3.9 KiB
3.9 KiB
视觉 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%）。
未建锚面备案（2026-10-29 迭代 41 收尾登记）：营地／设置／战斗三屏与战末结算／三选一／图例／调试浮窗四浮层无改前 golden 锚——迭代 41 测试特许移交（2026-10-28 用户裁，码先行动）致改前帧无法补建；这些呈现面的等价证据承载＝现役探针/单元测试断言面＋实机目检（体验验证清单 ㊵ 节）。
时效判定纪律（迭代 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%。