From cde68006b2a9b5123732a776c60f483ce1eabe84 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 5 Oct 2026 07:31:56 +0800 Subject: [PATCH] =?UTF-8?q?=E7=A7=98=E5=AE=9D=E4=BB=A3=E7=A0=81=E8=AF=8D?= =?UTF-8?q?=E6=97=8F=E5=AF=B9=E9=BD=90=E6=89=B9=E4=BB=BB=E5=8A=A1=E4=B9=A6?= =?UTF-8?q?=20v1.1=EF=BC=88C3=20=E6=B6=88=E8=A7=A3=20+=20=E4=BA=8B?= =?UTF-8?q?=E5=AE=9E=E8=A1=A8=E5=A4=8D=E6=A0=B8=20+=20=E7=BC=96=E5=85=A5?= =?UTF-8?q?=20roadmap=20=E8=BF=AD=E4=BB=A315=E2=91=A2=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 前提：奇物批（迭代15②）已于 2026-10-05 收口落库（合并 c571af2）， 本会话前一轮的 UU 冲突态解除，可安全编辑迭代序列。 任务书修订（v1.0 → v1.1）： - §7 C3 撞批面**已消解**：② 已落库，本批为迭代 15 唯一在途需求，可独立开工。 残留义务三条：T0 重取基线（判式换代 T5 读数 750/0、②又动数据层，§1.2 的 747 为②前旧数禁沿用）/ T0 复核全部事实表 / 查清②"存档键正式迁移"待裁点状态。 - §2 事实表按②落库后复核修订三处： F1 文件数 35→**36**（`hero_info_panel_view.gd` 被②带入引用），处数 358 不变 F3 玩家可见文案 3→**5 处**——**补入两处初查遗漏的真实玩家可见字符串**： `hero_info_panel_view.gd:56` `UiKit.label("魔法道具", 16, true)` 槽位标题 `hero_info_panel_view.gd:178` `slot.tooltip_text = "魔法道具槽（空）"` tooltip （教训：`grep "魔法道具"` 命中 60+ 行但绝大多数是注释，字符串字面量需逐行核） F5 存档键引用 28→**34 处**（增量来自②带入的调用点；**②未迁移任何键名**， 已核 `git show c571af2 -- game/core/adventure_runner.gd` 无键名改动） - §3 组 A 补入上述两处 UI 文案，并加目检提示（C 区槽位标题与 tooltip 是玩家 唯一会看到的「秘宝」二字） - §1.2 判定 2 判据同步为 5 处基线 roadmap 新增迭代 15 需求③ 行（①调试整合已落籍 / ②奇物已落籍 / ③本批待开工）， 标注 T0 重取基线义务与两个待用户裁点（C1 `"aux_item"` 域串是否随全族改 / C2 `aux_items` 一名两义拆分）。 待用户裁点由 3 项降为 2 项（C3 已消解）。C1/C2 未决前不开工。 --- .../任务书-秘宝代码词族对齐批-2026-10-05.md | 38 +++++++++---------- roadmap.md | 1 + 2 files changed, 19 insertions(+), 20 deletions(-) diff --git a/design/research/任务书-秘宝代码词族对齐批-2026-10-05.md b/design/research/任务书-秘宝代码词族对齐批-2026-10-05.md index db8c9ff3..db2f9a0e 100644 --- a/design/research/任务书-秘宝代码词族对齐批-2026-10-05.md +++ b/design/research/任务书-秘宝代码词族对齐批-2026-10-05.md @@ -6,7 +6,9 @@ > 满足 loop engineering 八件（见 §9 逐条对照）；本任务书 = 计划书八节的前五节落地，§6 任务卡为执行单元。 > **用户三项拍板（2026-10-05）**：①编入迭代 15（追加）②**全族彻底改（含数据表）** ③**断点存档键一律保留**。 -> 🔴 **撞批警示（与同迭代 ② 奇物批）**：本批与 `任务书-奇物词族对齐与渠道分离批-2026-10-05.md` **撞同一批文件**（`core/level_runner.gd` · `data/tables/adventure.tres` · `core/adventure_runner.gd` 断点区），且**双方都动断点存档键**（本批禁改、②批内有"存档键正式迁移"待裁点）。**两批不得并行开工**，须串行或用户明示插队——详见 §7 C3。 +> 🔴 **撞批警示（与同迭代 ② 奇物批）**：本批与 `任务书-奇物词族对齐与渠道分离批-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 修订）。 + --- @@ -22,7 +24,7 @@ | # | 判定项 | 量化标准 | |---|---|---| | 1 | 词族换尽 | `game/` 下 `aux_*`/`AuxItem*`/`AUX_ITEM*` 出现处**仅剩 §4 白名单**（存档键 + 🔴 冲突面 + 历史留痕注释），其余全数换词 | -| 2 | 玩家可见清零 | `grep -rn "魔法道具" game/` **零命中**（现状 3 处：`battle_narrator.gd:117-118`、`bonus_interact_controller.gd:76`） | +| 2 | 玩家可见清零 | `grep -rn "魔法道具" game/` **零命中**（2026-10-05 收口后复核现基线 = **5 处玩家可见字符串**，见 §3 组 A；其余 60+ 命中均为注释，由组 D 清） | | 3 | 重闸全绿 | 冒烟 **747/0**（现基线，迭代 15 前实测值）· 十一探针全绿 · MC 逐位对拍**零漂移** · doc 三闸**对基线零新增** · 熵增闸 PASS | | 4 | 人闸完成 | 目检清单过 + 代拍板追认清单过 + §8 白名单外无代拍板 | | 5 | 收口五步 | active.md 快照 / 台账条目 / roadmap 里程碑行 / stage.txt（如变）/ 闸序列留痕 | @@ -33,11 +35,11 @@ | # | 事实 | 读数 | |---|---|---| -| F1 | `aux_*` / `AuxItem*` 词族规模 | **358 处 / 35 文件**（`game/` 下 `.gd` + `.tres`） | +| F1 | `aux_*` / `AuxItem*` 词族规模 | **358 处 / 36 文件**（`game/` 下 `.gd` + `.tres`）——⚠️ **2026-10-05 收口后复核：文件数 35→36**（`presentation/views/hero_info_panel_view.gd`，奇物批带入引用），处数不变 | | F2 | 重灾文件 | `core/adventure_runner.gd`(79) · `core/level_runner.gd`(27) · `presentation/bonus_interact_controller.gd`(19) · `core/battle_orchestrator.gd`(18) · `smoke/smoke_all.gd`(14) · `presentation/aux_interact_controller.gd`(14) · `core/config_db.gd`(14) · `presentation/main.gd`(13) | -| F3 | 玩家可见「魔法道具」文案 | **3 处**：`battle_narrator.gd:117` `battle_narrator.gd:118` `bonus_interact_controller.gd:76` | +| F3 | 玩家可见「魔法道具」文案 | **⚠️ 2026-10-05 收口后复核 = 5 处**（初查 3 处，漏 2 处 UI 文案）：`battle_narrator.gd:117` · `battle_narrator.gd:118` · `bonus_interact_controller.gd:76` · **`hero_info_panel_view.gd:56`**（`UiKit.label("魔法道具", 16, true)` 槽位标题）· **`hero_info_panel_view.gd:178`**（`slot.tooltip_text = "魔法道具槽（空）"` 悬停提示） | | F4 | 🔴 **`battle_narrator.gd` 同屏两义共现** | 117-118 行输出"魔法道具" ‖ 同文件 **139 行** `arch_names := {"magic": "魔法", ...}` = 敌方伤害语汇——同一 narrator 内两义并存，是歧义的**唯一真实暴露点** | -| F5 | 断点存档键（**禁改**） | `bonus_aux_carry` · `aux_detail` · `aux_cleared` · `aux_cleared_last` · `aux_items`（断点快照数组）· `attunement_charges` —— **28 处引用**（读 28 / 内部变量 26） | +| F5 | 断点存档键（**禁改**） | `bonus_aux_carry` · `aux_detail` · `aux_cleared` · `aux_cleared_last` · `aux_items`（断点快照数组）· `attunement_charges` —— **2026-10-05 收口后复核 = 34 处引用**（初查 28 处，增量来自②奇物批带入的调用点；**②未迁移任何键名**，diff 核实无键名改动） | | F6 | 🔴 **冲突面：`aux_items` 一名两义** | 既是**断点存档键**（`adventure_runner.gd:976` 写入 / `:951-953` 读取，跨局持久，改名即破档）**又是** registry 条目键与 ConfigDB 持有变量名（`config_db.gd:50` `var aux_items: AuxItemTable`）——**同一字符串，语义不同层** | | F7 | 🔴 **冲突面：`"aux_item"` 是加载期校验域串** | `reward_table.gd:15` `CELL_TYPES` 封闭枚举含 `"aux_item"`（十型之一）· `:16` `AUX_ITEM_TYPE` 常量 · `smoke_all.gd:3932-3933` **断言 `CELL_TYPES.size() == 10` 且 `has("aux_item")`** —— 改此串 = 改 schema 契约 + 改 .tres 数据行 + 改冒烟断言，**三重连锁** | | F8 | Godot 类名/文件名 | `AuxItemTable`(schema) · `aux_items.gd` · `aux_item_table.gd` · `aux_interact_controller.gd` —— 改名须同步 `.uid` + `.tscn` 引用（迭代 14.5 有实证先例：主区跑前须 `--import` 重刷类名缓存） | @@ -53,8 +55,12 @@ | `presentation/battle_narrator.gd:117` | `return "魔法道具\n%s" % aux_line` | `return "秘宝\n%s" % aux_line` | | `presentation/battle_narrator.gd:118` | `return "魔法道具\n随机获得一件"` | `return "秘宝\n随机获得一件"` | | `presentation/bonus_interact_controller.gd:76` | `toast.show_toast("上关剩余 %d 件魔法道具已随关卡结束清空" ...)` | `"上关剩余 %d 件秘宝已随关卡结束清空"` | +| **`presentation/views/hero_info_panel_view.gd:56`** | `col.add_child(UiKit.label("魔法道具", 16, true))` | `UiKit.label("秘宝", 16, true)` | +| **`presentation/views/hero_info_panel_view.gd:178`** | `slot.tooltip_text = "魔法道具槽（空）"` | `slot.tooltip_text = "秘宝槽（空）"` | +> **后两处是 2026-10-05 收口后补入的**（初查仅命中 3 处，漏了 UI 标签与 tooltip 两处——`grep "魔法道具"` 命中 60+ 行但绝大多数是注释，**这两处是真实玩家可见字符串**）。 > **组 A 独立成一个提交**——它是本批唯一有玩家可见效果的部分，先行落地上游台账可独立验收。**F4 两义共现随本组一并消解**（117-118 改后同屏不再出现两个"魔法"）。 +> **目检提示**：组 A 落地后须实机确认 C 区槽位标题与悬停提示——这是玩家唯一会看到的「秘宝」二字。 ### 组 B · schema 与数据表文件（类名 + 文件名 + @export） @@ -180,24 +186,16 @@ > **我方倾向：甲 + 强制注释标记**——变量改词，存档键在代码旁加显式注释 `// 🔴 存档键，历史名，禁改（2026-10-05 用户拍板）`。**须用户拍板**。 -### C3 · 与同迭代 ② 奇物批的串行次序（🔴 **开工前必须定**） +### C3 · 与同迭代 ② 奇物批的串行次序（✅ **2026-10-05 已消解**） -**事实冲突**：两批同属迭代 15、**撞同一批文件**、**双方都动断点存档键**。 +**原事实冲突**：两批同属迭代 15、**撞同一批文件**、**双方都动断点存档键**。 -| 撞点 | 本批（③秘宝） | ② 奇物批 | 冲突性质 | -|---|---|---|---| -| `core/level_runner.gd` | 改 `restore_aux_items` / `grant_aux_item` / `aux_inventory` 等 | 动 `feature_*` / `relic_*` / `bonus_*` 词族 | 🔴 **同文件不同词族**，机械替换易误伤 | -| `data/tables/adventure.tres` | 只改注释（`aux_item` 池种退役注记） | 改数据行（`feature_*` → `curio_*` 键） | 🔴 同文件，数据 vs 注释混层 | -| `core/adventure_runner.gd` 断点区 | **禁改**（`bonus_aux_carry` / `aux_items` 键） | 有"存档键正式迁移"待裁点 | 🔴 **若 ② 先迁移键名，本批的禁改清单失效** | -| 冒烟基线 | 待 T0 取实际值 | 同样待取 | 🟡 两批先后跑，基线数字不同 | +**✅ 消解结论（2026-10-05 07:29 复核）**：② 奇物批**已收口落库**（合并提交 `c571af2`），**并行撞批风险解除**。本批现为迭代 15 唯一在途需求，可独立开工。 -| 方案 | 做法 | 风险 | -|---|---|---| -| **甲** | ② 先走完（其 T3 出口 = 切分点），③ 开工时**重新取基线**并复核本批事实表 F1–F10 | 🟢 串行无冲突；代价 = ③ 起点后移 | -| **乙** | ③ 先走，② 延后 | 🟡 ③ 改动面小（5 组），先跑代价低；但 ② 的"存档键迁移"待裁点会因 ③ 的"禁改"约束而需重议 | -| **丙** | 两批并行 | 🔴 **禁止**——同文件同区域机械替换，必生不可定位的冲突 | - -> **我方倾向：甲（② 先走）**——② 的 T8 涉及"存档键正式迁移"这一未裁事项，若 ③ 先动完代码再由 ② 迁移键，等于让 ③ 的禁改清单被单方面作废。**须用户拍板并定次序**。 +**⚠️ 残留义务**： +1. **T0 须重新取基线**——② 已把冒烟推进（判式换代批 T5 出口读数 **750/0**、奇物批又动数据层），§1.2 的 747 是②之前的旧数，**禁止沿用**。 +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. 代拍板白名单 diff --git a/roadmap.md b/roadmap.md index 029f4832..26f71c06 100644 --- a/roadmap.md +++ b/roadmap.md @@ -62,6 +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-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七正主落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+任务书全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；任务书=`design/research/任务书-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、任务书冻结保留=design/research/任务书-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已落籍 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 |**③全局作用域变异首发批（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-T8 实施批全落（T7b MC 读数批按切分预案切独立后批，跑批待用户批准）——skewed_veins 贫矿脉行+互锁三条+effect_value [0,50]/门控第三维节点身份/替换制+兜底回落/装板序全局决议前置（数据依赖调和，出口报告在册）/资源面偏斜投影（整数最大余数守恒 77+合成序图级先件级后）/三层预告三层全接/七正主落文+06 收口；闸=冒烟 747/0（+29）+run_all 15+golden 普通图逐位 12/12 全等+六探针+三闸熵增终录见批报告 design/qa/m4iter14-gvar-exit-report-2026-10-04.md（Q3 四件应对件知情代价登记+静态推演+provisional 追认单+人闸目检清单）；**③出口成立——⑥A4 开工门解一半**（另半=②出口）；off/on 双档读数待 T7b（带 A 判读归 M-4 只测不判）。**④技能池执行批（2026-10-04 用户点名入列——调研+四裁+任务书全齐，06 Alpha 验证条目随之收口）**：文档五件（敌人系统.md 池构成表补 L2/L3 五敌种行/护甲列改读表口径/Boss 三代错峰句/意图呈现节补解锁弹出规格/版本 v0.13+EV 锚整数口径重登记+enemy.tres 批注消歧）+**新机制一件=Boss 半血解锁新独占伤害技**（三 Boss 血量 ≤50%〔用户口径定死〕解锁：酋长「震地怒击」类 ×2.5/CD4·卓尔遏毒类 ×2.0/CD3·石君王「岩崩」类 ×2.5/CD4——参考档即工作值，命名 T5 定稿、倍率冷却 provisional 归调参；enemy.tres 池条目扩 unlock_hp_pct 键〔int [1,99] 缺省无=无门槛〕；未解锁条目双面过滤不进摇号与保底集合；解锁出一次归因明细行「XX 解锁了 YY」）；首拍加权取消（杂鱼纹理注销——巨蜘蛛 52% 读数已被 Package B 抬血自愈、地精两行终裁不加工）；呈现=明细行+既有类型级预告+解锁时技能名一次性弹出（零动画资产、不改演出）；裁决 D1-D8 零待裁；任务书=`design/research/任务书-技能池执行批-2026-10-04.md`（T0-T7≈4.25d，切分预案在册）——开工=用户发令升计划书。**⑤魔法提灯 +2 效果接线（小卡）**：零调研直入——2026-09-30 拍板④已裁（灯甲视野外扩 +2 格、类型微光不随视野扩），迷雾批已留常量 LIGHT_RADIUS_LANTERN_BONUS，纯接线+断言估 0.5d 内。原候选卡注记终态（2026-10-04）：敌人系统内容批=已具化为④；教学引导定稿批=用户裁改排 Beta（06 教学节头注记在案），移出本迭代候选。**⑥冒险前资源配比预设批——已移出本迭代（2026-10-05 用户令挂起：暂不做；条目保留 06-待办清单「冒险前资源配比预设（构筑提案）」〔已裁待实施→挂起〕，八项裁决全数有效、任务书冻结保留=design/research/任务书-冒险前资源配比预设批-2026-10-04.md；重启须用户另行发令，届时开工门仍=②③号卡出口〔若②③已落籍 master 则自动解——合成序与包络数值锚依赖②判式换代与③变异投影，三者共用摇号投影点〕）**。 | 迭代 13 出口（**迭代 13 已落籍 2026-10-04 eff8cb8**，台账 342） | 初始展开批 T0-T8（可两段切分）+判式换代批 T0-T5≈2.5d（独立 worktree 合并）+全局变异首发批 T0-T8≈5.75d（读数批可切，独立 worktree 合并）+技能池执行批 T0-T7≈4.25d（独立 worktree 合并）+提灯接线小卡 0.5d（可并入任一批顺路）〔⑥配比预设批 A4 已移出本迭代挂起，2026-10-05 用户令〕 | | 迭代 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 取基线后回填估时；二裁点未决前不开工） | ## 执行纪律（2026-09-27 用户立规）