视觉 golden 基线(渲染闸的比对基准)
基线按平台各存(2026-11-03 用户裁:跨显卡/字形渲染机制差异使跨平台逐像素必失配——
windows/ 与 mac/ 子目录各持一套,平台内部照常严格比对,跨平台不互比;
平台选择实现单点 = tools/gate_platform.sh 的 gate_platform_id,比较器 tools/golden_compare.py
自动拼平台子目录)。本目录现持:windows/(棋盘三图 board_L1_dungeon / board_L2_underdark /
board_L3_deep_underdark,裁剪区 900×760 + 启动态菜单 menu_boot,全屏)、
level_map(关卡画面全屏,历史基线留根——现行闸件未对拍它)、
palette_baseline/(色板基线,纯文件内容比对与平台无关)。
比对判据与工具见 tools/golden_compare.py
(逐像素灰度差 >16 的像素占比 ≤2%)。
未建锚面备案:营地/设置/战斗三屏与战末结算/三选一/图例/调试浮窗四浮层无改前 golden 锚;这些呈现面的等价证据承载=现役探针/单元测试断言面+实机目检(体验验证清单 ㊵ 节)。
时效判定纪律
基线冻结于 2026-09-30。判定先于动作:每代换代面(视觉/素材/布局改动) 跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
- 判有效(changed 远低于 2% 阈值):基线留在位,不得顺手重制;
- 判失效(changed 超阈值或换代面落在裁剪区外):显式重制 + 呈报 + 复闸, 禁止先动后判、禁止用「重制一下就绿了」掩盖真实视觉回归。
- 加严口径(棋盘三图):棋盘图 changed>0 且差异像素落在棋盘裁剪区内(900×760)一律按判失效
处理——占比远低于 2% 阈值也不判有效,显式呈报后由用户定是否重制。该口径只收紧棋盘三图的判读,
不改写 2% 容差本身的语义(
golden_compare.py判据不动);启动态菜单不适用本口径。