docs(plan): Sprint 6 加入 UI/UX 设计稿前置

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,29 +755,70 @@ 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） | 📋 计划中 |
 
 **完成度预期**:
 
 | 阶段 | 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+ 把"设计先于实现"补齐

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 | 真实试点项目复盘 | 📋 计划中 |