视觉 golden 基线(渲染闸的比对基准)
五张基线:棋盘三图(board_L1_dungeon / board_L2_underdark / board_L3_deep_underdark,
裁剪区 900×760)+ 启动态菜单(menu_boot,全屏)+ 关卡画面(level_map,全屏)。
比对判据与工具见 tools/golden_compare.py
(逐像素灰度差 >16 的像素占比 ≤2%)。
时效判定纪律(迭代 29 T7 立)
基线冻结于 2026-09-30(v3.5 视觉落码后)。判定先于动作:每代换代面(视觉/素材/布局改动) 跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
- 判有效(changed 远低于 2% 阈值):基线留在位并在此加注一次判定记录,不得顺手重制;
- 判失效(changed 超阈值或换代面落在裁剪区外):按迭代 26 T6 先例显式重制 + 呈报 + 复闸, 禁止先动后判、禁止用「重制一下就绿了」掩盖真实视觉回归。
- 加严口径(棋盘三图):棋盘图 changed>0 且差异像素落在棋盘裁剪区内(900×760)一律按判失效
处理——占比远低于 2% 阈值也不判有效,显式呈报后由用户定是否重制。该口径只收紧棋盘三图的判读,
不改写 2% 容差本身的语义(
golden_compare.py判据不动);启动态菜单不适用本口径。
判定记录
- 2026-10-16(迭代 29 T7):判有效。三代换代面(棋盘三图 + 启动态菜单)实测 changed = 0.00% / 0.00% / 0.00% / 0.15%,均远低于 2% 阈值 ⇒ 基线留在位,不重制。 (本批零视觉改动,判定属常规复核。)
- 2026-10-25(迭代 37 卡① T3):判失效 → 显式重制 + 复闸。实测棋盘三图
changed = 0.13% / 0.11% / 0.10%,差异像素全落 900×760 棋盘裁剪区内、裁剪区外 0,
按加严口径不判有效;成因定位为
2f3a87e9(秘宝 HUD)注入REWARD_BADGE预读格 字形——晚于 2026-10-08 建基提交,与本批零因果。呈报后用户裁「重制三张基线」, 经tools/golden_baseline_refresh.sh换代;复闸 changed = 0.00% / 0.00% / 0.00%, 启动态菜单 0.00%(未重制)。 - 2026-10-26(迭代 38 卡① l4):新增基线
level_map(改前建基——时点铁序)。 来源 = shot_probe_snap("level")帧(入口停点出图后第 4 帧,淡入完成态), 跨跑次逐像素一致性实测 changed=0.00% 后落盘。承载迭代 38 卡① l1–l3 结构重构的 逐像素对拍(改后对拍 changed=0.00% 为验收主锚);对拍经tools/golden_compare.py直跑(render_gate 现行只对拍棋盘三图+menu_boot,闸件不在本批改动面)。 - 2026-10-26(迭代 38 卡⑦ c8):menu_boot 显式重制(预期面视觉变化——调试角标 发布态恒隐,基线右下角幽灵角标像素消失)。改后实测 changed=0.15%(≈卡面预估 0.14%, 容差内但按 render_gate「预期面视觉变化=显式重制基线」口径重制);复闸 changed=0.00%。