任务书 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 为②前旧数 禁沿用）。
This commit is contained in:
DKChan committed
1 parent
cde68006b2
commit
3c4291dbd9
2 files changed
+127
-36
No files matched your search
@@ -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` 加载零报错 |
|
||||
| **T4** | **组 B-2**（ConfigDB 持有变量 + 访问器 + 全部调用方跟改） | 0.75d | 冒烟 + MC 对拍 | 冒烟数值断言全绿（访问器链路完整） |
|
||||
| **T5** | **组 E-1**（测试文件名 + preload + run_all 登记） | 0.5d | 冒烟（十五套件全跑） | `run_all` 无 fixture 缺失 |
|
||||
| **T6** | **组 E-2**（内部变量换词） | 0.5d | 冒烟 + MC 对拍 | MC 逐位零漂移 |
|
||||
| **T7** | **重闸**：全量轻闸 + doc 三闸 + 熵增闸 + MC 逐位对拍 | 0.5d | 重闸全绿 | §1.2 判定 3 五项全绿 |
|
||||
| **T8** | **人闸**：目检清单 + 代拍板追认 + §7 冲突面裁决回报 | 0.5d | 目检过 | §1.2 判定 4 |
|
||||
| **T9** | **收口五步** | 0.25d | — | §1.2 判定 5 |
|
||||
| **T3** | **组 F**（`"aux_item"` 分派语汇与域串 16 处，含冒烟断言同步） | 0.5d | 冒烟 + MC 对拍 | `smoke_all.gd:3932` 断言同步后绿；`reward.tres` 零改动 |
|
||||
| **T4** | **组 B-1**（schema 文件名 + 类名 + `.uid` 同步 + `--import` 重刷） | 0.75d | 冒烟 + `--import` 后类名解析 | `TreasureItemTable` 加载零报错 |
|
||||
| **T5** | **组 B-2**（ConfigDB 持有变量 + 表注册键 + 访问器 + 全部调用方跟改） | 0.75d | 冒烟 + MC 对拍 | 冒烟数值断言全绿；**§4.2 四处同名用法按表分置** |
|
||||
| **T6** | **组 E-1**（测试文件名 + preload + run_all 登记） | 0.5d | 冒烟（十五套件全跑） | `run_all` 无 fixture 缺失 |
|
||||
| **T7** | **组 E-2**（内部变量换词，**存档键字面量除外**） | 0.5d | 冒烟 + MC 对拍 | MC 逐位零漂移；§4.1 十二处存档键**逐字未变**（diff 专项核） |
|
||||
| **T8** | **重闸**：全量轻闸 + doc 三闸 + 熵增闸 + MC 逐位对拍 | 0.5d | 重闸全绿 | §1.2 判定 3 五项全绿 |
|
||||
| **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` 闸可能判新增术语债 |
|
||||
| **乙** | 保留 `"aux_item"` 域串为**已知欠债**，加注释说明它 = 秘宝 | 零风险；"全族彻底改"打折（但可解释为"域串非用户可见语义"） |
|
||||
| `config_db.gd:27` `var aux_items` / `:50` 持有变量 | 进程内持有 | ✅ 改 `treasure_items` |
|
||||
| `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 判定。**须用户拍板**。
|
||||
|
||||
### 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 用户拍板）`。**须用户拍板**。
|
||||
落地细则见 §4.2。
|
||||
|
||||
### 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。
|
||||
|
||||
Reference in new issue
Block a user