Sprite 截图回归怎么定容差？分开位置、透明度与颜色

本文由 FrameSprite 作者工作流整理，AI 辅助编写，引用原始技术资料；构造案例不代表模型或引擎实测。

固定截图条件，报告差异区域与阈值，让素材更新可以被独立复核。

简要答案

先固定尺寸、缩放、帧时刻和背景，再比较截图。透明边缘、位置变化与颜色变化使用不同检查；阈值和忽略区域写入报告，失败后保留原图与差异图。一个总体差异百分比不能说明角色脚点、武器或字形是否正确。

适用范围

• 换一套角色图后需要确认布局没回退，但肉眼检查容易漏项。

不适用范围

• 有意大幅重画的美术不应强制与旧像素相同，需要新的人工基准。

1. 固定可重复截图

固定视口、DPR、缩放与动作时刻，等待资源加载。关闭非必要随机粒子，记录背景；跨平台文字渲染变化不能被默认为人物素材改变。

2. 分别定义检查项

角色脚点可用几何约束，轮廓用透明区域，颜色用受控差异工具。像素差工具的 threshold 是其定义的参数，不等于你可随意称作百分比的肉眼差异。

3. 报告差异范围

除了差异数量还输出边界区域。一个小面积但位于武器尖端的变化可能重要；不要把总面积小当作必然通过，忽略区域应有明确理由。

4. 人工批准新基准

失败时保留旧图、新图与差异图，判断是预期美术还是错误布局。新基准应带版本与原因；帧灵输出是候选，不因生成完成就自动更新黄金截图。

原创构造样本：位置错一像素

两张 3×2 二值图，亮点从 (1,0) 移到 (2,0)，按严格像素相等比较。

差异像素为 2，区域覆盖 x=1 至 2、y=0。

这是严格二值比较，不测试真实抗锯齿阈值或引擎截图。

三种比较依据

同一个差分数字，可能对应两种完全不同的问题

构造 100 个比较像素，只有 2 个不一致，比例为 2%。如果这两个点位于角色边缘，可能是位置或抗锯齿差异；如果位于眼睛或握持点，就可能是重要细节改变。不能只按全图比例决定通过，因为大片空白会稀释角色错误。分别比较透明蒙版、角色包围盒和前景颜色，并保存差异位置。阈值应由项目允许的误差决定，之后固定运行环境和取样时间；这项小算例不等于给任何真实素材设置了 2% 的合格标准。

• 验收：前景区域
• 验收：差异位置
• 验收：环境与时间一致

差异报告用于解释，不替代判断

为宣传提供样本时，应同时标注构造数据与真实截图，不把运行过二值算式称作引擎实测。接收者拿到阈值、源图和截图条件，才能复核变化是否可接受。版本报告也应说明主动批准的美术改变。

编辑与示例说明

本次补充由 AI 辅助整理，按公开原始技术资料核对。可下载的输入与预期结果是原创构造案例，不代表模型或引擎实测；实际项目应按步骤保留自己的验收记录。

常见问题

差异少就自动通过吗？

要看变化位置与验收规则。

阈值能跨平台直接照搬吗？

需核对截图条件。

生成成功就更新基准吗？

不应，需明确验收。

来源与补充材料

Pixelmatch image comparison options · Mapbox

Canvas pixel manipulation · MDN

原文：https://cn.framesprite.com/guides/sprite-regression-image-diff-thresholds