4.6 KiB
视觉 golden 基线（渲染闸的比对基准）
基线跨平台单套（2026-11-08 用户裁：跨平台渲染必须一致——Windows 与 macOS 对拍同一份基线，
差异必须落在容差带内；跨平台实测噪声棋盘 ≤0.033% / menu ≤0.68% changed，口径 ≤16/像素、≤2% 面积，
比较器 tools/golden_compare.py，禁以加基线方式消化差异）。本目录现持（单层，无平台子目录）：
- 棋盘三图
board_L1_dungeon/board_L2_underdark/board_L3_deep_underdark——裁剪区由探针按board_meta.json采样坐标决定（禁硬编码像素） - 启动态菜单
menu_boot（全屏，迭代 28 T4 立） - 关卡视口两 Shot
lmap_entry/lmap_boss——2026-11-05 用户裁：只对拍关卡最开始（入口停点）与 关卡 Boss 节点（末列锚定），中间过程不对拍 - 屏态五锚
camp_screen/settings_screen/battle_screen/career_screen/status_panel（全屏，shot_probe 七屏采集——golden 补锚批 2026-11-08：battle 段带呼吸相位冻结） - 营地窗态五锚
camp_forge/camp_chest/camp_tree/camp_codex/camp_notebook（真点热点开窗态，camp.md:45 五窗窗壳） - 浮层四锚
battle_end（战末结算）/curio_pick（三选一）/legend（图例）/debug_overlay（调试浮窗） palette_baseline/（色板基线，纯文件内容比对，与平台无关）
采集＝真实引擎渲染：探针以固定种子跑到指定状态截屏（棋盘 golden 帧＝微光关态，呼吸相位冻结；
确定性采集）。换代入口＝tools/golden_baseline_refresh.sh（缺省棋盘／--menu／--lmap），
提交说明须写明触发原因（强制）。两 Shot 基线采集＝res://probe/level_map_shot_probe.tscn。
基线冻结与审核（2026-11-08 用户立）
基线＝人定标准、机器守标准。任何基线的新建／换代／迁移／容差修订，须呈报用户逐张审核、 确认后才能提交入库生效；确认记录登记于下方审核记录节（审核人＋时间＋基线清单），未审核的 基线禁合回。机器侧前置：探针自检 PASS（结构断言——非生效格零变化／生效格实绘非空等——在案） 才允许出候选图；候选图不满足自检＝采集失败，不得送审。
审核记录
| 日期 | 基线清单 | 审核人 | 结果 |
|---|---|---|---|
| 2026-11-08 | 棋盘三图＋menu_boot＋lmap 两 Shot＋单基线合并（6 张） | DKChan | 确认 |
| 2026-11-08 | 屏态五锚＋营地窗态五锚＋浮层四锚（14 张补锚） | DKChan | 确认 |
| 2026-11-09 | menu_boot 换代（调试角标恢复批——右下角「调试」角标重现，预期面视觉变化显式重制） | DKChan | 确认 |
时效判定纪律
基线冻结时点：menu_boot＝迭代 28 T4；lmap 两 Shot＝2026-11-05；棋盘三图＝2026-11-08 迭代 56 卡 2 换代（封印受理即揭示渲染入帧）；单基线合并＝2026-11-08。判定先于动作：每代换代面 （视觉/素材/布局改动）跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
- 判有效（changed 远低于 2% 阈值）：基线留在位，不得顺手重制；
- 判失效（changed 超阈值或换代面落在裁剪区外）：显式重制＋呈报＋复闸， 禁止先动后判、禁止用「重制一下就绿了」掩盖真实视觉回归。
- 加严口径（棋盘三图·同平台复跑）：windows 本地对拍棋盘 changed>0 一律按判失效处理—— 同种子同参数应逐位一致，任何非零差异都可能是真回归，显式呈报后由用户定是否重制； 该口径只收紧棋盘三图的判读，不改写 2% 容差本身的语义；启动态菜单不适用本条。
- 跨平台对拍（CI mac）：不适用上一条——跨平台字形锯齿噪声按容差带吸收（2026-11-08 用户裁）， changed 落容差带内判有效；超容差即红停批呈报，禁加基线消化。
- 越格口径（棋盘地形换代立）：棋盘地形允许越格绘制——岩顶抬升、南/东崖面、四段投影、 浮空数字与引导线均按 art-bible §3.2 越出逻辑格边界；「禁越圈」只约束类型微光层（按该格抬升后 岩顶面 rect 判，不按逻辑格 rect），不约束地形/小人/浮空层。棋盘金标仍按加严口径整幅严格比对。
未建锚面备案：（2026-11-08 补锚批后备案清零——上列营地/设置/战斗三屏、生涯/状态两屏顺带锚、 营地五窗、四浮层全部入锚；此后新画面按 §8.2 扩项机制随批立锚，发现缺失即补、不再登记待置。）