修复策划项目重开运行态恢复

持久化策划项目 design 运行模式并在重开时恢复 design/game 工作台。补充旧策划会话兼容判断、前端夹具和恢复回归测试。
2026-09-12 06:41:49 +00:00
parent 281e6ccf48
commit 832f1e8b59
10 changed files with 196 additions and 4 deletions
@@ -2,6 +2,11 @@

 > 当前口径：本文件保留可复用的排障经验；历史条目的旧路由、旧版本和已删除文档仅作根因背景，不得据此恢复退役入口。当前命令、路由和 schema 以代码与 `docs/README.md` 为准。

+## 2026-09-12 策划项目重开前必须恢复运行模式
+
+- 工作台不能只依赖创建时的内存 `startMode`：重开时丢失该值会挂载游戏资源画布，而对话恢复后又进入策划状态，造成左右区域不一致。
+- 新建策划项目进入工作台前持久化 `.agent/runtime-mode.json`；重开先读取模式再发布项目上下文。无模式文件的旧项目用策划会话恢复为 design，明确的 game 标记优先于旧会话。
+
 ## 2026-09-10 设计 Agent 需要流式 Responses 的原生 output[]，不能只靠 tool_calls

 - **现象**：新策划报 `Provider 返回工具调用但未提供完整 Responses output`。模型已经在调工具，`.debug/design-agent` 里 `tool_calls` 有值但 `output` 是 `[]`。
@@ -342,6 +342,8 @@ UI 使用“批准”和“继续修改”两个文字按钮，分别配 Lucide

 ## 14. 开发调试入口

+项目运行模式通过 `.agent/runtime-mode.json` 持久化。新建策划项目在进入工作台前写入 `design`；“做成游戏”写入 `game`。重新打开项目时通过 `get_design_agent_runtime_mode` 读取模式，完成后一次性挂载对应工作台，不能先挂载 GameAgent 再切回策划。旧项目缺少模式文件但存在策划会话时按 `design` 恢复；明确的 `game` 标记优先于残留策划会话。无模式也无策划会话的项目仍使用游戏工作台。
+
 开发构建的策划工作区页头在“刷新”旁提供“快速准备做成游戏测试”按钮。该入口与策划 Debug 日志共用 `GENARRATIVE_AGC_DESIGN_DEBUG=1` 开关：开关未启用时按钮不显示，命令也不可执行。入口仅进行本地 fixture 和会话状态写入，不调用 Provider；完成后自动刷新文件树与阶段，通过 `design-agent-update` 状态事件同步右侧审批/阶段操作区。随后仍需点击正常的“做成游戏”按钮执行资产登记与运行时切换。

 ## 15. 策划 Agent reasoning 展示现状