删除策划agent v2，与退役功能解耦 (#355)

Reviewed-on: #355 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>
2026-09-20 14:49:57 +08:00
parent 623e007fae
commit 70271b408e
75 changed files with 492 additions and 9473 deletions
@@ -28,8 +28,8 @@

 1. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml direct_thread -- --nocapture`
 2. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml export_bindings`（生成 `src/features/project-workspace/generated/`），随后用 `prettier --write` 格式化生成目录，避免未格式化的 ts-rs 输出混进提交
-3. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directTurnPresentation.test.ts apps/ai-game-creator-shell/tests/directHistoryPaging.test.ts`
-4. `npx vitest run apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
+3. `npm run test -- apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directTurnPresentation.test.ts apps/ai-game-creator-shell/tests/directHistoryPaging.test.ts apps/ai-game-creator-shell/tests/directHistoryAnchorGate.test.ts`
+4. `npm run test -- apps/ai-game-creator-shell/tests/appSurface.test.ts`（`project-development.suite.ts` 由该入口注册，不能作为独立测试入口；同时验证现役 Design Agent 的会话恢复与审批界面。）
 5. TypeScript 类型检查与 ESLint（范围同前次 DirectProject 迁移）。
 6. `npm run check:encoding`、`npm run check:doc-index`、`git diff --check`

@@ -0,0 +1,92 @@
+# 【实施计划】退役策划 Agent V1/V2 解耦清理
+
+| 字段 | 值 |
+| --- | --- |
+| Milestone | `docs/project-memory/plans/【里程碑】退役策划Agent V1V2解耦清理-2026-09-15.md` |
+| Status | ready |
+| Owner | Codex |
+
+## 一句话交付结果
+
+删除退役策划 V1/V2 及其耦合的 Supervisor 产品残留，让当前 Design Agent 独立运行、做游戏走 DirectCodex 并恢复仓库编译；保留通用 Supervisor 和做游戏 16 Agent DAG。
+
+## 验收判据
+
+当前分支能够通过 AGC 前端 typecheck 和受影响定向测试；Design Agent 的新建、恢复、澄清、阶段审批和 reasoning 展示仍由当前 Design Agent 链路完成；旧 V2 IPC、旧 GDD 类型和旧前端测试契约不再存在。
+
+## 修改边界
+
+允许修改：
+
+- `apps/ai-game-creator-shell/src/App.tsx` 中旧 V2 状态、helper、IPC 分支和旧 UI props。
+- `apps/ai-game-creator-shell/src/app/types.ts` 中旧 GDD 类型。
+- `apps/ai-game-creator-shell/src/features/project-workspace/planningSessionV2.ts` 及其直接调用方。
+- `apps/ai-game-creator-shell/tests/appSurface/harness.ts`、`home.suite.ts`、旧策划事件测试。
+- `apps/ai-game-creator-shell/src/styles.css` 中只属于旧 Plan GDD / planning lane 的样式。
+- 没有现役调用方的旧策划身份 fixture、注释和文档索引。
+- 为通过编译所需的最小共享残留删除或改名。
+
+明确不修改：
+
+- `directCodex` 主链路和当前 Design Agent。
+- 16 Agent DAG、`supervisor-swarm` 测试和通用 Runtime 编排；只处理删除策划耦合后直接造成的编译错误。
+- 当前 Design Agent Rust runtime、Design Agent 资源包和 Design Agent IPC 协议。
+- 公开 API、SpacetimeDB schema、迁移和历史持久化数据格式。
+
+## 实现顺序与提交拆分
+
+### 提交一：解耦 Design Agent 状态命名
+
+- 将新版 Design Agent 实际使用的 `planningV2*` transient reply、reasoning、active ref 和相关 lane 控制改成 Design Agent 专属状态。
+- 保持行为不变，不删除旧 V2 会话代码。
+- 验证：AGC typecheck、`git diff --check`。
+
+### 提交二：删除 App 旧 V2 会话控制流
+
+- 删除仅服务旧策划的 Supervisor 产品入口、恢复、轮询和聊天提交分支。
+- 删除旧 V2 session/GDD 状态和 helper。
+- 删除项目打开、消息发送、问询回答、审批和旧流式事件分支。
+- 将“做方案”只连接到当前 Design Agent hydrate/continue/decide 路径，将“做游戏/做素材”只连接到 DirectCodex。
+- 保留 `planningStartMode` 作为入口路由字段，避免无关扩大重命名。
+- 验证：AGC typecheck；必要时运行 App 启动相关定向 suite。
+
+### 提交三：删除旧 TypeScript 适配层和类型
+
+- 删除 `planningSessionV2.ts`。
+- 删除 `PlanGddDecisionAction`、`PlanGddStateViewV1` 及所有直接导入。
+- 重新执行旧符号检索，确认没有残留调用方。
+- 验证：AGC typecheck、`npm run check:encoding`、`git diff --check`。
+
+### 提交四：清理测试、事件契约和 CSS
+
+- 精确删除 harness 中旧 V2/GDD 工厂、mock、调用记录和导出。
+- 精确删除首页 suite 中旧 V2 IPC 断言。
+- 删除旧 `planning-session-v2-stream` 事件测试。
+- 删除 Plan GDD、GDD 审批卡和 planning lane 专属 CSS 及过时说明。
+- 验证：appSurface 定向测试、事件订阅定向测试、AGC typecheck、编码和 diff 检查。
+
+### 提交五：收口确定失效的身份残留和文档入口
+
+- 只处理因 V1/V2 退役而确定失效的旧身份展示、测试 fixture、注释和文档索引。
+- 不扫描或重构做游戏 DAG；共享代码只在其旧策划用途已确定死且删除能直接解决编译/测试问题时处理。
+- 验证：旧策划符号定向检索、相关测试、编码和 diff 检查。
+
+## 验证命令
+
+1. `npm --prefix apps/ai-game-creator-shell run typecheck`
+2. `npm run check:encoding`
+3. `git diff --check`
+4. `npm --prefix apps/ai-game-creator-shell exec vitest run tests/appSurface.test.ts`
+5. 受影响 Rust 文件变化后运行 `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml`
+6. 完成全部提交后再次执行旧策划符号检索，并核对 `git status` 与提交边界
+
+## 风险与回滚点
+
+- 最大风险是新版 Design Agent 复用了旧变量名；必须先完成提交一，再删除旧 helper。
+- `ProjectSupervisorView` 已经移除旧 GDD props，App 传参残留会在提交二中一并删除。
+- 测试 harness 同时服务通用总控和 Design Agent，必须局部删除旧 mock，不能整段重写。
+- 若某次提交导致 Design Agent 测试失败，只回滚该独立提交，不恢复旧 V2 兼容层。
+
+## 完成后的临时文档处理
+
+全部里程碑验收通过后，删除本里程碑和实施计划两份临时文档；把仍然有效的长期边界同步回现行 Design Agent 技术方案和项目记忆，不保留阶段性提交步骤。
@@ -0,0 +1,21 @@
+# 关联里程碑
+
+`【里程碑】退役策划V2 Rust Runtime清理-2026-09-14.md`
+
+# 修改顺序
+
+1. 从 `runtime_protocol.rs` 移除 V2 模块声明与导出。
+2. 从 `main.rs` / `commands.rs` 移除 V2 command 注册和仅供 V2 的导入。
+3. 删除 V2 Rust 模块及其专属单元测试；保留共享 GDD 模型或新版设计会话仍使用的类型。
+4. 用 `rg` 检查 V2 Rust 符号残留，修复编译引用。
+
+# 验证命令
+
+- `cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml`
+- `npm run check:encoding`
+- `git diff --check`
+
+# 风险与回滚
+
+- 风险：V2 类型可能被共享测试或前端桥接代码引用。处理方式是按编译错误逐项判断，保留真正共享类型。
+- 回滚：按提交粒度回退本里程碑提交，不触碰前序 V1 清理提交。
@@ -0,0 +1,49 @@
+# 【里程碑】退役策划 Agent V1/V2 解耦清理
+
+| 字段 | 值 |
+| --- | --- |
+| Version | 1.0 |
+| Status | proposed |
+| Date | 2026-09-15 |
+| Parent Spec | `docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md` |
+
+## 目标
+
+移除旧版策划 Agent V1、V2 的前端会话、审批、数据适配、测试契约和确定失效的展示残留；仅在删除策划链路时遇到已退役 Supervisor 功能耦合时一并删除该耦合，使“做方案”只使用当前 Design Agent、做游戏只使用 DirectCodex。
+
+## 范围
+
+- 解除当前 Design Agent 与旧 `planningV2` / `PlanGdd` 状态命名和控制流的耦合。
+- 删除仅服务旧策划的 Supervisor 产品入口、会话恢复、Runtime 轮询和聊天提交分支；保留通用 Supervisor 与做游戏 DAG。
+- 删除旧 V2 会话 hydrate、start、continue、审批和用户问询分支。
+- 删除旧 V2 TypeScript 会话适配层、旧 GDD 前端类型、测试 mock、旧事件契约和专属样式。
+- 清理确定没有现役调用方的旧策划身份说明、测试 fixture 和文档当前入口。
+- 保留当前 Design Agent 的会话、澄清、阶段审批、工作区浏览和 reasoning 展示行为。
+
+## 不在范围内
+
+- 不主动扫描、重构或整体删除做游戏 Agent 的 16 Agent DAG；只有策划删除直接造成编译或测试失败时才做最小修复。
+- 不删除 DirectCodex 或当前 Design Agent；必要时保留被两者复用的中性聊天表现组件。
+- 不为旧项目新增兼容层、迁移器、墓碑注释或退役行为测试。
+- 不修改 SpacetimeDB schema、公开 API、持久化迁移和现役 Design Agent 协议。
+
+## 依赖与前置条件
+
+- PR #159 的合并提交 `3d8e0211` 代表旧 Fast GDD / 策划 V1 的引入。
+- PR #305 的合并提交 `04128eb6` 同时包含 V1 大范围退役、策划 V2 会话链路和后续 Design Agent 迁移。
+- 当前分支已经删除 Rust V1/V2 Runtime 模块和旧审批组件，但前端仍残留旧 V2 调用方；实现前须保持工作树干净。
+
+## 验收标准
+
+- [ ] “做方案”入口和已有 Design Agent 项目只调用当前 Design Agent IPC，不再调用旧 `planning_*_v2` IPC。
+- [ ] 当前 Design Agent 的消息、reasoning、澄清、阶段审批和重试行为不依赖旧 V2 状态变量。
+- [ ] 源码中不再存在旧 V2 TypeScript 会话适配层、旧 `PlanGdd` 类型和旧前端审批契约。
+- [ ] 旧前端测试、事件测试和样式残留被删除或改为当前 Design Agent 契约。
+- [ ] 不主动修改做游戏 Supervisor + 16 Agent DAG；因共享退役代码删除产生的编译错误得到最小修复。
+- [ ] 前端 typecheck、相关定向测试、编码检查和 diff 检查通过；触及 Rust 时对应 cargo check 通过。
+
+## 证据要求
+
+- 自动化：`npm --prefix apps/ai-game-creator-shell run typecheck`、相关 appSurface 定向测试、`npm run check:encoding`、`git diff --check`。
+- 运行时：至少验证“做方案”新项目进入 Design Agent、已有 Design Agent 会话恢复、澄清/审批回合可继续。
+- 边界：确认 DirectCodex 和做游戏既有入口未被旧策划清理改动；确认旧 V2 IPC 字符串和旧事件契约不再进入现役前端。
@@ -0,0 +1,38 @@
+# Version
+
+V2-RUST-RETIRE-1
+
+# Status
+
+in-progress
+
+# Date
+
+2026-09-14
+
+# Parent Spec
+
+`docs/technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md`
+
+# 目标
+
+删除已经被独立 Design Agent 取代的旧策划 V2 Rust Runtime、Tauri 命令注册和仅服务 V2 的模块导出，使桌面壳继续编译并保留做游戏 Agent 与新版 Design Agent。
+
+# 边界
+
+- 删除 `planning_policy_v2`、`planning_session_v2` 及仅供这两者使用的 V2 注册和调用。
+- 删除 V2 专属的 Tauri command 注册、模块导出和测试入口。
+- 保留 `design_runtime`、`design_tools`、`design_session`、通用 runtime、DirectProject 和做游戏 Agent。
+- 本里程碑不处理前端 V2 数据层、UI、文档索引和共享运行时中的可选清理。
+
+# 验收标准
+
+1. Rust 源码不再编译 `planning_policy_v2.rs` 或 `planning_session_v2.rs`。
+2. `main.rs`、`commands.rs` 和 runtime protocol 不再注册或导出 V2 命令。
+3. 新版 Design Agent 与做游戏 Agent 的 Rust 编译路径保持可用。
+4. 相关定向 Rust 测试和 `cargo check` 通过。
+
+# 依赖
+
+- 当前分支已包含 PR159 的 V1 清理。
+- 前端 V2 调用暂时保留，待后续里程碑同步删除。
@@ -1,7 +1,8 @@
 # 决策记录

 > 用途：记录已经确认、会影响后续开发的长期技术/产品/协作决策。短期讨论不要写在这里。
-> 当前口径：历史条目的旧路径、旧版本和已退役对象只用于追溯，不构成现行实现依据；如与当前代码或 `docs/README.md` 冲突，以当前代码和最新专题文档为准。
+> 当前口径（2026-09-18）：历史条目的旧路径、旧版本和已退役对象只用于追溯，不构成现行实现依据。策划 Agent V1/V2 的 Runtime、专用命令、审批卡、展示适配和旧测试已删除；当前策划入口统一使用 Design Agent。如与当前代码或 `docs/README.md` 冲突，以当前代码和最新专题文档为准。
+
 ## 2026-09-17 GameCreationApp 资源 kind 只保留一份词汇表：严格解析 + `app_log!` 留痕

 - 背景：kind 曾经有三份实现——Rust 手写 `GAME_CREATION_APP_CANONICAL_ASSET_KINDS` + `canonical_game_creation_app_asset_kind()`（带 legacy 别名表与 `font → document` 特例）、TS 手写 `GAME_CREATION_APP_CANONICAL_ASSET_KINDS` + `GAME_CREATION_APP_LEGACY_ASSET_KINDS` + `canonicalGameCreationAppAssetKind()`、以及 ts-rs 生成的 TS union。两份手写表互相引用又各自收口，判据直接分叉（同一个 `"UI"` 一边归一成 `ui-design`、一边收口成 `unknown`），跨语言一致性只能靠正则解析源码的测试来钉。
@@ -223,7 +224,7 @@

 - 决策：待实施的生产迁移以自由协作策划原型为行为基线，仅复用 Provider、恢复、文件操作、审计和 UI 通信；不继承旧 Planning V2 的强制工具、问询轮数、GDD 内容校验和版本审批。保留五阶段与顾问态、当前阶段资源注入和产物存在性检查，系统阶段空必需清单不增加解析或登记功能。
 - 交互边界：正式审批由 ✅/❌ 决定；❌ 只取消待审批、不唤醒 Agent，等待审批时禁止发送消息但允许浏览工作区。用户可直接查看工作区，编辑可暂不做，不引入用户与 Agent 协同编辑锁或冲突合并。
- 影响范围：策划入口、会话与工具实现、资源打包、文件浏览；实施中。无旧 Planning V2 会话的策划项目走新设计 Agent，已有 V2 会话仍走原链路。
+- 影响范围：策划入口、会话与工具实现、资源打包、文件浏览；迁移已完成。当前入口统一使用新 Design Agent，旧 Planning V2 会话不再继续运行。
 - 关联文档：[策划 Agent 生产迁移与工作区浏览](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md)。

 ## 记录格式
@@ -24,10 +24,10 @@
 AI 游戏创作 / DirectProject / UI workflow：

 1. `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`
-2. `docs/technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md`
+2. `docs/technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md`（历史方案，仅供追溯）
 3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
 4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
-5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`（仅存量旧链路）
+5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`（历史 V1 方案，仅供追溯）
 2. `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md`
 3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
 4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
@@ -1,5 +1,10 @@
 # 踩坑与排障记录

+## Rust 同步回调的测试记录按线程隔离
+
+- `shared-contracts` 的资源 kind reporter 是进程级回调。仅给注册和断言加锁，无法阻止其他并行 manifest 测试触发该回调，导致日志数量和内容断言偶发混入其他测试记录。
+- kind 解析与回调在调用线程同步执行，测试收集器使用线程局部存储，各用例开始时清空本线程记录；生产 reporter 保持不变。保留完整记录断言，并用两个线程分别解析和核对记录，验证隔离；不要通过全局串行测试或放宽断言掩盖干扰。
+
 ## AGC 自动同步必须绑定真实项目生命周期

 - 正式客户端在单窗口中用 React 状态打开/切换工程，窗口 URL 不代表当前工程。原生后台同步应读取由当前窗口显式登记的活动工程；首次打开、离开、切换、关窗及退出等待分别验证，不能只用携带 `projectPath` 的独立测试窗口证明正式入口可用。