dsh-agent-team-ui-testing 0.1.1 → 0.1.2

package/skills/{ui-testing → ui-testing-web}/references/tiers/t1-programmatic.md

@@ -6,9 +6,9 @@ T1 共 10 个工具（含独立 HTTP `browser_http_request` 与共享视口 `bro
 | --- | --- | --- |
 | 导航 | browser_navigate | errorText/最终 URL/目标与 DNS/Document 重定向校验，不保证 load complete |
 | JS | browser_eval | 顶层主世界，可序列化值；页面异常 error 对象含描述/栈/位置 |
-| 截图 | browser_screenshot | P0：显式 scale 0.1–4（省略时跟随共享 view.scale，cold 1）、region文档CSS px、out相对.png；PNG CRC/尺寸/全量均匀统计、JSON mapping、安全落盘与附件metadata证据；保留base64/附件fallback；provider另验，无T3分析 |
+| 截图 | browser_screenshot | P0：显式 scale 0.1–4（省略时跟随共享 view.scale，cold 1）、region画布CSS px、includeAnnotations?:boolean=false、out相对.png；true 按同一 region/scale 叠加 Host 已接受的六形状，不含草稿/工具栏，证据 capture.annotations；默认截图与 T3/T4 原始源不含面板标注；PNG CRC/尺寸/全量均匀统计、JSON mapping、安全落盘与附件metadata证据；保留base64/附件fallback；provider另验，无T3分析 |
 | 共享视口 | browser_viewport | `action:"get"`=只读缓存诊断（不启动/不发 CDP/不占租约，`stale` 明示）；`action:"set"`=页面操作（宽高才发 metrics override，scale-only 不改页面几何）；`x/y` 为文档 CSS 滚动位置实测，宽高 200–4096 整数，scale 0.1–2（也是省略 scale 的截图默认密度），`expectedRevision` → `VIEWPORT_CONFLICT` 零应用 |
-| 输入 | browser_input | applied 是数量，不证明生效；支持 modifiers（数组或 CDP 位掩码）、key 的 virtualKeyCode/autoRepeat 等、mouse 的 buttons/pointerType；无焦点管理工具与高层动作 |
+| 输入 | browser_input | applied 是数量，不证明生效；支持 modifiers（数组或 CDP 位掩码）、key 的 virtualKeyCode/autoRepeat 等、mouse 的 buttons/pointerType。**有按键状态机**：`keyDown` 记位、`keyUp` 清位，按住 Shift 后其它事件自动带位（要复现"没带位"的坏行为用 `synthesizeModifiers:false`）；`mouse` 给 `deltaX/deltaY` 就是相对移动（虚拟光标，clamp 在视口内）；返回 `held` 可核对残留按键，导航会清空。无焦点管理工具与高层动作 |
 | 网络（旧工具） | browser_network | 响应与 loadingFailed 元数据、URL 脱敏、有界 300 条；**无头/正文**；其他 owner BUSY。深度采集/控制看下一条 |
 | 网络（P0 七工具） | browser_network_session · events · detail · trace · control · evidence · subscribe | `action` 必填；HTTP/HTTPS 请求响应与头/体（按需、配额截断、读不到 `available:false`）、WebSocket 双向帧、SSE、same-origin iframe/OOPIF/Worker、统一时间轴与分析聚合、业务步骤链路、拦截/限速/断连/重放/Mock、JSONL+HAR 与多 Agent 独立订阅；只读/诊断不启动浏览器，`session.start` 与需 page 的 `control` 才懒启动；`G1.5` partial（same-origin iframe + dedicated worker 已实证；OOPIF partial；shared/service worker 不采集）、HTTPS 未独立验收（`limits.network.https="mechanism-identical"`）、`responseModification` 条件支持、真实宿主上的行为需单独证据|
 | CSSOM | browser_computed_style | 首匹配，未命中 error 对象；无伪元素/iframe/Shadow DOM 内部定位 |

package/skills/{ui-testing → ui-testing-web}/references/tiers/t3-static-visual.md

@@ -2,7 +2,7 @@
 
 > 权威契约：[`docs/t3-vision.md`](../../../../docs/t3-vision.md)。本文件是已实现能力的操作摘要，字段、边界与验收口径以契约为准。
 
-## 已实现的六个工具（当前工具面 36 = 10 T1 + 1 P0-E + 7 T2 + 6 T3 + 7 network + 5 T4）
+## 已实现的六个工具（当前工具面 37 = 10 T1 + 1 P0-E + 1 P0-D + 7 T2 + 6 T3 + 7 network + 5 T4）
 
 | 工具 | 用途 | 关键边界 |
 | --- | --- | --- |
@@ -35,7 +35,7 @@
 
 ## 与 T1/T2 的关系
 
-`browser_screenshot` 仍是原始 PNG 采集（P0），不隐式产生 productId；要用同一画面做视觉分析，先 `browser_vision_image` 取得 product。T2 负责语义元素与可交互目标；T3 的 `act` 用当前截图里的顶层命中点，不是“知道调用者想要哪个 DOM 对象”，也不是 T2 `NOT_INTERACTABLE` 的 force 逃生口。`escalation:"T3"` 只提示需要视觉分析；`escalation:"T4"` 提示需要连续帧证据（持续运动）。
+`browser_screenshot` 是 PNG 采集（P0），不隐式产生 productId；它的 `includeAnnotations?:boolean=false` 仅控制本次截图叠加 Host 已接受的面板标注，T3 原始源不含面板标注，T3 `annotations` 是独立的图片后处理标记；要用同一画面做视觉分析，先 `browser_vision_image` 取得 product。T2 负责语义元素与可交互目标；T3 的 `act` 用当前截图里的顶层命中点，不是“知道调用者想要哪个 DOM 对象”，也不是 T2 `NOT_INTERACTABLE` 的 force 逃生口。`escalation:"T3"` 只提示需要视觉分析；`escalation:"T4"` 提示需要连续帧证据（持续运动）。
 
 ## 结论边界
 

package/skills/{ui-testing → ui-testing-web}/references/tiers/t4-dynamic-visual.md

@@ -54,4 +54,5 @@
 
 ## 不要再用旧说法
 
-- 单张 `browser_screenshot`、T3 的 before/after 两帧、面板 `/metrics` 与 `browser_eval` 读页面状态都**不是** T4 帧序列证据。
+- T4 的 screencast/screenshot-loop 两种帧源均不含面板标注；`browser_screenshot {includeAnnotations:true}` 只生成带 Host 已接受标注文档的静态截图，不影响 T4 采帧。
+- 单张 `browser_screenshot`（含带标注截图）、T3 的 before/after 两帧、面板 `/metrics` 与 `browser_eval` 读页面状态都**不是** T4 帧序列证据。