v0.1.0: Electron 桌面端骨架 + pi SDK 聊天链路

docs/references.md

@@ -0,0 +1,35 @@
+# 参考项目取舍
+
+原则：**功能设计抄 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 用于消息入场、卡片展开等动效