视觉 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,全屏 + 关卡视口两 Shot
lmap_entry / lmap_boss——2026-11-05 用户裁两 Shot 面:只对拍关卡最开始(入口停点)与
关卡 Boss 节点(末列锚定),中间过程不对拍)、
level_map(关卡画面全屏,历史基线留根——现行闸件未对拍它,由两 Shot 面接替)、
palette_baseline/(色板基线,纯文件内容比对与平台无关)。
比对判据与工具见 tools/golden_compare.py
(逐像素灰度差 >16 的像素占比 ≤2%)。两 Shot 基线采集=res://probe/level_map_shot_probe.tscn
(固定种子单关直构——确定性采集),换代入口=tools/golden_baseline_refresh.sh --lmap;
他平台(mac)的关卡视口基线尚未冻结——渲染闸对本平台缺基线记 SKIP 不判红,冻结义务归批末呈报。
未建锚面备案:营地/设置/战斗三屏与战末结算/三选一/图例/调试浮窗四浮层无改前 golden 锚;这些呈现面的等价证据承载=现役探针/单元测试断言面+实机目检(体验验证清单 ㊵ 节)。
时效判定纪律
基线冻结于 2026-09-30;关卡视口两 Shot(lmap_entry/lmap_boss)冻结于 2026-11-05——两 Shot 面口径(只对拍入口停点与 Boss 节点)见上文现持清单行。判定先于动作:每代换代面(视觉/素材/布局改动) 跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
- 判有效(changed 远低于 2% 阈值):基线留在位,不得顺手重制;
- 判失效(changed 超阈值或换代面落在裁剪区外):显式重制 + 呈报 + 复闸, 禁止先动后判、禁止用「重制一下就绿了」掩盖真实视觉回归。
- 加严口径(棋盘三图):棋盘图 changed>0 且差异像素落在棋盘裁剪区内(900×760)一律按判失效
处理——占比远低于 2% 阈值也不判有效,显式呈报后由用户定是否重制。该口径只收紧棋盘三图的判读,
不改写 2% 容差本身的语义(
golden_compare.py判据不动);启动态菜单不适用本口径。