fix: 固化 Workbench 回放可见性验收

2026-07-21 13:44:30 +02:00
parent d2b39d6c34
commit db594bf871
4 changed files with 106 additions and 15 deletions
@@ -206,6 +206,11 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
  - `tool_call`/`command_output` 与 HWLAB `tool`/`status` 是条件事件对，仅在实际出现时校验数量和 lineage；
  - 直接答复不得为了通过探针而合成工具事件，超时证据必须披露已经观测和仍然缺失的事件族；
  - refresh 启用时必须证明 retention 到 live handoff、正式 `user` event、`hwlab.event.v1` 同 envelope，以及主页面单一 EventSource 和同一 UI reducer 终态；
+  - session 切换或重连期间的 replay 可见性以 `docs/reference/hwlab.md#纯-kafka-页面刷新与实时交接合同` 为唯一权威：
+    - connected 前允许后台追赶，但页面必须保留切走前的稳定投影，不得显示历史前缀导致最近更新时间倒退；
+    - handoff 完成后只把待处理 frame 交给原 reducer 一次发布，失败或 scope 替换时丢弃未完成事务；
+    - L1 先用 `validateExistingSessionRefresh` 证明单 EventSource、retention→live 和禁止恢复请求，再对真实运行中 session 用 `switchAwayAndBack --session-id <id>` 验证用户操作路径；
+    - 在统一 typed command 尚未提供切换期间的时间标签采样前，L0 可见性测试是“不回退”的主证据，L1 两条 typed command 只补真实入口和 transport 合同，禁止把最终截图冒充过程证据；
  - 已有 session 的 rail、turn card、Final Response 或回放提示不一致时：
    - 先执行一次 `workbench events inspect --over-api` 证明服务端 connected、核心事件族和 terminal；
    - 服务端完整后只执行一次 `validateExistingSessionRefresh` 核对 DOM identity、live handoff 与 forbidden request；