SuperAPI AI 工具集

visual-testing-advanced

测试与质量

查看项目

更新于 10-16 03:48

技能介绍

用途:检测和阻止 UI 视觉回归,覆盖布局位移、颜色变化、字体渲染、对齐、图片缺失、内容溢出等类问题,并做响应式设计和跨浏览器一致性验证。

主要能力:像素级对比、结构性相似度、AI 语义对比(可忽略抗锯齿等无意义差异);按区域(selector)截取对比;多视口断点对比;动态内容遮罩;基线更新;CI 门禁(相似度低于阈值时返回非零退出码);Percy 等 AI 工具支持的组件级快照。

用法(主路径 qe-browser visual-diff):先建立基线,再对比,示例命令:vibium go https://example.com;vibium wait load;首次运行 node .claude/skills/qe-browser/scripts/visual-diff.js --name homepage 创建基线;后续运行 node .claude/skills/qe-browser/scripts/visual-diff.js --name homepage --threshold 0.02 对比;可用 --selector 限定区域,--update-baseline 重置基线;多断点用循环设置 vibium viewport。基线存于 .aqe/visual-baselines/,安装 pixelmatch 时使用像素匹配,否则用哈希精确匹配兜底。

回退方案:需要 AI 语义对比(Percy、Applitools)、Firefox/WebKit 跨浏览器渲染检查,或与现有 Playwright 测试套件紧耦合时,使用 Playwright 的 toHaveScreenshot 及 maxDiffPixels、maxDiffPixelRatio、threshold 等配置,并用 mask 遮罩时间戳、计数、广告、头像等动态元素。

适用场景:组件变更、CSS/样式修改、响应式验证、跨浏览器一致性检查。

限制:Vibium 目前仅支持 Chrome;动态内容需显式遮罩;阈值与基线需人工维护;差异应人工复核而非全自动通过。官方未提供收费、价格等信息。