merge: 文档卫生批落籍（拍板点10甲）——GDD审计口径冲突21文件回写+八文版本史升序重排
This commit is contained in:
DKChan committed
commit
c03a84dc95
21 files changed
+56
-54
No files matched your search
@@ -123,7 +123,7 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体
|
||||
| P1 | 三柜台内容铺量与定价数字 | 柜台结构已定稿；清单明细、几何定价的起步价与公比、Boss 两档产出数值，随设计批配读数投值 |
|
||||
| P1 | 道具工坊钥石直购价 | 首版只挂通关次数渠道（零定价依赖）；定价体系建成后补价，收敛双渠道 |
|
||||
| P1 | 奖励格图鉴的格子内容 | 排 Alpha，随[地图战斗资源](../战斗循环/地图战斗资源.md)差异化批 |
|
||||
| P1 | 换算率表数值行标定 | **已完成**（2026-09-23 换算率标定批——首版三行投值 6/8/1，护甲行强条目重测随批履行并修复护甲断链） |
|
||||
| P1 | 换算率表数值行标定 | **已完成**（2026-09-23 换算率标定批——首版三行投值 6/9/1，护甲行强条目重测随批履行并修复护甲断链）（原系笔误孤例，registry 与 meta.tres 均为 6/9/1——2026-09-30 勘误） |
|
||||
| P2 | 营地界面与解锁呈现实现 | 归[HUD 框架](../表现与支撑/HUD框架.md)协作批，以表现层样张过审为前置 |
|
||||
|
||||
## 调参表
|
||||
|
||||
@@ -73,7 +73,7 @@
|
||||
→ 关卡节点地图加载行集 → 呈现选路停点（现行流程原样续跑）
|
||||
```
|
||||
|
||||
可复现域沿用既有口径：主种子 + 各随机流计数器（语义权威归[冒险结构](冒险结构.md)「失败重开与主种子」节，本文不复述）。抽签每次消费恰一个带编号的 scope，计数器随既有快照契约入档——[存档序列化](../表现与支撑/存档序列化.md)零新增域。同主种子同操作序列的两局，逐位同一张图。
|
||||
可复现域沿用既有口径：主种子 + 全局取数计数器（ADR-0007 裁丙统一流；旧表述系并流前口径）（语义权威归[冒险结构](冒险结构.md)「失败重开与主种子」节，本文不复述）。抽签每次消费恰一个带编号的 scope，计数器随既有快照契约入档——[存档序列化](../表现与支撑/存档序列化.md)零新增域。同主种子同操作序列的两局，逐位同一张图。
|
||||
|
||||
教学位随骨架走：各骨架的"第一场战斗节点"沿用教学位纪律（首遇位固定数量不加骰）——教学位属性是骨架的内容标注，不跟节点编号走（拍板点①裁决后第一关也参与抽签，例外见下节）。
|
||||
|
||||
@@ -163,7 +163,7 @@
|
||||
| 方向 | 系统 / 文档 | 接口要点 |
|
||||
|---|---|---|
|
||||
| 上游 | [冒险结构](冒险结构.md) | 开始关卡流程是抽签时点的宿主；主种子与派生流的语义权威；行集内容责任方（模板内容归它） |
|
||||
| 上游 | [数据配置](../表现与支撑/数据配置.md) | 关卡表模板池列的承载与统一读取；`node_map` 流（提案待拍板）与流种子派生公式的基础设施 |
|
||||
| 上游 | [数据配置](../表现与支撑/数据配置.md) | 关卡表模板池列的承载与统一读取；node_map 统一流用途标签（扩签已落地 v0.5）与流种子派生公式的基础设施 |
|
||||
| 上游 | [难度曲线与Boss](难度曲线与Boss.md) | 模板内遭遇数值的所有权；曲线调参批收口是台阶一的实施门 |
|
||||
| 下游 | [关卡节点地图](关卡节点地图.md) | 实例化行集的供给方；其图合法性校验与全部行进规则零改动 |
|
||||
| 下游 | [存档序列化](../表现与支撑/存档序列化.md) | 抽签 scope 计数器入既有快照契约（主种子 + 流计数器），零新增域；「首次冒险已进行」布尔位为唯一新增存档字段（实施批落 schema） |
|
||||
@@ -218,5 +218,5 @@
|
||||
| v0.1 | 2026-09-27 | **设计草案成文（立项批，用户拍板立项——06 条目「关卡内结构随机生成」随批改状态）**：概念三件套（图模板/模板池/图模板抽签，N=1 回滚档）、抽签时机（开始关卡内逐关抽、主种子派生 `node_map` 流提案）、三级台阶路线（抽签→属性随机→全程序）、MC 测量对账三条款（分层出数/基线可比/实施门=曲线调参批后）、五拍板点、依赖表与验收草案。实施未开工；术语入 registry 词汇表随定稿批执行 |
|
||||
| v0.2 | 2026-09-27 | **首轮裁决落文批（用户拍板①④⑤+路线确认）**：①第一关参与抽签、仅首次冒险走固定脚本——新增「首次冒险的固定脚本」节（存档域布尔标志「首次冒险已进行」、收束点置位、边界与测量口径，P0/验收/依赖表同步）；④首版池规模=每关 5 张（调参表投值）；⑤抽签时点确认；用户并裁「骨架不完全固定、多份随机调取」= 台阶一路线确认（台阶节补白话块+教学位随骨架走注记）。②③补证据面待复裁——新增「拍板点证据面」节：A=随机流/增流白话释义+两选项；B=台阶一详解（玩家看到什么/做三件/不做两件/内容形态 15 骨架/遭遇表按编号共用约束）+实施时点三选项（A 立即全上/B 等调参批/C 机制先行骨架随后，荐 C）；测量对账实施门条款同步改"随机量扩池守门、机制可先行"口径 |
|
||||
| v0.3 | 2026-09-27 | **②③终裁落文批（用户两轮复裁）**：②统一用一个流·全面执行——全游戏 rng 架构批先行（[ADR-0007](../../../dev/architecture/adr-0007-rng-single-stream.md) 评估书交付：核心发现=七流系同一主种子的盐值分栏、字面目标现行已满足；待裁决=甲维持分栏/乙物理并流/丙并流+全事件日志），本特性实施排队其后（P0 补前置行、抽签节流形态改随 ADR 结论）；③特性内机制先行骨架随后（池暂 N=1、骨架内容批扩池）；证据面 A 补裁决注记。06 新立「全游戏随机流统一架构批」条目（数据配置节） |
|
||||
| v0.5 | 2026-09-28 | **台阶一实施落地批（M-3 迭代 5 T5）**：P0 六项全落地——①关卡表逐关行 templates 池（3 关 × 5，模板 0 = 现行图回滚档；L1 单链排列变体〔图形态 Boss 最大编号 vs 遭遇深度 4 两不可全〕/L2L3 网状变体〔战斗编号恒 ∈ 遭遇表行集、商店必经位承袭〕）②node_map 扩签（标签不参与派生只进事件日志，黄金向量零改动）③首次冒险固定脚本（存档唯一新增布尔位「首次冒险已进行」、老档迁移=true、收束点置位幂等、测量夹具恒抽签）④池内全模板加载校验（validate 抽出 + config_db 跨表校验模板感知）⑤抽签确定性/零 scope 强制/N=1 等价/首冒分支 冒烟断言（558→576）⑥MC 分层出数（RUNSUM level_templates）。内容批生成器 = tools/t5_build_templates.py（生成前自校验）。遗留：台阶二/三后置不变；正式侧生存链/带面影响随读数批 |
|
||||
| v0.4 | 2026-09-27 | **实施前置解除批（统一随机流批随批——rng 架构批已按 ADR-0007 裁丙落地）**：状态行改实施解锁；抽签节流形态定稿 = 统一流扩签新用途标签 `node_map`（标签不参与派生、只进事件日志——并流后派生隔离概念退役）；P0 闭环前置行改解除口径。本批只记架构依赖解除，特性实施仍未开工 |
|
||||
| v0.5 | 2026-09-28 | **台阶一实施落地批（M-3 迭代 5 T5）**：P0 六项全落地——①关卡表逐关行 templates 池（3 关 × 5，模板 0 = 现行图回滚档；L1 单链排列变体〔图形态 Boss 最大编号 vs 遭遇深度 4 两不可全〕/L2L3 网状变体〔战斗编号恒 ∈ 遭遇表行集、商店必经位承袭〕）②node_map 扩签（标签不参与派生只进事件日志，黄金向量零改动）③首次冒险固定脚本（存档唯一新增布尔位「首次冒险已进行」、老档迁移=true、收束点置位幂等、测量夹具恒抽签）④池内全模板加载校验（validate 抽出 + config_db 跨表校验模板感知）⑤抽签确定性/零 scope 强制/N=1 等价/首冒分支 冒烟断言（558→576）⑥MC 分层出数（RUNSUM level_templates）。内容批生成器 = tools/t5_build_templates.py（生成前自校验）。遗留：台阶二/三后置不变；正式侧生存链/带面影响随读数批 |
|
||||
@@ -64,7 +64,7 @@
|
||||
|
||||
每个节点在关卡内领一个**节点编号**（本文含义：关卡内不重复的序号，用来当战斗的定位地址；数据键沿用切片字段 `node_depth`）。Boss 的编号恒为全图最大——"最深处的房间是关底"这条直感由此保留。单链特例：一张每步只有一条连线的图就是一条链，此时节点编号等于它前面走过的战斗场数。第一关行集就是单链特例，切片代码零改动运行；分支图行集随第二关内容批落地（见 P1）。
|
||||
|
||||
呈现侧口径（2026-09-17 用户拍板）：节点图的画面表达走**方块地牢观感**——节点画成地牢房间的方块、连线画成通道——但逻辑拓扑就是本文的节点图，不产生任何额外选路或探索语义。关卡画面本体即节点链进度的呈现载体（选路覆盖层的常驻形态，节点态直接读图：已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 紫赤描边（旗朱→紫赤 2026-09-26 封印紫批）），不另设进度条组件；视觉规格归 [HUD 框架](../表现与支撑/HUD框架.md)。
|
||||
呈现侧口径（2026-09-17 用户拍板）：节点图的画面表达走**方块地牢观感**——节点画成地牢房间的方块、连线画成通道——但逻辑拓扑就是本文的节点图，不产生任何额外选路或探索语义。关卡画面本体即节点链进度的呈现载体（选路覆盖层的常驻形态，节点态直接读图：已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 封印黑描边（旗朱→封印紫→封印黑 #000000，2026-09-28 用户拍板现行）），不另设进度条组件；视觉规格归 [HUD 框架](../表现与支撑/HUD框架.md)。
|
||||
|
||||
**商店覆盖层呈现**（呈现 spec：[design/gdd/ux/shop.md](../../ux/shop.md) v1.0，2026-09-30）：兑付 = 打开商店覆盖层（模态）——三商品卡全陈列、GP 余额读数、购买/离开；离开后兑付确认回选路。本节锁编排面（何时开/何时关/回选路），呈现细节归 spec；定价数值归[难度曲线与Boss](难度曲线与Boss.md)（shop.tres）。
|
||||
|
||||
|
||||
@@ -74,7 +74,7 @@
|
||||
|
||||
一场冒险由关卡串成。关卡（本文含义：地牢一层的完整推进——一条节点链加一个关底 Boss）的序列读关卡表：逐关一行的配置表，本文是它行集内容的责任方，表本体与读取机制归[数据配置](../表现与支撑/数据配置.md)。
|
||||
|
||||
MVP 的序列是两关线性：第一关是地牢基线，第二关在基线上加入新元素并抬高数值台阶（"新元素"具体是什么，见「待办」——原表述绑定的机制已从设计中移除）。通关一关（该关关底 Boss 被击杀）自动进下一关；冒险通关 = 最后一关的关底 Boss 被击杀。没有跳关、没有回头路；关卡行进走[关卡节点地图](关卡节点地图.md)的分支节点图（切片第一关为单链特例）。
|
||||
MVP 的序列是三关线性：地精洞窟→幽暗地域→灰矮人矿城（2026-09-21 生效）。通关一关（该关关底 Boss 被击杀）自动进下一关；冒险通关 = 最后一关的关底 Boss 被击杀。没有跳关、没有回头路；关卡行进走[关卡节点地图](关卡节点地图.md)的分支节点图（切片第一关为单链特例）。
|
||||
|
||||
第二关的生效有前提：要等[难度曲线与Boss](难度曲线与Boss.md)的第二关深度轴行值填充批落地。未落地前，冒险以单关运行——单关冒险是合法状态，不是缺陷。
|
||||
|
||||
@@ -152,7 +152,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
|
||||
### 关卡大奖励：通关一关发三件
|
||||
|
||||
关卡大奖励（本文含义：通关一关时固定发放的三件套）是非末关通关的固定兑付。它不进任何背包、不占任何库存域，收益面只朝"下一战"生效。兑付时点固定：关卡节点地图先调战斗结算的关卡收束接口清空关卡域库存，再向本文宣布关卡结束——大奖励在这之后、下一关开始之前兑付，顺序不可换。上限已有加成时，后续大奖励累加；两关冒险至多兑付一次。
|
||||
关卡大奖励（本文含义：通关一关时固定发放的三件套）是非末关通关的固定兑付。它不进任何背包、不占任何库存域，收益面只朝"下一战"生效。兑付时点固定：关卡节点地图先调战斗结算的关卡收束接口清空关卡域库存，再向本文宣布关卡结束——大奖励在这之后、下一关开始之前兑付，顺序不可换。上限已有加成时，后续大奖励累加；非末关每关各兑付一次（现行三关下至多两次，末关不兑付）。
|
||||
|
||||
| 件 | 内容 | 生效方式 |
|
||||
|---|---|---|
|
||||
@@ -218,7 +218,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
|
||||
| 方向 | 系统 | 接口要点 |
|
||||
|---|---|---|
|
||||
| 上游 | [难度曲线与Boss](难度曲线与Boss.md) | 逐关通关率带是序列难度排布的输入；第二关深度轴行值填充批是两关序列的生效前提；大奖励与恢复点数值的联动复验归它 |
|
||||
| 上游 | [难度曲线与Boss](难度曲线与Boss.md) | 逐关通关率带是序列难度排布的输入；三关序列均已生效（地精洞窟→幽暗地域→灰矮人矿城），无未落前置；大奖励与恢复点数值的联动复验归它 |
|
||||
| 上游 | [数据配置](../表现与支撑/数据配置.md) | 关卡表与冒险表（单行全局）的承载与统一读取，本文是两表的内容与回填责任方；主种子的注入入口（随机服务） |
|
||||
| 上游 | [战斗结算](../战斗循环/战斗结算.md) | 主角战斗入参覆盖值通道（本文供生命与上限）；关卡收束接口由关卡节点地图收束点调用，本文零直调；战后生命终值与本战 GP 掉落（gp_dropped）经上报读回 |
|
||||
| 下游 | [关卡节点地图](关卡节点地图.md) | 接口契约四件套 + 收束点语义，本文是定义源，也是其文档的强制输入 |
|
||||
@@ -242,7 +242,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
|---|---|---|
|
||||
| P2 | 大奖励形态扩展（三选一 / 攻击型 / 通关加成） | 冒险表扩列结构位已留；设计随元进度定稿 |
|
||||
| P2 | 冒险开始参数面消费 | 预留给未来跨局加成注入（MVP 空参数，结构同覆盖值通道）；归元进度 |
|
||||
| P2 | 冒险长度扩展（多于两关） | MVP 两关对比愿景单局 20–40 分钟；扩关 = 内容批，节奏按真人单关时长数据定 |
|
||||
| P2 | 冒险长度扩展（多于三关） | MVP 两关对比愿景单局 20–40 分钟；扩关 = 内容批，节奏按真人单关时长数据定 |
|
||||
|
||||
## 调参表
|
||||
|
||||
@@ -272,7 +272,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
- 大奖励覆盖：大奖励后首战的上限入参 = 旧上限 + 上限提升（覆盖值通道）；攻击力恒走表值通道。
|
||||
- 收束次序：通关宣布到达时库存已被关卡节点地图先行清空；重复的关卡结束宣布被拒绝，账本与摘要零变化。
|
||||
- 覆盖义务：冒烟断言——行集内每个战斗与关底节点（关、深）在敌人与棋盘生成的数值表中有精确行；序列关数 = 行集关数。
|
||||
- 生效前提未兑现（第二关行缺行）：以单关冒险运行（合法态），两关断言显式跳过而非失败。
|
||||
- 生效前提未兑现（第二关行缺行）：以单关冒险运行（合法态），越界关断言显式跳过而非失败。
|
||||
- 放弃：战斗中的放弃请求被拒绝；非战斗期放弃按失败同型结算，已获大奖励不追回；放弃入口仅在选路停点呈现且只在冒险模式开放。
|
||||
- 种子域：冒险内零随机流自开，一切随机派生自主种子（含 GP 掉落掷定的 gp_drop 封闭流）；同种子同操作序列两局逐位可复现。
|
||||
- GP 账本封闭：钱包只有三个收口——战斗完成入账恰一次（掉落掷定 + 关级加值 + 战斗内缓冲合计）、商店购买出账、冒险收束清零；战斗内缓冲与钱包隔离，战斗进行中钱包零变动。
|
||||
|
||||
@@ -112,7 +112,7 @@ MVP 行值并不逐式现算，而是按此式量级直填经切片验证过的
|
||||
|
||||
| 带 | 定稿口径 | 含义 |
|
||||
|---|---|---|
|
||||
实证：直入口 L2 普通 5% vs 冒险条件口径 L2 90% 同期并存〔「营地检查点」= balance_verifier 营地循环判定段旧称（现名营地循环战役）——2026-09-30 词源考证收口，见 design/research/gdd-concept-coverage-audit-2026-09-30.md 拍板点 9；与冒险结构「没有检查点」铁律的字面相撞就此解除〕
|
||||
| 通关率带 | 口径已换·现行带：普通档 L1 [35,55] / L2 [10,15]（2026-09-30 改带）；完美档 [35,65]，详见本节末「判读口径同步」与「改带」两条。实证：直入口 L2 普通 5% vs 冒险条件口径 L2 90% 同期并存〔「营地检查点」= balance_verifier 营地循环判定段旧称（现名营地循环战役）——2026-09-30 词源考证收口，见 design/research/gdd-concept-coverage-audit-2026-09-30.md 拍板点 9；与冒险结构「没有检查点」铁律的字面相撞就此解除〕 | 首关吃紧但多数玩家数局内能过；第二关明显更难（L2 低通关率系设计预期，2026-09-30 改带批用户裁定）；与完美档带错开一档留出元进度爬升空间 |
|
||||
| 通关余量带 | 通关者通关时剩余生命的 p90 / p10 按现生命轴上限百分比表达（压缩前绝对血量带已作废；界值重标随验收批） | **通关余量** = 通关瞬间还剩多少血。余量太肥说明赢得太从容，压生存侧；太瘦说明"剩一两滴血惨胜"成常态，抬治疗供给或恢复点收益 |
|
||||
| 第一关形态带 | 教学位绿档 + 中段黄档 + Boss 黄档不红 | **形态带**管一关内各战三档判定的排布形状：第一战必须稳过，中段有输的可能，Boss 战紧但不许是配置事故 |
|
||||
|
||||
@@ -296,7 +296,7 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板
|
||||
- 零红档：全部行集经区间扫描，不存在"最好情况也打不过"的战斗组合。
|
||||
- 教学位绿档：第一关第一战与各新敌种首遇位的区间判定为绿档。
|
||||
- 形态带成立：第一关形态 = 教学位绿 + 中段黄 + Boss 黄不红。
|
||||
- 通关率带：⚠ 口径退役待重锚（2026-09-23）——原带第 1 关 ∈ [35%, 55%]、第 2 关 ∈ [25%, 45%]（2026-09-20 分带批）锚定直入口单关读数，该口径随单关试玩入口一并退役；逐关读数改冒险条件口径（balance_verifier 报告①），新带值重锚归曲线调参批，重锚前只测不判（旧重投读数 L1 47%/L2 34% 系直入口口径，production/qa/mc-reinvest-baseline-2026-09-20.md 留档不作判据）。
|
||||
- 通关率带：口径已换·现行带——普通档 L1 [35,55] / L2 [10,15]（2026-09-30 改带）；完美档 [35,65]。测量口径 = 冒险条件通关率（逐关读数由 balance_verifier 冒险段派生，单关直入口口径已随 2026-09-23 拍板退役）；判读细则见「期望值带」节「判读口径同步」与「改带」两条。
|
||||
- 通关余量带：通关者剩余生命 p90 / p10 按现生命轴上限百分比表达，界值重标随验收批。
|
||||
- 恒等式闭合：关级通关恒等式逐项对账闭合，残差 <5%（provisional 阈值）；奖励输出占比 ∈ [15%, 40%]。
|
||||
- Boss 锚在案：每个 Boss 行的血量锚比率记录在案且落在现行带内；越带须登记，不静默变更。
|
||||
@@ -331,3 +331,5 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板
|
||||
| v0.17 | 2026-09-20 | **第三关内容批（灰矮人矿城——与切片代码 / registry / 03-内容规模 / 棋盘生成 / 地形变异 同批，存量行值零改动）**：调参表新增第三关图版注记——敌种生态（灰矮人 duergar 单体重甲中坚 + 钩爪恐魔 hook_horror 群行复用撕咬 + Boss 灰矮人石君王 duergar_king 专属池独占妨害技大地脉动 = 乏力 sapped 第二妨害词汇首发）、首遇位节点 0/1 固定数量不加骰、克制面重轻错开（重甲首次登台，教学梯度轻→魔→重在 L3 补完）、Boss 血量锚 75 = Σ91 × r_boss≈0.82、棋盘 13×13 / Boss 14×14 密度 0.25 维持、地形落石 3 点 + 矿尘、armor_class 恒 0（正式投值仍归在案条目全表同批）；期望值带节补 L3 口径——行值 provisional-pending-growth，零成长基线红档属预期、冒烟首遇绿档按成长代理档（atk+200 / hp+100）口径，正式通关率带与首遇绿档口径随 L3-A 玩家成长批（GP + 商店房）换装，归曲线调参批统一收带 |
|
||||
| v0.18 | 2026-09-20 | **GP+商店房批（用户拍板"骨架先行、数值整体后置"——与 关卡节点地图 v1.1 / 冒险结构 v0.5 / 战斗结算 v0.23 / 地图战斗资源 v0.15 / registry / 切片同批，行值零改动）**：① 新增「商店与 GP 经济杠杆」节——GP 供给 × 商品定价 = 第三族玩家侧杠杆（掉落均值±方差 / 关级掉落加值 / 关级价格加成 / 首价与步长，全部读 shop.tres provisional-pending-曲线调参批），定价锚定口径 = 正常运气与运气极好可购档数的数学期望（期望账进商店表批注）；② 分层验收 defer 成文——shop=off/on 双格 MC、shop=on 带平移、换算率登记全部随曲线调参批执行（与「基线通关率越带」「L2 Boss 承伤微越带」「大奖励数值联动」同窗），执行前 shop=on 只登记不判读；③ L3 首遇绿档成长代理档口径不变；④ 调参联动表 +GP 供给↔商品定价行、调参表 +shop.tres 行、验收标准 +杠杆在案条目 |
|
||||
| v0.19 | 2026-09-23 | **基线通关率带测量口径退役（用户拍板单关直入口口径退役——与单关试玩入口退役同批）**：原带（第 1 关 [35,55] / 第 2 关 [25,45]，v0.16 分带批）锚定直入口单关读数——满血零上下文进关，与真实冒险的条件通关率脱节（实证：直入口 L2 普通 5% 与营地检查点 L2 条件 90% 同期并存，曾误导曲线调参）。逐关读数改冒险条件口径（balance_verifier 冒险段派生：通关数/到达数）；新带值重锚归曲线调参批，重锚前只测不判；调参表「基线通关率带」行与验收标准通关率带条同步改口径退役注记。行值零改动 |
|
||||
| v0.20 | 2026-09-28 | 判读口径落档+回滚阶梯收编+Boss 锚漂移登记 |
|
||||
| v0.21 | 2026-09-30 | 普通档改带 L1 [35,55]/L2 [10,15]+带表与验收标准回写现行口径 |
|
||||
@@ -240,8 +240,8 @@
|
||||
| v0.6 | 2026-09-16 | **护甲等级掷点批·换装（与战斗结算 / 增益状态 / registry / 切片同批）**：defense 型正向行 defense_up（减伤 −30%，hero_defense 池）换装为 ac_up（护甲强化 +1 护甲等级/层 ×2 层，显示名暂定"护甲强化"）——百分比减伤行无双轨退役；cell_type defense / 权重 16 / 档位 2 零改动（v0.6 当下类型频次合计 79；v0.7 数值压缩批后 heal_minor 权重 15→3，合计降至 67——见 v0.7 条）；五型字典表与 mvp 行表同步 |
|
||||
| v0.7 | 2026-09-17 | **数值压缩批·文档同步（与 doc-conventions.md §5 数值纪律·强制收口条款同批）**：整体绝对值轴 ÷3（24/7→8/2 等，见 `data/tables/enemy.tres` 注释）；奖励表 heal_minor 权重 ÷4（15→3）；reward.tres 三 flat 行同步（spark_aoe power 4→1 · heal_backlash power 4→1 · heal_minor power [2,6]→[1,1] 定值）；clear_blast 区间 [25,55]→[8,18]（中点 13，期望不漂移）。**双写失同步收口**：① 五型字典表与调参表数值列改指路存根（指向 `data/tables/reward.tres` 与 `registry/entities.yaml` reward_table mvp_content）；② 文档表格只锁字段语义与取值域，不再列具体数；③ 与 `增益状态.md` v0.7 / `registry/entities.yaml` 同批落地——五步收口（`.tres` 落批 · 切片 smoke 跑通 · GDD 表格指路化 · registry mvp_content 指路化 · 待办清单现状刷新）一并兑现 |
|
||||
| v0.8 | 2026-09-17 | **候选集合节补强（与代码对齐）**：在「格面资源」节后新增「候选集合：安全格与雷格的资源池」——明确安全格与雷格候选集 = cell 池正向 5 行全集（attack_up · ac_up · spark_aoe · heal_minor · weaken），权重分布相同，类型频次合计 67（v0.7 压缩批后）。清图槽 clear_blast 独立于格面资源、板级作用域。代码事实源：`core/reward_economy.gd#roll_board`（`_rollable_rows` 不分格型）+ `core/minesweeper_rules.gd#_do_dig`（cell_revealed 通道 `resource=true` 对两种格一致）。同步修正 v0.6 历史条目"类型频次合计 79 不变"——v0.7 后改 67 |
|
||||
| v0.10 | 2026-09-18 | **伤害道具批（用户指令，2026-09-18）**：① 五型→七型——增补 pierce（穿刺）/ magic（魔法）两型，各正负一行：正向 = 单目标克制直伤道具（pierce_strike 穿刺弹 / magic_bolt 魔法矢，attack_type 字段载攻击类型轴，查战斗结算克制矩阵、必中全额不掷点、目标 = 固定顺位最前存活敌）；负向 = 主角直伤（pierce_snare 穿刺陷阱 / magic_recoil 魔法反噬，复用反噬通道不经增益状态）；② 权重再平衡（用户指令"保爆裂粉尘不变、等比下调其余"）：spark_aoe 16 不动，attack_up 20→14 · ac_up 16→11 · heal_minor 3→2 · weaken 12→8（等比基准 ×35/51≈0.686，整取微差登记已知偏差），新行各 8——类型频次合计仍 67；③ 结构冻结"五型封闭"按 owner 修订流程改"七型封闭"；切片同批落地（reward.tres 四新行 + schema 七型枚举 + attack_type 校验 + 结算兑付分支 + 棋盘徽标 穿/魔 + smoke 295 全绿；断言"主角先手攻击行存在"放宽为"存在或授予段终局"——单弱敌可被挖掘期兑付单独击杀，战斗段整段跳过为合法结局） |
|
||||
| v0.9 | 2026-09-17 | **数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 `data/tables/*.tres` 与 registry），3 处失同步值修正**——候选集合节"合计 = 67"字面量改指路 reward.tres cell 池正向行 weight 之和（现行值读表）；候选集合表"类型频次合计"列两处 67 改"见 reward.tres"；代码事实源清单五型 weight 明细（attack_up 20 · ac_up 16 · spark_aoe 16 · heal_minor 3 · weaken 12）改"5 行正向行 weight 现行值读 reward.tres" |
|
||||
| v0.10 | 2026-09-18 | **伤害道具批（用户指令，2026-09-18）**：① 五型→七型——增补 pierce（穿刺）/ magic（魔法）两型，各正负一行：正向 = 单目标克制直伤道具（pierce_strike 穿刺弹 / magic_bolt 魔法矢，attack_type 字段载攻击类型轴，查战斗结算克制矩阵、必中全额不掷点、目标 = 固定顺位最前存活敌）；负向 = 主角直伤（pierce_snare 穿刺陷阱 / magic_recoil 魔法反噬，复用反噬通道不经增益状态）；② 权重再平衡（用户指令"保爆裂粉尘不变、等比下调其余"）：spark_aoe 16 不动，attack_up 20→14 · ac_up 16→11 · heal_minor 3→2 · weaken 12→8（等比基准 ×35/51≈0.686，整取微差登记已知偏差），新行各 8——类型频次合计仍 67；③ 结构冻结"五型封闭"按 owner 修订流程改"七型封闭"；切片同批落地（reward.tres 四新行 + schema 七型枚举 + attack_type 校验 + 结算兑付分支 + 棋盘徽标 穿/魔 + smoke 295 全绿；断言"主角先手攻击行存在"放宽为"存在或授予段终局"——单弱敌可被挖掘期兑付单独击杀，战斗段整段跳过为合法结局） |
|
||||
| v0.11 | 2026-09-18 | **战斗数值结构修复批·极性矩阵同步（2026-09-18 盘问会话用户拍板，与战斗结算 v0.14 / 增益状态 v0.9 / registry / 切片代码同批）**：① defense 型负向 off_guard 行失同步修正——原残留"hero_defense 池，承伤加深"改"AC 掷点阈值轴负向、不入池"（off_guard 换装 AC 轴随结构修复批落地，effect_pool_map 删键）；② weaken 型正向行补续时定案注记（同名重复授予只刷新剩余次数——2026-09-18，叠层措辞随批退役） |
|
||||
| v0.12 | 2026-09-19 | **插旗不可逆批·极性矩阵同步（用户拍板全套落地，与战斗结算 v0.18 / 排雷玩法 v0.5 / registry / 切片代码同批）**：矩阵「标旗后当轮撤旗」行删除（撤旗动作退役）、「插旗格直接挖开」行新增——安全格零兑付（四情况④零惩罚零奖励）、雷格负向照常（四情况②只受挖雷一层惩罚、标中不发）；路由描述「抵消过滤」随战斗结算改「判定基线」 |
|
||||
| v0.13 | 2026-09-20 | **伏击单轮上限删除批同步（与战斗结算 v0.19 / 敌人系统 v0.11 等同批）**：负向即时节 blast 负向的伏击上限护栏与溢出行协议措辞删除，改直授无上限 |
|
||||
|
||||
@@ -149,8 +149,8 @@
|
||||
|
||||
| 状态 | 效果一句话 | 发给谁 | 幅度（现行值） | 时限 / 合并 | 来源类别 |
|
||||
|---|---|---|---|---|---|
|
||||
| attack_up 增伤 | 主角攻击提升 | 主角 | 见 `data/tables/status_effects.tres` attack_up 行 | 时限/上限读表 / 叠加 | 安全格 |
|
||||
| ac_up 护甲强化 | 主角护甲等级提升（掷点折扣判定阈值——AC 轴，不入池） | 主角 | 见 `status_effects.tres` ac_up 行（2026-09-16 换装，原 defense_up 行已退役，见版本历史） | 时限/上限读表 / 叠加 | 安全格 |
|
||||
| attack_up 增伤 | 主角攻击提升 | 主角 | 见 `data/tables/status_effects.tres` attack_up 行 | 时限/上限读表 / 刷新（2026-09-20 续时批 stack→refresh，层数恒 1） | 安全格 |
|
||||
| ac_up 护甲强化 | 主角护甲等级提升（掷点折扣判定阈值——AC 轴，不入池） | 主角 | 见 `status_effects.tres` ac_up 行（2026-09-16 换装，原 defense_up 行已退役，见版本历史） | 时限/上限读表 / 刷新（2026-09-20 续时批 stack→refresh，层数恒 1） | 安全格 |
|
||||
| alert 警觉 | 敌方护甲等级 +1/层 | 敌方 | 见 `status_effects.tres` alert 行 | 1 结算 / 叠加读表 | 踩雷（blast 型负向） |
|
||||
| weaken 削弱 | 敌方攻击被削弱（同名重复标中只刷新剩余次数、层数恒 1） | 敌方 | 见 `status_effects.tres` weaken 行（取值域 [60,85]，取负生效） | 时限读表 / 刷新（2026-09-18 续时定案） | 标中旗 |
|
||||
| enrage 暴走 | 敌方攻击提升 | 敌方 | 见 `status_effects.tres` enrage 行 | 时限/上限读表 / 叠加 | 标空旗反噬 |
|
||||
|
||||
@@ -372,16 +372,16 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值
|
||||
| v0.9 | 2026-09-16 | 新增「呈现只读面」节（06 清单「呈现只读面契约登记缺口」闭合）：把切片已实现的呈现面函数与信号登记为对外契约——呈现状态快照 `presentation_snapshot`、战斗进行中谓词 `is_battle_live`、奖励身份查询 `query_reward_identity`、结算快照信号 `settlement_snapshot`、战斗结束信号 `battle_finished` 五件成文（载荷字段、消费方、销毁前捕获语义），并登记"呈现层唯一状态读取出口、禁链式穿透"的出口纪律与诊断观测面的非契约定位；依赖与输出表 HUD 框架下游行补指路 |
|
||||
| v0.10 | 2026-09-16 | **护甲等级掷点批·定稿落地（用户拍板，数字即规范——与敌人系统 / 难度曲线与Boss / registry / 切片代码同批）**：判定式定稿——掷 1d20，掷点 ≥ 防守方护甲等级 + 攻击加成（结构位 `attack_bonus`，切片恒 0）→ 全额，低掷按缺口三档折扣（1-3 → ×0.75 · 4-7 → ×0.5 · 8+ → ×0.25，无零档）；nat20 暴击该基础攻击分量 ×2 且恒全额（双方同规）；伤害下限全局 max(1, ·)（`damage_floor` = 1）——"被减伤归零 v=0"零值伤害行语义退役，重档折扣行文本记"被压制"；百分比减伤增益 defense_up 整体退役换装 ac_up（护甲强化 +1 AC/层 ×2 层，`unit=ac` 新量纲、不入任何池，无双轨），off_guard 与池结构零改动；护甲等级与护甲类型分离成文（数值轴 / 属性轴，不做映射）。数值载体：主角 armor_class 10（暂定）、敌方首关 0（暂定，正式行值归怪物设定批，登记待办清单）；掷点流归属定稿 = `armor_roll` 封闭流（逐次掷逐次取号，可逐位回放），调参表掷点/档位/下限/加成五行由未定改拍板值；EV 参考数成文（AC10 21.25% / AC11 25% / AC12 28.75%，按判定式复算），换装点锚定（基准 AC10 自带约 −21% 敌方输出期望）与加难杠杆扫描合并处理；验收标准改写掷点条目 + 新增伤害下限与留档条目；切片同批：settlement.tres 七参数入表、战斗段掷点判定/暴击/下限/行留档（roll/ac/tier/crit 字段）、armor_roll 流接入 rng_service（黄金向量 m=42 scope0 = 4806095330042243845）、零值伤害行分支删除、冒烟护栏与掷点行为断言（nat20 种子 / AC12 档位分布 / 池触底保底 / 棋盘必中）、英雄卡与敌人卡 AC 展示、ac_up 状态槽图标、nat20 金框高亮 |
|
||||
| v0.11 | 2026-09-16 | **敌人技能池批（用户拍板，设计权威 docs/proposal-skill-pool.md v1.0——与敌人系统 / 增益状态 / 难度曲线与Boss / 战斗表现 / HUD框架 / registry / 切片代码同批）**：① 随机口径两处 → 三处——技能摇号 `behavior_roll` 封闭流（回合内、开轮时点、步骤流之外，每敌按生成序派生独立子流、单敌轨迹可独立复放）入册，可回放契约扩写为"三处皆封闭流，同种子同输入逐位复现"；② 战斗段成文开轮摇号与敌方技能兑现（每轮恰摇一次、轮内刷新不重摇、摇定后兑现前死亡作废）、增益技 = 施放行 + 状态授予（0 伤害不掷不折不兑伏击）；③ 三乘法链成文（技能倍率乘在最前：基线 × 倍率 → AC 掷点 → 甲效 → 既有链不动）；④ AC 判定对象措辞四处改述（"敌方攻击拍与重击拍基线" → "敌方技能基础伤害分量"，含正文/公式行/边界表/验收标准）；⑤ 敌方防御池入乘区（`enemy_defense` 新池——硬化载体）：主角攻击 Σ三分量后 ×(100+enemy_defense)/100，四池对称成文（hero_offense 现行走普通分量直乘的切片现状登记待办）；⑥ 行型改型：蓄力行 `charge` → 施放行 `cast`（10 类封闭不变）；⑦ 呈现快照敌人数组字段定稿（当前拍/行动环进度 → 摇定动作三字段 + 敌方增益 effects）；验收标准新增开轮摇号条目、战斗段次序与可回放条目改写；切片同批：`_roll_round_actions` 开轮编排、技能摇号器独立服务类、单位容器实例池/冷却/执行上报、settlement.tres effect_pool_map 增 empower/fortify、施放行格式化、摇定动画位 |
|
||||
| v0.13 | 2026-09-18 | **营地扩展前置批·主角双轴可配置（用户指令，与敌人系统 / registry / 切片代码同批）**：① hero 表新增 armor_type（{light, ward, heavy}，缺省 light）——主角护甲类型轴可配置可修改，消费面 = 甲效矩阵（现行敌方攻击恒 normal 档 = 数值中性的结构位，轴生效待敌方技能攻击类型批）；② hero 表新增 attack_type（{normal, pierce, magic}，缺省 normal）——**基础攻击量与攻击类型抽象分离**：基础分量类型不再硬编码普通、改读主角表值，营地永久强化"换成魔法/穿刺攻击"= 改字段，atk 量轴与掷点口径零改动；③ 同桶充能照加语义成文（基础分量与充能同型时，充能分量保持不掷不折）；正文三分量表述、甲效矩阵"普通"行注记、分量固有属性措辞三处同步 |
|
||||
| v0.12 | 2026-09-17 | **数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 `data/tables/*.tres` 与 registry），20 余处失同步值修正**——收益对照表参考敞口 12 / 完美乘数 200 改指路 settlement.tres（equivalence_ref_damage / p_perfect）；伏击加层"+2 层"改"+stacks 层（读 reward.tres ambush_double 行）"；充能供给表与 charge_grants 行"每格 1 / 上限 8 / 每雷 2"改 per_unit/cap 读表；三乘法链与甲效矩阵 1.5/1.0/0.5、150/100/50 改三档读表；掷点判定 1d20 / nat20 ×2 / 缺口档 ×0.75/×0.5/×0.25 / 边界 [3,7] / 档位 [75,50,25] / damage_floor=1 / AC 10·0 / ac_up +1×2 层全部改指路 settlement.tres·status_effects.tres·hero/enemy 表；EV 参考数（AC10 21.25% 等）与"旧 defense_up 满层 −60%"删除（派生读数 / 退役值，版本历史可查）；调参表与验收标准同步 |
|
||||
| v0.13 | 2026-09-18 | **营地扩展前置批·主角双轴可配置（用户指令，与敌人系统 / registry / 切片代码同批）**：① hero 表新增 armor_type（{light, ward, heavy}，缺省 light）——主角护甲类型轴可配置可修改，消费面 = 甲效矩阵（现行敌方攻击恒 normal 档 = 数值中性的结构位，轴生效待敌方技能攻击类型批）；② hero 表新增 attack_type（{normal, pierce, magic}，缺省 normal）——**基础攻击量与攻击类型抽象分离**：基础分量类型不再硬编码普通、改读主角表值，营地永久强化"换成魔法/穿刺攻击"= 改字段，atk 量轴与掷点口径零改动；③ 同桶充能照加语义成文（基础分量与充能同型时，充能分量保持不掷不折）；正文三分量表述、甲效矩阵"普通"行注记、分量固有属性措辞三处同步 |
|
||||
| v0.14 | 2026-09-18 | **战斗数值结构修复批（2026-09-18 盘问会话用户拍板，与增益状态 / registry / 切片代码同批）**：① 主角侧乘区接线——hero_offense 池入主角攻击乘区：Σ三分量后 ×(100+hero_offense)/100 ×(100+enemy_defense)/100 两池串乘，增伤/乏力覆盖面 = 普通+穿刺+魔法 合计；attack_up 普通分量直乘旁路退役（正文甲效矩阵"普通"行注记、池乘区公式行、v0.11 切片现状注记三处同步销项）；② off_guard（失衡）换装 AC 轴——unit percent→ac（幅度 provisional 归状态层重设计批），effect_pool_map 删 off_guard 键，hero_defense 池清空、结构保留，消费走既有掷点判定读法零改动；③ fortify（硬化）符号纠正——旧 +100 入敌方防御池实际 ×2 翻倍与"硬化=减伤"语义相反，改负值（读表）后主角攻击折半；④ weaken（削弱）叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1，×2 叠满池触底 ×0 的免伤轮结构性根治（消饱和）；duration 终值、off_guard 幅度、当量锚复算全部归状态层重设计批。切片同批：battle_orchestrator 池接线与直乘删除、status_effects.tres 三行、settlement.tres 删键、冒烟护栏（削弱续时 / 乘区接线 ×1.5·×0.75 / 硬化折半方向三组新断言，旧"削弱×2 池触底"采样通道随批退役） |
|
||||
| v0.15 | 2026-09-18 | **甲效矩阵用户调参批（用户逐格给值，事实源 settlement.tres 五格改值、四格不动，零代码）**：普通行 ward 100→120 / heavy 100→50；穿刺行 light 100→80 / ward 150→120 / heavy 50→80；魔法行与普通-轻甲不动——「克制/中性/被克」三档结构与「普通行恒中性」退役，改五档（克制 / 弱克制 / 中性 / 弱被克 / 被克，档值读表）。矩阵消费面成文 = 主角侧（奖励直伤道具 / 主角攻击三分量 / 充能分量），敌方攻击不查矩阵、主角 armor_type 轴仍休眠（v0.13「敌方攻击恒 normal 档故中性」的归因改述——轴休眠是结构性的非数值性的）。语义列两行同步（穿刺「破不开重甲」重压语义弱化为与轻甲同档折损）。切片同批：settlement.tres 批注、冒烟矩阵三行断言改五档读数 + 乘区接线穿刺分量 3→2（3 点 ×80% 取整）随批改形，冒烟 300 项 0 失败 + 四探针 PASS；registry（enemy/hero armor_type 两行注记）与 敌人系统 / 难度曲线与Boss 三档措辞同步 |
|
||||
| v0.22 | 2026-09-19 | **充能退役批（版本号避让注记：原登 v0.16 与甲效矩阵加法核换装批撞号——2026-09-20 R10 版本号唯一性规则上线发现，后落籍者顺延；用户拍板，与切片代码 / registry / 07 清单 / README 同批）**：主角攻击三分量模型（普通 + 穿刺/魔法充能）整体退役，回归单分量——量 = 攻击基线、类型 = 主角表 attack_type；挖格批/旗判定批的充能计数条款删除、充能供给表与 charge_grants 调参行删除、乘区公式与粒度口径改"攻击合计"；退役理由 = 克制策略归冒险前配置（营地换型/未来冒险前参数面），局内不再有挖掘攒弹药的第二伤害供给；保留面 = 攻击类型属性轴与棋盘奖励触发源的抽象分离、奖励直伤道具（穿刺弹/魔法矢）的克制直伤消费不变。切片同批：battle_orchestrator 攻击段单分量化 + _charge_points/_charge_counts/round_facts 充能键删除、DamageMath.charge_component → counter_component 改名（奖励直伤唯一消费方）、settlement.tres charge_grants 键与 schema 校验删除、冒烟充能断言组退役改形（乘区接线单分量基线 100、标中正向兑付行断言、恢复点探针换种子 42）、冒烟 293 项 0 失败 |
|
||||
| v0.16 | 2026-09-18 | **甲效矩阵加法核换装批（用户拍板数值语言——小整数加法核，与 01-核心循环 数值语言条款 / registry / 切片代码同批）**：量纲 percent→整数点数，三档（克制 +1/中性 0/被克 −1）九格改值〔normal 0/+1/−1、pierce −1/+1/0、magic 0/−1/+1〕，pierce×heavy = 0 中性为用户特别拍板；五档词表与百分比乘区退役（v0.15 的五档表随批短命退役，理由=个位数刻度假粒度）；分量算术改述=折算取整后加修正点数；缺项回退 100→0；奖励直伤行 payload 键 effectiveness 保留、值语义改点数；池乘区/AC 折扣档/暴击保留百分比并成文粒度口径（数值语言条款：百分比仅此三处既有粗档+开发侧工具）；切片同批：settlement.tres/settlement_table.gd/damage_math/battle_orchestrator/smoke/registry/01-核心循环同步 |
|
||||
| v0.17 | 2026-09-19 | **技能池新效应词汇批（用户拍板——设计权威 docs/proposal-status-vocabulary.md v1.0，与 敌人系统 / 增益状态 / registry / 切片代码同批）**：① 三乘法链尾部 +必中附加分量 rider（伤害技 rider_mult 字段：max(伤害下限, floor(攻击基线 × rider_mult))——后置加法、必中全额、不进乘区不出暴击、价位锚 0.75 = AC 折扣档最轻档；"固定值伤害"改形——固定值不随基线缩放与共享技能表前提冲突）；② 增益/妨害技 = 同族施放行（0 伤害不掷不折不兑伏击），妨害状态按状态行 target_side 落主角——零新授予通道；③ 必中家族清单 +rider（掷点边界切口）；④ 公式行/吃掷点行/验收标准三处同步 + 新效应词汇验收条目（rider 逐拍精确复算 + rider 键封闭 + 妨害落主角端到端）；⑤ 实装面 = 仅 L2 Boss 卓尔（毒爆 +rider、新行蛛网束缚妨害→失衡），其余敌种不动；多段命中经用户拍板退役不入词汇表 |
|
||||
| v0.18 | 2026-09-19 | **插旗不可逆批（用户拍板全套落地，2026-09-18 提案转正；与排雷玩法 v0.5 / 行动经济 v0.4 / 地图战斗资源 v0.12 / registry / 切片代码同批）**：① 授予段「抵消过滤」改述「判定基线」——撤旗动作退役，旗判定以轮末在场旗为基线，被挖开的旗不入基线；② 新增插旗不可逆四情况兑付表：①标中照常 / ②插旗雷格直挖只吃挖雷惩罚标中不发 / ③标空照常 / ④插旗安全格直挖零惩罚零奖励（正向作废 + reward_ineffective 归因行）；③ 挖格批兑付表补四情况分支；④ 标中资格措辞改「旗无移除手段」（拔旗重插通道消失）；⑤ P0 闭环第 2/4 步与验收标准同步（「抵消过滤」条改「挖旗格兑付改判」）。切片同批：minesweeper_rules 挖旗格放行 + flag_pull 出目录 + dug_under_flag 事件标记、battle_orchestrator 情况④零奖励抑制、action_economy 表 flag_pull_ap_cost 删除、冒烟 317→327 项 0 失败（四情况探针 `_smoke_flag_irreversible_quadrants`） |
|
||||
| v0.19 | 2026-09-20 | **伤害下限全来源批（用户拍板「任何伤害取值域 [1,+∞)，最小值一定是 1」；与 06 清单「零伤害/无威胁组合的跨字段护栏」收口 / registry / 切片代码同批，台账 100）**：① 下限语义从"任何攻击落地伤害"扩为"任何来源的伤害落地"——攻击双方（原有）＋棋盘克制直伤（counter_component 增 landed_floor 参数，空桶不吃修正恒 0 边界不变）＋爆裂正向＋负向反噬（穿刺陷阱/魔法反噬/heal 反噬）＋地形变异 flat_damage，全部收进 damage_floor 闸内；② 取值域成文 [1, +∞) **不设上限**——「零伤害/无威胁组合」条目的跨表上界护栏半边随拍板裁决为不设（上不封顶），敌种攻击基线 0 的退化态经下限自然消解（0 基线攻击落地仍 ≥1，"无威胁敌"结构性不存在）；③ 现行表值下零行为变更（棋盘直伤贴底值 2−1=1 本就在闸内），本批=结构保证+调参防误配；④ 判读口径/约束表/调参表/验收四处措辞同步；冒烟 352→355 项 0 失败（+贴底/穿透/空桶三断言）。版本号注记：v0.19 在伏击上限删除批（未合并分支）中已被占用，本条与之合并时以先落籍者为准顺延避让 |
|
||||
| v0.20 | 2026-09-20 | **伏击单轮上限删除批（用户拍板——与 敌人系统 / 地图战斗资源 / 难度曲线与Boss / registry / 切片代码同批）**：① 行型协议 10 类→9 类——溢出未生效行下线（唯一发射源 = 伏击上限截流，上限删除后零发射面）；② 授予段伏击加层改直授无上限（反灾难护栏退役——一轮踩雷数由行动点预算天然封顶）；③ 核验清单伏击守恒条改伏击池共享；④ 切片同批：enemy.tres 12 行字段删除、敌表校验/编排器截流/单位容器 F3 计划函数/日志视图 overflow 格式化删除、冒烟 blast 负向断言改直授累加（330 项 0 失败） |
|
||||
| v0.21 | 2026-09-20 | **格面资源八型批（用户拍板——与 敌人系统 / 地图战斗资源 / 行动经济 / registry / 切片代码同批）**：① 三乘法链与敌方技能攻击公式删伏击附加项及其"后置加法不进乘区"解释短语（rider 保留）；② 授予段兑付表 blast 负向换装警觉加层（enemy_alert → alert 行）+ 新增 action 型行动点修正行（queue_ap_delta 排队、下一轮开始兑现、下限 0、明细记 effect_id=ap_delta）；③ EV flat 类枚举伏击→行动点；④ 呈现快照两处伏击层数拆除（警觉并入敌方增益 effects 投影）；⑤ 棋盘来源必中枚举去伏击（两处）；⑥ 核验清单伏击池共享改警觉共享 |
|
||||
| v0.22 | 2026-09-19 | **充能退役批（版本号避让注记：原登 v0.16 与甲效矩阵加法核换装批撞号——2026-09-20 R10 版本号唯一性规则上线发现，后落籍者顺延；用户拍板，与切片代码 / registry / 07 清单 / README 同批）**：主角攻击三分量模型（普通 + 穿刺/魔法充能）整体退役，回归单分量——量 = 攻击基线、类型 = 主角表 attack_type；挖格批/旗判定批的充能计数条款删除、充能供给表与 charge_grants 调参行删除、乘区公式与粒度口径改"攻击合计"；退役理由 = 克制策略归冒险前配置（营地换型/未来冒险前参数面），局内不再有挖掘攒弹药的第二伤害供给；保留面 = 攻击类型属性轴与棋盘奖励触发源的抽象分离、奖励直伤道具（穿刺弹/魔法矢）的克制直伤消费不变。切片同批：battle_orchestrator 攻击段单分量化 + _charge_points/_charge_counts/round_facts 充能键删除、DamageMath.charge_component → counter_component 改名（奖励直伤唯一消费方）、settlement.tres charge_grants 键与 schema 校验删除、冒烟充能断言组退役改形（乘区接线单分量基线 100、标中正向兑付行断言、恢复点探针换种子 42）、冒烟 293 项 0 失败 |
|
||||
| v0.23 | 2026-09-20 | **GP+商店房批（用户拍板——与 关卡节点地图 v1.1 / 冒险结构 v0.5 / 地图战斗资源 v0.15 / 难度曲线与Boss v0.18 / registry / 切片代码同批；版本号注记：v0.22 已被充能退役批占用，表尾顺延）**：① 呈现只读面表 battle_finished 载荷 +gp_dropped（掉落掷定 + 关级加值 + 战斗内缓冲的合计——字段增删走本文修订条款兑现）；② 授予段兑付形态表新增 GP 缓冲行：gp 正/负向（金币袋 / 破财——九型批）兑付 = 战斗内 GP 缓冲 ±power，战斗完成统一上抛入钱包账本（账本归冒险结构），战斗域零钱包状态；③ 随机口径六处→七处：战斗结束掉落掷定消费 `gp_drop` 封闭流（出口随机、步骤流之外）；九型字典措辞与验收标准可回放条目同步 |
|
||||
| v0.24 | 2026-09-24 | **伤害管线单据化批（用户三裁决——与切片代码同批，06 台账 148）**：新增「伤害单据与伤害控制器」一节——伤害对象抽象补全：五族伤害来源收口伤害控制器单点管线、兑付配方封闭五种；三裁决落文——①结账时机双模式（现行 = 段界结账：授予段尾 / 清图批同步点 / 战斗段尾；开单即结保留为回切结构位，切换走代码不走调参）②目标结账时刻照规则解析③死亡事件由单位自行宣布（怪死其未结单据作废、主角死兑付终止）；授予段兑付与战斗段两节补结账时点句；验收标准 +伤害单据管线条目。切片同批：`core/damage_controller.gd` 新建（单据构造/开单/结账/死亡事件消费/管线算术收口）、battle_orchestrator 六调用点改开单、掷点/折扣/克制/池乘/攻击行文本助手迁出（`_defender_ac`/`_clamped_pool` 留薄委托）、unit_container 增 `unit_died` 信号；冒烟 557 项 0 失败双模式全绿 + A/B 对拍四配置全确定且真实分岔（行数恒等、纯次序位移）；历史基线读数自本批起以段界结账口径为准（重测归曲线调参批） |
|
||||
@@ -235,10 +235,10 @@ Boss 专属身份 = 专属池承载：独占技能 + 权重轮廓（现行：酋
|
||||
|
||||
| 参数 | 取值域 | 说明 |
|
||||
|---|---|---|
|
||||
| type | {普通攻击, 伤害, 增益} | 封闭枚举；新类型走本文修订；技能行名录读表 |
|
||||
| type | {普通攻击, 伤害, 增益, 妨害} | 封闭枚举；新类型走本文修订；技能行名录读表 |
|
||||
| damage_mult | [1.1, 16] | 仅伤害技；普通攻击恒 1 不可配（域校验锁死） |
|
||||
| cooldown_beats | [0, 99] | 施放后连续 N 拍不可摇中；普通攻击恒 0 不可配（域校验锁死——空池不可能的结构前提） |
|
||||
| buff_ref / buff_duration | 效果引用 / [1, 99] | 仅增益技；悬空引用加载期拒绝 |
|
||||
| buff_ref / buff_duration | 效果引用 / [1, 99] | 仅增益与妨害技（target_side 路由）；悬空引用加载期拒绝 |
|
||||
| pity_threshold（保底 M） | [1, 99] | 全局单旋钮：连续 M 拍执行普攻 → 下拍必出特殊技 |
|
||||
|
||||
主角表（单行全局）：
|
||||
@@ -284,9 +284,9 @@ Boss 专属身份 = 专属池承载：独占技能 + 权重轮廓（现行：酋
|
||||
| v0.4 | 2026-09-16 | **护甲等级掷点批·定稿落地（与战斗结算 / 难度曲线与Boss / registry / 切片代码同批）**：armor_class 域定稿 [0, 999]（缺省 0 向后兼容）；主角行值 10（暂定）、三敌种首关行值 0（暂定）——"行值未定"改"暂定值 + 待办"，敌方正式行值归怪物设定批（第一关怪物 AC 相对较低，值待怪物设定投值，登记待办清单）；敌种表护甲等级列同步落值；调参表两行改域与现行值 |
|
||||
| v0.5 | 2026-09-16 | **敌人技能池批（用户拍板，设计权威 docs/proposal-skill-pool.md v1.0；与战斗结算 / 增益状态 / 难度曲线与Boss / 战斗表现 / HUD框架 / registry / 切片代码同批）**：行为环章节整体退役——固定出招剧本、拍枚举（攻击/蓄力/重击）、环指针、同种锁步、heavy_multiplier 字段全部废除；技能池语义成文（三层对象〔技能行/池模板/实例池〕、技能行词汇表、池构成纪律、两道闸〔全技能各自冷却 + 保底〕、开轮摇号时序、死亡作废、独立子流）；蓄力语义改写（纯攻击增益技、与重击无组合语义——纠偏二；施放行继承零兑付伏击）；Boss 专属身份改专属池承载；意图呈现改三档可见性（普攻零表示 / 特殊技类型级预告 / 暴击掷点层）；敌人表 schema pattern → pool；调参表增技能表与池 EV 锚（含闸长期速率实测登记）；验收标准按摇号口径重写 |
|
||||
| v0.6 | 2026-09-17 | **文档降级为模板批（用户拍板，与难度曲线与Boss / 战斗结算同批）**：数值纪律定稿——本文只锁字段、取值域与规则，全部具体行值（敌种表池权重 / 护甲等级行值 / 两道闸表值 / 伏击每层附加与上限 / 技能行倍率与冷却 / 主角三字段 / 三敌种行值与池 EV 实测读数）自本文移除、一律读配置表（切片 `data/tables/` 与 registry）；调参表三表删除"现行值"列改纯 schema 模板；伏击公式与验算改符号化（a = 每层伏击表值）；验收标准同步去数值。背景：切片 `.tres` 数值压缩批后文档行值已滞后，双写失同步被实证 |
|
||||
| v0.7 | 2026-09-17 | **数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 `data/tables/*.tres` 与 registry），2 处失同步值修正**——共享技能表示例"熊地精 9×2=18"改符号化"基线 A × 技能倍率 M（行值读 enemy.tres / skills.tres）"；蓄力语义"施加'攻击×2'状态""×2 遇 ×2 = ×4"改"施加 empower 状态（幅度读 status_effects.tres）"，两层乘法组合语义保留符号表述 |
|
||||
| v0.8 | 2026-09-18 | **营地扩展前置批 + 护甲类型重配（用户指令，与战斗结算 / registry / 切片代码同批）**：① hero 表新增 armor_type / attack_type 两根可配置轴（缺省 light / normal；主角字段表同步两行）——护甲类型轴入矩阵消费面（敌方技能攻击类型轴未开前数值中性），基础攻击类型轴 = 量与类型抽象分离的营地换型落点；② 敌种护甲类型行值重配（数据面）：关卡 1 全部轻甲（食人魔酋长 heavy→light、熊地精两行 ward→light），关卡 2 除 Boss 蛛化卓尔精灵 heavy→ward（魔法甲）外全部轻甲（熊地精四行 ward→light，巨蜘蛛既有 light 不动）；现行克制三角读数效果 = L1 克制轴中性化、L2 仅 Boss 战非中性（魔法矢 ×150 / 穿刺弹 ×50 对 Boss） |
|
||||
| v0.9 | 2026-09-18 | **甲效矩阵用户调参批同步（零代码，事实源 settlement.tres 五格改值——详见[战斗结算](战斗结算.md) v0.15）**：主角字段表 armor_type 行注记归因改述——轴休眠的理由由「敌方攻击恒 normal 档故中性」（依赖普通行恒 100 的旧数值结构）改为「矩阵消费面 = 主角侧、敌方攻击不查克制矩阵」（结构性，与数值无关），轴生效仍待敌方技能攻击类型批。历史注记：v0.8 行「魔法矢 ×150 / 穿刺弹 ×50 对 Boss」与当时矩阵（穿刺×魔法甲=150 / 魔法×魔法甲=50）正反互倒，系当批笔误，按历史不改写留档，正确读数见战斗结算 |
|
||||
| v0.7 | 2026-09-17 | **数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 `data/tables/*.tres` 与 registry），2 处失同步值修正**——共享技能表示例"熊地精 9×2=18"改符号化"基线 A × 技能倍率 M（行值读 enemy.tres / skills.tres）"；蓄力语义"施加'攻击×2'状态""×2 遇 ×2 = ×4"改"施加 empower 状态（幅度读 status_effects.tres）"，两层乘法组合语义保留符号表述 |
|
||||
| v0.10 | 2026-09-19 | **技能池新效应词汇批（用户拍板——设计权威 docs/proposal-status-vocabulary.md v1.0，与 战斗结算 / 增益状态 / registry / 切片代码同批）**：① 技能类型枚举三→四（+妨害 debuff——对主角施减益的 0 伤害施放动作，字段复用 buff_ref/buff_duration，落点由状态行 target_side 路由〔增益 → 敌方侧 / 妨害 → 主角侧，施放类 side 守卫加载拒绝〕，执行与增益技同族施放行语义——不掷不折不兑付伏击）；② 伤害技新字段 rider_mult（必中附加分量——"固定值伤害"改形：固定值不随基线缩放与共享技能表前提冲突，必中小倍率承载"躲不掉的稳定伤害"）；③ 池构成纪律 +每池妨害 ≤1；④ 意图三档特殊技预告扩三族（攻击系 ⚔ / 增益系 ✦ / 妨害系 ☠）；⑤ 三词收敛两词——多段命中经用户拍板退役（无防御磨损体系，无对照机制），P1 字段位「命中段数」保留；⑥ 实装面 = 仅 L2 Boss 蛛化卓尔精灵（venom_burst + rider_mult 0.75；新行 web_snare 蛛网束缚 debuff→off_guard，首发载荷 = 失衡〔用户拍板〕，乏力 sapped 留作第二词汇），其余敌种不动 |
|
||||
| v0.11 | 2026-09-20 | **伏击单轮上限删除批（用户拍板——与 战斗结算 / 地图战斗资源 / 难度曲线与Boss / registry / 切片代码同批）**：① 伏击节上限段与溢出可见行删除，一轮踩雷数由行动点预算天然封顶成文；② 字段表 advantage_per_round_cap 行删除（原 0 = 免疫伏击语义作废）；③ 结构冻结联动纪律去单轮上限 × 攻击基线、数量 × 上限两条；④ 验收标准伏击授予与表校验条同步 |
|
||||
| v0.12 | 2026-09-20 | **格面资源八型批（用户拍板——与战斗结算 / 地图战斗资源 / 行动经济 / registry / 切片代码同批）**：① 伏击节整体退役改写（复利集中单血条与群伤奖励双重不对称，用户裁决）；② 责任表/结构冻结/验收标准的伏击词条目拆除；③ 群伤负向现况 = 警觉（敌方护甲等级 +1），定义与承载移交增益状态 |
|
||||
@@ -215,8 +215,8 @@
|
||||
|
||||
| 优先级 | 内容 | 后置原因 |
|
||||
|---|---|---|
|
||||
| P2 | 探测类道具的查询接口 | 接口归[魔法道具](魔法道具.md)定稿，本系统不预写 |
|
||||
| P2 | 地形变异接入的格面规则 | 地形变异尚未定稿；接入时走本文修订流程 |
|
||||
| P2 | 探测类道具的查询接口 | 接口已由 registry `aux_items` 机制桥接（query_reward_identity 只读面），本系统不预写 |
|
||||
| P2 | 地形变异接入的格面规则 | 地形变异已定稿落地（2026-09-19 四类型两轴×两关、2026-09-20 枚举化 schema 扩批），新增类型走双方修订流程 |
|
||||
|
||||
## 调参表
|
||||
|
||||
@@ -248,6 +248,6 @@
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
||||
| v0.2 | 2026-09-15 | 雾格残留清理：关闭「待拍板」三条雾失义登记（连锁开雾格与雾内旗恒不中、开格事件的变异标记透传、四格态中的两个雾态）——现行连锁与旗判定口径已按"全部安全格"写在正文，开格事件仍携带随格只读的变异标记（通用变异框架保留），格态呈现收窄为已开 / 未开两态。规则本体不变 |
|
||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），0 处失同步修正——动作价面值改「按标准动作价计费（价目见 action_economy.tres）」口径，连锁免费、移动免费等结构语义保留 |
|
||||
| v0.3 | 2026-09-15 | **格面资源批（用户拍板四点）**：① 初始展开格定名**封锁格**（已开、计入清图进度、恒无格面资源、不再有任何加成），铁律表"无奖励"改"无格面资源"；② 挖开格事件"奖励资格"字段改"格面资源资格"——安全格与雷格恒有（雷格不再恒无），封锁格恒无；③ 旗生命周期补结算队列口径：标旗 / 撤旗都是动作，轮末经战斗结算抵消过滤（标旗后被撤旗不兑付、行动点不返；开格不可撤）；④ 标错惩罚条目与 P1 后置删除——惩罚已定为该安全格格面资源的负向兑付（极性矩阵，归奖励道具经济 / 战斗结算），本系统只报"标空"事实；⑤ 清图呈现口径注记：剩余安全格计数即"剩余未探索安全区域"。玩家说法"失控反噬"随三选一反噬下线改"控制失败" |
|
||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），0 处失同步修正——动作价面值改「按标准动作价计费（价目见 action_economy.tres）」口径，连锁免费、移动免费等结构语义保留 |
|
||||
| v0.5 | 2026-09-19 | **插旗不可逆批（用户拍板全套落地，2026-09-18 提案转正）**：① 挖旗格放行——挖的合法对象去掉"无旗"前提，旗格直挖被受理、旗随挖掘消失、该旗轮末不再上报判定；② 拔旗动作退役——意图目录删 flag_pull，动作表与拒绝原因清单删对应项（flag_absent）；③ 旗生命周期改写：旗无任何移除手段、纠错路径 = 挖开（兑付改判四情况归战斗结算 v0.18）；④ 验收标准"挖有旗格被拒"改"挖旗格放行"。冒烟 327 项 0 失败（四情况探针 `_smoke_flag_irreversible_quadrants` 在案） |
|
||||
@@ -211,7 +211,7 @@
|
||||
| max_gen_attempts | int [1, 32] | 域 [1, 32]，现行按行取值见 board_gen.tres | 生成-验证重试上限；受成本闸联合约束 |
|
||||
| board_type | String，词表 {dungeon, underdark, deep_underdark} | 现行值见 board_gen.tres（词表 v1.1，2026-09-20 第三关内容批增补） | 图类型标签（玩家侧「地图类型」）；域校验 = 词表成员检查 |
|
||||
|
||||
结构冻结（非调参项）：键结构与每关深度 0 锚行、五阶段顺序、solver_rules、可推理率的合法信息源枚举、及格线域下限 0.85、成本闸常数（结构护栏，登记于 registry board_gen_table 条目，调整走文档修订）、先布后删语义。
|
||||
结构冻结（非调参项）：键结构与每关深度 0 锚行、四阶段顺序（变异布置段 2026-09-20 已移出管线）、solver_rules、可推理率的合法信息源枚举、及格线域下限 0.85、成本闸常数（结构护栏，登记于 registry board_gen_table 条目，调整走文档修订）、先布后删语义。
|
||||
|
||||
## 验收标准
|
||||
|
||||
@@ -234,6 +234,6 @@
|
||||
| 版本 | 日期 | 改动 |
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），3 处失同步修正（雷密度、可推理率及格线、生成尝试上限——文档面旧 provisional 值与 board_gen.tres 现值不一致，改指路）；成本闸 16384 改标注「结构护栏常数，登记于 registry board_gen_table 条目」，其余引用处指路；调参表「现行值」列整列指路化 |
|
||||
| v0.2 | 2026-09-15 | 雾格残留清理：删除「待拍板」五项旧版失义条目（雾参数两字段与雾域跨字段校验、双判据与 inferability_core、雾相关生成约束、雾致清图预算增量两指标、黄金图向量的 core 整数对）；验收标准「表实一致」条去掉指向该节的清理登记。参数表、五阶段管线与三分支出图等现行规则不变 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），3 处失同步修正（雷密度、可推理率及格线、生成尝试上限——文档面旧 provisional 值与 board_gen.tres 现值不一致，改指路）；成本闸 16384 改标注「结构护栏常数，登记于 registry board_gen_table 条目」，其余引用处指路；调参表「现行值」列整列指路化 |
|
||||
| v0.4 | 2026-09-20 | **第三关内容批（与切片代码 / registry / 03-内容规模 / 难度曲线与Boss / 地形变异 同批，参数行值零改动）**：图类型词表 v1.0 → v1.1，增补第三值 deep_underdark（灰矮人矿道方向）；正文词表句与调参表 board_type 行随批同步（L3 = deep_underdark）。[地图战斗资源](../战斗循环/地图战斗资源.md)的图类型差异化插槽句不随批动——clear_deep_underdark 启用仍为预留 |
|
||||
@@ -86,7 +86,7 @@
|
||||
|
||||
储备池唯一的支出是刷新雷图。玩家在挖掘期经界面入口发起，储备值不低于刷新门槛（rap_refresh_cost，见 action_economy.tres）时扣费，当场换一张新图继续挖。注意刷新不终结这一轮：行动点不重置、本轮剩余行动点保留；但换来的新图不发清图奖励（它又不是清图），旧图上的旗随旧图一起失效（插旗花的钱不退）。
|
||||
|
||||
每轮最多刷新 2 次（轮内计数，开轮重置），没有冷却，每次独立检查门槛并扣费。已用次数与剩余次数为只读观测量（切片实现在战斗编排器侧计数，HUD 刷新按钮「剩 N 次」文案即其消费方）——客户端可现读，不经可变状态外泄。禁止"攒满就自动刷"——刷新永远是玩家的决定。
|
||||
每轮最多刷新次数=表值 refresh_cap_per_round（现行 2）（轮内计数，开轮重置），没有冷却，每次独立检查门槛并扣费。已用次数与剩余次数为只读观测量（切片实现在战斗编排器侧计数，HUD 刷新按钮「剩 N 次」文案即其消费方）——客户端可现读，不经可变状态外泄。禁止"攒满就自动刷"——刷新永远是玩家的决定。
|
||||
|
||||
停手与刷新合起来构成这本账的基线节拍：满行动点一轮停手，正好攒够一次刷新。行动点修正队列会扰动该节拍的实际兑现（+1 轮可多挖一格），不变式本身不动；对账归曲线调参批。
|
||||
|
||||
@@ -104,7 +104,7 @@
|
||||
|---|---|
|
||||
| 一次性 | 每颗雷在一场战斗内至多兑付一次，资格随首次兑付消费 |
|
||||
| 当轮结算 | 旗只是当轮兑付的载体，不囤积到以后 |
|
||||
| 资格认雷格实例 | 拔掉重插同一格，不恢复已消费的资格——堵死"重复计费重插刷收益"的农场 |
|
||||
| 资格认雷格实例 | 挖开重插同一格（旗随挖掘消失），不恢复已消费的资格——堵死"重复计费重插刷收益"的农场（注：拔旗动作已退役，插旗不可逆批 2026-09-19）——堵死"重复计费重插刷收益"的农场 |
|
||||
| 不逐轮重复 | 同一颗雷的收益不会每轮反复发 |
|
||||
| 换图重置 | 新图的雷是新实例，资格自然重来 |
|
||||
|
||||
@@ -136,7 +136,7 @@
|
||||
|
||||
| 变量 | 含义 | 锚定来源 |
|
||||
|---|---|---|
|
||||
| P(安全) / P(雷) | 挖掘目标格为安全格 / 为雷的概率 | [棋盘生成](棋盘生成.md)的可推理率参数 |
|
||||
| P(安全) / P(雷) | 挖掘目标格为安全格 / 为雷的概率 | 实测可推理率分布 p10（registry inferability_vs_p_safe 口径——非 target 参数） |
|
||||
| 增益当量下界 | 最低档安全格增益换算值 | 战斗结算的效果对照表 |
|
||||
| 敌方增益当量上界 | 踩雷惩罚的换算上限（原伏击惩罚上限表随 2026-09-20 八型批伏击退役，对账模型归 难度曲线与Boss 调参批重立） | [难度曲线与Boss](../冒险循环/难度曲线与Boss.md) |
|
||||
| 清图奖励当量 | 清图奖励的换算值 | [地图战斗资源](../战斗循环/地图战斗资源.md) |
|
||||
@@ -216,7 +216,7 @@
|
||||
| 版本 | 日期 | 改动 |
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-09-14 | 自归档 GDD 压缩改写 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），0 处失同步修正——价目改「统一价目 / 标准价（见 action_economy.tres）」口径，每轮点数与刷新门槛改表值指路；调参表「现行值」列整列指路化；注记 refresh_cap_per_round 与表字段 refresh_max_per_round 命名不一致（字段名对齐待批）。顺带：P0 闭环「扣 1 点」改「按价扣费」；终扫补两处漏网——巢穴约束例句「每轮花 2 点重插」改「重复计费重插」、P0 闭环「每轮至多 2 次」改刷新上限读表 |
|
||||
| v0.2 | 2026-09-16 | AP 压速批文档面值同步（用户拍板 8→6，削标旗 rush 单轮兑付吞吐为无伤通关根因的主阀门）：ap_per_round 与 rap_refresh_cost 现行值 8→6，随动保持"满预算停手 = 恰好一刷"耦合；数据表与 registry 已同批改，本批补文档面正文两处与调参表两行 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），0 处失同步修正——价目改「统一价目 / 标准价（见 action_economy.tres）」口径，每轮点数与刷新门槛改表值指路；调参表「现行值」列整列指路化；注记 refresh_cap_per_round 与表字段 refresh_max_per_round 命名不一致（字段名对齐待批）。顺带：P0 闭环「扣 1 点」改「按价扣费」；终扫补两处漏网——巢穴约束例句「每轮花 2 点重插」改「重复计费重插」、P0 闭环「每轮至多 2 次」改刷新上限读表 |
|
||||
| v0.4 | 2026-09-19 | 插旗不可逆批（用户拍板全套落地）：拔旗动作退役——设计目的/统一价目/价目表/布尔入口清单/P0 闭环/调参表六处删"拔旗"，flag_pull_ap_cost 字段随 schema 与 data 表同批删除；插旗行补"旗 = 一次性承诺、纠错 = 直接挖开"口径 |
|
||||
| v0.5 | 2026-09-20 | **格面资源八型批同步（用户拍板——与敌人系统 / 战斗结算 / 地图战斗资源 / registry / 切片代码同批）**：① F1 条款 3 改写——原"敌方伏击暴露不等式"随伏击机制退役作废，惩罚当量对账模型归难度曲线与Boss 调参批重立；② 新增「下轮行动点修正」节——action 型格面资源经 queue_ap_delta 排队、下一轮开始兑现（基线 ap_per_round + 净值、下限 0、兑现后清零），跨轮携带量口径改写（RAP 唯一显式携带资源 + 一次性修正队列）；③ 节拍不变式（满停一轮 = 恰好一刷）补扰动注记 |
|
||||
@@ -197,7 +197,7 @@ playtest 预警（预注册，归难度曲线与Boss）：
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
||||
| v0.2 | 2026-09-16 | 更名批（用户拍板 2026-09-16）：系统更名"辅助道具"→"魔法道具"——定位已非纯数值道具，含信息/妙用向效果；文件同步重命名；英文代号 AUXILIARY_ITEMS 暂沿用 |
|
||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），1 处失同步修正（AP 8→6 漏改：爆破工兵包定位读数段的「每轮行动点默认 8」改指路 action_economy.tres）——道具加量、供给读数、调参表六行 w/t/mag、道具依赖预警阈值 50% 均改指路 registry `aux_items`；行名与表结构列保留 |
|
||||
| v0.3 | 2026-09-17 | 切片期空内容拍板（用户拍板）：道具定义表为空列为合法态——五维度覆盖检查改为仅对非空清单执行（垂直切片期无道具内容、无掉落面；六行设计值与机制桥接登记保留，内容整批后置至切片收尾后的魔法道具内容批）；验收标准覆盖检查条目同步；[06-待办清单](../../06-待办清单.md)「维度覆盖检查破缺」「失义道具的掉落投放」两条随批关闭 |
|
||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），1 处失同步修正（AP 8→6 漏改：爆破工兵包定位读数段的「每轮行动点默认 8」改指路 action_economy.tres）——道具加量、供给读数、调参表六行 w/t/mag、道具依赖预警阈值 50% 均改指路 registry `aux_items`；行名与表结构列保留 |
|
||||
| v0.5 | 2026-09-29 | **内容批落地修订（迭代 7——用户八拍板）**：①道具定义表六行入表（AuxItemTable——三有效实装：工兵令 ap_grant/探巢摆钟真视/爆破工兵包组合；**探宝罗盘退役留痕**（拍板①乙——未开格类型微光常显覆盖预读价值，retired 标记词表兼容）；显影尘/地穴全图卷 deferred「能力封存」（拍板④甲，Alpha 重定）；②F2 维度覆盖改**投放维度覆盖**口径+豁免面 {plan, info, counter} 显式登记（罗盘退役+显影件悬置所致，豁免随 Alpha 重定/天赋批消减）；③解锁语义定稿=工坊解锁→进掉落投放池（拍板③甲，未解锁权重 0）；④奖励节点=三选一构筑点（拍板②丙，node-reward.md v1.0）；⑤掉落投放三件总权重 10/池 88（拍板⑥甲，provisional） |
|
||||
| v0.6 | 2026-09-30 | **拍板点 1 收口批（2026-09-30 用户裁决甲：同调=终局方向）**：①新增「定位与形态沿革」节——现行正文定性=切片期过渡形态、终局=局外同调件（设计权威底稿 proposal-magic-item-attunement-2026-09-22.md 八拍板），两态关系=形态替换、衔接纪律与事故留痕入节；②正文口径回写四处：五维度表信息/规划/反制三行改现行态（罗盘退役/显影件封存/豁免面入正文）、覆盖检查改投放维度覆盖口径、掉落池获取节补解锁门控（2026-09-29 拍板③甲）、板级叠加层预读集改「机制在案无投放来源」；③验收两条（护栏/覆盖检查）与调参表投放态注记、地形变异依赖行同步；④实施批登记见 06「魔法道具同调实施批」条。审计冲突 C19/C29 随批收口（全录见 design/research/gdd-concept-coverage-audit-2026-09-30.md） |
|
||||
@@ -199,7 +199,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| 下游 | [战斗表现](../战斗循环/战斗表现.md) | 交付三区布局、明细带呈现位、敌人呈现语义（站桩形态）；它只叠加动画密度与演出 |
|
||||
| 下游 | [音频](音频.md) | 挂点事件源（明细行类型流、toast 触发）；MVP 无音频 |
|
||||
| 下游 | [教学引导](教学引导.md) | toast 与图例面板两个承载位——教学内容装进这两个容器 |
|
||||
| 下游 | [设置与本地化](设置与本地化.md) | 中文字体随包、按钮宽度、术语表等契约的消费方 |
|
||||
| 下游 | [设置与本地化](设置与本地化.md) | 中文字体随包、按钮宽度等契约的消费方 |
|
||||
|
||||
呈现义务来源清单——各上游系统点名要本系统兑付的呈现义务，一行一条；规则本体以对方文档为准：
|
||||
|
||||
|
||||
@@ -59,7 +59,7 @@
|
||||
|---|---|---|
|
||||
| 行动经济表 `ActionEconomyTable` | 每轮行动点、动作价目、停手与刷新门槛 | [行动经济](../排雷循环/行动经济.md) |
|
||||
| 棋盘生成参数表 `BoardGenTable` | 板尺寸、雷密度、可推理率目标等（进度键表） | [棋盘生成](../排雷循环/棋盘生成.md) |
|
||||
| 变异表 `VariationTable` | 变异类型清单（现行空清单，合法态） | [地形变异](../排雷循环/地形变异.md) |
|
||||
| 变异表 `VariationTable` | 变异类型清单（现行六行两轴×三关（2026-09-20 落地）） | [地形变异](../排雷循环/地形变异.md) |
|
||||
| 敌人表 `EnemyTable` | 敌种基线数值、遭遇数量区间、护甲类型、技能池模板（进度键表） | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 技能表 `SkillTable` | 技能行定义（类型/倍率/冷却/增益引用）与保底阈值 | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 主角表 `HeroTable` | 主角生命上限与基础攻击 | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
@@ -71,7 +71,7 @@
|
||||
| 难度表 `DifficultyTable` | 难度修饰乘数（占位空表） | [难度曲线与Boss](../冒险循环/难度曲线与Boss.md) |
|
||||
| 关卡表 `LevelTable` | 逐关节点图与层名 | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
| 冒险表 `AdventureTable` | 关卡大奖励与钥石入账（单行全局） | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
| 元进度表 `MetaTable` | 元进度字段（占位，键结构未定） | [元进度](../冒险循环/元进度.md) |
|
||||
| 元进度表 `MetaTable` | 元进度字段（已建表（2026-09-21，四行族）） | [元进度](../冒险循环/元进度.md) |
|
||||
|
||||
举证：本节为数据纪律约定，无计算。违规检测 = 静态扫描加人工复核，随各表回填定稿与里程碑检查执行。
|
||||
|
||||
@@ -188,7 +188,7 @@
|
||||
| 参数 | 现行值 | 说明 |
|
||||
|---|---|---|
|
||||
| 表路径清单 | data/tables/ 固定（调试注入根除外） | 冻结：散装路径破坏单点访问 |
|
||||
| 表结构版本常量 `SCHEMA_VERSION` | 实现期定（MVP = 1，provisional） | 全部表结构携带版本字段；高于当前支持的版本拒读，比较逻辑归[存档序列化](存档序列化.md) |
|
||||
| 表结构版本常量 `SCHEMA_VERSION` | 当前 = 2（v2=断点域出生，迭代 8 卡①，与存档 SAVE_FORMAT_VERSION 同源） | 全部表结构携带版本字段；高于当前支持的版本拒读，比较逻辑归[存档序列化](存档序列化.md) |
|
||||
| 随机流口径 | 统一流单盐单计数器 + 七用途标签封闭词表 | 统一口径为 ADR-0007 裁决；扩签 = 改代码 + 评审，有意设卡 |
|
||||
| 进度坐标解析策略 | 可取范围内向上取整 + 警告（保证偏难）；超出最大行封顶取最大值 + 警告；域越界致命（2026-09-18 两段拍板，原「就近向下」退役） | 冻结：静默降难会掩盖难度断档 |
|
||||
| 入口锚行校验 | 写死开 | 非调参项；重议走文档修订流程 |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 设置与本地化
|
||||
|
||||
> 一句话：设置项与多语言
|
||||
> 状态：范围草案（待设计）
|
||||
> 状态：范围草案·最小设置面已兑现（2026-09-29 迭代 8 卡④）
|
||||
> 旧版参考：../../../archive/gdd-2026-09-14/systems-index.md（旧体系未单独成文，散见于归档索引）
|
||||
|
||||
## 设计目的
|
||||
|
||||
@@ -158,4 +158,4 @@
|
||||
| 版本 | 日期 | 改动 |
|
||||
|---|---|---|
|
||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
||||
| v0.2 | 2026-09-16 | 新增「临时音效的覆盖清单」：必覆盖五挂点、选配两候选、明确不覆盖两挂点与切片期验收口径成文（06 清单「临时音效的覆盖清单」闭合），P0 最小闭环改指本节；明细流水行型数 15→10、例举去"道具"行，随战斗结算格面资源批行协议同步 |
|
||||
| v0.2 | 2026-09-16 | 新增「临时音效的覆盖清单」：必覆盖五挂点、选配两候选、明确不覆盖两挂点与切片期验收口径成文（06 清单「临时音效的覆盖清单」闭合），P0 最小闭环改指本节；明细流水行型数 15→10、例举去"道具"行，随战斗结算格面资源批行协议同步（追记 2026-09-30：现行 9 类——2026-09-20 伏击上限删除批下线溢出未生效行） |
|
||||
@@ -68,7 +68,7 @@
|
||||
| Exit Destination | Trigger | Notes |
|
||||
|---|---|---|
|
||||
| 关卡画面（选路枢纽） | 敌方全灭（战斗结算判定段 verdict=win）且非末节点 | 不可逆：battle_over 已发生，RAP 清零；落地奖励/恢复节点时开节点覆盖层确认（NodeOverlay，关卡画面域） |
|
||||
| 关卡结算 | Boss 战胜利 → level_clear（spec：[level-clear.md](level-clear.md)） | 不可逆：关卡收束清库义务载体 = 魔法道具背包（随魔法道具 P0 落地，届时须可见反馈；现行切片无库存容器） |
|
||||
| 关卡结算 | Boss 战胜利 → level_clear（spec：[level-clear.md](level-clear.md)） | 不可逆：关卡收束清库义务载体 = 魔法道具背包（库存已随迭代 7 落地——C 区四槽+关卡域库存；清库反馈呈现待批） |
|
||||
| 冒险终结 | 主角 HP=0（verdict=lose） | 不可逆：Roguelike 死亡重开（art-bible §2.5 温柔惋惜调性） |
|
||||
| 无中途退出 | — | MVP 不设战斗内放弃/暂停菜单（回合制无时间压力；如需暂停留 Playtest 诊断按钮，调试用） |
|
||||
|
||||
@@ -104,7 +104,7 @@
|
||||
- **C 区角色信息（规划数据框）**
|
||||
- 攻击值 + 修正来源角标（战斗在消费、且站桩上无展示）
|
||||
- 护甲 AC（2026-09-26 二轮拍板补入——我方 AC 的唯一展示面；掷点判定轴，受击侧可读性）
|
||||
- 魔法道具槽（**预留**——随身战斗用道具的唯一展示面；槽位数与交互形态待魔法道具定稿，交互入口按既有裁决不预设在此）
|
||||
- 魔法道具槽（**已实装**：四槽两步交互，详见 [node-reward.md](node-reward.md)——随身战斗用道具的唯一展示面）
|
||||
- 本关强化列表（**预留**——锻造/大奖励/关卡奖励节点获得的属性提升；与战斗内状态效果分区呈现，防「战斗结束被清」误读）
|
||||
- **D 区扫雷图 · AP 条**
|
||||
- AP 点阵 + 停手按钮（现行）
|
||||
@@ -146,7 +146,7 @@
|
||||
| B | 结算明细带 | 滚动列表 | 结算期逐行流水（[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋) 9 类行协议）；挖掘期收起为上轮摘要 1 行 | 点击展开明细回看 overlay | battle_log_view.gd 改造 |
|
||||
| B | 结算明细回看 | 模态 overlay | 完整流水逐行（现行 9 类行协议；未生效类行聚合计数） | 关闭 | battle_log_view.gd 改造 |
|
||||
| C | 攻击数据框 | 直角细线数据框 | 攻击值 + 修正来源角标 + 护甲 AC（AC 二轮拍板 2026-09-26 补入——我方 AC 唯一展示面；原「HP/攻击/RAP 显示」——HP 与 RAP 随信息归属拍板迁出本组件） | 只读 | HUDView 拆分 |
|
||||
| C | 魔法道具槽（预留） | 图标槽（数量待魔法道具定稿） | 随身战斗用道具的唯一展示面；空槽虚线占位，不预设交互（挖掘期指向交互归 E 区既有裁决） | 悬停 tooltip（道具语义） | 新建（随魔法道具批） |
|
||||
| C | 魔法道具槽（已实装：四槽两步交互，详见 [node-reward.md](node-reward.md)） | 图标槽 ×4 | 随身战斗用道具的唯一展示面；库存已随迭代 7 落地（C 区四槽+关卡域库存），清库反馈呈现待批 | 悬停 tooltip（道具语义） | 新建（随魔法道具批，已落地） |
|
||||
| C | 本关强化列表（预留） | 列表/图标行 | 锻造/大奖励/关卡奖励节点获得的属性提升——中循环数据，因改变战斗数学且无其他展示面准入战斗屏；与战斗内状态效果（B 区站桩）分区，防「战斗结束被清」误读 | 只读 | 新建 |
|
||||
| D | AP 条 | 点阵 + 按钮组 | 本轮 AP 点阵、停手按钮（左）、**RAP 点阵+数字（自 C 区迁入 2026-09-26——RAP 唯一消费口 = 弃图刷新，资源数字贴消费按钮；RAP 清零可见反馈〔行动经济〕载体随迁）**、弃图刷新按钮（右端·雷图右上角；RAP−8 · 本轮剩 N 次——上限 2 次已随行动经济 2026-09-12 修订生效） | 点击提交意图 | HUDView 拆分 |
|
||||
| D | BoardView | 网格 | 棋盘全部格态 + 小人 + 旗 + 变异纹带 + 奖励身份 icon（已开格；绘制优先级 数字>小人>旗>奖励徽章>变异纹带>底色——徽章不进数字区，样张验收项） | 左/右键意图提交 | ✅ board_view.gd 迁移 |
|
||||
@@ -363,7 +363,7 @@
|
||||
- [ ] 挖/移/旗/停手/刷新全部操作纯鼠标可完成；stop 意图经 `settle_batch` 提交（代码走查 + 探针断言）
|
||||
- [ ] 每次拒绝（棋盘面/资源面/相位）玩家可感知且两源可区分；voided（至少 stop 作废）可感知（排雷玩法×6⑥、行动经济双源）
|
||||
- [ ] 弃图刷新消耗 RAP 8 点、本轮上限 2 次可见（按钮文案实时「剩 N 次」；上限已随行动经济 2026-09-12 修订生效）；RAP<8 资源面拒绝可见（行动经济 EC13）；确认交互与常规确认不同位；换图后 AP 不重置、剩余次数扣减可见（**上游已修订受理——2026-09-12 布局决策 4 落稿**）
|
||||
- [ ] battle_over 时 RAP 清零有可见反馈（行动经济）；关卡收束清库反馈义务载体 = 魔法道具背包，随魔法道具 P0 落地补验收（现行切片无库存容器）
|
||||
- [ ] battle_over 时 RAP 清零有可见反馈（行动经济）；关卡收束清库反馈义务载体 = 魔法道具背包——库存已随迭代 7 落地（C 区四槽+关卡域库存），清库反馈呈现待批，随呈现落地补验收
|
||||
- [ ] battle_over 时状态图标行全清有可见反馈（B 区站桩逐枚化光 + 微文案）（增益状态×④）
|
||||
- [ ] 敌人死亡瞬间可辨识（卡体灰化 + 碎裂退场，禁瞬消）；战斗段短路被掐灭的重击由行序可推断（敌人系统资产下限）
|
||||
|
||||
|
||||
@@ -33,13 +33,13 @@
|
||||
| 10 | 一次性非模态教学提示 | Feedback | **已实现**（chord 提示——规格全文待补） |
|
||||
| 11 | tooltip 规范 | Feedback | **已实现**（状态/道具悬停——规格全文待补） |
|
||||
| 12 | 单意图帧批次提交 | Input | **已实现**（main.gd 组合根——规格全文待补） |
|
||||
| 13 | 状态效果槽 | Data Display | **已实现**（status_slot_row.gd——规格全文待补） |
|
||||
| 14 | 步进进度条 | Navigation | **已实现**（level_strip_view.gd——规格全文待补） |
|
||||
| 13 | 状态效果槽 | Data Display | **已实现**（status_slot_row.gd——规格全文待补；载体变更留档：C 区四槽已退役，现役载体=B 区站桩伴随件） |
|
||||
| 14 | 步进进度条 | Navigation | **已退役留档**（level_strip_view 已删，节点态承载进度） |
|
||||
| 15 | 移动路径预览 | Input | **已实现**（board_view.gd BFS 蓝点——规格全文待补） |
|
||||
| 16 | 清图/换图演出编排 | Feedback | **已实现·占位级**（board_fx_view.gd 金粒彩纸——规格随战斗表现 美术批补） |
|
||||
| 17 | 胜利/失败终局编排 | Feedback | **已实现·占位级**（battle_end_overlay.gd——规格随战斗表现补） |
|
||||
| 18 | Boss 遭遇演出 | Feedback | **已实现·占位级**（紫赤影子——规格随战斗表现补） |
|
||||
| 19 | 库存常读列表 | Data Display | **已实现**（inventory_panel_view.gd——规格全文待补） |
|
||||
| 19 | 库存常读列表 | Data Display | **已实现**（inventory_panel_view.gd——规格全文待补；载体变更留档：现行载体=C 区道具槽） |
|
||||
| 20 | 标准控件组（button/progress bar/list） | Control | **已实现**（ui_kit.gd 直角细线/凸圆角——规格全文待补） |
|
||||
|
||||
MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab bar——战斗屏无此需求；TunePanel slider 为调试专用。
|
||||
@@ -57,7 +57,7 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
|
||||
|
||||
**Specification**:
|
||||
- 触发：`ActionOutcome{accepted=false, reject_reason, sub_reason}` **返回值驱动**（拒绝无事件外发——排雷玩法发射面封闭，实现层不得等待拒绝信号）
|
||||
- 反馈映射：board_face → 目标格危险红 `#A8321F` 边框闪（拒绝语义红族——旗朱退役 2026-09-26 封印紫批） + toast 具体原因（sub_reason→文案映射表：not_adjacent/target_revealed/target_concealed/flag_present/flag_absent/no_path/out_of_catalog）；resource_face → 对应资源数字脉冲（AP/RAP）+「AP 不足 · 剩 0 点」式文案；phase → toast（结算中/非挖掘期）
|
||||
- 反馈映射：board_face → 目标格危险红 `#A8321F` 边框闪（拒绝语义红族——旗朱→封印紫→封印黑 #000000，2026-09-28 用户拍板现行） + toast 具体原因（sub_reason→文案映射表：not_adjacent/target_revealed/target_concealed/flag_present/flag_absent/no_path/out_of_catalog）；resource_face → 对应资源数字脉冲（AP/RAP）+「AP 不足 · 剩 0 点」式文案；phase → toast（结算中/非挖掘期）
|
||||
- 即时性：拒绝当帧呈现；toast 自动消退 2.5s
|
||||
- **voided 区分**：作废 ≠ 拒绝（零效果零扣费零事件）——须独立文案如「本轮已清图，停手未执行 · 剩余 AP 已作废」，至少 stop 作废可感知
|
||||
- Accessibility：危险红边框闪为形状+运动通道；文案常驻
|
||||
@@ -85,7 +85,7 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
|
||||
|
||||
**Specification**:
|
||||
- 数据源：[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)步骤流（9 类行封闭协议（现行）；公共字段 `type/source_class/origin_cell/round_index/display_name/value/highlight?`）；**无来源行 = 断言失败**
|
||||
- 行模板：「{行为} {值} → {目标}（来源）」——来源标注（第 N 轮 · 安全格式）；行文案最长 token = 道具名（4 汉字），模板预留 40% 膨胀宽度
|
||||
- 行模板：「{行为} {值} → {目标}（来源）」——来源标注（第 N 轮 · 安全格式）；行文案最长 token = 来源标签（4 汉字封闭枚举），模板预留 40% 膨胀宽度
|
||||
- 聚合纪律：未生效类行（奖励未生效——现行 9 类行协议唯一未生效型，2026-09-20 收敛）按聚合计数呈现（防逐行惩罚轰炸）；衰减行聚合计数；效果行 value=单次贡献值、禁与 pool_value（池合成值）相加呈现；零值行可见不吞（免伤轮归因不断点）
|
||||
- 高亮：highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调；完美排雷 = 独立高光行 + 全屏喝彩级反馈
|
||||
- 布局：固定槽高 + clip_contents；正文 ≥14px；数值暗底高对比；未生效类行带 icon/划线形状冗余
|
||||
@@ -123,7 +123,7 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
|
||||
### 5. 点阵资源显示（dot-matrix resource display）
|
||||
|
||||
**Category**: Data Display
|
||||
**Used In**: AP 条、RAP 框
|
||||
**Used In**: AP 条（RAP 读数已并入，独立 RAP 框不存在）
|
||||
|
||||
**Description**: 离散点阵 + 数字双承载的资源显示——点阵为图形载体（本地化零成本、一眼可读余量），数字为精确值。
|
||||
|
||||
|
||||
@@ -56,7 +56,7 @@
|
||||
|
||||
1. **大奖励三件套**（第一注视点）：生命上限提升（含新上限读数）、生命回满、钥石入账（增量 + 累计）——中循环边界事件的兑付账，本屏是它唯一消费口。钥石入账与营地的钥石存量不同义（进账瞬间 vs 存量可用），不构成重复展示
|
||||
2. **GP 结算呈现——归属已收口（2026-09-27 用户拍板）**：GP 不进本屏。战斗总结结算展示获得的资源（目前 = GP），GP 增量+总量归战斗总结结算承载（battle.md OQ14 口径为准；呈现 spec：[settlement-summary.md](settlement-summary.md) v1.0——本屏旧用「战斗胜利总结结算」系四字变体，随 spec 命名收口退役）；关卡画面另设常驻总量。本屏维持现行大奖励文案无 GP
|
||||
3. **清库反馈**（预留，随魔法道具 P0）：关卡收束清库义务载体 = 魔法道具背包；现行切片无库存容器，义务挂账、本批不设计呈现（battle.md Exit 表同源）
|
||||
3. **清库反馈**（呈现待批）：关卡收束清库义务载体 = 魔法道具背包；库存已随迭代 7 落地（C 区四槽+关卡域库存），义务挂账、本批不设计呈现（battle.md Exit 表同源）
|
||||
|
||||
**禁入清单**（两铁律推导）：战斗小循环数据（结算明细、状态效果——留在战斗屏）；GP（呈现位已拍板 = 战斗总结结算 + 关卡画面常驻，见 06）；营地柜台全量（解锁清单/定价——不陈列）；冒险摘要五件事（末关时由相邻域冒险结算屏承载，本屏不重复）。
|
||||
|
||||
@@ -98,7 +98,7 @@
|
||||
- [ ] 末关通关分支正确转接冒险结算，冒险摘要五件事完整
|
||||
- [ ] 确认前冒险状态冻结（无后台推进、无战斗事件串扰）
|
||||
- [ ] 呈现遵循 HUD框架 可访问性基线（对比 ≥4.5:1、字号下限、纯鼠标可完成）
|
||||
- [ ] 清库反馈：随魔法道具 P0 落地补验收（现行切片无库存容器，义务挂账）
|
||||
- [ ] 清库反馈：库存已随迭代 7 落地（C 区四槽+关卡域库存），清库反馈呈现待批——随呈现落地补验收（义务挂账）
|
||||
|
||||
## Open Questions
|
||||
|
||||
|
||||
@@ -49,7 +49,7 @@
|
||||
|
||||
### Information Hierarchy
|
||||
|
||||
本屏必须传达的全部信息，按注视优先级分五层：
|
||||
本屏必须传达的全部信息，按注视优先级分六层：
|
||||
|
||||
1. **节点图本体**（第一注视点）：节点方块（五类型字面：战/赏/疗/王/商）、通道连线、当前位置、可选去路
|
||||
2. **候选选路口**：亮金候选通道 + 候选节点亮金描边——「下一步能去哪」的图上双冗余（2026-09-27 拍板：候选按钮退役，图上点击为唯一提交通道）
|
||||
@@ -64,7 +64,7 @@
|
||||
|
||||
| 区 | 位置与尺寸 | 内容 |
|
||||
|---|---|---|
|
||||
| **顶栏语境** | 居中横排，图区上方，高约 32px | 左：关卡名（`level_row.display_name`，如「第二层 · 幽暗地域」）；右：GP 常驻徽章（金币图标+数字，直角细线数据框——GP 值域超点阵适用档，走 pattern 5 的 When-NOT-to-Use 路线）；HP 常驻读数是否并列右侧 = OQ1 待拍板，拍板前不实现 |
|
||||
| **顶栏语境** | 居中横排，图区上方，高约 32px | 左：关卡名（`level_row.display_name`，如「第二层 · 幽暗地域」）；右：GP 常驻徽章（金币图标+数字，直角细线数据框——GP 值域超点阵适用档，走 pattern 5 的 When-NOT-to-Use 路线）；HP 归底部状态栏（2026-09-27 拍板收口） |
|
||||
| **节点图区** | 居中 | 整幅节点图自绘：节点方块 + 通道折线 + 节点态着色 + Boss 紫赤描边。画布随图自适应（**冻结公式**：宽 = 70+层深×122+34、高 = 52+槽位×58+26+8，下限 620×240——routebug 83c11a1 根修件）；通道折线**冻结 2/3/4px**（未点亮石灰 STONE/候选亮金 GOLD_LIT/悬停加粗）；节点方块 52×36 内**节点图标 20px 烘焙 1:1**（♻ kenney 五键：战=弓/赏=桂冠/疗=篝火/王=王冠/商=钱袋，WARM 单色、当前金底转深墨——双色墨制）+ 编号 10px 右上角 |
|
||||
| **底部状态栏** | 图区下方横排，高约 48px | 左-中：状态数据框组（直角细线，pattern 5 族）——生命（当前/上限 + 迷你血条）、属性（攻击 / 护甲 AC，有效值 + 加成角标）、本关加成（攻+X · 上限+Y · AC+Z，零加成隐藏）；右端：放弃冒险按钮（危险红族文字，与状态数据框保持间距——破坏性确认异位，pattern 7） |
|
||||
|
||||
@@ -119,8 +119,8 @@
|
||||
| State / Variant | Trigger | What Changes |
|
||||
|---|---|---|
|
||||
| **入口停点（默认首态）** | 关卡开始（停点前移） | 标题「出发——选择首个节点」；唯一候选 = 入口节点；图上全部节点为未来态 |
|
||||
| **单链停点** | 兑付确认后、恰 1 个下一跳 | 标题「继续前进」；单候选按钮 |
|
||||
| **岔路停点** | 兑付确认后、≥2 个下一跳 | 标题「选择下一节点」；候选按钮横排；亮金通道与候选描边逐一分叉可辨 |
|
||||
| **单链停点** | 兑付确认后、恰 1 个下一跳 | 标题「继续前进」；单候选节点图上点击提交（候选按钮已退役——图上点击为唯一通道） |
|
||||
| **岔路停点** | 兑付确认后、≥2 个下一跳 | 标题「选择下一节点」；候选节点图上点击提交（候选按钮已退役——图上点击为唯一通道）；亮金通道与候选描边逐一分叉可辨 |
|
||||
| **悬停预承诺** | 悬停候选节点 | 该节点亮金描边加粗 + 所属通道增亮 + 光标切指针态；移出即回落（仅预承诺，点击才提交） |
|
||||
| **放弃确认态** | 首击放弃按钮 | 文案转确认语 + 危险红边框脉冲约 3 秒；超时或移出回落；二击提交 `abandon_requested` |
|
||||
| **换层进入** | 上一关结算确认 → 新关开始 | 本屏以新关卡数据淡入；屏底世界侧随层进换挡（**换层色板渐变挂点**——§2.7 切片档：只动色相/饱和、明度带归一，level_index→tint 表候选值 = art-bible §6.3 三关方向，终值归色板样张批；M-2 迭代 4 落挂点） |
|
||||
@@ -135,7 +135,7 @@
|
||||
| 组件 | 动作 | 输入 | 即时反馈 | 结果（经组合根） |
|
||||
|---|---|---|---|---|
|
||||
| 候选节点（图上，唯一通道） | 提交选路 | 左键 | 悬停预承诺（描边加粗 + 通道增亮 + 指针）→ 点击本屏关闭 | `route_chosen(node_id)` → `LevelRunner.pick_next_node`——到达即兑付，无进入前确认步 |
|
||||
| 放弃冒险按钮 | 终结整局冒险 | 左键（现行单击；确认态见 OQ3） | 危险红族反馈 | `abandon_requested` → 组合根走冒险终结（同失败结算——已获大奖励保留） |
|
||||
| 放弃冒险按钮 | 终结整局冒险 | 左键（二击提交——首击转确认态，2026-09-27 布局决策 3） | 危险红族反馈 | `abandon_requested` → 组合根走冒险终结（同失败结算——已获大奖励保留） |
|
||||
|
||||
**零自动推进纪律**（关卡节点地图 定稿）：本屏是唯一的行进发起口——不选就停在图上；没有任何定时、默认或顺延的自动前进路径。兑付后确认挂各兑付面（战斗总结结算〔settlement-summary.md〕/ 节点覆盖层 / 商店覆盖层离开动作），本屏不重复确认步。
|
||||
|
||||
@@ -163,7 +163,7 @@
|
||||
|---|---|---|
|
||||
| 打开（进图 / 兑付确认后回图） | 独立屏淡入（约 200ms，同装板淡入档；alpha 淡入非明度变化——§2） | 屏级切换；战斗屏整体隐藏 |
|
||||
| 选路提交 | 本屏关闭，直达所选节点兑付流程 | 到达即兑付（关卡节点地图） |
|
||||
| 放弃确认态（OQ3 提案） | 危险红边框脉冲约 3 秒（单段呼吸，非频闪） | pattern 7；闪烁基线（≤3 次/秒）内 |
|
||||
| 放弃确认态（OQ3，拍板落定） | 危险红边框脉冲约 3 秒（单段呼吸，非频闪） | pattern 7；闪烁基线（≤3 次/秒）内 |
|
||||
| 减动效 | 上述全部时长减半或跳终态 | HUD框架 可访问性基线 |
|
||||
|
||||
---
|
||||
|
||||
Reference in new issue
Block a user