docs: clarify Workbench L1 CLI screenshot validation

.agents/skills/unidesk-webdev/SKILL.md

@@ -120,6 +120,11 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
   - 必须确认没有阻塞 bootstrap 的 `pageerror`、`console.error`、关键失败请求或持续主线程卡顿；
   - `web-probe` 导航、DOM 读取、交互或截图超时，以及浏览器出现“页面无响应”，都直接判定 L1 未通过；
   - L1 未通过时禁止向用户披露入口为“可用”，必须继续定位并修复，或明确报告 browser readiness blocker。
+- Workbench L1 业务验收采用 CLI 交互、截图观察的两层证据：
+  - 先用项目正式 CLI 的 `--over-api` 调用同一 Cloud API dispatcher，完成 session 创建、turn 提交和产品 SSE 终态对账，并记录 sessionId 与 traceId；
+  - 再用 `web-probe screenshot` 从 owning YAML 选择的固定公网入口打开该 session 深链，观察用户可见的消息、终态和语义化错误；
+  - 不把 WebProbe 的硬编码 DOM selector、长等待、临时 Playwright 脚本或探针自身超时作为 Workbench 业务终态的唯一门禁；探针异常时保留其作为工具证据，并以 CLI 终态和截图继续归因；
+  - CLI 必须走同一产品 dispatcher 和身份语义，禁止以 direct manager、snapshot、result polling 或其他第二业务路径替代。
 - Native 阶段采用短反馈循环：
   - 修改后先执行最小语法检查和目标功能验证；
   - 使用 `web-probe` 从 YAML 选择的固定 HTTPS 或公网 HTTP 入口验证真实 DOM、交互、布局和截图；custom/local 仅记录为 preflight，不能宣称 L1 通过；

docs/reference/hwlab.md

@@ -208,6 +208,10 @@ Workbench 浏览器回归需求以 UniDesk OA [PJ2026-010401 Web工作台](../..
     - 此时 retention 查询尚未开始，不得先归因 Kafka 扫描超时或历史事件缺失；
   - 通过条件是 `connected=true`、`missingSemantics=[]` 且 `terminalStatuses` 出现明确终态；
   - `eventCount` 和 `--min-events` 不能证明 assistant、terminal 或 final，不得通过反复猜事件数量重开 inspect；
+  - 业务交互优先使用项目正式 CLI 的 `--over-api` 完成 session/turn 与产品 SSE 终态对账，并保留精确 sessionId、traceId；
+  - 页面验证随后使用 `web-probe screenshot` 打开 owning YAML 选择的固定公网入口及该 session 深链，只观察用户可见的消息、终态和语义化错误；
+  - 不得通过硬编码 DOM selector、长等待或临时 Playwright 脚本重复驱动页面业务；这类 WebProbe 异常只能作为工具可见性证据，不能覆盖同一 dispatcher 的 CLI 终态或截图中已可见的业务结果；
+  - CLI 和浏览器必须保持同一产品 dispatcher、鉴权与 Kafka SSE 路径；禁止用 AgentRun direct manager、snapshot、result polling 或其他第二业务路径替代。
   - `event-timeout` 必须直接读取 `observedSemantics` 与 `missingSemantics` 分层定位；
   - AgentRun 冷启动仍未终态时，报告上游运行状态，不得补读 snapshot、read-model、AgentRun `/events` 或 `/result` 冒充产品 SSE 验收。
   - `workbench.connected` 已到达且 `filters.sessionId` 与当前会话一致时，delivery semantics、capabilities、contract version 和 authority metadata 的缺失或漂移只记录 `blocking=false` warning；