@@ -6,29 +6,29 @@ Status: implemented
## 问题
Web GUI 以一条真实组装链交付——chromium 页面 → client 插件 bundle → HTTP 单次 RPC + 两条 SSE（ ） `toFetchHandler` /apiproxy → host 端的 agent loop（ ） GUI 测试体系 ](../process/2026-07-20-gui-testing-system.md )覆盖第 1 层（ `FixtureApiClient` ——没有 host、没有 wire、没有 agent loop——而全链路冒烟需要 `DEEPSEEK_API_KEY` 和真实模型，因此不确定、在无密钥 CI 中自行跳过。[docs/testing.md ](../../../../docs/testing.md ) 的快照哲学——带密钥录制一次、永久无密钥回放、格式变动时刷新——已覆盖 ACP（ ） `stream-json` 与 TUI 三个文本记录（ transcript） ； ： （ ）
Web GUI 以一条真实组装链交付——chromium 页面 → client 插件 bundle → HTTP 单次 RPC + 两条 SSE（ ） `toFetchHandler` /apiproxy → host 端的 agent loop（ ） GUI 测试体系 ](../process/2026-07-20-gui-testing-system.md )覆盖第 1 层（ `FixtureApiClient` ——没有 host、没有 wire、没有 agent loop——而全链路冒烟需要 `DEEPSEEK_API_KEY` 和真实模型，因此不确定、在无密钥 CI 中自行跳过。[docs/testing.md ](../../../../docs/testing.md ) 的快照哲学——带密钥录制一次、永久无密钥回放、格式变动时刷新——已覆盖 ACP（ ） `stream-json` 与 TUI 三个 transcript（文本记录 ） ； ： （ ）
## 决策
`pnpm run test:web` 携带 `apps/web/tests/` 下的无密钥、确定性浏览器 e2e 车道：录制的会话日志 fixture 经 `@deepseek-ai/dsh-llm-replay` 对真实进程内 web 组合回放；用户可见状态使用规范化的 aria 预期输出，持久世界状态则使用进程内断言。配套的产品契 约包括 `dsh-llm-replay` 的节奏控制、消费检查与已校验的索引式覆写 patch； `dsh-llm` 失败通过自有数据属性保留经校验的提供方信息；已交付的 web 组合挂载 `llm-retry` ，以处理瞬态模型失败。
`pnpm run test:web` 携带 `apps/web/tests/` 下的无密钥、确定性浏览器 e2e 车道：录制的会话日志 fixture 经 `@deepseek-ai/dsh-llm-replay` 对真实进程内 web 组合回放；用户可见状态使用规范化的 aria 预期输出，持久世界状态则使用进程内断言。配套的产品约定 包括 `dsh-llm-replay` 的节奏控制、消费检查与已校验的索引式覆写 patch； `dsh-llm` 失败通过自有数据属性保留经校验的提供方信息；已交付的 web 组合挂载 `llm-retry` ，以处理瞬态模型失败。
### Scaffold：
一个普通的共享 fixture 模块（[测试政策认可的形态 ](../../../../docs/testing.md )），不是包：值得门禁把守的逻辑——回放推导、会话解析、日志脱敏、持久化——都在已受门禁的包 `dsh-llm-replay` 、`dsh-acp-snapshot` 、`dsh-session-persistence-jsonl` 中；剩下的只是启动接线和浏览器胶水，而驱动 chromium 的源码在无浏览器的覆盖率 runner 上无法诚实保持逐文件 100% 覆盖率。
`launchWebScaffold()` 通过 vendored Loader 的 include 机制，从交付的 `apps/cli/config/base.cordis.yml` 与 `apps/cli/config/web.cordis.yml` 启动真实 web 组合——与 `AppCLIEntry` 为 `dsh web` 驱动的是同一棵树、同一套机制。差异全部经 include patch 覆盖在这棵树上，即 ACP `cordis.snapshot.yml` 模式的进程内表达：临时 `persistenceRoot` ；每个主机级 `skill-local` 根目录（`dshHome` 、`agentsHome` 和 `bundledSkillDir` ）都钉在临时工作区下并禁用监听，因为环境 skill（ ） ； `workspace-context` （录制的 fixture 不得嵌入本仓库的 AGENTS.md） ； `session-title-llm` （ ） ； ； `llm-deepseek` 。patch 的 id 一旦不再匹配任何行， `chdir` 下运行，使 api-gateway 的 `process.cwd()` 会话默认值、工具 cwd 与 fixture 一致；`dsh web` bin 自身的胶水（ ） `smoke-real.e2e.ts` 中的无密钥 CLI 冒烟把守。初始化回滚和正常关闭都会先对 Cordis 树执行 dispose（ ） ，
`launchWebScaffold()` 通过 vendored Loader 的 include 机制，从交付的 `apps/cli/config/base.cordis.yml` 与 `apps/cli/config/web.cordis.yml` 启动真实 web 组合——与 `AppCLIEntry` 为 `dsh web` 驱动的是同一棵树、同一套机制。差异全部经 include patch 覆盖在这棵树上，即 ACP `cordis.snapshot.yml` 模式的进程内表达：临时 `persistenceRoot` ；每个主机级 `skill-local` 根目录（`dshHome` 、`agentsHome` 和 `bundledSkillDir` ）都钉在临时工作区下并禁用监听，因为环境 skill（ ） ； `workspace-context` （录制的 fixture 不得嵌入本仓库的 AGENTS.md） ； `session-title-llm` （ ） ； ； `llm-deepseek` 。patch 的 id 一旦不再匹配任何行， `chdir` 下运行，使 api-gateway 的 `process.cwd()` 会话默认值、工具 cwd 与 fixture 一致；`dsh web` bin 自身的胶水（ ） `smoke-real.e2e.ts` 中的无密钥 CLI（命令行界面） 冒烟把守。初始化回滚和正常关闭都会先对 Cordis 树执行 dispose（ ） ，
无密钥的模型替换 = 禁用适配器行的 patch 加 `installLlmReplay` 在停稳的根 ctx 上以提供方目录（ ） ： ， `resolveModelInfo` 无路由可走，`compact-basic` 的步后 压力检查将步步 告警，而不是被可证明地闲置（发布的 128k `contextWindow` 使该路径对小 fixture 保持闲置）。选择直接安装而非插入回放插件行是刻意的：直接安装返回收尾消费检查所需的 `ReplayHandle` 。没有 fixture 的场景让 seam 保持空置，任何离群的流式调用都会以 NO_ADAPTER 大声失败。
无密钥的模型替换 = 禁用适配器行的 patch 加 `installLlmReplay` 在停稳的根 ctx 上以提供方目录（ ） ： ， `resolveModelInfo` 无路由可走，`compact-basic` 的步骤后的 压力检查会在每个步骤都 告警，而不是被可证明地闲置（发布的 128k `contextWindow` 使该路径对小 fixture 保持闲置）。选择直接安装而非插入回放插件行是刻意的：直接安装返回收尾消费检查所需的 `ReplayHandle` 。没有 fixture 的场景让 seam 保持空置，任何离群的流式调用都会以 NO_ADAPTER 大声失败。
`seedSession()` 通过真实持久化 API 播种冷会话——一次性 `Context` 挂载 `SessionStore` + `SessionPersistenceJsonl` 指向 host 的根目录，`create()` + `append()` ，一次 `utimes` 回拨保证侧栏顺序确定（`semantic-checkpoint.snapshot.ts` 先例） ， ， `turn/end` 结尾——未闭合的最终轮次会被恢复（ ）
`seedSession()` 通过真实持久化 API 播种冷会话——一次性 `Context` 挂载 `SessionStore` + `SessionPersistenceJsonl` 指向 host 的根目录，`create()` + `append()` ，一次 `utimes` 回拨保证侧栏顺序确定（`semantic-checkpoint.snapshot.ts` 先例） ， ， `turn/end` 结尾——未闭合的最终轮次会被恢复的崩溃修复改写）。
### 确定性规则
回放模式下浏览器断言的屏障栈， ： （ ） `await agent.whenIdle()` 加超时，以进程内 `turn/end` 为锚——空闲翻转发生在持久化落盘之后， ； （ ） （ ） ， `whenIdle()` 之后、scaffold 释放之前进行，此时运行中的会话仍然可用。单独监听进程内 `turn/end` 是错误屏障（它先于 SSE 帧到达浏览器、先于 fsync 触发） ； （ `whenIdle` 取代），但工具控制的临时就绪标记可以仅作为该完成屏障之前的交互门控进行轮询；`networkidle` 被彻底禁止（ 它永不解析 ）。导航断言会在页面加载前同时监听 `session.list` 和 `workspace.list` 的初始响应，随后等待播种数据投影到 DOM；
回放模式下浏览器断言的屏障栈， ： （ ） `await agent.whenIdle()` 加超时，以进程内 `turn/end` 为锚——空闲翻转发生在持久化落盘之后， ； （ ） （ ） ， `whenIdle()` 之后、scaffold 释放之前进行，此时运行中的会话仍然可用。单独监听进程内 `turn/end` 是错误屏障（它先于 SSE 帧到达浏览器、先于 fsync 触发） ； （ `whenIdle` 取代），但工具控制的临时就绪标记可以仅作为该完成屏障之前的交互门控进行轮询；`networkidle` 被彻底禁止（ 永远不会达到该状态 ）。导航断言会在页面加载前同时监听 `session.list` 和 `workspace.list` 的初始响应，随后等待播种数据投影到 DOM；
不做单次瞬态 DOM 断言：从回放产出到 React 提交的每一跳都可能合并分片，采样 `[data-streaming]` 天然就是竞态。流式输出的增量性由持久化的 `assistant/chunk` 事件断言（模型可见 ⟺ 已记录，使日志成为权威证据）。`dsh-llm-replay` 的可选 `paceMs` （默认缺省 = 突发）只是让浏览器观察到真正增量 SSE 的真实感旋钮；正确性绝不依赖它，且节奏等待期间中止会即时取消。
每个场景都会因任何 pageerror 或客户端的连接丢失/间隙修复控制台警告而失败：否则重连机制加历史重同步会把一条死掉的 SSE 通路自愈掉，套件反而认证了坏 wire。Scaffold 的 `close()` 调用 `ReplayHandle.assertConsumed()` 收尾检查（每个已录脚本都被绑定、每个游标都耗尽），把静默的少放 与错绑变成清晰诊断。车道不设 vitest 重试；每文件一个 chromium、每场景一个新 context、每场景一个 host； ； `data-*` 属性和可见文本，而 frame 与会话区采集则使用既有的 CSS 模块局部类名锚点。常规场景在客户端启动前设置 `dsh.locale=en` ，使本地化的 role 定位器和预期输出统一采用明确指定的语言；断言中文文案的场景则不预设该存储项，改为开启 `zh-CN` 浏览器，因为客户端的初始 locale 由 `navigator` 推导（[由浏览器推导初始 locale ](../feature/2026-07-31-browser-derived-initial-locale.md )），而 `settings-chrome.e2e.ts` 还额外覆盖双向切换与英文浏览器默认态。
每个场景都会因任何 pageerror 或客户端的连接丢失/间隙修复控制台警告而失败：否则重连机制加历史重同步会把一条死掉的 SSE 通路自愈掉，套件反而认证了坏 wire。Scaffold 的 `close()` 调用 `ReplayHandle.assertConsumed()` 收尾检查（每个已录脚本都被绑定、每个游标都耗尽），把静默的消费不足 与错绑变成清晰诊断。车道不设 vitest 重试；每文件一个 chromium、每场景一个新 context、每场景一个 host； ； `data-*` 属性和可见文本，而 frame 与会话区采集则使用既有的 CSS 模块局部类名锚点。常规场景在客户端启动前设置 `dsh.locale=en` ，使本地化的 role 定位器和预期输出统一采用明确指定的语言；断言中文文案的场景则不预设该存储项，改为开启 `zh-CN` 浏览器，因为客户端的初始 locale 由 `navigator` 推导（[由浏览器推导初始 locale ](../feature/2026-07-31-browser-derived-initial-locale.md )），而 `settings-chrome.e2e.ts` 还额外覆盖双向切换与英文浏览器默认态。
### 预期输出
@@ -40,19 +40,19 @@ Web GUI 以一条真实组装链交付——chromium 页面 → client 插件 bu
`DSH_SNAPSHOT` 选择 replay（ ， ） （ ） （ ） ； `user/message` 核对；每个场景目录都采用封闭清单，其中每个 JSONL 都是脱敏不动点。Web fixture 全部脱敏请求头且不钉任何 header 类别；见「暂缓」。
### 覆盖契 约
### 覆盖约定
该车道覆盖三类行为。实时轮次场景钉住普通工具执行、取消、不可重试失败、瞬态重试、常驻提问与轮次中途 steering； `whenIdle()` 或显式回放标记，而不使用延时。冷历史场景通过真实持久化 API 播种， W aterfall 视图及工具详情。浏览器生命周期场景覆盖首次发送时物化工作区、重新加载恢复、布局重置、主题与语言偏好，以及工作区的创建、重命名和视图操作。每类场景都断言浏览器表面和权威的 host 状态；离群的模型调用或未耗尽的 fixture 会使拆卸失败。必需车道还包含一份合成的 88 轮 Chat 滚动契 约，其中混合了换行 Markdown、围栏代码以及成对的 bash 调用/结果。真实 wheel、输入框、工具、tab、会话与 viewport 交互会在并发历史前插加带节奏流式输出、贴底/离底流式输出、工具 disclosure 离屏循环、扩展历史后的视图/会话重新挂载、宽度重排、贴底后立即重新挂载、输入框尺寸变化以及 textarea wheel 链场景中，断言一个具名已结算行相对 transcript scrollport 的顶部位置和到真实底部的距离；真实键盘翻页与触摸式惯性滑动模拟额外钉住不依赖 wheel 的贴底跟随所有权（[读者滚动归因笔记 ](../bug-fix/2026-08-06-reader-scroll-attribution-observed-top-ledger.md )）；它刻意不钉 DOM 基数或绝对 `scrollTop` ，因此同一契 约可以验收虚拟化实现。另一份基于同一 fixture 的交互契 约钉住异构行顺序、相邻工具 disclosure 的独立状态、用户消息剪贴板内容的精确值、以轮次为边界的消息 fork、源会话/子会话隔离， ； 契 约从空白工作区开始，连续驱动输入框轮次，其中包括真实的 bash 调用/结果轮次和一段带节奏的长篇最终响应；它钉住单一会话身份、每轮 事件的 精确归属、浏览器回显唯一性与输入框恢复，不设置时间阈值。
该车道覆盖三类行为。实时轮次场景钉住普通工具执行、取消、不可重试失败、瞬态重试、常驻提问与轮次中途 steering（中途引导） ；同步依赖持久事件、`whenIdle()` 或显式回放标记，而不使用延时。冷历史场景通过真实持久化 API 播种， w aterfall（瀑布式事件） 视图及工具详情。浏览器生命周期场景覆盖首次发送时物化工作区、重新加载恢复、布局重置、主题与语言偏好，以及工作区的创建、重命名和视图操作。每类场景都断言浏览器表面和权威的 host 状态；离群的模型调用或未耗尽的 fixture 会使拆卸失败。必需车道还包含一份合成的 88 个轮次的 Chat 滚动约定 ，其中混合了换行 Markdown、围栏代码以及成对的 bash 调用/结果。真实 wheel、输入框、工具、tab、会话与 viewport 交互会在并发历史前插加带节奏流式输出、贴底/离底流式输出、工具 disclosure 离屏循环、扩展历史后的视图/会话重新挂载、宽度重排、贴底后立即重新挂载、输入框尺寸变化以及 textarea wheel 链场景中，断言一个具名已结算行相对 transcript scrollport 的顶部位置和到真实底部的距离；真实键盘翻页与触摸式惯性滑动模拟额外钉住不依赖 wheel 的贴底跟随所有权（[读者滚动归因笔记 ](../bug-fix/2026-08-06-reader-scroll-attribution-observed-top-ledger.md )）；它刻意不钉 DOM 基数或绝对 `scrollTop` ，因此同一约定 可以验收虚拟化实现。另一份基于同一 fixture 的交互约定 钉住异构行顺序、相邻工具 disclosure 的独立状态、用户消息剪贴板内容的精确值、以轮次为边界的消息 fork、源会话/子会话隔离， ； 定 从空白工作区开始，连续驱动输入框轮次，其中包括真实的 bash 调用/结果轮次和一段带节奏的长篇最终响应；它钉住单一会话身份、每个轮次的 事件精确归属、浏览器回显唯一性与输入框恢复，不设置时间阈值。
### CI 立场
根据[浏览器快照 CI 决策 ](2026-07-30-web-browser-snapshot-ci-gate.md )，该车道是 Linux 拉取请求 必需的只比较门禁。`node 24 / snapshots and artifacts` 消费方任务在[消费方独立构建 ](../process/2026-07-30-independent-ci-consumer-build.md )中负责唯一一次 Linux 构建，安装锁文件选定的 Chromium， ， `DSH_SNAPSHOT=replay` 运行该车道。这是有意的平面切分： tsx 源码启动契 约 ](../architecture/2026-07-29-dsh-source-launch-tsx-esm.md )，浏览器则消费 `apps/web/dist` 和包的 `lib/client.js` 产物，因此门禁依赖 `built-package-invariants` 提供这些客户端产物。托管和自托管的默认分支 Linux 串行任务运行同一门禁；托管任务生成供 PR 消费的浏览器缓存，持久化 自托管池则不需要托管侧缓存。CI 从不录制或刷新预期输出。场景仍面向 POSIX，
根据[浏览器快照 CI 决策 ](2026-07-30-web-browser-snapshot-ci-gate.md )，该车道是 Linux PR（ ） 必需的只比较门禁。`node 24 / snapshots and artifacts` 消费方任务在[消费方独立构建 ](../process/2026-07-30-independent-ci-consumer-build.md )中负责唯一一次 Linux 构建，安装锁文件选定的 Chromium， ， `DSH_SNAPSHOT=replay` 运行该车道。这是有意的平面切分： tsx 源码启动约定 ](../architecture/2026-07-29-dsh-source-launch-tsx-esm.md )，浏览器则消费 `apps/web/dist` 和包的 `lib/client.js` 产物，因此门禁依赖 `built-package-invariants` 提供这些客户端产物。托管和自托管的默认分支 Linux 串行任务运行同一门禁；托管任务生成供 PR 消费的浏览器缓存，常驻 自托管池则不需要托管侧缓存。CI 从不录制或刷新预期输出。场景仍面向 POSIX，
高基数性能诊断使用单独按需启用的 `apps/web/tests/**/*.perf.ts` 清单，并且只由 `vitest.web.perf.config.ts` 选中。`complex-history.perf.ts` 的隔离用例复用真实 scaffold： ， 轮 执行真实 `bash` 调用并断言其持久化结果，最后一轮 则填入一条包含 8,232 个字符的混合语言提示词，并回放 120 个带节奏的文本增量。一个单独的 soak 用例从空白会话开始，通过真实输入框连续驱动 100 轮 ，每第 10 轮 执行一次 `bash` 调用并产生结果，每 10 轮 强制执行一次 GC， 轮 的延迟窗口及保留的浏览器状态。随后它通过受信任的浏览器点击提交第 101 个纯文本轮次，并使用浏览器时钟分别测量发送到 transcript DOM 和发送到绘制后的延迟，排除输入框的草稿镜像，并与完整轮次完成时间分开。逐轮 诊断涵盖输入框填入、点击到用户消息回显、点击到首个分片、完成、浏览器变更、持久化分片和工具事件；合成回放模型拥有足够的上下文容量，可使 fixture 基数保持稳定， （ ） ， ， 契 约。必需的 `vitest.web.config.ts` 清单仍仅限 `*.e2e.ts` 和 `*.snapshot.ts` ，因此 `test:web:built` 及其 CI 门禁都不会收集性能用例。
高基数性能诊断使用单独按需启用的 `apps/web/tests/**/*.perf.ts` 清单，并且只由 `vitest.web.perf.config.ts` 选中。`complex-history.perf.ts` 的隔离用例复用真实 scaffold： ， 个轮次 执行真实 `bash` 调用并断言其持久化结果，最后一个轮次 则填入一条包含 8,232 个字符的混合语言提示词，并回放 120 个带节奏的文本增量。一个单独的 soak 用例从空白会话开始，通过真实输入框连续驱动 100 个轮次 ，每 10 个轮次 执行一次 `bash` 调用并产生结果，每 10 个轮次 强制执行一次 GC， 个轮次 的延迟窗口及保留的浏览器状态。随后它通过受信任的浏览器点击提交第 101 个纯文本轮次，并使用浏览器时钟分别测量发送到 transcript DOM 和发送到绘制后的延迟，排除输入框的草稿镜像，并与完整轮次完成时间分开。各轮次 诊断涵盖输入框填入、点击到用户消息回显、点击到首个分片、完成、浏览器变更、持久化分片和工具事件；合成回放模型拥有足够的上下文容量，可使 fixture 基数保持稳定， （ ） ， ， 定 。必需的 `vitest.web.config.ts` 清单仍仅限 `*.e2e.ts` 和 `*.snapshot.ts` ，因此 `test:web:built` 及其 CI 门禁都不会收集性能用例。
## 业界先例
调研了 AI 聊天/agent web UI 与 mock 层（ ； ） ： ， （ `LIBRECHAT_TEST_RUN_HOOK` 伪模型； `MockLanguageModelV3` + `simulateReadableStream` ； `dsh-llm-replay` 已然所是。浏览器层 SSE 拦截无法检验增量渲染（`route.fulfill` 一次性交付整个响应体； #33564 ），且服务端 SSE 栈完全失测，因此各项目只把它用于边缘用例。分片节奏作为 fixture 参数反复出现（ ； ） ； （ ， ） ； （ ； （ ） （ ）
调研了 AI（人工智能） 聊天/agent web UI 与 mock 层（ ； ） ： ， （ `LIBRECHAT_TEST_RUN_HOOK` 伪模型； `MockLanguageModelV3` + `simulateReadableStream` ； `dsh-llm-replay` 已然所是。浏览器层 SSE 拦截无法检验增量渲染（`route.fulfill` 一次性交付整个响应体； #33564 ），且服务端 SSE 栈完全失测，因此各项目只把它用于边缘用例。分片节奏作为 fixture 参数反复出现（ ； ） ； （ ， ） ； （ ； （ ） （ ）
## 曾考虑的替代方案
@@ -62,15 +62,15 @@ Web GUI 以一条真实组装链交付——chromium 页面 → client 插件 bu
**扩展 `?fixture` 客户端。 ** 已否决：分层纪律——`FixtureApiClient` 的存在意义就是脱离服务器测试客户端 shell；
**用占位 `DEEPSEEK_API_KEY` + 回放拦截替代禁用适配器行。 ** 尽管零组合改动且树内有两处先例仍被否决：它用 谎言满足 `llm-deepseek` 的快速失败 密钥检查， ； （ 是诚实 的无密钥，并在最早可解析点快速 失败。
**用占位 `DEEPSEEK_API_KEY` + 回放拦截替代禁用适配器行。 ** 尽管零组合改动且树内有两处先例仍被否决：它以 谎言绕过 `llm-deepseek` 会明确报错 的密钥检查， ； （ 才是真正 的无密钥方案 ，并会 在最早可判定点明确 失败。
* * `packages/support/web-snapshot` 包 + `defineWebSnapshotSuite` 工厂。** 已否决：驱动 chromium 的源码在无浏览器的覆盖率 runner 上无法诚实保持逐文件 100%，且除受门禁的包已导出的辅助工具与本地 scaffold 外，这些场景专用交互尚未形成稳定的无浏览器契 约。出现第二个 web 形态消费方，或被证实重复的生命周期代码确立该契 约后，再重新考虑。
* * `packages/support/web-snapshot` 包 + `defineWebSnapshotSuite` 工厂。** 已否决：驱动 chromium 的源码在无浏览器的覆盖率 runner 上无法诚实保持逐文件 100%，且除受门禁的包已导出的辅助工具与本地 scaffold 外，这些场景专用交互尚未形成稳定的无浏览器约定 。出现第二个 web 形态消费方，或被证实重复的生命周期代码确立该约定 后，再重新考虑。
**第二份提交的规范化会话日志预期输出。 ** 已否决：日志表面已由 ACP/headless/TUI 套件经同一循环与持久化钉住；在此只会翻倍刷新成本并重复测试下层。内联在根上下文事件上的世界状态断言保住了验证世界的义务。
**以 `DSH_SNAPSHOT` 回放分支拉起 `dsh web` bin。 ** 已否决：它需要在交付的 CLI 中增加测试专用回放分支和环境变量管道。进程内 scaffold 已加载同一份 `apps/cli/config/base.cordis.yml` 与 `apps/cli/config/web.cordis.yml` ；只剩 argv、profile JSON 和 `AppCLIEntry` 胶水不在其覆盖范围内，而这些路径已由无密钥 CLI 冒烟覆盖。
**为可测试性改 wire 协议。 ** 已否决：契 约已有第一等的无密钥同构 seam（ `InProcessApiClient(toFetchHandler(api))` ），逐事件不合批的 SSE 恰是回放在浏览器中可观测的原因，测试一条不再交付的 wire 会颠倒该层的存在意义。
**为可测试性改 wire 协议。 ** 已否决：约定 已有第一等的无密钥同构 seam（ `InProcessApiClient(toFetchHandler(api))` ），逐事件不合批的 SSE 恰是回放在浏览器中可观测的原因，测试一条不再交付的 wire 会颠倒该层的存在意义。
**以真实模型浏览器测试充当无密钥车道。 ** 已否决： ； （ ）
@@ -78,18 +78,18 @@ Web GUI 以一条真实组装链交付——chromium 页面 → client 插件 bu
**客户端 `data-dsh-busy` 安定信号。 ** 暂缓： `whenIdle` 屏障配合稳定 DOM 轮询，足以覆盖当前场景。第一次安定轮询抖动，或必要状态在 DOM 中不可观察时，再重新考虑。
## Testing
## 测试
`pnpm run test:web` 构建并无密钥运行该车道；`test:web:built` 基于现有构建产物运行。`pnpm run test:web:perf` 构建并运行手动性能清单；`test:web:perf:built` 复用现有产物。`DSH_SNAPSHOT=record pnpm exec vitest run --config vitest.web.config.ts apps/web/tests/<spec>` 对真实模型录制一个发起提示的场景，`DSH_SNAPSHOT=refresh pnpm run test:web` 则无密钥重写 aria 预期输出。CI 显式选择回放模式。live-interactions AUTH 场景会把不可重试的终态失败钉为 Chat 内联状态，其中携带适合展示的消息与错误码，并验证提供方回显的凭据片段不会出现在 Chat 或 Trajectory 中；该场景同时覆盖输入框恢复与 `turn/end` 错误。scaffold 环境隔离场景会在全部 3 个环境 skill 根目录中分别填入不同条目，并要求这些条目都不得进入组装后的目录。`dsh-llm-replay` 单元覆盖率钉住节奏控制、取消、消费诊断、sidecar 校验、按索引替换与唯一的追加位置。
`pnpm run test:web` 构建并无密钥运行该车道；`test:web:built` 基于现有构建产物运行。`pnpm run test:web:perf` 构建并运行手动性能清单；`test:web:perf:built` 复用现有产物。`DSH_SNAPSHOT=record pnpm exec vitest run --config vitest.web.config.ts apps/web/tests/<spec>` 对真实模型录制一个发起提示的场景，`DSH_SNAPSHOT=refresh pnpm run test:web` 则无密钥重写 aria 预期输出。CI 显式选择回放模式。live-interactions AUTH 场景会把不可重试的终态失败钉为 Chat 内联状态，其中携带适合展示的消息与错误码，并验证提供方回显的凭据片段不会出现在 Chat 或 Trajectory 中；该场景同时覆盖输入框恢复与 `turn/end` 错误。scaffold 环境隔离场景会在全部 3 个环境 skill 根目录中分别填入不同条目，并要求这些条目都不得进入组装后的目录。`dsh-llm-replay` 单元覆盖率钉住节奏控制、取消、消费诊断、伴随文件 校验、按索引替换与唯一的追加位置。
## 暂缓
- **Web 头类别钉住**： `{{system}}` /`{{tools}}` ，没有场景钉住 web 组合的提示词/工具 schema（ `TODO(web-header-pin)` ——scaffold 的 `recordFixture` JSDoc 有标记）。沿用 TUI 处处脱敏先例；当 web 组装的请求头与其镜像的 repl 组合进一步 分叉时重审。
- **Web 头类别钉住**： `{{system}}` /`{{tools}}` ，没有场景钉住 web 组合的提示词/工具 schema（ `TODO(web-header-pin)` ——scaffold 的 `recordFixture` JSDoc 有标记）。沿用 TUI 处处脱敏先例；当 web 组装的请求头与其镜像的 repl 组合发生 分叉时重审。
- **恢复后追问场景**：真实 wire 上的历史/实时缝合路径；当该代码变更或回归时作为独立场景补充。
- **输入框 steering 手势**：输入在运行期间锁定（只能停止或等待），因此 steering 场景从页面走 wire 做 steer； `TODO(web-steer-composer)` 待产品长出真实的输入框手势后，把驱动步骤升级为该手势。
- **拖拽会话重排**： `workspace.insertSessionBefore` 尚无浏览器场景；它需要在同一个工作区里物化两个会话，并合成 HTML5 拖拽事件。当该表面变更或回归时再补充。无行为的会话 Rename/Fork/Delete 和工作区 Delete 菜单行待获得行为后再补充场景。
- **长历史 Chat 到 Trajectory 的 Inspect**：独立的检查数据源会在视图打开后穷尽历史，而所选记录由一个派生的表格索引定位；随着较早页面前插，该索引可能移动。短历史 Inspect 仍有覆盖；在选中项具有稳定的语义身份之前，长历史交互契 约不包含这项交接。
- **长历史 Chat 到 Trajectory 的 Inspect**：独立的检查数据源会在视图打开后穷尽历史，而所选记录由一个派生的表格索引定位；随着较早页面前插，该索引可能移动。短历史 Inspect 仍有覆盖；在选中项具有稳定的语义身份之前，长历史交互约定 不包含这项交接。
## 后果
Web 表面获得了录制一次/永久回放的层级：真实 chromium → SSE → apiproxy → 循环 → 工具 → 持久化的链路以约 10-30 秒无密钥运行， ， `DSH_SNAPSHOT=refresh` 收尾（预期输出变动是受评审的 diff， ） ； `apps/web/package.json` 中浮动为 `^1.49.0` ；若变动伤人则改为精确锁定）；回放的首次调用顺序绑定把每个场景限制为至多一个发起提示的会话，消费断言是绊线；`compact-basic` 与会话共享回放游标，仅在发 布的 128k 目录 窗口下保持闲置；必需的消费方任务承担 Chromium 供给与一次浏览器运行的成本，使改动组装后 UI 的 PR（ ） ，
Web 表面获得了录制一次/永久回放的层级：真实 chromium → SSE → apiproxy → 循环 → 工具 → 持久化的链路以约 10-30 秒无密钥运行， ， `DSH_SNAPSHOT=refresh` 收尾（预期输出变动是受评审的 diff， ） ； `apps/web/package.json` 中浮动为 `^1.49.0` ；若变动伤人则改为精确锁定）；回放的首次调用顺序绑定把每个场景限制为至多一个发起提示的会话，消费断言是绊线；`compact-basic` 与会话共享回放游标，仅在目录中公 布的 128k 窗口下保持闲置；必需的消费方任务承担 Chromium 供给与一次浏览器运行的成本，使改动组装后 UI 的 PR 持有相应的预期输出 diff。按需启用的性能车道保留了可重复的诊断工作负载，
xjt