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
@@ -136,7 +136,7 @@
|
||||
## 6. 流程纪律
|
||||
|
||||
1. **大改动三段走**：设计稿/伪代码 → 用户审阅 → 实现 → 修改记录（README + session-state）。实现不得先于审阅。
|
||||
2. **实现批收尾双登记**：切片 README 修改记录 + `production/session-state/active.md` 条目，缺一不可。
|
||||
2. **实现批收尾双登记**：切片 README 修改记录 + 根目录 `active.md` 条目（会话状态唯一状态源——2026-10-09 定性，路径自 production/session-state/ 迁根目录），缺一不可。
|
||||
3. **规范变更必须成文进本文件**——发现未成文约定、或用户裁决产生新规则，当场补条文。
|
||||
4. **呈现层缺陷的教训回写 D1 GDD 设计输入**（信号载荷 schema / 场景级测试 / 时点状态可见性）。
|
||||
|
||||
@@ -153,3 +153,10 @@
|
||||
| 上帝对象 | main.gd ~1100 行 | 职责无边界持续堆积 | 1.1–1.3 |
|
||||
| ID 前缀命名 | a1_/b1_ 与领域命名并存 | 事实约定未成文 | 1.4–1.5 |
|
||||
| 可选类每关 24.8 件 | 速杀退化、囤刀秒 Boss | 单尺度校准未做跨尺度推演 | 5.3 |
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|---|---|---|
|
||||
| v1 | 2026-09-11 | 首版成文（垂直切片评审用户逐一指出，全部附真实反面案例） |
|
||||
| v2 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：§6 流程纪律第 2 条「production/session-state/active.md」过期路径改「根目录 active.md」（会话状态唯一状态源，2026-10-09 用户定性为状态文件并迁根目录）；本表系本批补建 |
|
||||
@@ -18,7 +18,7 @@
|
||||
|
||||
答不出来，就重写这一节，而不是给看不懂的地方补注释。
|
||||
|
||||
**与旧体系门禁的关系**：旧体系的 lean 格式六条硬规则与 `tools/gdd_lint.py` 门禁已随 2026-09-14 归档停用（PostToolUse 钩子同批停用，工具本体留 `tools/` 备查），此后仅用于解读 `design/archive/` 里的旧文档（解读时注意其表格占比口径为 30%，2026-09-14 由 60% 放宽）。现行文档不跑 lint；可读性是唯一的内容质量门。旧模板文件留档 `.claude/docs/templates/` 备查。
|
||||
**与旧体系门禁的关系**：旧体系的 lean 格式六条硬规则已随 2026-09-14 归档停用，仅用于解读 `design/archive/` 里的旧文档（解读时注意其表格占比口径为 30%，2026-09-14 由 60% 放宽）。`tools/gdd_lint.py` 工具同批停用后已恢复为现行文档机检三闸之一（gdd_lint / doc_link_audit / doc_term_audit——分级周期口径见 CLAUDE.md，对现行文档生效）；可读性仍是第一内容质量门，lint 是格式机检面，两者并行。旧模板文件留档 `.claude/docs/templates/` 备查。
|
||||
|
||||
## 2. 白话写作规则
|
||||
|
||||
@@ -202,3 +202,4 @@
|
||||
| v11 | 2026-10-04 | **第 4 节补强：自造词三形态禁令（用户令，黑话审计后）**：新增自造词三种固定形态禁令表（工作包代号 / 机制造词 / 流程造词，各带本仓真实反例与正确写法）+ 通行检验标准（读者 = 业内人但没读过项目历史，需要作者解释的词即不合格，展开才算改）+ 写后自查动作；同批 CLAUDE.md 硬性红线新增「用语红线」一行。起因：原第 4 节禁令过于抽象、执行失效（全仓 530 条自造短语），且未明确覆盖对话输出与工作日志命名 |
|
||||
| v12 | 2026-10-09 | §9 摘除 design/archive/gdd-2026-09-14/ 归档列项（目录已删，2026-10-09 用户令旧档引用全量摘除）；旧概念翻译与 registry 改指两条维持 |
|
||||
| v13 | 2026-10-09 | §11 新增「证据只留最新」行（2026-10-09 用户立规——qa 存量清理批随批落文）：测试证据只保留最新迭代/最新一轮审计版本，新证据落位即删上一份；待人清单过闸后同规退役 |
|
||||
| v14 | 2026-10-09 | §1「与旧体系门禁的关系」段与现实对齐（文档正确性审查批·独立复核）——原文「gdd_lint 门禁已停用、现行文档不跑 lint」与现状矛盾：gdd_lint 现为机检三闸之一（与 doc_link_audit/doc_term_audit 并列，分级周期口径见 CLAUDE.md，2026-10-03 起分域批在役）；lean 六条硬规则本身维持停用仅用于解读旧档；「可读性是第一内容质量门」定位不变，lint 定性为格式机检面 |
|
||||
+3
-11
@@ -88,7 +88,7 @@
|
||||
|
||||
**回复应在商店内**（用户 2026-10-05 定）：回复不是计价物，套不上「计价物不自售」，按默认原则它应当在商店出现。现行 `shop.tres` 货架只有 attack / max_hp / armor / ap 四项，**现状与表格不对齐，须在实施批补上**。
|
||||
|
||||
**待拍板／待观察两项**：① ~~资源的命名~~ 与 ~~回复是否属该类~~ **已定（v2.5）＝资源，回复留在其中不拆第四类**（它与金币同为即时兑付、判据同源；拆出去第四类只剩两项）。② **专长门票尚未入表**：出现概率 / 配额 / 全局限量三个参数都没有事实源，入池同样受档位结构锚约束。③ **专长总量与档位阈值的匹配——延后复裁**（用户 2026-10-05 定"先不调整"）：终局 Boss 不给已定，一局确定性专长次数＝终局前 Boss 个数；**三关结构下是两次，加门票最多三次**，而档位阈值是同标签 ≥2 档一 / ≥4 档二——**档二（完全体）在三关结构下几乎不可达**。用户决定不动，理由是**后续会有第四关**，且届时可能另做获取侧调整。**复裁触发：第四关内容批落地后实测，配合仍太少再调。** 先不调≠不成问题，登记于此防忘。
|
||||
**待拍板／待观察项**：① ~~资源的命名~~ 与 ~~回复是否属该类~~ **已定（v2.5）＝资源，回复留在其中不拆第四类**（它与金币同为即时兑付、判据同源；拆出去第四类只剩两项）。② **专长门票尚未入表**：出现概率 / 配额 / 全局限量三个参数都没有事实源，入池同样受档位结构锚约束。③ **专长总量与档位阈值的匹配——延后复裁**（用户 2026-10-05 定"先不调整"）：终局 Boss 不给已定，一局确定性专长次数＝终局前 Boss 个数；**三关结构下是两次，加门票最多三次**，而档位阈值是同标签 ≥2 档一 / ≥4 档二——**档二（完全体）在三关结构下几乎不可达**。用户决定不动，理由是**后续会有第四关**，且届时可能另做获取侧调整。**复裁触发：第四关内容批落地后实测，配合仍太少再调。** 先不调≠不成问题，登记于此防忘。
|
||||
④ **charge 标签件数不足（数据缺陷，独立登记，勿被上条盖掉）**：档二要求同标签 ≥4 件，而 `relics.tres` 里 charge 标签**只有 3 件**——即使获取次数无限，charge 流派也永远达不到档二。这与渠道结构无关，是数据层缺陷。**探讨态注记（2026-10-07 用户令撤回前日编入）**：补件设计仍在文档探讨阶段、上下文不足，未排批不进迭代 18（重启=用户发令；落地形态考证在册=纯 .tres 数据行、新件限现有效果 hook 则零代码）
|
||||
⑤ ~~顶层命名待定~~ **已定（v2.4）＝「奇物」Wondrous Item**：DND 魔法物品九分类中的兜底杂类，官方中文译名即「奇物」，专装"不好归类但有奇效之物"——正好对应三个互不相干的分类。落选：Treasure（偏财物，装不下专长）、Relic（品类惯例，用户否决「遗物」）、全部自造词（进益/造化/机缘/遇获）。**代码词族随之定为 `curio_*` / `ADVENTURE_CURIO`**——原计划的 `feature_* → reward_*` 对齐**作废**：`reward_pick` 流 / `reward_node` context / `reward_preview` kind 已占用 reward 词族，照做会撞车。
|
||||
|
||||
@@ -287,14 +287,6 @@
|
||||
**归属**：HUD 批（M-4，批未立项）——已随迭代 17 卡③实施
|
||||
|
||||
**状态**：✅ 代码面已交付待实机目检（2026-10-06，迭代 17 卡③暂停层只读入口批——worktree g-plan2-iter17-pause 分支 iter17-pause-20261006，提交 c08a901/fc9eb1e/d44fdd5+收口笔；P1丁常驻角标/P2甲设置层同档 dim 遮罩/P3甲余额+三柜台进度/P4甲零动效直开直关全落；badge 已按 Q10 甲工厂化入 ui_kit 并同步迁营地钥石徽；机检=冒烟 788/0+run_all 17 套+四探针全绿〔含输入锁 case⑯/只读巡检/零动效契约/钥石徽对比度对〕+doc 三闸零新增；**人闸=用户实机目检** 迭代17暂停层人闸清单（已退役，git 历史可查）——过闸后本条销号；Esc 快捷通道维持本清单键盘/手柄条登记随键盘批办理）
|
||||
#### 第一关亮墨数字直画观感优化（2026-10-01 T17 目检体感登记——2026-10-07 用户令删除）
|
||||
|
||||
**处置**：2026-10-07 用户令——本条不成立，直接删除（观感类优化归 UI 相关线，逻辑批不做；相关优化实践已做过）。两目检体感（直画字难看/墙底黑线难看）随条目一并销去。
|
||||
|
||||
#### 高墙墙底细阴线观感优化（2026-10-01 T17 目检体感登记——2026-10-07 用户令删除）
|
||||
|
||||
**处置**：同上条，2026-10-07 用户令删除（原登记内容：迭代 9 T3 高墙机制过闸后墙底阴线颜色/粗细/有无待优化——不再保留待办）。
|
||||
|
||||
#### 未开格类型徽章呈现时机（2026-09-18 方向已拍板，待实施批）
|
||||
|
||||
**现状**：2026-09-18 用户拍板方向——未开格常显奖励类型微光（周围 8 格泛光：魔法=紫 / 穿刺=蓝 / 群伤=红 / 治疗=绿 / 其他增益=黄），让玩家能针对敌人护甲类型规划优先开哪些格。设计依据：护甲克制轴已落地（穿刺弹/魔法矢），玩家需要类型先验才能兑现克制博弈。**2026-09-22 美术圣经审阅批更新（T1 裁决：采纳彩色常显微光）**：原五色与圣经语义色条款三方冲突（紫落 300°–345° 禁入带/治疗绿违反绿零逻辑/穿刺蓝违反蓝只说己方），经用户裁决采纳微光后五组色相已重选候选——芥末黄(通用增益)/黄绿(治疗)/青(穿刺)/紫罗兰(魔法)/绯红(群伤)，见 [art-bible](../art/art-bible.md) §4.2「类型微光色带」（候选值，样张批冻结）；圣经 §4.6.3 呈现约束已同步为「角嵌纹样(形状)+常显微光(色彩)」双通道，类型预读呈现方案在美术侧已成文。连带裁决面：① 本方向修订[不做清单](05-不做清单.md)「未开格不显示奖励身份」裁定（owner 修订，合法）；② ~~与 art-bible §4.6.3 家族类型徽章口径对齐归美术批~~——已完成（2026-09-22 美术文档修订批）；③ 探宝罗盘（预读 3×3）价值被清空，效果重定归秘宝内容批；④ ~~色板与既有格面徽标/UI 用色冲突检查归样张批~~——冲突面已在色相重选时规避，样张批保留组间互辨抽测义务；⑤ 原「资源预读与推理的边界」条目并入口径（2026-09-19 用户拍板：预读边界按本条微光方案定——类型级常显；探宝罗盘重定两方案另立条目评估）；⑥ 实施窗口 = 表现层升级批（会改推理信息面，切片期默认不开、保护验收读数基线）。**2026-09-30 口径校正（用户裁决）**：微光正确口径=**英雄周围 8 格内的未开格显示类型微光**（非全板常显）——本条历史文本中的「常显」为无范围复述、「魔法=紫/穿刺=蓝…」为 2026-09-18 原案旧色（已被 T1 重选五组取代，现行见 art-bible §4.2）；概念正主已落 [HUD框架](systems/表现与支撑/HUD框架.md)「未开格类型微光」节（2026-09-30 收口批落位），本条此后只承载实施状态、不再承载定义。
|
||||
@@ -361,7 +353,7 @@
|
||||
|
||||
### 教学引导
|
||||
|
||||
> **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `../../archive/提案-教学引导定稿-2026-10-04.md`（Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态=丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。
|
||||
> **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `archive/` 目录（磁盘留存、不入 git，Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态=丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。
|
||||
|
||||
#### 教学形态未定
|
||||
|
||||
@@ -431,7 +423,7 @@
|
||||
|
||||
**文档/结构闸存量欠账（2026-10-08 迭代 19 总收口批登记——新重闸口径首次全闸套跑翻出；经 T0 基点 9160942 复测确认为存量/外部批旧债，非本迭代新增）**
|
||||
- gdd_lint 表格占比 3 件：01-核心循环（35%）/06-待办清单（0%）/07-体验验证清单（6%）——T0 基点已 2 件存量在案，第 3 件疑外部道具批 80 行散文落文稀释占比
|
||||
- doc_link 死链 2 件：奇物.md:245 → ../ux/battle.md 与 ../ux/node-reward.md（奇物 v2.7 b6b43eb 旧债）
|
||||
- doc_link 死链 2 件：奇物.md:245 → ../ux/battle.md 与 ../ux/node-reward.md（奇物 v2.7 b6b43eb 旧债）——**已清偿（2026-10-09 独立复核批：路径层级 ../ux/→../../ux/ 修正，doc_link 复验零死链）**
|
||||
- doc_term 退役术语旗 1 件：06「拔旗回收返 AP」备选条目文字引用（该条目自身裁决时顺手处置）
|
||||
|
||||
**归属**：文档体检批/对应来源批
|
||||
|
||||
+11
-10
@@ -24,45 +24,45 @@
|
||||
- **观测什么**：第二关 Boss（蛛化卓尔精灵）战的轮数、承伤、"打不打得动"的体感。硬化此前只挂 Boss 池，旧读数全部泡在翻倍行为里。
|
||||
- **预期**：明显比以前难——硬化期主角输出减半是纠正后的正确语义，不是 bug。
|
||||
- **红灯信号**：硬化覆盖期间完全打不动、战斗拖过约 10 轮、或恢复点耗尽仍过不去。
|
||||
- **结论回流**：体感数据 → T19 真人标定局（读数与 k 系数，验收读数重测批已于 2026-09-19 履行）；难度杠杆归难度修正批（计划书草案待 U0，成文后在此挂路径）——**不在试玩现场改数**。
|
||||
- **结论回流**：体感数据 → T19 真人标定局（读数与 k 系数，验收读数重测批已于 2026-09-19 履行）；难度杠杆归数值批（Beta 阶段，未排期）（计划书草案待 U0，成文后在此挂路径）——**不在试玩现场改数**。
|
||||
|
||||
### ② 削弱续时后的承伤压力
|
||||
|
||||
- **观测什么**：普通场每轮承伤是否压得住；插旗的意愿变化（削弱不再能堆出免伤轮）。
|
||||
- **预期**：承伤比以前高——旧"连标两层 → 敌方打不出伤害"的节奏消失了，这是消饱和的代价，属预期。
|
||||
- **红灯信号**：普通场（非 Boss）连续掉血无法规划、恢复点不够用。
|
||||
- **结论回流**：承伤带读数 → T19 真人标定局；削弱时长终值（现行 2 次结算）调整归难度修正批计划书（待 U0）。
|
||||
- **结论回流**：承伤带读数 → T19 真人标定局；削弱时长终值（现行 2 次结算）调整归数值批（Beta 阶段，未排期）计划书（待 U0）。
|
||||
|
||||
### ③ 增伤全段覆盖的数值手感
|
||||
|
||||
- **观测什么**：持有增伤时边挖边打，伤害是否"明显变高但不爆炸"（乘区作用于全部输出；2026-09-19 充能退役后主角输出 = 单分量）。
|
||||
- **预期**：挖得越顺伤害滚得越快（正反馈增强）。
|
||||
- **红灯信号**：普通敌一拍秒杀常态化、增益格子变成"无脑必抢"没有决策。
|
||||
- **结论回流**：增伤幅度为 percent 族冻结轴现行值（+50%）——调整须显式解冻，归难度修正批计划书（待 U0）。
|
||||
- **结论回流**：增伤幅度为 percent 族冻结轴现行值（+50%）——调整须显式解冻，归数值批（Beta 阶段，未排期）计划书（待 U0）。
|
||||
|
||||
### ④ 乏力的可感知性
|
||||
|
||||
- **观测什么**：踩雷吃乏力后，接下来一轮的输出下降是否感觉得到。
|
||||
- **预期**：可感知但不致命（−25% 输出）。
|
||||
- **红灯信号**：完全无感（等于白踩）或过痛（一轮输出报废后必然崩线）。
|
||||
- **结论回流**：乏力幅度为 percent 族冻结轴现行值（−25%）——调整归难度修正批计划书（待 U0）；"乏力死效果"期的格面资源调研读数已随接线作废留档。
|
||||
- **结论回流**：乏力幅度为 percent 族冻结轴现行值（−25%）——调整归数值批（Beta 阶段，未排期）计划书（待 U0）；"乏力死效果"期的格面资源调研读数已随接线作废留档。
|
||||
|
||||
### ⑤ 失衡换轴的归因可读性（P2 关注）
|
||||
|
||||
- **观测什么**：标错旗吃失衡后，玩家能否读懂"为什么这几刀特别容易挨打"（护甲等级 −1 → 命中更难被闪开）。
|
||||
- **预期**：惩罚变隐性是换轴的已知代价——承伤加深是"每刀固定变疼"，AC 降低是"挨打概率与档位变差"，后者更难直觉归因。
|
||||
- **红灯信号**：试玩者完全无法把"挨打变疼"与标错旗关联起来。
|
||||
- **结论回流**：归因呈现面已随迭代 6/8 落地（状态图标九枚+明细行文案）；失衡幅度现行 AC −1，调整归难度修正批计划书（待 U0）。
|
||||
- **结论回流**：归因呈现面已随迭代 6/8 落地（状态图标九枚+明细行文案）；失衡幅度现行 AC −1，调整归数值批（Beta 阶段，未排期）计划书（待 U0）。
|
||||
|
||||
### ⑥ 速杀退化预警（监控口径，2026-09-18 定案）
|
||||
|
||||
纯日志侧预警、不影响玩家体验：读数 = "战斗结束未开资格格占比"（战斗结束时玩家尚未开过的奖励资格格 ÷ 全部资格格）——占比过高说明玩家在跳过棋盘互动直接速杀。预警阈值 provisional = **>40% 报警**（基线已随 2026-09-19 判读报告采集；重校准归 T19 标定局或难度修正批计划书。高加成档速杀低难度行本身是合法形态，预警只进日志不做玩法修复）。
|
||||
纯日志侧预警、不影响玩家体验：读数 = "战斗结束未开资格格占比"（战斗结束时玩家尚未开过的奖励资格格 ÷ 全部资格格）——占比过高说明玩家在跳过棋盘互动直接速杀。预警阈值 provisional = **>40% 报警**（基线已随 2026-09-19 判读报告采集；重校准归 T19 标定局或数值批（Beta 阶段，未排期）计划书。高加成档速杀低难度行本身是合法形态，预警只进日志不做玩法修复）。
|
||||
|
||||
### ⑦ 刷新经济监控（日志先行，阈值等基线）
|
||||
|
||||
弃图率 / 每轮刷新率随试玩日志采集；预警阈值须有基线读数才能定（2026-09-18 拍板：现在定是拍脑袋）——基线已采（见下条），阈值数字归后续调参（难度修正批计划书备选面）联动复核。挖掘期当场刷新无结算发生，两读数均不影响对账。
|
||||
弃图率 / 每轮刷新率随试玩日志采集；预警阈值须有基线读数才能定（2026-09-18 拍板：现在定是拍脑袋）——基线已采（见下条），阈值数字归后续调参（数值批（Beta 阶段，未排期）计划书备选面）联动复核。挖掘期当场刷新无结算发生，两读数均不影响对账。
|
||||
|
||||
**基线已采（2026-09-19 验收重测批——读数已内联本节）**：MC 完美档弃图 ~0.1 次/局量级（L1 基线格 0.23 / L2 0.03）、normal 档零弃图（模拟画像不主动刷新）；每轮刷新率 ≤0.6%。阈值数字归后续调参（难度修正批计划书备选面，待 U0）。两读数已固化进 `log_analysis.py` 关卡级统计列（分析器随批升级）。
|
||||
**基线已采（2026-09-19 验收重测批——读数已内联本节）**：MC 完美档弃图 ~0.1 次/局量级（L1 基线格 0.23 / L2 0.03）、normal 档零弃图（模拟画像不主动刷新）；每轮刷新率 ≤0.6%。阈值数字归后续调参（数值批（Beta 阶段，未排期）计划书备选面，待 U0）。两读数已固化进 `log_analysis.py` 关卡级统计列（分析器随批升级）。
|
||||
|
||||
|
||||
### ⑧ 旗行为基线监控（插旗不可逆批 2026-09-19 落地后的行为监控；原「提案评估前置采集」使命随提案转正终结）
|
||||
@@ -91,7 +91,7 @@
|
||||
|
||||
**结果回流**：日志取数 → 真人修正系数 k（真人整关承伤中位 ÷ 模拟完美档中位；**正常预期 k>0.5、预警线 k<0.3**——2026-10-03 用户裁）并入 T19 标定报告（落 design/qa/，换代 2026-09-19 判读报告为现行锚）；①–⑤ 体感按各条目的回流位分流。
|
||||
|
||||
**2026-10-01 数值修复批后试玩注记**（master 4b4a011 起的正式标定局）：本批已落 hero 血池 20→26 / 直伤雷三行 4/5/5→6/8/8 / L1 系敌 atk 2→1（轨迹与读数见 [numfix 报告](数值修复批读数（已退役，git 历史可查）)）。试玩时对号新增两点：
|
||||
**2026-10-01 数值修复批后试玩注记**（master 4b4a011 起的正式标定局）：本批已落 hero 血池 20→26 / 直伤雷三行 4/5/5→6/8/8 / L1 系敌 atk 2→1（轨迹与读数见 numfix 报告（已退役，git 历史可查））。试玩时对号新增两点：
|
||||
1. **踩雷疼痛感**（本批主刀）：「踩很多雷还是轻松活」应是过去式——单雷 6-8 直伤、两三连雷应明显肉疼；若仍无痛感=回调信号，记一句话即可；
|
||||
2. **整体难度印象**：用户 2026-10-01 已阶段性验收「令人稍微满意」——本批试玩读数作正式标定（真人通关率+k 系数），若体感偏难/偏易也照实记，不因单局顺逆回调。
|
||||
模拟侧对照读数（普通档画像 L1 13%/战役 0%；完美档 78.5%）见同报告 §四。
|
||||
@@ -186,7 +186,7 @@
|
||||
|
||||
## 验收读数重测义务（履行留痕 + 现行义务）
|
||||
|
||||
**已履行**（按序换代，旧读数各随其批作废留痕不入本单）：①验收读数重测批（2026-09-19——Boss 单独出列/承伤带/通关率基线全量重测，硬化翻倍期·乏力死效果期·充能期旧读数作废）；②迭代 5 基线重测（统一随机流后 MC+verifier 双窗）；③**数值修复批新尺重测（2026-10-01）**——模拟档位重构后全量重测，新锚 `sim-data/runsum_numfix_final_n200_20261001.jsonl`，全旧带作废只测不判（[numfix 报告](数值修复批读数（已退役，git 历史可查）)）；④**迭代 10 奖励重构批重锚（2026-10-01）**——四代锚 77000/78000/79000/80000（改前/重构后/共享池后/掷定前置后，各 400 局），普通 L1 41.8%/L2 10.2% 带内（[读数报告](迭代10通关率读数（已退役，git 历史可查）)）；⑤**T19 真人标定局收口（2026-10-03 用户裁）**——有效局 2（1 通关 1 死于 L3 首战，[读数报告](T19真人试玩读数（已退役，git 历史可查）)），用户裁定**佐证级收口不再补局**；k 预期带同日立（**正常 >0.5、预警 <0.3**），字段随 81000 重锚入库后补算终值。
|
||||
**已履行**（按序换代，旧读数各随其批作废留痕不入本单）：①验收读数重测批（2026-09-19——Boss 单独出列/承伤带/通关率基线全量重测，硬化翻倍期·乏力死效果期·充能期旧读数作废）；②迭代 5 基线重测（统一随机流后 MC+verifier 双窗）；③**数值修复批新尺重测（2026-10-01）**——模拟档位重构后全量重测，新锚 `sim-data/runsum_numfix_final_n200_20261001.jsonl`，全旧带作废只测不判（numfix 报告（已退役，git 历史可查））；④**迭代 10 奖励重构批重锚（2026-10-01）**——四代锚 77000/78000/79000/80000（改前/重构后/共享池后/掷定前置后，各 400 局），普通 L1 41.8%/L2 10.2% 带内（迭代10通关率读数（已退役，git 历史可查））；⑤**T19 真人标定局收口（2026-10-03 用户裁）**——有效局 2（1 通关 1 死于 L3 首战，T19真人试玩读数（已退役，git 历史可查）），用户裁定**佐证级收口不再补局**；k 预期带同日立（**正常 >0.5、预警 <0.3**），字段随 81000 重锚入库后补算终值。
|
||||
|
||||
**现行义务**：**T7 技能池节奏重测（2026-10-05 技能池执行批挂单）**——≥50 distinct seeds 节奏重测（过涝判读带=Boss 半血后特殊技密度上探；跑批须用户批准；S2 过涝越带→解锁技权重/倍率回调呈报禁自动调；**2026-10-06 联审批注：判读带立单于案C 行为换代前，执行前须按案C 新行为复核「半血后」窗口与密度分母是否仍有效，失权即停机呈报重立带**）→ ~~T19 真人标定局~~（⑤已收口）→ 真人侧读数换 81000 锚补算 k 终值（随迭代 9 出口重锚批出，模拟锚 2026-09-19 判读报告的现行锚地位由 81000 锚+真人两局承接）。工具面：`analyze_playtest.py` / `balance_verifier.py` 冒险段 / JSONL 日志现役。
|
||||
|
||||
@@ -199,3 +199,4 @@
|
||||
| v0.1 | 2026-10-09 | 补登：文档正确性审查批改动①——⑬节「迷雾联动信号」行魔法提灯观测点加退役注（「魔法提灯 +2——已裁退役 2026-10-09，拆线批落籍后本信号面失效」）；本文件当时无版本表，本行系卫生批补登 |
|
||||
| v0.2 | 2026-10-09 | 补登：文档正确性审查批改动②——⑰节「结论回流」行裸「M-4」改「Beta 阶段（未排期）」（强度体感归 Beta 阶段带判读）；同上系卫生批补登 |
|
||||
| v0.3 | 2026-10-09 | 版本历史表补建——本文件此前无版本表（2026-10-09 审查批呈报在案），本卫生批补建本表并补登上两行 |
|
||||
| v0.4 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①三处「链接语法但目标非路径」伪死链去链接改纯文本（numfix 报告/迭代10通关率读数/T19真人试玩读数——三份读数均已退役，git 历史可查口径不变）；②「难度修正批」批次名全替「数值批（Beta 阶段，未排期）」——与 06 现行归属称呼对齐（同批=M4 数值批需求卡片，未排期态不变） |
|
||||
@@ -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 字段 |
|
||||
@@ -68,7 +68,7 @@
|
||||
| Exit Destination | Trigger | Notes |
|
||||
|---|---|---|
|
||||
| 关卡画面（选路枢纽） | 敌方全灭（战斗结算判定段 verdict=win）且非末节点 | 不可逆：battle_over 已发生，RAP 清零；落地奖励/恢复节点时开节点覆盖层确认（NodeOverlay，关卡画面域） |
|
||||
| 关卡结算 | Boss 战胜利 → level_clear（spec：[level-clear.md](level-clear.md)） | 不可逆：~~关卡收束清库义务载体 = 秘宝背包~~（秘宝过渡形态〔关卡域库存/局内两步使用〕已随迭代 11 第①批退役——现行形态 = 营地同调装配、整局冒险生效，无关卡域清库面，见秘宝.md） |
|
||||
| 关卡结算 | Boss 战胜利 → level_clear（spec：[level-clear.md](level-clear.md)） | 不可逆：~~关卡收束清库义务载体 = 秘宝背包~~（秘宝过渡形态〔关卡域库存/局内两步使用〕已随迭代 11 第①批退役——现行形态 = 营地同调装配、整局冒险生效，无关卡域清库面〔旧关卡域库存 treasure_inventory 为投放渠道全退役后恒空的机械惰性承载，拆线归实装批——见战斗结算「轮次生命周期」节注〕，见秘宝.md） |
|
||||
| 冒险终结 | 主角 HP=0（verdict=lose） | 不可逆：Roguelike 死亡重开（art-bible §2.5 温柔惋惜调性） |
|
||||
| 无中途退出 | — | MVP 不设战斗内放弃/暂停菜单（回合制无时间压力；如需暂停留 Playtest 诊断按钮，调试用） |
|
||||
|
||||
@@ -446,3 +446,4 @@
|
||||
| 2026-09-27 | 关卡画面 UX spec 建档联动（关卡画面 UX 批）：§Navigation Position 上游屏/下游屏行挂 [level-map.md](level-map.md) 屏级 spec 指针——关卡画面（选路覆盖层常驻形态）的布局/组件/交互/状态规格自此有独立权威文档。零机制改动 |
|
||||
| 2026-10-06 | **方案二·立绘定档与站桩落底排批（用户拍板；工作流程铁律 2026-10-06 = 讨论期只动文档，代码实装另批走 PRD→迭代）**：① B 区 252→270（演出 ≈1/3 屏）/ C 区 548→530（**棋盘 438×438 原尺寸不缩、格子不变**，压缩全部由面板空档吸收）——布局表 B/C/D 三行随改；② 站桩排式重排：**立绘→血条→状态 落底排**（全场血条对齐一线；血条嵌石板位、台缘线留作地面线、落影保留），原「血条悬浮头顶」退役（高盒下血条-立绘空洞，用户点名否决）——Component Inventory 主角/敌人站桩两行随改；③ 大体档（显示 >150px 级：drider/duergar_king）头部探出盒顶压光柱区，血条仍落底；意图徽标上移头顶上方（探顶档压胸）；④ 空态行措辞随改；⑤ ASCII 线框图 B 区重绘。立绘八敌源档定档归 art-bible §8.2（v3.7）与 character-design.md §5.5（体量=生物体型修订） |
|
||||
| 2026-10-09 | 文档正确性审查批（在役态对齐）：①秘宝槽「已实装四槽两步交互/关卡域库存/清库义务载体 = 秘宝背包」过期——过渡形态随迭代 11①退役，现行 = 营地同调装配（四槽壳空槽占位，展示重接归装配面批次）；②奇物列表「预留」改已实装（现行标题「特性」，迭代 9⑫+迭代 12 呈现补齐）；③明细回看 overlay/入口/交互三处随 P-C7 退役订正（回看归「生涯」）；④TunePanel 三处改调试浮窗（迭代 15①退役）+减动效开关 = 设置面（迭代 8④）；⑤棋盘尺寸 N∈{10,12} 扩 {10,12,13,14}（第三关内容批）；⑥OQ9 TunePanel 退役计划收口 |
|
||||
| 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：Exit 表关卡结算行「无关卡域清库面」表述精确化——旧关卡域库存 treasure_inventory 经代码实证仍在（level_runner.gd:520 快照计数/battle_orchestrator.gd:745 consume），系投放渠道全退役后恒空的机械惰性承载，拆线归实装批；同调装配件不经此域的结论不变 |
|
||||
@@ -39,7 +39,7 @@
|
||||
| 16 | 清图/换图演出编排 | Feedback | **已实现·占位级**（board_fx_view.gd 金粒彩纸——规格随战斗表现 美术批补） |
|
||||
| 17 | 胜利/失败终局编排 | Feedback | **已实现·占位级**（battle_end_overlay.gd——规格随战斗表现补） |
|
||||
| 18 | Boss 遭遇演出 | Feedback | **已实现·占位级**（紫赤影子——规格随战斗表现补） |
|
||||
| 19 | 库存常读列表 | Data Display | **已实现**（inventory_panel_view.gd——规格全文待补；载体变更留档：现行载体=C 区道具槽） |
|
||||
| 19 | 库存常读列表 | Data Display | **占位失效**（所记载体 inventory_panel_view.gd 从未入库〔git 全史零记录，2026-10-09 复核〕；库存面已随秘宝过渡形态退役——C 区现行秘宝槽=装配呈现面、重接归装配面批次，见 battle.md 组件清单） |
|
||||
| 20 | 标准控件组（button/progress bar/list） | Control | **已实现**（ui_kit.gd 直角细线/凸圆角——规格全文待补） |
|
||||
|
||||
MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab bar——战斗屏无此需求；TunePanel slider 为调试专用。
|
||||
@@ -221,3 +221,4 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
|
||||
| 2026-09-15 | 雾格残留清理：pattern 1 无改；pattern 4 的悬停预承诺消歧依据改按格态两态表述；目录 #10 一次性非模态提示的已实现说明去掉雾首遇、只留 chord 提示。pattern 库不引入新决策 |
|
||||
| 2026-09-20 | 退役术语扫描批（用户拍板）：pattern 2 原位窗口激活退役留档（唯一消费面轮末道具窗口随 2026-09-15 可选类道具删除下线——编号留空防交叉引用失锚，照 battle.md 布局决策 2 先例）；pattern 8 禁用态即理由 Used In/Reference 去道具窗口引用（保留为通用模式）；聚合纪律未生效类行枚举收敛为奖励未生效 |
|
||||
| 2026-10-09 | 文档正确性审查批：pattern 8「Used In 现无消费面、消费面随秘宝 Alpha 重设计回归」过期订正——消费面在役 = 商店购买钮余额不足置灰、三选一/商店 GP 刷新钮余额不足禁用 |
|
||||
| 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：目录 #19「库存常读列表」状态订正——所记载体 inventory_panel_view.gd 经 git 全史复核**从未入库**（「已实现」系失实登记），库存面已随秘宝过渡形态退役，状态改「占位失效」 |
|
||||
@@ -88,7 +88,7 @@
|
||||
|
||||
| Data | Source System | Read / Write | Notes |
|
||||
|---|---|---|---|
|
||||
| 三候选（件 id/名称/效果行值） | 冒险结构 bonus_pick 信号（加权洗牌掷 3，reward_pick 封闭流） | Read | 载荷自包含、despawn 前捕获；同种子同三候选（可复放） |
|
||||
| 三候选（件 id/名称/效果行值） | 冒险结构 bonus_pick 信号（令牌池洗牌不放回抽 3〔同 kind 去重——v0.14 令牌池换代口径，原「加权洗牌」退役〕，reward_pick 封闭流） | Read | 载荷自包含、despawn 前捕获；同种子同三候选（可复放） |
|
||||
| 部分回血读数（回血前后生命） | 冒险结构生命账本（clear_heal_pct 兑付） | Read | 满血回 0 合法态文案化 |
|
||||
| 兑付反馈载荷 | 冒险结构 bonus_resolved 信号 | Read | 选中件 id + 生效值 |
|
||||
| ~~同调位库存~~ | —— | —— | 替换子态随渠道退役；过渡键 transitional_sync_slots 已退役（迭代 11① T7——同调位正主 = attunement_growth.tres 谓词表实时求值） |
|
||||
@@ -130,3 +130,4 @@
|
||||
| 2026-09-27 | 关卡画面 UX spec 建档联动：§Navigation Position 下游屏行挂 level-map.md 屏级 spec 指针。零机制改动 |
|
||||
| 2026-10-01 | **三选一选择交互重写（迭代 10 奖励重构批——用户 2026-09-30 拍板案丙；T2 UX spec 卡）**：①Purpose/载体/导航/进出/层级/状态/交互/数据全节重写——「大奖励三件套快照展示」退役，改「部分回血反馈 + 提升三选一三卡点选 + 确认兑付 + 同调位替换子交互」；②钥石元素全屏退役（增量行迁战斗总结结算，禁入清单机检化）；③交互范式 = choice_box 按钮族 + 选路两段式复用，零新增原语；④AC 五条改写 + 断点中断/减动效/禁入机检三条新增；⑤OQ3 改钥石三面化收口、OQ5 改替换子交互视觉归样张批 |
|
||||
| 2026-10-09 | 文档正确性审查批（在役态对齐）：①三选一候选订正——自迭代 15② 渠道分离起通关三选一 = 纯专长（原「六种池加权抽三」与秘宝件直显条款退役）；②同调位替换子交互全节退役（秘宝件迭代 11① 出池后本屏无道具件候选）；③过渡键 transitional_sync_slots 引用删除（同调位正主 = attunement_growth.tres）；④载体组件名订正 = curio_pick_overlay（与奖励节点共用面） |
|
||||
| 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：Data Requirements 三候选行「加权洗牌掷 3」漏网旧口径清偿——冒险结构 v0.14 令牌池换代后 = 令牌池洗牌不放回抽 3（同 kind 去重），与冒险结构/关卡节点地图/node-reward 同口径 |
|
||||
@@ -1,6 +1,6 @@
|
||||
# UX Spec: 关卡画面（选路枢纽，Level Map）
|
||||
|
||||
> **Status**: 定稿版——三项设计提案已拍板收口（2026-09-27：底栏状态展示 / 图上点击选路·候选按钮退役 / 放弃二次确认）；**形态已升格独立屏（2026-09-28 用户裁决：独立存在为最终形态）**；**视觉终稿已冻结（2026-09-28 关卡画面样张 v1 机检 11/11 全绿，闸形 A——冻结值见 Layout/组件清单与样张机检报告，M-2 迭代 4）**
|
||||
> **Status**: 定稿版——三项设计提案已拍板收口（2026-09-27：底栏状态展示 / 图上点击选路·候选按钮退役 / 放弃二次确认）；**形态已升格独立屏（2026-09-28 用户裁决：独立存在为最终形态）**；**视觉终稿已冻结（2026-09-28 关卡画面样张 v1 机检 11/11 全绿，闸形 A——冻结值见 Layout/组件清单与样张机检报告，迭代 4）**
|
||||
> **Author**: user + ZCode（关卡画面 UX 批）
|
||||
> **Last Updated**: 2026-10-09
|
||||
> **Platform Target**: PC (Steam)——Keyboard/Mouse 主，全部操作纯鼠标可完成（同 [battle.md](battle.md)）
|
||||
@@ -60,7 +60,7 @@
|
||||
|
||||
### Layout Zones
|
||||
|
||||
按 1280×800 基座（ADR-0002）。本屏为独立屏独占呈现：屏底（深底 `BG_ROOT` + 石纹底噪〔M-1 框材组冻结件，缺位纯色回退〕）铺满，内容居中三段。
|
||||
按 1280×800 基座（ADR-0002）。本屏为独立屏独占呈现：屏底（深底 `BG_ROOT` + 石纹底噪〔迭代 2 框材组冻结件，缺位纯色回退〕）铺满，内容居中三段。
|
||||
|
||||
| 区 | 位置与尺寸 | 内容 |
|
||||
|---|---|---|
|
||||
@@ -74,7 +74,7 @@
|
||||
|---|---|---|---|---|
|
||||
| 关卡名标签 | 文本 | `level_row.display_name`（关卡表行读数） | 只读 | 新建（现行标题位升级） |
|
||||
| GP 常驻徽章 | 直角细线数据框 | 金币图标 + 数字（`runner.gp`，冒险钱包读数；刷新经 `wallet_changed` 信号投影〔gain/buy/clear 三事件〕或写路径回执后重查） | 只读 | 新建（GP 去向拍板落地面） |
|
||||
| 节点图画布 | 自绘 Control | 节点图标（五键 20px 烘焙，双色墨制）+ 编号、通道折线、节点态着色、Boss 紫赤描边+深墨环（BOSS_PURPLE——2026-09-26 封印紫批语义：紫赤本色） | 悬停预承诺 / 点击提交选路（唯一通道） | ✅ level_map_screen.gd `_draw_graph`（视觉终稿已落码——M-2 迭代 4 T2/T3） |
|
||||
| 节点图画布 | 自绘 Control | 节点图标（五键 20px 烘焙，双色墨制）+ 编号、通道折线、节点态着色、Boss 紫赤描边+深墨环（BOSS_PURPLE——2026-09-26 封印紫批语义：紫赤本色） | 悬停预承诺 / 点击提交选路（唯一通道） | ✅ level_map_screen.gd `_draw_graph`（视觉终稿已落码——迭代 4 T2/T3） |
|
||||
| 状态数据框组 | 直角细线数据框 ×3 | 生命（当前/上限 + 迷你血条）、属性（攻击 / 护甲 AC 有效值 + 加成角标）、本关加成（加算区增量列表，零加成隐藏） | 只读 | 新建（2026-09-27 拍板：底栏状态展示） |
|
||||
| 放弃冒险按钮 | 按钮（危险红族） | 「放弃冒险（同失败结算——已获大奖励保留）」；二次确认态已拍板（见布局决策 3） | 点击（首击转确认态、二击提交） | ✅ level_map_screen.gd（可见性归组合根，仅冒险模式开） |
|
||||
| 标题行 | 文本 | 停点语境提示（见布局决策 1 三停点标题） | 只读 | ✅ level_map_screen.gd `_title`（措辞已按布局决策 1 改稿） |
|
||||
@@ -110,7 +110,7 @@
|
||||
└──────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
> 图为岔路停点示意（第二关行集）：已过节点暗金（GOLD_DONE #68562C）、当前节点金、候选节点亮金描边、Boss 紫赤描边+外缘深墨细环（灰度冗余通道）。终稿 = 节点图标组（♻ kenney 五键已接线，样张 v1 冻结）+ 通道折线 2/3/4px（已落码，M-2 迭代 4）。
|
||||
> 图为岔路停点示意（第二关行集）：已过节点暗金（GOLD_DONE #68562C）、当前节点金、候选节点亮金描边、Boss 紫赤描边+外缘深墨细环（灰度冗余通道）。终稿 = 节点图标组（♻ kenney 五键已接线，样张 v1 冻结）+ 通道折线 2/3/4px（已落码，迭代 4）。
|
||||
|
||||
---
|
||||
|
||||
@@ -246,3 +246,4 @@
|
||||
| 2026-09-27 | 初稿（关卡画面 UX 批，用户拍板立项）：占位升格版——信息层级五层/三分区布局/组件清单/三停点状态/交互与数据锚/AC 成文；停点标题措辞修正（清偿台账 143 遗留）；GP 常驻徽章落地面（2026-09-26 二轮拍板去向，经 GP 归属拍板对齐批维持）；三项提案挂 OQ（HP 常驻读数/图上直接点击选路/放弃二次确认）登记 06 待拍板；视觉终稿以表现层样张为前置。实现锚 = route_overlay.gd 程序化占位现行 |
|
||||
| 2026-09-27 | **三拍板收口批（用户逐项裁决）**：① 底栏 = 状态展示——生命/属性（攻击·AC 有效值）/本关已选加成三组常读（原提案顶栏 HP 扩为底栏状态栏，布局决策 4）；② 图上直接点击选路定稿——候选按钮整列退役、图上点击为唯一提交通道（布局决策 2；press_candidate 探针面随实装批改造注记）；③ 放弃冒险二次确认定稿（布局决策 3）。信息层级六层重排/组件清单/States/交互表/Data Requirements（属性与加成读数入口）/AC/线框图随改；06 拍板点条目解决移除（去向 = 本批台账 204） |
|
||||
| 2026-10-09 | 文档正确性审查批：States 减动效行「切片期 TunePanel」过期订正——减动效开关已转正设置面（迭代 8 卡④；TunePanel 随迭代 15 卡①退役） |
|
||||
| 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：正文四处里程碑前缀按 2026-10-09 口径清偿——「M-2 迭代 4」三处删前缀只留「迭代 4」（Status 行/节点图画布实现锚/线框图注记）；「M-1 框材组冻结件」改「迭代 2 框材组冻结件」（git 9abf5ff 实证框材组=M-1 迭代 2） |
|
||||
@@ -1,12 +1,12 @@
|
||||
# 节点奖励屏 UX spec（node-reward）
|
||||
|
||||
> 状态：v2.5（2026-10-09 文档正确性审查批——通关三选一渠道分离对齐；池与交互形态同 v2.4）
|
||||
> 状态：v2.6（2026-10-09 文档正确性审查批·独立复核——令牌池七种口径对齐代码；池与交互形态同 v2.4）
|
||||
> 事实源：`game/presentation/views/curio_pick_overlay.gd`（三选一覆盖层共用面）+ `main.gd`（奖励节点分支——`adventure.node_bonus_candidates/apply_node_bonus`）+ `battle_narrator.gd`（node_bonus_header）
|
||||
> 相邻：[level-clear](level-clear.md)（通关三选一面——同一覆盖层的另一上下文）/ [level-map](level-map.md)（关卡画面）/ [秘宝](../systems/排雷循环/秘宝.md)（道具件内容权威——本批起为局外同调件，不再入三选一牌库）/ [冒险结构](../systems/冒险循环/冒险结构.md)（共享池令牌库账本）
|
||||
|
||||
## 定位
|
||||
|
||||
奖励节点（reward node）到达即开的**提升三选一选择面**：**六种×档位**令牌池（攻击/生命上限/护甲/GP 袋/行动点件/恢复件 × 普通/稀有/罕见——v2.2 起秘宝件随同调批退役出池；v2.4 起=固定配额令牌池），与商店货架同库同账（v2.3）、同池耗语义、同 reward_pick 封闭流。**通关三选一自迭代 15② 渠道分离起候选 = 纯专长，与本面不再同池**；与通关面的差异另在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
|
||||
奖励节点（reward node）到达即开的**提升三选一选择面**：**七种×档位**令牌池（攻击/生命上限/护甲/GP 袋/行动点件/恢复件/刷新件 × 普通/稀有/罕见——v2.2 起秘宝件随同调批退役出池；v2.4 起=固定配额令牌池；刷新件随迭代15② T6 入池〔稀有 2，恢复件同批挤占收窄——adventure_table CURIO_KINDS 第七类〕），与商店货架同库同账（v2.3）、同池耗语义、同 reward_pick 封闭流。**通关三选一自迭代 15② 渠道分离起候选 = 纯专长，与本面不再同池**；与通关面的差异另在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
|
||||
|
||||
## 布局与交互
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
- 头部行：「关卡奖励点 / 从提升池抽三选一（与通关三选一同池同权重同上限）：选择一件带走：」（Narrator.node_bonus_header——文案「与通关三选一同池同权重同上限」滞后于迭代 15② 渠道分离，现行通关候选 = 纯专长；文案换代归内容批，已呈报）。
|
||||
- 三卡点选（✓ 高亮，确认前可改选）→「确认选择」→ 兑付反馈（选中件效果 + 丢弃提示）→「继续」→ 回图选路（零自动推进同款）。
|
||||
- ~~秘宝件直显/满位替换~~（v2.1 两面随池种退役——迭代 11 第①批 T7；秘宝改走营地同调装配面，见[秘宝](../systems/排雷循环/秘宝.md)）。
|
||||
- **三选一刷新**（v2.2 新增——P1 甲 X/Y 双源）：装配「三选一刷新件」给 X 次（每次碰三选一重给、优先消耗、不结转）+ 营地「刷新升级」给 Y 次（每冒险开局注入冒险周期池、用完即无）；刷新钮余量 >0 时现形，点按重抽三候选（reward_pick 既有洗牌流，池规则全保留：不放回/达上限剔牌/掷定前置直显/停点可中断）。autoplay 默认不刷（钓鱼归玩家）。
|
||||
- **三选一刷新**（v2.2 新增——P1 甲 X/Y 双源；机制正主=[秘宝](../systems/排雷循环/秘宝.md)「三选一刷新双源」节，X 源承载件已随新目录批换代〔旧目录「三选一刷新件」退役→新目录「刷新练习」〕）：装配「三选一刷新件」给 X 次（每次碰三选一重给、优先消耗、不结转）+ 营地「刷新升级」给 Y 次（每冒险开局注入冒险周期池、用完即无）；刷新钮余量 >0 时现形，点按重抽三候选（reward_pick 既有洗牌流，池规则全保留：不放回/达上限剔牌/掷定前置直显/停点可中断）。autoplay 默认不刷（钓鱼归玩家）。
|
||||
|
||||
## 口径
|
||||
|
||||
@@ -34,4 +34,5 @@
|
||||
| v2.3 | 2026-10-03 | **商店并账注记（迭代 11 第②批 GP 商店房重构批——P1 共享池）**：口径节「同池同上限」扩第三渠道=商店货架（pool 模式付费渠道，买一件=奖励面少一件；库存=上限即库存全冒险一次性）；本 spec 交互面零改动（商店货架面归 shop.md 与 ShopOverlay，非三选一覆盖层）；GP 袋对商店面切边（负交易）、奖励面照常（牌库恒非空结构保证不变） |
|
||||
| v2.4 | 2026-10-03 | **令牌池落地（迭代 12 TP0——追认 b 实施批）**：三选一池改固定配额令牌池（普通 70/稀有 25/罕见 3=98 张；罕见档原列「道具件 2」随 aux_item 池种退役收窄——台账自决披露项）；洗牌=令牌 Fisher-Yates 不放回抽 3 同 kind 去重每 kind 至多一枚、选中踢池未选回池、池耗即枯竭（空库=零候选直通合法态）；种类次数上限退役；恢复件=新入池种类（rare 档 +6 当即回血）；kind 词表扩 heal 六种；MC 策略 316-f 落地（1 级最稀有/2 级最左）；货架=令牌级抽签（价格公式 tier-blind 维持批②裁定）；断点扩键 bonus_deck（余库逐枚还原）；现行基线锚=runsum_m4iter12_tp0_n20_20261003（normal 档配对读数同带） |
|
||||
| v2.5 | 2026-10-09 | 文档正确性审查批（在役态对齐）：①定位节「与通关三选一共享同一令牌池」过期——迭代 15② 渠道分离后通关三选一候选 = 纯专长，本面与商店货架同库（六种令牌池）；②载体组件名订正 = CurioPickOverlay；③头部文案引文加注「与通关三选一同池」字样滞后于渠道分离（文案换代归内容批，已呈报） |
|
||||
| v2.6 | 2026-10-09 | 文档正确性审查批·独立复核（worktree docaudit-2026-10-09）：①定位节令牌池「六种」→**七种**（adventure_table.gd CURIO_KINDS 实测七类含 refresh——刷新件随迭代15② T6 入池，curio_quota_refresh_rare=2 在役；v2.5 修订漏登）；②三选一刷新行补机制正主指路与 X 源承载件换代注（旧目录「三选一刷新件」退役→新目录「刷新练习」——秘宝.md「三选一刷新双源」节） |
|
||||
| —— | 2026-10-09 | v2.2 双行同号系历史登记，2026-10-09 卫生批加 a/b 后缀区分 |
|
||||
Reference in new issue
Block a user