docs: fix web-probe smoke target rule

2026-07-01 08:47:47 +00:00
parent f88914e82d
commit 6f70f162fa
1 changed files with 1 additions and 1 deletions
@@ -31,7 +31,7 @@ description: UniDesk Web 开发与浏览器验证技能。用户处理 UniDesk/H

 ## web-probe 证据规则

- 用户要求“web-probe smoke”或“基本 web-probe smoke”时，默认验收对象是 web-probe 基础设施本身：至少覆盖 `web-probe screenshot` 远程截图下载与 SHA 校验、`web-probe script` 的受管登录/报告/artifact 生成、`web-probe observe start/status/collect/stop` 的启动采样和清理闭环。不要用 `opencode-smoke`、Workbench 对话、MDTODO 业务流或其他应用专用探针替代基础 smoke，除非用户或 issue 明确要求验证该业务链路。
+- 用户要求“用 web-probe 做 smoke”时，`web-probe` 是取证工具，smoke 目标以用户/issue 指定的业务入口为准；例如目标是 Workbench 时，必须用 `web-probe run` 或 `web-probe observe start` + `observe command --type sendPrompt` 验证 Workbench 页面、会话、消息终态和 `observe analyze` 结果，不能改成只验证 web-probe 工具自身。只有用户明确说“验证 web-probe 自身/基础设施”时，才把 screenshot/script/observe 作为工具自检 smoke。
 - 交互式线上验收优先使用 `web-probe observe start`、`observe command`、`observe collect` 和 `observe analyze`；`web-probe script` 只作为一次性探测逃生口。重复出现的高频动作（折叠侧栏、关闭报告、切换全屏、导出低码率截图、采集布局指标）必须沉淀为 observe command 或 analyzer 能力。
 - 截图取证必须优先配合页面的 RESTful 深链：截图命令应直接打开能恢复目标 source/file/task/report/session/run 和聚焦区域的 URL，再等待稳定 DOM 合约后截图。若目标页面缺少必要深链能力，不要先用脆弱点击/滚动流程硬截；应先增强前端深链与刷新恢复能力，再把截图能力接回 web-probe/observe/sentinel 命令。
 - Issue closeout 引用 observer id、command id、stateDir/report SHA、screenshot SHA 和关键字段摘要；不要粘贴截图二进制、完整 JSON、Secret、cookie 或无界日志。