[Grok/dsh 64] Ship 浏览器图与终端一致性

[Blackman99]

Parent

#132

Ticket: 64

Status: ready-for-agent

User Stories: 68（见父规格）

What to build

启用 Ship 的用户可打开既有本地浏览器图，查看与 Rust 终端一致的任务、回答、依赖和实时状态。

Acceptance criteria

• 复用同一持久化状态来源，在已迁移首阶段验证实时更新、断线重连、恢复与图缓存重建不丢问答或误报完成；完整运行状态在完整 Ship 迁移票补验。
• 本地服务监听和访问边界明确，关闭扩展/会话后按约定清理，不无意对外公开内容。
• 使用 agent-browser 实际点击、展开、导航和重连，检查所有共享状态路由、空/长/缺失内容。
• 桌面与移动视口均检查交互与布局并保存截图；单张渲染截图或仅单元测试不能算验收。

Blocked by

• [Grok/dsh 63] Ship 可选安装与首阶段接入 #195 — Ticket 63: Ship 可选安装与首阶段接入

Delivery contract

用户于2026-09-20批准当前测试与任务拆分。按父规格的已安装产物/真实终端和公开协议测试验收；实际实现须带适用的文档、Changeset及必要检查。ready-for-agent表示任务已定义，不表示前置任务已完成，也不授权自动开始本轮实施、购买付费资源或发布软件版本。

[Blackman99]

已集成到 rewrite/grok-dsh-20260920：493c0e2

• 推送：快进 e896d31..493c0e2（未强推）。
• 变基：基于包含 [Grok/dsh 41] 子代理消息与续接 #173（e02467f）与 [Grok/dsh 54] 记忆捕获、整理与诊断 #186（e896d31）的最新分支变基，无冲突；CONTEXT.md、CONTRIBUTING.md、README、mock LLM 等双方新增内容均保留。

实现

• 同一状态来源：Ship 插件的 hook 按会话启动 loopback 服务（ship-web.mjs），图数据每次从规格文件、answers.json（合并待写入回答）与本地票据实时联合生成；<spec>.ship.graph.json 缓存只重建、不作为来源，损坏或删除后由下一次 hook 重写且保留全部问答；联合出错时返回 503 并停用运行，不误报完成。
• 终端一致：/ship 时及图变化后，终端打印一行 Ship graph · <规格> · Status · 待认领/已认领/已关闭 · X of Y decision answers recorded · <url>，与浏览器图的计数一致。
• 访问边界：仅监听 127.0.0.1，URL 带随机 token；Host 必须是 127.0.0.1/localhost（否则 421），只允许 GET/HEAD（否则 405），只提供 index/graph.json/两个静态资源（其余 404），带 CSP、no-store、nosniff、no-referrer；记录文件权限 0600、目录 0700。
• 清理：新增 SessionStart/SessionEnd hook（共 4 个），会话结束即关闭端口；--continue 恢复同一会话时沿用同一 URL，页面自动重连；codsh 宿主进程退出、记录变更或插件数据被删除（卸载）时服务自行退出；无宿主时 30 分钟空闲退出。
• hook 宿主：命令 hook 输出的 systemMessage 作为提示显示（标注来源如 plugin:ship），hook 环境新增 CODSH_HOOK_HOST_PID。
• 旧版浏览器页面的 graph.json 改为相对路径请求，以便挂在 token 路径下。
• 测试基础设施：e2e/vt.ts 只对未读流开头 64 个码元做字形切分（之前长会话每个字符都把整段流交给 ICU，内存可达数 GB），输出不变。
• 文档：CONTEXT.md、README/README.zh、packages/cli/README、插件 README（新增 Browser graph 一节）、CONTRIBUTING（agent-browser 用法）；Changeset rust-ship-browser-graph.md（codsh-cli、codsh-bundle patch）。

检查（干净环境，Linux）

• 新增 scripts/rust-ship-web-pty-test.py：真实 Rust 终端 + 无头 agent-browser/Chromium，桌面 1440×900 与移动 390×844 两个视口。流程：空图 → 实时地图（不刷新） → 点击展开/折叠全部、适配视图、阶段折叠按钮、导航（01 Wayfinder、原始需求、Ship 目标）、点击票据并按依赖关系跳转、长回答卡片滚动与详情、缺失回答显示 “No user answer recorded” → 第三个回答实时出现 → 退出会话后端口关闭、页面显示 “Disconnected · retrying” 并保留最后的图 → --continue 同一 URL 重连 → 损坏缓存无影响、再回答后缓存重写且问答齐全、删除缓存仍正确 → 卸载插件后服务停止、页面断开。变基后通过，保存 20 张截图（box 本地 /tmp/codsh-rust-ship-web-acorupdx/）。
• rust-ship-pty-test.py、rust-plugin-content-pty-test.py：通过。
• pnpm test（vitest）：变基前 2532 通过 / 15 跳过；变基后 2546 通过 / 2 失败 / 15 跳过，2 个失败均在 rust-goal.spec.mjs（负载下的时序问题），单独重跑 19/19 通过。新增 ship-extension-web.spec.ts 9 项、rust-ship-extension.spec.mjs 生命周期测试、rust-hooks.spec.mjs systemMessage 解码测试。
• 旧版 e2e：pty-ship*.e2e.ts 4 个文件 14 项通过；使用 vt 的 e2e（pty-input/folds/session、experience-*）6 个文件 76 项通过。
• tsc --noEmit 通过；cargo fmt --check、cargo clippy -D warnings（-A dead_code -A clippy::needless_return）通过；cargo test --workspace：1689 通过、2 忽略、4 个已知既有失败（filesystem_sandbox ×2、privacy drafts、voice substitute_route）。Rust 仅更新了一个插件测试的 hook 列表断言。

未验证 / 说明

• macOS 未运行；rust-hook-pty-test.py、rust-plugin-pty-test.py 仅限 macOS，本次未跑。
• 未用真实模型验证，只用 mock LLM。
• 完整 Ship 运行状态按约定留到完整 Ship 迁移票 [Grok/dsh 76] Ship 完整流程与恢复验证 #208 补验。
• TUI 里的 hook 提示行显示在本轮回答块中（位于工具调用上方），长回合时可能需要滚动才能看到。
• agent-browser 作为外部工具使用（非仓库依赖），通过 AGENT_BROWSER/AGENT_BROWSER_EXECUTABLE_PATH 指定。

main、npm、发布、默认版本和 PR #213 均未改动。#208 的前置已解除。