任务书 v1.2：全改保一致（C1/C2 裁决关闭，待裁点归零）

用户 2026-10-05 裁决：「只要是我们相关的概念对象/变量，全部统一修改，保证一致性」。两条待裁点据此关闭。 **改名总原则（§4.0 新增）**：凡属本作「秘宝」概念对象的标识符——文件、类、变量、方法、枚举值、字符串字面量、注册表键——全部换词。判据一句话：该标识符是否指向「秘宝」这个概念？三类例外穷举：①敌方语汇（magic 格面族 / magic_bolt / ward 魔法护甲 / arch_names）②玩家可见既有柜台名「道具工坊」 ③跨局存档历史键。 **C1 裁决落地（§4.3，实测连锁面比预估小得多）**：`"aux_item"` 域串照改。 - `reward.tres` 已零 aux_item 数据行（池种随迭代 11 T7 退役）→ 原估的「改数据文件」连锁项**消失** - 全仓 16 处字面量全在代码内闭合，**无跨局存档依赖** → 可彻底改 - 唯一保留连锁项 = `smoke_all.gd:3932-3933` 断言须同步 - 新增**组 F**（分派语汇与域串 16 处：adventure_runner 8 处 / reward_table 枚举与常量 / battle_narrator / bonus_interact_controller / smoke_all 三处 / reward_dangling_aux_test 夹具） **C2 裁决落地（§4.2）**：`aux_items` 一名两义**拆分**—— - ✅ 改：ConfigDB 持有变量 `var aux_items` + 表注册键 `"aux_items"` （纯进程内，加载期取，不落盘） - 🔴 禁改：断点存档键 `adventure_runner.gd:976/844` + 冒烟夹具 `smoke_all.gd:4473/4495`（夹具构造的就是存档键，改则与真存档脱节） - **关键认知：「键名禁改」与「变量名禁改」是两回事**——禁改的只是落盘的键名字面量，进程内变量名照改不误。这就把一处危险同名拆成「两可改 + 两禁改」的清晰边界。 - ⚠️ 与 registry 条目键 `aux_items`（`design/registry/entities.yaml`）区分：registry 条目键禁改（数据契约），ConfigDB 表注册键可改 **§4.1 存档键禁改清单成表**：六个键 12 处引用逐条列出写入点与性质，要求代码旁加显式禁改注释；T7 卡增设 diff 专项核（逐字节比对，防破档）。 **任务卡 T0-T9 → T0-T10**（新增 T3 组 F），估时 5.0→5.5 日（超软盒 3 日已知情预挂，T8 后 L3 呈报切点）。§7 标题改为「冲突面裁决记录（C1/C2/C3 已全部关闭）」，roadmap 迭代15③ 门改为「裁点已全决·可开工」。现状补充：② 奇物批已收口落库（c571af2），C3 撞批消解，本批为迭代 15 唯一在途需求。T0 须重取基线（判式换代 T5 读数 750/0；§1.2 的 747 为②前旧数禁沿用）。
2026-10-05 07:43:57 +08:00
1 parent cde68006b2
commit 3c4291dbd9
@@ -9,8 +9,6 @@
 > 🔴 **撞批警示（与同迭代 ② 奇物批）**：本批与 `任务书-奇物词族对齐与渠道分离批-2026-10-05.md` 撞同一批文件（`core/level_runner.gd` · `data/tables/adventure.tres` · `core/adventure_runner.gd` 断点区），且**双方都动断点存档键**（本批禁改、②批内有"存档键正式迁移"待裁点）。
 > **2026-10-05 07:29 复核：② 奇物批已收口落库**（合并提交 `c571af2`，"merge: 奇物概念收口与词族对齐（迭代15②号卡·文档与数据层）"）——**并行撞批风险已解除，本批可独立开工**。但 ② 已改动 `adventure_runner.gd`(46 行) / `config_db.gd` / `level_runner.gd`(10 行) / `adventure_table.gd`(113 行) / `adventure.tres`(42 行) / `relic_table.gd` / `shop_table.gd`，**本批事实表须按 T0 重新复核**（已做首轮复核，见 §2 F1/F3 修订）。
 ---
 ## 1. 目标与完成定义
@@ -23,7 +21,7 @@
 | # | 判定项 | 量化标准 |
 |---|---|---|
-| 1 | 词族换尽 | `game/` 下 `aux_*`/`AuxItem*`/`AUX_ITEM*` 出现处**仅剩 §4 白名单**（存档键 + 🔴 冲突面 + 历史留痕注释），其余全数换词 |
+| 1 | 词族换尽 | `game/` 下 `aux_*`/`AuxItem*`/`AUX_ITEM*`/`"aux_item"` 出现处**仅剩 §4.0 三类例外**（敌方语汇 / 道具工坊 / §4.1 十二处存档键 + 冒烟夹具），其余全数换词。**裁决后无待定欠债——全改** |
 | 2 | 玩家可见清零 | `grep -rn "魔法道具" game/` **零命中**（2026-10-05 收口后复核现基线 = **5 处玩家可见字符串**，见 §3 组 A；其余 60+ 命中均为注释，由组 D 清） |
 | 3 | 重闸全绿 | 冒烟 **747/0**（现基线，迭代 15 前实测值）· 十一探针全绿 · MC 逐位对拍**零漂移** · doc 三闸**对基线零新增** · 熵增闸 PASS |
 | 4 | 人闸完成 | 目检清单过 + 代拍板追认清单过 + §8 白名单外无代拍板 |
@@ -46,7 +44,7 @@
 | F9 | 中文注释层现状 | 大量注释仍写"魔法道具"（如 `aux_items.gd:2` `aux_items_test.gd:2` `bonus_interact_controller.gd:92` `config_db.gd:27`）——**注释属本批清理对象**（与 §1.2 判定 2 同批） |
 | F10 | 文档侧已完成 | 2026-10-05 消歧更名批（`430419c` + `06e94b7`）：26 个设计文档已改「秘宝」，`秘宝.md` 已重命名，registry 30 处已同步，owner 路径已指向新文件。**本批只做代码侧，文档侧除 §3 链接修复外不动** |
-## 3. 改动清单（分五组，逐组独立可提交）
+## 3. 改动清单（分六组，逐组独立可提交）
 ### 组 A · 玩家可见文案（**P0，最高优先**）
@@ -107,14 +105,97 @@
 | 内部变量 | `_last_aux_cleared` · `_bonus_aux_carry` · `_last_draw_aux` · `aux_inventory` · `aux_items`(局部) | ✅ 换词（**非存档键的**局部变量；存档键见 §4） |
 | 🔴 冒烟断言 | `smoke_all.gd:3932-3933` `CELL_TYPES.size() == 10 and has("aux_item")` | **见 §7 C1 裁决**——本批不动断言值即需同步改 .tres 与 enum，两条路由 C1 定 |
 ### 组 F · 分派语汇与域串（**C1 裁决后新增，全改**）
 `"aux_item"` 字面量 **16 处**，全部代码内闭合、**无存档依赖**，一律换词（建议 `treasure_item`；若与局内「奇物」`curio_*` 词族冲突，改 `treasure_*` 全族统一前缀）：
 | 文件 | 行 | 处置 |
 |---|---|---|
 | `core/adventure_runner.gd` | 231 / 366 / 490 / 510 / 556 / 583 / 601 / 672 | ✅ 8 处分派与兑付字面量全改（同源，须一次改齐） |
 | `data/schemas/reward_table.gd` | 15 `CELL_TYPES` / 16 `AUX_ITEM_TYPE` / 50 校验分支 | ✅ 改（枚举项 + 常量名 + 分支引用三者同改） |
 | `presentation/battle_narrator.gd` | 115 | ✅ 改（叙述分派键） |
 | `presentation/bonus_interact_controller.gd` | 127 | ✅ 改（呈现分派键） |
 | `smoke/smoke_all.gd` | 562 / 3847 / **3932-3933** | ✅ 改（**断言 `has("aux_item")` 与 `size()==10` 必须同步，否则冒烟红**） |
 | `tests/unit/data_config/reward_dangling_aux_test.gd` | 25 | ✅ 改（夹具注入串 `"cell_type": "aux_item"`） |
 > ⚠️ **`reward.tres` 无需改**（已核：零 `aux_item` 数据行，池种随迭代 11 T7 退役）。
 > ⚠️ **枚举项改名后 `CELL_TYPES.size() == 10` 仍为 10**（改的是字面量不是项数），但 `has()` 的参数须同步——这是本组唯一的机械陷阱。
 > 🔴 **`smoke_all.gd:4473/4495` 的 `"aux_items"` 夹具键禁改**（见 §4.2）——它们构造的是断点存档快照，改了夹具就与真存档脱节。
 ## 4. 范围边界（🔴 不可越界）
 ### 4.0 ✅ 改名总原则（用户 2026-10-05 拍板：**全改，保证一致性**）
 > **凡属本作"秘宝"概念对象的标识符——无论是文件、类、变量、方法、枚举值、字符串字面量，还是注册表键——全部统一换词。**
 > 判据一句话：**该标识符是否指向"秘宝"这个概念？** 是 → 改；不是（敌方语汇 / 通用词 / 存档历史键）→ 不改。
 **三类例外（唯一不改项，穷举）**：
 | 例外 | 具体 | 理由 |
 |---|---|---|
 | ① **敌方语汇** | `magic` 格面族 · `magic_bolt` / `magic_recoil` · `ward 魔法护甲` · `arch_names["magic"]` | 属敌方伤害/护甲语汇，与秘宝无概念关联 |
 | ② **玩家可见既有柜台名** | 「道具工坊」 | 营地三柜台之一，玩家已习惯，本批不动（与秘宝是父子关系，非同义） |
 | ③ **跨局存档历史键** | 见 §4.2 白名单 | 改则破档 |
 ### 4.1 禁改：跨局存档键（用户 2026-10-05 明令，破档即玩家进度丢失）
 **判据**：凡**写入断点存档 / 跨局持久化**的键名，一律不改。
 | 键名 | 写入点 | 性质 |
 |---|---|---|
 | `bonus_aux_carry` | `adventure_runner.gd:982` | 断点：道具件跨关携带 |
 | `aux_items` | `adventure_runner.gd:976` 写 / `:844` 读 | 断点：持有集快照 |
 | `aux_detail` | `adventure_runner.gd:880/890/538/635/654/665/227/228/685` 读写 | 断点：三选一掷定详情 |
 | `aux_cleared` | `adventure_runner.gd:887` 写 / `:864` 读 / `level_runner.gd:523` 写 / `bonus_interact_controller.gd:75` 读 | 断点：关末清空计数 |
 | `aux_cleared_last` | `adventure_runner.gd:908` 写 | 断点：末关清空反馈 |
 | `attunement_charges` | `adventure_runner.gd:970` 写 / `:251` 读 | 断点：同调主动件充能余量 |
 > **上述键在代码旁必须加显式禁改注释**：`// 🔴 存档键（历史名 aux_*，与中文名「秘宝」对应），禁改——改则破档`
 > **配套动作**：对应的**内部变量**（`_bonus_aux_carry` / `_last_draw_aux` / `aux_inventory` / `_last_aux_cleared`）**照改不误**——变量名不落盘，禁改的只是键名字面量。这正是解 C2 一名两义的关键。
 ### 4.2 `aux_items` 三处同名用法（**C2 裁决落地**）
 同一个字面 `aux_items` 在三处语义不同，**处置各异**：
 | 位置 | 实际语义 | 处置 |
 |---|---|---|
 | `config_db.gd:27` `var aux_items` = `AuxItemTable` | **注册表键 + 持有变量** | ✅ **改**（`treasure_items` / `TreasureItemTable`）——纯进程内，加载期从 `loaded.get()` 取，不落盘 |
 | `config_db.gd:27` `"aux_items": "aux_items.tres"` | **表注册项** | ✅ **改**（ConfigDB 内部映射，两端同改即闭合） |
 | `adventure_runner.gd:976/844` `"aux_items"` | **断点存档键** | 🔴 **禁改** + 加注释标记 |
 | `smoke_all.gd:4473/4495` `"aux_items": [...]` | **冒烟夹具（构造断点快照）** | 🔴 **禁改**——它构造的就是存档键，改了则夹具与真存档脱节、测试失去意义 |
 ### 4.3 ✅ C1 裁决落地：`"aux_item"` 域串**照改**（连锁面已实测收窄）
 **用户 2026-10-05 拍板全改。实测复核后连锁面比预估小得多**：
 | 原判断 | 实测 | 结论 |
 |---|---|---|
 | 要改 `reward.tres` 数据行 | **`reward.tres` 已零 `aux_item` 数据行**（aux_item 池种随迭代 11 第①批 T7 退役） | ✅ **无需改数据文件** |
 | 要改冒烟断言 | `smoke_all.gd:3932-3933` 断言 `size()==10 and has("aux_item")` | ⚠️ 断言**必须同步改**（枚举与断言同源） |
 | schema 契约 | `reward_table.gd:15/16/50` | ✅ 改（枚举 + 常量 + 校验分支） |
 **全仓 `"aux_item"` 字面量 16 处（全部代码内闭合，**无跨局存档依赖**）**：
 | 文件:行 | 用途 |
 |---|---|
 | `adventure_runner.gd:231/366/490/510/556/583/601/672` | 分派与兑付（8 处，同一分派语汇） |
 | `reward_table.gd:15` `CELL_TYPES` · `:16` `AUX_ITEM_TYPE` | 枚举与常量 |
 | `battle_narrator.gd:115` | 叙述分派键 |
 | `bonus_interact_controller.gd:127` | 呈现分派键 |
 | `smoke_all.gd:562/3847/3932` | 冒烟断言与夹具判断 |
 | `reward_dangling_aux_test.gd:25` | 夹具注入串 |
 > ✅ **这 16 处无一是存档键**（对比 §4.1 的 12 处）——**可彻底改，无兼容风险**。
 > ⚠️ 改后 `smoke_all.gd:3932` 断言须同步为新字面量，否则冒烟红。
 ### 4.4 其他禁改项
 ### 本批**不做**（硬边界，违反即 L3 停机）
 | 禁项 | 理由 |
 |---|---|
 | **断点存档键一律保留** | 用户 2026-10-05 明令。`bonus_aux_carry` / `aux_detail` / `aux_cleared` / `aux_cleared_last` / `aux_items`（断点数组）/ `attunement_charges` **一字不改**——破档即玩家进度丢失 |
-| **registry 条目键 `aux_items` 不改** | 属数据契约键（`design/registry/entities.yaml`），与 06 更名批的"条目键沿用"口径一致 |
+| **registry 条目键 `aux_items` 不改** | 属数据契约键（`design/registry/entities.yaml`），与 06 更名批的"条目键沿用"口径一致。⚠️ 注意与 §4.2 的 ConfigDB 表注册键区分：**registry 条目键禁改，ConfigDB 表注册键可改** |
 | **数值零触碰** | 本批纯改名。`magnitude` / `charge_n` / `w` / `t` / 权重档位**一律不动** |
 | **行为零变更** | 不得借改名之机重构逻辑、调参数、改流程 |
 | **`magic` 格面族与 `ward` 护甲** | 敌方语汇，与本批无关（组 D 已锁） |
@@ -152,39 +233,49 @@
 | **T0** | 开工：worktree + 基线复读（冒烟实际值/十一探针/MC 基准/三闸）+ `git status` 归属核对 + 记录 `.uid` 清单 + **回填 §1.2 基线数字** | 0.5d | 全量冒烟基线 | 基线数字回填进本文档 §1.2 且全绿 |
 | **T1** | **组 A + D**（玩家可见文案 + 中文注释层） | 0.5d | 冒烟 + `grep "魔法道具" game/` 零命中 | 组 D 分色表零误改（`魔法矢`/`魔法护甲` 未被误改） |
 | **T2** | **组 C**（链接修复，含 architecture.md 既有断债清偿） | 0.25d | doc 三闸 | `doc_link` 对基线**零新增** |
-| **T3** | **组 B-1**（schema 文件名 + 类名 + `.uid` 同步 + `--import` 重刷） | 0.75d | 冒烟 + `--import` 后类名解析 | `TreasureItemTable` 加载零报错 |
+| **T3** | **组 F**（`"aux_item"` 分派语汇与域串 16 处，含冒烟断言同步） | 0.5d | 冒烟 + MC 对拍 | `smoke_all.gd:3932` 断言同步后绿；`reward.tres` 零改动 |
-| **T4** | **组 B-2**（ConfigDB 持有变量 + 访问器 + 全部调用方跟改） | 0.75d | 冒烟 + MC 对拍 | 冒烟数值断言全绿（访问器链路完整） |
+| **T4** | **组 B-1**（schema 文件名 + 类名 + `.uid` 同步 + `--import` 重刷） | 0.75d | 冒烟 + `--import` 后类名解析 | `TreasureItemTable` 加载零报错 |
-| **T5** | **组 E-1**（测试文件名 + preload + run_all 登记） | 0.5d | 冒烟（十五套件全跑） | `run_all` 无 fixture 缺失 |
+| **T5** | **组 B-2**（ConfigDB 持有变量 + 表注册键 + 访问器 + 全部调用方跟改） | 0.75d | 冒烟 + MC 对拍 | 冒烟数值断言全绿；**§4.2 四处同名用法按表分置** |
-| **T6** | **组 E-2**（内部变量换词） | 0.5d | 冒烟 + MC 对拍 | MC 逐位零漂移 |
+| **T6** | **组 E-1**（测试文件名 + preload + run_all 登记） | 0.5d | 冒烟（十五套件全跑） | `run_all` 无 fixture 缺失 |
-| **T7** | **重闸**：全量轻闸 + doc 三闸 + 熵增闸 + MC 逐位对拍 | 0.5d | 重闸全绿 | §1.2 判定 3 五项全绿 |
+| **T7** | **组 E-2**（内部变量换词，**存档键字面量除外**） | 0.5d | 冒烟 + MC 对拍 | MC 逐位零漂移；§4.1 十二处存档键**逐字未变**（diff 专项核） |
-| **T8** | **人闸**：目检清单 + 代拍板追认 + §7 冲突面裁决回报 | 0.5d | 目检过 | §1.2 判定 4 |
+| **T8** | **重闸**：全量轻闸 + doc 三闸 + 熵增闸 + MC 逐位对拍 | 0.5d | 重闸全绿 | §1.2 判定 3 五项全绿 |
-| **T9** | **收口五步** | 0.25d | — | §1.2 判定 5 |
+| **T9** | **人闸**：目检清单（含 C 区槽位标题与 tooltip 实机确认）+ 代拍板追认 | 0.5d | 目检过 | §1.2 判定 4 |
 | **T10** | **收口五步** | 0.25d | — | §1.2 判定 5 |
-> 估时合计 ≈ **5.0 日**，**超 roadmap 软盒 3 日上限**。知情预挂：T7 后按 L3 呈报切点，不擅切（沿迭代 9 先例：估 4.5–6 日 vs 软盒 3 日，切点=段末闸后呈报）。或执行中触发 G1/G2 降级可压至 3 日内。
+> 估时合计 ≈ **5.5 日**，**超 roadmap 软盒 3 日上限**。知情预挂：T8 后按 L3 呈报切点，不擅切（沿迭代 9 先例）。或执行中触发 G1/G2 降级可压至 3 日内。
 >
 > **T7 的存档键零变更核验方法**：`git diff` 后逐条比对 §4.1 表中 12 处键名字面量，须**逐字节一致**——这是本批最容易破档的一卡，须专项核。
-## 7. 待裁决冲突面（🔴 **T0 必须回报用户，不得自行决断**）
+## 7. 冲突面裁决记录（C1/C2/C3 **已全部关闭**）
-### C1 · `"aux_item"` 格面域串改不改？
+### C1 · `"aux_item"` 格面域串改不改？　✅ **已裁决：全改（用户 2026-10-05）**
-**事实冲突**：用户拍板"全族彻底改（含数据表）"，但该串是**加载期校验的域名字符串**，改动 = 三重连锁：改 `reward_table.gd:15` enum → 改 `reward.tres` 数据行 `cell_type` → 改 `smoke_all.gd:3932` 断言（`size()==10 and has("aux_item")`）。
+**原事实**：`"aux_item"` 是加载期校验域串，改动 = 三重连锁（enum + .tres 数据行 + 冒烟断言）。
-| 方案 | 做法 | 风险 |
+**裁决后实测收窄（关键）**：
 | 原判断 | 实测结果 |
 |---|---|
 | 需改 `reward.tres` 数据行 | **`reward.tres` 已零 `aux_item` 数据行**（池种随迭代 11 T7 退役）→ **该连锁项消失** |
 | 需改冒烟断言 | `smoke_all.gd:3932-3933` 断言必须同步改（**唯一保留的连锁项**） |
 | schema 契约 | `reward_table.gd:15/16/50` 照改 |
 **结论**：全仓 `"aux_item"` 字面量 **16 处，全部代码内闭合，无跨局存档依赖** → **可彻底改，无兼容风险**。落地细则见 §4.3。
 ### C2 · `aux_items` 一名两义拆不拆？　✅ **已裁决：拆（用户 2026-10-05）**
 **裁决**：内部持有变量与注册表键 ✅ 全改；断点存档键 🔴 保留 + 加禁改注释；冒烟夹具 🔴 保留（它构造的就是存档键）。
 **解法核心**：**"键名禁改"与"变量名禁改"是两回事**——禁改的只是落盘的键名字面量，进程内的变量名/注册表键照改不误。这就把一处危险同名拆成了「两个可改 + 两个不可改」的清晰边界。
 | 位置 | 语义 | 处置 |
 |---|---|---|
-| **甲** | 全改（enum + .tres + 断言） | 🔴 **动 schema 契约 + 数据文件**；`reward.tres` 存量数据行须逐行改；`doc_term` 闸可能判新增术语债 |
+| `config_db.gd:27` `var aux_items` / `:50` 持有变量 | 进程内持有 | ✅ 改 `treasure_items` |
-| **乙** | 保留 `"aux_item"` 域串为**已知欠债**，加注释说明它 = 秘宝 | 零风险；"全族彻底改"打折（但可解释为"域串非用户可见语义"） |
+| `config_db.gd:27` `"aux_items": "aux_items.tres"` | 表注册项 | ✅ 改（两端同改闭合） |
 | `adventure_runner.gd:976/844` `"aux_items"` | 断点存档键 | 🔴 禁改 + 注释 |
 | `smoke_all.gd:4473/4495` `"aux_items"` | 冒烟夹具 | 🔴 禁改（改则夹具与真存档脱节） |
-> **我方倾向：乙**——该串是数据契约键而非玩家可见语汇，与 registry 条目键同性质（同"沿用不改"口径）；且 `reward.tres` 是 MC 对拍的输入，动它会污染 R2 判定。**须用户拍板**。
+落地细则见 §4.2。
 ### C2 · `aux_items` 一名两义拆不拆？
 **事实**（F6）：`config_db.gd:50` 的持有变量 `var aux_items: AuxItemTable`（可改）与断点存档键 `"aux_items"`（禁改）**字符串相同**。`adventure_runner.gd:951-976` 的断点数组读写用的正是这个键。
 | 方案 | 做法 | 风险 |
 |---|---|---|
 | **甲** | 变量改 `treasure_items`、存档键留 `aux_items`（靠字面不同区分） | 🟡 **易误改**：同文件内 `bp.get("aux_items")` 与 `treasure_items` 混排，肉眼难辨 |
 | **乙** | 变量保持 `aux_items` 不改、只改类名与文件名 | 与"全族彻底改"打折，但零误改风险 |
 > **我方倾向：甲 + 强制注释标记**——变量改词，存档键在代码旁加显式注释 `// 🔴 存档键，历史名，禁改（2026-10-05 用户拍板）`。**须用户拍板**。
 ### C3 · 与同迭代 ② 奇物批的串行次序（✅ **2026-10-05 已消解**）
@@ -197,7 +288,6 @@
 2. **T0 须复核 §2 全部事实表**——② 改动面覆盖 `adventure_runner.gd` / `config_db.gd` / `level_runner.gd` / `adventure_table.gd` / `adventure.tres` / `relic_table.gd` / `shop_table.gd`，其中 `adventure_runner.gd` 是本批 F2 第一重灾文件（79 处）。
 3. **② 的"存档键正式迁移"待裁点状态须查清**——若 ② 已迁移了 `bonus_aux_carry` / `aux_items` 等键名，本批 §4 的禁改清单须同步更新（**这是本批唯一仍需向用户确认的残留项**）。
 ## 8. 代拍板白名单
 **白名单内**（执行会话可直接决断，commit 记录）：
@@ -206,11 +296,13 @@
 - 改名顺序与提交粒度（§3 五组可再细分）
 **白名单外**（须回报用户）：
 - §7 C1 / C2 两条冲突面的任何决断
 - 任何 🔴 R1–R5 契约的取舍
 - 降级级别选择（G1/G2/G3）
 - `.tres` 数据行 `cell_type` 值改与不改（C1 派生）
 - 冒烟基线数字与本文档不符时的取用
 - **§4.1 存档键白名单的任何增补**（增补即意味着扩大破档面）
 - **§4.0 三类例外的边界质疑**（例如某个 `magic_` 标识符到底属敌方语汇还是秘宝概念）
 > ✅ **C1 / C2 已于 2026-10-05 裁决关闭**（全改保一致），不再是待裁点。
 ## 9. loop engineering 八件对照（合规自证）
@@ -254,4 +346,3 @@
 > **注 1**：`entities.yaml` 无法被标准 YAML 解析器读取（项目把 `**粗体**` 当键名用，改动前即如此）——校验结构须用正则提取键集合比对，**勿用 `yaml.safe_load`**。
 >
 > **注 2**：局内「奇物」概念文档 = [奇物.md](../gdd/systems/冒险循环/奇物.md) v2.7（7 轮裁定定稿，2026-10-05 落文），任务书 = `任务书-奇物词族对齐与渠道分离批-2026-10-05.md`。**本批与它分属两套词族**（`aux_*` = 局外秘宝 / `feature_*`·`relic_*`·`bonus_*` = 局内奇物），但撞同一批文件——见 §7 C3。
@@ -62,7 +62,7 @@
 | 迭代 14 | **初始展开收窄批（2026-10-04 用户拍板甲乙混合立项）**：甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环（参数化半径，现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成）+乙=生成重掷闸 R₀≤cap（合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口）；**玩法侧零改动路线**（排雷玩法「初始展开恰等」验收原样为真，minesweeper_rules.gd 零 diff）；裸数字截断路否决退役（可见 0 格+未开邻居=扫雷不可能态）。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`，任务书=`design/research/任务书-初始展开收窄批-2026-10-04.md`（T0-T8≈5.25d，读数批 T5-T6 可切独立后批；拍板点 P1-P3 全读数后置；停机点 S1 相变警戒/S2 带越界回调）。**②挖掘风险不等式判式换代批（2026-10-04 用户裁编入本迭代，作为迭代内需求）**：判式三层换代（条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价）+β 比值带判读 [1.2,2.5]（u=3 登记态）+标中兑付溢价 δ=1.25（形态 a 兑付公式一处·雷安同池冻结不动）+runsum 旗行为五字段+audit 工具常量刷新（池 77/直伤 6-8-8/AP 8）；裁决全落零新拍板点（方案报告=`design/research/方案-挖掘风险不等式修订-2026-10-04.md` §九），任务书=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`（T0-T5≈2.5d；条件二 T3 落文按登记已知破·T4 机制转绿；契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案；开工门=U0）。**✅ 实施批落地（2026-10-05，worktree m4iter14-mineq-20261005 台账 354）**：T0-T5 全落——audit 工具常量刷新（改前静态锚与方案报告 §四 逐位吻合）+runsum 五字段（行侧判据考证=授予行专带 highlight，87行==87插旗1:1）+F1 条款3 重立三层口径（v0.8）+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条（改前锚+P7 修正注记）+06 破线条收口+**T4 标中兑付溢价机制**（settlement.flag_hit_premium=125 provisional，grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现，标空/挖格不乘，DamageController 零改/同池冻结）+smoke 750/0（+3 断言；max 路径种子 42→43 重采）；判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感（η 位移 <1.4pp<5pp，保留+登记）/条件二判式口径等号压线转绿（整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面）；改后锚换代 runsum_m4iter14mineq_post_n200_20261005（perfect 冒险通关 65.3%→72.0% 增强向位移，四带判读归 M-4）；出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md（provisional 追认单 8 项+07⑫ 人工项）；damage_probe A1 红灯=改前既有非本批新增（在册）。**③全局作用域变异首发批（2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落，批内序位待排）**：L2/L3 Boss 图恒定一型 scope=global 变异，首发型=**案A 资源面·微贫向偏斜**（正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动；v1.0「沃土+雷密对冲」形勘误作废——雷数为生成器事实、布置段不可加，改生成端=踩结构面否决理由）；**替换制**（Boss 图不再布 region 片——L2 完美 Boss 承伤 55.8% 已越带不叠加；迭代 12 四件地形应对件在 Boss 图失效=知情代价，registry/调参日志随批登记）；L1 Boss 免疫（带B [50,85] 教学保护）；三层预告（开战横幅+HUD 常驻角标+帮助手册行）；带A 判读后置 M-4（落地 off/on 对拍只测不判；off 基线=替换制后零变异 Boss 图，与现行带 region 片 Boss 图语义不同须注明）；偏运硬币合成序=图级先件级后（代拍随批锚登记）。调研报告（事实源，v1.1 裁决落盘）=`design/research/调研-全局作用域变异设计空间-2026-10-04.md`，任务书=`design/research/任务书-全局作用域变异首发批-2026-10-04.md`（T0-T8≈5.75d，读数批 T7 可切独立后批→主体≈5.25d；零新拍板点·provisional 追认单随批；停机点 S1 普通图逐位漂移/S2 读数越带只呈报/S3 互锁误伤；开工门=U0；**⑥A4 批开工门含本批出口——本批落地图级偏斜投影点为⑥合成链中段**〔2026-10-05 注：⑥已移出迭代 14 挂起，此依赖句冻结待其重启〕）。与①②互不撞（收窄=普通图初始展开轴/判式=不等式判读口径/全局变异=Boss 图资源面轴），出口读数各自分开归因。**✅ 实施批落地（2026-10-04，worktree m4iter14-gvar-20261004 台账 345）**：T1-T8Line truncated
 | 迭代 15 | **①调试功能整合批（2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡，落地事实与验证读数零变化，只改编号归属）**：主菜单三调试散件（随机种子输入框/角色数值调整板/两层调试入口）收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标（与主按钮组非平级，DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径）；浮窗=悬浮菜单之上 Dialog（不隐藏开始层，同确认弹窗形态；旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid）；可扩展滚动列表页四区块（随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探）。四拍板全落（2026-10-04 用户裁）=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达（_show_debug_overlay 门禁护栏+对局发起随开随收）/P4 可扩展列表。**✅ 已全批落籍（2026-10-05，worktree iter145-debug-hub 两提交 48c0b34/46dadbb，主区 merge --no-ff d0a3c6b/10c301b，台账 352）**：闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿（worktree+主区双跑，主区跑前 --import 重刷类名缓存在册坑）；遗留=实机目检归用户（DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口） | 卡①门：迭代 14 出口（注：本卡先于迭代 14 出口落籍——编入时点迭代 14 ③已闭/①②④⑤在飞/⑥挂起，门列仅记编入时点状态，不构成追溯闸） | 单批已落地（原估 0.5d，实际一次会话）；后续扩调试项=debug_overlay.gd _build() 列表区追加区块（P4 扩展口径） |
 | 迭代 15 | **②奇物概念收口与词族对齐批（2026-10-05 用户令编入本迭代）**：概念层已由用户逐轮裁定定稿（《奇物》v1.0→v2.7，7 轮），本批只做**落地对齐**、不做二次设计。三批内容：**①三套旧词族全面对齐**（顶层已改名「奇物」而代码仍叫旧名＝用户最初抱怨的"文档与代码分开"）：`feature_*`→`curio_*`（103 处/7 文件）、`relic_*`→`feat_*`（162 处/12 文件）、运行层 `bonus_*`→`curio_*`（160 处/8 文件）。**硬约束：`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用，统一词族不得使用**；`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`（非文本层无法自证）。**②三条渠道按分类分离**（现行三渠道共用同一个 98 张池、三类混编）：关底 Boss 击败＝通过这一关→只出专长；奖励节点/商店→属性值提升+资源、专长在此**只以门票形式**出现。**兑付频率红线**：奇物不是打一场战斗给一份，关内普通战斗节点打完不给任何奇物，一关之内只兑付一次（用户 2026-10-05 纠错）。**③两个新种类入池**＝刷新次数（须先与"商店独立刷新机制"划清边界）+ 专长获取门票（拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底：连续 5 次三选一展示未出→第 6 次必出，刷新重展计入、奖励节点与商店共享计数）；附带 `shop.tres` 补回复（默认原则要求分类内成员都在该出现的渠道池里）与 charge 标签补至 ≥4 件（现仅 3 件，档二永远达不到——数据缺陷）。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7，任务书=`design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md`（T0-T8≈4.5d，两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕，切分点=T3 出口；11 条设计契约含 6 条 🔴 停机级；12 条批末验收断言；代拍板白名单 5 项；待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/门票四参数终值/存档键正式迁移〕）。**开工门**：与在途 M-4 各批（判式换代/全局变异/配比预设）撞同一批文件（`adventure_table.gd`/`level_runner.gd`/`adventure.tres`），须确认不并行或用户明示插队 | 卡②门：迭代 14 出口 | 卡①已落籍（原估 0.5d）；卡②T0-T8≈4.5d（可两段切分：词族对齐段 + 渠道入表段） |
-| 迭代 15 | **③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）**：设计侧已完成（消歧更名批 `430419c`+`06e94b7`，26 个设计文档「魔法道具」→「**秘宝**」，同调位机制名保留不变），本批只做**代码侧对齐**、不做二次设计。内容：`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**（重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**A 玩家可见文案（P0，5 处）**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`（槽位标题 `UiKit.label`）+ `:178`（tooltip）· B schema 与数据表（`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改，**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑）· C 文档链接修复（含 `architecture.md` 两处既有断债顺带清偿）· D 中文注释层（**须分色**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。**用户三项拍板**：全族彻底改（含数据表）· **断点存档键一律保留**（`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 `aux_items` 不改（数据契约键）。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9，任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`（T0-T9≈5.0d，**超软盒 3 日上限·知情预挂**：T7 段末闸后 L3 呈报切点不擅切；**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 4 项；**待用户裁点 2 项**）。**撞批已消解**：② 奇物批 2026-10-05 收口落库（合并 `c571af2`），并行风险解除，本批为迭代 15 唯一在途需求；**T0 须重取基线**（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。**开工门**：须先裁 C1（`"aux_item"` 是否随全族改·牵动 schema 契约+`reward.tres`+冒烟断言三重连锁）/C2（`aux_items` 一名两义·ConfigDB 变量 vs 断点存档键） | 卡③门：迭代 14 出口 + **C1/C2 二裁点已决** | 卡①已落籍（原估 0.5d）；卡②已落籍（`c571af2`）；**卡③待开工**（T0 取基线后回填估时；二裁点未决前不开工） |
+| 迭代 15 | **③秘宝代码词族对齐批（2026-10-05 用户令编入本迭代）**：设计侧已完成（消歧更名批 `430419c`+`06e94b7`，26 个设计文档「魔法道具」→「**秘宝**」，同调位机制名保留不变），本批只做**代码侧对齐**、不做二次设计。内容：`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**（重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13），分五组落：**A 玩家可见文案（P0，5 处）**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`（槽位标题 `UiKit.label`）+ `:178`（tooltip）· B schema 与数据表（`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改，**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑）· C 文档链接修复（含 `architecture.md` 两处既有断债顺带清偿）· D 中文注释层（**须分色**：`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动）· E 测试文件名+内部变量。**用户三项拍板**：全族彻底改（含数据表）· **断点存档键一律保留**（`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改，破档即进度丢失）· registry 条目键 `aux_items` 不改（数据契约键）。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9，任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`（T0-T9≈5.0d，**超软盒 3 日上限·知情预挂**：T7 段末闸后 L3 呈报切点不擅切；**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕；5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕；代拍板白名单 5 项；**C1/C2 已裁关闭·全改保一致·待裁点 0 项**）。**撞批已消解**：② 奇物批 2026-10-05 收口落库（合并 `c571af2`），并行风险解除，本批为迭代 15 唯一在途需求；**T0 须重取基线**（判式换代批 T5 读数 750/0、② 又动数据层，§1.2 的 747 为②前旧数禁沿用）并复核事实表。**✅ 裁决（用户 2026-10-05「全改保一致」）**：C1 `"aux_item"` 域串**照改**（实测连锁面收窄——`reward.tres` 已零 aux_item 数据行，池种随迭代 11 T7 退役；16 处字面量全在代码内闭合无存档依赖；唯一连锁项=`smoke_all.gd:3932` 断言须同步）· C2 `aux_items` 一名两义**拆分**（ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**，禁改的只是落盘字面量）。新增**组 F**（分派语汇与域串 16 处），任务卡扩为 T0-T10≈5.5d。**开工门**：✅ 已无待裁点，可直接发 T0 | 卡③门：迭代 14 出口（**裁点已全决·可开工**） | 卡①已落籍（原估 0.5d）；卡②已落籍（`c571af2`）；**卡③可开工**（无待裁点；T0 取基线后回填估时） |
 ## 执行纪律（2026-09-27 用户立规）