diff --git a/PLAN.md b/PLAN.md index 2deeab4..70b9d4f 100644 --- a/PLAN.md +++ b/PLAN.md @@ -14,8 +14,8 @@ > | S3 | 测试 + 运维场景工具补齐 | ✅ 完成(2026-04-18) | > | S4 | 场景联动 + 度量闭环 | ✅ 完成(2026-04-18) | > | S5 | 统一 CLI + 对外发布 + 试点复盘 | ✅ 完成(2026-04-18) 🎉 | -> | **S6** | **架构盘点 + 手册起步 + macOS Beta** | **📋 Phase 2 计划中** | -> | S7 | 跨平台决策 + Linux/Win Beta | 📋 Phase 2 计划中 | +> | **S6** | **架构盘点 + UI/UX 设计稿 + 手册起步 + 信息流文档化** | **📋 Phase 2 计划中** | +> | S7 | macOS Beta 打包 + 跨平台栈决策 | 📋 Phase 2 计划中 | > | S8 | 用户手册完整版 + v1.0 正式发布 | 📋 Phase 2 计划中 | > | S9 | 服务端 RFC + OTA 协议设计(不实现) | 📋 Phase 2 计划中 | > | S10 | 真实试点项目复盘 | 📋 Phase 2 计划中 | @@ -659,9 +659,10 @@ Week 5: 复盘 + 反馈 → 改进 backlog - 自动更新通道(Sparkle for macOS · GitHub Release + 版本检查 for Linux/Win) - `CODEOWNERS` 加桌面应用维护人 -**Sprint**: -- **S6 · macOS Beta 发布**(仅打包) -- **S7-S8 · 决策跨平台栈 + 三平台 Beta**(视方案 A/B/C) +**Sprint**(因加入 ⑥ UI/UX 设计,顺序调整): +- **S6 · 不含打包**(先做 UI/UX 设计稿,见 ⑥) +- **S7 · macOS Beta 发布**(按设计稿调整 macOS 实现 → 打包 → 签名 → Release) +- **S8 · 跨平台栈决策 + Linux/Win Beta** --- @@ -754,13 +755,52 @@ Week 5: 复盘 + 反馈 → 改进 backlog --- +### ⑥ 桌面应用 UI/UX 设计稿(新增 · 2026-04-19) + +**为什么先做**: +- 当前 macOS 有 22 个 Swift 文件**实现**,但**没有设计稿**(Sprint 1 之前是快速原型) +- Phase 2 三平台齐发,如果直接开码,Linux/Win 没有权威源,每个平台做出来都不一样 +- 设计稿先行 → 跨平台实现有统一蓝图 → 减少 Sprint 7-8 的返工 + +**产出**: +- `docs/design/ui/` 新目录 + - `README.md` · 设计原则 + 工具选型(Figma 链接 + 仓库内 ASCII 备份) + - `wireframes/` · 核心页面线框图(ASCII / Mermaid) + - `01-main-three-pane.md` · 三栏主视图(侧边栏会话列表 / 聊天区 / Artifact 面板) + - `02-setup-wizard.md` · 首次启动向导(环境检查 + 供应商配置) + - `03-settings.md` · 设置页(供应商管理 / 偏好 / 快捷键) + - `04-conversation.md` · 单会话内的交互(消息渲染 / 斜杠命令 / 流式输出) + - `05-artifact.md` · Artifact 面板(代码片段 / 文档 / 图表) + - `06-search-and-favorites.md` · 搜索与收藏 + - `interaction-flows/` · 关键交互流程图(Mermaid) + - `flow-new-conversation.md` · 新建会话 → 选供应商 → 输入首条消息 + - `flow-env-check-fail.md` · 环境检查失败的兜底引导 + - `flow-slash-command.md` · 斜杠命令选择 + 自动补全 + - `flow-artifact-detect.md` · AI 输出代码 → 自动识别为 Artifact + - `cross-platform-constraints.md` · 三平台一致性约束 + - 必须一致的部分(信息架构 / 核心功能层级 / 关键术语) + - 可分平台定制的部分(快捷键 / 窗口控件 / 系统集成方式) + +**工具选型**: +- **首版**: 仓库内 ASCII 线框 + Mermaid(零外部依赖,文档站可直接渲染) +- **高保真版** (S7-S8 由有 Figma 经验者补): Figma 链接挂在 README 里 + +**Sprint**: S6(2-3 天,在架构图之后,UI 设计前置于实现) + +**为什么 macOS 实现要等设计稿**: +- macOS 已有的 22 个 Swift 文件可能不是最优解 +- 设计稿出来后,可能需要调整 macOS 的部分页面 +- 与其打包"过时"版本,不如延后 1 周打包"对齐"版本 + +--- + ## Phase 2 · 5 Sprint 规划 | Sprint | 主题 | 覆盖 | 状态 | |--------|------|------|------| -| S6 | 架构盘点 + 手册起步 + macOS Beta | ①⑤ 完成 · ②起步 · ③ macOS | 📋 计划中 | -| S7 | 跨平台决策 + 桌面应用 Linux/Win Beta | ③ Linux + Win | 📋 计划中 | -| S8 | 用户手册完整版 + 首次 v1.0 正式发布 | ② 完成 | 📋 计划中 | +| S6 | 架构图 + UI/UX 设计稿 + 信息流 + 手册起步 | ①⑤⑥ 完成 · ②起步 | 📋 计划中 | +| S7 | macOS Beta(对齐设计稿)+ 跨平台栈决策 | ③ macOS · 跨平台 ADR | 📋 计划中 | +| S8 | 用户手册完整版 + Linux/Win Beta + v1.0 GA | ② 完成 · ③ Linux/Win | 📋 计划中 | | S9 | 服务端 RFC + OTA 协议设计 | ④(纯设计)| 📋 计划中 | | S10 | 真实试点项目(非 npds)+ 复盘 + 反馈回流 | Phase 1 遗留(L5) | 📋 计划中 | @@ -768,15 +808,17 @@ Week 5: 复盘 + 反馈 → 改进 backlog | 阶段 | L1 | L2 | L3 | L4 | L5 | 应用可用 | 服务端 | 整体 | |------|---|---|---|---|---|---------|--------|------| -| Phase 1 结束 (当前) | 95 | 100 | 97 | 90 | 85 | 30(仅 macOS 源码) | 0 | **98%** | -| S6 完成 | 100 | 100 | 97 | 90 | 85 | 50(macOS Beta) | RFC 0% | **模型完整** | -| S7-S8 完成 | 100 | 100 | 97 | 92 | 90 | 90(三平台 Beta) | 设计 50% | **可下载使用** | +| Phase 1 结束 (当前) | 95 | 100 | 97 | 90 | 85 | 30(仅 macOS 源码,无设计稿) | 0 | **98%** | +| S6 完成 | 100 | 100 | 97 | 90 | 85 | 40(设计稿就绪,实现未变) | RFC 0% | **设计完整** | +| S7 完成 | 100 | 100 | 97 | 92 | 88 | 60(macOS Beta) | RFC 0% | **macOS 可下载** | +| S8 完成 | 100 | 100 | 97 | 92 | 90 | 90(三平台 Beta) | 设计 50% | **三平台可下载** | | S9 完成 | 100 | 100 | 97 | 92 | 90 | 90 | 设计 100% | **服务化可投资** | | S10 完成 | 100 | 100 | 97 | 95 | 95 | 95 | 设计 100% | **企业可试点** | ## Phase 2 原则 -1. **先设计再实现**:④ 的服务端先写 RFC 评审,避免"一头钻进代码才发现方向错" -2. **三平台齐发**:③ 不追求"macOS 领先 3 个月",要么一起 Beta 要么一起 GA(避免非 macOS 用户"感觉被忽略") +1. **先设计再实现**:④ 服务端先 RFC 评审;⑥ UI/UX 先线框/Mermaid,再调 macOS 实现 → 再开 Linux/Win +2. **三平台齐发**:③ 不追求"macOS 领先 3 个月",但接受"macOS 先 1 周 Beta(S7)+ Linux/Win 紧跟(S8)"的小错位 —— 关键是设计稿统一 3. **用户手册小步迭代**:② 写一节发一节,别憋到 Sprint 结尾 -4. **架构文档要有图**:①⑤ 不是文字描述,必须有 Mermaid / ASCII 图让非技术人员也能看懂 +4. **架构文档要有图**:①⑤⑥ 不是文字描述,必须有 Mermaid / ASCII 图让非技术人员也能看懂 +5. **设计先于代码**:⑥ 是 Phase 2 的隐藏前置 —— Sprint 1-5 已经把"方法论先于工具"做好,Sprint 6+ 把"设计先于实现"补齐 diff --git a/ROADMAP.md b/ROADMAP.md index c745603..afbb10a 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -18,9 +18,9 @@ | S4 | Week 4 | 场景联动 + 度量闭环 | ✅ 完成 | | S5 | Week 5 | 统一 CLI + 对外发布 + 试点复盘 | ✅ 完成 | | **Phase 2 · 落地与产品化** | | | | -| S6 | Week 6 | 架构盘点 + 手册起步 + macOS Beta | 📋 计划中 | -| S7 | Week 7 | 跨平台栈决策 + Linux/Win Beta | 📋 计划中 | -| S8 | Week 8 | 用户手册完整版 + v1.0 正式发布 | 📋 计划中 | +| S6 | Week 6 | 架构图 + UI/UX 设计稿 + 信息流 + 手册起步 | 📋 计划中 | +| S7 | Week 7 | macOS Beta(对齐设计稿)+ 跨平台栈决策 | 📋 计划中 | +| S8 | Week 8 | 用户手册完整版 + Linux/Win Beta + v1.0 GA | 📋 计划中 | | S9 | Week 9 | 服务端同步 RFC + OTA 协议设计(不实现) | 📋 计划中 | | S10 | Week 10 | 真实试点项目复盘 | 📋 计划中 |