From 7c70c3b027d1d95a2a47a6f2af9abf62fa73a18c Mon Sep 17 00:00:00 2001 From: pikastech Date: Mon, 20 Jul 2026 16:20:57 +0200 Subject: [PATCH] docs: clarify Workbench L1 CLI screenshot validation --- .agents/skills/unidesk-webdev/SKILL.md | 5 +++++ docs/reference/hwlab.md | 4 ++++ 2 files changed, 9 insertions(+) diff --git a/.agents/skills/unidesk-webdev/SKILL.md b/.agents/skills/unidesk-webdev/SKILL.md index 1093f4e2..fe8575fe 100644 --- a/.agents/skills/unidesk-webdev/SKILL.md +++ b/.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 通过； diff --git a/docs/reference/hwlab.md b/docs/reference/hwlab.md index a0596953..400c5471 100644 --- a/docs/reference/hwlab.md +++ b/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；