feat: 增加 YAML-first Cloud Console 验收命令

This commit is contained in:
Codex
2026-07-16 02:49:53 +02:00
parent 09bd068c9a
commit 8fad1ff10b
12 changed files with 1087 additions and 7 deletions
+7
View File
@@ -41,6 +41,13 @@ description: UniDesk Web 开发与浏览器验证技能。用户处理 UniDesk/H
- `observe collect <id> --view turn-summary --command-id <cmd_...>` 必须按 commandId 精确返回单轮;不存在时保持结构化 `not-found`,禁止回退全量轮次。输出中 observer control 完成、turn submission 与异步 turn terminal 是三个独立证据字段,control completed 不等于业务 turn terminal。
- `workbench-triad` 的本地 `network.jsonl` 没有匹配响应时,结论必须写作 `artifact evidence missing`,并明确这不能证明业务 API 未发生;将 control artifact 中的 OTel trace reference 作为独立证据引用,再走 `$unidesk-otel` 受控诊断核验完整业务链路。
- `web-probe script` 结果首行固定返回 `UNIDESK_WEB_PROBE_COMMAND_PROMOTION_HINT <json>`,同时在结构化结果首字段返回 `commandPromotionHint`;一次性脚本在重复前必须沉淀为 repo-owned typed command。内置 generated command(例如 `web-probe opencode-smoke`)会明确返回可直接复用且不附加临时脚本 warning,禁止复制其生成脚本另起一次性入口。
- Cloud Console 全路由、多视口和通用产品交互收口:
- 使用 `web-probe console-verify --node <node> --lane <lane> --origin internal|public --profile <profile>`
- 路由、视口、selector、工作流、等待和证据上限只从 owning YAML profile 读取;
- 不再复制临时脚本;
- 只用于已部署页面的人工 closeout;
- 不进入 CI/CD gate
- 不替代 Workbench Kafka、Trace 或性能专项命令。
- 沉淀后的 typed command 必须复用 observer start 时选中的 semantic origin;不得在 command 内嵌 URL/IP,也不得为 internal/public 各复制一份 command。
- Workbench 性能卡顿调查优先用 `observe command --type performanceCapture` + `observe analyze` + `observe collect --view performance-summary``performance-summary` 必须保持首屏 bounded,只输出 LongTask/LoAF/event-loop gap 摘要、CPU profile hotspots/stacks 和 sourceFiles,下钻完整 profile/report 时再显式读取 artifact。
- Project Management/MDTODO closeout 必须区分 `control` 页和被动 `observer` 页:显式 `observe command` 的 command result、control URL 和对应截图是用户动作证据;observer 周期刷新或 stop 后根路由空态只能作为对照信号,不能覆盖 command result。涉及报告的验收要同时记录 `reportPreviewVisible``reportFullscreenVisible`、报告 deep link 和截图 SHA。
@@ -4,6 +4,14 @@
- 交互流程使用 `observe start``observe command``observe collect``observe analyze`
- `run``script` 只用于有界探测和 smoke
- 收尾证据引用 observer id、command id、artifact/report SHA、screenshot SHA 和关键有界字段。
- Cloud Console 页面矩阵:
- 使用 `bun scripts/cli.ts web-probe console-verify --node <node> --lane <lane> --origin internal|public --profile <profile>`
- 配置真相位于 `config/hwlab-node-lanes.yaml#templates.*.webProbeWorkbench.consoleVerificationProfiles`
- 配置拥有 route profile、viewports、稳定 selector、可选产品工作流、等待和证据上限;
- 命令复用既有认证、semantic origin、远程浏览器、`MemAvailable` 启动门禁、report recovery 和截图合同;
- 默认 profile 由同一 YAML 的 `defaultConsoleVerificationProfile` 选择,CLI `--profile` 只做显式 profile 选择;
- 该命令用于已部署页面人工 closeout,不作为 CI/CD gate,不替代 Workbench Kafka、Trace 和性能专项 validator
- 成功或失败均以有界 `issueEvidence`、report SHA、screenshot SHA 和失败摘要收口,不再重复创建 `.state/probes/*.mjs`
- Workbench 与 Performance 调查规则:
- 先使用专用 collect/analyze view
- 不要先检索原始 JSONL artifact。