59 lines
4.9 KiB
Markdown
59 lines
4.9 KiB
Markdown
# 视觉 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 | 确认 |
|
||
| 2026-11-09 | 全屏 14 锚换代（调试角标恢复批后续——角标入帧，实测 0.06–0.15% 容差内；逐张差异包围盒同一 44×36 角标区，画面其余零变化；棋盘三图与 lmap 两 Shot 实测 0.00% 不动） | 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 扩项机制随批立锚，发现缺失即补、不再登记待置。）
|