refactor(代码术语): 卡① flag→seal 全族换代＋game/ 禁用词清扫（迭代 31 卡①）
标识符面：flag_*→seal_ 族（含 Godot 信号 flag_judged→seal_judged 与连接/回调同名、 FACTS 两键 flags_count→seals_count／dug_under_flag→dug_under_seal 全链、 .tres 键名与 schema .gd 同批同步）；显式豁免零改动=size_flags_*（Godot 布局属性）＋_fatal_flag。 中文面：金币→GP（金币袋→GP 袋）／插旗→封印／雷格→危险格／惩罚格→危险格／旗→封印·封印印记族， game/ 内 *.gd/.tres/.md/.json 四类禁用词与 flag 双双零命中（V1/V4）。 守卫字面量不动（被检查的禁字不是使用）：smoke_all V21 零「雷/旗」检查面、 ui_font_asset_test 字形集攻/雷/旗/封 保持原断言逻辑。 代拍板：板面单字槽 glyph「旗」→「封」（禁字纪律＋单字位宽，消费面四处同名随动）。 素材换代（2026-10-18 用户裁案甲）：assets/art/board/flag_seal.png→seal_mark.png（素材不入 git， 盘上改名＋导入重刷），代码两处 res:// 字符串＋COL_FLAG/CURSOR_FLAG 常量同步， 闸件四处随批（run_all_gates.sh/render_gate.sh/golden_baseline_refresh.sh/path_check.py）。 anchor.json 键名手改，重锚与改前改后 diff 随本卡收口（同裁案甲）。 基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click 存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。 改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
This commit is contained in:
DKChan committed
1 parent
ed2dfaf66f
commit
32fdf957fd
79 files changed
+899
-899
No files matched your search
+28
-28
@@ -56,7 +56,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
- **v1 在范围内**：D2（10 表 + ConfigDB + RngService）· A1（single_subset 求解器 + 双判据验收）· A2 · A3（AP8/RAP）· A4（迷雾，L2）· B1（七段结算 + 13 类行协议 + 高光双落）· B2（grub/ambusher/伏击池 cap4）· B3（四行状态容器）· B4（install 预分配/F5 保底/道具窗口）· D1-lite 程序化呈现
|
||||
- **v2 追加**：LevelTable（线性节点链数据表）· C1-lite 关卡推进器 `level_runner.gd`（原 c1_level_runner，2026-09-11 领域命名批更名）（关卡域生命周期：共享 B4 关内延续 + HP 跨战斗携带 + 奖励/恢复节点兑付 + 关卡末清库）· Boss 遭遇行（Dmax=4）· 节点奖励 API（B4 `grant_node_active`）· **测试用角色数值调整板**（atk%/hp% 覆盖 + 批量模拟，模拟天赋树——正式侧归 C4）
|
||||
- **裁剪不变**：A5 / C1 路径分支选择（用户拍板线性）· C2–C4 / B5 战斗动画 / D3–D6 / A1 黄金向量与 F4 批量工具 / gdUnit · 注：标错惩罚（原 A2 OQ1）已于 2026-09-12 批上线（标空旗三选一确定性反噬：暴走 / 伏击 +2 层 / 失衡，坐标×板序号派生、不走随机流），本批（2026-09-15）已收编进现行文档，不再属裁剪项
|
||||
- **裁剪不变**：A5 / C1 路径分支选择（用户拍板线性）· C2–C4 / B5 战斗动画 / D3–D6 / A1 黄金向量与 F4 批量工具 / gdUnit · 注：标错惩罚（原 A2 OQ1）已于 2026-09-12 批上线（标空封印三选一确定性反噬：暴走 / 伏击 +2 层 / 失衡，坐标×板序号派生、不走随机流），本批（2026-09-15）已收编进现行文档，不再属裁剪项
|
||||
|
||||
## 2026-09-11 可选类供给控制器（用户拍板批——修改记录）
|
||||
|
||||
@@ -110,7 +110,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
5. **属性覆盖 = 测试专用**：调整板直接写运行时 HeroTable（atk 域 [1,999] 内 clamp ≥1）；关卡结束/回菜单恢复基线。正式天赋树归 C4，禁止生产代码引用本机制。
|
||||
6. **UI 复用 b1 引用**：关卡模式下呈现层 `b1 = runner.b1`（与调试模式共用 HUD/棋盘路径）；runner 在关卡结束置 `b1 = null`。
|
||||
7. **runner 信号时序（playtest 缺陷①修复登记）**：`node_entered` 必须先于 `begin_battle` 发出——后发时首板安装的 `board_changed` 到达呈现层时 `b1` 尚未接手，首战棋盘不渲染。场景级探针 `smoke/ui_probe.tscn` 为该缺陷的回归断言载体。
|
||||
8. **A2 旗动作末点 AP 软锁（playtest 缺陷②修复登记——A2 核心 bug，v1 即存在）**：`_do_flag_place/_do_flag_pull` 花完末点 AP 后 A3 相位翻 Waiting 但不发 round_end——B1 的 Waiting 结算点依赖 round_end 到达，事件缺席 = 整局软锁（Boss 图插旗多，末点 AP 花在旗上即触发）。修复 = 旗动作检查相位翻转并补发 `_emit_round_end_flags_and_payload()`（与 `_do_dig` 同款）。v1 冒烟盲区根源：自动玩家不用旗。回归断言入 smoke_all（旗动作耗尽 AP 必须进入第 2 轮）+ 行为探针 `smoke/ui_click_probe.tscn`（合成鼠标事件走真实 UI 路径，随机混合插旗/拔旗/停手/窗口刷新/无效点击，4 种子全关通扫）。**正式侧义务**：A2 GDD F4 事件序契约须补"旗动作路径的 round_end 发射"措辞（接口漂移）。
|
||||
8. **A2 封印动作末点 AP 软锁（playtest 缺陷②修复登记——A2 核心 bug，v1 即存在）**：`_do_seal_place/_do_seal_pull` 花完末点 AP 后 A3 相位翻 Waiting 但不发 round_end——B1 的 Waiting 结算点依赖 round_end 到达，事件缺席 = 整局软锁（Boss 图封印多，末点 AP 花在封印上即触发）。修复 = 封印动作检查相位翻转并补发 `_emit_round_end_seals_and_payload()`（与 `_do_dig` 同款）。v1 冒烟盲区根源：自动玩家不用封印。回归断言入 smoke_all（封印动作耗尽 AP 必须进入第 2 轮）+ 行为探针 `smoke/ui_click_probe.tscn`（合成鼠标事件走真实 UI 路径，随机混合封印/撤封印/停手/窗口刷新/无效点击，4 种子全关通扫）。**正式侧义务**：A2 GDD F4 事件序契约须补"封印动作路径的 round_end 发射"措辞（接口漂移）。
|
||||
9. **呈现层固定分区（playtest 缺陷③修复登记）**：侧栏全部动态区（RAP/敌人/增益/库存/悬停状态）固定槽高 + `clip_contents`——悬停文案切换与库存增长不再推挤整体布局（此前"第 N 轮"库存行被挤出视口 + 全 UI 抖动）。区域独立，超长裁剪不回流。
|
||||
10. **L1 12×12 板生成余量**：D2–D4（及 L2）`max_gen_attempts` 16→24（F2c 24×144=3456 ≤ 16384 合法）——16 次尝试下偶发"重试耗尽接受最优"（best≈0.85–0.87 < target 0.88）；24 次后仍偶发（best 0.866），密度×推理率的根本解归 C3。
|
||||
11. **道具使用后不消失（playtest 缺陷④修复登记——UI 层契约违例）**：B1 窗口选择契约 = `_window_items` **位置**（义务④"选定序"），UI 选用按钮却传 `item.index`（库存数组句柄）——未消耗过时二者巧合相等；一旦消耗过一件，已耗条目仍占库存数组位，后续窗口条目"句柄 = 位置 + 已耗数"错位 → 选中件不消耗、邻件被误耗（可用次数语义本身存在且正确：`use()` 一次性标记 Used 不可逆）。修复 = UI/行为探针一律传窗口位置；探针加"选用必生效"断言（选用件库存态变 Used，失效即退出码非零）。
|
||||
@@ -216,11 +216,11 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
**试玩反馈（v2 数值）**：满血全通关（三策略均通）/ Boss 血量 OK 或可上调 / 刷新零使用 / 零弃图倾向 / 治疗包零使用 / DND 命名指令（地精/熊地精/食人魔酋长）。
|
||||
|
||||
**v3 数值批**：atk 4/4/6/4/7 → **7/5/9/6/9**（承伤主杠杆）；D0 goblin 24 保持（20 会被首轮粉尘秒杀——冒烟旗回归断言抓获）、D1 群 13×2、D2 bugbear 40/9、D3 群 26×2、**Boss ogre_chief 150/9**（用户拍板可上调）；L2 锚行同步。**DND 命名**：goblin 地精 → bugbear 熊地精（DND 原型即伏击手）→ ogre_chief 食人魔酋长；enemy_id 同步更名。
|
||||
**v3 数值批**：atk 4/4/6/4/7 → **7/5/9/6/9**（承伤主杠杆）；D0 goblin 24 保持（20 会被首轮粉尘秒杀——冒烟封印回归断言抓获）、D1 群 13×2、D2 bugbear 40/9、D3 群 26×2、**Boss ogre_chief 150/9**（用户拍板可上调）；L2 锚行同步。**DND 命名**：goblin 地精 → bugbear 熊地精（DND 原型即伏击手）→ ogre_chief 食人魔酋长；enemy_id 同步更名。
|
||||
|
||||
**v3 扫描对照 F5**：基线 **60%**（带 40–60% 上沿 ✓，v2 80%）· 败北 4/6 集中 Boss（压迫预期兑现）· +50%→87% / +100%→93% / +200%→100%（天赋曲线成立）· 承伤 90（v2 80）。C3 GDD 回写：F3 带 [0.5,1.1]（OQ2 裁决）、OQ2/3/4/6 试玩读数、试玩批次记录。
|
||||
|
||||
**冒烟 103/103**（旗回归断言改用 Boss 行——D0 20HP 级被盲挖粉尘秒杀无法承载场景；DifficultyTable 断言对齐 v3 行值）。**下一批 = v3 真人试玩**（OQ3 定量/OQ2 终裁）。
|
||||
**冒烟 103/103**（封印回归断言改用 Boss 行——D0 20HP 级被盲挖粉尘秒杀无法承载场景；DifficultyTable 断言对齐 v3 行值）。**下一批 = v3 真人试玩**（OQ3 定量/OQ2 终裁）。
|
||||
|
||||
## 2026-09-12 遭遇随机化（Roguelike 局感引入批——Peglin 对比报告落地项）
|
||||
|
||||
@@ -238,7 +238,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
## 2026-09-12 攻击类型 × 护甲克制批（用户拍板——三段伤害 + 标错惩罚落地）
|
||||
|
||||
**触发**：设计会话（本日）定稿"怪物护甲类型（轻甲/魔法护甲/重甲）× 角色伤害三段构成（普通/穿刺/魔法）"的克制对策系统（穿甲弹/高爆弹式三角）+ 标错旗随机惩罚。（本段写于 2026-09-12，原文使用位置名 无甲/护甲A/护甲B 与 基础/伤害A/伤害B——2026-09-15 命名统一批已全仓改为语义名，映射见下方该批小节。）设定表经用户多轮审阅确认"没有问题"后落程序（GDD 正式修订另批进行——本批以表格结论为实现依据）。
|
||||
**触发**：设计会话（本日）定稿"怪物护甲类型（轻甲/魔法护甲/重甲）× 角色伤害三段构成（普通/穿刺/魔法）"的克制对策系统（穿甲弹/高爆弹式三角）+ 标错封印随机惩罚。（本段写于 2026-09-12，原文使用位置名 无甲/护甲A/护甲B 与 基础/伤害A/伤害B——2026-09-15 命名统一批已全仓改为语义名，映射见下方该批小节。）设定表经用户多轮审阅确认"没有问题"后落程序（GDD 正式修订另批进行——本批以表格结论为实现依据）。
|
||||
|
||||
**拍板结构 → 落点**：
|
||||
|
||||
@@ -248,15 +248,15 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
| 伤害单分量（2026-09-19 充能退役） | ~~B1 三分量~~ 主角攻击 = 单一基础分量：量 = atk（表值）、类型 = hero.attack_type（营地换型 = 改字段）；hero_attack 行携带实际攻击类型键 + roll/ac/tier 掷点读数（P2 归因）。**攻击类型是伤害的属性轴，与来源无关**（2026-09-15 抽象分离批纪律保留） |
|
||||
| ~~充能供给~~（2026-09-19 退役） | SettlementTable 字段 `charge_grants` 已删除——挖掘攒弹药的第二伤害供给取消，克制应对 = 冒险前配型（hero.attack_type）+ 棋盘火力（穿刺弹/魔法矢直伤道具） |
|
||||
| 克制矩阵：克制 ×150 / 中性 ×100 / 被克 ×50 | SettlementTable 新字段 `armor_effectiveness`（{normal,pierce,magic}×{light,ward,heavy} percent，缺项回退 100）——刀/AOE/清图奖励**恒定表值不吃克制**（道具=万能稳定伤害，暂定待拍板） |
|
||||
| 标错旗 → 随机轻惩罚三选一（时效 1 结算） | `_apply_miss_backlash()`：① `enrage` 暴走（敌 +25% 进 enemy_output 池）② 敌方伏击 +2 层（复用 ambush 行）③ `off_guard` 失衡（我方 +25% 进 hero_defense 池 = 多挨打）；新 B3 行 ×2（dur=1 与 weaken/ambush 同款先兑付后衰减）；沿用 `_flag_miss_seen` 每雷格实例一次去重 |
|
||||
| 标错封印 → 随机轻惩罚三选一（时效 1 结算） | `_apply_miss_backlash()`：① `enrage` 暴走（敌 +25% 进 enemy_output 池）② 敌方伏击 +2 层（复用 ambush 行）③ `off_guard` 失衡（我方 +25% 进 hero_defense 池 = 多挨打）；新 B3 行 ×2（dur=1 与 weaken/ambush 同款先兑付后衰减）；沿用 `_seal_miss_seen` 每危险格实例一次去重 |
|
||||
| 随机载体 | **零新流确定性派生**：(x×7 + y×13 + 板序号×5) mod 3——同种子可回放、不扰动既有三条封闭流取号序；正式侧候选 = RngService 新增封闭流（待拍板） |
|
||||
| 呈现 | 敌人卡环点行常驻护甲标签（轻甲/魔法护甲/重甲——克制对策可读前提）· 结算明细主角攻击行拆"（普通 X + 穿刺 Y + 魔法 Z）" · 反噬效果行入明细流 · settlement_snapshot 增 armor/charge 字段（JSONL 数值分析面） |
|
||||
|
||||
**数值全部 provisional 待拍板/调参**（登记于 enemy.tres / settlement.tres 注释）：~~charge_grants~~（2026-09-19 退役）· ~~矩阵 150/100/50~~（加法核 +1/0/−1 换装）· enrage/off_guard 25% · 伏击 +2 层 · 护甲映射 goblin/bugbear/ogre——C3 调参时按 F6 供给平衡式复算（三段充能是新增伤害供给，裸装败北/基线通关率两条冒烟路径已复验仍成立）。
|
||||
|
||||
**正式侧义务（GDD/registry 修订清单，待文档批）**：B2 GDD（EnemyTable armor_type 字段 + schema）、B1 GDD（F3 主角攻击三分量构成 + flag_miss 反噬编排 + 克制矩阵载体）、B3 GDD（六行 MVP 状态表 + source_class flag_miss 授予）、A2 OQ1（标错惩罚候选升级为三选一随机池 + 重复性口径＝每雷格实例一次）、registry（enemy/settlement_table/status_effect 条目 + A3 条款②锚与条款③不等式重推导——标中旗收益从纯 weaken 变"weaken+魔法 充能"）、C3（数值 provisional 接管）。lore 侧：`design/research/lore-nest-metaphor-2026-09-12.md`（穿刺=地利/魔法=封印暴露、反噬=封印失败——待新会话拍板后写回 game-concept）。
|
||||
**正式侧义务（GDD/registry 修订清单，待文档批）**：B2 GDD（EnemyTable armor_type 字段 + schema）、B1 GDD（F3 主角攻击三分量构成 + seal_miss 反噬编排 + 克制矩阵载体）、B3 GDD（六行 MVP 状态表 + source_class seal_miss 授予）、A2 OQ1（标错惩罚候选升级为三选一随机池 + 重复性口径＝每危险格实例一次）、registry（enemy/settlement_table/status_effect 条目 + A3 条款②锚与条款③不等式重推导——封印命中收益从纯 weaken 变"weaken+魔法 充能"）、C3（数值 provisional 接管）。lore 侧：`design/research/lore-nest-metaphor-2026-09-12.md`（穿刺=地利/魔法=封印暴露、反噬=封印失败——待新会话拍板后写回 game-concept）。
|
||||
|
||||
**验证**：冒烟 **161/161**（+12：护甲快照三档传播 / 克制矩阵三行表值 / hero_attack 行三分量字段〔全战斗回放 ×2〕/ 标错旗 flag_miss+反噬效果行 / 标中雷充能进主角攻击 / 反噬派生同种子回放）· ui_probe PASS · ui_tune_probe PASS · ui_click_probe（done=true、选用失效=0、问题=0）。
|
||||
**验证**：冒烟 **161/161**（+12：护甲快照三档传播 / 克制矩阵三行表值 / hero_attack 行三分量字段〔全战斗回放 ×2〕/ 标错封印 seal_miss+反噬效果行 / 标中雷充能进主角攻击 / 反噬派生同种子回放）· ui_probe PASS · ui_tune_probe PASS · ui_click_probe（done=true、选用失效=0、问题=0）。
|
||||
|
||||
## 2026-09-12 战斗屏五区改造批（battle.md 落地——ui-programmer 批）
|
||||
|
||||
@@ -264,7 +264,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
**五区布局**（1280×800 基座）：A 区 28px 顶栏关卡进度条（`level_strip_view.gd` 改造：暗金已过/奖励金当前高亮）；B 区 252px 战斗画面（`battle_stage_view.gd` 新建 = `hero_card_view.gd` + 轮次·阶段指示 + 兑现演出区 + `enemy_card_view.gd` ×1–3〔顺位徽标/意图徽标常驻/环点拍数/伏击共享池/死亡灰化+碎裂残位禁瞬消〕+ 底部结算明细带）；C 区 240px `hero_info_panel_view.gd`（直角细线数据框 + 修正来源角标 + RAP 点阵 + `status_slot_row.gd` ×4〔形状+色相双通道/层数角标/剩余结算点/悬停 tooltip 来源+语义+剩余/空态槽隐藏〕）；D 区 `board_zone_view.gd`（`ap_bar_view.gd` 44px〔AP 点阵+停手居左；图例+弃图刷新居右——确认 chips 异位 pattern 7〕+ `board_view.gd` 改造〔悬停三语义自绘光标/目标格边框/BFS 路径蓝点预览/可挖域 8 向呼吸微光/奖励徽章 R₀ 域外/去饱和 shader〕+ `toast_stack.gd` 2.5s 消退 + `board_fx_view.gd` 演出层）+ `desaturation.gdshader`（去饱和+金橙偏移、明度不变）；E 区 280px `inventory_panel_view.gd`（常读列表固定槽高 + 原位窗口态 pattern 2/8：描边金光/标题切换/时机指示/usable_now 禁选+原因/跳过/政策注记；属性简述投影、来源不呈现）。**旧 `hud_view.gd` 删除**（HUDView 职责由 B/C/D 三区视图承接）。
|
||||
|
||||
**全屏 States 与模态**：`legend_overlay.gd`（图例，状态槽空态说明）/ `settlement_review_overlay.gd`（明细回看）/ `battle_end_overlay.gd`（胜=金蜡封落于棋盘中央+判定行+回看入口；败=暮蓝 #5A6C8C+旗化光点收回）——统一模态登记序管理（`_open_modal` 打开时显式隐藏上方遮挡层，缺陷⑤纪律）。清图金粒喷泉+彩纸 / 完美排雷金光带+横幅 / 标中旗加重弹道 / Boss 紫赤影子爬棋盘 / 零合法板诚实 toast / chord·非相邻一次性提示（每 run 去重，`ux_hint_shown` 遥测）。**发现并修复历史 quirk**：TunePanel 默认 `visible=true` 靠被不透明开始层遮蔽的树序巧合——已显式初始化 false（缺陷⑤家族）。
|
||||
**全屏 States 与模态**：`legend_overlay.gd`（图例，状态槽空态说明）/ `settlement_review_overlay.gd`（明细回看）/ `battle_end_overlay.gd`（胜=金蜡封落于棋盘中央+判定行+回看入口；败=暮蓝 #5A6C8C+封印化光点收回）——统一模态登记序管理（`_open_modal` 打开时显式隐藏上方遮挡层，缺陷⑤纪律）。清图金粒喷泉+彩纸 / 完美排雷金光带+横幅 / 封印命中加重弹道 / Boss 紫赤影子爬棋盘 / 零合法板诚实 toast / chord·非相邻一次性提示（每 run 去重，`ux_hint_shown` 遥测）。**发现并修复历史 quirk**：TunePanel 默认 `visible=true` 靠被不透明开始层遮蔽的树序巧合——已显式初始化 false（缺陷⑤家族）。
|
||||
|
||||
**遥测**（playtest_logger 增 ux 行族，呈现层观测不改 core）：`ux_round_input_ratio`（原始输入:AP 消耗，快照驱动）/ `ux_round_exit{path_tag}`（快照 round_facts.path——呈现层只订 B1 的接线纪律下唯一合法源）/ `ux_refresh_attempt{result, round_refresh_index}` / `ux_window_choice` / `ux_reject{source, sub_reason}` / `ux_hint_shown{hint_id}`。
|
||||
|
||||
@@ -312,7 +312,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
| # | 项 | 修复 |
|
||||
|---|---|---|
|
||||
| E1 | **B1 协作对象全公开 → 呈现层链式穿透**（`b1.b2.hero`、`b1.a3.phase` 式层层下钻 main×18 / presenter×15 处） | a1/b2/b3/b4 私有化（a2/a3 保留公有 = 架构文档 API Boundaries 的 D1 契约面）；新增 `presentation_snapshot()`（载荷 schema 头注成文）/`is_battle_live()`/`stock_count()`/`query_reward_identity()` 四个成文只读出口——diagnostic_snapshot 同款模式 |
|
||||
| E2 | **A2 状态字典公开且被视图绕过查询面直读**（board_view:278/303 直读 `.revealed`，头注自称"只读查询面"自相矛盾） | `board/revealed/flags` 私有化；新增 `current_board()`/`reveal_record()` 查询面；B1/组合根/探针全部改走命名面 |
|
||||
| E2 | **A2 状态字典公开且被视图绕过查询面直读**（board_view:278/303 直读 `.revealed`，头注自称"只读查询面"自相矛盾） | `board/revealed/seals` 私有化；新增 `current_board()`/`reveal_record()` 查询面；B1/组合根/探针全部改走命名面 |
|
||||
| E3 | **B2 裸字典容器公开**（`hero/enemies` 可被任意写；presenter 为死亡残位直读原始数组） | 私有化 + `hero_unit()`/`all_enemies()`（含死亡残位，句柄语义与 query_alive 同构）投影面；presenter 残位渲染需求收进 API |
|
||||
| E5 | **"只读"字段仅靠纪律**（phase/ap/rap/last_round_end/master_seed 架构文档定只读，实际公开可变） | getter-only 属性 + 下划线后备字段（外部读法 `a3.phase` 不变，写入仅剩方法通道——GDScript 层面机制化） |
|
||||
|
||||
@@ -392,12 +392,12 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
## 2026-09-14 完美策略档测量批（OQ7 技能轴上界仪——用户拍板"增加完美策略档测试验证"，零玩法数值变更）
|
||||
|
||||
**背景**：用户（扫雷强玩家）指出"完全正确开图/标雷、零踩雷 ⇒ 存活无压力"——现行扫描只有弱策略基线档（不标旗/邻格盲挖/朴素选道具），技能轴不可测；registry `calibration_gap`（真人显著强于模拟者）此前只有方向无机制。本批 = 测量工具批。
|
||||
**背景**：用户（扫雷强玩家）指出"完全正确开图/标雷、零踩雷 ⇒ 存活无压力"——现行扫描只有弱策略基线档（不封印/邻格盲挖/朴素选道具），技能轴不可测；registry `calibration_gap`（真人显著强于模拟者）此前只有方向无机制。本批 = 测量工具批。
|
||||
|
||||
**落地变更**：
|
||||
- `auto_player.gd` 增完美策略求解器（`perfect_action`/`_deduce`）：single + subset 推理不动点（A1 F1 `measure_inferability` 同族规则集，**去 safe_set oracle**——约束未知邻格含雷格，比生成期闸保守）；**零盲挖**（只挖已证安全格 = 构造保证零踩雷，扫描末断言兜底违例 quit(1)）· **已证雷格全标旗**（旗先于挖——轮末 weaken + 魔法 首次充能，雷上旗不阻连锁）· 卡死且资源可 → `b1.player_request_refresh()` 轮内刷新 · 否则停手（残 AP 1:1 入 RAP）。输入只经 A2 查询面（reveal_record/is_revealed/has_flag），**禁读棋盘雷区真值**——测推理上界，非全知作弊。core 层零改动；
|
||||
- `auto_player.gd` 增完美策略求解器（`perfect_action`/`_deduce`）：single + subset 推理不动点（A1 F1 `measure_inferability` 同族规则集，**去 safe_set oracle**——约束未知邻格含危险格，比生成期闸保守）；**零盲挖**（只挖已证安全格 = 构造保证零踩雷，扫描末断言兜底违例 quit(1)）· **已证危险格全封印**（封印先于挖——轮末 weaken + 魔法 首次充能，雷上封印不阻连锁）· 卡死且资源可 → `b1.player_request_refresh()` 轮内刷新 · 否则停手（残 AP 1:1 入 RAP）。输入只经 A2 查询面（reveal_record/is_revealed/has_seal），**禁读棋盘雷区真值**——测推理上界，非全知作弊。core 层零改动；
|
||||
- `window_selection` 增 `heal_no_waste` 选项（缺口 < 治疗量不用；完美档启用）+ 完美档轮次门解除（round_gate=0）；
|
||||
- `level_autoplay.gd` 增 `policy` 参数（默认 "normal"——tune_sim_controller/defense_scan/level_debug 既有调用零改动）；完美档经 `policy="perfect"` 由 `_decide_act` 分派承载（原专职驱动 `_autoplay_battle_perfect` 已随样板收口并入分派——move/dig/flag 走 A2 settle_batch、refresh 走 B1 编排、连续拒绝 ≥3 停手防死循环）；st 增 `mine_hits`/`refreshes` 计数（mine_hit 证据行埋点）；
|
||||
- `level_autoplay.gd` 增 `policy` 参数（默认 "normal"——tune_sim_controller/defense_scan/level_debug 既有调用零改动）；完美档经 `policy="perfect"` 由 `_decide_act` 分派承载（原专职驱动 `_autoplay_battle_perfect` 已随样板收口并入分派——move/dig/seal 走 A2 settle_batch、refresh 走 B1 编排、连续拒绝 ≥3 停手防死循环）；st 增 `mine_hits`/`refreshes` 计数（mine_hit 证据行埋点）；
|
||||
- `level_monte_carlo.gd` 增第 3 CLI 参 `[policy]`（normal/perfect/both，缺省 normal 兼容既有文档命令）+ 策略/踩雷/刷新列；脚注 F5 带文案同步 [30,50] 带锚定稿。
|
||||
|
||||
**完美档基线（N=30 · 种子 4200–4229 · 耗时 597.6s）**：**0 加成通关率 100%**（弱策略基线档 60%）、通关剩余 HP 均 **47.4/50**、整关承伤均 3.5（p90 18.0）、普通场承伤 0.5%（带 ≤20%）、Boss 场 5.3%（带 ≤50%）、踩雷 0.00/局（断言 ✓）、刷新 0.23/局、跳战率 20%。+50%～+200% 全档位恒 100% 满血通关（+200% 承伤均 0.4）——**技能轴上界完全碾压现行曲线：F5 带与 F6 S/K 区间对完美档零分辨力**（区间模型无策略水平轴的结构性证实；calibration_gap 获得机制解释与定量上界）。
|
||||
@@ -418,7 +418,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
**实测（N=30，种子 4200–4229）**：
|
||||
- 奖励侧单独：完美档 0 加成 **100%**（承伤 3.5——与区间前逐值一致）；基线档 17%（不变）；
|
||||
- 敌方侧叠加：完美档 0 加成仍 **100%**（承伤 3.5→3.9 / p90 18→19——方差真实流动但被血缓冲全吞）；剩余 HP 均 47.4 不变；
|
||||
- **验收结论：≤40% 线用数值区间杠杆族到不了**——完美玩家结构性优势（零踩雷 = 零直伤 + 全标旗 = weaken −65% 顶格 + 快杀 = 敌出手次数最少）不受值域方差影响。三选待裁决：①承伤硬地板（每结算不可减免平伤——S_min 压缩，B1/B2 域）；②weaken 饱和/递减语义（拆"全标旗顶格"基石，B3/B1 域）；③极端宽度（数值可用但毁基线档与可读性锚——建议否决）。**本批区间机制保留**（对普通玩家方差体验有效，中点锚不伤当量）。
|
||||
- **验收结论：≤40% 线用数值区间杠杆族到不了**——完美玩家结构性优势（零踩雷 = 零直伤 + 全封印 = weaken −65% 顶格 + 快杀 = 敌出手次数最少）不受值域方差影响。三选待裁决：①承伤硬地板（每结算不可减免平伤——S_min 压缩，B1/B2 域）；②weaken 饱和/递减语义（拆"全封印顶格"基石，B3/B1 域）；③极端宽度（数值可用但毁基线档与可读性锚——建议否决）。**本批区间机制保留**（对普通玩家方差体验有效，中点锚不伤当量）。
|
||||
|
||||
**验证**：冒烟 **154/149+5 全绿**（区间批 5 新断言 + 既有全部回归含遭遇骰分布/回放）。
|
||||
|
||||
@@ -432,49 +432,49 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|---|---|---|
|
||||
| 攻击类型（结算表矩阵行键 / hero_attack 行分量） | `normal` / `pierce` / `magic` = 普通 / 穿刺 / 魔法 | `base` / `dmg_a` / `dmg_b` = 基础 / 伤害A / 伤害B |
|
||||
| 护甲类型（`armor_type` / 矩阵列键） | `light` / `ward` / `heavy` = 轻甲 / 魔法护甲 / 重甲 | `none` / `a` / `b` = 无甲 / 护甲A / 护甲B |
|
||||
| 结算表字段 | `charge_grants`（触发源→{attack_type, per_unit, cap}，同日第二批抽象分离后定型） | `damage_a_per_cell` / `damage_a_cap` / `damage_b_per_flag`（"类型×来源"焊死命名；同名批曾短暂改 `pierce_per_cell` / `pierce_cap` / `magic_per_flag`，随即作废） |
|
||||
| 结算表字段 | `charge_grants`（触发源→{attack_type, per_unit, cap}，同日第二批抽象分离后定型） | `damage_a_per_cell` / `damage_a_cap` / `damage_b_per_seal`（"类型×来源"焊死命名；同名批曾短暂改 `pierce_per_cell` / `pierce_cap` / `magic_per_seal`，随即作废） |
|
||||
| 结算快照 round_facts | `charge_counts`（各触发源计数）+ `charge_points`（按攻击类型分桶点数） | `charge_dmg_a` / `charge_dmg_b`（既有 JSONL 留存文件仍用旧键） |
|
||||
|
||||
映射沿教学梯度：goblin `none`→`light`、bugbear `a`→`ward`、ogre_chief `b`→`heavy`；**矩阵数值逐格不动**（pierce→ward 150 / pierce→heavy 50 / magic→heavy 150 / magic→ward 50 / normal 全 100）。
|
||||
|
||||
**同日第二批 · 攻击类型与奖励抽象分离**（用户裁定"攻击类型的定义和格子奖励要分离开；开格|标雷 → 奖励；奖励如何定义是可以修改的；不要将两者绑定"）：攻击类型 = 伤害的属性轴（普通 / 穿刺 / 魔法，只决定查甲效矩阵哪一行，定义里不含任何棋盘来源）；充能 = 按攻击类型分桶的附加伤害储备，**谁能充、充哪个桶 = 奖励定义**（`charge_grants`；开格 / 标中旗 / 踩雷 / 清图一律只作奖励触发源）。原 `pierce_per_cell` / `magic_per_flag` 式命名（类型与来源焊在一根名字里）作废。冒烟新增三条断言：奖励定义在位 ×2 + 行为断言（把"标中旗"奖励改投穿刺桶 → 同一战斗魔法分量归零；还原后步骤流逐行相同——证明改道唯一入口是奖励定义）。
|
||||
**同日第二批 · 攻击类型与奖励抽象分离**（用户裁定"攻击类型的定义和格子奖励要分离开；开格|标雷 → 奖励；奖励如何定义是可以修改的；不要将两者绑定"）：攻击类型 = 伤害的属性轴（普通 / 穿刺 / 魔法，只决定查甲效矩阵哪一行，定义里不含任何棋盘来源）；充能 = 按攻击类型分桶的附加伤害储备，**谁能充、充哪个桶 = 奖励定义**（`charge_grants`；开格 / 封印命中 / 踩雷 / 清图一律只作奖励触发源）。原 `pierce_per_cell` / `magic_per_seal` 式命名（类型与来源焊在一根名字里）作废。冒烟新增三条断言：奖励定义在位 ×2 + 行为断言（把"封印命中"奖励改投穿刺桶 → 同一战斗魔法分量归零；还原后步骤流逐行相同——证明改道唯一入口是奖励定义）。
|
||||
|
||||
**落点**：GDD（战斗结算 v0.5 / 敌人系统 / 难度曲线与Boss / 03-内容规模）+ registry（`enemy.armor_type`、`settlement_table.armor_effectiveness` 与三字段 + 批次注记）+ 切片（`enemy_table.gd` `ARMOR_TYPES`、`settlement_table.gd` `ARMOR_KEYS` / `ATTACK_TYPE_KEYS`〔原 `COMPONENT_KEYS`〕、`enemy.tres`、`settlement.tres`、`damage_math.gd`、`unit_container.gd`、`battle_orchestrator.gd`、`enemy_card_view.gd`〔敌卡常驻标签改 轻甲 / 魔法护甲 / 重甲〕、`battle_log_view.gd`〔拆行文案改"（普通 X + 穿刺 Y + 魔法 Z）"〕、`smoke_all.gd` / `damage_probe.gd` / `auto_player.gd`）；playtest 观测记录保留当时键名并附现名。
|
||||
|
||||
**验证（本批实跑）**：冒烟 **201 项检查 0 失败**（含分离批三条新断言：奖励定义在位 ×2 + 行为断言"标中旗奖励改投穿刺桶 → 魔法分量归零、还原后步骤流逐行相同"）· `ui_probe` PASS · `ui_tune_probe` PASS · `ui_click_probe`（done=true、选用失效=0、问题=0）· `ui_layout_probe` PASS——四探针 exit=0、FAIL 行 0。命名批纯改名零行为变更；分离批为结构重构，数值链路等价（旧"计数×每单位×克制"与现行"计数→按奖励定义折算点数→×克制"结果相同，冒烟全量回归含回放断言未动）。
|
||||
**验证（本批实跑）**：冒烟 **201 项检查 0 失败**（含分离批三条新断言：奖励定义在位 ×2 + 行为断言"封印命中奖励改投穿刺桶 → 魔法分量归零、还原后步骤流逐行相同"）· `ui_probe` PASS · `ui_tune_probe` PASS · `ui_click_probe`（done=true、选用失效=0、问题=0）· `ui_layout_probe` PASS——四探针 exit=0、FAIL 行 0。命名批纯改名零行为变更；分离批为结构重构，数值链路等价（旧"计数×每单位×克制"与现行"计数→按奖励定义折算点数→×克制"结果相同，冒烟全量回归含回放断言未动）。
|
||||
|
||||
## 2026-09-15 验收 + 收口批（两批改动闭合核对；零数值零机制改动；不碰 v0.7 文件）
|
||||
|
||||
**背景**：2026-09-15 两批（攻击/护甲命名统一 v0.5 + 攻击类型/奖励抽象分离 v0.6）已完成；本批只读核对"文档口径 ↔ 切片实现"是否闭合，并收口遗留开口。**范围纪律**：`战斗结算.md` / `地图战斗资源.md` 属 v0.7 格面资源批所有者文件、口径仍在移动——本批不改；③ 收口项落在 `registry` + 本 README + `active.md`，GDD 侧只报告、待 v0.7 批整体收口后回填。
|
||||
|
||||
**核对结论（两批核心语义 9 项全闭合）**：`charge_grants` 键与值（safe_cell→pierce 1/格 cap 8 · flag_hit→magic 2/雷 cap 0）· 甲效矩阵 9 格（normal 全 100 / pierce→ward 150、heavy 50 / magic→heavy 150、ward 50）· `armor_type` 三值（light/ward/heavy）· `hero_attack` 行分量字段（normal/pierce/magic）· round_facts 键（`charge_counts`/`charge_points`）· 敌卡标签文案（轻甲/魔法护甲/重甲）· 明细行拆行文案"（普通 X + 穿刺 Y + 魔法 Z）"· 攻击类型定义不含来源 · 矩阵数值逐格不动——GDD/registry/tres/代码逐项一致。残留旧名扫描仅命中批次注记"原名"与历史观测记录；来源-类型硬绑扫描确认代码只剩两处计数埋点（`_charge_counts["safe_cell"]` / `["flag_hit"]`）+ `charge_grants` 键 + 行 `source_class` 归因。
|
||||
**核对结论（两批核心语义 9 项全闭合）**：`charge_grants` 键与值（safe_cell→pierce 1/格 cap 8 · seal_hit→magic 2/雷 cap 0）· 甲效矩阵 9 格（normal 全 100 / pierce→ward 150、heavy 50 / magic→heavy 150、ward 50）· `armor_type` 三值（light/ward/heavy）· `hero_attack` 行分量字段（normal/pierce/magic）· round_facts 键（`charge_counts`/`charge_points`）· 敌卡标签文案（轻甲/魔法护甲/重甲）· 明细行拆行文案"（普通 X + 穿刺 Y + 魔法 Z）"· 攻击类型定义不含来源 · 矩阵数值逐格不动——GDD/registry/tres/代码逐项一致。残留旧名扫描仅命中批次注记"原名"与历史观测记录；来源-类型硬绑扫描确认代码只剩两处计数埋点（`_charge_counts["safe_cell"]` / `["seal_hit"]`）+ `charge_grants` 键 + 行 `source_class` 归因。
|
||||
|
||||
**实跑（本批）**：冒烟 **201 项检查 0 失败**；四场景探针 `ui_probe` / `ui_tune_probe` / `ui_click_probe` / `ui_layout_probe` 全部 **exit=0、无 FAIL 行**。
|
||||
|
||||
**收口（③，落在非 GDD 文件）**：
|
||||
- ① **收益对照表充能当量覆盖缺口**：登记于本 README + registry + `active.md`（GDD 收益对照表回填待 v0.7 批收口后）。候选口径 = 充能当量 = Σ各桶点数 × 当轮目标护甲平均甲效倍率 ÷ 100（与直伤同类 1 伤害 = 1 当量，守 行动经济 条款①单一当量）；补式 / 登记待拍板二选一待回填批裁定。
|
||||
- ② **两处已知落差登记**：a) `charge_grants` 触发源可扩展 vs 切片仅两个触发源计数埋点（新增源须加埋点）；b) `safe_cell`/`flag_hit` 来源标识跨命名空间同名（明细行 `source_class` / `charge_grants` 键；RewardTable.pool_tag 已随格面资源批改 `cell`）。
|
||||
- ② **两处已知落差登记**：a) `charge_grants` 触发源可扩展 vs 切片仅两个触发源计数埋点（新增源须加埋点）；b) `safe_cell`/`seal_hit` 来源标识跨命名空间同名（明细行 `source_class` / `charge_grants` 键；RewardTable.pool_tag 已随格面资源批改 `cell`）。
|
||||
- ③ playtest 观测记录的快照键"现名"注记由中间名订正为现行名 `charge_counts`/`charge_points`。
|
||||
|
||||
**注意（口径移动）**：本批运行期间 **v0.7 格面资源批**已在 GDD（战斗结算 v0.7 / 地图战斗资源 v0.4）与 registry 落地——段序七→五、行型 15→10、极性路由取代三套固定兑付、可选类道具删除。切片代码尚未同步（registry 注明"切片代码修改随新会话执行、指导已产出"），故本文以上各历史批次条目保留当时陈述。
|
||||
|
||||
**两轴分离措辞不变**：攻击类型 = 伤害属性轴（定义不含来源）；充能 = 按攻击类型分桶的附加伤害储备，投桶归奖励定义 `charge_grants`；开格/标中旗/踩雷/清图只作奖励触发源。
|
||||
**两轴分离措辞不变**：攻击类型 = 伤害属性轴（定义不含来源）；充能 = 按攻击类型分桶的附加伤害储备，投桶归奖励定义 `charge_grants`；开格/封印命中/踩雷/清图只作奖励触发源。
|
||||
|
||||
## 2026-09-15 格面资源批 · 批 1（数据面 + 极性路由——设计权威 = 地图战斗资源 v0.4 / 战斗结算 v0.7 / 排雷玩法 v0.3 / registry 2026-09-15 条目）
|
||||
|
||||
**模型一句话**：格子分 安全|雷|封锁格 三型；每个非封锁格（安全格 + 雷格，雷安同池同分布）装板期一次摇定格面资源类型（五型 attack/defense/heal/blast/weaken）；极性不在资源内，由「动作 × 格型」矩阵决定——开安全格/标中雷 = 正向（奖励），开雷格/标错安全格 = 负向（惩罚），标旗后撤旗零兑付；全部兑付在轮末授予段。可选类道具（刀/治疗包）与库存/供给控制器/道具窗口整体删除。
|
||||
**模型一句话**：格子分 安全|雷|封锁格 三型；每个非封锁格（安全格 + 危险格，雷安同池同分布）装板期一次摇定格面资源类型（五型 attack/defense/heal/blast/weaken）；极性不在资源内，由「动作 × 格型」矩阵决定——开安全格/标中雷 = 正向（奖励），开危险格/标错安全格 = 负向（惩罚），封印后撤封印零兑付；全部兑付在轮末授予段。可选类道具（刀/治疗包）与库存/供给控制器/道具窗口整体删除。
|
||||
|
||||
**数据面**：
|
||||
- `reward.tres` 结构性重写（`reward_table.gd` 同批）：删 `category`/`use_timing` 字段与 CATEGORIES/USE_TIMINGS 常量；新增 `cell_type`（五型封闭枚举，清单外加载拒绝）× `polarity`（positive/negative）+ `stacks`（可省，缺省 1）；`pool_tag` 收窄 {cell, clear_default}。行集 = 十一行：格面池正向五行 attack_up(w20,t2)/defense_up(w16,t2)/spark_aoe(flat 4,w16,t1)/heal_minor(flat [2,6],w15,t1)/weaken(w12,t1) + 负向五行 enrage(attack,t2)/off_guard(defense,t2)/heal_backlash(heal 直伤 flat 4,t1,无 effect_id)/ambush_double(blast 加层 stacks=2,t1,无 effect_id)/sapped(weaken,t1)——负向行 weight=0 纯兑付字典不参与摇号；clear_blast 保留（flat [25,55],w1,t2,clear_default）。加载校验族重写：五型 × 正负两行齐备（缺任一致命）/ cell 池 ≥1 正向行 weight>0 / percent 行 effect_id 必填（悬空校验在 ConfigDB）/ flat 行 power≥1（**例外 = blast 负向加层行，消费 stacks 不消费 power**——战斗结算 兑付形态表"伏击加层"独立形态的行级兑现）/ 区间配对 + 中点锚不变。
|
||||
- **删除三件**：`core/reward_supply_controller.gd`（可选类供给控制器——首件保证/指数递减整体下线）、`data/schemas/reward_config_table.gd`、`data/tables/reward_config.tres`（RewardConfigTable 随可选类删除废止——注入概率/按板保底参数失义）。
|
||||
- `status_effects.tres` 六行→七行：新增 **sapped（乏力——weaken 型负向：hero · −25 percent · dur 1 · max_stack 16 · stack**，hero_offense 池，attack_up 镜像；值 provisional 归 难度曲线与Boss）。
|
||||
- `settlement.tres`：`segment_order` 七段→五段 [grant, buff_debuff, combat, decay, verdict]（schema 冻结常量同步）；`effect_pool_map` 增 sapped→hero_offense；`source_label_map` 删 item 键（ConfigDB 必需键清单同步）。`charge_grants` 路径不动（开格→穿刺 1/格 cap8 · 标中旗→魔法 2/雷）。
|
||||
- `settlement.tres`：`segment_order` 七段→五段 [grant, buff_debuff, combat, decay, verdict]（schema 冻结常量同步）；`effect_pool_map` 增 sapped→hero_offense；`source_label_map` 删 item 键（ConfigDB 必需键清单同步）。`charge_grants` 路径不动（开格→穿刺 1/格 cap8 · 封印命中→魔法 2/雷）。
|
||||
- `config_db.gd`：reward_config 出表清单；跨表校验族重写——旧 ②池空/③clear正当量并入 RewardTable.validate，旧 ④⑤⑨（k_dmg 保底/零伤害后闸/注入池护栏）随 reward_config 删除退役，保留 ①effect_id 悬空 / poolmap 悬空 / source_label_map 键集 / level 节点悬空。
|
||||
|
||||
**路由面（core）**：
|
||||
- `minesweeper_rules.gd`：cell_revealed 事件字段 `reward_eligible` → **`resource`**——initial 恒 false（封锁格），chain/dig 恒 true **含雷格**（雷安同池——旧"mine 恒 false"作废）。
|
||||
- `reward_economy.gd` 重写为纯格面资源身份面：roll_board 对全部非封锁格逐一摇定类型（摇号只用正向行权重 = 类型频次，合计 79）+ 清图批尾摇 clear_blast + 区间行 power 追加取号；query_identity 返回 {reward_id, cell_type, tier}，未开格恒可查（雷格同权）；grant/grant_clear 幂等保持；新增 `polarity_row(cell_type, polarity)`（类型化字典行查询面，拷贝出口）与静默 `is_mapped`/`phase` 只读出口；**删库存轴整族**（stock/use/query_inventory/in_stock_count/clear_inventory/grant_node_active/supply_granted_count/notify_battle_start）；equivalence_supply 投影保留（tier_min_buff = 我侧 percent 正向行最低档 = 2）。
|
||||
- `battle_orchestrator.gd` 授予段改**极性路由**：结算队列（开格/旗判定/清图三批）逐格兑付——开安全格→该格 cell_type 正向行（charge_grants 计数埋点不变）、开雷格→负向行、标中→该雷格正向行（_flag_consumed 每雷实例一次去重不变，高光 flag_hit 保持）、标空→标旗未中归因行 + 该安全格负向行（_flag_miss_seen 同键去重不变）；**删旧三套固定兑付**（`_convert_ambush` 踩雷固定伏击 / `_judge_flag` 标中固定 weaken / `_apply_miss_backlash` 标错三选一哈希派生——整段删除）。负向兑付：percent 走 apply_effect（enrage/off_guard/sapped）；heal 负向 = 主角直伤 4（apply_damage，不经增益状态；战斗段增 hero 存活守卫 = 致死短路；同轮后到 heal 正向遇已倒下主角记"奖励未生效"行）；blast 负向 = ambush +stacks 层（`_apply_ambush_grant` 逐层经 ambush_grant_plan 对 cap=4 守恒，溢出逐层"溢出未生效"行——协议不变）。正向兑付：percent 挂状态、flat 当场（满层/满血/无敌/主角已倒下记"奖励未生效"行）。抵消过滤既有语义保持（旗判定批以轮末在场旗为基线——发射面过滤，勿改）。区间行快照 power 只在正向路由覆盖表值（负向字典行自带定值 power）。**行型协议 15→10**（删 item/consumed_ineffective/use_rejected/window_open/window_skip），SOURCE_EXEMPT 两层豁免集合同步收窄。
|
||||
- `minesweeper_rules.gd`：cell_revealed 事件字段 `reward_eligible` → **`resource`**——initial 恒 false（封锁格），chain/dig 恒 true **含危险格**（雷安同池——旧"mine 恒 false"作废）。
|
||||
- `reward_economy.gd` 重写为纯格面资源身份面：roll_board 对全部非封锁格逐一摇定类型（摇号只用正向行权重 = 类型频次，合计 79）+ 清图批尾摇 clear_blast + 区间行 power 追加取号；query_identity 返回 {reward_id, cell_type, tier}，未开格恒可查（危险格同权）；grant/grant_clear 幂等保持；新增 `polarity_row(cell_type, polarity)`（类型化字典行查询面，拷贝出口）与静默 `is_mapped`/`phase` 只读出口；**删库存轴整族**（stock/use/query_inventory/in_stock_count/clear_inventory/grant_node_active/supply_granted_count/notify_battle_start）；equivalence_supply 投影保留（tier_min_buff = 我侧 percent 正向行最低档 = 2）。
|
||||
- `battle_orchestrator.gd` 授予段改**极性路由**：结算队列（开格/封印判定/清图三批）逐格兑付——开安全格→该格 cell_type 正向行（charge_grants 计数埋点不变）、开危险格→负向行、标中→该危险格正向行（_seal_consumed 每雷实例一次去重不变，高光 seal_hit 保持）、标空→封印未中归因行 + 该安全格负向行（_seal_miss_seen 同键去重不变）；**删旧三套固定兑付**（`_convert_ambush` 踩雷固定伏击 / `_judge_seal` 标中固定 weaken / `_apply_miss_backlash` 标错三选一哈希派生——整段删除）。负向兑付：percent 走 apply_effect（enrage/off_guard/sapped）；heal 负向 = 主角直伤 4（apply_damage，不经增益状态；战斗段增 hero 存活守卫 = 致死短路；同轮后到 heal 正向遇已倒下主角记"奖励未生效"行）；blast 负向 = ambush +stacks 层（`_apply_ambush_grant` 逐层经 ambush_grant_plan 对 cap=4 守恒，溢出逐层"溢出未生效"行——协议不变）。正向兑付：percent 挂状态、flat 当场（满层/满血/无敌/主角已倒下记"奖励未生效"行）。抵消过滤既有语义保持（封印判定批以轮末在场封印为基线——发射面过滤，勿改）。区间行快照 power 只在正向路由覆盖表值（负向字典行自带定值 power）。**行型协议 15→10**（删 item/consumed_ineffective/use_rejected/window_open/window_skip），SOURCE_EXEMPT 两层豁免集合同步收窄。
|
||||
- `level_runner.gd`/`debug_session.gd`：共享 地图战斗资源 容器与库存延续语义随库存删除收窄——战斗各自持容器（映射随战斗退役，零跨战斗状态），runner 删 window 转发/inventory()/level_clear 清库/submit_window_selection；奖励点节点内容随功能道具渠道（P1 未定）**悬置为直通节点**（零兑付，node_entered 零载荷——内容归 关卡节点地图 定稿批，**待拍板**）；battle_finished 载荷删 remaining_items。
|
||||
|
||||
**呈现面**：
|
||||
@@ -483,7 +483,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
**smoke/tools**：
|
||||
- 删 `supply_scan.gd`（可选类供给跨种子扫描——对象已不存在）；`_smoke_supply` 整段删除。
|
||||
- `smoke_all.gd` 大改（201→211 项）：删窗口接线族与窗口锚行段、等待期刷新探针改挂衰减行（结算段内 Waiting 相位刷新必拒）；`_smoke_power_interval` 收窄两区间行；`_smoke_damage_types` 标错断言改类型化负向兑付。**新增五段**：`_smoke_reward_identity_unit`（roll 恰一次/query_identity 投影/同格重复 grant 幂等/grant_clear 幂等/退役拒绝）、`_smoke_polarity_routing`（真实流多轮：挖安全格只出正向 + 每格 ≥1 行、挖雷格只出负向、标中正向 origin 指回雷格、标空归因 + 负向同格同批、旗兑付零泄漏）、`_smoke_negative_dictionary`（sapped 数据面在位 + effect_pool_map 收编 + 逐型负向直验：enrage/off_guard/sapped 效果行、heal 直伤 4、blast +2 层与 cap 溢出守恒）、`_smoke_resource_surface`（chain/dig resource 恒 true 含雷格、initial 恒 false、封锁格查询 null、未开雷格可查）、`_smoke_settlement_segments`（segment_order 五段冻结 + 行型封闭零残留 + 逐轮行相位单调 + 衰减/判定恰一段）。
|
||||
- `smoke_all.gd` 大改（201→211 项）：删窗口接线族与窗口锚行段、等待期刷新探针改挂衰减行（结算段内 Waiting 相位刷新必拒）；`_smoke_power_interval` 收窄两区间行；`_smoke_damage_types` 标错断言改类型化负向兑付。**新增五段**：`_smoke_reward_identity_unit`（roll 恰一次/query_identity 投影/同格重复 grant 幂等/grant_clear 幂等/退役拒绝）、`_smoke_polarity_routing`（真实流多轮：挖安全格只出正向 + 每格 ≥1 行、挖危险格只出负向、标中正向 origin 指回危险格、标空归因 + 负向同格同批、封印兑付零泄漏）、`_smoke_negative_dictionary`（sapped 数据面在位 + effect_pool_map 收编 + 逐型负向直验：enrage/off_guard/sapped 效果行、heal 直伤 4、blast +2 层与 cap 溢出守恒）、`_smoke_resource_surface`（chain/dig resource 恒 true 含危险格、initial 恒 false、封锁格查询 null、未开危险格可查）、`_smoke_settlement_segments`（segment_order 五段冻结 + 行型封闭零残留 + 逐轮行相位单调 + 衰减/判定恰一段）。
|
||||
- `reward_expectation.gd` 重写为类型频次测量（实测收敛权重涌现值 attack 25.3/defense 20.3/blast 20.3/heal 19.0/weaken 15.2%，封锁格泄漏 0）；`level_autoplay`/`monte_carlo`/`dump_battle`/`damage_probe`/`level_debug`/`level_monte_carlo`/`ui_probe`/`ui_click_probe`/`ui_layout_probe` 去窗口/库存面。**顺手修**：`monte_carlo.gd` 缺 AutoPlayer preload（HEAD 起即解析失败）已补。
|
||||
|
||||
**验证（本批实跑）**：冒烟 **211 项检查 0 失败**（回放断言全量保持——同 master_seed 同意图序列结算步骤流逐行相同）；四场景探针 ui_probe / ui_tune_probe / ui_click_probe（PROBE_SEED=7 与 91 双种子）/ ui_layout_probe 全 PASS；工具回归 reward_expectation / monte_carlo / dump_battle / damage_probe(boss) / level_debug / level_monte_carlo(N=5) 零脚本错误。
|
||||
@@ -551,7 +551,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
## 2026-10-06 地图伤害账殿后批（案C，用户裁——「主角先手」歧义质询触发；设计权威 = 战斗结算.md v0.26）
|
||||
|
||||
**裁决**：每轮结算内三者顺序定死 = ①授予段兑非伤害账（资源/增益/治疗/行动点/GP/警觉）→ ③战斗段「主角先基础攻击 → 敌人按生成序逐个还手 → 地图伤害账殿后」→ ④衰减 → ⑤判定。授予段不再当场兑付任何伤害——全部伤害形态单据（爆裂/直伤/反噬/地形变异/战旗军规/熔火反噬/惊巢反制/魔能共鸣/清障炸药等）暂存，战斗段怪物还手后按授予段事件序补提交统一结账；主角死于敌方还手 → 暂存单整体不兑，逐单留「未生效（主角已倒下）」行（载荷 forfeit=hero_down）。
|
||||
**裁决**：每轮结算内三者顺序定死 = ①授予段兑非伤害账（资源/增益/治疗/行动点/GP/警觉）→ ③战斗段「主角先基础攻击 → 敌人按生成序逐个还手 → 地图伤害账殿后」→ ④衰减 → ⑤判定。授予段不再当场兑付任何伤害——全部伤害形态单据（爆裂/直伤/反噬/地形变异/战封印军规/熔火反噬/惊巢反制/魔能共鸣/清障炸药等）暂存，战斗段怪物还手后按授予段事件序补提交统一结账；主角死于敌方还手 → 暂存单整体不兑，逐单留「未生效（主角已倒下）」行（载荷 forfeit=hero_down）。
|
||||
|
||||
**切片落点**：`battle_orchestrator.gd` 暂存闸 `_defer_board_damage`/`_deferred_board` + `_submit` 案C 分流（sync 同闸——清图批一致延后）+ `_outcome_of`（暂存单按「将兑付」回报——完美第二份/高光份数依据开单时点事实）+ 授予段四处直提改走闸 + 战斗段末补提交块（死亡守卫+留痕）；授予段界 flush 保留（对空队 no-op 防御位）；`smoke_all.gd` 行相位分类器换代（damage 恒战斗段/reward_ineffective 按 forfeit 分流）+ 先手断言收紧（「存在或授予段终局」→「必存在」）+ 新增案C 段内序断言（地图账不得先于主角先手或插入敌方还手中间）。
|
||||
|
||||
@@ -570,7 +570,7 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
||||
|
||||
**结构换代 33→12 节点**：脊柱 2（生命/命中淬炼一线一节点 cap4——攻/护淬炼线随攻防所有权切分砍除，攻唯一入口=锻造工坊武器路线、AC 唯一入口=甲路线）+ 锻造脉 2（forge_workshop 钥匙 free 无前置 + easter_ley 彩蛋〔effects 摘攻/护分量〕）+ 钥石脉 2（秘宝匣/刷新升级）+ 同调脉 6（同调位 1/2/3——socket1 改根节点无前置 + Fork 3 单行双态）。schema 换代：FORK_GROUPS 4→3（fg_mastery 退役）/ RULE_KEYS 2→6 / row 字段退役（行门槛主语=节点第 N 级需全树总投入 ≥4×(N−1)）/ requires 只留点亮前置（R1 裁撤案执行）。
|
||||
|
||||
**六键真效果**：开局姿态窗=每关首战首轮（FACTS 扩签 battle_index=关卡域战斗序）；危险直觉锋=踩雷减半·守=标错返还 AP（EVENTS 扩签 flag_missed、契约 12 去重闸语义）——两组每关限次（adventure_counters domain=adventure、按关重置）；财富之道聚=战斗掉落 GP 入账前×1.5、散=商品购买价×80%（双计价单点，刷新价不折）。数值全 provisional 归 M4。
|
||||
**六键真效果**：开局姿态窗=每关首战首轮（FACTS 扩签 battle_index=关卡域战斗序）；危险直觉锋=踩雷减半·守=标错返还 AP（EVENTS 扩签 seal_missed、契约 12 去重闸语义）——两组每关限次（adventure_counters domain=adventure、按关重置）；财富之道聚=战斗掉落 GP 入账前×1.5、散=商品购买价×80%（双计价单点，刷新价不折）。数值全 provisional 归 M4。
|
||||
|
||||
**退役删除**：属性锻造柜台全家（buy_forge/forge_flat/meta_forge_row/forge_products 行族/forge_levels 存档域/营地·暂停层·生涯三投影）；migrate_tree 三体系迁移（旧档=tree_struct 标记检测破坏性废弃重置，禁迁移折算）；attunement_growth 谓词表（同调位槽位判定源切树点亮数——Q2 裁甲）。
|
||||
|
||||
|
||||
Reference in new issue
Block a user