Files
gplan-2/game/tests/golden/README.md
T

2.0 KiB
Raw Blame History

视觉 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 判据不动);启动态菜单不适用本口径。