docs: 系统更名批 + 可选类删除后 UI 文档收口
更名批（用户拍板 2026-09-16）：奖励道具经济→地图战斗资源（定义已双向化——格面承载、 战斗结算生效）、辅助道具→魔法道具（已非纯数值道具，信息/妙用向）；两 GDD 文件 git mv， GDD 全树 + registry + UX/美术/研究/文档全仓口径同步；英文代号 REWARD_ITEM_ECONOMY / AUXILIARY_ITEMS 暂沿用；版本历史旧行按约定保留旧名。 UI 收口批：battle.md / HUD框架.md 按代码现实收口——四区布局、五段结算、10 类明细行， 删 E 区道具面板、道具窗口态、query_inventory 登记与旧空态/囤刀措辞；魔法道具预留义务行 保留（库存条/指向交互/叠加层随其 P0 批设计）；02-系统清单 地图战斗资源概要行与 architecture.md B4 行改现行口径。 验证：残留 grep 现行条款零命中；全量 smoke 211 项 0 失败 + 四 UI 探针通过。
This commit is contained in:
DKChan committed
1 parent
3540fdbd31
commit
4e004cd832
31 files changed
+413
-363
No files matched your search
@@ -23,10 +23,10 @@ entities:
|
||||
streams: [board_gen, reward_roll, encounter]
|
||||
stream_names: 当前封闭清单（增流需改代码 + P1 支柱评审；combat_var 已于 2026-09-07 full 评审删除——玩法随机不预置基础设施；**encounter 增流 2026-09-12 用户拍板**——遭遇随机化批 难度曲线与Boss GDD Core Rule 8，scope_event_binding = 每次战斗实例化恰一 scope，挖掘决策域之外 P1 合规）
|
||||
stream_facade: open_stream(stream) 取号（计数器+1→派生→返回已播种实例）；derive_at(stream, scope) 纯函数供测试/预览（不推计数器）
|
||||
scope_event_binding: board_gen=每次生成新扫雷图（棋盘生成）；reward_roll=每次 board install（格奖励批 + 清图奖励批）（奖励道具经济——2026-09-09 接口漂移改写，原"每次奖励结算 roll 批次"；奖励道具经济 Rule 2/AC-1 为契约源）；encounter=每次战斗实例化恰一 scope（战斗结算 begin_battle 实例化期、扫雷开始前——unit_count 区间均匀骰，挖掘决策域之外 P1 合规）
|
||||
scope_event_binding: board_gen=每次生成新扫雷图（棋盘生成）；reward_roll=每次 board install（格奖励批 + 清图奖励批）（地图战斗资源——2026-09-09 接口漂移改写，原"每次奖励结算 roll 批次"；地图战斗资源 Rule 2/AC-1 为契约源）；encounter=每次战斗实例化恰一 scope（战斗结算 begin_battle 实例化期、扫雷开始前——unit_count 区间均匀骰，挖掘决策域之外 P1 合规）
|
||||
unseeded_access: 致命中止
|
||||
snapshot_contract: 续玩/复盘快照 = master_seed + 各流 scope 计数器（消费方 存档序列化）
|
||||
referenced_by: [棋盘生成, 战斗结算, 奖励道具经济, 冒险结构, 存档序列化]
|
||||
referenced_by: [棋盘生成, 战斗结算, 地图战斗资源, 冒险结构, 存档序列化]
|
||||
|
||||
- name: stream_seed_derivation
|
||||
type: formula
|
||||
@@ -43,7 +43,7 @@ entities:
|
||||
reproducibility_claim: 同冒险内同流各 scope 无碰撞 + 跨版本恒定（不做跨 master_seed 全局单射声明）
|
||||
master_seed_int64_min: 致命（abs 恒等回绕→与 0 静默别名）
|
||||
set_master_seed_precondition: 仅全流计数器全零时受理（3 流——2026-09-14 数据配置 漂移批口径）
|
||||
referenced_by: [棋盘生成, 战斗结算, 奖励道具经济, 冒险结构, 存档序列化]
|
||||
referenced_by: [棋盘生成, 战斗结算, 地图战斗资源, 冒险结构, 存档序列化]
|
||||
|
||||
- name: difficulty_row_resolution
|
||||
type: formula
|
||||
@@ -79,22 +79,22 @@ entities:
|
||||
flag_rules: 旗 = 排雷玩法 棋盘状态单态（原口袋旗双态作废）；随图存续，清图/刷新消失；标中旗 = 怪物 debuff（三向效果定稿），兑付一次性、资格以雷格实例为键（每雷本次战斗至多兑付一次；放置实例仅为当轮结算载体；拔旗重插不恢复已消费资格——2026-09-07 三轮评审改定，OQ5/F1 条款 2）
|
||||
round_end_carrier: 双发射源（2026-09-07 修订）——棋盘路径（ap_exhausted/cleared）由 排雷玩法 外发（systems-index 原裁决不变），停手路径（stopped）由 行动经济 直发；payload 同构 (path_tag, continuation_hint)
|
||||
arbitration_priority: cleared > stopped > ap_exhausted（同帧/同批次结束路径总仲裁；stop-first 批次腿 deferral 至 排雷玩法 集成测试，义务清单见 systems-index 门禁记录）
|
||||
downstream_contract: 行动经济 F1 五条款（① 效果当量对照单一线性换算 · ② 标中旗锚严格 > 最低档 + 连锁放大边际基准 + 总吞吐对账 · ③ 挖掘风险不等式 P(安全)×buff > P(雷)×敌方增益，战斗结算 单一闭合 owner · ④ 清图奖励 > 0 且 奖励道具经济 差异化插槽（图类型战斗域恒定） · ⑤ 清图 vs 弃图刷新支配性，战斗结算 闭合强制检查点）——2026-09-07 三轮评审定稿
|
||||
downstream_contract: 行动经济 F1 五条款（① 效果当量对照单一线性换算 · ② 标中旗锚严格 > 最低档 + 连锁放大边际基准 + 总吞吐对账 · ③ 挖掘风险不等式 P(安全)×buff > P(雷)×敌方增益，战斗结算 单一闭合 owner · ④ 清图奖励 > 0 且 地图战斗资源 差异化插槽（图类型战斗域恒定） · ⑤ 清图 vs 弃图刷新支配性，战斗结算 闭合强制检查点）——2026-09-07 三轮评审定稿
|
||||
cross_field_validation: 任一动作成本（dig/flag_place/flag_pull）≤ ap_per_round——ActionEconomyTable schema validate() 跨字段类别，违规加载期致命（2026-09-07 三轮评审增补；条件性夹具登记 数据配置 校验双通道）
|
||||
referenced_by: [棋盘生成, 排雷玩法, 地形变异, 战斗结算, 增益状态, 奖励道具经济, HUD框架, 教学引导]
|
||||
referenced_by: [棋盘生成, 排雷玩法, 地形变异, 战斗结算, 增益状态, 地图战斗资源, HUD框架, 教学引导]
|
||||
|
||||
- name: variation_table
|
||||
type: schema_data
|
||||
owner: design/gdd/systems/排雷循环/地形变异.md
|
||||
attributes:
|
||||
table: VariationTable（数据配置 承载，键 = variant_id；地形变异 回填 owner，2026-09-08 定稿回填）
|
||||
fields: variant_id（String 主键唯一）/ display_name / unlock_level（int [1,999]，knob）/ scope（enum region|global，global 预留 难度曲线与Boss）/ info_mask（enum none|hide_numbers）/ cell_constraint（enum any|safe_nonzero）/ biome_tag（StringList，∅=通配，knob）/ counter_item_ids（StringList，辅助道具 预留，非 knob——2026-09-08 re-review 修正 ✓ 误标）
|
||||
fields: variant_id（String 主键唯一）/ display_name / unlock_level（int [1,999]，knob）/ scope（enum region|global，global 预留 难度曲线与Boss）/ info_mask（enum none|hide_numbers）/ cell_constraint（enum any|safe_nonzero）/ biome_tag（StringList，∅=通配，knob）/ counter_item_ids（StringList，魔法道具 预留，非 knob——2026-09-08 re-review 修正 ✓ 误标）
|
||||
mvp_content: 空清单（合法态）——无任何机制已定稿的变异类型；岩浆/冰冻只登记名字、无 MVP 行（垂直切片随关卡解锁建行，建行批随批配 ≥1 反制道具——aux_items 框架内容契约）
|
||||
zero_special_casing: 连锁/数字计数/清图/旗/价目/结算零特判——既有系统行为不感知变异状态（排雷玩法 执行逻辑无变异分支；地形变异 Rule 3 的推论）
|
||||
rule4_exemption: 定义表非进度成长表，键 = variant_id，进度语义承载于 unlock_level 列（数据配置 Rule 4 豁免，schema 注释承载）
|
||||
cross_field_validation: info_mask=hide_numbers ⇒ cell_constraint=safe_nonzero——VariationTable schema validate() 跨字段类别，违规加载期致命（2026-09-08 re-review 增；防未来 hide_numbers+any 行静默击穿 EC4 连锁停止；地形变异 夹具 variation_mask_constraint 承载）
|
||||
dangling_ref_policy: counter_item_ids 为 数据配置 的引用型字段——现行空清单下无引用行，取值悬空；首个真实引用随未来变异行建行批回填，届时激活悬空校验（数据配置 修订批；条件性夹具 aux_dangling_counter 登记 辅助道具 GDD AC-13）
|
||||
referenced_by: [棋盘生成, 排雷玩法, 辅助道具]
|
||||
dangling_ref_policy: counter_item_ids 为 数据配置 的引用型字段——现行空清单下无引用行，取值悬空；首个真实引用随未来变异行建行批回填，届时激活悬空校验（数据配置 修订批；条件性夹具 aux_dangling_counter 登记 魔法道具 GDD AC-13）
|
||||
referenced_by: [棋盘生成, 排雷玩法, 魔法道具]
|
||||
|
||||
- name: variant_pool_gate
|
||||
type: formula
|
||||
@@ -129,18 +129,18 @@ entities:
|
||||
enrage: { display_name: 暴走（敌方增伤）, target_side: enemy, magnitude: "+25 percent", duration_settlements: 1, max_stack: 16, stack_policy: stack, source_class: flag_miss } # 2026-09-12 标错反噬批上线——三池之一（进 enemy_output 池）
|
||||
off_guard: { display_name: 失衡（我方承伤加深）, target_side: hero, magnitude: "+25 percent", duration_settlements: 1, max_stack: 16, stack_policy: stack, source_class: flag_miss } # 2026-09-12 标错反噬批上线——三池之一（进 hero_defense 池，承伤 ×1.25）；2026-09-15 格面资源批起 = defense 型负向（标错 defense 型安全格 / 踩到 defense 型雷格兑付）
|
||||
sapped: { display_name: 乏力（我方输出降低）, target_side: hero, magnitude: "-25 percent", duration_settlements: 1, max_stack: 16, stack_policy: stack, source_class: flag_miss } # 2026-09-15 格面资源批新增——weaken 型负向（标错 weaken 型安全格 / 踩到 weaken 型雷格兑付），进 hero_offense 池（attack_up 镜像）；值 provisional
|
||||
value_status: 七行值全部 provisional（2026-09-15 四行→六行——标错反噬批 enrage/off_guard 两行收编；六行→七行——格面资源批 sapped 收编为 weaken 型负向；伏击复用为反噬第三池项〔现为 blast 型负向〕），验收锚——weaken→行动经济 F1 条款 2（奖励道具经济/战斗结算）· ambush 量纲→敌人系统（条款 3，**量纲已定稿见 ambush_unit_definition**）· 对照表→战斗结算（条款 1）· **weaken 已按 战斗结算 F0 裁决修订 −25→−65（2026-09-10，值域 [60,85]、终值共裁 战斗结算 OQ2——见 anchor_warning 回执）**
|
||||
ambush_unit_definition: **量纲已定稿（2026-09-09 敌人系统 GDD Rule 6/F2——registry OQ2 关闭条件兑现）**：+3 flat = 每层伏击为每次攻击类行为（attack/heavy）附加 3 点主角 HP 伤害（后置加法、不进倍乘）；charge 拍零兑付（空拍蒸发）；值仍 provisional（锚验收归 奖励道具经济/战斗结算——行动经济 F1 条款 3；敌人系统 供给 cap 表值与单结算自然边界口径见 clause3_supply 条目）
|
||||
anchor_warning: weaken 行 vs 行动经济 F1 条款 2 锚两独立线性代理同向预检不过（百分点·结算暴露 25 vs 100；原型战斗量级 ≈1 vs ≈4 当量）——战斗结算 对照验收优先裁决，登记 战斗结算 强制检查点输入。**修复空间不对称（2026-09-09 增补）**：每结算瞬时当量归一 m_w≥51 可行（F2 越域界随移 AP 界 −408%/表界 −816%）；每 AP 总暴露归一 m_w>100 被 percent ∈ [-100,100] 域禁止（该分支不可行）——OQ1 前置步骤：战斗结算 先钉死归一口径，口径落定前禁止数值修订；落总暴露则现实解 = 奖励道具经济 重定最低档参照。**参照对象迁移注记（2026-09-09 奖励道具经济 评审；2026-09-11 回迁）**：最低档安全格 buff 当量的参照对象曾迁 defense_up 当量（attack_up 时为死行——奖励道具经济 F4 迁移）——**2026-09-11 用户裁决"基础攻击恒存在"（HeroTable.atk 域 [1,999]、0 加载拒绝、MVP=6）后 attack_up 复活，参照对象回迁 attack_up 当量**（消费面 = 主角战斗段先手攻击——战斗结算 GDD 同批；defense_up 迁移退役为历史记录，attack_up 入池时 tier_min_buff 重算）；本条与 clause3_supply.direction_precheck 的 25 vs 100 预检算术系 attack_up 口径历史登记——defense_up |−50|×dur2 与 attack_up 数值巧合全等（100pp），今日结论不变；**迁移后预检未按新参照重跑**的义务已于 2026-09-14 战斗结算 重算批兑现（F0/F1 按 attack_up 当量重跑 + F1 锚对照实物改 attack_up 行——本迁移注记关闭）。**F0 裁决回执（2026-09-10 战斗结算 GDD——红警关闭）**：归一口径 = **每结算瞬时当量**（总暴露分支被 percent schema 域禁止 + 与"单结算自然边界"已锁事实冲突，排除）；m_w 修订 −25 → **值域 [60,85]/默认 −65**（mvp_content.weaken 已同批改写——锚两腿 @D_ref=12：7.8 > 6.0 严格大于 ✓ / 7.8 ≥ E_dig 4.5 ✓〔E_dig 读数 2026-09-14 战斗结算 重算批按 难度曲线与Boss v3 曲线重推——原 7.2 随口径退役〕）；地板 = 乘数零点 −100pp、交叉层数 = ⌈100/m_w⌉ = 2（原"7 层触地板"预读按 −400% 合成带估读，更正）；defense_up 参照保持（总暴露分支的"重定参照"现实解未采纳）；终值 = 奖励道具经济/战斗结算 共裁（战斗结算 OQ2）；增益状态 GDD 正文不改以本条为准（收编先例）
|
||||
value_status: 七行值全部 provisional（2026-09-15 四行→六行——标错反噬批 enrage/off_guard 两行收编；六行→七行——格面资源批 sapped 收编为 weaken 型负向；伏击复用为反噬第三池项〔现为 blast 型负向〕），验收锚——weaken→行动经济 F1 条款 2（地图战斗资源/战斗结算）· ambush 量纲→敌人系统（条款 3，**量纲已定稿见 ambush_unit_definition**）· 对照表→战斗结算（条款 1）· **weaken 已按 战斗结算 F0 裁决修订 −25→−65（2026-09-10，值域 [60,85]、终值共裁 战斗结算 OQ2——见 anchor_warning 回执）**
|
||||
ambush_unit_definition: **量纲已定稿（2026-09-09 敌人系统 GDD Rule 6/F2——registry OQ2 关闭条件兑现）**：+3 flat = 每层伏击为每次攻击类行为（attack/heavy）附加 3 点主角 HP 伤害（后置加法、不进倍乘）；charge 拍零兑付（空拍蒸发）；值仍 provisional（锚验收归 地图战斗资源/战斗结算——行动经济 F1 条款 3；敌人系统 供给 cap 表值与单结算自然边界口径见 clause3_supply 条目）
|
||||
anchor_warning: weaken 行 vs 行动经济 F1 条款 2 锚两独立线性代理同向预检不过（百分点·结算暴露 25 vs 100；原型战斗量级 ≈1 vs ≈4 当量）——战斗结算 对照验收优先裁决，登记 战斗结算 强制检查点输入。**修复空间不对称（2026-09-09 增补）**：每结算瞬时当量归一 m_w≥51 可行（F2 越域界随移 AP 界 −408%/表界 −816%）；每 AP 总暴露归一 m_w>100 被 percent ∈ [-100,100] 域禁止（该分支不可行）——OQ1 前置步骤：战斗结算 先钉死归一口径，口径落定前禁止数值修订；落总暴露则现实解 = 地图战斗资源 重定最低档参照。**参照对象迁移注记（2026-09-09 地图战斗资源 评审；2026-09-11 回迁）**：最低档安全格 buff 当量的参照对象曾迁 defense_up 当量（attack_up 时为死行——地图战斗资源 F4 迁移）——**2026-09-11 用户裁决"基础攻击恒存在"（HeroTable.atk 域 [1,999]、0 加载拒绝、MVP=6）后 attack_up 复活，参照对象回迁 attack_up 当量**（消费面 = 主角战斗段先手攻击——战斗结算 GDD 同批；defense_up 迁移退役为历史记录，attack_up 入池时 tier_min_buff 重算）；本条与 clause3_supply.direction_precheck 的 25 vs 100 预检算术系 attack_up 口径历史登记——defense_up |−50|×dur2 与 attack_up 数值巧合全等（100pp），今日结论不变；**迁移后预检未按新参照重跑**的义务已于 2026-09-14 战斗结算 重算批兑现（F0/F1 按 attack_up 当量重跑 + F1 锚对照实物改 attack_up 行——本迁移注记关闭）。**F0 裁决回执（2026-09-10 战斗结算 GDD——红警关闭）**：归一口径 = **每结算瞬时当量**（总暴露分支被 percent schema 域禁止 + 与"单结算自然边界"已锁事实冲突，排除）；m_w 修订 −25 → **值域 [60,85]/默认 −65**（mvp_content.weaken 已同批改写——锚两腿 @D_ref=12：7.8 > 6.0 严格大于 ✓ / 7.8 ≥ E_dig 4.5 ✓〔E_dig 读数 2026-09-14 战斗结算 重算批按 难度曲线与Boss v3 曲线重推——原 7.2 随口径退役〕）；地板 = 乘数零点 −100pp、交叉层数 = ⌈100/m_w⌉ = 2（原"7 层触地板"预读按 −400% 合成带估读，更正）；defense_up 参照保持（总暴露分支的"重定参照"现实解未采纳）；终值 = 地图战斗资源/战斗结算 共裁（战斗结算 OQ2）；增益状态 GDD 正文不改以本条为准（收编先例）
|
||||
rule4_exemption: 定义表非进度成长表，键 = effect_id（数据配置 Rule 4 豁免，schema 注释承载）
|
||||
single_enemy_assumption: **回验结果 = 不成立——敌人系统 定多敌（用户 2026-09-09 拍板；同日 敌人系统 GDD 兑现 增益状态 预授权接口漂移条款）**：MVP 战斗 = 1–3 个同敌种敌单位（EnemyTable.unit_count）；效果 side-wide 语义改"全体存活敌单位"（层数 = side 共享池，**增益状态 现接口零变更兼容**）；target_ref（单体寻址）= 扩展位义务——首个单体效果上线时 增益状态 补列（随批：战斗结算 归集语义/HUD框架 呈现裁决）；增益状态 GDD 正文不改，以本条为准（行动经济 OQ5 收编先例）
|
||||
mechanics: 战斗域统一状态容器（三向效果同构实例）· 单一时限量纲 remaining_settlements（先兑付后衰减，每轮结算 −1，dur=1=一次性；跨轮跨图延续、battle_over 全清不跨战斗）· 按行叠层（stack 授予不触碰 R；refresh 重置取实例授予时快照 D；合并在授予时、结算作用顺序归 战斗结算——两序分离）· 满层授予拒绝原子（false+容器零写）· 合成 = L×m 加算、percent 越域不 clamp（地板/换算归 战斗结算 SettlementTable）· 授予集中在 战斗结算 结算编排（排雷玩法/奖励道具经济 零直接接口）· 零随机（无 RNG 流消费）· 零信号外发（纯被动容器）
|
||||
mechanics: 战斗域统一状态容器（三向效果同构实例）· 单一时限量纲 remaining_settlements（先兑付后衰减，每轮结算 −1，dur=1=一次性；跨轮跨图延续、battle_over 全清不跨战斗）· 按行叠层（stack 授予不触碰 R；refresh 重置取实例授予时快照 D；合并在授予时、结算作用顺序归 战斗结算——两序分离）· 满层授予拒绝原子（false+容器零写）· 合成 = L×m 加算、percent 越域不 clamp（地板/换算归 战斗结算 SettlementTable）· 授予集中在 战斗结算 结算编排（排雷玩法/地图战斗资源 零直接接口）· 零随机（无 RNG 流消费）· 零信号外发（纯被动容器）
|
||||
api: notify_battle_start / apply_effect(effect_id, source) -> bool / query_active(side) -> Array（插入序；六归因字段+display_name+授予时快照投影）/ decay_round() -> int / notify_battle_end() -> bool——战斗结算 消费契约，provisional 登记
|
||||
settlement_obligations: 八项（战斗结算 GDD 门禁评审缺项即 blocking）——① 同轮多授予按确定次序调用 ② 事实→授予恰一次转化（增益状态 不去重）③ percent→乘数换算方向与合成值地板成文 ④ 最后一轮 decay 判定 ⑤ F1 条款 1 效果档位对照表以 增益状态 实例为对照实物 ⑥ 每结算编排恰一次 decay_round（2026-09-09 增——decay 基数=1 先决条件）⑦ 结算明细按授予流水逐条标注来源（合并坍缩归因补偿，2026-09-09 增）⑧ “溢出未生效”行进结算明细协议（Rule 5 后半承载，2026-09-09 增）。**履行回执（2026-09-10）**：八项已全数落位 战斗结算 GDD（Core Rules 3/5/8/10/11 + Formulas F0–F2——落位映射 = 战斗结算 AC 覆盖矩阵"上游义务 23 条"行；③的 AP/表界数值随 F0 修订更新为 −520%/−1040%）
|
||||
presentation_obligations: （2026-09-09 登记 systems-index，缺项即 blocking）HUD框架×4——HUD 常显+EC12 空态规格定稿 / effect_id→icon 映射键契约（形状+色相双通道）/ 有利有害极性呈现映射（数据源 = 战斗结算 SettlementTable 效果语义，非 magnitude 符号）/ 全清状态栏去留；战斗表现×2——溢出行呈现 / origin_cell→玩家可读形态（缩略图/格子高亮）；教学引导——“同轮拿满优于跨轮叠”教学（OQ7 配套）；奖励道具经济——奖励身份预读（创意风险 #1 切面）
|
||||
ownership_note: 行动经济 OQ5“标中旗 debuff 档位归 奖励道具经济 表设计”经用户 2026-09-08 拍板收编——初值定稿权归 增益状态（2026-09-15 起为七行：标错反噬批两行 + 格面资源批 sapped 一行随批收编），锚验收权仍归 奖励道具经济/战斗结算，修订走接口漂移回写本条
|
||||
dangling_ref_policy: effect_id 悬空校验**已激活**（2026-09-09 奖励道具经济 RewardTable 首个 effect_id 引用行〔defense_up〕回填——dangling_ref_policy"首个引用字段 owner 补"条款兑现；条件性夹具 = 奖励道具经济 reward_dangling_effect〔AC-17〕）
|
||||
referenced_by: [战斗结算, 奖励道具经济, 敌人系统, HUD框架, 教学引导, 战斗表现]
|
||||
presentation_obligations: （2026-09-09 登记 systems-index，缺项即 blocking）HUD框架×4——HUD 常显+EC12 空态规格定稿 / effect_id→icon 映射键契约（形状+色相双通道）/ 有利有害极性呈现映射（数据源 = 战斗结算 SettlementTable 效果语义，非 magnitude 符号）/ 全清状态栏去留；战斗表现×2——溢出行呈现 / origin_cell→玩家可读形态（缩略图/格子高亮）；教学引导——“同轮拿满优于跨轮叠”教学（OQ7 配套）；地图战斗资源——奖励身份预读（创意风险 #1 切面）
|
||||
ownership_note: 行动经济 OQ5“标中旗 debuff 档位归 地图战斗资源 表设计”经用户 2026-09-08 拍板收编——初值定稿权归 增益状态（2026-09-15 起为七行：标错反噬批两行 + 格面资源批 sapped 一行随批收编），锚验收权仍归 地图战斗资源/战斗结算，修订走接口漂移回写本条
|
||||
dangling_ref_policy: effect_id 悬空校验**已激活**（2026-09-09 地图战斗资源 RewardTable 首个 effect_id 引用行〔defense_up〕回填——dangling_ref_policy"首个引用字段 owner 补"条款兑现；条件性夹具 = 地图战斗资源 reward_dangling_effect〔AC-17〕）
|
||||
referenced_by: [战斗结算, 地图战斗资源, 敌人系统, HUD框架, 教学引导, 战斗表现]
|
||||
|
||||
- name: board_gen_table
|
||||
type: schema_data
|
||||
@@ -156,7 +156,7 @@ entities:
|
||||
mvp_reference_rows: L1·D0（10×10/d0.10/t0.95/min_safe50/att16）与 L2·D0（12×12/d0.12/t0.92/min_safe60/att16）参考行——**全部 provisional，仅 schema 自洽性证明，曲线数值归 难度曲线与Boss 调参所有权**
|
||||
minesweeper_dual_containment: 双包含回验登记 排雷玩法 GDD——① 排雷玩法 实际展开域 ⊆ 棋盘生成 排除域（既有）② 棋盘生成 求解器初始态 ⊆ 排雷玩法 实际初始展开域（F1 注记④度量保真对偶）
|
||||
golden_vectors: 推理器黄金图回归向量协议（五类手工核验小板，整数对比对禁浮点容差，逐格信息源推导记录入版本库；换 solver_rules/信息源/metric_version = GDD 修订 + 向量重制）——数据配置 R2 先例同源
|
||||
referenced_by: [排雷玩法, 战斗结算, 奖励道具经济, 难度曲线与Boss, 存档序列化]
|
||||
referenced_by: [排雷玩法, 战斗结算, 地图战斗资源, 难度曲线与Boss, 存档序列化]
|
||||
|
||||
- name: minesweeper_event_surface
|
||||
type: schema_data
|
||||
@@ -164,12 +164,12 @@ entities:
|
||||
attributes:
|
||||
kind: 三事件回边契约（发射面封闭——TD-SYSTEM-BOUNDARY 回边裁决的 排雷玩法 侧定稿；增删事件 = 接口漂移修订）
|
||||
cell_revealed: "{cell, kind ∈ {safe, mine}, digit【仅 kind=safe 携带、恒真透传——呈现隐藏归 HUD框架，判定源 = variant_ids，排雷玩法×4③】, variant_ids, channel ∈ {initial, chain, dig}, resource【initial 恒 false（封锁格无资源）/ chain·dig 恒 true——安全格与雷格一视同仁，雷格亦携带格面资源（负向兑付归 战斗结算 极性路由）】}" # 2026-09-15 格面资源批：reward_eligible → resource，旧口径"mine 恒 false"随批作废
|
||||
flag_judged: "{cell, hit = [cell ∈ M]}×N——轮末统一判定批（基线 = 轮次结束事务开始时旗位，被拔不判；行主序枚举）；排雷玩法 诚实重复上报、兑付去重归 战斗结算/奖励道具经济（资格以雷格实例为键——action_economy.flag_rules/行动经济 OQ5）"
|
||||
flag_judged: "{cell, hit = [cell ∈ M]}×N——轮末统一判定批（基线 = 轮次结束事务开始时旗位，被拔不判；行主序枚举）；排雷玩法 诚实重复上报、兑付去重归 战斗结算/地图战斗资源（资格以雷格实例为键——action_economy.flag_rules/行动经济 OQ5）"
|
||||
round_end: "{path_tag ∈ {ap_exhausted, cleared}, continuation_hint}——棋盘路径由 排雷玩法 外发、核心字段逐字段取自 行动经济.last_round_end（读取权 = 接口契约），与 行动经济 stopped 路径 payload 同构；stopped 由 行动经济 直发、排雷玩法 禁双发（action_economy.round_end_carrier 双发射源）"
|
||||
event_order: 同一轮次结束事务内 flag_judged ×N 先于 round_end（全路径统一——stop 腿 排雷玩法 先发旗判定再委托 request_stop，停手不改旗故基线等价）；战斗结算 结算触发 = Waiting 相位编排点、不依赖事件到达序（战斗结算×3 强制项之一，systems-index 排雷玩法 门禁块）
|
||||
zero_random: 排雷玩法 零 RNG 流消费——同板同意图序列 ⇒ 事件流逐位确定（AC-19）；cell_revealed 发射序 = 规范序（初始/连锁 = 触发格 BFS、8 邻行主序）
|
||||
api_surface: install_board / settle_batch（HUD框架 唯一提交入口；stop 经此委托 行动经济.request_stop——HUD框架×6① 强制项：不直调 行动经济，行动经济 Rule 9 调用方细化、行动经济 GDD 不改以本条为准）/ try_dig·try_flag_place·try_flag_pull·try_move / compute_move_path（HUD框架 路径预览数据源）/ retire_board；ActionOutcome{accepted, executed|voided|rejected, reject_reason ∈ {board_face, resource_face, phase, board_invalid}, sub_reason【仅 board_face 携带：not_adjacent/target_revealed/target_concealed/flag_present/flag_absent/no_path/out_of_catalog——2026-09-09 评审 UX-1 定稿，玩家可辨呈现数据源；批后修改 = 接口漂移】}——provisional，事件载体归实现期 ADR（排雷玩法 OQ2）
|
||||
referenced_by: [战斗结算, 奖励道具经济, HUD框架, 音频, 教学引导]
|
||||
referenced_by: [战斗结算, 地图战斗资源, HUD框架, 音频, 教学引导]
|
||||
|
||||
- name: minesweeper_initial_expansion
|
||||
type: formula
|
||||
@@ -206,10 +206,10 @@ entities:
|
||||
溢出（伏击）: 单轮踩雷超过上限（cap）的部分——转为"溢出未生效"明细行可见、不生效（敌人系统 首次定义）
|
||||
死亡即不动手: 轮到某敌人行动时它已死 → 这一下不打、招式轮转停格（2026-09-09 用户拍板，敌人系统 首次定义）
|
||||
封锁格: 初始展开白送的那批已开格——恒无格面资源、不再有任何加成，但计入清图进度（排雷玩法 首次定义；install 期可精确枚举为 R₀——格面资源摇号清单的排除项；取代旧术语"资格格"，2026-09-15 格面资源批）
|
||||
格面资源（CellResource）: 关联到格子上的资源对象——装板期摇定五型类型身份（attack/defense/heal/blast/weaken），安全格与雷格一视同仁、同池同分布；极性不在资源内，由「动作 × 格型」矩阵在结算期决定正向（奖励）或负向（惩罚）（奖励道具经济 首次定义；取代"安全格奖励"旧名）
|
||||
批尾: 同一批取号中最后消费的一个号——奖励道具经济 清图奖励身份 = install 批的批尾取号（奖励道具经济 F1 首次定义）
|
||||
死行: 被当前内容态判定为零消费的表行——加载不致命、不入参考池，复活走 GDD 修订连锁（奖励道具经济 F4 首次定义；历史首例 attack_up〔hero atk=0 时代〕已于 2026-09-11 随"基础攻击恒存在"用户裁决复活，当前内容态暂无在册死行）
|
||||
预推进: 测试中为到达 scope=σ 而先行丢弃式消费 σ 个 scope 的构造——RngService 全新实例首个 open_stream 恒为 scope 0，derive_at 不推计数器（奖励道具经济 AC 前言首次定义）
|
||||
格面资源（CellResource）: 关联到格子上的资源对象——装板期摇定五型类型身份（attack/defense/heal/blast/weaken），安全格与雷格一视同仁、同池同分布；极性不在资源内，由「动作 × 格型」矩阵在结算期决定正向（奖励）或负向（惩罚）（地图战斗资源 首次定义；取代"安全格奖励"旧名）
|
||||
批尾: 同一批取号中最后消费的一个号——地图战斗资源 清图奖励身份 = install 批的批尾取号（地图战斗资源 F1 首次定义）
|
||||
死行: 被当前内容态判定为零消费的表行——加载不致命、不入参考池，复活走 GDD 修订连锁（地图战斗资源 F4 首次定义；历史首例 attack_up〔hero atk=0 时代〕已于 2026-09-11 随"基础攻击恒存在"用户裁决复活，当前内容态暂无在册死行）
|
||||
预推进: 测试中为到达 scope=σ 而先行丢弃式消费 σ 个 scope 的构造——RngService 全新实例首个 open_stream 恒为 scope 0，derive_at 不推计数器（地图战斗资源 AC 前言首次定义）
|
||||
完美排雷（perfect_sweep）: 板级零误标（flag_judged hit=false=0）∧ ≥1 标中 → 清图奖励当量 ×P_perfect（默认 ×2）——与踩雷正交（盲挖踩雷不破坏、标错才破坏）、全有或全无谓词无部分档、板级计数随 install 重置（战斗结算 Core Rule 13 首次定义）
|
||||
当量: 统一价值单位，1 当量 = 1 点主角 HP 的期望净变化——四源收益单一线性换算的通货（战斗结算 F1 首次定义）
|
||||
乘区: 伤害公式里相乘的修正段（本作两段：hero 减伤池 × 敌方削弱池——池内加算、clamp [−100,+100]pp、池间乘算、floor 取整）（战斗结算 F2 首次定义）
|
||||
@@ -220,17 +220,17 @@ entities:
|
||||
极性（polarity）: 同一类型兑付的正负方向——正 = 收益侧、负 = 代价侧，行为×格型→符号矩阵见极性提案 R2；视觉通道冻结 = 金族（有利）对红族（有害）+ 满框对缺框（art-bible §4.6 首次冻结视觉侧）
|
||||
命令式回执驱动: 动作调用返回后组合根立刻重查一次只读面来刷新界面、不等通知信号——旗插拔/移动/AP·RAP 读数/状态/库存五类动作零事件外发或零推送，呈现层刷新由此承载（HUD框架 首次定义；ADR-0001 订阅纪律的配对形态）
|
||||
程序化占位: 用代码按冻结色板与形状规则直接画出的临时图形——参数取自 art-bible §4.1/§3 参数域、icon 按 §4.6 键位映射表挂槽，终稿美术到位后原位替换、数据层零改动（HUD框架 首次定义；样张未定稿不阻塞呈现层开工的承载形态，占位同样受 §1.4 数字可读性第一验收项约束）
|
||||
叠加层（overlay）: 辅助道具 自持的板级派生信息集（显影/真视/预读三集）——只改"玩家能看见什么"不改棋盘事实，零回写 排雷玩法/奖励道具经济 状态、随图消亡（辅助道具 首次定义）
|
||||
真视窄域护栏: 替代推理的道具效果（雷位真视）目标域 ≤3×3、全图级仅限恢复推理原料类（显影/预读）——信息层级护栏，防"扫雷退化为路径优化"（辅助道具 Core Rule 3 首次定义，schema 校验强制）
|
||||
渗透率: aux 道具期望件数占奖励池的份额——E[N_aux/板] = |U|×Σw_aux/W_total（辅助道具 F1 首次定义；供给面天然限流，P1 护栏的量化形态）
|
||||
叠加层（overlay）: 魔法道具 自持的板级派生信息集（显影/真视/预读三集）——只改"玩家能看见什么"不改棋盘事实，零回写 排雷玩法/地图战斗资源 状态、随图消亡（魔法道具 首次定义）
|
||||
真视窄域护栏: 替代推理的道具效果（雷位真视）目标域 ≤3×3、全图级仅限恢复推理原料类（显影/预读）——信息层级护栏，防"扫雷退化为路径优化"（魔法道具 Core Rule 3 首次定义，schema 校验强制）
|
||||
渗透率: aux 道具期望件数占奖励池的份额——E[N_aux/板] = |U|×Σw_aux/W_total（魔法道具 F1 首次定义；供给面天然限流，P1 护栏的量化形态）
|
||||
行动: 轮次内挖掘期的原子决策单位——同一事件的三个视角：玩家决策层叫行动、进 排雷玩法 的数据形态叫意图（单意图帧整批提交）、行动经济 计价类别叫动作（action_kind 统一价目）；有价行动（挖/插旗/拔旗）1 AP/次、受每轮 AP 预算约束（现行表值 8），移动/停手免费不计 AP（game-concept 术语层级 2026-09-14 收录）
|
||||
节点: 关卡节点地图上的一个格——关卡内移动的步进单位；层名定稿（2026-09-14 用户裁决：节点 胜 遭遇——成员中立 + 关卡节点地图 注册名/切片 node_* 接口零改动 + 遭遇既有语义 = 战斗不挪用）；节点类型分类学与分支机制归 关卡节点地图 GDD 展开
|
||||
遭遇: 一次完整战斗事件的同义词——战斗节点触发的那一场仗（既有用法：战斗结算"两场遭遇" / HUD框架"双敌种遭遇""Boss 遭遇变体"）；不作地图层名（2026-09-14 裁决）
|
||||
节点奖励: 奖励点节点给的奖励（关卡节点地图 域）——与安全格奖励（奖励道具经济，格内开出）区分；节点奖励覆盖层 = 未来 spec design/ux/node-reward.md（battle.md OQ9）——三个"reward"各归各位（2026-09-14 拆名注记）
|
||||
节点奖励: 奖励点节点给的奖励（关卡节点地图 域）——与安全格奖励（地图战斗资源，格内开出）区分；节点奖励覆盖层 = 未来 spec design/ux/node-reward.md（battle.md OQ9）——三个"reward"各归各位（2026-09-14 拆名注记）
|
||||
HP 账本: 冒险域主角血量的唯一记录——冒险结构 持有，每战开始交出、战斗结束收回、恢复点与大奖励入账；关卡切换血条不清零（冒险结构 首次定义；跨战斗 HP 持久性归 关卡节点地图/冒险结构 已锁事实的 冒险结构 半边兑现）
|
||||
关卡收束点: 一关就此定局的时点——Boss 战胜利（通关）或英雄死亡（失败）；关卡节点地图 在收束点先调 战斗结算 关卡清库、再向 冒险结构 宣布关卡结束与结果（冒险结构 首次定义；切片 level_runner 先例转正）
|
||||
关卡大奖励: 清完一关、进入下一关前的一次性兑付——上限提升 + 血回满 + 代币记账三件构成，不进背包不占库存域；末关通关不兑付（冒险结构 首次定义；game-concept"冒险内大奖励"的落地形态）
|
||||
referenced_by: [排雷玩法, 敌人系统, 奖励道具经济, 战斗结算, HUD框架, 辅助道具, art-bible, game-concept, 关卡节点地图, 冒险结构]
|
||||
referenced_by: [排雷玩法, 敌人系统, 地图战斗资源, 战斗结算, HUD框架, 魔法道具, art-bible, game-concept, 关卡节点地图, 冒险结构]
|
||||
|
||||
- name: enemy
|
||||
type: schema_data
|
||||
@@ -244,6 +244,7 @@ entities:
|
||||
unit_count_max: int [unit_count, 3] 可省略（2026-09-14 难度曲线与Boss 修订批新增——遭遇区间上界；缺省 = 定值，旧行零迁移）
|
||||
atk_min/atk_max: 可选配对 int [0,999]（2026-09-14 敌方攻击区间批——上阶/下阶区间随机；缺省 = 定值行向后兼容；跨字段：必成对 · **atk = (min+max)/2 中点锚**；roll 时机 = 遭遇骰同流〔encounter 恰一 scope，数量骰先、atk 骰后〕spawn 期**整战持久**〔每拍抖动否决——数字可读性锚〕，战斗结算.begin_battle roll → 敌人系统.spawn enemy_atk_override 收确定值〔敌人系统 零随机纪律保持〕；MVP 六行 ±3 provisional 归 难度曲线与Boss；验收 = 完美策略档 0 加成通关 ≤40%〔OQ7〕；接口漂移 = 敌人系统.spawn 签名 +1 参数〔正式侧 GDD/registry 修订批随 ADR-0009 同批〕）
|
||||
armor_type: enum {light, ward, heavy} 缺省 light（2026-09-14 护甲克制批转正登记——攻击类型 × 护甲克制，克制矩阵 = settlement_table.armor_effectiveness〔克制 ×150 / 中性 ×100 / 被克 ×50〕；MVP 映射 goblin=light / bugbear=ward / ogre_chief=heavy；**2026-09-15 命名统一批：原 enum {none, a, b} 为位置键（无语义、且"无甲/甲A/甲B"在文档间已分裂成四种写法），改 {light, ward, heavy} = 轻甲 / 魔法护甲 / 重甲**；数值 provisional 归 难度曲线与Boss）
|
||||
armor_class: int 取值域未定（**2026-09-15 护甲等级批新增，provisional**——防守方护甲等级，主角基础攻击普通分量 / 敌方攻击拍与重击拍基线的掷点折扣判定读数，掷点与折扣结算归 settlement_table.ac_roll / ac_discount_tiers〔战斗结算〕；**与 armor_type〔克制属性轴 light/ward/heavy〕是两个概念、字段与文档口径不得混用**；三敌种行值未定，投值归 难度曲线与Boss 随掷点形式定稿批）
|
||||
hp: int [1,999]（knob——难度修饰前基线；MVP 18 provisional 出处待查）
|
||||
atk: int [0,999]（knob——attack 行为伤害基值；MVP 4 provisional 出处待查；0 = 纯伏击伤敌种合法）
|
||||
heavy_multiplier: int [1,16]（knob；无 heavy 拍敌种不消费——非校验项，增益状态 max_stack 先例；MVP 2 provisional）
|
||||
@@ -255,7 +256,7 @@ entities:
|
||||
settlement_obligations: 六项（敌人系统 GDD 门禁评审缺项即 blocking）——① 推进每结算恰一次（敌单位专属——主角无环）+ 结算内调用序成文 query_attack→apply_damage→advance ② 雷→伏击恰一次转化 ③ clamp/负值/溢杀与死亡判定时机成文 ④ F1 条款 3 闭合对账（cap 表值 + 量纲 + 棋盘生成 actuals p10 非 target 参数）⑤ 默认目标消费与单体/AOE 分流 ⑥ 伏击 cap 溢出"溢出未生效"明细行协议。**履行回执（2026-09-10）**：六项已全数落位 战斗结算 GDD（Core Rules 5/6/9/10/12 + Formulas F3/F4——落位映射 = 战斗结算 AC 覆盖矩阵）
|
||||
hud_obligations: 四项（视觉推测型呈现，缺项即 blocking）——① enemy_id→图像线索映射清单成文（预告时序=下一拍预告、挖掘期全程可见；含强度档位/环长直觉编码说明；形状+色相双通道）② 映射全局恒定（enemy_id 键——跨 run 禁重掷）③ 顺位与存活可读 ④ 敌方 side 池呈现口径
|
||||
rule4_status: 本表是进度成长表（棋盘生成 BoardGenTable 同型，无 Rule 4 豁免）
|
||||
referenced_by: [战斗结算, 奖励道具经济, 关卡节点地图, 难度曲线与Boss, HUD框架, 战斗表现, 教学引导]
|
||||
referenced_by: [战斗结算, 地图战斗资源, 关卡节点地图, 难度曲线与Boss, HUD框架, 战斗表现, 教学引导]
|
||||
|
||||
- name: hero
|
||||
type: schema_data
|
||||
@@ -264,16 +265,17 @@ entities:
|
||||
table: HeroTable（数据配置 新增 schema 行〔接口漂移回写，2026-09-09 敌人系统〕，单行全局；敌人系统 回填 owner）
|
||||
fields:
|
||||
max_hp: int [1,999]（knob；MVP 值 provisional 出处待查）
|
||||
atk: int [1,999]（**0 = 加载拒绝**——基础攻击恒存在，"0 基线 × 百分比增益恒零"死锁自 schema 层杜绝〔2026-09-11 用户裁决，原"机制开关 MVP=0、激活裁决归 奖励道具经济/战斗结算"作废〕；MVP = 6 原型锚 provisional 归 难度曲线与Boss；消费面 = 主角战斗段先手攻击——战斗结算 GDD 2026-09-11 增补）
|
||||
atk: int [1,999]（**0 = 加载拒绝**——基础攻击恒存在，"0 基线 × 百分比增益恒零"死锁自 schema 层杜绝〔2026-09-11 用户裁决，原"机制开关 MVP=0、激活裁决归 地图战斗资源/战斗结算"作废〕；MVP = 6 原型锚 provisional 归 难度曲线与Boss；消费面 = 主角战斗段先手攻击——战斗结算 GDD 2026-09-11 增补）
|
||||
armor_class: int 取值域未定（**2026-09-15 护甲等级批新增，provisional**——主角作为防守方的护甲等级，敌方攻击拍 / 重击拍基线的掷点折扣判定读数；掷点结算归 settlement_table.ac_roll〔战斗结算〕，与 armor_type〔克制属性轴〕两概念不得混用；值未定，投值归 难度曲线与Boss 随掷点形式定稿批）
|
||||
rule4_exemption: 单行全局定义表（主角不随关卡自动成长——成长=天赋 元进度/奖励侧；ActionEconomyTable 先例）
|
||||
hp_persistence: 跨战斗 HP 持久性归 关卡节点地图/冒险结构（provisional）——敌人系统 单位接口以初始 hp 入参，不定义冒险内持久性
|
||||
referenced_by: [战斗结算, 奖励道具经济, 难度曲线与Boss]
|
||||
referenced_by: [战斗结算, 地图战斗资源, 难度曲线与Boss]
|
||||
|
||||
- name: reward_table
|
||||
type: schema_data
|
||||
owner: design/gdd/systems/战斗循环/奖励道具经济.md
|
||||
owner: design/gdd/systems/战斗循环/地图战斗资源.md
|
||||
attributes:
|
||||
table: RewardTable（数据配置 承载，键 = reward_id；奖励道具经济 回填 owner；**2026-09-15 格面资源批结构性重写**——旧 category / use_timing / 库存 / 供给轴随可选类删除整批下线，五型 × 极性字典取代〔历史结构见底部修订记录〕）
|
||||
table: RewardTable（数据配置 承载，键 = reward_id；地图战斗资源 回填 owner；**2026-09-15 格面资源批结构性重写**——旧 category / use_timing / 库存 / 供给轴随可选类删除整批下线，五型 × 极性字典取代〔历史结构见底部修订记录〕）
|
||||
fields:
|
||||
reward_id: String（表内主键）
|
||||
cell_type: enum {attack, defense, heal, blast, weaken}——五型封闭（格面资源类型身份；表里出现清单外值加载拒绝 fail-fast） # 2026-09-15 新增，取代 category
|
||||
@@ -287,21 +289,21 @@ entities:
|
||||
pool_tag: enum {cell, clear_default}（cell = 格面资源单一池——安全格与雷格一视同仁同池同分布；clear_<biome> 命名空间预留、校验拒绝——棋盘生成 elite_ 同款） # 2026-09-15 safe_cell→cell 更名 + active_inject 删除
|
||||
tier: int [1, 8]（knob）——强度档位序数（与当量零耦合）
|
||||
cross_field_validation: 加载期致命族——池空（cell 池 ≥1 正向行 weight>0）· 五型正向行齐备 · 五型负向行齐备（字典完整性——缺任一极性行致命）· clear_default 恒正当量（≥1 活行 ∧ power≥1 ∨ effect_id 非空——行动经济 条款④"清图奖励>0"的行级兑现口径）· percent 行 effect_id 必填/flat 行恒空 · flat 行 power≥1 # 2026-09-15 重写——旧 floor_supply_missing / no_damage_row 随可选类删除失义退役
|
||||
mechanics: 格面资源身份 install 期预分配（roll_board 恰一次、行主序、消费 reward_roll 封闭流恰一 scope 批〔格批 + 清图批尾一号〕；全部非封锁格逐一摇定类型——安全格与雷格同池同分布、封锁格不入摇号清单；Ready 后只读、无重掷 API）· **极性不在资源内**——「动作 × 格型」矩阵（开安全格/标中雷 = 正向、开雷格/标错安全格 = 负向、标旗后撤旗 = 零兑付）字典定义归 奖励道具经济、路由执行归 战斗结算 授予段（结算队列 + 抵消过滤——标旗后被撤旗不结算）· 授予期零随机（身份恒定跨轮；换图映射消亡）· 负向恒即时（不入库、无库存语义——库存已随可选类删除下线）· 满层零兑付 = 合法例外 + "奖励未生效"行 · 重复受理幂等（同格重复 grant / 同批次重复 grant_clear → 同一快照/身份 + 诊断；受理/兑付恰一次归 战斗结算×②③）
|
||||
api: 封闭枚举入口（provisional，实现期 ADR 定名）——roll_board / query_identity（返回 {reward_id, cell_type, tier} 引用级投影；未开格恒可查——辅助道具 桥接结构前提；清单外坐标 → null + 诊断）/ grant（同格重复受理幂等 + 诊断）/ grant_clear（同批次重调幂等 + 诊断）/ retire_mapping / equivalence_supply（全活行投影 + tier_min_buff）+ weighted_pick 纯函数面；新增入口 = 接口漂移，新增入口须随附全输入域语义表 # 2026-09-15 删 stock/use/query_inventory/clear_inventory（库存轴下线）
|
||||
mechanics: 格面资源身份 install 期预分配（roll_board 恰一次、行主序、消费 reward_roll 封闭流恰一 scope 批〔格批 + 清图批尾一号〕；全部非封锁格逐一摇定类型——安全格与雷格同池同分布、封锁格不入摇号清单；Ready 后只读、无重掷 API）· **极性不在资源内**——「动作 × 格型」矩阵（开安全格/标中雷 = 正向、开雷格/标错安全格 = 负向、标旗后撤旗 = 零兑付）字典定义归 地图战斗资源、路由执行归 战斗结算 授予段（结算队列 + 抵消过滤——标旗后被撤旗不结算）· 授予期零随机（身份恒定跨轮；换图映射消亡）· 负向恒即时（不入库、无库存语义——库存已随可选类删除下线）· 满层零兑付 = 合法例外 + "奖励未生效"行 · 重复受理幂等（同格重复 grant / 同批次重复 grant_clear → 同一快照/身份 + 诊断；受理/兑付恰一次归 战斗结算×②③）
|
||||
api: 封闭枚举入口（provisional，实现期 ADR 定名）——roll_board / query_identity（返回 {reward_id, cell_type, tier} 引用级投影；未开格恒可查——魔法道具 桥接结构前提；清单外坐标 → null + 诊断）/ grant（同格重复受理幂等 + 诊断）/ grant_clear（同批次重调幂等 + 诊断）/ retire_mapping / equivalence_supply（全活行投影 + tier_min_buff）+ weighted_pick 纯函数面；新增入口 = 接口漂移，新增入口须随附全输入域语义表 # 2026-09-15 删 stock/use/query_inventory/clear_inventory（库存轴下线）
|
||||
mvp_content: 十行（2026-09-15 格面资源批；值 provisional 归 难度曲线与Boss）——格面池正向五行（attack_up buff→attack_up w20 t2 / defense_up buff→defense_up w16 t2 / spark_aoe flat p4 w16 t1〔blast〕/ heal_minor flat [2,6] w15 t1〔heal〕/ weaken buff→weaken w12 t1）+ 负向五行纯字典（enrage attack〔→enemy_output〕/ off_guard defense〔→hero_defense〕/ 直伤 heal flat p4〔不经增益状态〕/ ambush+2 blast〔stacks=2〕/ sapped weaken〔→hero_offense〕）+ clear_blast（flat [25,55] w1 t2 clear_default——完美板 ×2 期望中点 80）；类型频次 = 正向行权重（20/16/16/15/12 合计 79）；tier_min_buff = 2
|
||||
direction_precheck: **刀供给方向预检随可选类删除失义退役（2026-09-15）**——历史读数见底部修订记录；新对账锚 = 行动经济 条款②③ 左臂（正向格面资源当量供给）随格面资源批重推，义务归 难度曲线与Boss 调参批
|
||||
settlement_obligations: 四项（战斗结算 GDD 门禁评审缺项即 blocking，清单全文见 奖励道具经济 GDD Dependencies）——① 结算段序骨架（授予→增益/减益→战斗→衰减→判定）② 极性路由受理 + 每格恰一次 + 满层零兑付"奖励未生效"行（含聚合计数字段）③ clear_reward 授予路径（增益状态 OQ4 关闭条件）④ 生命周期编排（battle_over retire 映射消亡）+ roll_board 恰一次 # 2026-09-15 由六项收拢（窗口/道具段与库存编排随可选类删除失义）
|
||||
settlement_obligations: 四项（战斗结算 GDD 门禁评审缺项即 blocking，清单全文见 地图战斗资源 GDD Dependencies）——① 结算段序骨架（授予→增益/减益→战斗→衰减→判定）② 极性路由受理 + 每格恰一次 + 满层零兑付"奖励未生效"行（含聚合计数字段）③ clear_reward 授予路径（增益状态 OQ4 关闭条件）④ 生命周期编排（battle_over retire 映射消亡）+ roll_board 恰一次 # 2026-09-15 由六项收拢（窗口/道具段与库存编排随可选类删除失义）
|
||||
hud_obligations: 三项（缺项即 blocking）——① 已开格资源身份恒定可读（挖掘期规划面）+ 未开格类型可查面的呈现深度（预读边界待拍板）② 结算明细行（效果行/"奖励未生效"〔聚合计数〕/标旗未中行/直伤行）③ H2 清图奖励行强调呈现 # 2026-09-15 由五项收拢（库存常读条/道具窗口随可选类删除失义）
|
||||
high_glow_nodes: H1 开格拾取瞬间 / H2 清图奖励兑付（奖励侧常规节拍登记；**风险 #2 排雷侧"完美排雷爆发结算"机制本体归 战斗结算 强制检查点、#3 标中旗节拍补偿归 战斗结算——奖励道具经济 只交付插槽与明细行数据面**；呈现义务 HUD框架×③） # 2026-09-15 H3 道具抢杀窗口随可选类删除失义
|
||||
referenced_by: [战斗结算, HUD框架, 难度曲线与Boss, 辅助道具, 战斗表现, 教学引导]
|
||||
high_glow_nodes: H1 开格拾取瞬间 / H2 清图奖励兑付（奖励侧常规节拍登记；**风险 #2 排雷侧"完美排雷爆发结算"机制本体归 战斗结算 强制检查点、#3 标中旗节拍补偿归 战斗结算——地图战斗资源 只交付插槽与明细行数据面**；呈现义务 HUD框架×③） # 2026-09-15 H3 道具抢杀窗口随可选类删除失义
|
||||
referenced_by: [战斗结算, HUD框架, 难度曲线与Boss, 魔法道具, 战斗表现, 教学引导]
|
||||
|
||||
- name: reward_config
|
||||
type: schema_data
|
||||
owner: design/gdd/systems/战斗循环/奖励道具经济.md
|
||||
owner: design/gdd/systems/战斗循环/地图战斗资源.md
|
||||
attributes:
|
||||
table: "**已删除（2026-09-15 格面资源批）**——RewardConfigTable 随可选类道具整体删除下线：k_dmg / active_p0 / active_decay / n_draft / p_min 全部供给控制器与按板保底参数失义；清图奖励配置并入 RewardTable clear_default 槽；切片 reward_config.tres 随代码修改批删除（历史字段定义见底部修订记录）"
|
||||
referenced_by: [奖励道具经济, 难度曲线与Boss, 战斗结算]
|
||||
referenced_by: [地图战斗资源, 难度曲线与Boss, 战斗结算]
|
||||
|
||||
- name: settlement_table
|
||||
type: schema_data
|
||||
@@ -317,10 +319,12 @@ entities:
|
||||
pool_clamp_lo: int pp（结构冻结 −100——percent 池地板域下界，乘数域随之 [0,2]；2026-09-10 统一八字段口径）
|
||||
pool_clamp_hi: int pp（结构冻结 +100——percent 池地板域上界；原"七字段 pool_clamp_lo_hi"措辞作废，数据配置 GDD 行按收编先例以本条为准）
|
||||
round_direction: enum {floor}（结构冻结——单一取整规则）
|
||||
charge_grants: Dictionary 奖励触发源→{attack_type, per_unit, cap}（**2026-09-15 攻击类型/奖励抽象分离批新增**——攻击类型 = 伤害的属性轴（定义不含来源），充能 = 按攻击类型分桶的附加伤害储备；"哪类棋盘事实充哪个桶、每单位多少点"归本字典 = 奖励定义，替换字典即改奖励内容，攻击类型与 armor_effectiveness 不动；现行 safe_cell（开格）→ pierce 1/格 cap 8 · flag_hit（标中旗）→ magic 2/雷 cap 0=不封顶；**原 pierce_per_cell / pierce_cap / magic_per_flag（"类型×来源"焊死命名，更早为 damage_a_per_cell / damage_a_cap / damage_b_per_flag）同批作废**；数值 provisional 归 难度曲线与Boss；正式归属（奖励道具经济 的奖励类别/效果面）见 战斗结算「待拍板」）
|
||||
charge_grants: Dictionary 奖励触发源→{attack_type, per_unit, cap}（**2026-09-15 攻击类型/奖励抽象分离批新增**——攻击类型 = 伤害的属性轴（定义不含来源），充能 = 按攻击类型分桶的附加伤害储备；"哪类棋盘事实充哪个桶、每单位多少点"归本字典 = 奖励定义，替换字典即改奖励内容，攻击类型与 armor_effectiveness 不动；现行 safe_cell（开格）→ pierce 1/格 cap 8 · flag_hit（标中旗）→ magic 2/雷 cap 0=不封顶；**原 pierce_per_cell / pierce_cap / magic_per_flag（"类型×来源"焊死命名，更早为 damage_a_per_cell / damage_a_cap / damage_b_per_flag）同批作废**；数值 provisional 归 难度曲线与Boss；正式归属（地图战斗资源 的奖励类别/效果面）见 战斗结算「待拍板」）
|
||||
armor_effectiveness: Dictionary 攻击类型×护甲→百分比（键集结构冻结 {normal, pierce, magic} × {light, ward, heavy}；默认 normal 全 100 / pierce→ward=150、heavy=50 / magic→heavy=150、ward=50——克制 ×150 / 中性 ×100 / 被克 ×50；**2026-09-15 命名统一批：改为语义键，原 {base, dmg_a, dmg_b} × {none, a, b} 位置键作废**；数值 provisional 归 难度曲线与Boss）
|
||||
ac_roll: 护甲等级掷点（**2026-09-15 护甲等级批新增，未定稿**——形式 d20 / 百面骰 / 区间均匀未定、数值域未定，登记 战斗结算「待拍板」；回合内随机 = 结算换算层首次引入；吃掷点分量 = 主角先手攻击普通分量 / 敌方攻击拍与重击拍基线伤害；掷点 ≥ 防守方护甲等级 → 全额、掷点 < 护甲等级 → 档位折扣，必中非归零、无 miss 无零收益白回合；穿刺/魔法充能分量与棋盘来源伤害〔伏击附加 / 道具 / 清障炸药 / 奖励即时〕不掷不折）
|
||||
ac_discount_tiers: Dictionary 掷点差距档→折扣百分比（**2026-09-15 护甲等级批新增，未定稿**——档数与数值未定 provisional 归 难度曲线与Boss；档位不设零档〔非归零〕，折扣后取整沿全局 floor、为 0 走既有零值伤害行不新增行型；EV 中性——期望伤害对齐现行表值，现行数值不重调，难度曲线与Boss 生存链区间补记掷点带宽口径、"零红档"验收保留）
|
||||
validation: segment_order 违例致命 · effect_pool_map 悬空致命 · p_perfect 域 {100,200}（2026-09-10 载体域——100 = "完美必须 ≥ 不加倍"机制语义下界，200 = 双份交付）——战斗结算 冒烟三行致命 manifest（segorder_violation / poolmap_dangling / pperfect_oob）
|
||||
mechanics: 结算段序骨架唯一权威载体（授予→增益/减益→战斗→衰减→判定——2026-09-15 格面资源批五段，item_window/item 两段随可选类删除下线）· 零随机（rng_service 流封闭不含结算流）· 可回放步骤流（同 master_seed 同意图序列 ⇒ 步骤流逐行相同——数据配置 AC-15 deferred→战斗结算 兑现落点）· 调用序钉死 query_attack→apply_damage→advance · 衰减恒执行含末轮 · 高光双落载体（perfect_sweep P_perfect——2026-09-10 修订为真实双份兑付载体 / 标中旗 highlight 标记）· 流水行协议字段分层（公共 7 字段 + 行类型特有 target/effect_id/pool_value/聚合计数——2026-09-10 评审批修订；行类型封闭枚举 10 类——2026-09-15 格面资源批由 15 类收拢：删道具行 / 已消耗未生效行 / 使用被拒行 / 窗口打开锚行 window_open / 窗口跳过锚行 window_skip 五类随可选类删除下线〔2026-09-15 窗口锚行批曾由 13 扩为 15，同日回撤〕；行来源断言两层豁免集合同批修订 = 行型豁免 {decay, verdict} × 来源类别豁免 {hero_attack, enemy_action, clear_reward}，豁免不等于免检——豁免行仍受公共字段与各自语义约束，清单改动须同步 战斗结算 明细流水一节与 battle_log_view 格式化）· **穿刺/魔法 充能与护甲克制结算规格 = 战斗结算 GDD F6（W3 补全，2026-09-14 重算批；2026-09-15 命名统一批）**——挖掘期充能/战斗段消费/单轮生命周期、不吃 percent、逐分量 armor_effectiveness 查表 floor 相加
|
||||
mechanics: 结算段序骨架唯一权威载体（授予→增益/减益→战斗→衰减→判定——2026-09-15 格面资源批五段，item_window/item 两段随可选类删除下线）· **随机口径（2026-09-15 护甲等级批修订）**：结算换算层引入回合内随机（ac_roll 护甲等级掷点——必中非归零、低掷按 ac_discount_tiers 档位折扣），掷点流归属未定〔rng_service 流封闭清单 board_gen/reward_roll/encounter 不含结算内消费——新增流须改代码+P1 支柱评审、复用 encounter 则改"实例化期恰一 scope"绑定，登记 战斗结算「待拍板」，rng_service 条目随定稿批修订〕· 可回放契约 = **封闭随机流可回放**（同 master_seed 同意图序列 ⇒ 步骤流逐位复现——数据配置 AC-15 落点，原"结算路径零随机 / 步骤流逐行相同"口径随批作废；开战掷区间 / 装板摇号属初始化随机维持不变）· 调用序钉死 query_attack→apply_damage→advance · 衰减恒执行含末轮 · 高光双落载体（perfect_sweep P_perfect——2026-09-10 修订为真实双份兑付载体 / 标中旗 highlight 标记）· 流水行协议字段分层（公共 7 字段 + 行类型特有 target/effect_id/pool_value/聚合计数——2026-09-10 评审批修订；行类型封闭枚举 10 类——2026-09-15 格面资源批由 15 类收拢：删道具行 / 已消耗未生效行 / 使用被拒行 / 窗口打开锚行 window_open / 窗口跳过锚行 window_skip 五类随可选类删除下线〔2026-09-15 窗口锚行批曾由 13 扩为 15，同日回撤〕；行来源断言两层豁免集合同批修订 = 行型豁免 {decay, verdict} × 来源类别豁免 {hero_attack, enemy_action, clear_reward}，豁免不等于免检——豁免行仍受公共字段与各自语义约束，清单改动须同步 战斗结算 明细流水一节与 battle_log_view 格式化）· **穿刺/魔法 充能与护甲克制结算规格 = 战斗结算 GDD F6（W3 补全，2026-09-14 重算批；2026-09-15 命名统一批）**——挖掘期充能/战斗段消费/单轮生命周期、不吃 percent、逐分量 armor_effectiveness 查表 floor 相加
|
||||
closure_receipt: 行动经济 F1 条款①②③⑤闭合 owner = 战斗结算（2026-09-10 F0–F5 首版验算完成——F0 瞬时当量口径 + m_w 值域裁决见 status_effect.anchor_warning；条款③ clause3_supply 闭合回执；条款⑤ clause5_dominance 条目；actuals p10 交付后强制重跑）
|
||||
referenced_by: [HUD框架, 战斗表现, 音频, 教学引导, 难度曲线与Boss]
|
||||
|
||||
@@ -332,8 +336,8 @@ entities:
|
||||
boundary: **单结算自然边界（用户 2026-09-09 定稿）**——"不设（每战）上界：踩雷 debuff 只在一次结算中有效，之后没有 debuff"（dur=1 每结算清零无存量）
|
||||
variables: [cap, m_amb, unit_count, k_r, L_r]
|
||||
output_range: 单结算结构上界 ∈ [0, unit_count×min(AP, cap)×m_amb]（满配语境 3×min(8,4)×3=36；cap≥8 时真可达上界 72 而非 144；默认行值 unit_count=1 下 12）
|
||||
account_input: 对账输入 = 棋盘生成 actuals p10（F4 报告 C）非 target 参数（棋盘生成 登记口径）；闭合 owner = 战斗结算 单一签字人；左臂（安全格 buff 当量）载体 = **奖励道具经济 F6 当量供给**（2026-09-09 奖励道具经济 定稿——部分缓解非闭合：窗口使用次数是战斗轨迹量，敌人系统 OQ3 扩项保持；2026-09-11 起基础攻击恒在为左臂提供恒定伤害基底，原"当前内容态结构性不可通关"事实退役——敌人系统 Overview 2026-09-11 改写）
|
||||
direction_precheck: cap=4 下右臂 ≈7.7；左臂按条款 2 最低档锚（+50pp）计 = 0.36×50 = 18——裕度 ≈2.3×（1:1 百分点代理，provisional；2026-09-09 敌人系统 full 评审更正原 4.7×——该值按 +100 两层叠满取值、与"最低档下界"语言矛盾）；量级注记：atk=4 时 attack 拍 L≥2 伏击分量过半（heavy 拍过半点后移、按拍别读取；常态支配修正入口 = 难度曲线与Boss atk 曲线 / 奖励道具经济·战斗结算 m_amb 锚，敌人系统 权限外）。**参照迁移注记（2026-09-09 奖励道具经济 评审；2026-09-11 回迁）**：左臂参照对象曾迁 defense_up 当量（奖励道具经济 F4）——**2026-09-11 用户裁决"基础攻击恒存在"后 attack_up 复活，参照对象回迁 attack_up 当量**（上式 +50pp 系 attack_up 口径，迁移期结束；复算义务随 战斗结算 对照表落定，见 status_effect.anchor_warning 回迁注记）。**闭合回执（2026-09-10 战斗结算 GDD F4——条款③闭合完成；同日评审批双口径更正）**：统一 HP 当量 + 边际配对重算 → 默认 unit_count=1 下 L1 裕度 ≈2.0× / L2 ≈2.6× **通过**（锚行口径；**跨行期望口径 ≈1.2×/1.5× 同向通过——双口径登记，难度曲线与Boss 不得以锚行读数放行 unit_count=2**）；**满配语境（unit_count=3）最坏盲点破线 → 难度曲线与Boss 调参约束登记**（unit_count 轴 + 密度×可推理率轴——unit_count>1 行须降密度或降 m_amb）；本条 pp 代理预检（2.3×）退役为历史记录（量纲混用 + 右臂聚合上界与单格决策单位错配）。**重算回执（2026-09-14 战斗结算 重算批——按现行三输入重推：duration=1 × m_d=−30 × 难度曲线与Boss v3 曲线 d0.25/t0.88）**：L1 裕度 ≈0.48× / L2 ≈0.47× **破线**（锚行口径；跨行期望口径 E_dig=4.5 → ≈0.60×/0.58× 同向破线——双口径登记）；满配语境（unit_count=3）≈0.16× 深度破线；**破线升格为默认曲线级约束——V_safe 侧杠杆（m_d/duration/D_ref）× 板形侧杠杆（密度×ι 联动对）× m_amb 全处"禁独立调参"联动网络（m_w↔D_ref↔m_d↔duration_d），修正方向须 难度曲线与Boss 提案 + 战斗结算 闭合对账共裁**；上段 ≈2.0×/2.6× 读数系 duration=2 × m_d=−50 × v1 曲线旧值链产物，退役为历史记录；actuals p10 交付后强制重跑（战斗结算 AC-39；ι 判式面保守代理 = 行 target 代，总暴露面无效）
|
||||
account_input: 对账输入 = 棋盘生成 actuals p10（F4 报告 C）非 target 参数（棋盘生成 登记口径）；闭合 owner = 战斗结算 单一签字人；左臂（安全格 buff 当量）载体 = **地图战斗资源 F6 当量供给**（2026-09-09 地图战斗资源 定稿——部分缓解非闭合：窗口使用次数是战斗轨迹量，敌人系统 OQ3 扩项保持；2026-09-11 起基础攻击恒在为左臂提供恒定伤害基底，原"当前内容态结构性不可通关"事实退役——敌人系统 Overview 2026-09-11 改写）
|
||||
direction_precheck: cap=4 下右臂 ≈7.7；左臂按条款 2 最低档锚（+50pp）计 = 0.36×50 = 18——裕度 ≈2.3×（1:1 百分点代理，provisional；2026-09-09 敌人系统 full 评审更正原 4.7×——该值按 +100 两层叠满取值、与"最低档下界"语言矛盾）；量级注记：atk=4 时 attack 拍 L≥2 伏击分量过半（heavy 拍过半点后移、按拍别读取；常态支配修正入口 = 难度曲线与Boss atk 曲线 / 地图战斗资源·战斗结算 m_amb 锚，敌人系统 权限外）。**参照迁移注记（2026-09-09 地图战斗资源 评审；2026-09-11 回迁）**：左臂参照对象曾迁 defense_up 当量（地图战斗资源 F4）——**2026-09-11 用户裁决"基础攻击恒存在"后 attack_up 复活，参照对象回迁 attack_up 当量**（上式 +50pp 系 attack_up 口径，迁移期结束；复算义务随 战斗结算 对照表落定，见 status_effect.anchor_warning 回迁注记）。**闭合回执（2026-09-10 战斗结算 GDD F4——条款③闭合完成；同日评审批双口径更正）**：统一 HP 当量 + 边际配对重算 → 默认 unit_count=1 下 L1 裕度 ≈2.0× / L2 ≈2.6× **通过**（锚行口径；**跨行期望口径 ≈1.2×/1.5× 同向通过——双口径登记，难度曲线与Boss 不得以锚行读数放行 unit_count=2**）；**满配语境（unit_count=3）最坏盲点破线 → 难度曲线与Boss 调参约束登记**（unit_count 轴 + 密度×可推理率轴——unit_count>1 行须降密度或降 m_amb）；本条 pp 代理预检（2.3×）退役为历史记录（量纲混用 + 右臂聚合上界与单格决策单位错配）。**重算回执（2026-09-14 战斗结算 重算批——按现行三输入重推：duration=1 × m_d=−30 × 难度曲线与Boss v3 曲线 d0.25/t0.88）**：L1 裕度 ≈0.48× / L2 ≈0.47× **破线**（锚行口径；跨行期望口径 E_dig=4.5 → ≈0.60×/0.58× 同向破线——双口径登记）；满配语境（unit_count=3）≈0.16× 深度破线；**破线升格为默认曲线级约束——V_safe 侧杠杆（m_d/duration/D_ref）× 板形侧杠杆（密度×ι 联动对）× m_amb 全处"禁独立调参"联动网络（m_w↔D_ref↔m_d↔duration_d），修正方向须 难度曲线与Boss 提案 + 战斗结算 闭合对账共裁**；上段 ≈2.0×/2.6× 读数系 duration=2 × m_d=−50 × v1 曲线旧值链产物，退役为历史记录；actuals p10 交付后强制重跑（战斗结算 AC-39；ι 判式面保守代理 = 行 target 代，总暴露面无效）
|
||||
referenced_by: [战斗结算]
|
||||
|
||||
- name: clause5_dominance
|
||||
@@ -341,11 +345,11 @@ entities:
|
||||
owner: design/gdd/systems/战斗循环/战斗结算.md
|
||||
attributes:
|
||||
rule: 行动经济 F1 条款⑤清图 vs 弃图支配性闭合（战斗结算 单一闭合 owner，战斗结算 GDD F5；**2026-09-10 评审批模型修订：挖穿残余池计价**——E[踩雷] = |M|×n_s/(n_s+1) 均匀交错模型、Δr = ⌈(n_s+E[踩雷])÷AP_r⌉；旧模型按每格独立赌 P(雷) 漏计全池挖掘量、系统性偏乐观）——主判式 Δ_clear = [R_res + C_eff] − [X_res + Δr × s_ref] ≥ 0；E_dig = 默认根加权 7.2 HP（刀 40%/治疗 25%/defense_up 35%）；C_eff = C ×（perfect ? P_perfect÷100 : 1）（×2 = 真实双份交付）；s_ref = D_ref；**停手侧 RAP 机会收益按零计价（显式假设登记——零价假设下 verdict 已为负，为 RAP 计价只会更负）**；域守卫 n_s < 1 ⇒ 主判式不评估、信息端平凡腿接管
|
||||
first_pass: **条款⑤未闭合（2026-09-10 模型修订重推——旧"两态通过"读数作废）**：L1 −5.3 / L2 −10.1（完美双份 +2.7/−2.1）；满配语境 unit_count=3 深度为负（−49.6/−97.5，与 clause3_supply 破线同向联动）；实现率折减口径（E_dig×0.6）更差（−18.5/−39.5）；保守地板需求 L1 ≥ 46.1 / L2 ≥ 91.8（vs C=8/完美 16——缺口 −38.1/−75.8）。**难度曲线与Boss/奖励道具经济 约束包**：① C 量级上调整向（护栏 B 口径联动复核）② 或裁"清图非严格支配"为设计态（如裁设计态须同步声明 行动经济 条款⑤ P1 对冲弱化 + 奖励道具经济 预警加权监控）——①②二选一归 难度曲线与Boss 裁；③ 多敌放行判据 = 条款③⑤在全部登记行组合下同时成立。判据函数角色 = 调参约束生成器（AC-40 断言输出与约束包一致）
|
||||
first_pass: **条款⑤未闭合（2026-09-10 模型修订重推——旧"两态通过"读数作废）**：L1 −5.3 / L2 −10.1（完美双份 +2.7/−2.1）；满配语境 unit_count=3 深度为负（−49.6/−97.5，与 clause3_supply 破线同向联动）；实现率折减口径（E_dig×0.6）更差（−18.5/−39.5）；保守地板需求 L1 ≥ 46.1 / L2 ≥ 91.8（vs C=8/完美 16——缺口 −38.1/−75.8）。**难度曲线与Boss/地图战斗资源 约束包**：① C 量级上调整向（护栏 B 口径联动复核）② 或裁"清图非严格支配"为设计态（如裁设计态须同步声明 行动经济 条款⑤ P1 对冲弱化 + 地图战斗资源 预警加权监控）——①②二选一归 难度曲线与Boss 裁；③ 多敌放行判据 = 条款③⑤在全部登记行组合下同时成立。判据函数角色 = 调参约束生成器（AC-40 断言输出与约束包一致）
|
||||
c3_ruling: **约束包②采信（非支配设计态）+ 计价基元换位重推（2026-09-14 难度曲线与Boss 修订批）**——clear_default 槽由 clear_knife（入库刀 C=8/完美 16）换位为 clear_blast（instant_aoe 当场兑付全体存活敌，C = power = 40）：保守地板需求缺口重推 = 46.1−40 = 6.1（L1）/ 91.8−40 = 51.8（L2）；C 量级不上调 ✓；P1 对冲弱化同步声明（② 条件）+ 弃图率加权监控随 OQ4 持续；本条 first_pass 旧读数（C=8/16 口径）留作模型演进记录；**区间批义务（2026-09-14）**：C 语义改区间 [25,55]（期望中点 40 不变——期望口径缺口 6.1/51.8 维持）；保守地板口径（min=25）缺口重推 = 21.1/66.8——战斗结算 修订批对齐条款⑤措辞（义务登记，未兑现前 战斗结算 文本 C=40 按期望中点读）。**重算回执（2026-09-14 战斗结算 重算批——v3 曲线 d0.25/t0.88 × E_dig=4.5 重推，参考板形换锚 难度曲线与Boss MVP 行值总表）**：主判式 L1 −28.7/+11.3（完美翻正）、L2 −67.4/−27.4、满配 −153.2/−113.2 与 −257.1/−217.1；保守地板需求 L1 ≥ 110.3 / L2 ≥ 166.8（缺口 70.3/126.8，对 clear_blast）；上段 46.1/91.8 需求系 v1 曲线旧值链产物退役；**难度曲线与Boss 裁决②非支配设计态维持**（qualitative 结构不变——非完美态负、完美态 L1 翻正、L2 全负）；护栏 A 方向性复核 ≈−1.1 越下界（E_dig 修正）/ 护栏 B C=40 越线——W2 复核三选一裁决随 难度曲线与Boss 收口批；actuals 交付后按 clear_blast 语义强制重跑（战斗结算 AC-40 同批口径）
|
||||
guardrails: 护栏 B 防钓鱼（**2026-09-10 输入登记更正 + 双读数**：|S|_min = 棋盘生成 行级 knob 禁写死；|R₀|_max 无登记供给方——登记 棋盘生成 产出义务〔R₀ 规模分布上界，报告 C 扩列〕；s_ref=D_ref=12 比真实敌方 DPS 期望松 2.5–3×→ D_ref 口径上界 24〔C_eff=16 ✓〕/ DPS 严格读数 ≈8〔C_eff=16 越〕——两读数裁决归 难度曲线与Boss，与约束包①联动；结构承载 = 棋盘生成 min_safe_count + 布雷数下限 + 排雷玩法 R₀≠S 三闸的对账复核，非运行期校验）
|
||||
rerun_obligation: actuals p10 交付后强制重跑（战斗结算 AC-40）；难度曲线与Boss 每次调参重跑（D_ref/P_pf/C 联动）
|
||||
referenced_by: [难度曲线与Boss, 奖励道具经济, 棋盘生成]
|
||||
referenced_by: [难度曲线与Boss, 地图战斗资源, 棋盘生成]
|
||||
|
||||
# 占位表中的原型参考值（伏击 +3、清图 +10、敌 18HP/4ATK 等）为 provisional，
|
||||
# 不登记为事实——待各 owner GDD（地形变异/增益状态/奖励道具经济/战斗结算/难度曲线与Boss）定稿后由其登记。
|
||||
@@ -419,40 +423,40 @@ entities:
|
||||
owner: design/gdd/systems/表现与支撑/HUD框架.md
|
||||
attributes:
|
||||
kind: 呈现面契约（读图接口清单 + 订阅纪律 + 命令式刷新面 + 载荷 schema 索引——封装收口批〔session-state entry 39/40〕切片事实的 GDD 转正）
|
||||
read_map: 排雷玩法 current_board()/reveal_record()/compute_move_path() · 行动经济 getter-only phase/ap/rap/last_round_end · 战斗结算 presentation_snapshot()/is_battle_live()/stock_count()/query_reward_identity() + 步骤流信号 · 敌人系统 hero_unit()/all_enemies() · **增益状态/奖励道具经济 零直读**（经 战斗结算 呈现面与流水投影）· runner（节点链/当前节点/HP 携带）
|
||||
read_map: 排雷玩法 current_board()/reveal_record()/compute_move_path() · 行动经济 getter-only phase/ap/rap/last_round_end · 战斗结算 presentation_snapshot()/is_battle_live()/stock_count()/query_reward_identity() + 步骤流信号 · 敌人系统 hero_unit()/all_enemies() · **增益状态/地图战斗资源 零直读**（经 战斗结算 呈现面与流水投影）· runner（节点链/当前节点/HP 携带）
|
||||
write_paths: settle_batch（stop 亦经此，禁直调 行动经济）/ submit_window_selection(窗口条目位置序，非库存句柄) / 刷新意图 → 战斗结算 refresh_board 编排 / runner 推进——**全部唯一发生在组合根**
|
||||
subscription_discipline: 呈现层永不直接订阅 排雷玩法/行动经济——只订 战斗结算 步骤流/快照与 runner 信号（ADR-0001 固化）；接线全部在组合根
|
||||
imperative_refresh_faces: 零事件外发动作的刷新 = 命令式回执驱动（白话：动作调用返回后组合根立刻重查一次只读面刷新界面，不等通知信号）——旗插拔/移动成功（排雷玩法）/ AP·RAP 读数（行动经济 无推送）/ 状态效果（增益状态 零信号，绑 战斗结算 结算完成时点）/ 库存（奖励道具经济 查询面）五面成文
|
||||
payload_schema_index: HUD框架 GDD Core Rule 17 表 13 项——排雷玩法 三事件/战斗结算 流水行协议/奖励道具经济 窗口载荷等均为引用既有 schema；HUD框架 自有成文 = ux 遥测六行（ux_round_input_ratio/ux_round_exit/ux_refresh_attempt/ux_window_choice/ux_reject/ux_hint_shown）+ hint_id 封闭枚举 {chord, no_adjacent}
|
||||
imperative_refresh_faces: 零事件外发动作的刷新 = 命令式回执驱动（白话：动作调用返回后组合根立刻重查一次只读面刷新界面，不等通知信号）——旗插拔/移动成功（排雷玩法）/ AP·RAP 读数（行动经济 无推送）/ 状态效果（增益状态 零信号，绑 战斗结算 结算完成时点）/ 库存（地图战斗资源 查询面）五面成文
|
||||
payload_schema_index: HUD框架 GDD Core Rule 17 表 13 项——排雷玩法 三事件/战斗结算 流水行协议/地图战斗资源 窗口载荷等均为引用既有 schema；HUD框架 自有成文 = ux 遥测六行（ux_round_input_ratio/ux_round_exit/ux_refresh_attempt/ux_window_choice/ux_reject/ux_hint_shown）+ hint_id 封闭枚举 {chord, no_adjacent}
|
||||
lifetime_visibility_rule: 销毁前捕获（终局/死亡数据 despawn 前已入流水与快照）/ 载荷自包含（行协议自带来源/值/目标，禁按行序反推）/ 禁回读核心生命周期态（唯一观测口 = is_battle_live() 与 phase 投影）——切片缺陷②教训转正
|
||||
naming_unification: 正式名 request_refresh（行动经济）/ refresh_cap_per_round（结构位默认 2）——切片 provisional 名 request_refresh_active/can_request_refresh/refresh_max_per_round/during_round 退役（AC grep 断言零残留）
|
||||
drift_registrations: ① 行动经济 只读观测量缺轮内已用刷新次数（刷新按钮"本轮剩 N 次"读数缺口——行动经济 修订批补）② 切片 settlement_snapshot 信号 战斗结算 GDD 未登记契约（HUD框架 现行消费 = 步骤流判定行 + presentation_snapshot()，独立信号须回 战斗结算 补登记）③ 极性提案实施批 HUD框架 义务条目（未开格类型图标/极性视觉语言/负向文案族——随批入 systems-index HUD框架 台账）
|
||||
referenced_by: [战斗表现, 音频, 教学引导, 辅助道具, 设置与本地化]
|
||||
referenced_by: [战斗表现, 音频, 教学引导, 魔法道具, 设置与本地化]
|
||||
|
||||
- name: aux_items
|
||||
type: schema_data
|
||||
owner: design/gdd/systems/排雷循环/辅助道具.md
|
||||
owner: design/gdd/systems/排雷循环/魔法道具.md
|
||||
attributes:
|
||||
table: AuxItemTable（数据配置 承载【数据配置×① 修订批登记】，键 = item_id；辅助道具 回填 owner，2026-09-14 定稿登记；定义表非进度成长表——Rule 4 豁免；生效前提 = 奖励道具经济×①…⑤/数据配置×①② 修订批兑现）
|
||||
table: AuxItemTable（数据配置 承载【数据配置×① 修订批登记】，键 = item_id；魔法道具 回填 owner，2026-09-14 定稿登记；定义表非进度成长表——Rule 4 豁免；生效前提 = 地图战斗资源×①…⑤/数据配置×①② 修订批兑现）
|
||||
fields:
|
||||
item_id: String 主键唯一——奖励道具经济 RewardTable.effect_id（aux 行）与 VariationTable.counter_item_ids 的引用键
|
||||
display_name: String 非空（HUD框架 呈现数据源，本地化归 设置与本地化——敌人系统/增益状态/奖励道具经济 同库惯例）
|
||||
item_id: String 主键唯一——地图战斗资源 RewardTable.effect_id（aux 行）与 VariationTable.counter_item_ids 的引用键
|
||||
display_name: String 非空（HUD框架 呈现数据源，本地化归 设置与本地化——敌人系统/增益状态/地图战斗资源 同库惯例）
|
||||
dimension_tags: StringList ⊆ {info, risk, action, plan, counter} 非空——维度覆盖断言载体（F2：五维度各 ≥1 活行 = "每维度都有对应道具"的机器可查形态）
|
||||
effect_kinds: StringList ⊆ {mine_reveal, reward_preview, ap_grant} 非空、无重复（MVP ≤2——稀有多维组合行的 schema 承载；显影尘与地穴全图卷的原显影半边随雾格移除失义，效果待重定——辅助道具 待拍板，名称保留）
|
||||
effect_kinds: StringList ⊆ {mine_reveal, reward_preview, ap_grant} 非空、无重复（MVP ≤2——稀有多维组合行的 schema 承载；显影尘与地穴全图卷的原显影半边随雾格移除失义，效果待重定——魔法道具 待拍板，名称保留）
|
||||
target: enum {none, area_3x3, board_wide}——校验 = target ∈ 各空间 kind 支持域交集（全非空间 ⇒ 恒 none）；原 fog_region 域随显影效果待重定一并重立
|
||||
magnitude: int [0,999]（knob）——仅 ap_grant 行消费（= AP 点数，加载校验 ≥1）；空间行不消费非校验项
|
||||
use_phase: enum {active_dig}——MVP 单值（扩枚举走 辅助道具 GDD 修订；奖励道具经济 use_timing 扩值 during_dig 同批对齐——奖励道具经济×③）
|
||||
mvp_content: 六行（值 provisional 归 难度曲线与Boss；显影尘与地穴全图卷的原显影半边随雾格移除失义、效果与目标待重定——辅助道具 待拍板，名称保留）——probe_dust 显影尘〔info+counter / 效果待重定 / w5 t2〕· sapper_order 工兵令〔action / ap_grant / none / mag 2 / w5 t2〕· loot_compass 探宝罗盘〔plan / reward_preview / area_3x3 / w4 t2〕· nest_pendulum 探巢摆钟〔risk / mine_reveal / area_3x3 / w4 t2〕· catacomb_scroll 地穴全图卷〔info+plan / reward_preview + 显影半边待重定 / board_wide / w1 t3〕· blast_kit 爆破工兵包〔action+risk / ap_grant+mine_reveal / area_3x3 / mag 4 / w1 t3〕——四常规单维（t2）+ 两稀有多维高数值（t3；稀有读数 ≈0.17 件/板，F1）
|
||||
load_bearing_rules: 真视窄域护栏（承重）——mine_reveal 支持域 ≤area_3x3、board_wide 仅恢复推理原料类效果（显影/预读，显影载体待重定；恢复推理可全图、替代推理必窄域——P1 防塌方；schema 校验强制，夹具 aux_target_violation）· 效果时效随 kind 派生无独立字段（空间 kind 恒本图持续、ap_grant 恒当轮一次性）· 零随机（零 RNG 流消费——信息全部来自 排雷玩法 恒真数字/奖励道具经济 Ready 映射/行动经济 账本三既有事实源）· 零特判延伸（排雷玩法 代码零 辅助道具 分支）· 无效/零信息目标不可用不消耗（可用性门——2026-09-14 用户拍板：板级判据 → 图标灰/入口禁用〔奖励道具经济 usable_now 先例〕、点击级 → 拒绝零消耗、组合行判据取 OR——爆破包 ap_grant 恒可用、真视零雷恒有效；与 奖励道具经济 E10 照常消耗区分——挖掘期非结算管线、守卫 辅助道具 本地可判）· area_3x3 边缘窗口 resolved_target = 窗口 ∩ 板内格（2026-09-14 用户拍板——护栏只缩不扩）· 使用零 AP 成本（不经 try_spend）· 库存关卡域（与 奖励道具经济 库存正交两容器、生命周期同构）· Used 不可逆
|
||||
overlay_semantics: 板级叠加层三集（辅助道具 自持派生信息层、零回写 排雷玩法/奖励道具经济 状态、随图消亡；现行有效的 = 真视集与预读集，显影集载体待重定）——digit_reveal 显影集（HUD框架 显示被隐藏的数字，本体 = 排雷玩法 恒真数字；载体待重定）/ mine_reveal 真视集（真视≠自动兑付——插旗仍花 1 AP 走既有 flag_hit 路径）/ reward_preview 预读集（徽章数据源 = 战斗结算 query_reward_identity 既有读面——辅助道具 零 奖励道具经济 数据复制）
|
||||
api: 封闭枚举 8 入口（provisional，实现期 ADR 定名）——add_item(item_id, source) / query_inventory（枚举序 = 受理序，Used 保留只读，逐件含 usable 板级零信息可用性预判）/ validate_use(handle, target?) → 效果投影（只读不消耗；目标校验谓词 = 越板/点击级零信息拒绝 + 边缘窗口裁剪 resolved_target = 窗口 ∩ 板内格）/ apply_overlay(kind, target, mag)（战斗结算 逐 kind 调用）/ consume(handle)（Used 不可逆 + 快照回执）/ query_overlays（三集只读投影）/ retire_overlays（战斗结算 编排——与 奖励道具经济 retire_mapping 同点）/ clear_inventory（关卡末幂等）；负空间 = 无自动使用入口/无重掷/无事件订阅/无 RNG 直连/无 排雷玩法/奖励道具经济 写入口
|
||||
use_orchestration: 战斗结算 use_aux 规范序（唯一调用权）= 相位 gate（Active——行动经济 phase getter）→ validate_use（目标校验读 排雷玩法 只读面——使用目标校验谓词表见 辅助道具 GDD）→ 逐 kind 应用（顺序钉死：空间先、ap_grant 后——effect_kinds 列表序非运行时语义）→ consume——序即原子（validate 拦下全部可失败输入；apply/grant 域内无失败路径 → consume 恒达）
|
||||
formulas: F1 aux 渗透供给（E[N_aux/板] = |U|×Σw_aux/W_total，默认根 ≈1.7 件/板、稀有 ≈0.17；|U| 分布缺口待 棋盘生成 actuals——奖励道具经济 预检 11 同批重跑）· F2 维度覆盖谓词 coverage(d) · F3 信息价值方向预检（显影 ι↑ → 残余盲猜端 n_s = (1−ι)|S| 收缩 → 盲赌暴露下降 → 期望踩雷↓——P(雷) = |M|/(|M|+n_s) 对 ι 递增，单赌命中率上行属正常，收益在"少赌"非"单赌更安全"；与 战斗结算 F4 同式 + n_s<1 适用域守卫；2026-09-14 评审修正原"P(雷)↓"方向误写；定量当量归 战斗结算 条款①对照表扩列——战斗结算×④注记，MVP 不入对照表）
|
||||
obligations: 21 项跨 GDD 义务清单（辅助道具 GDD Dependencies 全文，对侧修订批逐项核对、缺项即 blocking）——战斗结算×①②③（use_aux 编排/生命周期/授予路由，缺项即 blocking）+ 战斗结算×④（对照表扩列注记）· 奖励道具经济×①…⑤（category 扩值 aux_item/effect_id 双表校验+夹具 reward_dangling_aux/use_timing 扩 during_dig/默认根六行+池总权重算/OQ2 收口注记）· 行动经济×①（grant_ap 第 9 API 接口漂移预授权——Active 受理、无上限域、零随机）· 地形变异×①②③（counter_item_ids 首引回填随未来变异行建行批/悬空校验激活+夹具 aux_dangling_counter/未来变异随批配 ≥1 反制——原雾行绑定随移除悬空，显影尘效果待重定）· HUD框架×①…④（库存条/使用交互/叠加层三集呈现/清空反馈）· 数据配置×①②（AuxItemTable 登记/两处表值回填+校验激活）· 教学引导×①（教学候选，非 blocking）· art-bible×①（§4.6 键扩容：item_id 六键+叠加层标记三族）
|
||||
use_phase: enum {active_dig}——MVP 单值（扩枚举走 魔法道具 GDD 修订；地图战斗资源 use_timing 扩值 during_dig 同批对齐——地图战斗资源×③）
|
||||
mvp_content: 六行（值 provisional 归 难度曲线与Boss；显影尘与地穴全图卷的原显影半边随雾格移除失义、效果与目标待重定——魔法道具 待拍板，名称保留）——probe_dust 显影尘〔info+counter / 效果待重定 / w5 t2〕· sapper_order 工兵令〔action / ap_grant / none / mag 2 / w5 t2〕· loot_compass 探宝罗盘〔plan / reward_preview / area_3x3 / w4 t2〕· nest_pendulum 探巢摆钟〔risk / mine_reveal / area_3x3 / w4 t2〕· catacomb_scroll 地穴全图卷〔info+plan / reward_preview + 显影半边待重定 / board_wide / w1 t3〕· blast_kit 爆破工兵包〔action+risk / ap_grant+mine_reveal / area_3x3 / mag 4 / w1 t3〕——四常规单维（t2）+ 两稀有多维高数值（t3；稀有读数 ≈0.17 件/板，F1）
|
||||
load_bearing_rules: 真视窄域护栏（承重）——mine_reveal 支持域 ≤area_3x3、board_wide 仅恢复推理原料类效果（显影/预读，显影载体待重定；恢复推理可全图、替代推理必窄域——P1 防塌方；schema 校验强制，夹具 aux_target_violation）· 效果时效随 kind 派生无独立字段（空间 kind 恒本图持续、ap_grant 恒当轮一次性）· 零随机（零 RNG 流消费——信息全部来自 排雷玩法 恒真数字/地图战斗资源 Ready 映射/行动经济 账本三既有事实源）· 零特判延伸（排雷玩法 代码零 魔法道具 分支）· 无效/零信息目标不可用不消耗（可用性门——2026-09-14 用户拍板：板级判据 → 图标灰/入口禁用〔地图战斗资源 usable_now 先例〕、点击级 → 拒绝零消耗、组合行判据取 OR——爆破包 ap_grant 恒可用、真视零雷恒有效；与 地图战斗资源 E10 照常消耗区分——挖掘期非结算管线、守卫 魔法道具 本地可判）· area_3x3 边缘窗口 resolved_target = 窗口 ∩ 板内格（2026-09-14 用户拍板——护栏只缩不扩）· 使用零 AP 成本（不经 try_spend）· 库存关卡域（与 地图战斗资源 库存正交两容器、生命周期同构）· Used 不可逆
|
||||
overlay_semantics: 板级叠加层三集（魔法道具 自持派生信息层、零回写 排雷玩法/地图战斗资源 状态、随图消亡；现行有效的 = 真视集与预读集，显影集载体待重定）——digit_reveal 显影集（HUD框架 显示被隐藏的数字，本体 = 排雷玩法 恒真数字；载体待重定）/ mine_reveal 真视集（真视≠自动兑付——插旗仍花 1 AP 走既有 flag_hit 路径）/ reward_preview 预读集（徽章数据源 = 战斗结算 query_reward_identity 既有读面——魔法道具 零 地图战斗资源 数据复制）
|
||||
api: 封闭枚举 8 入口（provisional，实现期 ADR 定名）——add_item(item_id, source) / query_inventory（枚举序 = 受理序，Used 保留只读，逐件含 usable 板级零信息可用性预判）/ validate_use(handle, target?) → 效果投影（只读不消耗；目标校验谓词 = 越板/点击级零信息拒绝 + 边缘窗口裁剪 resolved_target = 窗口 ∩ 板内格）/ apply_overlay(kind, target, mag)（战斗结算 逐 kind 调用）/ consume(handle)（Used 不可逆 + 快照回执）/ query_overlays（三集只读投影）/ retire_overlays（战斗结算 编排——与 地图战斗资源 retire_mapping 同点）/ clear_inventory（关卡末幂等）；负空间 = 无自动使用入口/无重掷/无事件订阅/无 RNG 直连/无 排雷玩法/地图战斗资源 写入口
|
||||
use_orchestration: 战斗结算 use_aux 规范序（唯一调用权）= 相位 gate（Active——行动经济 phase getter）→ validate_use（目标校验读 排雷玩法 只读面——使用目标校验谓词表见 魔法道具 GDD）→ 逐 kind 应用（顺序钉死：空间先、ap_grant 后——effect_kinds 列表序非运行时语义）→ consume——序即原子（validate 拦下全部可失败输入；apply/grant 域内无失败路径 → consume 恒达）
|
||||
formulas: F1 aux 渗透供给（E[N_aux/板] = |U|×Σw_aux/W_total，默认根 ≈1.7 件/板、稀有 ≈0.17；|U| 分布缺口待 棋盘生成 actuals——地图战斗资源 预检 11 同批重跑）· F2 维度覆盖谓词 coverage(d) · F3 信息价值方向预检（显影 ι↑ → 残余盲猜端 n_s = (1−ι)|S| 收缩 → 盲赌暴露下降 → 期望踩雷↓——P(雷) = |M|/(|M|+n_s) 对 ι 递增，单赌命中率上行属正常，收益在"少赌"非"单赌更安全"；与 战斗结算 F4 同式 + n_s<1 适用域守卫；2026-09-14 评审修正原"P(雷)↓"方向误写；定量当量归 战斗结算 条款①对照表扩列——战斗结算×④注记，MVP 不入对照表）
|
||||
obligations: 21 项跨 GDD 义务清单（魔法道具 GDD Dependencies 全文，对侧修订批逐项核对、缺项即 blocking）——战斗结算×①②③（use_aux 编排/生命周期/授予路由，缺项即 blocking）+ 战斗结算×④（对照表扩列注记）· 地图战斗资源×①…⑤（category 扩值 aux_item/effect_id 双表校验+夹具 reward_dangling_aux/use_timing 扩 during_dig/默认根六行+池总权重算/OQ2 收口注记）· 行动经济×①（grant_ap 第 9 API 接口漂移预授权——Active 受理、无上限域、零随机）· 地形变异×①②③（counter_item_ids 首引回填随未来变异行建行批/悬空校验激活+夹具 aux_dangling_counter/未来变异随批配 ≥1 反制——原雾行绑定随移除悬空，显影尘效果待重定）· HUD框架×①…④（库存条/使用交互/叠加层三集呈现/清空反馈）· 数据配置×①②（AuxItemTable 登记/两处表值回填+校验激活）· 教学引导×①（教学候选，非 blocking）· art-bible×①（§4.6 键扩容：item_id 六键+叠加层标记三族）
|
||||
ux_flag: 有 UI 贡献（库存条/使用交互/叠加层呈现）——Phase 4 前置 /ux-design；asset-spec 候选（art-bible 样张批后）
|
||||
closures: 奖励道具经济 OQ2 辅助道具 侧收口（呈现深度 = 道具驱动预读；未预读格不呈现、自动寻路不做——终态与否 OQ6）· 创意风险 #1 道具侧兑现（plan 维度预读——结构闭环最后一块，呈现归 HUD框架）· 显影语义（原为雾格显影 = fog_reveal）随雾格移除失义、载体待重定（辅助道具 待拍板）
|
||||
closures: 地图战斗资源 OQ2 魔法道具 侧收口（呈现深度 = 道具驱动预读；未预读格不呈现、自动寻路不做——终态与否 OQ6）· 创意风险 #1 道具侧兑现（plan 维度预读——结构闭环最后一块，呈现归 HUD框架）· 显影语义（原为雾格显影 = fog_reveal）随雾格移除失义、载体待重定（魔法道具 待拍板）
|
||||
warnings: 预警①…④ playtest 预注册归 难度曲线与Boss（道具依赖度/预读覆盖率/AP 转存联动/稀有感知）
|
||||
referenced_by: [战斗结算, 奖励道具经济, 地形变异, 行动经济, HUD框架, 数据配置, 教学引导, art-bible]
|
||||
referenced_by: [战斗结算, 地图战斗资源, 地形变异, 行动经济, HUD框架, 数据配置, 教学引导, art-bible]
|
||||
|
||||
- name: difficulty_table
|
||||
type: table
|
||||
@@ -474,7 +478,7 @@ entities:
|
||||
supply_balance_band: "**关级供给带 [1.1,2.0] 退役（2026-09-14——其验算 0.54 与实测 60% 通关矛盾）**——由生存链区间模型替代：每战 S/K 区间三档判定（绿 S_min>K_max / 黄 E[S]≥E[K]+1 / 红 S_max≤K_min 禁止入表）+ 关级恒等式（atk×ΣR_survive + Σ奖励输出 ≈ Σ敌hp期望×(1+缓冲)，actuals 逐项审计闭合）+ 输出占比带 [15%,40%] + 通关余量带（p90≤13 & p10≥3——'通关只剩一点血'量化）"
|
||||
tool_carrier: level_monte_carlo.gd / reward_expectation.gd（切片原型→难度曲线与Boss 期正式批量工具，棋盘生成 F4 排期倒挂解除载体）
|
||||
calibration_gap: 真人修正系数待 playtest 标定（OQ3——**方向已由试玩批次 1 反向确认：真人显著强于模拟者**〔v2 真人 100% vs 模拟 80%〕；旧"真人预期低于模拟"方向声明由本条替代；带按模拟口径定义，真人系数批次 2 定量）
|
||||
referenced_by: [奖励道具经济, 战斗结算, 冒险结构, 元进度]
|
||||
referenced_by: [地图战斗资源, 战斗结算, 冒险结构, 元进度]
|
||||
|
||||
- name: boss_dmax_convention
|
||||
type: convention
|
||||
@@ -615,3 +619,21 @@ entities:
|
||||
# ② 两处已知落差：a) charge_grants 触发源可扩展 vs 切片仅 safe_cell/flag_hit 两处计数埋点（新增源须加埋点）；
|
||||
# b) safe_cell/flag_hit 来源标识跨命名空间同名（结算明细行 source_class / charge_grants 键；RewardTable.pool_tag 已随格面资源批改 cell）。
|
||||
# 验收读数：冒烟 201 项 0 失败 · 四探针 exit=0 无 FAIL（切片侧仍为 pre-v0.7 实现，代码同步随格面资源批新会话执行）。
|
||||
#
|
||||
# 2026-09-15 护甲等级批（用户拍板登记，只改 GDD 与 registry、不动代码；owner=战斗结算 v0.8 / 敌人系统 v0.3 / 难度曲线与Boss v0.4 / registry 侧 3 条）：
|
||||
# settlement_table 增 ac_roll / ac_discount_tiers 两字段（未定稿——掷点形式 d20/百面骰/区间均匀与数值域未定，登记 战斗结算「待拍板」）；
|
||||
# enemy / hero 各增 armor_class 字段（取值域随掷点形式定稿，三敌种与主角行值未定 provisional 归 难度曲线与Boss）；
|
||||
# settlement_table.mechanics 随机口径修订——结算换算层首次引入回合内随机（护甲等级掷点），可回放契约从"结算路径零随机"
|
||||
# 修订为"封闭随机流可回放"（同种子同输入逐位复现）；掷点流归属未定（新增封闭流 vs 复用 encounter）登记 战斗结算「待拍板」，
|
||||
# rng_service 条目本批不动（流清单变更须改代码 + P1 支柱评审，随定稿批执行）。
|
||||
# 护甲等级（数值轴 armor_class）与护甲类型（克制属性轴 armor_type light/ward/heavy）命名区分成文——文档、表字段与代码键不得混用。
|
||||
# EV 中性引入：期望伤害对齐现行表值，现行数值不重调；难度曲线与Boss 生存链区间补记掷点带宽口径（定稿前扫描维持全额口径），"零红档"验收保留。
|
||||
# 拍板口径：必中、非归零（低掷按减伤档位折扣，无 miss 无零收益白回合）；只对基础攻击掷（主角普通分量 / 敌方攻击拍与重击拍基线）；
|
||||
# 棋盘来源一律无视护甲等级——与"奖励/惩罚必中"同构。
|
||||
#
|
||||
# 2026-09-16 系统更名批（用户拍板 2026-09-16，只改命名不改内容）：两个系统中文规范名更名——
|
||||
# "奖励道具经济" → "地图战斗资源"（owner 文件重命名 design/gdd/systems/战斗循环/地图战斗资源.md；其「待拍板」系统更名条目关闭）；
|
||||
# "辅助道具" → "魔法道具"（owner 文件重命名 design/gdd/systems/排雷循环/魔法道具.md）。
|
||||
# 本表同步：owner 路径（reward_table / reward_config / aux_items 三处）与 referenced_by、各属性文本中的系统名提及全部改新名；
|
||||
# 英文代号 REWARD_ITEM_ECONOMY / AUXILIARY_ITEMS 与条目键 reward_/aux_ 暂沿用（代码标识符与工具链口径），与中文名的对齐另批执行。
|
||||
# 底部历史注释行保留各批原文旧名作为修订留痕，现行口径以上方条目为准。
|
||||
Reference in new issue
Block a user