修复: 卡⓪④——删 adventure_runner.gd start_adventure 三行重复赋值（逐字重复+中间零语句+_seed_attune_charges 纯重置幂等=零行为变化，证据与四件对照见出口报告）；入口报告随批落籍
This commit is contained in:
DKChan committed
1 parent
fb845b78dc
commit
8a654ccece
2 files changed
+96
-3
No files matched your search
@@ -0,0 +1,96 @@
|
||||
# 迭代 19 卡⓪「主菜单开局缺陷修复批」出口报告（2026-10-08）
|
||||
|
||||
- worktree：`D:\code\g-plan2-iter19-card0`（分支 `iter19-card0-20261008`，基点 b0a73df = master 顶部）
|
||||
- 台账号：**398**（记账前以 `git -C D:/code/g-plan2 show master:active.md` 查撞——master 无 398；397 条预配「卡⓪398」与本卡一致，未撞未顺延）
|
||||
- MC/verifier：零跑（本卡 MC=静态论证，见 §5）
|
||||
|
||||
---
|
||||
|
||||
## 1. 四件逐件改动对照（file:line 改前 → 改后）
|
||||
|
||||
### ① 主菜单两入口补传同调三键
|
||||
|
||||
T0 实查：行号与任务书一致（新冒险入口 main.gd:510、继续上局入口 main.gd:470）；接收面确认 start_adventure :129-130+138 三键齐、resume_adventure :215-216 仅两键（见 §7 披露项）。三键来源复用既有营地投影口径，零新读取逻辑：
|
||||
|
||||
| 键 | 来源（既有访问器） | 与营地投影同源依据 |
|
||||
|---|---|---|
|
||||
| attunement | `save_manager.attunement_equipped()`（save_manager.gd:314-316） | `meta.attune_camp_status()["equipped"]` 同一读数源（meta_progression.gd:368） |
|
||||
| attune_refresh_y | `meta.attune_refresh_charges()`（meta_progression.gd:394-395，当前等级行表值） | `attune_camp_status()["refresh"]["charges"]` 同一读数源（:386） |
|
||||
| tree_rules | `meta.tree_rule_keys()`（meta_progression.gd:241-253，Fork 激活侧 effects） | 树 rule 键集唯一既有取值口 |
|
||||
|
||||
改动（均 `game/presentation/main.gd`）：
|
||||
|
||||
- **新增 static 构造函数 `build_adventure_params`**（改前 :493 空、改后 :496-513）——两入口共用参数面构造；hero_override 沿用既有 `meta.hero_override() if meta != null else {}` 口径原样搬入；static 形态=冒烟直呼单测（③），免实例化整菜单场景。
|
||||
- **继续上局入口**（`_resume_from_menu`，改前 :470 内联 2 键 dict `{"hero_override", "treasure_unlocked"}` → 改后 :470-471 `build_adventure_params(save_manager, meta, {"treasure_unlocked": ...})`，产出 5 键）。
|
||||
- **开新冒险入口**（`_start_adventure`，改前 :510 内联 4 键 dict → 改后 :528-530 `build_adventure_params(save_manager, meta, {"first_script", "treasure_unlocked", "shop_mode"})`，产出 7 键）。
|
||||
|
||||
runner 侧受理零改动（任务书明令「无需改 runner 侧受理」）。
|
||||
|
||||
### ② 关卡开场行攻血改传当前生效值 + 后缀认局外加成
|
||||
|
||||
改动（`game/presentation/main.gd` `_on_adventure_level_started`，改前 :517-521 → 改后 :539-549）：
|
||||
|
||||
- 攻/血：改前传初始表值 `int(db.hero.atk)` / `int(db.hero.max_hp)` → 改后传 `runner.effective_atk()` / `runner.effective_max_hp()`——与战斗面板同源（battle_orchestrator begin_battle enc 的 `hero_atk`/`hero_max_hp` 即 LevelRunner.effective_*，level_runner.gd:479-480）。回调时点 runner 已带全部加成：`level_started` 在 `_runner.start_level_external(...)` 之后 emit（adventure_runner.gd:946，改后 :943），base_override/加算区/调试 pct 均已注入。
|
||||
- 「含面板加成」后缀判断：改前只认 `debug_overlay.atk_pct() > 0 or debug_overlay.hp_pct() > 0` → 改后追加认局外加成 `meta.hero_override()` 的 atk/max_hp 两轴 flat 任一 >0（调试 pct 条件保留）。白板局（无局外 flat、无面板 pct）不带后缀。后缀文案本身零改。
|
||||
- 依据：06-待办清单「关卡开场行攻血显示初始表值」条——「战斗面板用 level_runner.gd:480 生效值……两处数字对不上；后缀只认调试浮窗 pct，局外加成不触发注记」，用户 2026-10-07 确认缺陷成立。
|
||||
|
||||
`battle_narrator.gd:38-40`（level_open_line）零改——签名与拼装能力本就够用。
|
||||
|
||||
### ③ 冒烟补主菜单入口传参断言
|
||||
|
||||
改动（`game/smoke/smoke_all.gd`，新增 :4661-4687，⑫同调段之后、`_meta_smoke_cleanup()` 之前）：
|
||||
|
||||
- 形态：直呼 `load("res://presentation/main.gd").build_adventure_params(...)` 单测统一构造面（static 免实例化整菜单场景，对既有冒烟夹具零侵入——level_autoplay 直呼 runner 的旧口径原样不动）。
|
||||
- 夹具（隔离档 `_META_SMOKE_PATHS[8]`＝smoke_meta_tree.json，随段尾既有 cleanup 清理）：装配 `["luck_coin"]` + Y 升 2 档 + Fork `fg_posture` 取 a 侧；前置断言防空转（rule 键非空 + Y=Lv2 行表值 2）。
|
||||
- 断言 6 项（大白话文案）：
|
||||
1. 前置：Fork 侧 a 激活 rule 键非空 + Y=Lv2 行表值 2；
|
||||
2. 开新冒险：同调装配 = 存档装配集（营地装了什么开局就带什么）；
|
||||
3. 开新冒险：Y 刷新池 = 当前等级行表值（营地升几档开局就给几次）；
|
||||
4. 开新冒险：树 rule 键集 = Fork 激活侧 effects（点哪侧带哪侧）；
|
||||
5. 开新冒险：入口特有键（first_script/shop_mode）随 extra 原样并入；
|
||||
6. 继续上局：三键与开新冒险同源同值（续玩不吃白板开局）。
|
||||
- 两入口覆盖说明：真实两入口共用 `build_adventure_params`（①的落法），开新/续玩两组断言即两路径的传参面；构造函数被两入口弃用回归时第 2-6 项即转红。
|
||||
|
||||
### ④ 删 adventure_runner.gd 三行重复赋值
|
||||
|
||||
改动（`game/core/adventure_runner.gd`，改前 :132-134 三行 → 删；现 :129-131 单组赋值收尾）：
|
||||
|
||||
零行为变化证据：
|
||||
|
||||
1. **逐字重复**：被删 :132-134 与保留 :129-131 三行逐 token 相同（`_attunement = params.get(...)`、`_attune_refresh_y = maxi(0, int(params.get(...)))`、`_seed_attune_charges()`），同一 params 实参下二次赋值结果逐位相等。
|
||||
2. **中间无扰动**：:131 与被删 :132 之间零语句——两次 `_seed_attune_charges()` 连续背靠背调用。
|
||||
3. **`_seed_attune_charges` 幂等**（:635-640，改后 :632-637）：函数体 = `attune_charges = {}` 整体重置后按 `_attunement`+表行重灌——纯函数（读 params 已落地的 `_attunement` 与 db 表行，零 RNG、零信号、零 db 写），连续两次调用终态与一次相同。
|
||||
4. **闸实证**：删后 run_smoke 840/0、run_all 17 套件全绿（含 breakpoint_resume/curio_refresh_paid 等直呼 start_adventure 参数面的套件）——充能账本/刷新双源行为断言零漂移。
|
||||
|
||||
## 2. 闸数字（改前基线 / 改后）
|
||||
|
||||
| 闸 | 改前（主区 b0a73df 实测基线） | 改后（本 worktree 批末） |
|
||||
|---|---|---|
|
||||
| run_smoke | 834 项 0 失败，三闸过 | **840 项 0 失败，三闸过**（+6=③新增断言，失败数持平 0） |
|
||||
| probe_gate 默认段 | input/struct/contrast 三探针全绿 | 三探针全绿 |
|
||||
| probe_gate --click | 全绿 | 全绿（click 走查真跑主菜单开局一场冒险，问题=0） |
|
||||
| run_all | 17 套件全绿 | 17 套件全绿 |
|
||||
| 残留 Godot | 0 | **0**（probe_gate 批末闸「本闸残留 Godot=0 · 全局 Godot=0」） |
|
||||
|
||||
中间轮次：改动落齐后即跑轻闸（probe_gate 默认段全绿 + run_smoke 840/0），批末重闸三件全跑如上。
|
||||
|
||||
## 3. MC 零跑静态论证（一句话）
|
||||
|
||||
本卡 MC=静态论证：MC 取数面不经主菜单入口（adventure_monte_carlo/level_autoplay 直呼 AdventureRunner 参数面，在册夹具口径不动），故 ①② 的呈现层改动对 MC 路径零触及，MC 零跑零风险。
|
||||
|
||||
## 4. 范围外三件未触碰声明
|
||||
|
||||
- X/Y 刷新双源语义倒置（adventure_runner.gd 原 :658-659/:706-709，删重后 :655-656/:703-706）：**零触碰**（④删除的三行在其上方，纯行号平移，内容未动——待用户裁定甲/乙）。
|
||||
- 被动同调件呈现：**零触碰**。
|
||||
- Fork 规则归因行（呈现层）：**零触碰**。
|
||||
- 主区其余脏文件：**零触碰**（全程只在本 worktree 改动三文件+出口报告+active.md；主区仅 `git -C` 只读查询）。
|
||||
|
||||
## 5. 遗留与移交项
|
||||
|
||||
1. **runner 侧 resume_adventure 受理面无 tree_rules 键**（:215-217 仅收 attunement/attune_refresh_y；任务书「接收面 :215-217 现成」对 tree_rules 不成立）。本卡按「无需改 runner 侧受理」执行：两入口三键均已传出，续玩局 tree_rules 暂不被消费（=续玩局 Fork 规则键暂不生效，与修复前同态、无回归）。移交：runner 侧补一行受理（`_tree_rules = params.get("tree_rules", ...)` 同 :138 款）即可闭环，归用户裁定后随任一后续批落。
|
||||
2. X/Y 双源语义倒置仍待用户裁定（范围外，登记 06）。
|
||||
3. 开场行后缀在「局内有加算区 flat 但无局外加成」时无注记（数字含加算区但 suffix 不带）——按任务书「局外加成存在才带」字面口径执行，如需扩展认加算区归设计批裁定。
|
||||
|
||||
## 6. 提交清单
|
||||
|
||||
（本节随提交落定，见 git log——分四笔：修复①② / 断言③ / 清理④+出口报告 / 台账 398 记账。）
|
||||
@@ -128,9 +128,6 @@ func start_adventure(seed_val: int, params: Dictionary = {}) -> bool:
|
||||
_treasure_unlocked = params.get("treasure_unlocked", {}) if params.get("treasure_unlocked", {}) is Dictionary else {}
|
||||
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive（迭代 11 第①批 T5）
|
||||
_attune_refresh_y = maxi(0, int(params.get("attune_refresh_y", 0))) # additive（迭代 11 第①批 T5b——Y 冒险周期池）
|
||||
_seed_attune_charges() # 迭代 11 第①批 T6——冒险开始充能账本按装备主动件重置（每冒险充能语义） # additive（迭代 7 T5）
|
||||
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive（迭代 11 第①批 T5）
|
||||
_attune_refresh_y = maxi(0, int(params.get("attune_refresh_y", 0))) # additive（迭代 11 第①批 T5b——Y 冒险周期池）
|
||||
_seed_attune_charges() # 迭代 11 第①批 T6——冒险开始充能账本按装备主动件重置（每冒险充能语义）
|
||||
# 特性开局注入（迭代 12 T7——MC 成型画像载体：params.relics_seed 非空=开局持有集〔七流派
|
||||
# 各 2 件档一成型——测量面专用；真实局规则改写型特性只走局内随机渠道，红线②层级纪律不破〕）
|
||||
|
||||
Reference in new issue
Block a user