chore(代码卫生): 文件头零工作日志红线落文+全仓头注变更叙事清偿（2026-10-15 用户令）

- CLAUDE.md 硬性红线新增「文件头零工作日志」；code-conventions.md 新增 §1.4.1（含反面案例） - 全仓 .gd 文件头注清偿：删除全部带日期条目、批次叙事段与迁移退役叙述，保留并改写为现在时的职责、接口契约、GDD 锚内容（main.gd 头注 42→31 行、save_manager.gd 49→45 行） - 纯注释改动零行为变更，按用户令免测试免冒烟
2026-10-15 04:08:38 +08:00
1 parent d5eea25f9c
commit 5f9d8e7b77
@@ -13,27 +13,25 @@
 #    封顶的执行归本类）；
 # ④ 关卡结束 = _on_level_finished（LevelRunner.level_finished 到达——结果 + 生命终值 + 节点位置）。
 #
-# 接口漂移清偿登记（06 清单①②③⑥⑦——LevelRunner 侧同批登记）：①种子域归本类
-# （start_adventure 调 rng.new_adventure 全冒险恰一次；LevelRunner 冒险模式不重播种）；
-# ②生命账本归本类（共享 _ledger）；③恢复兑付执行归本类（_rest_handler）；⑥收束先清库后宣布——
-# 现行无关卡域库存（格面资源批 2026-09-15 后为空集），战斗结束 retire_mapping + despawn_all 先于
-# battle_finished 即事实清库，不另设空接口；⑦失败结算归本类（LevelRunner 只上报结果）。
+# 职责切分：主种子注入恰一次归本类（start_adventure 调 rng.new_adventure 全冒险恰一次；
+# LevelRunner 冒险模式不重播种）；生命账本归本类（共享 _ledger）；恢复兑付执行归本类（_rest_handler）；
+# 收束先清库后宣布——战斗结束 retire_mapping + despawn_all 先于 battle_finished 即事实清库，
+# 不另设空接口；失败结算归本类（LevelRunner 只上报结果）。
 #
 # 收束次序登记（大奖励兑付时点——冒险结构.md「关卡大奖励」）：关卡节点地图先清库、后宣布关卡
 # 结束（次序不可换）；大奖励在宣布之后、下一关开始之前兑付——本类 _on_level_finished 兑付、
 # continue_to_next_level 开始下一关，两步间为呈现层大奖励屏（冒烟/自动路径立即确认）。
 # 结算受理只算一次（契约）：state != "running" 的关卡结束宣布与放弃请求一律拒绝并留诊断，
 # 账本与摘要零变化。
-# 停点前移批（2026-09-23，用户拍板「关卡开始即出节点图选路、选节点才进战斗」）：每关开始 =
-# 入口选路停点——_start_current_level 以 defer_entry 起关，level_started 之后才 present_entry_choice
-# （信号顺序契约：呈现层先重取 runner 实例，选路口才不会被空防御丢弃）；pick 入口候选走同一
-# _enter_node(entry)、呈现零 RNG 消耗——与旧「start 直进首战」逐位等价，测量面零漂移。
-# 关卡切换（continue_to_next_level）后新 LevelRunner 实例重新走 defer 流程；abandon 在入口停点
-# 天然非战斗期（current_battle 为空）——受理语义与选路停点一致。
+# 入口选路停点：每关开始 = 选路停点——_start_current_level 以 defer_entry 起关，level_started 之后才
+# present_entry_choice（信号顺序契约：呈现层先重取 runner 实例，选路口才不会被空防御丢弃）；
+# pick 入口候选走同一 _enter_node(entry)，呈现零 RNG 消耗；关卡切换（continue_to_next_level）后
+# 新 LevelRunner 实例重新走 defer 流程；abandon 在入口停点天然非战斗期（current_battle 为空）
+# ——受理语义与选路停点一致。
 # 纪律：ADR-0001 S6——连 runner 信号一律 _forward_* 方法 Callable（禁 lambda 捕获 self 成环）；
 # Core 层禁 UI 引用；数值零字面量——level_clear_hp_bonus / keystone_per_level 只读 db.adventure，
 # 基础上限只读 db.hero。
-# 断点续玩（迭代 8 卡①）：save_manager 经 set_save_manager 注入（缺省 null = 不写断点——模拟/
+# 断点续玩：save_manager 经 set_save_manager 注入（缺省 null = 不写断点——模拟/
 # 冒烟零触达零扰动）；停点快照挂 choices_presented 转发点（选路停点=唯一可恢复停点形态，战斗中
 # 不存）；三结局 _settle 清断点；resume_adventure 经 rng.restore_adventure 回填「主种子+计数器」
 # ——续玩从断点号位精确续接原随机时间线。
@@ -1,7 +1,6 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# 同调位求值服务（迭代 21 天赋树实装批 T4 换代——槽位收编 Q2 裁甲：槽位数量=树上同调位节点点亮数，
-# 旧「按击杀 Boss 次数/通关次数自动涨」谓词表判定链随批删除〔attunement_growth.tres 与表访问器
-# 随 T5 清退；boss_kill_count/clear_count 计数域保留——各有非槽位硬消费，见卡片 T0⑥〕）。
+# 同调位求值服务（槽位数量=树上同调位节点点亮数；无谓词表判定链——
+# attunement_growth.tres 与表访问器不存在；boss_kill_count/clear_count 计数域保留——各有非槽位硬消费）。
 # 纯函数零副作用；attune=off 纪律：零 await、零 RNG、零写副作用。
 class_name Attunement
 extends RefCounted
@@ -1,27 +1,26 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2）
 # Date: 2026-09-10
-# 战斗结算编排中枢：轮次生命周期唯一 owner · 五段结算（授予→增益/减益→战斗→衰减→判定——2026-09-15
-# 格面资源批，道具窗口/道具段随可选类删除下线）· 授予段极性路由（「动作 × 格型」矩阵：开安全格/标中旗
+# 战斗结算编排中枢：轮次生命周期唯一 owner · 五段结算（授予→增益/减益→战斗→衰减→判定）·
+# 授予段极性路由（「动作 × 格型」矩阵：开安全格/标中旗
 # = 正向，开雷格/标错旗 = 负向；结算队列 + 抵消过滤——标旗后被撤旗以轮末在场旗为基线不判）·
 # 10 类行协议可回放步骤流（零 await；随机消费三处皆封闭流——开战遭遇骰〔初始化随机〕+ 技能摇号
-# behavior_roll〔回合内、开轮时点、步骤流之外——敌人技能池批 2026-09-16〕+ 护甲等级掷点〔回合内、
+# behavior_roll〔回合内、开轮时点、步骤流之外〕+ 护甲等级掷点〔回合内、
 # 步骤流之内〕；同种子同输入逐位复现）· 高光双落（完美排雷 ×2 / 标中旗 highlight）·
 # Waiting 相位结算触发（不依赖事件到达序）。
-# GP+商店房实施批（2026-09-21）：授予段极性路由增 GP 型兑付（effect_id gp_gain/gp_loss → 战斗内缓冲
-# escrow 记账，不入钱包不入增益容器）；战斗结束分支掷 gp_drop 封闭流（每战斗末恰一 scope）出
+# GP 型兑付：授予段极性路由含 GP（effect_id gp_gain/gp_loss → 战斗内缓冲 escrow 记账，不入钱包
+# 不入增益容器）；战斗结束分支掷 gp_drop 封闭流（每战斗末恰一 scope）出
 # gp_dropped = 掷定 + level_gp_bonus + escrow 随 battle_finished 上抛——战斗域零 GP 状态持久。
-# 伤害管线单据化批（2026-09-24 用户三裁决，06 台账 148）：伤害兑付全部收口 伤害控制器（DamageController
-# 单点管线）——本类六调用点（主角先手/敌方伤害技/棋盘克制直伤/群伤/反噬/地形变异）退化为开单点
-# （流程决定何时开单给谁开单；单据怎么算归控制器）。结账时机开关在控制器 policy：IMMEDIATE（A＝开单
-# 即结，逐位等价迁移前行为——回切位）/ SEGMENT（B＝攒批到段界 flush：战斗段尾统一兑现）。
-# 地图伤害账殿后批（案C 2026-10-06 用户裁——「主角先手」歧义质询触发）：授予段不再当场兑付任何伤害——
-# 全部伤害形态单据经 _submit 暂存闸入 _deferred_board（保授予段事件序），战斗段「主角先手→逐敌还手」后
-# 补提交统一结账；主角死于敌方还手 → 暂存单整体不兑，逐单留「未生效（主角已倒下）」行（forfeit=hero_down）。
+# 伤害管线：伤害兑付全部收口 DamageController 单点管线——本类六调用点（主角先手/敌方伤害技/
+# 棋盘克制直伤/群伤/反噬/地形变异）为开单点（流程决定何时开单给谁开单；单据怎么算归控制器）。
+# 结账时机开关在控制器 policy：IMMEDIATE（开单即结）/ SEGMENT（攒批到段界 flush：战斗段尾统一兑现）。
+# 地图伤害殿后：授予段不当场兑付任何伤害——全部伤害形态单据经 _submit 暂存闸入 _deferred_board
+# （保授予段事件序），战斗段「主角先手→逐敌还手」后补提交统一结账；主角死于敌方还手 → 暂存单
+# 整体不兑，逐单留「未生效（主角已倒下）」行（forfeit=hero_down）；
 # 死亡事件 = 单位容器 unit_died（单位自行宣布）→ 控制器作废该敌未结单据〔死亡即不动手〕/ 主角死终止兑付。
-# 切片登记：① 事件总线载体 = 直连信号（实现期 ADR 项，provisional）② Waiting 相位刷新通道 2026-09-15 用户拍板整体
-# 拆除（仅 Active 挖掘期受理）③ 效果行协议 = 授予段逐 grant 行 + 增益/减益段续存实例组合行。
-# 实现 GDD：design/gdd/systems/战斗循环/战斗结算.md（v0.7 格面资源批——registry 追溯锚）
+# 切片登记：① 事件总线载体 = 直连信号（实现期 ADR 项，provisional）② Waiting 相位无刷新通道
+# （仅 Active 挖掘期受理）③ 效果行协议 = 授予段逐 grant 行 + 增益/减益段续存实例组合行。
+# 实现 GDD：design/gdd/systems/战斗循环/战斗结算.md（registry 追溯锚）
 class_name BattleOrchestrator
 extends RefCounted

@@ -1,9 +1,9 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-10-02（code-quality 修复批 T5——ConfigDb 拆分：跨表校验协作类，自 config_db.gd 迁出）
+# Date: 2026-10-02（ConfigDb 拆分——跨表校验协作类，自 config_db.gd 迁出）
 # 职责单一化（Rule 6 校验双通道的跨表一侧）：_cross_validate 全域（悬空引用/池护栏/节点精确行/
 # 技能池构成）+ validate_skill_pool_links（冒烟直验独立入口）。ConfigDb autoload 门面保持——
 # load_tables 调用点与冒烟直验经门面同名方法，公有签名零变化。
-# 诊断通道注入：跨表校验的行级错误经 push_diag: Callable 外发（门面传方法引用 push_diag——迭代 27 T6 Callable 换装）——
+# 诊断通道注入：跨表校验的行级错误经 push_diag: Callable 外发（门面传方法引用 push_diag）——
 # 本类零 ConfigDb 依赖（无状态纯校验器，装载序上先于成员赋值执行的前提保持）。
 # 迁移注记：validate_skill_pool_links 的 status_table 显式入参纪律照抄（装载通道传 loaded 表，
 # 冒烟直验传门面 status_effects；null 时 side 守卫跳过）——返回错误列表不进诊断通道，消费面归调用方。
@@ -1,13 +1,12 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # Date: 2026-09-24
-# 伤害控制器：伤害单据唯一兑付管线——伤害管线单据化批（2026-09-24 用户三裁决，06 台账 148）。
-# 背景：伤害此前无对象抽象——五族来源（主角攻击/敌方行动/棋盘克制直伤/棋盘群伤/反噬地形）在
-# 战斗编排器内各自内联组装管线；类型轴（attack_type）与算术层（DamageMath）早已收口，缺的是
-# 「一次伤害」这个对象与单点管线。本类补上：五调用点退化为开单点（流程决定何时开单、给谁开单），
-# 本类决定一张单经过哪几步（掷点 → 折扣 → 暴击 → 克制点数 → 池乘区 → 落地下限 → 交付）。
-# 用户三裁决落位：
-# ① 兑现时机双模式（结账时机开关）：POLICY_IMMEDIATE（A——开单即结，逐位等价 2026-09-24 前现状
-#   行为，回切位）/ POLICY_SEGMENT（B——开单攒批、段界统一结账；流程在授予段尾与战斗段尾调 flush）。
+# 伤害控制器：伤害单据唯一兑付管线。
+# 分工：五族伤害来源（主角攻击/敌方行动/棋盘克制直伤/棋盘群伤/反噬地形）的调用点只决定
+# 何时开单、给谁开单；本类决定一张单经过哪几步（掷点 → 折扣 → 暴击 → 克制点数 → 池乘区 →
+# 落地下限 → 交付）。
+# 设计要点：
+# ① 兑现时机双模式（结账时机开关）：POLICY_IMMEDIATE（A——开单即结，回切位）/ POLICY_SEGMENT
+#   （B——开单攒批、段界统一结账；流程在授予段尾与战斗段尾调 flush）。
 #   切换＝改 policy 一个值，管线/单据/数据表零改动。
 # ② 目标 = 结账时刻照 target_rule 看现场解析（front_alive_enemy = 行主序最前存活敌 / hero /
 #   all_alive_enemies）——开单时只写规则不冻结对象。
@@ -1,9 +1,9 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2）
 # 实现 GDD：design/gdd/systems/战斗循环/战斗结算.md（系统 ID B1·战斗结算——registry 追溯锚，命名规范见 CLAUDE.md）
-# 战斗结算·战斗段伤害公式族（零状态纯算术宿主——规范 1.2「工具性纯函数挂明确宿主类」；
-# 自 battle_orchestrator 拆出 2026-09-13，封装审查 O3）。池读取与表值读取仍归 战斗结算，本类只做算术。
-# 护甲等级掷点批（2026-09-16）：掷点查档与吃掷点分量算术收编本类（判定式参数化——表值零字面量纪律不变）。
+# 战斗结算·战斗段伤害公式族（零状态纯算术宿主——规范 1.2「工具性纯函数挂明确宿主类」）。
+# 池读取与表值读取仍归 战斗结算，本类只做算术；掷点查档与吃掷点分量算术在本类
+# （判定式参数化——表值零字面量纪律不变）。
 class_name DamageMath
 extends RefCounted

@@ -1,9 +1,8 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
-# Date: 2026-10-06（迭代 17 卡⓪ 内容数据驱动扩展批 T1——效果引擎框架）
-# 内容数据驱动扩展（需求卡片 design/research/需求卡片-内容数据驱动扩展批-2026-10-06.md；设计权威
-# design/research/研究-内容数据驱动扩展架构-2026-10-06.md）：把「内容的效果行为」从散布在结算
+# Date: 2026-10-06（效果引擎框架）
+# 内容数据驱动：把「内容的效果行为」从散布在结算
 # 代码里的硬编码分支搬进内容数据行三个字段——订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）
-# ——由本解释器统一执行。完成后加一件「已有效果类型」的新专长/新秘宝=只改 .tres 数据行，零代码。
+# ——由本解释器统一执行。加一件「已有效果类型」的新专长/新秘宝=只改 .tres 数据行，零代码。
 # 架构模型（R1 裁决）：发布订阅——结算管线同步 emit 事件（无队列无异步，确定性优先）→ 本引擎遍历
 # 持有订阅集匹配 → 返回按声明序排列的效果命中（do 列表），由发射点按组合规则施加。
 # 多订阅与冲突（R3 裁决）：一事件多订阅=常态；冲突在效果类型层用组合规则封死（§3.4 六族）；遍历序
@@ -4,31 +4,26 @@
 # 关卡节点地图（v1.0 图版落地——节点+连线，连线只朝前进方向，唯一入口，Boss 恒唯一终点）：
 # 关卡域生命周期唯一编排者——HP 跨战斗携带、恢复点节点兑付、关卡末收束。
 # 行进纪律（零自动推进）：到达即兑付；兑付后确认才出现选路口——战斗胜利与奖励/恢复确认一律经
-# choices_presented 进入选路态，玩家 pick_next_node 显式选下一跳（接口漂移清偿：战斗胜利不再自动推进、
-# continue_after_node 泛化为兑付确认——选路确认归 pick_next_node）。
-# 2026-09-15 格面资源批：可选类道具与库存整体删除——奖励点节点内容随功能道具渠道（P1，渠道未定）悬置为
-# 直通节点（零兑付）；战斗各自持有 地图战斗资源 容器（映射随战斗退役，无跨战斗状态可延续）。
+# choices_presented 进入选路态，玩家 pick_next_node 显式选下一跳。
+# 奖励点节点内容悬置为直通节点（零兑付——内容渠道未定）；战斗各自持有 地图战斗资源 容器
+# （无跨战斗状态可延续）。
 # Core 层零 UI 依赖（headless 可跑完整关卡——数据配置 Rule 7）。
-# 测试专用：hero_atk_pct/hero_hp_pct 数值覆盖（调整板模拟天赋树——正式侧归元进度，切片不落盘）。
-# E4 收口（2026-09-13）：覆盖值经 encounter 显式传入战斗（不再写 db.hero 表——表值运行期不可变，
-# 双基线同步/双写叠加 6→18→54 整类隐患随表写一并移除）。
+# 测试专用：hero_atk_pct/hero_hp_pct 数值覆盖（调整板模拟天赋树——正式侧归元进度，切片不落盘），
+# 覆盖值经 encounter 显式传入战斗——零表写，db.hero 运行期只读。
 # 对应 GDD：关卡节点地图 v1.0（图版结构——本文件为 P1 批实现位；命名规范见 CLAUDE.md）
-# GP+商店房实施批（2026-09-21）：GP 冒险钱包（战斗完成入账 clamp ≥0 · 冒险收束清零）+ 统一冒险
-# 加算区 bonus{atk,max_hp,armor_class}（商店购买与关卡大奖励共用账本——战斗开始参数 = 基础表值 +
-# 加算区，调试浮窗百分比在加算之后乘）+ 商店房节点兑付（开覆盖层/购买出账/离开回选路确认——
-# 复用 continue_after_node 兑付确认纪律，零自动推进）。
-# 冒险结构实现批（2026-09-21）——接口漂移清偿登记（06 清单「切片行进代码与定稿的接口漂移」①②③⑥⑦）：
-# ① 种子域归冒险结构：start_level 旧路径（单关测试模式）保留自调 rng.new_adventure；新路径
-#    start_level_external（冒险模式）不重播种——主种子注入恰一次归 AdventureRunner.start_adventure。
-# ② 生命账本归冒险结构：hero_hp/gp 改属性落 _ledger 字典——冒险模式经 start_level_external 注入
-#    AdventureRunner 共享账本（Dictionary 引用共享），单关模式 = 本实例私有账本；战斗结果上报语义 =
-#    runner 经共享账本属性直写（接口②——战后生命终值已在本类 _on_battle_finished 回写账本）。
-# ③ 恢复数学抽成单一路径 rest_heal_amount——冒险模式经 _rest_handler 回调（AdventureRunner.apply_rest，
-#    接口③治疗封顶回报执行体归冒险结构）；单关模式默认内置。公式逐位一致，零行为变更。
-# ⑥ 收束先清库后宣布——现行无关卡域库存（格面资源批 2026-09-15 可选类删除后为空集），战斗结束
-#    retire_mapping + despawn_all 先于 battle_finished 发出即事实清库，不另设空接口（假契约）。
-# ⑦ 倒下的失败结算归冒险结构：本类只发 level_finished（每战结果上报语义），失败结算由
-#    AdventureRunner._on_level_finished 执行；GP 冒险收束清零同步归冒险结构（本类冒险模式不关钱包）。
+# GP 冒险钱包：战斗完成入账（clamp ≥0）、冒险收束清零。统一冒险加算区 bonus{atk,max_hp,armor_class}：
+# 商店购买与关卡大奖励共用账本——战斗开始参数 = 基础表值 + 加算区（调试浮窗百分比在加算之后乘）。
+# 商店房节点兑付：开覆盖层/购买出账/离开回选路确认（复用 continue_after_node 兑付确认纪律，零自动推进）。
+# 种子域：单关模式 start_level 自调 rng.new_adventure；冒险模式 start_level_external 不重播种
+# （主种子注入恰一次归 AdventureRunner.start_adventure）。
+# 生命账本：hero_hp/gp 属性落 _ledger 字典——冒险模式经 start_level_external 注入 AdventureRunner
+# 共享账本（Dictionary 引用共享），单关模式 = 本实例私有账本；战斗结果上报 = runner 经共享账本属性
+# 直写（战后生命终值在本类 _on_battle_finished 回写账本）。
+# 恢复数学单一路径 rest_heal_amount——冒险模式经 _rest_handler 回调（AdventureRunner.apply_rest），
+# 单关模式默认内置。
+# 收束：战斗结束 retire_mapping + despawn_all 先于 battle_finished 即事实清库（关卡域库存现行空集）。
+# 失败结算：本类只发 level_finished（每战结果上报语义），失败结算由 AdventureRunner._on_level_finished
+# 执行；GP 冒险收束清零同步归冒险结构（本类冒险模式不关钱包）。
 class_name LevelRunner
 extends RefCounted

@@ -5,11 +5,11 @@
 # 元进度账本服务（Core 层零 UI、纯被动服务——同 StatusContainer 先例：零信号零外发，读存档算账）。
 # 职责三件：① 属性锻造定价与购买（几何递增——tier 级价格 = 迭代 floor(p × ratio/100)，tier 0 =
 # base_price，floor 单一取整对齐 round_direction 纪律）；② 道具工坊解锁（渠道由 meta.tres channel
-# 字段声明、判定量换算单点 _workshop_progress——2026-09-21 用户拍板可替换轴；首版 = 总通关次数，
-# 钥石直购价随定价批后补最终双渠道；六件局内效果归 Alpha 秘宝重设计批，本类只有解锁状态）；
+# 字段声明、判定量换算单点 _workshop_progress——可替换轴；现行 = 总通关次数，
+# 钥石直购价后补最终双渠道；六件局内效果不入本类（只承载解锁状态）；
 # ③ 冒险收束入账（Boss 两档 = 表值 first_kill/repeat_kill，首杀标记读存档判first；调 SaveManager
 # apply_adventure_summary 入账并附 boss_drops 副本——复盘可归因，验收 5）。
-# 注入面：hero_override() = 树生命/命中淬炼 flat + 锻造路线加值（当前选中武器/甲——迭代 23 T4 换代，
+# 注入面：hero_override() = 树生命/命中淬炼 flat + 锻造路线加值（当前选中武器/甲——
 # 全零 = 白板合法态；override 不写表——表运行期只读，消费方 AdventureRunner/LevelRunner 经冒险开始
 # 参数面显式传参）。
 # 纪律：数值零字面量——价格/档位/阈值/两档金额只读 db.meta_* 访问器；存档只经 SaveManager 访问器，
@@ -3,8 +3,8 @@
 # Date: 2026-09-10
 # 排雷玩法规则引擎：零随机/零表读取/零 UI——输入 = 棋盘生成 产物 + 意图序列，输出 = 三事件流。
 # 核心契约：install 四不变式 · 初始展开 = R₀ 恰等 · 连锁不越旗 · 批次语义序仲裁（cleared > stop > 其余）。
-# 旗语义（插旗不可逆批 2026-09-19 用户拍板全套落地）：旗 = 一次性承诺——挖旗格放行（本格旗事务内
-# 隐式退役、轮末不判），拔旗动作退役（flag_pull 出目录）。
+# 旗语义：旗 = 一次性承诺——挖旗格放行（本格旗事务内
+# 隐式退役、轮末不判）；无拔旗动作（flag_pull 已出目录）。
 # 实现 GDD：design/gdd/systems/排雷循环/排雷玩法.md（系统 ID A2·排雷玩法——registry 追溯锚，命名规范见 CLAUDE.md）
 class_name MinesweeperRules
 extends RefCounted
@@ -7,8 +7,8 @@
 # 极性不在资源内：「动作 × 格型」矩阵的字典定义归 GDD、路由执行归 战斗结算 授予段
 # （本类只提供 polarity_row 的（类型, 极性）→ 字典行查询面）。
 # 切片登记：取号约定 = randi_range(0, W-1)（实现期 ADR 事实，切片内恒定）；
-# 区间行 power roll 在身份批内追加取号（伤害量值区间批——快照 power = roll 值，授予期零随机不变）。
-# 实现 GDD：design/gdd/systems/战斗循环/地图战斗资源.md（v0.4 格面资源批——registry 追溯锚）
+# 区间行 power roll 取号语义：快照 power = roll 值，授予期零随机不变。
+# 实现 GDD：design/gdd/systems/战斗循环/地图战斗资源.md（registry 追溯锚）
 class_name RewardEconomy
 extends RefCounted

@@ -1,15 +1,15 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2）
 # Date: 2026-09-10
-# RngService autoload（数据配置）——统一随机流单点（Rule 5；ADR-0007 裁丙 2026-09-27：七流并一+全事件日志）。
+# RngService autoload（数据配置）——统一随机流单点（Rule 5；ADR-0007 裁丙：七流并一+全事件日志）。
 # 玩法代码禁止 randomize()/自建 RandomNumberGenerator。
 # 实现 GDD：design/gdd/systems/表现与支撑/数据配置.md（系统 ID D2·数据配置——registry 追溯锚，命名规范见 CLAUDE.md）
 # 统一流口径：唯一主种子 + 唯一派生（单盐）+ 唯一全局取数计数器；open_stream 参数降格为「用途标签」——
 # 不参与派生，只进事件日志（并流前七条流名全部保留为合法标签）。号位语义（ADR-0007 后果，用户裁决承接）：
 # 全局 scope 只回答「全局第 N 次取数」，不再回答「第 N 次某类事件」——路线依赖为已知代价，单点定位能力由事件日志承载。
-# 派生公式（R3 2026-09-19 + 统一流 2026-09-27）：derive = mix64(SINGLE_SALT XOR wrap64(master + scope×GOLDEN))——
-# splitmix64 finalizer 变体终末混淆，见 _mix64 注记；并流前分盐黄金向量随批作废，新向量按单盐重登记（scope 0-3 与
-# 旧 board_gen 向量逐位连续——单盐沿用原 board_gen 盐）。
+# 派生公式（R3 + 统一流）：derive = mix64(SINGLE_SALT XOR wrap64(master + scope×GOLDEN))——
+# splitmix64 finalizer 变体终末混淆，见 _mix64 注记；scope 0-3 与旧 board_gen 向量逐位连续
+# （单盐沿用原 board_gen 盐）。
 # 取号语义：全新冒险首个 open_stream = 全局 scope 0；事件日志逐次落盘 user://logs/rng_log_<master_seed>.jsonl。
 class_name RngServiceCore
 extends Node
@@ -10,31 +10,27 @@
 # 域清单与 owner 分工（内容 owner 定口径，本类照单承载、不替任何人定义进度）：
 #   keystone_balance / item_unlocks / level_clear_counts / boss_first_kill
 #     —— 内容 owner = 元进度.md（钥石余额/道具工坊/通关次数/首杀标记；属性锻造柜台已退役
-#     〔迭代 21 攻防所有权切分——forge_levels 域随批清退，生命唯一入口=树脊柱、攻/AC 唯一入口
-#     =锻造工坊路线，见 meta_progression.gd 注入面〕）
+#     ——生命唯一入口=树脊柱、攻/AC 唯一入口=锻造工坊路线，见 meta_progression.gd 注入面）
 #   boss_kill_count / attunement_equipped / attune_refresh_level
-#     —— 内容 owner = 秘宝.md（同调位账本，M-4 迭代 11 第①批 T2）：Boss 击杀总数〔含重复〕=
-#     生涯页终身计数与迭代 22 解锁条件消费面〔原 attunement_growth 谓词表计数源职责随迭代 21
-#     T4 槽位收编退役——槽位数量=树同调位节点点亮数〕；装配关系 = 局外进度事实（元进度域同族
+#     —— 内容 owner = 秘宝.md（同调位账本）：Boss 击杀总数〔含重复〕=
+#     生涯页终身计数与迭代 22 解锁条件消费面〔槽位数量=树同调位节点点亮数〕；装配关系 = 局外进度事实（元进度域同族
 #     ——非契约 2 反面清单的「局内道具库存」，后者=冒险进行中瞬态）；attune_refresh_level = Y 刷新
 #     升级购买等级
-#   tree_nodes / fork_sides / tree_struct —— 内容 owner = 天赋树.md（迭代 12 T9 建域、迭代 21 T5
-#     换代承载：tree_nodes=node_id→已购等级；fork_sides=fork_group→激活态；tree_struct=树结构
+#   tree_nodes / fork_sides / tree_struct —— 内容 owner = 天赋树.md（tree_nodes=node_id→已购等级；fork_sides=fork_group→激活态；tree_struct=树结构
 #     版本标记〔缺失=换代前结构→加载时树域破坏性废弃重置——开发阶段无迁移，Q3 用户裁〕）
-#   forge_routes —— 内容 owner = 锻造工坊.md（迭代 23 T5：levels 六路线等级+unlocked 直购解锁清单
+#   forge_routes —— 内容 owner = 锻造工坊.md（levels 六路线等级+unlocked 直购解锁清单
 #     +weapon/armor 当前选中标记；**无特效域**（裁 6——满级特效本期不做）；解锁态派生不落档：
 #     初始持有〔表 initial_owned〕∨ 直购〔unlocked〕∨ 练满前一档〔levels[prereq]≥cap〕——派生单点
 #     在 MetaProgression.forge_route_unlocked；旧档缺键补齐=初始持有态，开发阶段禁迁移禁折算）
 #   breakpoint.attunement_charges（主动件充能余量）——每冒险重置语义的断点瞬态附随件，内容装配归
-#     AdventureRunner（随 T6 接线入断点），本类照单承载；契约 2 域界注记同断点域豁免先例
+#     AdventureRunner（断点域接线），本类照单承载；契约 2 域界注记同断点域豁免先例
 #   recent_summaries（冒险摘要五件事副本）—— 内容 owner = 冒险结构.md（摘要五件事口径）
 #   adventure_total / adventure_cleared（生涯终身计数域）—— 内容 owner = 生涯.md（跨局汇总页
 #     数据源：总局数开局即计〔三结局同经收束恰计一次，含放弃与失败〕/通关局数三关全通才计 1
-#     ——判定字段 summary.cleared；写入唯一经 apply_adventure_summary，迭代 18 卡④）
+#     ——判定字段 summary.cleared；写入唯一经 apply_adventure_summary）
 #   breakpoint（冒险断点快照——停点粒度续玩域）—— 内容 owner = 冒险结构.md（七字段拍板面
 #     +恢复必需附随件：主种子/取数计数器/钥石累计/已到节点序/道具库存）；契约 2 域界反面清单
-#     只约束 meta 永久进度域——断点域=冒险进行中瞬态快照，生命/GP/道具库存按拍板面入域
-#     （M-3 迭代 8 卡①，存档序列化.md 契约 2 随批修订）
+#     只约束 meta 永久进度域——断点域=冒险进行中瞬态快照，生命/GP/道具库存按拍板面入域。
 #   承载 owner = 存档序列化.md（格式/时机/迁移/损坏/域登记）
 #
 # 契约登记（存档序列化.md 核心规则——违反即返工）：
@@ -1,17 +1,16 @@
 # VERTICAL SLICE - NOT FOR PRODUCTION
 # Validation Question: 玩家能否无指导在一场完整战斗中经历「开战→挖掘规划→轮末结算逐行兑现→胜/负」并逐行归因（P2）
 # Date: 2026-09-16
-# 敌人系统·战斗单位容器：hero/enemy 统一受伤死亡接口 · 实例池状态机（敌人技能池批——2026-09-16 用户拍板，
-# 设计权威 proposal-skill-pool.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 技能池节〕 v1.0）· 行值快照抗热重载 · 编排被动零事件。
-# 实例池三层对象（proposal §2.2）：定义层技能行（SkillTable）· 定义层池模板（EnemyTable.pool）·
+# 敌人系统·战斗单位容器：hero/enemy 统一受伤死亡接口 · 实例池状态机（设计权威=敌人系统.md 技能池节）
+# · 行值快照抗热重载 · 编排被动零事件。
+# 实例池三层对象：定义层技能行（SkillTable）· 定义层池模板（EnemyTable.pool）·
 # 本类持实例层——spawn 把模板快照为各实例池（冷却全零），此后冷却递减/待发动作/保底计数各自独立。
-# 零随机零事件纪律（proposal 约束二）：随机消费只在 战斗结算换算层抽签器（SkillLottery + behavior_roll 子流）；
-# 本类只收确定结果（set_pending_action）并管理确定性状态（冷却递减、执行上报）。旧行为环
-# （pattern 环数组 + steps 指针 + heavy_multiplier）随技能池整体退役——拍结构保留（每结算每存活敌恰行动一次、
-# 行序、先作用后推进），"轮到什么"改由开轮摇号决定（死亡即不动手：摇定后兑现前死亡 → 本拍作废、不 commit）。
-# 切片登记接口漂移：heal() 为切片新增（战斗结算 治疗 clamp 需要写入口）；spawn 签名 +3 参数（E4/区间批/
-# 遭遇骰——正式侧 GDD/registry 修订随对应批）；迭代 23 T2 +2 参数（hero_attack_type/hero_armor_type——
-# 两根类型轴注入面：hero.tres 静态表两轴删除〔契约 2 所有权移交〕，空串=锻造工坊配置默认值回退）。
+# 零随机零事件纪律：随机消费只在 战斗结算换算层抽签器（SkillLottery + behavior_roll 子流）；
+# 本类只收确定结果（set_pending_action）并管理确定性状态（冷却递减、执行上报）。
+# 拍结构：每结算每存活敌恰行动一次、行序、先作用后推进；"轮到什么"由开轮摇号决定
+# （死亡即不动手：摇定后兑现前死亡 → 本拍作废、不 commit）。
+# 接口：heal() = 治疗写入口（战斗结算 治疗 clamp 用）；spawn 签名含 hero_attack_type/hero_armor_type
+# 两根类型轴注入面（hero.tres 静态表不持两轴——契约 2 所有权归锻造工坊，空串=锻造工坊配置默认值回退）。
 # 实现 GDD：design/gdd/systems/战斗循环/敌人系统.md（registry 追溯锚，命名规范见 CLAUDE.md）
 class_name UnitContainer
 extends RefCounted