设计闭合(零豁免五键+补件批): architecture v1.25落文——S13三条豁免注销(main/battle_orchestrator/tune_sim),七新件登记行(ui_registry/board_hover/RoundCycle/BattleFacts/cell两层域件/standee两件/breakpoint_store),轴丁两件设计闭合,attune改判,gdstyle inner-class计数截断缺陷登记;用户再裁恢复D2/D4拆件并按D5留债写入尾波条目(批末豁免登记步骤不执行);新卡《gdstyle尾波补件批》v1.0(零待裁点,估时2.5-3.5天,待iter42合回编入);待办清单新增补件批与零豁免五键两条目;roadmap迭代42状态按用户口述订正为进行中
This commit is contained in:
DKChan committed
1 parent
ee4efad54e
commit
183f4da3a4
4 files changed
+171
-11
No files matched your search
@@ -2,8 +2,8 @@
|
||||
|
||||
## 文档状态
|
||||
|
||||
- 版本：1.24
|
||||
- 最近更新：2026-10-29（尾波清偿批设计闭合落文——「战斗编排域拆件定稿」节增补轴丙 BoardInstaller（`core/board_installer.gd`，实现批建件）：装板域六函数迁出、宿主复位留薄壳、BoardGenerator 实例随件；battle_orchestrator 行 B1 域文件集句两新件→三新件随动；迭代 41 反哺注记转正文现状，沿革查 git）
|
||||
- 版本：1.25
|
||||
- 最近更新：2026-10-29（零豁免五键清偿设计闭合落文——S13 三条豁免登记注销〔main 组合根／battle_orchestrator 类变量／tune_sim 测量面〕；五案设计闭合、实现批建件：ui_registry 界面注册面、RoundCycle＋BattleFacts、CellUnit 两绘制域件、StandeeBody 两状态件、tune_sim 信号步进状态机；gdstyle inner-class 计数截断缺陷登记；沿革查 git）
|
||||
- 引擎：Godot 4.7.2-stable（GDScript 单语言；2026-09-07 锁定）
|
||||
- 评审模式：solo（`review-mode.txt`，2026-09-12 用户拍板——TD/LP 门禁按 solo 跳过，用户授权架构产出自主推进、迭代期回调）
|
||||
- 覆盖 GDD：现行全集（根索引＝`design/gdd/02-系统清单.md`，文档树构成以根索引为准）
|
||||
@@ -106,20 +106,23 @@
|
||||
| **reward_economy**（B4） | 格面资源身份映射（install 期预分配、Ready 只读、换图映射消亡）、极性路由字典面（（类型, 极性）→ 字典行查询；路由执行归 B1 授予段）、F6 当量供给投影 | 封闭 API：roll_board / query_identity / query_full_snapshot / grant / grant_clear / retire_mapping / polarity_row / phase / weighted_pick；另有 is_mapped 静默布尔投影（批量工具用） | ConfigDB（RewardTable）；BattleFxHost 经注入 Callable `luck_bias_query` 取偏运合计（reward_roll 发射与 bias_rewards 求和移至效果层完成）；reward_roll 流（scope = 每次 install 批） | 无 |
|
||||
| **helper_items**（A5，切片已实装秘宝域） | HelperItemTable、探测显影语义 | （契约规范源：`../../gdd/systems/跨局循环/秘宝.md`——桥接位：A2 查询接口 + A4 counter_item_ids） | A2 / A4 / B4 | 无 |
|
||||
| **CurioDeck**（`core/curio_deck.gd`，A5 秘宝域令牌池件，迭代 37 自 AdventureRunner 拆出） | 三选一/商店共享池的持久多重集、抽签（候选抽取）、cap 库存与专长凭证三计数与判定唯一所有者——件只管池与判定，停点编排与兑付推进留冒险编排器 | `draw_candidates(channel)` 抽签；`consume_deck_token` / `consume_pool_purchase` 池消耗；`cap_ok` 上限判定；`feat_ticket_consider` 凭证判定；`stock_snapshot` / `pool_stock` 只读投影；商店购买消费经注入 Callable 链至 CurioStop 兑付单点（迭代 39 起转纯池——bind_handlers 反向回调已退役） | ConfigDB（秘宝令牌行集）；注入 RngServiceCore（reward_pick 封闭流，禁自建随机） | 无（RefCounted 纯逻辑） |
|
||||
| **ShopSession**（`core/shop_session.gd`，商店会话件，迭代 37 自 LevelRunner 拆出） | 关卡商店双模式（legacy 固定三件加定价／pool 共享令牌池）的货架、定价、购买与刷新唯一宿主——账本/钱包/装配集归宿主 LevelRunner（共享引用经 `bind` 注入，出账直接落同一引用改写宿主账本）；legacy 模式零 RNG 零池消费（off 对照承载） | 货架与定价只读面（`shop_products` / `shop_shelf` / `current_price` / `shop_refresh_cost`）＋写入口（`buy_product` / `buy_pool_item` / `shop_refresh` / `player_request_refresh` / `open_pool`）；外部调用面由 LevelRunner 同签名委托承载（外部零变化） | ConfigDB（商店行集）；注入 RngServiceCore；宿主钱包/账本引用；pool 模式令牌消耗与判定经注入 Callable 转 CurioDeck | 无 |
|
||||
| **ShopSession**（`core/shop_session.gd`，商店会话件，迭代 37 自 LevelRunner 拆出） | 关卡商店双模式（legacy 固定三件加定价／pool 共享令牌池）的货架、定价、购买与刷新唯一宿主——账本/钱包/装配集归宿主 LevelRunner（共享引用经 `bind` 注入，出账直接落同一引用改写宿主账本）；legacy 模式零 RNG 零池消费（off 对照承载） | 货架与定价只读面（`shop_products` / `shop_shelf` / `current_price` / `shop_refresh_cost`）＋写入口（`buy_product` / `buy_pool_item` / `shop_refresh` / `player_request_refresh` / `open_pool`）；外部调用面 2026-10-29 D3 裁改直连（LevelRunner 同签名委托壳删除——并排卡「level_runner 商店委托层拆除」迭代 42 承接，调用方改址） | ConfigDB（商店行集）；注入 RngServiceCore；宿主钱包/账本引用；pool 模式令牌消耗与判定经注入 Callable 转 CurioDeck | 无 |
|
||||
| **HeroLedger**（`core/hero_ledger.gd`，冒险域主角实体账，已实装（2026-10-27 迭代 39 拆件批）） | 冒险生命周期主角数值与获得记录唯一所有者：生命与 GP 钱包（gain/spend/clear 单写原语，钱包事件发射点归件）、锻造强化快照、调试百分比、攻击/甲类型轴快照、特性持有集（活引用注入——关内兑付当关生效）、本局钥石增量与逐杀明细、真视使用记录；获得记录三层结构＝获得记录列表（三选一件/商店购买/战末奖励各一条）→属性增益明细（带来源指回）→四轴汇总（由明细推导）；生效上限与回血封顶公式单点归件 | 构造注入；单写原语族＋只读投影；断点自交片段（账本键＋获得日记键） | ConfigDB（表值读取）；由 AdventureRunner 冒险开始创建、注入 CurioStop／level_runner／ShopSession／战斗 encounter | 无（RefCounted 纯逻辑） |
|
||||
| **AttuneLoadout**（`core/attune_loadout.gd`，同调配装件，已实装（2026-10-27 迭代 39 拆件批）） | 装备中的秘宝件对象集唯一所有者（每件内含充能单位与重置周期）；同调充能的物化行为唯一事实源——种行/补行改写时同步（RunLedger 充能字典轨与差额对账函数退役）；旧档 aux_items 同调行迁移归件 | 构造注入；充能查询/消耗/按周期重置原语；断点自交片段（attunement_charges 键，键名与策略不变） | ConfigDB（秘宝行集）；TreasureItems（同调行投放面）；注入战斗使用路径 | 无 |
|
||||
| **CurioStop**（`core/curio_stop.gd`，三选一停点件，已实装（2026-10-27 迭代 39 拆件批）） | 三选一停点编排唯一所有者（架构原则 9 本域承载）：停点三态（关卡完成三选一在途/已兑付待推进/奖励节点三选一在途）、刷新三源账（刷新件 X/营地池 Y/刷新券存量/付费刷新计数）、兑付方法族（pick/refresh/redeem/skip）、凭证出箱（RAP/时沙待注入）；三选一信号面自带；零自动推进停点语义承载 | 对外＝开停点/刷新/兑付/放行谓词/交断点片段五组入口＋信号面（curio_choice_presented/curio_resolved）；由 AdventureRunner 关卡完成受理时调用 | ConfigDB；注入 CurioDeck（抽签/摘牌）与 HeroLedger（落账）；随机只经 CurioDeck 的 reward_pick 封闭流 | 无 |
|
||||
| **breakpoint_store**（`core/breakpoint_store.gd`，冒险域·断点组装与回放件，2026-10-29 零豁免裁设计闭合——实现批建件） | 存档断点组装与回放唯一承载（自 adventure_runner 收编 6 成员＋函数族）：断点快照拼盘、回放回填、读侧策略分发；`BREAKPOINT_FIELDS` 27 键登记单源随件（键名/策略标签/键序冻结） | 构造＝引用束注入；`resume_adventure` 留宿主薄壳；断点键面零变化 | adventure_runner（宿主）；注入主角账三件与 curio/stop/bank/loadout 引用 | 无（RefCounted 纯逻辑） |
|
||||
|
||||
### 功能层
|
||||
|
||||
| 模块 | 独占职责 | 对外暴露 | 消费依赖 | 引擎 API |
|
||||
|---|---|---|---|---|
|
||||
| **battle_orchestrator**（B1） | 段序骨架（七段结构冻结）、轮 facts 缓冲、可回放步骤流、[明细行协议](../../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)（基础行型＋扩展行两层 + 字段分层，词表以 owner「明细流水」节为准）、条款③⑤闭合对账、**战斗域全部跨系统调用权**、效果引擎宿主面与树规则挂点施加面（**已拆出 BattleFxHost 并实装（2026-10-28 迭代 40——battle_fx_host.gd／reward_grant.gd 两件在库，效果引擎宿主面归 BattleFxHost 行承载，拆件细则见「战斗编排域拆件定稿」节）**） | `begin_battle(encounter)`；窗口/刷新意图提交面（扮演 D1）；`level_clear()`；步骤流（输出契约） | B2/B3/B4 全调用面（**唯一调用方＝B1 域文件集：battle_orchestrator.gd ＋ settlement/ 五段段类 ＋ damage_controller ＋ 拆件后三新件**）；A3 request_refresh 代理 + 回发；A2 install/retire + 三事件订阅；A1 generate（attempt 非 scope 事件）；D2 SettlementTable + set_reload_gate | 无（零随机、禁 await——切片 88 冒烟实证可回放） |
|
||||
| **battle_orchestrator**（B1） | 段序骨架（七段结构冻结）、轮 facts 缓冲、可回放步骤流、[明细行协议](../../gdd/systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)（基础行型＋扩展行两层 + 字段分层，词表以 owner「明细流水」节为准）、条款③⑤闭合对账、**战斗域全部跨系统调用权**、效果引擎宿主面与树规则挂点施加面（**已拆出 BattleFxHost 并实装（2026-10-28 迭代 40——battle_fx_host.gd／reward_grant.gd 两件在库，效果引擎宿主面归 BattleFxHost 行承载，拆件细则见「战斗编排域拆件定稿」节）；2026-10-29 零豁免裁设计闭合：RoundCycle/BattleFacts 两新件随批（宿主 38→15、S13 豁免第三条注销——见下两行与定稿节轴丁）**） | `begin_battle(encounter)`；窗口/刷新意图提交面（扮演 D1）；`level_clear()`；步骤流（输出契约） | B2/B3/B4 全调用面（**唯一调用方＝B1 域文件集：battle_orchestrator.gd ＋ settlement/ 五段段类 ＋ damage_controller ＋ 拆件后三新件**）；A3 request_refresh 代理 + 回发；A2 install/retire + 三事件订阅；A1 generate（attempt 非 scope 事件）；D2 SettlementTable + set_reload_gate | 无（零随机、禁 await——切片 88 冒烟实证可回放） |
|
||||
| **BattleFxHost**（`core/battle_fx_host.gd`，B1 域·效果引擎宿主件，2026-10-26 编排域拆件设计定稿——实现批建件） | 效果引擎挂点施加面唯一承载（自 battle_orchestrator 收编 fx 族）：事件发射与事实判定（_fx_emit/_fx_fact）、主角 AC 基线与本轮/本战 AC 累积、bonus_delta 四轴累积（战末宿主 drain 汇入账本）、揭示待兑队列与兑付（含 _fx_revealing 再入闸——同步信号回环防二次缓冲二次兑付）、树规则合成订阅的 round/battle 桶计数器持有（桶随编排器生灭语义不变） | 构造＝引用束注入（防 _init max-parameters 新键）；bind 时注入 emit Callable（行发射经宿主协议面单点）与兑付 Callable（RewardGrant 授予面——揭示队列 flush 回调）；只读投影分两类消费方：AC 累积/bonus_delta 供宿主呈现快照与战末 drain，揭示态供宿主 A2 订阅旁路判定；`luck_bias_for(cell_count) -> int` 偏运合计查询口（体内三参形 dispatch——reward_roll 发射与 bias_rewards 求和自 RewardEconomy 收回本件，RewardEconomy 经注入 Callable 消费） | EffectEngine（EffectContext 引用束）；RngServiceCore（fx_reveal 封闭流——除该流外零随机）；A2 minesweeper（板读与 fx_reveal 调用）；A3 action_economy（queue_ap_delta/charge_layers 读）；B3 status_container 读；B2 unit_container 读（hp_ratio）；DamageController（set_hero_ac_override）；ConfigDB；encounter 引用 | 无（零 await——效果引擎全同步解释器） |
|
||||
| **RewardGrant**（`core/reward_grant.gd`，B1 域·奖励授予件，2026-10-26 编排域拆件设计定稿——实现批建件） | 奖励授予唯一兑付管线（自 battle_orchestrator 收编 grant 族）：极性字典路由与封印溢价兑付（_grant_routed）、三种行应用（flat/percent/gp）、伤害单据提交面（_submit 族）、清图奖励与身份授予、秘宝使用编排（use_treasure 四步）、战斗域 GP 缓冲 escrow 与授予段暂存伤害闸（_defer_board_damage/_deferred_board） | use_treasure 编排入口（treasure_interact_controller 经组合根现值回调直连）；授予入口（结算段类直调）；只读投影（escrow 读与 GP 掉落合计——宿主呈现快照与 _roll_gp_drop 消费） | B4 RewardEconomy（polarity_row/grant）；B1 域 DamageController（开单）；BattleFxHost 引用（treasure_used 事件发射与计数器消耗）；A2 minesweeper（校验回调/fx_reveal/remove_mines_in）；A3 action_economy（相位闸/grant_ap/queue_ap_delta）；B3 status_container（apply_effect/池读）；B2 unit_container（hero_unit/heal）；ConfigDB；注入 emit Callable、宿主 fatal Callable（battle_result 状态机唯一写点留宿主）、宿主 attune 读投影（_attune_safe_seen）、encounter 账本引用；TreasureItems 经宿主 setter 转发注入（库存注入时序在宿主构造之后） | 无（零随机零 await——授予期零随机口径，roll 值授予前已定） |
|
||||
| **damage_controller**（B1 域·伤害单据管线） | 伤害单据唯一兑现管线（单据九栏目声明→分量掷点/克制修正/伤害下限归一→明细行发射；双方同规） | 兑付入口（编排侧开单）＋ fx 揭示回调注入位 | B2 单位实例（单据目标传入）；B1 注入（EffectContext 引用束与编排回调） | 无 |
|
||||
| **BoardInstaller**（`core/board_installer.gd`，B1 域·装板域件，2026-10-29 尾波清偿批设计闭合——实现批建件，细则见「战斗编排域拆件定稿」节轴丙） | 棋盘安装与变异布置域唯一承载（自 battle_orchestrator 收编装板族六函数）：生成受理、全局作用域变异决议、资源摇号资格域组装（roll_board 恰一次）、region 变异决议与连通片布置；BoardGenerator 实例随件自建自接线（宿主成员退役）——宿主侧装板后状态复位（封印/完美计数清零、板序推进、board_changed 发射、秘宝叠加层退役）留宿主薄壳，时序逐字保持 | `install(during_round) -> bool` 单入口；构造＝引用束注入（rng/db/minesweeper/reward_economy/encounter 只读引用＋宿主 fatal Callable——防 _init max-parameters 新键） | A1 board_generator（件内持有）；A2 install_board；B4 roll_board/board_skew 写；A4 变异决议行集经 ConfigDB；board_gen／variant_place 两封闭流随件、流名与开流时点零漂移 | 无（零 await——装板全同步） |
|
||||
| **RoundCycle**（`core/round_cycle.gd`，B1 域·轮循环驱动件，2026-10-29 设计闭合——实现批建件） | 轮循环驱动域唯一承载（自宿主收编 7 成员）：结算五段段件持有与驱动、重入门闸、开轮摇号、踩雷账 | 构造＝引用束注入；段驱动入口由宿主接线调用 | B1 宿主；settlement/ 五段段类；A3 相位读 | 无 |
|
||||
| **BattleFacts**（`core/battle_facts.gd`，B1 域·战斗事实件，2026-10-29 设计闭合——实现批建件） | 战斗事实域唯一承载（自宿主收编 14 成员）：受理事实（encounter）、轮 facts 缓冲（reveals/seals/path）、封印判定账、事实溯源、同调快照读面；attune 状态两成员随件（行为函数留宿主） | 构造＝引用束注入；宿主与段类经注入引用读写 | B1 宿主；A2/A3 只读 | 无 |
|
||||
| **settlement/ 五段段类**（B1 域·结算段件） | B1 每轮结算序列的五段逻辑件（授予/增益减益/战斗/衰减/判定——细则见下「战斗域装配现状」节） | 段处理入口（B1 接线调用）；可直接 `new()` 单测 | B2/B3/B4 兑付面与 B1 轮 facts 缓冲（各段按职责） | 无 |
|
||||
| **level_runner**（C1-lite，切片已建） | 关卡域生命周期（节点链推进、共享 B4 + HP 携带、关卡末 level_clear） | 节点推进接口；LevelTable（`level.tres`——节点 enum {battle,reward,rest,boss}、末节点必须 Boss、ConfigDB 跨表校验⑧） | B1（直构 BattleOrchestrator 接线战斗）、ConfigDB LevelTable | 无 |
|
||||
| **run_structure**（C2） | 冒险/关卡序列、失败重开、**master_seed 唯一接线方** | （契约规范源：`../../gdd/systems/冒险循环/冒险结构.md`） | RngService.set_master_seed、C3/D2 | 无 |
|
||||
@@ -134,10 +137,11 @@
|
||||
|
||||
- **轴甲两件**：battle_orchestrator（1313 行／50 成员，S13 全库单文件最大户）按变化原因拆出 BattleFxHost（效果引擎宿主域）与 RewardGrant（奖励授予域）两协作件；宿主保留架构在册职责全部——战斗状态机与生命周期、轮 facts 缓冲（_facts_reveals/seals/path）、A2 三事件订阅、结算五段驱动、attune 族原位、行发射基建（_emit_row/_assert_row_source/_fatal）、呈现投影（presentation/diagnostic_snapshot 唯一出口不变）、刷新面、nest_preview_count（巢穴预告读数口——外部直读面 main.gd 与 treasure_effects_test 随批点名冻结）。拆件动机与残留债口径见待办清单「gdstyle 存量债全量清偿」条目。
|
||||
- **轴丙一件（2026-10-29 尾波清偿批设计闭合——实现批建件）**：battle_orchestrator 装板域六函数（`_install_new_board`／`_resolve_global_variant`／`_place_variants`／`_place_variants_apply`／`_variants_fringe`／`_adjacent_to_packs`，约 140 行；全仓仅宿主三调用点——begin_battle／中途刷新受理／player_request_refresh，实查零外部调用）按变化原因拆出 BoardInstaller，职责语句「棋盘安装与变异布置域」（生成→全局变异决议→装板受理→资源摇号→变异布置；单一变化原因＝棋盘设置顺序与变异布置算法）。形态两修正（实测裁，与初案「逐字搬运」之差）：①宿主复位块不随件——`_install_new_board` 体内五处计数清零、板序推进、board_changed 发射与秘宝叠加层退役留宿主薄壳 `_install_and_reset`，三调用点改调薄壳、时序逐字；②`_board_generator` 全文件仅装板族使用——实例随件自建自接线（fatal 经注入 Callable），宿主成员退役（类变量 38→37，禁无效成员义务）。encounter（23 处跨宿主）与 _reward_economy（18 处）确认留宿主、经引用束注入。文件长键（1035/1000）随本件迁出归绿；attune 族与 begin_battle 受理段序禁动不变。
|
||||
- **轴丁两件（2026-10-29 零豁免裁设计闭合——实现批建件）**：RoundCycle（轮循环驱动件）与 BattleFacts（战斗事实件）见功能层表两行——宿主 38（轴丙落地后 37）→15，S13 豁免第三条注销；宿主保留面改登记为「战斗状态机与生命周期、行发射基建（_emit_row/_assert_row_source/_fatal）、呈现投影（两快照出口签名不变）、刷新面、nest_preview_count」；attune 族处置由下一条改判；treasure_inventory 注入改址追认——原「外部赋值路径零改址」句失效，level_runner 经 RewardGrant 出口直注；成员级对账以需求卡片为卡内契约（开工 T0 复核）。
|
||||
- **跨件单向接线**：RewardGrant 持 BattleFxHost 引用（treasure_used 事件发射与计数器消耗）；BattleFxHost 对授予面走 bind 时注入的兑付 Callable（揭示队列 flush 回调）——禁双向强引用（两件均 RefCounted，环引用随每战新建泄漏）。行发射经 bind 时注入的 emit Callable（协议面单点留宿主——CurioDeck bind_handlers 同款先例，禁件回调宿主私有族）；轮 facts 缓冲留宿主、fx 件经注入取值；_seal_consumed 留宿主（与 A2 seal_judged 订阅同域）；fatal 经注入 Callable 转宿主 _fatal（battle_result 状态机唯一写点不变）。注入 Callable 亦属接线面、同单向纪律——禁为省参数改持对象引用。授予件对账本零强引用：战斗期消费经 `battle_hooks` 三键回调束（attune_consume/vision_add/negative_blast，bind_battle 缺键 assert），宿主侧三单点记账（2026-10-28 迭代 40 合并适配实装——RunLedger 类已随迭代 39 退役，直持对象引用无处可指）。
|
||||
- **战斗域读面（RunLedger 退役后）**：账本读经编排器 `_journal()`／`_attune_loadout()` 现值派生（GainJournal／AttuneLoadout，enc 派生、无成员接收）；冒险桶经 `enc["adv_bucket"]` 下传 `battle_fx_host.mount_buckets`；战末 bonus 四轴经 `GainJournal.gain_bonus` 汇入（2026-10-27 迭代 39 主角账三件落地、迭代 40 合并适配承接）。
|
||||
- **settlement/ 段类随动**：段类构造注入直持宿主＋两新件三引用（Middle Man 禁令封转发壳——调用点改指），授予段读写面点名：_grant_routed×5／_submit×6／escrow 写／_fx_new_resource_types／_feat_first_dig_used／_fx_bonus_delta 写／_apply_ac_bonus／_fx_enqueue_reveal／_flush_pending_reveals／_grant_clear_reward／counters_ctx；战斗段 _defer_board_damage 复位与 _deferred_board 结账改指 RewardGrant。四个授予段 helper（_feat_yield_adjust/_harmful_variants/_harmful_adjacent/_hits_of）与 _pool_effective/perfect_sweep_earned 留宿主（段类经宿主引用直调，现状形态）。
|
||||
- **attune 族原位保留**：同调配装 8 成员不进新件——迭代 39 副卡（AttuneLoadout 充能单源化）语义领地，两批零冲突；本波残留债归尾波。RewardGrant 经宿主 attune 读投影取 _attune_safe_seen。
|
||||
- **attune 族处置（2026-10-29 零豁免裁改判，原「原位保留」失效）**：attune 状态两成员归 BattleFacts、行为函数留宿主——迭代 39 副卡（AttuneLoadout 充能单源化）语义领地不破，外部三面消费点零改址；RewardGrant 经宿主 attune 读投影取 _attune_safe_seen 形态不变。
|
||||
- **呈现零变化**：两快照出口签名与载荷逐字不变，内部改读两件只读投影（快照本体不读揭示态——揭示态投影消费方＝宿主 A2 订阅旁路判定）；treasure_interact_controller 三触点分家——use_treasure 经组合根现值回调改注 RewardGrant（每战新建编排器，禁一次性直引防悬挂），minesweeper 读与 attune_convert_state 仍走宿主取值回调（双取值面）；nest_preview_count 直读面零变化。
|
||||
- **S13 键账收敛义务**：12 个超标键随函数迁入新文件＝基线外 NEW（use_treasure 长度/分支/局部/返回×4、_grant_routed 参数 8、_dispatch_row 参数 6、_apply_percent_row 参数 6、_apply_gp_row 参数 6、_apply_flat_row 参数 7＋返回 9、_submit_flat_hero 参数 7、_fx_fact 返回 7）——卡内同步收敛为本波义务（_grant_routed 等签名随引用束注入改形、use_treasure 体拆分），禁波 0 合并 refresh 吸收新文件未还键；新件 _init 引用束注入防 max-parameters 新键。
|
||||
- **验收红线**：游戏行为零变化（RNG 消费序零漂移——fx_reveal 封闭流随件迁移取号序不变、信号顺序契约冻结、明细行协议词表零触碰、同种子逐位一致）；battle_orchestrator 头注发射点指址随拆件改写（词表不动，指址须真）；行数恶化债清偿义务（迭代 38 特批带红合并挂账 c4c69701——本波还债归绿）；PARITY 触面（battle_orchestrator.gd 被改）实跑对拍须经用户批准、不得借机重锚；S13 改善非清零口径（宿主残留 8–10 键＋随迁键卡内收敛后新件零残留为达标线）。
|
||||
@@ -149,7 +153,7 @@
|
||||
- **CurioDeck 转纯池**：bind_handlers 反向回调退役；商店购买消费经注入 Callable 链至 CurioStop 兑付单点——牌库只管抽签/消耗/cap 判定/凭证计数。
|
||||
- **RunLedger 退役**：四账各归其主——加算区/购买记录/钥石增量/特性集/真视记录归 HeroLedger，充能归 AttuneLoadout，冒险桶字典归应用层持有；战斗侧 encounter 注入面由单一账类引用改为多路（桶字典＋实体账＋配装件）；ShopSession 账本引用面同步换代，商店属性商品加算改经 HeroLedger 单写原语。
|
||||
- **level_runner**：依赖改构造注入一次给齐（后置 setter 群与商店重绑机制退役；注入活引用禁快照——特性集共享引用语义保留）；商店白盒转发属性撤除；战斗→关卡信号转发族保留（战斗实例每节点新建，关卡层做战斗域稳定面）。
|
||||
- **断点片段化**：各件自写自读自己的键（关卡层交关卡域五键片段：node_id/visited_ids/aux_items/shop_shelf/shop_visit_buys），缺键回退策略随领域知识归各件；应用层唯一落盘口（收齐各件片段拼成顶层快照后写盘），写触发点不变（五处）；既有 27 键逐键冻结；新增获得日记键沿扩列不升版先例——旧档缺日记回退汇总键直载并跳过比对，日记在档时由日记推导汇总、与留存值不符即报错中止（迁移正确性自检）。
|
||||
- **断点片段化**：各件自写自读自己的键（关卡层交关卡域五键片段：node_id/visited_ids/aux_items/shop_shelf/shop_visit_buys），缺键回退策略随领域知识归各件；应用层唯一落盘口（收齐各件片段拼成顶层快照后写盘），写触发点不变（五处）；既有 27 键逐键冻结；新增获得日记键沿扩列不升版先例——旧档缺日记回退汇总键直载并跳过比对，日记在档时由日记推导汇总、与留存值不符即报错中止（迁移正确性自检）。2026-10-29 零豁免裁随动：拼盘与读侧策略机组拆出 breakpoint_store（核心层表新行），应用层落盘口与写触发点不变——宿主经件组装快照后写盘，27 键冻结不变。
|
||||
- **信号直连**：adventure_runner 六转发信号族（node_entered/choices_presented/step_row/round_started/board_changed/wallet_changed）退役；呈现层在 level_started 重取点重订阅关卡对象信号（旧实例连接随引用释放消亡）；「关卡开始信号前零发射」契约写进关卡件头注；「恰好连接一次」断言用 is_connected 守卫（release 模板剥 assert）；三选一信号面归 CurioStop。
|
||||
- **调用直连**：不留中间人委托壳（纯转传＝Middle Man 反模式，2026-10-26 用户裁定）；呈现控制器经取值回调持件——回调只许捕获长活根对象，禁件方法 Callable（防悬挂）；约 30 个调用文件改址；测试/探针直连件读写。
|
||||
- **验收红线**：游戏行为零变化（RNG 流名 reward_pick 与消费序零漂移、信号顺序契约冻结、同种子逐位一致）；gdstyle 基线禁改（类变量计数下降属改善）；怪物寻址 resolve_enemy_rowset 调用面与关卡参数档装配零变化（未来关卡主题的数据缝不堵）。
|
||||
@@ -160,6 +164,10 @@
|
||||
|---|---|---|---|---|
|
||||
| **D1 HUD**（呈现面拆分持续换代：组合根 main.gd + 三屏壳（MenuScreen/CampScreen/AdventureScreen）+ views/ 视图单元（现行承载面见「呈现层装配与会话生命周期」节；早期 9 单元清单与 LevelStripView 已随场景换代退役）；营地覆盖层=四柜台并排〔树淬炼主界面/锻造工坊·秘宝匣钥匙门/图鉴常开——迭代 21 T6 程序占位重排〕） | 全部 Control/CanvasLayer（例外：BoardView 棋盘本体与 BattleStageView 站桩本体 = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界〔BoardWorld/CellUnit；StageWorld/StandeeBody——B 区 slot_row 伴随件留壳层〕，探针契约面不变——棋盘 Node2D 迁移批 Phase A 2026-09-23 / 战斗舞台 Phase B 2026-09-26）、输入→意图翻译（**唯一提交路径 = settle_batch，不直调 A3**）、呈现义务状态记录（A2×6 / B2×4 / B3×4 / B4×5 / B1×3） | 视图单元接口（信号外发、setter 只读注入） | A2 compute_move_path / ActionOutcome；A3 ap/rap；B1 步骤流行协议（数据源）；ConfigDB display_name | **MEDIUM**：Control / CanvasLayer / draw_* / InputEvent / RichTextLabel——对照 breaking-changes.md 4.5–4.7 条目（CanvasItem 线条无抗锯齿羽化、设备 ID 常量、RichTextLabel 图片参数两轮变化） |
|
||||
| **组合根拆件**（呈现侧写口子件：curio_interact_controller / camp_shop_presenter / treasure_interact_controller） | 代组合根执行核心写调用（冒险节点后续推进／营地购买与刷新／道具使用——依赖与回调由 main 构造注入） | 各拆件的写入口（仅组合根装配面可达；视图零直连） | 构造注入的核心写引用（推进／商店／道具各域——详见各拆件头注） | 无 |
|
||||
| **ui_registry**（`presentation/ui_registry.gd`，界面注册面，2026-10-29 零豁免裁设计闭合——实现批建件） | 呈现层接口面唯一承载：层序合同（LAYER_CONTRACT）迁驻与合同寻址、三域句柄容器 ui_screens（9 屏壳与覆盖层句柄）／ui_battle（5 战区句柄）／ui_modals（13 模态句柄＋ModalFlow）；组合根经其一级寻址接线，探针挂载假设迁移为 `main.ui.<域容器>.<句柄>`；七个探针别名/转发成员随批消灭 | 三容器属性＋合同寻址口（RefCounted 门面，不挂树、零会话期引用） | 构造注入：三屏壳、覆盖层、战区句柄、ModalFlow（main_ui_build 交付随之改型） | 无（RefCounted） |
|
||||
| **board_hover**（`views/board_hover.gd`，悬停预承诺呈现域件，尾波清偿批 D2 设计闭合——实现批建件） | 悬停反馈域唯一承载（自 board_view 收编 11 函数族＋_hover/_last_click 两成员）：三语义光标、目标格边框、BFS 路径预览、chord 双击首遇锚；_r0 出生展开区成员留宿主 | 构造＝引用束注入（cells/minesweeper/diggable 引用＋光标写入与 hover_forbidden 注入回调）；三入站口留宿主委托；hover_probe 读面留宿主 | board_view（宿主）；输入事件经宿主入站口 | 无（RefCounted） |
|
||||
| **cell_base_layer／cell_mark_overlay**（`views/`，单格两绘制域件，2026-10-29 设计闭合——实现批建件） | 单格绘制域拆分（自 board_cell_unit 状态件 `_CellPaintState` 收编，入参与该层绘制命令同件）：基座层（底面/描边/立面/投影/接触带/倒角，12 成员）与标识叠加层（标记/字形/徽章/封印/点迹/高亮/退色，13 成员）；宿主 _draw 退为六步时序器，类变量 30→10 | 构造注入；绘制命令由宿主 _draw 按层序调用 | board_cell_unit（宿主）；gdstyle 键各文件独立计数（12/13 均 ≤15） | 无（RefCounted） |
|
||||
| **standee_vitals／standee_motion**（`views/`，站桩两状态件，2026-10-29 设计闭合——实现批建件） | 站桩状态域拆分（自 `_StandeeState` 真实 25 成员收编）：身份命值（hp/atk/状态值族，12 成员）与资产演出（动作/姿态/位移演出族，11 成员）；三个演出探针计数器留宿主，宿主类变量 19→10 | 构造注入；st（沿用）／mo 两实例由宿主持有 | standee_body（宿主）；battle_stage_view 写入面逐字保持 | 无（RefCounted） |
|
||||
| **HudPresenter**（`presentation/hud_presenter.gd`，迭代 37 加注） | 战斗屏**数据投影＋文案拼装静态族**——核心状态→呈现文案的全部翻译集中于此（B/C/D 区文案与投影），静态无状态 | `refresh(…)` 全量重查装配（组合根每次动作/结算返回后调用，漏调即陈旧呈现）＋只读静态投影族 | 核心读取只走 `settlement.presentation_snapshot()` 成文快照面（禁链式穿透结算内部）；ConfigDB display_name | 无（RefCounted 静态） |
|
||||
| **board_resolvers**（`presentation/board_resolvers.gd`，迭代 37 拆出） | 棋盘每格渲染数据的只读解析回调四函数（奖励徽章身份——挖掘期 Active 相位内、地形变异数字遮蔽与角标、调试加成生效值）——有态绑定件，与无态静态投影族 HudPresenter 职责互斥 | 构造注入 db、调试浮窗与结算活态取值，产出绑定 Callable 供组合根接线 | ConfigDB / DebugOverlay / 结算活态取值 Callable | 无（纯投影） |
|
||||
| **main_ui_build**（`presentation/main_ui_build.gd`，迭代 37 拆出） | `_build_ui` 八步拆分件——组合根 UI 装配分步承接（三屏壳实例化、视图句柄接线、覆盖层装配与模态编排注入按步拆开）；main 侧留同名薄委托，装配序与 z 序零改动 | 分步静态函数（成员访问经 root 显式传入） | 层序逻辑不在此件——唯一事实源仍是 `main.LAYER_CONTRACT` + `_apply_layer_contract()` | 同 D1（Control 装配面） |
|
||||
@@ -182,7 +190,7 @@
|
||||
### 三屏壳与组合根句柄面
|
||||
|
||||
- 呈现场景拆为三屏壳：MenuScreen（开始菜单屏）／CampScreen（营地屏）／AdventureScreen（冒险屏——内含关卡地图与战斗两容器）。
|
||||
- 屏成员经组合根 main.gd 一级句柄暴露（探针挂载假设 `main.X` 路径零迁移；**S13 豁免登记 2026-10-27：组合根类变量面即探针契约面——约 46 个句柄成员被探针挂载假设钉死，max-class-variables 对本件按架构契约豁免（键永久基线内、禁再恶化），豁免理由在册本节，禁为清键改写探针挂载契约**）；局态一律住 RunScope 节点，禁在屏/视图侧持有局态引用。
|
||||
- 屏成员寻址自实现批起迁经界面注册面（**2026-10-29 零豁免裁＋注册面设计闭合——实现批建件**）：探针挂载假设 `main.X` 迁移为 `main.ui.<域容器>.<句柄>`（ui_screens／ui_battle／ui_modals 三域容器，约 867 处探针与系统测试引用随批改址）；原 S13 豁免登记〔2026-10-27「组合根类变量面即探针契约面」〕注销；main.gd 类变量 49→15，注册面形态见「模块归属·呈现层」表 ui_registry 行；局态一律住 RunScope 节点，禁在屏/视图侧持有局态引用。
|
||||
- **组合根拆件**＝组合根构造注入、代组合根执行核心写调用的呈现侧子件（现行三件：curio_interact_controller／camp_shop_presenter／treasure_interact_controller——冒险节点后续推进、营地购买与刷新、道具使用）。视图禁直连拆件；核心写调用的可达路径仍是「视图→信号→组合根（含拆件）→核心」，依赖规则与组合根单点装配不变。成员见「模块归属·呈现层」表。
|
||||
|
||||
### 视觉层装配合同
|
||||
@@ -310,9 +318,11 @@
|
||||
|
||||
本节为测试域（测试载体、判定口径、静态扫描域）的事实源。新增违规案例仍须先补 static_scan 规则再修码（code-conventions 缺陷-规范对照表纪律）。
|
||||
|
||||
**S13 测量面豁免登记（2026-10-27）**：`game/presentation/tune_sim_controller.gd` 的循环内 `await`（测速循环逐帧让出）是调参测量的 wall-clock 步进承载语义——重构即测量口径漂移，违行为零变化红线。该键按架构豁免（键永久基线内），豁免理由在册本段；同件 `print` 残留不豁免（信息已由 toast/JSONL 承载，随全清批删除）。
|
||||
**S13 测量面豁免注销（2026-10-29 零豁免裁）**：原循环内 `await` 豁免〔2026-10-27〕注销——tune_sim_controller 改 process_frame 信号常驻连接＋步进状态机（每帧一局、帧相位逐点对齐，设计闭合、实现批建件）；随批申报行为改动一处：运行态收尾由「每局置假」还原为「整批收尾单次置假」（消除与 wd8/ui_tune_probe 断言面的静态矛盾）。
|
||||
|
||||
**S13 豁免登记第三条（2026-10-28 迭代 40 卡①）**：`game/core/battle_orchestrator.gd` 的 max-class-variables 键——宿主保留面为「战斗编排域拆件定稿」节第 1 款锁定的职责承载面（状态机与生命周期、账本读面、attune 族原位、行发射基建、呈现投影），类变量阈值 15 在保留面锁定下不可达，按全清口径第二支臂登记架构豁免（键永久基线内、禁再恶化；实测键账 50→38）。
|
||||
**S13 豁免第三条注销（2026-10-29 零豁免裁）**：原 battle_orchestrator max-class-variables 豁免〔2026-10-28 迭代 40 卡①〕注销——RoundCycle/BattleFacts 两新件设计闭合（宿主 38→15，实现批建件，见「战斗编排域拆件定稿」节轴丁）。
|
||||
|
||||
**gdstyle 计数截断缺陷登记（2026-10-29 两设计批独立实证）**：gdstyle v0.4.0 对文件内 inner class 的成员计数存在截断——内嵌类中带行尾注释的属性声明截断其后续成员计数（standee_body 实测 31 声明仅记 19、board_cell_unit 33 仅记 30）。基线登记值属欠估；闸机扫描与基线同源、判定口径自洽不误报，债的真值以实查为准——零豁免各批按真实口径设计（实数低于阈值，不依赖解析缺陷）。登记待办：向 gdstyle 上游报 issue。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,134 @@
|
||||
# 需求卡片——gdstyle 尾波补件批
|
||||
|
||||
> **版本状态**：v1.0 定稿——零待裁点（2026-10-29 用户裁：恢复尾波卡 v2.0 裁去的 D2/D4 两拆件项；D5 五降值键＝留债、零豁免延伸）。
|
||||
> **接收方**：待办清单条目「gdstyle 尾波补件批——悬停域与断点域拆件（2026-10-29 登记）」。
|
||||
> **来源**：尾波清偿批设计闭合后的用户再裁（D2/D4 改判拆件）。**唯一事实源**：`design/engineering/architecture/architecture.md` v1.25（「模块归属·呈现层」表 board_hover 行、「核心层」表 breakpoint_store 行、「冒险域拆分」节断点随动句、「呈现层装配」节屏成员寻址句）。
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
这批做什么：把尾波卡 v2.0 裁去的两个拆件项恢复执行——board_view 悬停域拆出 board_hover、adventure_runner 断点域拆出 breakpoint_store。三个 gdstyle 键随之降值（board_view 类变量 32→约30、adventure_runner 类变量 28→约22；board_view 公开方法 27 持平——全为契约面）。
|
||||
|
||||
什么状态算完：
|
||||
|
||||
1. 两新件在库、宿主成员迁出、键账达第 3 节预期（降值口径，不承诺清零）。
|
||||
2. 行为零变化：同种子下事件流、断点快照、棋盘渲染逐位一致。
|
||||
3. 批末代码域闸全绿；三键终值按留债口径记入实现报告（禁落 architecture 豁免登记）。
|
||||
|
||||
## 2. 设计事实源
|
||||
|
||||
architecture.md v1.25 三处在册设计（2026-10-29 零豁免裁设计闭合）：board_hover 行（职责语句「悬停预承诺呈现域」、拟收 11 函数族＋2 成员、耦合边界）、breakpoint_store 行（职责语句「存档断点组装与回放唯一承载」、拟收 6 成员＋函数族、27 键冻结）、「冒险域拆分」节随动句（拼盘与读侧策略机组拆出、应用层落盘口不变）。
|
||||
|
||||
## 3. 现状事实（2026-10-29 实查；行号为迭代 42 合回前基线——T0 必须按当轮 master 重测重锚，board_view 的 `_paint_cell` 届时已由迭代 42 拆为五段、行号必漂移）
|
||||
|
||||
- board_view.gd：悬停域成员 `_hover`（:70）、`_last_click`（:71）；函数族 11 个＝`_hover_at`（:442）、`_on_shell_mouse_exited`（:453）、`_detect_chord`（:475）、`_on_cell_hover`（:486）、`_on_cell_unhover`（:491）、`_refresh_hover_after_paint`（:497）、`_apply_hover_visuals`（:503）、`_clear_hover_visuals`（:531）、`_set_cursor_shape`（:538）、`_show_path_preview`（:542）、`_hide_path_preview`（:552）。`_r0`（:72）是出生展开区资格域成员（:238/:296/:563 三消费方），**不随迁**——划入悬停件即凑计数袋。
|
||||
- adventure_runner.gd：断点域成员 6 个＝`_save_manager`（:35）、`_resume_bp`（:36）、`_pending_next_level`（:30）、`_last_level_payload`（:31）、`_last_treasure_cleared`（:32）、`_loadout_seeded`（:37）；常量 `BREAKPOINT_FIELDS`（:539-568，27 键）；函数族＝`_snapshot_breakpoint`（:571）、`_bp_parts`（:583）、`_bp_read`（:636）、`_bp_strategy`（:646）、`_bp_read_int`（:651）、`_resume_ledger`（:182）、`_resume_curio_state`（:193）、`_resume_params`（:218）、`_resume_counters`（:237）；公开入口 `resume_adventure`（:94）留宿主薄壳。
|
||||
- 测试触面：`game/tests/unit/core/breakpoint_resume_test.gd:185` 直读 `AdventureRunnerScript.BREAKPOINT_FIELDS`——随件迁改址（判据零变化）。
|
||||
- 键账：board_view 类变量 32（键留债目标约 30）、公开方法 27（持平——27 个逐类核对全为探针契约面与依赖单向纪律承载面）；adventure_runner 类变量 28（留债目标约 22）。
|
||||
|
||||
## 4. 设计契约（违反即返工的红线条款）
|
||||
|
||||
- 🔴 **行为零变化**：同种子下事件流/断点快照/存档往返/棋盘渲染逐位一致；玩家可见面零变化。
|
||||
- 🔴 **断点键集冻结**：`BREAKPOINT_FIELDS` 27 键逐键冻结（键名、策略标签、键序零变化）；随件迁移只换承载文件，不换键面。
|
||||
- 🔴 **RNG 零触碰**：本批零新流、零消费序变化（断点回放 restore 同序取号；悬停域无随机）。
|
||||
- 🔴 **呈现零变化**：悬停反馈三语义（光标/边框/路径预览）行为逐点保持；棋盘 golden 三张对拍差异非零即红。
|
||||
- 🔴 **拆分边界纪律**（判据权威＝code-conventions §1.1，卡内执行条款）：①拆出单元须有职责语句与单一变化原因（实现报告逐件一行）；②集体身份——命不出名字的打包＝凑计数袋，禁；③「过阈值」只作发现信号；④拆不出内聚单元→停卡呈报；⑤禁沿阈值轴拆。
|
||||
- 🔴 **禁为机检文本保留无效成员**：禁止为迎合机检消息文本保留或新增无效成员/别名；机检键与卡片契约互斥＝停卡呈报。
|
||||
- 🔴 **残留键留债（D5 零豁免裁）**：三键降值后留基线冻结禁恶化；**禁落 architecture 豁免登记**；禁为凑阈值硬拆。
|
||||
|
||||
## 5. 范围边界
|
||||
|
||||
做什么：第 3 节两拆件项（board_hover、breakpoint_store）。
|
||||
|
||||
不做什么：迭代 42 在飞范围零触碰（_paint_cell 拆五段、循环内 new、_enter_node、商店委托壳——并排卡承接）；单格/站桩状态件（呈现层状态件批承接）；main.gd/battle_orchestrator/tune_sim 五键（零豁免五键各批承接）；三残留键的终局清偿（留债，后续窗口再议）。
|
||||
|
||||
## 6. 关联文档同步面
|
||||
|
||||
| 文档 | 关联点 | 同步义务 |
|
||||
|---|---|---|
|
||||
| design/engineering/architecture/architecture.md | 两新件登记行（建件后「实现批建件」改现状）；「冒险域拆分」节随动句核对 | 设计权威文档——实现批禁直改；逐条列进 `reports/iter<N>-反哺点-<日期>.md`，用户裁决后归文档批落文 |
|
||||
| game/tests/README.md | 「棋盘悬停反馈」行代表用例列（本批复用既有探针、零新增断言——预计零改动）；断点行入口句核对 | 机械面文档——实现批禁写；如需更新由写卡段后续卡修订版同批处理 |
|
||||
| design/gdd/systems/ | 无关联文档——结构整改不改游戏规则与玩家可见行为 | 无修订预期；契约句被触碰＝停卡呈报走反哺点通道 |
|
||||
|
||||
## 7. 任务卡 T0..T3
|
||||
|
||||
**T0 读数重锚与对账（0.25–0.5 工作日）**
|
||||
|
||||
- [ ] 以当轮 master 重测 board_view/adventure_runner 三键实测值与第 3 节全部 file:line；漂移处就地改卡并记录；对不上即停卡呈报
|
||||
- [ ] 复核 11＋9 函数族现行键面（`tools/gdstyle_baseline.txt` 无其函数级键——逐字搬运零新键；实查确认）
|
||||
|
||||
**T1 board_hover 拆件（0.75–1 工作日）**
|
||||
|
||||
- [ ] 建 `game/presentation/views/board_hover.gd`（RefCounted；构造＝引用束注入：cells 容器引用、minesweeper 只读引用、diggable 集合引用＋壳层光标写入与 hover_forbidden 注入 Callable）
|
||||
- [ ] 悬停函数族 11 个＋成员 `_hover`/`_last_click` 迁出（函数体逐字搬运）；三入站口（`_gui_input`/`_on_cell_input`/`click_cell`）留宿主委托；`hover_probe()` 留宿主读件投影（返回语义零变化）；`_r0` 留宿主
|
||||
- [ ] 孤立验证：`tools/probe_gate.sh --click`＋`--full` 全绿；`tools/render_gate.sh` 棋盘 golden 三张差异 0.00%（非零即停机呈报）
|
||||
|
||||
**T2 breakpoint_store 拆件（1–1.5 工作日）**
|
||||
|
||||
- [ ] 建 `game/core/breakpoint_store.gd`（RefCounted；构造＝引用束注入：db、rng、主角账三件、curio/stop/bank/loadout 引用——防 max-parameters 新键）
|
||||
- [ ] 断点域 6 成员＋`BREAKPOINT_FIELDS`＋函数族 9 个迁出（逐字搬运）；`resume_adventure` 留宿主薄壳；`set_save_manager` 转发件
|
||||
- [ ] `breakpoint_resume_test.gd:185` 改址为 breakpoint_store 常量（判据零变化——第 14 节申报）
|
||||
- [ ] 孤立验证：`--script res://tests/run_all.gd -- --only=breakpoint_resume,save_rng_roundtrip,cross_system_flow` 全绿＋`python tools/run_smoke.py`
|
||||
|
||||
**T3 键账对账与收口（0.5 工作日）**
|
||||
|
||||
- [ ] 批末代码域闸全绿（`tools/run_all_gates.sh --code`）
|
||||
- [ ] 三键终值对账（board_view 约30/27、adventure_runner 约22）——留债口径记入实现报告
|
||||
- [ ] 产出物落位卡：实现报告与反哺点清单写齐方算收口
|
||||
|
||||
合计估时约 2.5–3.5 工作日。编队注记：编入待迭代 42 合回；与呈现层状态件批同代时推荐其先行——board_view 的 u.st 写入面改型后，hover 拆件在新写入面上施工。
|
||||
|
||||
## 8. 验证闸——改动—验收对照表
|
||||
|
||||
域口径：本批改动全为 `game/` 下非 .md 行为载体——批末跑代码域闸；里程碑步（T 段）出口跑一次全套闸，波内修复只做出红最小单元的最窄确认，新增测试先行孤立验证再并入全套。总判据＝每行改动以「既有断言面全绿＋golden 零差异」证明零行为漂移；全量闸电池＝冒烟＋系统测试＋run_all 全量＋probe_gate --click --full＋render_gate＋static_scan（含 S13 对账）。
|
||||
|
||||
| 行 | 需求点 | 改动（文件:行/行为） | 验收测试（名称＋落点＋尾缀） | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| V1 | 悬停域拆件 | board_hover.gd 新建；board_view.gd 函数族与 :70-71 成员迁出 | 复用 ui_input_probe 悬停三语义断言（case①到达/②禁入/③路径预览）＋ui_click_probe＋type_glow_shot_probe；新增断言零条 | 探针 | 合成 InputEventMouseMotion/MouseButton 经 `_gui_input` 入站口；`hover_probe()` 读面 | 探针可见性断言面（hover_probe 返回值、光标形状、格件 st 边框/点迹字段）＋golden 三张零差异 | 既有：棋盘悬停反馈（三语义光标／目标格边框／路径预览点迹） |
|
||||
| V2 | 断点域拆件 | breakpoint_store.gd 新建；adventure_runner 断点函数族与 6 成员迁出 | 复用 breakpoint_resume_test 全套＋save_rng_roundtrip_test＋cross_system_flow_test:_feats_breakpoint_roundtrip；新增断言零条；:185 改址（第 14 节申报） | 单元＋集成 | AdventureRunner.resume_adventure()／start_adventure() × SaveManagerCore 断点域 | 断点快照往返逐键断言面（27 键冻结——键名/策略/键序零变化） | 既有：断点片段往返与续玩幂等；既有：旧档迁移链与断点续玩零跳号（集成） |
|
||||
|
||||
反向核对：diff 中每个行为改动均有行——本批申报行为改动为零（全部非行为改动＝结构整改，判据＝零漂移证明）。孤儿断言：无（零新增断言）。
|
||||
|
||||
## 9. 异常分级
|
||||
|
||||
- **L1 自救**：迁移函数编译错、探针调用面改址漏改——就地修复重跑最窄确认。
|
||||
- **L2 记录继续**：实测值与预期区间偏离但同档位——记入实现报告「实现决定记录」。
|
||||
- **L3 停机写报告等用户**：①拆分边界纪律④触发（含 `_r0` 归属认定被实现期证伪）；②机检预算互斥——新件实数超第 12 节预算或迁移函数现出超标键＝停卡退回写卡段；③golden 对拍差异非零；④S13 键恶化或基线外新键；⑤断言面被下游兜底吸收致判据绑不上。
|
||||
|
||||
## 10. 代拍板白名单
|
||||
|
||||
1. 迁移函数头注指址微调（词表与语义不动）。
|
||||
2. 新件私有 helper 命名微调（职责语义不变）。
|
||||
3. 断言失败消息尾缀〔补件 Vn〕分配与措辞。
|
||||
4. 改址机械改写（preload 顺序、空行排版）。
|
||||
|
||||
## 11. 待裁点
|
||||
|
||||
零待裁点，开工门=U0。（裁决记录：2026-10-29 用户裁——恢复 D2/D4 拆件；D5 五降值键留债、零豁免延伸；`_r0` 留宿主；断点域六成员全迁。）
|
||||
|
||||
## 12. 落位与可复用性预检
|
||||
|
||||
- **board_hover.gd（新增）**：复用面核查——悬停预承诺逻辑现行全在 board_view（11 函数族全仓无第二实现，无既有件可复用）；不能并入 TilePalette（瓦片装载）、HeroSprite（英雄演出）、CellUnit（格件绘制）——悬停预承诺与三者是不同变化原因。落点唯一：`game/presentation/views/` 新件，board_view `_init` 建为子件（HeroSprite 挂载先例）。调用路径：只被 board_view 持有与调用，输入经宿主入站口委托，禁反向持宿主引用（注入回调单向）。
|
||||
- **breakpoint_store.gd（新增）**：复用面核查——断点拼盘与读侧策略现行在 adventure_runner（`BREAKPOINT_FIELDS` 登记单源唯一）；不能并入 save_manager（存档 IO 原语与冒险断点语义是两个变化原因——SlotStore 拆分已立界）、不能并入 MetaStateStore（元进度数据件）。落点唯一：`game/core/` 新件。调用路径：只被 adventure_runner 调用；宿主经件组装快照后写盘，应用层落盘口不变。
|
||||
- **新增函数**：零——全部为既有函数体逐字搬运。零新增数据件、零新增常量表（`BREAKPOINT_FIELDS` 为迁移非新增）。
|
||||
|
||||
## 13. 实现规范预算（gdstyle 默认阈值对账）
|
||||
|
||||
| 新件 | 公开方法 ≤20 | 类变量 ≤15 | 迁移函数对账 |
|
||||
|---|---|---|---|
|
||||
| board_hover.gd | 预算 6（悬停驱动入口） | 预算 2（`_hover`/`_last_click`）＋引用束成员 | 11 函数现行均无超标键（基线无其函数级键）；`_apply_hover_visuals` 分支 5 |
|
||||
| breakpoint_store.gd | 预算 8（快照/回填/读侧入口族） | 预算 6（拟拆成员）＋引用束 | `_bp_parts` 现行 49 行/9 局部（:583-630 实测）均在默认阈值内；`_resume_*` 四函数无超标键 |
|
||||
|
||||
存量触面一查：board_view 6 键与 adventure_runner 1 键 T0 读数写明「S13 键较登记值只降不升」预期；`_init` 一律引用束注入防 max-parameters 新键。
|
||||
|
||||
## 14. 测试削弱申报
|
||||
|
||||
1. `breakpoint_resume_test.gd:185`——`AdventureRunnerScript.BREAKPOINT_FIELDS` 直读随件迁改址为 breakpoint_store 常量；判据零变化，仅常量承载文件换代。
|
||||
2. 除此之外禁删断言、禁放宽阈值、禁缩小扫描面、禁把真实入口换成下层直调；未申报的削弱由独立验收审计判红。
|
||||
|
||||
## 15. 独立验收审计
|
||||
|
||||
合并前由未参与实现的会话或子代理执行；报告落 `reports/iter<N>-验收审计-<日期>.md`。审计至少做四件事：逐行核对第 8 节对照表（测试存在、真执行、尾缀可 grep、真实入口未绕过改动点）；抽查判据绑定面；检查测试削弱（对照第 14 节申报）；核对两行「非行为改动」判定的零漂移证明是否在当轮真实跑批中成立。未过不得合并。
|
||||
|
||||
## 16. MC／数值与 RNG 零触碰声明
|
||||
|
||||
本批零数值改动、零数据表改动、零 RNG 流词表改动——断点回放 restore 同序取号、悬停域无随机。MC 对拍不跑。
|
||||
+1
-1
@@ -75,7 +75,7 @@
|
||||
| 迭代 39 | 已完成（2026-10-27） | 已退役（git 历史可考） | 2026-10-26 | ≈10.15 个工作日〔用户特批 2026-10-26 超 10 个工作日〕 | 已退役（git 历史可考） |
|
||||
| 迭代 40 | 已完成（2026-10-28） | 已退役（git 历史可考） | 2026-10-27 | ≈6.375 个工作日 | 已退役（git 历史可考） |
|
||||
| 迭代 41 | 已完成（2026-10-29） | 已退役（git 历史可考） | 2026-10-27 | ≈13.15 个工作日〔用户特批 2026-10-27 超 10 个工作日〕 | 已退役（git 历史可考） |
|
||||
| 迭代 42 | 待开工 | reports/需求卡片-gdstyle尾波清偿批-2026-10-29.md<br>reports/需求卡片-level_runner商店委托层拆除-2026-10-29.md | 2026-10-29 | ≈5.375 个工作日 | — |
|
||||
| 迭代 42 | 进行中 | reports/需求卡片-gdstyle尾波清偿批-2026-10-29.md<br>reports/需求卡片-level_runner商店委托层拆除-2026-10-29.md | 2026-10-29 | ≈5.375 个工作日 | — |
|
||||
| 迭代 43 | 待开工 | reports/需求卡片-战斗一屏样张批-2026-10-28.md | 2026-10-29 | ≈6.5 个工作日 | — |
|
||||
|
||||
- 迭代 38 收口为带红合并〔用户特批 2026-10-26〕：09 静态扫描 S13 gdstyle 恶化 2 条经批准记入基线存量红（git 提交 c4c69701），卡② 停卡退上游，处方已于 2026-10-26 修订定稿 v1.3（git 提交 b3ea7532），随「gdstyle 存量债全量清偿」条目波 7 待编排。
|
||||
|
||||
@@ -69,12 +69,28 @@
|
||||
|
||||
#### gdstyle 尾波清偿批——基线余量 11 键定向整改（2026-10-29 登记，来源=审计发现）
|
||||
|
||||
**实况**：证据＝`tools/gdstyle_baseline.txt`（2026-10-29 人工重锚后余量 16 键）＋reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md（§三波次方案与 §六文档设计段裁定记录，裁定全部继续有效）。迭代 39/40/41 三批清偿后余 16 键：本批承接 11 键——board_view 6（_paint_cell 长度 139/分支 24/局部 22、循环内 new、类变量 32、公开方法 27）／level_runner 3（公开方法 50、类变量 30、_enter_node 返回 7）／battle_orchestrator 文件长 1035／adventure_runner 类变量 28；另 5 键走豁免通道另行讨论不在本批（main.gd 类变量 49、tune_sim_controller 循环内 await、board_cell_unit 类变量 30、standee_body 类变量 19、battle_orchestrator 类变量 38——其中三条已有架构豁免登记）。需求卡片 v2.0 定稿（零待裁点）：reports/需求卡片-gdstyle尾波清偿批-2026-10-29.md 设计段裁决 2026-10-29 用户裁闭合（D1 装板域拆新件 BoardInstaller 两修正·architecture v1.24 轴丙已落文／D2 悬停域不拆／D3 商店域候选 A／D4 断点域不拆／D5 五降值键豁免终局／D6 商店域并排编队——执行合同＝并排卡「level_runner 商店委托层拆除」v1.1，本卡不重复执行），零待裁点。预期两档：归绿 6 键（_paint_cell×3、循环内 new、_enter_node、文件长）；豁免终局 5 键（board_view 32/27、level_runner 50→33/30、adventure 28——批末按实测值落 architecture 豁免登记，键 7 实测值视并排卡时序）。本卡估时 3–4.25 工作日（并排卡 ≈1.5 工作日另计）。MC/数值零触碰（结构整改不改数值与 RNG 消费序）；battle_orchestrator 触 PARITY_TOUCH_FACES——实跑对拍须经用户批准、不得借机重锚。S13 键账对账在批末，基线重锚由用户发令人工 --refresh（预期降幅逾 10% 须 --force）。
|
||||
**实况**：证据＝`tools/gdstyle_baseline.txt`（2026-10-29 人工重锚后余量 16 键）＋reports/审计-gdstyle存量债清点与清偿方案-2026-10-26.md（§三波次方案与 §六文档设计段裁定记录，裁定全部继续有效）。迭代 39/40/41 三批清偿后余 16 键：本批承接 11 键——board_view 6（_paint_cell 长度 139/分支 24/局部 22、循环内 new、类变量 32、公开方法 27）／level_runner 3（公开方法 50、类变量 30、_enter_node 返回 7）／battle_orchestrator 文件长 1035／adventure_runner 类变量 28；另 5 键走豁免通道另行讨论不在本批（main.gd 类变量 49、tune_sim_controller 循环内 await、board_cell_unit 类变量 30、standee_body 类变量 19、battle_orchestrator 类变量 38——其中三条已有架构豁免登记）。需求卡片 v2.0 定稿（零待裁点）：reports/需求卡片-gdstyle尾波清偿批-2026-10-29.md 设计段裁决 2026-10-29 用户裁闭合（D1 装板域拆新件 BoardInstaller 两修正·architecture v1.24 轴丙已落文／D2 悬停域不拆／D3 商店域候选 A／D4 断点域不拆／D5 五降值键豁免终局／D6 商店域并排编队——执行合同＝并排卡「level_runner 商店委托层拆除」v1.1，本卡不重复执行），零待裁点。预期两档：归绿 6 键（_paint_cell×3、循环内 new、_enter_node、文件长）；豁免终局 5 键（board_view 32/27、level_runner 50→33/30、adventure 28——批末按实测值落 architecture 豁免登记，键 7 实测值视并排卡时序）。本卡估时 3–4.25 工作日（并排卡 ≈1.5 工作日另计）。MC/数值零触碰（结构整改不改数值与 RNG 消费序）；battle_orchestrator 触 PARITY_TOUCH_FACES——实跑对拍须经用户批准、不得借机重锚。S13 键账对账在批末，基线重锚由用户发令人工 --refresh（预期降幅逾 10% 须 --force）。2026-10-29 用户再裁（零豁免延伸）：D5 五降值键改留债——本卡批末「落 architecture 豁免登记」步骤**不执行**（键留基线冻结禁恶化、不落豁免登记）；D2 悬停域与 D4 断点域改判拆件，由新条目「gdstyle 尾波补件批」承接（需求卡片已写），本卡对应任务不施工。
|
||||
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：文档设计已闭合＋已写卡＋已编迭代 42
|
||||
|
||||
#### gdstyle 尾波补件批——悬停域与断点域拆件（2026-10-29 登记，来源=会话提及）
|
||||
|
||||
**实况**：尾波卡 v2.0 裁去的 D2/D4 两拆件项经用户再裁恢复（2026-10-29，零豁免延伸＋D5 留债）。设计闭合凭据＝architecture.md v1.25（呈现层表 board_hover 行／核心层表 breakpoint_store 行／「冒险域拆分」节随动句）。需求卡片：reports/需求卡片-gdstyle尾波补件批-2026-10-29.md（v1.0 定稿零待裁点）。范围：board_view 拆 board_hover（11 函数族＋2 成员，`_r0` 留宿主）＋adventure_runner 拆 breakpoint_store（6 成员＋`BREAKPOINT_FIELDS` 27 键冻结函数族，`resume_adventure` 留宿主薄壳）。键账预期：board_view 类变量 32→约30、公开方法 27 持平、adventure_runner 类变量 28→约22——三键**留债**（键留基线冻结禁恶化、禁落豁免登记）。编队：待迭代 42 合回后编入；与呈现层状态件批同代时其先行（u.st 写入面改型后 hover 拆件在新面上施工）。估时 2.5–3.5 工作日。
|
||||
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：文档设计已闭合＋已写卡
|
||||
|
||||
#### 零豁免五键清偿批——S13 余量五键真修四卡（2026-10-29 登记，来源=会话提及）
|
||||
|
||||
**实况**：用户 2026-10-29 裁「不允许任何豁免」——S13 三条豁免注销（architecture.md v1.25 落文），五键真实修复至阈值内：main.gd 类变量 49→15（组合根注册面：ui_registry 一门面＋三域容器，约 867 处探针/系统测试引用改址 `main.ui.<域>.<句柄>`，7 别名/转发成员消灭）／battle_orchestrator 类变量 38→15（RoundCycle＋BattleFacts 两件，叠加迭代 42 轴丙 BoardInstaller；encounter 归 BattleFacts、attune 改判状态两成员随件）／board_cell_unit 类变量 30→10＋standee_body 类变量 19→10（各拆两独立文件，gdstyle inner-class 展平计数口径）／tune_sim 循环内 await 消除（process_frame 信号步进状态机；含**申报行为改动**一处：运行态收尾由每局置假还原为整批收尾单次置假——消除与 wd8/ui_tune_probe 断言面的静态矛盾，T0 实证定谳）。设计闭合凭据＝architecture.md v1.25＋五份设计文档：reports/设计-组合根注册面-2026-10-29.md、reports/设计-战斗编排类变量归约-2026-10-29.md、reports/设计-单格绘制状态件-2026-10-29.md、reports/设计-站桩状态件-2026-10-29.md、reports/设计-测速循环去await-2026-10-29.md。四卡＝组合根注册面批／战斗编排归约批／呈现层状态件批／测速循环批；编队待迭代 42 合回（battle_orchestrator／board_view 触面碰撞约束），具体迭代归属归编排段。gdstyle inner-class 计数截断缺陷已在册（architecture v1.25）——基线登记值欠估，各批按真实口径施工；各批全部合回后一次人工 --refresh --force 收账。
|
||||
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：文档设计已闭合＋待写卡
|
||||
|
||||
#### 数值标定窗口总挂账——原九条数值类条目合并（2026-10-28 登记，来源=会话提及）
|
||||
|
||||
**实况**：2026-10-28 用户令把九条数值类挂账合并为一条：削弱档位的最终数值／迭代 10 奖励重构联动欠账／调参批数值点评登记／三方向各自的解锁清单与定价／GP 经济换算失衡／天赋树实装批登记欠账余两件／商店独立刷新机制两参数／基线通关率越带加难杠杆扫描／成长系数节奏——原九条同步删除，内容全量迁入汇总文档，git 历史可考（本提交）。共同背景：M4 数值批卡已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝各条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡——本条沿用该裁定，重启条件＝用户发令开窗口。合并动机＝九条共享同一重启条件与同一执行形态（窗口内一次 MC 批量统一覆盖各条对比需求：全冒险期望＋奖励期望＋对拍锚重锚），分散登记徒增维护面。逐条挂账明细、裁定史与相关文档见汇总文档。
|
||||
|
||||
Reference in new issue
Block a user