docs(audit): 文档正确性审查·独立复核批（worktree docaudit-2026-10-09，基点 03c4b4c——18 文件语义级清漏，主区零触碰）
R1 状态与证据对齐（全部代码实证）：
- 存档序列化 v2→v6 换代（save_manager.gd SAVE_FORMAT_VERSION=6 实证）：数据模型 JSON+域清单补 v4 同调三域/v5 树域/v6 生涯两域逐行 owner、版本与迁移节五件迁移链、调参表常量 6；v3-v6 四次升版当时均未回写本文，本批一次清偿（v1.4）
- 数据配置表清单四处失同步：变异表六行→七行（variation.tres 实测 7 行含贫矿脉）/RewardConfigTable 行删除（reward_config.tres 与类名全仓零命中）/AuxItemTable→TreasureItemTable（treasure_items.tres）/MetaTable 四行族→五行族（+attune_refresh_upgrade）+HeroTable 补 armor_class（v0.6）
- node-reward 令牌池六种→七种（adventure_table.gd CURIO_KINDS 实测七类含 refresh，curio_quota_refresh_rare=2 在役；v2.5 修订漏登，v2.6）
- interaction-patterns #19 inventory_panel_view.gd『已实现』系失实登记（git 全史零记录，从未入库）→占位失效
- level-clear『加权洗牌掷 3』漏网旧口径→令牌池洗牌不放回（与冒险结构 v0.14 对齐）
- 奇物依赖表 relics.tres→feats.tres（表文件已换代）+§1.3 异质性账清单对齐凭证件表（AP 上限摘除）（v3.10）
R3/R4 退役残留清漏：
- 行动经济依赖表『挖/插/拔』拔旗残留（v0.4 批漏网，v0.11）
- 地图战斗资源依赖表『秘宝的背包』同调形态残留（v0.22）
- 冒险结构『秘宝件受同调位约束』替换交互无现役触发面补注+『06 在册』悬空指针清偿（v0.19）
- HUD框架秘宝义务行『库存条常读』→装配件与充能常读（v0.15）
- 教学引导/P0 闭环/战斗结算/level-clear 等六处『秘宝背包/关卡末清库』补机械惰性承载注（treasure_inventory 代码实证在役但投放渠道全退役恒空、拆线归实装批——battle.md『无关卡域清库面』表述精确化）
R2 里程碑/批次口径：
- level-map 四处 M-1/M-2 前缀删（迭代 2 框材组=git 9abf5ff 实证；迭代 4 三处）
- 07『难度修正批』全替『数值批（Beta 阶段，未排期）』（v0.4）
- 教学引导『里程碑定位 Alpha』两处→Beta 阶段（2026-10-04 用户拍板漏同步，v0.5）
- HUD框架 P1『秘宝内容重定批』过期批次名→node-reward v2.5 在役
指路断链：
- 06 archive 死链改写（不入库目录表述）+两条『用户令删除』死条目整条移除（git 留痕）
- 07 三处伪死链去链接语法
- 奇物 §1.6 两处 ../ux/→../../ux/（v2.7 旧债，doc_link 复验清零）+06 欠账条目同步清偿注
规范两份：
- doc-conventions §1『现行文档不跑 lint』与现实对齐（gdd_lint=机检三闸之一在役，v14）
- code-conventions active.md 旧路径迁根目录+版本表补建（v2）
doc 三闸终验：doc_link 死链 4→1（剩 1=版本历史行内历史引文按纪律保留）；gdd_lint 5 不通过/doc_term 6 旗均与基线持平零新增
This commit is contained in:
DKChan committed
1 parent
03c4b4c933
commit
bbc849eac5
18 files changed
+91
-61
No files matched your search
@@ -184,7 +184,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
|
||||
**抽取机制 = 令牌池洗牌不放回（v0.14 追认 b 实施形态，取代 E-S 加权洗牌）**：池 = 固定配额令牌库（普通 70/稀有 25/罕见 3=98 张，kind×tier 多重集）；洗牌 = Fisher-Yates 不放回抽 3（**同 kind 去重每 kind 至多一枚**——「三选一=三种不同选项」体验延续；kind 出现率∝剩余令牌数，档位配额即分布、无独立权重 knob）；**选中踢池、未选回池**（抽签不摘牌、兑付才摘牌）；**池耗即枯竭**（余库不足出齐剩余，空库=零候选合法态直通）；**种类次数上限退役**（池消耗即上限）。消费 reward_pick 封闭随机流（主种子派生、[数据配置](../表现与支撑/数据配置.md)口径），同种子同操作序列同三选项可复放。**MC 策略 316-f**：autoplay 1 级优先度=最稀有（rarest>rare>common）、2 级=最左。**提升池为冒险级单例**（迭代 10 追加批）：关卡内奖励节点的三选一与通关三选一共享同一令牌库（同库同摘牌），兑付语义归[关卡节点地图](关卡节点地图.md)。
|
||||
|
||||
**秘宝件受同调位约束**：道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值（0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地，过渡读数源 transitional_sync_slots 已随批退役；原提案八拍板 git 57da58c 已退役）。获取渠道约束形态（迭代 10 过渡承载）：三选一道具件超位触发**替换交互**（现有件与新件 N+1 选 N——丢任一原有件腾位收新，或放弃新件不获取；终态恒 ≤ 同调位）；奖励节点与战斗内渠道超位**不授予**（候选拒绝 + 掉落沉没，逐行归因留痕）——停点渠道全覆盖的替换交互随同调实施批统一收口（06 在册）。
|
||||
**秘宝件受同调位约束**（2026-10-09 注：道具件已随迭代 11 第①批 T7 出池——三选一/奖励节点/战斗内渠道现行零道具件投放，下述渠道约束与替换交互无现役触发面，保留作渠道恢复时的契约口径；同调位读数正主=attunement_growth.tres 谓词表实时求值）：道具持有上限 = 同调位数。读数源 = 同调位里程碑谓词表 attunement_growth.tres 实时求值（0 起步、硬上限 3、增长 = 通关次数 + Boss 击杀数——同调实施批 2026-10-03 落地，过渡读数源 transitional_sync_slots 已随批退役；原提案八拍板 git 57da58c 已退役）。获取渠道约束形态（迭代 10 过渡承载）：三选一道具件超位触发**替换交互**（现有件与新件 N+1 选 N——丢任一原有件腾位收新，或放弃新件不获取；终态恒 ≤ 同调位）；奖励节点与战斗内渠道超位**不授予**（候选拒绝 + 掉落沉没，逐行归因留痕）——停点渠道全覆盖的替换交互随同调实施批统一收口（原 06 条目已随收口移除）。
|
||||
|
||||
最后一关通关不发三选一与部分回血：没有下一战可受益——只做冒险完成结算，末关 Boss 钥石照常入账。设计意图：清库之后才兑付、末关不兑付，都是从「奖励只朝下一战生效」这一条推出来的。
|
||||
|
||||
@@ -301,7 +301,7 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
- 恢复点：回复 = floor(生效上限 × 恢复比例 ÷ 100) 后封顶；满血腿回复 0 合法。
|
||||
- 大奖励覆盖：三选一兑付后首战的入参 = 基础表值 + 加算区累加含选中件（覆盖值通道）；AP 件兑付后每场战斗开始首轮行动点基线 +1。
|
||||
- 抽签封闭：三选一掷 3 消费 reward_pick 封闭流，同种子同操作序列同三选项；单次零重复；令牌耗尽快即枯竭、不再出现在候选（池消耗即上限）。
|
||||
- 同调位约束：道具终态持有恒 ≤ 同调位（谓词表实时求值）；超位时停点渠道触发替换交互（丢旧收新 / 放弃新件两路），战斗内渠道沉没不入；奖励节点渠道同受约束。
|
||||
- 同调位约束：道具终态持有恒 ≤ 同调位（谓词表实时求值）；超位时停点渠道触发替换交互（丢旧收新 / 放弃新件两路），战斗内渠道沉没不入；奖励节点渠道同受约束。（现行零道具件投放——约束保留作契约，见「秘宝件受同调位约束」节注。）
|
||||
- 钥石逐杀：Boss 击杀后钥石累计增量 = boss_keystone 行值（首杀/复杀两档）；大奖励面钥石入账零残留。
|
||||
- 收束次序：通关宣布到达时库存已被关卡节点地图先行清空；重复的关卡结束宣布被拒绝，账本与摘要零变化。
|
||||
- 覆盖义务：冒烟断言——行集内每个战斗与关底节点（关、深）在敌人与棋盘生成的数值表中有精确行；序列关数 = 行集关数。
|
||||
@@ -338,3 +338,4 @@ GP（显示名「金币」）是冒险内的一次性属性提升货币：战斗
|
||||
| v0.17 | 2026-10-07 | **生命周期轴裁决随批（框架正主=核心循环「生命周期轴」节同批落文）**：GP 冒险账本节补独立资源口径——GP 与钥石=两条平行独立资源不立统一上位概念（钥石归元进度同批落文）；各层对 GP 的兑付=一次性转换入账（转换源结算即消尽、钱包长存，类A→类C 转换关系非横跨多层）；既有账本语义零改动 |
|
||||
| v0.18 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①关卡序列节「第二关生效有前提、未落地前单关运行」过期句替换——三关序列 2026-09-21 起均已生效；②共享池账本货架候选订正——pool_shelf 六行 = 池∖{GP 袋, 刷新件}∪{门票}（门票与回复随迭代15② 入架），「∖{GP 袋} 四种」过期；③大奖励表提升三选一「加权抽 3、另 2 件丢弃」改令牌池口径（洗牌不放回抽 3、未选回池）；④提升池表六种→七种——恢复件配额 稀有 5→3、补刷新件行（稀有 2/+1，迭代15② 入池）；⑤秘宝件同调位读数源改谓词表实时求值（transitional_sync_slots 已退役、切换义务清偿，调参表过渡键行同改）；⑥断点附随件「秘宝库存」重复短语去重；⑦P2 冒险长度扩展行「MVP 两关」改「现行三关」；⑧调参表关卡行集行「第一关现行、第二关随扩展批」改「三关现行（templates 池 3×5）」、三选一件值（其余）行 bonus_* 旧键改 curio_value_* 列族、三选一权重行整体标退役（E-S 随 TP0 换代）、件次数上限行删「GP/道具件无次数上限」残句；⑨验收三条订正——抽签封闭条「AP 用尽 2 次/属性件达 3 次先剔」改「令牌耗尽快即枯竭」、同调位条「过渡键」改「谓词表实时求值」、加算区同账条购买生命上限改 pool 模式语义（只加上限不回当前生命）；⑩不负责表「节点奖励内容与库存语义→地图战斗资源」改「节点奖励件的分类与凭证定义→奇物」（提升池构成与库存归本文——两文档互指矛盾收口）。 |
|
||||
| —— | 2026-10-09 | 缺号注记：v0.15 未登记（对应批次=MC-1 商店独立刷新机制批〔2026-10-04，git ac3cee7 提交信息明记「冒险结构v0.15回写」、版本行未入表〕，登记见正文「共享池账本」节 v0.15 标签），卫生批仅注记不补写 |
|
||||
| v0.19 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：「秘宝件受同调位约束」段与验收「同调位约束」条补现状注——道具件已随迭代 11 第①批 T7 出池，三渠道零投放、替换交互无现役触发面（与关卡节点地图 v1.7「满位替换子交互随之不再触发」口径对齐），约束保留作渠道恢复契约；段内「（06 在册）」悬空指针改「原 06 条目已随收口移除」 |
|
||||
@@ -221,7 +221,7 @@
|
||||
|
||||
**判据句（"资源"这个词太泛，这句是唯一的收口凭据）**：资源成员是**转换源**——不是资源本身，而是「到手即结算成独立资源或系统数值的**凭证**」，凭证加完消尽；被写入的账（GP 钱包/刷新存量/储备池/充能/当前 AP/资格）各有自己的寿命档位。拿不准一项该归哪类时问三句：它进不进角色自己的属性数值（进→属性值提升）；它改不改规则（改→专长）；都不是、而是某本系统账上多出来的一笔一次性加仓的，归资源。
|
||||
|
||||
**资源类内部的异质性（统一表述）**：凭证全部即时消尽——不存在「持有凭证」这种状态；异质性不在凭证上，而在**被写入的账的寿命**上：GP 钱包 / AP 上限 / 刷新存量 = 冒险级，储备池 / 完美资格 = 节点级，当前 AP = 回合级。登记此节防止把凭证当成会持续生效的东西去结算。
|
||||
**资源类内部的异质性（统一表述）**：凭证全部即时消尽——不存在「持有凭证」这种状态；异质性不在凭证上，而在**被写入的账的寿命**上：GP 钱包 / 生命账 / 刷新存量 / 秘宝充能 = 冒险级，储备池 / 完美资格 = 节点级，当前 AP = 回合级（账清单对齐「凭证件表（新 5+留任 2）」节——旧四项时代的「AP 上限」已归属性值提升轴，见 §1.2 在途注）。登记此节防止把凭证当成会持续生效的东西去结算。
|
||||
|
||||
#### 1.4 分类判据
|
||||
|
||||
@@ -246,7 +246,7 @@
|
||||
**两层是两件事，别混**：
|
||||
|
||||
- **命名是本节的规矩**——三个分类各有一个专名，文档、代码词族、帮百科一律用它。指代某个分类时直接说「专长」，不说「机制类」「专长那一类」。
|
||||
- **呈现是另一件事**（归 [battle](../ux/battle.md) 与 [node-reward](../ux/node-reward.md)，本节不裁决）：玩家看到某件奇物时，卡面只写**这件东西的名字与效果**，不附带它的分类。玩家可以从效果反推它属于哪一类，但界面不替他说破。
|
||||
- **呈现是另一件事**（归 [battle](../../ux/battle.md) 与 [node-reward](../../ux/node-reward.md)，本节不裁决）：玩家看到某件奇物时，卡面只写**这件东西的名字与效果**，不附带它的分类。玩家可以从效果反推它属于哪一类，但界面不替他说破。
|
||||
|
||||
**为什么两层都要有**：分类名在卡面上不出现，不等于玩家对它没有概念——帮助手册、百科条目、成就名称三处一定会用到它（「首次集齐 4 件专长」「三件属性值提升」），效果描述里出现指代时也需要名字（如「本项属专长」类归类指代）。所以它必须是一个**玩家读得懂、读一遍就懂**的正式名词，不能是内部描述或自造词。
|
||||
|
||||
@@ -402,7 +402,7 @@
|
||||
| 类型 | 内容 |
|
||||
|---|---|
|
||||
| 依赖（概念） | 角色、结算管线、行动点、地形、关卡节点地图、局内金币钱包、三选一界面 |
|
||||
| 依赖（数据） | `relics.tres`（专长定义行）、`adventure.tres`（属性值提升与资源的种类配额与值）、`shop.tres`（货架取舍） |
|
||||
| 依赖（数据） | `feats.tres`（专长定义行）、`adventure.tres`（属性值提升与资源的种类配额与值）、`shop.tres`（货架取舍） |
|
||||
| 输出（对外） | 持有集、生效中的分类投影、剩余候选池、可用重抽次数 |
|
||||
| 明确边界 | 不写账号进度、不改敌人与关卡内容、不承载具体数值 |
|
||||
|
||||
@@ -481,3 +481,4 @@
|
||||
| **v3.7** | 2026-10-09 | **去毒批（用户立「文档去毒」为首要任务）**：退役术语魔法道具→秘宝（正文各处，含关联边界表）/档名三档→四级扫改（罕见→稀有）/门票与刷新入表状态订正（迭代15② 已落籍，调参表与 P1 与待办节同步）/资源成员指路凭证件表/验收第 3 条改令牌口径——新老框架分家第一步，老章节冻结段随实装批整体替换不变。 |
|
||||
| **v3.8** | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①§1.6 命名节例子「同标签达到 4 件时质变」摘除（流派标签集件档位 v2.9 已框架级作废，换为不引退役机制的归类指代例）；②渠道轴交叉表专长行自撞「专长（专长）」修为「专长」（v2.7 同类自撞漏网）；③§2.4 回复节现状句订正——shop.tres pool_shelf 六行已含回复（迭代15② 落地，默认原则对齐），「货架四项、回复缺席须补上」过期表述替换；④§2.5 在册事项订正——门票形式已随迭代15② 入表实装，渠道分工仅 Boss 渠道直接给专长仍为目标状态；⑤生命周期表选定行老规则「选定即从池中剔除、任何渠道不再见」改令牌口径（拿消耗、刷出不计、耗尽不再出现——对齐验收第 3 条与 TP0 在役语义）；⑥依赖与输出表摘除「档位求值结果」（集件档位作废的漏网输出）；⑦§1.2 补成员变动在途注（行动点上限归属性值提升轴，在役仍三项、迁动归实装批——对齐 §1.3 表下正主注）。 |
|
||||
| **v3.9** | 2026-10-09 | **B3/B4 两裁落文（用户令）**：①P1 后置「两项合成高阶项」注销——非用户设计意图的脏信息，合成方向若需要按新体系重新生一件；②§3 刷新次数例外句口径换代——一律按最新设计口径：刷新次数由刷新券替代（凭证到手即结算进刷新存量账、加完消尽不进持有集），旧「进同一份持有账本」表述作废、随实装批整节删除 |
|
||||
| **v3.10** | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：①§1.3 异质性节「被写入的账」清单对齐凭证件表——旧四项时代「AP 上限」摘除（已归属性值提升轴，§1.2 在途注），补生命账/秘宝充能两账；②依赖与输出表 `relics.tres` 改 `feats.tres`（表文件已随词族对齐批换代，data/tables/ 无 relics.tres——代码实证） |
|
||||
@@ -182,7 +182,7 @@
|
||||
| 下游 | [难度曲线与Boss](../冒险循环/难度曲线与Boss.md) | 权重、档位、威力与池内容的调参所有权（全部 provisional） |
|
||||
| 下游 | [HUD 框架](../表现与支撑/HUD框架.md) | 呈现义务归其：已开格资源身份常读、类型图标预读的呈现深度、结算明细行、清图奖励行强调 |
|
||||
| 下游 | [教学引导](../表现与支撑/教学引导.md) | "读敌拍板、抢类型"教学口径的来源 |
|
||||
| 下游 | [秘宝](../排雷循环/秘宝.md) | 相邻：秘宝的背包与使用归其管；预读类道具读取本系统的身份查询面 |
|
||||
| 下游 | [秘宝](../排雷循环/秘宝.md) | 相邻：秘宝件的装配与使用归其管；预读类道具读取本系统的身份查询面（现行零投放——原承载件探宝罗盘已退役，接口面保留） |
|
||||
|
||||
负空间：本系统不订阅事件、不画界面、除摇号外不用任何随机数；何时调接口、按什么顺序调，全归[战斗结算](战斗结算.md)。库存、道具使用窗口、可选类供给已随可选类道具删除（2026-09-15）整体下线，不再属于本系统。
|
||||
|
||||
@@ -275,3 +275,4 @@
|
||||
| v0.19 | 2026-10-07 | **地图层题四裁（用户裁——四档池结构）**：候选集合节新增「四档概率结构与保底」——档=概率位+保底上限两参数（T1 攻击类/T2 增益类·GP 小袋/T3 回复可保底档/T4 惊喜类永不保底档=上限 0 统一表达）；保底按型登记（heal=每板 ≥1），超上限时每板随机选定兑现集合（暂定）；补签四纪律（只改类型身份/不消费权重/粒度=板/不泄露元信息）；GP 数值锚（小袋≈战斗结束 GP×1/10、大宝箱≈×1）；大宝箱枚举新增归实装批（微光归通用增益组，五色相不变）；调参表节补四档组织注记+旧「按板保底」失义句消歧；结构冻结条补「补签=装板期校验环节非重摇」；验收标准补四档保底条；袋装摇号备选挂号 06 |
|
||||
| v0.20 | 2026-10-07 | **档位名映射随批（正主=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批落文）**：四档池节补对外稀有度映射行——T1=普通/T2=优秀/T3=稀有/T4=传说（T4=头奖级，与「极致罕见抽到就是爽」定位互证）；同补护栏=任何概率提升不得改变本档保底承诺（保底=承诺非概率） |
|
||||
| v0.21 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①格面资源节「没挖开的格子在界面上不显示里面是什么」订正——未开格类型身份已随 2026-10-07 类型层身份裁决经微光只读可见（不显示的是雷安），与 P1 呈现深度行同步（基础档已定）；②清图节图类型词表 {dungeon, underdark} 补第三值 deep_underdark（第三关内容批在役，P1 差异化行同步）；③负责表与 P1「功能道具渠道、渠道设计未定」订正——功能道具 = 秘宝局外同调件（渠道已随秘宝域与同调实施批落定），本系统结构位不变；④调参表 ap_up 行「weight=6」改域表述（数值纪律：行值读表）。 |
|
||||
| v0.22 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：依赖与输出表秘宝行「秘宝的**背包**与使用归其管」过渡形态残留——同调形态无背包（关卡域库存已退役），改「秘宝件的装配与使用归其管」并补预读接口现行零投放注（与秘宝.md v1.7 依赖表对齐） |
|
||||
@@ -254,7 +254,7 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值
|
||||
└─ 关卡结束（上层显式调用）→ 清空秘宝背包，给出可见反馈
|
||||
```
|
||||
|
||||
停手与耗尽收轮的回合恒为同图继续；换图指令只允许出现在清图轮，其他轮发换图属于程序错误、立即上抛。秘宝背包以关卡为界：战斗结束不清背包，跨战斗延续；关卡结束时一次性清空，清空前先返回快照计数，作为"剩余秘宝随关卡结束清空"的可见反馈。战斗道具背包已随可选类删除（2026-09-15）下线。
|
||||
停手与耗尽收轮的回合恒为同图继续；换图指令只允许出现在清图轮，其他轮发换图属于程序错误、立即上抛。秘宝背包以关卡为界：战斗结束不清背包，跨战斗延续；关卡结束时一次性清空，清空前先返回快照计数，作为"剩余秘宝随关卡结束清空"的可见反馈。战斗道具背包已随可选类删除（2026-09-15）下线。（2026-10-09 注：清空对象 = 关卡域库存 treasure_inventory——秘宝过渡形态的机械惰性承载，其投放渠道已随迭代 11 第①批全退役、现行恒空；现行秘宝=营地同调装配件、整局冒险生效不经此域，拆线归实装批——见[秘宝](../排雷循环/秘宝.md)沿革节。）
|
||||
|
||||
挖掘期刷新是玩家在挖掘中途主动换图，经[行动经济](../排雷循环/行动经济.md)扣费：扣费成功后按"旧板退役、生成新板、装板、资源预分配恰一次、变异布置"编排，本轮不打断——没有结算段、没有轮次结束。储备不足被拒是玩家决策的合法结果，不是编排错误。刷新图不发清图奖励，完美排雷计数随装板重置。
|
||||
|
||||
@@ -347,7 +347,7 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值
|
||||
- 伤害下限与留档：任何来源的伤害落地 ≥ damage_floor（读表，2026-09-20 扩全来源），全流水零 v=0 伤害行、零"被减伤归零"行；掷点读数、护甲等级与档位随伤害行留档，天然最大面（nat20）行带暴击标记。
|
||||
- 数值边界：伤害下限保底后全程无零值/负值伤害；溢杀丢弃不转移；治疗封顶不溢出。
|
||||
- 出口分发：先判主角倒下（负）再判敌清空（胜）；停手与耗尽轮恒同图，清图轮才允许换图。
|
||||
- 关卡收束：关卡结束清空秘宝背包恰一次并返回清空前计数；战斗结束不清背包。
|
||||
- 关卡收束：关卡结束清空秘宝背包（关卡域库存——现行恒空的机械惰性承载，见「轮次生命周期」节注）恰一次并返回清空前计数；战斗结束不清背包。
|
||||
- 可回放（封闭随机流口径）：同种子同输入两遍步骤流逐位复现；随机消费仅限七处封闭随机流——开战掷骰（初始化随机）、技能摇号 `behavior_roll`（回合内、开轮时点、步骤流之外）、护甲等级掷点 `armor_roll`（回合内、步骤流之内）、奖励格摇号 `reward_roll`（初始化、装板期）、变异布置 `variant_place`（初始化、装板与资源预分配之后）、换板棋盘生成 `board_gen`（初始化、清图轮换板时点）、战斗结束掉落掷定 `gp_drop`（出口随机、战斗结束分支），无未登记随机源、零界面等待；单敌出招轨迹可独立复放、互不穿插。
|
||||
- 无来源即炸：每行明细都能指回一个来源事实（棋盘格、单位、清图或段级结论）；找不到来源即断言失败，行型与来源类别两层豁免清单见明细流水一节，豁免行仍受其它契约约束。
|
||||
- 行型封闭：流水只出现本文登记的 9 类行型；新增或下线行型必须走本文修订并同步呈现层行格式化，未登记行型不得落行。
|
||||
@@ -389,3 +389,4 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值
|
||||
| v0.25 | 2026-10-05 | **挖掘风险不等式判式换代（迭代14②号卡 T3/T4——与行动经济/难度曲线与Boss/registry 同批）**：①收益对照表补 gp/ap 当量口径注记（gp=flat power 代理 3/2 假设 A5 口径空白登记、ap=flat 表值 1 机会成本口径仅登记假设 A6，精确口径归商店批复核）；②验收标准 +条款3 对账条（聚合健康式+β 带逐 u 检算 / 旗溢价兑付三形态覆盖·标空与挖格不乘·同池零触碰）；③T4 机制载体 = settlement.tres 新键 flag_hit_premium=125（percent 域 provisional）——标中旗正向兑付 ×(1+δ)，整数四舍五入取整与伤害管线 floor 分域（registry 随批登记）；DamageController 零改、雷安同池冻结不动、直伤雷 6/8/8 与 p_perfect 不动 |
|
||||
| v0.26 | 2026-10-06 | **地图伤害账殿后批（案C，用户裁——歧义质询触发）**：①五段总览①③行改写——授予段只兑非伤害形态，伤害形态兑付（爆裂/直伤/反噬/地形变异/战旗军规/熔火反噬等）暂存到战斗段末、按「主角先手→逐敌还手→地图账」统一落地；②战斗段节补地图账殿后与死亡守卫（主角死于怪物→暂存单整体不兑，逐单留「未生效（主角已倒下）」行）；③结账时机双模式改述：现行=段界结账+地图账殿后，清图批同步读数改「将兑付」回报口径（完美第二份依据开单时点事实），历史基线读数以 2026-10-06 前授予段结账口径封存；④兑付形态表 blast 正向/heal 负向兑付时点改战斗段末；⑤P0 闭环第 5 步补地图账；⑥顺手清充能退役遗留：三分量句改单分量、三处「主角普通分量」改「基础分量」。切片同批：battle_orchestrator 暂存闸 `_defer_board_damage`/`_deferred_board` + `_submit` 案C 分流 + `_outcome_of` + 战斗段末补提交块 + 授予段四处直提改走闸；冒烟 783 项 0 失败（新增案C 段内序断言+行相位分类器换代）+ run_all 17 套全绿 + probe_gate --click 全绿；旧行为 MC 锚全数作废，重锚归数值批 |
|
||||
| v0.27 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①依赖表冒险结构行「provisional，MVP 冒烟直供」过期注记订正——覆盖值通道与接口四件套已随冒险结构实现批（2026-09-21）正式接线；②P1 后置「冒险侧真实供给接线」已随同批落地——行移除；③两处「对账现状见「待办」」悬空指针改指 06-待办清单。 |
|
||||
| v0.28 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：「秘宝背包」三处（五出口表关卡结束行/轮次生命周期节/验收关卡收束条）补机械惰性承载注——清空对象=关卡域库存 treasure_inventory（代码实证在役：level_runner.gd:520 快照计数、battle_orchestrator.gd:745 consume），投放渠道已随迭代 11 第①批全退役、现行恒空，同调装配件不经此域，拆线归实装批；行为描述与代码一致，仅补现状口径 |
|
||||
@@ -197,7 +197,7 @@
|
||||
| 方向 | 系统 | 接口要点 |
|
||||
|---|---|---|
|
||||
| 上游 | [数据配置](../表现与支撑/数据配置.md) | 配置表 schema 与类型化读取；本系统是该表的回填责任方 |
|
||||
| 上游 | [排雷玩法](排雷玩法.md) | 挖/插/拔的调用方：只判棋盘合法性，扣费必须过账本 |
|
||||
| 上游 | [排雷玩法](排雷玩法.md) | 挖/插的调用方：只判棋盘合法性，扣费必须过账本 |
|
||||
| 下游 | [战斗结算](../战斗循环/战斗结算.md) | 轮末两字段消息的接收方；回发换图指令与战斗结束信号；五条经济契约的对账责任方 |
|
||||
| 下游 | [地图战斗资源](../战斗循环/地图战斗资源.md) | 清图奖励内容与图类型差异化插槽的归口 |
|
||||
| 下游 | [HUD 框架](../表现与支撑/HUD框架.md) | 行动点与储备池常显；刷新入口；清零反馈；动作被拒原因的双源呈现（棋盘非法 vs 资源不足） |
|
||||
@@ -273,3 +273,4 @@
|
||||
| v0.8 | 2026-10-05 | **挖掘风险不等式判式换代（迭代14②号卡 T3——与战斗结算/难度曲线与Boss/registry 同批）**：F1 条款3 重立——三层口径并行立（条款2 标中旗锚不动/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」只留下限 0/旗边际引理+条件二旗溢价「E[标中兑付]≥(1+δ)·E_dig」δ=0.25 provisional 形态 a 兑付溢价）；条件二落文按登记已知破·T4 机制闭合；β 比值带 [1.2,2.5] 判读入文（u=3 登记态微破下限）；η 降格读数入文（分母=全部插旗数）；推导节变量表换代（E_dig/V_mine/ρ̂/β/δ 五锚）；旧界形式与「惩罚当量对账模型归调参批重立」挂账句全部清偿 |
|
||||
| v0.9 | 2026-10-07 | **生命周期轴裁决随批（框架正主=核心循环「生命周期轴」节同批落文）**：「每轮预算与价目」节首补 AP 两账定义段——AP 上限=冒险级角色属性（开局基值+冒险中秘宝/属性提升抬高，兑现细则归「跨冒险行动点加成轴」节）、当前 AP=回合级池（每轮灌满、归零收轮，本账本只管后者）；既有规则面零改动 |
|
||||
| v0.10 | 2026-10-09 | 文档正确性审查批：巢穴约束表「资格认雷格实例」行重复短语清除（「堵死重复计费重插刷收益的农场」一句两写删一） |
|
||||
| v0.11 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：依赖与输出表排雷玩法行「挖/插/**拔**的调用方」退役动作残留清除——拔旗已随插旗不可逆批（2026-09-19）退役，v0.4 批六处删「拔旗」时本处漏网 |
|
||||
@@ -164,7 +164,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| 关联与边界 | 与「未开格类型微光」同边界——灯光区起步半径=微光环 8 格（同圈起步，实测后可调）；格态数据归[排雷玩法](../排雷循环/排雷玩法.md)；黑暗区域渲染规格（暗淡态明度、迷雾过渡）归 [art-bible](../../../art/art-bible.md) 修订随实施批；初始展开收窄不在本案（后置与 Alpha 差异化批窗口合并再议） |
|
||||
| 实装状态 | **已实装**（2026-10-03 迭代 11 第④批落籍；四裁决逐条对账与验收线转正见本节末「实施状态」注记；渲染规格 = [art-bible](../../../art/art-bible.md) §6.5） |
|
||||
|
||||
配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +2 格，flat 整数档）随迷雾立项；**类型微光不随视野扩大**（类型先读仍只贴身 8 格，微光锚=可挖域）；提灯载体归 aux_items 新行（登记原文——2026-10-07 用户令改道为独立卡，2026-10-08 裁案A=秘宝·同调位新行落位，见下方实施状态注记），呈现面挂「资产升档重产批」（挂账不动）。
|
||||
配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +2 格，flat 整数档）随迷雾立项；**类型微光不随视野扩大**（类型先读仍只贴身 8 格，微光锚=可挖域）；提灯载体归 aux_items 新行（登记原文——2026-10-07 用户令改道为独立卡，2026-10-08 裁案A=秘宝·同调位新行落位，见下方实施状态注记；**2026-10-09 用户裁退役**——新目录 15 件未收提灯，fog_lantern 数据行与卡④接线拆除归退役删行批〔实装批〕，功能由新目录普通档「阔视野带」承接，06 登记条在册），呈现面挂「资产升档重产批」（挂账不动）。
|
||||
|
||||
**实施状态（2026-10-03 迭代 11 第④批落籍）**：迷雾遮蔽+菱形灯光区跟随+暗淡记忆态上线，探针断言随批扩（ui_input_probe case⑮）。四裁决逐条对账——①案甲视野迷雾立项（纯呈现层）：迷雾开关分层验证可用（呈现态布尔，off 态=无迷雾基线），同板同动作序列与 MC 对拍逐位一致；②暗淡记忆态：区外已开格灰显+数字可读，明度按 [art-bible](../../../art/art-bible.md) §6.5 落文值（记忆板 #3A3A3A/记忆墨 #C4C4C4，provisional）；③灯光半径=微光环 8 格同圈：LIGHT_RADIUS=8 参数化（曼哈顿菱形，常量）；④提灯 +2、微光不扩：FOG_LANTERN_BONUS=+2（落码常量实名——本条旧记 LIGHT_RADIUS_LANTERN_BONUS 系文档侧拟名，随卡④落籍对齐），类型微光仍贴身 8 邻格零改动。**〔2026-10-05 迭代14⑤接线注记〕公共接线面已就位**——`board_view.set_fog_lantern(enabled)`（true=半径 8+2、false=复原 0；写入即 refresh 重算雾态），半径算式消费 `_fog_lantern` 迷雾批已在位；ui_input_probe case⑮ 增接线断言（开=dist 9 格转可见+lantern=2／关=复原）。**〔2026-10-08 迭代 19 卡④落籍注记〕载体到位+接线闭环=功能可达**——载体=秘宝·同调位新行 `fog_lantern`「魔法提灯」（treasure_items.tres 表尾追加，desc「灯光区半径+2」，slot_cost 1、营地道具工坊同调装配获渠，行字段=用户「按推荐」全收）；生产路径=runner set_attunement→enc.attunement→begin_battle 注入 orchestrator 装配集→公共只读出口 `attune_has`→组合根呈现桥 `main._sync_fog_lantern` 每战首轮装配链**显式重算含否**（🔴 复原语义=禁战斗结束隐式复原——卸装/未装配写 0，断点续玩/跨关天然正确）；未装配=false 写 0=缺省零扰动基线逐位不变。测试随批：case⑮ 载体级段（装配→lantern=2+dist R+1 转可见+卸装复原）+smoke 行字段/同调目录投影（九件→十件）/装配贯通断言+存档回归 Part 6+单测 fog_lantern_wiring（run_all 17→18 套）。原「提灯载体归 aux_items 新行随 Alpha 信息件重定批」登记去向就此销账（改道留痕=需求卡片-提灯载体道具批-2026-10-07 §一）。验收线（本篇「验收标准」视野迷雾行）逐条转正式验收：区内完整渲染／区外已开格灰显可读／区外未开格不可见／灯光区随移动跟随／两态结算逐位一致；实机目检人闸（迷雾观感/记忆态可读性/移动跟随流畅度）随出口闸。黑暗区域渲染规格承载 = art-bible §6.5（v3.5）。
|
||||
|
||||
@@ -213,7 +213,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| [敌人系统](../战斗循环/敌人系统.md) | 意图线索映射成文且全局恒定；单位顺位与血条可读；敌方共享层数各卡同值 |
|
||||
| [增益状态](../战斗循环/增益状态.md) | 状态栏常显；无状态时整排槽隐藏；有利 / 有害极性呈现不看数值符号 |
|
||||
| [地图战斗资源](../战斗循环/地图战斗资源.md) | 已开格的奖励身份常读；未开格类型微光（英雄周围 8 格内的未开格显示资源类型——概念定义见本篇「未开格类型微光」节） |
|
||||
| [秘宝](../排雷循环/秘宝.md) | 库存条常读；使用交互与目标拾取；板级叠加层信息呈现 |
|
||||
| [秘宝](../排雷循环/秘宝.md) | 装配件与充能常读；使用交互与目标拾取；板级叠加层信息呈现（在役旧框架——随实装批整体替换，秘宝.md v1.7 同款口径） |
|
||||
| [棋盘生成](../排雷循环/棋盘生成.md) | 零合法板的诚实告知（数据面经战斗结算上抛，本系统只管提示形态） |
|
||||
| [地形变异](../排雷循环/地形变异.md) | 全局作用域型三层预告（2026-10-04 首发批——语义正主=地形变异 §全局作用域型）：①开战横幅一行（板级变异非空时显示；减动效=静态驻留，轮横幅先例同款双态）②HUD 常驻角标（C 区战斗全程可见防中局遗忘，空态整节隐藏=奇物段先例；摆位 provisional）③帮助手册一行（零交互教学，承载=玩法帮助文案块）；数据面经呈现快照 board_variants 投影（核心→呈现唯一读取面），普通图三层恒空态零打扰 |
|
||||
|
||||
@@ -224,7 +224,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
3. 回执链：组合根重查只读面，界面字段级就地刷新。
|
||||
4. 轮末进入结算：棋盘区锁输入，明细带展开逐行兑现（战斗结算流水驱动）。
|
||||
5. 终局呈现（胜利 / 失败）伴随状态全清与储备清零反馈。
|
||||
6. 关卡末清库反馈：义务载体 = 秘宝背包，随秘宝 P0 落地（现行切片无库存容器，直接进下一节点或返回）。
|
||||
6. 关卡末清库反馈：义务载体 = 秘宝背包（关卡域库存——秘宝过渡形态机械惰性承载，投放渠道全退役后恒空；拆线归实装批，见[战斗结算](../战斗循环/战斗结算.md)「轮次生命周期」节注）。
|
||||
|
||||
## P1 / P2 后置
|
||||
|
||||
@@ -233,7 +233,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| P1 | 远格点击自动"先移动再挖"复合意图 | 移动免费高频，两击摩擦先经实测验证再裁 |
|
||||
| P1 | Gamepad 焦点序 | 纯鼠标已覆盖 MVP 全部操作 |
|
||||
| P1 | 可访问性正式分层（文本缩放 / 色盲模式 / 按键重映射） | 归[设置与本地化](设置与本地化.md)设置项全集裁决（2026-09-27 拍板不另立专项文档） |
|
||||
| P1 | 相邻域屏（节点奖励 / 关卡结算）完整屏形态 | 归后续 UX 文档（关卡结算屏 spec 已建 [level-clear](../../ux/level-clear.md)——2026-09-27；节点奖励屏随秘宝内容重定批）；MVP 以覆盖层反馈承载 |
|
||||
| P1 | 相邻域屏（节点奖励 / 关卡结算）完整屏形态 | 归后续 UX 文档（关卡结算屏 spec 已建 [level-clear](../../ux/level-clear.md)——2026-09-27；节点奖励屏 spec 已在役：[node-reward](../../ux/node-reward.md) v2.5 令牌池口径）；MVP 以覆盖层反馈承载 |
|
||||
| P2 | 提示一次性作用域升级为存档级"一生一次" | 归[存档序列化](存档序列化.md)与[元进度](../跨局循环/元进度.md)后重议 |
|
||||
| P2 | 调试面板退役 | 正式侧归元进度；诊断按钮保留为调试设施 |
|
||||
| P2 | 探测类秘宝的显影呈现面 | 接口归[秘宝](../排雷循环/秘宝.md)定稿批 |
|
||||
@@ -271,7 +271,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
- 高光三档：标中旗行金框、清图奖励行金框、完美排雷全屏喝彩级——庆祝不打在空兑现上（首份即零兑付则不发高光）。
|
||||
- 状态槽显示图标加层数加剩余结算次数，悬停见来源；极性按键级表呈现（金满框 / 红缺框），空态整排隐藏、数据框上移补位；战斗结束全清有微文案。
|
||||
- 敌人呈现（站桩立绘，2026-09-20 全站桩拍板后载体由敌人卡改为无框立绘+底座，义务面平移不重述）：意图占位 = 本拍摇定结果的动画占位（敌人技能池批三档可见性——普通攻击零表示、特殊技类型级提示〔攻/防系两型〕，不预告技能名与数值、池与权重不公开）且挖掘期全程可见、映射跨局恒定、顺位可读、血量数字可读、敌方共享层数各立绘同值（血条悬浮头顶、状态小图标挂血条正下方）；死亡灰化加碎裂退场（禁止瞬间消失）且就地更新不丢灰化态。
|
||||
- 终局：胜利金蜡封、失败暮蓝氛围层（明度不变）；储备清零与状态全清两反馈不合并、时序不倒挂（关卡末清库反馈义务载体 = 秘宝背包，随秘宝 P0 落地补验收）。
|
||||
- 终局：胜利金蜡封、失败暮蓝氛围层（明度不变）；储备清零与状态全清两反馈不合并、时序不倒挂（关卡末清库反馈义务载体 = 秘宝背包〔关卡域库存恒空机械惰性承载，拆线归实装批——见「轮次生命周期」同款节注于战斗结算〕，随秘宝 P0 落地补验收）。
|
||||
- 任一模态层打开时遮挡物隐藏或输入锁定、关闭逐层恢复；tooltip 与明细行等动态区固定槽高、换行裁剪不推挤布局。
|
||||
- 终局呈现只消费流水与快照：核心对象销毁后呈现层对生命周期状态零回读；终局后重放渲染与实时渲染一致。
|
||||
- 消费的每份载荷逐字段断言通过（缺字段、多字段都算失败）。
|
||||
@@ -302,3 +302,4 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
||||
| v0.13 | 2026-10-04 | **地形变异三层预告义务批（全局作用域变异首发批——迭代 14 ③号卡，代码同批）**：呈现义务来源清单补「地形变异」行（开战横幅一行〔减动效=静态驻留，轮横幅先例同款双态〕+ C 区常驻角标〔空态整节隐藏=奇物段先例，摆位 provisional〕+ 帮助手册一行〔零交互教学〕）；验收标准补三层预告线（普通图恒空态零打扰）；数据面走呈现快照 board_variants 投影（核心→呈现唯一读取面）。语义正主=地形变异.md §全局作用域型，本文只锁呈现承载 |
|
||||
| v0.14 | 2026-10-03 | **视野迷雾实施批落籍注记（迭代 11 第④批）**：迷雾节补「实施状态」注记（四裁决逐条对账：纯呈现两态逐位一致／暗淡记忆态灰显可读／LIGHT_RADIUS=8 参数化〔提灯 +2 插值位预留未接〕／类型微光仍贴身 8 邻格）；实装状态行「待实施批」改「已实装」；验收标准迷雾行去「待实施批落地后验收」括注转正式验收。机制定义零改动（定义一句话/作用范围/生命周期/关联边界/配套拍板全段原样）；黑暗区域渲染规格落 art-bible §6.5（v3.5） |
|
||||
| v0.13 | 2026-09-30 | **视野迷雾概念落位批（用户拍板立项）**：新增「视野迷雾」节=正主定义（菱形灯光区+黑暗边界；区外已开格=暗淡记忆态灰显可读、区外未开格=全黑；灯光半径起步=微光环 8 格同圈；纯呈现层，与已退役雾格无关）；验收标准补迷雾线；配套拍板随节登记（魔法提灯灯甲外扩 +2 格、类型微光不随视野扩、初始展开收窄后置 Alpha 差异化批）。实施待主线编卡 |
|
||||
| v0.15 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①视野迷雾配套拍板段补魔法提灯退役注（2026-10-09 用户裁——fog_lantern 数据行与卡④接线拆除归退役删行批，功能由新目录「阔视野带」承接，06 登记条在册）；②呈现义务清单秘宝行「库存条常读」改「装配件与充能常读」（同调形态无库存条——与秘宝.md v1.7 依赖表对齐）+补在役旧框架注；③P0 闭环第 6 步与验收「终局」条的关卡末清库载体补机械惰性承载注（关卡域库存恒空、拆线归实装批——与战斗结算 v0.28 同款口径）；④P1 相邻域屏行「节点奖励屏随秘宝内容重定批」过期批次名清偿（node-reward.md v2.5 令牌池已在役） |
|
||||
@@ -58,17 +58,24 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
|
||||
|
||||
**唯一豁免 = `breakpoint` 断点域**（2026-09-29 迭代 8 卡①随批修订）：断点是冒险进行中的瞬态快照，不是跨局携带——里面的生命/GP/道具库存只在「续玩上局」时还原进局内，冒险收束（通关/失败/放弃）即整域清除，永远不会渗进永久进度。反面清单的管辖对象因此收窄为 `meta` 永久进度域（冒烟域界扫描随批收窄到 meta 域）；断点域自身的字段口径归[冒险结构](../冒险循环/冒险结构.md)登记。
|
||||
|
||||
存档是单文件 JSON（`user://save.json`），字典键一律字符串。数据模型：
|
||||
存档是单文件 JSON（`user://save.json`），字典键一律字符串。数据模型（现行 = v6；示例值全为零值默认态）：
|
||||
|
||||
```json
|
||||
{
|
||||
"version": 2,
|
||||
"version": 6,
|
||||
"meta": {
|
||||
"keystone_balance": 0,
|
||||
"forge_levels": {"max_hp": 0, "atk": 0, "armor_class": 0},
|
||||
"item_unlocks": {},
|
||||
"level_clear_counts": {"1": 0, "2": 0, "3": 0},
|
||||
"boss_first_kill": {},
|
||||
"boss_kill_count": {},
|
||||
"attunement_equipped": [],
|
||||
"attune_refresh_level": 0,
|
||||
"tree_nodes": {},
|
||||
"fork_sides": {},
|
||||
"adventure_total": 0,
|
||||
"adventure_cleared": 0,
|
||||
"recent_summaries": []
|
||||
},
|
||||
"breakpoint": {}
|
||||
@@ -82,9 +89,18 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
|
||||
| `item_unlocks` | 已解锁道具集合（道具工坊消费） | [元进度](../跨局循环/元进度.md) |
|
||||
| `level_clear_counts` | 每关通关次数（键 = 关卡序号字符串） | [元进度](../跨局循环/元进度.md) |
|
||||
| `boss_first_kill` | Boss 首杀标记位（键 = 关卡序号字符串） | [元进度](../跨局循环/元进度.md) |
|
||||
| `boss_kill_count` | Boss 击杀总数（含重复——同调位增长谓词计数源，v4） | [元进度](../跨局循环/元进度.md) |
|
||||
| `attunement_equipped` | 同调装配关系持久（冒险中途不可换装，v4） | [秘宝](../排雷循环/秘宝.md)（承载语义归[元进度](../跨局循环/元进度.md)） |
|
||||
| `attune_refresh_level` | 营地刷新升级（Y 源）等级（v4） | [秘宝](../排雷循环/秘宝.md)（三选一刷新双源） |
|
||||
| `tree_nodes` | 天赋树已购等级（node_id→int，v5） | [天赋树](../跨局循环/天赋树.md) |
|
||||
| `fork_sides` | Fork 组激活侧（fork_group→a/b，v5） | [天赋树](../跨局循环/天赋树.md) |
|
||||
| `adventure_total` | 冒险总局数终身计数（开局即计、含放弃与失败，v6） | [生涯](../跨局循环/生涯.md) |
|
||||
| `adventure_cleared` | 通关局数终身计数（三关全通才计 1，v6） | [生涯](../跨局循环/生涯.md) |
|
||||
| `recent_summaries` | 最近冒险摘要副本，最新在前，最多 10 条 | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
| `breakpoint` | 冒险断点快照（停点粒度续玩域；空字典 = 无断点合法态——「继续上局」隐藏） | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
|
||||
v4/v5/v6 各域缺键由读取方按默认值补齐（空集合/0），旧档零迁移损失；收束自增域（通关次数/Boss 计数/终身计数）的唯一入账点 = `apply_adventure_summary`。
|
||||
|
||||
消费面纪律：其他系统只经 SaveManager 的类型化访问器（读余额/加钥石/花钥石、读写锻造等级等）与域更新原语（`apply_adventure_summary`）操作存档，不碰内部数据结构。
|
||||
|
||||
### 读写时机
|
||||
@@ -107,7 +123,7 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
|
||||
|
||||
### 版本与迁移
|
||||
|
||||
存档带版本字段（`version`，当前 = 2：v2 = 断点域出生〔迭代 8 卡①〕，与 registry `schema_version` 同源）。三条走向：
|
||||
存档带版本字段（`version`，当前 = **6**；版本沿革：v2 = 断点域出生〔迭代 8 卡①〕→ v3 = 断点附随件扩列 + 摘要 keystone_drops〔迭代 10 奖励重构〕→ v4 = 同调批扩域〔boss_kill_count / attunement_equipped / attune_refresh_level，迭代 11 第①批〕→ v5 = 天赋树域〔tree_nodes / fork_sides，迭代 12〕→ v6 = 生涯终身计数域〔adventure_total / adventure_cleared，迭代 18 卡④〕；与 registry `schema_version` 同源）。三条走向：
|
||||
|
||||
| 情形 | 处置 |
|
||||
|---|---|
|
||||
@@ -115,7 +131,7 @@ SaveManager 不依赖任何玩法系统就能工作：它是被动的承载方
|
||||
| 版本更高（未来版本的档） | **拒读且禁写**：不加载、后续写盘一律拒绝、内存以默认新档运行——保护未来版本的档不被当前版本覆写 |
|
||||
| 版本更低（旧档） | 读档时逐级迁移：从旧版本起逐个调用注册的迁移函数升到当前版本；任一步失败按损坏兜底处理 |
|
||||
|
||||
迁移函数经 `register_migration(旧版本号, 函数)` 注册：函数把数据从「旧版本」改写成「旧版本 + 1」。生产迁移链当前一件：v1→v2 = 断点域补空（旧档无断点 = 合法空态，非损坏非债务，迭代 8 卡①随批注册）。
|
||||
迁移函数经 `register_migration(旧版本号, 函数)` 注册：函数把数据从「旧版本」改写成「旧版本 + 1」。生产迁移链现行五件（v2 起自注册）：v1→v2 = 断点域补空；v2→v3 = 断点附随件与摘要 keystone_drops 补键（读取方 .get 兜底）；v3→v4 = 同调三域补键；v4→v5 = 树域两键补齐 + 三体系迁移（forge_levels→锻造脉节点等效点亮、工坊解锁→道具工坊节点、同调谓词→同调位节点——幂等、零亏损，迁移规则归[天赋树](../跨局循环/天赋树.md)）；v5→v6 = 生涯两终身计数域补零。任一步失败按损坏兜底处理。
|
||||
|
||||
### 损坏兜底
|
||||
|
||||
@@ -144,7 +160,7 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)把单
|
||||
|
||||
## 调参表
|
||||
|
||||
本系统没有玩法调参数值。两个结构常量登记在 registry `save_file` 条目：存档版本号（=2，与 registry `schema_version` 同源）、最近摘要保留条数（10）。二者是结构契约不是平衡值，改动属于版本迁移事件，不走调参批。
|
||||
本系统没有玩法调参数值。两个结构常量登记在 registry `save_file` 条目：存档版本号（=6，与 registry `schema_version` 同源）、最近摘要保留条数（10）。二者是结构契约不是平衡值，改动属于版本迁移事件，不走调参批。
|
||||
|
||||
## 验收标准
|
||||
|
||||
@@ -169,3 +185,4 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)把单
|
||||
| v1.1 | 2026-09-23 | 单关测试直入口（L2/L3）退役（用户拍板——唯一试玩入口 = 完整冒险）：不写档条款改口径为「调试两层与 headless 单关测试路径（LevelRunner.start_level，仅 QA 工具）」；写盘面零改动（正式冒险收束唯一写档点不变） |
|
||||
| v1.2 | 2026-09-29 | **断点域出生（迭代 8 卡①，schema v1→v2）**：`breakpoint` 域登记（停点粒度续玩快照，内容 owner=冒险结构）；反面清单收窄到 meta 域+断点域豁免条款；写盘时机+停点快照/三结局清除；生产迁移链 v1→v2 补空；P1 快照预挂号兑现（rng `restore_adventure` 回填面）；域界验收口径随改 |
|
||||
| v1.3 | 2026-10-01 | **版本兼容口径批（迭代 10 追加批 g 裁——用户拍板：版本兼容对齐 semantic version 标准）**：①版本策略成文口径——本域版本号语义 = **向后兼容的次序版本**：升版只允许「旧档在新代码可读可玩可续玩」（缺新键=合法空态、内容零丢失、断点可续），禁「新档在旧代码可读」承诺（向前兼容不做）；②v2→v3 迁移体=空迁移（断点附随件扩列〔bonus_taken/bonus_pending/bonus_result/bonus_aux_carry/keystone_drops + bonus.ap 轴〕与摘要 additive 键 keystone_drops 均由读取方 .get 兜底——兼容性由冒烟 v1→v3 与 v2→v3 断点续玩断言承载，2026-10-01 增）；③中断节点兼容义务：每升版必须在冒烟断言「旧版断点→新版续玩受理」（现行三档 v1/v2/v3 齐） |
|
||||
| v1.4 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09——版本滞后四代换代，全部代码实证 save_manager.gd SAVE_FORMAT_VERSION=6）**：①数据模型 JSON 与域清单表换代 v2→v6——补 v4 同调三域（boss_kill_count/attunement_equipped/attune_refresh_level，迭代 11①）、v5 树域（tree_nodes/fork_sides，迭代 12）、v6 生涯两终身计数域（adventure_total/adventure_cleared，迭代 18 卡④）逐域 owner 行；②版本与迁移节换代——当前=6、迁移链五件（v1→v2…v5→v6，含 v4→v5 三体系迁移指路天赋树）；③调参表版本常量 2→6；④缺键补齐纪律句补记（读取方默认补零/空集合，收束自增唯一入账=apply_adventure_summary）。注：v3/v4/v5/v6 四次升版当时均未回写本文，本批一次性清偿 |
|
||||
@@ -59,12 +59,12 @@ HUD 框架定稿时已为教学留好两个承载位，本系统的内容将来
|
||||
| chord 不存在的首遇提示 | [HUD 框架](HUD框架.md)（承接排雷玩法的呈现义务） | 经典扫雷玩家会习惯性双击数字格——本作没有 chord，点数字格 = 移动小人。每场冒险提示一次，非模态 |
|
||||
| 挖非相邻格的首次提示 | [HUD 框架](HUD框架.md) | 挖与旗都限小人 8 向相邻的格子，第一次越界操作时提示 |
|
||||
| 增益叠层节奏 | [增益状态](../战斗循环/增益状态.md) | "同一轮拿满优于跨轮慢慢叠"——增益有结算次数衰减，教学要传达这个节奏 |
|
||||
| 库存关卡末清空 | [地图战斗资源](../战斗循环/地图战斗资源.md) | 道具库存随关卡结束清空，需有反馈与教学条目 |
|
||||
| 库存关卡末清空 | [地图战斗资源](../战斗循环/地图战斗资源.md) | 道具库存随关卡结束清空，需有反馈与教学条目（清空对象=关卡域库存——秘宝过渡形态机械惰性承载、投放渠道全退役后恒空，拆线归实装批；本条目随拆线失效） |
|
||||
| Boss 图整图变异说明行 | [地形变异](../排雷循环/地形变异.md)（全局作用域变异首发批 2026-10-04） | Boss 图整图变异（贫矿脉——生存资源变薄、进攻资源变肥）开战横幅与 HUD 角标常驻预告；帮助手册一行承载常量性知识（零交互教学——「手册零再教」承载位，见 HUD 框架玩法帮助文案块） |
|
||||
|
||||
### 内容原则
|
||||
|
||||
- **整体后置**：教学引导是 MVP 之后的打磨项（见 [不做清单](../../05-不做清单.md)：先验证核心循环，再谈好听好看），里程碑定位 Alpha。
|
||||
- **整体后置**：教学引导是 MVP 之后的打磨项（见 [不做清单](../../05-不做清单.md)：先验证核心循环，再谈好听好看）；改排 **Beta 阶段**（2026-10-04 用户拍板——当前 Alpha 版不做教学相关工作，登记见 [06-待办清单](../../06-待办清单.md)教学引导节头注记）。
|
||||
- **一次性提示**：首次触发类提示每场冒险至多出现一次，不反复轰炸。
|
||||
- **只教规则，不替玩家玩**：教学解释规则与因果，不提供自动操作或"最优解"提示。
|
||||
|
||||
@@ -86,7 +86,7 @@ HUD 框架定稿时已为教学留好两个承载位，本系统的内容将来
|
||||
|
||||
| 优先级 | 内容 | 后置原因 |
|
||||
|---|---|---|
|
||||
| P1 | 教学引导全体 | MVP 打磨项排后（不做清单），里程碑 Alpha |
|
||||
| P1 | 教学引导全体 | MVP 打磨项排后（不做清单）；**Beta 阶段**（2026-10-04 用户拍板改排） |
|
||||
| P2 | 可重看的教学手册（图例面板兼任） | 待教学形态定稿后评估 |
|
||||
|
||||
## 调参表
|
||||
@@ -116,4 +116,5 @@ HUD 框架定稿时已为教学留好两个承载位，本系统的内容将来
|
||||
| v0.1 | 2026-09-14 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
||||
| v0.2 | 2026-09-15 | 雾格残留清理：删除「待拍板」的雾类教学条目失义登记（图例条目"迷雾 = 无雷盲区"与雾格首遇三要点提示），"待设计问题清单"第 3 条去掉雾条目删除的限定。教学条目清单与承载设施不变 |
|
||||
| v0.3 | 2026-09-17 | 数值纪律收口批：呈现常量复述改指路 HUD 框架调参表 |
|
||||
| v0.4 | 2026-10-04 | **地形变异手册行批（全局作用域变异首发批——迭代 14 ③号卡，代码同批）**：已登记的教学条目表补「Boss 图整图变异说明行」——三层预告中的手册层承载（帮助文案块一行，零交互教学），横幅/角标两层归 HUD 框架；语义正主=地形变异.md §全局作用域型 |
|
||||
| v0.4 | 2026-10-04 | **地形变异手册行批（全局作用域变异首发批——迭代 14 ③号卡，代码同批）**：已登记的教学条目表补「Boss 图整图变异说明行」——三层预告中的手册层承载（帮助文案块一行，零交互教学），横幅/角标两层归 HUD 框架；语义正主=地形变异.md §全局作用域型 |
|
||||
| v0.5 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①内容原则与 P1 后置「里程碑定位 Alpha」改排 **Beta 阶段**（2026-10-04 用户拍板教学引导整体改排，06 节头注记在案——本文漏同步）；②教学条目「库存关卡末清空」行补机械惰性承载注（清空对象=关卡域库存恒空、拆线归实装批，本条目随拆线失效——与战斗结算 v0.28 同款口径） |
|
||||
@@ -58,19 +58,18 @@
|
||||
|---|---|---|
|
||||
| 行动经济表 `ActionEconomyTable` | 每轮行动点、动作价目、停手与刷新门槛 | [行动经济](../排雷循环/行动经济.md) |
|
||||
| 棋盘生成参数表 `BoardGenTable` | 板尺寸、雷密度、可推理率目标等（进度键表） | [棋盘生成](../排雷循环/棋盘生成.md) |
|
||||
| 变异表 `VariationTable` | 变异类型清单（现行六行两轴×三关（2026-09-20 落地）） | [地形变异](../排雷循环/地形变异.md) |
|
||||
| 变异表 `VariationTable` | 变异类型清单（现行七行：region 六行两轴×三关〔2026-09-20 落地〕+ 首发 global 整图型贫矿脉〔2026-10-04 落地〕） | [地形变异](../排雷循环/地形变异.md) |
|
||||
| 敌人表 `EnemyTable` | 敌种基线数值、遭遇数量区间、护甲类型、技能池模板（进度键表） | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 技能表 `SkillTable` | 技能行定义（类型/倍率/冷却/增益引用）与保底阈值 | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 主角表 `HeroTable` | 主角生命上限与基础攻击 | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 主角表 `HeroTable` | 主角生命上限、基础攻击与护甲等级（armor_class）等单行战斗数值 | [敌人系统](../战斗循环/敌人系统.md) |
|
||||
| 状态效果表 `StatusEffectTable` | 增益/减益效果定义行 | [增益状态](../战斗循环/增益状态.md) |
|
||||
| 奖励表 `RewardTable` | 奖励条目、类别、权重与档位 | [地图战斗资源](../战斗循环/地图战斗资源.md) |
|
||||
| 奖励配置表 `RewardConfigTable` | 奖励供给控制参数（单行全局） | [地图战斗资源](../战斗循环/地图战斗资源.md) |
|
||||
| 结算表 `SettlementTable` | 结算段序、当量参考敞口、封顶与克制矩阵（单行全局） | [战斗结算](../战斗循环/战斗结算.md) |
|
||||
| 秘宝表 `AuxItemTable` | 秘宝定义行 | [秘宝](../排雷循环/秘宝.md) |
|
||||
| 秘宝表 `TreasureItemTable`（`treasure_items.tres`） | 秘宝定义行 | [秘宝](../排雷循环/秘宝.md) |
|
||||
| 难度表 `DifficultyTable` | 难度修饰乘数（占位空表） | [难度曲线与Boss](../冒险循环/难度曲线与Boss.md) |
|
||||
| 关卡表 `LevelTable` | 逐关节点图与层名 | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
| 冒险表 `AdventureTable` | 关卡大奖励与钥石入账（单行全局） | [冒险结构](../冒险循环/冒险结构.md) |
|
||||
| 元进度表 `MetaTable` | 元进度字段（已建表（2026-09-21，四行族）） | [元进度](../跨局循环/元进度.md) |
|
||||
| 元进度表 `MetaTable` | 元进度字段（已建表 2026-09-21——现行五行族：属性锻造 / Boss 钥石 / 工坊阈值 / 换算率 / 同调刷新升级行族，随批扩列） | [元进度](../跨局循环/元进度.md) |
|
||||
|
||||
举证：本节为数据纪律约定，无计算。违规检测 = 静态扫描加人工复核，随各表回填定稿与里程碑检查执行。
|
||||
|
||||
@@ -221,3 +220,4 @@
|
||||
| v0.3 | 2026-09-17 | 代币→钥石统一拍板随批措辞清偿：表清单冒险表行「代币记账」改「钥石入账」；registry adventure_table 同批改键 token_per_level→keystone_per_level。表清单与校验纪律不变 |
|
||||
| v0.4 | 2026-09-18 | **进度坐标解析口径修订（用户拍板，场景三讨论产物）**：① 取整方向「就近向下」→「**向上取整**」——无精确行取不低于请求坐标的最近行，理由 = 保证偏难（宁高估难度让工具读数保守，不静默降难掩盖断档）；② 越域致命补齐——低于合法域（关卡序号 <1、节点深度 <0）走运行期致命：Fatal 级诊断 + 进程退出码 1，与装载期致命纪律并轨；**同日追加拍板**：高于最大已有行不致命，封顶取最大已有行并留警告（用户裁定「可取范围内向上取整，超过了最大值就用最大值」）；③ registry enemy_table 条目「进度键 floor」随批改 ceil；切片 config_db._resolve_progress 同批落地（ceil 选择器 + _fatal 通道 + `smoke/config_fatal_probe.gd` 探针 + 冒烟 ceil 断言） |
|
||||
| v0.5 | 2026-09-27 | **统一随机流批（ADR-0007 裁丙——用户两轮复裁终选「统一用一个流」并拍「全面执行」）**：§「封闭随机流」整节改「统一随机流」口径——唯一主种子+单盐派生+唯一全局取数计数器，七流并一；取号参数降格为**用途标签**（只进事件日志不参与派生，七流名保留为封闭词表）；新增**全事件日志**（冒险会话制 user://logs/rng_log_<主种子>.jsonl，逐次取数落 scope/标签/派生种子——号位全序化后单点定位的承载面）；快照契约=主种子+全局计数器；扩签通道替代增流通道；表清单/依赖表/P0/验收行随批。代码实证：rng_service.gd 重写+七消费点迁移+armor_roll_stream 字段降格标签+behavior_roll 子流派生向量退役；新黄金向量 8 常量重登记（scope 0-3 与旧 board_gen 向量逐位连续）|
|
||||
| v0.6 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09——四处表清单失同步，全部代码实证）**：①变异表行「现行六行」→七行（variation.tres 实测 7 行=region 6+global 贫矿脉，2026-10-04 首发批漏登）；②奖励配置表 `RewardConfigTable` 行删除（表已随可选类删除下线——reward_config.tres 与类名全仓零命中）；③秘宝表 `AuxItemTable`→`TreasureItemTable`（treasure_items.tres，词族对齐批换代漏登）；④MetaTable「四行族」→现行五行族（+attune_refresh_upgrade，同调批扩列漏登）；⑤主角表行补 armor_class 字段 |
|
||||
Reference in new issue
Block a user