30 lines
2.7 KiB
Markdown
30 lines
2.7 KiB
Markdown
# 视觉 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` 判据不动）；启动态菜单不适用本口径。
|