Merge branch 'board-material-fix'

game/tests/golden/README.md

@@ -16,7 +16,7 @@
 - 浮层四锚 `battle_end`（战末结算）/ `curio_pick`（三选一）/ `legend`（图例）/ `debug_overlay`（调试浮窗）
 - **材质过审预览锚（非引擎帧）7 张**：`board_material_L1`／`_L2`／`_L3`（三关整板 12×8、格边 46）＋
   `board_material_L1_zoom2`／`_digit6`／`_hero4`／`_top4`（第一关机械裁切细部）。来源＝2026-11-09
-  用户目检通过的棋盘材质预览，仅作 `board_material_shot_probe` 的目标图与目检对照；**不参与渲染闸
+  用户目检通过的棋盘材质预览，**只作人审对照与美术方向凭据；不派任何探针复刻，不参与渲染闸
   逐像素比对，不替代 `board_L*` 引擎基线**，故不触发本文件 §基线冻结与审核的引擎帧审核口径。
 - `palette_baseline/`（色板基线，纯文件内容比对，与平台无关）
 

reports/需求卡片-棋盘瓦片与立体表现重做批-2026-11-07.md

@@ -4,7 +4,7 @@
 > **设计事实源（唯一事实源）**：`design/art/art-bible.md` v3.53 §1.4／§3.2／§4.1「三关棋盘环境八色」／§6.3／§7／§8.1「格边长与材质分工」／§8.2／§8.5「生产分工」＋`design/ux/battle.md`（Last Updated 2026-11-09）「Layout Zones」D 区行／「D 区布局与棋盘画法预览」／「封印格呈现预览」＋`design/gdd/systems/表现与支撑/HUD框架.md`（2026-11-07）D 区行与字号下限＋`game/tests/golden/README.md`「越格口径」。
 > **验收档：中**（呈现与交互几何改动，后果玩家可见但不损持久状态；用户 U0 可改判）。
 > **预计**：11.0 个工作日（区间 10–12；T0 0.5／T1 1.5／T2 0.5／T-A 0.5／T3 2.5／T4 1.5／T5 1.5／T6 0.5／T7 1.5／T8 0.5）。
-> **卡片状态**：复核记录见 §16；第一轮 19 条、第二轮 23 条、第三轮 4 条、第四轮 5 条、第五轮 1 条、第六轮（合并整合）6 条、第七轮（材质实现回退）1 条、第八轮（浮空数字几何）1 条、第九轮（512 材质与过审同步）14 条均已处置，第七/八/九轮定向复核通过。
+> **卡片状态**：复核记录见 §16；第一轮 19 条、第二轮 23 条、第三轮 4 条、第四轮 5 条、第五轮 1 条、第六轮（合并整合）6 条、第七轮（材质实现回退）1 条、第八轮（浮空数字几何）1 条、第九轮（512 材质与过审同步）14 条、第十轮（预览锚验收纠偏）2 条均已处置，第七/八/九/十轮定向复核通过。
 
 ---
 
@@ -264,7 +264,7 @@
 **产出**：三关岩顶/地面 6 张 512×512 无缝贴图入 `game/assets/art/board/`；`asset-path-map`／`art-assets-checklist`／`art-status-checklist` 登记；`.import` 边车；像素域 ≤32 色。
 
 - [x] 资产契约：`board_rock_<board_type>.png`／`board_ground_<board_type>.png`，board_type=dungeon/underdark/deep_underdark；无缝、无边框/无亮边/均匀光照、方形；源尺寸 **512×512**；同一母图换色；单张像素域 ≤32 色。
-- [x] 素材已按 asset-ingest 段接入：用户 2026-11-09 对三关整板、崖面/数字细部与 6 张母图确认「没有问题,可以按这样」；预览图作 `board_material_shot_probe` 目标图（非引擎基线），旧 C 方向原稿不再作为新材质基线。
+- [x] 素材已按 asset-ingest 段接入：用户 2026-11-09 对三关整板、崖面/数字细部与 6 张母图确认「没有问题,可以按这样」；预览图只作人审对照（非引擎基线、不作任何探针复刻目标），旧 C 方向原稿不再作为新材质基线。
 - [x] 落位与边车：6 张全部在 `game/assets/art/board/`，命名合规；Godot 4.7.2 `--import` 已生成 6 个 `.import`。已按 `asset-path-map` §1 把 6 PNG＋6 `.import` 同步到主区与 `board-material-fix` 工作区，两区各 12 项一致。
 - [x] `asset-path-map.md` 的 `board/` 行改为「512×512 岩顶/地面 6 张无缝贴图＋seal_mark」；`art-assets-checklist.md` 记录贴图材质；`art-status-checklist.md` 新增「棋盘岩顶/地面材质 6 张」✅ 行。
 - [x] 缺位容错：`UiKit.load_tex` exists 守卫；缺图只在开发态回落 palette 平色，正式包必须 6 张齐；`board_terrain_test._test_material_assets_present` 断言 6 张在库。
@@ -336,7 +336,8 @@
 
 - [ ] `board_shot_probe.gd`：`view.size=Vector2(1036,548)`、`view.position=Vector2.ZERO`；`view.rebuild(..., 200)`；`_meta` 写全幅 rect；`_crop_cell` 用 `_visual_rect_for` 的屏幕换算；`_check_dual_frames` 的允许区改顶面 rect（用 `lift_for/eshift_for` 换算）；**`_seal_evidence` 保持逻辑格 rect（封印居格心），选择器按迭代56后的 `has_seal` 口径**；注释与 `game/tests/golden/README.md` 口径一致。
 - [ ] `type_glow_shot_probe.gd:64-78` 视图改 1036×548、`rebuild(..., 200)`（与生产同格边 38），允许区/取样改顶面 rect；`layout_probe.gd` 的 `_cell_for` 带侧栏；`ui_input_probe.gd` 的恢复调用带侧栏；`ui_contrast_probe` 浮空四类底段与迷雾段换代。
-- [ ] 材质过审预览锚（非引擎帧）：`game/tests/golden/board_material_L1.png`／`_L2`／`_L3`（三关整板，12×8、格边 46）＋`board_material_L1_zoom2.png`／`_digit6`／`_hero4`／`_top4`（第一关机械裁切）已按 2026-11-09 用户目检通过的预览重制，并在 `golden/README.md` 登记为预览锚、明确不替代 `board_L*`；新增/扩展 `board_material_shot_probe` 以同一 12×8、46px 构图复刻，与 512×512 新材质、断续岩块和薄边缘对齐比对（材质/构图差异判据沿用渲染闸容差）。
+- [ ] 材质过审预览锚（非引擎帧）：`game/tests/golden/board_material_L1.png`／`_L2`／`_L3`（三关整板，12×8、格边 46）＋`board_material_L1_zoom2.png`／`_digit6`／`_hero4`／`_top4`（第一关机械裁切）已按 2026-11-09 用户目检通过的预览重制，并在 `golden/README.md` 登记为**人审对照锚**；不新增 `board_material_shot_probe`，不拿 HTML/Pillow 合成图与引擎帧做逐像素比对。
+- [ ] 材质结构验收走真实入口：`board_terrain_test.gd:_test_material_assets_present` 断言 6 张 512×512 经 `tex_paths_for`／`UiKit.load_tex` 消费；`_test_material_vs_structure` 断言相邻岩体全局 UV 连续、北/西 1+1+外2 边宽、南/东 3×1 内阴影、崖面无贯通岩层线；真机取证件用 `res://probe/board_shot_probe.tscn` 的真实 LevelRunner 起板帧（1036×548、真实 12×12 板型），不做 12×8 捏板复刻。
 - [ ] 引擎侧 `board_L1_dungeon`／`board_L2_underdark`／`board_L3_deep_underdark` 仍待实现后换代：先跑一次渲染闸看差异（预判全幅 changed>0，属换代）；**显式呈报用户，按 `game/tests/golden/README.md` 现行口径获用户确认后**再按 `tools/golden_baseline_refresh.sh` 重制三关引擎基线；复闸绿。材质过审预览锚不替代本步。
 - [ ] 三关色板逐值核对：`board_terrain_test.gd:_test_palette_three_boards` 与 art-bible v3.53 §4.1 三关八色同值（用户 2026-11-07 已看样张冻结）；`_test_material_assets_present` 核对 6 张 512×512 与像素域 ≤32（实测岩顶 9 色、地面 6 色）；`glow_discrimination_sheet.py` 读已删旧 `terrain_*`，本批不跑，工具换代登记待办（tools 批）；不过即停卡呈报，不调色绕过。
 - [ ] 跑 `bash tools/run_all_gates.sh --code`；报告写 smoke/unit/probe/render 读数。
@@ -374,7 +375,7 @@
 | 12. 侧栏信号/setter（判据：`design/ux/battle.md「Component Inventory」行动资源侧栏`） | `ap_bar_view.gd` | `board_side_rail_test.gd:_test_signals` | 单元 | 真实按钮 `pressed`/setter | `stop_pressed`/`refresh_confirmed`/`legend_toggled` 逐信号；`set_ap`/`set_rap`/`set_refresh_state` 读数 | 新增：D 区行动资源侧栏（AP 左栏、RAP 右栏、全高棋盘） |
 | 13. 接触带延续（判据：`design/art/art-bible.md「3.2 环境几何」可挖域接触带微光`） | `board_cell_unit.gd`、`board_view.gd:740,764-765` | `board_terrain_test.gd:_test_contact_glow`；`type_glow_test.gd` | 单元 | `BoardView.refresh()`→`ContactGlow.set_bands(..., ground_visible_rect)` | 英雄格地面侧接触带在位，正交整边/斜向角点+两半边，只绘地面可见区、不进岩体；全局 z=-1 | 既有：未开格类型微光（8 邻作用集、五组色相、零玩法写入） |
 | 14. 三关色板/互辨（判据：`design/art/art-bible.md「4.1 主色板」三关棋盘环境八色`） | `board_terrain_palette.gd` | `board_terrain_test.gd:_test_palette_three_boards`＋`_test_material_assets_present` | 单元＋静态 | `palette_for("dungeon"/"underdark"/"deep_underdark")`／`tex_paths_for(...)` | 三关八色与 art-bible v3.53 §4.1 逐值一致；三关同名槽位不全等（用户过审样张冻结）；不变槽恒定；封印石读 `light_edge`；6 张 512×512 贴图路径在库、单张像素域 ≤32（实测岩顶 9 色、地面 6 色） | 新增：棋盘合并岩体与连续地面（深度遮挡、投影、崖面） |
-| 15. 取证面换代（判据：`game/tests/golden/README.md「基线冻结与审核」才允许出候选图`） | `board_shot_probe.gd`、`board_material_shot_probe`（新增/扩展）、`type_glow_shot_probe.gd`、`layout_probe.gd`、`ui_input_probe.gd`、`ui_contrast_probe.gd` | 三关 `board_shot_probe`＋渲染闸；`board_material_shot_probe` 对过审预览图；`type_glow_shot_probe`；`layout_probe.gd:_ready`；`ui_input_probe.gd`；`ui_contrast_probe.gd` | 探针＋渲染闸 | `res://probe/board_shot_probe.tscn`；`tools/render_gate.sh`；`game/tests/golden/board_material_L1.png`（过审预览锚） | 视图 1036×548、侧栏 200、裁剪全幅、顶面 rect 微光圈、**封印取证保持逻辑格 rect（圆心格心）**、三关 golden 重制后 0 差异；12×8/46px 材质探针与 512×512 新材质、断续岩块、薄边缘预览对齐，差异在容差内 | 既有：战斗屏三区几何与棋盘格边长（分辨率两档×四档板型） |
+| 15. 取证面换代（判据：`game/tests/golden/README.md「基线冻结与审核」才允许出候选图`） | `board_shot_probe.gd`、`board_terrain_test.gd`、`type_glow_shot_probe.gd`、`layout_probe.gd`、`ui_input_probe.gd`、`ui_contrast_probe.gd` | 三关 `board_shot_probe` 真实起板帧＋渲染闸；`board_terrain_test.gd:_test_material_assets_present`＋`_test_material_vs_structure`；`type_glow_shot_probe`；`layout_probe.gd:_ready`；`ui_input_probe.gd`；`ui_contrast_probe.gd` | 单元＋探针＋渲染闸 | `res://probe/board_shot_probe.tscn` 真实 LevelRunner 起板（1036×548）；`board_terrain_test.gd`；`tools/render_gate.sh` | 视图 1036×548、侧栏 200、真实 12×12 板型；6 张贴图经 `tex_paths_for`／`load_tex` 消费、相邻岩体全局 UV 连续、1+1+外2 边宽、南/东 3×1 内阴影、崖面无贯通岩层线；**材质预览锚只作人审，不参与逐像素比对**；引擎 `board_L*` 重制触发基线审核关卡 | 既有：战斗屏三区几何与棋盘格边长（分辨率两档×四档板型） |
 | 16. 测试入口/能力审计（判据：`design/engineering/test-conventions.md「8.9 三层模型」能力清单`） | `run_all.gd:225`、新增测试件、`game/tests/README.md` | `bash tools/run_all_gates.sh --code`；`capability_audit.py` | 集成 | 单元测试全套件 | 三新套件在册、terrain 套件移除、能力审计红项 0、全绿 | 新增：棋盘合并岩体与连续地面（深度遮挡、投影、崖面） |
 | 17. 产出物/独立审计（判据：`design/engineering/test-conventions.md「8.6 测试时机」不要求先红后绿`） | `reports/` | 末卡产出物落位；`reports/iter<N>-验收审计-<日期>.md` | 集成 | 实现报告/反哺点清单/审计报告 | 三件齐、逐行勾选、审计未过不合并 | 既有：战斗屏三区几何与棋盘格边长（分辨率两档×四档板型） |
 
@@ -513,7 +514,10 @@
 | 9 | 同上 | §3 档期仍写“待编排” | 补写 | 改为“已写卡＋已编迭代 57、待开工” |
 | 9 | 同上 | 待办证据引用已不存在的旧 art-bible 条款 | 补写 | 改为历史陈述“旧条款已随 v3.53 解冻” |
 | 9 | 同上 | art-assets checklist §3.3 要什么/前置仍按逐格砖面 | 补写 | 改为只出雷格/数字格面语义纹样，六张材质已录入，不再出逐格瓦片 |
+| 10 | 实现会话反馈（2026-11-10） | T7 让 `board_material_shot_probe` 复刻 12×8/46 预览；真实 `board_shot_probe` 用 LevelRunner 起真实 12×12 板，复刻只能捏板，违背真实入口且实测密度全错 | 补写 | 删除 `board_material_shot_probe` 计划；预览锚只作人审对照；真机取证沿用 `board_shot_probe` 真实起板帧 |
+| 10 | 同上 | T7 把 HTML/Pillow 合成预览与引擎帧套渲染闸逐像素容差；两套管线不同，同材质同布局也必超差 | 补写 | 删除逐像素比对；材质验收改 `_test_material_assets_present`＋`_test_material_vs_structure` 结构断言（装载、UV 连续、边宽、崖面线不贯通）；`board_L*` 引擎基线仍按审核关卡 |
 
 第七轮定向复核：通过（1 条已处置；材质口径与样张、§8.5 一致）。
 第八轮定向复核：通过（1 条已处置；预览几何与 art-bible §3.2 浮空数字条逐值一致）。
 第九轮定向复核：通过（14 条均闭合；§12 全表 20 组内容锚零 MISS，判据列零行号锚）。
+第十轮定向复核：通过（2 条均闭合；预览锚与引擎验收面彻底分离，真实入口恢复为 `board_shot_probe`）。