SuperAPI AI 工具集

validation-diff-gifs

测试与质量

查看项目

更新于 10-15 22:38

技能介绍

用途:将验证采集图像与黄金参考图像之间的像素差异制作成逐相机 GIF 动画,便于快速定位基准测试的视觉回归。

主要能力:提供两个脚本。scripts/generate_diff_gifs.sh 处理嵌套 Robots/ 布局的基准测试逐相机差异;scripts/sdg_tolerance_diff_gifs.sh 处理扁平 rgb/ 布局的 SDG 黄金集差异,并可通过 qa_report.json 只对 QA 失败帧生成差异。输出 diff_animation.gif,黑色表示一致,越亮差异越大(按 amplify 放大)。

使用方式:需 ImageMagick 的 composite、convert 在 PATH 中,并已有与黄金数据目录结构匹配的验证采集。采集与黄金数据位于 standalone_examples/benchmarks/validation/captures/<run_name>/ 与 golden_data/<benchmark_name>/。示例:bash "${CLAUDE_SKILL_DIR:-skills/validation-diff-gifs}/scripts/generate_diff_gifs.sh" <captured_run_dir> <golden_benchmark_dir> [amplify] [fps],amplify 默认 10,fps 默认 5。SDG 脚本参数为 <sdg_output_dir> <sdg_golden_dir> [qa_report.json] [amplify] [fps],传 - 表示对比全部帧;使用 qa_report 时需 jq,深度 .npy 对比需 Python 3 与 numpy。

适用场景:调试验证容差失败、基准视觉回归、SDG 生产采集 QA 失败帧定位。

限制:对容差设置及采集时的驱动/GPU 差异敏感;需要已有黄金图像目录;无黄金目录需先生成采集;全帧红色差异可能因容差过紧或光照漂移;GIF 为空表示无变化像素,需确认分辨率匹配。