用途:这是一个参考/工具型技能,在已执行测试阶段的子代理内部加载,不自行派生代理,也没有调度策略。典型调用者是 /sprint-testing 的 Stage 2:当探索中发现的缺陷属于视觉/位置类问题时使用。输入是磁盘上已存在的原始截图(通常在工单的 PBI evidence/ 文件夹),输出恰好一个作为证据的文件——最终渲染的标注 PNG。裁剪图和标注 HTML 属于 Bucket C 工作文件,仅作会话草稿,不写入工单证据目录。不适用于提交缺陷、直接可读的原始前后对比图、实物或文档照片。
主要能力:在工作流中用 Python + PIL 裁剪出问题区域,用 HTML+CSS 构建标注层(绝对定位的 div 叠加),提供并需沿用 references/shapes.html 中带注释的区块(circle-callout、arrow-to-region、callout-box、badge-corner、axis-tick + axis-tag、before-after)及其 z-index 层级。
用法与限制:浏览器自动化 CLI 拒绝 file:// URL,必须用绑定 127.0.0.1 的本地 HTTP 服务器:python3 -m http.server <port> --bind 127.0.0.1 --directory <scratchpad>。加载 /playwright-cli 获取确切动词/参数;打开 http://127.0.0.1:<port>/annotation.html,把视口调整到 HTML 实际尺寸(等于或更大,更小会裁掉标注框),再截图到工单 evidence/,命名 {KEY}-BUG-{BUG-KEY}-annotated.png。随后读回 PNG 检查,至少做一轮调整,并杀掉 HTTP 服务器进程(kill <pid> 或 pkill -f "http.server <port>")。可选:经人工确认后用 jira-attach-media.ts 脚本把标注图发布为缺陷评论。
限制与安全约束:含真实产品或客户数据的 QA 证据绝不经过外部图像服务,本地回环绑定即为防止数据外泄,显式授权也不解除该约束。常见问题包括角标被标注框遮挡(需保持 z-index 层级:底图 1 → 圆/箭头/刻度 10 → 标注框 20 → 角标 30)、标注文字被裁切、file:// 不可用、缺少 <meta charset="utf-8"> 导致破折号和重音字符乱码。缺失事实:具体平台支持范围、收费或价格、性能指标暂未提供。