game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

合并(迭代39拆件批): 三卡实现(主卡冒险域拆件与账本实体化/副卡同调配装充能域封装/触发器卡技能池情境条件触发器)+领域拆分v1.3(B1主角账三件HeroStats/GpWallet/GainJournal·B2停点刷新账RefreshBank·B3私有助手抽取·B4战斗指标面)——特批带红合并: 02 EV锚(goblin 0.9148∉[1.00,1.20],重锚归后续数值批待用户发起)+08d 生涯.md:55行号漂移(修复归合并后文档批,反哺点在册)登记存量红;全量闸回执验收通过(闸况与基线一致,09指纹回归91d45583cf6d);断点对拍292dumps×28键mismatch=0

Browse Source
This commit is contained in:
DKChan committed 2026-10-27 18:21:10 +08:00
2 parents 192e336d6d 3530144e49
commit ffb0ac1526
73 files changed
+1755939 -2747
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

reports/iter39-代拍板-2026-10-27.md
+16
View File
@@ -0,0 +1,16 @@
# 迭代 39 代拍板追认单（2026-10-27）
接收方：用户会话追认（备案确认——授权发生在卡片审问阶段白名单，本单为批后备案）。
| # | 卡 | 白名单条目 | 裁量内容 |
|---|---|---|---|
| 1 | 主卡 | 提交切分与 worktree 命名 | 分支 iter39 单工作区；T0/T1/T2/T3/T4/T5 各一笔提交 |
| 2 | 主卡 | 测试改址等价写法 | 直读写已迁字段 30+ 处→stop()/hero() 件测试构造面；bind 句柄每回调新建故以关卡号守卫判重（Callable 相等不可靠） |
| 3 | 主卡 | 迁入注释随迁措辞 | 公式/兑付/断点段注释随迁 |
| 4 | 主卡 | 单关私有 HeroLedger 内部组织 | rebase_override 重注面＋reset_for_single_level 值重置（实例不重建） |
| 5 | 主卡（超白名单，呈追认） | ctx 增 adv_bucket 键 | 卡片 ctx 键清单漏列桶传递面——按「构造注入一次给齐」意图补全 |
| 6 | 副卡 | 种行/补行内部组织 | treasure_inventory 提冒险级共享（卡片文件结构图 treasure_items.gd 零触碰保持；关卡末清空调用点改选择性保留——「同调行始终留在 treasure_inventory」的行承载前提，玩家可见 C 区投影零变化） |
| 7 | 副卡（超白名单，呈追认） | 跨版续玩键值兜底补行 | 契约 3「行集为源」的跨版例外——改前档关卡完成停点行已被关末清空（键在行缺），按键值差额补行=与字典轨续玩逐位等价；新档行集为源差额零操作 |
| 8 | 触发器卡 | 新技/状态行定名 | desperate_guard/孤注守势、sneak_ambush/趁隙偷袭、defensive_stance/护身（推荐案采纳） |
| 9 | 触发器卡 | provisional 数值 | w1/w2、lte 35、−25、×1.5、CD4、duration 2（同数量级内） |
| 10 | 触发器卡 | 断言组织与夹具 | trigger_cond_test 内部组织；V5 对拍以 skill_unlock/round_flow 编排集成承载（迁移断言+事件摘要） |
reports/iter39-反哺点-2026-10-27.md
+23
View File
@@ -0,0 +1,23 @@
# 迭代 39 反哺点清单（2026-10-27）
接收方：各 owner 文档（文档批落文依据，用户裁决后执行）。
| # | 文档 | 关联点 | 改成什么 | 依据 |
|---|---|---|---|---|
| 1 | design/engineering/architecture/architecture.md | 模块归属表 HeroLedger/CurioStop/AttuneLoadout 三行「设计定稿——实现批建件」标注 | 改「已实装（2026-10-27）」；RunLedger 相关行整段退役注记；模块表 level_runner/battle 行消费依赖列 ledger 引用句删除；CurioDeck 行删 bind_handlers 句；level_runner 行补构造注入句；「冒险域拆分定稿」节转现状登记 | 主卡+副卡落地实况 |
| 2 | design/gdd/systems/表现与支撑/存档序列化.md | 断点域段机制句（写侧 _bp_parts 拼装/读侧 _bp_read 派生） | 改「各件自交片段（主角账/停点件/关卡件）＋冒险应用层唯一拼盘落盘口＋获得日记键扩列（gain_journal，28 键——旧档缺键汇总直载）」；同调行「始终留在 treasure_inventory」句随单源化核对 | 主卡 T4/副卡 k4 |
| 3 | design/gdd/systems/冒险循环/冒险结构.md | 断点域字段口径 owner——获得日记键字段口径登记 | 键名 gain_journal、缺省策略 plain、旧档回退（缺键=汇总直载跳过比对；在档=明细推导比对不符拒载） | 主卡契约 2 |
| 4 | design/gdd/systems/跨局循环/秘宝.md | 充能账机制句若有双轨描述 | 改单源化（物化行唯一事实源、剩余=未用行派生；同调未用行跨关存活——关卡末清空选择性保留） | 副卡落地实况（T0 核该文档若无双轨描述记「无需改」） |
| 5 | design/gdd/systems/战斗循环/敌人系统.md v1.2 | §P1 表「情境条件触发器」行「待写卡实装」 | 改「已实装（2026-10-27）」；§半血解锁收编段「字段换代与行值迁移归实装批」句摘除 | 触发器卡落地 |
| 6 | design/gdd/systems/战斗循环/战斗结算.md v1.0 | 开轮摇号排除句触发条件指针 | 查实装后无陈述漂移则记「无需改」 | 反哺核对行 |
| 7 | design/gdd/systems/冒险循环/难度曲线与Boss.md v1.0 | 技能池投值面 | 查无漂移记「无」；两示范 provisional 投值（w1/w2/lte35/−25/×1.5）登记读表口径 | 触发器卡 §二 |
| 8 | design/engineering/architecture/architecture.md | UnitContainer 新公开面（check_trigger_unlocks/事实组包口径）API Boundaries 登记面核查 | 若属登记面补行 | 触发器卡 §六 |
| 9 | 体验验证清单.md | 实机目检观测项两条入册 | ①上轮停手→下轮明细出「趁隙偷袭」②地精低血后摇出「孤注守势」 | 触发器卡（登记不阻塞） |
| 10 | 待办清单.md | 两源条目状态推进 | 「AdventureRunner 职责真拆分」「技能池情境条件触发器」→完成（batch-closure 承接） | 实现报告 |
| 11 | design/gdd/systems/跨局循环/生涯.md:55 | 代码行号指路句指 adventure_runner.gd:814（本批收薄后 627 行——行号越界，08d 引用可核新增红） | 行号指路改语义指认（结算受理段已随拆件迁 CurioStop/主角账——按 doc-conventions「引用不转述/代码↔设计追溯由 GDD 承担」改写该句；行号指路本属脆弱面，建议连同 :50/:60 两处留档句一并换代） | 本批 diff 直接后果（commit 被文档域闸拦——反哺落文后本批合回） |
| 12 | design/engineering/test-conventions.md | 验收尾缀形态：check_quiet 静默收集断言不入 extract_checks.py 扫描面（审计备案）；失败消息尾缀对静默通道的字面形态 | 备案级——工具面局限登记（如需覆盖 check_quiet 属提取器改版，工程批） | 独立验收审计备案 |
| 13 | 触发器卡 V5 改前基线载体 | 卡定 game/tests/evidence/trigger_baseline.md 未落盘（代拍板 #10 改道 skill_unlock/round_flow 编排集成承载） | 备案——三 Boss 迁移零变化验证强度=语义断言级；后续同类迁移批建议保留事件序列基线落盘义务 | 独立验收审计备案 |
**边界漏判呈报（副卡契约 3 内在矛盾，已按行留存实现）**：副卡 K4「aux_items 键载库存全量快照（含同调行）」在选路/三选一停点成立、在关卡完成停点不成立（改前行已被关末 reset 清空）——「同调行始终留在 treasure_inventory」与「aux_items 键值形态逐位不变」在该停点形态互斥。实现采「行留存」（关卡末清空改选择性保留＋treasure_inventory 提冒险级共享），断点档关卡完成停点 aux_items 含同调未用行（24 停点形态变化，充能读数 attunement_charges 全部逐位一致）。建议 §2 反哺时把该边界写明。
reports/iter39-实现报告-2026-10-27.md
+47
View File
@@ -0,0 +1,47 @@
# 迭代 39 实现报告（2026-10-27）
接收方：待办清单「AdventureRunner 职责真拆分」「技能池情境条件触发器」两条目（batch-closure 收尾依据）＋本报告 §四呈报项待用户裁决。
## 一、各卡状态
| 卡 | 状态 | 收口提交 |
|---|---|---|
| 主卡·冒险域拆件与账本实体化批 | 完成（T0-T5，wr1-wr8 落地） | 0229d5fb/8d7b12e0/4a9e4300/4da7f3e2/fa1409f4/659d59ed |
| 副卡·同调配装充能域封装批 | 完成（RunLedger 整类退役） | 80fe4b8f＋收尾笔 |
| 触发器卡·技能池情境条件触发器批 | 完成（机制+三 Boss 迁移+两示范） | 4868e11b |
## 二、实际改动—验收对照表（结果格随附）
| 需求点 | 验收测试 | 真实入口 | 撤销证明 | 结果 |
|---|---|---|---|---|
| wr1 账本实体化 | hero_ledger_test hr1/hr1-s/hr2 | start_adventure 真链＋商店购买真链 | 回退 shop_session gain_bonus hunk→hr1-s 红→还原复绿（本批执行，undo1） | 绿 |
| wr2/wr3 停点件+纯池化 | adventure_feats〔拆件批 V2〕/level_shop_economy〔V3〕现役断言承继 | 三选一真链/pool 购买真链 | （同族 wr1 承载——停点迁移 bp 对拍五时点零漂移主证） | 绿 |
| wr4/wr5 信号直连+构造注入 | hero_ledger_test sc3 源码断言（_bind_shop 单点/_forward_ 零命中）＋adventure_feats 信号序 | 两关全流程驱动 | （bp 对拍承载） | 绿 |
| wr6 断点片段化+日记键 | bp1 对拍 292dumps×27 键六时点逐位零漂移＋gain_journal 单列在档＋breakpoint_resume P8 28 键 | 同种子双跑 | （bp 对拍主证） | 绿 |
| wr7 转发属性撤除 | 改址后现役断言全绿＋S13 读数（§三） | 五单测套＋ui_input_probe | —— | 绿 |
| wr8 产出物 | 本报告三件套 | —— | 缺项红 | 在案 |
| 副卡 wr1-wr3 充能单源化 | feat_vouchers 账本保留〔卡② R1〕＋al2 单源对拍（attunement_charges 24 停点逐位一致） | 种行真链 | 回退 loadout 种行 hunk→feat_vouchers 红→还原复绿（undo2） | 绿 |
| 触发器 wr1-wr9 | trigger_cond_test V1/V2/V4/V6/V7/V8/V9/V10（manifest 登记） | db.load_tables/spawn 真实表/编排器真链 | 回退 rollable_skills 过滤 hunk→V2 红→还原复绿（undo3） | 绿 |
测试削弱申报履行：主卡契约 9 零削弱；触发器卡申报①②③④已履行（skill_unlock_test 读值源换代语义保持／round_flow expect_pools 期望值随投放改写仍精确比对／:654 直调单参保留／V4 扩行只增不删）。
## 三、S13 读数与呈报（需用户裁决——见 §四）
三宿主改善达成：adventure_runner 类变量 42→23（-19）公开方法 23→14（≤20 零警告）；level_runner 38→28（卡目标约 30）；board_view 45→32（精确达标）。基线文件 `tools/gdstyle_baseline.txt` 零改动。
**存量红面（收口须用户特批，同 iter38 先例）**：
- NEW 5 条：curio_stop max-class-variables=16/max-public-methods=31/max-branches|_apply_curio_pick=10/max-returns=9、hero_ledger max-public-methods=29——新件公开面为卡片接口块定义的迁移语义面（原基线 adventure_runner 对 _apply_curio_pick 同函数登记同值 branches=10/returns=9，超标形态随迁移显现）。
- WORSENED 4 条：battle_orchestrator 类变量 50→51（+_hero 拆件必要成员）/文件长 1302→1315/begin_battle 函数长 141→142；level_map_screen 类变量 21→22（iter38 存量漏登记——本批零触碰该文件）。
- 建议案：经批准将上列 9 键按实测值 refresh 进基线（含 level_map_screen iter38 存量补登）。
**EV 锚预期红（触发器卡 T4-4 预设停机呈报）**：round_flow EV 抽样对锚 goblin 实测 0.9148 ∉ [1.00,1.20]——两示范投放=池权重数值改动（孤注守势 buff 技稀释伤害期望，方向合理）；钩爪恐魔同批投放。**重锚归用户档位发起，实现批不自行重锚**。
## 四、遗留读数义务与实机目检总清单
- 实机目检两项（登记不阻塞）：①上轮停手→下轮结算明细出现「趁隙偷袭」；②地精低血后摇出「孤注守势」。
- MC 对拍：本批触发器卡含池权重投放=数值改动——MC 锚重锚归用户发起（见 §三）。
- 主卡 MC 口径：行为零变化重构（bp1 六时点 292 停点逐位零漂移为凭），MC 未发起。
## 五、中间产物退役清单（批末执行）
game/tests/bp_baseline_dump.gd（bp1 载体）＋reports/iter39-素材/ 六份 JSON（对拍凭据，审计后随本报告退役）。
reports/iter39-素材/bp_baseline_after_T1.json
+188095
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_after_T2.json
+188095
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_after_T3.json
+188095
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_after_T4.json
+332959
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_after_T5.json
+332959
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_after_attune.json
+333463
View File
File diff suppressed because it is too large. Load diff
reports/iter39-素材/bp_baseline_before.json
+188095
View File
File diff suppressed because it is too large. Load diff
reports/iter39-验收审计-2026-10-27.md
+21
View File
@@ -0,0 +1,21 @@
# 迭代 39 独立验收审计报告（2026-10-27）
审计入口：独立子代理（未参与实现）；基线=merge-base 5699192af 三点 diff。依据 test-conventions §8。
## 一、对照表逐行核对——通过（附 1 缺漏已补＋2 例外）
抽查 8 行全数在案且真实入口无绕过：hr1（直构逐值+start_adventure 真链 :20-52）/hr1-s（商店购买真链 :54-69，正钉 wr1 改动点）/hr2（三通道+片段往返 :71-122）/sc3（_bind_shop 单点+_forward_ 零命中 :124-140）/〔拆件批 V2〕/〔V3〕承继断言/触发器 V1 七反例+V2 双面+V8 阈值式/P8 28 键断言。缺漏 1（V3 保底不逼断言未落码）已补（trigger_cond_test V3 段：special_skills 双态+SkillLottery 30 摇零逼出+撤销态红证）。例外：hr 系尾缀落 manifest 注记行（备案，反哺点 12）。
## 二、撤销证明抽查复现——通过
undo1 复现：基线绿→gain_bonus 行改 pass→hr1-s 恰红（断言钉在被撤改动上）→还原复绿，工作树 clean。undo2/undo3 记录面与码面对得上（抽查一条合规）。
## 三、测试削弱检查——通过
删 72 行 Kit 断言全部属改址（旧路径引用已删字段），逐条同判据替换；净增 1 行=round_flow V7 扩行（申报④兑现）；EV 锚区间零触碰（预期红非削绿）；申报③兑现；表迁移与申报逐字一致。残留 1（level_shop_economy:1035 RunLedger 注释）已清＋al4 零引用源码断言补落。申报外等价改写 1 处（skill_unlock 零扰动/确定性载体换蜘蛛首遇带——投放致地精池含 trigger 行，50f9caa7 已申报，判例外）。
## 四、S13 基线核查——通过
tools/ 全目录零改动（基线禁改契约兑现）；存量红 9 键走用户特批呈报（实现报告 §三）。
## 五、bp 基线对拍抽验——通过
before vs after_T5：292×27 键=7884 次逐值比对 mismatch 0；gain_journal 0/292→292/292 在档（契约 2 兑现）。before vs after_attune：attunement_charges 292/292 全等（单源对拍达成）；aux_items 24 处=申报例外（关卡完成停点留存同调行，代拍板 #6/反哺点呈报吻合）。
## 结论
**通过（附例外）**——合并前三件已全部处理（V3 断言补落/RunLedger 残留清＋al4 补/备案两行入反哺点 12-13）。收口待用户裁决三项：S13 特批（9 键 refresh）、EV 锚重锚（goblin/hook_horror 池权重投放）、08d 反哺落文（生涯.md:55 行号句）。
reports/需求卡片-冒险域拆件与账本实体化批-2026-10-26.md
+100 -58
View File
@@ -1,6 +1,6 @@
# 需求卡片：冒险域拆件与账本实体化批（AdventureRunner 真拆分·主卡）
- 版本：**v1.2**（v1.0→grilling 一轮「回炉」13 阻断全折入→v1.1→二轮「通过附残留 8 条」全折入→v1.2 定稿，复核记录见 §12）
- 版本：**v1.3**（v1.0→grilling 一轮「回炉」13 阻断全折入→v1.1→二轮「通过附残留 8 条」全折入→v1.2 定稿→v1.3 领域拆分修订，复核记录见 §12。v1.3＝2026-10-27 领域拆分修订——用户裁结构指标=缺陷，闸 09「标准是尺」口径下的还债实现，用户令本会话讨论后修订）
- 来源：[待办清单](../待办清单.md)「AdventureRunner 职责真拆分」条目（2026-10-25 登记，P0，状态=文档设计已闭合＋待写卡）（唯一事实源：[architecture](../design/engineering/architecture/architecture.md) v1.16 核心层 HeroLedger／CurioStop 新件行＋「冒险域拆分定稿」节）
- 归属：`game/core/` 新二件＋adventure_runner／level_runner／curio_deck／shop_session／run_ledger／battle_orchestrator 改造＋呈现接线面＋测量面改址
- 排期：未编入（迭代批卡片；估时 ≈5–5.5 个工作日；姊妹副卡另 ≈1.5–2）
@@ -32,7 +32,7 @@
| u9 | RunLedger 瘦身 | bonus 账/vision 账/adventure_counters 桶全部退役迁出（桶归宿主＋encounter `"adv_bucket"` 键）；attune_charges 账保留（副卡退役） |
**完成定义**：
1. u1–u9 落地；全套闸按本批改动域选档全绿；S13 计数读数改善（adventure_runner 类变量 42→约 20、level_runner 38→约 30、board_view 45→32——读数记录进实现报告，基线禁改）。
1. u1–u9 落地；全套闸按本批改动域选档全绿；S13 计数读数改善（adventure_runner 类变量 42→约 20、level_runner 38→约 30、board_view 45→32——读数记录进实现报告，基线禁改）。**v1.3 增**：拆分后新件逐件落 gdstyle 默认线内——HeroStats 公开方法 12／GpWallet 5／GainJournal 13／RefreshBank 13（类变量各 ≤7）、CurioStop 收口公开方法恰 20、adventure_runner 公开方法 ≤23 基线内；battle_orchestrator 指标精确回位＝类变量 50／begin_battle 函数长 ≤141／文件长恰 1314（闸 09 存量 FAIL 行「1314>1302」文本逐字保持，指纹 91d45583cf6d 不变）；hero_ledger.gd 删除、grep `HeroLedger|hero_ledger|\.hero()` 代码引用零残留（manifest 文件名与历史性注释除外）。
2. 同种子改前改后：断点快照 27 键逐键逐位一致（含日记键前形态）；冒烟/系统/单测/探针全绿。
3. 撤销证明逐 wr 行落地；三份产出物写齐（T6）；独立验收审计过。
@@ -109,14 +109,18 @@
| 文件 | 职责 | 行为改动 |
|---|---|---|
| `game/core/hero_ledger.gd`（**新增**） | 主角实体账：数值面＋获得日记三层＋gp 单写原语＋公式单点＋断点片段 | 新件（承载迁移态，行为不变）→ wr1/wr6 |
| `game/core/curio_stop.gd`（**新增**） | 三选一停点件：停点三态/刷新三源账/兑付族/凭证出箱/信号面/断点片段 | 新件（承载迁移态）→ wr2/wr3/wr6 |
| `game/core/adventure_runner.gd`（修改） | 薄应用层：删数值面/停点族/六转发信号族；建件接线；断点拼盘口；件出口 hero()/stop() | 结构改动，行为不变 → wr4/wr6 |
| `game/core/level_runner.gd`（修改） | 构造注入收参；8 白盒属性删；重绑机制删；战斗→关卡信号族保留；断点关卡域片段方法 | 结构改动 → wr5/wr6 |
| `game/core/hero_stats.gd`（**新增**，v1.3 拆分） | 主角数值账：生命与特性持有集＋永久强化快照＋类型轴＋生效公式单点＋回血封顶＋续玩生命钳制＋断点片段（hero_hp/relics 两键） | 新件（hero_ledger 领域拆分——行为不变）→ wr1/wr6 |
| `game/core/gp_wallet.gd`（**新增**，v1.3 拆分） | GP 钱包：gain/spend/clear 单写原语＋断点片段（gp 一键） | 新件（同上）→ wr1/wr6 |
| `game/core/gain_journal.gd`（**新增**，v1.3 拆分） | 加算日记：获得记录三层＋统一加算区三通道＋购买档数＋钥石＋真视＋断点片段（六键） | 新件（同上）→ wr1/wr6 |
| `game/core/hero_ledger.gd`（**删除**，v1.3 拆分） | 原主角实体账整件退役——按领域拆入上三件（grep 零残留） | 结构改动（行为不变）→ wr1/wr6 |
| `game/core/refresh_bank.gd`（**新增**，v1.3 拆分） | 刷新账件：X 基数与余量/Y 池/刷新券存量账/付费刷计数与报价公式/免费位消耗序＋断点片段（refresh_stock/attune_refresh_y 两键） | 新件（curio_stop 领域拆分——行为不变）→ wr2/wr6 |
| `game/core/curio_stop.gd`（**新增**） | 三选一停点件：停点三态/兑付族/谓词/凭证出箱/信号面/断点片段；刷新编排留件（查停点态→bank 支出→重抽重发）；deck 纯委托删除（调用方直连 CurioDeck） | 新件（承载迁移态）→ wr2/wr3/wr6 |
| `game/core/adventure_runner.gd`（修改） | 薄应用层：删数值面/停点族/六转发信号族；建件接线（stats/wallet/journal/bank 四引用）；断点拼盘口（三片段并集）；件出口 stats()/wallet()/journal()/deck()/refresh_bank()/stop() | 结构改动，行为不变 → wr4/wr6 |
| `game/core/level_runner.gd`（修改） | 构造注入收参（ctx 三键 stats/wallet/journal）；8 白盒属性删；重绑机制删；战斗→关卡信号族保留；断点关卡域片段方法 | 结构改动 → wr5/wr6 |
| `game/core/curio_deck.gd`（修改） | 纯池化：bind_handlers 删；consume_pool_purchase 改经注入 Callable | 结构改动 → wr3 |
| `game/core/shop_session.gd`（修改） | 账本引用换代（run_ledger→hero）；商店属性加算改经 hero 单写原语 | 结构改动，写通道语义不变 → wr1 |
| `game/core/shop_session.gd`（修改） | 账本引用换代（run_ledger→wallet+journal）；商店属性加算改经 journal 单写原语 | 结构改动，写通道语义不变 → wr1 |
| `game/core/run_ledger.gd`（修改） | 瘦身：bonus 账/vision 账/adventure_counters 桶全部退役迁出（桶归宿主字典＋encounter `"adv_bucket"` 键）；attune_charges 账＋其三原语保留 | 结构改动 → wr1 |
| `game/core/battle_orchestrator.gd`（修改） | encounter 注入面：＋`"hero"` 键；bonus_add_axis/vision_count_add 调用改指 hero；attune_charge_* 仍走 ledger 瘦壳 | 结构改动 → wr1 |
| `game/core/battle_orchestrator.gd`（修改） | encounter 注入面：＋`"journal"` 键（v1.3——原 `"hero"` 键随拆分换代）；bonus_add_axis/vision_count_add 调用改指 journal；attune_charge_* 仍走 ledger 瘦壳；结构指标回位（类变量 50/函数长/文件长——闸 09 口径） | 结构改动 → wr1 |
| `game/presentation/main_adventure_flow.gd`（修改） | 信号重连（level_started 重取点 is_connected 守卫）；控制器件注入换代；bonus 读面改指 hero（:37-38） | 结构改动 → wr4/wr1 |
| `game/presentation/views/level_map_screen.gd`（修改） | bonus 读面改指 hero（:334/335/343） | 结构改动 → wr1 |
| `game/presentation/hud_presenter.gd`（修改） | bonus 读面改指 hero（:20/313） | 结构改动 → wr1 |
@@ -134,73 +138,107 @@
### 接口块
**HeroLedger（`game/core/hero_ledger.gd`）**
**HeroStats（`game/core/hero_stats.gd`，v1.3 拆分——数值域）**
```gdscript
class_name HeroLedger extends RefCounted
func _init(db_ref: ConfigDb, base_override_ref: Dictionary) -> void # 锻造强化快照构造注入（原 _base_override 迁入）
class_name HeroStats extends RefCounted
func _init(db_ref: ConfigDb, base_override_ref: Dictionary) -> void # 锻造强化快照构造注入
func set_debug_override(atk_pct: int, hp_pct: int) -> void # 调试百分比通道（adventure.set_hero_override 转发件内）
# ---- 数值面（自 adventure_runner 迁入，语义逐字不变）----
var hero_hp: int # 生命账（原 ledger["hero_hp"] 单值化——共享字典退役）
var gp: int # GP 钱包（原 ledger["gp"]——LevelRunner.gp 属性与 ShopSession 钱包读写全改指此单点）
func gain_gp(amount: int) -> void # gp 单写原语（clamp ≥0）
func spend_gp(amount: int) -> bool # gp 单写原语（不足 false 零副作用）
func clear_wallet() -> void # 收束清零
func reset_for_single_level() -> void # 单关模式重开重置（值重置非实例重建——shop 绑 hero 对象引用不换代，重绑因此消失；语义=现 start_level :151-164 重置面）
func effective_max_hp() -> int # 公式单点（与现 :305-307 逐字同式：表值+base_override+汇总，后乘本件 pct）
func effective_atk() -> int # 公式单点（与现 level :101-103 同式，迁入）
func effective_ac() -> int # 同上（level :114-115）
static func rest_heal(pct: int, hp: int, max_hp: int) -> int # 回血公式单点（自 LevelRunner.rest_heal 迁入）
# ---- 获得日记三层 ----
func record_gain(source_class: String, kind: String, detail: Dictionary) -> int # 获得记录列表追加，返回记录 id
func gain_bonus(axis: String, value: int, source_class: String, kind: String) -> void # 明细＋汇总同步维护（三通道统一入口；战末通道 source_class="battle_export"、kind=轴名——battle :1125-1127 按轴逐条调）
func bonus_total(axis: String) -> int # 汇总读面
func record_purchase(product_id: String) -> void # 购买条目（定价读数走 purchase_tier）
func purchase_tier(product_id: String) -> int
func record_keystone_drop(drop: Dictionary) -> void # 本局增量（keystone 更名 keystone_gained 语义）＋逐杀明细
func keystone_gained() -> int
func record_vision_use() -> void; func vision_used() -> int
var feats: Array[String] # 特性持有集（活引用注入——G12 语义）
func clamp_hp_to_resume_cap(db_max_hp: int) -> void # 续玩生命钳制（原 _resume_params mini 式逐字收进——上限=表值+永久强化 flat 后乘调试 pct）
func rebase_override(raw: Dictionary) -> void
func reset_for_single_level() -> void # 单关重开：override 清零＋本域账面重置（钱包/日记清零各归各件）
func reset_adventure_accounts() -> void # 生命置满生效上限＋特性持有集清零
func effective_max_hp() -> int; func effective_atk() -> int; func effective_ac() -> int # 公式单点
static func rest_heal(pct: int, hp: int, max_hp: int) -> int # 回血公式单点
var hero_hp: int # 生命账
var feats: Array[String] # 特性持有集（活引用注入）
func feats_held() -> Array
# ---- 断点片段 ----
func breakpoint_fragment() -> Dictionary # hero_hp/bonus(汇总快照)/获得日记键/purchased/keystone 相关/relics/vision_counter_used
func restore_fragment(frag: Dictionary, params: Dictionary) -> void # 日记缺键→汇总直载跳过比对；在档→推导比对不符 push_error+拒载
var attack_type := ""; var armor_type := "" # 两根类型轴快照
func breakpoint_fragment() -> Dictionary # hero_hp/relics 两键
func restore_fragment(frag: Dictionary, params: Dictionary) -> void
```
**CurioStop（`game/core/curio_stop.gd`）**
**GpWallet（`game/core/gp_wallet.gd`，v1.3 拆分——钱包域）**
```gdscript
class_name GpWallet extends RefCounted
var gp: int
func gain_gp(amount: int) -> void; func spend_gp(amount: int) -> bool; func clear_wallet() -> void
func breakpoint_fragment() -> Dictionary # gp 一键
func restore_fragment(frag: Dictionary, params: Dictionary) -> void
```
**GainJournal（`game/core/gain_journal.gd`，v1.3 拆分——加算日记域）**
```gdscript
class_name GainJournal extends RefCounted
const BONUS_AXES: Array[String] = ["atk", "max_hp", "armor_class", "ap"]
func gain_bonus(axis: String, value: int, source_class: String, kind: String) -> void # 三通道统一入口（明细＋汇总同拍）
func bonus_total(axis: String) -> int; func bonus_snapshot() -> Dictionary
func record_purchase(product_id: String) -> void; func purchase_tier(product_id: String) -> int
func record_keystone_drop(drop: Dictionary) -> void; func keystone_gained() -> int; func keystone_drop_log() -> Array
func record_vision_use() -> void; func vision_used() -> int
func reset_adventure_accounts() -> void # 日记域账面清零（汇总/明细/记录/已购档/钥石/真视）
func breakpoint_fragment() -> Dictionary # bonus/shop_purchased/keystone/keystone_drops/vision_counter_used/gain_journal 六键
func restore_fragment(frag: Dictionary, params: Dictionary) -> void # 缺日记→汇总直载 clamp；在档→明细推导比对不符 push_error 拒载
```
**RefreshBank（`game/core/refresh_bank.gd`，v1.3 拆分——刷新账域，零停点态依赖）**
```gdscript
class_name RefreshBank extends RefCounted
func _init(db_ref: ConfigDb) -> void
func set_refresh_x_cap(total: int) -> void # X 基数注入（装配集 bonus_refresh magnitude 合计——宿主 start/resume 时点）
func set_refresh_y(v: int) -> void; func refresh_y() -> int # Y 冒险周期池
func add_refresh_stock(n: int) -> void; func refresh_stock() -> int # 刷新券存量账（冒险级）
func free_left() -> int # 合计读面（X+Y+存量——原 attune_refresh_left 迁入）
func spend_free() -> bool # 免费位消耗（X→Y→存量序逐字；全空 false 零副作用）
func charge_paid() -> void; func gp_cost() -> int # 付费刷计数递增／报价公式（ceil 基价×曲线^已付费刷——原式迁入）
func reset_x() -> void # X 每碰三选一重置回基数（不结转）
func reset_paid() -> void # 付费刷计数随停点清零（对齐商店进店清零）
func breakpoint_fragment() -> Dictionary # refresh_stock/attune_refresh_y 两键
func restore_fragment(frag: Dictionary, params: Dictionary) -> void # Y 缺键回退参数面（params_fallback 逐字）
```
**CurioStop（`game/core/curio_stop.gd`，v1.3 收口后保留面）**
```gdscript
class_name CurioStop extends RefCounted # 生命周期＝每冒险一次（AdventureRunner 冒险开始建；关卡换实例不换件）
signal curio_choice_presented(payload: Dictionary) # 自 adventure_runner 迁入，载荷逐字不变
signal curio_choice_presented(payload: Dictionary) # 载荷逐字不变
signal curio_resolved(result: Dictionary)
func _init(db_ref: ConfigDb, deck_ref: CurioDeck, hero_ref: HeroLedger, snapshot_call: Callable) -> void
func rebind_level_runner(runner: LevelRunner) -> void # 每关注入时点＝AdventureRunner._start_current_level 建件接线处：存当前关卡对象的 grant_curio_gp 方法 Callable（GP 件入账维持现路径与 wallet_changed 发射序——第二关起绑新 runner，防调死对象）
# ---- 五组入口 ----
func open_level_clear(payload_base: Dictionary) -> void # 收编 _on_level_finished 停点段：抽签(level_clear)/置在途态/发信号/触发落盘回调
func present_node_curio(candidates: Array) -> void
func _init(db_ref: ConfigDb, deps: Dictionary, snapshot_call: Callable) -> void
# deps = {deck:CurioDeck, stats:HeroStats, journal:GainJournal, bank:RefreshBank}——构造注入一次给齐
func rebind_level_runner(runner: LevelRunner, level_index: int) -> void # 每关注入时点（GP 件入账回调换代）
# ---- 停点编排保留面（公开方法恰 20——gdstyle 默认线）----
func open_level_clear(payload_base: Dictionary) -> void
func present_node_curio(candidates: Array) -> void; func node_curio_candidates() -> Dictionary
func pick_curio(kind: String, tier: String = "", feat_id: String = "") -> bool
func apply_node_curio(kind: String, tier: String = "", feat_id: String = "") -> bool
func skip_empty_curio() -> bool
func refresh_curio() -> bool; func refresh_curio_paid() -> bool
func curio_refresh_gp_cost() -> int; func attune_refresh_left() -> int; func refresh_stock() -> int
func curio_stop_pending() -> bool # 名继承现役 :584 谓词
func stop_resolved() -> bool # 放行谓词（已兑付待推进且无在途停点）
func node_curio_pending_state() -> Dictionary
func skip_empty_curio() -> bool; func node_curio_pending_state() -> Dictionary
func refresh_curio() -> bool; func refresh_curio_paid() -> bool # 编排=查停点态→bank 支出→重抽重发
func curio_stop_pending() -> bool; func stop_resolved() -> bool
func consume_pool_purchase(kind: String, tier: String) -> bool
func reset_adventure_state() -> void
func restore_pending(bp_pending: Dictionary) -> void
func restore_resolved(payload: Dictionary) -> void # v1.3 合并 reemit——置态后重发（resume 只重发不重兑付）
func clear_resolved() -> void
func voucher_outbox() -> Dictionary # 凭证出箱 {rap:int, time_sand:int}——战首取走清零
func draw_candidates(channel: String) -> Array # 经 deck（reward_pick 流不变）
# ---- 断点片段 ----
func breakpoint_fragment() -> Dictionary # bonus_pending/bonus_result/feat_ticket_*/refresh_stock/attune_refresh_y（读侧 params 回退经参传入）
func breakpoint_fragment() -> Dictionary # bonus_pending/bonus_result/feat_ticket_*
func restore_fragment(frag: Dictionary, params: Dictionary) -> void
# v1.3 删除：feat_ticket_consider/curio_cap_ok/pool_stock（deck 纯委托——调用方直连 CurioDeck）、
# pool_stock_snapshot/draw_candidates（同上）、resolved_payload（零消费死面）、reemit_resolved（并入 restore_resolved）、
# 刷新族七方法（set_refresh_x_cap/set_refresh_y/refresh_y/add_refresh_stock/refresh_stock/attune_refresh_left/curio_refresh_gp_cost→RefreshBank）
```
**adventure_runner 应用层（保留/新增面）**
```gdscript
func _init(db_ref: ConfigDb, rng_ref: RngServiceCore, save_manager_ref = null) -> void # 存档承载改构造注入（缺省 null＝断点静默，原语义）
func hero() -> HeroLedger # 件出口（组件交出，非委托壳）
func stats() -> HeroStats; func wallet() -> GpWallet; func journal() -> GainJournal # 件出口（v1.3——hero() 随三件拆分换代）
func deck() -> CurioDeck; func refresh_bank() -> RefreshBank # 件出口（v1.3——停点件 deck 纯委托删除后调用方直连面）
func stop() -> CurioStop
# 保留：start_adventure/resume_adventure/continue_to_next_level/abandon/state/summary/runner()/set_hero_override
# 删除：数值面方法族/停点族方法/六转发信号与 _forward_*/_bp_parts 五连挖（改收片段）
# 删除：数值面方法族/停点族方法/六转发信号与 _forward_*/_bp_parts 五连挖（改收片段）/hero()
# BREAKPOINT_FIELDS 常量保留本件＝键序契约（拼盘口按此断言完整性）
```
@@ -208,13 +246,15 @@ func stop() -> CurioStop
```gdscript
func _init(db_ref: ConfigDb, rng_ref: RngServiceCore, ctx: Dictionary) -> void
# ctx 键（一次给齐，后置 setter 群删除——grilling 一轮补全 12 键）：
# hero:HeroLedger／ledger:RunLedger（瘦壳——本卡仅传，副卡删）／
# attunement:Array／tree_rules:Array／shop_mode:String／treasure_unlocked:Dictionary／
# ctx 键（一次给齐，后置 setter 群删除——grilling 一轮补全 12 键；v1.3 hero 键换代三键）：
# stats:HeroStats／wallet:GpWallet／journal:GainJournal（共享主角账三件——活引用）／loadout:AttuneLoadout（同调配装件）／
# adv_bucket:Dictionary（冒险桶宿主字典）／attunement:Array／tree_rules:Array／shop_mode:String／treasure_unlocked:Dictionary／
# hero_attack_type:String／hero_armor_type:String／voucher_rap:int／voucher_time_sand:int／
# pool_wiring:Dictionary（池模式装配 4 参收编：{deck:Array, consume:Callable, ticket:Callable, cap:Callable}——缺省空字典=legacy 零注入）
# start_level（单关测试模式）件内自建私有 HeroLedger（_init 即建、空 override 注入——shop 绑定因此仍仅构造一次；start_level 收 base_override_in 经 hero 重注＋reset_for_single_level() 值重置，实例不重建）
# 新增：func hero() -> HeroLedger # 只读出口（bonus 生产读面 5 文件经现 run_ledger 访问链改此承接）
# start_level（单关测试模式）件内自建私有三件（_init 即建、空 override 注入——shop 绑定因此仍仅构造一次；
# start_level 收 base_override_in 经 stats 重注＋三件各归各件清零，实例不重建）
# 新增：func stats() -> HeroStats # 只读出口（v1.3——hero() 换代；bonus 生产读面经 journal() 承接）
# func journal() -> GainJournal
# start_level_external 收参收窄为 (level_index:int, defer_entry:bool, resume_state:Dictionary)
# 新增：func breakpoint_fragment() -> Dictionary # 关卡域五键（node_id/visited_ids/aux_items/shop_shelf/shop_visit_buys）
# func restore_fragment(resume_state: Dictionary) -> void # 断点重建参数面收口（原 _resume_bp 直读面收编）
@@ -327,6 +367,8 @@ func _init(db_ref: ConfigDb, rng_ref: RngServiceCore, ctx: Dictionary) -> void
**二轮闭合复检（2026-10-26，同一独立子代理）**：判「通过（附残留 8 条，无新阻断）」——13 阻断逐条核闭合（含三处点名矛盾检查：桶迁移与契约 8 一致、rebind 时点先于该关全部信号发射无冲突、副卡键值校验与零行为变化自洽）。残留 8 条已折入 v1.2：R1 数字统一（u8/契约 9/wr7/§6 四处 47→49＋B 类 68→78）；R2 B 类补 run_ledger 账本断言族（约 10 处/3 文件改指）；R3 bonus 读面经 LevelRunner `hero()` 只读出口承接写明；R4 单关模式 `_init` 即建私有 hero（空 override）＋start_level 经 reset 重注——绑定仍仅构造一次；R5 结构图 run_ledger 行同步桶退役＋battle 直构空字典兜底；R6/R7/R8 归副卡折入。估时分项和 5.35d 对齐。
**领域拆分修订动因（2026-10-27，v1.3——用户令本会话讨论后修订）**：实现批收口呈报的结构指标超标（hero_ledger 公开方法 29、curio_stop 公开方法 34/类变量 18/_apply_curio_pick 分支 10 返回 9——五条 NEW；宿主 battle_orchestrator 类变量/函数长/文件长三条恶化）经用户裁「结构指标=缺陷、按领域切分」定案为还债实现，随本卡迭代收口批执行：①hero_ledger 按领域拆三件（HeroStats 数值与公式／GpWallet 钱包／GainJournal 加算日记——断点片段三件各交各账、应用层并集拼装，28 键对拍基线逐位一致为硬验收）；②curio_stop 拆出 RefreshBank 刷新账件（停点态零依赖）＋删五条 deck 纯委托（调用方经 adventure.deck() 直连）＋resolved_payload 死面删除＋reemit_resolved 并入 restore_resolved；③battle_orchestrator 指标精确回位（类变量 50、begin_battle ≤141、文件长恰 1314——闸 09「标准是尺」存量红两行的行文本与指纹逐字保持，多一行少一行都改指纹）。行为零变化契约不变；机检口径仍按 §13——禁为计数保留无效成员，本修订的全部公开面收敛都来自真实调用面。
## 13. 禁为机检文本保留无效成员（重构类必填条款）
禁止为迎合机检消息文本（含计数）而保留或新增无效成员/别名；本批撤除的 25 条转发属性即该债务的清偿——不得以「基线计数」「探针便利」等理由保留任何一条或新增同种转发；机检键与卡片契约互斥时实现段一律停卡呈报，不得自造第三条路（code-conventions §1.1 同款）。
reports/需求卡片-同调配装充能域封装批-2026-10-26.md
+6 -4
View File
@@ -1,6 +1,6 @@
# 需求卡片：同调配装充能域封装批（AdventureRunner 真拆分·副卡）
- 版本：**v1.2**（v1.0→grilling 一轮「回炉」5 阻断全折入→v1.1→二轮「通过附残留」R6/R7/R8 折入→v1.2 定稿，复核记录见 §12）
- 版本：**v1.3**（v1.0→grilling 一轮「回炉」5 阻断全折入→v1.1→二轮「通过附残留」R6/R7/R8 折入→v1.2 定稿→v1.3 领域拆分修订，复核记录见 §12。v1.3＝2026-10-27 领域拆分修订——用户裁结构指标=缺陷，闸 09「标准是尺」口径下的还债实现，用户令本会话讨论后修订）
- 来源：[待办清单](../待办清单.md)「AdventureRunner 职责真拆分」条目（2026-10-25 登记，P0，状态=文档设计已闭合＋待写卡）（唯一事实源：[architecture](../design/engineering/architecture/architecture.md) v1.16 AttuneLoadout 新件行＋「冒险域拆分定稿」节充能单源化句）
- 归属：`game/core/` 新一件（attune_loadout）＋run_ledger 整类退役＋battle_orchestrator 使用/重置路径＋断点旧档迁移
- 排期：未编入（迭代批卡片；估时 ≈1.5–2 个工作日）
@@ -10,7 +10,7 @@
## 0. 前置依赖与并行性
- **第〇步核对（2026-10-26 写卡会话）**：来源条目＝设计线条目（同主卡），闭合凭据＝architecture v1.16，放行。
- **前置卡接口取用**：主卡 T1 产出的 HeroLedger 与 encounter `"hero"` 键、T3 产出的 ctx 注入面与「关卡开始信号前零发射」头注契约、T4 产出的片段三接口形态——本卡在同形接口上扩展充能域。
- **前置卡接口取用**：主卡 T1 产出的主角账件（v1.3 拆分后＝HeroStats/GpWallet/GainJournal 三件）与 encounter `"journal"` 键、T3 产出的 ctx 注入面与「关卡开始信号前零发射」头注契约、T4 产出的片段三接口形态——本卡在同形接口上扩展充能域。
- 并行冲突：与主卡串行（硬前置）；与「通关口径换代批」（在册 v1.1）真实交叠＝**adventure_runner＋level_runner 两文件**（该批 C 注释面 adventure_runner 14 处／level_runner 3 处——本卡改其建件接线与 ctx；该批六件清单无 battle_orchestrator）——先后做者 T0 行号复核吸收；其余在册卡零交叠。
## 1. 目标与完成定义
@@ -122,9 +122,9 @@ func restore_fragment(frag: Dictionary, inventory: TreasureItems) -> void # 旧
**battle_orchestrator 改指**：`begin_battle` encounter 删 `"ledger"` 键——桶挂链走主卡已建的 `"adv_bucket"` 键（:382 改指已完成于主卡 T1，本卡零动作）、`"hero"` 键沿用；encounter 增 `"loadout": AttuneLoadout` 键；`_reseed_attune_charges(reset)` 改调 `loadout.reset_cycle(reset, treasure_inventory)`（:228-246 语义逐字承）；使用点 `:757` 改 `loadout.consume_charge(...)`；`:239` 充能设定改种行路径；`:381` ledger 类型检查与 `RunLedger.new()` 兜底删除。
**测试直构面改址（grilling 一轮补查）**：treasure_effects_test:275、round_flow_skill_pool_test:969/994（`load("res://core/run_ledger.gd").new()` 直构＋encounter "ledger" 注入）→ 改直构 HeroLedger＋"hero"/"adv_bucket" 键注入；meta_progression_forge_test:290-291 同款；effect_engine.gd:94／effect_context.gd:3 注释中 RunLedger 表述随批清（注释面，非行为）。
**测试直构面改址（grilling 一轮补查）**：treasure_effects_test:275、round_flow_skill_pool_test:969/994（`load("res://core/run_ledger.gd").new()` 直构＋encounter "ledger" 注入）→ 改直构主角账件＋`"journal"`/`"adv_bucket"` 键注入（v1.3——原 `"hero"` 键随主角账三件拆分换代）；meta_progression_forge_test:290-291 同款；effect_engine.gd:94／effect_context.gd:3 注释中 RunLedger 表述随批清（注释面，非行为）。
**主卡接口取用**：HeroLedger（无充能交互）、ctx 注入面（本卡扩两键）、片段三接口形态（本卡同形扩展）。
**主卡接口取用**：主角账件（v1.3 拆分后＝HeroStats/GpWallet/GainJournal 三件——充能交互零涉及）、ctx 注入面（本卡扩两键）、片段三接口形态（本卡同形扩展）。
### 落位与可复用性预检
@@ -202,6 +202,8 @@ func restore_fragment(frag: Dictionary, inventory: TreasureItems) -> void # 旧
**二轮闭合复检（2026-10-26，同一独立子代理）**：判「通过（附残留，无新阻断）」——5 阻断全核闭合、「键值仅校验读数与零行为变化」边界判自洽。残留 R6/R7/R8 已折入 v1.2：R6 契约 2 旧句（两读法兜底）删、wr1 列改单源对拍、§1 目标句旧措辞（同调行迁移）改「旧档读侧以行集为源」；R7 结构图补 feat_vouchers_test 充能直写 8 处改指行；R8 并行注记事实订正（通关批 C 面六件无 battle_orchestrator，真实交叠＝adventure_runner＋level_runner）。
**领域拆分修订动因（2026-10-27，v1.3——用户令本会话讨论后修订）**：主卡 v1.3 领域拆分（用户裁「结构指标=缺陷」还债实现）把主角账 HeroLedger 拆为 HeroStats/GpWallet/GainJournal 三件、battle encounter `"hero"` 键换代 `"journal"`——本卡对主卡产物的取用面（前置卡接口取用句、测试直构改址行、接口取用行）随换代同步改写；本卡自身范围（AttuneLoadout 建件、RunLedger 退役、使用管线逐位不变）零改动。
## 13. 禁为机检文本保留无效成员（重构类必填条款）
同主卡：禁止为迎合机检消息文本保留或新增无效成员/别名；RunLedger 的删除不得以任何「基线便利」理由拖延或保留空壳；机检键与契约互斥时停卡呈报（code-conventions §1.1 同款）。