合并 origin/master（21c79f54a）到 feat/game-purchase

- 冲突 docs/project-memory/shared-memory/decision-log.md：两侧都是在「# 决策记录」顶部新增条目，保留双份——本分支「2026-10-05 播放会话前缀在三处入口清空 Cookie」在前，master「2026-10-03 首页自动建项与 AI 项目命名解耦（Issue 599）」在后。
- 冲突 docs/project-memory/shared-memory/pitfalls.md：同为顶部新增条目，保留双份——本分支「2026-10-05 付费游戏播放会话前缀落在 /api/*」在前，master「2026-10-04 生成任务账本 taskType 维度与 v1 兼容」「2026-10-03 后台异步回填被进项目覆盖」在后。
- 其余逐处核对：master 本次只改了 apps/ai-game-creator-shell 与 docs（首页建项与 AI 命名解耦、AGC 标题栏项目标签、相关计划/记忆文档），与买断制付费功能文件无交集，全部吸收；master 未触碰 SpacetimeDB schema、钱包流水来源类型、游戏分发契约、边缘路由与生成绑定。
- 合并后回归核对：GameDistributionGame.price_mud_points 仍在结构体末尾且带默认值 0；migration 白名单仍含 game_distribution_purchase；RuntimeProfileWalletLedgerSourceType::GamePurchase（game_purchase）仍在。

docs/project-memory/plans/【实施计划】Direct回合跨页面生命周期与运行中项目可见性-2026-09-15.md

@@ -29,7 +29,7 @@ Milestone: `【里程碑】Direct回合跨页面生命周期与运行中项目
 
 1. Rust：扩展活动回合注册表并暴露只读快照命令，配定向用例（进入 / 进度 / 终态移除 / 多项目并存）。
 2. 前端：接入快照读取，实现“重新进入项目 → 恢复忙碌态与进度 → 以快照 sequence 续接 → 阻止并发提交”。
-3. 前端：在窗口标题栏挂载“正在运行的项目”下拉入口；标题栏只显示最后开始的项目，展开后按开始时间列出全部项目，复用既有组件与设计 token。
+3. 前端：在窗口标题栏挂载项目入口；2026-10-04 修订为**工作台内主文案恒为当前项目名**（只在工作台视图发布这个身份，不在项目内时回落到最近启动的在跑项目），运行中项目只占圆点、数量徽标与展开菜单（展开后按开始时间列出全部在跑项目，当前项目带「当前」标记），复用既有组件与设计 token。原口径「标题栏只显示最后开始的项目」见里程碑文末修订记录。
 4. 报错归类：按审计结论修正会误导的映射，逐条加回归用例；真实权限拒绝保持原提示。
 5. 文档：主规范与共享记忆同步；里程碑验收后删除临时计划文件。
 

docs/project-memory/plans/【里程碑】Direct回合跨页面生命周期与运行中项目可见性-2026-09-15.md

@@ -7,7 +7,7 @@ Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施
 
 ## 目标
 
-离开项目界面不再等于“回合消失”：后台继续跑的 Direct 回合必须能被前端重新发现并续接进度，同一项目在回合结束前不允许再发起第二条付费回合；壳层窗口标题栏提供“正在运行的项目”下拉入口，常态显示最后开始的项目，展开后列出当前确有在跑回合的全部项目并可点击进入。
+离开项目界面不再等于“回合消失”：后台继续跑的 Direct 回合必须能被前端重新发现并续接进度，同一项目在回合结束前不允许再发起第二条付费回合；壳层窗口标题栏提供项目入口，常态显示**当前打开的项目名**，展开后列出当前确有在跑回合的全部项目并可点击进入（2026-10-04 修订，见文末）。
 
 ## 边界
 
@@ -22,7 +22,7 @@ Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施
 - 重新进入有在跑回合的项目后：界面进入“正在处理”、显示最近一次进度、以快照 `sequence` 续接后续事件；回合结束前提交第二条需求不会真正发起第二条付费回合。
 - 回合结束（completed / failed）后：忙碌态解除、可以再次发送；不重复追加助手消息。
 - 无在跑回合的项目：行为与今天一致（可正常发送，不出现额外提示或阻塞）。
-- 窗口标题栏入口：常态只显示最后开始的项目，点击后按 `startedAt` 升序列出所有在跑项目，显示项目名（缺失时回退目录名）与状态/时长，点击进入对应项目；没有在跑回合时不渲染入口。
+- 窗口标题栏入口：常态显示当前项目名（只在工作台视图才算「当前项目」，不在项目内时回落到最近启动的在跑项目）；正在运行的项目只占圆点与数量徽标，点击后按 `startedAt` 升序列出所有在跑项目，显示项目名（缺失时回退目录名）与状态/时长、当前项目带「当前」标记，点击进入对应项目；没有在跑回合且没有读取失败时不渲染入口；读取失败不顶掉当前项目名，结论落在圆点告警色、标签提示与展开菜单里。
 - 快照读取失败不得阻断发送、不得显示成业务失败。
 - 已修的错误映射不回归：`direct-codex-turn-already-running:` 与历史同义中文正文都归一到“仍在处理这个项目的上一条需求”；真正的 `项目权限策略拒绝执行：<command>` 仍显示审批提示。
 
@@ -41,3 +41,20 @@ Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施
 - 仍未取得证据（需要真实运行）：真机重新进入正在跑的项目后恢复忙碌态与进度、标题栏入口点击进入对应项目、回合结束后可再次发送。
 
 因此本计划从 `in-progress` 改为 `implemented-awaiting-runtime-acceptance`：代码与定向测试已落地，缺的是真机运行时证据。
+
+## 2026-10-04 修订：标题栏标签认「当前项目」，运行中项目降级为徽标
+
+- 背景：issue #618。窗口标题栏那枚标签原来被「正在运行的项目」整块接管（`WindowChrome` 在 `activeTurns.length > 0 || readFailed` 时替换掉当前工作区标题），主文案取开始时间最晚的在跑项目。于是「当前项目没在跑、后台别的项目在跑」时标签显示的是别的项目，当前项目名在整个窗口上消失（现场：当前项目 `gameagent-ff7f3240`，标签显示 `gameagent-c3af9c7e`）。
+- 决策（主文案优先级）：标签主文案恒为当前项目名（`currentProjectContext.projectName`，经 `WindowChromeActiveProjectRuns.currentProjectName` 由 `WorkspaceLauncher` 发布）；不在项目内时才回落到最后开始的在跑项目。这与主规范既有条目「打开项目后居中标题切换为当前项目名」一致，运行中项目不再和它抢位置。
+- 决策（运行态表达）：圆点（读取失败转告警色）+ 运行中数量徽标（≥1 即显示）+ 展开菜单；菜单里当前项目那一行用与标签同名的项目名并带「当前」标记（`aria-current` 保留）。
+- 决策（读取失败）：不再整块替换标签，结论落在圆点告警色、标签提示（`aria-label` / `title`）与展开菜单里，不占主文案；既没有在跑项目、又没有当前项目可显示时才保留原来的纯提示。
+- 有意未做：后台项目在菜单里仍是目录名。运行中项目名来自快照 `projectName`（Rust 侧取 `thread_id` 目录名），要改成清单项目名就得让 `ThreadManager` 在认领回合时读 `.agent/manifest.json`，给纯内存模块的 claim 路径加锁内文件 I/O；当前项目那一行已用清单项目名对齐。
+- 验证：`npx vitest run apps/ai-game-creator-shell/tests/directActiveTurns.test.tsx apps/ai-game-creator-shell/tests/WindowChrome.test.tsx apps/ai-game-creator-shell/tests/workspaceWindowSync.test.tsx` → 22 passed（含三条新回归：别的项目在跑时标签仍是当前项目、当前项目自己跑时列表带「当前」、读取失败不顶掉当前项目名）；全量 AGC Web 用例与真实浏览器冒烟见 PR。
+
+## 2026-10-05 修订（评审后续）
+
+- 面板形态误报读取失败：`ActiveProjectRunsPanel` 的空态早退只判 `runningCount === 0`，把「快照读取成功、只是没有在跑回合」渲染成「未能读取正在运行的项目」，与本组件自身注释相反。补回 `!readFailed` 守卫；`panel` 是默认 prop，虽当前唯一生产调用方 `WindowChrome` 恒用 `titlebar`，但组件注释对外宣称面板布局可复用。
+- 会话残留的项目身份：`currentProjectContext` 是会话级状态（离开工作台不清空），活动回合快照却是全局轮询；照搬上下文会让首页 / 项目组 / 模板库上的标签一直写「当前项目：<上次打开的项目>」，徽标数字却属于别的项目，也令「不在项目内回落到最近启动的在跑项目」实际不可达。发布时按 `launcherView === 'project-development'` 门控 `currentProjectPath` / `currentProjectName`，与同文件窗口标题 effect 同口径。
+- 文案去重：读取失败的结论曾在菜单头部与 `role=status` 行连排两遍，头部改为只报数量；回落态触发文案原为「正在运行的项目：X；正在运行 N 个项目」，拆成「作用域 + 运行状态」（回落态作用域记为「最近运行的项目：X」，状态位「共 N 个项目在运行」）；数量徽标补 `title` 说明数字含义。
+- 验证：同三条定向用例文件 → 25 passed；对照旧实现，分别临时禁用 `launcherView` 门控与去掉面板空态守卫，对应用例各自转红（回归用例确有判别力）。
+- 仍未取得证据（需要真实运行）：真机重新进入正在跑的项目后恢复忙碌态与进度、标题栏入口点击进入对应项目、回合结束后可再次发送。

docs/project-memory/shared-memory/decision-log.md

@@ -11,6 +11,14 @@
 - 影响面：`deploy/nginx/{genarrative.conf,genarrative-dev-http.conf,README.md}`、`deploy/container/nginx.conf`、`vite.config.ts`、`server-rs/crates/pingora-gateway/src/main.rs`、`deploy/pingora/nginx-route-parity.matrix.json`、`scripts/check-{nginx-spa-routes,pingora-route-parity,pingora-gateway-smoke}.mjs`、`docs/technical/【开发运维】Pingora独立网关试点-2026-06-11.md`、`docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`。
 - 关联：`docs/project-memory/shared-memory/pitfalls.md`「付费游戏播放会话前缀落在 `/api/*`」条。
 
+## 2026-10-03 首页自动建项与 AI 项目命名解耦（Issue 599）
+
+- 背景：首页「开启创作」原先串行执行「Web 预检 → `await suggest_automatic_project_name` → `create_automatic_local_game_project`」。项目名称不是创建工作区、导入附件或发起首轮创作的前置条件，命名请求（`AUTOMATIC_PROJECT_NAME_TIMEOUT_MS = 15s`，正常请求同样占时）却把用户按在「正在创建工作区」上。
+- 决策（建项与命名解耦）：建项固定传 `name: null`，由宿主既有兜底名（`GameAgent 项目 <8 位短 id>` / `策划项目 <8 位短 id>`）落盘并立即进入项目；命名请求在建项前并行打出、结果交给后台任务。后台拿到合法名称后调用新增的 `rename_local_game_project_if_unchanged(projectPath, expectedProjectId, expectedName, name)`：只有「项目 ID 相同」且「当前名称仍是本次创建的兜底名」才改名，返回 `renamed: true/false`（跳过时不写盘、不是错误）。用户已手动改名、项目 ID 不符、名称与现状相同一律跳过；空 `expectedProjectId` / `expectedName`、空名 / 控制字符 / 超长一律失败关闭。
+- 决策（纳入「生成任务」体系）：自动命名做成**项目工作台那条既有「生成任务」列表里的一条后台任务**，而不只是页面里的一个 promise。账本记录加 `taskType`（`asset-generation` / `project-naming`，缺省 `asset-generation`）、`kind` 变可选，schema 升 `agc-asset-generation-task.v2`（读取同时接受 v1/v2，v1 记录按素材任务读回）；新增 `enqueue_local_project_naming_task`（排队中）/ `update_local_project_naming_task`（命名中 → 已完成/失败），展示名固定「AI 项目命名」，与素材生成共用同一份账本、同一个变更事件与同一个侧栏。状态流转：排队中 → 命名中 → 已完成（已应用 AI 名称 / 建议名与现状一致 / 用户已手动改名而跳过）或失败（无可用名称 / 自动改名失败，均保留兜底名）。命名任务由命名链路推进、**不进 live 集合就会被中断收口误判**，所以 enqueue 写账本前登记 live、update 终态写盘后摘除（中断残留仍按命名口径收口为失败）。前端按 `taskType` 把命名记录从素材任务分支里剔除，命名行不渲染缩略图/提示词/派发与定位动作，结论只在终态显示。
+- 边界：改名是簿记写入，与既有 `rename_local_game_project` 同口径**不推进项目 revision**（推 revision 会让运行时验证凭证无故漂移）；返回的 `revision` 是当时盘上的值。后台改名结果写「当前项目上下文」与「最近项目行重检」必须等建项主体收尾（`entrySettled`）：AI 比进项目更快时直接写上下文会被随后的 `enterProjectDevelopment` 用兜底名覆盖，最近项目行也要等进项目登记过才会被重检；写入前再过壳的生命周期守卫（`mounted` + 代次），关窗/卸载后只保留已落盘的改名，不写 UI 投影。账本是**展示旁路**：`enqueue` / `update` 失败只写诊断日志，绝不影响建项、命名与首轮创作；「做方案」与手动选目录建项不发起自动命名。本次未改共享契约（`packages/shared/**`）、server-rs 与任何 SpacetimeDB schema/HTTP 路由。条件改名的 `expectedProjectId` / `expectedName` 为空时按仓库同类入口口径失败关闭；`update_local_project_naming_task` 与 enqueue 共用 `project.rename` 权限位、校验记录归属，且终态只接受同状态幂等重放。**兼容性写成显式边界：兼容是单向的**——新构建读 v1 账本 OK；旧构建读到含命名记录（`kind: null`）的账本会整份解析失败（面板报读失败、同批在途素材任务被按中断收口）。前端刷新必须先订阅事件再读快照，并在面板打开时补读一次兜底（**门控**：仅当列表里确实存在在途命名行时才补读，避免给没有命名任务的项目多打一次账本 IPC）。
+- 影响范围：`apps/ai-game-creator-shell/src-tauri/src/{commands.rs,desktop.rs,asset_generation_tasks.rs,asset_generation_tasks/runtime.rs}`、`apps/ai-game-creator-shell/src/{app/types.ts,features/app-shell/{useHomeProjectCreation.ts,WorkspaceLauncher.tsx},features/resource-canvas/{resourceCanvasAssetGenerationTaskModel.ts,ResourceCanvasAssetGenerationTasksPanelView.tsx},view/project-development/index.tsx}`、`apps/ai-game-creator-shell/tests/{homeProjectNamingAsync.test.tsx,projectNamingGenerationTaskRow.test.tsx,appSurface/home.suite.ts}`。
+- 验证：`npx vitest run apps/ai-game-creator-shell/tests/homeProjectNamingAsync.test.tsx`（12 passed，含「命名请求永不返回仍进工作区」「AI 结果先于进项目落定仍不被兜底名覆盖」「手动改名不被覆盖且任务按已完成+已跳过收口」「非法/空响应 → 任务 failed 且保留兜底名」「做方案不发起命名」「切到别的工作区不被劫持」「卸载/pagehide 后不写上下文」，并断言入队→命名中→终态的账本推进序列）；`projectNamingGenerationTaskRow.test.tsx`（3 passed：固定展示名/不渲染缩略图提示词定位、终态才显示结论、失败徽章与原因 + 在途计数）；AGC 全量 `npm run test -- apps/ai-game-creator-shell/tests`（1964 passed / 17 skipped）；`cargo test --features=cocos-editor-execute,unity-editor-execute,godot-editor-execute asset_generation_task`（27 passed，含 `naming_task_stays_in_flight_across_ledger_reads_until_terminal`、`naming_task_update_requires_the_project_rename_permission`、`naming_task_update_rejects_a_record_from_another_project`、`naming_task_terminal_state_rejects_a_different_status_but_allows_the_same_one`、`ledger_with_an_unsupported_schema_version_fails_closed`、`ledger_without_a_schema_version_is_accepted_as_v1`）与 `conditional_project_rename_tests`（7 passed，含超长名失败关闭）；`npm run agc:typecheck`（含 `check:tests:types`）、`cargo fmt --check`、`npm run check:encoding`、`git diff --check`。
 ## 2026-10-03 AGC 发布版本标签改为由工程内部版本派生，取代「用户可编辑标签」口径
 
 - 背景：用户实机验收指出发布面板「项目版本」显示 v6，而 AGC 工程内部只有 4 条正式版本记录（资源总览「项目版本」栏目 4 张卡，顶栏「智能体修订」下拉同样只有这 4 条）。核实：面板值来自本地清单 `manifest.projectVersion` 这个可编辑标量，它被三条链路反复钉到**平台** `game_distribution_version.version_number` 上——发布成功回写（`apps/ai-game-creator-shell/src-tauri/src/game_distribution_publish.rs:1531-1535`）、打开面板回读绑定回填（`:536-541`）、用户手改（`:944-965`）；而 `manifest.versions` 从头到尾不参与该值。`publicationRevision` 只做 CAS，与任何版本号都无推导关系（`module-game-distribution/src/domain.rs:27-40` 的版本号解析只比 `max_existing` 与 `requested`）。
@@ -9617,6 +9625,15 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 - 边界（未验证）：macOS 真机的 sidecar 加载与 `check-macos-bundle.mjs` 包内容门禁未在本机验证；Linux 门禁按新配置不再要求 sidecar 资源，需 CI 实跑确认转绿。
 - 关联：issue #519、master `fb130d184`、`docs/technical/【技术方案】AGC随包资源staging归位-2026-09-26.md`、CI run 3083。
 
+## 2026-10-04 AGC 窗口标题栏项目标签改认「当前项目」，运行中项目降级为圆点与徽标
+
+- 背景：issue #618。窗口标题栏那枚标签原来被「正在运行的项目」整块接管——`WindowChrome` 只要存在活动回合或运行快照读取失败，就把当前工作区标题换成 `ActiveProjectRunsPanel`（titlebar 形态），主文案取开始时间最晚的在跑项目。于是「当前项目没在跑、后台别的项目在跑」时，标签显示的是别的项目（现场：当前项目 `gameagent-ff7f3240`，标签 `gameagent-c3af9c7e`），用户以为自己开错了项目；读取失败时标签还会变成「正在运行的项目读取失败」，同样顶掉当前项目名。
+- 决策（主文案）：标签主文案恒为当前项目名，与当前项目是否在跑回合无关；不在项目内（首页 / 项目组 / 模板库）才回落到最后开始的在跑项目（该回落按视图门控，见 2026-10-05 条目）。名字由 `WorkspaceLauncher` 经 `WindowChromeActiveProjectRuns.currentProjectName` 发布（`currentProjectContext.projectName`，即清单项目名）。这同时消掉了同一项目「有回合在跑显示目录名、没在跑显示项目名」的两种口径。
+- 决策（运行态）：圆点 + 运行中数量徽标（≥1 即显示）+ 展开菜单；菜单里当前项目那一行用与标签同名的项目名，meta 首位带「当前」标记，`aria-current` 保留。读取失败改成告警色圆点 + 菜单内一行结论；只有既没有在跑项目、又没有当前项目可显示时才保留原来的纯提示。
+- 有意未做：后台项目在菜单里仍是目录名（快照 `projectName` 由 Rust 取 `thread_id` 目录名）。改成清单项目名要在 `ThreadManager` 的 claim 路径里读 `.agent/manifest.json`，等于给纯内存模块加锁内文件 I/O，本轮不做。
+- 影响范围：`apps/ai-game-creator-shell/src/components/WindowChrome.tsx`、`src/components/windowChromeContext.ts`、`src/features/app-shell/ActiveProjectRunsPanel.tsx`、`src/features/app-shell/WorkspaceLauncher.tsx`、`src/styles.css` 与两个定向用例文件；同步修正主规范 2026-09-15 段的标题栏条目、里程碑文末修订与实施计划 `修改顺序` 条目。不改 Rust、快照命令字段、公共 API 与持久化。
+- 验证方式：`npx vitest run apps/ai-game-creator-shell/tests/directActiveTurns.test.tsx apps/ai-game-creator-shell/tests/WindowChrome.test.tsx apps/ai-game-creator-shell/tests/workspaceWindowSync.test.tsx` → 22 passed（三条新回归：别的项目在跑时标签仍是当前项目、当前项目自己跑时列表带「当前」、读取失败不顶掉当前项目名）；评审后续修订后为 25 passed，见下条。全量 `npm run test -- apps/ai-game-creator-shell/tests` 与真实 Chromium 冒烟见 PR。
+- 关联：issue #618、`docs/project-memory/plans/【里程碑】Direct回合跨页面生命周期与运行中项目可见性-2026-09-15.md`（2026-10-04 修订）。
 
 ## 2026-10-04：Direct 普通操作与交付复核解耦
 
@@ -9647,3 +9664,13 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
 - Linux 排除僵尸时必须保守处理不完整扫描；数字 PID 的读取/解析不确定性不能成为组已空的证据，已确认消失的 PID 可以忽略。
 - 正常关闭连接的迟到通知不创建或覆盖成功回合的终态报告；无合同收尾新产生的预算报告优先返回，其他真实关闭错误保留。
 - 权威边界见[Direct 合同规则](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#宿主验收与执行许可合同)。视觉/玩法判据和预算值不变。
+
+## 2026-10-05：AGC 标题栏项目标签评审后续（空态、视图门控与文案）
+
+- 背景：对 issue #618 的标题栏修复做 PR 评审，发现四处与文档或组件自身注释相反的行为，逐条修正；#618 现场（当前项目没在跑、后台别的项目在跑）的结论不变。
+- 面板形态误报读取失败：`ActiveProjectRunsPanel` 的空态早退只判「没有在跑回合」，把「快照读取成功、只是没有在跑回合」渲染成「未能读取正在运行的项目」。补回 `!readFailed` 守卫；`panel` 是默认 prop，唯一生产调用方 `WindowChrome` 恒用 `titlebar`，但组件注释对外宣称面板布局可复用。
+- 会话残留的项目身份：`currentProjectContext` 是会话级状态（离开工作台不清空），活动回合快照却是全局轮询；照搬上下文会让首页 / 项目组 / 模板库上的标签一直写「当前项目：<上次打开的项目>」，徽标数字却属于别的项目，也让「不在项目内回落到最近启动的在跑项目」实际不可达。发布时按 `launcherView === 'project-development'` 门控 `currentProjectPath` / `currentProjectName`，与同文件窗口标题 effect 同口径。
+- 文案去重：读取失败结论曾在菜单头部与 `role=status` 行连排两遍，头部改为只报数量；回落态触发文案原为「正在运行的项目：X；正在运行 N 个项目」，拆成「作用域 + 运行状态」（回落态作用域记为「最近运行的项目：X」，状态位「共 N 个项目在运行」）；数量徽标补 `title` 说明数字含义。
+- 仍有意不做：后台项目在菜单里是目录名；判定 `aria-current` 的路径匹配仍是 `projectPathsMatchForInvalidation`；不改 Rust、快照命令字段、公共 API 与持久化。
+- 验证方式：`npx vitest run apps/ai-game-creator-shell/tests/directActiveTurns.test.tsx apps/ai-game-creator-shell/tests/WindowChrome.test.tsx apps/ai-game-creator-shell/tests/workspaceWindowSync.test.tsx` → 25 passed；对照旧实现分别临时禁用 `launcherView` 门控、去掉面板空态守卫，对应用例各自转红。真机运行时证据仍缺，见里程碑文末「仍未取得证据」。
+- 关联：issue #618、本文件上一条（2026-10-04 标题栏项目标签）、`docs/project-memory/plans/【里程碑】Direct回合跨页面生命周期与运行中项目可见性-2026-09-15.md`（2026-10-05 修订）。

docs/project-memory/shared-memory/pitfalls.md

@@ -11,6 +11,26 @@
 - **门禁**：`npm run check:nginx-spa-routes` 对三份模板断言该 `^~` location 存在、块内清空 Cookie、代理头齐全且排在通用 `/api` location 之前（变异验证：删掉块内 `proxy_set_header Cookie "";` 立刻报「播放会话前缀 location 缺少代理片段」）；`npm run check:pingora-route-parity` 断言矩阵 `play_sessions_gateway` 用例声明清 Cookie 片段、不复用通用 `/api` location，且 Rust `classify_path` 的播放会话分支排在通用 `/api` 之前（变异验证：把矩阵片段换成通用 location、或在 Rust 里交换两个分支，各自单独判红）；`npm run check:pingora-gateway-smoke` 用真实网关二进制断言该前缀清 Cookie、创建会话端点保留 Cookie。三条都串在 `npm run lint` 链里，有自动调用方。
 - **关联**：`server-rs/crates/pingora-gateway/src/main.rs`、`deploy/pingora/nginx-route-parity.matrix.json`、`deploy/nginx/README.md`、`vite.config.ts`；另见本文件「主站 SPA allowlist 有三处真相源」条的「别踩」（发行入口不转发 Cookie 的同族规则）。
 
+## 2026-10-04 把非素材任务塞进「生成任务」账本：taskType 维度、v1 兼容与 live 集合
+
+- **现象**：首页「AI 项目命名」改成进「生成任务」列表后，第一次读账本（工作台打开项目就会读）就把那条还在跑的命名任务标成**失败**；随后前端的终态推进被拒（记录已终态）。
+- **根因**：账本的中断收口判据是「非终态 + 不在本进程 live 集合」= 上次运行的残留。素材生成任务由 Rust 后台任务在 `start` 里先登记 live 再落账本；项目命名任务由前端驱动（`enqueue` / `update` 两条 IPC），没有登记 live，于是任何一次 `list_local_project_asset_generations` 都把它当成残留收口。
+- **处理（现行口径）**：账本记录加 `taskType`（`asset-generation` / `project-naming`，缺省 `asset-generation`）、`kind` 变可选；schema 升 `agc-asset-generation-task.v2`，读取同时接受 v1 与 v2（v1 记录按素材任务读回）。`enqueue_local_project_naming_task` 写账本前登记 live（写盘失败只回滚本轮插入的那条），`update_local_project_naming_task` 在非终态时幂等登记、终态写盘成功后摘除。命名没有素材可交叉核对，中断收口一律 failed 且文案与素材口径区分（不含「目标素材」）。
+- **边界**：命名任务的结论文案（已应用 / 用户已改名跳过 / 失败保留兜底名）由命名链路给出；账本只是展示旁路——`enqueue` / `update` 失败只写诊断日志，绝不影响建项、命名与首轮创作。前端按 `taskType` 把命名记录从素材任务列表里剔除（素材分支会按 `kind` 解析），命名行固定展示名「AI 项目命名」，只在终态显示结论。
+- **边界（兼容是单向的，必须写清）**：**新构建读旧账本 OK，旧构建读新账本会失败**——命名记录写 `"kind": null`，而旧构建（`AssetGenerationTaskRecord.kind` 必填且 `read_ledger` 不校验 schema）解析含命名记录的账本会**整份失败** → 面板报「生成任务列表读取失败」，且同一次读里在途的素材任务会被按「上次运行中断」收口为失败。触发条件只有「同一项目先被新构建写过命名任务、之后又被旧构建打开（降级或新旧混跑）」。潜在的低成本正向兼容方向（**未实施，需先确认**）：命名记录也写一个合法 `kind`（例如 `unknown`）只靠 `taskType` 区分——旧构建会把它渲染成一张名为「AI 项目命名」的素材任务卡，但账本能解析、不会误伤在途素材任务。
+- **边界（前端读快照的时序）**：命名行的推进发生在本组件之外，刷新只能靠「变更事件 + 一次受控快照读取」。**必须先订阅再读**（与素材队列「先订阅后派发」同口径）：先读后订阅时，落在这一次 IPC 往返里的终态事件没有消费者、直接丢掉，行会永久停在「命名中」；订阅失败时退化为「进项目读一次 + 面板打开时补读」。补读兜底必须有，但**有门控**：仅当列表里确实存在一条在途命名行时才读——没有命名任务的项目不该因为打开面板就多打一次账本 IPC，那会改变「轮询计数」这类外部可观测行为（既有生成任务用例正是按轮询次数推进 mock 的）。
+- **边界（update 的门禁与终态语义）**：`update_local_project_naming_task` 与 `enqueue` 共用 `project.rename` 权限位，并校验记录 `project_id` 与项目一致；记录一旦终态只接受**同状态幂等重放**，改写成另一种状态（含 `completed → failed`）一律 Err 且不写盘——否则一次迟到的排队/失败事件会覆盖已落定的命名结论。
+- **判据/取证**：Rust `cargo test … asset_generation_task` 27 条（含 `naming_task_stays_in_flight_across_ledger_reads_until_terminal`、`naming_task_update_requires_the_project_rename_permission`、`naming_task_update_rejects_a_record_from_another_project`、`naming_task_terminal_state_rejects_a_different_status_but_allows_the_same_one`、`ledger_with_an_unsupported_schema_version_fails_closed`、`ledger_without_a_schema_version_is_accepted_as_v1`）与 `conditional_project_rename_tests` 7 条（含超长名失败关闭）；前端 `homeProjectNamingAsync.test.tsx`（入队→running→终态的推进序列）、`projectNamingGenerationTaskRow.test.tsx`（行渲染）、appSurface 的「syncs the workbench title and recent project list with the AI name after creation」「recovers the naming row when the terminal event lands before the subscription is ready」「re-reads the naming ledger when the generation tasks panel opens」（后两条已做「改前红」验证：退回「先读后订阅 / 面板打开不补读」两条即红）。
+- **关联**：`apps/ai-game-creator-shell/src-tauri/src/asset_generation_tasks.rs`、`apps/ai-game-creator-shell/src/features/app-shell/useHomeProjectCreation.ts`、`apps/ai-game-creator-shell/src/features/resource-canvas/resourceCanvasAssetGenerationTaskModel.ts`、`apps/ai-game-creator-shell/src/view/project-development/index.tsx`。
+
+## 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 随包 plugins 的 feature 档位必须与消费方一致，且门禁会因 build.rs 未重跑而假通过
 
 - **现象**：Windows 本机 `npm run check:generated-bindings`（`npm run lint` 链内，`scripts/check-repository-ci.sh` 的 Repository checks 也走它）在 `build.rs:167:29` panic：`插件随包资源校验失败：随包插件存在未声明文件：.../src-tauri/resources/plugins/agc-godot-editor/native/gdextension/bin/win-x64/agc_godot_editor.dll（目标 x86_64-pc-windows-msvc 与当前 feature 组合不允许；请先执行随包资源准备步骤）`；树上换成 `agc-unity-editor/dotnet/publish/win-x64/Agc.Unity.Attach.exe` 时报同一类错。反向还有更隐蔽的形态：门禁 2 秒就 exit 0 说「通过」，但 tree 上其实带着编辑器产物。