技能介绍

问题：视觉差异容易被 CI 噪音淹没

截图回归测试会在每次流水线运行时产生大量图片和日志。一个按钮宽度变化可能只是几十像素，却会和动画帧、字体渲染、环境差异等噪声混在一起，靠肉眼翻日志很难判断是否真的需要更新基线。技能要解决的是把图片快照拉进统一的复核流程：用存储的基线做比对，把差异整理成可人工查看的报告，并把审核后的快照基线发布回团队可见的位置。

技能如何工作

聚焦快照复核循环：它不是通用前端工具，而是围绕截图输出管理 compare、publish、notify 这几个环节。
接收测试产物：前提是 CI 中能产出截图 artifacts；技能以这些图片为输入，对照历史基线执行比较。
生成可审阅差异：比较结果会整理为便于人看的报告，让 reviewer 直接判断是回归、环境噪声还是需要更新基线。
发布基线与通知：审核通过后，新的基线会被发布；如需远程存储，可使用 S3 或 GCS 这类 publisher 插件。
串起 CI 流程：Agent 负责把比较、报告发布、复核通知串成闭环，而不是只跑一次图片比对。

适用边界与注意点

适合已经能稳定产出截图的视觉回归场景，不负责替代前端构建、lint 或通用测试框架。运行环境需要 Node.js、npm 和截图测试产物；若要持久化基线或报告，还需配置 S3、GCS 等 publisher。上游示例曾固定在 Node.js 10.x，实际项目应结合当前运行时验证兼容性。截图捕获必须尽量确定性，避免动画、字体、视口或时间戳造成大量伪差异。基线更新应保留人工复核关口，否则自动化发布可能把错误快照变成“新的正常”。