@@ -0,0 +1,126 @@
# 会话状态：Dungeon Sweeper（扫雷 × 自动战斗，唯一状态源，每里程碑同步一次）
- **阶段**： （ `production/stage.txt` = Systems Design，
- **系统索引**： `design/gdd/systems-index.md` （20 系统，含门禁修正 + 2026-09-07 增补记录）
- **概念文档**： `design/gdd/game-concept.md` （含目标受众 + Visual Identity Anchor + 创意风险登记）
- **游戏支柱**： `design/gdd/game-pillars.md` （
- **原型**：概念原型 demo 已删除（2026-09-12，垂直切片承接）；验证报告留档 `docs/prototype-report-minesweeper-battle-concept.md` （ ， ）
- **引擎**： （ `.claude/docs/technical-preferences.md` + `docs/engine-reference/godot/` ； `/setup-engine refresh` 逐条核实 4.5–4.7 官方迁移指南，无破坏架构契约项，current-best-practices.md 已建）
- **架构**： `docs/architecture/architecture.md` v1.0（ ； ）
- **最近门禁报告**： `production/gate-checks/gate-check-systems-design-2026-09-07.md`
## 项目当前位置
1. 概念原型验证：v2 核心假设 CONFIRMED，v3 终验待做（与标错惩罚实测合并为一次会话），REPORT 已归档 PROCEED
2. `/map-systems` 完成：20 系统四层分解 + GDD 设计顺序 + 优先级
3. `/gate-check systems-design` 重审（2026-09-07）：CONCERNS 无阻塞 → 登记级意见已清偿进 systems-index"门禁增补记录"，
4. **D2 已收口 ** ：两轮 /design-review（ ） **Approved ** （ （ × × `action_economy` ，索引补齐 C2/B1/B4/C4←D2 四边
5. **A3 已收口 ** ： `design/gdd/a3-action-economy.md` ， `design/gdd/reviews/a3-action-economy-review-log.md` ），registry 已登记 `action_economy`
6. **A4 已收口 ** ：两轮 /design-review（ **Approved ** （用户拍板 delta 核销免第三轮，A3 先例）。承重数学（厚度≤2【≡任意 3×3 窗口非全雾】/f≤8d/两态 AP/F1 谓词）经两轮对抗零动摇；承重规则不变（生成期布置约束 + 零特判 + fog unlock_level=2）。D2/registry/systems-index 三方已同步（跨字段校验 hide_numbers⇒safe_nonzero 致命、B4 三条定价硬约束、A1× `design/gdd/reviews/a4-terrain-variation-review-log.md` （含两轮阻塞→修复对照表）
7. **B3 设计会话进行中（2026-09-08 启动） ** ：上下文预收集同日完成——① review mode = lean（ **已锁事实不得默改 ** ：己方限时增益跨轮次延续（按剩余结算次数）、不跨战斗【game-concept 2026-09-06】；三向效果映射（安全格→主角 buff/开雷→敌方增益/标中雷→怪物 debuff）【v3 定稿】；标中旗一次性兑付、资格以雷格实例为键、拔旗重插不恢复【A3 OQ5】；debuff 档位锚严格 > 最低档安全格 buff 当量、对照基准=连锁放大边际挖掘收益【A3 F1 条款 2】；安全格 buff/标中旗 debuff/清图奖励/敌方增益统一当量单一线性换算、B1 闭合 owner【A3 F1 条款 1】；安全格奖励有回合限制甚至一次性、扫雷只入库轮末结算、P2 要求结算明细标注来源；④ 数据承载 = D2 StatusEffectTable 占位行（"buff 时限/叠层字段名"，单行全局，owner=B3 回填）；⑤ B3 为 Foundation 瓶颈系统，下游 B4/B1 未设计——接口契约需 provisional 登记（A3 条款 1/3/5 的 provisional 先例现成）；⑥ 无 docs/consistency-failures.md；既往一致性检查 0 冲突
8. **B3 已收口（Designed， ） ** ： `design/gdd/b3-status-effect.md` ， （ ； `status_effect` + action_economy.referenced_by 增 B3； ； **A1 扫雷棋盘生成（设计顺序第 5 位，MVP） ** ——注意 A4 已登记 A1×15 验收清单 + B3 登记 ambush/weaken 锚供给义务，A1 GDD 门禁评审须逐项核对
## GDD 设计顺序（前 10 = MVP）
D2 数据配置 → A3 行动经济 → A4 地形变异 → B3 增益状态 → A1 棋盘生成 → A2 排雷玩法 → B2 敌人系统 → B4 奖励经济 → B1 战斗结算 → D1 HUD →（垂直切片：A5 → C3 → C2 → C1 → B5）→（Alpha：
## GDD 写作纪律（制作人门禁意见）
- 每个 MVP 系统 GDD 一次会话完成：决策定稿 + 可调参数 + 事件接口，不写 20 页完美文档
- 总监修正意见已按系统登记在 systems-index"门禁修正记录"，写对应 GDD 时落实
<!-- CONSISTENCY-CHECK: 2026-09-08 | GDDs checked: 3 (d2/a3/a4) | Conflicts found: 0 | drift write-back EXECUTED (D2 Core Rules VariationTable row, same day) | Report: docs/consistency-report-2026-09-08.md -->
<!-- CONSISTENCY-CHECK: 2026-09-08 (B3 定稿后定向) | GDDs checked: 4 (d2/a3/a4/b3) | Conflicts found: 0 | drift write-back EXECUTED ×
<!-- CONSISTENCY-CHECK: 2026-09-09 (A1 定稿后定向) | GDDs checked: 5 (d2/a3/a4/b3/a1) | Conflicts found: 0 | drift write-back EXECUTED (D2 Dependencies 表 A1 行补 BoardGenTable 回填, same day) | Report: docs/consistency-report-2026-09-09-a1.md -->
<!-- CONSISTENCY-CHECK: 2026-09-09 (B4 定稿后定向) | GDDs checked: 8 (d2/a3/a4/b3/a1/a2/b2/b4) + game-concept 专查 | Conflicts found: 2 🔴 + 2 ⚠️ + 1 ℹ️ (全部同日修正: B4 错引条目名/义务编号 × ×
<!-- B3 定稿回写已执行（2026-09-08 同日）：registry status_effect 新条目 + action_economy.referenced_by 增 B3 + D2 Core Rules/Status 两处 + systems-index 两处（B3 进度行 + 门禁增补记录 B3 块） -->
9. **Task: Designing a1-board-generation GDD ** （ `design/gdd/a1-board-generation.md`
10. **A1 已收口（Designed， ） ** ：GDD 全节已写入（12 节零占位，~405 行；lean 门禁 systems-designer/qa-lead 已咨询；CD-GDD-ALIGN 按 lean 跳过）。定稿要点：五阶段确定性生成管线 · inferability = 免赌开据占比（F1 三通道 + 雾元知识信息源 + 次序无关 + metric_version）· clearable 合法性闸与质量度量两闸分离 · 验收三分支（达标即出/接受最优/**零合法接受最不坏**——用户定稿玩家永不卡死）· F4 批量红线**严格零**（用户定稿）· BoardGenTable 九字段回填（首个进度键表，solver_rules 冻结，参考行 provisional 归 C3）。registry 已登记 `board_gen_table` + action_economy.referenced_by 增 A1； ； ； ×
11. **A2 已收口（Designed， ） ** ： `design/gdd/a2-minesweeper-rules.md` ， 〔 – 〕 〔 × **A1 修订义务 ** （ `a2_event_surface` / `a2_initial_expansion` ； ：
12. **B2 已收口（Designed， ） ** ： `design/gdd/b2-enemy-system.md` ， 〔 – 〕 〔 × × ）
<!-- CONSISTENCY-CHECK: 2026-09-10 (B1 定稿后定向) | GDDs checked: 9 (d2/a3/a4/b3/a1/a2/b2/b4/b1) + registry 专查 | Conflicts found: 1 🔴 (B1 内部 AC 编号误引 ×9 处——同日修正) + ℹ （ − × ×
<!-- B3+A1 定稿回写已执行：registry（ （
13. **B4 已收口（Designed， ） ** ： `design/gdd/b4-reward-item-economy.md` ， 〔 – 〕 × ） **B3× × × × ** （全缺项即 blocking）、weaken 锚红警裁决（B3 OQ1 归一口径前置）、A3 F1 条款①–⑤闭合 owner、A4 硬约束②③对账、EC8 reload gate 落点、事件总线载体裁决（TD 门禁 2026-09-07 登记）
14. **B1 已收口（Designed， ） ** ： `design/gdd/b1-settlement.md` ，12 节零占位，628 行——项目最大 GDD； 〔 – 〔 〕 **结算触发 = Waiting 相位编排点 ** （不依赖事件到达序——A2 义务①）· **段序骨架 ** （授予→窗口〔授予段后〕→增益/减益→道具→战斗→衰减→判定——B4 义务①原文）· **23 条上游义务全落位 ** （ × × × × ， **F0 归一口径裁决 ** （瞬时当量；weaken − **条款①③⑤闭合首版验算 ** （条款③默认通过、满配 unit_count=3 破线→C3 约束；条款⑤两态通过+保守地板缺口登记；actuals p10 交付后强制重跑）· **高光双落 ** （ #2 完美排雷 × × #3 标中旗 highlight——用户拍板）· **战斗段短路 ** （hero hp=0 即中止——用户拍板）· SettlementTable 七字段回填（三行致命 manifest）。回写已执行（用户批准）：registry 新增 settlement_table/clause5_dominance + 四处接口漂移（weaken 值/anchor_warning F0 回执/clause3_supply 闭合/board_gen 消费回执）+ 三处履行回执 + terminology 五词条；systems-index B1 进度行 + 门禁增补记录 B1 块（**D1×3 义务清单缺项即 blocking** + C3 消费注记 + UX Flag + ADR 裁决项×2）；D2 SettlementTable 行回填。**下一步 = D1 HUD 与界面框架（设计顺序第 10 位，MVP）**——硬输入：全项目最大呈现义务台账（A2×6/B2× × × × ） – ）
15. **垂直切片启动（2026-09-10， ** ：概念名 **dungeon-sweeper ** ，目录 `prototypes/dungeon-sweeper-vertical-slice/` （用户已确认开工）。**验证问题**：玩家从零开始一场战斗，能否无指导 10 分钟内经历完整「开战→挖掘规划→轮末结算逐行兑现→胜/负」循环并逐行归因（P2）——以及能否按 GDD 约束（表值单点/RNG 封闭/结算可回放/Core headless）5 个工作日内以代表性质量建完。**范围内系统**：D2（9 表）· A1（含 single_subset 求解器 + 双判据验收，用户拍板完整验收）· A2 · A3 · A4（迷雾）· B1 七段编排全量 · B2 双敌种 · B3 四行 · B4 install 预分配+窗口 · D1-lite 程序化呈现（art-bible 明亮风）· encounter 直供两场（L1× ： – – ： （ ）
## 垂直切片速度日志（/vertical-slice，
- **Day 1（ ） **39/39 全绿（约 3 秒） ** ：表加载校验、R2 黄金向量 5/5、A1 双判据+确定性、两遭遇全战斗 3 轮终局、结算步骤流回放逐行相同。**修掉的关键 bug**：① B4 换图后 Retired 相位拒绝重 roll ② A2 `_do_dig` 对闭包全量发事件（应只发 O′∖O——重复奖励行根因）+ chain_size 口径 ③ B1 轮末最后一挖事件被相位守卫丢弃 ④ GDScript 不允许 Dictionary==bool。**重大设计发现**： `smoke/experiment_density.gd` 留档，README 登记表）。
- **状态**：循环可演示（Day 1，远早于 Day-3 检查点）。**下一步 = Phase 5 playtest**（用户跑 F5 人工试玩 → 按 vertical-slice 技能问询 → Phase 6 报告）。
16. **2026-09-11 拍板四条落地（切片程序调整完成） ** ：① atk 恒存在（[1,999] 拒 0、MVP=6、战斗段主角先手、attack_up 唯一修正——attack_up 死行复活）② 奖励两类（即时 75% 五类法 {buff,instant_aoe,instant_heal} 当场兑付 / 可选 25% 入库走窗口、heal_pack w6 p12）③ 库存关内延续（battle_over 不清、level_clear 清、UI 关卡模式共享 B4+HP 延续）④ 窗口至多一件（核心截断+文案）。实现主体由并行会话完成，本会话核对补缺口：settlement source_label_map 键去重（hero_action→hero_attack）、config_db required_sources 增 hero_attack、窗口文案、冒烟加 4 条拍板断言。**冒烟 43/43 全绿**；dump 验证：主角攻击 9=6×1.5、减伤叠满免伤轮、dur=1 当次衰减、治疗包入库、伏击 cap4 溢出行。**待办**：五项 GDD/registry 回写（README"2026-09-11 拍板"节全列）；playtest Phase 5 仍未做（用户试玩曾因窗口字段 bug 中断，已修）。
**更正（同日） ** ：条目 16 所列"待回写 GDD/registry 清单"作废——用户已在文档会话先行完成全部回写（b1/b2/b4 GDD、registry、systems-index、d2、game-concept、b3 的 2026-09-11 批），程序调整即以该批文档为依据。本会话完成的是：程序与文档的逐项对齐核查（五类奖励/75-25 权重/heal_pack w6 p12/库存关卡域/窗口单件含"取首件+诊断"/hero_attack 来源值/锚参照回迁 attack_up/reward tier 行集），README 已改记为"文档对齐核查记录"。冒烟 43/43 维持有效。
17. **垂直切片教训 → D1 GDD 设计输入（2026-09-11 登记，D1 GDD 门禁评审核对项） ** ：切片试玩两起呈现层崩溃（窗口条目缺字段 round_index / battle_finished 发出后读已销毁的 b2.hero）暴露系统性盲区——已定稿 AC 全部覆盖 core 层，D1 呈现层无测试承载，且 GDScript 编译不查字典字段与时序。**D1 GDD 三条硬性要求（缺项即 blocking）**：① 每个面向呈现的信号载荷成文 schema（对齐 A2 三事件先例，字段清单入 GDD）② 场景级 headless 测试进 AC（真实实例化 UI 场景 + 驱动完整对局 + 断言零脚本错误；切片的 headless UI 冒烟为其原型）③ 信号时点状态可见性规则（销毁前捕获、载荷数据自包含、禁止呈现层回读核心生命周期状态）。另登记：gdUnit4（D2 OQ1）若引入，UI 场景测试以此为载体。
18. **战斗期望值现状核查 + 实测（2026-09-11，用户问询触发） ** ：文档侧——**"期望胜轮数 / 期望每轮承伤 / 期望败北轮数"无任何直接设定**；最近的三个既有数字全部过期：① B4 刀供给方向预检（2026-09-09：击杀需求 18/54、供给≈2|资格格|）基于旧权重与"无基础攻击"口径未重算 ② B1 F5 Δr（清图轮数 L1≈2/L2≈4）基于旧密度参考行 ③ B1 E_dig=7.2（旧权重 40/25/35）。C3（难度曲线，此类期望的正当 owner）未开始设计。**实测（smoke/monte_carlo.gd， × （ × × × – （ –
19. **垂直切片 v2——第一关完整关卡（2026-09-11， ** ：用户拍板线性第一关（无路径分支）：**战×2 → 随机主动道具点 → 战×2 → 血量恢复点 → Boss 房**，同步进入数值设计（元进度模拟）。落地：① **LevelTable ** （新表 `level.tres` + schema——线性节点链数据位，节点 enum {battle,reward,rest,boss}，末节点必须 Boss； **C1-lite 推进器 ** `core/c1_level_runner.gd` （关卡域生命周期 owner：共享 B4 + HP 携带 + 节点兑付 + 关卡末 level_clear + 测试面板 hero 覆盖；Core 零 UI 依赖）③ **B4.grant_node_active() ** （接口漂移登记——可选类活行 roll 一件入库，reward_roll 恰一 scope）④ **B2 spawn max_hp 修复 ** （原 max_hp=hero_hp 入参压扁携带 HP——恢复点/治疗包满血守卫失效）⑤ EnemyTable L1 深度轴 D0– × × × – × × ； **测试用角色数值调整板 ** （ – `smoke/level_autoplay.gd` ）。工具：`smoke/level_monte_carlo.gd` （atk%×hp% 网格扫描：通关率/承伤期望/败北节点分布——C3 关卡侧批量工具原型）+ `level_debug.gd` （单关诊断）。冒烟 55/55（新增关卡 10 断言：满配通关/裸装败北/奖励点入库/恢复点公式/Dmax 解析/关卡回放确定性/hero 基线恢复）。**首版调参实测**：敌 HP 208 时基线通关率 73%——预警⑥关卡尺度坐实，v2 上调至 290 后复测中。**登记**：
20. **Playtest 三缺陷修复 + 奖励期望汇报（2026-09-11，用户 F5 试玩反馈批） ** ：**缺陷① UI 抖动**——悬停文案换行推挤侧栏布局、"第 N 轮"库存行被挤出视口；修复 = 侧栏全部动态区固定槽高 + clip_contents（区域独立、超长裁剪不回流）。**缺陷② Boss 战 AP 用完不结算（软锁）**——根因 = **A2 核心 bug（ ** ： `_do_flag_place/_do_flag_pull` 花完末点 AP 后 A3 翻 Waiting 但不发 round_end， `_emit_round_end_flags_and_payload()` （与 `_do_dig` 同款）；正式侧义务 = A2 GDD F4 事件序契约补"旗动作路径 round_end 发射"（接口漂移）。**新增测试载体**：`smoke/ui_click_probe.tscn` 行为探针（合成鼠标事件走真实 UI 路径，随机混合插旗/拔旗/停手/窗口期刷新/无效点击——4 种子全关通扫）；smoke_all 加旗动作耗尽 AP 回归断言。连带：L1 12× （ `smoke/reward_expectation.gd` 。
21. **可选类供给控制器（2026-09-11 用户拍板批——伪代码审阅后落地） ** ：用户重新定义三尺度指标——**格 <0.01 / 板≈0.78 / 战斗期望≈1（首件保证 + 指数递减）**，可选类退出格子权重池。拍板四条：① 注入占比小刀 60/精工 30/**治疗包 10**（治疗宝贵）② 清图奖励改**一次性高额伤害**（ **指数递减 ** （ ， `RewardSupplyController` （ （ ； – （
22. **缺陷④ 道具使用后不消失（2026-09-11 用户 playtest 反馈批） ** ：可用次数语义本身存在且正确（`b4.use()` 一次性标记 Used 不可逆，库存过滤 InStock）——真实根因 = **UI 层契约违例 ** ： `_window_items` 位置（义务④"选定序"），UI 选用按钮传 `item.index` （库存数组句柄）；未消耗过时二者巧合相等，消耗过一件后句柄=位置+已耗数错位 → 选中件不消耗、邻件被误耗（Boss 战道具多、多次消耗后暴露）。修复 = UI 与行为探针统一传窗口位置；行为探针加"选用必生效"断言（选中件库存态必须变 Used，失效即退出码非零——种子 7/23 实测生效 1/2、失效 0）。冒烟 74/74 维持。**登记义务**：
23. **缺陷⑤ 数值调整板被遮挡 + 专属测试补建（2026-09-11 用户质询批） ** ：用户质询"调整板没实现/没测试"——实现存在（含批量模拟），但**层级 bug 使其不可见**：调整板覆盖层位于不透明开始覆盖层之前（场景树序），打开时未隐藏开始层 → 面板被完全遮住 = "点击无反应"。修复 = `_show_tune_panel` 隐藏开始层 / `_close_tune_panel` （含"应用并关闭"）恢复；顺带删除重构引入的重复函数定义（同名 parse error）。**专属测试补建**： `smoke/ui_tune_probe.tscn` （场景级全链路 7 断言：打开可见性〔缺陷⑤回归〕/ 滑条→生效预览联动 / 应用写 hero 表 12/75 / 重置回 6/50 / 批量模拟 N=10 全链路〔通关率+败北节点输出〕/ 关闭回开始界面 / 加成跨模式持久）——PASS。全量回归：冒烟 74/74、ui_probe PASS、行为探针种子 7 通过（选用生效 1/失效 0）。**教训登记（D1 GDD 输入④）**：覆盖层堆叠顺序 = 呈现层隐形缺陷高发区（"功能存在但不可达"），任何模态覆盖层必须有"打开时遮挡物隐藏"的场景级断言；此三类缺陷（①②⑤ 呈现时序/层级 + ④ 呈现契约）全部漏过既有 AC——呈现层场景测试从"建议"升级为切片标配（ui_probe/ui_click_probe/ui_tune_probe 三探针）。
24. **呈现层模块化重构（2026-09-11 用户批——"上帝对象"拆分） ** ：用户工程师视角否决 main.gd ~1100 行上帝对象。拆为 **9 个单一职责单元 ** （ ：
25. **Core 层领域命名批（2026-09-11 用户问责 → AskUserQuestion 拍板） ** ：用户质询 core/ 的 a1_/b1_/c1_ 前缀命名（"规范缺失还是能力不足"）。**定性**：ID 前缀 = 跟随 GDD 文档名的事实约定（意图 = 设计↔代码追溯），但从未成文、且同目录 board_data/config_db/rng_service 无前缀——两套命名并存即规范缺失铁证。**拍板 = 改领域命名**：8 文件机械更名（a1_board_generator→board_generator、a2_board_rules→minesweeper_rules、a3_action_economy→action_economy、b1_battle_orchestrator→battle_orchestrator、b2_unit_container→unit_container、b3_status_container→status_container、b4_reward_economy→reward_economy、c1_level_runner→level_runner），类名同步去前缀（BoardGenerator/BattleOrchestrator/LevelRunner…），.uid 随行保资源身份；全项目 .gd 引用（15 文件）批量替换；每文件头注新增「实现 GDD： ：
26. **代码规范成文 + CLAUDE.md 必读门（2026-09-11 用户拍板） ** ：用户令将全部已指出的陋习总结成规范文档。落地：**`docs/code-conventions.md` **（新建）——六类纪律（结构：禁上帝对象/类封装/依赖单向/领域命名/禁事实约定；契约：信号事件成文与发射完整性/标识符语义单一/覆盖层层级/状态字段显式；测试：场景探针标配/打开可见性断言/缺陷沉淀回归断言/提交前全量；语言：GDScript 六条实战坑；数值：口径显式/先测后调/跨尺度推演/拍板零发挥；流程：伪代码审阅→实现→双登记）+ **缺陷-规范对照表 ** （缺陷①②④⑤、上帝对象、ID 命名、可选类 24.8 件——每条规则挂本项目真实反面案例）。**CLAUDE.md**：原命名节替换为「代码规范（写代码前必读）」门 + 摘要，指向 docs/code-conventions.md 为单一事实源。回归：冒烟 74/74、ui_probe PASS（文档批不触代码，例行确认）。
27. **轮内刷新方案 A 落地（2026-09-12 用户拍板批） ** ：用户确认刷新实现（仅 Waiting 受理）与设计预期不符（预期 = 扫雷阶段遇推理死路、有剩余 AP 且 RAP 足够即当场刷新继续挖）。**影响分析先行**（三方案对比：A 轮内不打断轮次 / B 停手+刷新组合宏 / 时间税差异点破——"刷新是否触发敌方结算"是唯一实质差异；16 代码触点 + 8 文档 + 5 数值连锁清单）→ 用户拍板 **方案 A ** ：Active 相位当场换图继续挖、AP 保留不重置、不触发结算、RAP 够即可、**每轮兜底上限 2 次**（表值 refresh_max_per_round）。**实现**： `request_refresh_active()` （仅扣 RAP）· A2 install/retire 增 `during_round` 显式通道（其余守卫不变）· B1 `can_request_refresh()` + 双相位重写 + 每轮计数 · **facts 身份快照隔离 ** （实现批新暴露的深坑：轮内换图后旧图已挖未结算格与新图坐标重叠，轮末 grant 错拿新图身份——解法 = 缓冲期 `query_full_snapshot` 冻结身份、授予直通快照绕过现行 mapping/_granted）· B4 `query_full_snapshot()` · HUD 按钮"弃图刷新（RAP -8 · 每轮至多 2 次）"。**验证**：冒烟 88/88（ ：
28. **Task: Designing c3-difficulty-curve GDD ** （ `design/gdd/c3-difficulty-curve.md` · 上下文摘要已呈现（上游 D2/B2/B1 全 Approved；锁定事实：clause3_supply 满配破线约束、B1 条款⑤未闭合约束包、A1 Boss=Dmax 约定 + OQ6、A4 scope=global 语义位、B4 全部 provisional 值归 C3；切片实测现状：敌深度轴 D0-D4/供给 p0-0.4/基线通关 55-80%）
29. **主架构文档产出（2026-09-12， ** ： `docs/architecture/architecture.md` v1.0 已写入（TD 自评 APPROVED WITH CONDITIONS； `.claude/docs/director-gates.md` 缺失登记 QQ-10）。要点：① 20 系统五层映射（依据 systems-index 依赖分层，切片实现验证）② 模块所有权地图（Owns/Exposes/Consumes/引擎 API，含切片新增件 RewardSupplyController/LevelTable/level_runner）③ 四条数据流（帧更新/事件信号/存档快照/初始化顺序）④ API 边界契约表（GDD AC 前言为规范源）⑤ ADR 审计：现存 0 份；63 条 TR 可追溯性 = 46 条架构文档+GDD 承载 / 12 条待 ADR / 5 条随未设计系统，0 孤儿 ⑥ **Required ADRs 13 项分级 ** （必须编码前：ADR-0001 事件总线与编排载体〔推荐组合根直连 signal + Waiting 相位触发〕/ ADR-0002 渲染器与窗口〔推荐 2D 用 gl_compatibility〕 ： `/architecture-decision "event-bus-and-orchestration-carrier"` 等 4 个 Foundation ADR → /architecture-review（新会话）→ /gate-check 前置项（/test-setup /ux-design）。注意：与条目 28 的 C3 GDD 设计会话并行中——ADR-0001/0002 落定结果与 C3 无接口冲突（C3 消费 B1 对账输出为文档层事实依赖）。 → **GDD 完成（2026-09-12 同会话） ** ：12 节全部写入（用户全权委托——"所有选择按推荐"，逐节问询按用户指示跳过；solo 模式专员代理跳过已在各节登记）。关键决策：① 承载结构 = 直填行值主体 + DifficultyTable 修饰结构位（MVP 空表，B2 Rule 10 兑现）② 切片 SLICE-TUNED 行集转正 MVP 默认曲线 ③ 难度期望表（通关率目标带 L1 基线 40–60%/供给平衡带 [1.1,2.0]——F5/F6）④ F1–F7 全部为设计期工具式、运行时零新增公式 ⑤ B1 条款③⑤/预警⑥约束承接：条款⑤ MVP 接受非支配设计态（C 量级不上调，OQ4 playtest 观测弃图率）⑥ A4 scope=global 语义定稿（仅 Boss/精英图，MVP 不产生行）⑦ Boss 血量占比 0.81 越带如实登记 OQ2。registry +3 条目（difficulty_table/difficulty_expectation_table/boss_dmax_convention）· systems-index C3 → Designed。**注意：未经 /design-review——solo 出稿待人工复核，独立评审须新会话 `/design-review design/gdd/c3-difficulty-curve.md` **。
29. **C3 GDD 落地切片 + 试玩采集清单（2026-09-12） ** ：用户拍板跳过 /design-review（ （ ） × **96/96 ** （+8）。下一步 = 用户 F5 试玩采集 → OQ 裁决 → （可选）新会话 /design-review。
30. **Foundation 四 ADR 落定（2026-09-12， × ** ：ADR-0001（事件总线=组合根直连 signal + B1 Waiting 相位触发；信号实名 round_end_board/round_end_stopped； （ × （ ； ， #6360 ）；CI 必配外部 wall-clock 超时；click_probe 口径修正 = "真实翻译出口"； （ `docs/architecture/adr-0001~0004-*.md` 四文件（Status: Accepted） `docs/registry/architecture.yaml` （新建：interfaces × × × ）
31. * * /test-setup 完成（2026-09-12， `tests/` 脚手架 + `.github/workflows/tests.yml` 已创建——**一处对 skill 默认的有意偏离**： （ （ （ （ （ – （ ， ， （
32. **门检查前置工件补齐（2026-09-12，用户拍板"先补工件再跑门"） ** ：用户 invoke /gate-check 后发现阶段漂移（stage.txt=Systems Design 但实际已在 Technical Setup 深处），选择先补工件。同批完成：① * * `docs/architecture/requirements-traceability.md` **（新建——gate 要求的专用矩阵：63 条 TR 分层覆盖表，Foundation 36 条零缺口核验逐条列载体；Core 待 ADR-0006/0007， **ADR-0005 `save-contract-and-schema-versioning` ** （新建 Accepted——SCHEMA_VERSION 比较归属 D3 + RNG 快照切点契约收拢，Foundation 层最后两条 pending TR 闭合）③ architecture.md §Required ADRs 重排（0005 已用 → 应有队列重编号为 0006–0009，可推迟 0010– ： （ （
30. **试玩日志器 + 诊断转储（2026-09-12 用户需求批——playtest 数据采集基建） ** ：① B1 新增 `settlement_snapshot` 信号（每结算末尾全量状态快照：判定段重构为 verdict 先算→快照→分支——快照含 despawn 前终局；板序号 _board_seq 归因）② 新组件 `presentation/playtest_logger.gd` （ ： ： ×
34. **战斗屏 UX 规格产出（2026-09-12， ** ： `design/ux/battle.md` 已写入（Status: Complete 待 /ux-review； （ × × × 〔 × × × ： `design/accessibility-requirements.md` 与 `design/ux/interaction-patterns.md` 两件套仍未建（spec 内建 WCAG AA 基线承诺，正式分层待补）；相邻域屏 NodeOverlay/关卡结算建议后续 spec（
31. **试玩批次 1 → v3 数值批（2026-09-12，F7 流程首次完整实践） ** ：用户 6 项反馈（满血全通关/Boss OK 或可上调/刷新零使用/零弃图/DND 命名指令/道具先保留）→ 裁决：OQ3 方向确认（真人>>模拟）、OQ2 初步裁决（F3 带 [0.35,0.55]→[0.5,1.1]）、OQ4 初步关闭（非支配成立）、OQ6 读数（盲猜墙不足非刷新太顺滑——密度杠杆留观测）。**v3 数值批**： （
32. **Peglin 对比研究报告（2026-09-12，用户问"Roguelike 体现"触发） ** ：报告 = `design/research/peglin-comparison-2026-09-12.md` （数据源 peglin.wiki.gg 逐页核实：Peglin 基础 HP 100、Forest 敌 60-65HP/1-5伤、Boss 900、精英 500、每场战后回复、每场遗物选择）。**三根因结论**：① 构筑密度差一个量级（Peglin 每场 1 次遗物选择 vs 我们每关 6 件——"局感"第一根因）② 遭遇零随机+线性无分支 ③ 资源模型不同（Peglin 战后回复+低伤多场 vs 我们无回复+高伤少场——**数值不可直接移植，只可比结构比例**）。**行动建议**：本切片可做 = 遭遇随机化（同敌种 unit_count 区间掷骰，不触 B2 行集锁定）；后置 = 多波战斗（B1 波次表）/遗物协同（先设计协同再提密度）/战后回复（绑定敌 atk 下调）。用户决策点 = 是否本切片做遭遇随机化。
33. **遭遇随机化落地（2026-09-12 用户拍板——Peglin 对比报告结论 2 的本切片项） ** ：报告 `design/research/peglin-comparison-2026-09-12.md` （三根因：构筑密度/零随机/资源模型；数值不可移植只可比结构比例）。**用户拍板先做遭遇随机化**。C3 GDD 增补 Core Rule 8（ （ ） ； ） （
35. **战斗屏 UX 批：评审通过 + pattern 库建立（2026-09-12， ** ：① **上游契约批落地 ** ——battle.md /ux-review（ ） `refresh_board` 编排+stopped/ap_exhausted 恒 same_board、旧旗作废、时间税失效预警 OQ3 联动）。**注意与切片 entry 27 命名对账**：切片代码用 provisional 名（`request_refresh_active()` /`can_request_refresh()` /`refresh_max_per_round` /`during_round` ），GDD 用正式名（`request_refresh` Active 受理/`refresh_board` /`refresh_cap_per_round` 结构位）——语义一致，正式 D1 批统一命名 ② * * /ux-review 独立复检**（全新上下文代理）：1 blocking（ **VERDICT: APPROVED ** （§13 台账 27 项义务承接逐项实存验证）③ **interaction-patterns.md 已建 ** （用户拍板"先写核心 8"）：双源拒绝反馈/原位窗口激活/逐行兑现明细带/悬停预承诺光标/点阵资源显示/模态 overlay 层级纪律/破坏性确认异位/禁用态即理由全文 + 12 目录占位（实现期回写义务）④ Phase 2 视觉 spec 跳过（用户拍板，art-bible §1–4 直接驱动）。**下一步 = Phase 3 单次协调实现**：
36. **战斗屏五区改造落地（2026-09-12， ） ** ： ： – （
37. **伤害类型 × 护甲克制批落地（2026-09-12 用户拍板——设计会话设定表定稿"没有问题"后落程序） ** ：**结构**——敌人护甲类型 {无甲,护甲A,护甲B}（ ） **标错旗随机惩罚三选一 ** （ ， （ ： ： （ （ （ ： ）
38. **呈现层 code-review 修复批（2026-09-12， ** ：全切片 53 脚本评审（含两 specialist 并行审查 views/ 与 smoke/+schemas/）裁决 7 项必改，本批清偿：① **TunePanel 封装破口 ** （视图直写 hero 表 + 视图 load smoke 驱动 core → 面板模拟 pct² 口径 + 模拟后表值残留污染真实对局）——重构纯视图信号外发，加成落表收口组合根 `_apply_hero_override` 单一路径（每次从基线幂等重算），模拟编排拆 `tune_sim_controller.gd` ② **意图徽标双翻译 ** （ **C 区 RAP 死分支 ** （ `_last_rap` 成员存储 ④ **smoke_all 恒真断言**改带标签真实断言 ⑤ **level_runner core↔core 接线 lambda × ** （ **B1 `diagnostic_snapshot()` 诊断观测面 ** （ **main.gd 761→667 ** ：节点构建/模态层级/叙事文案/模拟编排四拆分（ui_assembler + modal_stack + battle_narrator + tune_sim_controller，均无 class_name 走 preload； ：
<!-- CONSISTENCY-CHECK: 2026-09-12 (lore 换轴概念层增补后全量) | GDDs checked: 10 (d2/a3/a4/b3/a1/a2/b2/b4/b1/c3) + game-concept/game-pillars/ux-battle/registry/session-state 专查 | Conflicts found: 2 🔴 (registry 09-11 批 fields 行漏网——category 五值残留三值 / p_min 默认 4 残留——同日修正完毕、复查清零) + 2 ⚠️ (B1/B3"雷是赌桌不是陷阱"措辞碰撞 / lore ②敌种行 vs 切片 DND 命名 goblin-bugbear-ogre_chief) + ℹ
39. **封装收口批落地（2026-09-13， ** ：代码架构审查报告 `docs/architecture/code-architecture-review-2026-09-13.md` （ `presentation_snapshot()/is_battle_live()/stock_count()/query_reward_identity()` 成文呈现面（a2/a3 保留公有 = API Boundaries 登记的 D1 契约面）；**E2** A2 board/revealed/flags 私有化 + `current_board()/reveal_record()` （ `.revealed` 的自相矛盾收口）；**E3** B2 hero/enemies 私有化 + `hero_unit()/all_enemies()` 投影（presenter 死亡残位需求收进 API）；**E5** A3/RngService 只读字段 getter-only 机制化（phase/ap/rap/last_round_end/master_seed）；**O1+O2** 调试模式拆 `debug_session.gd` （调参语义单一实现；battle_created 先于 begin_battle = ADR-0001 接线归组合根 + 缺陷①时序——ui_probe 抓获初版 battle_ready 才接手 b1 的雾提示丢失）；**O3** `core/damage_math.gd` 纯算术抽取 + board_generator 重复求解合并；**P3** 头注溯源 ×4 / B4 返回值统一 null / equivalence_supply 表行 duplicate / load→preload × `_on_board_action` 清图判定在 settle_batch 同步重入（关卡终局置空 b1）后摸 `b1.a2` 的 SCRIPT ERROR——click_probe stderr 归零（优于基线）。**验证**：冒烟 141/141 + 三探针 PASS（
40. **P2 收口批落地（2026-09-13，用户拍板两项均做——封装审查 P2 设计稿批准） ** ：① **E4 表值参数化 ** ： `_apply_hero_override` /runner `start_level` 写表），加成经 encounter 显式参数（B1 begin_battle +hero_atk/hero_max_hp 字段 → B2.spawn +atk_override/max_hp_override 参数，-1 表值兜底）——双写叠加 6→18→54 与双基线同步整类隐患移除，D2 单一事实源机制化；registry 新增 `hero_override_parameter_passing` （ **O4 自动玩家单一实现 ** （合并 W-3）：`smoke/auto_player.gd` （ ）
41. **art-bible §1– ， ** ： `design/art/art-bible.md` （ ； （ ） （ `/design-review design/gdd/d1-hud-framework.md` ，
42. **GDD lean 格式迁移完成（2026-09-13， ** ：全部系统级 GDD 按新模板（`.claude/docs/templates/game-design-document.md` ）重排，`tools/gdd_lint.py` 11/11 PASS（表格占比 81–89%）；修订注记出正文→版本历史表；原稿备份 `design/gdd/legacy-2026-09-13/` 。**随迁按 registry 回执写现行的语义统一**： （ − （ × （
41. **零承伤根因分割探针 + playtest-09-12 Bug #1– ， ** ：① **根因分割探针 `smoke/damage_probe.gd` ** （ × × × **BUG-0002/0003/0004 建档 ** （ #1 空遭遇 = **首轮全灭被快照盲区误读 ** （ （ #2 Boss 攻击零兑现 = 设计语义非 bug → Closed（ #3 grant_node_active 绕过 _supply.notify_granted = 代码实锤 → **Fixed ** （stock 受理后补入账，战斗域清零语义不变 = 零战斗数值影响，纯口径）。回归断言 +7（spawn_count 字段/等值 · 遭遇全深度×12 种子全域 60 场 · _smoke_attack_chain_fresh_pool 攻击链钉死 · _smoke_supply ⑦ 节点奖励入账）。③ **Q1 复扫基线 ** （ × **17% ** （ – **35.1– ** （带 ≤20%）· Boss 场 **71.3– ** （带 ≤50%）（hp+0 档）——**F4/F5 全档位越带**，拆墙 + v3 atk 叠加后难度由严重不足摆向严重过剩。**本批零数值变更**（敌 hp 与奖励供给禁独立调参——registry 预警⑥联动；杠杆方向列待拍板，基线 = F7 测量输入）。**验证**：冒烟 **148/148 ** （141+7 新回归）· 三探针 PASS · damage_probe boss 7/7 + level 种子 42/43/44 全 PASS。**待拍板/待设计批**：①难度杠杆重拍板（F4/F5 越带——候选 atk 回撤/防御权重回升/供给联动，归 C3 F7）；②墙语义候选改法（clamp 收紧/乘法衰减/重击拍穿防——/propagate-design-change + B3 GDD 文字同步）；③供给量语义重拍板（每战斗 vs 关卡域首件保证——C3）；④浅深度首轮跳战可玩性（C3）。切片 README 同批登记。
42. **D1 已收口（Designed， ， ** ： `design/gdd/d1-hud-framework.md` ，12 节 + 台账表/冲突清单零占位，25 条 AC；**专员/总监代理全部跳过，出稿待人工复核；未经 /design-review，独立评审须新会话**）。定稿要点：① **呈现义务台账 27 项逐项落位 ** （ × × × × × × **切片教训三条硬性要求兑现 ** （ **命令式回执驱动**五面成文（registry `d1_presentation_surface` 登记；battle.md §Events Fired 措辞差列冲突⑥）④ **命名统一核销 ** （ ： `/design-review design/gdd/d1-hud-framework.md` → `/review-all-gdds` → `/gate-check` **（ ；
42. **四项拍板落地（2026-09-13，用户四问裁决——本批零玩法数值变更） ** ：①**难度主杠杆 = 先真人试玩再拍**（F5 真人修正系数标定优先于数值调整；模拟基线 17% vs 带 40–60% 的越带方向真人预期只会更确认，杠杆方案保持待拍板：atk 回撤/组合/专项三案备选）；②**墙语义维持现状 + 归零护栏**：smoke_all `_smoke_wall_zero_guard` 表级不变式（2× ： **8% ** （ （ – **149/149 ** （+1 护栏）· 复扫各列与 Q1 基线逐值一致（collect_rows 开启不改变行为——确定性交叉验证）。**下一步（用户侧）**：真人试玩一局（观测清单：通关/败北节点 = F5 修正系数分子；普通场掉血体感；Boss 战轮数；d0–d3 跳战与否；治疗包缺血时刻与库存残留 = 拍板③数据）→ 会话分析 JSONL 出修正系数与①③④复议数据。
40. **A5 扫雷辅助道具 GDD 定稿（2026-09-14， ** ： `design/gdd/a5-minesweeper-aux-items.md` （ `a5_aux_items` 条目 + terminology 四词条（叠加层/真视窄域护栏/渗透率）+ `variation_table.counter_item_ids` 回填 [probe_dust]（ – ； ： ： （
## Session Extract — /review-all-gdds 2026-09-14
- **Verdict: FAIL**——2 blocking（① B3/B1： − × `design/gdd/gdd-cross-review-2026-09-14.md`
- **同日 A5**： **Approved ** ；日志 `design/gdd/reviews/a5-minesweeper-aux-items-review-log.md`
- **下一步**：新会话按报告 §七 批调度跑回写批（D2/B3 → B1 重算 → B4 规格 → C3 收口 → 零散）→ `/review-all-gdds since-last-review` 增量复核 → PASS 再 `/create-architecture` ；⚠️ 评审期间检测到并行会话修改 GDD（C3 回写批半途落地致两代理结论互斥）——批收口前勿多会话并行改设计文档
43. **C2 冒险结构 GDD 定稿（2026-09-14， ** ： `design/gdd/c2-adventure-structure.md` （ `level_table` / `adventure_table` 两条件目 + 补登 `hero_override_parameter_passing` （切片 E4 批实现但 registry 缺登——缺口闭合，owner=b1， ： × （ × （
44. **完美策略档测量批（2026-09-14，用户拍板"增加完美策略档测试验证"——OQ7 技能轴上界仪，零玩法数值变更） ** ： ） `policy` 参数 + level_monte_carlo 策略轴（CLI 第 3 参）与踩雷/刷新观测列（零踩雷断言 quit(1)）；core 零改动，冒烟 **149/149 ** 。**读数（N=30，种子 4200–4229）**： **100% ** 、剩 HP 均 **47.4/50 ** 、踩雷 0.00（弱策略基线 60%）；+50%～
45. **伤害量值区间批（2026-09-14，用户拍板②——验收口径改完美策略档 0 加成 ≤40%；两步全落地 + 无效性实测） ** ：第一步奖励侧五行 power 区间化（heal_minor[2,6]/knife_t1[5,11]/heal_pack[6,18]/knife_adv[10,22]/clear_blast[25,55]——身份批追加取号，E14 快照口径不变，B1/呈现零改动）+ 第二步敌方 atk 区间（六行 ±3，遭遇骰同流 spawn 期整战持久——每拍抖动否决〔数字可读性锚〕，B2 零随机保持，spawn +1 参数接口漂移登记）；中点恒等现值 = A3 条款①锚不漂移；schema 双批校验（成对/中点锚/buff 禁止）+ smoke `_smoke_power_interval` 4 断言；冒烟 **154/154 ** 。**实测（N=30）**：完美档 0 加成仍 **100% ** （承伤 3.5→3.9——方差真实流动被 47/50 血缓冲全吞）；基线档 17% 不变——**数值区间杠杆族对 ≤40% 线无效已坐实**（完美玩家结构性优势 = 零踩雷直伤 + weaken 顶格 + 快杀）。**待用户三选裁决（C3 OQ7 主项）**：①承伤硬地板（B1/B2）②weaken 饱和语义（B3/B1——拆全标旗基石）③极端宽度（建议否决——毁基线与可读性）；区间机制保留（普通玩家方差体验有效）。registry reward_table/enemy 条目 + clause5 义务 + C3 行值总表/F5/OQ7 同批登记。
DKChan committed