修复 #599：首页建项不再等待 AI 项目命名，改为后台条件改名

- 首页自动建项：预检通过后立即以宿主兜底名创建工作区并进入项目，create_automatic_local_game_project 固定传 name: null，不再等待 suggest_automatic_project_name。 - 命名请求在建项前并行打出，结果交给后台任务；命名慢、超时、失败或返回非法内容都不影响建项、附件导入与首轮创作。 - 新增 Rust 命令 rename_local_game_project_if_unchanged（expectedProjectId + expectedName 条件改名）：项目 ID 不符、用户已手动改名、名称未变一律返回 renamed: false 并保持现状，空名/控制字符/超长失败关闭，改名不推进项目 revision。 - 后台改名结果等「建项主体收尾」再写当前项目上下文与最近项目行重检，避免被进项目的兜底上下文覆盖。 - 新增前端时序测试 tests/homeProjectNamingAsync.test.tsx（9 例，promise 闸门而非 sleep）与 appSurface 客户端流程用例。 - 新增 Rust 条件改名单测 5 例；更新实施计划专题、decision-log、pitfalls。验证：npx vitest run apps/ai-game-creator-shell/tests/homeProjectNamingAsync.test.tsx（9 passed）；npm run test -- apps/ai-game-creator-shell/tests（1910 passed / 17 skipped）；cargo test --features=cocos-editor-execute,unity-editor-execute,godot-editor-execute --bin genarrative-ai-game-creator-shell conditional_project_rename_tests（5 passed）；cargo check 同 features 通过；npm run agc:typecheck、cargo fmt --check、npm run check:encoding、git diff --check 全绿。
2026-10-03 19:44:00 +08:00
parent 8aee5db84e
commit e3c91c4e2c
10 changed files with 822 additions and 6 deletions
@@ -2,6 +2,16 @@

 这里只记录对当前开发仍有用的症状、根因、排查方法和风险边界。同一事实保留一个当前口径；退役对象的专属过程与单轮测试结果由 Git 历史追溯。遇到旧路径或版本时，以现行代码和专题文档为准。

+## 2026-10-03 后台异步回填被「进项目」覆盖：AI 项目名只在兜底名仍成立时改
+
+- **现象**（Issue 599）：首页建项把 AI 命名改成「与建项并行、结果后台回填」后，偶尔工作台标题停在兜底名（`GameAgent 项目 <短 id>`），而磁盘 manifest 已经是 AI 名字。
+- **原因**：改名落盘很快，但写「当前项目上下文」的那次 `setCurrentProjectContext` 被 `enterProjectDevelopment` 随后的兜底上下文覆盖——AI 比进项目更快时，回填写入时上下文里还没有这个项目（`current` 为 null 或仍是上一个项目）。同一原因下 `refreshRecentWorkspace` 也会被丢弃：最近项目行只在 `recentWorkspacesRef` 已包含该路径时才更新状态，而路径是进项目时才登记的。
+- **处理（现行口径）**：后台改名任务里，「写项目上下文 + 重检最近项目行」这两步必须等「建项主体收尾」（进项目成功、失败或让位于别的项目）的信号再执行；改名本身照旧立即落盘。回归用 promise 闸门卡住 `get_local_game_preview_status` 复现顺序，不用 sleep。
+- **判据/取证**：`npx vitest run apps/ai-game-creator-shell/tests/homeProjectNamingAsync.test.tsx` 的「keeps the AI name when the naming result lands before the project is entered」（去掉等待即复现兜底名覆盖）；appSurface 的「syncs the workbench title and recent project list with the AI name after creation」。
+- **边界**：条件改名的判据必须由宿主校验（项目 ID + 当前名称仍是兜底名），前端只转述 `expectedProjectId` / `expectedName`；用户已手动改名时宿主返回 `renamed: false`，回填整体跳过、绝不覆盖用户输入。
+- **关联**：`apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts`、`apps/ai-game-creator-shell/src-tauri/src/commands.rs`。
+
+
 ## 2026-10-03 AGC 栏目画布上传素材落「待归类」：kind 派生分类不等于入口栏目

 - **现象**（Issue 359）：在 AGC 资源栏目子画布（如「UI 交互」「角色与对象」）左下角工具栏点「上传」选图片 / 视频 / 代码类文件，提示条给出「已上传 1 个素材」，但当前栏目计数纹丝不动（仍「0 项」），素材出现在「待归类」。用户看到的是"上传成功了，可它就消失在这个页面里"。