SuperAPI AI 工具集

bug-screenshot-annotation

测试与质量

查看项目

更新于 10-16 05:42

技能介绍

用途:把磁盘上已有的原始缺陷截图加工成 QA 风格的注释证据图,用于说明视觉或位置类缺陷(元素重叠、错位、坐标轴日期或偏移错误、元素位置错误)。它只是在既有图片上叠加图形,不会根据文字描述生成或编辑图像,也不负责提交缺陷本身;原始截图已足够清晰的前后对比图不适用。

主要能力:支持圆圈/椭圆、箭头、标注文本框、角标、坐标轴刻度与标签、前后对比等叠加块,参考 references/shapes.html 中带注释的块复制调整。

使用方式:技能在已执行测试阶段的子代理内部加载,不派发代理、不是阶段归属者,典型调用方为 sprint-testing 的执行阶段。流程为:先用 Python + PIL 按像素裁切出工作用 crop(仅暂存,不写入证据目录);再构建注释 HTML(裁切图作背景 <img>,每个注释为绝对定位 <div> 叠加);必须通过回环 HTTP 提供服务,例如 python3 -m http.server <port> --bind 127.0.0.1 --directory <scratchpad>,因为浏览器自动化 CLI 拒绝 file://;用浏览器自动化 CLI 在独立命名会话中打开 http://127.0.0.1:<port>/annotation.html,视口需不小于 HTML 画布尺寸,再截图到工单 evidence/ 目录,命名 {KEY}-BUG-{BUG-KEY}-annotated.png;读回 PNG 检查并至少做一轮调整;随后终止 HTTP 服务进程。可选地通过 jira-attach-media.ts 把注释图作为证据评论发布到缺陷工单,需人工先确认。

限制与安全:QA 截图含真实产品与客户数据,全程禁止经任何外部图像服务(含生成式)处理,即使用户在对话中授权也不解除;全部渲染在本地完成。仅最终注释 PNG 属于证据文件,裁切图与注释 HTML 均为会话暂存,不写入证据目录、不被工单引用。未提供收费、价格、平台或效果信息。