Merge pull request '修复：AGC 窗口标题栏项目标签改认当前项目（#618）' (#621) from fix/agc-titlebar-project-label into master

Reviewed-on: http://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/621
2026-10-05 16:11:16 +08:00
parent 6af965dab8 45ae29461c
commit 21c79f54a4
12 changed files with 482 additions and 87 deletions
@@ -29,7 +29,7 @@ Milestone: `【里程碑】Direct回合跨页面生命周期与运行中项目

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

@@ -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` 门控与去掉面板空态守卫，对应用例各自转红（回归用例确有判别力）。
+- 仍未取得证据（需要真实运行）：真机重新进入正在跑的项目后恢复忙碌态与进度、标题栏入口点击进入对应项目、回合结束后可再次发送。
@@ -9614,6 +9614,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 普通操作与交付复核解耦

@@ -9644,3 +9653,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 修订）。