Merge branch 'glow-freeze'

本步凭据: 抽测件实跑 17 项 FAIL 0(dungeon 实测 #B49069 L=0.307 过门余量 0.007／underdark #BAC1D2 0.532／deep_underdark #969EBA 0.345)＋样图与 2026-11-05 出图件逐字节同哈希(15d33fabb75256677254…，目检面未变)＋§1.4 格子样张重跑 30/31 绿(唯一红 V10＝在途素材区无改前基线件，拒用 --save-baseline 造「改前＝改后」空对拍)＋run_all_gates --docs 闸况与基线一致无新增红(流水线闸 PASS，条目 27；术语闸抓到「不得」两处已按 STC 词表改「禁止」)＋目检口径记档(用户回话「没有问题，我觉得是可以分清楚的」，经追问四条覆盖范围答「四条全过」)。

订正备案: 本会话中代理一度判「dungeon 顶面受光档 L=0.235 不达圣经地板」并拟立案，系测量用 sRGB 加权亮度排序选像素、与该门线性域相对亮度口径不同尺度的失误；按件内口径实测 0.307 过门，未据此立任何条。

.gitattributes

@@ -1,2 +1,19 @@
 # git 钩子文件必须保持 LF——autocrlf=true 检出会转 CRLF，bash 执行带 \r 的脚本即崩。
 tools/hooks/* text eol=lf
+# 全仓文本一律 LF 入库与检出——Windows core.autocrlf=true 会把工作区检出成 CRLF，
+# 行尾一旦进入逐字符比对的字符串基线数据面（如测试内嵌的多行 golden 常量），
+# 运行时基线（\n）与源码基线（\r\n）逐位比对必红。本规则让一切平台检出落 LF。
+* text=auto eol=lf
+# 二进制面显式豁免（防 auto 误判转码损坏素材与基线图）
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.webp binary
+*.gif binary
+*.ico binary
+*.ogg binary
+*.wav binary
+*.mp3 binary
+*.ttf binary
+*.otf binary
+*.zip binary

AGENTS.md

@@ -16,7 +16,7 @@
 
 ## 运行与验证（工作目录 = 含 project.godot 的切片目录）
 
-- **合回验证 = 远端 CI（2026-11-03 用户裁）**：git merge 合回 master 落地后，post-merge 钩子（`tools/hooks/post-merge`）自动 `git push origin master` 触发远端 CI（Gitea Actions，runner＝Mac 本机 host 模式，环境自举件＝`tools/ci/mac_setup.sh`），工作流（`.gitea/workflows/ci.yml`）按改动域分流（分流算法单点＝`tools/ci/domain_route.sh`）：游戏码批＝两域全量含渲染闸，文档批＝文档域秒级闸，纯闸件/管线批＝零触发。远端结果**按需现查**：`tools/ci_check.sh <合并提交>` 读该提交任务的 run `status`/`conclusion`，只呈报、不落盘（2026-11-04 用户裁：合回不等待、不唤醒；判据＝run 落定后的终局态，且绿须坐实跑闸步真跑过——零触发批呈报「未验」不作绿证，细则=process-conventions §1 第 3 条）。**合回落地即向用户呈报本批总结并止回合**，禁前台 sleep／轮询等 CI。CI 红态不回滚合并——红项在案、修复批合回即再推再验追绿；开工先跑现查件读 CI 状态，红未修不开新批。同一份字节禁止第二次人手跑。`tools/run_all_gates.sh` 仍是全部验证闸的**唯一入口与唯一清单，域划分与选闸算法只写在它这一个地方**，文档禁另列清单；`--code`／`--docs`／`--quick` 是开发期改完即测的选档入口（细则见 process-conventions §4），全量档不替代它。**runner 依赖**：Mac 需开机在线（关机＝远端任务排队延后）；换机/重装按 `tools/ci/mac_setup.sh` 自举
+- **合回验证 = 前置检查 ＋ 远端 CI（前置检查 2026-11-06 用户裁）**：主区 `git merge --no-ff` 落合并提交前，pre-merge-commit 钩子（`tools/hooks/pre-merge-commit`）自动跑 `tools/run_all_gates.sh --premerge`——冒烟测试＋单元与集成测试全套件（4 分片），热导入缓存约 2 分钟；红＝合并提交不落（修红后 git commit 续合，或 git merge --abort 放弃），快进合并不触发钩子，`--no-verify` 可跳过且仅属用户。git merge 合回 master 落地后，post-merge 钩子（`tools/hooks/post-merge`）自动 `git push origin master` 触发远端 CI（Gitea Actions，runner＝Mac 本机 host 模式，环境自举件＝`tools/ci/mac_setup.sh`），工作流（`.gitea/workflows/ci.yml`）按改动域分流（分流算法单点＝`tools/ci/domain_route.sh`）：游戏码批＝两域全量含渲染闸，文档批＝文档域秒级闸，纯闸件/管线批＝零触发。远端结果**按需现查**：`tools/ci_check.sh <合并提交>` 读该提交任务的 run `status`/`conclusion`，只呈报、不落盘（2026-11-04 用户裁：合回不等待、不唤醒；判据＝run 落定后的终局态，且绿须坐实跑闸步真跑过——零触发批呈报「未验」不作绿证，细则=process-conventions §1 第 3 条）。**合回落地即向用户呈报本批总结并止回合**，禁前台 sleep／轮询等 CI。CI 红态不回滚合并——红项在案、修复批合回即再推再验追绿；开工先跑现查件读 CI 状态，红未修不开新批。同一份字节禁止第二次人手跑。`tools/run_all_gates.sh` 仍是全部验证闸的**唯一入口与唯一清单，域划分与选闸算法只写在它这一个地方**，文档禁另列清单；`--code`／`--docs`／`--quick` 是开发期改完即测的选档入口（细则见 process-conventions §4），全量档不替代它。**runner 依赖**：Mac 需开机在线（关机＝远端任务排队延后）；换机/重装按 `tools/ci/mac_setup.sh` 自举
 - 单件直跑（＝改完即测的最窄确认，其读数就是那一步的凭据；跨改动面的漏网由合回后远端全量档兜）：冒烟测试 `python tools/run_smoke.py`（`game/tests/smoke_boot.tscn` 极小启动场景）· 系统测试 `python tools/run_system_test.py`（宿主 `game/tests/system_test.gd`）· 场景探针 `…console.exe --headless --path . res://probe/ui_probe.tscn` · 单元与集成 `… --script res://tests/run_all.gd`
 - 调参批量：`--script res://sim/adventure_monte_carlo.gd`（全冒险期望）· `res://sim/reward_expectation.gd`（奖励期望）；关卡完成率/难度类测量一律走全冒险
 - 数值验证：`python tools/balance_verifier.py`（采集端 `res://sim/verifier_batch.gd`，报告与原始数据落 `sim-data/`）
@@ -104,7 +104,7 @@
 
 ## 硬性红线（勿违反；操作细则在 process-conventions.md 与各规约）
 
-- 车道铁律（2026-10-31 用户裁恢复）——主工作区只作合并落点，一切开发/设计改动走独立 worktree：`git worktree add ../g-plan2-<任务名> -b <任务分支>`（建区即跑 `tools/setup_worktree_userdir.sh`），收口＝冻结→件核→并 master→重塑→主区 `git merge --no-ff`→删区（合回即删，2026-09-19 原裁），CI 红不回滚合并——新开修复 worktree（`fix-<任务名>` 分支，免重塑免数卡）修复合回追绿；会话单区（2026-11-04 用户裁）——同一时刻每会话至多一个 worktree 在役，同会话追加事项并入在役区、只做一次合入（一次 CI），合回后用户再发令＝新回合另开区，迭代实现批独占回合（细则见 process-conventions §1 第 5 条）；主区唯一合法写动作＝合并，agent 侧由 worktree-guard 拦主区 Edit/Write 与非 merge 提交；豁免面仅 `.zcode/`、`.qoder/`（不入 git，主区直改）；commit 点零钩子检查（pre-commit 直改闸已退役），全量验证归合回后远端 CI（post-merge 钩子推送触发，见「运行与验证」首条）；`--no-verify` 仅属用户，agent 禁用（细则见 process-conventions §1）
+- 车道铁律（2026-10-31 用户裁恢复）——主工作区只作合并落点，一切开发/设计改动走独立 worktree：`git worktree add ../g-plan2-<任务名> -b <任务分支>`（建区即跑 `tools/setup_worktree_userdir.sh`），收口＝冻结→件核→并 master→重塑→主区 `git merge --no-ff`→删区（合回即删，2026-09-19 原裁），CI 红不回滚合并——新开修复 worktree（`fix-<任务名>` 分支，免重塑免数卡）修复合回追绿；会话单区（2026-11-04 用户裁）——同一时刻每会话至多一个 worktree 在役，同会话追加事项并入在役区、只做一次合入（一次 CI），合回后用户再发令＝新回合另开区，迭代实现批独占回合（细则见 process-conventions §1 第 5 条）；主区唯一合法写动作＝合并，agent 侧由 worktree-guard 拦主区 Edit/Write 与非 merge 提交；豁免面仅 `.zcode/`、`.qoder/`（不入 git，主区直改）；commit 点零钩子检查（pre-commit 直改闸已退役）；合回 merge 点另有前置检查钩子（pre-merge-commit，2026-11-06 用户裁，见「运行与验证」首条）；全量验证归合回后远端 CI（post-merge 钩子推送触发，见「运行与验证」首条）；`--no-verify` 仅属用户，agent 禁用（细则见 process-conventions §1）
 - **仓库根禁止设会话状态文件**（`active.md` 已废除）——现状看 roadmap「当前位」，待办看待办清单，过程看 git 提交信息，产出物看 `reports/`；任何文档禁止另设「当前状态快照」节，两处记同一件事必然漂移（细则见 doc-conventions 第 10 节）
 - **改完即测铁规（2026-11-05 用户裁，取代原「测试执行两入口铁规」）**——任何会话里的任何改动，落笔之后立刻跑一遍覆盖该改动面的验证并跑绿、读数写进这一步的提交信息，这一步才算完成；验证载体一律按 `tools/run_all_gates.sh` 的域划分与该件自身的直跑方式，不扩出改动面、不请示、不等点名，未改动的面不测，合回后远端 CI 的全量跑批不替代本条。读数类采集（MC/verifier）不在该域划分内，不属本条义务
 - **红账不清不开新批**——上一批远端跑批有真红未闭合不开新批；假红（导入缓存、user 目录未隔离那类在册环境坑）走异常分级处置，不算未闭合

design/art/art-bible.md

@@ -1,6 +1,6 @@
 # 美术圣经(Art Bible)— Dungeon Sweeper
 
-> 项目：Dungeon Sweeper（扫雷 × 自动战斗 闯关 Roguelike）· 状态：**第 1–9 节定稿**；现行为 v3.42，历次修订明细见 git 提交史
+> 项目：Dungeon Sweeper（扫雷 × 自动战斗 闯关 Roguelike）· 状态：**第 1–9 节定稿**；现行为 v3.43，历次修订明细见 git 提交史
 >
 > **Art Director Sign-Off(AD-ART-BIBLE)**：历次批均未签核——此为 Lean/Solo 模式（非 PHASE-GATE）下的现行治理状态；full 门禁签核时机待用户表态。
 > 风格基调：地牢题材但**非暗黑风**——轻快明亮的幻想冒险风，全年龄；像素风；角色 2~3 头身。
@@ -215,7 +215,7 @@
 - **换色合并登记五处（用户裁，部件色落值）**｜按本表「不过门即触发换色合并、禁加色绕行」执行，五处**零新增额度**（各件原拟新增候选一律不取）：① 主角铲刃浅铁灰（原拟 `#A8AEB8`）→ 并入 `FOG_MEMORY_INK #C4C4C4`，**部件取值 = `#C4C4C4`**；② 主角提灯铜色（原拟 `#C08A3A`）→ 并入 `GOLD_DEEP #B07A14`，**部件取值 = `#B07A14`**；③ 食人魔酋长暖褐皮（原拟 `#B08050` / `#A97C4E`）→ 并入 `暖石 #B8A582`，**部件取值 = `#B8A582`**；④ 石君王灰皮（原拟 `#9A968C` / `#949089`，按**次级皮**口径——板甲视同体块主色、灰皮属次级皮故不受 L 0.22–0.45 约束）→ 并入 `STONE #786E62`，**部件取值 = `#786E62`**；⑤ 轻甲护甲图标木色 `#8A5A34`（深素底下 2.72:1 不过门；原拟新增木色亮档 `#C49A5E`）→ 并入 `WARM_FAINT #CDB88C`，**部件取值 = `#CDB88C`**（8.08:1）。**一色两岗代价已随裁定接受**：① 的 `#C4C4C4` 语义岗 = 迷雾记忆墨（§6.5）、② 的 `#B07A14` 属金族（§4.2 金只说收益与兑现）——两者均作角色随身件材质色用，不进信息层与语义物件岗；③④⑤ 无语义岗冲突。验收：机检〈五处部件取值点全部改指合并目标色，四枚原拟新增候选值零入板〉
 - **换色合并登记三处**｜按本表「不过门即触发换色合并、禁加色绕行」执行，三处零新增额度：①地台顶缘受光线 `#C4AC84` 已并入 `#C9AF83`（掩尘枚 `BRICK`，与 §8.2 高墙口沿高光同枚）——源常量已删除（全仓零引用，退役断言测试串为预期例外），绘制点全部改指 `#C9AF83`；②地台描边 `#5A4C3A` 已并入 `#4C4038`（代码 `PLAZA_EDGE`，ui_kit 唯一落点）——源常量已删除，绘制点全部改指；③舞台底 `#3E342A`（代码 `STAGE_BG`）→ 并入 `#3E362C`（状态槽底）——源常量已删除（常量表零键），背景资产接管该绘制面，程序化平色缺图回退改指 `SLOT_BACKDROP`（`#3E362C`）。程序化回退绘制与已落合并值的贴图保持一致。验收：机检〈①②两枚源常量全仓零引用，绘制点全部改指合并目标色〉
 
-**对比硬指标（可测）**：数字可读性由**格底明度分档**承载——棋盘数字亮墨 **L≥0.75** 对**已开格底 L 0.08–0.14** ⇒ 直画对比 **≥4.5:1 恒成立**（WCAG AA，样张逐组合抽测冻结）；**色牌后备**：色牌素色恒定 **L≥0.70**、牌上数字深墨 **L≤0.027** ⇒ 任意牌墨组合 ≥4.5:1（实测样例：#33261B/#F5EAD3 = 12.3:1）。未开格底槽（含全部图类型）相对亮度 **L≥0.30**（墙顶面受光档）、HSV 饱和 **≤0.55**、避 Boss 禁入色相带；已开格底走世界底层档（见上）。物件识别不依赖格底（§5.1 轮廓通道），封印印记、金色不作识别依赖。验收：机检〈亮墨对已开格底 ≥4.5:1；未开格底 L≥0.30、饱和 ≤0.55；任意牌墨组合 ≥4.5:1〉 ←原二；地形变异 AC-9
+**对比硬指标（可测）**：数字可读性由**格底明度分档**承载——棋盘数字亮墨 **L≥0.75** 对**已开格底 L 0.08–0.14** ⇒ 直画对比 **≥4.5:1 恒成立**（WCAG AA，样张逐组合抽测冻结）；**色牌后备**：色牌素色恒定 **L≥0.70**、牌上数字深墨 **L≤0.027** ⇒ 任意牌墨组合 ≥4.5:1（实测样例：#33261B/#F5EAD3 = 12.3:1）。未开格底槽（含全部图类型）与类型微光、已开格底之间存在**相对亮度与相对饱和关系**——禁止底槽吞没微光环、禁止底槽与已开格底同档；本节只定这层关系，阈值与准入判定由图类型色板互辨抽测的执行件承载（用法登记见 [art-pipeline-tools](art-pipeline-tools.md)）。已开格底走世界底层档（见上）。物件识别不依赖格底（§5.1 轮廓通道），封印印记、金色不作识别依赖。验收：机检〈亮墨对已开格底 ≥4.5:1；未开格底对微光环与对已开格底的相对亮度关系经互辨抽测准入；任意牌墨组合 ≥4.5:1〉 ←原二；地形变异 AC-9
 
 **色板增量纪律（数值状态 = 待定现用）**：全作色板硬上限 **48 色**（防色板无限膨胀的封口条款；**额度已用尽、余量 0**，后续余量以色板检查器实报为准）；新色入板须同时过两道门：①§4.2 语义检查（不占语义色段/禁入带）；②**与既有任一色的 RGB 三通道差禁止全部 <8/255**——即三通道里至少一通道 ≥8/255 即过门，「三通道差全部 <8」才算不过门（条文原写的「三通道差 ≥8/255」有「逐通道全过」与「禁止全灭」两种互斥读法，前者下现行色板 247 对不达标、与本节自认的「现行即执法」合规状态不能同真，故取后者；用户裁）。**额度已用尽：后续任何新增须先压缩或合并既有色**——按本节「额度不足时呈报作者」口径呈报，**压缩或合并哪几枚由作者裁，本节不代裁、不预指对象**。反例实证：#3A2E22 ↔ #362B20 三通道差均 <5，肉眼不可辨，同板共存只增噪。不过门即触发「换色合并」（把意图色并进最近既有色），**禁加色绕行**；加色义务同时登记于本表修订。**「待定现用」态释义**：数值**现行即执法**（色板检查器按此拦，§8.3）——非候选（不存在"等冻结"空窗）、非死规（后续需求引入时可变）；调整走本节修订并登记，改值 = 修订不是违约。验收：机检〈色板总数 ≤48；新色入板过两道门〉
 
@@ -393,7 +393,7 @@
 - **场景构成**：一张可点击的营地场景图（1280×800，与工程档同幅面）。远景=天空与远山；中景=**独立成层的木围墙**（密排竖木桩、桩顶削尖、不透缝无横木）与**半开的营地大门**；近景=中央篝火、左侧锻炉铁砧、右侧帐篷与宝箱、帐篷旁的笔记本，另有木桩与挂在围墙上的布告板。**中景带自底部往上约 2/3 处起**；**近景物件可覆盖围墙，唯一例外=中间门洞必须留空、不被任何物件遮挡**。七个可点物件的功能绑定归 `camp.md`，本节只定画法。
 - **图层拆分（10 张）**：场景按「远景／中景／近景要素各自成层」拆——`scene_camp_bg` 背景层（z0，不透明全幅）=天空＋远山＋整片地面＋门洞内一条通向远处的小路；`scene_camp_wall` 围墙层（z1，透明底）=横贯全宽密排木桩墙（左右两段）＋两根略高的门柱，**门洞处留透明缺口**透出背景层的小路；`scene_camp_board` 布告板（z2）、`scene_camp_gate` 门扇（z3）、`scene_camp_dummy` 木桩／`scene_camp_forge` 锻炉／`scene_camp_tent` 帐篷（z4）、`scene_camp_chest` 宝箱／`scene_camp_notebook` 笔记本（z5）、`scene_camp_campfire` 篝火（z6，最前）=八个物件层，各透明底单件一张。**帐篷**为承载件、不可点。围墙独立成层的好处：桩高可单独锁死、门洞做透明缺口、背景层不混入暖木色。提示词与坐标 = `camp-scene-prompts.md`，消费常量 = `asset-path-map`。
 - **交付形态**：**背景层 1 张（不透明全幅）＋ 围墙层 1 张 ＋ 八个物件层 = 10 张**，其中 9 张透明底、1 张不透明全幅 + 一份坐标表（贴图矩形/命中矩形/z 序）。背景层由**远景片 `bg_far`（2560×734）与地面片 `bg_floor`（2560×866）两片出图、按 y734 拼成一张**——整张一次出图时模型把远山挤到画面下半部，被围墙挡住后完全消失（实测三张里两张山体上缘落在墙顶以下）。接缝整条落在围墙背后，画面无接缝。**篝火例外**：命中矩形只取下半（火堆），上半（火焰）只作特效展示。围墙层落盘按细条裁，不做全幅（全幅约 3.9 MB 显存，细条约 0.35 MB）；**实装落盘矩形 `(0, 203, 1280, 164)`、底锚 y367**（桩身 150px、门柱 164px 终稿锁定值，落带内〔围墙带 (0,203,1280,164)〕）。
-- **色彩与氛围依据**：营地场景的冷暖分工（冷的大面积后退、暖的小面积前进）、空气透视三档与大面积用色规则 = `reports/提案-营地色彩与氛围脚本-2026-10-23.md`。本节不复述色值；新增环境色按 §4.1 场景环境子板条款登记（每屏一套、≤32 色、过 §4.2 语义检查与 RGB 三通道差 ≥8/255 两道门）。
+- **色彩与氛围依据**：营地整体偏暖、安全温馨，与冒险中的地下城形成对比；现行口径 = 本文件 §2.8「全作最暖」与本节「情绪与色域」条，远景淡而退后、近景暖调为主。本节不复述色值；新增环境色按 §4.1 场景环境子板条款登记（每屏一套、≤32 色、过 §4.2 语义检查与 RGB 三通道差 ≥8/255 两道门）。
 - **交互四态（零新素材，全部程序化）**：悬停=**轮廓亮边 + 浮动**（浮动须整像素吸附）；按下=位移 1px；**禁用/未解锁=降明度 + 去饱和**（§2 已缩窄至情绪域，状态表达不受限），**仅锻炉（锻造工坊）与宝箱（秘宝匣）两件会有此态**；已解锁=常态。
 - **钥石余额**：常驻画面顶部的一行小 HUD 栏（高 48px，**浮层覆盖，不挤压画面**）。
 - **事实源边界**：解锁条件/价格/存档写入归元进度 GDD 与 `MetaProgression`；素材命名与路径归 `asset-path-map`；清单登记归 `art-assets-checklist` §3.5。
@@ -401,7 +401,7 @@
 
 ### 6.3 三关图类型色板候选（board_type 换挡方向）
 
-- **模板与不变槽**：换皮只换 §4.3 四槽(`tile_closed`/`tile_open`/`wall_ambient`/`variant_tint`)，信息与语义层全图类型恒定——本节只给三关**方向性候选**，终值按 §4.3 现行规则重跑 §1.4 格子样张冻结。**终值的取值程序**：先跑「三关色相 × 五组类型微光」互辨抽测（抽测任务登记在待办清单），再按 §4.3 现行规则重跑 §1.4 格子样张冻结——本节不填终值色值，待该抽测与格子样张重跑后落本节修订。验收：机检〈本节三关行无 `tile_closed`/`wall_ambient` 终值色值字面量（终值未冻结前禁填）〉
+- **模板与不变槽**：换皮只换 §4.3 四槽(`tile_closed`/`tile_open`/`wall_ambient`/`variant_tint`)，信息与语义层全图类型恒定——本节的三关两槽终值**已冻结**。**冻结口径（本节不抄色值字面量）**：各关 `tile_closed` 终值＝该关在役墙瓦片三块底型件（素砖／裂纹／碎石斑）顶面受光档的实测最亮值，`wall_ambient` 取同关同槽值（两槽同值；同属 §4.1 分层②场景环境子板，零新增色值、不占 48 额度）；实测值与准入判定只在执行件里算，执行件用法登记见 [art-pipeline-tools](art-pipeline-tools.md)。**冻结凭据**＝「三关色相 × 五组类型微光」互辨抽测闭合（机检 17 项 0 红＋目检四条全过；抽测样图与 2026-11-05 出图件同哈希，目检面未重跑）＋ §1.4 格子样张重跑机检 30/31 绿（唯一红灯＝改前/改后对拍一件，因在途素材区无改前基线件、属素材区环境坑不属色板回归，沿革查 git 提交史）——砖面形态与色板维持冻结。验收：机检〈三关行两槽终值与互辨抽测执行件的实测读数同值（该件三行铺底代表值判定全过），且本节三关行不含色值字面量〉
 - **三关背景变体**：§6.1 的三张背景取本节三关方向作为岩体形态、剪影语言与色族差异（dungeon 暖石棕＋地精巢穴支洞/木栈道/木桩围栏；underdark 冷蓝灰＋卓尔巨柱/石笋/蛛网/螺旋塔剪影/巨菇/石桥；deep_underdark 灰黑＋灰矮人石笋城郭/棱角石厅/矿道口/烟囱塔）；背景不复用 `wall_ambient` tint（该槽作用于棋盘/世界），背景色值归战斗屏场景环境子板。验收：目检〈三关背景可辨为不同洞窟，非同一图换色〉
 - **深度轴叙事**（§2.7 下探过渡）：色相层进预告「更深更险」，明度档不动——
   - **dungeon 地精洞窟**（第一关）：现行掩尘系暖石棕（`#C9AF83` 基）即基准档，`wall_ambient` 暖棕；

design/art/art-pipeline-tools.md

@@ -15,6 +15,7 @@
 | UI 框材（面板、按钮、石框、底噪、图标） | `tools/quantize_ui_skin.py` | `tools/palette_check.py`、`tools/path_check.py` | 主题小件另跑 `tools/gen_theme_icons.py` |
 | 地形瓦片 | `tools/recolor_terrain_tiles.py` | `tools/palette_check.py` | 只换色，不重绘 |
 | 整屏样张 | `tools/render_sample_sheet_v3.py`、`tools/render_level_map_sheet.py` | `tools/shot_checker.py`；棋盘回归用 `tools/golden_board_crop.py` 加 `tools/golden_compare.py` | 样张脚本生成后自带机检 |
+| 图类型色板互辨抽测（三关格底 × 五组微光） | `tools/glow_discrimination_sheet.py` | `tools/palette_check.py`（近色比对池同源）、`tools/shot_checker.py`（WCAG 公式同源） | 出并列样图＋逐对读数表；格底准入的门值单点在本件 |
 
 ## 三条已知边界
 
@@ -291,3 +292,22 @@ python tools/path_check.py --repo . --code game
 **判据或口径**：L1 查 `asset-path-map` §1 的声明目录，`design/art/candidates` 按需创建豁免。L2 查 `game/assets/art` 的四个语义子目录与现役文件清单，含主角 idle／walk／portrait、八敌、铲三帧、封印印记。L3 grep 代码里的 `res://assets/art` 引用，核对盘上存在性，并检出 `board_floor`、`board_wall`、`pillar_dungeon`、`production/mockups` 等退役命名；路径模板含 `%s` 或 `%d` 的跳过。worktree 素材未同步时，缺失项标 SKIP 不判红；主区完整素材环境才全量判。全过 0，有红灯 1。
 
 **已知坑与适用边界**：依赖 `asset-path-map.md` 的声明清单与代码常量；新增素材目录不更新文档就不会被查。素材不入 git，worktree 空或半同步会大量 SKIP，不能据此判断主区健康。只核对路径存在与退役命名，不核对图像内容、尺寸或色板。
+
+## tools/glow_discrimination_sheet.py
+
+**一句话定位**：三关图类型色板 × 五组类型微光的互辨抽测执行件——出一张并列样图（54 格＝三关 × 三底型 × 五组 ＋ 基准格，含灰度副本段与图例），自带机检判定并落逐对读数表。
+
+**归属**：仓库内 `tools/glow_discrimination_sheet.py`。
+
+**输入与输出**：读 `game/assets/art/board/terrain_wall_center*_ <board_type>.png` 三块底型件、`game/presentation/views/ui_kit.gd` 的微光冻结常量、`game/tests/golden/palette_baseline/` 两张条带作近色比对池；合成侧逐像素复刻 `game/presentation/views/cell_type_glow.gdshader`。产物＝`artwork/mockups/glow-discrimination-sheet-<日期>.png`（不入 git）＋ `reports/` 下当日读数表。
+
+**用法命令**：
+
+```bash
+python tools/glow_discrimination_sheet.py              # 取准入读数 + 出样图 + 机检全道 + 落读数表
+python tools/glow_discrimination_sheet.py --no-sheet   # 只跑铺底准入五门，不出图不落表
+```
+
+**判据或口径**：门值单点在本件常量，文档侧不抄——`FLOOR_L`（未开格底线性亮度地板）、`CEIL_SAT`（饱和上限）、`BANNED_HUE`（禁入色相带）、`NEAR_EPS`（近色容差）、`B_MIN_CH_DIFF`（格底对微光可辨底线）、`C_MODEL_TOL`（样图与合成模型容差）。铺底代表值不查色表：取该关三块底型件像素里**线性相对亮度最大**的实测色（顶面受光档），素材换色后读数自动跟随。判定四道＝A 五组明度阶梯单调且组间对比过线、B 格底对微光的三通道差禁止全部小于容差、C 样图与合成模型差落在容差内、D 准入五门；目检四条归用户，与机器判定并列取严（任一侧不过即该对不过）。退出码 0＝全绿、1＝有 FAIL、2＝底型件缺位硬阻塞。
+
+**已知坑与适用边界**：素材不入 git，worktree 缺三块底型件时直接 `exit(2)`——抽测的先决条件不成立，不是假红。色相吞没刻意不设机检阈值：本仓无一条文给出色相差门槛，自造一个等于把观感问题伪装成可机检问题，故色相差只进读数表列、不参与判定。带域与格心取样口径与 `game/probe/type_glow_shot_probe.gd` 同源（带域 de＜格边×0.125、格心内缩 20%），改探针口径须同步本件。

design/art/camp-scene-prompts.md

@@ -1,7 +1,7 @@
 # 营地场景 · 分层生图提示词卡 v1.5
 
 > **性质**：营地场景图（1280×800，一张可点击场景图 ＋ 十张分层：背景层 1 ＋ 围墙层 1 ＋ 八个物件层）的出图执行侧文件。**场景级资产，与角色级 [art-prompts](art-prompts.md) 并列，两文件互不覆盖**。
-> **依据**：色彩与氛围 = `reports/提案-营地色彩与氛围脚本-2026-10-23.md`（本卡不复述色值）；坐标与层序 = 本卡 §2.3（运行期单一事实源 = `game/data/tables/camp_scene_layout.tres`）；物件命名与消费链 = [asset-path-map](asset-path-map.md)；画法与交付形态 = [art-bible](art-bible.md) §6.2。冲突时色彩以色彩脚本为准，画法以 art-bible 为准。
+> **依据**：色彩与氛围 = [art-bible](art-bible.md) §2.8 与 §6.2（营地整体偏暖、安全温馨，与冒险中的地下城形成对比；本卡不复述色值）；坐标与层序 = 本卡 §2.3（运行期单一事实源 = `game/data/tables/camp_scene_layout.tres`）；物件命名与消费链 = [asset-path-map](asset-path-map.md)；画法与交付形态 = [art-bible](art-bible.md) §6.2。画法与用色冲突时以 art-bible 为准。
 > **边界**：只管营地场景图的分层出图。角色、图标、格面走 art-prompts.md 与脚本管线，不需要提示词。
 > **建立**：2026-10-25 · 状态：十条提示词成文（背景层 1 ＋ 围墙层 1 ＋ 八个物件层）；2026-11-05 按地平线 y367 重排，背景层与围墙层待按 §4 新判据重出，门扇随门洞压扁重画
 
@@ -39,7 +39,7 @@ Style reference: the attached images are this game's own finished pixel art and
 
 ## 2. 背景层与围墙层（两张，不可点）
 
-围墙从背景层拆出、独立成层：围墙层可单独锁死桩高、门洞做成透明缺口透出背景层的小路；背景层不混入暖木色、更易守住冷色占比判据（判据见 §4）。两层都不可点；按乙工序门**先只出背景层 1 张**供作者确认风格前缀，确认后才扩产围墙层与八个物件层。
+围墙从背景层拆出、独立成层：围墙层可单独锁死桩高、门洞做成透明缺口透出背景层的小路；背景层只画天、山、草地与地面，不画任何物件，远景保持淡而退后，让近景的暖调成为画面主角。两层都不可点；按乙工序门**先只出背景层 1 张**供作者确认风格前缀，确认后才扩产围墙层与八个物件层。
 
 ### 2.1 背景层（`scene_camp_bg`，不可点，不透明全幅）
 
@@ -64,18 +64,18 @@ Style reference: the attached images are this game's own finished pixel art and
 **不画什么**：围墙、门柱、门扇、物件、角色、营地内地面（那是 §2.1.2）；山与草地之间禁出现平直硬边
 
 ```
-Pixel art style. True pixel art game background, chunky square pixels, strict pixel grid, hard edges, no anti-aliasing, flat colors, limited palette about 20 colors, retro 16-bit look, Aseprite style, flat side view, orthographic, ULTRA WIDE horizontal composition, aspect ratio 3.5 to 1. This is the far view seen from inside a small adventurer camp, looking out. It contains ONLY three bands stacked top to bottom, plus one path. BAND 1 — SKY, from the top edge down to 14 percent of the frame height: pale cool off-white with a faint blue-grey tint, flat and empty, at most one or two extremely simple flat clouds, no sun. BAND 2 — DISTANT HILLS, from 14 percent down to 55 percent of the frame height: two or three overlapping layers of rolling hills in pale cool blue-grey-green, each farther layer lighter, cooler and lower in contrast. THE HILLS MUST FILL THIS ENTIRE BAND — the highest ridgeline reaches up to 14 to 20 percent of the frame height and the hill mass continues down to 55 percent; a low ridge hugging the bottom of the frame is WRONG. Silhouette edges are stepped in pixel blocks, no outline, no rim light. BAND 3 — MEADOW, from 55 percent down to the bottom edge: cool pale grey-green grass, flat and low contrast, marked only by a few simple flat grass tufts, no trees, no bushes. PATH — one dirt path in the meadow only: it starts at the bottom edge of the frame in the middle, about one fifth of the frame width there, runs straight up and narrows until it meets the hill foot at 55 percent, where it disappears; it must not go above the hill foot and must not reach the sky. COLOR: everything cool, pale, desaturated, low contrast, no warm, golden, amber or yellow anywhere. DO NOT ADD: any palisade wall, fence, gate, gate posts, tent, campfire, crate, barrel, prop, character, animal; any hard straight horizontal seam between sky, hills and meadow — the hill foot dissolves into the meadow through stepped intermediate tones; any outline or rim; trees, forests or dense vegetation; antialiasing, gradients, dithering, painterly strokes, 3D, realistic shading, glossy light, bloom, vignette, dark corners, night, sunset, sun; any text, letters, number, watermark, signature, logo, frame, border, UI element, icon, badge.
+Pixel art style. True pixel art game background, chunky square pixels, strict pixel grid, hard edges, no anti-aliasing, flat colors, limited palette about 20 colors, retro 16-bit look, Aseprite style, flat side view, orthographic, ULTRA WIDE horizontal composition, aspect ratio 3.5 to 1. This is the far view seen from inside a small adventurer camp, looking out. It contains ONLY three bands stacked top to bottom, plus one path. BAND 1 — SKY, from the top edge down to 14 percent of the frame height: pale warm off-white with a faint cream tint, flat and empty, at most one or two extremely simple flat clouds, no sun. BAND 2 — DISTANT HILLS, from 14 percent down to 55 percent of the frame height: two or three overlapping layers of rolling hills in pale warm grey-green, each farther layer lighter and lower in contrast. THE HILLS MUST FILL THIS ENTIRE BAND — the highest ridgeline reaches up to 14 to 20 percent of the frame height and the hill mass continues down to 55 percent; a low ridge hugging the bottom of the frame is WRONG. Silhouette edges are stepped in pixel blocks, no outline, no rim light. BAND 3 — MEADOW, from 55 percent down to the bottom edge: soft pale grey-green grass, flat and low contrast, marked only by a few simple flat grass tufts, no trees, no bushes. PATH — one dirt path in the meadow only: it starts at the bottom edge of the frame in the middle, about one fifth of the frame width there, runs straight up and narrows until it meets the hill foot at 55 percent, where it disappears; it must not go above the hill foot and must not reach the sky. COLOR: an overall warm, sunlit daytime palette — pale cream sky, warm grey-green hills, soft grey-green meadow; gentle warmth throughout, low contrast, no harsh saturation, no sunset or golden-hour cast. LIGHT: bright, dry, clear daylight from above, so the far view reads as a safe open camp in daytime. DO NOT ADD: any palisade wall, fence, gate, gate posts, tent, campfire, crate, barrel, prop, character, animal; any hard straight horizontal seam between sky, hills and meadow — the hill foot dissolves into the meadow through stepped intermediate tones; any outline or rim; trees, forests or dense vegetation; antialiasing, gradients, dithering, painterly strokes, 3D, realistic shading, glossy light, bloom, vignette, night, sunset, a visible sun disc; any text, letters, number, watermark, signature, logo, frame, border, UI element, icon, badge.
 ```
 
 #### 2.1.2 地面片（`bg_floor`）
 
 **画布比例**：3:1 超宽
-**内容**：营地内的踩实裸土，铺满整幅
-**硬指标**：**中线与左右两侧同色——没有任何路、小径、车辙**；明度 30%–45%；色相与远景片草地明显区分
+**内容**：营地内被太阳晒着的踩实黄土地，铺满整幅
+**硬指标**：**中线与左右两侧同色——没有任何路、小径、车辙**；明度读到晴天下被晒亮的干土，不暗、不闷；色相与远景片草地明显区分
 **不画什么**：草、植被、大石块、物件、天空、地平线、围墙、接缝线
 
 ```
-Pixel art style. True pixel art game ground texture, chunky square pixels, strict pixel grid, hard edges, no anti-aliasing, flat colors, limited palette about 12 colors, retro 16-bit look, Aseprite style, ULTRA WIDE horizontal composition, aspect ratio 3 to 1. This is the trodden floor INSIDE a small adventurer camp — bare packed dry earth filling the whole frame edge to edge, seen at a shallow angle from slightly above. MATERIAL: desaturated warm grey-brown, medium value, roughly 30 to 45 percent luminance, never dark, never muddy. TEXTURE: deliberate pixel clusters only — short paired scuff marks that read as dragged footprints, small scattered pebbles, beaten patches where feet have worn the ground smooth, occasional faint drag marks; density rises slightly toward the bottom edge and the middle stays calm and open. CRITICAL, NO PATH: there is no road, no trail, no track, no wheel rut and no worn strip anywhere in this image — the middle of the frame must look the same as the left and right edges, nothing leads anywhere. DO NOT ADD: grass, vegetation, plants, flowers, moss, lichen; rocks larger than a pebble; crates, sticks, bones, debris piles, tools; water, puddles; shadows of objects; sky, horizon, hills, wall, fence, gate, building; any line, seam, border or edge inside the frame; antialiasing, gradients, dithering, painterly strokes, 3D, realistic shading, glossy light, bloom, vignette, dark corners, warm golden cast; any text, letters, number, watermark, signature, logo, frame, border, UI element, icon, badge.
+Pixel art style. True pixel art game ground texture, chunky square pixels, strict pixel grid, hard edges, no anti-aliasing, flat colors, limited palette about 12 colors, retro 16-bit look, Aseprite style, ULTRA WIDE horizontal composition, aspect ratio 3 to 1. This is the trodden floor INSIDE a small adventurer camp — bare packed dry earth filling the whole frame edge to edge, seen at a shallow angle from slightly above. MATERIAL: dry sunlit yellow earth (trodden loess), a warm ochre-tan packed soil, medium-to-bright value, dry and never muddy or grey. LIGHT: bright, dry, clear daylight from above, with broad soft sunlit patches and gentle tonal variation across the ground. TEXTURE: deliberate pixel clusters only — short paired scuff marks that read as dragged footprints, small scattered pebbles, beaten patches where feet have worn the ground smooth, occasional faint drag marks; density rises slightly toward the bottom edge and the middle stays calm and open. CRITICAL, NO PATH: there is no road, no trail, no track, no wheel rut and no worn strip anywhere in this image — the middle of the frame must look the same as the left and right edges, nothing leads anywhere. DO NOT ADD: grass, vegetation, plants, flowers, moss, lichen; rocks larger than a pebble; crates, sticks, bones, debris piles, tools; water, puddles; shadows of objects; sky, horizon, hills, wall, fence, gate, building; any line, seam, border or edge inside the frame; antialiasing, gradients, dithering, painterly strokes, 3D, realistic shading, glossy light, bloom, vignette; any text, letters, number, watermark, signature, logo, frame, border, UI element, icon, badge.
 ```
 
 #### 2.1.3 拼接与后处理
@@ -193,8 +193,8 @@ A campfire made of a ring of grey stones around crossed stacked logs with a warm
 ## 4. 验收（机检 + 目检）
 
 **远景片 `bg_far`**
-- 黄度 =(R+G)/2−B 分区取样：天空 ≤20、远山 ≤20、草地 ≤35
-- 冷色像素占比 ≥55%；禁出现任何暖色高饱和像素
+- 整体读作晴天暖调、安全温馨，与冒险中的地下城形成对比；色温与色值判据按 §5 第 11 条随环境子板登记回填
+- 整体暖调但保持中等饱和、低对比；远景淡而退后、近景暖调为主，高饱和只留给火焰，禁出现整屏高饱和偏色
 - 机检：**山体上缘 ≤ 画面高度 15%**（这是硬指标——山体上缘落得越低，被围墙挡住后越是什么都看不见）
 - 机检：**山体占画面高度 ≥40%**（山体上缘到山脚）
 - 机检：草地上限 ≤ 画面高度 55%
@@ -204,10 +204,10 @@ A campfire made of a ring of grey stones around crossed stacked logs with a warm
 - 目检：无围墙、门柱、门扇、物件、角色
 
 **地面片 `bg_floor`**
-- 明度 **L 0.30–0.45**（相对亮度）；整片低于 0.30 即判红（旧稿偏暗、观感发闷）
+- 明度读到晴天下被晒亮的干土，不暗、不闷；硬阈值随环境子板登记回填（§5 第 11 条）
 - 机检：画面中线 200px 带与左右各 250px 带的平均色差 ≤6/255（**营地内无路带**）
 - 机检：与远景片草地的平均色 (R−B) 差 ≥10/255（两种材质色相可辨）
-- 目检：禁出现草、植被、大石块、物件、水面；细节读作拖拽脚印／碎石／踩踏斑块，不是满屏噪点
+- 目检：能读出晴天下被晒过的干土与柔和日晒斑块；禁出现草、植被、大石块、物件、水面；细节读作拖拽脚印／碎石／踩踏斑块，不是满屏噪点
 
 **整图（两片拼接后）**
 - 接缝 y367 落在围墙 203–367 背后，**画面里看不见接缝**
@@ -239,7 +239,7 @@ A campfire made of a ring of grey stones around crossed stacked logs with a warm
 4. **帐篷**：251×170 沿用现终稿，落位 (982, 335)，遮住墙下部 32px（覆盖围墙可接受）
 5. **笔记本**：随帐篷跟随，落在帐篷左下方外侧、两者不重叠——`x = 帐篷 x − 112`、`y = 帐篷底 + 10`
 6. **宝箱离底**：贴图底 y744，距画面底 56px；其余物件同步上移 46px
-7. **地面分两区**：营地外（y734 以上）＝冷调灰绿草地＋一条向远山收窄的土路；营地内（y734 至画面底）＝踩实裸土、与草地异色相、无草无路无车辙；两区分界被围墙层完全遮住
+7. **地面分两区**：营地外（y734 以上）＝灰绿草地＋一条向远山收窄的土路；营地内（y734 至画面底）＝被太阳晒着的踩实黄土地、与草地异色相、无草无路无车辙；两区分界被围墙层完全遮住
 8. **背景层分两片出图**：远景片 `bg_far`（2560×734，天空 14%／远山 41%／草地 45%＋小路）＋ 地面片 `bg_floor`（2560×866 踩实裸土），后处理按 y734 拼成一张 2560×1600；接缝落在围墙 406–734 背后。分片理由＝整张出图时模型把山挤到画面下半部，实测三张里两张山体整段被围墙遮没
 9. **布告板位置**：(845, 224, 130, 140)，底 345 落在墙内，不再悬空
 10. **描边颜色**：奶油色追认——去底脚本「奶油描边膨胀 3px 当屏障」的技术前提随现值锁定（§1 注记同源）；改深灰褐须换去底方案全量重出，不裁

design/engineering/process-conventions.md

@@ -10,9 +10,9 @@
 主工作区（master 检出）只作合并落点，一切开发/设计改动禁止直接发生在主工作区（2026-10-31 用户裁恢复；验证模型＝批内按 §4 改完即测、合回后远端 CI 是唯一强制全量验证点，细则见本节第 3 条）：
 
 1. **worktree 车道（一切面）**：每回合先建独立 worktree（建区粒度＝回合，会话单区细则见第 5 条）：`git worktree add ../g-plan2-<任务名> -b <任务分支>`；建区后立刻跑 `tools/setup_worktree_userdir.sh`——给该区独立 Godot user 目录（测试夹具、试玩日志、截图产物不与其他区共用；主区不生成，真实档保持原位）。所有改动与提交都在 worktree 内自由进行——commit 点零钩子检查（`tools/hooks/pre-commit` 已删除）。豁免面仅 `.zcode/`（钩子与配置）与 `.qoder/`（本机 harness 配置）允许主工作区直改——两份实测均不入 git（走 worktree 反而带不进去，改动只对本机生效）
-2. **收口顺序（固定）**：**冻结 → 件核 → 并 master → 重塑 → 主区合回 → 删区**——代码与断言改完即冻结，全仓件核 grep 查残留；master 已被别的批次推进时先在 worktree 内 `git merge master` 解冲突（必须在合回之前，合回后才并＝CI 验的是中间态）；**重塑**＝迭代分支（iter<N> 形）合回前执行 `python tools/reshape_cards.py`，把分支线性史按卡末态快照压成一卡一笔（可选追加一笔纯文档收尾），master 台账由此每卡一行——工具自带「重塑前后树逐字节一致」断言与 backup 分支，不改任何文件内容；非迭代批免重塑；然后主工作区 `git merge --no-ff <任务分支>`——这是主区唯一合法写动作（合回守卫对迭代分支数卡校验，未归卡提交拦下）。**合回落地即 `git worktree remove`＋删分支（合回即删，2026-09-19 原裁）；post-merge 钩子已在合回落地时自动触发 CI，红态不回滚合并——新开修复 worktree（`fix-<任务名>` 分支，非 iter<N> 形免重塑免数卡）修复提交再合，落地复验追绿后删修复区**。批内的验证义务按 §4 改完即测铁规履行——改完即测自己改过的那部分，不请示、不等点名；收口顺序本身不设跑批关口。**卡片复核前置判据（2026-11-05 用户裁）**：需求卡片的 grilling 复核先于卡片提交、卡片提交先于合回——复核未跑完、缺陷清单未裁完，禁把卡片落 commit（落了也不算成立），`master` 永不落未成立卡；本条与 §2 段三出口铁律、doc-conventions §12.1「已写卡」凭据同判。
+2. **收口顺序（固定）**：**冻结 → 件核 → 并 master → 重塑 → 主区合回 → 删区**——代码与断言改完即冻结，全仓件核 grep 查残留；master 已被别的批次推进时先在 worktree 内 `git merge master` 解冲突（必须在合回之前，合回后才并＝CI 验的是中间态）；**重塑**＝迭代分支（iter<N> 形）合回前执行 `python tools/reshape_cards.py`，把分支线性史按卡末态快照压成一卡一笔（可选追加一笔纯文档收尾），master 台账由此每卡一行——工具自带「重塑前后树逐字节一致」断言与 backup 分支，不改任何文件内容；非迭代批免重塑；然后主工作区 `git merge --no-ff <任务分支>`（pre-merge-commit 钩子先跑前置检查——冒烟＋单元与集成全套件约 2 分钟，红则停合并提交，细则见第 4 条 ③）——这是主区唯一合法写动作（合回守卫对迭代分支数卡校验，未归卡提交拦下）。**合回落地即 `git worktree remove`＋删分支（合回即删，2026-09-19 原裁）；post-merge 钩子已在合回落地时自动触发 CI，红态不回滚合并——新开修复 worktree（`fix-<任务名>` 分支，非 iter<N> 形免重塑免数卡）修复提交再合，落地复验追绿后删修复区**。批内的验证义务按 §4 改完即测铁规履行——改完即测自己改过的那部分，不请示、不等点名；收口顺序本身不设跑批关口。**卡片复核前置判据（2026-11-05 用户裁）**：需求卡片的 grilling 复核先于卡片提交、卡片提交先于合回——复核未跑完、缺陷清单未裁完，禁把卡片落 commit（落了也不算成立），`master` 永不落未成立卡；本条与 §2 段三出口铁律、doc-conventions §12.1「已写卡」凭据同判。
 3. **合回后验证（远端 CI，2026-11-03 用户裁）**：git merge 合回 master 落地后 post-merge 钩子（`tools/hooks/post-merge`）自动 `git push origin master` 触发远端 CI（Gitea Actions，runner＝Mac 本机 host 模式），工作流按改动域分流（分流算法单点＝`tools/ci/domain_route.sh`：游戏码批＝两域全量含渲染闸，文档批＝文档域秒级闸，纯闸件/管线批＝零触发）——唯一强制全量验证点。远端结果用 `tools/ci_check.sh <合并提交>` 按需现查（读该提交任务的 run 自身 `status`/`conclusion`，只呈报、不落盘），agent 开工先读 CI 状态的纪律不变，红未修不开新批。**绿须坐实**：零触发批的 run 照样建、照样 conclusion=success，但跑闸步是 `skipped`（run 55 实证）——一条闸都没跑不构成验证，现查件对此呈报「未验」（退出码 4），禁当绿证用；job 列表为空、取不到步级读数或工作流里没有跑闸步时呈报「不可判」，同样禁当绿证。CI 红态不回滚合并——修复走新开修复 worktree（`fix-<任务名>` 分支，非 iter<N> 形免重塑免数卡），修复合回落地即再推再验追绿（追绿同链）。导入缓存刷新（.godot 不入 git 的在册坑）由工作流「导入缓存刷新」步接管。**合回零等待纪律（2026-11-04 用户裁，取代 2026-11-02 回执等待纪律）**：合回落地即向用户呈报本批总结并止回合——不挂后台轮询、不等回执、不被唤醒；CI 结论什么时候要看就现查一次（`tools/ci_check.sh`，run 那时早已落定，秒级）。退役缘由＝原轮询件把「commit status 离开 pending」当终局判据，会把 run 未落定期的尝试级失败写成终局红（run 37 实证：开跑 36 秒写红，该 run 三分半后 `conclusion=success`），且零触发批与 runner 排队必熬满超时再写红；同 commit 的多路轮询还重复覆写同一份判定。跑闸等一切分钟级跑批的等待纪律不变——后台运行，禁前台 sleep／轮询循环。
-4. **执法分层（全机械，零自觉依赖）**：①`.zcode/hooks/worktree-guard.sh`（PreToolUse，本机件不入 git）——agent 侧：主工作区 Edit/Write 与主区非 merge `git commit` 拦截（豁免 `.zcode/`、`.qoder/`；worktree 内目标快速放行；合并收尾提交凭 MERGE_HEAD 豁免）、`git commit --no-verify` 拦截（该旗标仅属用户）、iter<N> 分支合回的一卡一提交数卡校验、规则闸（写 design/／game/ 前核对会话规约读取记录）。②post-merge 钩子——远端 CI 触发（只推送，不挂等待；仅主工作区，任务 worktree 内的合并不触发）。③git 层不设车道钩子——用户手工改动不受限；ZCode 层只约束 agent（子代理不经守卫层）
+4. **执法分层（全机械，零自觉依赖）**：①`.zcode/hooks/worktree-guard.sh`（PreToolUse，本机件不入 git）——agent 侧：主工作区 Edit/Write 与主区非 merge `git commit` 拦截（豁免 `.zcode/`、`.qoder/`；worktree 内目标快速放行；合并收尾提交凭 MERGE_HEAD 豁免）、`git commit --no-verify` 拦截（该旗标仅属用户）、iter<N> 分支合回的一卡一提交数卡校验、规则闸（写 design/／game/ 前核对会话规约读取记录）。②post-merge 钩子——远端 CI 触发（只推送，不挂等待；仅主工作区，任务 worktree 内的合并不触发）。③git 层钩子＝合回链两件：pre-merge-commit（合回前置检查，2026-11-06 用户裁：主区 merge 落合并提交前自动跑 `tools/run_all_gates.sh --premerge`＝冒烟＋单元与集成全套件 4 分片，热导入缓存约 2 分钟；exit≠0 拦合并提交不拦合并动作——红态仓库停 MERGE_HEAD 态，修红 git commit 续合或 git merge --abort 放弃；快进合并不触发；--no-verify 可跳过且仅属用户）＋post-merge（远端 CI 触发，只推送，不挂等待）；合回链之外 git 层不设车道钩子——用户手工改动不受限；ZCode 层只约束 agent（子代理不经守卫层）
 5. **会话单区（2026-11-04 用户裁）**：建区粒度＝回合——同一时刻每会话至多一个 worktree 在役；合入删区之前，会话内用户追加的事项一律并入在役区推进，禁为追加事项另开新区。区内全部事项完成后只做一次合入（一次 `git merge --no-ff`、post-merge 一次推送、远端 CI 只跑一次），追加事项在合入提交信息里分列；无改动需求的事项不建区。合回删区后用户再发令的事项＝新回合，另开新区（区名取该回合主任务名）。CI 红的 `fix-<任务名>` 修复区属同一回合的追绿延续，不另算新区。迭代实现批（iter<N> 形分支）独占回合——其他类事项不得并入迭代区（合回守卫数卡校验本就拦未归卡提交），待其合回后按新回合另开。
 
 ## 2. 五段流水线
@@ -49,8 +49,8 @@
 7. **验收改动先行声明**——验收变化（基线换代/探针增改/旧断言改判）预先写进需求卡片，禁事后补
 
 **完成**
-8. **合回后 CI 验证（唯一强制全量验证点）**——主工作区 `git merge --no-ff <任务分支>` 落地后 post-merge 钩子自动推送 origin master 触发远端 CI；远端按改动域分流（§1 第 3 条），全量档兜的是跨卡触面、探针与未申报套件的消费漏网（迭代 44 实证），判定与红项用 `tools/ci_check.sh <合并提交>` 按需现查（读 run 终局态，只呈报不落盘）。合回前独立验收审计通过（iter 技能第 5 步），未过不合回。`tools/run_all_gates.sh` 是全部验证闸的**唯一入口、唯一清单与唯一域划分（含选闸算法与套件族映射表）**，闸件增减、分域调整都只改它；**本文与其他文档禁另列闸件清单**（清单散落多处正是 iter27 漏跑 `probe_gate --full` 的成因）。开发期的验证义务与选档一律见 §4，CI 全量档不替代它。闸件（`tools/` 下机检脚本与闸壳）自身的改动不占 CI 全量——其质量义务＝按 §4 把该件实跑一遍（最小参数全路径含产出落盘）并核对判据口径未变；闸真崩溃时远端 CI 判红在案（job 失败＝verdict 红，fail-closed 语义保留）
-9. **重跑语义（2026-10-30 用户裁）**——同一份字节禁止第二次人手跑；允许的重跑只剩两类：① CI 红后的修复合回（post-merge 钩子再推再验，每轮修复至多触发一轮）；② 用户自发发起的全量回归。「跑都跑了再跑一遍保险」「顺手改点再补一跑」都不构成重跑理由。导入缓存刷新由远端工作流「导入缓存刷新」步接管，合并后无手工动作
+8. **合回后 CI 验证（唯一强制全量验证点）**——主工作区 `git merge --no-ff <任务分支>` 落地后 post-merge 钩子自动推送 origin master 触发远端 CI；远端按改动域分流（§1 第 3 条），全量档兜的是跨卡触面、探针与未申报套件的消费漏网（迭代 44 实证），判定与红项用 `tools/ci_check.sh <合并提交>` 按需现查（读 run 终局态，只呈报不落盘）。合回前独立验收审计通过（iter 技能第 5 步），未过不合回。`tools/run_all_gates.sh` 是全部验证闸的**唯一入口、唯一清单与唯一域划分（含选闸算法与套件族映射表）**，闸件增减、分域调整都只改它；**本文与其他文档禁另列闸件清单**（清单散落多处正是 iter27 漏跑 `probe_gate --full` 的成因）。开发期的验证义务与选档一律见 §4，CI 全量档不替代它。闸件（`tools/` 下机检脚本与闸壳）自身的改动不占 CI 全量——其质量义务＝按 §4 把该件实跑一遍（最小参数全路径含产出落盘）并核对判据口径未变；闸真崩溃时远端 CI 判红在案（job 失败＝verdict 红，fail-closed 语义保留）。合回前的 pre-merge-commit 前置检查（§1 第 4 条 ③）是当场拦截面不是验证台账——不落回执不入基线，不改变本条「唯一强制全量验证点」口径
+9. **重跑语义（2026-10-30 用户裁）**——同一份字节禁止第二次人手跑；允许的重跑只剩三类：① CI 红后的修复合回（post-merge 钩子再推再验，每轮修复至多触发一轮）；② 用户自发发起的全量回归；③ 合回 pre-merge-commit 前置检查（§1 第 4 条 ③——与合回后远端跑批判面不同档〔拦截面 vs 台账〕，不算同一判面的二次人手跑）。「跑都跑了再跑一遍保险」「顺手改点再补一跑」都不构成重跑理由。导入缓存刷新由远端工作流「导入缓存刷新」步接管，合并后无手工动作
 10. **批次完成后的登记义务**——合回 master 后按 doc-conventions §12.1 推进待办清单条目状态（做完整条删除），涉及迭代编排的在 roadmap 迭代总表与顶部「当前位」节换代——执行入口=项目技能 batch-closure（批后收尾与中间文档退役），跨会话教训写记忆库。批次过程与结论由 git 提交信息承载，禁止再写会话状态文件（见 doc-conventions 第 10 节）。`design/` 与根规则文件（`AGENTS.md`/`roadmap.md`/`待办清单.md`/`体验验证清单.md`）实现批禁写，见 §12
 11. **文档同步闸（实现批禁写文档）**——实现批**禁写 `design/` 整个目录与根规则文件**，**另禁写 `game/tests/README.md`（能力清单，归写卡段维护，test-conventions §8.9）**，要往外交代的东西一律落 `reports/`：实现报告 `reports/iter<N>-实现报告-<日期>.md`（各卡状态+实机目检总清单+遗留读数义务+实现决定记录——超白名单／超卡片明列范围事项逐条记「决了什么／为什么／代价／撤销方式」，全部按卡执行时只写一行「零拍板」）、GDD 反哺点清单 `reports/iter<N>-反哺点-<日期>.md`（每条写清哪个文件哪一节、改成什么、依据是什么）。设计权威文档（GDD/art-bible）**任何批都不直改**：用户在会话中逐点裁决后，由工程/文档设计改动批（直改类）写入 `design/`（执行入口=doc-design 技能），并把反哺条目从 `reports/` 清掉（吸收即死；退役执行=batch-closure 技能）。机械面文档（roadmap 行/术语表/README 工具注）同样归工程/文档设计改动批在合并前更新。反哺点未落地期间相关 GDD 节视为待反哺，读前先查 `reports/` 与待办清单；需求卡片必列「关联文档同步面」按两层标注
 12. **实机目检归用户，只登记不阻塞**——真人检测项登记进实现报告目检总清单与体验验证清单即完成批内义务；禁把等目检当停工理由或完成前置

design/engineering/test-conventions.md

@@ -20,6 +20,8 @@
 
 凡模态覆盖层，探针必须断言：打开后自身 visible 且遮挡物已隐藏（模态被遮挡 = 功能存在但不可达）。
 
+**UI 驱动断言须走真输入管线（2026-11-06 立）**：探针里「点按钮/点场景物件」类驱动断言，一律经引擎输入管线承载（合成 InputEvent 走 `push_input`，press+release 成对；合成滚轮同样必须 press+release 成对——只发 press 会把鼠标焦点钉死在按下点控件上，后续点击全部失效）；信号直发（`pressed.emit()` 等）绕过命中测试，保不了「玩家点击可达」，只许用于真输入到不了的面并当场标〔接线断言〕（现役例：置灰态穿透钉处理器兜底）。折叠区控件先以真输入滚轮滚入可视区再点。每个动线断言钉「落点」判定（点了之后到哪个屏/哪层可见），防驱动中断后的空转假绿。真输入命中控件时自动登记控件覆盖（探针共用面登记件落 `.gates/` 观测产物），覆盖面生长不靠人记。
+
 ## 3. 缺陷修复必须沉淀回归断言
 
 每个缺陷修复必须在探针或冒烟中留下能抓住该缺陷的断言（例：封印动作耗尽 AP → 必须进入第 2 轮；
@@ -27,7 +29,7 @@
 
 ## 4. 验证时机（合回后远端 CI 制，2026-11-03 换代）
 
-开发期义务＝`process-conventions.md` §4 改完即测铁规：本批新增/改动的验收测试自己跑绿、读数写进该步提交信息才算完成（卡内只测自己改的东西）。全量验证归合回后的远端 CI：git merge 合回 master 落地后 post-merge 钩子推送 origin master，远端按改动域分流跑 `tools/run_all_gates.sh`（游戏码批＝不带参数档两域全量、单元与集成测试全套件——跨卡触面与关联档选测的盲区由全量兜底；文档批＝文档域秒级闸；分流算法单点＝`tools/ci/domain_route.sh`），远端结果用 `tools/ci_check.sh <合并提交>` 按需现查（读 run 自身 `status`/`conclusion`，只呈报、不落盘——合回不等待、不唤醒，process-conventions §1 第 3 条）；CI 红态下修复合回落地即再推再验追绿（修复走新开 `fix-<任务名>` 修复 worktree，process-conventions §1）。同一份字节禁止第二次人手跑。该脚本是全部验证闸的唯一入口与唯一清单，域划分与选闸算法只写在脚本里，本文禁另列闸件清单。
+开发期义务＝`process-conventions.md` §4 改完即测铁规：本批新增/改动的验收测试自己跑绿、读数写进该步提交信息才算完成（卡内只测自己改的东西）。合回 merge 提交落笔前另有 pre-merge-commit 前置检查（2026-11-06 用户裁：冒烟＋单元与集成全套件 4 分片，约 2 分钟——当场拦截面，不落回执；细则见 process-conventions §1 第 4 条 ③）。全量验证归合回后的远端 CI：git merge 合回 master 落地后 post-merge 钩子推送 origin master，远端按改动域分流跑 `tools/run_all_gates.sh`（游戏码批＝不带参数档两域全量、单元与集成测试全套件——跨卡触面与关联档选测的盲区由全量兜底；文档批＝文档域秒级闸；分流算法单点＝`tools/ci/domain_route.sh`），远端结果用 `tools/ci_check.sh <合并提交>` 按需现查（读 run 自身 `status`/`conclusion`，只呈报、不落盘——合回不等待、不唤醒，process-conventions §1 第 3 条）；CI 红态下修复合回落地即再推再验追绿（修复走新开 `fix-<任务名>` 修复 worktree，process-conventions §1）。同一份字节禁止第二次人手跑。该脚本是全部验证闸的唯一入口与唯一清单，域划分与选闸算法只写在脚本里，本文禁另列闸件清单。
 行为探针使用随机化玩家行为（封印/停手/刷新/无效点击）——自动玩家不做的动作就是测试盲区。
 
 ## 5. 测试函数怎么写——验收清单条目的落码规范
@@ -77,7 +79,7 @@
 
 ### 8.2 四层与真实入口
 
-- **单元**：不依赖场景树和真实宿主的纯逻辑；测试从领域类的对外方法进出，断言钉对外可观测面（返回值／信号／查询接口／落盘内容）。内部字段直查＝受控例外：仅当该行为没有公开可观测面可钉时允许，对照表该行注明理由；存量不回头清扫，被批次触碰时顺带换代。
+- **单元**：不依赖场景树和真实宿主的纯逻辑；测试从领域类的对外方法进出，断言钉对外可观测面（返回值／信号／查询接口／落盘内容）。内部字段直查＝受控例外：仅当该行为没有公开可观测面可钉时允许，对照表该行注明理由；存量不回头清扫，被批次触碰时顺带换代。探针直读视口承载子件结构（画布取视口首子件、渐隐带两片与平移提示子件按名取）属此类——断言对象即承载结构本身，无公开可观测面可钉，理由随对照表行申报。
 - **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。接口级断言随单元套件落（`unit/contracts/`），不另设承载目录。
 - **集成**：跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩；测试必须实例化真实宿主链，禁止用裸 EffectEngine 代替。
 - **探针/golden**：玩家可达性与观感；真实实例化场景、驱动真实输入。

design/gdd/00-游戏概念.md

@@ -47,12 +47,6 @@
 
 | 专名 | 是什么 | 出处条目 |
 |---|---|---|
-| 显影尘 | 信息类秘宝 | aux_items |
-| 工兵令 | 加行动点的秘宝 | aux_items |
-| 探宝罗盘 | 预读奖励身份的秘宝 | aux_items |
-| 探巢摆钟 | 探知巢穴位置的秘宝 | aux_items |
-| 地穴全图卷 | 全图级稀有秘宝 | aux_items |
-| 爆破工兵包 | 行动点 + 探巢的稀有秘宝 | aux_items |
 | 地精 / 熊地精 / 食人魔酋长 | 首发三敌种（末者为 Boss） | enemy |
 | 第一层 · 地精洞窟 | 首关层名 | level_table |
 | 封印 | 正式动作名（全库统一，非比喻、非呈现层别名）——对未开格实施封印，印记=封印印记 | terminology |

design/gdd/03-内容规模.md

@@ -38,7 +38,7 @@ MVP 不加新敌种，也不做同深度多敌种混搭；敌种扩容走 `enemy
 
 目录（重设计 v1）已定稿 **12 件**（普通 7 / 优秀 3 / 稀有 2——代号制，正式命名归用户；数值全 provisional 归调参批），现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录（重设计 v1）」节。数据行随实装批落表（同调件数据表 = `data/tables/treasure_items.tres`），MVP 不新增。
 
-旧目录（旧 aux_items 六行：显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包，及过渡形态诸件）已全数退役、只作素材库（design/content-archive/道具退役素材库.md）；旧行删除归实装批。
+旧目录（旧 aux_items 六行：显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包，及过渡形态诸件）已全数退役、留底 design/content-archive/道具退役素材库.md（数据表旧行已删净——treasure_items.tres 旧六名扫描零命中）。
 
 ## 增益与状态
 

design/gdd/systems/战斗循环/地图战斗资源.md

@@ -1,7 +1,7 @@
 # 地图战斗资源
 
 > 一句话：格面资源的产出、极性字典与清图奖励封装
-> 状态：已定稿；现行为 v1.5
+> 状态：已定稿；现行为 v1.6
 
 ## 设计目的
 
@@ -96,7 +96,7 @@
 
 - **档由两个参数定义：概率位 + 保底上限**。「永不保底」不单立规则——T4 的保底上限 = 0 即其统一表达；T1/T2 上限同为 0。
 - **保底数量挂在型上、不挂在档上**：每个型各自登记「每板至少出几个」。档内登记保底的型数 ≤ 档上限 → 全部兑现；> 上限 → 每板从登记型中随机选定「上限」个兑现，其余型该板按普通概率出现、不保底。
-- **补签纪律**：执行序 = 装板摇号（含偏运硬币投影）→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份：危险格与安全格不动（补签格可为雷可为安全格，危险格与安全格同池不破）、不消费权重（补签不是一次取号）、清图判定不动、不泄露元信息（补签格与摇号格不可区分）。粒度 = 板，换板重新校验。
+- **补签纪律**：执行序 = 装板摇号（含订阅加权投影）→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份：危险格与安全格不动（补签格可为雷可为安全格，危险格与安全格同池不破）、不消费权重（补签不是一次取号）、清图判定不动、不泄露元信息（补签格与摇号格不可区分）。粒度 = 板，换板重新校验。
 - **GP 数值锚**：以战斗结束 GP 奖励为锚——小 GP 袋 ≈ 其 1/10、大宝箱 ≈ 其 1 倍（具体数值归调参批）。
 - 大宝箱为枚举新增（九型→十型走本文修订流程，不随手加行）；微光归通用增益组（五色相不变，组内不细分正好容下）。
 - **对外稀有度映射**（现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节）：T1=普通 / T2=优秀 / T3=稀有 / T4=传说；任何概率提升禁止改变本档保底承诺（保底=承诺非概率）。

design/gdd/systems/战斗循环/战斗结算.md

@@ -1,7 +1,7 @@
 # 战斗结算
 
 > 一句话：轮末结算的编排与逐行兑现
-> 状态：已定稿；现行为 v1.7
+> 状态：已定稿；现行为 v1.8
 
 ## 设计目的
 
@@ -84,7 +84,7 @@
 | 判定行 | 胜 / 负 / 继续各一行；终局判定行同时是胜负画面的数据锚 |
 | 高光行 | 完美封印成立时一行，只记实际有效兑付 |
 
-每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：两类"未生效"行如实记录合法例外，呈现时聚合计数，不逐行刷屏。
+每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。**显示名等玩家可见文案是数据面字段：文案值登记在数据表行，代码按来源类别与效果身份读表拼行，不在代码里写死文案字串**（2026-11-06 用户裁——文案归属数据表承载；承载表与字段形态归表结构设计段定，设计闭合后由实装批落表）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：两类"未生效"行如实记录合法例外，呈现时聚合计数，不逐行刷屏。
 
 任何一行找不到来源即断言失败——宁可返回错误，也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源，断言为此留了两层豁免，豁免集合是封闭清单，改动同样走本文修订。
 

design/gdd/术语表.md

@@ -1,7 +1,7 @@
 # 术语表
 
 > 全库专用术语的唯一对照表（2026-10-11 用户令建立）。规矩：新术语先登记本表、再在文档使用；退役词见文末对照表，文档正文一律使用现行词。文档中遇到看不懂的词，查本表。用词纪律（禁用词、替换值、豁免范围）见「用语规范」节。
-> 状态：**现行 v1.26**——2026-10-11 建立；历次升版明细见 git 提交史。
+> 状态：**现行 v1.27**——2026-10-11 建立；历次升版明细见 git 提交史。
 
 ## 格与棋盘
 
@@ -95,7 +95,7 @@
 | 术语 | 定义 |
 |---|---|
 | 效果端口件 | 战斗业务类（伤害管线／行动经济）唯一的效果发射出口：收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连（机制归属见架构文档「战斗编排域拆件定稿」节轴戊；实现类 EffectPort） |
-| 掷格件 | 装配期格面资源摇号的承载件：池行装配、区间行 roll、权重合成（偏运硬币／board_skew 两路投影）；受理账面留守地图战斗资源件（机制归属同上；实现类 RewardRoller） |
+| 掷格件 | 装配期格面资源摇号的承载件：池行装配、区间行 roll、权重合成（订阅加权/board_skew 两路投影）；受理账面留守地图战斗资源件（机制归属同上；实现类 RewardRoller） |
 | `seal_missed` | 封印落空事件（旧名已换代）：封印动作落在安全格上时发出，订阅面据此做限次与豁免判定 |
 | `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型，`domain=battle` 首例；有效误标＝误标总数 − 豁免数，豁免不改写误标账 |
 

game/probe/level_map_shot_probe.gd.uid

@@ -0,0 +1 @@
+uid://j4ax48si4nq5

game/probe/probe_coverage_recorder.gd

@@ -0,0 +1,242 @@
+# probe_coverage_recorder.gd — 真输入覆盖登记件（探针共用面）
+# 是什么：探针/C 驱动件把合成 InputEvent 经 Viewport.push_input 送进引擎输入管线时，登记
+#   「真输入实际命中了哪些交互控件」，探针收尾落 JSONP 式 .js 到 tests/.gates/coverage/
+#   （.js 供 file:// 页面 <script src> 直载——fetch 本地 json 会被 CORS 拦）。
+# 成员面（两源）：① 场景树全部 BaseButton——pressed 沿自动接线（重扫懒触发，见下）；
+#   ② 自绘命中类——现役接 camp_scene_view.object_pressed（信号带物件 id，key 追加 #物件id 后缀），
+#   其余自绘命中面走 note_hit() 显式口。
+# 真输入旗标：push 前置位、帧末清位——只有旗标在位期间的命中入账；信号直发（〔接线断言〕保留站）
+#   与产品码自发射永不入账。命中=控件真的收到事件：hitbox 错位/遮挡时零命中，缺口自然暴露——
+#   这是「新控件落地→覆盖登记自动出现它」的数据源。
+# key 规则（契约「场景文件路径＋节点路径」的实况落地偏差，详见 qa-harness 讨论文档回写节）：
+#   本仓库 UI 大头由代码构建（main_ui_build/ui_kit 不设节点名），运行时节点路径全为 @类@序
+#   临时名——契约原样落地产出空登记。故键取「锚链归一化」形态：自主根到控件只收集带稳定身份的
+#   锚（具名节点用其名、带脚本节点用脚本文件名；@ 临时名段整体不入键），控件本体记 类#钮面文本，
+#   同键控件按接线遍历序追加 #序位。键在确定构建序下可复现；UI 构建序变更会平移同键序位——
+#   表现为键漂移而非静默丢失，属测量面可接受代价。
+# 用法：探针 _ready 里 `_recorder = ProbeCoverageRecorder.new()` → `attach(main, "<探针名>")`；
+#   收尾 `dump_js()`。探针共用面不入 S 系扫描面（code-conventions §4.13 分档）。
+extends RefCounted
+
+const ProbeUiUtil := preload("res://probe/probe_ui_util.gd")
+
+var _main: Node
+var _probe_name: String
+var _pending := false                    # 真输入在途旗标
+var _camp: Control = null                # 营地场景根（自绘命中单点）
+var _hits: Dictionary = {}               # 稳定 key(String) → 命中次数(int)
+var _node_keys: Dictionary = {}          # 接线时分配的节点键（instance_id → key）
+var _key_seen: Dictionary = {}           # 基键出现次数（同键控件按遍历序追加序位）
+var _wired: Dictionary = {}              # 已连 pressed 的按钮实例 id → true（防重连）
+var _skipped_temp := 0                   # 临时名命中笔数（不入 key，只计数）
+
+
+# ---- 装载与接线 ----
+
+func attach(main: Node, probe_name: String) -> void:
+	_main = main
+	_probe_name = probe_name
+	ProbeUiUtil.coverage_hook = self   # 共用件真输入口统一过旗标（push_click/push_click_at/push_motion）
+	_wire_buttons()
+	_wire_camp_scene()
+
+
+# 懒重扫：每次真输入 push 前接线一遍新入树的按钮（开层重建的钮行在下次点击前接上）；
+# 已释放按钮的连接随节点释放失效，登记表按 instance_id 清扫。
+func mark_real_input() -> void:
+	for id in _wired.keys():
+		if instance_from_id(int(id)) == null:
+			_wired.erase(id)
+			_node_keys.erase(id)
+	_wire_buttons()
+	if not _pending:   # 同帧多次 push 只挂一次帧末清位旗（重复 connect 会报引擎错）
+		_pending = true
+		_main.get_tree().process_frame.connect(_clear_pending, CONNECT_ONE_SHOT)
+
+
+func _clear_pending() -> void:
+	_pending = false
+
+
+func _wire_buttons() -> void:
+	_wire_into(_main)
+
+
+func _wire_into(node: Node) -> void:
+	if node is BaseButton:
+		var id := node.get_instance_id()
+		if not _wired.has(id):
+			_wired[id] = true
+			_node_keys[id] = _assign_key(node)
+			(node as BaseButton).pressed.connect(_on_button_pressed.bind(id))
+	for child in node.get_children():
+		_wire_into(child)
+
+
+func _wire_camp_scene() -> void:
+	_camp = _find_by_script(_main, "camp_scene_view")
+	if _camp != null:
+		_camp.object_pressed.connect(_on_camp_object)
+
+
+func _find_by_script(root: Node, script_name: String) -> Control:
+	var s: Script = root.get_script()
+	if s != null and String(s.resource_path).contains(script_name) and root is Control:
+		return root as Control
+	for child in root.get_children():
+		var found := _find_by_script(child, script_name)
+		if found != null:
+			return found
+	return null
+
+
+# ---- 键分配（锚链归一化，接线时一次算好存表）----
+
+func _assign_key(n: Node) -> String:
+	var chain := _anchor_chain(n)
+	var leaf := ""
+	if n is BaseButton:
+		leaf = "%s#%s" % [n.get_class(), String((n as BaseButton).text)]
+	else:
+		leaf = n.get_class()
+	var base := "%s:%s/%s" % [String(_main.scene_file_path), "/".join(chain), leaf]
+	# 同键控件按接线遍历序加序位（#1 省略）——重复键可分账，序位随构建序漂移属已知代价
+	_key_seen[base] = int(_key_seen.get(base, 0)) + 1
+	if int(_key_seen[base]) > 1:
+		base += "#%d" % int(_key_seen[base])
+	return base
+
+
+# 自主根到 n 的稳定锚链：具名节点取其名、带脚本节点取脚本文件名；@ 临时名段不入链。
+func _anchor_chain(n: Node) -> Array[String]:
+	var chain: Array[String] = []
+	var cur: Node = n
+	while cur != null and cur != _main:
+		var nm := String(cur.name)
+		if not nm.begins_with("@"):
+			chain.push_front(nm)
+		elif cur.get_script() != null:
+			var sp := String((cur.get_script() as Script).resource_path)
+			chain.push_front(sp.get_file().trim_suffix(".gd"))
+		cur = cur.get_parent()
+	if chain.is_empty():
+		chain.push_front("(root)")
+	return chain
+
+
+# ---- 显式登记口（自绘命中类无信号可连时的单点）----
+
+func note_hit(n: Node, suffix: String = "") -> void:
+	if not _pending or n == null:
+		return
+	var id := n.get_instance_id()
+	var key := String(_node_keys.get(id, ""))
+	if key == "":
+		key = _assign_key(n)
+		_node_keys[id] = key
+	_bump(key + suffix)
+
+
+# ---- 命中处理 ----
+
+func _on_button_pressed(id: int) -> void:
+	if not _pending:
+		return
+	var key := String(_node_keys.get(id, ""))
+	if key == "":
+		_skipped_temp += 1
+		return
+	_bump(key)
+
+
+func _on_camp_object(key: StringName) -> void:
+	if not _pending or _camp == null:
+		return
+	var id := _camp.get_instance_id()
+	var base := String(_node_keys.get(id, ""))
+	if base == "":
+		base = _assign_key(_camp)
+		_node_keys[id] = base
+	_bump(base + "#" + String(key))
+
+
+func _bump(key: String) -> void:
+	_hits[key] = int(_hits.get(key, 0)) + 1
+
+
+# ---- 场景树全量交互面枚举（控件缺口数据源：seen−hit=「存在但零真输入覆盖」）----
+# 成员面与登记同源：场景树全部 BaseButton（main 建树常驻——未开过的屏的钮也算存在；
+# 已接线钮复用接线键防序位错位，未接线者落盘期才补键——落盘是终态动作，序位计数此后不再消费）
+# ＋营地物件（经 db 布局表 hotspot_key 公共数据面枚举；物件命中见 _on_camp_object 的 #物件id 后缀）。
+func enumerate_seen() -> Array[String]:
+	var keys: Array[String] = []
+	_seen_into(_main, keys)
+	var db = _main.get("db")
+	if db != null and db.get("presentation") != null:
+		var layout = db.presentation.camp_scene_layout
+		if layout != null:
+			for spec in layout.layers:
+				var hk: StringName = spec.hotspot_key
+				var ck := "camp_object#" + String(hk)
+				if hk != &"" and not keys.has(ck):
+					keys.append(ck)
+	return keys
+
+
+func _seen_into(node: Node, keys: Array[String]) -> void:
+	if node is BaseButton:
+		var id := node.get_instance_id()
+		var key := String(_node_keys.get(id, ""))
+		if key == "":
+			key = _assign_key(node)
+			_node_keys[id] = key
+		if not keys.has(key):
+			keys.append(key)
+	for child in node.get_children():
+		_seen_into(child, keys)
+
+
+# ---- 落盘（JSONP 式 .js——file:// 页面 <script src> 直载）----
+
+func dump_js() -> void:
+	var dir := DirAccess.open("res://")
+	if dir == null:
+		push_error("[coverage] res:// 打不开，登记未落盘")
+		return
+	var mk := dir.make_dir_recursive("tests/.gates/coverage")
+	if mk != OK and not dir.dir_exists("tests/.gates/coverage"):
+		push_error("[coverage] coverage 目录建不了（err=%d），登记未落盘" % mk)
+		return
+	var path := "res://tests/.gates/coverage/probe_hits_%s.js" % _probe_name
+	var f := FileAccess.open(path, FileAccess.WRITE)
+	if f == null:
+		push_error("[coverage] 登记文件打不开：%s" % path)
+		return
+	var total := 0
+	for k in _hits:
+		total += int(_hits[k])
+	var seen := enumerate_seen()
+	var payload := {
+		"meta": {
+			"probe": _probe_name,
+			"seed": OS.get_environment("PROBE_SEED"),
+			"scene": String(_main.scene_file_path),
+			"generated_at": Time.get_datetime_string_from_system(),
+			"driver": "InputEvent via Viewport.push_input（真输入管线）",
+			"key_shape": "锚链归一化（具名/脚本锚＋类#文本＋序位；@ 临时名不入键）",
+			"hits_total": total,
+			"seen_total": seen.size(),
+			"skipped_temp_names": _skipped_temp,
+		},
+		"hits": _hits,
+		"seen": seen,
+	}
+	var js := "/* 真输入覆盖登记——探针每次运行自动覆写，人工修订无效（豁免面走人工清单，不落本文件）。 */\n"
+	js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+	js += "window.__QA_COVERAGE__.probe_real_input = window.__QA_COVERAGE__.probe_real_input || {};\n"
+	js += "window.__QA_COVERAGE__.probe_real_input[%s] = %s;\n" % [
+		JSON.stringify(_probe_name), JSON.stringify(payload, "  ")]
+	f.store_string(js)
+	f.close()
+	print("[coverage] 真输入命中登记已落盘 %s（控件 %d 处 / 命中 %d 次 / 临时名跳过 %d）" % [
+		path, _hits.size(), total, _skipped_temp])

game/probe/probe_coverage_recorder.gd.uid

@@ -0,0 +1 @@
+uid://d1uhtlw3kmhxw

game/probe/probe_ui_util.gd

@@ -120,13 +120,20 @@ static func isolate_save(main, tag: String, mark_first_done: bool = false, with_
 
 # ---- 真输入点击承载（test-conventions §8.3「真实入口」判定口径）----
 # 合成鼠标事件经 Viewport.push_input 进引擎输入管线（hitbox/命中测试参与），press+release 成对
-#（BaseButton pressed 信号走 release 沿——ui_input_probe :717-733 / screen_flow_probe :484-499 同式）。
+#（BaseButton pressed 信号走 release 沿——ui_input_probe :717-733 先例式）。
 # 信号直发（pressed.emit()）只许标「接线验证」，不得充当真实入口断言的驱动。
+# coverage_hook = 真输入覆盖登记件（probe_coverage_recorder.gd）挂点：本件三个 push 口是探针
+# 真输入的单点通道，push 前通知登记件置旗标——命中记账只认旗标在位期间（信号直发不入账）。
+static var coverage_hook: Object = null
+
+
 static func push_click(main, ctrl: Control) -> void:
 	push_click_at(main, ctrl.get_global_rect().get_center())
 
 
 static func push_click_at(main, pos: Vector2) -> void:
+	if coverage_hook != null:
+		coverage_hook.mark_real_input()
 	var down := InputEventMouseButton.new()
 	down.position = pos
 	down.global_position = pos
@@ -141,6 +148,71 @@ static func push_click_at(main, pos: Vector2) -> void:
 	main.get_viewport().push_input(up, true)
 
 
+# 悬停真输入（tooltip/悬停态断言的承载——motion 进管线触发 mouse_entered/exited 沿）
+static func push_motion(main, pos: Vector2) -> void:
+	if coverage_hook != null:
+		coverage_hook.mark_real_input()
+	var mv := InputEventMouseMotion.new()
+	mv.position = pos
+	mv.global_position = pos
+	main.get_viewport().push_input(mv, true)
+
+
+# 滚轮真输入（dir=+1 向下翻 / -1 向上翻——折叠区行滚入视野的唯一真输入通道）。
+# wheel 合成必须 press+release 成对：硬件滚轮虽无 release 沿，但引擎 GUI 会把按键事件的
+# press 记为鼠标焦点且等 release 才释放——只发 press 会把焦点钉死在按下点控件上，
+# 后续左键点击全被路由给焦点控件（实证：滚轮后 fork/返回营地两钮点击全部失效）。
+static func push_wheel(main, pos: Vector2, dir: int) -> void:
+	if coverage_hook != null:
+		coverage_hook.mark_real_input()
+	var idx := MOUSE_BUTTON_WHEEL_DOWN if dir > 0 else MOUSE_BUTTON_WHEEL_UP
+	var w := InputEventMouseButton.new()
+	w.position = pos
+	w.global_position = pos
+	w.button_index = idx
+	w.pressed = true
+	main.get_viewport().push_input(w, true)
+	var w2 := InputEventMouseButton.new()
+	w2.position = pos
+	w2.global_position = pos
+	w2.button_index = idx
+	w2.pressed = false
+	main.get_viewport().push_input(w2, true)
+
+
+# 窗板定位（窗壳视图子树固定链：遮罩 ColorRect → CenterContainer → 窗板 PanelContainer——
+# screen_flow_probe._window_panel 同式，探针族共用单点）
+static func window_panel(view: Control) -> PanelContainer:
+	if view == null or view.get_child_count() == 0:
+		return null
+	var dim := view.get_child(0)
+	if dim.get_child_count() == 0:
+		return null
+	var center := dim.get_child(0)
+	if center.get_child_count() == 0 or not (center.get_child(0) is PanelContainer):
+		return null
+	return center.get_child(0) as PanelContainer
+
+
+# 折叠区行滚入窗板可视区（真输入滚轮驱动；滚动不重建行，rect 随滚更新）。
+# 判据：钮 rect 整体落在窗板内（上缘留 8px、下缘让开底栏 64px——返回营地钮带高约 56px）。
+# 保险丝 60 次滚叶防异常内容死循环；窗板缺失或钮句柄失效即返回（调用方前置断言兜底）。
+static func scroll_button_into_view(main, view: Control, btn: Control) -> void:
+	var panel := window_panel(view)
+	if panel == null or btn == null:
+		return
+	var guard := 60
+	while guard > 0:
+		var r := btn.get_global_rect()
+		var pr := panel.get_global_rect()
+		if r.position.y >= pr.position.y + 8.0 and r.end.y <= pr.end.y - 64.0:
+			return
+		var down := r.end.y > pr.end.y - 64.0
+		push_wheel(main, pr.get_center(), 1 if down else -1)
+		guard -= 1
+		await main.get_tree().process_frame
+
+
 # 真输入拖拽沿（press→motion×steps→release 成对经 push_input 进引擎输入管线——卷轴视口批
 # R3/R5/R6 驱动沿；沿 push_click_at 同式。relative 按步显式置值——合成事件的位移量由事件
 # 自身承载，被测面按 relative 逐帧平移）
@@ -167,7 +239,7 @@ static func push_drag_at(main, pos: Vector2, delta: Vector2, steps: int = 4) ->
 
 
 # 真输入滚轮沿（单档滚轮事件经 push_input——卷轴视口批 R4 驱动沿；方向映射在被测面，
-# 本工具只发原始滚轮档）
+# 本工具只发原始滚轮档）。press+release 成对（同 push_wheel 注——只发 press 钉死鼠标焦点）。
 static func push_wheel_at(main, pos: Vector2, wheel_down: bool = true) -> void:
 	var ev := InputEventMouseButton.new()
 	ev.position = pos
@@ -175,6 +247,12 @@ static func push_wheel_at(main, pos: Vector2, wheel_down: bool = true) -> void:
 	ev.button_index = MOUSE_BUTTON_WHEEL_DOWN if wheel_down else MOUSE_BUTTON_WHEEL_UP
 	ev.pressed = true
 	main.get_viewport().push_input(ev, true)
+	var ev2 := InputEventMouseButton.new()
+	ev2.position = pos
+	ev2.global_position = pos
+	ev2.button_index = MOUSE_BUTTON_WHEEL_DOWN if wheel_down else MOUSE_BUTTON_WHEEL_UP
+	ev2.pressed = false
+	main.get_viewport().push_input(ev2, true)
 
 
 # 营地经进档开层（卡② mn9 新路径——campbtn 已撤；槽模板注入隔离命名空间，防碰真实槽

game/probe/screen_flow_probe.gd

@@ -8,9 +8,11 @@
 extends Node
 
 const ProbeUiUtil := preload("res://probe/probe_ui_util.gd")
+const ProbeCoverageRecorder := preload("res://probe/probe_coverage_recorder.gd")
 
 var main: Node
 var _problems: Array[String] = []
+var _recorder: RefCounted = null   # 真输入覆盖登记件（probe_coverage_recorder.gd——attach 后全探针真输入自动记账）
 
 
 func _ready() -> void:
@@ -20,6 +22,10 @@ func _ready() -> void:
 	await get_tree().process_frame
 	await get_tree().process_frame
 
+	# 真输入覆盖登记（命中控件自动记账，收尾落 tests/.gates/coverage/——覆盖面生长不靠人记）
+	_recorder = ProbeCoverageRecorder.new()
+	_recorder.attach(main, "screen_flow")
+
 	# 隔离存档（全 worktree 共享同一份 user://save.json——探针必须换注，禁碰真实档）
 	ProbeUiUtil.isolate_save(main, "smoke_screen_flow", false, false, false)
 	await get_tree().process_frame
@@ -35,6 +41,7 @@ func _ready() -> void:
 	await _step_abandon_to_end()
 	await _step_end_back_to_menu()
 
+	_recorder.dump_js()
 	if _problems.is_empty():
 		print("[screen_flow_probe] PASS — 六步主流程＋回退路径全绿（屏级互斥：任意时刻 ≤1 屏可见）")
 		get_tree().quit(0)
@@ -122,11 +129,11 @@ func _step_camp_back_to_menu() -> void:
 	if main.ui.modals.camp.scene == null:
 		_problems.append("③营地→菜单：营地场景根句柄缺失〔句柄子容器批 V1〕")
 		return
-	main.ui.modals.camp.scene.object_pressed.emit(&"campfire")
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"campfire").get_center())   # 真输入（营地场景 _gui_input 命中——大门段同式）
 	await _frames()
 	if not main.ui.modals.menu.confirm_dialog.visible:
 		_problems.append("③篝火：二次确认弹窗未现（camp.md v2.2 必须先确认）〔营地图批 V7〕")
-	main.ui.modals.menu.confirm_dialog.confirmed.emit()   # 二次确认离场（confirmed 先于关层——卡④ T4）
+	ProbeUiUtil.push_click(main, main.ui.modals.menu.confirm_dialog._confirm_btn)   # 真点「确认」离场（confirmed 先于关层——卡④ T4）
 	await _frames()
 	_expect_exclusive("③营地→菜单（回退）", "菜单")
 
@@ -150,7 +157,7 @@ func _step_save_select_open_back() -> void:
 	if back_btn == null:
 		_problems.append("[savesel] sl10 返回钮缺失（页壳顶条）")
 	else:
-		back_btn.pressed.emit()
+		ProbeUiUtil.push_click(main, back_btn)   # 真点「返回」→ 关选档层
 		await get_tree().process_frame
 		if main.ui.modals.menu.save_select_overlay.visible or not main.ui.screens.start_overlay.visible:
 			_problems.append("[savesel] sl10 返回后选档未隐藏或开始层未恢复（关闭链失守）")
@@ -228,7 +235,7 @@ func _step_end_back_to_menu() -> void:
 	if main.ui.modals.run.end_overlay == null or not main.ui.modals.run.end_overlay.visible:
 		_problems.append("⑦终局→菜单：前置不在终局")
 		return
-	main.ui.modals.run.end_overlay.continue_pressed.emit()
+	ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)   # 真点「继续」（_btn=continue_pressed 同源句柄）
 	await _frames(3)
 	_expect_exclusive("⑦终局→菜单", "菜单")
 	if main.run_scope != null and main.run_scope.is_adventure:
@@ -254,8 +261,10 @@ func _step_camp_esc_and_hud() -> void:
 	await _frames()
 	if main.ui.modals.camp.esc_overlay.visible:
 		_problems.append("[esc] echo 事件唤起浮窗（触发沿 pressed 且非 echo 失守）〔ESC批 V1〕")
-	main.ui.modals.camp.scene.object_pressed.emit(&"dummy")   # 子界面开态
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center())   # 子界面开态（真输入命中）
 	await _frames()
+	if not main.ui.modals.camp.tree.visible:
+		_problems.append("[esc] 子界面未随场景点选打开（后续关窗断言的前置落点）")
 	_push_esc()
 	await _frames()
 	if main.ui.modals.camp.tree.visible:
@@ -285,7 +294,7 @@ func _step_camp_esc_and_hud() -> void:
 	if not main.ui.modals.camp.esc_overlay.visible or main.ui.screens.start_overlay.visible:
 		_problems.append("[esc] 关设置后未回浮窗或回弹主菜单（契约 3 语境分支失守）〔ESC批 V4〕〔ESC批 B3〕")
 	# 返回主菜单动线（契约 4——浮窗自收＋营地隐＋选档收＋菜单显）
-	main.ui.modals.camp.esc_overlay.return_requested.emit()
+	ProbeUiUtil.push_click(main, main.ui.modals.camp.esc_overlay._return_btn)   # 真点「返回主菜单」
 	await _frames()
 	if main.ui.modals.camp.esc_overlay.visible or main.ui.modals.camp.scene.visible 			or main.ui.modals.menu.save_select_overlay.visible or not main.ui.screens.start_overlay.visible:
 		_problems.append("[esc] 返回主菜单动线失守（浮窗自收/营地隐/选档收/菜单显）〔ESC批 V3〕〔ESC批 B3〕")
@@ -323,11 +332,11 @@ func _step_camp_window_shell() -> void:
 			if prev_back == null:
 				_problems.append("[winshell] %s 底栏「返回营地」钮缺失〔窗口化批 V4〕" % String(opened.back()))
 			else:
-				prev_back.pressed.emit()
+				ProbeUiUtil.push_click(main, prev_back)   # 真点「返回营地」关前窗
 				await _frames()
 				if prev.visible or not main.ui.modals.camp.scene.visible:
 					_problems.append("[winshell] %s 关闭钮按下未隐窗或场景根失守〔窗口化批 V4〕" % String(opened.back()))
-		main.ui.modals.camp.scene.object_pressed.emit(k)
+		ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(k).get_center())   # 真输入开窗（场景 _gui_input 命中）
 		await _frames()
 		opened.append(k)
 		var view: Control = views[k]
@@ -362,7 +371,10 @@ func _step_camp_window_shell() -> void:
 		if vis_n != 1:
 			_problems.append("[winshell] %s 开态五窗 visible 计数=%d 应=1（互斥单开失守）〔窗口化批 V5〕" % [String(k), vis_n])
 	# 树窗点选遮挡（V5b——树窗开态向锻炉命中区推真实鼠标点：被遮罩挡＝零新窗零响应）
-	main.ui.modals.camp.scene.object_pressed.emit(&"dummy")
+	# 真输入化订正：前窗（图鉴）先经真实关闭钮清账再开树窗——emit 直发可穿透遮罩开窗，
+	# 真输入下「无窗态场景命中」是唯一合法开窗路径（遮罩语义由本段正面验证）。
+	await _close_all_windows(views)
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center())
 	await _frames()
 	var tree_view: Control = views[&"dummy"]
 	if not tree_view.visible:
@@ -370,8 +382,7 @@ func _step_camp_window_shell() -> void:
 	else:
 		var hotspot: Rect2 = main.ui.modals.camp.scene.get_hotspot_rect(&"forge")
 		var c := hotspot.get_center()
-		_push_click(c)
-		_push_release(c)
+		ProbeUiUtil.push_click_at(main, c)   # 遮挡试探真点击——遮罩生效则零命中零响应
 		await _frames()
 		var vis_n2 := 0
 		for w in five:
@@ -383,7 +394,7 @@ func _step_camp_window_shell() -> void:
 	# 随栈 close 恢复语义逐层清账，V6/V8 从干净单窗态起步）
 	await _close_all_windows(views)
 	# V6 ESC 先关窗（生涯窗开态 Esc→关生涯窗、浮窗不唤起）
-	main.ui.modals.camp.scene.object_pressed.emit(&"notebook")
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"notebook").get_center())
 	await _frames()
 	if not career.visible:
 		_problems.append("[winshell] 生涯窗未开（V6 前置中断）〔窗口化批 V6〕")
@@ -395,7 +406,7 @@ func _step_camp_window_shell() -> void:
 		if main.ui.modals.camp.esc_overlay.visible:
 			_problems.append("[winshell] 关窗同拍唤起浮窗（应无窗才进浮窗）〔窗口化批 V6〕")
 	# V7 内容超高窗内滚动（树窗＋真实投影喂加长行册）
-	main.ui.modals.camp.scene.object_pressed.emit(&"dummy")
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center())
 	await _frames()
 	if not tree_view.visible:
 		_problems.append("[winshell] 树窗未开（V7 前置中断）〔窗口化批 V7〕")
@@ -420,7 +431,7 @@ func _step_camp_window_shell() -> void:
 	# 清窗经真实钮（同 V6 前置——干净单窗态起步）
 	await _close_all_windows(views)
 	# V8 生涯同壳（窗板同几何＋返回钮在位＋内容列滚动面在）
-	main.ui.modals.camp.scene.object_pressed.emit(&"notebook")
+	ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"notebook").get_center())
 	await _frames()
 	if not career.visible:
 		_problems.append("[winshell] 生涯窗未开（V8 前置中断）〔窗口化批 V8〕")
@@ -445,7 +456,7 @@ func _step_camp_window_shell() -> void:
 	# 段尾收闭：生涯窗经真实「返回」钮关闭（on_camp_closed 关闭名单不含生涯窗——防残留泄段）
 	var career_back: Button = ProbeUiUtil.find_button(career, "返回", "prefix")
 	if career_back != null:
-		career_back.pressed.emit()
+		ProbeUiUtil.push_click(main, career_back)   # 真点「返回」收闭生涯窗
 		await _frames()
 		if career.visible:
 			_problems.append("[winshell] 生涯「返回」钮未隐窗〔窗口化批 V4〕")
@@ -463,7 +474,7 @@ func _close_all_windows(views: Dictionary) -> void:
 		if back == null:
 			_problems.append("[winshell] %s 底栏「返回营地」钮缺失〔窗口化批 V4〕" % String(k))
 			continue
-		back.pressed.emit()
+		ProbeUiUtil.push_click(main, back)   # 真点「返回营地」逐窗清账
 		await _frames()
 
 
@@ -480,25 +491,7 @@ func _window_panel(view: Control) -> PanelContainer:
 	return center.get_child(0) as PanelContainer
 
 
-# 真实鼠标合成（press+release 成对——BaseButton pressed 信号默认 release 触发，ui_input_probe :718 先例）
-func _push_click(pos: Vector2) -> void:
-	var ev := InputEventMouseButton.new()
-	ev.position = pos
-	ev.global_position = pos
-	ev.button_index = MOUSE_BUTTON_LEFT
-	ev.pressed = true
-	main.get_viewport().push_input(ev, true)
-
-
-func _push_release(pos: Vector2) -> void:
-	var ev := InputEventMouseButton.new()
-	ev.position = pos
-	ev.global_position = pos
-	ev.button_index = MOUSE_BUTTON_LEFT
-	ev.pressed = false
-	main.get_viewport().push_input(ev, true)
-
-
+# 键盘真输入合成（鼠标点击统一走 ProbeUiUtil.push_click_at——覆盖登记单点通道）
 func _push_esc(echo := false) -> void:
 	var ev := InputEventKey.new()
 	ev.keycode = KEY_ESCAPE

game/probe/ui_click_probe.gd

@@ -11,8 +11,10 @@ extends Node
 
 const AutoPlayer := preload("res://sim/auto_player.gd")   # O4：自动玩家策略单一实现
 const ProbeUiUtil := preload("res://probe/probe_ui_util.gd")   # T6 收口：树寻址/隔离样板单点
+const ProbeCoverageRecorder := preload("res://probe/probe_coverage_recorder.gd")
 
 var main: Node
+var _recorder: RefCounted = null   # 真输入覆盖登记件（probe_coverage_recorder.gd——attach 后全探针真输入自动记账）
 var _last_state := {}
 var _stall_frames := 0
 var _closed_via_abandon := false   # T17——预算耗尽经放弃路径收口（断点段返回断言豁免位）
@@ -48,6 +50,9 @@ func _ready() -> void:
 	main = load("res://presentation/main.tscn").instantiate()
 	add_child(main)
 	await get_tree().process_frame
+	# 真输入覆盖登记（命中控件自动记账，收尾落 tests/.gates/coverage/——覆盖面生长不靠人记）
+	_recorder = ProbeCoverageRecorder.new()
+	_recorder.attach(main, "ui_click")
 	var t_ui_ready := Time.get_ticks_msec() - t0
 	# 调试浮窗 boot 不开（菜单优先——入口=UI 最顶层全局浮层角标，
 	# 任何 UI 不遮挡；浮层角标遮挡判据见设置面段）
@@ -67,7 +72,7 @@ func _ready() -> void:
 		await get_tree().process_frame
 		if not main.ui.modals.camp.scene.visible:
 			_problems.append("营地场景根未打开（进档开层新路径）〔句柄子容器批 V1〕")
-		main.ui.modals.camp.scene.object_pressed.emit(&"dummy")   # 场景点选真实路由（木桩→天赋树子界面——卡④ T5）
+		ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center())   # 场景点选真输入（木桩→天赋树子界面——卡④ T5；_gui_input 命中）
 		await get_tree().process_frame
 		if main.ui.modals.camp.tree._tree_buy_btns.is_empty():
 			_problems.append("树淬炼购买钮缺失（四柜台拆解后树=独立子界面）〔句柄子容器批 V1〕")
@@ -85,7 +90,8 @@ func _ready() -> void:
 			else:
 				var bal_before: int = iso_c.meta_state.keystone_balance()
 				var price: int = int(main.db.crossrun.meta_tree.row_by_id("sp_hp").get("price", 0))
-				buy_btn.pressed.emit()   # 合成购买点击 → _on_camp_tree_buy → meta.tree_buy（写调用唯一归组合根）
+				await ProbeUiUtil.scroll_button_into_view(main, main.ui.modals.camp.tree, buy_btn)   # 折叠区行先滚入窗板可视区（真输入滚轮）
+				ProbeUiUtil.push_click(main, buy_btn)   # 真点购买 → _on_camp_tree_buy → meta.tree_buy（写调用唯一归组合根）
 				await get_tree().process_frame
 				if int(iso_c.meta_state.keystone_balance()) != bal_before - price:
 					_problems.append("营地树购买未出账（%d→%d 应 −%d）〔句柄子容器批 V1〕〔营地图批 V4〕" % [bal_before, iso_c.meta_state.keystone_balance(), price])
@@ -99,7 +105,8 @@ func _ready() -> void:
 				if String(card.node_id) == "att_socket1":
 					socket_btn = card.btn
 			if socket_btn != null:
-				socket_btn.pressed.emit()
+				await ProbeUiUtil.scroll_button_into_view(main, main.ui.modals.camp.tree, socket_btn)
+				ProbeUiUtil.push_click(main, socket_btn)   # 真点解锁（点亮同调位前置）
 				await get_tree().process_frame
 				main.ui.modals.camp.tree.refresh_camp(main._camp_data())
 				await get_tree().process_frame
@@ -110,7 +117,8 @@ func _ready() -> void:
 			if fork_btn == null:
 				_problems.append("Fork 解锁钮缺失（点击路径）〔句柄子容器批 V1〕")
 			else:
-				fork_btn.pressed.emit()
+				await ProbeUiUtil.scroll_button_into_view(main, main.ui.modals.camp.tree, fork_btn)   # fork 行在折叠区（rect 越窗底栏——实证误中「返回营地」钮）
+				ProbeUiUtil.push_click(main, fork_btn)   # 真点解锁（展开 a/b 双态钮）
 				await get_tree().process_frame
 				main.ui.modals.camp.tree.refresh_camp(main._camp_data())
 				await get_tree().process_frame
@@ -121,7 +129,8 @@ func _ready() -> void:
 				if side_b == null:
 					_problems.append("Fork 双态切换钮缺失（解锁后应展开 a/b 钮）〔句柄子容器批 V1〕")
 				else:
-					side_b.pressed.emit()   # 合成切态点击 → _on_camp_fork_toggle → meta.tree_toggle_fork
+					await ProbeUiUtil.scroll_button_into_view(main, main.ui.modals.camp.tree, side_b)
+					ProbeUiUtil.push_click(main, side_b)   # 真点切态 → _on_camp_fork_toggle → meta.tree_toggle_fork
 					await get_tree().process_frame
 					var iso_fk = load("res://core/save_manager.gd").new("user://smoke_click_probe_camp_slot_1.json")
 					iso_fk.load_from_disk()
@@ -130,9 +139,15 @@ func _ready() -> void:
 			# ---- 营地灰字取色断言（迭代36 wc4——四子界面拆分后按视图分扫；卡④ T5 迁移）：
 			# 图鉴锁文→codex 视图（锚随形态订正去『柜台』）；秘宝行未解锁/同调形态/档位/刷新行→treasure 视图
 			# _workshop_holder 子树。font_color 逐处 == STONE_DEEP；树链段已闭树界面。
-			main.ui.modals.camp.tree.closed.emit()   # 树界面返回（关层归 presenter 单口）
+			var tree_back: Button = ProbeUiUtil.find_button(main.ui.modals.camp.tree, "返回营地")
+			if tree_back == null:
+				_problems.append("树界面「返回营地」钮缺失（真输入化驱动中断）〔句柄子容器批 V1〕")
+			else:
+				ProbeUiUtil.push_click(main, tree_back)   # 真点返回（关层归 presenter 单口——closed 同源钮）
 			await get_tree().process_frame
-			main.ui.modals.camp.scene.object_pressed.emit(&"chest")   # 宝箱→秘宝匣（灰字四源位宿主）
+			if main.ui.modals.camp.tree.visible:
+				_problems.append("树窗「返回营地」真点击后未隐窗（真输入化补钉——落点判定）〔句柄子容器批 V1〕")
+			ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"chest").get_center())   # 宝箱→秘宝匣（灰字四源位宿主）
 			await get_tree().process_frame
 			var ws_labels: Array = []
 			_collect_labels_by_text(main.ui.modals.camp.treasure._workshop_holder, ws_labels)
@@ -169,9 +184,13 @@ func _ready() -> void:
 						_problems.append("营地灰字：刷新行未用 STONE_DEEP（wc4 :525）〔句柄子容器批 V1〕")
 			if not refresh_inked:
 				_problems.append("营地灰字：刷新行 label 未找到（wc4 定位锚失守）〔句柄子容器批 V1〕")
-			main.ui.modals.camp.treasure.closed.emit()
+			var treasure_back: Button = ProbeUiUtil.find_button(main.ui.modals.camp.treasure, "返回营地")
+			if treasure_back == null:
+				_problems.append("秘宝匣「返回营地」钮缺失（真输入化驱动中断）〔句柄子容器批 V1〕")
+			else:
+				ProbeUiUtil.push_click(main, treasure_back)   # 真点返回（closed 同源钮）
 			await get_tree().process_frame
-			main.ui.modals.camp.scene.object_pressed.emit(&"board")   # 布告板→图鉴占位（锁文宿主）
+			ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"board").get_center())   # 布告板→图鉴占位（锁文宿主）
 			await get_tree().process_frame
 			var codex_labels: Array = []
 			_collect_labels_by_text(main.ui.modals.camp.codex, codex_labels)
@@ -181,7 +200,11 @@ func _ready() -> void:
 			for l in atlas_locks:
 				if l.get_theme_color("font_color") != UiKit.STONE_DEEP:
 					_problems.append("营地灰字：图鉴锁文未用 STONE_DEEP（wc4 :167）〔句柄子容器批 V1〕〔营地图批 V6〕")
-			main.ui.modals.camp.codex.closed.emit()
+			var codex_back: Button = ProbeUiUtil.find_button(main.ui.modals.camp.codex, "返回营地")
+			if codex_back == null:
+				_problems.append("图鉴「返回营地」钮缺失（真输入化驱动中断）〔句柄子容器批 V1〕")
+			else:
+				ProbeUiUtil.push_click(main, codex_back)   # 真点返回（closed 同源钮）
 			await get_tree().process_frame
 		main._on_camp_closed()   # 关层收闭（营地与选档层同收＋开始层恢复——卡④ T3）
 		await get_tree().process_frame
@@ -213,7 +236,7 @@ func _ready() -> void:
 		_problems.append("[savesel] 槽1 新档钮缺失（sl5/sl12 驱动中断）")
 	else:
 		var samples: Array = []
-		new_btn.pressed.emit()   # 真实按钮信号路径 → _on_save_select_new → create_slot+open_camp
+		ProbeUiUtil.push_click(main, new_btn)   # 真点「新档」→ _on_save_select_new → create_slot+open_camp
 		for fi in 3:
 			await get_tree().process_frame
 			samples.append([main.ui.modals.menu.save_select_overlay.visible, main.ui.modals.camp.scene.visible, main.ui.screens.start_overlay.visible])
@@ -239,7 +262,7 @@ func _ready() -> void:
 	if load_btn == null:
 		_problems.append("[savesel] 槽2 进档钮缺失（sl6 驱动中断——夹具应有档）")
 	else:
-		load_btn.pressed.emit()
+		ProbeUiUtil.push_click(main, load_btn)   # 真点「进档」→ 激活槽2 开营地
 		await get_tree().process_frame
 		if main.save_manager.slots.active_slot() != 2:
 			_problems.append("[savesel] sl6 进档链失守（active=%d 应=2——激活该槽）" % main.save_manager.slots.active_slot())
@@ -254,7 +277,7 @@ func _ready() -> void:
 	if del_btn == null:
 		_problems.append("[savesel] 槽2 删档钮缺失（sl7 驱动中断）")
 	else:
-		del_btn.pressed.emit()
+		ProbeUiUtil.push_click(main, del_btn)   # 真点「删档」一击只开窗
 		await get_tree().process_frame
 		if not main.ui.modals.menu.confirm_dialog.is_open():
 			_problems.append("[savesel] sl7 一击未只开确认窗（直删形态）")
@@ -265,7 +288,7 @@ func _ready() -> void:
 				_problems.append("[savesel] sl7 确认窗未经模态栈开（直开旁路——wr2 单口失守）")
 			elif not main.ui.flow.locks_input():
 				_problems.append("[savesel] sl7 确认窗开时输入锁未生效（锁域失守——wr2）")
-			main.ui.modals.menu.confirm_dialog.cancelled.emit()   # 取消路径（真实信号——cancelled 钮同源）
+			ProbeUiUtil.push_click(main, main.ui.modals.menu.confirm_dialog._cancel_btn)   # 真点「取消」（cancelled 钮同源）
 			await get_tree().process_frame
 			if main.ui.modals.menu.confirm_dialog.is_open() or not FileAccess.file_exists(csel_tpl % 2):
 				_problems.append("[savesel] sl7 取消路径失守（应只关窗、文件仍在）")
@@ -273,9 +296,9 @@ func _ready() -> void:
 				_problems.append("[savesel] sl8 取消后消费方状态量未清（分派面残留）")
 			if main.ui.flow.stack._occluded.has(main.ui.modals.menu.confirm_dialog):
 				_problems.append("[savesel] sl7 取消后确认窗遮挡账未清（关侧未走模态栈——wr2）")
-			del_btn.pressed.emit()   # 再开窗走确认路径
+			ProbeUiUtil.push_click(main, del_btn)   # 真点再开窗走确认路径
 			await get_tree().process_frame
-			main.ui.modals.menu.confirm_dialog.confirmed.emit()   # 确认路径（真实信号——confirmed 钮同源）
+			ProbeUiUtil.push_click(main, main.ui.modals.menu.confirm_dialog._confirm_btn)   # 真点「确认」（confirmed 钮同源）
 			await get_tree().process_frame
 			if FileAccess.file_exists(csel_tpl % 2) or main.ui.modals.menu.confirm_dialog.is_open():
 				_problems.append("[savesel] sl7 确认路径失守（应删档+关窗）")
@@ -343,7 +366,7 @@ func _ready() -> void:
 		if settings_close == null:
 			_problems.append("设置面返回按钮缺失")
 		else:
-			settings_close.pressed.emit()
+			ProbeUiUtil.push_click(main, settings_close)   # 真点「返回」收设置面
 			await get_tree().process_frame
 		if main.ui.modals.menu.settings_overlay.visible or not main.ui.screens.start_overlay.visible:
 			_problems.append("设置面关闭后未恢复开始层")
@@ -377,7 +400,7 @@ func _ready() -> void:
 		if career_close == null:
 			_problems.append("生涯页返回按钮缺失")
 		else:
-			career_close.pressed.emit()
+			ProbeUiUtil.push_click(main, career_close)   # 真点「返回」收生涯页
 			await get_tree().process_frame
 			if main.ui.modals.menu.career_overlay.visible or not main.ui.screens.start_overlay.visible:
 				_problems.append("生涯页关闭后未恢复开始层")
@@ -463,7 +486,11 @@ func _ready() -> void:
 			# 分派链序：商店层=选路页上的模态覆盖（停点呈现为
 			# level_screen+shop 双 visible）——必须先于 level_screen 分派，否则下层候选点击
 			# 空转烧尽预算（实证：lv2 商店停点双 visible 循环 12000 帧 done=false）。
-			main.ui.modals.menu.shop_overlay.leave_pressed.emit()
+			var shop_leave: Button = ProbeUiUtil.find_button(main.ui.modals.menu.shop_overlay, "离开商店")
+			if shop_leave == null:
+				_problems.append("商店「离开商店」钮缺失（真输入化驱动中断）")
+			else:
+				ProbeUiUtil.push_click(main, shop_leave)   # 真点离店（leave_pressed 同源钮）放行选路
 			_seals_placed.clear()
 			continue
 		if main.ui.modals.run.level_screen.visible:
@@ -476,12 +503,13 @@ func _ready() -> void:
 				if mpb == null or not mpb.visible or mpb.disabled:
 					_problems.append("地图屏状态角标缺失/未点亮/被置灰（P1 丁）")
 				else:
-					mpb.pressed.emit()
+					ProbeUiUtil.push_click(main, mpb)   # 真点地图屏角标开状态面板
 					if not main.ui.modals.run.status_panel.visible or not main.ui.modals.run.level_screen.visible:
 						_problems.append("地图屏角标开状态面板失败或地图屏被误藏（P2 甲层级失守）")
+					await get_tree().process_frame   # 面板当帧开——容器排版帧后钮 rect 才有效（真点击依赖排版）
 					var rbtn2: Button = ProbeUiUtil.find_button(main.ui.modals.run.status_panel, "继续", "prefix")
 					if rbtn2 != null:
-						rbtn2.pressed.emit()
+						ProbeUiUtil.push_click(main, rbtn2)   # 真点「继续」关面板
 					if main.ui.modals.run.status_panel.visible or not main.ui.modals.run.level_screen.visible:
 						_problems.append("状态面板关闭后地图屏态失守（恢复语义破）")
 			# 地图屏加成帽换代断言（迭代36 卡A wa2——「特性」→「属性值提升」；帽 Label 常在树；
@@ -519,7 +547,8 @@ func _ready() -> void:
 				if next_btn == null:
 					_problems.append("大奖励屏确认按钮缺失")
 				else:
-					next_btn.pressed.emit()
+					await get_tree().process_frame   # 停点层当帧开——排版帧后真点击
+					ProbeUiUtil.push_click(main, next_btn)   # 真点「进入下一层」推进 L2（落点判定见下）
 					await get_tree().process_frame
 					await get_tree().process_frame
 					if main.run_scope.runner == null or int(main.run_scope.runner.level_row.get("level_index", -1)) != 2:
@@ -540,7 +569,7 @@ func _ready() -> void:
 			if main.ui.modals.run.end_overlay.verdict_text() == "":
 				_problems.append("胜利结算框判定行缺失")
 			_settlement_confirms += 1
-			main.ui.modals.run.end_overlay._btn.pressed.emit()   # 「下一节点」真实信号路径
+			ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)   # 真点「下一节点」（结算框已过帧排版）
 			await get_tree().process_frame
 			await get_tree().process_frame
 			if main.run_scope.settlement_stop_timer.is_armed() or not main.ui.modals.run.level_screen.visible:
@@ -555,7 +584,7 @@ func _ready() -> void:
 			# （_adventure_mode）在真终局仍 true——会把真终局当中途面点掉返回键（实证）。
 			var _adv_running: bool = main.run_scope.adventure != null and String(main.run_scope.adventure.state) == "running"
 			if main.run_scope.is_adventure and _adv_running:
-				main.ui.modals.run.end_overlay._btn.pressed.emit()
+				ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)   # 中途结算面真点「继续」推进
 				continue
 			if not main.ui.flow.locks_input():
 				_problems.append("终局 overlay 打开时输入未锁定")
@@ -612,7 +641,7 @@ func _ready() -> void:
 			if main.ui.modals.run.end_overlay.is_open():
 				# 中途结算面（state=running）=点继续推进；真终局（settling）=断点段前提满足，收口。
 				if main.run_scope.is_adventure and main.run_scope.adventure != null and String(main.run_scope.adventure.state) == "running":
-					main.ui.modals.run.end_overlay._btn.pressed.emit()
+					ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)   # 中途结算面真点「继续」推进
 				else:
 					break
 			elif main.ui.modals.run.curio_overlay.visible:
@@ -626,18 +655,20 @@ func _ready() -> void:
 			elif main.ui.modals.run.node_overlay.visible:
 				main.ui.modals.run.node_overlay.press_continue()
 			elif main.ui.modals.menu.shop_overlay.visible:
-				main.ui.modals.menu.shop_overlay.leave_pressed.emit()
+				var shop_leave2: Button = ProbeUiUtil.find_button(main.ui.modals.menu.shop_overlay, "离开商店")
+				if shop_leave2 != null:
+					ProbeUiUtil.push_click(main, shop_leave2)   # 真点离店（收口段同主循环分派）
 			elif main.ui.screens.inter_overlay.visible:
 				var next_btn2: Button = ProbeUiUtil.find_button(main.ui.screens.inter_overlay, "进入下一层", "prefix")
 				if next_btn2 != null:
-					next_btn2.pressed.emit()
+					ProbeUiUtil.push_click(main, next_btn2)   # 真点「进入下一层」（收口段）
 			elif main.ui.modals.run.level_screen.visible:
 				var abandon_btn: Button = ProbeUiUtil.find_button(main.ui.modals.run.level_screen, "放弃", "prefix")
 				if abandon_btn != null:
 					_closed_via_abandon = true
-					abandon_btn.pressed.emit()
+					ProbeUiUtil.push_click(main, abandon_btn)   # 真点「放弃」一击
 					await get_tree().process_frame
-					abandon_btn.pressed.emit()   # 二击确认（3s 窗内）
+					ProbeUiUtil.push_click(main, abandon_btn)   # 真点二击确认（3s 窗内）
 					for i in 10:
 						await get_tree().process_frame
 					break
@@ -665,7 +696,7 @@ func _ready() -> void:
 	if main.ui.modals.run.end_overlay._btn == null:
 		_problems.append("断点段：终局面返回按钮缺失")
 	else:
-		main.ui.modals.run.end_overlay._btn.pressed.emit()   # 真实按钮信号路径（_btn=继续/返回共用句柄）
+		ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)   # 真点「返回」（_btn=继续/返回共用句柄）
 		await get_tree().process_frame
 		if not main.ui.screens.start_overlay.visible:
 			# 豁免：放弃路径收口时终局「返回」后仍挂三选一/关卡推进残留态（停点链），
@@ -693,7 +724,7 @@ func _ready() -> void:
 		_problems.append("大门无断点：未确认即进冒险〔营地图批 V3〕")
 	if main.ui.modals.menu.confirm_dialog._secondary_btn.visible:
 		_problems.append("大门无断点：次钮应隐藏（两出口形态）〔营地图批 V3〕")
-	main.ui.modals.menu.confirm_dialog.cancelled.emit()
+	ProbeUiUtil.push_click(main, main.ui.modals.menu.confirm_dialog._cancel_btn)   # 真点「取消」（大门取消出口）
 	await get_tree().process_frame
 	if not main.ui.modals.camp.scene.visible or main.run_scope.is_adventure 			or main._camp_data()["balance"] != bal_gate:
 		_problems.append("大门取消：未无变更退回营地（写口零调用/营地根 visible 失守）〔营地图批 V3〕")
@@ -795,6 +826,7 @@ func _ready() -> void:
 		exit_code = 1
 	if not _problems.is_empty():
 		exit_code = 1
+	_recorder.dump_js()   # 收尾落盘（大门段/开场行段点击在循环退出后——落盘必须在 quit 前）
 	get_tree().quit(exit_code)
 
 
@@ -821,7 +853,7 @@ func _run_modal_probes_once() -> void:
 	# ① 图例模态（pattern 6）：打开 → 遮挡物隐藏 + 输入锁定；关闭 → 恢复
 	if not _tested_legend:
 		_tested_legend = true
-		main.ui.battle.board_zone.ap_bar._btn_legend.pressed.emit()
+		ProbeUiUtil.push_click(main, main.ui.battle.board_zone.ap_bar._btn_legend)   # 真点图例钮开层
 		if not main.ui.modals.run.legend_overlay.is_open():
 			_problems.append("图例打开失败")
 		if main.ui.modals.run.end_overlay.is_open() or main.ui.screens.start_overlay.visible:
@@ -851,7 +883,7 @@ func _run_modal_probes_once() -> void:
 			_problems.append("战斗屏状态角标缺失/未点亮/被置灰（P1 丁入口失守 visible=%s disabled=%s）"
 				% [str(pbtn != null and pbtn.visible), str(pbtn != null and pbtn.disabled)])
 		else:
-			pbtn.pressed.emit()   # 真实按钮信号路径 → 组合根 _on_status_badge_pressed
+			ProbeUiUtil.push_click(main, pbtn)   # 真点状态角标 → 组合根 _on_status_badge_pressed
 			if not main.ui.modals.run.status_panel.visible:
 				_problems.append("状态面板未随角标打开（组合根接线失守）")
 			if not main.ui.flow.locks_input():
@@ -903,30 +935,32 @@ func _run_modal_probes_once() -> void:
 			if resume_btn == null:
 				_problems.append("状态面板关闭钮缺失（「继续」）")
 			else:
-				resume_btn.pressed.emit()
+				await get_tree().process_frame   # 面板当帧开——排版帧后真点击
+				ProbeUiUtil.push_click(main, resume_btn)   # 真点「继续」关面板恢复
 				if main.ui.modals.run.status_panel.visible or main.ui.flow.locks_input():
 					_problems.append("状态面板关闭后未恢复（visible=%s locked=%s——R3 残留）"
 						% [str(main.ui.modals.run.status_panel.visible), str(main.ui.flow.locks_input())])
-			# P1 守卫：图例开着 → 两处入口角标置灰；置灰态点击被处理器兜住（探针 emit 绕过 disabled）
-			main.ui.battle.board_zone.ap_bar._btn_legend.pressed.emit()
+			# P1 守卫：图例开着 → 两处入口角标置灰；置灰态点击被处理器兜住
+			#（置灰态穿透判定保留 emit 直发——真输入到不了置灰钮，处理器级防线只能以〔接线断言〕钉住）
+			ProbeUiUtil.push_click(main, main.ui.battle.board_zone.ap_bar._btn_legend)   # 真点图例钮复开
 			if not main.ui.battle.board_zone.status_badge.disabled:
 				_problems.append("图例开着时战斗屏状态角标未置灰（P1 守卫失守）")
-			main.ui.battle.board_zone.status_badge.pressed.emit()
+			main.ui.battle.board_zone.status_badge.pressed.emit()   # 〔接线断言〕置灰态 emit 穿透——钉处理器兜底（真输入被 disabled 拦，测不到此层）
 			if main.ui.modals.run.status_panel.visible:
 				_problems.append("置灰态仍可开状态面板（守卫兜底失守）")
 			main.ui.modals.run.legend_overlay.close()
-	# ③ tooltip（状态效果槽悬停——来源+语义+剩余）：有槽可见时触发
+	# ③ tooltip（状态效果槽悬停——来源+语义+剩余）：有槽可见时触发（真输入 motion 进管线触发 entered/exited 沿）
 	if not _tested_tooltip:
 		var row = main.ui.battle.stage.hero_standee.slot_row   # 状态 tooltip 载体（B 区站桩）
 		for child in row.get_children():
 			if child is PanelContainer and child.visible and child.has_meta("eff"):
 				_tested_tooltip = true
-				child.mouse_entered.emit()
+				ProbeUiUtil.push_motion(main, (child as PanelContainer).get_global_rect().get_center())
 				if not row._tip.visible:
 					_problems.append("状态槽 tooltip 未显示")
 				elif not row._tip_label.text.contains("来源") or not row._tip_label.text.contains("剩余"):
 					_problems.append("状态槽 tooltip 缺来源/剩余（%s）" % row._tip_label.text.replace("\n", "|"))
-				child.mouse_exited.emit()
+				ProbeUiUtil.push_motion(main, Vector2(-40, -40))   # 移出一切控件（视口外沿触发 exited）
 				if row._tip.visible:
 					_problems.append("状态槽 tooltip 未随移出隐藏")
 				break
@@ -1027,8 +1061,8 @@ func _random_unknown_adjacent(minesweeper) -> Vector2i:
 
 
 func _click_stop() -> void:
-	# 停手走真实按钮信号路径（AP 条 → 组合根 settle_batch——排雷玩法 D1×6① 回归载体）
-	main.ui.battle.board_zone.ap_bar._btn_stop.pressed.emit()
+	# 停手走真实点击路径（AP 条「停手」钮 → 组合根 settle_batch——排雷玩法 D1×6① 回归载体）
+	ProbeUiUtil.push_click(main, main.ui.battle.board_zone.ap_bar._btn_stop)
 
 
 # ---- T1 D1：锁期/重放断言（每 run 一次，脚本化场景——演播期豁免的断言化承载） ----

game/sim/journey_player.gd

@@ -0,0 +1,587 @@
+# journey_player.gd — 全动线机器自玩驱动（C·发现环节去人化）
+# 是什么：headless 场景驱动件——实例化 main、隔离存档，按旅程段驱动全动线（开机→设置→存档三操作
+#   新档/删档/进档→营地功能窗逐窗开合→Esc 回退→大门开冒险→关卡推进→战斗→各停点→终局收束→回菜单），
+#   每屏到达记账＋段间异常上报，收尾落 JSONP 报告并入探针覆盖登记（真输入事件同源记账）。
+# 判据（契约 §5）：每个屏到达过＋段间零 fatal。
+# 异常上报三类（其余静默）：①诊断收集器 fatal 级（settlement battle_result=fatal_error／fatal 屏）
+#   ②段间超时（单段 >30s 未达预期停点；战斗段另设状态无变化挂死阈值）③屏状态与预期不符。
+#   RID 泄漏等已知日志噪音静默。
+# 归因字段：每条上报机器自填——段名／期望屏／实测屏／上一动作／通道标签（真实输入-按钮／
+#   真实输入-场景热点／真实输入-键盘／方法-地图命中口／方法-棋盘口）。原归因制度残骸=本结构内字段。
+# 误报收敛：误报指纹（类+段+归因摘要）落 .gates/coverage/journey_misfire_ledger.json——同一指纹
+#   第 2 次起自动登记静默（计数照记、不再进上报清单）；连 3 批零真缺陷判据收紧归用户复核轮。
+# 驱动纪律：按钮/场景物件全走真输入（push_input 管线，同探针判据——ProbeUiUtil 单点通道）。
+#   两处方法口如实标注通道：地图候选=press_candidate（自绘布局命中路径，探针族既定入口）；
+#   棋盘格=click_cell（BoardView 公共点击口，ui_input_probe 先例——棋盘管线面由该探针承载）。
+#   停点分发的视图内部读数（_continue_btn/_node_pending 等）沿用探针族直读受控例外（iter53 反哺点 9 同款在册）。
+# 运行：Godot_console.exe --headless --path . res://sim/journey_player.tscn
+extends Node
+
+const ProbeUiUtil := preload("res://probe/probe_ui_util.gd")
+const ProbeCoverageRecorder := preload("res://probe/probe_coverage_recorder.gd")
+const AutoPlayer := preload("res://sim/auto_player.gd")
+
+const SEGMENT_TIMEOUT_MS := 30000          # 段间超时判据（契约 §5——单段 30s 未达预期停点）
+const BATTLE_STALL_FRAMES := 90            # 战斗段状态无变化挂死阈值（演播期豁免同探针口径）
+const ADVENTURE_BUDGET_FRAMES := 60000     # 冒险段帧预算（全停点循环兜底）
+const MISFIRE_PATH := "res://tests/.gates/coverage/journey_misfire_ledger.json"
+const REPORT_PATH := "res://tests/.gates/coverage/journey_report.js"
+
+var main: Node
+var _recorder: RefCounted = null
+var _problems: Array = []                  # 异常上报（三类；指纹二次起静默不入此列）
+var _silent_count := 0                     # 误报静默笔数（回执可见）
+var _screens_seen: Dictionary = {}         # 屏到达记账（判据面）
+var _screen_trace: Array = []              # 屏到达变迁轨迹（诊断面——新屏首现时点＋上一动作）
+var _misfire: Dictionary = {}              # 指纹 → 次数（跨跑落盘）
+var _last_state := {}                      # 战斗段状态哈希（挂死检测）
+var _stall := 0
+var _last_action := "（无）"                # 归因初判：上一动作描述
+var _map_status_done := false              # 地图屏状态角标一次性
+var _legend_done := false                  # 图例开合一次性（每战斗面一次）
+var _status_done := false                  # 战斗屏状态面板一次性
+var _refresh_done := false                 # 刷新确认链一次性
+
+
+func _ready() -> void:
+	await get_tree().process_frame
+	main = load("res://presentation/main.tscn").instantiate()
+	add_child(main)
+	await get_tree().process_frame
+	await get_tree().process_frame
+	_load_misfire()
+	_recorder = ProbeCoverageRecorder.new()
+	_recorder.attach(main, "journey")
+	ProbeUiUtil.isolate_save(main, "journey_player", false, false, true)
+	main.save_manager.slots.attach_slot_template("user://journey_player_slot_%d.json")
+	for i in range(1, 4):   # 夹具清场——陈旧槽文件会翻有档态、新档钮缺席（open_camp_via_savesel 同款坑注）
+		for suf in ["", ".tmp", ".corrupt.bak"]:
+			var sp: String = main.save_manager.slots.slot_path(i) + suf
+			if FileAccess.file_exists(sp):
+				DirAccess.remove_absolute(sp)
+	main.ui.modals.menu.debug_overlay.set_sliders(400, 200)   # 高加成保 L1 可完成（探针先例——夹具注）
+	main.ui.modals.menu.debug_overlay.seed_edit.text = "42"
+
+	await _phase_expect("开机落菜单", ["菜单"])
+	await _phase_menu_settings()
+	await _phase_new_slot(1)
+	await _phase_camp_windows()
+	await _phase_camp_esc_return()
+	await _phase_new_and_delete(2)
+	await _phase_load_slot(1)
+	await _phase_gate_start()
+	await _phase_adventure()
+	await _phase_end_back_menu()
+
+	_recorder.dump_js()
+	_dump_report()
+	_save_misfire()
+	var fatal := _fatal_count()
+	if _problems.is_empty() and fatal == 0 and _screens_seen.has("菜单") and _screens_seen.has("终局"):
+		print("[journey] PASS — 全动线走查完成（屏到达 %d 类，异常上报 0，fatal 0，误报静默 %d）" % [
+			_screens_seen.size(), _silent_count])
+		get_tree().quit(0)
+		return
+	print("[journey] FAIL — 异常 %d（静默 %d）/ fatal %d / 屏到达 %d 类" % [
+		_problems.size(), _silent_count, fatal, _screens_seen.size()])
+	for p in _problems:
+		print("[journey]   - " + JSON.stringify(p, "  "))
+	get_tree().quit(1)
+
+
+# ---- 屏状态读取与记账 ----
+
+func _screen_state() -> Dictionary:
+	var st := {
+		"菜单": main.ui.screens.start_overlay != null and main.ui.screens.start_overlay.visible,
+		"选档": main.ui.modals.menu.save_select_overlay.visible,
+		"设置": main.ui.modals.menu.settings_overlay.visible,
+		"生涯": main.ui.modals.menu.career_overlay.visible,
+		"确认弹窗": main.ui.modals.menu.confirm_dialog.is_open(),
+		"营地": main.ui.modals.camp.scene.visible,
+		"锻造窗": main.ui.modals.camp.forge.visible,
+		"树窗": main.ui.modals.camp.tree.visible,
+		"秘宝窗": main.ui.modals.camp.treasure.visible,
+		"图鉴窗": main.ui.modals.camp.codex.visible,
+		"Esc浮窗": main.ui.modals.camp.esc_overlay.visible,
+		"冒险": main.run_scope != null and main.run_scope.is_adventure,
+		"关卡屏": main.ui.modals.run.level_screen != null and main.ui.modals.run.level_screen.visible,
+		"三选一": main.ui.modals.run.curio_overlay.visible,
+		"商店": main.ui.modals.menu.shop_overlay.visible,
+		"大奖励": main.ui.screens.inter_overlay != null and main.ui.screens.inter_overlay.visible,
+		"节点": main.ui.modals.run.node_overlay.visible,
+		"终局": main.ui.modals.run.end_overlay != null and main.ui.modals.run.end_overlay.is_open(),
+	}
+	var in_battle: bool = bool(st["冒险"]) and not bool(st["关卡屏"]) and not bool(st["终局"]) \
+		and main.run_scope != null and main.run_scope.settlement != null \
+		and String(main.run_scope.settlement.battle_result) == ""
+	st["战斗"] = in_battle
+	return st
+
+
+func _record_screens() -> void:
+	var st := _screen_state()
+	for k in st:
+		if bool(st[k]) and not _screens_seen.has(k):
+			_screens_seen[k] = true
+			_screen_trace.append({"t": Time.get_datetime_string_from_system(), "screen": k, "last_action": _last_action})
+	_check_exclusion(st)
+
+
+var _excl_reported: Dictionary = {}   # 屏互斥违约对（本跑一次性上报——跨跑由误报指纹静默）
+
+# 屏级互斥（探针同款判据对）：合法叠加仅「终局盖冒险」；违约＝③屏状态与预期不符
+func _check_exclusion(st: Dictionary) -> void:
+	var pairs := [["菜单", "营地"], ["菜单", "冒险"], ["营地", "冒险"], ["终局", "营地"], ["终局", "菜单"], ["菜单", "战斗"]]
+	for pair in pairs:
+		if bool(st.get(pair[0], false)) and bool(st.get(pair[1], false)):
+			var fk: String = str(pair[0]) + "×" + str(pair[1])
+			if not _excl_reported.has(fk):
+				_excl_reported[fk] = true
+				_report("screen_mismatch", "屏级互斥", "%s 与 %s 不应同场" % [pair[0], pair[1]])
+
+
+func _active_screens() -> Array:
+	var on: Array = []
+	var st := _screen_state()
+	for k in st:
+		if bool(st[k]):
+			on.append(k)
+	return on
+
+
+func _fatal_count() -> int:
+	var n := 0
+	if main.run_scope != null and main.run_scope.settlement != null \
+			and String(main.run_scope.settlement.battle_result) == "fatal_error":
+		n += 1
+	return n
+
+
+# ---- 异常上报（三类＋归因＋误报收敛） ----
+
+func _report(kind: String, seg: String, expect: String) -> void:
+	var finger_src := "%s|%s|%s|%s" % [kind, seg, expect, ",".join(_active_screens())]
+	var finger := str(finger_src.hash())
+	_misfire[finger] = int(_misfire.get(finger, 0)) + 1
+	if int(_misfire[finger]) >= 2:
+		_silent_count += 1   # 同一误报源第 2 次自动登记静默（契约 §5 收敛口径）
+		return
+	_problems.append({
+		"kind": kind, "segment": seg, "expect": expect,
+		"actual_screens": _active_screens(), "last_action": _last_action,
+		"fatal": _fatal_count(), "at": Time.get_datetime_string_from_system(),
+	})
+
+
+func _load_misfire() -> void:
+	if FileAccess.file_exists(MISFIRE_PATH):
+		var parsed: Variant = JSON.parse_string(FileAccess.get_file_as_string(MISFIRE_PATH))
+		if parsed is Dictionary:
+			_misfire = parsed
+
+
+func _save_misfire() -> void:
+	var f := FileAccess.open(MISFIRE_PATH, FileAccess.WRITE)
+	if f != null:
+		f.store_string(JSON.stringify(_misfire, "  "))
+		f.close()
+
+
+# ---- 段间等待（超时判据承载） ----
+
+func _frames(n: int = 2) -> void:
+	for _i in n:
+		await get_tree().process_frame
+		_record_screens()
+
+
+# 期望屏集合在超时内逐帧到达；到达即记账返回。超时＝异常②超时＋③屏状态不符双记（同源指纹静默收敛）。
+func _phase_expect(seg: String, expect_keys: Array) -> void:
+	_last_action = "等待段「%s」落点（期望 %s）" % [seg, ",".join(expect_keys)]
+	var t0 := Time.get_ticks_msec()
+	while Time.get_ticks_msec() - t0 < SEGMENT_TIMEOUT_MS:
+		await get_tree().process_frame
+		_record_screens()
+		var st := _screen_state()
+		var all_on := true
+		for k in expect_keys:
+			all_on = all_on and bool(st.get(k, false))
+		if all_on:
+			await _frames(2)   # 开层排版帧——当帧可见时容器未排，紧随的控件真点击会落空（探针件同款坑）
+			return
+	_report("timeout", seg, "屏 %s 应在场" % ",".join(expect_keys))
+	_report("screen_mismatch", seg, "屏 %s 应在场" % ",".join(expect_keys))
+	_save_misfire()
+
+
+# ---- 旅程段 ----
+
+func _phase_menu_settings() -> void:
+	# 设置开合（开始层真实入口——功能界面全覆盖义务）
+	var btn: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "设置", "prefix")
+	if btn == null:
+		_report("screen_mismatch", "设置入口", "开始层「设置」钮在场")
+		return
+	_last_action = "真点「设置」钮"
+	ProbeUiUtil.push_click(main, btn)
+	await _phase_expect("设置开", ["设置"])
+	var back: Button = ProbeUiUtil.find_button(main.ui.modals.menu.settings_overlay, "返回", "prefix")
+	if back != null:
+		_last_action = "真点设置「返回」钮"
+		ProbeUiUtil.push_click(main, back)
+	await _phase_expect("设置收", ["菜单"])
+
+
+func _phase_new_slot(slot: int) -> void:
+	# 开机→存档·新档（选档层真实入口：进入存档→槽位新档→落营地）
+	var esb: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "进入存档", "prefix")
+	if esb == null:
+		_report("screen_mismatch", "选档入口", "开始层「进入存档」钮在场")
+		return
+	_last_action = "真点「进入存档」钮"
+	ProbeUiUtil.push_click(main, esb)
+	await _phase_expect("选档层开", ["选档"])
+	var nb: Button = main.ui.modals.menu.save_select_overlay._new_btns.get(slot)
+	if nb == null:
+		_report("screen_mismatch", "新档槽%d" % slot, "槽%d 新档钮在场" % slot)
+		return
+	_last_action = "真点槽%d「新档」钮" % slot
+	ProbeUiUtil.push_click(main, nb)
+	await _phase_expect("新档落营地", ["营地"])
+
+
+func _phase_load_slot(slot: int) -> void:
+	var esb: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "进入存档", "prefix")
+	if esb == null:
+		_report("screen_mismatch", "选档入口", "开始层「进入存档」钮在场")
+		return
+	_last_action = "真点「进入存档」钮（进档链）"
+	ProbeUiUtil.push_click(main, esb)
+	await _phase_expect("选档层开", ["选档"])
+	var lb: Button = main.ui.modals.menu.save_select_overlay._load_btns.get(slot)
+	if lb == null:
+		_report("screen_mismatch", "进档槽%d" % slot, "槽%d 进档钮在场" % slot)
+		return
+	_last_action = "真点槽%d「进档」钮" % slot
+	ProbeUiUtil.push_click(main, lb)
+	await _phase_expect("进档落营地", ["营地"])
+
+
+func _phase_new_and_delete(slot: int) -> void:
+	# 新档→篝火回菜单→选档删档（二次确认双路径真点击）——存档三操作收口
+	await _phase_new_slot(slot)
+	var camp: Control = main.ui.modals.camp.scene
+	_last_action = "真点篝火热点（回退动线）"
+	ProbeUiUtil.push_click_at(main, camp.get_hotspot_rect(&"campfire").get_center())
+	await _phase_expect("篝火确认弹窗", ["确认弹窗"])
+	var ok: Button = main.ui.modals.menu.confirm_dialog._confirm_btn
+	if ok != null:
+		_last_action = "真点篝火确认「确认」钮"
+		ProbeUiUtil.push_click(main, ok)
+	await _phase_expect("回菜单", ["菜单"])
+	# 删档：进选档→槽位删档一击开窗→真点取消→再删→真点确认（文件三态走查归探针既有套件——C 只验到达）
+	var esb: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "进入存档", "prefix")
+	if esb != null:
+		_last_action = "真点「进入存档」钮（删档链）"
+		ProbeUiUtil.push_click(main, esb)
+		await _phase_expect("选档层开", ["选档"])
+		var db: Button = main.ui.modals.menu.save_select_overlay._delete_btns.get(slot)
+		if db != null:
+			_last_action = "真点槽%d「删档」钮一击" % slot
+			ProbeUiUtil.push_click(main, db)
+			await _phase_expect("删档确认窗", ["确认弹窗"])
+			var cc: Button = main.ui.modals.menu.confirm_dialog._cancel_btn
+			if cc != null:
+				_last_action = "真点删档「取消」钮"
+				ProbeUiUtil.push_click(main, cc)
+				await _frames(2)
+			_last_action = "真点槽%d「删档」钮二击" % slot
+			ProbeUiUtil.push_click(main, db)
+			await _phase_expect("删档确认窗", ["确认弹窗"])
+			var ok2: Button = main.ui.modals.menu.confirm_dialog._confirm_btn
+			if ok2 != null:
+				_last_action = "真点删档「确认」钮"
+				ProbeUiUtil.push_click(main, ok2)
+			await _frames(3)
+		var back: Button = ProbeUiUtil.find_button(main.ui.modals.menu.save_select_overlay, "返回", "prefix")
+		if back != null:
+			_last_action = "真点选档「返回」钮"
+			ProbeUiUtil.push_click(main, back)
+		await _phase_expect("选档收", ["菜单"])
+
+
+func _phase_camp_windows() -> void:
+	# 营地功能窗逐窗真点开合（锻造/秘宝/树/图鉴/生涯——campfire/gate 归动线段）
+	var views := {
+		&"forge": ["锻造窗", main.ui.modals.camp.forge],
+		&"chest": ["秘宝窗", main.ui.modals.camp.treasure],
+		&"dummy": ["树窗", main.ui.modals.camp.tree],
+		&"board": ["图鉴窗", main.ui.modals.camp.codex],
+		&"notebook": ["生涯", main.ui.modals.menu.career_overlay],
+	}
+	for key: StringName in [&"forge", &"chest", &"dummy", &"board", &"notebook"]:
+		var camp: Control = main.ui.modals.camp.scene
+		_last_action = "真点营地物件热点 %s" % String(key)
+		ProbeUiUtil.push_click_at(main, camp.get_hotspot_rect(key).get_center())
+		await _phase_expect("%s窗开" % String(key), [views[key][0]])
+		var back: Button = ProbeUiUtil.find_button(views[key][1], "返回营地")
+		if back == null:
+			back = ProbeUiUtil.find_button(views[key][1], "返回", "prefix")
+		if back != null:
+			_last_action = "真点 %s 窗返回钮" % String(key)
+			ProbeUiUtil.push_click(main, back)
+			await _frames(3)
+
+
+func _phase_camp_esc_return() -> void:
+	# 营地 Esc 浮窗→「返回主菜单」真点（回退动线＋浮窗功能面到达）
+	_push_esc()
+	await _phase_expect("Esc浮窗开", ["Esc浮窗"])
+	var rb: Button = main.ui.modals.camp.esc_overlay._return_btn
+	if rb != null:
+		_last_action = "真点浮窗「返回主菜单」钮"
+		ProbeUiUtil.push_click(main, rb)
+	await _phase_expect("浮窗回菜单", ["菜单"])
+
+
+func _phase_gate_start() -> void:
+	# 大门确认→开冒险（动线收口——确认后落点=冒险，非回菜单）
+	var camp: Control = main.ui.modals.camp.scene
+	_last_action = "真点大门热点"
+	ProbeUiUtil.push_click_at(main, camp.get_hotspot_rect(&"gate").get_center())
+	await _phase_expect("大门确认弹窗", ["确认弹窗"])
+	var ok: Button = main.ui.modals.menu.confirm_dialog._confirm_btn
+	if ok != null:
+		_last_action = "真点大门「确认」钮"
+		ProbeUiUtil.push_click(main, ok)
+	await _phase_expect("冒险发起", ["冒险"])
+	# 已知缺陷现场（发现环义务已尽）：大门开局后开始层滞留盖屏＝「开局被开始层盖住」
+	# （营地交互修复批承接中、合回前 master 在案）——开始层可见直入 locks_input 谓词，战斗全程锁死。
+	# C 上报后以夹具面隐藏开始层继续走查（通道=夹具修整，非真输入；缺陷本体不因此掩盖）。
+	await _frames(2)
+	if main.ui.screens.start_overlay != null and main.ui.screens.start_overlay.visible:
+		_report("screen_mismatch", "大门开局", "开始层滞留盖屏（已知缺陷——营地交互修复批承接中）")
+		_last_action = "夹具修整：隐藏滞留开始层以解锁战斗走查（缺陷已上报在案）"
+		main.ui.screens.start_overlay.visible = false
+		await _frames(2)
+
+
+func _phase_adventure() -> void:
+	# 关卡推进段：入口选路→战斗→各停点分发→真终局收口（帧预算兜底）
+	var budget := ADVENTURE_BUDGET_FRAMES
+	while budget > 0:
+		budget -= 1
+		await get_tree().process_frame
+		_record_screens()
+		var st := _screen_state()
+		if bool(st["节点"]):
+			_last_action = "节点层「继续」（方法-视图口）"
+			main.ui.modals.run.node_overlay.press_continue()
+			continue
+		if bool(st["三选一"]):
+			_drive_curio()
+			continue
+		if bool(st["商店"]):
+			var lv: Button = ProbeUiUtil.find_button(main.ui.modals.menu.shop_overlay, "离开商店")
+			if lv != null:
+				_last_action = "真点「离开商店」钮"
+				ProbeUiUtil.push_click(main, lv)
+			continue
+		if bool(st["大奖励"]):
+			var nb: Button = ProbeUiUtil.find_button(main.ui.screens.inter_overlay, "进入下一层", "prefix")
+			if nb != null:
+				_last_action = "真点大奖励「进入下一层」钮"
+				ProbeUiUtil.push_click(main, nb)
+				await _frames(2)
+			continue
+		if bool(st["关卡屏"]):
+			_drive_map_once()
+			continue
+		if bool(st["战斗"]):
+			await _drive_battle_once()
+			continue
+		var endo: Control = main.ui.modals.run.end_overlay
+		if endo != null and endo.is_open():
+			var armed: bool = main.run_scope.settlement_stop_timer.is_armed()
+			var running: bool = main.run_scope.is_adventure and main.run_scope.adventure != null \
+				and String(main.run_scope.adventure.state) == "running"
+			if armed or running:
+				_last_action = "真点结算面「继续/下一节点」钮"
+				ProbeUiUtil.push_click(main, main.ui.modals.run.end_overlay._btn)
+				await _frames(2)
+				continue
+			break   # 真终局（失败/放弃/打穿）——收口段交棒
+	if budget <= 0:
+		_last_action = "冒险段超时（诊断：%s）" % JSON.stringify({
+			"pacer_pending": main.ui.screens.row_pacer.pending_rows().size(),
+			"locked": main.ui.flow.locks_input(),
+			"battle_result": String(main.run_scope.settlement.battle_result) if main.run_scope.settlement != null else "?",
+			"level": int(main.run_scope.runner.level_row.get("level_index", -1)) if main.run_scope.runner != null else -1,
+			"round": int(main.run_scope.settlement.round_index) if main.run_scope.settlement != null else -1,
+			"ap": int(main.run_scope.settlement.action_economy.ap) if main.run_scope.settlement != null else -1,
+		})
+		_report("timeout", "冒险段", "帧预算耗尽未达真终局")
+		_save_misfire()
+
+
+func _drive_map_once() -> void:
+	# 地图屏：状态角标真点开合一次＋候选命中（方法-地图命中口——自绘布局路径，探针族同款入口）
+	if not _map_status_done and main.ui.modals.run.level_screen.status_badge != null \
+			and not main.ui.modals.run.level_screen.status_badge.disabled:
+		_map_status_done = true
+		var badge: Button = main.ui.modals.run.level_screen.status_badge
+		_last_action = "真点地图屏状态角标"
+		ProbeUiUtil.push_click(main, badge)
+		await _frames(3)   # 面板开层排版帧——同帧点「继续」会落空、输入锁滞留全战役（实证）
+		var resumed: Button = ProbeUiUtil.find_button(main.ui.modals.run.status_panel, "继续", "prefix")
+		if resumed != null and main.ui.modals.run.status_panel.visible:
+			ProbeUiUtil.push_click(main, resumed)
+	_last_action = "地图候选命中（方法-地图命中口）"
+	main.ui.modals.run.level_screen.press_candidate(0)
+
+
+func _drive_curio() -> void:
+	# 三选一停点：待选态点首件＋确认；兑付/已消费态点继续（方法-视图口——curio 停点既定驱动面）
+	var co: Control = main.ui.modals.run.curio_overlay
+	_last_action = "三选一停点分发（方法-视图口）"
+	if co._continue_btn.visible:
+		co.press_continue()
+	elif main.run_scope.adventure != null and not main.run_scope.adventure.stop()._node_pending.is_empty():
+		co.press_card(0)
+		co.press_confirm()
+	elif main.run_scope.adventure != null and not main.run_scope.adventure.stop()._pending.is_empty():
+		co.press_card(0)
+		co.press_confirm()
+	else:
+		co.press_continue()
+
+
+func _drive_battle_once() -> void:
+	# 战斗单步：挂死检测＋功能钮真点（图例/状态/刷新确认链/停手）＋棋盘挖格（方法-棋盘口）
+	var settlement = main.run_scope.settlement
+	var diag: Dictionary = settlement.diagnostic_snapshot()
+	var st := {
+		"round": diag.round, "phase": diag.action_economy.phase, "ap": diag.action_economy.ap,
+		"revealed": diag.minesweeper_revealed,
+	}
+	var pacer_idle: bool = main.ui.screens.row_pacer.pending_rows().is_empty()
+	if JSON.stringify(st) == JSON.stringify(_last_state) and pacer_idle \
+			and not main.ui.flow.locks_input():
+		_stall += 1
+		if _stall >= BATTLE_STALL_FRAMES:
+			_report("timeout", "战斗段", "状态无变化达 %d 帧" % BATTLE_STALL_FRAMES)
+			_stall = 0
+			_save_misfire()
+			_last_state = {}   # 重置基线防同帧连报
+	else:
+		_stall = 0
+	_last_state = st
+	if not pacer_idle or main.ui.flow.locks_input():
+		return
+	var ap_bar: Control = main.ui.battle.board_zone.ap_bar
+	# 功能钮真点（一次性——图例开合／状态面板开合／刷新确认链）
+	if not _legend_done:
+		_legend_done = true
+		_last_action = "真点图例钮"
+		ProbeUiUtil.push_click(main, ap_bar._btn_legend)
+		await _frames(2)
+		var lclose: Button = ProbeUiUtil.find_button(main.ui.modals.run.legend_overlay, "关闭")
+		if lclose != null and main.ui.modals.run.legend_overlay.is_open():
+			ProbeUiUtil.push_click(main, lclose)
+		await _frames(2)
+		return
+	if not _status_done and not main.ui.battle.board_zone.status_badge.disabled:
+		_status_done = true
+		_last_action = "真点战斗屏状态角标"
+		ProbeUiUtil.push_click(main, main.ui.battle.board_zone.status_badge)
+		await _frames(3)   # 面板开层排版帧（同地图屏实证坑）
+		var resumed: Button = ProbeUiUtil.find_button(main.ui.modals.run.status_panel, "继续", "prefix")
+		if resumed != null and main.ui.modals.run.status_panel.visible:
+			ProbeUiUtil.push_click(main, resumed)
+		await _frames(2)
+		return
+	if not _refresh_done and ap_bar.is_refresh_ready():
+		_refresh_done = true
+		_last_action = "真点「弃图刷新」钮＋确认链"
+		ProbeUiUtil.push_click(main, ap_bar._btn_refresh)
+		await _frames(2)
+		var cbtn: Button = ProbeUiUtil.find_button(ap_bar, "确认弃图")
+		if cbtn != null:
+			ProbeUiUtil.push_click(main, cbtn)
+		await _frames(2)
+		return
+	# 棋盘动作（方法-棋盘口——BoardView 公共点击口，ui_input_probe 先例；C 的按钮面全走真输入）
+	var minesweeper = settlement.minesweeper
+	var plan: Dictionary = AutoPlayer.choose_dig(minesweeper)
+	if plan.is_empty():
+		plan = AutoPlayer.gamble_pick(minesweeper)
+	if plan.is_empty():
+		_last_action = "真点「停手」钮（无计划）"
+		ProbeUiUtil.push_click(main, ap_bar._btn_stop)
+		await _frames(2)
+		return
+	_last_action = "棋盘挖格 %s（方法-棋盘口）" % str(plan.dig_cell)
+	if plan.hero_cell != minesweeper.hero_pos():
+		main.ui.battle.board_zone.board_view.click_cell(plan.hero_cell, MOUSE_BUTTON_LEFT)
+	main.ui.battle.board_zone.board_view.click_cell(plan.dig_cell, MOUSE_BUTTON_LEFT)
+	await _frames(1)
+
+
+func _phase_end_back_menu() -> void:
+	# 终局收束：真点「返回」→ 回菜单；结算框/中途面已在冒险段分发
+	var t0 := Time.get_ticks_msec()
+	while Time.get_ticks_msec() - t0 < SEGMENT_TIMEOUT_MS:
+		await get_tree().process_frame
+		_record_screens()
+		var endo: Control = main.ui.modals.run.end_overlay
+		if endo != null and endo.is_open() and not main.run_scope.settlement_stop_timer.is_armed():
+			break
+	if main.ui.modals.run.end_overlay == null or not main.ui.modals.run.end_overlay.is_open():
+		_report("timeout", "终局收束", "真终局面未在超时内到达")
+		_save_misfire()
+		return
+	var btn: Button = main.ui.modals.run.end_overlay._btn
+	if btn != null:
+		_last_action = "真点终局「返回」钮"
+		ProbeUiUtil.push_click(main, btn)
+	await _phase_expect("终局回菜单", ["菜单"])
+
+
+func _push_esc() -> void:
+	var ev := InputEventKey.new()
+	ev.keycode = KEY_ESCAPE
+	ev.physical_keycode = KEY_ESCAPE
+	ev.pressed = true
+	main.get_viewport().push_input(ev, true)   # 键盘真输入（通道=真实输入-键盘）
+
+
+# ---- 报告落盘（JSONP） ----
+
+func _dump_report() -> void:
+	var dir := DirAccess.open("res://")
+	if dir != null:
+		dir.make_dir_recursive("tests/.gates/coverage")
+	var payload := {
+		"meta": {
+			"generated_at": Time.get_datetime_string_from_system(),
+			"seed": OS.get_environment("PROBE_SEED"),
+			"screens_seen_total": _screens_seen.size(),
+			"anomalies_reported": _problems.size(),
+			"anomalies_silent": _silent_count,
+			"fatal_count": _fatal_count(),
+			"anomaly_classes": "fatal／timeout／screen_mismatch（其余静默；误报指纹二次起静默）",
+		},
+		"screens_seen": _screens_seen.keys(),
+		"screen_trace": _screen_trace,
+		"anomalies": _problems,
+	}
+	var f := FileAccess.open(REPORT_PATH, FileAccess.WRITE)
+	if f != null:
+		var js := "/* 全动线自玩报告——journey_player.gd 随跑覆写；误报核销归用户复核轮。 */\n"
+		js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+		js += "window.__QA_COVERAGE__.journey = %s;\n" % JSON.stringify(payload, "  ")
+		f.store_string(js)
+		f.close()
+	print("[journey] 报告已落盘 %s（屏到达 %d 类 / 上报 %d / 静默 %d）" % [
+		REPORT_PATH, _screens_seen.size(), _problems.size(), _silent_count])

game/sim/journey_player.tscn

@@ -0,0 +1,6 @@
+[gd_scene load_steps=2 format=3 uid="uid://cjourneyplayer1"]
+
+[ext_resource type="Script" path="res://sim/journey_player.gd" id="1"]
+
+[node name="JourneyPlayer" type="Node"]
+script = ExtResource("1")

game/tests/.gates/.gitignore

@@ -1,9 +1,11 @@
 # 本目录只入库 baseline.json（存量基线，需随代码走以保证各 worktree 判定口径一致）。
 # receipt.json 是每跑批覆写的当次回执、ci-status.json/ci-history.jsonl 是已退役的 CI 回执判定与流水账（判定只在远端，本机残留）、
-# ci.lock/ci.rerun 是跑批件锁与补跑标记、*.log 是跑批当场日志——均为中间产物，不入库。
+# ci.lock/ci.rerun 是跑批件锁与补跑标记、*.log 是跑批当场日志、coverage/ 是探针真输入覆盖登记
+#（JSONP 式 .js，每次探针运行自动覆写——观测产物非事实源，不入库）——均为中间产物，不入库。
 receipt.json
 ci-status.json
 ci-history.jsonl
 ci.lock
 ci.rerun
 *.log
+coverage/

game/tests/README.md

@@ -160,7 +160,7 @@ tests/
 | 四柜台拆解后五界面入口改挂与写口零回归 | 营地五界面 | 五界面意图信号 → `CampShopPresenter` → `MetaProgression.tree_buy()` 写口 | `forge_workbench_test.gd:_run`（承载类同迁断言十二项）；`ui_click_probe.gd:_ready`（写口链段） |
 | 营地篝火回主菜单与笔记本改挂动线 | 营地交互流 | 笔记本命中区 → `CareerOverlay.open()`；篝火命中区 → ConfirmDialog 二次确认 → 主菜单 | `ui_struct_probe.gd:_ready`（career 段）；`screen_flow_probe.gd:_ready`（篝火／开合段） |
 | 关卡画面视口跟随 | 关卡画面（选路枢纽） | 停点切换与兑付回图经真实屏流程；读面 `LevelMapViewport.viewport_center_canvas_pos()` | `level_map_viewport_probe.gd:_probe_follow_anchor`；`level_map_viewport_probe.gd:_probe_smooth_scroll_reduced_motion` |
-| 关卡画面视口平移 | 关卡画面（选路枢纽） | 合成拖拽沿与滚轮沿经 `push_input`（`ProbeUiUtil.push_drag_at()`／`push_wheel_at()`） | `level_map_viewport_probe.gd:_probe_drag_pan`；`level_map_viewport_probe.gd:_probe_wheel_pan`；`level_map_viewport_probe.gd:_probe_clamp_bounds`；`level_map_viewport_probe.gd:_probe_drag_no_submit` |
+| 关卡画面视口平移 | 关卡画面（选路枢纽） | 合成拖拽沿与滚轮沿经 `push_input`（`ProbeUiUtil.push_drag_at()`／`push_wheel_at()`） | `level_map_viewport_probe.gd:_probe_drag_pan`；`level_map_viewport_probe.gd:_probe_wheel_pan`；`level_map_viewport_probe.gd:_probe_clamp_bounds_and_columns`；`level_map_viewport_probe.gd:_probe_drag_no_submit` |
 | 关卡画面视口指引 | 关卡画面（选路枢纽） | 深图经 `LevelMapScreen.open_choices()` 真实停点 | `level_map_viewport_probe.gd:_probe_guidance_chrome` |
 | 营地图鉴占位挂起态与反参照结构纪律 | 营地场景视图 | 布告板命中区 → `CampSceneView._gui_input()`（object_pressed 信号） → 图鉴占位视图；营地根态场景树审计 | `ui_struct_probe.gd:_ready`（占位禁词／禁行段）；`ui_struct_probe.gd:_ready`（结构禁词段） |
 | 营地刷新单口与场景根 HUD 同步 | 营地刷新总线 | 写口尾 → `CampRefreshBus.refresh()` → 现开界面刷新＋场景根 HUD 刷新 | `ui_struct_probe.gd:_ready`（顶栏位段）；`ui_click_probe.gd:_ready`（写口尾刷新段） |

game/tests/golden/README.md

@@ -18,7 +18,7 @@
 
 ## 时效判定纪律
 
-基线冻结于 2026-09-30。**判定先于动作**：每代换代面（视觉/素材/布局改动）
+基线冻结于 2026-09-30；关卡视口两 Shot（lmap_entry/lmap_boss）冻结于 2026-11-05——两 Shot 面口径（只对拍入口停点与 Boss 节点）见上文现持清单行。**判定先于动作**：每代换代面（视觉/素材/布局改动）
 跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
 
 - **判有效**（changed 远低于 2% 阈值）：基线**留在位**，不得顺手重制；

game/tests/unit/data_config/forge_table_test.gd

@@ -212,9 +212,10 @@ func _test_negative_cases() -> void:
 # ---- V11：效果类型闭集零新增（满级特效本期不开新词）----
 # 实数订正（L2 在册）：卡片 F11「24 种」系设计文档事实快照，
 # 现行 31；本套件零扩签，钉现行数（将来任何加词即转红提示复核）。
+# 32→31：改写族清退批摘 spike（CI run 87 追绿——词表合法收窄的断言随动）。
 
 func _test_effect_kinds_closed() -> void:
-	Kit.check("效果引擎效果类型闭集 32 种（甲案词表退役——overflow/attack_segments 摘名）〔锻造工坊批 V11〕",
-		EffectEngineScript.EFFECT_KINDS.size() == 32)
+	Kit.check("效果引擎效果类型闭集 31 种（甲案词表退役 overflow/attack_segments＋改写族清退摘 spike）〔锻造工坊批 V11〕",
+		EffectEngineScript.EFFECT_KINDS.size() == 31)
 	Kit.check("效果引擎事件词表在册 21 种（charge_full 位摘名——蓄力层删键批）〔锻造工坊批 V11〕",
 		EffectEngineScript.EVENTS.size() == 21)

game/tests/unit/presentation/level_map_info_fog_test.gd

@@ -221,7 +221,10 @@ func _test_layout_cache(db) -> void:
 	await process_frame   # 换代图真实绘制路径重算（缓存随内容变失效重写）
 	var pc1: Dictionary = screen.layout_probe(chain)
 	var pc2: Dictionary = screen.layout_probe(chain)
+	# 第三判据原＝新旧图 id0 位置差——改前靠容器延迟收敛的 origin 中间态偶然成立（换图首探针
+	# 画布未及重排，origin≠0）；视口化批画布同帧收敛（canvas.size 恒=内容包络）后两图 origin
+	# 恒等、id0 同层同槽位置恒等，前提失义。等强换键＝重算字典键数恰为新图节点数（旧缓存
+	# 63 键，换代不重算必不成立），同一性判据（核心失效重算面）不动。
 	Kit.check("布局缓存换代：新图查询返回新实例非旧缓存（失效重算生效）〔levelmap批 V2〕",
-		not is_same(p1, pc1) and is_same(pc1, pc2)
-		and (pc1[chain[0]] as Vector2) != (p1[nodes[0]] as Vector2))
+		not is_same(p1, pc1) and is_same(pc1, pc2) and pc1.size() == chain.size())
 	screen.queue_free()

reports/QA-harness三批-缺陷与覆盖遗漏报告-2026-11-06.md

@@ -0,0 +1,62 @@
+# QA harness 三批——缺陷与覆盖遗漏报告（2026-11-06）
+
+> **接收方**：待办清单「QA harness 三批缺陷与覆盖遗漏收口」条目（P0）。
+> **来源**：合并 d3c85390（批 1 探针真输入化＋覆盖登记／批 2 覆盖总览面板＋本体枚举器／批 3 自动试玩扩展）三批实施过程的真实跑批读数。
+> **口径**：本报告只列**发现且未解决**的缺陷与测试遗漏（实施期已自修的环境/机制坑不在列，见 qa-harness 讨论文档 §10–§12）；明细可查出处逐条标注。
+
+## 一、产品缺陷（2 类）
+
+### A1 开局被开始层盖住（大门开局开始层滞留盖屏＋输入锁死）
+
+- **现象**：大门确认开局冒险后，开始层（start_overlay）滞留可见；它以栈内模态身份直入输入锁谓词（`game/presentation/modal_flow.gd:77` 的 `start_visible_get` 项），战斗全程 `locks_input()==true`，玩家无法操作。
+- **发现**：C 自动试玩首跑（journey_player）即机器复现——上报 2 条（同缺陷双指纹），归因字段在案（`game/tests/.gates/coverage/journey_report.js`）。
+- **现状**：**营地交互修复批已修未合**（camp-interact 分支 0977a548，main.gd 大门两出口补隐藏句）——该分支合回 master 后本缺陷即消，C 的对应上报自然消失。
+- **归属**：随 camp-interact 合回即消，无需新批。
+
+### A2 终局面板关闭路径引擎报错噪声
+
+- **现象**：`game/presentation/views/battle_end_overlay.gd:194` 的 `get_meta(&"celebrate_tw", null)` 在 meta 缺失时仍触发引擎 SCRIPT ERROR 打印（当前引擎版对显式 null 缺省值照样报错）；关闭动线功能不受影响，属持续输出的日志噪声。
+- **发现**：批 1 探针直跑日志在案（screen_flow_probe 终局段每次触发）。
+- **修法**（一行级，未实施）：改 `has_meta()` 前置判断。归属＝需求性工程条目（改游戏行为），走写卡通道。
+
+## 二、测试覆盖遗漏（6 类）
+
+### B1 停手钮（AP 条）零真输入覆盖
+
+- **现象**：两探针与 C 均未以真输入点过「停手」钮——emit 时代信号直发绕过 disabled 掩盖了驱动空洞；停手使能位＝alive∧digging 投影（`game/presentation/views/ap_bar_view.gd:147`、`hud_presenter.gd:92`）。
+- **登记处**：覆盖面板控件下钻（ui_click 探针 seen 91／命中 27 的缺口之一）；`probe_hits_ui_click.js` 零停手键。
+
+### B2 视图层测试方法面未真输入化
+
+- **现象**：弃图刷新确认链（press_refresh_for_probe／press_confirm_for_probe）、地图候选（press_candidate）、节点与三选一停点（press_continue／press_card／press_confirm）等驱动走视图方法口，非输入管线——保「逻辑通」不保「玩家点击可达」。
+- **登记处**：待办清单「测试面真输入化分期与存量断言逐条精锚」条目①余项；C 的两方法口在归因字段如实标注通道。
+
+### B3 存量 996 条断言判据出处精锚
+
+- **现象**：链式锚已保可核（capability_audit 链断 0），逐条出处粒度精锚未做。
+- **登记处**：同上条目②，原样在案。
+
+### B4 本体对账缺口 212 条／62 类
+
+- **现象**：游戏本体实体（data/tables 行集、schema 词表与字段、场景按钮、自绘命中类、屏模态清单，共 865 实体）在测试断言文料中零关联 212 条——「游戏做了但从未被验证」的候选面。
+- **诚实边界**：grep 关联有假阳假阴（断言测了实体但文本没带 id＝假缺口；文本带 id 但断言弱＝假覆盖）——**须人工逐条复核后再立事项**，禁直接照单开工。
+- **登记处**：覆盖面板第四节（`tools/coverage_report.html`）；`game/tests/.gates/coverage/ontology_gaps.js`。
+
+### B5 控件级零真输入命中缺口（ui_click 64 处／screen_flow 97 处）
+
+- **现象**：探针真输入登记的「存在但零命中」控件缺口——大头＝未被探针打开过的屏（完备性边界在案：控件级视图只对被打开过的屏负责），其中混有 B1 类真空洞。
+- **登记处**：覆盖面板第三节；`probe_hits_ui_click.js`／`probe_hits_screen_flow.js` 的 seen−hit 差集。
+
+### B6 C 判据收紧轮未做
+
+- **现象**：全三关推进约 8 分钟（冒险段帧预算 60000 兜底）；契约条款「连 3 批零真缺陷→判据收紧一轮」的触发权与执行归用户复核轮。
+- **登记处**：`journey_report.js` meta（上报数/静默数/fatal/屏到达进回执）＋qa-harness 讨论文档 §5。
+
+## 三、处置归属（汇总）
+
+| 组 | 项 | 通道 |
+|---|---|---|
+| 随合即消 | A1 | camp-interact 分支合回，无需新批 |
+| 写卡通道 | A2、B1、B2 | 需求性工程条目（改游戏行为/测试驱动）→ 需求卡片 |
+| 既有义务 | B3、B6 | 衔接条目②＋用户复核轮 |
+| 人工复核 | B4、B5 | 面板逐条复核后按性质分流（真缺口立事项／假缺口面板豁免清单核销） |

reports/iter53-反哺点-2026-11-05.md

@@ -1,21 +0,0 @@
-# 迭代 53 反哺点清单（2026-11-05）
-
-- 接收方：[待办清单](../待办清单.md)（反哺点裁决后由文档批/工程批写入并把本清单条目清掉）。
-- 依据：`reports/iter53-实现报告-2026-11-05.md`；两卡「关联文档同步面」逐条落点如下。
-
-| # | 落点（哪个文件哪一节） | 改成什么 | 依据 |
-|---|---|---|---|
-| 1 | `design/gdd/systems/跨局循环/锻造工坊.md` §满级特效扩展位——重甲反震候选条 | 实现前提句补一句：反弹伤害需新开消费点（本批摘 `spike` 词表位后彻底无位，候选=「需新代码」档） | 卡② §6 第 2 行；damage_controller.gd 摘除后 `open_ticket` reflect 通道为唯一反弹面且零现役表行 |
-| 2 | `design/gdd/systems/战斗循环/增益状态.md`／`伤害与护甲.md` | 零命中备案——两文档叙述「按序改写族」的句子未挂退役件名，无需改动 | 卡② §6 机械面核对读数（40 名扫描两文件零命中） |
-| 3 | `design/gdd/systems/冒险循环/奇物.md`、`systems/战斗循环/地图战斗资源.md`、`design/gdd/术语表.md`、`00-游戏概念.md`、`03-内容规模.md` | 各文仍提退役内容名的句子逐处换机制名（清退口径同卡② T3：只换名不换职责） | 卡② §5 去向表；40 名扫描命中所在（GDD 面不在本批可写域） |
-| 4 | 结算明细标签是否入表（文案硬编码 `reward_grant.gd:226`） | 规范裁决点：玩家可见明细文案归属——维持代码硬编码 or 入数据表行；裁决后改对应规范文档 | 卡② §5 去向表末条；本批已把标签换代为「挖掘惩罚减半（%d→%d）」 |
-| 5 | `tools/gate_platform.sh` `gate_run_timeout` | 修 Windows 恒 124 缺陷：`kf` 改「先赋路径、`rm -f` 后置守卫」（probe_gate.sh run_suite 同款正确写法）；连带修 `golden_baseline_refresh.sh` 的 guard 子Shell kill 短路（7 分钟等待症状） | iter53 实现报告「遗留读数义务与发现呈报」第 1 条；实证=直接调用 4 秒返回 124、refresh 两次 7m1s |
-| 6 | `game/tests/golden/mac/` | mac 侧补冻关卡视口两 Shot 基线（跑 `golden_baseline_refresh.sh --lmap`） | 渲染闸 lmap 段缺基线记 SKIP；windows 已冻结（6394abf7），mac 冻结后两平台同盯 |
-| 7 | `game/tests/golden/README.md` §时效判定纪律 | 「基线冻结于 2026-09-30」句补 lmap 两 Shot 冻结日（2026-11-05）与两 Shot 面口径指针 | 本批 golden/README 台账已改现持清单，冻结纪律节的时间句留待文档批随批换代 |
-| 8 | `game/tests/README.md` 能力行 :163（关卡画面视口平移） | 代表用例名 `_probe_clamp_bounds` 回表为落地名 `_probe_clamp_bounds_and_columns`（实现按卡 §8 对照表外的更 descriptive 名落地，回表归写卡段） | 验收审计 D1（建议级）：名实回表义务 |
-| 9 | 探针直读申报口径（test-conventions §8.2/§8.4 受控例外注记） | 「探针直读视口子件结构（`get_child(0)` 画布位、按名取指引子件 FadeL/FadeR/PanHint）」补进探针直读惯例的申报面注记 | 验收审计 D2（观察级）：直读有注释理由、零风险，补成文口径 |
-| 10 | `reports/iter53-实现报告-2026-11-05.md` 决定 3 | 已随本清单同批订正（case⑰→⑱ 笔误）——归档备查，无文档批动作 | 验收审计 D3 |
-
-## 零反哺备案
-
-- 卡① `design/gdd/ux/level-map.md`：实现未发现 spec 缺口——布局决策 5 行为四条＋像素级判据①–④＋AC 260–271 全部有绿读数承载（实现报告对照表 R1–R9＋golden 段）。

reports/iter53-实现报告-2026-11-05.md

@@ -1,80 +0,0 @@
-# 迭代 53 实现报告（2026-11-05）
-
-- 接收方：[待办清单](../待办清单.md)条目「超预算图策略升级路径——等比缩放与滚动视口两案待裁」（卡①卷轴视口批）＋「damage_controller 按序改写族——内容孤儿机制与退役名注释层」（卡②改写族清退批）。
-- 需求卡片：`reports/需求卡片-卷轴视口批-2026-11-05.md`（验收档：中）＋`reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md`（验收档：中）。
-- 独立验收审计：`reports/iter53-验收审计-2026-11-05.md`（未参与实现的会话执行；两卡均按中档深度）。
-- 执行形态：整迭代单工作区（`g-plan2-iter53`，两卡均未声明可并行），卡序＝卷轴视口 → 改写族清退。
-
-## 各卡状态
-
-| 卡 | 状态 | T 卡 | 凭据摘要 |
-|---|---|---|---|
-| 卡①卷轴视口批 | 完成（T0–T4 全收口＋golden 扩项冻结） | T0 基线读数在案／T1–T3 实现波提交 c1043902／T4 指针反转 4e87a012／golden 扩项 6394abf7 | 新探针 26 断言全绿＋探针族全绿＋冒烟 15/0＋S13 基线内 7 新增 0＋渲染闸全绿（lmap 双图 changed=0.00%） |
-| 卡②改写族清退批 | 完成（T0–T5 全收口） | T0 基线读数在案／T1 b5c21e3a／T2 1bd50304／T3+T4 并笔 ed793e8c | 三套件+四套窄测 exit=0＋对拍六组逐字节 diff=0＋四探针负域全拒＋契约 1 三条 grep 全零＋40 名注释面清零 |
-
-## 卡① 实际改动—验收对照表
-
-| 需求点 | 改动（文件:行） | 验收测试（落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 结果 |
-|---|---|---|---|---|---|---|
-| R1 浅图整幅居中无裁切 | level_map_screen.gd 三段页承载＋level_map_viewport.gd `_axis_center_offset` 居中分支 | `level_map_viewport_probe.gd:71/74/76`〔卷轴批 V1〕 | 探针 | `open_choices` 真实停点（L1 固定种子直构 runner） | 画布≤窗居中 offset 定位＋画布矩形 encloses 于视口 | 绿 |
-| R2 停点切换当前节点居中 x=640±2 | level_map_viewport.gd `reanchor`＋screen `_viewport_anchor`/open_choices 接线 | `level_map_viewport_probe.gd:221`〔卷轴批 V2〕 | 探针 | 断点停点重建＋真实 `open_choices` | 当前节点画布投影=视口中线±2 | 绿 |
-| R3 拖拽平移 | screen `_on_canvas_motion` 拖拽态逐帧 `pan_by`（含激活帧位移） | `level_map_viewport_probe.gd:137`〔卷轴批 V3〕 | 探针 | `push_drag_at` 合成沿走 `push_input` | 视线位移=拖拽位移（40px 逐位） | 绿 |
-| R4 滚轮横滚 | screen `_wheel_pan_step` 映射（下/右=前进向） | `level_map_viewport_probe.gd:114/116/120`〔卷轴批 V4〕 | 探针 | `push_wheel_at` 合成滚轮沿 | 单档 ±60 逐位＋窗内不钉边界 | 绿 |
-| R5 clamp 包络与首末列可达 | level_map_viewport.gd `_axis_pan_offset`/`is_clamped_at_edge` | `level_map_viewport_probe.gd:88/102/158/160/161/167/168`〔卷轴批 V5〕 | 探针 | 超包络拖拽沿两极 | 中线恒在夹紧域＋两极 edge=true＋首末列中心入屏＋入口组包围盒锚点 | 绿 |
-| R6 拖拽不触发选路 | screen `_on_canvas_click` 拖拽抬杆不提交 | `level_map_viewport_probe.gd:200/201/206`〔卷轴批 V6〕 | 探针 | 拖拽沿/完整点击沿起止候选上方 | `route_chosen` 零发射＋屏未关；完整点击仍提交=1 | 绿 |
-| R7 平滑滚动与减动效瞬切 | level_map_viewport.gd `reanchor(smooth)` tween `UiKit.motion(0.3)`＋`ArmedTimer.motion_still` 跳终态 | `level_map_viewport_probe.gd:245/249/258`〔卷轴批 V7〕 | 探针 | 可见屏停点切换＋`UiKit.motion_scale` 置位 | 平滑有 tween 中间帧（同向在途）＋减动效即达 | 绿 |
-| R8 指引件可见性与几何 | level_map_viewport.gd `_build_guidance`/`_sync_guidance` | `level_map_viewport_probe.gd:271–287`〔卷轴批 V8〕 | 探针 | 深图真实停点＋浅图复验 | 渐隐带 70px＋chip 240×30 居中可见；浅图隐藏 | 绿 |
-| R9 schema 头注指针反转（非行为） | level_gen_params.gd:3-4/:66 头注 | 静态判据：grep「调参表」残留=0、「参数契约节」指向=2；`--check-only` 零错 | 静态 | — | 全仓无「域并单点=调参表」残留 | 绿 |
-| golden 两 Shot 面（2026-11-05 用户裁） | level_map_shot_probe.gd＋golden/windows/lmap_entry·lmap_boss＋render_gate.sh 对拍段 | 渲染闸「关卡视口 golden 逐像素」段（changed=0.00% 双绿）；重采集确定性=0.00% | golden | 窗口化真实渲染＋固定种子 | 两 Shot 逐像素 ≤16 差/≤2% | 绿 |
-
-非行为改动行：无（R9 之外全部行为面；`.uid` 边车随新件入库）。
-
-## 卡② 实际改动—验收对照表
-
-| # | 需求点 | 改动（文件:行） | 验收测试（落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 结果 |
-|---|---|---|---|---|---|---|---|
-| R1 | 摘四段不可达改写分支 | damage_controller.gd（原 ：297-302/:305-309/:310-314/:316-323/:350-353/:367-372/:623 全摘＋spike_ready 键摘） | `damage_controller_test.gd`（exit=0）；`roll_multiplier_test.gd`（exit=0）；`round_flow_skill_pool_test.gd`（exit=0）；dump_battle 六组改前改后逐字节比对 diff=0 | 单元＋集成 | `BattleOrchestrator.begin_battle()` 全链 | step_row 流逐位=改前基线（L{1,2}×S{42,779401,779501}）；静态=契约 1 三条 grep 全零＋摘后 `spike_ready` 零残留。观测面局限申报：零现役注册行使分支不可达，禁注入表行取证（卡 §8 申报在案） | 绿 |
-| R2 | EFFECT_KINDS 摘 spike | effect_engine.gd:30 | `effect_kind_retired_test.gd:89`「effect_kind_retired_test/③词表闭面：kind=spike 出域拒绝」 | 单元（负面，独立进程） | `ConfigDB.load_tables()` → `validate_trigger_row` | do.kind=spike 行被拒＋error 诊断在案＋退出码 1（负面期望码） | 绿 |
-| R3 | DO_KEYS 摘 trade_hit/trade_atk | effect_engine.gd:82 | `effect_kind_retired_test.gd:92`「effect_kind_retired_test/④do 键闭面：trade_hit 出域拒绝」 | 单元（负面，独立进程） | 同上 | 带 trade_hit 键 do 字典被拒＋退出码 1 | 绿 |
-| R4 | 注释面退役名清零（13 文件） | T3 35 处注释改写（对照卡 3.3 表逐处） | 静态判据：40 名全扫仅剩卡 §5 留底 3 行（treasure_items_test:31/33/35 StubDB 夹具名）；宿主套件逐位不变（四套窄测 exit=0） | 静态（闸件扫描） | 宿主套件回归（改写面不进运行期） | 注释面命中 0＋套件绿 | 绿 |
-| R5 | 减半明细行去退役件名 | reward_grant.gd:226（标签→「挖掘惩罚减半（%d→%d）」＋effect_id→nest_halve） | `meta_progression_forge_test.gd:694/697/699/700`（断言串随动，非空＋等值＋不含旧词强度不降） | 集成（信号采集） | 锻造锋线满级特效 → begin_battle → mine_hit 减半路径 → step_row | display_name==「挖掘惩罚减半（6→3）」＋power 减半数值与发射次数逐字不变＋grep nest_counter=0 | 绿 |
-| R6 | 空集拒绝 reason 去退役件名 | reward_grant.gd:189（→「中立移除：…」） | 静态判据：grep 爆破工兵包 reward_grant.gd=0；`table_structure_guard_test.gd` exit=0 | 静态＋单元 | 通道校验面（零现役行不可达） | grep 零命中＋通道校验绿。观测面局限申报：reason 不可达，禁造行取证 | 绿 |
-| R7 | 反弹明细标签去退役件名 | grant_segment.gd:166（标签→「反弹伤害」＋归因串→attune_nest_halve；channel=="reflect" 判据与开单参数字典逐字不动） | 静态判据：grep 惊巢反制 game/=0、attune_nest_counter=0；`round_flow_skill_pool_test.gd` exit=0 | 静态＋集成 | mine_hit 订阅施加链（reflect 行族零表行，今天不可达） | grep 零命中＋发射面零变化回归。观测面局限申报：禁造行取证 | 绿 |
-| R8 | sim 恒 false 匹配删除 | level_autoplay.gd（原 ：415 注释＋:421 contains(雷区图谱) 条件删，highlight==seal_hit 单判据保留） | 静态判据：grep 雷区图谱 game/=0；sim 驱动链套件绿（四套窄测含 autoplay 消费面 exit=0） | 静态＋单元 | autoplay 驱动链（测量面） | grep 零命中＋套件绿。观测面局限申报：恒 false 条件不可达 | 绿 |
-
-非行为改动行：T3 注释面 35 处（由 R4 行覆盖）；契约 3 约束下 ：226/:166 仅标签与归因串文本变动、取值/位序/载荷键逐字未动（R1 对拍 diff=0 为其逐位证据）。
-
-## 读数义务对账（卡内 T 卡产出）
-
-- **卡①T0**：S13 基线无 `level_map_screen` 键（记「无键、按工具默认」）；ui_struct_probe PASS 全屏结构断言零红；screen_flow_probe PASS；冒烟 15 项 0 失败。
-- **卡①T4 复跑**：S13 基线内 7 条、新增 0（`_on_canvas_input` 重构触发的 max-branches 新违规已拆 `_on_canvas_motion`/`_on_canvas_click`/`_wheel_pan_step` 归零）；ui_struct_probe/screen_flow_probe 复跑绿（探针族全绿内含）。
-- **卡②T0**：契约 1 三条 grep——`game/data/tables/` 内 spike/armor_rewrite/discount_shift/trade_hit/trade_atk 全零（对照记录=feats.tres:855 clamp_bonus 现役一行）；tree_rules 面零；effect_kinds 面 cell_removal 表面零（仅 schema 在册：treasure_item_table.gd:20/:26，本批不摘通道）。S13 四文件无登记键（damage_controller/effect_engine/reward_grant/level_autoplay 均按工具默认）。改前对拍基线六组落盘（L{1,2}×S{42,779401,779501}）。改前断言串=「惊巢反制——危险格挖掘惩罚减半（6→3）」（:693/:698-701 现行文本抄录在案）。
-- **卡②T5**：改后对拍六组 diff=0；40 名全扫终读数=3 行留底夹具；R5–R8 静态 grep 全零；负域套件 exit=1（期望码）四探针全拒。
-- **存量触面 S13 对照**：damage_controller（分支数/函数长度随摘除下降，无新增键）；effect_engine（常量字面量变短，方法数/成员数不变）；reward_grant/level_autoplay（删文本与恒 false 条件）——S13 终读数=基线内 7、新增 0、恶化 0。
-
-## 实机目检总清单（登记不阻塞）
-
-| 目检项 | 来源卡 | 承载 |
-|---|---|---|
-| 深度 13+ 图拖拽可达首末列、推进跟随方向感、chip 不碍选路 | 卡① | 窗口化实跑截图已冻结（golden/windows/lmap_entry·lmap_boss）；真人试玩复核登记体验验证清单（归批后收尾） |
-| 结算明细行减半标签「挖掘惩罚减半（6→3）」一眼可读、无退役件名突兀感 | 卡② | 实现报告登记；真人目检归体验验证清单（归批后收尾） |
-
-## 实现决定记录（超白名单／超卡片明列面逐条备案）
-
-1. **拖拽态成员落屏侧**（卡①§11 把 `_drag_active`/`_drag_accum` 枚举进视口件成员，§6 职责边界却写明视口件「只管裁切/offset/clamp/跟随」、拖拽判定留画布）——取 §6 职责边界优先：拖拽判定状态随输入处理落 screen（`_drag_active`/`_drag_press_pos`），视口件成员 6 个（≤8 达标）、公开方法 5 个（≤20 达标）。撤销方式=成员迁视口件＋canvas 经方法驱动（纯结构搬移）。
-2. **open_choices 平滑判据＝有无当前节点**（卡①§6 写「reanchor(false) 首锚」、T2 写「停点切换/回图接 reanchor(true)」，open_choices 同时承载两路径）——合并读法：入口停点（current_node_id<0）即达＝首锚，其余停点/兑付回图平滑＝跟随。R2/R7 断言均经此路径。
-3. **提交沿移至抬杆**（原提交在按下沿；布局决策 5 阈值区分语义下按下时无法预知是否成拖拽，R6 要求拖拽沿零发射）——完整点击（按下→未超阈值抬杆）提交、拖拽抬杆不提交；ui_input_probe case⑫/⑱ 补 release 沿适配（验收审计 D3 订正：原呈报误写⑰，实际落点两处）（判据语义「图上真实点击提交选路」不变，输入形态更完整）。
-4. **滚轮步进 60px、渐隐带色 BG_ROOT 不透明端 0.9、chip 底 HP_BAR_BACK/描边 STONE/文字 WARM、缓动 TRANS_CUBIC+EASE_OUT**——卡 §12 白名单 4/5/3 授权面内定值。
-5. **视口件 NOTIFICATION_RESIZED 即席重锚**——首开布局晚于 open_choices 锚定（隐藏子树容器排序首可见帧才传播，4.7 行为；实证=探针首跑 y 锚偏 88px），resize 即席 `reanchor(false)` 收敛；同时是窗口尺寸变化的正确行为。
-6. **_fit_canvas 画布尺寸同帧收敛**（`canvas.size = _content_size` 显式置）——视口锚点数学与 `_layout` 同源读画布尺寸，容器延迟收敛不等锚点。
-7. **mouse_exited 清拖距跟踪器**——按下即武装的跟踪器在丢失 release 沿（alt-tab 等）后残留会把后续 motion 误判为拖拽激活（ui_input_probe case⑰⑧ press-only 实证）；非拖拽态离画布即解除。
-8. **卡②探针①注入 do.kind="spike"**（卡 T2 括注 kind=modify_ticket+mode=spike 形态）——括注形态无拒绝通道（`validate_trigger_row` 无 mode 值域检查，mode 属载荷字段非词表），按断言名「词表闭面：kind=spike 出域拒绝」与 R2 判据绑定面（effect_kinds 出域文案）的机制注入 kind 形态。
-9. **golden 两 Shot 面口径**（卡①现状事实写「本批不触渲染闸对拍」、批纪律 iter 4.4＋test-conventions §8.2 要求扩项）——呈裁用户，2026-11-05 裁「只处理最初始的和最终的：关卡最开始＋关卡 Boss 节点，中间过程不对拍」，按两 Shot 面扩项冻结。
-10. **卡② T3 与 T4 并笔提交**——卡 §10 白名单授权面。
-
-## 遗留读数义务与发现呈报
-
-1. **闸件缺陷呈报（工程批）**：`tools/gate_platform.sh` 的 `gate_run_timeout` 用 `mktemp` 造超时标志文件——mktemp 即建文件，末尾 `[ -f "$kf" ]` 在 Windows（Git Bash）恒真→**恒返回 124**。被各闸「判定锚工件而非退出码」口径掩住（菜单/棋盘 golden 段与本批 lmap 段均工件锚定，不受影响）；`tools/golden_baseline_refresh.sh` 的 7 分钟等待症状（guard 子Shell `sleep 420` 未被 kill 短路）同根。修法＝改 `kf="$TMP/..." ; rm -f "$kf"`（run_suite 同款，probe_gate.sh 已是正确写法）。本批不代修（闸件改动归工程批）。
-2. **mac 端关卡视口基线冻结义务**：`golden/mac/` 缺 lmap_entry/lmap_boss——渲染闸缺基线记 SKIP 不判红（windows 已锚即盯），mac 冻结归 mac 侧跑 `golden_baseline_refresh.sh --lmap`。
-3. **效果通道与事件词的零现役普查**——已在待办清单在册（卡② §5 去向），本批不扩。
-4. 卡① level-map.md 同步面：实现未发现 spec 缺口（布局决策 5 行为四条＋像素级判据＋AC 全部有绿读数承载），零反哺。

reports/iter53-验收审计-2026-11-05.md

@@ -1,122 +0,0 @@
-# 迭代 53 验收审计（2026-11-05）
-
-- 审计员：独立会话子代理——未参与本迭代任何实现、设计或写卡工作，只读证据做审计。
-- 审计对象：迭代 53 两张需求卡片——卡①卷轴视口批（`reports/需求卡片-卷轴视口批-2026-11-05.md`）＋卡②改写族孤儿机制与退役名清退批（`reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md`）＋卡① golden 扩项（2026-11-05 用户裁两 Shot 面）。
-- 实现报告：`reports/iter53-实现报告-2026-11-05.md`（两卡「实际改动—验收对照表」为逐行核对基准）。
-- 验收档与实际执行深度：两卡均申报「中」档；本次按 test-conventions §8.7 中档执行——对照表逐行全量核对（两卡 R 行逐行）、判据绑定面抽查（超出下限）、测试削弱检查逐处、直查例外核对逐条、判据出处抽查 6 处。**最窄测试复跑＝省略，该格写「合回后 CI 现查补记」**（合并尚未发生——本审计为合并前置闸，远端 CI 现查读数待合回落地后按 `tools/ci_check.sh <合并提交>` 补记；静态 grep／文件核对类检查由审计员当场重跑，不属省略面）。
-- 基线提交：`709d9a85..8b4399ad`（iter53 分支；7 笔实现笔 c1043902／4e87a012／b5c21e3a／1bd50304／ed793e8c／6394abf7／78e08234 ＋ 1 笔并 master 8b4399ad）。工作树存在本机 Godot 导入元数据漂移（若干 `*.png.import` 未提交改动），不属提交面审计对象。
-- 审计动作面：`git diff 709d9a85..HEAD` 全量过目（37 文件）；测试/探针/闸件改动逐 hunk 核对；契约 1 五词 grep、40 名退役名全扫、契约 5 残留 grep 由审计员当场重跑。
-
-## 卡① 卷轴视口批（验收档：中｜执行深度：中档）
-
-### 对照表逐行核对（全量）
-
-| 行 | 结论 | 依据（文件:行） |
-|---|---|---|
-| R1 浅图整幅居中无裁切 | 通过 | 断言在案且尾缀可 grep：`game/probe/level_map_viewport_probe.gd:71/74/76`〔卷轴批 V1〕；承载改造落地 `level_map_viewport.gd:30-36`（setup/clip_contents）＋`level_map_screen.gd:134-145`（CenterContainer→视口件）；真实入口＝`open_choices` 真实停点（探针 :62-64，L1 固定种子直构 runner，start_level_external 注入）。运行读数＝实现者「绿」在案；合回后 CI 现查补记 |
-| R2 停点切换当前节点居中 x=640±2 | 通过 | 断言 `level_map_viewport_probe.gd:221`〔卷轴批 V2〕；断言钉屏空间投影（当前节点屏幕 x 对视口中心 ±2）——比卡面所写 `viewport_center_canvas_pos()` 调用更外层的真实观测，与 level-map.md:101/:154 判据①「居屏中线 x=640±2」同义，非削弱（观察 4）；真实入口＝断点停点重建＋真实 `open_choices`（探针 :216-217）→ screen `reanchor` 接线 `level_map_screen.gd:312-315`＋锚点提供方 :483-516。合回后 CI 现查补记 |
-| R3 拖拽平移 | 通过 | 断言 `level_map_viewport_probe.gd:137`〔卷轴批 V3〕；真实输入沿=`ProbeUiUtil.push_drag_at`（`game/probe/probe_ui_util.gd:146-166`，press→motion×4→release 全经 `push_input`）打真实画布 `_gui_input`（`level_map_screen.gd:381-403` 拖拽态逐帧 `pan_by`）——**未绕过改动点**（探针全文零 `pan_by` 直调，grep 证）；判据=视线位移=拖拽位移 40px 逐位。合回后 CI 现查补记 |
-| R4 滚轮横滚 | 通过 | 断言 `level_map_viewport_probe.gd:114/116/120`〔卷轴批 V4〕；`push_wheel_at`（probe_ui_util.gd:168-176）经 `push_input`；映射 `_wheel_pan_step`（level_map_screen.gd:426-433，下/右=+60 前进向，代拍板白名单 5 授权）。合回后 CI 现查补记 |
-| R5 clamp 包络与首末列可达 | 通过 | 断言 `level_map_viewport_probe.gd:88/102/158/160/161/167/168`〔卷轴批 V5〕；判据绑定 `viewport_center_canvas_pos()` 夹紧域（level_map_viewport.gd:76-77/:97-100/:111-114）＋`is_clamped_at_edge()` 两极翻转（:81-86）＋极值列入屏（:161-169，等价 spec 判据④）；真实入口=超包络拖拽沿两极。合回后 CI 现查补记 |
-| R6 拖拽不触发选路 | 通过 | 断言 `level_map_viewport_probe.gd:200/201/206`〔卷轴批 V6〕；**拖拽沿确从候选节点上方起沿**（:193 `gpos`＝候选屏幕投影，:197 `push_drag_at(self, gpos, …)` 起点即候选）；判据绑 `route_chosen` 发射面零计数（screen `route_chosen.emit` :465）＋屏未关＋阈值另一侧完整点击提交=1（:203-206，点击沿 press+release 成对经 push_input）。合回后 CI 现查补记 |
-| R7 平滑滚动与减动效瞬切 | 通过 | 断言 `level_map_viewport_probe.gd:245/249/258`〔卷轴批 V7〕；tween 单段缓动 TRANS_CUBIC-EASE_OUT UiKit.motion(0.3)（level_map_viewport.gd:57-59）；减动效走 `ArmedTimer.motion_still()`（armed_timer.gd:16-17＝motion_scale<1）跳终态——探针置 `UiKit.motion_scale=0.5` 即设置面单点（settings_overlay.gd:96 同驱），判据同向在途＋即达。合回后 CI 现查补记 |
-| R8 指引件可见性与几何 | 通过 | 断言 `level_map_viewport_probe.gd:272-278`＋浅图隐藏 :289〔卷轴批 V8〕；几何常量 FADE_BAND_W=70（level_map_viewport.gd:10）、CHIP_SIZE 240×30（:11）直挂 spec 判据②③；可见性=`_sync_guidance` 画布超窗判据（:181-191）。合回后 CI 现查补记 |
-| R9 schema 头注指针反转（非行为） | 通过（静态重跑） | `level_gen_params.gd:3-4`＋:70 反转落地；审计员重跑 grep：该文件「调参表」残留=0、「参数契约节」指向=2、`--check-only` 读数实现者在案。全仓唯一「调参表」残留=variation_table.gd:41（地形变异 v1.2 owner，不同文件不同域，不属本卡清退面） |
-| golden 两 Shot 面（用户裁） | 通过 | `game/probe/level_map_shot_probe.gd`（PASS 签名 :36＋落盘 fail-fast :89-91）＋`game/tests/golden/windows/lmap_entry.png`/`lmap_boss.png` 已入库（6394abf7，Bin 215164/211513 字节）＋`tools/render_gate.sh:168-197` 对拍段（PASS 签名＋双图非零工件锚定＋平台缺基线 SKIP 不判红）＋`tools/golden_baseline_refresh.sh` --lmap 模式（:59-85，素材齐盘守卫）＋`game/tests/golden/README.md` 台账随动；mac 缺基线义务已呈报（实现报告遗留 2＋反哺点 6）。运行读数（changed=0.00% 双绿）＝实现者在案；合回后 CI 现查补记 |
-
-卡①补充核对：26 断言计数属实（探针 26 处 `_check`＋尾缀〔卷轴批 V1..V8〕27 行含 1 处缺位告警）；`tools/probe_gate.sh:137-141` 注册新探针；ui_struct_probe 本批零改动（未触其结构断言面，卡①削弱申报该项落空＝无事）；实现报告实现决定 1-7（拖拽态落屏侧/open_choices 平滑判据/提交沿移抬杆/代拍板白名单定值/resize 即席重锚/_fit_canvas 同帧/mouse_exited 清跟踪器）均有代码承载且不越卡 §12 白名单；7 笔实现笔无一触碰 `design/`／两份根清单／`game/tests/README.md`（逐笔 name-only 核对）。
-
-### 判据绑定面抽查（本卡抽 4 行，超中档下限 2 行）
-
-- R6（如上）——`route_chosen` 零发射＋屏未关＋完整点击仍提交，三面钉在「拖拽不提交/点击提交」的特有提交面上。
-- R2（如上）——当前节点屏空间投影=视口中线 ±2。
-- R5（如上）——夹紧域＋两极 edge 翻转＋极值列入屏。
-- R3（如上）——拖拽位移与视线位移逐位一致，且全程走引擎输入管线。
-
-### 直查例外核对（逐条）
-
-| 直查行 | 申报状态 | 结论 |
-|---|---|---|
-| `level_map_viewport_probe.gd:67` `vp.get_child(0)`（取视口画布子件） | 探针内注释已给理由（「画布=视口首子件——setup 注入序」，:61），对照表/实现报告**未单列申报口径** | 缺漏（建议级，见末节 D2）——断言对象即承载结构本身，无公开可观测面可钉，风险零 |
-| `level_map_viewport_probe.gd:266-268/:287-288` 按名取 FadeL/FadeR/PanHint | 同上——探针内注释在案，对照表未单列 | 缺漏（建议级，并入 D2）——R8 断言对象即指引子件结构本身 |
-| screen 侧私有成员 | 新探针**未直读**任何 screen 私有成员（`_drag_active`/`_drag_press_pos` 零探针触达）；既有「探针直读冻结」惯例面（level_map_screen.gd:39/:57-64）未扩 | 通过 |
-
-## 卡② 改写族孤儿机制与退役名清退批（验收档：中｜执行深度：中档）
-
-### 对照表逐行核对（全量）
-
-| # | 结论 | 依据（文件:行） |
-|---|---|---|
-| R1 摘四段不可达改写分支 | 通过（静态面重跑一致；运行读数合回后 CI 现查补记） | diff 逐段核对：`damage_controller.gd` 命中侧交换/免掷覆盖/spike 置位/移档调用/增伤侧/spike 倍乘/`_discount_shift_up` 整函数全摘；`_ctx_rewrites` 返回键集={roll_read,threshold,crit,discount,clamp_hits}（:301-303）、`_hero_attack_ctx` 摘 spike_ready（:278-281）——与卡 T1 收窄键集逐字一致；armor_roll 发射点保留不接收返回值（:289-290，卡 3.6 口径）；spike_ready/ar_hits/shift 残留 grep=0（审计员重跑）。六组逐字节对拍 diff=0 与三套件 exit=0＝实现者读数在案；dump_battle 六组参数面（seed 42 默认＋参数覆盖，dump_battle.gd:13/:21）核对成立 |
-| R2 EFFECT_KINDS 摘 spike | 通过 | `effect_engine.gd:30` 词表摘名；断言 `effect_kind_retired_test.gd:89`「③词表闭面：kind=spike 出域拒绝」在案，沿既有 `_assert_rejected`/`_inject` 骨架（卡 T2 明示沿用）；注入形态偏差（do.kind=spike，非卡 T2 括注 kind=modify_ticket+mode=spike）＝实现决定 8 申报在案且经审计员核实——`validate_trigger_row`（effect_engine.gd:382-396）确无 mode 值域检查，括注形态无拒绝通道，实现口径与断言名/R2 判据绑定面（词表出域）一致。运行读数（负域套件 exit=1 四探针全拒）合回后 CI 现查补记 |
-| R3 DO_KEYS 摘 trade_hit/trade_atk | 通过 | `effect_engine.gd:80-82` 摘两键；断言 `effect_kind_retired_test.gd:92`「④do 键闭面：trade_hit 出域拒绝」在案。运行读数合回后 CI 现查补记 |
-| R4 注释面退役名清零 | 通过（40 名全扫审计员重跑） | 审计员自解析 `design/content-archive/道具退役素材库.md` 两表 40 名（41 减现役淬毒刃纹）重扫 `game/` 全域 .gd/.tres/.md/.tscn：命中仅 3 行＝`treasure_items_test.gd:31/33/35` StubDB 夹具名——与卡 §5 留底申报逐行一致；契约 2 抽 4 处（grant_segment.gd:232「完美布防→封印全中倍率」、damage_controller.gd:109「猎巢人→nest_count 订阅消费面」、reward_grant.gd:130「掘进蓄能→付费积点账本」、grant_segment.gd:359「雷区图谱→标中雷追加」）——职责陈述（做什么/按什么序/取值从哪来）逐处保留，只换名；宿主套件绿＝实现者读数，合回后 CI 现查补记 |
-| R5 减半明细行去退役件名 | 通过 | `reward_grant.gd:226` 标签→「挖掘惩罚减半（%d→%d）」＋effect_id→nest_halve；断言随动 `meta_progression_forge_test.gd:694/697/699-700`，强度三件（nc_hit 非空＋等值「挖掘惩罚减半（6→3）」＋零「挖雷」）与改前逐项对齐（基线 709d9a85:693-701 核对）；grep nest_counter=0（审计员重跑）。合回后 CI 现查补记 |
-| R6 空集拒绝 reason 去退役件名 | 通过（静态重跑） | `reward_grant.gd:189` reason 前缀→「中立移除：…」，`{"ok": false}` 形态未动（diff 核对）；grep 爆破工兵包 game/=0（审计员重跑）；观测面局限申报（reason 不可达、禁造行）在卡 §8/对照表一致在案 |
-| R7 反弹明细标签去退役件名 | 通过（静态重跑） | `grant_segment.gd:165-166` 标签→「反弹伤害」＋归因串→attune_nest_halve；**契约 3 逐字核对成立**：`channel=="reflect"` 判据、开单参数字典（channel/base_value/target_rule/ri/origin_cell）、`reward_grant.submit` 调用全未动（diff 对照基线 709d9a85:164-170）；grep 惊巢反制/attune_nest_counter=0（审计员重跑）。运行读数合回后 CI 现查补记 |
-| R8 sim 恒 false 匹配删除 | 通过（静态重跑） | `level_autoplay.gd:414-418` highlight=="seal_hit" 单判据保留、contains(雷区图谱) 条件与 :415 注释随删；grep 雷区图谱 game/=0（审计员重跑）。套件绿＝实现者读数，合回后 CI 现查补记 |
-
-卡②补充核对（契约逐条）：契约 1 三条 grep 审计员重跑全零——tables 五词 0、tree_rules 面 0、cell_removal 表面 0 仅 schema 在册（treasure_item_table.gd:20/:26）；`feats.tres:855` clamp_bonus 现役一行对照记录与实现报告 T0 一致，表内现存 mode 值（queue/round/battle/clamp_bonus/refresh）零退役四模式。契约 5 禁留空壳——spike_ready/ar_hits/shift/_discount_shift_up 残留 grep 全零（审计员重跑）。契约 6 实现批禁写文档——7 笔实现笔 name-only 核对零触 design/／待办清单／体验验证清单／game/tests/README.md。契约 7 零新增数值——diff 内零 .tres 表值改动。反哺点清单 7 条落点齐（含「明细标签是否入表」裁决点＋增益状态/伤害与护甲零命中备案）。
-
-### 判据绑定面抽查（本卡抽 3 行）
-
-- R2/R3（如上）——负域探针钉「退役词/键注入行→load_tables 拒绝＋error 诊断≥1＋进程退出码 1」；归属由夹具结构保证（copy_tables 全量现役表＋唯一异常探针行）。观察 5：卡面写的「error 载荷含 effect_kinds 出域文案」未做逐字断言——沿用卡 T2 明示的既有骨架语义，非削弱。
-- R5（如上）——step_row display_name 等值断言＋非空＋零旧词，判据绑减半路径特有发射面。
-- R1 静态面（如上）——收窄键集逐字核对＋摘除残留 grep，钉在「分支消亡」这一改动特有提交面。
-
-### 测试削弱检查（逐处，两卡合并过目）
-
-`git diff 709d9a85..HEAD -- game/tests/ game/probe/` 全量 hunk 过目，共 5 文件：
-
-1. `effect_kind_retired_test.gd`：**纯新增**（两探针常量＋两次 `_assert_rejected` 调用＋PASS 文案随动）；既有探针①②与 quit 语义零改动；`run_all.gd:195` 在册条目 expect=1/negative=true 未动。无削弱。
-2. `meta_progression_forge_test.gd`：恰 4 处期望串随 R5 换代（:694 匹配串/:697 描述/:699-700 等值串）＋2 行注释（卡 3.3 表申报面）——断言强度逐项不降（非空＋等值＋不含旧词全保留），与卡 §8 削弱申报逐字吻合。无申报外削弱。
-3. `variant_placement_test.gd`：1 行注释（偏运硬币→订阅行，卡 3.3 表 :239 申报面），断言零改动。无削弱。
-4. `ui_input_probe.gd`：+16 行＝case⑫断言段（图上命中提交沿）＋case⑱ 雾段（雾下点击零提交）各补 release 沿——实现报告决定 3 申报在案；判据语义核对：雾段=零提交不变（且改为完整点击沿后更强）、命中段=提交沿随新语义移至抬杆（单 press 沿在新语义下不再是提交沿，不适配则必红——必要适配非放宽）。**呈报笔误**：申报写「case⑫⑰⑧」，实际落点两处、无 ⑰（case⑰ 未开格类型微光走 `_push_click` 既有成对沿，无需适配）（建议级 D3）。
-5. `ui_struct_probe.gd`：零改动——卡①「适配须保持语义」条款无事可核，非缺漏。
-
-无申报外的断言删除、阈值放宽、扫描面缩小、换下层直调。
-
-### 判据出处抽查（6 处，超下限 4 处）
-
-| 断言预期值 | 规格出处 | 独立可写出性 |
-|---|---|---|
-| 居中 ±2（探针 R2 :221） | level-map.md:101「屏中线 x=640±2」/:154 判据①/:269 | 能——规格句直接给出 640±2 |
-| 渐隐带 70px（探针 R8 :273-274） | level-map.md:104/:154 判据②「屏缘两侧各 70px 渐隐带」 | 能 |
-| chip 240×30（探针 R8 :275-276） | level-map.md:104/:154 判据③「240×30、圆角 6」 | 能 |
-| 「挖掘惩罚减半（6→3）」（forge 测试 :699-700） | 卡② §8 R5 判据明文＋reward_grant.gd:226 契约 3 边界；6→3 可由测试构造独立推出（heal 行 power=6×halve 50% ceil=3） | 能——预期值在卡内先行锁定，非镜像实现 |
-| 拖拽阈值 8px（DRAG_THRESHOLD，level_map_screen.gd:34） | 卡① §12 白名单 2「8px 附近 provisional 区间内定值」授权；spec :103 明示阈值实现期定值 | 能——授权面在卡，值属 provisional 自主面 |
-| golden 两 Shot 面 | 2026-11-05 用户裁决（实现报告决定 9 在案）：只对拍关卡最开始＋Boss 节点 | 能——裁决记录在实现报告与 golden/README 台账双在案 |
-
-六处均非「预期值只在实现里出现」的同义反复。
-
-## 附加核对
-
-- 能力行名实（game/tests/README.md:162-164 三行）：:162 跟随行（_probe_follow_anchor/_probe_smooth_scroll_reduced_motion）与 :164 指引行（_probe_guidance_chrome）名实一致；**:163 平移行的 `_probe_clamp_bounds` 与落地名 `_probe_clamp_bounds_and_columns` 不一致**（建议级 D1——卡① §5「批末收尾核对表上名与落地一致（改名则回表）」未回表，反哺点清单亦未收录；实现批禁写 README，正确通道＝回写卡段/反哺点）。
-- 负面套件在册：`game/tests/run_all.gd:195` effect_kind_retired_test expect=1/negative=true 登记在位，卡② T2 未动在册条目——一致。
-- S13 基线读数：`tools/gdstyle_baseline.txt` 恰 7 条且无本批触面键（level_map_screen/damage_controller/effect_engine/reward_grant/level_autoplay 均无键）——与实现报告 T0/T4 读数一致。
-- 闸件缺陷呈报核实（实现报告遗留 1）：`tools/gate_platform.sh:37` `kf="$(mktemp …)"` 即建文件＋:48 `[ -f "$kf" ]` 恒真→恒 124，呈报描述与代码相符；probe_gate.sh:97 `kf="$TMP/killed.$RANDOM"`（先赋路径不预建）为正确写法参照——呈报属实；该缺陷修法归工程批，本审计不裁定（不在验收对象内，已入反哺点 5）。
-
-## 缺漏与观察清单
-
-阻断级：无。
-
-建议级（不阻断合并，归批后收尾/文档批）：
-
-- D1：能力清单 `game/tests/README.md:163` 代表用例名 `_probe_clamp_bounds` ≠ 落地名 `_probe_clamp_bounds_and_columns`（卡① §5 名实核对义务未回表；反哺点清单漏收）。
-- D2：新探针对宿主内部结构的直查（`level_map_viewport_probe.gd:67` get_child(0)＋:266-268/:287-288 按名取指引子件）未按 test-conventions §8.7 第 4 条在对照表逐条申报口径；探针内注释已给理由（断言对象=承载结构本身，无公开观测面），screen 侧既有「探针直读冻结」惯例未被动用、新私有成员零直读，风险零。
-- D3：实现报告/提交信息写「ui_input_probe case⑫⑰⑧ 补 release 沿」，实际落点为 case⑫断言段＋case⑱雾段两处、无 ⑰——呈报笔误，判据语义已核保持。
-
-观察（记录在案，不构成缺漏）：
-
-- O1：R2 判据绑定面用屏空间投影而非卡面所写 `viewport_center_canvas_pos()` 调用——更外层真实观测，与 spec 判据①同义，非削弱；连带 `game/tests/README.md:162` 读面句与实况有轻微出入。
-- O2：卡② R2/R3 负域探针未逐字断言错误文案（沿用卡 T2 明示骨架语义；归属由夹具唯一异常行结构保证）。
-- O3：卡① T1 写「探针宿主沿组合根真实屏」、卡 §8 对照表写「场景探针实例化本屏」——卡内两处口径不一，实现取对照表口径且在对照表真实入口格如实呈现；`push_input` 真实输入管线口径照守（禁合成投喂的实质红线未破）。
-- O4：探针宿主直构 runner（start_level_external）属 test-conventions §5.4 自动化测试直构口径，探针头注已申报。
-
-## 审计结论
-
-**通过**（可合并；合并落地后按中档梯度以 `tools/ci_check.sh <合并提交>` 现查读数补记「最窄复跑」格——零触发或不可判不作绿证）。
-
-- 卡①卷轴视口批（验收档：中）：对照表 10 行全通过；绑定面抽查 4 行钉面成立；削弱零申报外；判据出处 4+ 处独立可写出；缺漏 3 项均建议级（D1 能力行名实回表、D2 直查申报口径补记、D3 呈报笔误）。
-- 卡②改写族清退批（验收档：中）：对照表 8 行全通过；契约 1/2/3/5/6/7 审计员重跑/逐处核对全部成立；削弱恰为申报内 4 处期望串且强度不降；40 名扫描与卡 §5 留底逐行一致；无阻断项。
-- golden 扩项：两 Shot 面用户裁决在案、基线入库、闸件对拍段与台账齐；mac 冻结义务已呈报（反哺点 6）。

reports/提案-营地色彩与氛围脚本-2026-10-23.md

@@ -1,147 +0,0 @@
-# 提案：营地色彩与氛围脚本（2026-10-23）
-
-> **性质**：设计讨论段过程稿。**只确立「营地该长什么样、什么风格、什么感觉」，不出图、不改 `art-bible` 主色板。**
-> 上游依据：`art-bible` §2.8（营地情绪）、§4.1 色板分层与对比硬指标、§4.2 适用域条款、§6.1 战斗背景后退条款、§6.2 营地场景、§8 定值单点纪律；外部调研见 §4。
-> 下游：本脚本是 §13 生图提示词的色彩依据；色值候选在此**单点**提出，待作者追认后按 §4.1「场景环境子板」条款登记（环境子板每屏一套、≤32 色、允许跨屏不共享、不占 48 token 额度）。
-
----
-
-## 0. 四问速览（只读这一段也能定）
-
-| 问 | 答 |
-|---|---|
-| **① 现状差在哪** | 营地整屏发黄发闷。实测：天空黄度 51、地面黄度 81（黄度 =(R+G)/2−B，越大越黄）。**占屏约七成的大面积——天空、远山、地面——全是暖色**，找不到一块冷色来平衡。 |
-| **② 建议做什么** | 给营地补一张**环境子板**，按「**冷的大面积后退、暖的小面积前进**」重新分工：天与山与地走冷灰，暖色只留给物件（火、木、石），火焰是唯一高饱和。 |
-| **③ 为什么选它** | 这是空气透视的通行做法（远处更淡、更冷、对比更弱，近处更暗、更暖、对比更强），且 `art-bible` §4.2 已写明**环境层不受色相独占约束**——远山走冷色完全合规，不需要动任何暖色条款。 |
-| **④ 怎么验证** | 出图后按 §2.5 的面积占比与黄度阈值实量：天空黄度 ≤20、地面黄度 ≤35；暖色面积 ≤30%。这两条可机检，不靠眼估。 |
-
----
-
-## 1. 诊断：黄不是设计意图，是三个缺口叠加
-
-### 1.1 事实（出图实测，非推测）
-
-| 版本 | 天空 RGB | 天空黄度 | 地面 RGB | 地面黄度 |
-|---|---|---|---|---|
-| 首版方向稿 | (249, 229, 188) 奶黄 | 51 | (157, 119, 57) 暖褐 | 81 |
-| 修正天空后 | (217, 221, 202) 灰白 | 17 | (146, 128, 97) 仍偏褐 | 40 |
-
-天空改冷后黄度掉到 17，画面立刻不那么"尿黄"——**说明元凶是大面积的色温，不是物件本身**。地面只降到 40，因为当时提示词里还挂着棋盘色 `裸土 #B39A78`。
-
-### 1.2 三个缺口
-
-**缺口一：营地没有自己的环境子板，大面积色是借来的。**
-`art-bible` §4.1 主色板里能撑大面积的暖色只有两个——`掩尘 #C9AF83`、`裸土 #B39A78`。但这两色的语义是**棋盘格底**（未开格／已开格），营地场景直接拿来当地面和石头用，等于把棋盘色板铺满了占屏七成的面积。§4.1 那组硬指标（L≥0.30、饱和 ≤0.55）是**棋盘数字可读性**指标，搬到场景大面积上只剩弱约束，管不住色相。
-
-**缺口二：「全作最暖」被泛化到了不该暖的地方。**
-§6.2 写的是「承载 §2.8——全作最暖：烛光黄 `#F6C667` × 木色 `#8A5A34`」。这两个色的本体是**火焰与木构**，是"人留下的东西"。它被理解成了"整屏都要暖"，于是天空、远山、地面全部跟着暖。
-
-**缺口三：两条构图口径把仅有的冷色来源拿掉了。**
-作者口径「近景不要草」删掉了暖调场景里**唯一的天然冷色平衡源（绿植）**；「不要远景地面／地平线」又删掉了山脚那片本可以做成冷灰绿的地带。剩下来的大面积只剩天、山、地——三者全暖，必然发黄。
-
-### 1.3 与美术圣经核对：没有任何条款要求营地大面积是暖的
-
-| 条款 | 原文要点 | 对本议题的含义 |
-|---|---|---|
-| §4.2 适用域 | **纯环境氛围（背景／装饰／远景／非语义物件）不受色相独占约束**，只受 §3.4 焦点预算与低饱和后退约束 | 远山、天空走冷色**完全合规**，不被任何语义色独占条款拦 |
-| §6.1 战斗背景 | 背景整体**低对比自然后退**，禁止抢焦点 | 营地远景可沿用同款"后退"逻辑，冷灰正是后退手段 |
-| §4.1 色板分层（2026-10-22 作者裁） | 场景环境子板：**每屏一套、≤32 色、允许跨屏不共享**；新增环境色须过 §4.2 语义检查 + 与既有任一色 RGB 三通道差 ≥8/255 | 营地可以**单独拥有一套环境色**，不必挤占棋盘主色板，也不占 48 token 额度 |
-| §2 明度分层（2026-09-29 v3.0） | 空间纵深走明度分层允许域（光照氛围／色相饱和／形体承载），非情绪压暗 | 空气透视的"远景趋近天空明度、对比变弱"与既有明度分层同族，不冲突 |
-
-**结论**：要改的不是美术圣经的暖色条款，而是**补一张营地环境子板**，并把"全作最暖"收回它本来的位置——暖的是物件，不是整屏。
-
----
-
-## 2. 修正后的定位：营地应该长什么样
-
-### 2.1 一句话氛围定位
-
-> **白天、干爽、有风的开阔营地。暖的是「人留下的东西」（火、木头、皮革、石头），冷的是「野外的东西」（天、远山、地面）。玩家第一眼看到的是篝火和物件，天与山只是安静地退在后面。**
-
-### 2.2 三个感觉词（写提示词与验收都照这三条判）
-
-| 感觉词 | 落到画面上是什么 | 反例（出现即判红） |
-|---|---|---|
-| **干爽** | 降饱和、无湿气；地面是干实土不是泥泞 | 整屏油润、饱和过高、像黄昏金光 |
-| **安稳** | 暖色集中在篝火与木构上，是"人味"，不是整屏染色 | 天空、远山也发暖 → 变成"整屏黄疸" |
-| **空旷** | 远景只有天与山，无地平线、无杂物、无树 | 远景长出树、屋、地平线 |
-
-### 2.3 冷暖分工（核心规则，一句话记住）
-
-**冷＝大面积＝后退；暖＝小面积＝前进。**
-
-- 冷（后退层）：天空、远山、地面 —— 冷灰白／冷灰蓝／中性灰褐，低饱和
-- 暖（前进层）：火焰、木构、石头、绳垫、毯子 —— 只在这一层出现暖色
-- **唯一高饱和＝篝火火焰**（§3.4 焦点预算：首焦唯一，其余全部让位）
-
-### 2.4 空气透视三档（远近各层怎么拉开）
-
-**空气透视**＝空气隔在中间，越远的东西看起来越淡、越冷、对比越弱、细节越少；近处相反，更暗、更暖、对比更强、细节更多。
-
-| 层 | 明度 | 色温 | 饱和 | 对比 | 细节 |
-|---|---|---|---|---|---|
-| **远**（天空／远山） | 最亮，趋近天空 | **冷** | 最低 | 最弱 | 只剩剪影，无单体树 |
-| **中**（木围墙／门／布告板） | 中 | 中性偏冷（木色压灰） | 低 | 弱 | 简化，无个体木纹 |
-| **近**（地面／七件） | **最暗** | **暖（仅此层）** | 中（火焰为唯一高饱和） | 最强 | 完整、清晰、可读 |
-
-> 注：本表的明度关系是**营地环境子板内部**的纵深关系，与棋盘的世界底／中层档互不干扰（环境子板允许跨屏不共享）。
-
-### 2.5 面积占比（把"别太黄"变成可机检的数）
-
-| 色温区 | 建议占比 | 判据 |
-|---|---|---|
-| 冷色面积（天＋山＋地） | **≥ 55%** | 低于则整屏偏暖 |
-| 暖色面积（物件与木构） | **≤ 30%** | 高于则"黄疸" |
-| 火焰高饱和 | **≤ 3%** | 高于则抢焦（违反 §3.4 焦点预算） |
-
-配套黄度阈值（出图后实量）：**天空黄度 ≤20、地面黄度 ≤35**。
-
-### 2.6 色值候选方向（待作者定，§4.1 是数值单点事实源）
-
-只给方向不给死值——定色值须由作者拍板，且新色要过两道门（§4.2 语义检查 + 与既有任一色 RGB 三通道差 ≥8/255）：
-
-| 大面积 | 方向 |
-|---|---|
-| 天空 | 冷灰白、微带蓝灰，全画明度最高 |
-| 远山 | 冷灰蓝，越远越淡越冷（空气透视），趋近天空明度 |
-| 地面 | 中性灰褐，降饱和，全画明度最低，**绝不带金黄／琥珀** |
-| 木构（中景围墙） | 木色 `#8A5A34` 压一档饱和走中性偏冷——它是中景，必须后退 |
-| 物件（近景） | 木色 `#8A5A34`、掩尘 `#C9AF83` 保持本色；火焰烛光黄 `#F6C667` 为唯一高饱和 |
-
----
-
-## 3. 与美术圣经的关系：哪些不动、哪些要新建
-
-| 项 | 处理 | 理由 |
-|---|---|---|
-| §6.2「全作最暖：烛光黄 × 木色」 | **不动**，但收回适用范围＝**物件层**，不含天空／远山／地面 | 两色本体是火与木，泛化到整屏是把"物件色"当成了"环境色" |
-| §4.1 主色板（掩尘／裸土等） | **不动**；营地地面**停止挪用** `裸土 #B39A78` | 那是棋盘格底色，语义不同域 |
-| §4.2 适用域条款 | **不动**，本脚本正是依据它给环境层定冷色 | 环境层本就不受色相独占约束 |
-| 营地环境子板 | **新建**（本脚本 §2.6 为候选） | §4.1 色板分层条款已开通道：每屏一套、≤32 色、不占 48 额度 |
-| §4.1 硬指标（L≥0.30、饱和 ≤0.55） | **不动**，仅说明它是棋盘可读性指标、不搬到场景大面积 | 避免把格底指标误当场景指标 |
-
----
-
-## 4. 外部调研依据
-
-### 4.1 三条通行原则（多来源一致）
-
-1. **空气透视**：越远越亮（趋近天空明度）、越冷（偏蓝）、对比越弱、细节越少；近处相反——暗、暖、高对比、有细节。（来源：Fiveable《Atmospheric perspective》、ArtExamples《Atmospheric Perspective》、科普中国「空气透视」条目——后者原文："近处色彩偏暖，远处色彩偏冷""最远处冷暖不分而形成为一片蓝灰色"）
-2. **冷暖分工**：暖色前进、冷色后退。像素画环境里"背景多走冷、前景多走暖，以此拉开纵深"。（来源：PixelPaletteSwap《Color Theory for Pixel Art》；Peace on Paper《Warm vs Cool Tricks》技巧一"暖前景、冷背景"）
-3. **饱和即焦点**：高饱和只留给焦点，大面积必须降饱和。（来源：Pixel-Editor《Color Theory for Pixel Art》"Keep saturated colors sparse"）
-
-### 4.2 同类游戏参照
-
-**暖而不脏**的 cozy 像素阵营：Stardew Valley、Moonlighter、Eastward、Forager、Littlewood、Spirittea、Potion Permit（来源：The Cozy Gaming Nook 两次 cozy 像素专题）。
-
-**其中 Stardew Valley 最值得对照**：它同样是"暖乡土"调子，靠**大面积绿色植被**做冷色平衡（来源：ImageToPixel 的分析——Stardew 走"golden hour"暖调、无抖动、细描边，但画面里绿植占比极大）。
-
-**对本项目的直接推论**：营地按作者口径**禁草**、**禁远景地面**，等于把 Stardew 赖以平衡的绿植整块拿掉。所以冷色平衡只能由**天空与远山**承担——这两块必须明确走冷，否则整屏无解。
-
----
-
-## 5. 待裁（由作者定，不擅自动）
-
-1. **营地环境子板色值**（§2.6 仅给方向）——定色值属 `art-bible` §4.1 的活，且新色须过 §4.2 语义检查 + RGB 三通道差 ≥8/255 两道门。
-2. **面积占比与黄度阈值**（§2.5）——是否作为营地场景图的机检判据写进验收表。
-3. **木围墙的色温**——中景走"中性偏冷"要比物件木色压一档饱和，是否与 §6.2「木色 `#8A5A34`」的物件用法冲突（我的判断：不冲突，压饱和不是换色，但需作者确认）。

reports/普查-效果通道与事件词零现役-2026-11-06.md

@@ -0,0 +1,45 @@
+# 普查：效果通道与事件词零现役（2026-11-06）
+
+> **接收方**：待办清单「效果通道与事件词的零现役普查」条——本报告是该条的产出合同。
+> **结论**：需要你处理的事只有 **2 件**（第一节）；扫描面内其余全部属预留埋点，**全部保留、零处理项**（第二节只留计数供存档）。词表零改动、内容层零孤儿、零代码改动。
+
+## 一、需要你裁断的两件事
+
+### 1. 注释叙述订正 5 处——做不做
+
+代码注释把三件**未设计入表**的专长（掘进蓄能／深挖钻头／爆破工兵包）写成了在役叙述，后来读代码或写卡的人会被误导（迭代 53 已发生过一次：spike 承接句按注释误判「零新代码」）。订正方式＝把注释改成「预留、未设计入表」，不改任何逻辑。
+
+| 位置 | 现行叙述 | 事实 |
+|---|---|---|
+| effect_engine.gd OPS 头注 | mod_zero「掘进蓄能」、gte_ref/lt_ref「深挖钻头配额」 | 两专长零在表 |
+| effect_engine.gd EFFECT_KINDS 头注 | spike 独立 kind 在词表 | 实走 modify_ticket 的 mode 通道 |
+| reward_grant.gd:130 | 「counter_spend 订阅=掘进蓄能积点账本」 | 掘进蓄能零在表 |
+| action_economy.gd:82 | 「深挖钻头付费开掘」 | 深挖钻头零在表 |
+| treasure_item_table.gd:20 | 「cell_removal = 爆破工兵包中立移除格」 | 爆破工兵包零在表 |
+
+### 2. 秘宝表旧词「迁移完成」收尾——做不做、何时做
+
+秘宝表 schema 词表里留着 9 个旧目录时代的词面（git 查证：迭代 22 秘宝批把旧目录 12 行全量换代成现役 12 件后，旧词面按 schema 自己注的「旧词保留共存至迁移完成」留下）。按关联效果列名：
+
+| 旧词承载的效果 | 类型 |
+|---|---|
+| 雷区揭示／奖励预览／行动点授予（3 个旧词形） | 新旧词共存——现役等价能力已由新词形承载 |
+| 踩雷伤害减半／受击反弹伤害／开局前几轮行动点加成／爆破工兵包中立移除格／奖励摇号权重偏置／换图刷新加算区（6 个） | 旧内容已裁、通道位预留 |
+
+裁断点：这批「迁移完成」收尾要不要做、什么时候做。**词面现在不动**；收尾属于单独一批改动，做的时候再设计。
+
+## 二、无需处理项汇总（零裁决点，计数存档）
+
+扫描面内以下词面全部判定**保留**（预留埋点——引擎架构＝词表先行、内容后接，加一件已有效果类型的专长/秘宝只写数据行零代码）：
+
+- **事件词预留 4**：armor_roll（事件岗）／reward_roll／treasure_used／seal_settle——发射点全在役运行，等订阅内容；armor_roll 另有掷点流名岗在役，同词两用。
+- **效果类型词预留 10**：spawn_spell（锻造工坊法杖设计在册待接线）；bias_rewards／counter_spend（架构在役机制承载位——偏运合计查询口／受理闸模式）；add_ticket_rider／yield_mult／apply_status／bias_wallet／refresh_pick／preview／spike 词面（预留位）。
+- **事实词预留 6**：is_first_dig_of_battle／terrain_kind（载荷特判支撑在）／target_armor_class／seals_count／nest_count／battle_index。
+- **算子词预留 7**：neq／gt／ends_with／has／mod_zero／gte_ref／lt_ref（实现函数全在）。
+- **channel 反弹行族**：open_ticket 反弹域零数据行（预留）。
+
+其余全部事件词／效果词／事实词／算子词的数据面订阅行在役（feats/treasure 数据行＋天赋树规则合成行），零孤儿。
+
+## 三、普查方法（存档）
+
+四张词表封闭在 effect_engine.gd 常量：事件 21／效果类型 31／事实 18／算子 13；邻接面＝秘宝表 schema 旧词层 10 词＋channel 域。数据面使用按行结构键（`"on"`／`"kind"`／`"fact"`／`"op"`／`"channel"`）统计自 `game/data/tables/*.tres` 全域＋天赋树规则合成行＋秘宝表主动件域；注释裸词面不计。skills.tres（敌技）的 when/fact 走独立系统，不入本普查面。

reports/读数-三关色相互辨抽测-2026-11-05.md

@@ -0,0 +1,203 @@
+# 读数：三关色相 × 五组微光互辨抽测（2026-11-05）
+
+> 接收方：待办清单「三关色相 × 五组微光互辨抽测——三关图类型色板终值冻结的前置抽测」条。
+> 执行依据：reports/提案-三关色相互辨抽测方案-2026-10-29.md（S1/S2 步）。
+> 样图：artwork/mockups/glow-discrimination-sheet-2026-11-05.png（不入 git）。
+
+## 机检汇总
+
+| 项 | 判定 | 说明 |
+|---|---|---|
+| D-dungeon | PASS | 铺底代表值门（底型瓦片实测顶面受光档；亮度/饱和/禁入带，近色只报读数）：RGB=(180, 144, 105) L=0.307 饱和=0.417 色相=31.2° 近色对=13（在役素材色，非新增） |
+| D-underdark | PASS | 铺底代表值门（底型瓦片实测顶面受光档；亮度/饱和/禁入带，近色只报读数）：RGB=(186, 193, 210) L=0.532 饱和=0.114 色相=222.5° 近色对=4（在役素材色，非新增） |
+| D-deep_underdark | PASS | 铺底代表值门（底型瓦片实测顶面受光档；亮度/饱和/禁入带，近色只报读数）：RGB=(150, 158, 186) L=0.345 饱和=0.194 色相=226.7° 近色对=9（在役素材色，非新增） |
+| A-stair-dungeon-素砖 | PASS | 明度阶梯单调递减：165.242→145.992→130.196→114.266→92.362 |
+| A-stair-dungeon-裂纹 | PASS | 明度阶梯单调递减：165.242→145.992→130.196→114.266→92.362 |
+| A-stair-dungeon-碎石斑 | PASS | 明度阶梯单调递减：164.957→144.992→129.269→113.266→91.434 |
+| A-stair-underdark-素砖 | PASS | 明度阶梯单调递减：161.080→141.829→125.179→109.389→87.485 |
+| A-stair-underdark-裂纹 | PASS | 明度阶梯单调递减：164.152→144.902→129.106→112.461→90.557 |
+| A-stair-underdark-碎石斑 | PASS | 明度阶梯单调递减：158.152→138.829→123.106→106.461→84.557 |
+| A-stair-deep_underdark-素砖 | PASS | 明度阶梯单调递减：145.437→126.186→109.748→93.746→71.914 |
+| A-stair-deep_underdark-裂纹 | PASS | 明度阶梯单调递减：147.509→128.259→112.536→95.818→73.986 |
+| A-stair-deep_underdark-碎石斑 | PASS | 明度阶梯单调递减：142.509→123.186→106.748→90.746→68.914 |
+| A-CR | PASS | 组间合成对比最弱对 ≥1.20（90 对）：最弱 underdark/HEAL/PIERCE CR=1.224 |
+| B | PASS | 格底-微光可辨底线（45 行三通道差不全<8）：违例 0 行：无 |
+| C | PASS | 绘制参数校准（45 行模型差≤±2/255）：违例 0 行：无 |
+| GRAY | PASS | 灰度副本段零彩色像素：命中 0 |
+| EDGE | PASS | 四缘 10px 带内零内容像素：命中 0 |
+
+## S1 机检 D：铺底代表值（底型瓦片实测顶面受光档）五门
+
+| 关 | RGB | L（线性域） | 饱和 | 色相 | 近色对 | 判定 |
+|---|---|---|---|---|---|---|
+| dungeon | (180, 144, 105) | 0.307 | 0.417 | 31.2° | 13 | 过 |
+| underdark | (186, 193, 210) | 0.532 | 0.114 | 222.5° | 4 | 过 |
+| deep_underdark | (150, 158, 186) | 0.345 | 0.194 | 226.7° | 9 | 过 |
+
+## 表一 逐对表（45 行）
+
+| 关 | 底型 | 微光组 | 带内合成均值 | 格心素底均值 | 模型带内均值 | 模型差 | 三通道差 | 色相差° | 判定 |
+|---|---|---|---|---|---|---|---|---|---|
+| dungeon | 素砖 | BUFF | (193, 166, 76) | (145, 116, 84) | (193, 166, 76) | 0 | [48, 50, 8] | 21 | 过 |
+| dungeon | 素砖 | HEAL | (126, 159, 76) | (145, 116, 84) | (126, 159, 75) | 1 | [19, 43, 8] | 73 | 过 |
+| dungeon | 素砖 | PIERCE | (100, 140, 122) | (145, 116, 84) | (100, 140, 122) | 0 | [45, 24, 38] | 149 | 过 |
+| dungeon | 素砖 | MAGIC | (135, 105, 145) | (145, 116, 84) | (135, 105, 145) | 0 | [10, 11, 61] | 136 | 过 |
+| dungeon | 素砖 | AOE | (155, 76, 70) | (145, 116, 84) | (155, 76, 70) | 0 | [10, 40, 14] | 43 | 过 |
+| dungeon | 裂纹 | BUFF | (193, 166, 76) | (143, 115, 83) | (193, 166, 76) | 0 | [50, 51, 7] | 21 | 过 |
+| dungeon | 裂纹 | HEAL | (126, 159, 76) | (143, 115, 83) | (126, 159, 76) | 0 | [17, 44, 7] | 73 | 过 |
+| dungeon | 裂纹 | PIERCE | (100, 140, 122) | (143, 115, 83) | (100, 140, 122) | 0 | [43, 25, 39] | 149 | 过 |
+| dungeon | 裂纹 | MAGIC | (135, 105, 145) | (143, 115, 83) | (135, 105, 145) | 0 | [8, 10, 62] | 136 | 过 |
+| dungeon | 裂纹 | AOE | (155, 76, 70) | (143, 115, 83) | (155, 76, 70) | 0 | [12, 39, 13] | 43 | 过 |
+| dungeon | 碎石斑 | BUFF | (192, 166, 75) | (147, 118, 85) | (192, 166, 75) | 0 | [45, 48, 10] | 21 | 过 |
+| dungeon | 碎石斑 | HEAL | (125, 158, 75) | (147, 118, 85) | (125, 159, 75) | 1 | [22, 40, 10] | 73 | 过 |
+| dungeon | 碎石斑 | PIERCE | (99, 139, 122) | (147, 118, 85) | (99, 139, 122) | 0 | [48, 21, 37] | 149 | 过 |
+| dungeon | 碎石斑 | MAGIC | (134, 104, 144) | (147, 118, 85) | (134, 104, 144) | 0 | [13, 14, 59] | 136 | 过 |
+| dungeon | 碎石斑 | AOE | (154, 75, 70) | (147, 118, 85) | (154, 75, 70) | 0 | [7, 43, 15] | 43 | 过 |
+| underdark | 素砖 | BUFF | (172, 164, 100) | (104, 110, 128) | (172, 164, 100) | 0 | [68, 54, 28] | 170 | 过 |
+| underdark | 素砖 | HEAL | (105, 157, 100) | (104, 110, 128) | (105, 157, 100) | 0 | [1, 47, 28] | 119 | 过 |
+| underdark | 素砖 | PIERCE | (78, 137, 147) | (104, 110, 128) | (78, 137, 147) | 0 | [26, 27, 19] | 42 | 过 |
+| underdark | 素砖 | MAGIC | (114, 102, 169) | (104, 110, 128) | (114, 102, 169) | 0 | [10, 8, 41] | 33 | 过 |
+| underdark | 素砖 | AOE | (134, 73, 94) | (104, 110, 128) | (134, 73, 95) | 1 | [30, 37, 34] | 126 | 过 |
+| underdark | 裂纹 | BUFF | (175, 167, 104) | (113, 120, 137) | (175, 167, 104) | 0 | [62, 47, 33] | 170 | 过 |
+| underdark | 裂纹 | HEAL | (108, 160, 104) | (113, 120, 137) | (108, 160, 104) | 0 | [5, 40, 33] | 119 | 过 |
+| underdark | 裂纹 | PIERCE | (82, 141, 150) | (113, 120, 137) | (82, 141, 150) | 0 | [31, 21, 13] | 42 | 过 |
+| underdark | 裂纹 | MAGIC | (117, 105, 173) | (113, 120, 137) | (117, 105, 173) | 0 | [4, 15, 36] | 33 | 过 |
+| underdark | 裂纹 | AOE | (137, 76, 98) | (113, 120, 137) | (137, 76, 98) | 0 | [24, 44, 39] | 126 | 过 |
+| underdark | 碎石斑 | BUFF | (169, 161, 98) | (124, 131, 149) | (169, 161, 98) | 0 | [45, 30, 51] | 170 | 过 |
+| underdark | 碎石斑 | HEAL | (102, 154, 97) | (124, 131, 149) | (102, 154, 97) | 0 | [22, 23, 52] | 119 | 过 |
+| underdark | 碎石斑 | PIERCE | (76, 135, 144) | (124, 131, 149) | (76, 135, 144) | 0 | [48, 4, 5] | 42 | 过 |
+| underdark | 碎石斑 | MAGIC | (111, 99, 167) | (124, 131, 149) | (111, 99, 167) | 0 | [13, 32, 18] | 33 | 过 |
+| underdark | 碎石斑 | AOE | (131, 70, 92) | (124, 131, 149) | (131, 70, 92) | 0 | [7, 61, 57] | 126 | 过 |
+| deep_underdark | 素砖 | BUFF | (157, 148, 86) | (76, 80, 102) | (157, 148, 86) | 0 | [81, 68, 16] | 175 | 过 |
+| deep_underdark | 素砖 | HEAL | (90, 141, 86) | (76, 80, 102) | (90, 141, 86) | 0 | [14, 61, 16] | 123 | 过 |
+| deep_underdark | 素砖 | PIERCE | (64, 121, 133) | (76, 80, 102) | (64, 121, 133) | 0 | [12, 41, 31] | 47 | 过 |
+| deep_underdark | 素砖 | MAGIC | (99, 86, 155) | (76, 80, 102) | (99, 86, 155) | 0 | [23, 6, 53] | 29 | 过 |
+| deep_underdark | 素砖 | AOE | (119, 57, 81) | (76, 80, 102) | (119, 57, 81) | 0 | [43, 23, 21] | 122 | 过 |
+| deep_underdark | 裂纹 | BUFF | (159, 150, 89) | (84, 89, 111) | (159, 150, 89) | 0 | [75, 61, 22] | 175 | 过 |
+| deep_underdark | 裂纹 | HEAL | (92, 143, 89) | (84, 89, 111) | (92, 143, 89) | 0 | [8, 54, 22] | 123 | 过 |
+| deep_underdark | 裂纹 | PIERCE | (66, 124, 136) | (84, 89, 111) | (66, 124, 136) | 0 | [18, 35, 25] | 47 | 过 |
+| deep_underdark | 裂纹 | MAGIC | (101, 88, 158) | (84, 89, 111) | (101, 88, 158) | 0 | [17, 1, 47] | 29 | 过 |
+| deep_underdark | 裂纹 | AOE | (121, 59, 84) | (84, 89, 111) | (121, 59, 84) | 0 | [37, 30, 27] | 122 | 过 |
+| deep_underdark | 碎石斑 | BUFF | (154, 145, 84) | (91, 97, 121) | (154, 145, 83) | 1 | [63, 48, 37] | 175 | 过 |
+| deep_underdark | 碎石斑 | HEAL | (87, 138, 83) | (91, 97, 121) | (87, 138, 83) | 0 | [4, 41, 38] | 123 | 过 |
+| deep_underdark | 碎石斑 | PIERCE | (61, 118, 130) | (91, 97, 121) | (61, 118, 130) | 0 | [30, 21, 9] | 47 | 过 |
+| deep_underdark | 碎石斑 | MAGIC | (96, 83, 152) | (91, 97, 121) | (96, 83, 152) | 0 | [5, 14, 31] | 29 | 过 |
+| deep_underdark | 碎石斑 | AOE | (116, 54, 78) | (91, 97, 121) | (116, 54, 78) | 0 | [25, 43, 43] | 122 | 过 |
+
+## 表二 组间表（90 行）
+
+| 关 | 底型 | 组对 | 合成对比 | 灰度亮度a | 灰度亮度b | 判定 |
+|---|---|---|---|---|---|---|
+| dungeon | 素砖 | BUFF/HEAL | 1.270 | 165.242 | 145.992 | 过 |
+| dungeon | 素砖 | BUFF/PIERCE | 1.583 | 165.242 | 130.196 | 过 |
+| dungeon | 素砖 | BUFF/MAGIC | 1.979 | 165.242 | 114.266 | 过 |
+| dungeon | 素砖 | BUFF/AOE | 2.510 | 165.242 | 92.362 | 过 |
+| dungeon | 素砖 | HEAL/PIERCE | 1.247 | 145.992 | 130.196 | 过 |
+| dungeon | 素砖 | HEAL/MAGIC | 1.559 | 145.992 | 114.266 | 过 |
+| dungeon | 素砖 | HEAL/AOE | 1.977 | 145.992 | 92.362 | 过 |
+| dungeon | 素砖 | PIERCE/MAGIC | 1.250 | 130.196 | 114.266 | 过 |
+| dungeon | 素砖 | PIERCE/AOE | 1.585 | 130.196 | 92.362 | 过 |
+| dungeon | 素砖 | MAGIC/AOE | 1.268 | 114.266 | 92.362 | 过 |
+| dungeon | 裂纹 | BUFF/HEAL | 1.270 | 165.242 | 145.992 | 过 |
+| dungeon | 裂纹 | BUFF/PIERCE | 1.583 | 165.242 | 130.196 | 过 |
+| dungeon | 裂纹 | BUFF/MAGIC | 1.979 | 165.242 | 114.266 | 过 |
+| dungeon | 裂纹 | BUFF/AOE | 2.510 | 165.242 | 92.362 | 过 |
+| dungeon | 裂纹 | HEAL/PIERCE | 1.247 | 145.992 | 130.196 | 过 |
+| dungeon | 裂纹 | HEAL/MAGIC | 1.559 | 145.992 | 114.266 | 过 |
+| dungeon | 裂纹 | HEAL/AOE | 1.977 | 145.992 | 92.362 | 过 |
+| dungeon | 裂纹 | PIERCE/MAGIC | 1.250 | 130.196 | 114.266 | 过 |
+| dungeon | 裂纹 | PIERCE/AOE | 1.585 | 130.196 | 92.362 | 过 |
+| dungeon | 裂纹 | MAGIC/AOE | 1.268 | 114.266 | 92.362 | 过 |
+| dungeon | 碎石斑 | BUFF/HEAL | 1.282 | 164.957 | 144.992 | 过 |
+| dungeon | 碎石斑 | BUFF/PIERCE | 1.598 | 164.957 | 129.269 | 过 |
+| dungeon | 碎石斑 | BUFF/MAGIC | 2.001 | 164.957 | 113.266 | 过 |
+| dungeon | 碎石斑 | BUFF/AOE | 2.536 | 164.957 | 91.434 | 过 |
+| dungeon | 碎石斑 | HEAL/PIERCE | 1.247 | 144.992 | 129.269 | 过 |
+| dungeon | 碎石斑 | HEAL/MAGIC | 1.561 | 144.992 | 113.266 | 过 |
+| dungeon | 碎石斑 | HEAL/AOE | 1.979 | 144.992 | 91.434 | 过 |
+| dungeon | 碎石斑 | PIERCE/MAGIC | 1.252 | 129.269 | 113.266 | 过 |
+| dungeon | 碎石斑 | PIERCE/AOE | 1.587 | 129.269 | 91.434 | 过 |
+| dungeon | 碎石斑 | MAGIC/AOE | 1.267 | 113.266 | 91.434 | 过 |
+| underdark | 素砖 | BUFF/HEAL | 1.248 | 161.080 | 141.829 | 过 |
+| underdark | 素砖 | BUFF/PIERCE | 1.549 | 161.080 | 125.179 | 过 |
+| underdark | 素砖 | BUFF/MAGIC | 1.969 | 161.080 | 109.389 | 过 |
+| underdark | 素砖 | BUFF/AOE | 2.637 | 161.080 | 87.485 | 过 |
+| underdark | 素砖 | HEAL/PIERCE | 1.241 | 141.829 | 125.179 | 过 |
+| underdark | 素砖 | HEAL/MAGIC | 1.577 | 141.829 | 109.389 | 过 |
+| underdark | 素砖 | HEAL/AOE | 2.112 | 141.829 | 87.485 | 过 |
+| underdark | 素砖 | PIERCE/MAGIC | 1.271 | 125.179 | 109.389 | 过 |
+| underdark | 素砖 | PIERCE/AOE | 1.702 | 125.179 | 87.485 | 过 |
+| underdark | 素砖 | MAGIC/AOE | 1.339 | 109.389 | 87.485 | 过 |
+| underdark | 裂纹 | BUFF/HEAL | 1.245 | 164.152 | 144.902 | 过 |
+| underdark | 裂纹 | BUFF/PIERCE | 1.524 | 164.152 | 129.106 | 过 |
+| underdark | 裂纹 | BUFF/MAGIC | 1.952 | 164.152 | 112.461 | 过 |
+| underdark | 裂纹 | BUFF/AOE | 2.612 | 164.152 | 90.557 | 过 |
+| underdark | 裂纹 | HEAL/PIERCE | 1.224 | 144.902 | 129.106 | 过 |
+| underdark | 裂纹 | HEAL/MAGIC | 1.567 | 144.902 | 112.461 | 过 |
+| underdark | 裂纹 | HEAL/AOE | 2.097 | 144.902 | 90.557 | 过 |
+| underdark | 裂纹 | PIERCE/MAGIC | 1.280 | 129.106 | 112.461 | 过 |
+| underdark | 裂纹 | PIERCE/AOE | 1.713 | 129.106 | 90.557 | 过 |
+| underdark | 裂纹 | MAGIC/AOE | 1.338 | 112.461 | 90.557 | 过 |
+| underdark | 碎石斑 | BUFF/HEAL | 1.252 | 158.152 | 138.829 | 过 |
+| underdark | 碎石斑 | BUFF/PIERCE | 1.538 | 158.152 | 123.106 | 过 |
+| underdark | 碎石斑 | BUFF/MAGIC | 1.981 | 158.152 | 106.461 | 过 |
+| underdark | 碎石斑 | BUFF/AOE | 2.658 | 158.152 | 84.557 | 过 |
+| underdark | 碎石斑 | HEAL/PIERCE | 1.229 | 138.829 | 123.106 | 过 |
+| underdark | 碎石斑 | HEAL/MAGIC | 1.583 | 138.829 | 106.461 | 过 |
+| underdark | 碎石斑 | HEAL/AOE | 2.123 | 138.829 | 84.557 | 过 |
+| underdark | 碎石斑 | PIERCE/MAGIC | 1.288 | 123.106 | 106.461 | 过 |
+| underdark | 碎石斑 | PIERCE/AOE | 1.728 | 123.106 | 84.557 | 过 |
+| underdark | 碎石斑 | MAGIC/AOE | 1.341 | 106.461 | 84.557 | 过 |
+| deep_underdark | 素砖 | BUFF/HEAL | 1.265 | 145.437 | 126.186 | 过 |
+| deep_underdark | 素砖 | BUFF/PIERCE | 1.585 | 145.437 | 109.748 | 过 |
+| deep_underdark | 素砖 | BUFF/MAGIC | 2.040 | 145.437 | 93.746 | 过 |
+| deep_underdark | 素砖 | BUFF/AOE | 2.734 | 145.437 | 71.914 | 过 |
+| deep_underdark | 素砖 | HEAL/PIERCE | 1.253 | 126.186 | 109.748 | 过 |
+| deep_underdark | 素砖 | HEAL/MAGIC | 1.613 | 126.186 | 93.746 | 过 |
+| deep_underdark | 素砖 | HEAL/AOE | 2.162 | 126.186 | 71.914 | 过 |
+| deep_underdark | 素砖 | PIERCE/MAGIC | 1.287 | 109.748 | 93.746 | 过 |
+| deep_underdark | 素砖 | PIERCE/AOE | 1.725 | 109.748 | 71.914 | 过 |
+| deep_underdark | 素砖 | MAGIC/AOE | 1.340 | 93.746 | 71.914 | 过 |
+| deep_underdark | 裂纹 | BUFF/HEAL | 1.263 | 147.509 | 128.259 | 过 |
+| deep_underdark | 裂纹 | BUFF/PIERCE | 1.562 | 147.509 | 112.536 | 过 |
+| deep_underdark | 裂纹 | BUFF/MAGIC | 2.028 | 147.509 | 95.818 | 过 |
+| deep_underdark | 裂纹 | BUFF/AOE | 2.720 | 147.509 | 73.986 | 过 |
+| deep_underdark | 裂纹 | HEAL/PIERCE | 1.237 | 128.259 | 112.536 | 过 |
+| deep_underdark | 裂纹 | HEAL/MAGIC | 1.606 | 128.259 | 95.818 | 过 |
+| deep_underdark | 裂纹 | HEAL/AOE | 2.154 | 128.259 | 73.986 | 过 |
+| deep_underdark | 裂纹 | PIERCE/MAGIC | 1.298 | 112.536 | 95.818 | 过 |
+| deep_underdark | 裂纹 | PIERCE/AOE | 1.742 | 112.536 | 73.986 | 过 |
+| deep_underdark | 裂纹 | MAGIC/AOE | 1.341 | 95.818 | 73.986 | 过 |
+| deep_underdark | 碎石斑 | BUFF/HEAL | 1.268 | 142.509 | 123.186 | 过 |
+| deep_underdark | 碎石斑 | BUFF/PIERCE | 1.593 | 142.509 | 106.748 | 过 |
+| deep_underdark | 碎石斑 | BUFF/MAGIC | 2.055 | 142.509 | 90.746 | 过 |
+| deep_underdark | 碎石斑 | BUFF/AOE | 2.753 | 142.509 | 68.914 | 过 |
+| deep_underdark | 碎石斑 | HEAL/PIERCE | 1.256 | 123.186 | 106.748 | 过 |
+| deep_underdark | 碎石斑 | HEAL/MAGIC | 1.620 | 123.186 | 90.746 | 过 |
+| deep_underdark | 碎石斑 | HEAL/AOE | 2.170 | 123.186 | 68.914 | 过 |
+| deep_underdark | 碎石斑 | PIERCE/MAGIC | 1.290 | 106.748 | 90.746 | 过 |
+| deep_underdark | 碎石斑 | PIERCE/AOE | 1.728 | 106.748 | 68.914 | 过 |
+| deep_underdark | 碎石斑 | MAGIC/AOE | 1.339 | 90.746 | 68.914 | 过 |
+
+---
+
+机检 17 项，FAIL 0 项。
+
+目检（S3）归用户，判定见下节。
+
+## S3 目检判定（用户在会话中判定，2026-11-06）
+
+| 条 | 判据（方案 §2.2） | 判定 |
+|---|---|---|
+| 1 | 正图段 45 格逐格指认微光属哪一组（五选一），45/45 | 过 |
+| 2 | 灰度副本段（Rec.709 去色＝色弱通道）重做第 1 条，45/45 | 过 |
+| 3 | 阶梯序相邻 36 对逐对判可分辨，全对可分 | 过 |
+| 4 | 裂纹／碎石斑两种装饰变体底上 30 格：微光仍可指认且装饰不成第二焦点 | 过 |
+
+判定口径＝用户回话「没有问题，我觉得是可以分清楚的」，经追问四条覆盖范围后答「四条全过」。
+
+## S4 抽测结论
+
+抽测通过：机检 17 项 FAIL 0 ＋ 目检四条全过。
+
+同批生效的口径订正：铺底代表值改为从三块底型瓦片像素实测（线性域相对亮度取大），不再引用换色脚本的锚槽表值；dungeon 实测 `#B49069`（L=0.307，过门余量 0.007）。样图逐字节未变（sha256 `15d33fabb752566772540f436ca992fc71b0074fd5da71ff398a9b6bbb789087`，与 2026-11-05 出图件一致），故 S3 目检结论继续有效。

reports/需求卡片-卷轴视口批-2026-11-05.md

@@ -1,140 +0,0 @@
-# 需求卡片：卷轴视口批（关卡画面选路屏视口化）
-
-- 来源：[待办清单](../待办清单.md)「超预算图策略升级路径——等比缩放与滚动视口两案待裁」条（状态＝文档设计已闭合＋待写卡，2026-11-05 用户裁滚动视口案落地）。
-- **唯一事实源**：[level-map.md v2.0](../design/gdd/ux/level-map.md) §布局决策 5（行为四条表 ：101–104＋内嵌视口效果图 ：108–153＋像素级视觉判据 ：154）＋[关卡节点图生成.md v1.5](../design/gdd/systems/冒险循环/关卡节点图生成.md) §参数契约（图规模无呈现侧上限）。设计讨论四口子与效果图人审均 2026-11-05 用户裁决在案。
-- **验收档：中**（呈现交互面——玩家可见但不损持久状态；无存档写读、无结算公式、无 RNG 触碰；批卡 U0 时确认或改判）。
-
-## 1. 目标与完成定义
-
-关卡画面（选路屏）落卷轴视口范式：画布随图生长可超屏，屏为窗口——①视口锚点＝当前节点居中；②停点切换与兑付回图平滑滚动跟随（减动效瞬切）；③拖拽＋滚轮手动平移（clamp 画布包络、拖拽不触发选路）；④屏缘渐隐带＋平移提示 chip 指引。
-
-完成定义：验证闸对照表 R1–R9 全部有绿读数；场景探针家族扩展件当轮真实跑批通过；代码域闸全绿；用户实机目检「深度 13 图拖拽可达首末列、推进跟随方向感」登记不阻塞。
-
-## 2. 现状事实（开工自行复核）
-
-- [level_map_screen.gd:26-32](../game/presentation/views/level_map_screen.gd) 冻结公式常量：`LAYER_BASE_X=70`／`LAYER_STEP_X=122`／`SLOT_BASE_Y=52`／`SLOT_STEP_Y=58`／`NODE_ICON_PX=20.0`／`NODE_HALF(36.5,25)`（52×36 的 1.4× 绘制）／`HIT_PAD=6.0`。
-- [level_map_screen.gd:66-69](../game/presentation/views/level_map_screen.gd) `_content_size(620,240)`、`_layout_cache`——`open_choices` 按图拟合画布尺寸。
-- [level_map_screen.gd:77-82](../game/presentation/views/level_map_screen.gd) 画布由 `CenterContainer`（`PRESET_FULL_RECT`）承载：整幅居中、无裁切无平移——超屏图（L3 层深 13，画布宽 1700.5px）两侧各 ~210px 出屏。
-- [level_gen_params.tres:41](../game/data/tables/level_gen_params.tres) L3 `layers=13`——深度 13 是现行定值，非极端情形。
-- [level_gen_params.gd:3-4、:69](../game/data/schemas/level_gen_params.gd) 头注「域校验沿关卡节点图生成.md v1.1 调参表已锁条款」「域并单点（关卡节点图生成.md v1.4 调参表）」——owner 文档已 v1.5 换代参数契约节，指针失效待反转（本卡 T4 随动）。
-- [ui_kit.gd:231-232](../game/presentation/views/ui_kit.gd) `UiKit.motion(dur)` 呈现层 tween 时长单点包装（减动效面）。
-- [ui_struct_probe.gd:204](../game/probe/ui_struct_probe.gd) `_audit("level_map", ...)` 既有结构审计锚；[golden/README.md:8](../game/tests/golden/README.md) level_map 全屏 golden＝历史留根、现行闸件未对拍（本批不触渲染闸对拍）。
-- 全文件 662 行——超 code-conventions §1.1 的 ~400 行审视线，视口承载拆件有据。
-
-## 3. 设计契约（违反＝L3 停机呈报）
-
-- 🔴 **冻结值零改动**：节点图标 20px 烘焙 1:1、通道折线 2/3/4px、画布公式（宽=70+层深×122+44.5、高=52+槽位×58+25+24、下限 620×256）、节点方块 52×36×1.4 绘制、编号 10px——视口批只加行为，不动任何像素冻结件（level-map.md:69、:154）。
-- 🔴 **视口纯呈现态**：平移位置零核心写、不进存档（重进本屏按锚点规则重新定位）；Core 层零触碰、RNG 零触碰（level-map.md:103 行、:107 视口为纯呈现态句）。
-- 🔴 **选路唯一通道**：图上点击提交语义零改动；拖拽超阈值不得触发选路提交（level-map.md:103）。
-- 🔴 **零自动推进**：视口跟随只随停点切换/兑付回图发生，不构成任何自动前进路径（level-map.md:141 零自动推进纪律不变）。
-- 🔴 **拆分边界纪律**（code-conventions §1.1，2026-10-28 用户裁）：每个拆出单元有可陈述职责语句与单一变化原因；拆出单元有集体身份；「过阈值」只作发现信号；拆不出内聚单元＝停卡走豁免通道，禁硬拆凑绿。
-- 🔴 **禁为机检文本保留无效成员**（code-conventions §1.1⑤）：机检键与卡片契约互斥＝停卡呈报，禁自造第三条路。
-
-## 4. 范围边界
-
-做：视口承载件、锚点跟随、平滑滚动、减动效瞬切、拖拽/滚轮平移、clamp、渐隐带与提示 chip、探针断言、schema 头注指针反转。
-不做：缩放与缩略图（等比缩放案已否决）、其余视口暗示形态（边缘回弹等——布局决策 5 注后置）、顶栏/底栏/放弃按钮/覆盖层改动、生成器与参数表改动、键盘/手柄输入（排 Beta）。
-
-## 5. 关联文档同步面
-
-| 文档 | 关联点 | 同步义务 |
-|---|---|---|
-| [level-map.md](../design/gdd/ux/level-map.md) v2.0 | 布局决策 5 行为实现与 AC :260–271——实现若发现 spec 缺口 | 设计权威——实现批禁写，缺口逐条列反哺点清单由文档批落 |
-| [game/tests/README.md](../game/tests/README.md) 能力清单 | 本卡新增能力行三行（写卡段已同批落表，见 §8 能力行列） | 机械面——实现批禁写；批末收尾核对表上名与落地一致（改名则回表） |
-| [level_gen_params.gd](../game/data/schemas/level_gen_params.gd) | 头注 ：3-4/:69 指针失效（owner 已 v1.5 参数契约） | 本卡 T4 随批反转指针（非行为改动——`game/` 内实现批可写面） |
-| [关卡节点图生成.md](../design/gdd/systems/冒险循环/关卡节点图生成.md) v1.5 | 无——本批实现不改变其任何陈述 | 无同步义务 |
-
-## 6. 文件结构图（行为改动→对照表行互指）
-
-| 文件 | 职责 | 改动性质 |
-|---|---|---|
-| `game/presentation/views/level_map_viewport.gd` | 新增——卷轴视口承载件：画布宿主与裁切、平移状态与 clamp、锚点跟随、平滑滚动、指引件（拖拽/滚轮判定留画布 `_gui_input`——事件流同源） | 行为改动（R2–R8）·新增 |
-| `game/presentation/views/level_map_screen.gd` | 修改——CenterContainer 承载换视口件；停点切换/回图接线 `reanchor()`；`_content_size` 拟合后调 `reanchor(false)` 首锚 | 行为改动（R1＋R2/R3 随动）·复用既有文件 |
-| `game/data/schemas/level_gen_params.gd` | 修改——头注指针反转（owner 单点改为本文件域校验＋参数契约指针） | 非行为改动（R9）·复用既有文件 |
-| `game/probe/level_map_viewport_probe.gd` + `.tscn` | 新增——视口行为场景探针（真输入驱动） | 行为改动（R2–R8 验收载体）·新增 |
-| `game/probe/probe_ui_util.gd` | 修改——新增拖拽沿与滚轮沿真输入合成工具 `push_drag_at`／`push_wheel_at`（沿 `push_click_at` :717-733 同式；探针共用面唯一落点） | 非行为改动（探针侧工具）·复用既有文件 |
-
-## 7. 任务卡 T0..T4
-
-### T0 读数与基线（0.5 工作日）
-- [ ] 核对 `tools/gdstyle_baseline.txt` 有无 `level_map_screen` 相关 S13 键；有则记录登记值（改后只降不升），无则记「无键、按工具默认」
-- [ ] 跑场景探针现状读数：`…console.exe --headless --path . res://probe/ui_struct_probe.tscn`（level_map 审计段绿）＋ `res://probe/screen_flow_probe.tscn`——读数记入本步提交信息
-- [ ] 跑冒烟 `python tools/run_smoke.py`——基线读数在案
-
-### T1 视口承载件与手动平移（1–1.5 工作日）
-- [ ] 新增 `level_map_viewport.gd`（接口块见 §10）：`setup(canvas, anchor_provider, viewport_size)`、`pan_by(delta)`、`viewport_center_canvas_pos() -> Vector2`、`is_clamped_at_edge() -> bool`；`clip_contents=true`；成员 ≤8
-- [ ] `level_map_screen.gd` 承载改造：CenterContainer 换视口件实例；`open_choices` 拟合后调 `reanchor(false)` 首锚（入口停点锚入口组、其余锚当前节点——`anchor_provider` 由 screen 提供画布坐标）
-- [ ] 拖拽/滚轮判定落**画布既有 `_gui_input`**（画布已持有鼠标事件流——悬停/选路同源，禁在视口件层做父子事件路由竞争；视口件只管裁切/offset/clamp/跟随）：拖动距离阈值（provisional 8px）判定，超阈值进拖拽态逐帧调 `viewport.pan_by()`；滚轮横滚映射 `pan_by`（代拍板：滚轮下＝向右/前进向）
-- [ ] clamp：`pan_by` 后 offset 收敛在画布包络内（`viewport_center_canvas_pos()` 画布坐标恒在 `[half_view, canvas_size-half_view]` 夹紧域；**画布小于视口＝居中分支**——夹紧域退化为居中定位）；探针宿主沿 ui_struct_probe :204 同款（组合根真实屏 `main.ui.modals.run.level_screen`），禁合成投喂替代真实路径
-- [ ] 探针 `level_map_viewport_probe.gd`：断言 R3（拖拽移视口）、R4（滚轮移视口）、R5（clamp 边界）、R6（拖拽不触发选路——`route_chosen` 零发射）；真实入口＝probe_ui_util 合成沿走 `push_input`
-
-### T2 锚点跟随与平滑滚动（0.5–1 工作日）
-- [ ] `reanchor(smooth)`：目标 offset＝锚点画布坐标−视口半宽（居中）；`smooth=true` 走单段缓动 tween 时长 `UiKit.motion(0.3)`（provisional）；`smooth=false` 即达；重入先杀在飞 tween 再建新（快速连续停点切换防叠加）
-- [ ] 减动效：`UiKit.motion` 通道既有减动效语义下滚动跳终态——探针断言 R7（减动效开＝位置即达，无 tween 中间帧）
-- [ ] level_map_screen.gd 停点切换与兑付回图路径接 `reanchor(true)`——入口停点锚入口节点组（多入口取组包围盒居中）
-- [ ] 探针断言 R2（停点切换后当前节点画布坐标投影＝视口中线 x=640±2）
-
-### T3 指引件（0.5 工作日）
-- [ ] 视口件内渐隐带：屏缘左右各 70px 渐变（色取屏底同族——代拍板渐变 stops）；浅图画布不超屏时渐隐带隐藏（无暗示必要）
-- [ ] 平移提示 chip：240×30 圆角 6、深底石灰描边、文案「◄ 拖拽画布 / 滚轮平移 ►」14px；图区底部居中（level-map.md:104）
-- [ ] 探针断言 R8（渐隐带与 chip 可见性＋几何判据——像素级判据②③，level-map.md:154）
-
-### T4 指针反转与收口（0.5 工作日）
-- [ ] `level_gen_params.gd` 头注 ：3-4/:69 反转：「取值域与字段契约单点＝本文件域校验；概念与设计意图＝关卡节点图生成.md v1.5 参数契约节」（非行为改动——grep 判据 R9）
-- [ ] 全探针最窄回归：ui_struct_probe level_map 段＋screen_flow_probe 复跑绿（波内修复只做出红最小单元的最窄确认）
-- [ ] 产出物落位：`reports/iter<N>-实现报告-<日期>.md`（各卡状态＋实机目检总清单＋实现决定记录）＋ `reports/iter<N>-反哺点-<日期>.md`（同步面所列逐条落点）——轻闸全绿后、合并前写齐
-
-估时合计：3–4.5 工作日（中值 3.5）。
-
-## 8. 验证闸（改动—验收对照表）
-
-| 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
-|---|---|---|---|---|---|---|
-| R1 浅图整幅居中无裁切＋画布入视口件承载（锚 design/gdd/ux/level-map.md:260） | level_map_screen.gd（CenterContainer→viewport 件） | `level_map_viewport_probe.gd:_probe_shallow_no_crop`〔卷轴批 V1〕 | 探针 | 场景探针实例化本屏＋open_choices 真实停点 | 画布尺寸≤视口时居中分支 offset 定位、无裁切 | 新增：关卡画面视口跟随 |
-| R2 视口锚点：停点切换/回图后当前节点居中 x=640±2（锚 design/gdd/ux/level-map.md:101、:269） | level_map_viewport.gd `reanchor`＋screen 接线 | `level_map_viewport_probe.gd:_probe_follow_anchor`〔卷轴批 V2〕 | 探针 | 合成推进停点切换经真实屏流程 | 当前节点画布坐标经 `viewport_center_canvas_pos()` 投影＝640±2 | 新增：关卡画面视口跟随 |
-| R3 拖拽平移移动视口（锚 design/gdd/ux/level-map.md:103） | 画布 `_gui_input`（level_map_screen.gd）拖拽态调 `pan_by` | `level_map_viewport_probe.gd:_probe_drag_pan`〔卷轴批 V3〕 | 探针 | `ProbeUiUtil.push_drag_at` 拖拽沿走 `push_input` | `_offset` 位移量＝拖拽位移（clamp 前） | 新增：关卡画面视口平移 |
-| R4 滚轮横滚移动视口（锚 design/gdd/ux/level-map.md:103） | 画布 `_gui_input` wheel 分支调 `pan_by` | `level_map_viewport_probe.gd:_probe_wheel_pan`〔卷轴批 V4〕 | 探针 | `ProbeUiUtil.push_wheel_at` 合成滚轮沿走 `push_input` | `_offset` 位移＝滚轮步进映射 | 新增：关卡画面视口平移 |
-| R5 clamp 边界与首末列可达：不出露屏底空档、拖拽两极首列与末列（含 Boss）入屏（锚 design/gdd/ux/level-map.md:103、:260） | `pan_by` 收敛逻辑＋包络两极 | `level_map_viewport_probe.gd:_probe_clamp_bounds`〔卷轴批 V5〕 | 探针 | 极端拖拽沿（超包络、两极到边） | `viewport_center_canvas_pos()` 恒在夹紧域；浅图居中分支；`is_clamped_at_edge()` 翻转；两极时深度 0 与深度 13 列中心入视口 | 新增：关卡画面视口平移 |
-| R6 拖拽不触发选路提交（锚 design/gdd/ux/level-map.md:103） | 画布 `_gui_input` 阈值判定（provisional 8px） | `level_map_viewport_probe.gd:_probe_drag_no_submit`〔卷轴批 V6〕 | 探针 | 拖拽沿起止于候选节点上方 | `route_chosen` 零发射＋屏幕未关 | 新增：关卡画面视口平移 |
-| R7 平滑滚动与减动效瞬切（锚 design/gdd/ux/level-map.md:102、:188、:227） | `UiKit.motion(0.3)` tween／减动效跳终态 | `level_map_viewport_probe.gd:_probe_smooth_scroll_reduced_motion`〔卷轴批 V7〕 | 探针 | 停点切换＋设置面减动效置位 | smooth=true 有 tween 中间帧；减动效开＝位置即达 | 新增：关卡画面视口跟随 |
-| R8 指引件：渐隐带 70px＋chip 240×30 呈现（锚 design/gdd/ux/level-map.md:104、:154） | 视口件指引子件 | `level_map_viewport_probe.gd:_probe_guidance_chrome`〔卷轴批 V8〕 | 探针 | 深图 open_choices 真实停点 | 像素级判据②③（level-map.md:154）——可见性＋几何 | 新增：关卡画面视口指引 |
-
-非行为改动行：schema 头注指针反转（level_gen_params.gd:3-4/:69）——判据＝全仓无「域并单点＝调参表」残留、头注含「参数契约节」指向（锚 design/gdd/systems/冒险循环/关卡节点图生成.md:109）；由 §6 文件结构图该行覆盖，T4 落步，实现报告对照表列非行为改动行。
-锚行核对义务：开工时行号以当版文件为准（本卡锚基于 v2.0/v1.5 抄录）。
-
-- 测试方式两分法：R1–R8 全走探针自动化（调试注入不适用——本卡零数据面改动，状态经真实停点与真实输入驱动）；用户目检项＝「深度 13 图拖拽可达首末列、跟随方向感、chip 不碍选路」登记进实现报告实机目检总清单（登记不阻塞）。
-- 回归措辞：里程碑步（T 段）出口跑一次场景探针族全套；波内修复只做出红最小单元的最窄确认；新增探针先行孤立验证再并入全套。
-- 测试削弱申报：无删旧断言申报；ui_struct_probe level_map 段既有审计判据不改——承载改造若触其结构断言面，适配性调整须在实现报告申报并保持判据语义。
-- 独立验收审计：`reports/iter<N>-验收审计-<日期>.md`，由未参与实现的会话执行；本卡验收档＝中，审计深度按 test-conventions §8.7 中档执行（对照表逐行全量、判据绑定面抽查、削弱检查逐处、直查例外逐条、最窄复跑以远端 CI 现查读数代证）。
-
-## 9. 异常分级
-
-- L1 自救：探针断言红→改后只跑出红探针的最小单元；闸红只跑红件。
-- L2 记录继续：画布 `_gui_input` 内拖拽态与悬停/选路命中分支次序的调整、渐变/chip 视觉微调（provisional 区间内）、S13 读数波动在只降不升约束内的消化。
-- L3 停机写报告等用户：触碰 §3 任一 🔴；S13 键上升且无法只降；拆不出内聚单元；机检预算互斥＝上游缺陷停卡退回写卡段；拖拽误触选路提交且路由层面消不掉。
-
-## 10. 落位与可复用性预检
-
-- **level_map_viewport.gd（新增）**：不复用 `ScrollContainer`——其滚动条 UI、焦点/滚动语义与本屏「纯鼠标、无滚动条、锚点居中跟随」冲突，且平滑滚动与 clamp 语义仍需全自管；承载裁切用 Control `clip_contents`（引擎内建，项目已有 clip 先例）。唯一面：视口 offset 状态只落本件（screen 的 `_layout_cache` 仍管布局、不管视口）；全仓 grep 无第二处视口/平移逻辑。分层：呈现层内部子件——构造注入（canvas/anchor_provider/viewport_size 一次交齐，code-conventions §1.6 拆分交接）；读核心只读面经 screen 既有出口，零新增核心触点。
-- **probe_ui_util.gd 增补（复用既有文件）**：`push_drag_at`／`push_wheel_at` 落探针共用面唯一落点——禁另起工具文件散落；`push_click_at`（ui_input_probe :717-733 同式）点击沿同式扩展。
-- **指引件（渐隐带/chip）**：随视口件承载（同职责：视口呈现行为）；不立独立文件——拆出「命不出名字的打包」即凑计数袋。
-- **level_gen_params.gd 头注反转（复用既有文件）**：注释单行改动，无新增件。
-
-## 11. 实现规范预算
-
-- **新增 level_map_viewport.gd 三查**：①接口块公开方法 4（setup/pan_by/viewport_center_canvas_pos/is_clamped_at_edge）≤20 ✓；②成员变量 ≤8（_canvas/_anchor_provider/_viewport_size/_offset/_tween/_drag_active/_drag_accum/_guided_visible）≤15 ✓；③无迁移函数（新件零存量函数迁入——screen 侧只是接线改造，hover/命中逻辑零迁移）。
-- **存量触面**：level_map_screen.gd——T0 记 S13 键基线；本批改动为承载替换与 reanchor 接线，预期键值持平或只降；达成手段＝T4 复跑 S13 对账。
-- 指标例外：无申报。
-
-## 12. 代拍板白名单
-
-1. 画布 `_gui_input` 内拖拽态与悬停/选路命中的事件分支次序（红线＝R6 判据不破）。
-2. 拖拽距离阈值具体值（8px 附近 provisional 区间内定值）。
-3. 平滑滚动缓动曲线类型（单段缓动家族内选型）。
-4. 渐隐带渐变 stops 与 chip 深底/描边色值（art-bible §4.1 冻结色板同族取值）。
-5. 滚轮方向映射（下＝向右/前进向）。
-超清单决定记入实现报告「实现决定记录」节。
-
-## 13. 待裁点
-
-零待裁点，开工门＝U0（四口子与效果图 2026-11-05 用户已裁决；验收档「中」随批卡确认）。

reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md

@@ -1,267 +0,0 @@
-# 需求卡片·改写族孤儿机制与退役名清退批（2026-11-05）
-
-来源：待办清单条目「damage_controller 按序改写族——内容孤儿机制与退役名注释层」（2026-11-04 登记，来源=会话提及）。
-唯一事实源：`design/gdd/systems/跨局循环/锻造工坊.md` v0.13 §满级特效扩展位（本期已按本批口径订正）＋本卡「现状事实」所列代码读数；机制处置与注释口径的裁决记录＝2026-11-05 会话，用户裁「只要有问题的都要改」，退役内容名一律清退、零现役注册的改写分支一律摘除。
-验收档：中（一处玩家可见明细行文案换代＋若干不可达分支摘除；不写存档、不改乘区公式与数值表）。
-估时：2.25–2.75 个工作日（T0 0.25＋T1 0.5＋T2 0.5＋T3 0.5–1＋T4 0.25＋T5 0.25 加总）。切分预案：T3 注释面若单轮改不完，按文件切成 T3a（core 八件）／T3b（schemas＋sim＋tests），两张各自收尾，不并进 T1。
-
----
-
-## 1 目标与完成定义
-
-做完这五件事算完：
-
-1. 主角先手攻击的四个改写分支摘除——它们零数据表行注册，游戏里从不执行。
-2. 连带收窄两处引擎词表：`EFFECT_KINDS` 摘 `spike`、`DO_KEYS` 摘 `trade_hit`/`trade_atk`，并同批补负域探针取证。
-3. `game/` 注释面退役内容名清零（42 行/13 文件），只换名不换职责陈述。
-4. 三处挂退役件名的玩家可见文案改中性机制文案（其中一处今天可达），一处 sim 死匹配删除。
-5. 产出物两份写齐（实现报告＋反哺点清单），代码域闸全绿，改前改后对拍逐位一致。
-
-判据总口径：本批除第 4 项文案外全部是非行为改动——零现役注册行＝分支不可达＝删了也不改变任何一帧输出。这条不靠感觉，T0 用三条 grep 读数坐实。
-
-## 2 设计事实源
-
-- 设计线闭合凭据：`design/gdd/systems/跨局循环/锻造工坊.md` v0.13（2026-11-05）§满级特效扩展位——本批订正该节四处陈述，其中重甲反震与长枪先手连击两条候选的代价档由「零新代码」改判「需新代码」，效果类型闭集词数不再抄进文档。
-- 机制处置裁决：本卡所属待办条目「实况」段所载 2026-11-05 会话裁决。
-- 代码现状取证：本卡第 3 节全部带 `文件:行号`，无一条凭记忆。
-
-## 3 现状事实
-
-### 3.1 四个改写分支零注册（本批要摘的）
-
-| 分支 | 代码位置 | 触发条件 | 现役注册行 | 退役名注释 |
-|---|---|---|---|---|
-| 命中交换 | `game/core/damage_controller.gd:297-302`（命中侧）、`:351-353`（增伤侧） | `kind=modify_ticket` 且载荷带 `trade_hit`/`trade_atk` | 0 行（`game/data/tables/` 全域零命中） | :285-286、:341、:350（矿工重锤） |
-| 免掷恒折扣 | `:305-309` | `kind=modify_ticket` 且 `mode=armor_rewrite` | 0 行 | :287（专注） |
-| 满层必中与倍乘 | `:310-313`（必中置位）、`:368-372`（倍乘） | `kind=modify_ticket` 且 `mode=spike` | 0 行 | :288（厚积薄发，行内含 spike）、:342 与 :368 |
-| 轻甲折扣档改善 | `:320-323` ＋私有函数 `_discount_shift_up`（`:623`） | `kind=modify_ticket` 且 `mode=discount_shift` | 0 行 | :288、:622（猎弱本能） |
-
-穿线键 `spike_ready` 出现在 `:282`、`:310`、`:313`、`:325`、`:369` 五处，随分支一起消失。
-
-克制点数面（`mode=clamp_bonus`）有现役一行注册：`game/data/tables/feats.tres:853-857` 淬毒刃纹（`kind=modify_ticket`／`mode=clamp_bonus`／`delta=2`）——**不摘**，`_ctx_clamp_delta`（`:333-338`）与 `clamp_check` 发射点（`:315`）保持原样。
-
-### 3.2 两处词表在册
-
-- `game/core/effect_engine.gd:30` `EFFECT_KINDS` 含 `"spike"`；该常量实数 32 词（本卡现读，摘后 31）。全仓按 `kind == "spike"` 派发效果的代码**不存在**——`spike` 只在词表与注释里在册（另两处：`:30` 词表、`:452` 「任意真族（任一命中即生效）：spawn_spell、spike」注释）。
-- `game/core/effect_engine.gd:82` `DO_KEYS`（现 26 键）含 `"trade_atk"`, `"trade_hit"`；执法点在 `:417`（`if not DO_KEYS.has(String(k))` 出域即拒绝）。摘后 24 键。
-- `attack_segments` 不属本批：它已随架构审查整改甲案整链退役（`grep -r attack_segments game/` 仅命中 `game/tests/unit/data_config/effect_kind_retired_test.gd:3` 的注释），本批只把它在 GDD 里的错句一并订正（见第 6 节）。
-
-### 3.3 注释面退役名全仓扫描读数
-
-名单来源＝`design/content-archive/道具退役素材库.md` 两张表的「原名」列，共 41 名；减去表内仍作为现役 `display_name` 出现的 1 名（淬毒刃纹）＝40 名。扫 `game/` 全域 `.gd`/`.tres`/`.md` 命中 **53 行/13 文件**，无一条落在 `.tres` 数据表里。
-
-| 文件 | 注释面行号（本批改） | 字面量行号 | 字面量处置 |
-|---|---|---|---|
-| `game/core/damage_controller.gd` | 109、138、285、287、288、328、341、350、394、424、622 | — | — |
-| `game/core/reward_grant.gd` | 2、130、183、221 | 189、226 | 两处都改中性文案（T4） |
-| `game/core/settlement/grant_segment.gd` | 127、128、232、240、265、279、283、351、362、373 | 166 | 玩家可见标签改中性（T4） |
-| `game/core/reward_roller.gd` | 1、41、46、86 | — | — |
-| `game/core/effect_engine.gd` | 64、65、157、452 | — | 452 随 T1 摘词改写 |
-| `game/core/battle_orchestrator.gd` | 258、538 | — | — |
-| `game/core/action_economy.gd` | 82 | — | — |
-| `game/data/schemas/treasure_item_table.gd` | 20、122 | — | — |
-| `game/sim/adventure_monte_carlo.gd` | 75 | — | — |
-| `game/sim/level_autoplay.gd` | 415 | 421 | 死匹配删除（T4）；415 随删该处注释 |
-| `game/tests/unit/core/meta_progression_forge_test.gd` | 677、690 | 694、697、699、700 | 断言串随 T4 文案换代（申报见第 8 节） |
-| `game/tests/unit/battle_settlement/variant_placement_test.gd` | 239 | — | — |
-| `game/tests/unit/core/treasure_items_test.gd` | — | 31、33、35 | 不动——StubDB 自造夹具名，不宣称内容现役 |
-
-字面量合计 11 行：本批动 8 行（三文件的四处文案/死串＝`reward_grant:189`/`:226`、`grant_segment:166`、`level_autoplay:421`，加锻造测试四处断言串 `694`/`697`/`699`/`700`），其余 3 行夹具名保留。注释面 42 行全改，另加 `effect_engine.gd:452` 一句随摘词改写＝本批改写 43 处。
-
-### 3.4 玩家可见文案三处
-
-- `game/core/reward_grant.gd:226`：`mine_hit` 减半路径发射的结算明细行标签——`"惊巢反制——危险格挖掘惩罚减半（%d→%d）" % [...]`，载荷 `"effect_id": "nest_counter"`。`惊巢反制` 与 `nest_counter` 都是退役件名（素材库表一 :18），而这行文案是玩家能看见的，且这条路径今天可达（有现役锻造锋行驱动——`meta_progression_forge_test.gd:694-700` 正在钉它）。
-- `game/core/reward_grant.gd:189`：`_cell_removal_open` 空集拒绝 reason——`"爆破工兵包：3×3 区域内无可移除危险格（须未揭示且未封印）"`。该通道 `cell_removal` 在册（`game/data/schemas/treasure_item_table.gd:26`、消费点 `reward_grant.gd:160-161`）但零现役数据行（`game/data/` 全域零命中），所以 reason 今天不可达；文案仍挂退役件名。通道本体不进本批（见第 5 节），本批只清文案。
-- `game/core/settlement/grant_segment.gd:166`：`mine_hit` 订阅中 `kind=open_ticket` 且 `channel="reflect"` 的行开单，明细标签硬编码 `"惊巢反制·反弹"`，归因串 `"attune_nest_counter"`。`"reflect"` 在 `game/data/tables/` 二十一张表逐张 grep 零命中 → 今天不可达，与 `:189` 同类问题（标签挂退役件名）。`reflect` 渠道本体不进本批（见第 5 节），本批只清标签与归因串。
-
-### 3.5 一处 sim 死匹配
-
-`game/sim/level_autoplay.gd:421` 用 `String(row.get("display_name", "")).contains("雷区图谱")` 捕高光事件，`:415` 是配套注释。`雷区图谱` 零现役行（`game/data/` 零命中）→ 该条件恒 false。
-
-### 3.6 既有测试面读数（决定本批要不要改测试）
-
-- 四个 mode 与两个键在 `game/tests/`、`game/probe/`、`game/sim/` **零命中**（`grep -rn "trade_hit\|trade_atk\|armor_rewrite\|discount_shift\|spike" game/tests/ game/probe/ game/sim/` 空）。摘分支不动任何既有断言。
-- `armor_roll` 有既有断言：`game/tests/unit/battle_settlement/roll_multiplier_test.gd:125 _smoke_armor_roll()`——它测的是护甲骰与折扣读数，不是订阅消费。所以掷点面 `:293 _armor_roll()` 与发射调用 `:296 _fx_hits("armor_roll", ...)` 都保留（`armor_roll` 在 `effect_engine.gd:13` 事件词表在册），只删 `:305-309` 消费环，`ar_hits` 局部变量随删。
-
-## 4 设计契约
-
-- 🔴 **契约 1｜零现役注册坐实才许摘**：T0 三条 grep 读数必须全为零——`game/data/tables/` 内 `spike`/`armor_rewrite`/`discount_shift`/`trade_hit`/`trade_atk` 各 0 行、`tree_rules` 面 0 行、`effect_kinds` 面 `cell_removal` 0 行（后者只作记录，本批不摘通道）。任一数非零＝该分支可达＝停卡 L3 呈报，禁直接摘。
-- 🔴 **契约 2｜注释改写只换名不换职责**：42 行注释逐处保留「这段在做什么、按什么序、为什么这样取」的陈述，把退役件名替换成机制语言。整行删除、成片缩写、或删注释换 gdstyle 行数绿＝违规（先例：宿主行数压至 999 时「禁删注释凑行数红线未碰」）。
-- 🔴 **契约 3｜文案换代禁碰数值与发射序**：`:226` 只改标签字符串，`[int(row.power), half]` 取值、`emit_cb.call` 参数位序、`"effect_id"` 载荷键一律不动；`:189` 只改 reason 前缀，`{"ok": false}` 形态不动。
-- 🔴 **契约 4｜词表收窄与负域探针同批**：摘 `EFFECT_KINDS` 的 `spike` 与 `DO_KEYS` 的两键，必须同批落 T2 探针；只摘词不取证＝本卡未完成。
-- 🔴 **契约 5｜禁留空壳**：`spike_ready` ctx 键、`ar_hits`/`shift`/`trade_hit` 局部变量、`_discount_shift_up` 函数随分支即删，禁保留空返回、别名或「以后可能用」的成员凑机检文本。
-- 🔴 **契约 6｜实现批禁写文档**：`design/` 整个目录、`待办清单.md`、`体验验证清单.md`、`game/tests/README.md` 一律不写；要改的文档句子全进第 6 节与反哺点清单。
-- 🔴 **契约 7｜零新增数值**：本批不引入任何玩法数值，不改 `.tres` 表值。MC 与 verifier 零跑（无数值改动零跑）。
-
-## 5 范围边界
-
-做：3.1 四段分支＋穿线键＋`_discount_shift_up`；3.2 两处词表摘名；3.3 注释面 43 处；3.4 三处文案；3.5 一处 sim 死匹配；3.6 消费环 `armor_rewrite` 删而发射点留；T2 负域探针；T4 断言串随动。
-
-不做，去向写明：
-
-| 不收件面 | 为什么不做 | 去向 |
-|---|---|---|
-| `EVENTS` 零订阅词普查（含 `armor_roll` 发射点去留） | 与「改写分支」不同轴，是事件词表整体普查 | 待办清单本批同登条目「效果通道与事件词的零现役普查」 |
-| `effect_kinds`／渠道零现役清退（`cell_removal`、`mine_hit_halve`、`open_ticket` 的 `channel="reflect"` 行族） | 通道在册、有消费点、只缺数据行——判「删通道」要连同 schema 词、归因标识与拒绝文案整体裁 | 同上条目，与 iter52 孤儿函数清退批同族 |
-| GDD 其余仍提退役内容名的句子（`systems/冒险循环/奇物.md`、`systems/战斗循环/地图战斗资源.md`、`术语表.md`、`00-游戏概念.md`、`03-内容规模.md`） | 属文档面用语，不属代码批 | 反哺点清单，文档批落文 |
-| `game/tests/unit/core/treasure_items_test.gd:31/33/35` 三个退役件名夹具 | StubDB 自造行，不宣称该件现役；改名动的是测试面 | 无——保留 |
-| `attack_segments` 词表补摘 | 已随甲案退役，本批只在 GDD 订正错句 | 无——已完成 |
-| 结算明细标签是否入表（文案硬编码在 `:226`） | 涉及「呈现文案归属」规范裁决，不属本卡 | 反哺点清单，文档批裁 |
-
-## 6 关联文档同步面
-
-| 文档 | 关联点 | 同步义务 |
-|---|---|---|
-| `design/gdd/systems/跨局循环/锻造工坊.md` §满级特效扩展位 | 闭集词数句、长枪候选代价档、重甲候选代价档、七条前提句 | **已在本批前置文档段落文**（v0.13）；实现批禁再写该文件 |
-| `design/gdd/systems/跨局循环/锻造工坊.md` 同节 | 重甲反震候选的实现前提：反弹需新开消费点（本批摘 `spike` 后彻底无位） | 设计权威文档，实现批不直改；写入 `reports/<迭代号>-反哺点-<日期>.md`，用户裁后归文档批 |
-| `design/gdd/systems/战斗循环/增益状态.md`／`伤害与护甲.md` | 若其中叙述「改写族四拍」的句子里挂了退役件名 | 机械面核对；有则列反哺点，无则实现报告记「零命中」 |
-| `game/tests/README.md` 能力表 | 本批无新增能力、无能力退役；T2 探针挂既有行「加载期违规表拒绝：跨表悬空／计数器前缀／真视窄域／效果类型出域」（:177，代表用例含 `effect_kind_retired_test.gd:_assert_rejected`） | 无改动义务；批末核对表上名字与落地一致 |
-| `待办清单.md`／`roadmap.md` | 条目状态与迭代行 | 由写卡段与编排段推进，实现批禁写 |
-
-## 7 任务卡
-
-### 文件结构图
-
-| 文件 | 职责 | 改动性质 |
-|---|---|---|
-| `game/core/damage_controller.gd` | 主角/敌方伤害结算编排 | 非行为改动（摘不可达分支＋注释改写）→ 对照表 R1、R4 |
-| `game/core/effect_engine.gd` | 效果词表与行校验 | 非行为改动（摘词两枚＋注释改写）→ R2、R3、R4 |
-| `game/tests/unit/data_config/effect_kind_retired_test.gd` | 负域加载探针宿主 | 新增两个探针常量与两次调用（非行为改动的取证面）→ R2、R3 |
-| `game/core/reward_grant.gd` | 奖励与格面兑付 | 行为改动（一处明细行标签＋一处拒绝 reason 文案）→ R5、R6 |
-| `game/tests/unit/core/meta_progression_forge_test.gd` | 元进度/锻造断言宿主 | 断言串随 R5 换代（申报见第 8 节）→ R5 |
-| `game/sim/level_autoplay.gd` | autoplay 驱动件 | 非行为改动（删恒 false 匹配＋注释）→ R4、R8 |
-| `game/core/settlement/grant_segment.gd` | 授予段结算编排 | 行为改动（`:166` 明细标签文本）→ R7；注释面 10 行改写 → R4 |
-| `game/core/reward_roller.gd`、`game/core/battle_orchestrator.gd`、`game/core/action_economy.gd`、`game/data/schemas/treasure_item_table.gd`、`game/sim/adventure_monte_carlo.gd`、`game/tests/unit/battle_settlement/variant_placement_test.gd` | 注释面 | 非行为改动（注释改写）→ R4 |
-
-零新增文件、零新增函数、零新增数据件；唯一的"新增"是既有套件内的两个探针常量。
-
-### T0 基线与读数对账（0.25 工作日）
-
-取用：无。产出：改前基线三件——对拍转储、S13 键读数、契约 1 三条 grep 读数。
-
-- [ ] 跑契约 1 三条 grep，逐条把命中数写进实现报告 T0 节（期望全 0，除 `feats.tres:854` 的 `clamp_bonus` 一行作对照记录）。
-- [ ] 读 `tools/gdstyle_baseline.txt` 内 `damage_controller.gd`/`effect_engine.gd`/`reward_grant.gd`/`level_autoplay.gd` 现登记键，抄进实现报告「存量触面」表（第 14 节要求只降不升）。
-- [ ] 采改前对拍基线：`game/sim/dump_battle.gd` 六组（L{1,2}×S{42,779401,779501}，stdout 单流转储，先例＝拆件批 T6 同参）。
-- [ ] 采改前明细行读数：`meta_progression_forge_test.gd:_smoke_tree_rules` 现断言串的完整文本抄进实现报告（T4 换代后的比对基准）。
-
-### T1 摘四段死分支与穿线键（0.5 工作日）
-
-取用：T0 的契约 1 读数全零。产出：`_ctx_rewrites` 与 `_hero_attack_ctx` 的收窄返回键集（T2、T4 引用）。
-
-- [ ] `damage_controller.gd`：删 `:297-302`（命中侧交换）、`:351-353`（增伤侧交换）、`:305-309`（免掷覆盖）、`:310-313` 置位块＋`:368-372`（spike 倍乘）、`:320-323`（移档调用）与 `:623` 函数 `_discount_shift_up(discount: int, shift: int) -> int`。
-- [ ] 同文件：删 `clamp_hits` 收集后残留的 `shift` 局部变量、`ar_hits` 局部变量（发射调用 `:296` 保留但不接收返回值，见 3.6）；`spike_ready` 键从 `:282`、`:325` 返回字典与 `:369` 消费处一并去除。
-- [ ] 收窄后的签名与键集照此，不得自创：
-  - `_ctx_rewrites(t: Dictionary, target: Dictionary, armor: String, matchup: String) -> Dictionary` 返回键集 = `{roll_read, threshold, crit, discount, clamp_hits}`。
-  - `_hero_attack_ctx(t: Dictionary) -> Dictionary` 返回键集 = 现键集去掉 `spike_ready`（`:278-282` 其余键逐字保留）。
-  - `_hero_attack_base_value(t: Dictionary, ctx: Dictionary) -> float` 签名不变，体内删两拍。
-- [ ] 头注与分节注释随删随改（`:249-254`、`:264-266`、`:285-290`、`:341-342`、`:368`）：改写后的四拍叙事只剩「掷点折扣读数 → 克制点数」两拍，注释口径同步收窄（这条与 T3 同判据，禁再挂退役件名）。
-- [ ] 单元侧适配：`game/tests/unit/battle_settlement/damage_controller_test.gd`、`roll_multiplier_test.gd`、`game/tests/unit/contracts/system_contracts_test.gd` 跑一遍；3.6 已证零命中，若真出红，只改装配不改进判据，并把改动写进实现报告「实现决定记录」。
-
-### T2 词表收窄与负域探针（0.5 工作日）
-
-取用：T1 摘除后的 `damage_controller.gd` 键集（探针只需构造表行，不引用控制器内部键）。产出：`effect_kind_retired_test.gd` 两枚新探针常量 `_assert_rejected` 新断言名（R2/R3 引用）。
-
-- [ ] `effect_engine.gd:30` 摘出 `"spike"`（`EFFECT_KINDS` 实数 32→31）；`:82` 摘出 `"trade_atk"`, `"trade_hit"`（`DO_KEYS` 19→17 项，实数以摘后 `grep` 行内计数为准）。
-- [ ] 同文件 `:452` 组合规则注释改为只列现役：「任意真族（任一命中即生效）：`spawn_spell`。」；`:64`/`:65`/`:157` 注释改写并入 T3 判据面。
-- [ ] `game/tests/unit/data_config/effect_kind_retired_test.gd`：按既有形态新增两枚探针——`PROBE_SPIKE_MODE`（注入 `{"kind": "modify_ticket", "mode": "spike"}` 行的夹具目录）与 `PROBE_TRADE_KEY`（注入带 `trade_hit` 键的 do 字典）。各建一个 `user://` 夹具目录常量，沿用 `_inject(dir, probe)` 与 `_assert_rejected` 既有函数，不新建套件文件。
-- [ ] 断言名与尾缀：`_assert_rejected` 内新增两条检查——`"词表闭面：kind=spike 出域拒绝"` 与 `"do 键闭面：trade_hit 出域拒绝"`；该套件已在 `game/tests/run_all.gd:195` 负面清单在册（`expect=1`、`negative=true`），本步只加探针，不动在册条目与退出码判据。
-- [ ] 独立验证先行：只跑该套件（`godot --headless --path game --script res://tests/unit/data_config/effect_kind_retired_test.gd`）出绿，再并入全套。
-
-### T3 注释面退役名改写（0.5–1 工作日，可切 T3a/T3b）
-
-取用：3.3 表逐行清单。产出：注释面 grep 零命中读数（对照表 R4）。
-
-- [ ] 名单唯一来源＝`design/content-archive/道具退役素材库.md` 两张表的「原名」列，现场解析；禁把 40 个名字复制成第二份清单文件（第 12 节唯一面）。
-- [ ] 逐处改写口径＝「这段代码做什么、按什么序、取值从哪来」，内容名换成机制名。示例（禁照抄字句，只照抄口径）：
-  - `:285` 「第一拍矿工重锤命中交换」→ 「命中判定减成换攻击增伤的交换位（现役零注册，随本批摘除后此句消亡）」——摘除后该注释整段随分支删除，改写只适用于 T1 未摘的 11 个文件行。
-  - `reward_roller.gd:1` 「偏运硬币/board_skew 两路投影」→ 「订阅加权与 board_skew 两路投影」。
-  - `grant_segment.gd:232` 「完美布防=本轮封印批全中」→ 「封印全中倍率=本轮 hit>0 且 miss==0 时」。
-- [ ] 判据 grep：改写后重跑 3.3 那条扫描，注释面命中数必须为 0；读数贴进实现报告。
-- [ ] 不碰第 5 节点名保留的三行夹具串。
-
-### T4 玩家可见文案与死匹配（0.25 工作日）
-
-取用：T0 采到的改前明细行读数。产出：新标签文本（R5/R6 引用）。
-
-- [ ] `reward_grant.gd:226` 标签 → `"挖掘惩罚减半（%d→%d）"`；同处归因串 `"effect_id": "nest_counter"` → `"nest_halve"`（依代码规范用语纪律清零退役名；该串全仓仅此一处、不进存档不读表，改动面＝本行＋测试匹配串随动）。
-- [ ] 同文件 `:183` 与 `:221` 注释随 T3 口径改写；`:189` reason → `"中立移除：3×3 区域内无可移除危险格（须未揭示且未封印）"`。
-- [ ] `game/core/settlement/grant_segment.gd:166` 明细标签 `"惊巢反制·反弹"` → `"反弹伤害"`，同处归因串 `"attune_nest_counter"` → `"attune_nest_halve"`；`channel == "reflect"` 判据与开单参数字典逐字不动（契约 3）。
-- [ ] `meta_progression_forge_test.gd`：`:694` 匹配串、`:697` 标签文案、`:699`/`:700` 期望串四处随动到新标签；判据仍绑 `step_row` 采集的 `display_name`，`nc_hit != ""` 与等值断言的强度不得降低。
-- [ ] `level_autoplay.gd:421` 恒 false 的 `contains("雷区图谱")` 条件与该分支一并删，`:415` 注释随删。
-- [ ] 窄测：`meta_progression_forge_test`、`round_flow_skill_pool_test`、`damage_controller_test`、`table_structure_guard_test` 四套跑绿。
-
-### T5 产出物落位卡（0.25 工作日）
-
-- [ ] 轻闸全绿后、合并前写齐 `reports/<迭代号>-实现报告-<日期>.md`：各 T 卡状态、T0/T2/T3/T4 四条读数、契约 1 三条 grep、改前改后对拍逐位一致结论、实机目检总清单（本批目检项：结算明细行减半标签一眼可读、无退役件名突兀感——登记不阻塞）、遗留读数义务（零现役通道与零订阅事件词两件，已另登待办条目，见第 5 节）、实现决定记录。
-- [ ] `reports/<迭代号>-反哺点-<日期>.md`：第 6 节每条都要有落点，含「明细标签是否入表」这条规范裁决点。
-- [ ] 里程碑步出口跑一次全套闸（`tools/run_all_gates.sh --code`）；波内出红只做出红最小单元最窄确认。
-
-## 8 验证闸（改动—验收对照表）
-
-| # | 需求点（判据出处行锚） | 改动（文件:行） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
-|---|---|---|---|---|---|---|---|
-| R1 | 摘四段不可达改写分支（锚 `design/engineering/code-conventions.md:15`） | `damage_controller.gd:297-302/305-309/310-313/351-353/368-372/320-323/623` | `damage_controller_test.gd:_run_recipe_sequence`；`roll_multiplier_test.gd:_smoke_armor_roll`；`round_flow_skill_pool_test.gd:_smoke_full_battle`＋dump_battle 六组逐字节比对 | 单元＋集成 | `BattleOrchestrator.begin_battle()` → 主角先手开单兑付全链 | `step_row` 明细行文本与 `outcome` 取值逐位＝T0 基线；静态判据＝契约 1 三条 grep 零注册＋摘后键集 grep 零 `spike_ready`。**观测面局限申报**：零现役注册行使分支不可达，无法从真实入口造出命中；禁人为注入表行取证（全项目禁变异类测试） | 既有：伤害单据编排与回放；既有：伤害公式与掷点乘区；既有：轮内流与结算五段全序 |
-| R2 | `EFFECT_KINDS` 摘 `spike`（锚 `design/engineering/code-conventions.md:15`） | `effect_engine.gd:30` | `effect_kind_retired_test.gd:_assert_rejected`（新断言「词表闭面：kind=spike 出域拒绝」，尾缀 `expect=1 negative=true`） | 单元（负面，独立进程） | `ConfigDB.load_tables()` → `EffectEngine.validate_trigger_row` | 出域错误载荷含 `effect_kinds 出域` 文案＋进程退出码 1 | 既有：加载期违规表拒绝：跨表悬空／计数器前缀／真视窄域／效果类型出域 |
-| R3 | `DO_KEYS` 摘 `trade_hit`/`trade_atk`（锚 `design/engineering/code-conventions.md:15`） | `effect_engine.gd:82` | `effect_kind_retired_test.gd:_assert_rejected`（新断言「do 键闭面：trade_hit 出域拒绝」） | 单元（负面，独立进程） | `ConfigDB.load_tables()` → `EffectEngine.validate_trigger_row` | 键出域拒绝错误载荷含 `trade_hit`＋进程退出码 1 | 既有：加载期违规表拒绝：跨表悬空／计数器前缀／真视窄域／效果类型出域 |
-| R4 | 注释面退役名清零 13 文件 42 行（锚 `design/engineering/code-conventions.md:26`） | 3.3 表全部注释行号 | 静态判据：3.3 那条扫描命令注释面命中 0，读数贴实现报告；`--code` 域内静态扫描与 S11 段不变红；宿主既有套件逐位不变 | 静态（闸件扫描） | `BattleOrchestrator.begin_battle()` 链上宿主套件（改写面不进运行期） | 逐文件 grep 读数（文件名＋行号＋命中 0）＋宿主套件回归 | 既有：换图系刷新链路与效果词表接线；既有：伤害单据编排与回放 |
-| R5 | 减半明细行去退役件名（锚 `design/engineering/doc-conventions.md:47`） | `reward_grant.gd:226` | `meta_progression_forge_test.gd:_smoke_tree_rules`（换代断言串，落点 694/697/699/700） | 集成（信号采集） | 锻造锋线满级特效 → `BattleOrchestrator.begin_battle()` → `mine_hit` 减半路径 → `step_row` 信号 | `step_row` 行 `display_name` == 「挖掘惩罚减半（6→3）」，且 `power` 减半数值与发射次数逐字不变；`grep -r nest_counter game/` 零命中 | 既有：天赋树购买与六键合成 |
-| R6 | 空集拒绝 reason 去退役件名（锚 `design/engineering/test-conventions.md:116`） | `reward_grant.gd:189` | 静态判据：`grep -c 爆破工兵包 game/core/reward_grant.gd` == 0；`table_structure_guard_test.gd` 与 `extended_row_violation_test.gd:_init` 跑绿 | 静态＋单元 | `ConfigDB.load_tables()` → `_cell_removal_open` 所在兑付链（零现役行不可达） | grep 零命中读数＋通道校验面绿。**观测面局限申报**：`cell_removal` 零现役行，reason 不可达，禁造行取证 | 既有：加载期违规表拒绝：跨表悬空／计数器前缀／真视窄域／效果类型出域 |
-| R7 | 反弹明细标签去退役件名（锚 `design/engineering/doc-conventions.md:47`） | `grant_segment.gd:166` | 静态判据：`grep -rc "惊巢反制·反弹" game/` == 0 且 `grep -rc "attune_nest_counter" game/` == 0；`round_flow_skill_pool_test.gd:_smoke_full_battle` 跑绿 | 静态＋集成 | `BattleOrchestrator.begin_battle()` → `mine_hit` 订阅施加链（`channel="reflect"` 二十一张表零命中，今天不可达） | grep 零命中＋发射面零变化回归。**观测面局限申报**：同上，禁造行取证 | 既有：轮内流与结算五段全序 |
-| R8 | sim 恒 false 匹配删除（锚 `design/engineering/test-conventions.md:116`） | `level_autoplay.gd:415/421` | 静态判据：`game/sim/` 全域 grep `雷区图谱` 零命中；`--code` 域内驱动件相关套件跑绿 | 静态＋单元 | `game/sim/level_autoplay.gd` 驱动链（测量面，不进游戏运行） | grep 零命中＋套件绿。**观测面局限申报**：恒 false 条件不可达，禁造行取证 | 既有：轮内流与结算五段全序 |
-
-测试方式两分法：R1/R2/R3/R5 归调试接口与真实入口断言；R6/R7/R8 三处的改动点今天不可达（零现役注册行驱动），一律走静态判据＋观测面局限申报，禁造行取证，也不设目检；R5 的文本观感归用户目检——目检项「结算明细减半标签文本可读」写进实现报告总清单，登记不阻塞，不作合回前置。
-
-闸口径：本批改动含 `game/` 下非 `.md` 行为载体 → 按 `tools/run_all_gates.sh --code` 选档，所选域全绿才合并；卡内不写死闸件名单。
-
-回归措辞：里程碑步（T 段）出口跑一次全套闸；波内修复只做出红最小单元的最窄确认；新增探针先行孤立验证再并入全套。
-
-测试削弱申报：唯一允许改的旧断言＝`meta_progression_forge_test.gd:694/697/699/700` 四处期望串，理由是 R5 文案换代要求名实相符；断言强度（非空判定＋等值判定＋不含旧词）一条不降，阈值与扫描面不放宽。除此之外任何断言删除、阈值放宽、扫描面缩小都属未申报改动，独立验收审计判红。
-
-独立验收审计：入口＝合回前由未参与实现的会话或子代理执行，报告落 `reports/<迭代号>-验收审计-<日期>.md`；本档验收档=中，按 test-conventions §8.7 中档梯度核（R1/R2/R3/R5 四条必须逐条核到判据绑定面）。
-
-## 9 异常分级
-
-- L1 自救：注释措辞不通、局部变量名残留、grep 命令写法——就地改，不动判据。
-- L2 记录继续：T1 单元侧适配出现既有断言装配报错（3.6 已预判零命中），按申报范围改装配并记入实现报告「实现决定记录」。
-- L3 停机呈报并写报告：
-  1. 契约 1 任一条 grep 读数非零（分支可达）＝上游事实与卡片互斥，停卡退回写卡段。
-  2. 摘词后加载出现非预期致命（现役行被误判出域）或现役套件出红且原因落在本批摘除面。
-  3. 机检预算与卡片契约互斥（例：收窄后某函数键数低于登记值触发基线红/留空壳才能凑绿）＝停卡退回写卡段，禁自造第三条路。
-  4. 按纪律无法干净摘除、必须保留中间壳函数才能过闸＝停卡呈报走豁免/还债通道，禁硬拆凑绿。
-  5. R5 断言换代后仍红且原因在数值或发射序（说明文案改动越界）。
-
-## 10 代拍板白名单
-
-允许实现期自行拍板：注释改写的具体中文措辞（守契约 2 即可）；负面探针常量与夹具目录命名（沿用既有形态）；grep/扫描命令写法；是否把 T3 与 T4 并成一次提交；测试文件内局部变量改名；实现报告小节标题措辞。
-超出白名单＝记入实现报告「实现决定记录」，不得静默。
-
-## 11 待裁点
-
-零待裁点，开工门=U0。（机制删留与注释口径已由用户在 2026-11-05 会话裁毕；GDD 四处错陈述已在写卡段前置文档段落文 v0.13；「明细标签是否入表」与三件遗留读数不属本卡执行面，已列第 5/6 节去向。）
-
-## 12 落位与可复用性预检
-
-- 复用面：本批零新增文件。负域探针复用 `game/tests/unit/data_config/effect_kind_retired_test.gd` 既有 `_inject`/`_assert_rejected` 骨架——它正是「退役词出域即加载致命」的现成载体，新建套件＝重复落点。注释改写复用既有文件与函数，无新 helper。
-- 唯一面：退役内容名清单的唯一来源＝`design/content-archive/道具退役素材库.md`，判据脚本现场解析，禁在 `game/` 或 `tools/` 落第二份名单；摘词只改 `effect_engine.gd` 两处常量，`treasure_item_table.gd:20` 的注释属说明面（随 T3 改写），不另立词表。
-- 分层与交互面：`game/core/damage_controller.gd` 与 `game/core/effect_engine.gd` 的交互仍走既有 `_fx_hits` 查询口与 `validate_trigger_row` 校验口，本批只删消费环、不改接口；`reward_grant.gd` 文案改动不动 `emit_cb` 契约；`game/sim/` 驱动件不回连产品码。Core 零 UI、数值只经 ConfigDB、随机只经 RngService 三条红线本批一律不绕（本批不新增数值与随机消费）。
-
-## 13 禁为机检文本保留无效成员
-
-本卡为清退类：禁止为迎合机检消息文本或计数保留/新增任何无效成员、空壳函数、无用别名或 ctx 冗余键——`spike_ready`、`ar_hits`、`shift`、`trade_hit` 局部变量与 `_discount_shift_up` 一律随分支删净。机检键与本卡契约互斥时，实现段停卡呈报，不得自造第三条路。
-
-## 14 实现规范预算
-
-本批无新增文件，新件三查不适用；执行的是存量触面一查：
-
-- `game/core/damage_controller.gd`：T1 摘除使 `_ctx_rewrites` 与 `_hero_attack_base_value` 的分支数、函数长度下降；`_discount_shift_up` 整函数消亡。预期 S13 键只降不升，T0 抄录现登记值、T5 抄录摘后读数两张对照。
-- `game/core/effect_engine.gd`：两处常量字面量变短，方法数与成员变量数不变。
-- `game/core/reward_grant.gd`、`game/sim/level_autoplay.gd`：只删文本与一条恒 false 条件，分支数下降或持平。
-- 指标例外通道：本卡不申报任何例外——若摘除后仍有键超默认，属存量在册键，沿用 `tools/gdstyle_baseline.txt` 现登记，不新增。
-
-## 15 拆分边界纪律
-
-本卡是清退类，不产生拆出单元；条款照写以防实现期顺手重组：
-
-1. 若实现中确需拆出新私有函数或新段件，每个单元必须能写出一句职责陈述与单一变化原因，并逐件写进实现报告；写不出＝凑计数袋，回炉。
-2. 「过阈值」只作发现信号，禁作为本批拆分或收拢的动机——本批唯一动机是零现役注册分支的清退。
-3. 按纪律无法干净摘除时停卡呈报走豁免/还债通道，禁硬拆凑绿（进第 9 节 L3 第 4 条）。

roadmap.md

@@ -5,8 +5,8 @@
 ## 当前位（只回答「现在该做什么」；三行内随批次换代，禁止在此扩写成状态快照）
 
 - **阶段**：M3——Alpha 版本的完整实现（2026-10-09 立规：未明令宣布完成前停留 M3，迭代只排 M3 需求，M4 不排期；根目录 stage.txt 为旧阶段开关仅存档）。
-- **迭代位**：迭代 1–52 全部已完成；各迭代收口与批后收尾沿革查 git 提交信息与 `reports/`。
-- **下一步**：无已编迭代在飞——待编池：改写族孤儿（待处置方向裁决）、二三关棋盘观感（待设计＋待美术）、EC8 热重载实装（待用户另立条目）；测试面真输入化分期与存量断言逐条精锚（待执行，归下批编排）。
+- **迭代位**：迭代 1–53 全部已完成；各迭代收口与批后收尾沿革查 git 提交信息与 `reports/`。
+- **下一步**：无已编迭代在飞——待编池：效果通道与事件词零现役普查（待写卡）、结算明细文案入表（待文档设计）、二三关棋盘观感（待设计＋待美术）、测试面真输入化分期与存量断言逐条精锚（待执行）、QA 覆盖总览面板与自动试玩扩展（待执行）；EC8 热重载实装待用户另立条目。
 
 ## 里程碑时间线
 
@@ -86,7 +86,7 @@
 | 迭代 50 | 已完成（2026-11-03） | 已退役（git 历史可考） | 2026-11-03 | ≈12.875 个工作日〔用户特批 2026-11-03 超 10 个工作日〕 | 已退役（git 历史可考） |
 | 迭代 51 | 已完成（2026-11-04） | 已退役（git 历史可考） | 2026-11-04 | ≈6.625 个工作日 | 已退役（git 历史可考） |
 | 迭代 52 | 已完成（2026-11-05） | 已退役（git 历史可考） | 2026-11-04 | ≈9.275 个工作日 | 已退役（git 历史可考） |
-| 迭代 53 | 待开工 | reports/需求卡片-卷轴视口批-2026-11-05.md<br>reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md | 2026-11-05 | ≈6.0 个工作日 | — |
+| 迭代 53 | 已完成（2026-11-06） | 已退役（git 历史可考） | 2026-11-05 | ≈6.0 个工作日 | 已退役（git 历史可考） |
 
 - 历史行的「—」= 该列事实不可考：迭代 1~8 早于需求卡片制；编排时点与预计周期不再回溯，细节查 git 提交史。
 - 「已退役（git 历史可考）」= 需求卡片或实现报告曾存在，已按「证据只留最新」退役；已完成迭代的实现报告列只填 reports/ 现存路径或本保留字，不填「—」。

tools/capability_audit.py

@@ -132,6 +132,16 @@ def product_funcs():
     return names
 
 
+def probe_funcs():
+    # 真实入口锚面补探针共用面（capability E 规则用）：真输入合成沿（probe_ui_util 等探针
+    # 共用件）写进能力行真实入口格后，卡片退役其凭证只能锚代码面——探针件定义与 D 规则
+    # 同口径认锚（仍要求 func 真实存在，不属放宽）。
+    names = set()
+    for p in (REPO / "game" / "probe").rglob("*.gd"):
+        names.update(re.findall(r"^(?:static\s+)?func\s+([A-Za-z_]\w*)\s*\(", read(p), re.M))
+    return names
+
+
 def cards_corpus():
     """reports/需求卡片*.md 全文拼接（双通道的「卡在」锚面）；无卡返回空串。"""
     if not CARDS_DIR.is_dir():
@@ -266,7 +276,7 @@ def check_entry(no, name, cell, funcs, cards):
     for _, method in tokens:
         if method not in funcs and not (cards and method in cards):
             red(README.relative_to(REPO), no, "真实入口",
-                "「%s」方法 %s() 无凭证——产品码与 sim 测量件无定义且需求卡片未载" % (name[:16], method))
+                "「%s」方法 %s() 无凭证——产品码、sim 测量件与探针件均无定义且需求卡片未载" % (name[:16], method))
 
 
 def check_coverage(cov_tables, names):
@@ -333,7 +343,7 @@ def main():
     suites = manifest()
     if not suites:
         selfcheck.append("run_all.gd manifest 零套件")
-    funcs = product_funcs()
+    funcs = product_funcs() | probe_funcs()
     if not funcs:
         selfcheck.append("产品码零 `func`")
     names, referenced = check_capability_rows(cap_tables, suites, funcs, cards_corpus())

tools/coverage_enum.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+r"""coverage_enum.py — 本体枚举器（游戏内容↔测试验证对账，B 面板·义务层双源之机器源）
+
+两个文本扫描器＋一次比对，全程不依赖跑游戏（交互命中维度除外——由探针覆盖登记另行承载）：
+
+  扫描器 1（游戏本体枚举）——「游戏有什么」：
+    game/data/tables/*.tres       行集主键（`"xxx_id": "yyy"` 形态，逐表逐行）
+    game/data/schemas/*.gd        词表常量与字段名（const 块内的引号 token＋var 字段名）
+    game/presentation/**/*.tscn   BaseButton 族节点（scene＋节点名）
+    game/presentation/**/*.gd     _gui_input/_input 自绘命中类（脚本名）
+    game/presentation/views/*.gd  屏与模态清单（*_screen/*_overlay/*_panel 视图类）
+
+  扫描器 2（验证关联）——「验证了什么」：复用 tools/extract_checks.py 的断言静态提取
+  （unit/**＋integration/**＋system_test.gd 全量），实体 id 在「断言标签＋cond＋源文件＋函数」
+  文料中出现即记一次关联。
+
+  比对＝差集：本体存在、验证零关联＝缺口清单，按类别分组、标首见批次（本工具生成时间）。
+
+诚实边界（契约 §7 在案）：grep 关联有假阳假阴——断言测了实体但文本没带 id＝假缺口（人工核销
+兜）；文本带 id 但断言弱＝假覆盖（oracle 改造堵）。推荐约定「断言文本含被测实体 id」提高精度，
+不立规约。交互点（按钮/物件被点过没有）不在本工具判据内——那归探针真输入覆盖登记。
+
+用法:  python tools/coverage_enum.py [--out <路径>]
+产出:  game/tests/.gates/coverage/ontology_gaps.js（JSONP，B 面板消费）
+"""
+from __future__ import annotations
+
+import argparse
+import datetime
+import json
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+GAME = ROOT / "game"
+DEFAULT_OUT = GAME / "tests" / ".gates" / "coverage" / "ontology_gaps.js"
+
+TRES_ID_RE = re.compile(r'"(\w+_id)":\s*"([^"]+)"')
+SCHEMA_TOKEN_RE = re.compile(r'"([a-z][a-z0-9_]{2,40})"')
+SCHEMA_VAR_RE = re.compile(r"^@?export\s+var\s+(\w+)\s*:", re.M)
+TSCN_NODE_RE = re.compile(r'\[node name="([^"]+)"[^>]*type="(\w*Button\w*)"')
+GUI_INPUT_RE = re.compile(r"^func (_gui_input|_input)\(", re.M)
+VIEW_KIND_RE = re.compile(r"(screen|overlay|panel)$")
+
+
+def scan_tables() -> list[dict]:
+    out: list[dict] = []
+    tables = GAME / "data" / "tables"
+    for f in sorted(tables.glob("*.tres")):
+        text = f.read_text(encoding="utf-8", errors="replace")
+        seen: set[tuple[str, str]] = set()
+        for m in TRES_ID_RE.finditer(text):
+            key = (m.group(1), m.group(2))
+            if key not in seen:
+                seen.add(key)
+                out.append({"category": "表行:%s" % f.stem, "id": m.group(2), "id_field": m.group(1)})
+    return out
+
+
+def scan_schemas() -> list[dict]:
+    out: list[dict] = []
+    schemas = GAME / "data" / "schemas"
+    for f in sorted(schemas.glob("*.gd")):
+        text = f.read_text(encoding="utf-8", errors="replace")
+        tokens = set(SCHEMA_TOKEN_RE.findall(text))
+        fields = set(SCHEMA_VAR_RE.findall(text))
+        for t in sorted(tokens):
+            out.append({"category": "词表/枚值:%s" % f.stem, "id": t, "id_field": "token"})
+        for fl in sorted(fields):
+            out.append({"category": "schema字段:%s" % f.stem, "id": fl, "id_field": "field"})
+    return out
+
+
+def scan_tscn_buttons() -> list[dict]:
+    out: list[dict] = []
+    for f in sorted(GAME.glob("presentation/**/*.tscn")):
+        text = f.read_text(encoding="utf-8", errors="replace")
+        for m in TSCN_NODE_RE.finditer(text):
+            out.append({"category": "场景按钮", "id": "%s:%s" % (f.name, m.group(1)), "id_field": m.group(2)})
+    return out
+
+
+def scan_gui_input_classes() -> list[dict]:
+    out: list[dict] = []
+    for f in sorted(GAME.glob("presentation/**/*.gd")):
+        text = f.read_text(encoding="utf-8", errors="replace")
+        kinds = set(GUI_INPUT_RE.findall(text))
+        for k in kinds:
+            out.append({"category": "自绘命中类", "id": f.stem, "id_field": k})
+            break   # 一类一行（一个脚本同具两面也只记一次）
+    return out
+
+
+def scan_screens() -> list[dict]:
+    out: list[dict] = []
+    for f in sorted((GAME / "presentation" / "views").glob("*.gd")):
+        if VIEW_KIND_RE.search(f.stem):
+            out.append({"category": "屏与模态", "id": f.stem, "id_field": "view"})
+    return out
+
+
+def assertion_corpus() -> tuple[list[dict], str]:
+    sys.path.insert(0, str(ROOT / "tools"))
+    import extract_checks as ec   # noqa: PLC0415 —— 复用现役提取机制（契约 §7 指定扩面）
+    rows, _problems = ec.extract_all(ec.default_sources())
+    parts: list[str] = []
+    for r in rows:
+        parts.append("%s %s %s %s" % (r.get("src", ""), r.get("func", ""),
+                                      r.get("label_literal", ""), r.get("cond", "")))
+    return rows, "\n".join(parts)
+
+
+def main() -> int:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    ap = argparse.ArgumentParser(description="本体枚举器（游戏内容↔测试验证对账）")
+    ap.add_argument("--out", default=str(DEFAULT_OUT))
+    args = ap.parse_args()
+    entities = scan_tables() + scan_schemas() + scan_tscn_buttons() + scan_gui_input_classes() + scan_screens()
+    _rows, corpus = assertion_corpus()
+    categories: dict[str, dict] = {}
+    for ent in entities:
+        cat = categories.setdefault(ent["category"], {"total": 0, "matched": 0, "gaps": []})
+        cat["total"] += 1
+        if ent["id"] and ent["id"] in corpus:
+            cat["matched"] += 1
+        else:
+            cat["gaps"].append({"id": ent["id"], "id_field": ent.get("id_field", "")})
+    payload = {
+        "meta": {
+            "generated_at": datetime.datetime.now().isoformat(timespec="seconds"),
+            "entities_total": len(entities),
+            "corpus_rows": len(_rows),
+            "honest_boundary": "grep 关联有假阳假阴——文本没带 id 的假缺口人工核销；交互命中归探针真输入登记",
+        },
+        "categories": [
+            {"category": k, "total": v["total"], "matched": v["matched"], "gaps": v["gaps"]}
+            for k, v in sorted(categories.items())
+        ],
+    }
+    out = Path(args.out)
+    out.parent.mkdir(parents=True, exist_ok=True)
+    js = "/* 本体对账清单——coverage_enum.py 随跑重生成，人工核销走豁免清单（coverage_exemptions.js），不落本文件。 */\n"
+    js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+    js += "window.__QA_COVERAGE__.ontology = %s;\n" % json.dumps(payload, ensure_ascii=False, indent=2)
+    out.write_text(js, encoding="utf-8", newline="\n")
+    gap_total = sum(len(c["gaps"]) for c in payload["categories"])
+    print("[ontology] 本体实体 %d / 断言文料行 %d / 缺口 %d（%d 类）→ %s" % (
+        len(entities), len(_rows), gap_total, len(payload["categories"]), out))
+    for c in payload["categories"]:
+        print("  %s：%d 实体 / %d 缺口" % (c["category"], c["total"], len(c["gaps"])))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tools/coverage_exemptions.js

@@ -0,0 +1,11 @@
+/* 覆盖豁免清单——人工维护（S13 基线人工修订同款纪律；面板与工具只读本文件，禁代码生成）。
+ * 用途：登记「确认不需要真输入覆盖/不需要断言关联」的条目，B 面板对在册条目亮豁免灯、不亮缺口。
+ * 形态：abilities=能力清单行「能力」列原文（精确匹配）；controls=控件登记键或其中缀（包含匹配）；
+ *       ontology=本体实体 id（精确匹配）。每条必须带 reason——无理由的豁免条目面板标红示警。 */
+window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};
+window.__QA_COVERAGE__.exemptions = {
+  "meta": {"note": "人工维护；改后刷新面板即生效，无生成步骤"},
+  "abilities": [],
+  "controls": [],
+  "ontology": []
+};

tools/coverage_receipts.py

@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+r"""coverage_receipts.py — 六源回执明细化（B 覆盖总览面板·执行层）
+
+各闸跑批把当场日志落 `.gates/*.log`；本工具在跑批末尾被闸壳调用一次，把六层日志解析成
+「名×结果×计数」明细，按闸各写一个 JSONP .js 到 `.gates/coverage/`，供
+tools/coverage_report.html 经 <script src> 直载。
+
+六层与日志源（层键=面板消费键，层名=呈现名）：
+  smoke  冒烟测试        smoke_boot.log   摘要「N 项检查，M 项失败」
+  unit   单元与集成测试  unit.log         每套件「[run_all] PASS/FAIL res://…（exit=N）」
+  system 系统测试        system_test.log  摘要「N 项检查，M 项失败」
+  probe  场景探针        probe.log        每探针段「======== 名（段）========」＋该段 PASS/FAIL 行
+  render 渲染闸          render.log       golden 清单与对比结果
+  static 静态扫描        static_scan.log  每个 S 系条目「[static_scan] S# ok/FAIL（…）」
+
+判据口径：
+  - 明细粒度＝「名×结果×计数」，不记逐条断言文本（契约 §4 成本口径）；
+  - 日志缺失＝该层 {"result": "not_run"}——面板亮灰灯，不冒充绿；
+  - 本工具失败不翻转闸判定（观测件非判定件），但必须打红字——静默丢数据等于断言蒸发。
+
+用法:  python tools/coverage_receipts.py [--stamp-dir <.gates 路径>]
+产出:  <stamp-dir>/coverage/gate_<层键>.js × 6
+"""
+from __future__ import annotations
+
+import argparse
+import datetime
+import json
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+DEFAULT_STAMP = ROOT / "game" / "tests" / ".gates"
+
+SUMMARY_RE = re.compile(r"摘要[：:]\s*\[?[^\]]*\]?\s*摘要[：:]\s*(\d+)\s*项检查，(\d+)\s*项失败")
+SUITE_RE = re.compile(r"\[run_all\] (PASS|FAIL) (res://\S+?\.gd)(?:\s*\(exit=(-?\d+)\))?")
+PROBE_SECTION_RE = re.compile(r"^======== (\S+)(?:\s+(.+?))? ========")
+PROBE_RESULT_RE = re.compile(r"^\[[^\]]+\] (PASS|FAIL)")
+GOLDEN_RE = re.compile(r"\[render_gate\] \[golden\] (PASS|FAIL)（(\d+) 屏黄金图")
+GOLDEN_CROP_RE = re.compile(r"\[render_gate\] \[golden_crop\] (\S+?) —")
+STATIC_RE = re.compile(r"^\[static_scan\] (S\d+(?:/S\d+)*)\s+(ok|FAIL)", re.M)
+STATIC_GDSTYLE_RE = re.compile(r"^\[gdstyle_gate\] (ok|FAIL)", re.M)
+
+
+def read(stamp: Path, name: str) -> str:
+    p = stamp / name
+    if not p.is_file():
+        return ""
+    return p.read_text(encoding="utf-8", errors="replace")
+
+
+def parse_summary_layer(log: str) -> dict:
+    if not log:
+        return {"result": "not_run"}
+    m = SUMMARY_RE.search(log)
+    verdict = "绿" if "[run_smoke] PASS" in log or "[run_system_test] PASS" in log else (
+        "红" if ("FAIL" in log or "摘要" in log and m and int(m.group(2)) > 0) else "灰")
+    if m:
+        return {"result": verdict, "checks": int(m.group(1)), "fails": int(m.group(2))}
+    return {"result": verdict}
+
+
+def parse_unit(log: str) -> dict:
+    if not log:
+        return {"result": "not_run"}
+    items = [{"name": m.group(2), "result": m.group(1), "exit": int(m.group(3) or 0)}
+             for m in SUITE_RE.finditer(log)]
+    red = [i for i in items if i["result"] == "FAIL"]
+    verdict = "绿" if "[run_all] all green" in log and not red else ("红" if red or "FAIL" in log else "灰")
+    return {"result": verdict, "suites_total": len(items), "items": items}
+
+
+def parse_probe(log: str) -> dict:
+    if not log:
+        return {"result": "not_run"}
+    items: list[dict] = []
+    cur: dict | None = None
+    for line in log.splitlines():
+        sm = PROBE_SECTION_RE.match(line.strip())
+        if sm:
+            seg = (sm.group(2) or "").strip()
+            cur = {"name": sm.group(1), "segment": seg, "result": "灰"}
+            items.append(cur)
+            continue
+        rm = PROBE_RESULT_RE.match(line.strip())
+        if rm and cur is not None and cur["result"] == "灰":
+            cur["result"] = rm.group(1)
+    judged = [i for i in items if i["result"] != "灰"]
+    verdict = "红" if (any(i["result"] == "FAIL" for i in judged) or "[probe_gate] 全绿" not in log) else "绿"
+    return {"result": verdict, "probes_total": len(judged), "items": items}
+
+
+def parse_render(log: str) -> dict:
+    if not log:
+        return {"result": "not_run"}
+    items: list[dict] = []
+    gm = GOLDEN_RE.search(log)
+    if gm:
+        items.append({"name": "golden 逐像素对比", "result": gm.group(1), "screens": int(gm.group(2))})
+    screens: list[str] = []
+    for m in GOLDEN_CROP_RE.finditer(log):
+        if m.group(1) not in screens:
+            screens.append(m.group(1))
+    if screens:
+        items.append({"name": "golden 逐屏裁剪", "result": "PASS", "screens": screens})
+    verdict = "红" if "FAIL" in log or "[render_gate] 全绿" not in log else "绿"
+    return {"result": verdict, "items": items}
+
+
+def parse_static(log: str) -> dict:
+    if not log:
+        return {"result": "not_run"}
+    items = [{"name": m.group(1), "result": m.group(2)} for m in STATIC_RE.finditer(log)]
+    gm = STATIC_GDSTYLE_RE.search(log)
+    if gm:
+        items.insert(0, {"name": "gdstyle", "result": gm.group(1)})
+    red = [i for i in items if i["result"] != "ok"]
+    verdict = "红" if red or "FAIL" in log else "绿"
+    return {"result": verdict, "items_total": len(items), "items": items}
+
+
+LAYERS = [
+    ("smoke", "冒烟测试", "smoke_boot.log", parse_summary_layer),
+    ("unit", "单元与集成测试", "unit.log", parse_unit),
+    ("system", "系统测试", "system_test.log", parse_summary_layer),
+    ("probe", "场景探针", "probe.log", parse_probe),
+    ("render", "渲染闸", "render.log", parse_render),
+    ("static", "静态扫描", "static_scan.log", parse_static),
+]
+
+
+def main() -> int:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    ap = argparse.ArgumentParser(description="六源回执明细化（B 面板·执行层）")
+    ap.add_argument("--stamp-dir", default=str(DEFAULT_STAMP))
+    args = ap.parse_args()
+    stamp = Path(args.stamp_dir)
+    out_dir = stamp / "coverage"
+    out_dir.mkdir(parents=True, exist_ok=True)
+    failed = False
+    wrote = 0
+    for key, label, log_name, fn in LAYERS:
+        try:
+            detail = fn(read(stamp, log_name))
+            detail["meta"] = {
+                "layer": key,
+                "label": label,
+                "source_log": log_name,
+                "generated_at": datetime.datetime.now().isoformat(timespec="seconds"),
+            }
+            payload = {"receipt": detail}
+            js = "/* 闸回执明细化——coverage_receipts.py 随每次跑批覆写，人工修订无效。 */\n"
+            js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+            js += "window.__QA_COVERAGE__.gate_receipts = window.__QA_COVERAGE__.gate_receipts || {};\n"
+            js += "window.__QA_COVERAGE__.gate_receipts[%s] = %s;\n" % (
+                json.dumps(key), json.dumps(payload, ensure_ascii=False, indent=2))
+            (out_dir / ("gate_%s.js" % key)).write_text(js, encoding="utf-8", newline="\n")
+            wrote += 1
+            print("[receipts] %s（%s）=%s" % (label, log_name, detail.get("result", "?")))
+        except Exception as exc:   # noqa: BLE001 —— 观测件逐层容错，红字可见不静默
+            failed = True
+            print("[receipts] 红：%s 层解析失败（%s）：%r" % (label, log_name, exc))
+    if wrote == 0:
+        print("[receipts] 红：六层明细一件未落盘——禁静默")
+        return 1
+    # 探针登记文件清单（B 面板 file:// 无法列目录——按现存 probe_hits_*.js 落 manifest 供 <script src>）
+    probe_files = sorted(p.name for p in out_dir.glob("probe_hits_*.js"))
+    manifest = {
+        "meta": {"generated_at": datetime.datetime.now().isoformat(timespec="seconds")},
+        "probes": probe_files,
+    }
+    mjs = "/* 探针登记清单——coverage_receipts.py 随跑批按现存文件覆写，勿手编。 */\n"
+    mjs += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+    mjs += "window.__QA_COVERAGE__.probe_manifest = %s;\n" % json.dumps(manifest, ensure_ascii=False)
+    (out_dir / "probe_manifest.js").write_text(mjs, encoding="utf-8", newline="\n")
+    print("[receipts] 探针登记清单 %d 件 → probe_manifest.js" % len(probe_files))
+    return 1 if failed else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tools/coverage_report.html

@@ -0,0 +1,226 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<title>QA 覆盖总览面板——Dungeon Sweeper</title>
+<style>
+  :root { --ok:#3a7d44; --bad:#a33; --off:#9aa; --na:#d5d5d0; --ex:#b8860b; --ink:#2c2a26; --paper:#f4f1ea; }
+  body { font-family: "Microsoft YaHei", sans-serif; margin: 0; background: var(--paper); color: var(--ink); }
+  header { padding: 14px 20px 10px; border-bottom: 3px solid var(--ink); background: #fff; }
+  h1 { font-size: 19px; margin: 0 0 4px; }
+  h2 { font-size: 16px; margin: 22px 0 6px; border-left: 5px solid var(--ink); padding-left: 8px; }
+  .note { font-size: 12px; color: #555; margin: 3px 0; }
+  .warn { color: var(--bad); font-weight: bold; }
+  main { padding: 12px 20px 40px; }
+  table { border-collapse: collapse; width: 100%; background: #fff; font-size: 12.5px; }
+  th, td { border: 1px solid #cfc9bd; padding: 4px 7px; text-align: left; vertical-align: top; }
+  th { background: #ebe6da; }
+  .lamp { display: inline-block; width: 13px; height: 13px; border-radius: 50%; margin-right: 3px; vertical-align: -2px; }
+  .ok { background: var(--ok); } .bad { background: var(--bad); }
+  .off { background: var(--off); } .na { background: var(--na); } .ex { background: #fff; border: 3px double var(--ex); }
+  .chip { display: inline-block; padding: 1px 8px; border-radius: 9px; color: #fff; font-size: 12px; }
+  details { margin: 4px 0 10px; } summary { cursor: pointer; font-size: 13px; }
+  .gaplist { font-size: 12px; color: #444; line-height: 1.7; }
+  .seg { margin-bottom: 18px; }
+  code { background: #eceade; padding: 0 3px; }
+</style>
+</head>
+<body>
+<header>
+  <h1>QA 覆盖总览面板 <span style="font-weight:normal;font-size:13px">（义务 × 执行合并视图——只读）</span></h1>
+  <div class="note">状态灯：绿=该层最近跑批过　红=跑批挂　灰=该层无承载/未跑　双圈=豁免（<code>tools/coverage_exemptions.js</code> 人工维护）。</div>
+  <div class="note" id="staleness"></div>
+  <div class="note"><b>完备性边界</b>：控件级视图只对「被探针/C 打开过的屏」负责；未打开过的屏由动线断言＋C 探索兜底。
+  本体对账为文本 grep 关联——有假阳假阴（断言测了实体但文本没带 id＝假缺口，人工核销；文本带 id 但断言弱＝假覆盖），缺口须人工复核后再立事项。</div>
+  <div class="note">数据源：随最近一次闸批落盘于 <code>game/tests/.gates/coverage/</code>；刷新本页即读最新。</div>
+</header>
+<main>
+  <h2>一、六层闸况</h2>
+  <div id="gateSummary"></div>
+
+  <h2>二、能力清单 × 六层状态灯（按旅程段）</h2>
+  <div class="note">灯的判据：用例文件落哪层就钉哪层的回执（单元=逐套件 PASS/FAIL；探针/系统/冒烟/渲染/静态=层判据）；该层无对应承载＝灰。</div>
+  <div id="capabilityMatrix"></div>
+
+  <h2>三、控件级交互覆盖下钻（探针真输入登记）</h2>
+  <div class="note">交互源=探针真输入命中登记（push_input 管线命中）；「存在但零命中」＝控件缺口——hitbox 错位/遮挡/驱动空洞在此暴露。展示源=渲染闸 golden 逐屏登记。</div>
+  <div id="controlDrill"></div>
+
+  <h2>四、本体对账（游戏内容 ↔ 测试验证）</h2>
+  <div class="note">缺口=本体存在、断言文料零关联；若该 id 出现在探针命中登记则降级为「探针承载」。首见批次=本工具生成时间，逐批对比看新面孔。</div>
+  <div id="ontologyGaps"></div>
+</main>
+<script src="./coverage_exemptions.js"></script>
+<script src="../game/tests/.gates/coverage/capability_list.js"></script>
+<script src="../game/tests/.gates/coverage/gate_smoke.js"></script>
+<script src="../game/tests/.gates/coverage/gate_unit.js"></script>
+<script src="../game/tests/.gates/coverage/gate_system.js"></script>
+<script src="../game/tests/.gates/coverage/gate_probe.js"></script>
+<script src="../game/tests/.gates/coverage/gate_render.js"></script>
+<script src="../game/tests/.gates/coverage/gate_static.js"></script>
+<script src="../game/tests/.gates/coverage/probe_manifest.js"></script>
+<script src="../game/tests/.gates/coverage/ontology_gaps.js"></script>
+<script>
+/* 探针登记文件由 manifest 同步补挂（document.write 在解析期阻塞加载，渲染段前数据已就位） */
+(function () {
+  const probes = ((window.__QA_COVERAGE__ || {}).probe_manifest || {}).probes || [];
+  for (const p of probes) {
+    document.write('<script src="../game/tests/.gates/coverage/' + encodeURIComponent(p) + '"><\/script>');
+  }
+})();
+</script>
+<script>
+"use strict";
+const C = window.__QA_COVERAGE__ || {};
+function esc(s) { return String(s == null ? "" : s).replace(/[&<>"]/g, c => ({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"}[c])); }
+function lamp(cls, title) { return `<span class="lamp ${cls}" title="${esc(title)}"></span>`; }
+function chip(txt, cls) { return `<span class="chip" style="background:${cls}">${esc(txt)}</span>`; }
+const VCOLOR = {"绿":"var(--ok)","红":"var(--bad)","灰":"var(--off)","not_run":"var(--off)"};
+
+// ── 数据新鲜度（陈旧可见——防静默旧数据） ──
+(function () {
+  const stamps = [];
+  const cl = (C.capability_list || {}).meta; if (cl) stamps.push(`义务层 ${cl.generated_at}`);
+  const rc = C.gate_receipts || {};
+  for (const k in rc) { const m = (rc[k].receipt || {}).meta; if (m) stamps.push(`${m.label} ${m.generated_at}`); }
+  const on = (C.ontology || {}).meta; if (on) stamps.push(`本体 ${on.generated_at}`);
+  const pm = (C.probe_manifest || {}).meta; if (pm) stamps.push(`探针登记 ${pm.generated_at}`);
+  document.getElementById("staleness").innerHTML = "数据时间：" + stamps.map(esc).join("　·　");
+})();
+
+// ── 一、六层闸况 ──
+(function () {
+  const rc = C.gate_receipts || {};
+  const ORDER = ["smoke", "unit", "system", "probe", "render", "static"];
+  const LABEL = {smoke:"冒烟测试", unit:"单元与集成测试", system:"系统测试", probe:"场景探针", render:"渲染闸", static:"静态扫描"};
+  let html = "<table><tr><th>层</th><th>判定</th><th>明细</th></tr>";
+  for (const k of ORDER) {
+    const r = (rc[k] || {}).receipt;
+    if (!r) { html += `<tr><td>${LABEL[k]}</td><td>${chip("缺数据", "var(--off)")}</td><td>—</td></tr>`; continue; }
+    const v = r.result === "not_run" ? "未跑" : r.result;
+    const color = VCOLOR[r.result] || "var(--off)";
+    let detail = `共 ${r.items ? r.items.length : 0} 项`;
+    if (r.checks != null) detail = `${r.checks} 项检查 / ${r.fails} 失败`;
+    if (r.suites_total != null) detail = `${r.suites_total} 套件`;
+    if (r.probes_total != null) detail = `${r.probes_total} 探针`;
+    html += `<tr><td>${LABEL[k]}</td><td>${chip(v, color)}</td><td>${esc(detail)}　<span class="note">源=${esc(r.meta.source_log)} @ ${esc(r.meta.generated_at)}</span></td></tr>`;
+  }
+  html += "</table><details><summary>单元与集成逐套件明细</summary><div class='gaplist'>";
+  const unit = ((rc.unit || {}).receipt || {}).items || [];
+  for (const it of unit) {
+    html += `${lamp(it.result === "PASS" ? "ok" : "bad", it.result)} ${esc(it.name.replace("res://tests/", ""))}${it.exit ? "（exit=" + esc(it.exit) + "）" : ""}<br>`;
+  }
+  html += "</div></details><details><summary>场景探针逐段明细</summary><div class='gaplist'>";
+  const pr = ((rc.probe || {}).receipt || {}).items || [];
+  for (const it of pr) {
+    html += `${lamp(it.result === "PASS" ? "ok" : (it.result === "FAIL" ? "bad" : "off"), it.result)} ${esc(it.name)}${it.segment ? "（" + esc(it.segment) + "）" : ""}<br>`;
+  }
+  html += "</div></details><details><summary>静态扫描逐条明细</summary><div class='gaplist'>";
+  const st = ((rc.static || {}).receipt || {}).items || [];
+  for (const it of st) {
+    html += `${lamp(it.result === "ok" ? "ok" : "bad", it.result)} ${esc(it.name)}<br>`;
+  }
+  html += "</div></details>";
+  document.getElementById("gateSummary").innerHTML = html;
+})();
+
+// ── 二、能力清单 × 六层灯 ──
+(function () {
+  const cl = C.capability_list;
+  if (!cl || !cl.segments) { document.getElementById("capabilityMatrix").innerHTML = "<p class='warn'>义务层缺数据——先跑 tools/extract_capability_list.py</p>"; return; }
+  const rc = C.gate_receipts || {};
+  const ex = ((C.exemptions || {}).abilities || []).map(s => String(s));
+  function layerOf(caseFile) {
+    if (/system_test/.test(caseFile)) return "system";
+    if (/probe\//.test(caseFile) || /_probe\.gd/.test(caseFile)) return "probe";
+    if (/golden|render/.test(caseFile)) return "render";
+    return "unit";
+  }
+  function rowLight(row) {
+    if (ex.includes(row.ability)) return lamp("ex", "豁免（coverage_exemptions.js 在册）");
+    if (!row.cases || !row.cases.length) return lamp("off", "无代表用例指针");
+    let worst = null; const seenLayers = new Set();
+    for (const c of row.cases) {
+      const layer = layerOf(c);
+      seenLayers.add(layer);
+      const r = (rc[layer] || {}).receipt;
+      if (!r || r.result === "not_run") { worst = worst || "na"; continue; }
+      if (r.result === "红") return lamp("bad", `${layer} 层跑批挂`);
+      if (layer === "unit") {
+        const items = r.items || [];
+        const hit = items.filter(it => c.indexOf(it.name.replace("res://tests/", "")) >= 0 || it.name.indexOf(c.split(":")[0].replace(".gd", "")) >= 0);
+        if (!hit.length) { worst = worst || "off"; continue; }
+        if (hit.some(it => it.result !== "PASS")) return lamp("bad", "代表套件红：" + c);
+        worst = worst || "ok";
+      } else {
+        worst = worst || (r.result === "绿" ? "ok" : "off");
+      }
+    }
+    if (worst === "ok") return lamp("ok", "承载层绿");
+    if (worst === "na") return lamp("na", "承载层本批未跑");
+    return lamp("off", "该层无对应承载（灰）");
+  }
+  let html = "";
+  for (const seg of cl.segments) {
+    if (!seg.rows.length) continue;
+    html += `<div class="seg"><h3 style="font-size:14px;margin:8px 0 4px">${esc(seg.segment)}（${seg.rows.length} 行）</h3>`;
+    html += "<table><tr><th style='width:32%'>能力</th><th>系统</th><th style='width:14%'>灯</th><th style='width:26%'>代表用例</th></tr>";
+    for (const row of seg.rows) {
+      html += `<tr><td>${esc(row.ability)}</td><td>${esc(row.system)}</td><td>${rowLight(row)}</td><td>${row.cases.map(esc).join("<br>")}</td></tr>`;
+    }
+    html += "</table></div>";
+  }
+  document.getElementById("capabilityMatrix").innerHTML = html;
+})();
+
+// ── 三、控件级下钻 ──
+(function () {
+  const pm = C.probe_manifest || {probes: []};
+  const ex = ((C.exemptions || {}).controls || []).map(s => String(s));
+  const rd = ((C.gate_receipts || {}).render || {}).receipt || {};
+  const renderScreens = [];
+  for (const it of (rd.items || [])) if (it.screens instanceof Array) renderScreens.push(...it.screens);
+  let html = "";
+  if (renderScreens.length) {
+    html += `<p class="note"><b>渲染展示登记（golden 逐屏）</b>：${renderScreens.map(esc).join("、")}</p>`;
+  }
+  for (const pf of pm.probes) {
+    const name = pf.replace(/^probe_hits_/, "").replace(/\.js$/, "");
+    // 同名重复 <script> 无法动态注入——manifest 落盘时同步内联一份数据入口由面板经 window 取
+    const data = (window.__QA_COVERAGE__.probe_real_input || {})[name];
+    if (!data) { html += `<p class="warn">${esc(name)}：登记文件未加载（检查 script 标签与 manifest）</p>`; continue; }
+    const hits = data.hits || {};
+    const seen = data.seen || [];
+    const gaps = seen.filter(k => !(k in hits) && !ex.some(e => k.indexOf(e) >= 0));
+    html += `<details open><summary><b>${esc(name)}</b>：命中 ${Object.keys(hits).length} 控件 / 存在 ${seen.length} 控件 / 零命中缺口 ${gaps.length}（@ ${esc(data.meta.generated_at)}）</summary><div class='gaplist'>`;
+    for (const g of gaps) html += `${lamp("off", "存在但零真输入命中")} ${esc(g)}<br>`;
+    html += "<b>已命中：</b><br>";
+    for (const k of Object.keys(hits).sort()) html += `${lamp("ok", "真输入命中 " + hits[k] + " 次")} ${esc(k)}×${hits[k]}<br>`;
+    html += "</div></details>";
+  }
+  document.getElementById("controlDrill").innerHTML = html || "<p class='warn'>探针登记缺数据——先跑探针与 tools/coverage_receipts.py</p>";
+})();
+
+// ── 四、本体对账 ──
+(function () {
+  const on = C.ontology;
+  if (!on || !on.categories) { document.getElementById("ontologyGaps").innerHTML = "<p class='warn'>本体数据缺——先跑 tools/coverage_enum.py</p>"; return; }
+  const ex = ((C.exemptions || {}).ontology || []).map(s => String(s));
+  const hitTexts = [];
+  const pri = (C.probe_real_input || {});
+  for (const k in pri) for (const hk of Object.keys(pri[k].hits || {})) hitTexts.push(hk);
+  let html = `<p class="note">实体 ${esc(on.meta.entities_total)} · 断言文料 ${esc(on.meta.corpus_rows)} 行 · 首见批次 ${esc(on.meta.generated_at)}</p>`;
+  for (const cat of on.categories) {
+    const shown = cat.gaps.filter(g => !ex.includes(g.id));
+    const probed = shown.filter(g => hitTexts.some(h => h.indexOf(g.id) >= 0));
+    const pure = shown.filter(g => !probed.includes(g));
+    html += `<details><summary><b>${esc(cat.category)}</b>：${cat.total} 实体 / 关联 ${cat.matched} / 缺口 ${shown.length}（其中探针承载 ${probed.length}）</summary><div class='gaplist'>`;
+    for (const g of probed) html += `${lamp("ok", "探针真输入命中承载")} ${esc(g.id)}　<span class="note">（断言文料零关联——交互覆盖由探针承载）</span><br>`;
+    for (const g of pure) html += `${lamp("off", "验证零关联缺口——人工复核后再立事项")} ${esc(g.id)}<br>`;
+    html += "</div></details>";
+  }
+  document.getElementById("ontologyGaps").innerHTML = html;
+})();
+</script>
+</body>
+</html>

tools/extract_capability_list.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+r"""extract_capability_list.py — 能力清单义务层提取器（B 覆盖总览面板·义务层）
+
+把 game/tests/README.md「能力清单」的四列表（能力｜系统｜真实入口｜代表用例）按旅程段
+解析成机器可读 JSONP .js，供 tools/coverage_report.html 经 <script src> 直载
+（file:// 下 fetch 本地 json 被 CORS 拦——JSONP 是 B 面板全数据源的统一形态）。
+
+用法:
+  python tools/extract_capability_list.py [--readme <路径>] [--out <路径>]
+
+判据口径：
+  - 只认表头恰为「能力｜系统｜真实入口｜代表用例」的四列表（覆盖域表等五列表不取）；
+  - 旅程段标题形态＝「**旅程段N：名称**」，段名进每行的 segment 字段；
+  - 代表用例列按「；」切分成用例指针数组（`文件:函数` 形态逐字保真）；
+  - 本工具是义务层的静态投影，产出随 README 变更重跑即得——面板只读本产物，禁在面板里改义务。
+
+产出（JSONP）:
+  window.__QA_COVERAGE__.capability_list = {
+    "meta": {"generated_at", "source", "rows_total", "segments_total"},
+    "segments": [{"segment": 名称, "rows": [{"ability", "system", "entry", "cases": []}]}],
+  }
+"""
+from __future__ import annotations
+
+import argparse
+import datetime
+import json
+import re
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+DEFAULT_README = ROOT / "game" / "tests" / "README.md"
+DEFAULT_OUT = ROOT / "game" / "tests" / ".gates" / "coverage" / "capability_list.js"
+
+SEGMENT_RE = re.compile(r"^\*\*旅程段[一二三四五六七八九十]+[：:](.+?)\*\*\s*$")
+
+
+
+def split_row(line: str) -> list[str]:
+    body = line.strip()
+    if body.startswith("|"):
+        body = body[1:]
+    if body.endswith("|"):
+        body = body[:-1]
+    return [c.strip() for c in body.split("|")]
+
+
+def parse(readme: Path) -> dict:
+    lines = readme.read_text(encoding="utf-8").splitlines()
+    segments: list[dict] = []
+    cur_seg: str | None = None
+    cur_rows: list[dict] | None = None
+    in_capability_table = False
+    for line in lines:
+        seg = SEGMENT_RE.match(line.strip())
+        if seg:
+            if cur_seg is not None:
+                segments.append({"segment": cur_seg, "rows": cur_rows or []})
+            cur_seg = seg.group(1).strip()
+            cur_rows = []
+            in_capability_table = False
+            continue
+        if cur_seg is None:
+            continue
+        if not line.strip().startswith("|"):
+            in_capability_table = False
+            continue
+        cells = split_row(line)
+        if all(not set(c) - {"-", " ", ":"} for c in cells) and cells:
+            continue   # 表头分隔行 |---|---|
+        if (len(cells) == 4 and cells[0] == "能力" and cells[1] == "系统"
+                and cells[2] == "真实入口" and cells[3].startswith("代表用例")):
+            in_capability_table = True
+            continue
+        if in_capability_table and len(cells) == 4:
+            ability, system, entry, cases = cells
+            cur_rows.append({
+                "ability": ability.strip("`"),
+                "system": system,
+                "entry": entry,
+                "cases": [c.strip().strip("`") for c in cases.split("；") if c.strip()],
+            })
+    if cur_seg is not None:
+        segments.append({"segment": cur_seg, "rows": cur_rows or []})
+    rows_total = sum(len(s["rows"]) for s in segments)
+    return {
+        "meta": {
+            "generated_at": datetime.datetime.now().isoformat(timespec="seconds"),
+            "source": str(readme),
+            "rows_total": rows_total,
+            "segments_total": len(segments),
+        },
+        "segments": segments,
+    }
+
+
+def dump_js(payload: dict, out: Path) -> None:
+    out.parent.mkdir(parents=True, exist_ok=True)
+    js = "/* 能力清单义务层投影——由 extract_capability_list.py 生成，随 README 变更重跑；人工修订无效（义务源=README 能力清单）。 */\n"
+    js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
+    js += "window.__QA_COVERAGE__.capability_list = %s;\n" % json.dumps(payload, ensure_ascii=False, indent=2)
+    out.write_text(js, encoding="utf-8", newline="\n")
+
+
+def main() -> int:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    ap = argparse.ArgumentParser(description="能力清单义务层提取（B 面板·义务层）")
+    ap.add_argument("--readme", default=str(DEFAULT_README))
+    ap.add_argument("--out", default=str(DEFAULT_OUT))
+    args = ap.parse_args()
+    readme = Path(args.readme)
+    if not readme.is_file():
+        print("[capability] README 不存在：%s" % readme)
+        return 1
+    payload = parse(readme)
+    dump_js(payload, Path(args.out))
+    print("[capability] 义务层投影已落盘 %s（旅程段 %d / 能力行 %d）" % (
+        args.out, payload["meta"]["segments_total"], payload["meta"]["rows_total"]))
+    if payload["meta"]["rows_total"] == 0:
+        print("[capability] 红：能力行数为 0——表头或旅程段标题形态不匹配，禁当空义务面用")
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tools/glow_discrimination_sheet.py

@@ -0,0 +1,465 @@
+# 三关色相 × 五组微光互辨抽测——S1 取铺底值（机检 D）＋ S2 出并列样图（机检 A/B/C）。
+# 执行依据：reports/提案-三关色相互辨抽测方案-2026-10-29.md（抽测任务=待办清单
+# 「三关色相 × 五组微光互辨抽测」条）。产物：并列样图（artwork/，不入 git）＋逐对读数表（reports/）。
+# 口径出处（冲突时以 owner 为准）：
+#   微光色值与呈现参数 = game/presentation/views/ui_kit.gd TG_GLOW_*/TYPE_GLOW_*（v2 冻结）；
+#   合成公式 = game/presentation/views/cell_type_glow.gdshader（blend_mix 距离场柔光）；
+#   带域/格心取样 = game/probe/type_glow_shot_probe.gd（de<格边×0.125 / 内缩 20%）；
+#   准入门值（亮度地板/饱和上限/禁入色相带/近色容差）单点在本件 FLOOR_L·CEIL_SAT·
+#     BANNED_HUE·NEAR_EPS；art-bible §4.1 只述「未开格底与微光存在相对亮度关系」并指路本件。
+#   既有色板比对池 = game/tests/golden/palette_baseline/ 两张条带并集（palette_check.py 同源）。
+# 方案 §2.3 机检 C 口径订正：模型 0.49/0.51 是反解近似（ui_kit.gd 头注「模型域与实测的差
+#   = shader 距离场权重非扁平混合」），比较对象改为 shader 精确合成模型（逐像素复刻），判据线
+#   ±2/255 沿用在役值。
+# 方案 §7 表二行数笔误订正：表二实为 90 行（3 关 × 3 底型 × 10 组对），非 30 行。
+#
+# 用法：
+#   python tools/glow_discrimination_sheet.py --art <artwork/mockups 目录> [--no-sheet]
+# 输出：
+#   <art>/glow-discrimination-sheet-2026-11-05.png（样图：正图段＋灰度副本段＋图例）
+#   reports/读数-三关色相互辨抽测-2026-11-05.md（逐对表 45 行＋组间表 90 行＋机检汇总）
+import argparse
+import math
+import os
+import sys
+
+from PIL import Image
+
+REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+# ── ui_kit.gd 冻结常量（逐字转写，禁改值）──
+GLOWS = [
+    ("BUFF", (247, 223, 67)),    # 通用增益·芥末黄
+    ("HEAL", (104, 208, 66)),    # 治疗·黄绿
+    ("PIERCE", (48, 166, 166)),  # 穿刺·青
+    ("MAGIC", (123, 91, 214)),   # 魔法·紫罗兰
+    ("AOE", (166, 29, 55)),      # 群伤·绯红
+]
+GLOW_ALPHA = 170.0 / 255.0
+BAND_FRAC = 0.125
+SOFT = 0.55
+CORNER = 2.0
+
+CELL = 45                      # D 区实比格边
+BAND = CELL * BAND_FRAC        # 5.625
+CORE_PAD = int(CELL * 0.20)    # 格心内缩（探针 CORE_PAD_FRAC=0.20）
+
+# ── 铺底准入门值单点（文档侧只述「未开格底与微光存在相对亮度关系」，数值归本件）──
+FLOOR_L = 0.30                 # 未开格底相对亮度地板（线性域）
+CEIL_SAT = 0.55                # 饱和度上限
+BANNED_HUE = (300.0, 345.0)    # 禁入色相带（Boss 紫赤独占）
+NEAR_EPS = 8                   # 近色容差（三通道差全 <此值 即近色）
+B_MIN_CH_DIFF = 8              # 机检 B｜格底-微光可辨底线（三通道至少一通道 ≥此值）
+C_MODEL_TOL = 2                # 机检 C｜样图与合成模型容差（±此值 /255）
+BOARD_TYPES = ["dungeon", "underdark", "deep_underdark"]
+BASE_VARIANTS = [  # （底型名，瓦片件名后缀）——素砖 + 两种装饰变体（高墙瓦片词表在册件）
+    ("素砖", "terrain_wall_center"),
+    ("裂纹", "terrain_wall_center_crack"),
+    ("碎石斑", "terrain_wall_center_speckle"),
+]
+
+TILE_DIR = os.path.join(REPO, "game", "assets", "art", "board")
+BASELINE_DIR = os.path.join(REPO, "game", "tests", "golden", "palette_baseline")
+
+CHECKS = []
+
+
+def check(cid, name, ok, detail=""):
+    CHECKS.append((cid, name, bool(ok), detail))
+    print("[%s] %s %s — %s%s" % ("PASS" if ok else "FAIL", cid, name, "✓" if ok else "✗",
+                                 ("；" + detail) if detail else ""))
+
+
+# ── 色彩数学 ──
+def to_linear(v):
+    c = v / 255.0
+    return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4
+
+
+def rel_lum(rgb):
+    return 0.2126 * to_linear(rgb[0]) + 0.7152 * to_linear(rgb[1]) + 0.0722 * to_linear(rgb[2])
+
+
+def gray709(rgb):
+    return 0.2126 * rgb[0] + 0.7152 * rgb[1] + 0.0722 * rgb[2]
+
+
+def hsv(rgb):
+    r, g, b = [v / 255.0 for v in rgb]
+    mx, mn = max(r, g, b), min(r, g, b)
+    d = mx - mn
+    if d == 0:
+        h = 0.0
+    elif mx == r:
+        h = 60 * ((g - b) / d % 6)
+    elif mx == g:
+        h = 60 * ((b - r) / d + 2)
+    else:
+        h = 60 * ((r - g) / d + 4)
+    s = 0.0 if mx == 0 else d / mx
+    return h % 360, s
+
+
+def wcag(c1, c2):
+    l1, l2 = rel_lum(c1), rel_lum(c2)
+    return (max(l1, l2) + 0.05) / (min(l1, l2) + 0.05)
+
+
+def smoothstep(e0, e1, x):
+    t = max(0.0, min(1.0, (x - e0) / (e1 - e0)))
+    return t * t * (3.0 - 2.0 * t)
+
+
+def glow_weight(px, py):
+    """shader 复刻：像素中心 (px,py) 的微光权重 = glow_alpha × a(d) × mask。"""
+    h = CELL / 2.0
+    d = min(px, py, CELL - px, CELL - py)
+    r = min(CORNER, CELL * 0.25)
+    qx = abs(px - h) - (h - r)
+    qy = abs(py - h) - (h - r)
+    outside = math.hypot(max(qx, 0.0), max(qy, 0.0)) + min(max(qx, qy), 0.0) - r
+    mask = 1.0 - smoothstep(-1.0, 0.5, outside)
+    a = 0.0
+    if d < BAND:
+        a = 1.0 - smoothstep(SOFT, 1.0, d / BAND)
+    return GLOW_ALPHA * a * mask
+
+
+# ── 素材装载 ──
+def load_tiles():
+    tiles = {}
+    for bt in BOARD_TYPES:
+        for vn, stem in BASE_VARIANTS:
+            path = os.path.join(TILE_DIR, "%s_%s.png" % (stem, bt))
+            if not os.path.exists(path):
+                print("[阻塞] 素材缺位：%s" % path, file=sys.stderr)
+                sys.exit(2)
+            img = Image.open(path).convert("RGB")
+            if img.size != (CELL, CELL):
+                img = img.resize((CELL, CELL), Image.NEAREST)
+            tiles[(bt, vn)] = img.load()
+    return tiles
+
+
+def lit_slots(tiles):
+    """铺底代表值 = 该关三块底型瓦片像素里线性亮度最大的实测色（顶面受光档）。
+    零表值：不引用任何色表常量，素材换色后读数自动跟随。"""
+    slots = {}
+    for bt in BOARD_TYPES:
+        best = None
+        for vn, _ in BASE_VARIANTS:
+            px = tiles[(bt, vn)]
+            for y in range(CELL):
+                for x in range(CELL):
+                    c = px[x, y]
+                    if best is None or rel_lum(c) > rel_lum(best):
+                        best = c
+        slots[bt] = best
+    return slots
+
+
+# ── 带域/格心取样（探针口径）──
+def band_pixels():
+    """带域像素集（整数格坐标 de < 格边×0.125，type_glow_shot_probe 口径）。"""
+    return [(x, y) for x in range(CELL) for y in range(CELL)
+            if min(x, y, CELL - 1 - x, CELL - 1 - y) < BAND]
+
+
+def core_pixels():
+    """格心像素集（内缩 20%）。"""
+    return [(x, y) for x in range(CELL) for y in range(CELL)
+            if min(x, y, CELL - 1 - x, CELL - 1 - y) >= CELL * 0.20]
+
+
+BAND_PX = band_pixels()
+CORE_PX = core_pixels()
+
+
+def mean_rgb(px, pts):
+    n = len(pts)
+    return tuple(round(sum(px[x, y][i] for x, y in pts) / n) for i in range(3))
+
+
+def model_band_mean(base_px, glow_rgb):
+    """shader 精确合成模型：逐像素 blend_mix 理论带内均值（独立实现路径）。"""
+    n = len(BAND_PX)
+    acc = [0.0, 0.0, 0.0]
+    for x, y in BAND_PX:
+        w = glow_weight(x + 0.5, y + 0.5)
+        b = base_px[x, y]
+        for i in range(3):
+            acc[i] += w * glow_rgb[i] + (1.0 - w) * b[i]
+    return tuple(round(v / n) for v in acc)
+
+
+# ── 机检 D：铺底代表值五门 ──
+def load_baseline_palette():
+    cols = set()
+    for fn in ["ui_tokens.png", "art_snapshot.png"]:
+        p = os.path.join(BASELINE_DIR, fn)
+        img = Image.open(p).convert("RGB")
+        for x in range(img.width):
+            for y in range(img.height):
+                cols.add(img.getpixel((x, y)))
+    return sorted(cols)
+
+
+def gate_d(tiles):
+    baseline = load_baseline_palette()
+    lit = lit_slots(tiles)
+    rows = []
+    all_pass = True
+    for bt in BOARD_TYPES:
+        rgb = lit[bt]
+        h, s = hsv(rgb)
+        lin = rel_lum(rgb)
+        l_ok = lin >= FLOOR_L
+        s_ok = s <= CEIL_SAT
+        hue_ok = not (BANNED_HUE[0] <= h <= BANNED_HUE[1])
+        # 近色门：三值=在役素材色（已在基线池内），palette_check 双门②只判新增色——报读数不判红
+        near = [b for b in baseline if all(abs(rgb[i] - b[i]) < NEAR_EPS for i in range(3))]
+        ok = l_ok and s_ok and hue_ok
+        all_pass = all_pass and ok
+        rows.append((bt, rgb, lin, s, h, len(near), ok))
+        check("D-" + bt, "铺底代表值门（底型瓦片实测顶面受光档；亮度/饱和/禁入带，近色只报读数）", ok,
+              "RGB=%s L=%.3f 饱和=%.3f 色相=%.1f° 近色对=%d（在役素材色，非新增）%s%s%s"
+              % (rgb, lin, s, h, len(near),
+                 "" if l_ok else " [L红]", "" if s_ok else " [饱和红]",
+                 "" if hue_ok else " [禁入带红]"))
+        # 语义检查=设计面人工核对（palette_check 同口径），打印读数不判红
+        print("  [语义] %s=%s 环境域（不占红/金/蓝/紫赤/绿语义段）——人工核对" % (bt, rgb))
+    # 渲染面带域均值 = 读数不判红（方案机检 D 只判槽值；本读数供观感定性参考）
+    for bt in BOARD_TYPES:
+        for vn, _ in BASE_VARIANTS:
+            m = mean_rgb(tiles[(bt, vn)], BAND_PX)
+            lin = rel_lum(m)
+            print("  [读数] 渲染面带域均值 %s/%s RGB=%s L=%.3f（不判红）" % (bt, vn, m, lin))
+    return all_pass, rows
+
+
+# ── 样图绘制 ──
+PAGE_W, PAGE_H = 640, 1120
+MARGIN, HEAD, BLOCK_TITLE, GAP, LEGEND = 10, 60, 20, 30, 80
+
+
+def draw_sheet(out_path):
+    import argparse  # noqa: F401
+    from PIL import ImageDraw, ImageFont
+    img = Image.new("RGB", (PAGE_W, PAGE_H), (255, 255, 255))
+    d = ImageDraw.Draw(img)
+    try:
+        f_zh = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 13)
+        f_zh_s = ImageFont.truetype("C:/Windows/Fonts/msyh.ttc", 11)
+    except OSError:
+        f_zh = ImageFont.load_default()
+        f_zh_s = f_zh
+
+    blocks = []
+    y = MARGIN + HEAD
+    for bt in BOARD_TYPES:
+        d.text((MARGIN + 4, y + 3), "%s —— 列0=基准格，列1–5=五组微光（阶梯序）" % bt, fill=(0, 0, 0), font=f_zh)
+        y += BLOCK_TITLE
+        blocks.append((bt, y))
+        y += 3 * CELL
+
+    tiles = load_tiles()
+    # 画正图段 54 格
+    cell_pngs = {}
+    for bt, y0 in blocks:
+        for ri, (vn, _) in enumerate(BASE_VARIANTS):
+            for ci, gname in enumerate(["BASE"] + [g[0] for g in GLOWS]):
+                base = tiles[(bt, vn)]
+                cell = Image.new("RGB", (CELL, CELL))
+                cp = cell.load()
+                if gname == "BASE":
+                    for x in range(CELL):
+                        for yy in range(CELL):
+                            cp[x, yy] = base[x, yy]
+                else:
+                    glow = dict(GLOWS)[gname]
+                    for x in range(CELL):
+                        for yy in range(CELL):
+                            w = glow_weight(x + 0.5, yy + 0.5)
+                            b = base[x, yy]
+                            cp[x, yy] = tuple(round(w * glow[i] + (1 - w) * b[i]) for i in range(3))
+                gx = MARGIN + 170 + ci * CELL
+                gy = y0 + ri * CELL
+                img.paste(cell, (gx, gy))
+                cell_pngs[(bt, vn, gname, "main")] = (gx, gy)
+        # 行标注
+        for ri, (vn, _) in enumerate(BASE_VARIANTS):
+            d.text((MARGIN, y0 + ri * CELL + 16), vn, fill=(0, 0, 0), font=f_zh_s)
+
+    # 灰度副本段（等幅面，正图段整段 Rec.709 去色）
+    main_top = MARGIN + HEAD
+    main_bot = y
+    gray_top = main_bot + GAP
+    for xx in range(MARGIN, PAGE_W - MARGIN):
+        for yy in range(main_top, main_bot):
+            r, g, b = img.getpixel((xx, yy))
+            v = int(round(gray709((r, g, b))))
+            img.putpixel((xx, gray_top + (yy - main_top)), (v, v, v))
+    d.text((MARGIN + 4, gray_top - 2), "灰度副本段（Rec.709 去色——色弱通道目检面）", fill=(80, 80, 80), font=f_zh_s)
+
+    # 图例段
+    leg_y = gray_top + (main_bot - main_top) + 10
+    d.text((MARGIN + 4, leg_y), "图例（五组冻结色值 ui_kit.gd TG_GLOW_*；阶梯序=合成空间亮度递减）", fill=(0, 0, 0), font=f_zh_s)
+    for i, (gn, rgb) in enumerate(GLOWS):
+        x0 = MARGIN + 170 + i * (CELL + 4)
+        d.rectangle([x0, leg_y + 18, x0 + CELL, leg_y + 18 + 28], fill=rgb, outline=(0, 0, 0))
+        d.text((x0, leg_y + 48), gn, fill=(0, 0, 0), font=f_zh_s)
+
+    img.save(out_path)
+    return img, cell_pngs, tiles, blocks, gray_top, main_top, main_bot
+
+
+# ── 机检 A/B/C ＋ 灰度/净空机检 ──
+def run_checks(img, cell_pngs, tiles, blocks, gray_top, main_top, main_bot):
+    sheet_px = img.load()
+    table1 = []   # 45 行逐对表
+    table2 = []   # 90 行组间表
+    band_means = {}
+    fail_b, fail_c = [], []
+    lit = lit_slots(tiles)
+
+    for bt, y0 in blocks:
+        for vn, _ in BASE_VARIANTS:
+            # 列 0 基准格带域均值 = 该底型的模型底值
+            gx0, gy0 = cell_pngs[(bt, vn, "BASE", "main")]
+            band_base = mean_rgb(tiles[(bt, vn)], BAND_PX)
+            for gi, (gname, glow) in enumerate(GLOWS):
+                gx, gy = cell_pngs[(bt, vn, gname, "main")]
+                px = tiles[(bt, vn)]
+                # 样图带内均值（样图渲染面读数）
+                n = len(BAND_PX)
+                acc = [0.0, 0.0, 0.0]
+                for x, yy in BAND_PX:
+                    p = sheet_px[gx + x, gy + yy]
+                    for i in range(3):
+                        acc[i] += p[i]
+                band_mean = tuple(round(v / n) for v in acc)
+                core_mean = mean_rgb(px, CORE_PX)
+                model = model_band_mean(px, glow)
+                diff_model = max(abs(band_mean[i] - model[i]) for i in range(3))
+                ch_diff = [abs(band_mean[i] - core_mean[i]) for i in range(3)]
+                b_ok = max(ch_diff) >= B_MIN_CH_DIFF
+                c_ok = diff_model <= C_MODEL_TOL
+                if not b_ok:
+                    fail_b.append("%s/%s/%s" % (bt, vn, gname))
+                if not c_ok:
+                    fail_c.append("%s/%s/%s" % (bt, vn, gname))
+                hue_gap = abs(hsv(lit[bt])[0] - hsv(glow)[0])
+                hue_gap = min(hue_gap, 360 - hue_gap)
+                table1.append((bt, vn, gname, band_mean, core_mean, model,
+                               diff_model, ch_diff, hue_gap, b_ok and c_ok))
+                band_means[(bt, vn, gname)] = band_mean
+
+    # 机检 A：组间表 90 行
+    for bt, y0 in blocks:
+        for vn, _ in BASE_VARIANTS:
+            for i in range(len(GLOWS)):
+                for j in range(i + 1, len(GLOWS)):
+                    a, b = band_means[(bt, vn, GLOWS[i][0])], band_means[(bt, vn, GLOWS[j][0])]
+                    cr = wcag(a, b)
+                    ok = cr >= 1.20
+                    table2.append((bt, vn, "%s/%s" % (GLOWS[i][0], GLOWS[j][0]),
+                                   cr, gray709(a), gray709(b), ok))
+    stair_ok = True
+    for bt, y0 in blocks:
+        for vn, _ in BASE_VARIANTS:
+            seq = [gray709(band_means[(bt, vn, GLOWS[k][0])]) for k in range(len(GLOWS))]
+            mono = all(seq[k] > seq[k + 1] for k in range(len(seq) - 1))
+            stair_ok = stair_ok and mono
+            check("A-stair-%s-%s" % (bt, vn[:4]), "明度阶梯单调递减", mono,
+                  "→".join("%.3f" % v for v in seq))
+    min_cr = min(t[3] for t in table2)
+    worst = min(table2, key=lambda t: t[3])
+    check("A-CR", "组间合成对比最弱对 ≥1.20（90 对）", min_cr >= 1.20,
+          "最弱 %s/%s CR=%.3f" % (worst[0], worst[2], min_cr))
+    check("B", "格底-微光可辨底线（45 行三通道差不全<8）", len(fail_b) == 0,
+          "违例 %d 行：%s" % (len(fail_b), ", ".join(fail_b[:6]) or "无"))
+    check("C", "绘制参数校准（45 行模型差≤±2/255）", len(fail_c) == 0,
+          "违例 %d 行：%s" % (len(fail_c), ", ".join(fail_c[:6]) or "无"))
+
+    # 灰度段零彩色像素
+    color_hit = 0
+    for xx in range(MARGIN, PAGE_W - MARGIN):
+        for yy in range(gray_top + BLOCK_TITLE, gray_top + (main_bot - main_top)):
+            r, g, b = sheet_px[xx, yy]
+            if not (r == g == b):
+                color_hit += 1
+    check("GRAY", "灰度副本段零彩色像素", color_hit == 0, "命中 %d" % color_hit)
+
+    # 四缘净空（A5 同款）
+    edge_hit = 0
+    for xx in range(PAGE_W):
+        for yy in range(PAGE_H):
+            if xx < MARGIN or xx >= PAGE_W - MARGIN or yy < MARGIN or yy >= PAGE_H - MARGIN:
+                if sheet_px[xx, yy] != (255, 255, 255):
+                    edge_hit += 1
+    check("EDGE", "四缘 10px 带内零内容像素", edge_hit == 0, "命中 %d" % edge_hit)
+    return table1, table2
+
+
+def write_report(table1, table2, d_rows):
+    rep = os.path.join(REPO, "reports", "读数-三关色相互辨抽测-2026-11-05.md")
+    lines = [
+        "# 读数：三关色相 × 五组微光互辨抽测（2026-11-05）",
+        "",
+        "> 接收方：待办清单「三关色相 × 五组微光互辨抽测——三关图类型色板终值冻结的前置抽测」条。",
+        "> 执行依据：reports/提案-三关色相互辨抽测方案-2026-10-29.md（S1/S2 步）。",
+        "> 样图：artwork/mockups/glow-discrimination-sheet-2026-11-05.png（不入 git）。",
+        "",
+        "## 机检汇总",
+        "",
+        "| 项 | 判定 | 说明 |",
+        "|---|---|---|",
+    ]
+    for cid, name, ok, detail in CHECKS:
+        lines.append("| %s | %s | %s：%s |" % (cid, "PASS" if ok else "FAIL", name, detail))
+    lines += ["", "## S1 机检 D：铺底代表值（底型瓦片实测顶面受光档）五门", "",
+              "| 关 | RGB | L（线性域） | 饱和 | 色相 | 近色对 | 判定 |", "|---|---|---|---|---|---|---|"]
+    for bt, rgb, lin, s, h, near, ok in d_rows:
+        lines.append("| %s | %s | %.3f | %.3f | %.1f° | %d | %s |" % (bt, rgb, lin, s, h, near, "过" if ok else "红"))
+    lines += ["", "## 表一 逐对表（45 行）", "",
+              "| 关 | 底型 | 微光组 | 带内合成均值 | 格心素底均值 | 模型带内均值 | 模型差 | 三通道差 | 色相差° | 判定 |",
+              "|---|---|---|---|---|---|---|---|---|---|"]
+    for bt, vn, gn, bm, cm, md, dm, cd, hg, ok in table1:
+        lines.append("| %s | %s | %s | %s | %s | %s | %d | %s | %.0f | %s |"
+                     % (bt, vn, gn, bm, cm, md, dm, cd, hg, "过" if ok else "红"))
+    lines += ["", "## 表二 组间表（90 行）", "",
+              "| 关 | 底型 | 组对 | 合成对比 | 灰度亮度a | 灰度亮度b | 判定 |", "|---|---|---|---|---|---|---|"]
+    for bt, vn, pair, cr, ga, gb, ok in table2:
+        lines.append("| %s | %s | %s | %.3f | %.3f | %.3f | %s |" % (bt, vn, pair, cr, ga, gb, "过" if ok else "红"))
+    n_fail = sum(1 for c in CHECKS if not c[2])
+    lines += ["", "---", "", "机检 %d 项，FAIL %d 项。" % (len(CHECKS), n_fail),
+              "", "目检（S3）归用户：四条判据见方案 §2.2（逐对指认 45/45／灰度副本 45/45／相邻并列 36 对可辨／装饰不抢读）。", ""]
+    with open(rep, "w", encoding="utf-8") as f:
+        f.write("\n".join(lines))
+    print("[报告] %s" % rep)
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--art", default=os.path.join(REPO, "artwork", "mockups"))
+    ap.add_argument("--no-sheet", action="store_true")
+    args = ap.parse_args()
+    tiles = load_tiles()
+    print("== S1 机检 D：三关铺底代表值 ==")
+    d_ok, d_rows = gate_d(tiles)
+    if args.no_sheet:
+        return 0 if d_ok else 1
+    os.makedirs(args.art, exist_ok=True)
+    out = os.path.join(args.art, "glow-discrimination-sheet-2026-11-05.png")
+    print("== S2 出并列样图 ==")
+    img, cell_pngs, tiles2, blocks, gray_top, main_top, main_bot = draw_sheet(out)
+    print("[样图] %s" % out)
+    t1, t2 = run_checks(img, cell_pngs, tiles2, blocks, gray_top, main_top, main_bot)
+    write_report(t1, t2, d_rows)
+    n_fail = sum(1 for c in CHECKS if not c[2])
+    print("== 抽测机检完成：%d 项，FAIL %d ==" % (len(CHECKS), n_fail))
+    return 0 if n_fail == 0 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

tools/hooks/pre-merge-commit

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# 合回前置检查钩子（git pre-merge-commit，2026-11-06 用户裁）——主工作区 git merge 落合并提交前
+#   跑最小验证面：tools/run_all_gates.sh --premerge（冒烟测试＋单元与集成全套件 4 分片，热导入缓存约 2 分钟）。
+# 语义（git 2.45.2.windows.1 本机实测）：本钩子拦的是「合并提交」不是「合并动作」——exit≠0 时合并结果
+#   已进暂存区、仓库停 MERGE_HEAD 待提交态；处置二选一：修红后 git commit 续合，或 git merge --abort 放弃。
+# 快进合并不触发本钩子（git 语义）——本仓合回铁规恒 --no-ff，漏写时远端 CI 兜底仍在。
+# --no-verify 可整体跳过（实测）——仅属用户，agent 禁用（worktree-guard 在案）。
+# 仅主工作区触发（worktree 内合并不触发，与 post-merge 同款 git-dir 判别）。
+# 冷缓存注意：本机首次跑批前先刷导入（$GODOT --headless --path game --editor --quit，约 20 秒），
+#   否则冷导入可致套件内建 120 秒超时假红；主工作区 .godot 缓存常驻，日常免此步。
+set -u
+_GD="$(cd "$(git rev-parse --git-dir)" && pwd)"
+_CD="$(cd "$(git rev-parse --git-common-dir)" && pwd)"
+[ "$_GD" = "$_CD" ] || exit 0
+REPO="$(git -C "$(dirname "$0")" rev-parse --show-toplevel 2>/dev/null || pwd)"
+bash "$REPO/tools/run_all_gates.sh" --premerge
+RC=$?
+if [ "$RC" -ne 0 ]; then
+	echo "" >&2
+	echo "[pre-merge-commit] ✗ 前置检查红（读数如上）——合并提交未落，仓库停 MERGE_HEAD 待提交态。" >&2
+	echo "    处置二选一：① 修红后 git commit 续合本合并；② 放弃整次合并＝git merge --abort。" >&2
+	exit 1
+fi
+echo "[pre-merge-commit] ✓ 前置检查绿——合并提交继续。"
+exit 0

tools/run_all_gates.sh

@@ -9,7 +9,11 @@
 # 只服务开发期按域跑批；--gates 档另为远端纯闸件/管线批的执行形态（domain_route.sh 判 gates → ci.yml 映射 --gates）。
 # 跑闸时代码面带着未提交改动，回执会标 dirty_game（验的不是 HEAD 字节）。
 #
-# 用法：tools/run_all_gates.sh [--code|--docs|--gates|--quick]
+# 用法：tools/run_all_gates.sh [--code|--docs|--gates|--premerge|--quick]
+#   --premerge 合回前置检查档（2026-11-06 用户裁）：只跑冒烟测试＋单元与集成测试全套件（4 分片，
+#           热导入缓存约 2 分钟）——主工作区 git merge --no-ff 落合并提交前由 pre-merge-commit
+#           钩子自动调用的拦截面。退出码聚合即判定（三硬闸口径），不落回执、不比基线——
+#           验证台账归合回后远端 CI，本档只做当场拦截。快进合并不触发钩子；--no-verify 仅属用户。
 #   --code  只跑代码域闸（冒烟测试／系统测试／单元与集成测试／场景探针／
 #           渲染闸／静态扫描＋熵增闸）
 #           ——本批改动含 game/ 下非 .md 的行为载体（代码/测试脚本/探针/场景/数据表/素材）时用。
@@ -56,10 +60,10 @@ DOMAIN="full"
 while [ $# -gt 0 ]; do
 	case "$1" in
 		--quick) QUICK=1 ;;
-		--code|--docs|--gates)
-			[ "$DOMAIN" = "full" ] || { echo "用法: --code/--docs/--gates 互斥"; exit 2; }
+		--code|--docs|--gates|--premerge)
+			[ "$DOMAIN" = "full" ] || { echo "用法: --code/--docs/--gates/--premerge 互斥"; exit 2; }
 			DOMAIN="${1#--}" ;;
-		*) echo "用法: tools/run_all_gates.sh [--code|--docs|--gates|--quick]"; exit 2 ;;
+		*) echo "用法: tools/run_all_gates.sh [--code|--docs|--gates|--premerge|--quick]"; exit 2 ;;
 	esac
 	shift
 done
@@ -67,7 +71,7 @@ done
 # 每个代码面 worktree 用独立 Godot user 目录（game/override.cfg 由 setup 脚本自愈生成；主区 no-op）。
 # 并行批共用一套夹具、日志与截图目录会互相踩盘造成假红——隔离建不起来就拒跑（fail-closed）。
 # 隔离只服务代码域（Godot 运行面）；文档域与闸件自检档不启引擎，跳过省 0.8 秒。
-if [ "$DOMAIN" = "code" ] || [ "$DOMAIN" = "full" ]; then
+if [ "$DOMAIN" = "code" ] || [ "$DOMAIN" = "full" ] || [ "$DOMAIN" = "premerge" ]; then
 	"$REPO/tools/setup_worktree_userdir.sh" "$REPO" || {
 		echo "[gates] FAIL — user 目录隔离未建立，拒绝在共享目录上跑闸。"
 		exit 1
@@ -82,7 +86,8 @@ export PYTHONIOENCODING=utf-8
 # 代码面（game/ 下非 .md 的行为载体）是否带着未提交改动（只算已跟踪文件——闸件自身产物都落在
 # gitignore 面）。脏树跑出来的回执记的是 HEAD，验的却是别的字节，回执标 dirty_game 由 CI 落账留痕。
 DIRTY_GAME=0
-if [ -n "$(git -C "$REPO" -c core.quotepath=false diff HEAD --name-only -- game/ 2>/dev/null | grep -viE '\.md$')" ]; then
+# premerge 档不查脏树：钩子跑在合并提交落笔前，合并内容本就未提交（diff HEAD＝待合内容），无回执可比。
+if [ "$DOMAIN" != "premerge" ] && [ -n "$(git -C "$REPO" -c core.quotepath=false diff HEAD --name-only -- game/ 2>/dev/null | grep -viE '\.md$')" ]; then
 	DIRTY_GAME=1
 	echo "[gates] 警告：代码面（game/ 下非 .md）有未提交改动——本次回执将标 dirty_game，不能用于合回（先提交再跑）。"
 fi
@@ -130,7 +135,7 @@ in_domain() {   # in_domain <code|docs|both>
 # 所以 git worktree 检出的工程天生缺全部美术素材：main_theme.tres 解析失败 → 按钮五个样式盒全空
 # → 冒烟 V1 成片假红；渲染闸又会因素材缺位把两段 golden 直接跳过（见 render_gate.sh）。
 # 缺位即拒跑——禁带着空盘跑完，把「什么都没比」的回执当全绿合回。
-if in_domain code; then
+if in_domain code || [ "$DOMAIN" = "premerge" ]; then
 	_miss=""
 	for a in assets/art/ui/button_stone.png assets/fonts/ui_font_fusion_pixel_zh_hans.ttf \
 		assets/art/board/seal_mark.png assets/art/character/character_hero_idle.png \
@@ -405,8 +410,8 @@ gate_unit() {   # run_all 是 --script 模式，退出码为唯一判据；分
 
 # ══ 闸件自检段（gates 档专属）══
 # 闸壳自检：bash -n 过全部 bash 闸件与管线件——闸件批改的就是这些件，语法坏＝下一批真跑闸时才炸，
-# 闸件批当场拦住。收件面动态收全：tools/ 全部 .sh＋game/tests 顶层 .sh（静态扫描）＋hooks/post-merge
-# （无后缀件）；新增 bash 闸件自动入检面，无需维护清单。
+# 闸件批当场拦住。收件面动态收全：tools/ 全部 .sh＋game/tests 顶层 .sh（静态扫描）＋hooks/ 无后缀件
+# （post-merge／pre-merge-commit）；新增 bash 闸件自动入检面，无需维护清单。
 gate_shell_selfcheck() {
 	local name="闸壳自检"
 	local rc=0 _n=0 _bad=0 _s
@@ -414,7 +419,7 @@ gate_shell_selfcheck() {
 	while IFS= read -r _s; do [ -n "$_s" ] && _shells+=("$_s"); done < <(
 		{ find "$REPO/tools" -name '*.sh' 2>/dev/null
 		  find "$REPO/game/tests" -maxdepth 1 -name '*.sh' 2>/dev/null
-		  echo "$REPO/tools/hooks/post-merge"; } | sort -u
+		  find "$REPO/tools/hooks" -maxdepth 1 -type f ! -name '*.sh' 2>/dev/null; } | sort -u
 	)
 	echo ""
 	echo "════════════════════════════════════════════"
@@ -442,6 +447,15 @@ gate_shell_selfcheck() {
 	return 0
 }
 
+# ══ 合回前置检查档（premerge，2026-11-06 用户裁）══
+# 冒烟＋单元与集成全套件（4 分片）——合回 merge 点的最小人工拦截面；不是全量、不替代远端 CI。
+# 选闸推导整段跳过（本档不按 diff 选闸——合回是最后拦截点，恒全套件）；退出码聚合即判定，
+# 不落回执不比基线（回执与基线面归远端 CI，本档读数只进合并现场）。
+if [ "$DOMAIN" = "premerge" ]; then
+	gate "冒烟测试" "smoke_boot.log" "$PY" "$REPO/tools/run_smoke.py"
+	gate_unit
+fi
+
 # ══ 代码域 ══
 if in_domain code; then
 # ── 冒烟测试（极小启动场景：真实开机路径存活检查，零逻辑判定，秒级）──
@@ -493,7 +507,10 @@ fi
 
 # ── 静态扫描（代码域与闸件自检档）+ 熵增闸（各档都跑：它查顶层目录/根文件/图像白名单/退役路径，
 #      文档批新增或挪动 design/ 下的文件同样会绊它；纯文本扫描，秒级）──
-if [ $QUICK -eq 0 ]; then
+# premerge 档不入此面：前置检查只盯冒烟＋单元，静态扫描与熵增闸由合回后远端 CI 盯。
+if [ "$DOMAIN" = "premerge" ]; then
+	echo ""; echo "[gates] 静态扫描／熵增闸 → 不入前置检查面（premerge；闸况归合回后远端 CI）"
+elif [ $QUICK -eq 0 ]; then
 	if in_domain code || [ "$DOMAIN" = "gates" ]; then
 		gate "静态扫描" "static_scan.log" bash "$GAME/tests/static_scan.sh"
 	fi
@@ -506,6 +523,23 @@ else
 	echo ""; echo "[gates] 静态扫描（代码域）/ 熵增闸 → SKIP（--quick）"
 fi
 
+# ── premerge 档汇总：退出码聚合即判定（三硬闸口径），不落回执不比基线 ──
+if [ "$DOMAIN" = "premerge" ]; then
+	RC=0
+	for _e in "${EXITS[@]}"; do
+		[ "$_e" -ne 0 ] && RC=1
+	done
+	echo ""
+	echo "════════════════════════════════════════════"
+	echo "  前置检查汇总（premerge——退出码即判定，不落回执）"
+	for _i in "${!NAMES[@]}"; do
+		_s="绿"; [ "${EXITS[$_i]}" -ne 0 ] && _s="红"
+		printf '  %s：%s（exit=%s）\n' "${NAMES[$_i]}" "$_s" "${EXITS[$_i]}"
+	done
+	echo "════════════════════════════════════════════"
+	exit $RC
+fi
+
 # ── 与存量基线比对 ──
 "$PY" - "$BASELINE" "$RECEIPT" "$QUICK" "$DOMAIN" "$REPO" "$DIRTY_GAME" "$SCOPE" "$ONLY_TERMS" "${NAMES[@]}" -- "${EXITS[@]}" -- "${LOGS[@]}" <<'PYEOF'
 import hashlib, json, os, re, subprocess, sys
@@ -648,5 +682,7 @@ RC=$?
 echo ""
 echo "════════════════════════════════════════════"
 printf '  回执：%s\n  基线：%s\n  commit：%s\n' "$RECEIPT" "$BASELINE" "$(git -C "$REPO" rev-parse --short HEAD 2>/dev/null || echo '?')"
+# B 覆盖总览面板·执行层六源明细化（观测件非判定件——解析失败打红字不翻闸判，coverage_receipts.py 头注）
+"$PY" "$REPO/tools/coverage_receipts.py" --stamp-dir "$STAMP_DIR" || true
 echo "════════════════════════════════════════════"
 exit $RC

体验验证清单.md

@@ -508,3 +508,14 @@
 | 1 | 三关封印格观感 | 环＋十字＋环外压暗光圈呈形正确、与格底可辨；像素判据已在机检承载，本项为观感复核 |
 | 2 | 战末金蜡封徽记观感 | 贴图路径未动（零预期变化）——观感确认项 |
 | 3 | 封印格与变异纹带同格观感 | 两层共存可辨、不脏面（零代码触面——观感确认项） |
+## 52 卷轴视口与结算文案换代目检（迭代 53）
+
+> 关卡画面视口化（卷轴视口）与结算文案换代（减半标签）后，机检已覆盖行为与像素面（探针 26 断言＋golden 两 Shot 逐像素＋明细行等值断言），观感面按登记不阻塞立规不拦合并。
+
+| # | 目检项 | 判据 |
+|---|---|---|
+| 1 | 深图卷轴视口实跑观感 | 深度 13+ 图拖拽平滑可达首末列；停点推进跟随方向感自然、当前节点居中锚即时；拖拽不误触选路 |
+| 2 | 指引件观感 | 深图两侧渐隐带与顶部平移提示 chip 可辨、不碍选路；浅图两件均不出现 |
+| 3 | 结算明细减半标签 | 「挖掘惩罚减半（6→3）」一眼可读，无退役件名突兀感 |
+
+- **结论回流**：观感问题归待办清单登记新条目；数值面不在目检现场改数。

待办清单.md

@@ -2,14 +2,6 @@
 
 本清单是流水线的唯一登记处：以后才做的事在此登记一条，随流水线段推进改状态，做完整条删除（条目记进度，不是各段的开工前置）；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
 
-#### 三关色相 × 五组微光互辨抽测——三关图类型色板终值冻结的前置抽测（2026-10-28 登记，来源=会话提及）
-
-**实况**：三关图类型色板（`tile_closed` 与 `wall_ambient` 两槽）终值冻结前须先跑「三关色相 × 五组类型微光」互辨抽测（格底与类型微光同在未开格面，邻近色相有吞没风险）；美术设计段已闭合——取样面 54 格（3 关 × 5 组 × 3 底型＋9 基准格）、判据＝目检四条＋机检四条（阈值全取在役值，色相通道不设机检阈值）、产物＝并列样图＋逐对读数表两兼。执行步骤与三件定值全载抽测方案过程稿 reports/提案-三关色相互辨抽测方案-2026-10-29.md；抽测挂点＝[美术圣经](design/art/art-bible.md) v3.22 §6.3 终值取值程序第一条（终值冻结闸＝§1.4 格子样张重跑）。执行前提已核：三关瓦片三套在本机 `game/assets/art/board/` 齐备，可开跑。
-
-**改动面**：文档＋美术素材＋工具代码
-
-**状态**：美术设计已闭合＋待执行
-
 #### 数值标定窗口总挂账——原九条数值类条目合并（2026-10-28 登记，来源=会话提及）
 
 **实况**：九条数值类挂账合并一条（削弱档位终值／迭代 10 奖励重构联动／调参点评登记／三方向解锁清单与定价／GP 经济换算失衡／天赋树欠账余两件／商店刷新两参数／基线通关率越带杠杆扫描／成长系数节奏），逐条明细与统一执行形态（窗口内一次 MC 批量覆盖全冒险期望＋奖励期望）全载 reports/汇总-数值标定窗口挂账-2026-10-28.md。共同裁定：未设计不启动，重启条件＝用户发令开数值标定窗口。MC 档位硬闸见 sim-data/README.md「MC 采集档位表」。
@@ -20,14 +12,15 @@
 
 **状态**：待文档设计
 
-#### 超预算图策略升级路径——等比缩放与滚动视口两案待裁（2026-10-24 登记，来源=批次移交）
+#### 结算明细文案入表——玩家可见明细文案归属改数据表承载（2026-11-06 登记，来源=批次移交）
 
-**实况**：2026-11-05 用户裁滚动视口案落地（等比缩放案否决——像素纪律）：关卡画面卷轴视口，跟随＋拖拽＋滚轮、平滑滚动（减动效瞬切）、当前节点居中锚；「图包络 ≤ 屏预算」约束退役，画布随图生长、规模归参数档。设计闭合凭据：design/gdd/ux/level-map.md v2.0（布局决策 5＋视口效果图内嵌，2026-11-05 人审通过）；design/gdd/systems/冒险循环/关卡节点图生成.md v1.5（参数契约节＋图规模无呈现侧上限句）。需求卡片＝reports/需求卡片-卷轴视口批-2026-11-05.md（grilling 复核裁决全落，验收档中）。
-- 相关文档：关卡节点图参数取值域已归数据 schema 层；schema 头注「域并单点＝调参表」指针反转随实现批顺带（卡片随动项）；需求卡片 reports/需求卡片-卷轴视口批-2026-11-05.md（grilling 复核裁决全落，验收档中）。
+**实况**：迭代 53 反哺点 4 归属裁决在案＝文案入数据表行（2026-11-06 用户裁）；规范句已落 [战斗结算](design/gdd/systems/战斗循环/战斗结算.md) v1.8 明细流水节（显示名等玩家可见文案＝数据面字段，代码读表拼行、禁代码写死文案字串）；现行代码硬编码面＝结算明细扩展行标签文案（如减半标签，reward_grant.gd:226 一族）。
 
-**改动面**：文档
+**缺口**：还差表结构设计讨论——承载表与字段形态、基础行文案是否同批入表、读表拼行接线面。
 
-**状态**：文档设计已闭合＋已写卡＋已编迭代 53
+**改动面**：文档＋游戏代码
+
+**状态**：待文档设计
 
 #### UI 贴图重构批——元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现）
 
@@ -234,34 +227,53 @@
 
 ### 文档与结构
 
-#### damage_controller 按序改写族——内容孤儿机制与退役名注释层（2026-11-04 登记，来源=会话提及）
+#### 效果通道与事件词的零现役普查（2026-11-05 登记，来源=审计发现）
 
-**实况**：damage_controller.gd 按序改写族通用机制（trade_hit/trade_atk 交换、armor_rewrite 免掷、spike 满层必中与倍乘、discount_shift 轻甲改善——注释叙事 ：285-290、改写执行 ：291-325、增伤与倍乘 ：350-353 与 ：368-372）现役内容面仅淬毒刃纹一行 modify_ticket（mode=clamp_bonus，feats.tres:853-857）：其余子分支零表行注册（全仓 grep 证）——「框架先行、内容未接」同族债。五拍注释全以旧 27 专长名叙事（矿工重锤/专注/厚积薄发/猎弱本能，道具退役素材库.md:43-47 退役在案）；charge_layers 四处已归 EffectPort 蓄力层删键批（实现提交 ace15701）。2026-11-05 会话裁决＝孤儿机制与退役名一律清退（口径「只要有问题的都要改」）；同轮核出 spike 的 GDD 承接句站不住（候选条写「零新代码——spike 在册」，实为词面在册、全仓零派发点；长枪条同类——attack_segments 已随架构审查甲案退役），据此订正该节四处陈述。全仓扫＝40 退役名命中 53 行/13 文件（注释面 42、字面量 11），逐处清单见卡片。关联文档：设计定稿=design/gdd/systems/跨局循环/锻造工坊.md v0.13（2026-11-05）；需求卡片=reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md
+**实况**：普查报告 reports/普查-效果通道与事件词零现役-2026-11-06.md——结论＝内容层零孤儿、四词表＋秘宝表 schema 旧词层全部属预留埋点（词面全保留零清退项；架构原则＝词表先行内容后接）。叙述脱节 5 处已按「预留、未设计入表」口径订正（2026-11-06 用户令直改，冒烟 15 项 0 失败三闸全过）。唯一遗留待裁＝秘宝表 schema 旧词面 9 个「迁移完成」收尾（做不做、何时做），待用户裁。
 
 **改动面**：游戏代码
 
-**状态**：文档设计已闭合＋已写卡＋已编迭代 53
+**状态**：待执行
 
-#### 效果通道与事件词的零现役普查（2026-11-05 登记，来源=审计发现）
+#### 测试面真输入化分期与存量断言逐条精锚（2026-11-05 登记，来源=批次移交）
 
-**实况**：证据＝四条 grep 读数：`cell_removal` 通道在册（`game/data/schemas/treasure_item_table.gd:26`；消费点 `game/core/reward_grant.gd:160-161`）而 `game/data/` 全域零数据行；`mine_hit_halve` 同形态（仅 schema 词表与注记在位）；`open_ticket` 的 `channel="reflect"` 行族零表行（21 张 `.tres` 逐张 grep）；`armor_roll` 在 `game/core/effect_engine.gd:13` 事件词表在册、发射点 `game/core/damage_controller.gd:296`，而 `game/data/tables/feats.tres` 零订阅行。形态与架构审查甲案已清的 overflow/attack_segments 死通道同族（判据出处＝`design/engineering/code-conventions.md:15`、`design/engineering/test-conventions.md:116`）。本批（需求卡片-改写族孤儿机制与退役名清退批）只清其文案与归因串，通道与事件词本体去留待普查批整体裁。
+**实况**：证据＝test-conventions §8.3「判据出处行锚」「真实入口判定口径」两条文＋§2「UI 驱动断言须走真输入管线」条文（批1补，qa-harness 分支 2cbd2ca9）；链式锚机检已在闸（capability_audit 链断 0，80 套件全承接）。已承接＝两探针 52 处 emit 站点（51 转真输入管线＋1 置灰穿透标〔接线断言〕）。剩余面＝①视图层测试方法面（press_candidate／press_continue／press_card／press_confirm／press_refresh_for_probe 等探针消费口，非 emit 站点）②存量 996 条断言的判据出处逐条精锚（链式锚已保可核，精锚提升出处粒度）。
+
+**改动面**：游戏代码
+
+**状态**：待执行
+
+#### QA harness 三批缺陷与覆盖遗漏收口（2026-11-06 登记，来源=批次移交，优先级=P0）
+
+**实况**：证据＝reports/QA-harness三批-缺陷与覆盖遗漏报告-2026-11-06.md（八类逐条带文件行号与登记处指针：产品缺陷 2＝A1 开局被开始层盖住/A2 终局关闭路径引擎报错噪声；测试覆盖遗漏 6＝B1 停手钮零真输入/B2 视图方法面/B3 精锚/B4 本体缺口 212 条/B5 控件零命中缺口/B6 判据收紧轮）；来源批次＝合并 d3c85390（三批读数在案）。处置分流：A1 随营地交互修复批合回即消；A2/B1/B2 走需求性工程写卡通道；B3/B6 归衔接条目与复核轮；B4/B5 人工复核后分流（真缺口立事项/假缺口豁免清单核销）。
 
 **改动面**：游戏代码
 
 **状态**：待写卡
 
-#### 测试面真输入化分期与存量断言逐条精锚（2026-11-05 登记，来源=批次移交）
+#### 闸机超时守卫缺陷修复——gate_run_timeout 标志文件恒真（2026-11-06 登记，来源=批次移交）
 
-**实况**：证据＝test-conventions §8.3「判据出处行锚」「真实入口判定口径」两条文（本批落）；链式锚机检已在闸（capability_audit 链断 0，80 套件全承接）。剩余面＝①营地七物件段等 ~40 处 emit 站点仍为接线验证（大门/进档链已于本批真输入化，能力行 :158 残险在案）②存量 996 条断言的判据出处逐条精锚（链式锚已保可核，精锚提升出处粒度）。
+**实况**：tools/gate_platform.sh 的 gate_run_timeout 用 mktemp 预建超时标志文件，判据 `[ -f ]` 建时即真、超时态无法与正常完成区分（Windows Git Bash 实测直接调用 4 秒返回 124；远端各闸以工件锚定未受影响）。连带 tools/golden_baseline_refresh.sh 的 guard 子Shell sleep 420 未被 kill 短路（重采集等待 7 分钟症状）。修法＝kf 先赋路径＋rm -f 后置守卫（probe_gate.sh:97 run_suite 同款正确写法）。证据＝tools/gate_platform.sh:37/:48＋迭代53实现报告遗留呈报 1（git 历史可考）。
+
+**改动面**：工具代码
+
+**状态**：待执行
+
+#### 关卡视口两 Shot 基线 mac 侧冻结（2026-11-06 登记，来源=批次移交）
+
+**实况**：golden/windows/ 已锚 lmap_entry/lmap_boss（提交 6394abf7）；mac 子目录无该两 Shot——渲染闸对 mac 缺基线记 SKIP 不判红，两平台同盯缺一。义务＝Mac 侧跑 tools/golden_baseline_refresh.sh --lmap 冻结 mac 基线并呈报确定性读数。证据＝game/tests/golden/README.md 现持清单行与时效判定纪律行＋迭代53实现报告遗留 2（git 历史可考）。
 
 **改动面**：游戏代码
 
 **状态**：待执行
 
-#### QA 覆盖总览面板与自动试玩扩展——自动发现测试验证缺漏（2026-11-05 登记，来源=会话提及）
+#### 美术圣经去数值化——定值改由机检件与数据表承载（2026-11-06 登记，来源=会话提及）
 
-**实况**：方案全文＝`D:\code\qa-harness-discussion\QA-Harness讨论结果-中间报告.md`（三批定案，全部三关试点）：①探针存量 emit 真输入化（~40 处站点，承接上条）②B 覆盖总览面板＋本体枚举器（六源回执明细化＋能力清单提取＋HTML 双击即开＋游戏内容↔测试验证对账）③C 自动试玩扩展（auto_player 扩全动线全功能，异常上报含机器自填归因）。裁决在案勿重提：A 执行覆盖矩阵不做、D 缺口闸不做、变异测试禁入、归因登记不立独立制度。
+**实况**：本条立文档分层规矩——美术圣经与 GDD 同级属 Meta 层，只写概念与方向（可写「两者存在相对亮度关系」），不写具体数值约束；阈值与准入判定归执行件，执行件登记面＝[art-pipeline-tools](design/art/art-pipeline-tools.md)（三关色板互辨抽测件本批已入册）。
+- 相关文档：纪律出处＝[doc-conventions §5 禁实现内容行](design/engineering/doc-conventions.md)；同款先例＝[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md) 二节「面值一律不在此抄录，以数据表为准」
 
-**改动面**：游戏代码＋工具代码＋文档
+**缺口**：还差一次清点与归属设计讨论——圣经全部定值逐条定落点（机检件／代码常量／数据表／golden 基线）、定文档侧指针句式、核下游反向引用面（ux 文档、需求卡片、探针注引圣经定值之处）。
 
-**状态**：待执行
+**改动面**：文档＋工具代码
+
+**状态**：待文档设计