36 lines
2.0 KiB
Markdown
36 lines
2.0 KiB
Markdown
# 参考项目取舍
|
||
|
||
原则：**功能设计抄 pi-web，工程结构抄 Proma，技术选型和业务形态按我们自己的来。**
|
||
|
||
## agegr/pi-web（5.9k★，Next.js 本地 Web UI）
|
||
|
||
### 采纳
|
||
- **与 pi 共享本地数据的集成模式**：直接读 `~/.pi/agent` 的配置/凭据/会话（`sessions/<encoded-cwd>/<时间戳>_<uuid>.jsonl`），支持 `PI_CODING_AGENT_DIR` 重定向 → 我们的应用零配置复用用户已有 pi 环境
|
||
- **会话工作区功能清单**：按项目分组、运行状态、上下文用量/成本/压缩详情、重命名/导出/删除
|
||
- **双分支设计**：New session（从历史消息建独立会话）/ Edit from here（会话内分支）
|
||
- **模型配置面板**：models.json 编辑、API key、连通性测试
|
||
- **文件访问边界**：只允许访问选定工作目录与已知项目根（安全约束）
|
||
- 事件推送做快照 + 60ms 节流的工程细节
|
||
|
||
### 丢弃
|
||
- Next.js/Web 技术栈（我们是 Electron）
|
||
- Git worktree、通用文件浏览器等重编码功能（垂直业务场景不需要，最多降级为可选模块）
|
||
|
||
## proma-ai/Proma（Electron + React，本地优先 AI 桌面应用）
|
||
|
||
### 采纳
|
||
- **工程结构**：`apps/electron + packages/*` 的 Electron monorepo 组织
|
||
- **产品形态**：workspace 按业务域隔离、Skills 技能系统的组织方式、多模型 chat 的配置体验
|
||
- **本地优先**理念（与我们 D5 数据主权决策一致）
|
||
|
||
### 丢弃
|
||
- Bun monorepo → 我们用 **pnpm**（pi 生态是 npm 系；Windows 上 pnpm + electron-builder 兼容性更稳）
|
||
- 远程机器人、通用 agent 客户端的复杂度
|
||
- 照抄代码（结构参考为主，代码质量未逐一验证）
|
||
|
||
## beautifului.dev
|
||
|
||
- AI 原语组件的**设计参考**（Approval Card、Tool Chips、Task Rows、Streaming Text、Thinking、Prompt Bar 等 21 个）
|
||
- copy-paste 式分发（类 shadcn），我们按此风格在 `apps/desktop` 内自实现同款组件（React + Tailwind），不引入其付费订阅
|
||
- GSAP 用于消息入场、卡片展开等动效
|