inkreach-agent/docs/references.md

参考项目取舍

原则：功能设计抄 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 用于消息入场、卡片展开等动效