feat(chat): 双端对齐 Composer 工具栏与上下文计量

[GreyGunG]

关联

Closes #157

摘要

为 桌面端 GUI 与 Gateway WebUI 对齐增强 ChatComposerBar 输入区工具栏，并补齐上下文计量、导出与压缩相关边界处理。

功能

• 上下文占用：展示估算用量 / 比例，支持 usage 观测锚点（含 total_tokens snake_case）
• 手动压缩（桌面端）：运行锁、Gateway running 快照、中止清理、失败提示不重复
• 导出 Markdown：完整历史水合；busy / 未加载完 / 离线 has_more 时拒绝静默缺页导出
• 附件：剪贴板图片、截图（桌面）；上传目标锁定防止切会话串台
• 更多菜单：会话费用、清空草稿、Prompt 模板、窄屏 overflow

双端文件

区域	主要路径
GUI	ChatComposerBar.tsx、ChatPage.tsx、contextUsage / conversationExport / clipboardCapture、compaction/controller
WebUI	对应 ChatComposerBar、GatewayApp、同名 lib 模块
i18n	中英文 chat.toolbar.*

测试

• 新增/更新：clipboard-capture、context-usage、conversation-export、compaction-controller 等单测
• 本地曾跑 GUI / WebUI 相关 npm test（composer 相关用例通过）

审查说明

• 基于最新 main（含楼层导航等既有能力）移植，避免整树覆盖
• WebUI 手动压缩仍按「仅桌面可用」策略（工具栏提示）
• Codex（CPA / gpt-5.6-sol）审核：0×P0 / 0×P1

自检清单

• 双端工具栏能力对齐
• 导出/压缩/计量边界保护
• 关联 issue feat(chat): 双端 Composer 工具栏（上下文占用 / 压缩 / 导出 / 附件） #157
• 中文 PR 描述

[su-fen]

Review：暂不能直接合入（分支自身质量不错，但有 2 个合并阻塞项 + 1 个镜像纪律问题）

先说好的：在 PR 分支上双端测试全绿（GUI 1075 / WebUI 368）、tsc 与 biome 干净，i18n 37 个新键 zh/en 双端完全对齐；上传目标锁、手动压缩的 run lock / abort / prune 降级、导出的 busy / hydrating / has_more 拒绝保护都做得很细。

阻塞项

1. 与当前 main 有合并冲突

PR 基于 924f1d9，落后 main 6 个提交。之后合入的 9db1d0f（#159 composer 展开按钮）改了同样的文件，git merge-tree 确认两端 ChatComposerBar.tsx 均冲突：

• crates/agent-gui/src/pages/chat/components/ChatComposerBar.tsx
• crates/agent-gateway/web/src/pages/chat/ChatComposerBar.tsx

展开按钮涉及 FLIP 动画、高度上报冻结等不变量密集代码，rebase 时需要把两个工具栏改动手工织合（双端各一份），请务必保住展开功能的行为。

2. 自动合并产物有隐性编译错误（icons.tsx 重复导出）

main 已为展开按钮在 web 端 icons.tsx 添加了 Minimize2，本 PR（压缩图标）也添加了同名导出。git 合并该文件不报冲突，但产物会出现两条 export const Minimize2（重复声明，tsc 直接报错）。解决冲突时请一并去重；GUI 端 icons 无此问题。

3. 镜像文件在本 PR 内已经分叉（conversationExport.ts）

两端 lib/chat/conversationExport.ts 不是字节一致：pushContextBlocksFromRound 的 usage 锚点挂载策略和 toolResult 输出顺序完全相反（GUI 版把 usage 挂到轮次末尾、web 版挂到 assistant 消息上并把 toolResult 后置），两边注释还互相矛盾。且：

• GUI 端这两个 transcript-row 函数实际是死代码（GUI 用真实会话消息估算），新增单测测的恰是死代码变体；
• web 端真正在用的变体反而没有任何测试；
• 三个新 lib 文件（contextUsage / clipboardCapture / conversationExport）都没加进 scripts/mirror-manifest.json，CI mirror check 因此"通过"了实际已漂移的文件。

请统一两端实现为同一份代码、加入 manifest，并给 web 在用的路径补测试。

非阻塞建议

• customHeaders 类型回退：compaction/types.ts 删除了 customHeaders 字段——这是 main 上 263889d（7/19，自定义请求头支持，已在本 PR 基点内）刚加的，等于悄悄回退了该改动。目前行为无变化（bindTurn 从未传该字段），但把"压缩摘要请求缺自定义头"固化了。建议恢复该字段。
• WebUI busy 期 1s 全量轮询：流式期间每秒对全部 transcript rows 做 flatten + 对所有工具参数/结果 JSON.stringify，长会话下开销可观。1 Hz 且不在渲染路径上尚可接受，留意即可。
• 桌面端截图/剪贴板走 Web API（getDisplayMedia / navigator.clipboard.read），在 Tauri WKWebView 上的支持情况存疑，虽有优雅降级，建议桌面端实机验证功能真的可用。
• 成功提示复用了 "warning" 级 toast（NotifyItem 只有 warning/error 两级），小 UX 瑕疵，可后续统一。

结论

请：① rebase 到最新 main，解决两端 ChatComposerBar 冲突并去重 web icons 的 Minimize2；② 统一 conversationExport.ts 两端实现并加入 mirror-manifest、补 web 侧测试；③ 恢复 compaction types 的 customHeaders。完成后重跑双端测试即可再审合入。

[github-actions]

This PR has been inactive for 14 days and is marked stale. It will be closed in 14 days if there is no further activity. Push an update or comment to keep it open.