docs: clarify web-probe smoke closeout rules

2026-07-01 08:29:30 +00:00
parent 6b73dcd0c1
commit f88914e82d
2 changed files with 2 additions and 0 deletions
@@ -31,6 +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 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 或无界日志。