fix(frontend): round-64 批2——desktop 右键「转发」接上真 Hub mutation + toast.actionUnavailable zh/en 键落地(不再谎称「请重试」) + 消息动作 port 假注释订正 (#2241)

[DeliciousBuding]

这是什么

round-64 wave 批 2（tracker #2241），lane B。批 1（edge 审批门属主化 + hub health 兜底诚实化）已在 #2242 合入 master 4a7af8c6；本分支已 rebase 到该 master，rebase 无冲突（批 1 只碰 Go 与 api/openapi.yaml，本 PR 只碰 app/**）。

3 个 commit，均带 (#2241)：

1. fix(i18n) — 补 toast.actionUnavailable 的 zh/en 键。workbenchTranscriptChromeActionMappers.ts:545 早已导出 UNAVAILABLE_ACTION_TOAST_KEY = 'toast.actionUnavailable' 并在 7 个调用点（:625/:660/:693/:709/:725/:741/:757）使用，但 chatview bundle 里没有这个键 ⇒ i18next 回落判据 resolved !== KEY 不成立，announceUnavailableAction 落到 effect.failureMessage，用户看到的是「…失败，请重试」——一句对「这个端根本没接线」的错误指导。
2. docs(workbench) — 订正 AgentHubWorkbenchTypes.ts:165-171 的假注释。原文称 "Desktop/demo shells omit them and pin/unpin/recall/react stay hidden ([P1] 假内容与假交互清理：任务页/上下文菜单/设置项/demo 身份 #1818)"，与 workbenchTranscriptChromeHelpers.ts:515-531 的逐 action capabilities、以及 Desktop 确实设 activeConversationId 并接线 pin/unpin/recall（[整理] 静态审计 backlog 跟踪（探索 lane 剩余项） #2154）的事实矛盾。
3. feat(desktop) — 接上 Hub 转发 mutation：新增 desktop/src/api/sessionQueries.ts 的 useHubForwardMessage，在 App.tsx 接线 onForwardMessage，desktop 右键「转发」条目重新渲染并真派发（此前 fix(frontend): desktop 消息右键菜单死条目收口——pin/unpin/recall 接上已有 mutation、forward/regenerate 按 handler fail-closed、派发器 7 处静默 break 改为一次可感知反馈 (#2154) #2238 按 fail-closed 把它关掉了，因为缺 port；现在 port 补上了）。

regenerate 明确不接线：regenerateAgentTask 在 Desktop 的 DesktopHubTaskBridge / agent task 语义下未经验证，接了等于把未证语义推给用户 ⇒ 保持 fail-closed，onRegenerate / onAddMessageReaction 的 undefined 断言原样保留。

证据（本机实测）

红→绿双向：

• 任务 1 红（临时抽掉 zh/en 两行键）：workbench unavailableActionToastI18n.test.ts expected 'toast.actionUnavailable' to be undefined（i18next 把键 echo 回来）3 failed；shared resources.test.ts expected undefined to be '该操作在当前端未接入' 3 failed | 12 passed。绿：shared 15 passed（基线 12 + 新 3）、workbench 97 passed（基线 92 + 新 5）。
• 任务 3 红（把 App.tsx 的 onForwardMessage 整块注掉）：onForwardMessage must reach the workbench deps: expected undefined to be type of 'function'，1 failed | 3 passed。绿：desktop messageActions + App.v4 共 18 passed。
• 写集外夹具红证据：抽掉 App.v4.test.tsx 那 1 行 vi.mock 导出 ⇒ 12+ 用例全红；补回 ⇒ 14 passed（该文件任何断言一字未改）。

主机侧独立复跑（rebase 到 4a7af8c6 之后）：

pnpm --filter agenthub-desktop exec vitest run src/__tests__/App.messageActions.test.tsx src/__tests__/App.v4.test.tsx
  → Test Files 2 passed (2) / Tests 18 passed (18)   35.16s
pnpm --filter @agenthub/workbench exec vitest run src/__tests__/forwardMenuPort.test.tsx src/__tests__/unavailableActionToastI18n.test.ts
  → Test Files 2 passed (2) / Tests 5 passed (5)     11.34s
git diff origin/master --stat -- .github scripts/verify Makefile \
    app/workbench/src/workbenchTranscriptChromeActionMappers.ts app/workbench/vitest.config.ts
  → 空（判卷面 + 7 个调用点所在文件一行未动）
resources.ts:317 'toast.actionUnavailable': '该操作在当前端未接入'
resources.ts:1216 'toast.actionUnavailable': 'This action is not wired in this client'   ← zh/en 键名逐字一致
App.tsx:741 messageId.replace(/^hub-message-/, '')  ← 与 pin/unpin/recall 的 :707/:717/:727 逐字同形态，且同样 gate 在 chatActions 上

lane B 自跑门禁（HEAD 7c3a92c5，rebase 前）：

verify-i18n-deadkeys.py      → i18n dead-key gate ok (bundles: 2, dynamic prefixes: 6)
verify-i18n-terminology.py   → i18n terminology gate ok (zh definition surfaces scanned: 5)
verify-i18n-callsites.py     → baseline 78 files/608 CJK lines; current 74/597; PASS: current <= baseline
tsc --noEmit                 → workbench 0 / desktop tsconfig.app.json 0 / desktop tsconfig.json 0 / shared 0
eslint（改动的 7 个文件）    → 0 新增 problem（App.tsx:266 `tIm` useMemo warning 与 Types.ts:81/:85 4×no-invalid-void-type
                               均经 master blob 探针确认为 pre-existing，未顺手修）

两处需要 reviewer 知情的取舍

1. 删了一条既有断言：App.messageActions.test.tsx 的 expect(props.onForwardMessage).toBeUndefined()。它的前提写在它自己的注释里——"forward needs a useHubForwardMessage port"，即「desktop 没有这个 mutation 所以只能是 undefined」；本 PR 的交付物正是补上该 hook 并接线，接线后该断言与事实相反。处理：只删这一条，同 test 内 onRegenerate/onAddMessageReaction 两条 fail-closed 断言原样保留；另在「chatActions 缺失」那个 test 里新增 expect(props.onForwardMessage).toBeUndefined()，保住 [整理] 静态审计 backlog 跟踪（探索 lane 剩余项） #2154 的 fail-closed 不变量（demo / Hub 未就绪时条目仍不渲染）。测试数只增不减（3 → 4）。
2. commit 02a1dee0（原 5cd150e1）的注释里已写 "plus forward ([整理] round-64 wave：edge 审批门零属主(安全 P1) + desktop 菜单尾巴(前端/i18n) + health/version 诚实化(可观测性) #2241)"，而 forward 由紧随其后的 commit 才落地 ⇒ 该中间 SHA 上注释超前一句；分支 tip 与 squash 后的结果完全为真。squash merge 会消掉这个中间态。

未验证（如实）

• coverage 未跑、全量 vitest 未跑、pnpm -r build 未跑、web/mobile 包测试未跑（4 核机 + 本轮纪律）⇒ web src/App.test.tsx 的 10 passed 基线未本地复跑。本 PR 不含 web 文件，但 resources.ts 是 web 也吃的 bundle ⇒ 由 CI 的 frontend-web / frontend-required 判。
• packaged Desktop（Tauri）真点击路径未验证：本机证据等级＝vitest + jsdom 真实渲染（真实 AgentHubWorkbench / 真实 i18next bundle / 真实 hubClient.forwardMessage 方法调用，仅在 client 边界打桩），不是 packaged 端到端；按 AGENTS.md §10 标注 real_tested=false（无真 Hub 往返）。
• forward 成功后目标会话是否即时刷新未在真 Hub 上验证（失效 ['hub','sessions']，与 pin/unpin/recall 及 web 侧同契约）。
• 环境偏差（不进 git）：本 worktree 原本没有 app/node_modules，按 fix(frontend): desktop 消息右键菜单死条目收口——pin/unpin/recall 接上已有 mutation、forward/regenerate 按 handler fail-closed、派发器 7 处静默 break 改为一次可感知反馈 (#2154) #2238 同款做法软链到主 checkout、包级 @agenthub/* 重建为指向本 worktree（readlink -f 已验证跑的是本分支代码），未跑 pnpm install。

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: c6138a0c-0c3e-493a-aa27-d0e1584ff01f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}