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

docs/tech-stack.md

@@ -0,0 +1,38 @@
+# 技术栈
+
+## 桌面端（本期实现范围）
+
+| 层 | 选型 | 说明 |
+|---|---|---|
+| 框架 | Electron + electron-vite | 三进程构建（main/preload/renderer），HMR；Electron ≥37.6（内置 Node ≥22.19，满足 pi 运行时） |
+| 渲染进程 UI | React + TypeScript | |
+| 样式 | Tailwind CSS v4 | |
+| 组件 | shadcn/ui 风格自实现 + beautifului.dev 原语风格（Approval Card、Tool Chips、Task Rows、Streaming Text、Thinking、Prompt Bar） | copy-paste 式自有组件，不引入外部付费 |
+| 动效 | GSAP | 消息入场、卡片展开、状态过渡 |
+| 图标 | lucide-react | |
+| Agent 运行时 | pi SDK（`@earendil-works/pi-coding-agent`，版本精确锁定） | 嵌主进程；`save-exact` 纪律 |
+| 本地库 | sqlite3（better-sqlite3 候选，带 migrations 表 + 启动自动迁移） | v0.x 后期引入，先跑通链路 |
+
+## Monorepo 布局（目标态，按版本逐步填充）
+
+```
+agent-store-operations/
+├─ pnpm-workspace.yaml          # apps/*, packages/*
+├─ apps/
+│  ├─ desktop/                  # ✅ 本期：Electron 客户端
+│  ├─ server/                   # ⛔ 未设计，不创建（NestJS）
+│  └─ admin/                    # ⛔ 未设计，不创建（Ant Design Pro）
+├─ packages/
+│  ├─ shared/                   # ⏳ 后端设计定稿后再建（DTO 契约）
+│  └─ agent/                    # ⏳ pi 插件：业务工具 + skills + 提示词
+└─ docs/                        # ✅
+```
+
+> 约束：`apps/server`、`apps/admin`、数据库相关一律不创建不设计（用户明确要求）。业务插件包 `packages/agent` 中依赖服务器 API 的工具只留占位接口。
+
+## 工程纪律
+
+- 依赖 `save-exact=true`（.npmrc），pi 包版本浮动 = 行为漂移
+- 主进程依赖 externalize（electron-vite 默认），pi 保持 `dependencies`，打包时随 app 分发
+- 每个版本 git tag（v0.1.0 起），自省记录追加到 `docs/roadmap.md`
+- 渲染进程零敏感信息：API key、pi 凭据只存在主进程可达的 `~/.pi`，渲染进程经 IPC 交互