chore: initial commit
This commit is contained in:
commit
ddd2960fa6
317 files changed
+41717
No files matched your search
@@ -0,0 +1,577 @@
|
||||
# 实体注册表(Entity Registry)
|
||||
# 跨系统事实的唯一登记处:各 GDD 定稿的命名实体/公式/常量在此登记,
|
||||
# 后续 GDD 写作时作为"已锁事实"引用——不得默默改值,冲突必须显式提出。
|
||||
# 维护规则:见 design-system 技能 Phase 5b。value 字段只能由 owner GDD 修订。
|
||||
|
||||
entities:
|
||||
- name: config_db
|
||||
type: service
|
||||
owner: design/gdd/d2-data-config.md
|
||||
attributes:
|
||||
kind: autoload
|
||||
role: 数值表单点访问入口(类型化属性)
|
||||
policy: 禁止绕过(Rule 2,debug 注入根除外);校验失败全构建致命(Rule 6)
|
||||
validation_channels: 游戏通道 collect_only=false(致命)/ 测试通道 collect_only=true(收集不升级);夹具注入 --data-root=(仅 debug)
|
||||
referenced_by: [all-systems]
|
||||
|
||||
- name: rng_service
|
||||
type: service
|
||||
owner: design/gdd/d2-data-config.md
|
||||
attributes:
|
||||
kind: autoload
|
||||
streams: [board_gen, reward_roll, encounter]
|
||||
stream_names: 当前封闭清单(增流需改代码 + P1 支柱评审;combat_var 已于 2026-09-07 full 评审删除——玩法随机不预置基础设施;**encounter 增流 2026-09-12 用户拍板**——遭遇随机化批 C3 GDD Core Rule 8,scope_event_binding = 每次战斗实例化恰一 scope,挖掘决策域之外 P1 合规)
|
||||
stream_facade: open_stream(stream) 取号(计数器+1→派生→返回已播种实例);derive_at(stream, scope) 纯函数供测试/预览(不推计数器)
|
||||
scope_event_binding: board_gen=每次生成新扫雷图(A1);reward_roll=每次 board install(格奖励批 + 清图奖励批)(B4——2026-09-09 接口漂移改写,原"每次奖励结算 roll 批次";B4 Rule 2/AC-1 为契约源);encounter=每次战斗实例化恰一 scope(B1 begin_battle 实例化期、扫雷开始前——unit_count 区间均匀骰,挖掘决策域之外 P1 合规)
|
||||
unseeded_access: 致命中止
|
||||
snapshot_contract: 续玩/复盘快照 = master_seed + 各流 scope 计数器(消费方 D3)
|
||||
referenced_by: [A1, B1, B4, C2, D3]
|
||||
|
||||
- name: stream_seed_derivation
|
||||
type: formula
|
||||
owner: design/gdd/d2-data-config.md
|
||||
attributes:
|
||||
variables: [SALT_s, master_seed, scope]
|
||||
output_range: "[0, 2^63)"
|
||||
golden_vectors: 见 d2-data-config.md Formulas-R2 向量表(6 常量:board_gen m=42 scope0-3 · reward_roll m=42 scope0=7422916049646135537 · encounter m=42 scope0=1061841193803499209——2026-09-14 D2 漂移批 encounter 增流补向量)
|
||||
salt_board_gen: 0xA0761D6478BD642F
|
||||
salt_reward_roll: 0xE7037ED1A0B428DB
|
||||
salt_encounter: 0x8EBC6AF09C88C6E3(2026-09-14 encounter 增流——互异奇常数 ≠ 乘数)
|
||||
multiplier: 0x9E3779B97F4A7C15
|
||||
impl_spec: wrap64=二补数自然回绕;禁 float 中间量、禁对中间量用 %、禁"主动修复溢出";常量用分段表达式书写;掩码收尾
|
||||
reproducibility_claim: 同冒险内同流各 scope 无碰撞 + 跨版本恒定(不做跨 master_seed 全局单射声明)
|
||||
master_seed_int64_min: 致命(abs 恒等回绕→与 0 静默别名)
|
||||
set_master_seed_precondition: 仅全流计数器全零时受理(3 流——2026-09-14 D2 漂移批口径)
|
||||
referenced_by: [A1, B1, B4, C2, D3]
|
||||
|
||||
- name: difficulty_row_resolution
|
||||
type: formula
|
||||
owner: design/gdd/d2-data-config.md
|
||||
attributes:
|
||||
rule: (level_index, node_depth) 双维 floor 解析 + base_ceil 命名(请求低于表首向上解析);无 default 行兜底、无外推;越域请求(level<1/depth<0)致命
|
||||
warning_dedup_key: (table_id, missing_type, L*, D*) 四元组;missing_type ∈ {level_floor, depth_floor, both, base_ceil}
|
||||
warning_purpose: 开发期异常信号(非审计工具);难度审计=离线曲线导出工具(C3 期交付物)
|
||||
prerequisite: 每 level 至少 1 行且含 depth-0 锚行(Rule 6 校验)
|
||||
referenced_by: [A1, C3]
|
||||
|
||||
- name: schema_version
|
||||
type: constant
|
||||
owner: design/gdd/d2-data-config.md
|
||||
attributes:
|
||||
value: 实现期定(MVP=1);全部占位 schema 均携带版本字段
|
||||
high_version_policy: 拒读(比较逻辑 owner=D3)
|
||||
referenced_by: [D3]
|
||||
|
||||
- name: action_economy
|
||||
type: constant_set
|
||||
owner: design/gdd/a3-action-economy.md
|
||||
attributes:
|
||||
table: ActionEconomyTable(D2 承载,单行全局;A3 为回填 owner;2026-09-07 三次回填(RAP 结构修订)——四字段删除 + rap_refresh_cost 新增,见 A3 Schema 定稿节)
|
||||
ap_per_round: 8(原型 v2 定稿,12 点已否决;双重身份:节奏 knob 兼停手 RAP 转存规模)
|
||||
dig_ap_cost: 1(连锁展开免费,计入清图进度)
|
||||
flag_place_ap_cost: 1(旗无实物资源/无数量上限——2026-09-07 用户修订,稀缺性由 AP 承载;限小人 8 向相邻)
|
||||
flag_pull_ap_cost: 1(移除棋盘标记、无返还物——OQ2 待原型补丁复核,knob 落点)
|
||||
rap_refresh_cost: 8(RAP 刷新门槛;默认 = ap_per_round,满停一轮 = 恰好一刷基线节拍)
|
||||
move_ap_cost: 0(冻结:P4 探索氛围承载,非经济杠杆)
|
||||
chain_ap_cost: 0(冻结:v2 定稿)
|
||||
rap_rules: RAP = 停手剩余 AP 1:1 转存(结构,非 knob);战斗域生命周期(battle_over 清零,跨轮跨图保留);来源唯一(停手)、支出唯一(刷新);刷新决策主体 = 玩家发起、挖掘期(Active 相位)当场换图——D1 经组合根/B1 refresh_board 编排调用(2026-09-12 D4 修订:原"结算编排期 Waiting 代理调用"退役);每轮上限 2 次(refresh_cap_per_round 结构位默认 2——D1 提案采纳,RoundStart 重置;原"同一 Waiting 相位多次刷新合法/无结构上限"作废);旧板旗随旧板作废(零兑付、旗 AP 不返还——A2 EC11 承载);挖掘期当场刷新无结算发生(原"敌方时间税"自惩失效——A3 OQ3 阈值联动复核);cleared 轮恒 new_board、stopped/ap_exhausted 轮恒 same_board(B1 回发违约 fail-fast 不变);刷新图不产生清图奖励;无战斗收益——原 ×2/×1 折算与 stop/clear_multiplier 已作废(2026-09-07 用户拍板)
|
||||
flag_rules: 旗 = A2 棋盘状态单态(原口袋旗双态作废);随图存续,清图/刷新消失;标中旗 = 怪物 debuff(三向效果定稿),兑付一次性、资格以雷格实例为键(每雷本次战斗至多兑付一次;放置实例仅为当轮结算载体;拔旗重插不恢复已消费资格——2026-09-07 三轮评审改定,OQ5/F1 条款 2)
|
||||
round_end_carrier: 双发射源(2026-09-07 修订)——棋盘路径(ap_exhausted/cleared)由 A2 外发(systems-index 原裁决不变),停手路径(stopped)由 A3 直发;payload 同构 (path_tag, continuation_hint)
|
||||
arbitration_priority: cleared > stopped > ap_exhausted(同帧/同批次结束路径总仲裁;stop-first 批次腿 deferral 至 A2 集成测试,义务清单见 systems-index 门禁记录)
|
||||
downstream_contract: A3 F1 五条款(① 效果当量对照单一线性换算 · ② 标中旗锚严格 > 最低档 + 连锁放大边际基准 + 总吞吐对账 · ③ 挖掘风险不等式 P(安全)×buff > P(雷)×敌方增益,B1 单一闭合 owner · ④ 清图奖励 > 0 且 B4 差异化插槽(图类型战斗域恒定) · ⑤ 清图 vs 弃图刷新支配性,B1 闭合强制检查点)——2026-09-07 三轮评审定稿
|
||||
cross_field_validation: 任一动作成本(dig/flag_place/flag_pull)≤ ap_per_round——ActionEconomyTable schema validate() 跨字段类别,违规加载期致命(2026-09-07 三轮评审增补;条件性夹具登记 D2 校验双通道)
|
||||
referenced_by: [A1, A2, A4, B1, B3, B4, D1, D5]
|
||||
|
||||
- name: variation_table
|
||||
type: schema_data
|
||||
owner: design/gdd/a4-terrain-variation.md
|
||||
attributes:
|
||||
table: VariationTable(D2 承载,键 = variant_id;A4 回填 owner,2026-09-08 定稿回填)
|
||||
fields: variant_id(String 主键唯一)/ display_name / unlock_level(int [1,999],knob)/ scope(enum region|global,global 预留 C3)/ info_mask(enum none|hide_numbers)/ cell_constraint(enum any|safe_nonzero)/ biome_tag(StringList,∅=通配,knob)/ counter_item_ids(StringList,A5 预留,非 knob——2026-09-08 re-review 修正 ✓ 误标)
|
||||
mvp_content: 恰含 fog 一行(unlock_level=2【knob 活值,事实以表为准;调参须回写本条】 · info_mask=hide_numbers · cell_constraint=safe_nonzero · biome_tag=∅【knob 活值,同上】 · counter_item_ids=[probe_dust]【A5 定稿回填登记——D2 表值与悬空校验激活随 D2/A5 修订批同批落地;回填前为 ∅】);岩浆/冰冻无 MVP 行(垂直切片随关卡解锁建行,建行批随批配 ≥1 反制道具——a5_aux_items 框架内容契约)
|
||||
load_bearing_rule: 生成期布置约束——雾区只能布置在非 0 安全格(区内无雷、无 0 格,A1 生成期强制);"雾区无雷"为玩家可见知识(D5 教学义务);结构推论(2026-09-08 full 评审入文,同日 re-review 钉死度量):雾区厚度≤2【≡任意 3×3 窗口非全雾,非直线行程读法】、雾面积占比 f≤8d 必要上界——A1 参数域硬边界(A1 验收清单 15 项之⑫)
|
||||
zero_special_casing: 连锁/数字计数/清图/旗/价目/结算零特判——既有系统行为不感知变异状态(A2 执行逻辑无变异分支;A4 Rule 3 的推论)
|
||||
rule4_exemption: 定义表非进度成长表,键 = variant_id,进度语义承载于 unlock_level 列(D2 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 连锁停止;A4 夹具 variation_mask_constraint 承载)
|
||||
dangling_ref_policy: counter_item_ids 为 D2 首个引用型字段——**首引已由 A5 定稿(probe_dust,2026-09-14 A5 GDD)**:悬空校验激活 + 表值回填同批(D2 修订批;条件性夹具 a5_dangling_counter 登记 A5 GDD AC-13——A4 测试口径"首个道具 id 回填时补校验"条款即 A5-1 义务,闭环)
|
||||
fog_ap_note: (2026-09-08 full 评审改两态;同日 re-review 改增量构成)雾不改 AP 价目但改清图预算构成,雾格 AP 成本两态——链可达雾格(邻非雾 0 格)免费链开、链不可达雾格全价 dig_ap_cost;雾致预算增量 = 链不可达雾格数 × dig_ap_cost,计入清图总预算需求参与 A1 BoardGenTable 设计期核算(原"≤ 轮数上限 × ap_per_round"不等式作废——"轮数上限"无定义;lean 版"全价结算"表述作废);A3 F1 条款 5 对账 = 三腿入账非消解:雷险腿消解(雾区无雷无 50/50)+ 信息腿双向净效应(雾边寂静减项 × 雾边推理锚增项,禁单向补偿)+ AP 腿(链不可达全价抬高清图成本)——B1 条款 5 强制检查点输入,雾板/无雾板两态验算 + 两条方向性护栏(雾板净当量优势带上界·防福利 / 防钓鱼·对账 A3 OQ6)
|
||||
pricing_constraints: B4 三条定价硬约束(2026-09-08 re-review 定稿三条)——① 雾内奖励档位下界 ≥ 最低档安全格 buff 当量(反淹没下界,per-AP 平价归 B1/B4 对账)② 清图奖励锚随雾成本负担上浮(链不可达同分母,防面积/成本分母脱钩)③ 雾板净当量优势带上界(防福利)——B4 GDD 验收项
|
||||
referenced_by: [A1, A2, A5, B1, B4, C3, D1, D5]
|
||||
|
||||
- name: variant_pool_gate
|
||||
type: formula
|
||||
owner: design/gdd/a4-terrain-variation.md
|
||||
attributes:
|
||||
variables: [unlock_level, level_index, biome_tag, board_biome]
|
||||
rule: pool = {v ∈ VariationTable | unlock_level ≤ level_index ∧ (biome_tag=∅ ∨ biome_tag ∩ board_biome ≠ ∅)};直接整数比较(无 D2 R1 floor);∅ = 通配语义
|
||||
output_range: pool 集合(MVP ≤1);空池合法——A1 静默布置普通图,不报错
|
||||
board_biome_type: StringSet(值域与来源归 A1 BoardGenTable biome 字段;非空为 F1 输入前提——域校验登记 A1 验收⑮,fail-fast 闭合)
|
||||
downstream: A1 布置候选池门控(A1 验收清单 15 项之首——2026-09-08 full 评审由 11 项扩容,清单已登记 systems-index 门禁记录);多变异选取须消费 board_gen 流(回放确定性)
|
||||
referenced_by: [A1]
|
||||
|
||||
- name: status_effect
|
||||
type: schema_data
|
||||
owner: design/gdd/b3-status-effect.md
|
||||
attributes:
|
||||
table: StatusEffectTable(D2 承载,键 = effect_id;B3 回填 owner,2026-09-08 定稿回填)
|
||||
fields:
|
||||
effect_id: String 主键唯一
|
||||
display_name: String
|
||||
target_side: enum {hero, enemy}
|
||||
magnitude: int——percent ∈ [-100,100] ∧ ≠0 | flat ≥ 1(跨字段校验)
|
||||
unit: enum {percent, flat}
|
||||
duration_settlements: int [1,99]
|
||||
stack_policy: enum {stack, refresh, independent}
|
||||
max_stack: int [1,16](仅 stack 消费——refresh/independent 行内容约定恒 1,非校验项)
|
||||
mvp_content:
|
||||
attack_up: { display_name: 增伤, target_side: hero, magnitude: "+50 percent", duration_settlements: 1, max_stack: 2, stack_policy: stack, source_class: safe_cell } # 2026-09-11 两级奖励批 D=2→1(当次结算语义)
|
||||
defense_up: { display_name: 减伤, target_side: hero, magnitude: "-30 percent", duration_settlements: 1, max_stack: 2, stack_policy: stack, source_class: safe_cell } # 2026-09-11 两级奖励批 D=2→1;2026-09-13 减伤墙批 −50→−30(叠满两层 −60 帽——C3 投值,B3/registry 2026-09-14 接口漂移批回写落地)
|
||||
ambush: { display_name: 伏击(敌方增益), target_side: enemy, magnitude: "+3 flat", duration_settlements: 1, max_stack: 16, stack_policy: stack, source_class: mine_hit }
|
||||
weaken: { display_name: 削弱(标中旗 debuff), target_side: enemy, magnitude: "-65 percent", duration_settlements: 1, max_stack: 16, stack_policy: stack, source_class: flag_hit }
|
||||
value_status: 四行值全部 provisional,验收锚——weaken→A3 F1 条款 2(B4/B1)· ambush 量纲→B2(条款 3,**量纲已定稿见 ambush_unit_definition**)· 对照表→B1(条款 1)· **weaken 已按 B1 F0 裁决修订 −25→−65(2026-09-10,值域 [60,85]、终值共裁 B1 OQ2——见 anchor_warning 回执)**
|
||||
ambush_unit_definition: **量纲已定稿(2026-09-09 B2 GDD Rule 6/F2——registry OQ2 关闭条件兑现)**:+3 flat = 每层伏击为每次攻击类行为(attack/heavy)附加 3 点主角 HP 伤害(后置加法、不进倍乘);charge 拍零兑付(空拍蒸发);值仍 provisional(锚验收归 B4/B1——A3 F1 条款 3;B2 供给 cap 表值与单结算自然边界口径见 clause3_supply 条目)
|
||||
anchor_warning: weaken 行 vs A3 F1 条款 2 锚两独立线性代理同向预检不过(百分点·结算暴露 25 vs 100;原型战斗量级 ≈1 vs ≈4 当量)——B1 对照验收优先裁决,登记 B1 强制检查点输入。**修复空间不对称(2026-09-09 增补)**:每结算瞬时当量归一 m_w≥51 可行(F2 越域界随移 AP 界 −408%/表界 −816%);每 AP 总暴露归一 m_w>100 被 percent ∈ [-100,100] 域禁止(该分支不可行)——OQ1 前置步骤:B1 先钉死归一口径,口径落定前禁止数值修订;落总暴露则现实解 = B4 重定最低档参照。**参照对象迁移注记(2026-09-09 B4 评审;2026-09-11 回迁)**:最低档安全格 buff 当量的参照对象曾迁 defense_up 当量(attack_up 时为死行——B4 F4 迁移)——**2026-09-11 用户裁决"基础攻击恒存在"(HeroTable.atk 域 [1,999]、0 加载拒绝、MVP=6)后 attack_up 复活,参照对象回迁 attack_up 当量**(消费面 = 主角战斗段先手攻击——B1 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 B1 重算批兑现(F0/F1 按 attack_up 当量重跑 + F1 锚对照实物改 attack_up 行——本迁移注记关闭)。**F0 裁决回执(2026-09-10 B1 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 B1 重算批按 C3 v3 曲线重推——原 7.2 随口径退役〕);地板 = 乘数零点 −100pp、交叉层数 = ⌈100/m_w⌉ = 2(原"7 层触地板"预读按 −400% 合成带估读,更正);defense_up 参照保持(总暴露分支的"重定参照"现实解未采纳);终值 = B4/B1 共裁(B1 OQ2);B3 GDD 正文不改以本条为准(收编先例)
|
||||
rule4_exemption: 定义表非进度成长表,键 = effect_id(D2 Rule 4 豁免,schema 注释承载)
|
||||
single_enemy_assumption: **回验结果 = 不成立——B2 定多敌(用户 2026-09-09 拍板;同日 B2 GDD 兑现 B3 预授权接口漂移条款)**:MVP 战斗 = 1–3 个同敌种敌单位(EnemyTable.unit_count);效果 side-wide 语义改"全体存活敌单位"(层数 = side 共享池,**B3 现接口零变更兼容**);target_ref(单体寻址)= 扩展位义务——首个单体效果上线时 B3 补列(随批:B1 归集语义/D1 呈现裁决);B3 GDD 正文不改,以本条为准(A3 OQ5 收编先例)
|
||||
mechanics: 战斗域统一状态容器(三向效果同构实例)· 单一时限量纲 remaining_settlements(先兑付后衰减,每轮结算 −1,dur=1=一次性;跨轮跨图延续、battle_over 全清不跨战斗)· 按行叠层(stack 授予不触碰 R;refresh 重置取实例授予时快照 D;合并在授予时、结算作用顺序归 B1——两序分离)· 满层授予拒绝原子(false+容器零写)· 合成 = L×m 加算、percent 越域不 clamp(地板/换算归 B1 SettlementTable)· 授予集中在 B1 结算编排(A2/B4 零直接接口)· 零随机(无 RNG 流消费)· 零信号外发(纯被动容器)
|
||||
api: notify_battle_start / apply_effect(effect_id, source) -> bool / query_active(side) -> Array(插入序;六归因字段+display_name+授予时快照投影)/ decay_round() -> int / notify_battle_end() -> bool——B1 消费契约,provisional 登记
|
||||
b1_obligations: 八项(B1 GDD 门禁评审缺项即 blocking)——① 同轮多授予按确定次序调用 ② 事实→授予恰一次转化(B3 不去重)③ percent→乘数换算方向与合成值地板成文 ④ 最后一轮 decay 判定 ⑤ F1 条款 1 效果档位对照表以 B3 实例为对照实物 ⑥ 每结算编排恰一次 decay_round(2026-09-09 增——decay 基数=1 先决条件)⑦ 结算明细按授予流水逐条标注来源(合并坍缩归因补偿,2026-09-09 增)⑧ “溢出未生效”行进结算明细协议(Rule 5 后半承载,2026-09-09 增)。**履行回执(2026-09-10)**:八项已全数落位 B1 GDD(Core Rules 3/5/8/10/11 + Formulas F0–F2——落位映射 = b1 AC 覆盖矩阵"上游义务 23 条"行;③的 AP/表界数值随 F0 修订更新为 −520%/−1040%)
|
||||
presentation_obligations: (2026-09-09 登记 systems-index,缺项即 blocking)D1×4——HUD 常显+EC12 空态规格定稿 / effect_id→icon 映射键契约(形状+色相双通道)/ 有利有害极性呈现映射(数据源 = B1 SettlementTable 效果语义,非 magnitude 符号)/ 全清状态栏去留;B5×2——溢出行呈现 / origin_cell→玩家可读形态(缩略图/格子高亮);D5——“同轮拿满优于跨轮叠”教学(OQ7 配套);B4——奖励身份预读(创意风险 #1 切面)
|
||||
ownership_note: A3 OQ5“标中旗 debuff 档位归 B4 表设计”经用户 2026-09-08 拍板收编——四行初值定稿权归 B3,锚验收权仍归 B4/B1,修订走接口漂移回写本条
|
||||
dangling_ref_policy: effect_id 悬空校验**已激活**(2026-09-09 B4 RewardTable 首个 effect_id 引用行〔defense_up〕回填——dangling_ref_policy"首个引用字段 owner 补"条款兑现;条件性夹具 = B4 b4_dangling_effect〔AC-17〕)
|
||||
referenced_by: [B1, B4, B2, D1, D5, B5]
|
||||
|
||||
- name: board_gen_table
|
||||
type: schema_data
|
||||
owner: design/gdd/a1-board-generation.md
|
||||
attributes:
|
||||
table: BoardGenTable(D2 承载,键 (level_index, node_depth) + depth-0 锚行——首个进度键表;A1 回填 owner,2026-09-09 定稿回填;第三轴登记约定〔B7 修订〕——Boss 图 = 各 level Dmax 行、elite_/boss_ 字段命名空间预留、C1/C3 定稿强制重审 OQ6,改键退路 = D2 Rule 4 接口漂移通道)
|
||||
fields: board_width/board_height(int [8,64],knob)/ mine_density(float (0,0.5],knob——雷量参数形态=密度浮点,尺寸解耦;布雷数下限 round(d×(W×H−9)) ≥ 1,R3 修订)/ inferability_target(float **[0.85,1]**,knob——P1 门槛承重参数+绝对锚,B1 修订收窄)/ solver_rules(enum single|single_subset,**冻结 single_subset**——推理定义域非调参)/ min_safe_count(int [1,999],knob——A3 EC5 退化板对冲)/ max_gen_attempts(int [1,32],knob)/ fog_region_count(int [0,32],knob)/ fog_target_ratio(float [0,1),knob——**≤ min(8d, 0.25) 绝对上限,B1 修订**)/ board_biome(StringSet **非空**,域校验致命——A4⑮;词表 owner 未定稿前只校验非空)+ elite_/boss_ 前缀字段命名空间预留(非 knob,B7——语义归 C1/C3)
|
||||
cross_field_validation: fog_domain_ok(F2 规范形——count=0⇔ratio=0 或 0<ratio≤min(8×density, **0.25 雾占比绝对上限,B1 修订**)∧<1,加载期致命)+ min_safe_feasible(F2b——W×H−round(density×(W×H−9))≥min_safe_count,sound 保守〔B3 修订补论证:N=round(d×(W×H−9)) 先定数+先布后删只减不增〕,计数可行≠连通可行)+ 布雷数下限(round(d×(W×H−9)) ≥ 1,R3)+ cost_feasible(F2c——max_gen_attempts×W×H ≤ 16384 provisional,正式值归 OQ2 ADR;运行期禁墙钟时间逃生,B8)——A4⑩ 参数域化
|
||||
mechanics: 五阶段确定性管线(参数解析→布雷→变异布置→生成-验证循环→产出上报;顺序冻结,先雷后雾;**布雷取整与落位钉死,B3 修订——N=round(d×(W×H−9)) 先定数,先布后删〔环内雷移除、只减不增、无迭代〕**)· inferability = **免赌开据占比**(F1:初始展开∪连锁∪推导开据三通道;合法信息源穷举{数字约束(a),雾元知识(b)}——新增信息源=GDD 修订;次序无关不变式;metric_version=1 防实现漂移)· **达标须两项判据同时满足(B1 修订):inferability 与 inferability_core(剔除雾格后的可推理率 |R∞∖F|÷max(1,|S∖F|))各 ≥ target——防止"雾区无雷"知识单独撑线**· clearable 合法性闸(清图可达性与质量度量两闸分离)· 验收算子三分支(达标即出 k*/接受最优+强告警 k**/**零合法→接受最不坏+非法产物标记 k***——用户 2026-09-09 定稿,玩家永不卡死,F4 断言 A′ 批量守红线;EC5 玩家侧体验债已登记 B1/D1 域**)· 重试不重开 scope(attempt 边界=生成函数完整返回——D3 快照切点契约)· 生成期表值单次读取(防热重载撕裂 attempt)
|
||||
metrics: 生成期指标集八项 = 实际 inferability(metric_version)/inferability_core(剔除雾格后的可推理率,B1)/实际雾占比(=|F|÷(W×H))/实际雷数与实际 |S|(B3——先布后删漂移观测,|M|≤N)/fog_burden_ratio/Δbudget_fog/attempts_used/降级标记(shortfall+非法产物);fog_burden_ratio=|U|÷max(1,|S∖Chain₀|)(付费格分母)——**B1 条款 5 对账精确口径**
|
||||
batch_assertions: F4 调参期(N=256/行默认,σ(L,D)=10^9+2^20·L+2^12·D——R4 修订防碰撞,版本库清单)——断言 A 可推理率**严格零**(B1 修订:inferability 与 core 两项判据对照)/A″ target ≥ 0.85 绝对下限(B1)/A′ 非法产物零容忍/**B 达成区数=count 板占比 ≥ 0.95(B6 修订收紧——承载 A4⑭ 出现率下限+降级率上限两件套)**/B′ 无雾行零雾(泄漏=bug)/E 难度方向 advisory(R2,monotone_in_depth 标记字段);报告 C 按行 p10/p50/p90
|
||||
inferability_vs_p_safe: "inferability 是盘面级免赌占比(生成侧);P(安全) 是单格认知概率(决策侧、经济口径)——免赌集内 P(安全)≡1(含雾格),风险收缩到残余集(占比 ≤1−inferability);inferability 是 P(安全) 的生成端结构性上界代理之占比形式,非同义词。B1 条款 3 对账输入 = **actuals 分布 p10(F4 报告 C)而非 target 参数**"。**B1 消费回执(2026-09-10)**:条款③闭合消费本条口径——P(安全) 代理式 = 残余盲猜端上界 P(雷) = |M|÷(|M|+(1−ι)×|S|)(ι = actuals p10,未交付前行 target 代乐观代理);对账重跑义务 = A1 报告 C 交付后强制(B1 AC-39)"
|
||||
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/雾1区0.10)参考行——**全部 provisional,仅 schema 自洽性证明,曲线数值归 C3 调参所有权**
|
||||
a4_acceptance_mapping: A4×15 验收清单逐项落位表在 a1 GDD Dependencies 节(A1 门禁评审逐项核对,缺项即 blocking)
|
||||
a2_dual_containment: 双包含回验登记 A2 GDD——① A2 实际展开域 ⊆ A1 排除域(既有)② A1 求解器初始态 ⊆ A2 实际初始展开域(F1 注记④度量保真对偶)
|
||||
golden_vectors: 推理器黄金图回归向量协议(五类手工核验小板,整数对比对禁浮点容差,逐格信息源推导记录入版本库;含雾板另登记 (|R∞∖F|,|S∖F|) core 整数对——B1,由既有坐标规格派生不重制;换 solver_rules/信息源/metric_version = GDD 修订 + 向量重制)——D2 R2 先例同源
|
||||
referenced_by: [A2, B1, B4, C3, D3]
|
||||
|
||||
- name: a2_event_surface
|
||||
type: schema_data
|
||||
owner: design/gdd/a2-minesweeper-rules.md
|
||||
attributes:
|
||||
kind: 三事件回边契约(发射面封闭——TD-SYSTEM-BOUNDARY 回边裁决的 A2 侧定稿;增删事件 = 接口漂移修订)
|
||||
cell_revealed: "{cell, kind ∈ {safe, mine}, digit【仅 kind=safe 携带、恒真透传含雾格——呈现隐藏归 D1,判定源 = variant_ids,A2×4③】, variant_ids, channel ∈ {initial, chain, dig}, reward_eligible【initial 恒 false / chain·dig ∧ safe 恒 true(含链开雾格)/ mine 恒 false】}"
|
||||
flag_judged: "{cell, hit = [cell ∈ M]}×N——轮末统一判定批(基线 = 轮次结束事务开始时旗位,被拔不判;行主序枚举);A2 诚实重复上报、兑付去重归 B1/B4(资格以雷格实例为键——action_economy.flag_rules/A3 OQ5)"
|
||||
round_end: "{path_tag ∈ {ap_exhausted, cleared}, continuation_hint}——棋盘路径由 A2 外发、核心字段逐字段取自 A3.last_round_end(读取权 = 接口契约),与 A3 stopped 路径 payload 同构;stopped 由 A3 直发、A2 禁双发(action_economy.round_end_carrier 双发射源)"
|
||||
event_order: 同一轮次结束事务内 flag_judged ×N 先于 round_end(全路径统一——stop 腿 A2 先发旗判定再委托 request_stop,停手不改旗故基线等价);B1 结算触发 = Waiting 相位编排点、不依赖事件到达序(B1×3 强制项之一,systems-index A2 门禁块)
|
||||
zero_random: A2 零 RNG 流消费——同板同意图序列 ⇒ 事件流逐位确定(AC-19);cell_revealed 发射序 = 规范序(初始/连锁 = 触发格 BFS、8 邻行主序)
|
||||
api_surface: install_board / settle_batch(D1 唯一提交入口;stop 经此委托 A3.request_stop——D1×6① 强制项:不直调 A3,A3 Rule 9 调用方细化、A3 GDD 不改以本条为准)/ try_dig·try_flag_place·try_flag_pull·try_move / compute_move_path(D1 路径预览数据源)/ 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(A2 OQ2)
|
||||
referenced_by: [B1, B4, D1, D4, D5]
|
||||
|
||||
- name: a2_initial_expansion
|
||||
type: formula
|
||||
owner: design/gdd/a2-minesweeper-rules.md
|
||||
attributes:
|
||||
rule: O₀ = R₀ = 出生 3×3 ∪ 0 格 flood 闭包(与 A1 F1 求解器初始态同算子同值——运行期镜像,显式不含外扩 1 环);执行时点 = install_board 事务内一次(板级一次跨轮不重放)
|
||||
properties: 免费(零 try_spend)· 计入清图进度 · 无奖励(channel=initial、reward_eligible=false——game-concept 定稿;B1×3 强制项:不入奖励库)· 永不触雷(R₀ ∩ M = ∅ 为 A2 侧定理)触雾(A1 排除域 + install 不变式②)
|
||||
dual_containment_resolution: 双包含两臂在 A2 定稿下**构造性成立**——臂① R₀ ⊆ A1 排除域(子项关系)· 臂② A1 求解器初始态 = R₀(**恰等**)⇒ A1 回退口径(出生 3×3 最小态)不触发、度量保真零降级(board_gen_table.a2_dual_containment 的兑现回执)
|
||||
install_invariants: 四条结构不变式 fail-fast(B3 无雷 / B3∪R₀ 无变异 / 数字恒真 / **R₀ ≠ S 清图退化板拒绝**——非 A1 clearable 闸复验,A2 状态机良构性守卫);诊断类别封闭枚举 {inv1_mine_in_spawn, inv2a_variant_in_spawn, inv2b_variant_in_r0, inv3_digit_invariant, inv4_r0_equals_s}(2026-09-09 评审补)
|
||||
degenerate_gap: **A1 修订义务(2026-09-09 登记,systems-index A2 门禁块)**——反例 B(8×8 八雷先布后删幸存距离-2 雷 → 最终板全 0 格连通 → R₀=S 开局免费清图)与 N=1 行 100% 退化,证明 A1 布雷数下限必要不充分、F4 断言 A(inferability=1.0)零拦截:义务 = A1 F5 legality 增 R₀≠S(违例 = 尝试作废重试)+ F4 断言严格零覆盖 + Rule 4 排除域基准措辞钉死"以最终产物板计";A2 侧不变式④为纵深防御
|
||||
drift_red_lines: 实现期红线——0 格判定读真实数字禁显示值 · 初始展开禁加外扩环/禁只开 3×3 · clears_map ≡ cleared 单一实现禁第二套 · chain_size 不含首格、链不开雷、含链开雾格、**链不越旗**(运行期传播集 = N₈∩S∖G——2026-09-09 评审 GD-1 定稿,G=∅ 域与 A1 算子①逐字同构、双包含不受影响)· A1 R₀/算子修订 = metric_version 跳变 + 本条同步修订
|
||||
referenced_by: [A1, B1, C3]
|
||||
|
||||
- name: terminology
|
||||
type: glossary
|
||||
owner: design/gdd/a2-minesweeper-rules.md(各词条以首次定义 GDD 为 owner)
|
||||
attributes:
|
||||
purpose: CLAUDE.md 用语纪律(2026-09-09)的登记通道——项目内生术语的白话定义集中地,GDD 首次出现处须附同款定义
|
||||
terms:
|
||||
双包含回验: A1 与 A2 互检两条包含关系——臂① A2 实际初始展开域 ⊆ A1 生成期排除域(开局不触雷不触变异);臂② A1 求解器初始可见态 ⊆ A2 实际初始展开域(A1 度量不吃亏)
|
||||
恰等: 两集合逐格相等(不多开不少开)
|
||||
零特判: 代码不为变异写任何 if 分支——变异只是随格只读标记透传,行为差异由生成端约束保证
|
||||
规范序: 事件发射的固定顺序(触发格 BFS、8 邻行主序),同输入必得同顺序
|
||||
语义序仲裁: 批次内不按提交顺序、按"清图挖 > 停手 > 其余"固定类别顺序结算
|
||||
双发射源: round_end 有两个合法发射者——棋盘路径由 A2 发、停手路径由 A3 直发,payload 同构
|
||||
三源拒绝: 拒绝原因三互异来源——棋盘面 board_face / 资源面 resource_face(AP 不足)/ 相位 phase(非 Active)
|
||||
单意图批: settle_batch 只装一个意图 ≡ 直接调 try_dig 等便捷 API,行为逐项相同
|
||||
作废(voided): 轮次结束后未获执行的批次意图——零棋盘效果、零扣费、零事件,区别于非法拒绝
|
||||
连锁不越旗: 连锁展开不经过插旗格(旗格不入链、不作传播源——2026-09-09 评审 GD-1 定稿,经典 flood 惯例)
|
||||
行为环: 敌种出招的固定顺序表(如攻击→蓄力→重击),按结算轮转、环尾回环首——零随机、可学习(B2 首次定义)
|
||||
拍: 行为环里的一格行动("这一拍是重击")——B2 首次定义
|
||||
同步轮转: 同种敌人永远处于同一拍,任何死亡时序都不会让幸存者乱拍(B2 F1 定理)
|
||||
伏击池: 敌方侧共享的伏击层数——本轮踩几颗雷就几层,轮末清零(side-wide 语义,B2 首次定义)
|
||||
溢出(伏击): 单轮踩雷超过上限(cap)的部分——转为"溢出未生效"明细行可见、不生效(B2 首次定义)
|
||||
死亡即不动手: 轮到某敌人行动时它已死 → 这一下不打、招式轮转停格(2026-09-09 用户拍板,B2 首次定义)
|
||||
资格格: 开出时 reward_eligible=true 的格——A2 事件面上 chain/dig 通道的安全格(含链开雾格);install 期可精确枚举为 S∖R₀(B4 首次定义,F1 消费)
|
||||
刀: 伤害道具(damage_item)的项目行话,全文同义(B4 Rule 5 首次定义);"烧刀/烧包" = 把无法生效的道具白白消耗掉(选定即承诺的成本,B4 E10/E12 语境)
|
||||
批尾: 同一批取号中最后消费的一个号——B4 清图奖励身份 = install 批的批尾取号(B4 F1 首次定义)
|
||||
死行: 被当前内容态判定为零消费的表行——加载不致命、不入参考池,复活走 GDD 修订连锁(B4 F4 首次定义;历史首例 attack_up〔hero atk=0 时代〕已于 2026-09-11 随"基础攻击恒存在"用户裁决复活,当前内容态暂无在册死行)
|
||||
档位序检查: 雾池最低活档 ≥ 最低活 buff 档的序数比较(原"档位序代理"更名,B4 AC-19)——tier 与当量零耦合,仅序数健全性、非当量保证(B4 F2 注记)
|
||||
预推进: 测试中为到达 scope=σ 而先行丢弃式消费 σ 个 scope 的构造——RngService 全新实例首个 open_stream 恒为 scope 0,derive_at 不推计数器(B4 AC 前言首次定义)
|
||||
完美排雷(perfect_sweep): 板级零误标(flag_judged hit=false=0)∧ ≥1 标中 → 清图奖励当量 ×P_perfect(默认 ×2)——与踩雷正交(盲挖踩雷不破坏、标错才破坏)、全有或全无谓词无部分档、板级计数随 install 重置(B1 Core Rule 13 首次定义)
|
||||
当量: 统一价值单位,1 当量 = 1 点主角 HP 的期望净变化——四源收益单一线性换算的通货(B1 F1 首次定义)
|
||||
乘区: 伤害公式里相乘的修正段(本作两段:hero 减伤池 × 敌方削弱池——池内加算、clamp [−100,+100]pp、池间乘算、floor 取整)(B1 F2 首次定义)
|
||||
溢杀: 一刀超出目标剩余 HP 的部分——丢弃、不转移、无负 hp 中间态(B1 F3 首次定义)
|
||||
免伤轮: 主角该结算承伤为 0 的结算——percent 池地板(−100pp → 乘数 0)的自然结果;现行值链可达路径 = weaken 饱和(敌侧单结算零输出),defense_up 叠满 = 0.4×(−30×2 帽)不再单侧触地板(B1 F2 首次定义;原"defense_up 顶点 −100% 恰在地板边界"例随减伤墙批退役——2026-09-14 B3 接口漂移批同步)
|
||||
图标键(icon key): "哪个数据行配哪枚图标"的固定对照——数据表主键(effect_id/reward_id/cell_type/enemy_id)直接作图标键,一键一专属纹样、映射全局恒定禁运行时换图(art-bible §4.6 首次定义,2026-09-13 冻结)
|
||||
徽章(badge): 画在格子上的身份附属小图标(类型/奖励身份预读)——绘制优先级栈位在旗之下、变异纹理之上,不构成格内第二焦点(art-bible §4.6 首次定义;栈位声明源 = proposal-reward-polarity §0)
|
||||
极性(polarity): 同一类型兑付的正负方向——正 = 收益侧、负 = 代价侧,行为×格型→符号矩阵见极性提案 R2;视觉通道冻结 = 金族(有利)对红族(有害)+ 满框对缺框(art-bible §4.6 首次冻结视觉侧)
|
||||
命令式回执驱动: 动作调用返回后组合根立刻重查一次只读面来刷新界面、不等通知信号——旗插拔/移动/AP·RAP 读数/状态/库存五类动作零事件外发或零推送,呈现层刷新由此承载(D1 首次定义;ADR-0001 订阅纪律的配对形态)
|
||||
程序化占位: 用代码按冻结色板与形状规则直接画出的临时图形——参数取自 art-bible §4.1/§3 参数域、icon 按 §4.6 键位映射表挂槽,终稿美术到位后原位替换、数据层零改动(D1 首次定义;样张未定稿不阻塞呈现层开工的承载形态,占位同样受 §1.4 数字可读性第一验收项约束)
|
||||
叠加层(overlay): A5 自持的板级派生信息集(显影/真视/预读三集)——只改"玩家能看见什么"不改棋盘事实,零回写 A2/B4 状态、随图消亡(A5 首次定义)
|
||||
真视窄域护栏: 替代推理的道具效果(雷位真视)目标域 ≤3×3、全图级仅限恢复推理原料类(显影/预读)——信息层级护栏,防"扫雷退化为路径优化"(A5 Core Rule 3 首次定义,schema 校验强制)
|
||||
渗透率: aux 道具期望件数占奖励池的份额——E[N_aux/板] = |U|×Σw_aux/W_total(A5 F1 首次定义;供给面天然限流,P1 护栏的量化形态)
|
||||
行动: 轮次内挖掘期的原子决策单位——同一事件的三个视角:玩家决策层叫行动、进 A2 的数据形态叫意图(单意图帧整批提交)、A3 计价类别叫动作(action_kind 统一价目);有价行动(挖/插旗/拔旗)1 AP/次、受每轮 AP 预算约束(现行表值 8),移动/停手免费不计 AP(game-concept 术语层级 2026-09-14 收录)
|
||||
节点: 关卡节点地图上的一个格——关卡内移动的步进单位;层名定稿(2026-09-14 用户裁决:节点 胜 遭遇——成员中立 + C1 注册名/切片 node_* 接口零改动 + 遭遇既有语义 = 战斗不挪用);节点类型分类学与分支机制归 C1 GDD 展开
|
||||
遭遇: 一次完整战斗事件的同义词——战斗节点触发的那一场仗(既有用法:B1"两场遭遇" / D1"双敌种遭遇""Boss 遭遇变体");不作地图层名(2026-09-14 裁决)
|
||||
节点奖励: 奖励点节点给的奖励(C1 域)——与安全格奖励(B4,格内开出)区分;节点奖励覆盖层 = 未来 spec design/ux/node-reward.md(battle.md OQ9)——三个"reward"各归各位(2026-09-14 拆名注记)
|
||||
HP 账本: 冒险域主角血量的唯一记录——C2 持有,每战开始交出、战斗结束收回、恢复点与大奖励入账;关卡切换血条不清零(C2 首次定义;跨战斗 HP 持久性归 C1/C2 已锁事实的 C2 半边兑现)
|
||||
关卡收束点: 一关就此定局的时点——Boss 战胜利(通关)或英雄死亡(失败);C1 在收束点先调 B1 关卡清库、再向 C2 宣布关卡结束与结果(C2 首次定义;切片 level_runner 先例转正)
|
||||
关卡大奖励: 清完一关、进入下一关前的一次性兑付——上限提升 + 血回满 + 代币记账三件构成,不进背包不占库存域;末关通关不兑付(C2 首次定义;game-concept"冒险内大奖励"的落地形态)
|
||||
referenced_by: [A2, B2, B4, B1, D1, A5, art-bible, game-concept, C1, C2]
|
||||
|
||||
- name: enemy
|
||||
type: schema_data
|
||||
owner: design/gdd/b2-enemy-system.md
|
||||
attributes:
|
||||
table: EnemyTable(D2 承载,键 (level_index, node_depth, enemy_id);B2 回填 owner,2026-09-09 定稿回填——进度键 floor(D2 R1)+ 实体键精确匹配)
|
||||
fields:
|
||||
enemy_id: String(行集内主键;意图视觉映射键——视觉推测型 D1×4①)
|
||||
display_name: String(本地化归 D6)
|
||||
unit_count: int [1,3](knob——**遭遇区间下界**〔2026-09-14 C3 修订批:unit_count 升级区间语义 [unit_count, unit_count_max],B1.begin_battle 实例化期经 RngService encounter 封闭流均匀骰;新敌种首遇/教学位节点固定不加骰〕;默认 1 provisional,多敌语义默认零消费者复验归 C1〔B2 OQ2〕)
|
||||
unit_count_max: int [unit_count, 3] 可省略(2026-09-14 C3 修订批新增——遭遇区间上界;缺省 = 定值,旧行零迁移)
|
||||
atk_min/atk_max: 可选配对 int [0,999](2026-09-14 敌方攻击区间批——上阶/下阶区间随机;缺省 = 定值行向后兼容;跨字段:必成对 · **atk = (min+max)/2 中点锚**;roll 时机 = 遭遇骰同流〔encounter 恰一 scope,数量骰先、atk 骰后〕spawn 期**整战持久**〔每拍抖动否决——数字可读性锚〕,B1.begin_battle roll → B2.spawn enemy_atk_override 收确定值〔B2 零随机纪律保持〕;MVP 六行 ±3 provisional 归 C3;验收 = 完美策略档 0 加成通关 ≤40%〔OQ7〕;接口漂移 = B2.spawn 签名 +1 参数〔正式侧 GDD/registry 修订批随 ADR-0009 同批〕)
|
||||
armor_type: enum {none, a, b} 缺省 none(2026-09-14 护甲克制批转正登记——伤害类型 × 护甲克制,克制矩阵 = settlement_table.armor_effectiveness〔特化 ×150 / 无甲 ×100 / 对位 ×50〕;MVP 映射 goblin=none / bugbear=a / ogre_chief=b;数值 provisional 归 C3)
|
||||
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 拍敌种不消费——非校验项,B3 max_stack 先例;MVP 2 provisional)
|
||||
pattern: StringList(行为环;元素 ∈ {attack, charge, heavy} MVP 校验域——guard/boost/hinder/summon 预留值校验拒绝〔A1 solver_rules 冻结先例〕;环长 [1,8])
|
||||
advantage_per_round_cap: int [0,16](knob;**MVP 默认 4 定稿**〔2026-09-09——反灾难护栏定位,旧默认 8 溢出协议死码已废弃〕;0 = 免疫伏击合法极端;A3 F1 条款 3 供给表值来源字段)
|
||||
rowset_rule: 每行集恰一敌种(行集内 enemy_id 唯一 = 表结构校验,违规加载期致命)——多敌种同深度选择规则归 C1/C3(provisional);精英/Boss 编码位预登记 B2 OQ7(键冻结下同深度第二敌种行触发行集致命——改键走 D2 Rule 4 接口漂移,C1 定稿时强制核对)
|
||||
mvp_content: **恰 3 敌种(2026-09-14 C3 修订批转正——DND 更名批用户指令:grub→goblin / ambusher→bugbear / boss_guardian→ogre_chief;旧两敌种登记由本条替代;B2 AC-16③ 物种集断言随批更新为 {goblin, bugbear, ogre_chief})**:goblin(地精,[attack] 单拍环——L1 D0 24hp/7atk ×[1,2] 教学位固定 ×1、L1 D1 群 13/5 ×[2,3];armor=none)· bugbear(熊地精,[attack,charge,heavy] 三拍环——L1 D2 40/9 ×1、L1 D3 群 18/6 ×[2,3]、L2 D0 锚行 30/7;armor=a)· ogre_chief(食人魔酋长,[attack,attack,charge,heavy] 四拍 Boss 环——L1 D4 150/9 ×1;armor=b);heavy_multiplier=2 全员;出处 = 切片 enemy.tres v3(试玩批次 1 裁决 + 遭遇随机化批),曲线数值归 C3
|
||||
load_bearing_rules: 多敌模型(1–3 同敌种单位,B3 单敌假设回验不成立——见 status_effect.single_enemy_assumption)· 行为环确定性轮转(零随机;先作用后推进;死亡即不动手——轮到前被杀本拍不打指针冻结;同步轮转定理)· 效果 side-wide(伏击池 = side 共享,B3 零接口变更)· 行值快照抗热重载(B3 EC9 同款)· 零随机零 UI 零事件订阅(A2 事件面不含 B2——事实经 B1 转化)
|
||||
b1_obligations: 六项(B2 GDD 门禁评审缺项即 blocking)——① 推进每结算恰一次(敌单位专属——主角无环)+ 结算内调用序成文 query_attack→apply_damage→advance ② 雷→伏击恰一次转化 ③ clamp/负值/溢杀与死亡判定时机成文 ④ F1 条款 3 闭合对账(cap 表值 + 量纲 + A1 actuals p10 非 target 参数)⑤ 默认目标消费与单体/AOE 分流 ⑥ 伏击 cap 溢出"溢出未生效"明细行协议。**履行回执(2026-09-10)**:六项已全数落位 B1 GDD(Core Rules 5/6/9/10/12 + Formulas F3/F4——落位映射 = b1 AC 覆盖矩阵)
|
||||
d1_obligations: 四项(视觉推测型呈现,缺项即 blocking)——① enemy_id→图像线索映射清单成文(预告时序=下一拍预告、挖掘期全程可见;含强度档位/环长直觉编码说明;形状+色相双通道)② 映射全局恒定(enemy_id 键——跨 run 禁重掷)③ 顺位与存活可读 ④ 敌方 side 池呈现口径
|
||||
rule4_status: 本表是进度成长表(A1 BoardGenTable 同型,无 Rule 4 豁免)
|
||||
referenced_by: [B1, B4, C1, C3, D1, B5, D5]
|
||||
|
||||
- name: hero
|
||||
type: schema_data
|
||||
owner: design/gdd/b2-enemy-system.md
|
||||
attributes:
|
||||
table: HeroTable(D2 新增 schema 行〔接口漂移回写,2026-09-09 B2〕,单行全局;B2 回填 owner)
|
||||
fields:
|
||||
max_hp: int [1,999](knob;MVP 值 provisional 出处待查)
|
||||
atk: int [1,999](**0 = 加载拒绝**——基础攻击恒存在,"0 基线 × 百分比增益恒零"死锁自 schema 层杜绝〔2026-09-11 用户裁决,原"机制开关 MVP=0、激活裁决归 B4/B1"作废〕;MVP = 6 原型锚 provisional 归 C3;消费面 = 主角战斗段先手攻击——B1 GDD 2026-09-11 增补)
|
||||
rule4_exemption: 单行全局定义表(主角不随关卡自动成长——成长=天赋 C4/奖励侧;ActionEconomyTable 先例)
|
||||
hp_persistence: 跨战斗 HP 持久性归 C1/C2(provisional)——B2 单位接口以初始 hp 入参,不定义冒险内持久性
|
||||
referenced_by: [B1, B4, C3]
|
||||
|
||||
- name: reward_table
|
||||
type: schema_data
|
||||
owner: design/gdd/b4-reward-item-economy.md
|
||||
attributes:
|
||||
table: RewardTable(D2 承载,键 = reward_id;B4 回填 owner,2026-09-09 定稿回填、同日 full 评审增补 display_name——含 use_timing 字段〔game-concept"使用时机"预留的兑现,MVP 单值 pre_settlement 承重,扩枚举走修订〕)
|
||||
fields:
|
||||
reward_id: String(表内主键)
|
||||
category: enum {buff, damage_item, heal_pack, instant_aoe, instant_heal}——MVP 恰五值(2026-09-11 两级奖励批两类交付轴:即时类 {buff, instant_aoe, instant_heal} 当场兑付不进库存 / 可选类 {damage_item, heal_pack} 入库存走窗口),预留值(resource/aux_item 等)校验拒绝 fail-fast # was: {buff, damage_item, heal_pack} 三值 before 2026-09-12
|
||||
effect_id: String 可空——buff 类必填(StatusEffectTable 精确引用,悬空校验已激活);非 buff 类恒空
|
||||
display_name: String 非空——玩家可读名(D1 呈现数据源,本地化归 D6;2026-09-09 评审增补,B2/B3 同库惯例)
|
||||
power: int [0, 999](knob)——item 类加载校验 ≥ 1;buff 类不消费非校验(B2 heavy_multiplier 先例)
|
||||
power_min/power_max: 可选配对 int [1,999](2026-09-14 伤害量值区间批——上阶/下阶区间随机;缺省 = 定值行向后兼容〔armor_type 先例〕;跨字段:必成对 · buff 行禁止 · **power = (min+max)/2 中点锚**〔A3 条款①期望当量不漂移〕;roll 时机 = 身份预分配批内追加取号〔既有取号序零扰动〕,快照 E14 授予时口径不变、B1/呈现零改动)
|
||||
weight: int [0, 999](knob)——0 = 该池不出此行(合法极端,取号前剔除)
|
||||
pool_tag: enum {safe_cell, active_inject, clear_default}(2026-09-14 C3 修订批增补 active_inject——供给控制器注入池〔可选类三行移出格子权重池,由 RewardSupplyController install 期注入:首件保证 + 指数递减〕;clear_<biome> 命名空间预留、校验拒绝——A1 elite_ 同款)
|
||||
tier: int [1, 8](knob)——A4 雾内档位下界约束载体
|
||||
use_timing: enum {pre_settlement}——MVP 唯一值,扩枚举走 GDD 修订
|
||||
cross_field_validation: 加载期致命族——池空(每 pool_tag × 雾/非雾两态各 ≥1 行 weight>0)· clear_default 恒正当量(≥1 活行 ∧ power≥1 ∨ effect_id 非空——A3 条款④"清图奖励>0"的行级兑现口径)· item 行 power≥1 · buff 行 effect_id 必填/非 buff 恒空 · safe_cell 活 buff 行集非空(tier_min_buff 定义前提,F1 对偶)· **floor_supply_missing(K_dmg ≥ 1 ∧ safe_cell 池无 power ≥ P_min 活刀行)· no_damage_row(K_dmg = 0 ∧ 全池零活刀行——零伤害世界后闸,B2 OQ9 并案)〔2026-09-09 评审增补,跨 RewardConfigTable 校验〕**
|
||||
mechanics: 奖励身份 install 期预分配(roll_board 恰一次、行主序、消费 reward_roll 封闭流恰一 scope 批〔格批 + 清图批尾一号 × F5 草稿数——每稿含清图一号、草稿作废连清图一号一并作废〕;Ready 后只读、无重掷 API)· 授予期零随机(身份恒定跨轮;换图映射消亡)· **库存关卡域(2026-09-11 关内延续——跨战斗/跨图延续、关卡末 clear_inventory 清空;原战斗域 battle_over 全清作废)**· **两类交付轴(2026-09-11):即时类 {buff, instant_aoe, instant_heal} 授予段当场兑付不进库存(默认根 75%)/ 可选类 {damage_item, heal_pack} 入库存走窗口(25%、更强)——category 五值枚举**· **窗口单件制(2026-09-11 拍板——至多选用一件)**· **治疗两级:instant_heal 小额即时 + heal_pack 稀缺强治疗(w 25%→6%、p 4→12)**· 道具伤害恒定表值不吃 percent 修正(2026-09-11 后 attack_up 已复活〔消费面 = 主角先手攻击〕、入池随奖励改造批——原死行口径与"锚参照迁 defense_up"注记退役;A3 条款 2 锚参照对象 = attack_up 当量)· 道具段照常消耗(选定即承诺:无存活敌的已选刀照常 Used + 零效果 + "已消耗未生效"明细行——理由 2026-09-09 评审更正为守卫所有权不对称 + 反抖动,原"敌 HP 不可见"与 B2 血条数字可读矛盾作废)· **窗口锚点 = 授予段后、增益/减益段前(2026-09-09 评审用户拍板:当轮拾取当轮可用;核心段序 buff/debuff > 道具 > 战斗不变)**· 清图槽允许 buff 行(运行时满层零兑付 = 合法例外 + "奖励未生效"行,预警④监控)· F5 保底 = 草稿-校验-提交重 roll(K_dmg=0 / N_draft=32 provisional——**2026-09-14 C3 修订批转正:K_dmg=0"禁区默认值"条款解除**,刀保底语义由供给控制器战斗首件保证取代;no_damage_row 后闸仍托底零活刀行世界)· F2 雾档过滤(T_fog_min 默认 2 provisional;A4 约束①为验收锚非运行时校验——AC-19 档位序检查,B1 对照表落定后升级)· **重复受理幂等(同格重复 grant / 同批次重复 grant_clear → 同一快照/身份 + 诊断;受理/兑付恰一次归 B1×②③)**
|
||||
api: 封闭枚举 10 入口(provisional,实现期 ADR 定名)——roll_board / query_identity(返回 {reward_id, category, tier} 引用级投影;未开格恒可查——A5 桥接结构前提;清单外坐标 → null + 诊断)/ grant(同格重复受理幂等 + 诊断)/ grant_clear(同批次重调幂等 + 诊断)/ stock(仅受理道具类,未知 item_id/buff 类拒绝;来源 {cell, round} 调用方供给不校验真值)/ use(零游戏态守卫;回执 = 授予时快照投影)/ query_inventory(Used 保留只读;枚举序 = stock 受理序)/ clear_inventory / retire_mapping / equivalence_supply(全活行投影 + tier_min_buff)+ weighted_pick 纯函数面;新增入口 = 接口漂移,**新增入口须随附全输入域语义表(2026-09-09 评审纪律)**
|
||||
mvp_content: **默认根行集重登记(2026-09-14 C3 修订批——减伤墙批 + 供给控制器批 + clear_blast 换位批转正;值 provisional 归 C3;2026-09-11 两级奖励批旧登记由本条替代)**:格子池四行即时类(attack_up_basic buff→attack_up w20 t2 / defense_up_basic buff→defense_up **w16** t2〔减伤墙批 24→16,attack_up 升池内最高行〕/ spark_aoe instant_aoe p4 w16 t1 / heal_minor instant_heal p4 w15 t1——池合计 67)+ 注入池三行可选类(knife_t1 damage_item p8 **w60 active_inject** t1 / knife_adv damage_item p16 **w30 active_inject** t2 / heal_pack heal_pack p12 **w10 active_inject** t2)+ clear_blast(instant_aoe p40 w1 t2 clear_default——**清图槽换位:原 clear_knife 入库刀由当场兑付全体存活敌的 instant_aoe 替代,不入库不占可选类供给;完美板 ×2 = 80**);tier_min_buff = 2;雾池 = {defense_up_basic, attack_up_basic, knife_adv, heal_pack}(AC-19 对账对 (knife_adv, attack_up_basic) 不变);B1 条款⑤计价基元随换位重推(C = power = 40——clause5_dominance.c3_ruling);**2026-09-14 伤害量值区间批:五行 power 区间化**(heal_minor [2,6] / knife_t1 [5,11] / heal_pack [6,18] / knife_adv [10,22] / clear_blast [25,55]——中点恒等原值,身份批内上阶/下阶随机;验收口径 = 完美策略档 0 加成通关率 ≤40%〔OQ7 完美档基线 100%〕)
|
||||
direction_precheck: **刀供给方向预检(2026-09-09 评审批登记,B2 clause3_supply 先例)**——击杀需求 18(单敌)/ 54(3 敌,B2 EnemyTable 参考行);刀伤供给期望/板 ≈ |资格格| × 40% × 5 = 2|资格格| → |资格格|=10 保守板:单敌 ≈0.9 板、3 敌 ≈2.7 板("单敌无忧 / 2–3 敌贴近下界"现值有锚);输入缺口 |资格格| 分布待 A1 actuals p10/p50 落地后重跑;治疗对照基准 max_hp=50(原型锚——HeroTable 值出处建议 B2/D2 回写补登)
|
||||
b1_obligations: 六项(B1 GDD 门禁评审缺项即 blocking,清单全文见 B4 GDD Dependencies;2026-09-09 评审同步)——① 结算段序骨架(授予→**窗口**→增益/减益→道具→战斗→衰减→判定;窗口锚点 = 授予段后;窗口选择序 = 回放输入)② 受理分流 + **每格恰一次** + 满层零兑付"奖励未生效"行(含聚合计数字段)③ clear_reward 授予路径(B3 OQ4 关闭条件)④ 窗口与道具段编排(usable_now 组装/选定序/满血守卫 + 逐件动态守卫/零效果判定"已消耗未生效"行/**击杀结果进流水**/治疗 clamp)⑤ 生命周期编排(battle_over clear_inventory〔清空反馈计数〕/ retire 映射消亡)⑥ roll_board 恰一次。**履行回执(2026-09-10)**:六项已全数落位 B1 GDD(Core Rules 4/5/7/9/编排专章——落位映射 = b1 AC 覆盖矩阵;缺口预检 2 阻塞级 deferral 已随 AC-7/AC-15/16/20 承载)
|
||||
d1_obligations: 五项(缺项即 blocking;2026-09-09 评审 3→5 扩容)——① 已开格 + 库存身份恒定可读(库存常读条 = 挖掘期规划面)② 道具使用窗口呈现(授予段后弹出/选用/跳过/序/usable_now/触发政策注记)③ 结算明细四类行(道具/"奖励未生效"〔聚合计数〕/"已消耗未生效"/"使用被拒")④ H2 清图奖励行强调呈现 ⑤ battle_over 库存清空可见反馈
|
||||
pricing_constraints: A4 三条定价硬约束承接——① 雾内档位下界(AC-19 档位序检查夹具对账型,B1 对照表落定后升当量对账)② 清图锚随雾成本上浮(**MVP 结构性不可闭合——clear_default 常量池无法随雾负担变化,非 deferral;激活载体 = clear_<biome> 插槽,B1 检查点仅对常量判 pass/fail**)③ 雾板净当量优势带上界(**MVP 静默绿灯风险——②缺位 + 仅 tier 下界加成下近乎必然平凡通过**;B1 强制检查点 + 预警⑤雾板分层/⑥速杀退化观测对冲)〔②③状态 2026-09-09 评审显式宣告〕
|
||||
high_glow_nodes: H1 开格拾取瞬间 / H2 清图奖励兑付 / H3 道具抢杀窗口(2026-09-09 评审诚实化:H1/H2 = 奖励侧常规节拍登记,H3 = 创意风险 #2 战斗侧执行兑现;**风险 #2 排雷侧"完美排雷爆发结算"机制本体归 B1 强制检查点、#3 标中旗节拍补偿归 B1——B4 只交付插槽与明细行数据面**;呈现义务 D1×④⑤)
|
||||
referenced_by: [B1, D1, C3, A5, B5, D5]
|
||||
|
||||
- name: reward_config
|
||||
type: schema_data
|
||||
owner: design/gdd/b4-reward-item-economy.md
|
||||
attributes:
|
||||
table: RewardConfigTable(D2 承载,**单行全局**——2026-09-09 B4 full 评审接口漂移新增:B4 三个标量 knob 的 Rule 1 单一事实源载体,R3 override key 空间随之存在)
|
||||
fields:
|
||||
t_fog_min: int [1, 8](默认 2)——F2 雾档过滤门限
|
||||
k_dmg: int [0, 999](默认 **0**——2026-09-14 C3 修订批转正〔切片 reward_config.tres 现值〕:原默认 1 与"C3 禁区默认值"条款由供给控制器战斗首件保证取代;no_damage_row 加载后闸仍托底零活刀行世界) # was: 默认 1、K=0 = C3 禁区默认值 before 2026-09-14
|
||||
active_p0: float [0,1](默认 0.4 provisional——供给控制器首件之后每张新板注入概率初值;E[战斗获取] ≈ 1 标定目标,归 C3)
|
||||
active_decay: float (0,1](默认 0.5 provisional——注入概率指数递减 0.4→0.2→0.1→…永不绝育;加难杠杆候选 0.6 随 C3 OQ7 扫描)
|
||||
n_draft: int [1, 999](默认 32)——F5 草稿重 roll 上限
|
||||
p_min: int [1, 999](默认 8 = 默认根最低刀 power——2026-09-11 两级奖励批)——K≥1 供给闸刀力下界(floor_supply_missing) # was: 默认 4 before 2026-09-12
|
||||
rule4_exemption: 单行全局常量表(HeroTable/ActionEconomyTable 先例)
|
||||
referenced_by: [B4, C3, B1]
|
||||
|
||||
- name: settlement_table
|
||||
type: schema_data
|
||||
owner: design/gdd/b1-settlement.md
|
||||
attributes:
|
||||
table: SettlementTable(D2 承载,单行全局;B1 回填 owner,2026-09-10 定稿回填;Rule 4 豁免——单行全局常量/结构表,HeroTable/ActionEconomyTable 先例)
|
||||
fields:
|
||||
equivalence_ref_damage: int [1,999](knob,默认 12 provisional——当量参考敞口 D_ref,F1 通货;变更触发全对照表 + 条款③⑤对账重跑,禁独立调参)
|
||||
p_perfect: int {100,200} percent(knob,默认 200 provisional——完美排雷清图奖励**第二份兑付触发**;2026-09-10 B1 评审批修订:真实双份交付载体〔Core Rule 13#2〕——100 = 仅高光、200 = 双份交付,非整数倍数乘数无运行时载体、域外加载致命;上界受护栏 B 约束〔双读数:D_ref 口径 24 / DPS 严格读数 ≈8,裁决归 C3〕)
|
||||
segment_order: StringList(结构冻结——段序骨架 [grant, item_window, buff_debuff, item, combat, decay, verdict];加载期恒等拍板序校验违例致命,防实现乱序静默漂移)
|
||||
source_label_map: Dictionary source_class→文案键(结构冻结——P2 归因呈现映射;键集 = B3 source_class ∪ {道具/判定扩展, enemy_action, flag_miss}——2026-09-10 B1 评审批修订;新增键 = 接口漂移)
|
||||
effect_pool_map: Dictionary effect_id→pool {hero_offense|hero_defense|enemy_output|flat_attach}(结构冻结——F2 效果语义映射,B3 Rule 7 载体;键 ⊆ StatusEffectTable 活行集、悬空加载期致命;新 effect_id 上线须随批登记)
|
||||
pool_clamp_lo: int pp(结构冻结 −100——percent 池地板域下界,乘数域随之 [0,2];2026-09-10 统一八字段口径)
|
||||
pool_clamp_hi: int pp(结构冻结 +100——percent 池地板域上界;原"七字段 pool_clamp_lo_hi"措辞作废,D2 GDD 行按收编先例以本条为准)
|
||||
round_direction: enum {floor}(结构冻结——单一取整规则)
|
||||
damage_a_per_cell: int ≥0(knob 默认 1 provisional——伤害A 开格充能/格;2026-09-14 护甲克制批转正登记,机制与结算归 B1、C3 投值)
|
||||
damage_a_cap: int ≥0(knob 默认 8——伤害A 单轮充能封顶,防连锁轮失控;0 = 不封顶)
|
||||
damage_b_per_flag: int ≥0(knob 默认 2——伤害B 标雷充能/首次标中雷,每雷实例一次去重)
|
||||
armor_effectiveness: Dictionary 伤害类型×护甲→百分比(键集结构冻结 {base, dmg_a, dmg_b} × {none, a, b};默认 base 全 100 / dmg_a→a=150、b=50 / dmg_b→b=150、a=50——特化 ×150 / 无甲 ×100 / 对位 ×50;数值 provisional 归 C3)
|
||||
validation: segment_order 违例致命 · effect_pool_map 悬空致命 · p_perfect 域 {100,200}(2026-09-10 载体域——100 = "完美必须 ≥ 不加倍"机制语义下界,200 = 双份交付)——B1 冒烟三行致命 manifest(segorder_violation / poolmap_dangling / pperfect_oob)
|
||||
mechanics: 结算段序骨架唯一权威载体(授予→道具使用窗口〔授予段后〕→增益/减益→道具→战斗→衰减→判定——用户 2026-09-09 拍板序)· 零随机(rng_service 流封闭不含结算流)· 可回放步骤流(同 master_seed 同意图序列同窗口选择序列 ⇒ 步骤流逐行相同——D2 AC-15 deferred→B1 兑现落点)· 调用序钉死 query_attack→apply_damage→advance · 衰减恒执行含末轮 · 高光双落载体(perfect_sweep P_perfect——2026-09-10 修订为真实双份兑付载体 / 标中旗 highlight 标记)· 流水行协议字段分层(公共 7 字段 + 行类型特有 target/effect_id/pool_value/聚合计数——2026-09-10 评审批修订;行类型封闭枚举 13 类)· **伤害A/B 充能与护甲克制结算规格 = B1 GDD F6(W3 补全,2026-09-14 重算批)**——挖掘期充能/战斗段消费/单轮生命周期、不吃 percent、逐分量 armor_effectiveness 查表 floor 相加
|
||||
closure_receipt: A3 F1 条款①②③⑤闭合 owner = B1(2026-09-10 F0–F5 首版验算完成——F0 瞬时当量口径 + m_w 值域裁决见 status_effect.anchor_warning;条款③ clause3_supply 闭合回执;条款⑤ clause5_dominance 条目;actuals p10 交付后强制重跑)
|
||||
referenced_by: [D1, B5, D4, D5, C3]
|
||||
|
||||
- name: clause3_supply
|
||||
type: formula
|
||||
owner: design/gdd/b2-enemy-system.md
|
||||
attributes:
|
||||
rule: B2→B1 挖掘风险不等式(A3 F1 条款 3)供给口径——每结算敌方伏击暴露精确式 = k × L × m_amb(k = 本结算存活敌中攻击/重击拍单位数,确定性可算);每结算结构上界 = unit_count × min(AP 上界, cap) × m_amb(cap > AP 界时 cap 腿松弛——2026-09-09 B2 full 评审收紧);跨结算累计 = 轨迹量非表值
|
||||
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: 对账输入 = A1 actuals p10(F4 报告 C)非 target 参数(A1 登记口径);闭合 owner = B1 单一签字人;左臂(安全格 buff 当量)载体 = **B4 F6 当量供给**(2026-09-09 B4 定稿——部分缓解非闭合:窗口使用次数是战斗轨迹量,B2 OQ3 扩项保持;2026-09-11 起基础攻击恒在为左臂提供恒定伤害基底,原"当前内容态结构性不可通关"事实退役——B2 Overview 2026-09-11 改写)
|
||||
direction_precheck: cap=4 下右臂 ≈7.7;左臂按条款 2 最低档锚(+50pp)计 = 0.36×50 = 18——裕度 ≈2.3×(1:1 百分点代理,provisional;2026-09-09 B2 full 评审更正原 4.7×——该值按 +100 两层叠满取值、与"最低档下界"语言矛盾);量级注记:atk=4 时 attack 拍 L≥2 伏击分量过半(heavy 拍过半点后移、按拍别读取;常态支配修正入口 = C3 atk 曲线 / B4·B1 m_amb 锚,B2 权限外)。**参照迁移注记(2026-09-09 B4 评审;2026-09-11 回迁)**:左臂参照对象曾迁 defense_up 当量(B4 F4)——**2026-09-11 用户裁决"基础攻击恒存在"后 attack_up 复活,参照对象回迁 attack_up 当量**(上式 +50pp 系 attack_up 口径,迁移期结束;复算义务随 B1 对照表落定,见 status_effect.anchor_warning 回迁注记)。**闭合回执(2026-09-10 B1 GDD F4——条款③闭合完成;同日评审批双口径更正)**:统一 HP 当量 + 边际配对重算 → 默认 unit_count=1 下 L1 裕度 ≈2.0× / L2 ≈2.6× **通过**(锚行口径;**跨行期望口径 ≈1.2×/1.5× 同向通过——双口径登记,C3 不得以锚行读数放行 unit_count=2**);**满配语境(unit_count=3)最坏盲点破线 → C3 调参约束登记**(unit_count 轴 + 密度×可推理率轴——unit_count>1 行须降密度或降 m_amb);本条 pp 代理预检(2.3×)退役为历史记录(量纲混用 + 右臂聚合上界与单格决策单位错配)。**重算回执(2026-09-14 B1 重算批——按现行三输入重推:duration=1 × m_d=−30 × C3 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),修正方向须 C3 提案 + B1 闭合对账共裁**;上段 ≈2.0×/2.6× 读数系 duration=2 × m_d=−50 × v1 曲线旧值链产物,退役为历史记录;actuals p10 交付后强制重跑(B1 AC-39;ι 判式面保守代理 = 行 target 代,总暴露面无效)
|
||||
referenced_by: [B1]
|
||||
|
||||
- name: clause5_dominance
|
||||
type: formula
|
||||
owner: design/gdd/b1-settlement.md
|
||||
attributes:
|
||||
rule: A3 F1 条款⑤清图 vs 弃图支配性闭合(B1 单一闭合 owner,B1 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)。**C3/B4 约束包**:① C 量级上调整向(护栏 B 口径联动复核)② 或裁"清图非严格支配"为设计态(与 A4 定价硬约束②同向;如裁设计态须同步声明 A3 条款⑤ P1 对冲弱化 + B4 预警⑤加权监控)——①②二选一归 C3 裁;③ 多敌放行判据 = 条款③⑤在全部登记行组合下同时成立。判据函数角色 = 调参约束生成器(AC-40 断言输出与约束包一致)
|
||||
c3_ruling: **约束包②采信(非支配设计态)+ 计价基元换位重推(2026-09-14 C3 修订批)**——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——B1 修订批对齐条款⑤措辞(义务登记,未兑现前 B1 文本 C=40 按期望中点读)。**重算回执(2026-09-14 B1 重算批——v3 曲线 d0.25/t0.88 × E_dig=4.5 重推,参考板形换锚 C3 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 曲线旧值链产物退役;**C3 裁决②非支配设计态维持**(qualitative 结构不变——非完美态负、完美态 L1 翻正、L2 全负);护栏 A 方向性复核 ≈−1.1 越下界(E_dig 修正 + 雾池构成变更)/ 护栏 B C=40 越线——W2 复核三选一裁决随 C3 收口批;actuals 交付后按 clear_blast 语义强制重跑(B1 AC-40 同批口径)
|
||||
guardrails: 护栏 A 雾板净当量优势带(每链不可达雾格 +2.4 ∈ (0, 3]——A4 pricing_constraints③ 判据;与残余池模型无关读数不变;突破条件 E_fog > 11.7 → C3 雾池联动禁区)· 护栏 B 防钓鱼(**2026-09-10 输入登记更正 + 双读数**:|S|_min = A1 行级 knob 禁写死;|R₀|_max 无登记供给方——登记 A1 产出义务〔R₀ 规模分布上界,报告 C 扩列〕;s_ref=D_ref=12 比真实敌方 DPS 期望松 2.5–3×→ D_ref 口径上界 24〔C_eff=16 ✓〕/ DPS 严格读数 ≈8〔C_eff=16 越〕——两读数裁决归 C3,与约束包①联动;结构承载 = A1 min_safe_count + 布雷数下限 + A2 R₀≠S 三闸的对账复核,非运行期校验)
|
||||
a4_three_legs: 条款⑤三腿入账核对(雷险消解〔雾区无雷〕+ 信息双向净效应 + AP 腿〔链不可达全价 Δr 增量〕)——variation_table.fog_ap_note 消费面
|
||||
rerun_obligation: actuals p10 / fog_burden_ratio p50·p90 交付后强制重跑(B1 AC-40);C3 每次调参重跑(D_ref/P_pf/C 联动)
|
||||
referenced_by: [C3, B4, A1]
|
||||
|
||||
# 占位表中的原型参考值(伏击 +3、清图 +10、敌 18HP/4ATK 等)为 provisional,
|
||||
# 不登记为事实——待各 owner GDD(A4/B3/B4/B1/C3)定稿后由其登记。
|
||||
# (AP 等七字段已于 2026-09-07 由 A3 三次回填登记为 action_economy 条目;旗上限与折算乘数同日作废删除。)
|
||||
# 修订记录:2026-09-07 full 评审(design-review)——删除 combat_var 流、去重键改四元组、
|
||||
# 快照契约补计数器、R2 增实现级规约与 reward_roll 向量(owner=d2-data-config.md 代用户修订);
|
||||
# 同日 re-review(5 阻塞:missing_type 分类规则/EC14 覆盖/诊断收集器/实体键解析语义/Rule 6 二分)
|
||||
# + 独立 delta 复核 5/5 PASS → D2 Approved(2026-09-07)。
|
||||
# 2026-09-07 A3 RAP 结构修订(owner=a3-action-economy.md 代用户修订):action_economy 全条目重写——
|
||||
# 删 flags_per_round / flag_unit_cost / stop_multiplier / clear_multiplier,增 rap_refresh_cost 与
|
||||
# rap_rules / flag_rules / downstream_contract 事实;round_end 改双发射源(A2 棋盘路径 + A3 停手路径)。
|
||||
# 2026-09-07 A3 三轮评审修订(owner=a3-action-economy.md):flag_rules 兑付资格改雷格实例为键(原"放置实例"与
|
||||
# "拔插不重置"并存矛盾)· rap_rules 增玩家发起/多次受理/new_board 契约义务 · downstream_contract 改五条款
|
||||
# (增挖掘风险不等式 B1 闭合 + 弃图支配性)· 增 cross_field_validation(任一动作成本 ≤ ap_per_round)。
|
||||
# 2026-09-08 A4 定稿回填(owner=a4-terrain-variation.md):新增 variation_table 与 variant_pool_gate 条目;
|
||||
# action_economy.referenced_by 增 A4(清图预算构成注记只读消费 ap_per_round=8,与注册表值一致零冲突)。
|
||||
# 2026-09-08 A4 full 评审修订(owner=a4-terrain-variation.md,NEEDS REVISION 8 阻塞同日核销):
|
||||
# variation_table.load_bearing_rule 增结构推论(厚度≤2/f≤8d)· fog_ap_note 改写(全价→链不可达两态;
|
||||
# 条款 5"消解"→三腿入账两态验算)· variant_pool_gate 增 board_biome 域校验归属与 15 项验收门禁登记——
|
||||
# 详见 design/gdd/reviews/a4-terrain-variation-review-log.md 阻塞→修复对照表。
|
||||
# 2026-09-08 A4 re-review 修订(owner=a4-terrain-variation.md,NEEDS REVISION #2 6 阻塞同日核销):
|
||||
# variation_table 增 cross_field_validation(hide_numbers⇒safe_nonzero 致命)与 pricing_constraints(B4 三
|
||||
# 硬约束)· counter_item_ids 修正为非 knob · mvp_content 的 knob 活值标注 · referenced_by 补 B1/B4 ·
|
||||
# fog_ap_note 预算不等式改增量构成("轮数上限"作废)· 厚度≤2 钉死窗口谓词度量。
|
||||
# 2026-09-09 B3 full 评审修订(owner=b3-status-effect.md,NEEDS REVISION 7 blocking 同日核销):
|
||||
# status_effect 条目 fields/mvp_content 改逐字段 YAML 键(AC-18 机器对账前提,action_economy 同构)·
|
||||
# b1_obligations 5→8(⑥ decay 恰一次 ⑦ per-grant 来源标注 ⑧ 溢出行)· 增 single_enemy_assumption 与
|
||||
# presentation_obligations(D1×4/B5×2/D5/B4)· anchor_warning 增修复空间不对称(总暴露读法被 schema 域禁止)。
|
||||
# 2026-09-09 A1 full 评审修订(owner=a1-board-generation.md,MAJOR REVISION NEEDED 8 blocking 同日修订):
|
||||
# board_gen_table 条目同步 B1/B3/B4/B6/B7/B8/R2/R3/R4/R9——inferability_target 域 [0.85,1](P1 绝对锚)·
|
||||
# fog_target_ratio ≤ min(8d,0.25) 绝对上限 · 布雷数下限 round(d×(W×H−9))≥1 · F2c 成本谓词(att×W×H≤16384
|
||||
# provisional,禁墙钟逃生)· 达标两项判据(inferability_core = 剔除雾格后的可推理率)· 布雷钉死(先定数后落位/先布后删)·
|
||||
# 断言 B 收紧达成区占比(A4⑭ 两件套)· σ 打包 2^20·L+2^12·D 防碰撞 · 指标集六→八项 · 第三轴登记约定
|
||||
# (Boss=Dmax 行 + elite_/boss_ 命名空间 + OQ6 重审门)· 黄金向量 core 整数对(派生不重制)。
|
||||
# 2026-09-09 A2 定稿回填(owner=a2-minesweeper-rules.md):新增 a2_event_surface / a2_initial_expansion 两条件目
|
||||
# (三事件回边契约 + 初始展开域与双包含兑现回执 + A1 修订义务〔反例 B〕登记);A2 /design-review 须核对标错惩罚 OQ 在位。
|
||||
# 2026-09-09 A2 full 评审修订(owner=a2-minesweeper-rules.md,NEEDS REVISION 6 blocking 同日核销):
|
||||
# a2_event_surface.api_surface 增 ActionOutcome.sub_reason 封闭枚举(UX-1,批前免费窗口)· D1×1→D1×6;
|
||||
# a2_initial_expansion 增诊断类别封闭枚举 + 链不越旗红线(GD-1——连锁传播集 ∖ G,G=∅ 域与 A1 算子①同构不变);
|
||||
# 新增 terminology 术语条目(用语纪律登记通道)。详见 design/gdd/reviews/a2-minesweeper-rules-review-log.md。
|
||||
# 2026-09-09 B2 定稿回填(owner=b2-enemy-system.md):新增 enemy / hero / clause3_supply 三条目(EnemyTable 八字段 +
|
||||
# 双敌种行 + 每行集恰一敌种校验;HeroTable 单行全局两字段 + atk=0 机制开关〔该口径 2026-09-11 作废,见下〕;条款 3 单结算自然边界供给口径〔用户定稿〕)·
|
||||
# status_effect.single_enemy_assumption 回验改写(定多敌,side-wide 兼容 + target_ref 扩展位)·
|
||||
# status_effect 增 ambush_unit_definition(量纲定稿,OQ2 关闭条件)· terminology 增 B2 六词条。
|
||||
|
||||
# 2026-09-11 用户裁决批(基础攻击恒存在):hero.atk 域改 [1,999]、0 = 加载拒绝(MVP=6 原型锚 HERO_BASE_ATK,
|
||||
# 概念原型"每次结算的基础伤害")——"机制开关 MVP=0"与"当前内容态无胜利路径"声明作废;attack_up 复活(消费面 =
|
||||
# 主角战斗段先手攻击,B1 GDD 同批增补 + source_label_map 增 hero_attack 键);锚参照回迁 attack_up 当量(status_effect.
|
||||
# anchor_warning / clause3_supply.direction_precheck 两处迁移注记退役为历史);b1_obligations 履行回执 2026-09-10 不变;
|
||||
# 变更 owner = b2/b4/b1 GDD 2026-09-11 同批修订。
|
||||
#
|
||||
# 2026-09-11 用户裁决批(两级奖励 + 关内延续):RewardTable category 扩为五值两类交付轴(即时 75% / 可选 25%)·
|
||||
# 默认根重登记为八行(attack_up_basic 复活入池 / spark_aoe / heal_minor 新增;heal_pack 稀缺化 w6 p12)·
|
||||
# status_effect attack_up/defense_up duration 2→1(当次结算语义)· 库存关卡域(跨战斗延续、关卡末清空——
|
||||
# 原战斗域作废)· 窗口单件制(原任意多件作废)· reward_config p_min 4→8。
|
||||
# 变更 owner = b4/b1/b3 GDD 2026-09-11 同批修订。
|
||||
# 2026-09-09 B2 full 评审修订(owner=b2-enemy-system.md,NEEDS REVISION 8 blocking 同日核销):
|
||||
# enemy.b1_obligations ① 增调用序成文(query_attack→apply_damage→advance)与敌单位专属口径 · d1_obligations
|
||||
# ① 增预告时序/强度档位、② 改全局恒定 · rowset_rule 增精英/Boss 编码位预登记(B2 OQ7)· clause3_supply
|
||||
# 结构上界改 min(AP, cap) 形(cap 腿松弛收紧)· direction_precheck 裕度 4.7×→2.3× 更正(最低档锚口径)·
|
||||
# account_input 增胜利路径声明注记。详见 design/gdd/reviews/b2-enemy-system-review-log.md。
|
||||
# 2026-09-09 B4 定稿回填(owner=b4-reward-item-economy.md):新增 reward_table 条目(schema 八字段 + 跨字段
|
||||
# 校验族 + 机制/API 面 + B1×6/D1×3 义务清单 + A4 三约束承接 + 高光节点条目化);接口漂移改写三处——
|
||||
# rng_service.scope_event_binding 的 reward_roll 语义(每次奖励结算 → 每次 board install 批)、
|
||||
# status_effect.dangling_ref_policy(首引条件兑现)、clause3_supply.account_input(左臂载体 = B4 F6);
|
||||
# action_economy.referenced_by 增 B4(F6 当量供给消费条款①②)。并行会话冲突经用户裁决:道具段"照常消耗"
|
||||
# 拍板为最终语义(覆盖并行草稿"拒绝不消耗"版),清图槽允许 buff 行拍板同批落定。
|
||||
|
||||
- name: d1_presentation_surface
|
||||
type: convention
|
||||
owner: design/gdd/d1-hud-framework.md
|
||||
attributes:
|
||||
kind: 呈现面契约(读图接口清单 + 订阅纪律 + 命令式刷新面 + 载荷 schema 索引——封装收口批〔session-state entry 39/40〕切片事实的 GDD 转正)
|
||||
read_map: A2 current_board()/reveal_record()/compute_move_path() · A3 getter-only phase/ap/rap/last_round_end · B1 presentation_snapshot()/is_battle_live()/stock_count()/query_reward_identity() + 步骤流信号 · B2 hero_unit()/all_enemies() · **B3/B4 零直读**(经 B1 呈现面与流水投影)· runner(节点链/当前节点/HP 携带)
|
||||
write_paths: settle_batch(stop 亦经此,禁直调 A3)/ submit_window_selection(窗口条目位置序,非库存句柄) / 刷新意图 → B1 refresh_board 编排 / runner 推进——**全部唯一发生在组合根**
|
||||
subscription_discipline: 呈现层永不直接订阅 A2/A3——只订 B1 步骤流/快照与 runner 信号(ADR-0001 固化);接线全部在组合根
|
||||
imperative_refresh_faces: 零事件外发动作的刷新 = 命令式回执驱动(白话:动作调用返回后组合根立刻重查一次只读面刷新界面,不等通知信号)——旗插拔/移动成功(A2)/ AP·RAP 读数(A3 无推送)/ 状态效果(B3 零信号,绑 B1 结算完成时点)/ 库存(B4 查询面)五面成文
|
||||
payload_schema_index: D1 GDD Core Rule 17 表 13 项——A2 三事件/B1 流水行协议/B4 窗口载荷等均为引用既有 schema;D1 自有成文 = ux 遥测六行(ux_round_input_ratio/ux_round_exit/ux_refresh_attempt/ux_window_choice/ux_reject/ux_hint_shown)+ hint_id 封闭枚举 {fog_first, chord, no_adjacent}
|
||||
lifetime_visibility_rule: 销毁前捕获(终局/死亡数据 despawn 前已入流水与快照)/ 载荷自包含(行协议自带来源/值/目标,禁按行序反推)/ 禁回读核心生命周期态(唯一观测口 = is_battle_live() 与 phase 投影)——切片缺陷②教训转正
|
||||
naming_unification: 正式名 request_refresh(A3)/ refresh_cap_per_round(结构位默认 2)——切片 provisional 名 request_refresh_active/can_request_refresh/refresh_max_per_round/during_round 退役(AC grep 断言零残留)
|
||||
drift_registrations: ① A3 只读观测量缺轮内已用刷新次数(刷新按钮"本轮剩 N 次"读数缺口——A3 修订批补)② 切片 settlement_snapshot 信号 B1 GDD 未登记契约(D1 现行消费 = 步骤流判定行 + presentation_snapshot(),独立信号须回 B1 补登记)③ 极性提案实施批 D1 义务条目(未开格类型图标/极性视觉语言/负向文案族——随批入 systems-index D1 台账)
|
||||
referenced_by: [B5, D4, D5, A5, D6]
|
||||
|
||||
- name: a5_aux_items
|
||||
type: schema_data
|
||||
owner: design/gdd/a5-minesweeper-aux-items.md
|
||||
attributes:
|
||||
table: AuxItemTable(D2 承载【D2×① 修订批登记】,键 = item_id;A5 回填 owner,2026-09-14 定稿登记;定义表非进度成长表——Rule 4 豁免;生效前提 = B4×①…⑤/D2×①② 修订批兑现)
|
||||
fields:
|
||||
item_id: String 主键唯一——B4 RewardTable.effect_id(aux 行)与 VariationTable.counter_item_ids 的引用键
|
||||
display_name: String 非空(D1 呈现数据源,本地化归 D6——B2/B3/B4 同库惯例)
|
||||
dimension_tags: StringList ⊆ {info, risk, action, plan, counter} 非空——维度覆盖断言载体(F2:五维度各 ≥1 活行 = "每维度都有对应道具"的机器可查形态)
|
||||
effect_kinds: StringList ⊆ {fog_reveal, mine_reveal, reward_preview, ap_grant} 非空、无重复(MVP ≤2——稀有多维组合行的 schema 承载)
|
||||
target: enum {none, fog_region, area_3x3, board_wide}——校验 = target ∈ 各空间 kind 支持域交集(全非空间 ⇒ 恒 none)
|
||||
magnitude: int [0,999](knob)——仅 ap_grant 行消费(= AP 点数,加载校验 ≥1);空间行不消费非校验项
|
||||
use_phase: enum {active_dig}——MVP 单值(扩枚举走 A5 GDD 修订;B4 use_timing 扩值 during_dig 同批对齐——B4×③)
|
||||
mvp_content: 六行(值 provisional 归 C3)——probe_dust 显影尘〔info+counter / fog_reveal / fog_region / 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 / fog_reveal+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 仅 fog_reveal/reward_preview(恢复推理可全图、替代推理必窄域——P1 防塌方;schema 校验强制,夹具 a5_target_violation)· 效果时效随 kind 派生无独立字段(空间 kind 恒本图持续、ap_grant 恒当轮一次性)· 零随机(零 RNG 流消费——信息全部来自 A2 恒真数字/B4 Ready 映射/A3 账本三既有事实源)· 零特判延伸(A2 代码零 A5 分支)· 无效/零信息目标不可用不消耗(可用性门——2026-09-14 用户拍板:板级判据 → 图标灰/入口禁用〔B4 usable_now 先例〕、点击级 → 拒绝零消耗、组合行判据取 OR——爆破包 ap_grant 恒可用、真视零雷恒有效;与 B4 E10 照常消耗区分——挖掘期非结算管线、守卫 A5 本地可判)· area_3x3 边缘窗口 resolved_target = 窗口 ∩ 板内格(2026-09-14 用户拍板——护栏只缩不扩)· 使用零 AP 成本(不经 try_spend)· 库存关卡域(与 B4 库存正交两容器、生命周期同构)· Used 不可逆
|
||||
overlay_semantics: 板级叠加层三集(A5 自持派生信息层、零回写 A2/B4 状态、随图消亡)——digit_reveal 显影集(D1 显示雾格数字,本体 = A2 恒真数字)/ mine_reveal 真视集(真视≠自动兑付——插旗仍花 1 AP 走既有 flag_hit 路径)/ reward_preview 预读集(徽章数据源 = B1 query_reward_identity 既有读面——A5 零 B4 数据复制)
|
||||
api: 封闭枚举 8 入口(provisional,实现期 ADR 定名)——add_item(item_id, source) / query_inventory(枚举序 = 受理序,Used 保留只读,逐件含 usable 板级零信息可用性预判)/ validate_use(handle, target?) → 效果投影(只读不消耗;目标校验谓词 = 越板/点击级零信息拒绝 + 边缘窗口裁剪 resolved_target = 窗口 ∩ 板内格)/ apply_overlay(kind, target, mag)(B1 逐 kind 调用)/ consume(handle)(Used 不可逆 + 快照回执)/ query_overlays(三集只读投影)/ retire_overlays(B1 编排——与 B4 retire_mapping 同点)/ clear_inventory(关卡末幂等);负空间 = 无自动使用入口/无重掷/无事件订阅/无 RNG 直连/无 A2/B4 写入口
|
||||
use_orchestration: B1 use_aux 规范序(唯一调用权)= 相位 gate(Active——A3 phase getter)→ validate_use(目标校验读 A2 只读面——使用目标校验谓词表见 A5 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| 分布缺口待 A1 actuals——B4 预检 11 同批重跑)· F2 维度覆盖谓词 coverage(d) · F3 信息价值方向预检(显影 ι↑ → 残余盲猜端 n_s = (1−ι)|S| 收缩 → 盲赌暴露下降 → 期望踩雷↓——P(雷) = |M|/(|M|+n_s) 对 ι 递增,单赌命中率上行属正常,收益在"少赌"非"单赌更安全";与 B1 F4 同式 + n_s<1 适用域守卫;2026-09-14 评审修正原"P(雷)↓"方向误写;定量当量归 B1 条款①对照表扩列——B1×④注记,MVP 不入对照表)
|
||||
obligations: 21 项跨 GDD 义务清单(A5 GDD Dependencies 全文,对侧修订批逐项核对、缺项即 blocking)——B1×①②③(use_aux 编排/生命周期/授予路由,缺项即 blocking)+ B1×④(对照表扩列注记)· B4×①…⑤(category 扩值 aux_item/effect_id 双表校验+夹具 b4_dangling_aux/use_timing 扩 during_dig/默认根六行+池总权重算/OQ2 收口注记)· A3×①(grant_ap 第 9 API 接口漂移预授权——Active 受理、无上限域、零随机)· A4×①②③(fog.counter_item_ids=[probe_dust] 回填/悬空校验激活+夹具 a5_dangling_counter/未来变异随批配 ≥1 反制)· D1×①…④(库存条/使用交互/叠加层三集呈现/清空反馈)· D2×①②(AuxItemTable 登记/两处表值回填+校验激活)· D5×①(教学候选,非 blocking)· art-bible×①(§4.6 键扩容:item_id 六键+叠加层标记三族)
|
||||
ux_flag: 有 UI 贡献(库存条/使用交互/叠加层呈现)——Phase 4 前置 /ux-design;asset-spec 候选(art-bible 样张批后)
|
||||
closures: A4 EC6 显影语义定稿(=fog_reveal,恢复推理原料非排雷;时效 = 本图持续)· A4 OQ2 收口(时效/定价/首引回填/悬空校验)· B4 OQ2 A5 侧收口(呈现深度 = 道具驱动预读;未预读格不呈现、自动寻路不做——终态与否 OQ6)· 创意风险 #1 道具侧兑现(plan 维度预读——结构闭环最后一块,呈现归 D1)
|
||||
warnings: 预警①…④ playtest 预注册归 C3(道具依赖度/预读覆盖率/AP 转存联动/稀有感知)
|
||||
referenced_by: [B1, B4, A4, A3, D1, D2, D5, art-bible]
|
||||
|
||||
- name: difficulty_table
|
||||
type: table
|
||||
owner: design/gdd/c3-difficulty-curve.md
|
||||
attributes:
|
||||
kind: 全局修饰结构位(MVP 空表——零行为)
|
||||
key: (level_index, node_depth)
|
||||
fields: 修饰乘数(域预登记 [0.1,10],越域 clamp+warning——非 fail-fast,组合事故非配置事故)
|
||||
application_point: B2.spawn 实例化时、行值快照前套乘(B2 Rule 10 兑现——接口漂移建表随 C3 实现批)
|
||||
first_use_scenario: 精英节点(C1 分支地图定稿后联动设计——C3 OQ5);Boss 走 Dmax 直填行不走本表
|
||||
referenced_by: [B2, C3]
|
||||
|
||||
- name: difficulty_expectation_table
|
||||
type: formula_set
|
||||
owner: design/gdd/c3-difficulty-curve.md
|
||||
attributes:
|
||||
kind: 调参目标带(F5)+ 承伤估算(F4)+ 供给平衡式(F6)——设计期工具式,运行时零新增公式(C3 定位声明)
|
||||
clear_rate_target: L1 基线 **30-50%**(2026-09-14 带锚定稿——旧 40-60% 由本条替代;现扫描 60% 越上界,加难杠杆批内执行 OQ7)/ L2 20-40% / L3+ 10-25%(中高天赋带见 GDD F5 表——区间位移机制承载:atk 翻倍 ≈ K 减半 → 绿档)
|
||||
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(切片原型→C3 期正式批量工具,A1 F4 排期倒挂解除载体)
|
||||
calibration_gap: 真人修正系数待 playtest 标定(OQ3——**方向已由试玩批次 1 反向确认:真人显著强于模拟者**〔v2 真人 100% vs 模拟 80%〕;旧"真人预期低于模拟"方向声明由本条替代;带按模拟口径定义,真人系数批次 2 定量)
|
||||
referenced_by: [B4, B1, C2, C4]
|
||||
|
||||
- name: boss_dmax_convention
|
||||
type: convention
|
||||
owner: design/gdd/c3-difficulty-curve.md
|
||||
attributes:
|
||||
rule: Boss = 各关最大深度 Dmax 行(A1 第三轴登记约定的 GDD 侧兑现)+ LevelTable 末节点必须 Boss(schema 校验)+ 专属行为环含 charge 拍
|
||||
boss_hp_anchor: F3 = Σ普通战斗hp期望 × r_boss ∈ [0.5, 1.1](现行带——旧带 [0.35,0.55] 与"切片 0.81 越上界"读数由本条替代,OQ2 采信用户"可上调"裁决后修订)· L1 v3 记录值 150/153.5 ≈ **0.98** 带内 ✓(期望口径含 unit_count 区间骰 Σ=153.5——2026-09-14 C3 修订批口径统一,旧固定口径 Σ=142 读数替代)· **加难走廊 [1.1, 1.35] 预登记**(Boss 180–207 候选,OQ7 扫描终裁)
|
||||
elite_reserved: elite_/boss_ 前缀命名空间预留(A1 B7);精英完整语义归 C1 定稿联动(OQ5/OQ6 强制重审)
|
||||
referenced_by: [A1, B2, C1, C2]
|
||||
|
||||
- name: level_table
|
||||
type: schema_data
|
||||
owner: design/gdd/c2-adventure-structure.md
|
||||
attributes:
|
||||
table: LevelTable(D2 承载,键 = level_index 行、行内 nodes 节点链数组——切片建表,C2 定稿转正为行集内容 owner)
|
||||
fields:
|
||||
level_index: int 行主键(冒险序列序号,从 1 连续递增——线性序列无跳关)
|
||||
display_name: String(玩家可读层名——L1"第一层 · 苔藓回廊"切片现行;L2 provisional"第二层 · 雾漫巢径",终稿随 L2 内容批)
|
||||
rest_heal_pct: int [0,100](knob 默认 30——恢复点回复 max_hp_eff 的百分比,随上限加成同步放大防高上限档恢复失效;数值复验归 C3)
|
||||
nodes: 节点链数组——node_kind ∈ {battle, reward, rest, boss}(切片字段名 type);battle/boss 携带 node_depth;reward/rest 不占深度
|
||||
rowset_rule: Boss 恒末节点(schema 校验);战斗节点深度 = 前序战斗节点计数、Boss = Dmax(A1 第三轴约定兑现面);MVP 链模板 = battle D0 → battle D1 → reward → battle D2 → battle D3 → rest → boss D4(7 节点 5 战斗深度,L1/L2 同构复用)
|
||||
cross_table_validation: battle/boss 节点 (L,D) 在 board_gen/enemy 两表存在精确行(D2 跨表校验⑧复用 + C2 AC-7 冒烟断言——序列关数 ⊆ 内容覆盖,越界关卡 = 内容生产缺口)
|
||||
mvp_content: L1 全行(切片转正——7 节点链、rest_heal_pct=30、全程无雾);L2 行 = N=2 扩展批(同构模板 + C3 深度轴行值同批填充——C2 GDD 生效前提,未落地前冒险以单关行集运行 N=1 合法态)
|
||||
referenced_by: [C2, C1, C3, A1, D2]
|
||||
|
||||
- name: adventure_table
|
||||
type: schema_data
|
||||
owner: design/gdd/c2-adventure-structure.md
|
||||
attributes:
|
||||
table: AdventureTable(D2 承载,单行全局;C2 回填 owner;Rule 4 豁免——单行全局常量表,HeroTable/SettlementTable 先例;建表走 D2 接口漂移规则)
|
||||
fields:
|
||||
level_clear_hp_bonus: int [0,999](knob 默认 10——关卡大奖励 HP 上限提升,冒险内生效经 begin_battle 覆盖值通道传入后续每战;值锚 = C3 区间平移换算率 +10hp ≈ +1 轮,上调须 C3 重扫 L2 通关率带)
|
||||
token_per_level: int [0,999](knob 默认 10——每通关一关的代币记账值;消费方 C4)
|
||||
mvp_content: 两字段默认值即 MVP 行(10 / 10,provisional)
|
||||
extension_reserve: 大奖励形态扩列位(三选一 / 攻击型 / 通关加成——C2 OQ2,随 C4 元进度设计)
|
||||
referenced_by: [C2, C4, D2]
|
||||
|
||||
- name: hero_override_parameter_passing
|
||||
type: convention
|
||||
owner: design/gdd/b1-settlement.md
|
||||
attributes:
|
||||
kind: 主角战斗入参覆盖值通道(begin_battle 显式参数传递——切片 E4 封装收口批实现,registry 登记缺口由 C2 定稿批补登)
|
||||
contract: begin_battle 增 hero_hp / hero_atk / hero_max_hp 显式入参 → B2.spawn 增 atk_override / max_hp_override 参数;-1 = 表值兜底(不覆盖);hero 表运行期不可变(D2 单一事实源机制化——表写通道全删)
|
||||
consumers: HP 账本(C2——跨战斗 HP 持久性 + 大奖励上限提升的传入面)/ 元进度加成(C4 远期预留)/ 切片 TunePanel(调试通道)
|
||||
adr_status: ADR-0009 候选——正式侧 B1/B2 GDD 修订随 ADR-0009 批;C2 GDD 规则 3/4 为 C2 半边(HP 账本供值)的正式定义源
|
||||
referenced_by: [B1, B2, C2, C4]
|
||||
# 2026-09-09 B4 full 评审修订批(owner=b4-reward-item-economy.md 代用户修订,NEEDS REVISION 14 blocking 同日核销):
|
||||
# 新增 reward_config 条目(RewardConfigTable 单行全局——T_fog_min/K_dmg/N_draft/P_min 的 Rule 1 载体);
|
||||
# reward_table 增 display_name(九字段)+ 默认根行集登记 + direction_precheck(刀供给)+ 跨字段护栏两条
|
||||
# (floor_supply_missing / no_damage_row——B2 OQ9 并案)+ 窗口锚点改授予段后(用户评审拍板:当轮拾取当轮可用)
|
||||
# + 重复受理幂等语义 + B1×6/D1×3→D1×5 义务清单同步;锚参照迁移传播三处(本条 anchor_warning 迁移注记 /
|
||||
# clause3_supply.direction_precheck 迁移注记 / systems-index A3 OQ5 注记——attack_up 口径历史值与 defense_up
|
||||
# 数值巧合全等、迁移后预检未重跑事实同批登记);terminology 增 B4 六词条(刀/批尾/死行/档位序检查/预推进/烧刀烧包)。
|
||||
# 详见 design/gdd/reviews/b4-reward-item-economy-review-log.md。
|
||||
# 2026-09-10 B1 定稿回填(owner=b1-settlement.md):新增 settlement_table / clause5_dominance 两条件目
|
||||
# (SettlementTable 七字段 + 三行致命 manifest + 段序骨架/可回放/高光双落载体;条款⑤主判式 + 保守地板缺口 +
|
||||
# 两护栏 + 三腿入账)· 接口漂移回写四处——status_effect.mvp_content.weaken magnitude −25→−65(F0 裁决,
|
||||
# 值域 [60,85],终值共裁 B1 OQ2)+ anchor_warning F0 裁决回执(红警关闭:瞬时当量口径/地板层数=2/defense_up
|
||||
# 参照保持)· clause3_supply.direction_precheck 闭合回执(≈2.0×/2.6× 边际配对、满配破线 C3 约束、pp 代理退役)
|
||||
# · board_gen_table.inferability_vs_p_safe 消费回执(P(安全) 残余盲猜端代理式);status_effect/enemy/reward_table
|
||||
# 三处 b1_obligations 履行回执(23 条义务全落位 b1 AC 覆盖矩阵);terminology 增 B1 五词条
|
||||
# (完美排雷/当量/乘区/溢杀/免伤轮)。
|
||||
# 2026-09-10 B1 评审批修订(owner=b1-settlement.md,/design-review NEEDS REVISION 同日核销 8 blocking):
|
||||
# settlement_table——p_perfect 载体域 {100,200}(真实双份交付)、pool_clamp_lo_hi 拆 lo/hi 两字段(八字段口径统一、
|
||||
# D2 GDD 行按收编先例以本条为准)、source_label_map 键集补 enemy_action/flag_miss、mechanics 补行协议字段分层;
|
||||
# clause5_dominance——模型修订重登(挖穿残余池计价、条款⑤未闭合 + C3/B4 约束包 + 护栏 B 双读数 + RAP 零价假设);
|
||||
# clause3_supply——闭合回执双口径更正(锚行 ≈2.0×/2.6× / 期望 ≈1.2×/1.5×、破线约束两轴)。
|
||||
# 详见 design/gdd/reviews/b1-settlement-review-log.md。
|
||||
# 2026-09-13 D1 定稿回填(owner=d1-hud-framework.md):新增 d1_presentation_surface 条目(呈现面契约——
|
||||
# 读图接口清单/订阅纪律/命令式刷新面/载荷 schema 索引/生命周期可见性规则/命名统一/接口漂移登记 ×3);
|
||||
# terminology 增两词条(命令式回执驱动/程序化占位)+ referenced_by 增 D1。solo 模式出稿待人工复核。
|
||||
# 2026-09-14 A5 定稿回填(owner=a5-minesweeper-aux-items.md,solo 模式一次会话定稿、出稿待人工复核):
|
||||
# 新增 a5_aux_items 条目(AuxItemTable 七字段 + MVP 六行【四常规单维 + 两稀有多维,值 provisional 归 C3】+
|
||||
# 真视窄域护栏承重规则 + 叠加层三集语义 + 8 API 面 + use_orchestration 规范序 + F1–F3 + 21 项跨 GDD 义务清单
|
||||
# + A4 EC6/OQ2 与 B4 OQ2 收口);variation_table.mvp_content.counter_item_ids 回填 [probe_dust](A4 预授权
|
||||
# "A5 期回填"兑现——D2 表值与悬空校验激活随 D2/A5 修订批同批落地)+ dangling_ref_policy 首引兑现改写;
|
||||
# terminology 增四词条(叠加层/真视窄域护栏/渗透率 + referenced_by 增 A5)。
|
||||
# 生效前提:B4×①…⑤(category 扩值 aux_item/use_timing 扩 during_dig/默认根六行等)与 D2×①② 修订批——
|
||||
# 未兑现前 RewardTable 含 aux 行会加载致命(B4 Rule 1 预留值拒绝)、A5 GDD AC-12/13 登记 deferral。
|
||||
# 2026-09-14 跨评审回写批(/review-all-gdds 🔴-1/🔴-2 修复,owner=b3/b1/d2 GDD 代用户修订):
|
||||
# 批1(D2 漂移批 + B3 接口漂移批)——status_effect.mvp_content.defense_up magnitude −50→−30(减伤墙批
|
||||
# 2026-09-13 C3 投值的对侧回写落地);rng_service.scope_event_binding 增 encounter 绑定 + referenced_by 增 B1;
|
||||
# stream_seed_derivation 增 salt_encounter=0x8EBC6AF09C88C6E3 与第 6 常量黄金向量(encounter m=42 scope0)+
|
||||
# set_master_seed 全流零计数前提;terminology 免伤轮词条随减伤墙批退役旧例。
|
||||
# 批2(B1 重算批)——status_effect.anchor_warning F0 回执腿读数更新(E_dig 7.2→4.5)+ 参照回迁迁移注记关闭;
|
||||
# clause3_supply.direction_precheck 增 2026-09-14 重算回执(现行值链破线 ≈0.48×/0.47×、约束升格曲线级——
|
||||
# 禁独立调参联动网络 m_w↔D_ref↔m_d↔duration_d);clause5_dominance 增重算回执(v3 曲线四态 + 需求 110.3/166.8 +
|
||||
# 裁决②维持 + 护栏 W2 待重推注记);settlement_table.mechanics 增 B1 F6 充能与护甲克制结算规格登记(W3)。
|
||||
Reference in new issue
Block a user