merge: 禁写变更记录批入库——规约/AGENTS/闸壳/技能四层指令面废除文档内变更日志（gdd_lint R4 反转为禁设＋06b 新闸＋三工具去豁免），48 份文档版本历史节与 game/README 流水段删除、代码注释 900 余行批次标签清偿（约束句保留、去注释零触碰自证）、卡片「修订记录」块改「审查回写要点」（--docs 闸 dafc5540 六件全绿＋变异验证三态真拦：版本历史/修订记录/修改记录）
# Conflicts: # game/tests/static_scan.sh
This commit is contained in:
DKChan committed
commit
c5200b6be9
235 files changed
+2647
-4167
No files matched your search
@@ -62,6 +62,7 @@
|
|||||||
- 闸机轮次纪律：新码先孤立验证 → 出红只跑红件最小单元 → 长批先最小参数试车 → 开工扫坑册（process-conventions §6）
|
- 闸机轮次纪律：新码先孤立验证 → 出红只跑红件最小单元 → 长批先最小参数试车 → 开工扫坑册（process-conventions §6）
|
||||||
- 变异验证——新增/改写验收函数必须变异变红才算验收成立；无变异红记录只写「已实现，拦截能力未证」（test-conventions §6）
|
- 变异验证——新增/改写验收函数必须变异变红才算验收成立；无变异红记录只写「已实现，拦截能力未证」（test-conventions §6）
|
||||||
- 中间产物吸收即死——结论先吸收进权威文档、未决先迁 06，文件即删且永不提交（doc-conventions 第 11 节）
|
- 中间产物吸收即死——结论先吸收进权威文档、未决先迁 06，文件即删且永不提交（doc-conventions 第 11 节）
|
||||||
|
- **禁写变更记录**——文档与代码文件内一律禁设「版本历史／修订记录／变更记录／修改记录／更新记录／更新日志」节或表格，禁写「本版改了哪些条款」式逐版本叙述与 `# 2026-xx-xx 缺陷修批——` 式行内修订注记；沿革只进 git commit log。版本号可作文档现行身份标记留在文首状态行与正文引用中（doc-conventions 第 5 节，机检闸 gdd_lint R4 反转拦截）
|
||||||
- 用语红线——一切对用户输出禁自造黑话，需要作者解释的词必须展开成完整白话句（doc-conventions 第 4 节三形态表）
|
- 用语红线——一切对用户输出禁自造黑话，需要作者解释的词必须展开成完整白话句（doc-conventions 第 4 节三形态表）
|
||||||
- 呈报六问——What 现状差异 / Why 动机与不做代价 / How 方案与全部备选 / Where 影响面 / 验收判据 / 不确定点单列收尾；Who/When 不进正文；仅首次描述需求/bug/方案适用
|
- 呈报六问——What 现状差异 / Why 动机与不做代价 / How 方案与全部备选 / Where 影响面 / 验收判据 / 不确定点单列收尾；Who/When 不进正文；仅首次描述需求/bug/方案适用
|
||||||
- 真人检测只登记不阻塞——登记进 07 清单/实现报告即完成义务，禁以等目检为停工理由或收口前置
|
- 真人检测只登记不阻塞——登记进 07 清单/实现报告即完成义务，禁以等目检为停工理由或收口前置
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# 美术资源依赖清单（Art Assets Checklist）
|
# 美术资源依赖清单（Art Assets Checklist）
|
||||||
|
|
||||||
> **性质**：表现层升级批与战斗表现批的生产侧清单——把散在战斗表现 / HUD框架 / 关卡节点地图 / 敌人系统里的资产需求收拢成一张可执行的工单视图，**兼资产维度单一登记处**。**规范效力归各 owner 文档**（战斗表现、美术圣经、04-美术音频方向），本文只补「生产视角的需求规格」，冲突时以 owner 文档为准。
|
> **性质**：表现层升级批与战斗表现批的生产侧清单——把散在战斗表现 / HUD框架 / 关卡节点地图 / 敌人系统里的资产需求收拢成一张可执行的工单视图，**兼资产维度单一登记处**。**规范效力归各 owner 文档**（战斗表现、美术圣经、04-美术音频方向），本文只补「生产视角的需求规格」，冲突时以 owner 文档为准。
|
||||||
> **建立**：2026-09-18 场景一（战斗画面呈现）讨论产物。**2026-09-22 GDD 过期账清偿批**：原 asset-checklist.md 并入本文后删除，本文自此为两份清单合并后的唯一清单；同批修正敌人键集/徽章数量/样张状态等过期事实（详见 art-bible 版本历史 v1.3）。**2026-09-22 §5 角色设计落地批**：剪影引用迁 art-bible §5.1、护甲区分方案落 §5.3（清偿两处待设计项）、提示词卡 v2.0 重生成（详见 art-bible 版本历史 v1.6）。**2026-09-23 复用盘点批**：立素材站复用渠道与复用闸（§0）；新增 §3.4–3.6 三条此前漏登记的需求（增益状态效果图标 / 营地与元进度件 / 字体）；各条目标注来源渠道。**2026-09-23 §5 抽离批**:角色设计内容迁独立文档 `character-design.md`(art-bible §5 自此为引用存根,小节号不变),本文 §5.x 剪影/护甲引用经存根仍可达;主角特征批(直剑→挖掘铲、加旗朱背旗)顺带,主角形象锚见 character-design.md §5.4。**2026-09-23 §6–9 补全批**：art-bible 四章成文（§6 环境/§7 UI/§8 资产规范/§9 参考与反参考）；本文 §0 交付格式与像素尺寸行、参考图行、§6 依赖链顺带改指 §8/§9 现行。
|
> **建立**：2026-09-18 场景一（战斗画面呈现）讨论产物。**2026-09-22 GDD 过期账清偿批**：原 asset-checklist.md 并入本文后删除，本文自此为两份清单合并后的唯一清单；同批修正敌人键集/徽章数量/样张状态等过期事实（详见 art-bible 的 git 提交史）。**2026-09-22 §5 角色设计落地批**：剪影引用迁 art-bible §5.1、护甲区分方案落 §5.3（清偿两处待设计项）、提示词卡 v2.0 重生成（详见 art-bible 的 git 提交史）。**2026-09-23 复用盘点批**：立素材站复用渠道与复用闸（§0）；新增 §3.4–3.6 三条此前漏登记的需求（增益状态效果图标 / 营地与元进度件 / 字体）；各条目标注来源渠道。**2026-09-23 §5 抽离批**:角色设计内容迁独立文档 `character-design.md`(art-bible §5 自此为引用存根,小节号不变),本文 §5.x 剪影/护甲引用经存根仍可达;主角特征批(直剑→挖掘铲、加旗朱背旗)顺带,主角形象锚见 character-design.md §5.4。**2026-09-23 §6–9 补全批**：art-bible 四章成文（§6 环境/§7 UI/§8 资产规范/§9 参考与反参考）；本文 §0 交付格式与像素尺寸行、参考图行、§6 依赖链顺带改指 §8/§9 现行。
|
||||||
> **更新纪律**：各条目「现状」行顺带更新（未开始 / 候选已出 / 已裁决 / 已交付）；做完不删条目，改状态。与 06-待办清单的联动：本文是资产维度明细，06 只留指路存根。
|
> **更新纪律**：各条目「现状」行顺带更新（未开始 / 候选已出 / 已裁决 / 已交付）；做完不删条目，改状态。与 06-待办清单的联动：本文是资产维度明细，06 只留指路存根。
|
||||||
|
|
||||||
## 0. 生产渠道、规格与风格宪法
|
## 0. 生产渠道、规格与风格宪法
|
||||||
@@ -199,9 +199,3 @@
|
|||||||
|
|
||||||
### 复用四闸(状态记录 130,现行)
|
### 复用四闸(状态记录 130,现行)
|
||||||
色板量化 / 禁入带吸色 / 灰度可辨 / 授权干净(SA 不可、来路不明不可)。
|
色板量化 / 禁入带吸色 / 灰度可辨 / 授权干净(SA 不可、来路不明不可)。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-10-10 | 补建版本表（本文件此前无版本表）+首笔登记：§3.5 柜台场景贴图括注「道具工坊」改「秘宝匣」（2026-10-10 天赋树设计会话裁） |
|
|
||||||
+2
-51
@@ -1,6 +1,6 @@
|
|||||||
# 美术圣经(Art Bible)— Dungeon Sweeper
|
# 美术圣经(Art Bible)— Dungeon Sweeper
|
||||||
|
|
||||||
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归状态记录 125);历次修订明细见文末版本历史(现行为 v3.15)
|
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归状态记录 125);现行为 v3.15，历次修订明细见 git 提交史
|
||||||
>
|
>
|
||||||
> **Art Director Sign-Off (AD-ART-BIBLE)**:历次批均 SKIPPED(v1.8 §6–9 补全亦 SKIPPED)— Lean/Solo mode(非 PHASE-GATE;§6–9 已成文,full 门禁签核时机待用户表态)
|
> **Art Director Sign-Off (AD-ART-BIBLE)**:历次批均 SKIPPED(v1.8 §6–9 补全亦 SKIPPED)— Lean/Solo mode(非 PHASE-GATE;§6–9 已成文,full 门禁签核时机待用户表态)
|
||||||
> 风格基调(2026-09-10 用户定稿):地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身
|
> 风格基调(2026-09-10 用户定稿):地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身
|
||||||
@@ -42,9 +42,7 @@
|
|||||||
|
|
||||||
*设计测试:当新图类型或新变异格需要新视觉时,先换色板加形状,再谈新资产;当格子多样化与"好看/有雷"之辨冲突时,砍装饰,不动逻辑通道。*
|
*设计测试:当新图类型或新变异格需要新视觉时,先换色板加形状,再谈新资产;当格子多样化与"好看/有雷"之辨冲突时,砍装饰,不动逻辑通道。*
|
||||||
|
|
||||||
### 1.3 修订记录(已迁出)
|
|
||||||
|
|
||||||
早期"对 brainstorm 视觉锚的修订记录"整节并入文末**版本历史**(v1.0/v1.1/v1.2/v1.3 条目承载);本节留号占位,正文只描述现行规则(状态记录 109 纪律)。
|
|
||||||
|
|
||||||
### 1.4 格子样张测试(验收标准,2026-09-13 成文)
|
### 1.4 格子样张测试(验收标准,2026-09-13 成文)
|
||||||
|
|
||||||
@@ -165,7 +163,7 @@
|
|||||||
- **地砖**:一切环境体由同一圆角方形衍生:未开=完整凸砖,已开=同形缺角碎裂,雷=碎裂加巢穴纹(危险格玩家说法见《排雷玩法》);只以"完整度"叙事,不为状态新造形。←原三;P4
|
- **地砖**:一切环境体由同一圆角方形衍生:未开=完整凸砖,已开=同形缺角碎裂,雷=碎裂加巢穴纹(危险格玩家说法见《排雷玩法》);只以"完整度"叙事,不为状态新造形。←原三;P4
|
||||||
- **装饰变体(未开格氛围层)**:覆尘完整砖之上叠加裂纹/碎石斑/物件级点缀等装饰;2026-09-29 v3.0 物件级解禁——物件级装饰(小石块/陶片/骨殖等)须走**专属装饰形状家族**(与信息元素形状语言隔离、灰度下不与任何逻辑元素同形),数量配额按图类型定(候选 3–5 种,样张 v3 冻结),一律残缺、内凹、低对比而自然后退(§3.4);零信息纪律(分布随机、与雷/安/类型零相关、灰度下禁止制造新分类特征、分布每板一次跨轮不复掷)以原则三为准,此处不赘。←原三
|
- **装饰变体(未开格氛围层)**:覆尘完整砖之上叠加裂纹/碎石斑/物件级点缀等装饰;2026-09-29 v3.0 物件级解禁——物件级装饰(小石块/陶片/骨殖等)须走**专属装饰形状家族**(与信息元素形状语言隔离、灰度下不与任何逻辑元素同形),数量配额按图类型定(候选 3–5 种,样张 v3 冻结),一律残缺、内凹、低对比而自然后退(§3.4);零信息纪律(分布随机、与雷/安/类型零相关、灰度下禁止制造新分类特征、分布每板一次跨轮不复掷)以原则三为准,此处不赘。←原三
|
||||||
- **结果整格表达(已开格)**:已开格按当格结果整格表达(结果清单见原则三);画法——产资源格的家族物件纹样用 §3.1 道具点剪影语言(直线几何体)角嵌于砖缘,砖心与数字字形占位区留白(已开格仍承载数字);危险格巢穴纹较已开格更凶一档,形状+颜色双通道不变。←原三;P3
|
- **结果整格表达(已开格)**:已开格按当格结果整格表达(结果清单见原则三);画法——产资源格的家族物件纹样用 §3.1 道具点剪影语言(直线几何体)角嵌于砖缘,砖心与数字字形占位区留白(已开格仍承载数字);危险格巢穴纹较已开格更凶一档,形状+颜色双通道不变。←原三;P3
|
||||||
- **未开格预读通道(微光单通道)**:类型预读 = 类型微光单通道(色相+明度双码,色带 §4.2);色弱类型主通道 = 微光明度梯度（组粒度——组间互辨；§2 微光明度例外）;格内零角嵌/箭头/加号类附加形(2026-09-28 用户裁「微光格只留微光」,退役史见版本历史 v2.12)。←原一;原三
|
- **未开格预读通道(微光单通道)**:类型预读 = 类型微光单通道(色相+明度双码,色带 §4.2);色弱类型主通道 = 微光明度梯度（组粒度——组间互辨；§2 微光明度例外）;格内零角嵌/箭头/加号类附加形(2026-09-28 用户裁「微光格只留微光」,退役史见 git 提交史)。←原一;原三
|
||||||
- **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 [术语表](../gdd/术语表.md)「封印」条;插旗动作面见《排雷玩法》)——旗 = 封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;旗印记纹理已落位、字形占位退役（迭代 9 卡⑬兑现；原 06 债务条目已完成移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28
|
- **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 [术语表](../gdd/术语表.md)「封印」条;插旗动作面见《排雷玩法》)——旗 = 封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;旗印记纹理已落位、字形占位退役（迭代 9 卡⑬兑现；原 06 债务条目已完成移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28
|
||||||
- **可挖域接触带微光(交互反馈层,2026-09-25 用户拍板)**:挖掘期,英雄格周界与可挖域(概念见《排雷玩法》动作合法性节;呈现义务见《HUD框架》可挖域指示)的接触面画呼吸微光——正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格(空间)一侧、不进墙格(与装饰变体零冲突,数字砖心不涉);微光=空间的灯光边界(画法口径)。色相=蓝族浅一档(§4.2 蓝条;与主角蓝框的分层归样张批);呼吸=§2.1 挖掘期唯一在动元素,减动效停格。角点为斜墙与正交墙共享、不逐格归因,逐格指认=悬停金框(呈现交互归《HUD框架》悬停指示域)。←§2.1;§4.2;P1
|
- **可挖域接触带微光(交互反馈层,2026-09-25 用户拍板)**:挖掘期,英雄格周界与可挖域(概念见《排雷玩法》动作合法性节;呈现义务见《HUD框架》可挖域指示)的接触面画呼吸微光——正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格(空间)一侧、不进墙格(与装饰变体零冲突,数字砖心不涉);微光=空间的灯光边界(画法口径)。色相=蓝族浅一档(§4.2 蓝条;与主角蓝框的分层归样张批);呼吸=§2.1 挖掘期唯一在动元素,减动效停格。角点为斜墙与正交墙共享、不逐格归因,逐格指认=悬停金框(呈现交互归《HUD框架》悬停指示域)。←§2.1;§4.2;P1
|
||||||
- **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰禁止伪装逻辑差异。←原三
|
- **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰禁止伪装逻辑差异。←原三
|
||||||
@@ -543,50 +541,3 @@
|
|||||||
| **传统扫雷 1–8 八色分色** | §4.1 数字墨三档 | 八色必撞红/金/蓝/紫赤语义色段;数字只走墨族三档色温,字形为唯一数值载体 |
|
| **传统扫雷 1–8 八色分色** | §4.1 数字墨三档 | 八色必撞红/金/蓝/紫赤语义色段;数字只走墨族三档色温,字形为唯一数值载体 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
- **v3.15(2026-10-17)未开格类型微光明度档 provisional 值登记(迭代 30 卡①实装随批;§4.2/§4.6.3 权威面零改动、§2.1 不追加)**:①**五组明度档 provisional 值登记**(色相零移动——样张 v2 冻结的五组色相本身不动,本批只定各组明度档,归「待定现用」第三态〔v3.10 立〕,复核转正归战斗一屏样张〔迭代 30 序位②〕):通用增益芥末黄 `#F7DF43`(冻结 `#D6C13A` 提亮档)、治疗黄绿 `#68D042`(冻结 `#5CB83A` 提亮档)、穿刺青 `#30A6A6`(冻结 `#2E9E9E` 提亮档)、魔法紫罗兰 `#7B5BD6`(与冻结值同)、群伤绯红 `#A61D37`(冻结 `#FF2D55` 的 V=0.65 暗档);五组 ΔH ≤0.13° 全数只动明度;实装落点 = `ui_kit.gd` TG_GLOW_* 五常量,呈现参数 α170/带宽 cell÷8 维持 §4.2 v2 口径不动;②**明度排档口径**——阶梯在渲染合成空间(伽马)排档:引擎 canvas 混合在帧缓冲 sRGB 域做线性插值,按 CIE L* 线性排档曾把群伤/魔法两档排反;相邻组对比度(CR)四对模型值 1.245/1.234/1.239/1.270 全数过判据线 1.20,实测最弱对 1.232;③**停机呈报留痕**(契约 5):群伤暗档初版 `#FF1A31`(ΔH 5.40° 超差)作废,用户裁「换更暗档」→ `#A61D37`(色相零移动);④连带=头注「现行为」漏更订正(v3.12–v3.14 三代未回头注,本批订正为 v3.15)。零素材新增,微光语义零改动
|
|
||||||
- **v3.14(2026-10-14)迭代 24/25/26 反哺写入批(用户裁「全部按呈报写入文档」——qa 收尾批)**:①**§4.1 新入三 token**(GOLD_BRIGHT #E0B860 收益金亮档 / HERO_BLUE_BRIGHT #7EBAF0 小人蓝亮档 / SLOT_BACKDROP_SOFT #806A4E 图标槽柔和档——迭代 26 反哺③语义岗登记转正,色板计数 42→45);②**§7.6 新增「引擎原生控件与按钮状态规格」节**(迭代 25 反哺①+迭代 26 反哺①④——原无条款,两批实现临时权威转正:按钮五态矩阵〔悬停 modulate 1.06/按下本族下沉/禁用 α0.45 幽灵化/焦点 INK 2px 内缩 1px 环〕+原生控件组件规格〔滚动条 StyleBox 柄/滑轨两段可辨/气泡/输入件/预盖件/字体防御〕+氛围层平滑件与抖动派并存留样张批+主题色值双源注记〔迭代 25 反哺④〕);③**§8.2 增全局纹理过滤与平滑渐变件例外条款**(迭代 26 反哺②——Nearest 全局+三件 LINEAR 豁免清单);④连带 = §7 白话章节清单补 §7.6。色值遵守定值单点纪律指路 theme README 溯源表,零复述
|
|
||||||
- **v3.13(2026-10-10)营地柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）**：§2.8 承载元素与 §6.2 场景构成两处三柜台括注改名。零素材新增
|
|
||||||
- **v3.12(2026-10-07)类型微光组粒度批（用户裁——道具三层重设计·地图层顺带）**：§4.2 类型微光色带「组内明度梯度分型」降为「组间五色相+组内不细分」——逐型明度映射从未定义、cell÷8 泛光上五级明度物理不可读；色弱通道随迁组粒度（§2 验收2/§4.5⑨ 同批措辞同步）；gp 不拆独立色相（用户裁：攻击三类+治疗+通用=五色已达玩家记忆上限）；五组色相本身不动（样张 v2 冻结维持）
|
|
||||||
- **v3.11(2026-10-06)文档层三小活收尾(审计 §07 吸收对账后剩余项)**:①**§8 头注新增「定值单点纪律」**(审计 §07-1 落规——数字定值只落 §4.1 主色板 + §8.2 两张表,其余章节指路禁复述;character-design §5.5 数值指路 §8.2);②**§8.3 检查器挂点补 standee_asset_check 硬闸升级规格**(审计 §07-2/3——按 §8.2 逐键定档校验/色数 ≤32/无非整数缩放痕迹/描边亮度达标,现「宽 1–75」虚设区间退役,实现归 PRD 工具批);③连带 = art-status-checklist 状态图标行悬空路径(candidates/status-icons-2026-09-23/)按归档纪律改描述性出处;审计 §07-3 体量分区数字表建议**改判作废**(已被「生物体型+逐键定档」语义取代)。
|
|
||||||
- **v3.10(2026-10-06)两拍板写入文档批(P2 收尾)**:①**§4.1 色板数值改「待定现用」态**(用户立第三态,非候选非死规——现行即执法、需求引入时走修订并登记;释义随条);②**头注新增「条款验收标注纪律」**——全文条款尾部三档标注(←机检/←目检/←方向性,用户拍板「符合工作流程」),新条款按此书写,存量口号型分章补标(06 挂账批执行);③连带 = 06「口号型条款机检化批」状态补格式已拍板注记。
|
|
||||||
- **v3.9(2026-10-06)P2 清理项文档处置批(审计 04 节四项;零素材新增)**:①**§4.1 新增色板增量纪律**——硬上限 48 色(现行 ≈42)+新色双门(§4.2 语义检查 / 与既有色 RGB 三通道差 ≥8/255,反例 #3A2E22↔#362B20 差 <5),不过门走「换色合并」禁加色绕行;数值候选待样张批冻结。②asset-path-map.md 三处悬空/过时更正——candidates 目录注「按需创建非作废」、废路径 production/mockups/** 改 `artwork/mockups/**`(实存)、board/ 现役改 terrain_floor_<board_type>_<n> + flag_seal(旧 board_floor/wall 退役)。③P2-1 草稿整理批(3349 个)与 P2-4 口号型条款机检化批登记 06 待办(前者执行须 dry-run 先行)。④待决项 A/B/C 前批已全部完成,本批零遗留。
|
|
||||||
- **v3.8(2026-10-06)零定义资产族契约批(P1-2,用户拍板「写进圣经、不另立文件」)**:零素材新增,纯契约登记——①§4.6.2 奖励徽章 19 枚资产契约(`ui/icons/reward_<reward_id>.png`,源 40×40,显示 20/40 双档候选);②§4.6.3 新增地形变异纹带族资产契约(`board/band_<variant_id>.png`,键集事实源 = 地形变异 GDD region 六行,源 64×64 无缝,已开变异格标识层);③§6.1 舞台背景插画资产契约(`stage/stage_bg.png` 基准一张 1280×270,三关换挡走 wall_ambient tint 槽不出三张)。三族照抄状态图标「键→文件名→尺寸」模式(§4.6.1 全链唯一完全合规族,审计点名可复制);程序化占位在役,出图工单归 PRD;art-status-checklist 看板随交付 ✅。
|
|
||||||
- **v3.7(2026-10-06)立绘八敌定档批+方案二排版写入文档+归档纪律(P0 完成讨论批;工作流程铁律 = 讨论期只动文档,代码实装另批走 PRD→迭代)**:①**§8.2 画布基准——站桩立绘源档八敌逐键定档**(goblin 36/giant_spider 38/duergar 46/hook_horror 58/bugbear 62/ogre_chief 74/drider 90/duergar_king 94,×2 整数显示;原三档 48/64/96 候选与 v3.0 档位上调方向候选一并完成;依据 = 用户三体型约束+定档总图确认;可读性门槛源高 ≥32 实测;派生管线 = pixel-1→紧裁→dom_block_resize);②**§8.2 缩放纪律——站桩立绘排版 = 方案二**(B 区 270 ≈1/3/C 区 530 ≈2/3/扫雷盘 438 不缩;立绘底锚落台+血条状态落底排全场对齐+大体档探顶;原「血条悬浮头顶」退役——高盒空洞用户点名否决);③**§8.3 归档纪律**(P0-1 用户口径:图片不入 git/归档+对象存储/主文档禁引用 artwork 散路径);④连带 = character-design.md §5.2 体量语义修订(强度先验→生物体型)+§5.5 源档注记+钩爪恐魔宽≥高豁免登记、battle.md 区表/组件/线框/空态/修订记录顺带。
|
|
||||||
- **v3.6(2026-10-04)站桩槽「高定宽随」条款落规(UI 重设计原型审计教训)**:§8.2 缩放纪律新增**站桩立绘槽位=高定宽随**条——槽位只定高度的整数倍档、宽度随源图宽高比自适应,禁统一方框强拉(纵横倍率恒等;实例=原型 88×92 方框把 23×48 地精横拉 3.83×/纵拉 1.92×、26×48 熊地精 3.38×/1.92× 压扁,46×48 主角近方恰等比独活;三层成因=窄条源图/方框一刀切/非整数倍 pixelated 发花);**乙类非整数豁免口径收窄注记=只覆盖等比缩放,不含纵横异倍变形**。同批原型侧修复=站槽 height:96 width:auto(48px 源 2×)+开始屏背景怪/大立绘/庆祝像/旗/图标显示尺寸整数倍对齐。文档核查=battle.md/HUD框架 均无强制方框条文(缺口是规则本身缺位,本批补)
|
|
||||||
- **v3.5(2026-10-03)视野迷雾黑暗区域渲染规格批(迭代 11 第④批实施批 T1;上位裁决=《HUD框架》「视野迷雾」节 v0.13,现行事实源已定论照抄)**:新增 §6.5——菱形灯光区=曼哈顿距离 ≤LIGHT_RADIUS(基准 8,表值/常量参数化;两圈分立注=类型微光仍贴身 8 邻格不随灯光区扩;提灯 +2 插值位预留不接效果);区外未开格全黑不渲染(照抄现行事实源「全黑不渲染」,非高遮蔽档,三档信息阶梯理由在节内);区外已开格暗淡记忆态(记忆板 #3A3A3A/记忆墨 #C4C4C4 provisional,数字 ≥4.5:1,三通道可辨判据在案,色牌格退牌归板,旗印记随未开格全黑隐没);过渡边=硬边逐格二值(禁渐变晕边);结算期去饱和叠加互斥口径(记忆态为终态档);§2 光照氛围允许域自查注记在节内;§6 开篇枚举行补「棋盘视野迷雾遮蔽」一词。纯呈现层零素材新增(程序化遮罩/调制),微光语义零改动,明度值 provisional(样张/实机自检锚,代拍板白名单内)
|
|
||||||
- **v3.4(2026-10-01)数字呈现三态修订(甲案深墨族方案渲染帧取证证伪后改版)**:v3.3 的「L2/L3 切深墨族直画」经 board_shot_probe 渲染帧取证证伪——underdark 系地板双峰纹理(近黑斑 p10 0.011+近白筋 p90 0.40+)上深墨直画融黑斑隐形(用户实机复测「还是看不清」实证),任何墨族直画不可救;改**三态**:dungeon 亮族直画(门 p90≥4.5/均值≥2.5)/中暗板深墨直画(门 p90≥4.5/均值≥3.0)/双峰板**色牌垫底**(素牌+深墨 12:1,v2 色牌形制复役);机检三关呈现模式断言 19/19;目视验证面=board_shot_probe 渲染帧取证入流程(机检≠看得清)。§1.4 样张闸第四验收项判读随三态口径件注记。
|
|
||||||
- **v3.3(2026-10-01)数字墨按板自适应修订(L2/L3 亮瓦融字缺陷修复,用户裁甲案「墨色按关自适应+补三关对比断言」)**:§4.1 数字墨双色制①改**按板自适应双族**——暗纹理板维持亮族三档(样张 v3 冻结原样),亮筋纹板(underdark/deep_underdark)切深墨族三档(青墨/赭墨/锈墨复役);选族判据=所选族对归一后地板 p90 亮斑 ≥4.5:1 且对均值 ≥2.0:1,落码单点 `board_view._digit_ink_mode`,机检=`terrain_tile_sets_test` 三关对比断言 21/21;缺盘平色回退默认深墨族。§4.1 其余条款(字形唯一载体/三档色温/垫牌后备)不变。
|
|
||||||
- **v3.1(2026-09-30)越权清理批(用户指令:按域内审查修订案修改,概念定义归还 GDD 权威文档)**:①**微光口径四处改指路**——§1.2 原则三/§1.4 样张清单去「常显」、§4.2 色带条去「常显」、§4.6.3 去「全部未开格」,统一指路《HUD框架》「未开格类型微光」节(2026-09-30 完成批落位的唯一事实源,他文只许指路);②**概念越权剥离**——危险格叙事属名与换轴史、封印插旗语义(→registry「封印」条+《排雷玩法》玩家说法)、极性定义(→《地图战斗资源》极性提案)、完美排雷定义与兑付结构(→同)、敌意图预告语义与「待机即预示」(→《敌人系统》意图线索节)、奖励 weight 与兑付/库存语义(→《地图战斗资源》)、键名沿革史(empower/fortify 来源=敌方技能施放、alert 2026-09-20 八型批换装、ac_up 2026-09-16 换装——自 §4.6.1 移除留痕)、甲档 armor 数据实态(L1 全轻甲/L2 除 drider 外全轻甲/L3 duergar·duergar_king 重甲)与旧键集史({grub, ambusher} 随 DND 更名退役——自 §4.6.4 移除留痕)、「敌不占格」断言、「类型分布即先验」机制 rationale、「分布属初始化随机」归属断言(改画法口径「分布每板一次跨轮不复掷」);③**实装状态与排期注记移本历史留痕**——游戏 UiKit.HERO_BLUE 已同步 #2E6E8E→#2E86DE、UiKit.CONTACT_GLOW 同值 #D6ECFF、旧可挖域绿相 DIG_EDGE 已随接触带方案退役、死亡表现切片实装=程序化 tween(灰化罩+碎块弹飞 5 块 0.45s,挂 unit_died)、封印特效「待表现批」、§6.1 背景插画「排期归表现层升级批」、panel_stone/button_stone 接线归最近表现批、§7.2 对比度违例「修复归表现批」、§7.5「占位不空窗」注记;④**角嵌退役条改写**为现行「未开格预读通道(微光单通道)」条(退役史见 v2.12);⑤**残留矛盾清除**——§3.2 呈现基准条「装饰变体一律纹理级」旧措辞随 v3.0 物件级解禁同步;⑥§2.8 营地承载元素/§7.5 钥石呈现位改指 §6.2(事实源边界在该节);⑦**补漏五处(同批完工审计发现,同类剥离留痕)**——§4.1 危险红「机关红」更名史、§6.2 营地贴图「排期归 UI 贴图重构批」与「占位不空窗」注记、§7.4 字体「接入归表现批」注记、§8.1 扩板与 1920 档换算值「归表现层升级批成文」(改债务指路 06「分辨率档位与棋盘格边长口径」条)、§8.3 「终稿目录归表现批定」注记、§1.4 整屏样张闸「表现层落码批开工前」改屏级落码开工前、§7.1 「样式终稿归样张后表现批」改随样张闸后定稿。**零美术信息损失**:全部色值/机检断言/纹样描述/画法参数不动,样张 v2 四冻结之②③维持
|
|
||||||
- **v3.2(2026-09-30)样张 v3 冻结批+缩放分级修订+案甲落定(迭代 9 T1/T2/T9;需求卡片已退役（git 710f9b7 出口批）)**:①§1.4 补**样张 v3 冻结记录**——机检 17/17 全绿,断言定值两件(A3b 图底分离定值 Δ≥30〔实测 38〕/A4 尺寸基线硬等冻结 立绘 46×48+小人源 32×32),F6 沿用 v3.4;**四冻结①④重冻**——①砖面形态=E 格高墙 30% 词表扩展+格底明度分档(世界底层档 L≈0.10)+装饰物件级解禁/④数字形制=亮墨三档直画+色牌后备;②色板③动画维持冻结。产物 `artwork/mockups/sample-batch-v3-final-2026-09-30.png`+机检报告【冻结】;气质终审=2026-09-29 用户验收豁免(状态记录 281)。②**§8.2 缩放纪律分级修订**(2026-09-26 用户裁「改规则不豁免」写入文档,修订窗口=v3.0 已入库):甲类文本语义件(数字/图标/旗/砖面/纹样)维持严格整数倍;乙类角色精灵允许运行时非整数倍(NEAREST 不变,判据=实机目检可感不适即回整数档);1920 档策略经三裁决**案甲落定**(全局等比 stretch keep——v3.2 当日 T9 写入文档,详见 §8.2)。头注「现行为」顺带 v3.2。
|
|
||||||
- **v3.0(2026-09-29)中修批(案 B,用户拍板;审视报告=git fbaadb8（已退役）,六病根+三案呈报)**:①**§2 明度恒定→明度分层**——三档明度带(信息面层/世界中层/世界底层),情绪与状态明暗禁令保留(状态区分仍只走色相/饱和/运动/元素),空间纵深/光照/形体塑造开允许域;§2.1/2.2/2.3/2.5/2.7 各状态条措辞随改,§2.7 增「明度带随深度微移」候选。②**原则二色牌降级**——「明亮为皮,色牌为骨」改「明度分档为骨」:已开格走世界底层档(候选 L 0.20–0.32),棋盘数字墨亮族直画(候选 L≥0.75,冷亮/暖白/金亮三档色温承袭密度语义),色牌仅复杂格底后备(垫牌场景用深墨族,12.3:1 实测保留);§1.4 验收 1/2/4 与判定回退口径同步,样张 v2 四冻结之①④(砖面形态之数字承载面/数字形制)**解冻待样张 v3 重冻**(②③冻结〔色板/动画〕不受影响)。③**语义色适用域限定**——§4.2 各条「X 只说 Y」约束信息层与语义物件,纯环境氛围解禁(焦点预算与低饱和后退接管防抢焦);紫赤禁入带环境层低饱和可入、高饱和独占不变;§4.3 换皮槽与不变槽口径随改。④**装饰变体物件级解禁**——专属装饰形状家族+零信息纪律不变+焦点预算约束,配额候选 3–5 种(原则三/§3.2)。⑤**§6.1 舞台正面目标**——B 区=地窟看台(地台/落影/光源氛围候选),补原条只有负面约束之缺。⑥**§1.4 整屏样张闸新增**——战斗/关卡/菜单/营地四屏,验收四项(全局文字 ≥4.5:1/明度三档带/整屏焦点预算/文字禁压纹理),闸形=方向稿目检先行→机检冻结。⑦**§7 三件**——7.1 占位完成条款(占位=临时态,终稿闸=整屏样张)/7.2 全局文字可读性硬指标/7.4 字号下限 16/14px 对齐 ux-designer PC 规范+层级手段解禁(字号档差+墨色+字重)。⑧**§8.2 档位上调方向候选**(主角 64×96/敌 64/96/128 评估,归整屏样张闸,本批不重产资产)。⑨**§9 参考表**——Moonlighter 取列增光照层次、§9.2 DD 条款改名+新增「传统扫雷白牌」反面行。⑩**§3.4 焦点双机制**(完整度+明度带)。**连带文档同步**:character-design.md(提灯点亮解禁候选)/interaction-patterns.md/level-map.md/art-assets-checklist.md/battle.md/04-美术音频方向.md 引用口径顺带。**挂账(06 登记)**:样张 v3 重跑批(断言改造+新参数冻结)/ui_kit 与棋盘渲染落码批(明度分层/格底分档/亮墨/UI 对比度修复)/资产升档重产批/mockup v3 方向稿(按 v3.0 重出)。**代拍板三项 2026-09-29 当日已追认**（闸形两段式/色牌后备范围/升档只立方向）。
|
|
||||||
- **v2.15(2026-09-28)人设旗脱钩批(用户拍板)**:§5.4 速览背包旗改旗朱红矩形旗+§4.1 封印黑条红族口径限定棋盘侧;封印黑仍为棋盘封印专属色不变;人设侧详见 character-design 对应版本行(v1.7)
|
|
||||||
- **v2.14(2026-09-28)关卡画面样张 v1 冻结批(M-2 迭代 4 T1–T4,机检闸形 A——11/11 全绿即冻结)**:§7.2 增「暗底呈现态双色墨制」条(暗底系图标/读数=暖白 #F0E2C8、当前金底转深墨 #181410,各态 ≥4.5:1;已过节点暗金冻结 **GOLD_DONE #68562C** 专用呈现态值——旧 GOLD_DIM #8C743C 对双色墨均不达标;Boss 描边=紫赤 2px+外缘 1px 深墨环灰度冗余通道——§4.2 色相独占本色不变);冻结面=节点图标形制(♻ kenney-board-game-icons 五键 bow/award/campfire/crown_b/pouch,20px 烘焙 1:1 消费,WARM 单色,复用闸①②③④)+通道质感(折线 2/3/4px 直角肘形)+画布公式(70+层×122+34/52+槽×58+26+8 下限 620×240——routebug 83c11a1 根修件同源)+底栏样式(暗数据框 WARM/WARM_SOFT 双墨)+屏底(BG_ROOT+backdrop_stone);换层色板渐变挂点落码(§2.7 切片档——level_index→tint 表候选值随 §6.3 方向,明度带归一,终值归色板样张批)。规格承载=level-map.md(修订记录同日行);产物=`artwork/mockups/level-map-sheet-v1-2026-09-28.png`,机检报告=git 提交 9a79927;气质终审=M-2 出口闸真人目检
|
|
||||||
- **v2.9(2026-09-26)高墙瓦片体系定稿批**(高墙批全程收官,用户拍板;状态记录 163/164):§3.2 新增「高墙瓦片体系」条——未挖格=一整块 32×32 自含凸起岩体(方案甲核心定义)+术语(墙瓦片/地面瓦片)+墨线边界纪律(1px 深墨线直线零锯齿,职责=分隔不融合)+单一北受光(北缘 1px 微亮棱/南缘立面窄暗条/凹角角点+立面侧 1px 齐平收头),定稿=`game/assets/art/board/terrain_*` 21 枚;§8.5 增「生产分工」条——材质归模型(AI 只出无缝填充纹理)、结构归程序(autotile 拼接约束超 2D 生图能力,实证在案)+镜像规则(只许 flip_h 禁旋转)。条口径=样张批追认(与 §8.4 方向集先例同)。词表与查表逻辑、搜包评估记录归 design/research 两档;过程文档顺带清退(中间产物不入库先例,状态记录 127)。
|
|
||||||
- **v2.10(2026-09-26)封印紫批**(用户拍板:插旗色 旗朱 #C63D22 → **封印紫 #7C3AA8**,色相 ≈267°):§4.1 旗朱条改写为封印紫条(候选值样张批冻结;禁入带合规+与魔法微光/妨害紫间距登记)、§4.2 红只说危险改单档(旗朱预告档退役)、§3.2 旗条/§1.4 验收 4/§4.3 不变槽/§3.2 变异互辨/§5.4 速览顺带。**语义面**——封印自术语批(2026-09-25)获专属色相,红族收敛为危险红单档;攻击预告/弹道/拒绝等非封印红统一归危险红族(RED_MINE)。**连带**——character-design §5.4 背旗、battle.md 三处、关卡节点地图 Boss 描边、清单封印特效行顺带;comfyui-prompts 生图卡颜色词随样张 v2 重生成。
|
|
||||||
- **v2.11(2026-09-28)封印黑批**(用户拍板:封印色 封印紫 #7C3AA8 → **封印黑 #000000**——紫色与微光蓝族色相冲突,黑色无色相天然合规):§4.1 封印紫条改写封印黑条、§3.2 旗条/§1.4 不变槽/§4.3/§5.4 速览顺带;代码 UiKit.SEAL_PURPLE→SEAL_BLACK 改名迁移+board_view/board_fx_view 换色+样张脚本同步;胜利彩带装饰紫位改亮金(紫赤系 Boss 独占不入装饰);远程生图单主角旗 purple→black 十六进制锁色重锁。历史行(v2.10 等)按文档纪律留痕不改
|
|
||||||
- **v2.12(2026-09-28)角嵌退役批**(用户裁「微光的展示只有微光,不要加额外的箭头或者加号在格子里面」——样张 v1 否决原因之一):未开格类型角嵌纹样**彻底退役**——类型预读改类型微光单通道(色相+明度双码),§2 微光明度恒定开例外(明度梯度承载类型,梯度不压格底明度档/三态分类),色弱类型主通道=微光双码;§1.2 优先级栈/§1.4 样张清单与验收 2/§3.2 角嵌条(标退役)/§3.4/§4.2 色带条/§4.5⑨/§4.6.3 呈现约束同步;已开格物件纹样(角嵌于砖缘画法动词)不在退役面;机检新增「微光格零墨色附加像素」断言;角嵌误读率指标转微光误读率 |
|
|
||||||
- **v2.13(2026-09-28)样张 v2 冻结批(M-1 迭代 2 T1,机检闸形 A——全过即冻结)**:§1.4 增样张 v2 记录(机检 16/16:现行 13 条+A3 上调 Δ≥55/F6 顶面立面双明度带 Δ≥18/F7 悬崖 DEPTH_PX 同源/A6 观感密度梯度 ≥4.70=v1 实测 4.09×1.15——v1 四否决原因断言化收官);**四冻结写入文档**——①砖面形态:§3.2 高墙瓦片体系条增「D 投影档+整板悬崖」定稿参数(口沿高光 2px Color8(196,172,132)/立面双段暗带 0.16+0.25 格边 α0.60·0.82/地面投影 0.22 格边三段渐隐 α0.28/悬崖 DEPTH_PX 8px board_world 同款);②色板:§4.1 小人蓝候选→定稿 #2E86DE(UiKit 同步)+§4.2 接触带微光色值 #D6ECFF 定稿+类型微光五组候选→定稿(v2 呈现 α170/带宽 cell÷8);③动画方案:§8.4 帧数规格候选档→冻结(待机 4/攻击 6/受击 2/死亡=灰化+程序化碎块弹飞 5 块 0.45s,序列帧归缺料清单);④数字形制:色牌形制定稿(#F5EAD3 直角小牌+Fusion Pixel+字号 max(18,ceil(格边×0.5))+墨三档)。产物命名带 v2(v1 被覆盖欠账清偿),报告迁 `design/research/`;连带=图例旗色封印黑漏网修正(#C63D22→#000000) |
|
|
||||||
- **v2.8(2026-09-25)可挖域接触带微光定稿批**(用户两拍板:①画法=接触带·空间侧——光画英雄格周界,正交邻墙=整边、斜向邻墙=角点+两半边;②色相=蓝族浅一档,顺路清偿旧 DIG_EDGE 绿相违 §4.2 绿禁则):§3.2 新增「可挖域接触带微光」条(画法/光只住空间一侧/角点不逐格归因、指认=悬停金框/呼吸与减动效守 §2.1/实现切换归表现批);§2.1 承载元素、§4.2 蓝条顺带;battle.md 注记顺带。背景=用户世界观口径「未开格=墙、已开格=挖出的空间」,微光=空间的灯光边界。
|
|
||||||
- **v2.7(2026-09-25)封印术语批**(用户拍板:Node2D 实现后「插旗」动作等价为**封印**——玩家对未开格插旗即对该格巢穴实施封印,旗 = 封印印记;机制键与规则全不变):§3.2 新增「旗(封印印记)」条——呈现语义/旗朱与栈位不变/封印特效(施印瞬间+印记常显形态)待表现批/现行占位 = 旗朱「旗」字形;§2.5 失败承载元素措辞顺带(插过的旗 = 封印印记)。**登记面**——registry terminology 新增「封印」词条、00-游戏概念 术语层级专名表随收;连带同步:battle.md 呈现注记、art-assets-checklist §4 演出类新增封印特效两件(施印特效+印记常显)、art-status-checklist P3 行、character-design.md §5.4 插旗条注记(主角即插旗者)。**关联面**——可挖域接触带微光方案(用户同日提出:微光画英雄格周界接触面,正交整边/斜向角点+两半边)评估可行,实现归表现批,未入本批。
|
|
||||||
- **v2.6(2026-09-25)世界观对齐扫描批(甲档回填 + 完美排雷钩子完成 + 引用锚内联;用户三拍板)**:①**§4.6.4 敌种甲档回填数据实态**——bugbear(ward→light)/ ogre_chief(heavy→light)/ drider(heavy→ward),并注记甲档事实源 = `enemy.tres` armor_type(2026-09-18 甲重配批后 L1 全轻甲、L2 除 drider 外全轻甲、L3 duergar/duergar_king 重甲);连带修订 character-design.md §5.5(熊地精轻甲化/食人魔弃金属甲板改裸身皮条/卓尔改魔法甲符纹)与 comfyui-prompts.md v2.8(熊地精/食人魔/卓尔三卡提示词随改)——食人魔视觉重设计经用户拍板「按最新设定,裸身+魔法甲符纹」。②**§2.2 完美排雷钩子完成**——「若…落实…待 GDD 定夺」改现行事实(零误标且至少标中一面旗→追加第二份清图兑付+结算高光行,地图战斗资源 GDD 已定稿)。③**引用锚内联**——§3/§4 尾注 P1–P4 支柱语义内联(概念期 brainstorm 编号,现行 GDD 树不单列),§1.4 两处 game-concept 编号引用改语义内联。扫描背景=用户发起的圣经×关卡/世界观对齐审计;变异六类型/格面九类/状态九键/奖励 19 键/敌种八键/三柜台钥石/三关色板方向经核对全部一致,零其余不符。
|
|
||||||
|
|
||||||
- **v2.5(2026-09-25)装饰变体纹理级修订批**(地形高墙瓦片批复审发现,见 `candidates/terrain-walls-2026-09-25/0-需求规格与验收闸.md` §八;用户裁定):§1.2 原则三与 §3.2 装饰变体条——例子「苔藓/裂纹/碎屑」改「裂纹/碎石斑等纹理级氛围层」(苔藓在三个现行关卡 dungeon/underdark/灰矮人矿城设定中不存在);新增约束——装饰变体一律为纹理级、禁物件级(巨石/小石堆等读作"格子里有个东西"的元素与"格子=内容舞台"冲突,会跟奖励/旗子抢读),数量保持最少(约 2 种),用途仅为破除大面积同砖平铺的重复感;随机分布/与危险格与安全格类型零相关/禁止构成可读线索等既有约束不动。§3.2 雷图棋盘呈现基准连带同步——「装饰小立牌=装饰变体的立体档」改「本作不采用立体小立牌档」。§1.4 样张清单「至少两种装饰变体」与约束一致,不动。
|
|
||||||
- **v2.4(2026-09-24)结构件完整性与参考核验纪律批**:新增 §8.5——①格面立体结构(顶面/缘件/角件/周界轮廓)必须来自素材本体绘制的结构件拼装,禁以调色/渐变/滤镜/跨格投影伪造缺失结构,样稿暴露缺件即停报「换素材/自产缺件」由用户裁决;②宣称「参考 X 游戏」前必须取得并像素级查看 X 截图证据并存档,仅凭文字/印象的断言无效;③图底分离由素材选型承载。立规动因=beast-cave 高墙批 G(渐变)/I(阴影)两稿以调色伪造结构、且参考 Necesse 未看截图,被用户两次纠偏返工。
|
|
||||||
- **v2.3(2026-09-24)棋盘小人方向集批**:§8.4 增方向集条款——4 向(下/上/侧,侧向左右镜像共用画稿)+斜向移动/挖掘按主导轴吸附最近正交向,不出 45° 斜向帧(用户拍板;镜像豁免「旗恒画右」纪律为代拟口径、样张批追认)。
|
|
||||||
- **v2.2（2026-09-24）效果图标纹样系统定稿批**：§4.6.1 九行纹样描述由用户逐键口述定稿（主体三轴白剑/白盾/白眼+右下角箭头语言绿↑红↓双绿↑，同族键共用同图）；旧语义锚文字退役。
|
|
||||||
- **v2.1(2026-09-23)停点前移批连带同步(批内代拍板②引用,worktree stoppoint-shift-20260923,状态记录 142)**:§6 开篇与 §7.2 结构行「双舞台四区」改「双舞台三区(B/C/D,字母保持不重编)」、扫雷图区锚点 1036×476→1036×504——战斗屏 A 区进度条随停点前移批退役(战后返回关卡画面,节点链进度由关卡画面选路覆盖层节点态承载),28px 纵向空间归 C/D 底行;裁决权与事实源归属 battle.md/HUD框架 不变,历次版本历史行不动。
|
|
||||||
- **v2.0(2026-09-23)UI 章迁入批 + 画布定档 + 色板方向裁定(用户对 v1.8 代拍板四项逐条表态+五缺口给口径;worktree art-ch69-amend-20260923,状态记录 138)**:①**§3.3/§4.4 物理迁入 §7**(用户拍板:UI 具体选择须在 UI 章定义,三/四章只留简单定义与方向指导——v1.8 代拍板①「按引用整合」据此推翻):§3.3/§4.4 降为方向指导节(各留一段+指路),细则全文迁 **§7.1 形状语法细则/§7.2 UI 色板细则**;§7 重排号 7.1–7.5(原 7.4 组件库语义并入 7.1,零内容损失);§6.2/§7.3/§7.5 与清单引用随改。②**§8.2 画布基准暂定值**(用户缺口一裁定):主角人设原图=48×72、主角战斗状态图(侧向)=48×72〔v1.9 待决注记「主角立绘档空缺」完成〕、棋盘小人=32×32 二头身独立派生资产(允许更小;36px 板占比摩擦沿「独立小源档」路线样张批定终值)、敌种立绘三档 48/64/96=普通怪(小)/精英(中)/Boss(大)对应关系经确认保留候选;旧「像素基准 32px」通用候选退役;1920 档缩放策略与帧数规格维持待裁决,登记 06-待办清单(表现与支撑/HUD框架节新条目),样张批时提醒。③**§6.3 三关色板方向**(用户裁定):underdark 幽暗地域=**冷调幽暗**(灰白蓝主调+少量紫黑点缀,紫系取紫罗兰域 ≈256° 候选、禁入带 300°–345° 不变)、deep_underdark 灰矮人矿城=**灰黑主调+矿脉金属色点缀**(金属质感族冷银/铜灰候选,奖励金亮金禁上格底 §4.2 不变)——替换 v1.8 苔绿/冷灰岩方向草案。④**§9.1 扩池候选否决**(Forager/杀戮尖塔不入池且撤登记——用户裁定美术参考意义不足;代拍板④完成)。⑤命名规范草案获确认(代拍板②完成)。清单 §0 像素行与风格宪法表指向顺带。
|
|
||||||
- **v1.9(2026-09-23)§8.2 待决注记批**(侧会话用户指令「你在这里直接把这件事给做了吧」;worktree art-s82-note-20260923,状态记录 137):§8.2 增两条待决注记——①**36px 板 × 32px 源摩擦**:32px 源在 45px 格 1× 占 ≈71% 合规、在 36px 格 1× 占 ≈89% 超「≤0.75 格边」红线且禁非整数缩放回退,出路二选一(棋盘小人独立更小源档如 24px 级 vs 两种板各出一版),样张批随格边长终值一并裁决,裁决前棋盘小人源图不排产;②**主角立绘档空缺**:主角 B 区站桩立绘未单独立档(现行 48/64/96px 阶梯按敌种 archetype 写),随战斗一屏样张锁「角色剪影方向/战斗空间」时一并定。头注「现行为」顺带 v1.9。
|
|
||||||
- **v1.8(2026-09-23)§6–9 四章补全批(D 框架 D1/D2/D4/D5 落地,圣经全章成文;worktree art-ch6-9-20260923,状态记录 136)**:**§6 环境与场景**——6.1 战斗舞台背景(明亮地窟/低对比自然后退/明度恒定适用/`wall_ambient` 联动/紫赤仅 Boss 战)、6.2 营地场景(烛光黄×木色/三柜台一字排开/亮起走饱和不动明度/系统语义归元进度 GDD)、6.3 三关图类型色板候选(dungeon 暖石棕基准档/underdark 苔绿偏灰/deep_underdark 冷灰岩,方向候选归样张批重跑 §1.4 冻结,增「与五组微光互辨」抽测)、6.4 下探过渡(渐变取下一关槽值,只动色相饱和);**§7 UI 设计**——7.1 视觉基准(§3.3/§4.4 上位法**按引用整合**,D5 框架「迁入」不物理迁移——保持形状/色彩两章完整性,物理迁移待用户另有裁决)、7.2 布局栅格(四区结构事实源归 battle.md+4px 步进档候选)、7.3 字体字号(Kenney CC0/Fusion Pixel OFL 候选+整数倍缩放+下限 18/14/13 事实源 HUD框架+禁字重区分)、7.4 组件库三类容器语义+极性冗余、7.5 营地界面;**§8 资产与技术规范**——8.1 两档定案+格边长口径(锚点 45/36px 事实源 battle.md,扩板与 1920 档换算归表现批)、8.2 像素基准 32px 候选(active.md 58 条挂账清偿入章)+整数倍缩放纪律+1920 档适配策略候选+画布档位候选、8.3 导出 PNG/SpriteFrames+命名规范候选草案(对象键=数据表主键,图标键契约的文件侧延伸)、8.4 帧数规格候选档;**§9 参考与反参考**——9.1 正面三款取/弃表+扩池候选(Forager/杀戮尖塔)仅登记不入池、9.2 反面四条绑条款(Darkest Dungeon 压暗/Gungeon 粒子色相爆炸/Hades 特效密度/传统扫雷八色),反面图证待素材生成。**同步面**——头注状态行/Sign-Off 注记/参考池行、art-assets-checklist §0 像素尺寸行与参考图行及 §6 依赖链、04-美术音频方向.md 参考指引顺带。**代拍板四项待追认**——①D5「迁入」按引用整合不物理迁移;②命名规范候选草案;③栅格/画布/帧数候选值系起草非裁决;④扩池候选两款不入池仅登记。
|
|
||||||
- **v1.7(2026-09-23)§5 抽离批 + 主角特征批**(用户两拍板:①角色设计自圣经 §5 抽离成独立文档 `character-design.md`,圣经 §5 改引用存根,小节号 §5.1–§5.6 不变、既有 §5.x 引用经存根可达;②主角特征改动——背后加扫雷联动旗、直剑换挖掘铲):§3.1 迁移注改指人物设计文档;主角两特征与三态措辞修订明细归 character-design.md 版本历史 v1.0,提示词执行侧归 comfyui-prompts.md v2.1。
|
|
||||||
- **v1.6(2026-09-22)§5 角色设计落地批(D 框架 D3)+ 提示词卡重生成**(用户拍板走正序:先补 §5 角色章,再重生成 comfyui-prompts.md;worktree art-char-s5-20260922):**新增 §5 角色设计**——§5.1 角色剪影与轮廓通道(自 §3.1 迁入:角色四类 archetype + 轮廓通道硬规则,「禁黑描边」顺带固化;道具点剪影留在 §3.1 并改题「道具点剪影」);§5.2 头身比与体量档位(2~3 头身两档、体量单调递增、像素画布归 §8 另批);§5.3 护甲类型视觉区分(候选方案待样张批冻结:通道 = 甲面覆盖率×甲材质色——轻甲裸、魔法护甲符纹饰带、重甲冷灰金属甲板;天然甲壳不计甲档;灰度按覆盖率三档可辨;清偿 §4.6.4 强度档位行挂起的待设计项);§5.4 主角三态规格(形象锚站姿样张/三态约束/小人蓝同族明暗/蓝族敌方禁入);§5.5 八敌种逐卡(键集随 registry,主色域物种本色豁免语义禁则、禁入带与蓝族两例外;兄弟精换色板不换形);§5.6 意图准备动画三档规格承载(自 2026-09-18 拍板与清单 §2.3 收编)。**引用随迁**——§4.5⑤/§4.6.4 两处 §3.1 改指 §5.1,§4.6.4 强度档位行改指 §5.3;art-assets-checklist §0/§2.2 引用与待设计项表述、战斗表现 §3.1 引用两处顺带。**comfyui-prompts.md 重生成 v2.0**(主角三态+八敌种逐资产自包含完整提示词——正向底座/主体/动作已拼妥、负向底座/增补已并妥,整段可直贴;继承 seed 纪律/禁入带/#F2F2F2 生成底色;主角蓝族随 v1.1 换装 #2E86DE;新增 duergar/hook_horror/duergar_king 三卡;护甲视觉短语按 §5.3 注入各卡;bugbear 主体改敦实圆肩守 §5.1 普通怪宽≥高;兄弟精变体配色弃冷蓝灰改灰褐战纹,避与小人蓝同屏混淆)。§6–9(D4/D5/D1/D2)仍待后续批。
|
|
||||||
|
|
||||||
- **v1.5(2026-09-22)中间产物引用解挂批**(用户裁决:修订指导与审计报告系中间产物不入库,工作区未跟踪留存;worktree midprod-unref-20260922):头注 D1–D5 框架引用改内联编号映射(明细归状态记录 125);本历史 v1.3 条目中的修订指导路径引用自此不再可达(历史文本如实保留);art-assets-checklist 两处「交接要点存审计报告」改指路状态记录 125。
|
|
||||||
- **v1.4(2026-09-22)gungeon 退场批**(用户拍板:gungeon 两张移出即可,暂不设反面案例——反面参考待素材生成后另批增补;worktree gungeon-exit-20260922):`references/gungeon_1/2.jpg` 删除;头注参考池行定稿三款×2 张,目录自此与点名池一一对应。
|
|
||||||
- **v1.3(2026-09-22)GDD 过期账清偿批 + 类型微光裁决**(用户四拍板:①未开格类型预读采纳彩色常显微光;②分辨率档位已定案两档 1280×800+1920×1080〔清单侧承载〕;③§5–9 按 D1–D5 框架分批补全,框架登记于 `art-docs-revision-guide-2026-09-22.md` 第 6 节;④两份美术清单合并以 art-assets-checklist 为底〔清单侧承载〕;worktree art-docs-settlement-20260922):**§4.6 契约表对齐数据实态**——§4.6.1 效果键七行→九行(ac_up/alert/empower/fortify 入表,defense_up/ambush 死键清除,sapped「待实施」旧注删除);§4.6.2 奖励徽章键整表重写为九型字典正负 18 行+清图槽 clear_blast(旧可选类三键/attack_up_basic/defense_up_basic/clear_knife 清除,「群伤 40」数值删除归配置事实源;gp 组键名按 reward.tres 勘误为 gp_coin/gp_lose);§4.6.4 敌种线索键整节重写(键集 {grub,ambusher}→八敌种现行键集,意图姿态改 2026-09-18 动画三档,Rule 8/伏击池/OQ7 退役表述清除);**微光改向**——§4.6.3 呈现约束由「墨族单色」单一通道改「角嵌纹样(形状)+类型常显微光(色彩)」双通道(R3 不泄危险格与安全格约束不变),§4.2 增「类型微光色带」分域条款与五组候选色相(芥末黄/黄绿/青/紫罗兰/绯红,避 300°–345° 禁入带与既有语义色段,样张批冻结),红/绿/紫赤/金条款加微光分域例外,§4.5⑨/§3.2 角嵌纹样条/§1.2 原则一/§1.4 样张清单与验收 2·4/§3.4 同步;**过期挂点清偿**——§3.2/§4.3 变异挂点落地(六类型定稿,纹带形按轴两分:伤害轴刺缺形/信息轴遮蔽形,同轴只做色板变体;样张批增岩浆橙红与危险红/旗朱互辨、信息轴遮蔽不入色牌占位区两项检查);§2.8 营地改三柜台+钥石(「天赋树」退役);**更名**——biome/board_biome/biome_tag 正文全量更名图类型(board_type),§4.3 标题顺带(键名事实源 = 棋盘生成 GDD 与 board_gen.tres);**结构收敛**——§1.3「对 brainstorm 视觉锚的修订记录」整节并入本版本历史(正文留号占位,状态记录 109 正文零历史纪律),头注压缩(状态行与 Sign-Off 并行),原则三与 §3.2 重复条款收敛(零信息纪律/结果清单单点成文)。gungeon 两张参考图去留待表态(T2)。
|
|
||||||
- **v1.2(2026-09-22)雷图棋盘呈现基准批**(用户拍板:雷图要有 ITB 参考图的战棋棋盘质感,但 45° 摆正成正俯视角——「摆正视角方格」读法):§3.2 增「雷图棋盘呈现基准」条——ITB 地表质感骨架(纹理多样/起伏体块/岛缘砖缘厚度/格上装饰立牌)× 相机正上方垂直向下、格线屏轴对齐、禁等距斜视与菱形格;砖缘厚度/岛缘立体面显式划为形体塑造、不触 §2 明度恒定(该规则禁的是状态/情绪明暗表达),顶面格底仍守 §4.1 参数域;装饰立牌 = 装饰变体立体档、零信息纪律不变;头部参考池行与资产清单样张要求顺带。**勘误**——v1.1 状态记录所记「参考池资产失配」判断有误:references/ 中 itb/moonlighter/peglin(点名池)+gungeon(未点名)四款×2 张一直在库,删除的十张系额外五款(CatQuest3/Dicey/Roundguard/Tangledeep/WonderBoy)退场,参考池本身无失配;gungeon 两张点名与否待用户表态。
|
|
||||||
- **v1.1(2026-09-22)视觉自由度修订批**(用户三拍板:①原则二改数字色牌方案;②已开后表达+零信息装饰变体;③只换主角蓝微调其余):原则二更名「明亮为皮,色牌为骨」——数字可读性改由数字色牌(素色直角小牌)承载,格底压素让路条款退役、饱和上限 0.40→0.55(候选),§1.2 优先级栈/§1.4 验收 1·2·4/§3.3/§3.4/§4.1 硬指标/§4.3 同步改查牌;原则三增格子多样化——已开格按当格结果整格表达(九类型物件纹样/纯安全格裸土/危险格巢穴更凶),未开格加零信息装饰变体(随机分布、禁逐轮重掷),未开格类型预读由小徽章升级为角嵌纹样(R3 不泄危险格与安全格约束不变),§3.2/§4.5⑨/§4.6 同步;主色板——小人蓝 `#2E6E8E`→`#2E86DE`、新增数字色牌 `#F5EAD3`(均候选值,样张批冻结终值),格面类型表五类→九类对齐(pierce/magic/action/gp)。§2 氛围层与明度恒定硬规则未动;§4.6 其余键表(效果 §4.6.1/奖励 §4.6.2/敌种 §4.6.4)数据过期账未清,另批处理;执行侧 ui_kit `HERO_BLUE` 等色值同步义务已登记,归样张批冻结后的表现批。
|
|
||||||
- **v1.0**(2026-09-10 初稿;2026-09-13 增补批——徽章栈位/危险格隐喻换轴/格子样张验收成文/图标键契约冻结;2026-09-15 去雾批)。
|
|
||||||
@@ -289,22 +289,3 @@ Seamless tileable pixel art texture of dry dirt ground, top-down, for a dungeon
|
|||||||
- **意图准备动画三档、战斗演出类**:动画序列帧,等一屏样张锁动画方案后另立规格卡。
|
- **意图准备动画三档、战斗演出类**:动画序列帧,等一屏样张锁动画方案后另立规格卡。
|
||||||
- **格面徽章 19 枚 / 关卡节点图图标 / 砖面终稿 / 地形变异纹带**:脚本管线,规格锚 art-bible §4.6(图标键契约)、§1.4(样张验收)与 §3.2,不需要生成提示词。
|
- **格面徽章 19 枚 / 关卡节点图图标 / 砖面终稿 / 地形变异纹带**:脚本管线,规格锚 art-bible §4.6(图标键契约)、§1.4(样张验收)与 §3.2,不需要生成提示词。
|
||||||
- **音乐音效**:清单已明确排除。
|
- **音乐音效**:清单已明确排除。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
- **v3.1(2026-10-06)渠道定位+拼表制主选批(用户拍板)**:①**渠道定位更正——远程对话式生图为主、本地 ComfyUI 为备选**(v2.7「彻底关闭」为当时口径,现行更正为备选;§0 使用流程随改);②**§4bis 纪律 3 改制**——地形瓦片出图 = 拼表制主选(三步流程:程序占位样图参考 → 整图生成 → 裁切+统一降采样;操作单 remote-gen-prompts §3),分张降为回退路径(裸拼表画框实证教训归因于缺参考锚定,非拼表制本身);③与 remote-gen-prompts 分工写明:本文件 = 词库正文、remote-gen = 对话操作单,正文不双处维护。
|
|
||||||
- **v3.0(2026-10-06)地形色值对齐批(审计 P1-1,用户拍板色值现行事实源 = 圣经 §4.1)**:§4bis 四张地形卡色值漂移修正——岩石系 `#8B755B`→**`#C9AF83`(掩尘/未开格)**、地面系 `#564232`→**`#B39A78`(裸土/已开格)**;remote-gen-prompts.md 2×2 拼图卡同批对齐。提示词侧色值自此以圣经 §4.1 为唯一事实源。
|
|
||||||
|
|
||||||
- **v2.9(2026-09-26)地形填充纹理节批**(高墙批收官,用户拍板):新增 §4bis——地形类首张卡(墙顶基面/裂纹/碎石斑/地面四张自包含英文卡)+对话式生图控制纪律四条(编辑模式/英文优先/分张跑/否定约束);分工纪律转写 art-bible §8.5「生产分工」(模型只出无缝填充纹理,结构件程序化)。
|
|
||||||
|
|
||||||
- **v2.8(2026-09-25)敌种甲档回填批**(圣经×关卡/世界观对齐扫描发现,规格上游 character-design.md v1.6 同批;用户拍板「按最新设定」):三卡随 `enemy.tres` 甲档实态修订——①熊地精 3.2 两版(A/B)正向:魔法甲「暖白符纹饰带」措辞退役,改轻甲「粗陋皮条+裸蓬毛无甲板」;②食人魔酋长 3.3:标题重甲→轻甲,正向「冷灰金属肩胸甲板」改「皮条骨饰+裸厚皮无甲板」,规格注随改;③蛛化卓尔精灵 3.5:标题重甲→魔法护甲,正向加「卓尔上体暖白秘法符纹饰带」(蛛腹几丁质保留、属天然甲壳),规格注随改。duergar/duergar_king 重甲卡与数据一致不动。
|
|
||||||
|
|
||||||
- **v2.7(2026-09-23)真像素硬化 + 本地通道清退批**(用户拍板:本地 ComfyUI 生图路线彻底关闭,生图一律线上 API 自跑;gg1 风格诊断后硬化方案顺带写入):①全部 13 张正向卡触发词后插入真像素约束段——`true pixel art game sprite / tiny 48x72 pixel canvas / chunky square pixels / strict pixel grid alignment / hard edges / no anti-aliasing / no gradients / limited 16-color palette / aseprite style`;②各卡负向底座并入平滑系禁词——`smooth lines / anti-aliasing / gradient shading / painterly / glossy / high detail / vector illustration`;③§0「现行管线」句(Z-Image-Turbo GGUF + 像素 LoRA + 母版工作流 `art-t2i-master.json`,成因见 v2.1/v2.5)改写为线上 API 口径,自然语言类模型改写指引顺带;④「ComfyUI 通道」措辞改「生图通道」(文件名沿用不改)。同日 repo 侧清退:`production/comfy/` 已删、comfy-mcp 注册已移除。
|
|
||||||
- **v2.6(2026-09-23)配装修订批**(用户四拍板:①弃全蓝——蓝只在兜帽,上衣暖米白、长裤深棕工装,与掩尘棋盘协调;②兜帽取下披肩、露棕色短发;③待机姿势改"铲插地+扶柄";④旗加大到比头大、插背包一侧、可被头部分遮挡):主角三卡正向提示词整体重写(形象锚措辞随改,2.2"斗篷飘动"改"兜帽布料飘动");线上 API 试生成由用户自跑,规格上游 character-design.md 同批升 v1.5。
|
|
||||||
- **v2.5(2026-09-23)触发词+肤色批**(用户三拍板:①LoRA 触发词 `Pixel art style.` **加入**——全部正向提示词(主角三卡+八敌种各卡)一律以触发词开头;②肤色改**白皙**(fair skin,弃小麦色),主角三卡随改;③提灯腰挂定案、棋盘小人定案归 character-design.md 同批 v1.4):§0 模型适配注由"待拍板"改"已加入";版本历史承接 v2.4。
|
|
||||||
- **v2.4(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):主角三卡正向提示词顺带插入 `brown fingerless gloves` 与 `leather knee pads with trouser legs rolled up above them`(皮革族小件,不占剪影预算);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.3。
|
|
||||||
- **v2.3(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋"改结构式帆布冒险背包,宽 ≈1.5× 体宽,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②护目镜推额前、头灯退役、灯改小号铜色提灯挂腰间(不点亮);③随身件=魔法道具形象候选池——铲/旗/背包/提灯,道具语义归魔法道具批):主角三卡正向提示词顺带更新(背包短语+护目镜+腰灯);§2 形象锚随改;规格上游 character-design.md §5.4 同批升 v1.2。
|
|
||||||
- **v2.2(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化):主角三卡正向提示词顺带更新(包裹短语 `large bulging tan canvas loot sack tied with rope on his back` + 旗改插于包裹顶);§2 形象锚随改(包裹、旗与铲三态恒在);规格上游 character-design.md §5.4 同批升 v1.1。
|
|
||||||
- **v2.1(2026-09-23)主角特征批**(用户两拍板:直剑→圆头挖掘铲——挖安全格动作语义角色化,攻击表现即挥铲;背后加旗朱三角旗——与棋盘插旗同物同色 `#C63D22`):主角三卡正向提示词顺带更新(铲+背旗短语,三态同旗同形象,背旗为主角唯一破对称件);§2 形象锚与 2.1/2.2 规格措辞随改(2.2"刀光"改"铲击光效");规格上游改指 character-design.md §5.4(人物设计自圣经 §5 抽离成独立文档,圣经 §5 为存根);§0 模型适配注补现行管线(Z-Image-Turbo GGUF + 像素 LoRA 已挂母版工作流,触发词 `Pixel art style.` 入正向待拍板)。
|
|
||||||
- **v2.0(2026-09-22)重生成批**(用户拍板正序:美术圣经 §5 角色设计落地(v1.6)后重写本卡;v1.0 于同日经裁决移除,状态记录 125):六敌种→**八敌种**(新增灰矮人/钩爪恐魔/灰矮人石君王三卡);**逐资产提示词改自包含完整串**(正向底座+主体+动作拼妥、负向底座+增补并妥,整段可直贴,零拼装);主角蓝族随 art-bible v1.1 换装(`#2E86DE`,同族候选 `#5FA8E8`/`#1C5CA4`);护甲视觉短语按 §5.3 注入各卡(轻甲无甲板/魔法护甲暖白符纹/重甲冷灰甲板,天然甲壳不计甲档);bugbear 主体由「高瘦」改「敦实圆肩」守 §5.1 普通怪宽≥高;兄弟精备选配色弃冷蓝灰(蓝族禁入敌方)改灰褐战纹;验收速查五关→六关(增甲档);引用基线改 art-assets-checklist 单清单(asset-checklist 已随合并批删除)。
|
|
||||||
- v1.0(2026-09-20):首版。主角三态 + 六敌种提示词卡成文;兄弟精改荐脚本换色通道;候选入库/后处理/转正五步流程成文。(2026-09-22 移除,本版为重生成。)
|
|
||||||
@@ -80,16 +80,3 @@
|
|||||||
- **终稿帧规格**(帧数/时长/结算节拍对齐)归圣经 §8 资产规范与战斗一屏样张批(清单 §2.3);占位符号(—/⚔/✦/蓄力)现行在役,动画到位后原位替换。
|
- **终稿帧规格**(帧数/时长/结算节拍对齐)归圣经 §8 资产规范与战斗一屏样张批(清单 §2.3);占位符号(—/⚔/✦/蓄力)现行在役,动画到位后原位替换。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
- **v1.9(2026-10-06)主角描边例外条款批(审计报告待决项 B 用户拍板)**:§5.1 新增**主角描边例外**条——主角四态硬描边 = 深褐 `(40,19,13)` 显式例外(浅砖面对比更高/主角更突出),敌人维持暖白族;系描边不一致的定性完成(不一致源自早期生成素材,按用户口径以约束条款认可为有意设计,素材不改);样张批终审复核义务登记 06 待办。
|
|
||||||
- **v1.8(2026-10-06)体量语义修订+立绘源档定档批(P0 完成讨论批;工作流程铁律 = 只动文档,代码实装另批走 PRD→迭代)**:①**§5.2 体量档位改「生物体型通道」**——原「强度先验·普通 < 精英 < Boss 单调递增」读法退役,依据 = 用户三体型约束(钩爪恐魔>灰矮人/灰矮人<熊地精/食人魔>熊地精,小体型精英与大体型普通怪并存);强度先验读法改由意图徽标(§5.6)与甲档(§5.3)承担;②**§5.5 新增立绘源档高注记**(八敌 36–94 定档、主角 48 不变、显示 ×2 整数档;圣经 §8.2 v3.7 同批)+**钩爪恐魔「宽≥高」豁免登记**(58 高窄条束状剪影,待样张批终审)。
|
|
||||||
- **v1.7(2026-09-28)人设旗脱钩批**(用户三拍板:①背包旗与棋盘封印色脱钩——封印色沿革〔旗朱 #C63D22→封印紫 2026-09-26→封印黑 2026-09-28〕仅作用于棋盘格封印旗,封印黑仅棋盘格,人设旗回归旗朱红 `#C63D22`;②旗形三角→矩形,以 normal/hit 定稿成图为基准;③兜帽=披肩式披于颈肩非垂背):§5.4 形象锚/背包旗条顺带。
|
|
||||||
- **v1.6(2026-09-25)甲档核对回填批**(圣经×关卡/世界观对齐扫描发现;用户拍板「按最新设定」:食人魔裸身、卓尔魔法甲符纹):§5.5 三行甲档回填 `enemy.tres` 数据实态(2026-09-18 甲重配批后未回填的过期账)——bugbear 魔法护甲→轻甲(粗陋皮条无甲板无符纹)、ogre_chief 重甲→轻甲(弃冷灰金属甲板,改甲面覆盖率≈0 的裸身皮条/骨饰)、drider 重甲→魔法护甲(加符纹饰带);§5.5 头注事实源措辞随改;提示词卡 v2.8 熊地精/食人魔/卓尔三卡顺带。giant_spider/hook_horror 的几丁质天然甲壳纪律不变(不计甲档,§5.3)。同日封印术语批:§5.4 插旗条附「插旗动作呈现名 = 封印」注记(详见 art-bible v2.7)。
|
|
||||||
- **v1.5(2026-09-23)配装修订批**(用户四拍板:①弃全蓝配色——蓝只保留在兜帽等明显处,上衣改暖米白、长裤改深棕工装,与掩尘棋盘协调;②兜帽不戴头上、取下披于肩上,露棕色短发与脸;③待机姿势改"铲插立地上、一手扶铲柄";④旗子加大到比头大、插在背包一侧,可被头部分遮挡):§5.4 形象锚/配色条/铲条/背包旗条/护目镜条顺带;提示词卡 v2.6 三卡顺带。线上 API 试生成渠道由用户自跑(本地 ComfyUI 通道同日停用)。
|
|
||||||
- **v1.4(2026-09-23)肤色+定案批**(用户四拍板:①肤色**白皙**(fair skin,弃小麦色);②LoRA 触发词 `Pixel art style.` 加入——执行侧提示词卡 v2.5 全卡正向以触发词开头;③提灯腰挂定案不手持(备选撤销);④棋盘小人定案 = 主角人设图压缩至二头身的简化版像素小人,随人设派生、同款装备剪影):§5.4 形象锚/腰灯条/棋盘小人条顺带。
|
|
||||||
- **v1.3(2026-09-23)衣着细节批**(用户拍板:半指手套 + 卷裤脚皮护膝):§5.4 形象锚顺带,新增衣着细节条(棕色半指手套/裤脚卷起+棕皮护膝,皮革木色族,不占剪影预算);提示词卡 v2.4 三卡顺带。
|
|
||||||
- **v1.2(2026-09-23)背包具形批 + 装备彩蛋池**(用户三拍板:①背包措辞与体量——弃"鼓胀掳获袋",改结构式帆布冒险背包(翻盖+皮扣带),宽 ≈1.5× 体宽两侧各露一点,正面参照合金弹头双主角大背包/奇诺比奥队长、反面禁特里式 3× 超宽;②头部饰品唯一化——护目镜推额前,头灯退役,灯改**小号铜色提灯挂腰间**(不点亮,备选另手持);③随身件=魔法道具形象候选池登记——铲/旗/背包/提灯四件,道具语义归魔法道具批):§5.4 形象锚/身份件条/三态①顺带,新增护目镜与腰灯条、候选池条。
|
|
||||||
- **v1.1(2026-09-23)掳获包裹批**(用户拍板:背旗改"背负大号鼓胀布包裹、旗杆插于包裹顶"——"地牢扫荡者满载而归"的角色化;包裹帆布暖卡其色+绳索捆扎):§5.4 形象锚/身份件条/三态①记账顺带,旗朱三条纪律不变(破例组改按"包裹+旗"整组)。
|
|
||||||
- **v1.0(2026-09-23)§5 抽离批 + 主角特征批**(用户两拍板:①人物设计自圣经 §5 抽离成独立文档、圣经留引用存根——人设高频改动免动圣经;②主角两特征改动——背后加扫雷联动旗帜、直剑换挖掘铲):§5.1–§5.3/§5.5/§5.6 自 art-bible v1.6 原文迁移(圣经内部节引用改注"圣经 §x"前缀,小节号不变);**§5.4 重写**——形象锚"直剑"改"圆头挖掘铲"(挖安全格动作语义角色化,攻击表现即挥铲),新增"旗朱背旗"(与棋盘插旗同物同色 `#C63D22`,主角唯一破对称件、旗面恒定画右、凹凸预算 +1),三态②"刀光"措辞改"铲击光效";新增生成顺序口径(先人设后状态图,侧背身状态卡按卡摘负向禁侧背条)与棋盘小人同旗开放项(归样张批)。执行侧 comfyui-prompts.md 主角三卡顺带更新(v2.1)。
|
|
||||||
@@ -95,6 +95,6 @@
|
|||||||
|
|
||||||
## 6. 流程纪律
|
## 6. 流程纪律
|
||||||
|
|
||||||
1. **大改动三段走**：设计稿/伪代码 → 用户审阅 → 实现；实现禁止先于审阅。修改记录落切片 README。
|
1. **大改动三段走**：设计稿/伪代码 → 用户审阅 → 实现；实现禁止先于审阅。改动明细只进 git 提交信息，README 与代码内不写修改记录（doc-conventions 第 5 节「禁写变更记录」）。
|
||||||
2. **实现批完成后的登记义务**：切片 README 写修改记录，06 条目按 doc-conventions §12.1 推进状态，批次过程与结论进 git 提交信息与 `reports/`（2026-10-18 用户裁：根目录会话状态文件已废除，禁止再在其中登记条目）。
|
2. **实现批完成后的登记义务**：06 条目按 doc-conventions §12.1 推进状态，批次过程与结论进 git 提交信息与 `reports/`（2026-10-18 用户裁：根目录会话状态文件已废除，禁止再在其中登记条目）。
|
||||||
3. **呈现层缺陷的教训回写 D1 GDD 设计输入**（信号载荷 schema / 场景级测试 / 时点状态可见性）。
|
3. **呈现层缺陷的教训回写 D1 GDD 设计输入**（信号载荷 schema / 场景级测试 / 时点状态可见性）。
|
||||||
@@ -66,7 +66,7 @@
|
|||||||
| 一系统一文档 | 不建 analysis 推演件；两三句能说清的"为什么"直接写进设计目的或规则正文 |
|
| 一系统一文档 | 不建 analysis 推演件；两三句能说清的"为什么"直接写进设计目的或规则正文 |
|
||||||
| 正文只写现行规则 | 禁删除线、"（作废）"、"（日期+拍板）"式注记；审计信息入对应文档附录 |
|
| 正文只写现行规则 | 禁删除线、"（作废）"、"（日期+拍板）"式注记；审计信息入对应文档附录 |
|
||||||
| 正文单点维护 | 一条规则句只写在定义它的那份文档（owner 文档）；其他文档要引用时写指针或语义概括，禁复制色值、尺寸、路径等可核对的具体值——上一句管不住数值之外的双写，本句补上。豁免面 = 执行侧文件必须带字面值才能工作时（生图提示词里的十六进制色、脚本参数），转写不算双写，但该文件头部必须写明"冲突时以 owner 文档为准" |
|
| 正文单点维护 | 一条规则句只写在定义它的那份文档（owner 文档）；其他文档要引用时写指针或语义概括，禁复制色值、尺寸、路径等可核对的具体值——上一句管不住数值之外的双写，本句补上。豁免面 = 执行侧文件必须带字面值才能工作时（生图提示词里的十六进制色、脚本参数），转写不算双写，但该文件头部必须写明"冲突时以 owner 文档为准" |
|
||||||
| 后置 ≠ 删除 | P1/P2 后置内容逐条列出；复活后置项 = 修订文档，禁静默加回 |
|
| 禁写变更记录 | 文档与代码文件内一律禁设「版本历史／修订记录／变更记录／修改记录／更新记录／更新日志」节或表格，禁逐版本叙述「改了哪些条款」；沿革与改动明细只进 git commit log。版本号可作为文档现行身份标记出现在文首状态行与正文引用中，但不得再挂变更表 || 后置 ≠ 删除 | P1/P2 后置内容逐条列出；复活后置项 = 修订文档，禁静默加回 |
|
||||||
|
|
||||||
**数值纪律**：正文定规则、取值域、单位；平衡值进 `data/tables/`，provisional 必须标注；已锁数值事实源 = `game/data/tables/*.tres`（现行值）与 owner 文档正文（规则、取值域、单位）。
|
**数值纪律**：正文定规则、取值域、单位；平衡值进 `data/tables/`，provisional 必须标注；已锁数值事实源 = `game/data/tables/*.tres`（现行值）与 owner 文档正文（规则、取值域、单位）。
|
||||||
|
|
||||||
@@ -93,7 +93,7 @@
|
|||||||
| `06-待办清单.md` | 流水线唯一登记处：条目=登记元数据标题＋四属性正文，状态随流水线段推进（格式与状态机见第 12.1 节）；各系统文档「待办」节只留指路存根 |
|
| `06-待办清单.md` | 流水线唯一登记处：条目=登记元数据标题＋四属性正文，状态随流水线段推进（格式与状态机见第 12.1 节）；各系统文档「待办」节只留指路存根 |
|
||||||
| `roadmap.md`（根目录） | 里程碑表＋迭代总表，一行一迭代，记录编排与实现进度（六列格式见第 12.2 节） |
|
| `roadmap.md`（根目录） | 里程碑表＋迭代总表，一行一迭代，记录编排与实现进度（六列格式见第 12.2 节） |
|
||||||
|
|
||||||
**系统文档骨架**（`systems/` 下统一采用）：文首引言（一句话定位+状态+旧版链接）／设计目的（2-4 句白话）／系统范围（负责/不负责两表）／在核心循环中的位置（字符画一行+两句白话）／核心规则（领域章节 ×2–6，每节一页纸）／依赖与输出（表格；引用纪律见 concept-conventions）／P0 最小闭环与 P1·P2 后置／调参表（取值域+provisional 标注）／验收标准（可验证判据）／待办（指路存根）／版本历史（表格）。
|
**系统文档骨架**（`systems/` 下统一采用）：文首引言（一句话定位+状态）／设计目的（2-4 句白话）／系统范围（负责/不负责两表）／在核心循环中的位置（字符画一行+两句白话）／核心规则（领域章节 ×2–6，每节一页纸）／依赖与输出（表格；引用纪律见 concept-conventions）／P0 最小闭环与 P1·P2 后置／调参表（取值域+provisional 标注）／验收标准（可验证判据）／待办（指路存根）。
|
||||||
|
|
||||||
**命名**：中文、见名知意；禁 a1_/b1_ 编号前缀；不留纯空目录。正文指代子系统一律用中文规范名；英文代号对照表见 `02-系统清单.md`，旧代号（a1–d6）仅限解读归档。
|
**命名**：中文、见名知意；禁 a1_/b1_ 编号前缀；不留纯空目录。正文指代子系统一律用中文规范名；英文代号对照表见 `02-系统清单.md`，旧代号（a1–d6）仅限解读归档。
|
||||||
|
|
||||||
|
|||||||
@@ -60,13 +60,3 @@
|
|||||||
注意：上表六件秘宝为旧目录，已全数退役、只作素材库（新现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录（重设计 v1）」节——新目录 15 件为代号制、正式命名归用户）；新目录正式命名定稿后本表同步。
|
注意：上表六件秘宝为旧目录，已全数退役、只作素材库（新现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录（重设计 v1）」节——新目录 15 件为代号制、正式命名归用户）；新目录正式命名定稿后本表同步。
|
||||||
|
|
||||||
另：元进度系统资源定名**钥石**——每一层关底 Boss 看守他那块区域的钥石，击杀即取走，用于在存档内解锁永久提升（属性 / 怪物遭遇 / 道具池）。2026-09-14 用户拍板，registry 术语登记随元进度设计批补登。
|
另：元进度系统资源定名**钥石**——每一层关底 Boss 看守他那块区域的钥石，击杀即取走，用于在存档内解锁永久提升（属性 / 怪物遭遇 / 道具池）。2026-09-14 用户拍板，registry 术语登记随元进度设计批补登。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立：一句话概念、目标受众、世界观命名、术语层级 |
|
|
||||||
| v1.1 | 2026-09-25 | 术语「封印」定稿（用户拍板）：插旗动作呈现名落术语表，出处条目 terminology |
|
|
||||||
| v1.2 | 2026-10-03 | R3 清账批（gdd_lint 分域随批）：术语表日期批注括注迁出至本表 v1.1 行；语义零变更 |
|
|
||||||
| v1.3 | 2026-10-09 | 文档正确性审查批：专名表下「部分秘宝效果待重定」注过期——六件旧目录秘宝已随目录重设计全数退役、只作素材库，注改写为退役指路（新现行事实源=秘宝.md「目录（重设计 v1）」节，registry 登记行随实装批迁移）；表格登记事实本体不动 |
|
|
||||||
| **v1.4** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「元进度资源定名钥石」→「元进度系统资源定名钥石」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -160,19 +160,3 @@
|
|||||||
**获取概率提升**是元进度/营地的合法提升轴（可提升=奇物高档位出现率/秘宝解锁进度/地图 T3/T4 权重），但**不动保底**——保底是承诺不是概率，禁止任何概率件改变 T3「每板必有回复」类承诺。
|
**获取概率提升**是元进度/营地的合法提升轴（可提升=奇物高档位出现率/秘宝解锁进度/地图 T3/T4 权重），但**不动保底**——保底是承诺不是概率，禁止任何概率件改变 T3「每板必有回复」类承诺。
|
||||||
|
|
||||||
**专长 rarity 语义约束**：Boss 三选一候选按档配比或加权抽取，使罕见度对出现率生效（字段双脱钩修复——此前 rarity 不影响抽选也不稳代表幅度）；具体配比归调参批。
|
**专长 rarity 语义约束**：Boss 三选一候选按档配比或加权抽取，使罕见度对出现率生效（字段双脱钩修复——此前 rarity 不影响抽选也不稳代表幅度）；具体配比归调参批。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立：一场战斗 / 一场冒险 / 死了之后三节 |
|
|
||||||
| v1.1 | 2026-09-18 | 「数值语言」节定稿（用户拍板：整数加减核、百分比仅三处既有粗档、全局 floor） |
|
|
||||||
| v1.2 | 2026-10-03 | R3 清账批（gdd_lint 分域随批）：节标题日期批注迁出至本表 v1.1 行；语义零变更 |
|
|
||||||
| v1.3 | 2026-10-07 | **生命周期轴（五档）节新立（道具重设计框架讨论用户裁决落文）**：五档定义（存档/冒险/关卡=预留档/节点=一次停点不按类型分档/回合）、节点链 DAG 前提（只向前·无环·只进一次）、一次性结算与持续态结算模型（跨层=转换非横跨，类A→类C）、总线与抽屉两类结算目标、道具定义卡 3+1 句、GP 与钥石两条平行独立资源；AP 两账/刷新两账/增益容器各归域内现行事实源（行动经济/秘宝/冒险结构/元进度同批落文） |
|
|
||||||
| v1.4 | 2026-10-07 | **道具三层职责与分界定稿（用户裁决——哈迪斯2 塔罗牌/祝福同构分界）**：新节落三句职责（秘宝=营地装配的角色机能件/奇物=冒险途中当局清零的增益/地图战斗资源=回合内获取并结算的格面兑付，地图层坐标经用户纠正——装板期生成、回合内获取与结算）+ 机能/机制/属性值判定尺 + 分层准入约束（新建秘宝必检：不出裸属性值、不改战斗结算机制；战斗机制改写只走专长）；现行秘宝目录机制向三件（淬毒刃纹/标中殉爆/惊巢反制）经用户点名与本约束不符，归留秘宝层重设计批处置，冻结期内维持现状 |
|
|
||||||
| v1.5 | 2026-10-07 | **跨层档位框架落文（用户裁——道具三层重设计）**：分界节新增「档位与获取规则」分节——稀有度四级统一=**普通/优秀/稀有/传说**（「优秀」=用户认可的「非普通」优化：无双否定、WoW 绿装先例、正面积木递进；DND 六级梯子中取四、跳档表意头奖级）；分层语义=秘宝档位越高解锁越苛刻/奇物越高概率越低/地图=概率位+保底上限；获取概率提升=元进度/营地合法轴但**不动保底**（保底=承诺非概率）；专长 rarity 语义约束=Boss 三选一按档配比或加权（字段双脱钩的文档面修复，配比归调参批） |
|
|
||||||
| v1.6 | 2026-10-07 | **同调位分档批（用户裁——道具三层重设计·秘宝层）**：档位与获取规则节秘宝行扩装配面——同调位分三档（普通格/优秀格/稀有格），槽位可装 ≤ 槽位档位的件（向下兼容不惩罚早解锁）；里程碑分档发槽（m1 普通格/m2 优秀格/m3 稀有格）；费用制落选留档（槽位仅 3 组合太小）；现行事实源落点=[秘宝](systems/跨局循环/秘宝.md)速览节同批 |
|
|
||||||
| v1.7 | 2026-10-10 | 分界尺措辞精确化（2026-10-10 用户澄清）：秘宝行「不出裸属性值」精确为「不出角色战斗属性值」+操作包络正向列举（经济与操作参数不在此限）——「属性值」定义行（生命/护甲/攻击/伤害）不变；机制零改动 |
|
|
||||||
| v1.8 | 2026-10-11 | 文档一致性修复批（定时检查呈报项）：「生命周期轴（五档）」节补五档嵌套字符画（R5 实指——lint 报错因工具 prev/cur 错位误记到「死了之后」节名下，工具已同批修正）；「死了之后」节顺带补死亡与重开循环字符画（内容补强）；版本历史同号冲突顺延——2026-10-10 分界尺措辞行 v1.5→v1.7（R10）；v1.6 行秘宝链接改指跨局循环新位（死链修复） |
|
|
||||||
| v1.9 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 6 处——「若干行动点」改指路行动经济／删「模板 C 骨架+模板 A 成长语言」无出处括注／DAG 首现补全称有向无环图／buff 换代增益 3 处／「不得改变」改「禁止」／「对标哈迪斯」改「参照」；版本历史行序修复（v1.7 行归位 v1.6 后）。句式句长不动（STC 文体豁免） |
|
|
||||||
| **v1.10** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：新立「系统资源」节（原「两条独立资源」）：成员带寿命档标注＋总线/抽屉两坐标，保留「GP 与钥石平行独立、不立统一上位概念」原裁论断，显式排除增益容器；总线/抽屉/一次性结算/五档表/各域指针节同步换代；旧称「账／账本」「独立资源」「系统数值」全库退役——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -118,43 +118,3 @@
|
|||||||
> 2026-10-05 消歧更名批注记（用户拍板）：`AUXILIARY_ITEMS` 的中文规范名「魔法道具」→「**秘宝**」（理由与代码不同步的欠债登记见[秘宝](systems/跨局循环/秘宝.md) v0.9 版本行）。英文代号**继续沿用 `AUXILIARY_ITEMS` 不变**——代码标识符与工具链口径不动，对齐另批。
|
> 2026-10-05 消歧更名批注记（用户拍板）：`AUXILIARY_ITEMS` 的中文规范名「魔法道具」→「**秘宝**」（理由与代码不同步的欠债登记见[秘宝](systems/跨局循环/秘宝.md) v0.9 版本行）。英文代号**继续沿用 `AUXILIARY_ITEMS` 不变**——代码标识符与工具链口径不动，对齐另批。
|
||||||
|
|
||||||
> 四个循环本身的英文代号为 `MINESWEEPER_CYCLE`（排雷循环）、`COMBAT_CYCLE`（战斗循环）、`ADVENTURE_CYCLE`（冒险循环）、`PRESENTATION_SUPPORT`（表现与支撑）。
|
> 四个循环本身的英文代号为 `MINESWEEPER_CYCLE`（排雷循环）、`COMBAT_CYCLE`（战斗循环）、`ADVENTURE_CYCLE`（冒险循环）、`PRESENTATION_SUPPORT`（表现与支撑）。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| v0.1 | 2026-09-15 | 根索引随新骨架建立：循环 × 子系统总表 + 子系统命名对照表 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：`地形变异.md` 概要行去掉"雾格已从设计中移除"的迁移期注记（移除事实以[不做清单](05-不做清单.md)为单一出处）。文档树形状不变 |
|
|
||||||
| v0.3 | 2026-09-16 | 更名批（用户拍板 2026-09-16）：两个系统中文规范名更名——"奖励道具经济"→"地图战斗资源"、"辅助道具"→"魔法道具"；循环表文件行与命名对照表中文规范名同步（文件重命名 地图战斗资源.md / 魔法道具.md）；英文代号暂沿用更名前名称，对齐另批 |
|
|
||||||
| v0.4 | 2026-09-16 | 格面资源批 UI 欠账收口（2026-09-15 格面资源批删除可选类道具后，本索引与 UX 文档的随批修订）：`地图战斗资源.md` 概要行由"奖励产出、道具库存与使用窗口"（格面资源批前旧描述）改为与其 GDD 头部一致的一句话口径"格面资源的产出、极性字典与清图奖励封装"；同批收口 battle.md / HUD框架.md 中随可选类道具删除而失义的道具窗口条款（文档本体修订见各文版本历史） |
|
|
||||||
| v0.5 | 2026-09-16 | 待拍板收编批：新建顶层文档 `06-待拍板清单.md`，把 systems/ 各系统文档「待拍板」章节的条目与三份文档的散落未定项统一收编；各系统文档「待拍板」节改为指路存根，其后新增条目直接登记清单 |
|
|
||||||
| v0.6 | 2026-09-16 | 06 清单改版（用户拍板）：「待拍板」术语全仓改「待办」，顶层文档更名 `06-待办清单.md`；本表 06 行同步，各系统文档存根节随批由「待拍板」改名「待办」（各文版本历史不另记存根改名） |
|
|
||||||
| v0.7 | 2026-09-17 | 关卡节点地图定稿批：`关卡节点地图.md` 状态行改**已定稿**（v1.0——分支节点图形态重开〔用户拍板重开 05 清单路径分支后置裁定〕、四类节点封闭枚举、全节点确认选路、遭遇构成编排面三条、节点奖励=功能道具正式渠道；概要行"节点链"改"节点图"；配套 05 清单移除路径分支条目、06 清单三悬案收口 + 两条新增、registry level_table 与术语回填） |
|
|
||||||
| v0.8 | 2026-09-21 | 元进度实现批：`元进度.md` 状态列「范围草案·待设计」→「已定稿·已实现」（2026-09-21 实现批落地，数值 provisional 归设计批标定） |
|
|
||||||
| v0.9 | 2026-09-27 | UX 文档欠账处置批：`ux/` 目录入索引（battle.md / interaction-patterns.md / 新建 level-clear.md）；四项欠账处置——player-journey 不建、accessibility-requirements 不另立（改指 HUD框架 基线 + 设置与本地化）、node-reward 挂魔法道具内容重定批（06 登记）、level-clear 建档 |
|
|
||||||
| v1.0 | 2026-09-27 | 节点图生成立项批（用户拍板立项——06 条目「关卡内结构随机生成」随批改状态）：`systems/冒险循环/` 新建 `关卡节点图生成.md` 设计草案 v0.1（图模板/模板池/抽签三概念、三级台阶路线、MC 测量对账条款、五拍板点）；文档树补行 + 命名对照表补 `NODE_MAP_GENERATION` 行 |
|
|
||||||
| v1.1 | 2026-09-27 | 关卡画面 UX spec 建档（关卡画面 UX 批）：`ux/` 表补 `level-map.md` 行——选路枢纽三停点布局、GP 常驻徽章、交互映射与 AC 成文，三项设计提案挂 06 待拍板 |
|
|
||||||
| v1.2 | 2026-10-03 | R3 清账批（gdd_lint 分域随批）：四处状态单元格日期批注迁出——敌人系统行事件见敌人系统.md 版本历史 v0.5（技能池批）；元进度行见本表 v0.8；camp/shop 行=两文 v1.0 落文（2026-09-30 三裁决执行批）；语义零变更 |
|
|
||||||
| v1.3 | 2026-10-05 | **消歧更名批（用户拍板 2026-10-05）**：a5 行中文规范名「魔法道具」→「**秘宝**」，文档树文件名同步（systems/排雷循环/魔法道具.md → 秘宝.md）；英文代号 `AUXILIARY_ITEMS` 沿用不变（代码标识符不同步属已知欠债，另批）；旧代号列不变（a5 仍指 2026-09-14 归档快照）。更名理由为「魔法」一词已被本作征用为敌方侧伤害/护甲语汇（`魔法矢`/`魔法族`/`魔法护甲`），详见[秘宝](systems/跨局循环/秘宝.md) v0.9。历史定稿文档（research/qa/archive）原样保留 |
|
|
||||||
| v1.4 | 2026-10-05 | 立《特性》：一次冒险内角色自身得到的提升——此前按内部分类被叫成三个名字（规则类称"流派件"、属性类称"数值件"、界面称"本关强化"），现收敛为一个对象的两种形态枚举；文档树冒险循环补行 + 命名对照表补 `ADVENTURE_FEATURE` 行 |
|
|
||||||
| v1.5 | 2026-10-05 | 《特性》v1.1 分类重构：两类由"规则改写型 / 属性加成型"改为"属性提升（ASI）/ 专长（Feat）"，属性提升内部再分纯属性组与特殊组；获取途径由两口共用池改为三条分工渠道（专长走特定节点、属性提升走奖励节点与商店）＋罕见旁路"专长获取" |
|
|
||||||
| v1.6 | 2026-10-05 | 《特性》改名为《奖励》并升 v2.0：顶层概念改为"一次冒险内各渠道给予玩家的增益总称"，边界判据由"自身提升 vs 持有物"改为生命周期（当局清零的是奖励，跨局带走的是魔法道具）；分类由两类扩为三个枚举（专长 / 属性值提升 / 资源与机会类），并新增分类 × 渠道交叉开关表——两根轴互不决定。文档树冒险循环行改名 + 命名对照表 `ADVENTURE_FEATURE` → `ADVENTURE_REWARD` |
|
|
||||||
| v1.7 | 2026-10-05 | 《奖励》v2.1 交叉表收口：Boss 渠道只出专长（终局 Boss 不给），另两类在此不出现；新增「计价物不自售」规则处理金币不进商店——不拆第四个分类、不开特例，而是两轴交叉处的一条约束 |
|
|
||||||
| v1.8 | 2026-10-05 | 《奖励》v2.2：专长在非 Boss 渠道改为「专长获取」凭证形式（不直接给专长）；渠道约束重构为三层（分类白名单／可计算谓词／显式例外清单），并承认「计价物不自售」形式上是白名单外的一道过滤、与死特判的区别在可计算；立默认原则——除已登记规则外分类内的都要在池子里，据此回复应在商店内（现行货架缺它，须补） |
|
|
||||||
| v1.9 | 2026-10-05 | 《奖励》改名为《奇物》并升 v2.4：顶层定名 Wondrous Item（DND 魔法物品九分类中的兜底杂类，官方中文译名「奇物」）。文档树冒险循环行改名；命名对照表 `ADVENTURE_REWARD` → `ADVENTURE_CURIO`（**不用 `reward_*`**——`reward_pick` 流 / `reward_node` context / `reward_preview` kind 已占用该词族） |
|
|
||||||
| v1.10 | 2026-10-05 | 《奇物》v2.5：第三类定名「资源」（资源偏泛，故在命名出处节写死判据句——给的是可消耗或可重掷的余量，不是属性永久抬升）；回复归属定案留在本类不拆第四类；修复 1.5 段末与渠道轴标题粘连 |
|
|
||||||
| v1.11 | 2026-10-05 | 《奇物》v2.7 三个子节点正式定名：专长（Feat）/ 属性值提升（ASI）/ 资源——去「类」字后缀，此前是描述式叫法不是专名；新增 1.6 节「三层结构与命名」，定玩家可见的三层（奇物 / 三个分类 / 具体单件），并明确命名与呈现是两件事 |
|
|
||||||
| v1.12 | 2026-10-06 | 生涯设计立项批（迭代 17 卡④，纯文档）：新建 `systems/跨局循环/生涯.md` 设计提纲 v0.1（信息架构 / 承载内容清单 / 与既有界面关系 / 分期实装建议 / 待裁点五节；状态=范围草案待评审——P0-P5 已裁结论落文，新发现待裁点 P6 营地最近冒险条带去留）。文档树跨局循环补行 + 命名对照表补 `CAREER` 行（无代码实现面，代号随实装批对齐） |
|
|
||||||
| v1.13 | 2026-10-07 | 道具三层职责分界批随批（用户裁——规则现行事实源=[核心循环](01-核心循环.md)「道具三层职责与分界」节 v1.4）：秘宝行概要由「扫雷侧秘宝（显影、探测类）」（同调形态起已滞后）换代为「营地装配、整局冒险生效的角色机能件」；状态列随去迁移注记 |
|
|
||||||
| v1.14 | 2026-10-07 | 奇物层重设计落地随批（现行事实源=[奇物](systems/冒险循环/奇物.md)版本历史 v2.9-v3.4——专长体系推倒重建+资源转换源+池结构案D+跨层档位框架）：奇物行概要与状态同步——概要补「专长=触发器句式的机制件/资源=转换源凭证」，状态改「已实现·2026-10-07 专长体系重设计落地（18 件基础框架+池结构案D）」 |
|
|
||||||
| v1.15 | 2026-10-09 | 旧档引用摘除批（用户令——旧版 GDD 归档 design/archive/gdd-2026-09-14/ 已删，全部指涉摘除）：「旧代号」句不再指涉归档路径（仅解读 2026-09-14 之前历史记录）；旧骨架索引参考行整行摘除。语义零变更 |
|
|
||||||
| v1.16 | 2026-10-09 | 文档正确性审查批（ux 表五行在役态对齐）：node-reward 行「v1.0·切片期过渡形态随同调实施批退役改写」过期——退役改写已兑现，改 v2.5 令牌池在役口径；level-map 行「占位升格版·视觉终稿后置」过期——改定稿版（独立屏+样张 v1 冻结）；shop 行「三商品卡全陈列」过期——pool 模式在役，改令牌级货架+v1.1；camp/settlement-summary 行版本号顺延 v1.1/v1.2。文件清单一轮只读核对零死链 |
|
|
||||||
| v1.17 | 2026-10-09 | B1 裁决落文（用户令——天赋树独立成文）：跨局循环区补 `天赋树.md` 行（系统随迭代 12 实装在役，文档 v0.1 补写——机制以代码实态与迭代 12 落地裁决为据）；命名对照表本批不动（代码标识符面 meta_tree 在役，代号登记另批） |
|
|
||||||
| v1.19 | 2026-10-10 | **系统目录归位批（用户发现结构问题）**：`秘宝.md` 自排雷循环区迁入跨局循环区——生命周期裁定=解锁（秘宝匣+解锁条件表）/装配（营地柜台）/存档持久全在跨局侧，排雷循环仅生效现场；成因=前身「辅助道具」系切片期掉落形态故旧置排雷循环，同调换代未随迁。文档树两区换行+系统总表行移区+命名对照表不动（代号 AUXILIARY_ITEMS/旧代号 a5 不变）；全仓引用路径 33 处随批同步（版本历史与注记行内的历史路径按纪律保留） | 武器锻造成文批（用户令「完成文档编写、代码不实现、记录待办」）：跨局循环区补 `武器锻造.md` 行（v0.1 设计定案待实装——按 2026-10-07 提案推荐案落文，17 裁点开放在册待逐点裁决）；系统总表补行（无代码实现面，代号随实装批对齐） |
|
|
||||||
| v1.20 | 2026-10-11 | **术语表建立+全库术语统一批（用户令「专用术语表查表阅读」+危险格/整图/专长凭证三更名）**：顶层文档表补 `术语表.md` 行（v1.0——四节术语+退役词对照）；同批全库更名=雷格/惩罚格→危险格、板级→整图、门票→专长凭证（清扫 7 文件约 270 处；排雷玩法定义句换代、秘宝.md v2.5 可读性批随批） |
|
|
||||||
| v1.21 | 2026-10-11 | 文档一致性修复批（定时检查呈报项）：顶层文档表术语表行多余版本列摘除（R6 列数一致）；奇物/天赋树/武器锻造三行状态格修订注记改写为现行事实白话句并换代版本号（天赋树 v0.4 换代定稿 29 节点、武器锻造 v0.2），日期批注归本表版本历史承载（R3） |
|
|
||||||
| v1.24 | 2026-10-12 | **迭代 20 反哺落文批·奇物行换代（用户裁④确认）**：奇物行状态格「基础框架 27 件，自爆流与生存件扩容后」→「迭代 20 专长实装批落地（29 行=基础 27+迁入 2，流派机制退役；池结构案D 四级 104，通关兑付=专长三选一按档配比加权）」 |
|
|
||||||
| v1.22 | 2026-10-11 | 锻造工坊更名批随迁：`武器锻造.md` 改名 `锻造工坊.md`（系统更名，用户令），顶层文档表行与系统总表行随名换代并顺延版本注（v0.3）；版本历史行内旧名按历史记载保留 |
|
|
||||||
| v1.23 | 2026-10-11 | 锻造工坊 A 组定案随迁：锻造工坊行版本注换代 v0.4（A 组三裁+攻防所有权切分〔树脊柱砍攻/护两线，树侧 29→21 归天赋树会话交接批〕+钥匙无前置+2c/5a 结案） |
|
|
||||||
| v1.25 | 2026-10-12 | **锻造工坊 B 组定案随迁（用户逐点裁决）**：锻造工坊行版本注换代 v0.5、描述格随裁换代——两区定名（武器锻造区/护甲锻造区）、三甲型统一命名「魔法护甲」、一次冒险各选一件、**满级特效本期不做留扩展位**；**17 裁点清零**（推翻推荐案四行 2a/3b/6/8a，撤回呈报子问 4a-1），开工门裁点侧已满足、仅剩用户发令；设计文档「裁决结果清单」+「工作间内容清单」两节为实装批需求卡片输入 |
|
|
||||||
| v1.26 | 2026-10-13 | **Alpha 版本标准立文（用户令「先定里程碑内容」）**：顶层文档表补 `08-Alpha版本标准.md` 行——Alpha 版本包含哪些东西的清单，即里程碑 M3 的完成标准；只列条目不写内容，定义一律指路各权威文档。本文只管「有什么」，系统与内容的定义权仍归各自权威文档，本表不复制其内容 |
|
|
||||||
| v1.27 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 2 处（关卡节点图生成行「拍板点全落文」→「拍板点全部已写入」；battle.md 行「Complete·随批修订」→「Complete·顺带修订」）＋失同步修复 1 处（顶层文档表 08 行「已定稿 v1.0」→「已定稿 v1.4」，对齐 08 篇现行定稿版本） |
|
|
||||||
| **v1.28** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：奇物行「资源=转换源凭证」→「补给=给系统资源加一笔的转换源」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -69,22 +69,3 @@ MVP 不加新状态；扩容走 `status_effects.tres` 加行 + [增益状态](sy
|
|||||||
- 战后自动回复——回复只有道具与恢复点两个来源
|
- 战后自动回复——回复只有道具与恢复点两个来源
|
||||||
- 新敌种、新棋盘档位、更高密度、同深度多敌种混搭
|
- 新敌种、新棋盘档位、更高密度、同深度多敌种混搭
|
||||||
- 秘宝清单之外的新件、状态表之外的新状态
|
- 秘宝清单之外的新件、状态表之外的新状态
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 顶层六文档成文：关卡 / 敌人 / 棋盘 / 战斗道具 / 辅助道具 / 状态六项体量 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：棋盘、辅助道具、暂不做三处去掉"雾格已移除 / 不依赖雾格"的迁移期注记，改指[不做清单](05-不做清单.md)。体量数字不变 |
|
|
||||||
| v0.3 | 2026-09-17 | 数值纪律收口批：全文改指路化体例——种数/行数/幅度不再抄配置，事实源改 data/tables/*.tres 与 registry；同步三批次失同步（两关落地/可选类删除/数值压缩） |
|
|
||||||
| v0.4 | 2026-09-20 | 层名改名批：第一层「苔藓回廊」→「裂颚洞窟」（用户拍板——苔藓意象与地精巢穴不契合；新名致敬 DND 5e《凡戴尔的失落矿坑》地精部族「裂颚」Cragmaw，洞窟纵深连通幽暗地域）。关卡表 display_name / registry / 00-游戏概念 / 切片首页按钮 / README 随批同步 |
|
|
||||||
| v0.5 | 2026-09-20 | 层名二改批：「裂颚洞窟」→「地精洞窟」（用户拍板——不绑定 DND 专名部族、规避 IP 指涉，直取地精巢穴意象；v0.4 出典随之作废仅留档）。全仓 8 处消费面随批同步 |
|
|
||||||
| v0.6 | 2026-09-20 | **第三关内容批（灰矮人矿城——与切片代码 / registry / 难度曲线与Boss / 棋盘生成 / 地形变异 同批）**：层名表加第三层（测试直入口已落地、正式序列推进待收尾——正式三关序列推进仍登记 Alpha 验收条件）；棋盘尺寸条款由两档改按关配置（第三关 13×13 / Boss 14×14 随批铺行）；棋盘节地形变异句随批补第三关一对（落石/矿尘）；暂不做「更多关卡」行更新为已按扩展批流程落地。行值读 `data/tables/level.tres` / `board_gen.tres` / `variation.tres`（registry 为准） |
|
|
||||||
| v0.7 | 2026-09-20 | **GP+商店房批（与切片代码 / registry / 关卡节点地图 / 冒险结构 / 战斗结算 / 地图战斗资源 / 难度曲线与Boss 同批）**：格面资源池"八型 × 正负两向（十六格）"→"九型 × 正负两向（十八格）"（+gp 金币）；新增「商店」小节一行——shop.tres 读表纪律（商品三行 / 掉落参数 / 价格参数，全部 provisional 归曲线调参批）；一句话定位句补"一套商店配置" |
|
|
||||||
| v0.8 | 2026-09-21 | **冒险结构实现批（与切片代码 / registry / 冒险结构 同批）**：层名表 L2/L3 状态行改「正式序列已生效」——首页「开始冒险」三关连探落地（AdventureRunner 编排；测试直入口保留）；「更多关卡」行同步；正文零历史叙述纪律下仅状态口径更新，结构框架零改动 |
|
|
||||||
| v0.9 | 2026-09-21 | **元进度实现批（与切片代码 / registry / 元进度 / 02 / 05 同批）**：「暂不做」节移除「元进度与跨局成长」行——跨局成长首批落地（营地三柜台 / 钥石账本 / 跨局注入，数值 provisional 归元进度设计批标定）；新增「一套元进度配置」小节（meta.tres 四行族读表纪律，数值 provisional 归设计批） |
|
|
||||||
| v1.0 | 2026-10-03 | R3 清账批（gdd_lint 分域随批）：五处日期批注括注迁出——体例说明=本表 v0.3 事件；十八格=本表 v0.7 事件；正式序列=本表 v0.8 事件；三处用户拍板事件随行入账：显影尘/地穴全图卷效果定位归 Alpha 且原 06 待办条目移除（2026-09-20 拍板）、单关测试直入口退役且唯一试玩入口=完整冒险（2026-09-23 拍板）、反制道具与全局作用域排 Alpha（2026-09-20 拍板）；语义零变更 |
|
|
||||||
| v1.1 | 2026-10-09 | 文档正确性审查批：扫雷秘宝节过期订正——「registry 登记六件封闭清单（数据表未建）、其余四件定义有效」滞后于秘宝目录重设计（旧目录已全数退役、只作素材库），改写为目录（重设计 v1）15 件代号制+旧行删除归实装批；同调件数据表 treasure_items.tres 在役补记 |
|
|
||||||
| v1.2 | 2026-10-10 | 元进度配置段柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）：「道具工坊阈值六行」改「秘宝匣阈值六行」。体量数字零改动 |
|
|
||||||
| v1.3 | 2026-10-11 | 文档一致性修复批（定时检查呈报项）：扫雷秘宝节目录计数换代 15 件→12 件（普通 7/优秀 3/稀有 2——回能器删除、换装券撤消、第四只手删除三轮修正在本文件的漏网面，秘宝.md v2.7-v2.9 已载）；该段超长拆两段（R1） |
|
|
||||||
| **v1.4** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「GP 钱包账本归冒险结构」→「GP 归冒险结构」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -13,10 +13,3 @@
|
|||||||
**音频方向未定稿**：MVP 阶段用占位音效即可，正式音乐与音效等核心循环验证后再定。
|
**音频方向未定稿**：MVP 阶段用占位音效即可，正式音乐与音效等核心循环验证后再定。
|
||||||
|
|
||||||
美术细则（色板、形状语言、图标契约、验收标准）见 `design/art/art-bible.md`（含参考与反参考，见其 §9）。
|
美术细则（色板、形状语言、图标契约、验收标准）见 `design/art/art-bible.md`（含参考与反参考，见其 §9）。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立：风格一句话、三条关键词、参考游戏、音频方向占位 |
|
|
||||||
| v1.1 | 2026-10-03 | gdd_lint 分域批：补版本历史节（R4）；本文体系裁散文体，R2 表格占比分域豁免 |
|
|
||||||
@@ -23,14 +23,3 @@
|
|||||||
- **反雪球机制**：MVP 不做。等 Alpha 拿到真实测试数据，再决定要不要治滚雪球、怎么治。
|
- **反雪球机制**：MVP 不做。等 Alpha 拿到真实测试数据，再决定要不要治滚雪球、怎么治。
|
||||||
- **正式音频、教学引导、战斗动画演出、设置与本地化**：MVP 内的打磨项，一律排后。先验证核心循环，再谈好听好看。
|
- **正式音频、教学引导、战斗动画演出、设置与本地化**：MVP 内的打磨项，一律排后。先验证核心循环，再谈好听好看。
|
||||||
- **连刷 / 换图资金跨战斗携带**：现行规则是每场战斗清零，防滚雪球。是否解禁连刷策略，等实测数据说话。
|
- **连刷 / 换图资金跨战斗携带**：现行规则是每场战斗清零，防滚雪球。是否解禁连刷策略，等实测数据说话。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-14 | 初版随 GDD 骨架建立：确定不做 / 现阶段不做两节 |
|
|
||||||
| v1.1 | 2026-09-21 | 元进度实现批：元进度行注首批已落地（营地三柜台 / 钥石账本 / 跨局注入），数值 provisional 归设计批标定 |
|
|
||||||
| v1.2 | 2026-10-03 | R3 清账批（gdd_lint 分域随批）：元进度行日期批注迁出至本表 v1.1 行；语义零变更 |
|
|
||||||
| v1.3 | 2026-10-03 | 道具替代推理边界锚复核（迭代 11 第①批同调实施批——需求卡片 §十连带）：「允许恢复推理原料，不允许道具替代推理」边界锚**原样保留即通过**——同调目录九件逐件对表：真视/预读类=信息给付（探巢摆钟 3×3 窄域护栏承重），六被动=机制修正（禁裸 flat schema 强制），无一替代推理判定本体；复核零改动 |
|
|
||||||
| v1.4 | 2026-10-07 | 道具三层重设计·地图层身份裁决（案甲，用户裁）：第 14 条收窄——「未开格显示奖励身份」改「未开格预读危险格与安全格」，未开格类型微光（读类型不读危险格与安全格）移出禁止面；呈现现行事实源=HUD框架「未开格类型微光」节（定义与色带已定稿），实施归微光批；推理本体保护不变 |
|
|
||||||
| **v1.5** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「中间资源折算」→「中间系统资源折算」；「钥石账本」→「钥石」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
+3
-25
@@ -100,7 +100,7 @@
|
|||||||
|
|
||||||
**局后随手记**（一句话即可，事后对日志）：每局大概掉了多少血 / 有没有整轮一点血没掉的轮次 / 通关与否 / 有没有"这局特别顺/特别倒霉"的体感（种子体感核对用）。
|
**局后随手记**（一句话即可，事后对日志）：每局大概掉了多少血 / 有没有整轮一点血没掉的轮次 / 通关与否 / 有没有"这局特别顺/特别倒霉"的体感（种子体感核对用）。
|
||||||
|
|
||||||
**结果回流**：日志取数 → 真人修正系数 k（真人整关承伤中位 ÷ 模拟完美档中位；**正常预期 k>0.5、预警线 k<0.3**——2026-10-03 用户裁）并入 T19 标定报告（落 design/research/，换代 2026-09-19 判读报告为现行锚）；①–⑤ 体感按各条目的回流位分流。
|
**结果回流**：日志取数 → 真人修正系数 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 直伤、两三连雷应明显肉疼；若仍无痛感=回调信号，记一句话即可；
|
1. **踩雷疼痛感**（本批主刀）：「踩很多雷还是轻松活」应是过去式——单雷 6-8 直伤、两三连雷应明显肉疼；若仍无痛感=回调信号，记一句话即可；
|
||||||
@@ -162,7 +162,7 @@
|
|||||||
### ⑮ 秘宝词族换词全 UI 面目检 + 渲染像素闸补跑（2026-10-05 秘宝代码词族对齐批顺带登记——迭代15③号卡）
|
### ⑮ 秘宝词族换词全 UI 面目检 + 渲染像素闸补跑（2026-10-05 秘宝代码词族对齐批顺带登记——迭代15③号卡）
|
||||||
|
|
||||||
- **实机目检（「秘宝」字样全 UI 面，约 3 分钟）**：①C 区槽位标题应显示「秘宝」（原「魔法道具」，hero_info_panel_view 槽位组）；②空槽悬停提示应显示「秘宝槽（空）」；③战斗总结三选一叙述行应显示「秘宝 / …」或「秘宝 / 随机获得一件」（原「魔法道具」开头）；④换关 toast 应显示「上关剩余 N 件秘宝已随关卡结束清空」。**红灯信号**：任何界面残留「魔法道具」字样。〔**✅ 真人目检半已核销（2026-10-14）**：用户实机目检回报完成，未呈报残留（qa 收尾批）〕
|
- **实机目检（「秘宝」字样全 UI 面，约 3 分钟）**：①C 区槽位标题应显示「秘宝」（原「魔法道具」，hero_info_panel_view 槽位组）；②空槽悬停提示应显示「秘宝槽（空）」；③战斗总结三选一叙述行应显示「秘宝 / …」或「秘宝 / 随机获得一件」（原「魔法道具」开头）；④换关 toast 应显示「上关剩余 N 件秘宝已随关卡结束清空」。**红灯信号**：任何界面残留「魔法道具」字样。〔**✅ 真人目检半已核销（2026-10-14）**：用户实机目检回报完成，未呈报残留（qa 收尾批）〕
|
||||||
- **渲染像素类闸补跑挂账**：本批屏蔽五件（golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot——组 A 文案变更使像素断言合法失效，按 goal 令弃断）；**补跑时点=迭代 14 全入库后的表现批周期闸一次性补跑**，与本批无独立补跑义务；届时若 golden 基线因文案换代失效，按换代流程重锚而非当缺陷修。**分工注记（2026-10-05 ui-struct-probe 批）**：结构类断言（互压/等宽/出屏）已由 `ui_struct_probe` 入轻闸默认必跑段（tools/probe_gate.sh），与像素五闸互补不替代——五闸补跑义务不变。**核销注记（2026-10-08 迭代 19 卡①自动化验收补齐批——机器补跑半顺带核销）**：五件机器半全部归宿已入库并实测绿——shot_probe（扩屏七屏+shot_checker A-D 断言）/board_shot（L1-L3 取证+golden 逐像素 0.00%×3）/golden_compare 三件入 render_gate（窗口化自动闸），fx_probe 入 probe_gate --full（headless 逻辑层断言），ui_layout_probe 补 1280/1920 两档最小断言（首跑 PASS）；五闸归宿见本句上列逐件注记（原对账卡已按「吸收即死」退役，git 历史可考）。**真人目检半（上方「秘宝」字样全 UI 面 3 分钟）仍归用户，不注销**。
|
- **渲染像素类闸补跑挂账**：本批屏蔽五件（golden_compare / shot_probe / fx_probe / ui_layout_probe / board_shot——组 A 文案变更使像素断言合法失效，按 goal 令弃断）；**补跑时点=迭代 14 全入库后的表现批周期闸一次性补跑**，与本批无独立补跑义务；届时若 golden 基线因文案换代失效，按换代流程重锚而非当缺陷修。**分工注记（2026-10-05 ui-struct-probe 批）**：结构类断言（互压/等宽/出屏）已由 `ui_struct_probe` 入轻闸默认必跑段（tools/probe_gate.sh），与像素五闸互补不替代——五闸补跑义务不变。**核销注记（2026-10-08 迭代 19 卡①自动化验收补齐批——机器补跑半顺带核销）**：五件机器半全部归宿已入库并实测绿——shot_probe（扩屏七屏+shot_checker A-D 断言）/board_shot（L1-L3 取证+golden 逐像素 0.00%×3）/golden_compare 三件入 render_gate（窗口化自动闸），fx_probe 入 probe_gate --full（headless 逻辑层断言），ui_layout_probe 补 1280/1920 两档最小断言（首跑 PASS）；五闸归宿对账见需求卡片-自动化验收补齐批 §一。**真人目检半（上方「秘宝」字样全 UI 面 3 分钟）仍归用户，不注销**。
|
||||||
|
|
||||||
### ⑯ UI 结构批复验（2026-10-05 ui-struct-probe mini-loop 顺带登记——标题屏双列修复+按钮宽度纪律，约 2 分钟）
|
### ⑯ UI 结构批复验（2026-10-05 ui-struct-probe mini-loop 顺带登记——标题屏双列修复+按钮宽度纪律，约 2 分钟）
|
||||||
|
|
||||||
@@ -261,28 +261,6 @@
|
|||||||
|
|
||||||
**后续内容批义务（2026-10-06 敌人表行集多行批 P3 丙二裁挂单）**：首个混编遭遇行投放（连同 Boss 多行内容，敌种候选与坐标由内容批裁）——投时 MC 取证先报批（数值验证场景二档起）、难度带读数义务随投登记、首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）、Boss 多行投放时 Boss 名取首行显示/Boss 遭遇骰逐行区间骰〔每行各掷自己区间——2026-10-07 卡① Q8 逐行骰换代，旧「读首行区间」口径消解〕/半血解锁/独占技/难度带六面读数逐项过。——**已编入 roadmap 迭代 18 卡⑤混编遭遇首批投放批（2026-10-06 用户令；读数义务维持顺带登记，MC 取证跑批顺延 Alpha 收官 M4 数值批统一执行〔未排期，届时另令——数值统一调整殿后〕）。进展：首批已于 2026-10-07 落表（(2,5) 双行，目检与读数义务见 ⑱）；剩余面 = Boss 多行第二批（六面读数随投逐项过）**
|
**后续内容批义务（2026-10-06 敌人表行集多行批 P3 丙二裁挂单）**：首个混编遭遇行投放（连同 Boss 多行内容，敌种候选与坐标由内容批裁）——投时 MC 取证先报批（数值验证场景二档起）、难度带读数义务随投登记、首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）、Boss 多行投放时 Boss 名取首行显示/Boss 遭遇骰逐行区间骰〔每行各掷自己区间——2026-10-07 卡① Q8 逐行骰换代，旧「读首行区间」口径消解〕/半血解锁/独占技/难度带六面读数逐项过。——**已编入 roadmap 迭代 18 卡⑤混编遭遇首批投放批（2026-10-06 用户令；读数义务维持顺带登记，MC 取证跑批顺延 Alpha 收官 M4 数值批统一执行〔未排期，届时另令——数值统一调整殿后〕）。进展：首批已于 2026-10-07 落表（(2,5) 双行，目检与读数义务见 ⑱）；剩余面 = Boss 多行第二批（六面读数随投逐项过）**
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| 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 数值批需求卡片，未排期态不变） |
|
|
||||||
| v0.5 | 2026-10-10 | 生涯页呈现行柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）：「道具工坊已解锁 X/6 件」改「秘宝匣已解锁 X/6 件」；计数语义（旧六件→新目录）随实装批换代，见 06「天赋树结构重构批」改名连带面 |
|
|
||||||
| v0.6 | 2026-10-12 | 新增 ㉒ 锻造工坊工作间形态与购买交互目检节（迭代 23 锻造工坊实装批随批登记——V13 人闸观测项：门与形态/购买/解锁双通道/选中与锁死/注入抽查） |
|
|
||||||
| v0.7 | 2026-10-13 | 新增 ㉓ 敌人表内容修批三观测目检节（迭代 24 卡①随批登记：新招可见性/甲型体感/第一关节奏——登记不阻塞按 2026-10-12 真人检测立规） |
|
|
||||||
| v0.8 | 2026-10-13 | 新增 ㉔ UI 全局主题批全屏巡检目检节（迭代 25 卡①随批登记：引擎默认灰清零巡检/音量滑轨两段可辨/专项观察点二（滑轨柄抢焦点·滚动条槽可见性）/预盖件无实役注记——登记不阻塞；能力验证半=冒烟 V1-V6） |
|
|
||||||
| v0.9 | 2026-10-14 | 新增 ㉕ UI 交互与观感批逐屏巡检目检节（迭代 26 卡①随批登记：按钮五态反馈/键盘焦点环/全局 Nearest 巡检（含暗角与渐变白名单判据）/布局均衡（商店居中+营地四栏等高）/诊断钮清零——登记不阻塞；能力验证半=冒烟 V1-V6+T4 结构断言） |
|
|
||||||
| v1.0 | 2026-10-14 | **qa 收尾批·人闸核销（用户 2026-10-14 回报实机目检全部完成）**：⑮真人半、⑳、㉑、㉒、㉓、㉔、㉕ 七节逐节加「✅ 已核销（2026-10-14）」注记——用户目检回报完成、未呈报问题；iter19 acceptance-package 存活八项与 iter20 五件（行为变化速览节）同批核销；迭代 18 清单 18 项同批核销。注：⑯⑰⑱⑲ 等早期人闸节此前已随各批核销或归 07 独立跟踪，本条不涉及 |
|
|
||||||
| v1.1 | 2026-10-14 | 新增 ㉖ 代码架构技术债修复批全流程走查目检节（迭代 27 卡①随批登记：全流程观感零变化走查/续玩断点恢复/调试浮窗对局中可开不锁棋盘〔:407-408 事故回归〕/刷新余量显示一致/DS_DEBUG 启动浮窗+两屏角标——登记不阻塞；能力验证半=冒烟 V1-V9+parity 三变体逐位一致对拍五跑全同） |
|
|
||||||
| v1.2 | 2026-10-15 | **冲突标记清理解（迭代 28 随批）**——本文件 v1.0/v1.1 两行处残留 `<<<<<<<`/`=======`/`>>>>>>>` 合并冲突标记（迭代 27 分支 iter27-techdebt-20261014 合并进 master 时漏解，两侧均有效故全留：qa 收尾批人闸核销行 + ㉖ 目检节登记行与正文节）；清理后两行内容照旧，仅版本号顺延。同批新增 ㉗ 启动态菜单目检节（迭代 28 卡①随批登记） |
|
|
||||||
| v1.3 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 35 处（随批→顺带 25、收口→完成/合并进 master 5、台账→状态记录 1、销号→注销 2、报错→返回错误 1、对拍→与基线数据逐项比对 1；均系正文现役文本，版本历史既有行按豁免不动）＋失同步修复 0 处 |
|
|
||||||
| v1.4 | 2026-10-17 | ㉖① 机检承接注记（迭代 29 GDD 反哺点经用户逐条裁决写入）：屏壳切换正确性已由 `screen_flow_probe` 机检承接（入轻闸必跑段）；该项**保留不注销**——承载机器抓不到的观感半（演出时序/文案/布局逐屏零漂移） |
|
|
||||||
| v1.5 | 2026-10-17 | 新增 ㉘ 未开格类型徽章批类型微光实机目检节（迭代 30 卡①随批登记：五组一眼可分/微光不遮数字〔环不外溢〕/出圈灭入圈复亮/整屏不脏/群伤暗档 #A61D37 观感〔provisional，读数归样张批复核〕——登记不阻塞；能力验证半=双帧 glow 作用集 2/4/4·outside=0＋golden off 帧 0.10–0.14%＋探针 case⑰＋单测五段 51 检查） |
|
|
||||||
| v1.6 | 2026-10-20 | 死链清偿：㉑ 节「五闸归宿对账见需求卡片-自动化验收补齐批 §一」指路句删除——该卡早已按 doc-conventions §11「吸收即死」退役，五件归宿由本句上列逐件注记自持。同批十一张失归属卡片退役，roadmap 卡片列改「已退役（git 历史可考）」 |
|
|
||||||
|
|
||||||
|
|
||||||
## ㉖ 代码架构技术债修复批——全流程走查（迭代 27 卡①顺带登记；能力验证半=冒烟 V1-V9+parity 三变体逐位一致、与基线数据逐项比对五跑全同）
|
## ㉖ 代码架构技术债修复批——全流程走查（迭代 27 卡①顺带登记；能力验证半=冒烟 V1-V9+parity 三变体逐位一致、与基线数据逐项比对五跑全同）
|
||||||
|
|
||||||
> 场景拆分+会话物化+战斗域重构+账本完成+模态协议内聚后，玩家可见面唯一验收=观感零变化。登记不阻塞（2026-10-12 真人检测立规）。
|
> 场景拆分+会话物化+战斗域重构+账本完成+模态协议内聚后，玩家可见面唯一验收=观感零变化。登记不阻塞（2026-10-12 真人检测立规）。
|
||||||
@@ -315,7 +293,7 @@
|
|||||||
|
|
||||||
## ㉘ 未开格类型徽章批——类型微光实机目检（迭代 30 卡①顺带登记；能力验证半=双帧 glow 作用集取证 2/4/4·outside=0＋golden off 帧 0.10–0.14%＋探针 case⑰＋单测五段 51 检查）
|
## ㉘ 未开格类型徽章批——类型微光实机目检（迭代 30 卡①顺带登记；能力验证半=双帧 glow 作用集取证 2/4/4·outside=0＋golden off 帧 0.10–0.14%＋探针 case⑰＋单测五段 51 检查）
|
||||||
|
|
||||||
> 类型微光实装（默认开、组合根布尔可切）后，玩家可见面=棋盘格内五组类型微光。机检只能证明「作用集正确/开帧一致/关帧逐位一致」，真机上「五组分不分得清、看着脏不脏」仍需人眼。**群伤组明度档为 provisional 值**（art-bible 版本历史 v3.15 登记），观感复核归战斗一屏样张批（迭代 30 卡②）——本节第 5 项读数作该复核的输入。登记不阻塞（2026-10-12 真人检测立规）。
|
> 类型微光实装（默认开、组合根布尔可切）后，玩家可见面=棋盘格内五组类型微光。机检只能证明「作用集正确/开帧一致/关帧逐位一致」，真机上「五组分不分得清、看着脏不脏」仍需人眼。**群伤组明度档为 provisional 值**（art-bible v3.15 登记，明细见其 git 提交史），观感复核归战斗一屏样张批（迭代 30 卡②）——本节第 5 项读数作该复核的输入。登记不阻塞（2026-10-12 真人检测立规）。
|
||||||
|
|
||||||
| # | 目检项 | 判据 |
|
| # | 目检项 | 判据 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。
|
> **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。
|
||||||
> **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。
|
> **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。
|
||||||
> **状态**：**已定稿（v1.10）**——2026-10-13 用户令定稿（v1.0），同日升版 v1.1（界面美化八条）与 v1.2（敌种池行注摘除）；v1.3/v1.4 为迭代 25/26 完成回填；v1.5 简明技术中文用语规范批；v1.6 状态刷新批（锻造工坊在役回填 + 数值统一标定按 2026-10-09 里程碑立规结案归 Beta）；v1.7 状态刷新批（立绘方向随 2026-10-14 用户裁结案 + 样张/棋盘观感编入迭代 30 注记 + 贫矿脉屏蔽注记）；v1.8 playnote 二轮对照批（状态面板行名随改名批换代 + 瘦身义务入册〔2026-10-16 用户令〕）；v1.9 未开格类型微光实装回填（迭代 30 卡①，反哺点回写用户令授权）；v1.10 混编遭遇第二批裁挂 Beta（2026-10-18 用户令，未决项六行减五行）。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决，并记入文末版本历史。
|
> **状态**：**已定稿（v1.10）**——2026-10-13 用户令定稿，此后十次升版的明细见 git 提交史。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决。
|
||||||
> **成文**：2026-10-13。
|
> **成文**：2026-10-13。
|
||||||
|
|
||||||
## 本文怎么用
|
## 本文怎么用
|
||||||
@@ -89,8 +89,8 @@
|
|||||||
| 商店配置 | `shop.tres` | 在役 |
|
| 商店配置 | `shop.tres` | 在役 |
|
||||||
| 元进度配置 | `meta.tres` | 在役 |
|
| 元进度配置 | `meta.tres` | 在役 |
|
||||||
| 天赋树节点集 | `meta_tree.tres` | 在役 |
|
| 天赋树节点集 | `meta_tree.tres` | 在役 |
|
||||||
| 锻造工坊路线行族 | `forge.tres` | 在役（定价 provisional 归 M4；表名订正与入库依据见版本历史 v1.6） |
|
| 锻造工坊路线行族 | `forge.tres` | 在役（定价 provisional 归 M4；表名订正与入库依据见 git 提交史） |
|
||||||
| 混编遭遇行集 | `enemy.tres` | 在役（首批；第二批移挂 Beta，裁决与明细见版本历史 v1.10） |
|
| 混编遭遇行集 | `enemy.tres` | 在役（首批；第二批移挂 Beta，裁决与明细见 git 提交史） |
|
||||||
| 第四关 | —— | 待裁 |
|
| 第四关 | —— | 待裁 |
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -101,7 +101,7 @@
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 主菜单 | —— | 在役 |
|
| 主菜单 | —— | 在役 |
|
||||||
| 开始覆盖层 | —— | 在役 |
|
| 开始覆盖层 | —— | 在役 |
|
||||||
| 营地（天赋树 / 锻造工坊 / 秘宝匣 / 图鉴） | [camp](ux/camp.md) | 在役（锻造柜台占位面板注已解除，见版本历史 v1.6；柜台贴图占位归「五 · 表现」UI 贴图重构批行） |
|
| 营地（天赋树 / 锻造工坊 / 秘宝匣 / 图鉴） | [camp](ux/camp.md) | 在役（锻造柜台占位面板注已解除；柜台贴图占位归「五 · 表现」UI 贴图重构批行） |
|
||||||
| 生涯页 | [生涯](systems/跨局循环/生涯.md) | 在役（期一） |
|
| 生涯页 | [生涯](systems/跨局循环/生涯.md) | 在役（期一） |
|
||||||
| 关卡地图屏 | [level-map](ux/level-map.md) | 在役 |
|
| 关卡地图屏 | [level-map](ux/level-map.md) | 在役 |
|
||||||
| 战斗屏 | [battle](ux/battle.md) | 在役 |
|
| 战斗屏 | [battle](ux/battle.md) | 在役 |
|
||||||
@@ -142,7 +142,7 @@
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 像素美术风格与色板 | [美术圣经](../art/art-bible.md) | 在役 |
|
| 像素美术风格与色板 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||||
| 棋盘瓦片与格面资源图标 | [美术圣经](../art/art-bible.md) | 在役 |
|
| 棋盘瓦片与格面资源图标 | [美术圣经](../art/art-bible.md) | 在役 |
|
||||||
| 未开格类型微光（五组色相＋明度档） | [HUD框架](systems/表现与支撑/HUD框架.md) | 在役（明度档 provisional 值登记见 art-bible 版本历史，复核转正归战斗一屏样张） |
|
| 未开格类型微光（五组色相＋明度档） | [HUD框架](systems/表现与支撑/HUD框架.md) | 在役（明度档 provisional 值登记见 art-bible 的 git 提交史，复核转正归战斗一屏样张） |
|
||||||
| 棋盘观感（第二 / 三关亮度与对比度） | [06-待办清单](06-待办清单.md) | 待做（2026-10-16 用户令编入迭代 30，序位③） |
|
| 棋盘观感（第二 / 三关亮度与对比度） | [06-待办清单](06-待办清单.md) | 待做（2026-10-16 用户令编入迭代 30，序位③） |
|
||||||
| 立绘清晰度回退评估（是否改用高清图） | [角色设计](../art/character-design.md) | 待做（评估已结——2026-10-14 用户裁维持像素风、升级精细手绘像素、不回退高清图，裁决录=[美术审计-cursor会话存档](../research/美术审计-cursor会话存档-2026-10-14.md) §2.2；余=立绘按新口径重产＋大小比例子题用户复核） |
|
| 立绘清晰度回退评估（是否改用高清图） | [角色设计](../art/character-design.md) | 待做（评估已结——2026-10-14 用户裁维持像素风、升级精细手绘像素、不回退高清图，裁决录=[美术审计-cursor会话存档](../research/美术审计-cursor会话存档-2026-10-14.md) §2.2；余=立绘按新口径重产＋大小比例子题用户复核） |
|
||||||
| 敌人立绘（全敌种） | [角色设计](../art/character-design.md) | 在役 |
|
| 敌人立绘（全敌种） | [角色设计](../art/character-design.md) | 在役 |
|
||||||
@@ -209,23 +209,3 @@
|
|||||||
| 5 | 素材升档重产进不进 Alpha | 五 · 表现 |
|
| 5 | 素材升档重产进不进 Alpha | 五 · 表现 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-10-13 | 首版成文：立 Alpha 版本的内容清单（系统 / 内容量 / 界面 / 工程与质量 / 表现五节 + 不含清单 + 未决项十项）。本文只列条目不写内容，定义一律指路各权威文档 |
|
|
||||||
| v0.2 | 2026-10-13 | **playnote 五条想法的归属裁定随批**（用户逐条裁）：①「关卡节点图展示优化」经用户定性为**重构**（可选节点太少）→ 冒险循环表新增「关卡节点图重构（增加可选节点）」行，标**待做（须先做文档设计，不可直接开发）**，同步登记 06 待办；②「第二 / 三关棋盘亮度对比度」→ 表现表新增「棋盘观感」行，标待做（用户确认标准里已覆盖，此行是把它显式化）；③「立绘改回高清图」→ 表现表新增「立绘清晰度回退评估」行，标待裁（与现行像素风定档存在方向冲突，入未决项）；④「战斗节点地图类型差异化（更多地图主题）」→ 用户裁**排 Beta**，移入「六 · Alpha 不含」节。未决项十项增为十一项 |
|
|
||||||
| v0.3 | 2026-10-13 | **五条全部登记 06 待办并标注阶段归属（用户令）**：P1 关卡节点图重构标「Alpha 阶段需完成 · 设计讨论先行」；P2 棋盘观感标「Alpha 阶段需完成 · 开工前过素材轴/UI 轴定性人闸」；P3 第一关遭遇表数值异常标「Alpha 阶段需完成 · 修复方式待裁（甲即时修/乙归 M4/丙先排查）」，本表敌种池行随带待修注；P4 立绘清晰度回退评估标「Alpha 阶段需完成 · 方向待裁」，拆出已兑现的大小比例子问题与未决的回退高清子问题；P5 战斗节点地图类型差异化标「Beta 阶段，Alpha 不做」 |
|
|
||||||
| v1.0 | 2026-10-13 | **定稿（用户令）**：① **与游戏内容无关的三项移出 Alpha**——音频 / 教学引导（含教学引导面）/ 多语言本地化一律排 Beta，自「一 · 表现与支撑」「三 · 界面」「五 · 表现」三表摘除，移入「六 · Alpha 不含」并单列为一组；判据 = 缺了照样能联调、能通关，属打磨层；② 未决项十一项减为**八项**（删音频 / 教学引导 / 本地化三条，余项重编号）；③ 文首加状态行 = **已定稿**，Alpha 内容范围自此冻结，增删须经用户裁决并记版本历史 |
|
|
||||||
| v1.1 | 2026-10-13 | **界面美化三层诊断入 Alpha 标准（用户令）**：用户同日提出界面美化需求并要求先作现状分析，随后下令「把分析出的三层全部作为独立待办事项登记、且一律列为 Alpha 阶段必须完成」。据此新增八行——「三 · 界面」表两行（UI 全局主题资源、UI 按钮状态矩阵），「五 · 表现」表六行（全局纹理过滤、UI 贴图重构批、UI 字体补完、战斗一屏样张、UI 氛围层与九宫格切片观感修、UI 元素细节修）。八行的登记事实源统一为 [06-待办清单](06-待办清单.md) 同批新增的八条专条；其中「UI 贴图重构批」「UI 字体补完」「战斗一屏样张」三条原先只登记在美术侧的资产清单与素材状态清单里，本次转立本清单以免两处各写一份内容。用户同时指定**先动第一层**，即主题资源 / 按钮状态矩阵 / 全局纹理过滤三项（均属纯工程补齐、不依赖美术素材）。本次改动未触碰既有的未决项八项与「六 · Alpha 不含」清单 |
|
|
||||||
| v1.2 | 2026-10-13 | **敌种池行注摘除（迭代 24 卡①机械面随批）**：「二 · 内容量」敌种池行的「第一关遭遇表数值待修」注摘除——该异常已随迭代 24 N1 修复（(1,2) 降档 hp 22/ac 2，06 对应条已销号），本行回归「在役」净态；条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.3 | 2026-10-13 | **UI 全局主题批收口回填（迭代 25 卡①机械面随批）**：「三 · 界面」表「UI 全局主题资源（引擎原生控件接管皮肤）」行 待做→在役（主题资源已入库：game/assets/theme/main_theme.tres 挂 project.godot gui/theme/custom，06 对应条销号）；「五 · 表现」表「UI 元素细节修」行状态注记①销号（滑轨两段难辨已随主题批重配＝已填充段 BG_ROOT 对暖石 ≈5.5:1，余②③④保留）。「五 · 表现」表余零改动——逐行核对六条 06 指向行中仅「UI 元素细节修」事实变化，其余（棋盘观感/站桩帧动画/素材升档重产/全局纹理过滤/UI 氛围层）本批零触碰；条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.4 | 2026-10-14 | **UI 交互与观感批收口回填（迭代 26 卡①机械面随批）**：「三 · 界面」表「UI 按钮状态矩阵」行 待做→在役（五态矩阵补齐）；「五 · 表现」表三行——「全局纹理过滤设为邻近采样」待做→在役、「UI 氛围层与九宫格切片观感修」待做→部分在役（光柱半已修，九宫格半未结注明）、「UI 元素细节修」待做（余②③④）→在役（②③④全落地）；06 对应四条销号或改写+反哺点四条新条登记（待用户裁决另批落文）；条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.5 | 2026-10-15 | 简明技术中文用语规范（用户令）：文头状态行换代 v1.2→v1.4（v1.3/v1.4 两批漏更）；「现状」取值枚举三种改四种（补「部分在役」定义，与「五 · 表现」九宫格切片行既有状态对齐）。条目集合零增删，未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.6 | 2026-10-16 | **状态刷新批（用户令）**：① 「一 · 跨局循环」锻造工坊行 待做→在役（实装批 2026-10-12 入库，06 载明；满级特效按裁 6 留扩展位不影响判定）；② 「二 · 内容量」锻造路线行族事实源订正 `meta_forge.tres`→`forge.tres` 并转在役；③ 「三 · 界面」营地行锻造柜台注 占位面板→工作间实形态（目检 07 ㉒ 已核销；柜台贴图占位归表现表贴图批行）——以上三行为 v1.0 定稿时失实残留；④ 「四 · 工程与质量」数值统一标定行撤销（待裁→归「六 · Alpha 不含」，依据=2026-10-09 里程碑立规 M4=Beta 且用户 2026-10-16 重申），未决项八项减为七项重编号；⑤ 文头状态行 v1.4→v1.6（v1.5 漏更）。除④外条目集合零增删 |
|
|
||||||
| v1.7 | 2026-10-16 | **状态刷新批（用户令）**：① 「五 · 表现」立绘清晰度回退评估行 待裁→待做（方向已裁——2026-10-14 用户裁维持像素风、升级精细手绘像素、不回退高清图，裁决录=美术审计-cursor会话存档 §2.2；余下义务=立绘按新口径重产与大小比例人闸复核），「七 · 未决项」七项减为六项重编号；② 「五 · 表现」战斗一屏样张、棋盘观感两行加编入注记（2026-10-16 用户令编入迭代 30 序位②③，状态维持待做）；③ 「一 · 排雷循环」「二 · 内容量」地形变异两行加屏蔽注记（2026-10-16 贫矿脉整图型屏蔽删行，variation.tres 回 region 六行；机制代码保留，重建设计加行即恢复）。除未决项销项外条目集合零增删；连带 06 立绘条子问题二与状态行随裁换代（方向已裁+08 指路改注，权威面 art-bible/character-design 反哺另批） |
|
|
||||||
| v1.8 | 2026-10-16 | **playnote 二轮对照批（用户令立框架：不需要讨论的写进 08 并同步 06、需要讨论的挂 06 待裁）**：① 「三 · 界面」「暂停层」行改名「状态面板（局内）」（随 2026-10-13 暂停层改名批换代——08 行名漏扫）并在役→部分在役（瘦身义务入册：去跨关解锁内容〔秘宝匣解锁态 12 行概览 / 天赋树已购概览〕、只留本局五件〔带的秘宝 / 已获专长 / 当前属性 / 现有 GP / 钥石总量〕——来源=playnote「状态界面不需要有具体的解锁内容」条；同步登记 06「状态面板瘦身」专条）；② playnote 余下增量两条不进本表：成长系数节奏语义两读待澄清→06 专条待裁（数值调优义务 v1.6 起不入版本标准）；路径长度统计与递增增幅=关卡节点图重构的设计输入→补进 06 既有专条。条目集合零增删（改名不算增删），未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.9 | 2026-10-17 | **未开格类型微光实装回填（迭代 30 卡①，反哺点回写用户令授权）**：「五 · 表现」表新增「未开格类型微光（五组色相＋明度档）」行（事实源 = HUD框架 微光节——2026-10-17 实装入库），状态 = 在役（明度档 provisional 值登记见 art-bible 版本历史，复核转正归战斗一屏样张〔迭代 30 序位②〕）；文头状态行 v1.8→v1.9。条目集合 +1 行（回写授权＝用户裁），未决项与「六 · Alpha 不含」零触碰 |
|
|
||||||
| v1.10 | 2026-10-18 | **混编遭遇第二批裁挂 Beta（用户令「挂 beta 吧，不需要再进行讨论了」）**：未决项第 4 行「混编遭遇第二批（Boss 多行）进不进 Alpha」删除（六项减为五项、第 5/6 重编号为 4/5），「二 · 内容量」混编遭遇行集现状注改为「首批；第二批 2026-10-18 用户裁挂 Beta、Alpha 不做」；本批零代码零内容变更——机制面（迭代 17 行集多行批）与首批投放（迭代 18 卡⑤）维持在册，Boss 多行投放与 MC 取证/数值统标一系随 Beta 阶段再议；文头状态行 v1.9→v1.10。其余条目与「六 · Alpha 不含」零触碰 |
|
|
||||||
| **v1.11** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：奇物池行三分类「资源」→「补给」；「中间资源折算」→「中间系统资源折算」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -212,16 +212,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统无未决待办（结构随机生成池已落地）；后续新增待办统一登记 06-待办清单，本节不再逐条登记。
|
本系统无未决待办（结构随机生成池已落地）；后续新增待办统一登记 06-待办清单，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| 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 架构批先行（评估书 2026-09-27 交付：核心发现=七流系同一主种子的盐值分栏、字面目标现行已满足；待裁决=甲维持分栏/乙物理并流/丙并流+全事件日志），本特性实施排队其后（P0 补前置行、抽签节流形态改随统一流结论）；③特性内机制先行骨架随后（池暂 N=1、骨架内容批扩池）；证据面 A 补裁决注记。06 新立「全游戏随机流统一架构批」条目（数据配置节） |
|
|
||||||
| v0.4 | 2026-09-27 | **实施前置解除批（统一随机流批随批——rng 架构批已按 2026-09-27 裁决落地）**：状态行改实施解锁；抽签节流形态定稿 = 统一流扩签新用途标签 `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（生成前自校验）。遗留：台阶二/三后置不变；正式侧生存链/带面影响随读数批 |
|
|
||||||
| v0.6 | 2026-10-01 | **出度上限拍板批（T17 目检用户裁决「节点出度最大为 2」）**：① 加载校验第七检 `fanout_violation`（出度 >2 加载致命）；② 规则连带——层宽上限随出度约束调整为 4（2026-09-29「层宽上限 5」废止，数学不相容）；③ L2/L3 十张模板全池重建（tools/t17_fanout2_rebuild.py——出度 ≤2/层宽 ≤4/类型序列保持/可达自校验，五骨架换名宽廊双干〔现行〕等）；④ 钉固断言 5 处随新图更新（min/max 路径/入口候选/奖励后候选）。**连带义务：MC 读数基线随图结构变化漂移——全旧 MC 锚作废，重锚归下一测量批**（当前只测不判） |
|
|
||||||
| v0.7 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①状态行里程碑前缀按 2026-10-09 里程碑口径删「M-3」只留「迭代 5」（worktree 名为历史产物名不动）；②调参表模板池大小行「内容批落地前现行 1 张」过期表述替换——2026-09-28 台阶一实施批已落地 3 关 × 5。注：版本表内 v0.6（2026-10-01）行排在 v0.5（2026-09-28）行前的既有乱序不动，另行列呈报。 |
|
|
||||||
| v0.8 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 10 处**——「收口」→「完成」9 处（三级台阶表前置两处 / 测量对账实施门句 / 实施时点选项 A、B 两处 / 依赖表难度曲线与Boss行 / P1、P2 后置表两处 / 验收标准节题）＋「对拍」→「与基线数据逐项比对」1 处（测量对账·基线可比条）。机制与数值零改动；文头「原 06 条目已收口移除」系原条目处置记载（对照性文本）按豁免保留 |
|
|
||||||
@@ -175,21 +175,3 @@ Boss 兑付（胜利或英雄死亡）触发关卡收束点，此后不再有选
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v0.2 | 2026-09-15 | 待拍板"多敌数量的消费面"条目同步教学位掷骰口径（随[难度曲线与Boss](难度曲线与Boss.md)同批修订）：删除"教学位节点固定不掷" |
|
|
||||||
| v1.0 | 2026-09-17 | **定稿**（逐问题拍板，全用户裁决）：① 形态重开——用户拍板重开[05-不做清单](../../05-不做清单.md)「路径分支地图后置」裁定，定稿为**分支节点图**（分层节点图，杀戮尖塔 / 哥布林弹珠同构；方块地牢美术观感、逻辑为节点图），P0 图定稿 + 单链特例先行；② 节点类型定稿四类封闭枚举不扩类；③ 行进交互定稿全节点确认 + 兑付后确认、零自动推进；④ 遭遇构成收窄为编排面三条（战斗内部初始化全归战斗小循环），寻址定稿节点编号升级（`node_depth` 语义升级为关卡内唯一节点编号，表键与字段名零改动，单链零漂移）；⑤ 节点奖励拍板为功能道具的正式渠道（内容归秘宝内容重定批，切片期直通为合法空态）；⑥ 「精英与 Boss 编码位」（同层多遭遇由节点编号消解，不设编码位）与「多敌数量的消费面」（关卡层零消费）两悬案收口，同场多敌种面拆归战斗侧；⑦ 切片行进代码对照的接口漂移清单登记 06 |
|
|
||||||
| v1.0.1 | 2026-09-17 | **P1 分支节点图内容与实现批落地**（用户拍板任务批——切片代码 / 难度曲线与Boss v0.7 / registry / 06 待办同批）：首张分支图 = 切片关卡 2「第二层 · 幽暗地域」行集落地（9 节点网状图：入口 0 → 中间三层 2/3/2 → Boss 8，真实岔路 4 处，奖励点 + 恢复点各 1，战斗节点 6 + Boss）；行进器图版推进（`choices_presented` 选路态 + `pick_next_node`——零自动推进，战斗胜利不再自动推进、`continue_after_node` 泛化为兑付确认，06 接口漂移清单 ④⑤⑧ 清偿）；图合法性校验落地 `LevelTable.validate`（单链与图同一套算法，L1 零迁移过校验，违规加载致命）；节点图选路 UI（选路覆盖层整图自绘——房间方块 + 通道连线 + 当前/候选高亮，占位图形质量；顶栏图形态渲染行进序列 + 候选）；首页"关卡 2 试玩"直入口（测试模式，≠ 两关序列生效）。本版本号只记实现批状态，图规则口径零改动 |
|
|
||||||
| v1.1 | 2026-09-20 | **商店房扩类（GP+商店房批，用户拍板——与冒险结构 / 战斗结算 / 地图战斗资源 / 难度曲线与Boss / registry / 切片同批）**：① 节点封闭枚举四类→五类（+商店房）；② 编排规则定稿——每关恰 1、关底 Boss 前一位必经位（哈迪斯式"决战前最后一个补给点"定位）；必经位由冒烟断言承载、图合法性六检零新增；③ 兑付定稿——打开商店覆盖层、购买即时生效写统一冒险加算区（与关卡大奖励同一笔，归冒险结构）、离开后兑付确认；商店房不携带战斗行；④ 节点兑付表 / 纪律表 / 依赖表 / P0 闭环 / 验收标准 / P2「事件类节点候选」注记同步 |
|
|
||||||
| v1.2 | 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批（已执行完毕，git 历史可查），代码实装另批并行）**：① 行进循环改停点前移口径——关卡开始即呈现节点图选路停点（关卡画面 = 选路覆盖层常驻化，入口节点不自动进入，第一次选路就是"出发"），选路确认进节点，兑付确认后返回关卡画面再选路（战后回图）；兑付后确认、零自动推进两条纪律语义不变，只改承载位；② 呈现侧口径补进度承载条款——关卡画面本体即节点链进度呈现载体（节点态直接读图：已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 旗朱描边），不另设进度条组件（战斗屏 A 区进度条随批退役）；③ P0 闭环两条、依赖表 HUD 框架行、验收标准「行进自主」条同步。**批内代拍板三项已追认（2026-09-24 用户确认）**：① B/C/D 字母保持不重编；② 28px 纵向空间划归 C/D 底行；③ 关卡画面进度呈现由选路覆盖层节点态承载（登记面见 HUD框架 v0.8） |
|
|
||||||
| v1.3 | 2026-10-01 | **图合法性第七检（T17 目检用户拍板「节点出度最大为 2」）**：`validate` 新增 `fanout_violation`（单节点出边 >2 加载致命）；规则连带层宽上限 4（原 5 与出度约束不相容，废止）——生成侧规则与模板池重建归[关卡节点图生成](关卡节点图生成.md) v0.6 同批 |
|
|
||||||
| v1.4 | 2026-10-03 | **奖励节点道具渠道退役注记（迭代 11 第①批同调实施批——与 node-reward.md v2.2 / registry 同批）**：奖励节点的秘宝件渠道随停点渠道退役拆除（BONUS_IDS 词表除名 aux_item，池五种；三选一刷新件面新增见 node-reward.md v2.2）——奖励节点兑付面=提升三选一（属性/GP/AP 五种）+刷新，零结构改动（节点类型词表/图合法性六检零新增） |
|
|
||||||
| v1.5 | 2026-10-03 | **商店房兑付换代注记（迭代 11 第②批 GP 商店房重构批——需求卡片 v1.3 全裁；冒险结构 v0.13 / registry / 难度曲线与Boss 同批）**：商店节点类型词表与编排规则零改动（每关恰 1/Boss 前一位必经位/图合法性六检零新增）；兑付面换代 = pool 模式进店抽 3（shop_draw 封闭流）+买 1 全重抽+重抽绑购买+空架合法态，货架候选与库存归冒险结构共享池节；覆盖层呈现面=货架三选一同构卡（legacy 固定三件面随对照模式保留注记） |
|
|
||||||
| v1.7 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①奖励节点兑付口径全节订正——「池六种含秘宝、加权洗牌、全冒险次数上限」改现行令牌池口径（七种、洗牌不放回抽 3、池耗即上限、未选回池）；「道具件满位替换子交互」随秘宝件出池不再触发；「池空直通随共享池退役、牌库恒非空」反转订正——TP0 后池耗即枯竭、空库直通为合法态；「终局=秘宝局外同调件的改写义务仍归同调实施批」订正为已落地（迭代 11 第①批）；②P0 闭环与验收「切片期直通合法空态 / 取一件入关卡域库存（随同调实施批退役改写）」过期表述替换为提升三选一共享令牌库口径；③P1 后置「分支节点图内容与实现批」已随 v1.0.1 落地——行移除，正文两处「随第二关内容批（见 P1）」改「已落地」；④不负责表与依赖表「节点奖励的道具内容→秘宝（内容重定批）」改指奇物（提升池构成与账本归冒险结构）。注：版本号 v1.6 系正文商店行已有标签（MC-1 独立刷新批 2026-10-04）的表内让号，该批版本行缺失另行列呈报。 |
|
|
||||||
| —— | 2026-10-09 | 缺号注记：v1.6 未登记（对应批次=MC-1 商店独立刷新批〔2026-10-04，git ac3cee7 明记「关卡节点地图v1.6换代」〕，登记见正文商店行 v1.6 标签与 v1.7 行让号注记），卫生批仅注记不补写 |
|
|
||||||
| v1.8 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 1 处**——设计目的首句「若干节点」改「由关卡表配置的一组节点」（「若干」→写明数值出处：节点构成与数量读关卡表行集）。机制与数值零改动 |
|
|
||||||
| **v1.9** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「跨战斗生命账本」「共享池账本」「库存账本」等去账字；指路「GP 冒险账本节」→「GP」节、「共享池账本节」→「共享池节」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -301,31 +301,3 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：第二关"解锁新元素"条目改引用「已从设计中移除的机制」（见不做清单），并明确第二关层名未定稿、随第二关内容批重定。关卡序列与节点模板不变 |
|
|
||||||
| v0.3 | 2026-09-17 | 代币→钥石统一拍板（用户裁决）：大奖励第三件「代币记账 +10」改「钥石入账 +10」——与元进度钥石同一资源（渠道 = 关卡大奖励入账与 Boss 掉落），「代币」措辞退役；调参表字段名、验收标准、依赖表同步。数值与机制不变 |
|
|
||||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），3 处失同步修正（示例轨迹改纯符号〔旧 50/50 生命轴示例作废〕、大奖励 +10/+10 改读 adventure_table 行值并删换算率数字锚、调参表 30/10/10 三格改读 level.tres / adventure_table） |
|
|
||||||
| v0.5 | 2026-09-20 | **GP+商店房批（用户拍板——与关卡节点地图 v1.1 / 战斗结算 v0.23 / 地图战斗资源 v0.15 / 难度曲线与Boss v0.18 / registry / 切片同批）**：① 新增「GP 冒险账本」节——钱包三收口（战斗完成统一入账 / 商店购买出账 / 冒险收束清零）+ 战斗内缓冲隔离语义（格面兑付入缓冲、战斗完成统一到账、战斗域零钱包状态）；② 统一冒险加算区成文——商店购买与关卡大奖励上限提升同一本账（三轴 {攻击, 生命上限, 护甲等级}，经覆盖值通道生效；购血 = 上限与当前生命同步 +Δ）；③ GP 掉落掷定消费 gp_drop 封闭随机流（主种子派生）登记进主种子节与调参表；④ GP 不入存档、不入冒险摘要；范围表 / 大奖励表 / 依赖表 / 验收标准同步。数值全 provisional-pending-曲线调参批，行值读 shop.tres |
|
|
||||||
| v0.6 | 2026-09-21 | **冒险结构实现批落地登记（切片 AdventureRunner + LevelRunner 账本外置 + AdventureTable 建表——与切片代码 / registry / 03 / 06 / roadmap 同批）**：本批只记实现批状态，正文规则口径零改动。落地面 = 三关正式序列生效（首页「开始冒险」）、接口契约四件套正式侧承载（开始关卡 start_level_external / 战斗结果上报共享账本直写 / 治疗封顶回报 apply_rest / 关卡结束 level_finished）、生命账本与 GP 冒险账本上交冒险结构层、大奖励非末关恰兑付一次（末关钥石照记）、冒险摘要五件事产出、主种子恰一次注入（registry rng_service new_adventure 调用权同批登记）、结算受理只算一次；06 待办「两关序列未生效」「切片行进代码与定稿的接口漂移」「冒险表未建表」三条随批解决移除。**规划书冲突按代码为准登记两处**：①大奖励 `_pending_next_level` 置位先于 emit（信号同步派发——处理器内立即确认需标记已就位）；②放弃受理补 state=running 守卫（契约 7 结算受理只算一次的 abandoned 侧对齐） |
|
|
||||||
| v0.7 | 2026-09-21 | **放弃入口界面呈现批（用户拍板「放弃接口也要有」——台账 119，推翻本文原「MVP 无界面入口、呈现后置」条款）**：① 放弃入口挂[关卡节点地图](关卡节点地图.md)选路覆盖层（选路停点 = 天然非战斗期；战斗中拒绝转为防御兜底分支——入口在战斗期不可达）；② 入口只在冒险模式开放，单关测试直入口没有可放弃的冒险对象；③ 正文改现行口径（放弃节 / 验收标准放弃条），P1 后置表「放弃入口的界面呈现」随落地移除（同表「两关序列生效」系 v0.6 已落地漏收口，顺手同口径移除）；④ 验收闸 = ui_probe 三断言（默认隐藏 / 冒险模式可见 / 首战中按下被拒 state 保持 running）+ 冒烟既有放弃两态 API 断言 |
|
|
||||||
| v0.8 | 2026-09-23 | **单关测试直入口退役（用户拍板——唯一试玩入口 = 完整三关冒险）**：正文改现行口径两处（放弃节「按钮只在冒险模式开放」的理由从「单关直入口无冒险对象」改为「选路覆盖层只在冒险模式出现」；验收标准放弃条同步去单关直入口从句）——放弃语义对象（整局冒险）与拒绝分支零改动。版本历史行（v0.7）按文档纪律不回改 |
|
|
||||||
| v0.9 | 2026-09-23 | **停点前移批流程口径对齐（用户 2026-09-23 拍板冒险入口流程倒置修复——与 HUD框架 / 关卡节点地图 / battle.md 同批；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批）**：P0 闭环「开始关卡」条改新流程口径——关卡节点地图加载节点图后停在入口选路停点（关卡画面，选路覆盖层常驻形态），行进自玩家首次选路开始；通读复核其余章节——「通关自动进下一关」属关卡序列层语义（进入下一关后仍出图选路，零矛盾）、接口契约四件套、收束点先清库后宣布、放弃入口（选路停点 = 天然非战斗期）等既有裁决零改动。**批内代拍板三项已追认（2026-09-24 用户确认）**（字母不重编 / 28px 归 C/D 底行 / 进度呈现由选路覆盖层节点态承载）不落本文修订面，登记见 HUD框架 v0.8 |
|
|
||||||
| v0.10 | 2026-09-27 | **统一随机流批口径对齐（2026-09-27 裁决——rng 架构批随批）**：主种子节「可复现域 = 主种子 + 各随机流计数器」改「主种子 + 全局取数计数器」（语义权威指数据配置）；本文规则面零改动——主种子恰一次注入、重开即全新一轮、摘要五件事均不变。代码实证与七消费点迁移见数据配置 v0.5 |
|
|
||||||
| v0.11 | 2026-09-29 | **冒险断点批（迭代 8 卡①③——中断可续玩/退出即结算两口径分离）**：核心规则新增「冒险断点」节（停点粒度/七字段拍板面+附随件/中断退出两口径/续玩语义/测量面静默）；依赖表存档序列化行补断点域 owner 登记；验收标准 GP 不留痕条补断点域豁免口径。实现落点 = AdventureRunner 快照/清除/续玩 + SaveManager breakpoint 域 + rng restore_adventure |
|
|
||||||
| v0.12 | 2026-10-01 | **关卡大奖励重构批（迭代 10——用户 2026-09-30 拍板案丙 + P-A~P-E 全裁毕；冒险表扩列 / meta.tres 重锚 / registry / 行动经济 / 元进度 / 01-核心循环 / 03-内容规模 / 难度曲线与Boss / 关卡节点地图 / 06 同批落文）**：①大奖励「固定三件套」退役改两层兑付——非末关通关 = 部分回血（clear_heal_pct 20 provisional）+ 提升三选一（池六种：攻击/生命上限/护甲/GP 袋/秘宝/行动点件；加权洗牌不放回 E-S weight-key 消费 reward_pick 封闭流；属性件上限各 3、AP 件上限 2，达上限先剔牌库）；②统一冒险加算区三轴扩四轴 +行动点（AP 件 = 每场战斗开始首轮基线 +1）；③钥石退役出大奖励改 Boss/精英击杀逐杀掉落（boss_keystone 重锚首杀 3/复杀 2，末关照常入账，精英掉 1 预留）；④秘宝件受同调位约束（过渡键 transitional_sync_slots=1 provisional，现行事实源 = 同调实施批谓词表；超位替换交互 N+1 选 N、战斗内渠道沉没不入）；⑤断点附随件扩奖励选择态 + 件获取次数计数；⑥选择停点零自动推进/可中断。渲染层验证冻结（用户 2026-10-01 提前开工拍板——不合入 master、目检待批），目检清单随批交付 |
|
|
||||||
| v0.13 | 2026-10-03 | **GP 商店房重构批（迭代 11 第②批——需求卡片 v1.3 全裁 P1 共享池/P1-a/P1-b 双甲/P2 甲/P3 甲/P4 ceil/P5 甲；06「GP 商店房重构」条 2026-10-02 用户裁决取代 09-20 无刷新裁决）**：①GP 冒险账本节商店购买行换代——价格公式 = ceil(基价 × b^(关序−1) × A^(本次进店已购次数))（A/b provisional 1.8/1.1；legacy 旧式随对照模式保留注记）；②新增「共享池账本」段——商店货架 = 池∖{GP 袋}∖{秘宝件} 四种，库存=上限即库存全冒险一次性，两渠道同一账本（买一件=奖励面少一件），池空硬闸+空架合法态；③shop_draw 扩签登记；④统一冒险加算区段——pool 模式买上限不回血（池件=奖励件本体）、AP 件累加源并商店；⑤断点附随件扩商店货架态（shop_shelf/shop_visit_buys，P2 甲；确定性重放承载注记）；⑥调参表 GP 经济参数行随表换代。实现=AdventureRunner/LevelRunner 池模式（缺省 legacy 对照承载，真实入口投 pool） |
|
|
||||||
| v0.14 | 2026-10-03 | **令牌池落地批（迭代 12 TP0——node-reward v2.2 追认 b 实施批）**：①提升池改**固定配额令牌池**——普通 70/稀有 25/罕见 3=98 张〔罕见档原列「道具件 2」随 aux_item 池种退役〔迭代 11 第①批 T7，落地晚于追认 b〕收窄，池总量 100→98——台账自决披露项〕；②抽取机制换代——Fisher-Yates 不放回抽 3 同 kind 去重每 kind 至多一枚（取代 E-S 加权洗牌），选中踢池未选回池、池耗即枯竭、**种类次数上限退役**；③恢复件新入池（rare 档 +6 当即回血封顶生效上限）+ 数值对（小GP 20/大GP 50 等）；④MC 策略 316-f 落地（autoplay 1 级最稀有/2 级最左）；⑤共享池账本段换代——库存=剩余令牌数，货架=令牌级抽签（价格公式 tier-blind 维持批②裁定），消费=AdventureRunner._bonus_deck 单点；⑥断点附随件扩令牌池余库（bonus_deck 逐枚还原；旧断点缺键=满库重建防御口径单版本周期）；⑦现行基线锚换代=runsum_m4iter12_tp0_n20_20261003（normal 档配对读数同带 0/5/0） |
|
|
||||||
| v0.16 | 2026-10-06 | **三选一刷新对齐商店批（用户令——「三选一对齐商店，得有刷新」；机制现行事实源=秘宝.md 三选一刷新双源节同批落文）**：免费双源（刷新件 X/冒险池 Y）用尽后 GP 付费刷新——同 shop_refresh_* 两旋钮（curio_refresh_gp_cost 单点调参）、扣同一 GP 冒险账本（LevelRunner.spend_gp 新单口）、重抽同 reward_pick 共享池抽签；付费刷计数每停点清零；呈现=CurioPickOverlay.set_refresh_display 与商店 set_refresh_display 同构（钮常驻选择态、两源皆穷禁用不隐藏、角标=免费余量、价签行示 GP 价）；通关停点刷新重发载荷带 refreshed 标直落选择面（不再重开胜利总结面）。店内凭证专长三选一暂不挂刷新面（维持现状）。单测=tests/unit/core/curio_refresh_paid_test.gd |
|
|
||||||
| 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 条目已随收口移除」 |
|
|
||||||
| v0.20 | 2026-10-12 | **迭代 20 反哺落文批·关卡大奖励换代（用户裁②——通关兑付=专长三选一按档配比加权抽取+回血，2026-10-11 迭代 20 Q1 已裁形态对齐）**：①章节标题/概览行/三层奖励框架表「提升三选一」→「专长三选一」（通关渠道=专长独占兼唯一直接渠道，未选候选不落袋）；②提升池七种×档位表与洗牌抽取段整体退役——池机制事实源移交[奇物]「池结构与抽取」节（案D 四级 104/曝光槽 2+1/令牌语义/概率与 cap 解耦），本节压缩为结构层段（共享池冒险级单例/库存=剩余令牌数/reward_pick 封闭流/MC 策略 316-f/断点余库还原）；③本文件「提升三选一」指通关兑付处换代「专长三选一」、指奖励节点选择处换代「奖励节点三选一」（生命周期图/加算区同账段/共享池账本段/关卡序列图/验收步骤 6/结构冻结——版本历史行引述豁免）；④不负责表换代（池结构与抽取机制→奇物；共享池库存账本留本文）；⑤~~秘宝件~~出池删除线行随提升池表退役（渠道恢复契约口径由「秘宝件受同调位约束」段承载不变）；⑥刷新句「提升三选一免费双源」中性化「三选一免费双源」 |
|
|
||||||
| v0.21 | 2026-10-13 | **Y 断点随存缺陷修批（06「天赋树实装批登记欠账三条」③——用户令单独开修）**：「冒险断点」节附随件清单扩 **Y 刷新池余量**（attune_refresh_y——续玩优先读断点、不自参数面整额重注入，堵「用完 Y 退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面=旧档行为零变化）；快照时点不变（停点整体覆写已覆盖 Y 消耗后状态）。断点域登记与版本口径归[存档序列化](../表现与支撑/存档序列化.md) v1.8（v7 域后扩列不升版） |
|
|
||||||
| v0.22 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 9 处**——「若干」→「三关（关数读关卡表）」1 处（冒险计量单位定义句）；「报错」→「返回错误」1 处（加关纪律运行期拦截句）；「收口」→「收支口」3 处（GP 冒险账本钱包句、表头、验收 GP 账本封闭条——名词义，对齐本文件生命账本「收支口」既有用词）＋→「完成」1 处（同调位约束段「统一收口」）；「不得」→「禁止」2 处（共享池账本两渠道句、主种子节生成新种子句）；「在飞」→「执行期间」1 处（放弃受理句·战斗域单事务括注）。机制与数值零改动；不负责表 HUD 行「随 spec 命名收口退役」与同调位段「原 06 条目已随收口移除」系更名/条目处置记载（对照性文本）按豁免保留 |
|
|
||||||
| **v0.23** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「生命账本／GP 冒险账本」表行与节标题 →「生命／GP」；GP 节标题改「### GP：…」，全库指路同步；生命/GP 两笔的系统资源表述换代（机制零改动）——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -118,7 +118,7 @@
|
|||||||
|
|
||||||
## 资源（重设计·基础框架 v1）
|
## 资源（重设计·基础框架 v1）
|
||||||
|
|
||||||
> 本节是补给分类的现行事实源。补给成员 = **转换源**：不是系统资源本身，是「到手即结算成一笔系统数值的凭证」——凭证加完消尽，被写入的系统资源各有自己的寿命档位（五档轴见[核心循环](../../01-核心循环.md)「生命周期轴」节）。判据句与归类方法见 §1.3/§1.4。**新凭证已随迭代 20 专长实装批落表（2026-10-11）；2026-10-18 用户裁削两件后，现行成员＝新 3+留任 2（同调电池删除、完美保险归专长——见版本历史 v3.18）。**
|
> 本节是补给分类的现行事实源。补给成员 = **转换源**：不是系统资源本身，是「到手即结算成一笔系统数值的凭证」——凭证加完消尽，被写入的系统资源各有自己的寿命档位（五档轴见[核心循环](../../01-核心循环.md)「生命周期轴」节）。判据句与归类方法见 §1.3/§1.4。**新凭证已随迭代 20 专长实装批落表（2026-10-11）；2026-10-18 用户裁削两件后，现行成员＝新 3+留任 2（同调电池删除、完美保险归专长——见 git 提交史 v3.18）。**
|
||||||
|
|
||||||
### 凭证件表（新 3 + 留任 2；代号制命名归用户；稀有度档、配额与面值数值归调参批）
|
### 凭证件表（新 3 + 留任 2；代号制命名归用户；稀有度档、配额与面值数值归调参批）
|
||||||
|
|
||||||
@@ -461,43 +461,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
全部待办单点登记于 [06-待办清单](../../06-待办清单.md)（BD 分层条目、命名统一后续条目），本节不复制。
|
全部待办单点登记于 [06-待办清单](../../06-待办清单.md)（BD 分层条目、命名统一后续条目），本节不复制。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 变更 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-10-05 | 以「特性」为名首次为本概念立定义文档。此前它按内部分类被叫成三个名字（规则类称「流派件」、属性类称「数值件」、界面称「本关强化」），现收敛为一个对象下的分类；性质定为「角色自身得到提升」而非「获得物品」。 |
|
|
||||||
| v1.1 | 2026-10-05 | 分类重构：两类由「规则改写型 / 属性加成型」改为「属性提升 / 专长」。 |
|
|
||||||
| v1.2 | 2026-10-05 | 专长渠道落定：关底 Boss 击败后兑付，不新增节点类型；罕见旁路明确为"普通奖励里的专长 N 选一"。 |
|
|
||||||
| **v2.0** | 2026-10-05 | **顶层改名为「奖励」并重构为两根轴**。改名动因：筐里既装"角色自身的变化"也装金币这类一次性兑付物，用"自身提升 vs 持有物"已切不开，边界判据改由生命周期承担——**当局清零的是奖励，跨局带走的是魔法道具**。分类由两类改为**三个枚举**（当时的写法是「机制类 / 属性提升类 / 资源与机会类」，v2.7 才定名为专长 / 属性值提升 / 资源）：专长 / 属性值提升（生命·AC·攻击）/ 资源（行动点上限·刷新次数·金币·回复）。新增第 2 节分类 × 渠道交叉开关表，明确两根轴互不决定；金币与回复不再被当作"该移出去的脏东西"，而是安置在资源里，同时把它们的即时兑付性质显式登记为类内异质性。 |
|
|
||||||
| v2.1 | 2026-10-05 | **交叉表收口（用户拍板）**：Boss 渠道**只出专长**，属性值提升与资源在此均不出现——三条渠道的形状定为"一块独占 + 两块并行"，专长靠打赢、其余靠抽取与购买。Boss 兑付明确为**终局前**的 Boss，终局 Boss 不给（无后续关卡可消费）。新增 2.4 节**「计价物不自售」规则**：金币不进商店既不拆分类也不开特例，而是写成两轴交叉处的一条约束——商店的计价物是金币，故金币不进商店；按"能不能进商店"反推分类等于用渠道轴去切分类轴，两根轴会缠回去。 |
|
|
||||||
| v2.2 | 2026-10-05 | **凭证形态 + 约束分层 + 默认原则**。① 用户明确：奖励节点与商店不直接给专长，而是给一个**「专长获取」道具**，拿到后开专长三选一——交叉表专长在两渠道由"不出现"改为"**凭证形式**"；凭证归专长（给的是一件以前不会的事，只是把选择推迟），理由是防止用钱定点买构筑。② 用户质疑「计价物不自售」本质是特判——**承认成立**：它确实是在分类白名单之外加的一道过滤，与死特判的区别在于把"枚举例外"变成"**可计算谓词**"（新渠道/新奖励自动判定）。2.4 改写为**三层约束**（分类白名单 / 可计算谓词 / 显式例外清单），并给出判断标准：结构性原因可写成谓词，设计性原因只能进清单且每条须写理由；三个方案（单独分类 / 谓词 / 死特判）的代价并列摆出，不藏折中。③ 用户定**默认原则**：除已登记的特殊规则外，分类内的东西都要在池子里——据此**回复应在商店内**，现行 shop.tres 货架缺它是"现状与表格不对齐"，须在实施批补上。 ⟵〔更正注记 2026-10-19：本行①的「凭证归专长」归类记载无用户裁断记录，系写文档时的误记，已在 v3.19 改写为渠道兑付形态表述；机制部分不受影响〕 |
|
|
||||||
| v2.3 | 2026-10-05 | **凭证机制细化 + 默认原则表述修正**。① 凭证**拿到即开、不可囤积**（用户定）——不进持有集，防止玩家把关键决策无限推迟，也防持有物语义从后门回来。② 凭证的"罕见"**只在概率不在价格**，一局限购一次，并加**计步保底**：连续 5 次三选一展示未出现则第 6 次必出；计数跨奖励节点与商店共享、**刷新后的重新展示计入**（用户明定含刷新），限购用满后保底不再触发。③ **修正 v2.2 的误读**：把"分类在某渠道不出现"当成需要理由的缺格是错的——渠道出哪些分类是渠道轴的定位（Boss 只出专长），不是例外；默认原则只管**分类内部**的成员齐不齐。④ 专长总量与档位阈值的匹配按用户决定**延后**（待第四关内容批后实测复裁），另单独登记 charge 标签仅 3 件、永远达不到档二的数据缺陷。 |
|
|
||||||
| **v2.4** | 2026-10-05 | **顶层由「奖励」改名为「奇物」（Wondrous Item）**。用户否决了「奖励」「收益」与全部自造词（进益/造化/机缘/遇获），要求回到 DND／西幻既有名词。定名依据：DMG 魔法物品九分类中的 Wondrous Item，官方中文译名即「奇物」，是专装不好归类但有奇效之物的兜底杂类——正好对应本概念下三个互不相干的分类。此前考虑过的 Treasure（宝物）因偏财物、装不下专长而落选；roguelike 品类惯例 Relic 因用户否决遗物落选。**代码词族定为 `curio_*`、`ADVENTURE_CURIO`**（`reward_*` 已被 `reward_pick` / `reward_node` / `reward_preview` 占用，不能对齐）。 |
|
|
||||||
| **v2.5** | 2026-10-05 | **第三类定名「资源」**（用户拍板，父节点定为「奇物」后解锁）。定名依据：行动点上限 / 刷新次数 / 金币 / 回复都是可以调动、可以花掉的余量。「资源」偏泛（能力资源、财富资源都叫资源），因此在 1.5 写死判据句——**给的是可消耗或可重掷的余量，不是角色基础属性的永久抬升**，这一句是把泛用词收回本类定义的唯一凭据。**回复归属同时定案：留在资源，不独立成第四类**——它与金币同为即时兑付、判据同源，拆出去第四类只剩两项且与本类判据重合。附带修复：1.5 段末与「### 2. 渠道轴」标题粘连（缺换行）。 | ⟵〔更正注记 2026-10-19：本行定名的第三类「资源」已于 v3.20 改名「补给」——原类名与「系统资源」同词（用户 2026-10-19 裁），本类定义以现行 §1.3 为准〕 |
|
|
||||||
| **v2.6** | 2026-10-05 | **修正核心循环位置图：奇物不是打一场战斗给一份**（用户纠错）。原图把"关内 排雷推理 → 战斗结算 → 通关 → 得到一份奇物"画成一条链，读起来就是每场战斗通关都给一份——**错在把关内普通战斗的通关与关底 Boss 的通关混为一谈**。按 [冒险结构](冒险结构.md) 的定义，**通关一关 = 该关关底 Boss 被击杀**，所以"击败 Boss"与"通过这一关"是同一个时刻、不是一条链上的两步。改法：① 图改为分支结构（普通战斗节点→不给、往下走；关底 Boss 击败→专长三选一＋通关回血）；② **一关只兑付一次**写成显式口径；③ 2.1 节渠道名由"终局前 Boss 击败后"改为"关底 Boss 击败（即通过这一关）"，并写明触发点就是关卡推进本身那一刻；④ 文首引言加"兑付频率"条，交叉表渠道名与 registry 同步；⑤ 连带修掉一处污染——节点类型封闭枚举五种里的"奖励"曾被 v2.4 批量替换误伤成"奇物"（节点类型里没有奇物这一类），已复原。 |
|
|
||||||
| **v2.7** | 2026-10-05 | **三个子节点正式定名（用户拍板：去「类」字后缀）**。此前三个分类只有带后缀的描述（机制类 / 属性提升类 / 资源类），是文档层临时叫法，既非专名也非玩家可读的词。现定专名：**专长**（Feat）/ **属性值提升**（ASI）/ **资源**。定名依据：前两个是 DND 规则书官方中文，且与用户 v1.1 原话一致（当时原话就是「属性提升（ASI）」与「专长」，v1.1 写入文档时被加了「类」字后缀而退化成描述）。「机制类」这个叫法本身还有硬伤——它的 28 个成员里没有一件是"机制"，实际是"在结算挂点上改一条规则"，读者看到会误解为游戏机制。
|
|
||||||
| **新增 1.6 节「三层结构与命名」**（用户 2026-10-05 拍板做玩家可见的三层）：奇物（总称）／三个分类／具体单件。明确**命名是本节规矩、呈现是另一件事**——分类名在卡面不出现（归 battle.md / node-reward.md 裁决），但帮百科、成就名、效果描述的指代三处都要用，所以它必须是玩家读一遍就懂的正式名词。连带：修掉批量替换撞出的五处「专长（专长）」类自撞、v2.0 历史行内的自撞并标注当时的旧称、registry 的「资源（命名待定）」过期标注。
|
|
||||||
| **v2.8** | 2026-10-06 | **效果行为数据驱动换代（内容数据驱动扩展批）**：专长的效果声明从「挂点+效果字典」换为「订阅行」——每件声明**订阅哪个事件（on）/ 什么条件（when）/ 什么效果（do）**，由效果引擎统一解释执行；旧挂点枚举消亡（事件名+效果类型取代）。配套事实：效果引擎 `game/core/effect_engine.gd`（事件 16 / 效果类型 24 / 条件事实 9 / 算子封闭词表）；专长行 `feats.tres` 27 件全量迁移，秘宝被动六件同批订阅化；行为与迁移前逐位一致（MC 同种子 40 局逐位逐项比对实证）。
|
|
||||||
| **v2.9** | 2026-10-07 | **专长体系推倒重设计裁（用户裁——道具三层重设计·奇物层）**：专长分类的**流派标签（archetype）与档位机制（集件质变）框架级作废**——用户判流派式设计「烂到极点」，且流派标签从未被认可为呈现面概念（命名铁律：流派名禁上玩家可见面，06「内部分类禁写入玩家可见面」条升格）；现行 27 件全数待重设，重设计主权归用户，灵感原材料归调研批（design/research 两份 2026-10-07 调研）；审查「六流派档位兑付位立项」方向随档位作废注销。专长=机制改写件的分类定位、凭证/渠道机制、属性值提升与资源两分类不受影响。新增准入校验（重设计适用）：**代价与收益须同账可核算**——「纯代价件」禁止出生（深挖钻头/整备军备教训）；头部加冻结遗留态横幅。 |
|
|
||||||
| **v3.0** | 2026-10-07 | **专长基础框架落地批（用户终审认同——道具三层重设计·奇物层）**：新增「专长（重设计·基础框架 v1）」节=新现行事实源——设计原则五条（触发器句式/事件族组织不上卡面/准入校验同账可核算/信息红线/防兑换环）+基础件表 18 件（开格系6/插旗系3/踩雷系3/节奏系3/战斗系3+契约尖点1；代号制命名归用户）+扩签登记（新事实候选6+停手挂点+清图事件暂缓）+老27件处置（随实装批整体替换、仅作素材库不默认继承）；横幅由「推倒重设计中」翻转「基础框架已立」；数值归调参批、实装归重设计实装批。 |
|
|
||||||
| **v3.1** | 2026-10-07 | **档位名与 rarity 语义约束顺带（现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节 v1.5 同批写入文档）**：稀有度四级采用**普通/优秀/稀有/传说**——本层旧三档名映射=普通→普通、稀有→优秀、罕见→稀有，第四级「传说」=新增头奖位（正文档名扫改归奇物批次）；**专长 rarity 语义约束落为文档约束**——Boss 三选一候选按档配比或加权抽取（双脱钩修复：此前 rarity 不影响抽选也不稳代表幅度；配比数值归调参批，MC「最稀有优先」策略的读数偏颇随实装一并校正）；「获取概率提升不动保底」护栏同批。 |
|
|
||||||
| **v3.2** | 2026-10-07 | **资源分类基础框架落地批（五件新凭证用户裁准——道具三层重设计·奇物层）**：新增「资源（重设计·基础框架 v1）」节=新现行事实源——定义句重写为**转换源**（成员=到手即结算成独立资源/系统数值的凭证，加完消尽，账各有寿命档）+凭证件表新 5 留任 2（刷新券/储备金袋RAP/同调电池/时沙/完美保险+小金币袋/应急口粮；代号制命名归用户，稀有度档配额面值归调参批）+上架原则（默认原则全渠道可出）；§1.3 判据句与异质性节随迁重写（凭证全部即时消尽，异质性=账的寿命不在凭证上）；池子档位形态（各档装什么）待用户裁后顺带 | ⟵〔更正注记 2026-10-19：①本行「五件新凭证用户裁准」系失实记载——当日用户所裁为池结构案D，未作此归类裁定；②本行「资源分类」已于 v3.20 改名「补给分类」〕 |
|
|
||||||
| **v3.3** | 2026-10-07 | **池结构与抽取写入文档（用户裁案D——归档打底做翼+曝光槽，道具三层重设计·奇物层）**：新增「池结构与抽取（重设计 v1）」节——令牌=出现次数上限明文化（拿消耗/没拿回池/刷新不消耗，「只刷出没拿」不计次，TP0 语义沿用）；内容归档=普通档面粉打底、优秀/稀有档功能凭证做翼、传说档惊喜位（按决策影响力归档不按数值）；曝光槽=三选一 2 格全池+1 格「优秀档以上」子池（子池空回退全池，池空直通同族）；凭证维持独立计数体系不进子池；配额改动须用户重裁（TP0 结构锚非调参）；MC 策略读数影响随实装复核 |
|
|
||||||
| **v3.4** | 2026-10-07 | **概率与上限解耦约束+耦合问题登记（用户指出的令牌模型冲突——道具三层重设计·奇物层）**：池结构节补两条——①**概率与上限解耦**（设计约束，新内容必检：概率位与已拿上限=两个独立字段，拿了才计/刷出不计，互不决定）；②已知耦合问题与实现路径候选三案登记（令牌 N 张同时承担概率与上限不可独立设定——抽象权重表+独立计数器/令牌池+提前退役计数器/维持耦合已否；选型归实装批，影响面=MC 对账与断点存档）。用户裁：实现设计不定于现在，只落约束与问题点防后续撞车 |
|
|
||||||
| **v3.5** | 2026-10-07 | **秘宝域迁出两件迁入登记（用户裁——秘宝层归留裁决同批）**：淬毒刃纹→战斗系克制向（`on attack_commit + advantageous → 追加 +N`）；标中殉爆→插旗系（`on flag_hit → 全体存活敌 N 群伤`，插旗系补第 4 件；数值均归调参批）；惊巢反制→退役进素材库（归[秘宝](../跨局循环/秘宝.md)速览「目录处置」同批）；实装批执行数据迁移 treasure→feats 并补入件表 |
|
|
||||||
| **v3.6** | 2026-10-09 | **旧条例外科摘除批（用户令——流派方向讨论中暴露的活矛盾）**：①分类表专长行、§1.1、生命周期表、P1 后置四处「流派标签·集件档位质变」残句摘除——v2.9 已框架级作废，残句以正文规则身份存活、持续误导设计（「战斗系占比须治理」伪问题即其衍生）；②验收标准第 4 条 B1 铁律（每流派标签 ≥1 件挂排雷侧触发点）作废，替换为条件判据「收益必挂条件、无条件数值归属性值提升」（用户同日讯：纯属性增加不是专长，通过条件获得数值才是专长要做的）；③待办两条（档位阈值匹配复裁 / charge 标签缺陷）因对象消亡注销。未动：冻结遗留（老 27 件清单与战斗结算侧现行代码行为描述）仍随重设计实装批整体替换；06-待办清单内三处描述性残留（BD 分层条目现状文 / charge 条 / 档位呈现裁点）归 06 条目自身生命周期，另行列出。 |
|
|
||||||
| **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——代码实证） |
|
|
||||||
| **v3.11** | 2026-10-10 | **正文换代批（方案甲，用户裁「旧的删、误标改」——同秘宝.md v2.2 同法）**：①头部冻结横幅摘除——所指「流派/档位/27 件清单」旧章节正文已不存在，名单承载=[道具退役素材库](../../../research/道具退役素材库.md)表二；②专长/资源两节引言去「冻结遗留态/随实装批整体替换」错标，各落一句「新框架实装批落地前，现役代码按同框架运行」；③§1.3 旧资源四项枚举表删除（成员去向一行交代：行动点上限归属性值提升轴/刷新次数由刷新券替代/金币回复留任为小金币袋/应急口粮），回复归属裁定并入「资源为什么单独成一类」段；④§1.2 在途注与 §3 刷新例外去标注改正文（行动点上限归本轴/刷新券口径一律按最新设计）；⑤§1.6 单件举例换新框架件（奥术余烬/贯穿射击→双管镐/疼痛记忆）；⑥「谓词」用词清除——「可计算谓词」改「可计算条件」（正文与验收，版本历史行引述豁免）；⑦验收 4/7/8/9 换代新口径+尾部现役代码运行线；⑧P1/P2 括注清算（已清偿/已注销条目由版本历史承载）+待办节收编为 06 单点指针。真旧内容承载=素材库表二+git 历史 |
|
|
||||||
| **v3.12** | 2026-10-11 | **自爆流扩容批（用户逐裁——踩雷系从被动补偿转主动输出循环）**：踩雷/受伤系 3→7——新增爆芯（踩雷→本轮攻击 +N，走面板乘区）/连爆（同轮多雷递进加层，与疼痛记忆 combo 涌现）/爆心冲击（踩雷→全体敌 雷伤×倍率 直伤，倍率 >1 结构锚——「角色与怪物互相吃伤害」系用户形态本体：开安全格零代价、引爆有代价故回报须更高）/雷蜜（踩雷→回复 N，比值 <1 结构锚）；新增跨族桥引信标定（挖开有旗危险格→+1 层——印记=标定引信、挖=引爆，插旗×踩雷推理闭环）；扩签登记 +3（本轮踩雷数计数器/被挖格当时有封印印记/雷罚伤害量）；**踩雷转化对账锚**顺带登记（净血账期望须为负，两轮压不住砍血蜜——喂雷流 R5 甲教训同源的 kill-switch）；用户裁定：主动/误踩不判定（不预判玩家意图，拿件自选收益最高操作）、爆芯走面板、爆心冲击按倍率非折扣；防御向两件（保险丝/安全帽）保留不动——双刃剑两刃相辅相成；附带修正基础件表战斗系计数 3→2（v3.0 起表头与行数不符），件表总 18→23 |
|
|
||||||
| **v3.13** | 2026-10-11 | **生存件扩容批（用户令「增加生存类的个数」——四类盘点呈报后逐裁）**：件表 23→27——①石肤（on 受伤：AC +1 本场累计上限 M）入踩雷/受伤系——恒定减伤形态被否（用户裁「太硬霸」），改受击成长型护甲；②背水（when 生命 ≤50%：受伤额外 −N）入踩雷/受伤系——风险联动减伤，低血不再是纯劣势；生命比例条件事实系其实现前置需求，用户批扩签+待办登记 06；③铁旗（on 标中：本轮 AC +N）入插旗系——生存奖励挂正确推理，与旗语回响共享事件；④战地包扎（on 战斗胜利：回复 N）入战斗系——战后通用恢复，补「恢复只服务自爆流」缺口。四类占比换代：减伤 2（安全帽/背水）/护甲 3（保险丝/石肤/铁旗）/恢复 2（雷蜜/战地包扎）对增伤 8 ≈ 1:1；用户口径订正=保险丝护盾归提升护甲类（AC 判定）、减伤专指受击直接扣减伤害 |
|
|
||||||
| **v3.14** | 2026-10-11 | **实装前置两项裁定写入文档（用户裁）**：①§2.5——Boss 渠道直接给专长（主渠道、唯一直接渠道）**已裁随专长实装批本批落地不再分期**；②§2.5 新增池结构选型澄清——池结构正主=案 D（v3.3 用户定夺在案：归档打底做翼+曝光槽 2+1+令牌=出现次数上限），「概率与上限解耦」实现路径（v3.4 在册三案）系**实装侧自选项非用户裁定项**（原裁定「实现设计不定于现在」=实装批内依代码事实自选不再上问）——成因=会话误将实装侧自选升级为用户裁定项重问已定夺事项，经历史记录（2026-10-07 讨论记忆+TP0 令牌池天然兼顾核实结论）找回定夺后澄清；06 渠道分工条状态行顺带同步 |
|
|
||||||
| **v3.15** | 2026-10-11 | **专长件第一版命名批（用户裁——对外命名纪律：无「雷」无「插旗」，插旗对外=封印、危险格对外风味=地下城陷阱/怪物巢穴；「扫雷插旗」系内部开发用语、对外=探索/挖掘地下城）**：九件代号换代——插旗系：旗语回响→**封印回响**/猎旗手→**封印匠**/铁旗→**封印桩**；踩雷/受伤系：爆芯→**陷阱本能**/连爆→**连环陷阱**/爆心冲击→**陷阱爆发**/雷蜜→**血蜜**；跨族桥：引信标定→**破封一击**；迁入登记：标中殉爆→**封印爆裂**；示警烟火/疼痛记忆/保险丝/见血开窍/石肤/背水/爆破会计等保留（无雷/旗字）；纪律登记=术语表新增「对外命名纪律」节（v1.6）；版本历史行引用旧代号系留痕不动；命名纪律试例=件名，后续全部对外命名（显示名/UI 文案）同尺 |
|
|
||||||
| **v3.16** | 2026-10-12 | **迭代 20 反哺落文批（用户令「先回写 GDD」——追认单①裁决齐，06 追认结果条承载裁决记录）**：①设计原则新增**落行注记**：「每第 N 次/积满触发」预评估落行=N−1（when 先于 do 读计数器现值，例：地质学家 eq 3/封印匠 mod_eq ref 2）；②疼痛记忆件表「下场战斗」→「下一次攻击」（2026-10-12 用户定性笔误，无需 battle-gate 面）；③弃图兑换落法回写=停手后首次攻击全额附加、用后清零、多攻击不拆分；④血税件表补生效时点（均**下一战起生效**——战末汇入冒险加算区，战界重建契约所致滞后一战）+账列换代双向同账细则；⑤时沙落法回写=下一战首轮 AP 队列兑付（hero_ap_bonus 既有通道），§1.3 判据句与异质性账清单「当前 AP=回合级」随迁「时沙暂记=至下一战首轮兑付」；⑥扩签登记节换代为实装承载记录（10 候选=6 fact+4 计数器改道/dig_stop 落/battle_won+mod_eq+hp_ratio 等随裁补位/新效果类型 7/rewrite_board 除名、清图事件继续暂缓）；⑦专长/资源两节引言「新框架实装批落地前」过渡句随批落地 expiry 换代（29 行=基础 27+迁入 2/凭证新 5+留任 2 已落表）；⑧流派口径澄清落档=**对外永不显示、对内保留事件族五系划分**（v2.9 作废所指=流派作玩法机制非对内划分本身，2026-10-12 用户重申——设计原则第 2 条原文已符，正文零改动）；待办=血税卡面 desc（feats.tres）补「下一战起生效」系代码侧一行改，另行小批 |
|
|
||||||
| **v3.17** | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 7 处**——「不得」→「禁止」3 处（信息红线条、代码词族 reward_* 句、验收第 6 条）；「若干」→写具体数值 2 处（核心循环位置图「三关串联」、生命周期表出现行「3 个候选」）；「收口」改写 2 处（§1.3 判据句「收口凭据」→「界定凭据」、§2.1 悬案句→「完成裁决」）。机制与数值零改动 |
|
|
||||||
| **v3.18** | 2026-10-18 | **凭证件裁削批（用户逐裁——①同调电池删除、②完美保险改归专长）**：①凭证件表计数「新 5+留任 2」→「**新 3+留任 2**」——同调电池整行删除（秘宝＝局外同调件、冒险中零更换途径，与 2026-10-11 撤换装券／删回能器同一原则，且 UI 层从未接线选件入口）；完美保险整行迁出资源类改归专长，理由＝它给的是规则豁免而非可调动的余量（§1.4 判据），经文记入迁入登记节。②§1.3 异质性「被写入的账」清单注销「秘宝充能」「完美资格」两账；`attune_charges` 账本本身仍属秘宝基础设施保留（迭代 11），本次只删奇物侧写它的入口。③受影响的计数与指路同步换代：§1.3 引言、凭证件表标题、调参表「资源种类」行。④**一处失实记载订正**：资源节头注原写「2026-10-07 五件新凭证**用户裁准**写入文档」——当日用户所裁为池结构案D，未作此归类裁定，该句删除（「资源成员＝转换源」判据句本身本批不动，是否复裁归 06 在册）。⑤本批**代码侧零改动**，归独立批：`CURIO_KINDS` 删两枚、`TIER_QUOTAS` rare 9→7 与总量 104→102（结构锚，用户已裁**净删**）、`feats.tres` 增完美保险行、效果引擎扩签一种效果类型、`grant_segment` 硬编码改订阅式（误标总数减豁免数得有效数，不改写既有计数值）。 |
|
|
||||||
| **v3.19** | 2026-10-19 | **一处误记载订正（用户定性＝写文档时的误记，令改）**：§1.1、§2.2 与 `entities.yaml:629` 三处原写「专长凭证归专长、不归资源」——2026-10-19 考古确认其引入与后续两次改写（`d6c13809`／`b6b43ebc`／`6951632d`）分别只承载机制、子节点定名与术语更名，**无一处含归类裁断记录**，现三处统一改写为「专长在非 Boss 渠道的兑付形态」，不再对此作归类论断。**机制零改动**：非 Boss 渠道仍只给凭证、拿到即开、不可囤积、一局限购与计步保底全部不变，交叉表专长行仍是「凭证形式」。连带两处：完美保险改归专长的依据指针由 §1.1 改指 §1.4（**归属结论不动**）；v2.2 历史行不改写字面，行尾追加更正注记指向本行。第 2 项（§1.3 资源判据句）本批不动，心智模型对齐前不裁，仍挂在 06 在册条目内。 |
|
|
||||||
| **v3.20** | 2026-10-19 | **定名批：「系统资源」立规范名＋第三类改名「补给」（用户裁）**：①「系统资源」定为 GP／钥石／行动点当前值与上限／储备行动点／刷新存量持久量与当次临时量／生命／充能／时沙暂记等"战斗数值以外的数值容器"的规范名，唯一定义处＝[核心循环](../../01-核心循环.md)「系统资源」节（每笔带寿命档＋总线/抽屉两坐标）；旧称「账／账本」「独立资源」「系统数值」全库退役，跨文档引用只写规范名加指路。②第三类由「资源」改名「**补给**」——原类名与系统资源同词，会把"给系统资源加一笔的件"误读成"系统资源本身"；类定义改为"给某一笔系统资源做一次性加仓的凭证（转换源）"，§1.3／§1.4／分类表／交叉表／凭证件表同步换代，§1.5 保留命名沿革备查。**机制与数值零改动**：五件凭证写入的账目、配额、寿命档全部不变。③连带：术语表补「系统资源」「补给」词条＋节名改「系统资源与经济」；02-系统清单奇物行换代；entities.yaml categories 按 owner 同步。④v2.5／v3.2 历史行不改字面，行尾追加更正注。⑤**代码零改动**——`CURIO_KINDS` 的 kind 字面是账名（gp/ap/heal/refresh/rap/time_sand）不是分类名，不受本次改名影响。 |
|
|
||||||
@@ -335,38 +335,3 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 教学位掷骰自洽（用户拍板：代码不动、文档对齐）：删除"教学位/首遇位固定不掷"豁免口径，教学位地精数量明确为开战掷骰区间 [1,2]；D0 行数量列改 [1,2]；Boss 血量锚 Σ=153.5 补逐数验算（区间期望口径下闭合） |
|
|
||||||
| v0.3 | 2026-09-15 | 雾格残留清理：关闭「待拍板」的雾相关供给验算失义条目（原供给与对账验算含雾板分层、雾成本负担比等输入分量）；第二关新内容投放缺口条目改为引用「已从设计中移除的机制」（见不做清单）。曲线规则、供给带与对账义务不变 |
|
|
||||||
| v0.4 | 2026-09-15 | **护甲等级批（与战斗结算 / 敌人系统 / registry 同批登记）**：生存链区间模型补记护甲等级掷点带宽口径——峰值/谷值构成各含最坏/最好掷点带宽；EV 中性引入成文（期望伤害对齐现行表值、现行行值不重调，折扣档位与掷点形式定稿前区间扫描维持全额口径、带宽项随定稿批补扫，"零红档"验收与三档判定式不变）；调参联动表新增"护甲等级 ↔ 攻击基线 ↔ 区间带宽"一行 |
|
|
||||||
| v0.5 | 2026-09-16 | **护甲等级掷点批·定稿落地（与战斗结算 / 敌人系统 / registry / 切片代码同批）**：带宽口径改写为"换装点锚定"——掷点形式与档位定稿（d20 / 缺口 1-3→×0.75 · 4-7→×0.5 · 8+→×0.25 / nat20 暴击 ×2 恒全额），基准 AC10 自带约 −21% 敌方输出期望（AC11 25% / AC12 28.75%），对比退役的 defense_up 满层 −60% 减伤墙为结构性削弱 + 伤害下限使零承伤轮结构性消失，方向性偏移与加难杠杆扫描合并处理、不单独重调行值；带宽补扫义务含暴击档与折扣档（并入加难扫描批）；护甲等级行值：主角 10（暂定）、敌方首关 0（暂定，正式行值归怪物设定批）；调参联动表"护甲等级"行改定稿口径；调参表主角表行与状态强度行同步（减伤 −30 → 护甲强化 +1 AC ×2 层） |
|
|
||||||
| v0.6 | 2026-09-16 | **敌人技能池批（与敌人系统 / 战斗结算 / 增益状态 / registry / 切片代码同批）**：曲线纪律两处改写（关间台阶"既有敌种新行为环段" → "既有池新技能"；关内坡度"保持行为环读数不变" → "保持技能池 EV 读数不变〔权重即旋钮、EV 重锚随批登记〕"）；Boss 约定改专属池承载（独占技"硬化" + 权重轮廓，旧"专属四拍环且含蓄力拍"退役）；调参表敌人行值表"行为环"列改"技能池（权重）"列并落建议池行值，新增"技能池投值"四行（池权重 / 技能冷却 / 保底 M / 池 EV 锚——含闸长期速率实测登记：地精 1.106〔保底闸抬升〕/ 熊地精 1.000 / 酋长 1.024）；重击倍率注记随倍率归技能行删除；区间模型受伤峰值/谷值构成改按含闸长期速率复核口径；行值零改动（EV 中性锚定维持，重锚与权重投值随加难扫描批合并处理） |
|
|
||||||
| v0.7 | 2026-09-17 | **分支节点图批（L2 幽暗地域内容批——与切片代码 / registry / 关卡节点地图 / 06 待办同批）**：第二关深度轴行值填充收口（原 P1 后置项）——图版编号 D0–D8 九节点，战斗/Boss 七坐标在敌人表与棋盘表各有精确行（跨表校验强制）；新敌种巨蜘蛛 giant_spider（群行 [2,3]、首遇位固定、轻甲）与 Boss 蛛化卓尔精灵 drider（重甲、血量 175 = r_boss provisional 锚）；既有敌种 bugbear 池新技能突刺（兄弟精池差异化——关间台阶纪律两半均兑现）；新技能行撕咬（×1.5 冷却 1）/ 毒爆（×2.5 冷却 4，蛛化卓尔精灵专属池独占）；技能池投值表 / 棋盘参数表随批扩列，L2 池 EV 锚登记静态份额（≈1.28/1.11/1.33/1.67，含闸速率待抽样）；首遇位绿档冒烟断言落地（基线 0 加成完美档 12 种子首遇战全胜且零踩雷）。全部行值 provisional，L2 整关通关率读数随批实测记录于切片汇报（精调归加难杠杆扫描批）。〔2026-09-18 注：本条为历史批注——血量 175、撕咬 ×1.5 / 毒爆 ×2.5 等读数已随数值压缩批作废，按数值纪律不再留值，现行值读 `enemy.tres` / `skills.tres`〕 |
|
|
||||||
| v0.8 | 2026-09-17 | **文档降级为模板批（用户拍板，与敌人系统 / 战斗结算同批）**：数值纪律定稿——本文只定规则、取值域与口径，全部具体行值移除、一律读配置表（切片 `data/tables/` 与 registry）；调参表敌人行值十二行整表改行模板（敌种语义注记保留），技能池投值 / 主角表 / 棋盘参数 / 关键投值各表删除"现行值"列改口径登记；Boss Σ 逐数验算（153.5 闭合）移除改"调参日志留档"口径；换装点锚定句去 AC 硬读数；伏击上限、保底 M、教学位区间等散落行值改"读表"。背景：切片 `.tres` 数值压缩批后文档行值已滞后，双写失同步被实证 |
|
|
||||||
| v0.9 | 2026-09-17 | 数值纪律收口批：正文 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），8 处失同步修正——曲线结论与换装点句残留读数改读 enemy.tres / settlement.tres；护甲克制 150/100/50 与联动表 d20 ×2 / 主角 10 / 敌 0 改读表（消双写）；元进度换算率 +10≈1 轮 / 翻倍≈减半改 registry / 调参日志口径；**normal 模拟档目标带 [30,50]→[10,25] 用户拍板落文，旧读数 60% 删除（压缩批后失效，重测随验收批另批登记）**；通关余量带 p90≤13 / p10≥3 压缩前绝对血量带改相对量口径（含验收标准节同步，清单外顺手修正） |
|
|
||||||
| v0.10 | 2026-09-18 | **元进度定稿批（与 元进度 v1.0 / registry / 06-待办清单 同批）**：元进度接口预留节改定稿口径——区间平移换算率启用（带平移，判读口径不变），换算率表首版三行与护甲行强条目指路 registry `meta_progression_conversion_table`，数值标定归元进度设计批；P2「区间平移换算率定稿」行同步改剩余面口径。曲线规则与行值零改动 |
|
|
||||||
| v0.11 | 2026-09-18 | **甲效矩阵用户调参批同步（零代码，事实源 settlement.tres 五格改值——详见[战斗结算](../战斗循环/战斗结算.md) v0.15）**：正文克制矩阵节与调参表联动行「克制/中性/被克三档」措辞改五档（克制 / 弱克制 / 中性 / 弱被克 / 被克，档值读表）；联动义务面扩写——矩阵档值变更与敌种护甲变更同列，都必须复算 Boss 与普通战的击杀区间。敌种甲类型行值零改动 |
|
|
||||||
| v0.12 | 2026-09-18 | **数值语言拍板批·甲效矩阵加法核换装同步（零行值改动——与 01-核心循环 数值语言条款 / 元进度 / registry / 06-待办清单 / 切片代码同批）**：正文克制矩阵节与调参表克制矩阵行两处五档措辞改三档加法（克制 / 中性 / 被克三档加法修正 +1 / 0 / −1 点，量纲由百分比改整数点数）；重定价义务面扩写——矩阵加法修正点数随攻击成长的重定价与敌种护甲变更同列，均须复算 Boss 与普通战的击杀区间 |
|
|
||||||
| v0.13 | 2026-09-19 | **技能池节奏体验验证批（与 06-待办清单 / tools/skill_rhythm_audit.py / smoke/rhythm_batch.gd 同批，零行值改动）**：06 待办「单拍行为环的体验验证（改型：技能池节奏体验验证）」解决移除——判读带用户拍板（过旱 = 战斗整体全敌人零特殊技；过涝 = 连续特殊技无普攻基底）；调参表「池 EV 锚」行登记 60 种子正式读数（份额对表 / 保底零越界 / 过涝无信号 / 过旱归短命杂鱼生存时长）；**方法论规则成文：节奏/EV 类日志读数须 ≥50 distinct seeds**（4200 系 10 种子×网格重复曾产生地精一伙 0/484 突刺假象，4300 系复跑证伪——与 armor_roll 种子偏置发现同族，见 registry rng_service 关联面） |
|
|
||||||
| v0.14 | 2026-09-20 | **伏击单轮上限删除批同步（零行值改动——上限行值整体退役）**：关键投值节单轮伏击授予上限改述不设上限；原 advantage_per_round_cap 对账供给面随批作废 |
|
|
||||||
| v0.15 | 2026-09-20 | **格面资源八型批同步（零行值改动——与敌人系统 / 战斗结算 / 地图战斗资源 / 行动经济 / registry / 切片代码同批）**：① 受伤峰值构成去"伏击附加"项（伏击随八型批退役）；② 关键投值节伏击上限措辞改述为群伤负向 = 警觉（敌方护甲等级 +1），原 advantage_per_round_cap 对账供给面维持同日先行作废；③ 警觉与行动点修正两新词的当量对账义务归本系统调参批（随 06 清单「调参批数值点评登记」条执行） |
|
|
||||||
| v0.16 | 2026-09-20 | **基线通关率带分带批 + MC 重投基线（用户拍板方案 A；台账 105〔登记时撞并行会话 103 号，顺延让号〕）**：① 基线通关率带由单一 [10%, 25%] 改为分带——第 1 关 [35%, 55%] / 第 2 关 [25%, 45%]：旧带锚定随机点击画像，普通画像换装基础定式后失锚；推导链 = 真人体验换算（模拟 47%/34% 对应真人新手约六成/五成）+ 与完美档带 [35,65] 错开一档保留元进度爬升空间；② MC 重投基线（N=300/画像/关 · unique · seed0=7000）：完美档 55.7%/39.7% 落 [35,65]、普通档 46.7%/34.3% 落新带——双画像双关全落带，加难紧迫性解除；③ 残留越带唯一项 = L2 完美 Boss 承伤 51.6%（微越 1.6 点，归调参批）；④ 报告 production/qa/mc-reinvest-baseline-2026-09-20.md；工具 level_monte_carlo.gd 增 baseline 参数 + F5 脚注随带同步 |
|
|
||||||
| 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]+带表与验收标准回写现行口径 |
|
|
||||||
| v0.22 | 2026-10-03 | **商店定价公式换代（迭代 11 第②批 GP 商店房重构批——需求卡片 v1.3 P1 共享池/P4 ceil/P5 甲；06 条 2026-10-02 用户裁决）**：商店与 GP 经济杠杆节公式换代 = ceil(基价 × b^(关序−1) × A^(进店已购次数))，A/b provisional 投值 1.8/1.1（原 P5 甲 game-balancer 研究拍板改后置追认——零人工令）；杠杆位表换货架基价四行+价格因子 A/b 两行；分层验收 defer 节补 v0.22 注记（shop=off=legacy 对照 off_n60 逐位 / shop=on 首锚 N=60 双策略带平移归调参批/终局池读数只测不判）。行值零结构改动（shop.tres 扩列不退役） |
|
|
||||||
| v0.23 | 2026-10-05 | **挖掘风险不等式判式换代（迭代14②号卡 T3——与行动经济/战斗结算/registry 同批）**：调参联动表 +6 新增行（旗溢价三件套 δ↔p_perfect↔ap_per_round / η 读数画像联动扩员 / β 带端点↔D_ref↔max_hp↔AC 折算 / 直伤雷三行↔正向同轴行〔同轴镜像比入对账面〕/ clear_blast 区间↔p_perfect / 标中强化池权重〔形态 b 条件生效行〕）；P1 后置「挖掘风险不等式与清图支配性对账重跑」行改判读回执（不等式半边收口=判式重立+β 带检算接替，残留 u=3 β=1.17 登记态；清图支配性维持）；五条经济契约对账段换代 |
|
|
||||||
| v0.24 | 2026-10-07 | **混编行集难度归属注记（敌人表行集多行批·组 A——与 敌人系统 v0.15 / registry / 06 清单同批）**：敌人表行值节新增混编行集难度归属注记——同一坐标多行混编后各行值按既有口径独立生效再叠加（数量区间各行各掷、行集实例总数 ≤ 4），不引入新难度轴或乘区；首个混编行连同 Boss 多行投放归后续内容批，投时行值 provisional 归本文调参口径不变+MC 取证先报批+难度带读数义务。本批零内容投放零数值变更 |
|
|
||||||
| v0.25 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①期望值带表「通关率带」行订正——「现行带：普通档 L1 [35,55] / L2 [10,15]、完美档 [35,65]」与同节「带换代」条及验收标准直接矛盾（2026-10-03 四带甲案已将其正式作废），改四带口径；②里程碑前缀按 2026-10-09 口径删「M-3」四处（判读口径同步条两处、回滚阶梯边界③一处、加难走廊扫描行一处）只留「迭代 5」；③杠杆位表与调参表「pool_shelf 四行」改「六行」（凭证与回复随迭代15② 入架）；④P1 加难杠杆扫描行「扫描未执行」订正——域内取样扫描已随迭代 5 执行（与 Boss 设计节加难走廊行对齐），全杠杆落带扫描未收口；⑤第二关图版注记奖励点「（直通空态）」过期标注删除（奖励点兑付=提升三选一）；⑥两处「见「待办」」悬空指针改指 06-待办清单。 |
|
|
||||||
| v0.26 | 2026-10-09 | 文档正确性审查批（定点）：三处裸「M-4」标签按 2026-10-09 里程碑口径改「Beta 阶段（未排期）」——期望值带节（M-4 排序）、P1/P2 表全局作用域行（M-4 杠杆表）、调参表资源面偏斜行（M-4 杠杆表）；批次登记事实不动 |
|
|
||||||
| v0.27 | 2026-10-09 | **文档卫生批（A5 过期指向收口——用户批准「按推荐做」）**：①调参表「血量锚比率 r_boss」行锚漂移登记尾句「复算与是否收锚归迭代 5 出口判读」改过期注记——迭代 5 已关闭未执行，r_boss 复算与收锚义务挂起、随数值批重开时核销；②期望值带节「期望承伤占比带复验义务随最近的减伤调整批执行」同款改过期注记——所指批次已关闭未执行，复验义务挂起、随数值批重开时核销。两义务内容不删、仅指向挂起 |
|
|
||||||
| v0.28 | 2026-10-12 | **迭代 20 反哺落文批·投放读数登记（用户裁③——数值暂不调整只落内容，只测不判）**：期望值带节新增「迭代 20 投放读数」注记——池换代构成四级 70/25/9/0=104 张（凭证四件入稀有档 +6 provisional）+MC shop=off 止步分布 {1:90, 2:10}→{1:93, 2:7}（通关率 0% 持平，新基线 seed 71000，位移归因曝光槽高档候选加速）；判读与带重锚随曲线调参批，本批零数值变更零带改动 |
|
|
||||||
| v0.29 | 2026-10-14 | **迭代 24 反哺落文批·敌人表修批读数登记（用户裁「全部按呈报落文」——只测不判，数值终值归 M4）**：期望值带节新增「迭代 24 敌人表内容修批读数」注记——N2 普通敌技能投放后 perfect L2 通关 8→13/20、L3 全通 6→10/20（方向符合预期、量级低于二档判读带，倍率 provisional 归 M4）；N3 敌方 attack_type 轴+克制消费后全局平移（重甲 −1/魔法甲 +1/轻甲 0，V5 实测单发恒 ±1，taken 中位上行系构成效应）；N1 (1,2) 降档后 perfect L1 通关 19→20/20。判读与带重锚随 M4 数值批 |
|
|
||||||
| **v0.30** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「HP 账本」→ HP（生命）；「钱包账本归…GP 冒险账本节」→ GP 归…GP 节；「期望账」→ 期望读数——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -116,7 +116,7 @@
|
|||||||
| 封印且留到轮末判定 | **−类型**：标错，该格资源的负向兑付（惩罚） | **+类型**：标中，该格资源的正向兑付（奖励） |
|
| 封印且留到轮末判定 | **−类型**：标错，该格资源的负向兑付（惩罚） | **+类型**：标中，该格资源的正向兑付（奖励） |
|
||||||
| 封印格直接挖开（封印不可逆批 2026-09-19） | 零兑付（四情况④：零惩罚零奖励——标空不判、正向作废） | **−类型**照常（四情况②：只受挖雷一层惩罚——标中不发） |
|
| 封印格直接挖开（封印不可逆批 2026-09-19） | 零兑付（四情况④：零惩罚零奖励——标空不判、正向作废） | **−类型**照常（四情况②：只受挖雷一层惩罚——标中不发） |
|
||||||
|
|
||||||
矩阵的定义归本文；把矩阵跑起来的路由（结算队列、判定基线、逐行兑付）归[战斗结算](战斗结算.md)的授予段。blast 型负向 = 警觉。矩阵只描述现行规则；被本矩阵取代的旧体系与历次结构变更（撤旗退役、伏击换装等）一律记版本历史，不在正文复述。
|
矩阵的定义归本文；把矩阵跑起来的路由（结算队列、判定基线、逐行兑付）归[战斗结算](战斗结算.md)的授予段。blast 型负向 = 警觉。矩阵只描述现行规则；被本矩阵取代的旧体系与历次结构变更（撤旗退役、伏击换装等）只进 git 提交史，不在正文复述。
|
||||||
|
|
||||||
举证：本节为枚举与路由定义，无计算。
|
举证：本节为枚举与路由定义，无计算。
|
||||||
|
|
||||||
@@ -249,32 +249,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 可选类注入递减基准对齐代码：逐图减半改为按实际获取件数递减；补明注入覆盖即时身份与"发放即获取、未挖到不计数"语义；验收标准首件保证改"必注入"口径 |
|
|
||||||
| v0.3 | 2026-09-15 | 雾格残留清理：关闭「待拍板」的雾格相关定价约束三条失义条目与随之取消的奖励配置表档位过滤门限 t_fog_min |
|
|
||||||
| v0.4 | 2026-09-15 | **格面资源批（用户拍板，2026-09-15）**：① 核心抽象改为格面资源（CellResource）——安全格与危险格一视同仁、单一类型池装板期摇定，极性由「动作 × 格型」矩阵决定（开安全格/标中雷 = 正向，开危险格/标错安全格 = 负向），取代踩雷固定伏击、标中固定削弱、标错三选一哈希反噬三套固定兑付；② 五型字典（attack/defense/heal/blast/weaken，正负各一行；weaken 负向 sapped 为新行，heal 负向为不经增益状态的直伤）；③ 封锁格（初始展开格）恒无资源；④ 清图奖励改述为整图、可配置可替换的清图奖励对象，图类型差异化插槽保留；⑤ **可选类道具（刀/治疗包）整体删除**——供给控制器、注入概率、按板保底、关卡域库存、道具使用窗口的数据面全部下线，RewardConfigTable 随批废止；功能道具经其他渠道加入的结构位登记 P1；⑥ 行动经济对账锚与难度曲线重推义务随批登记（见 registry 修订记录） |
|
|
||||||
| v0.5 | 2026-09-16 | 更名批（用户拍板 2026-09-16）：系统更名"奖励道具经济"→"地图战斗资源"——定义双向（正负由动作×格型决定）、格面承载、只在战斗结算生效；文件同步重命名；「待拍板」系统更名条目关闭；英文代号 REWARD_ITEM_ECONOMY 暂沿用 |
|
|
||||||
| 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 条目 reward_table mvp_content）；② 文档表格只锁字段语义与取值域，不再列具体数；③ 与 `增益状态.md` v0.7 / 旧 registry 条目 同批落地——五步收口（`.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.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 负向的伏击上限护栏与溢出行协议措辞删除，改直授无上限 |
|
|
||||||
| v0.14 | 2026-09-20 | **格面资源八型批（用户拍板——与敌人系统 / 战斗结算 / 行动经济 / registry / 切片代码同批）**：① 七型→八型（+action 行动点——正向 ap_up 下轮行动点 +1、负向 ap_drain 迟滞 −1，经 action_economy 排队、下一轮兑现）；② blast 负向 ambush_double 退役换装 enemy_alert 警觉（敌方全体护甲等级 +1/层，`status_effects.tres` alert 行，side-wide）；③ 极性矩阵/八型字典/负向即时节/候选集合/调参表/结构冻结/验收标准同步；正向权重合计 67→74（attack 14 / defense 11 / blast 16 / heal 2 / weaken 8 / pierce 8 / magic 8 / 清障炸药 1 / action 6） |
|
|
||||||
| v0.15 | 2026-09-20 | **格面资源九型批（GP+商店房批，用户拍板——格面 GP 获取途径推翻提案"格面池零修订"推荐：定位"低概率惊喜获取"、量与战斗掉落相当；与战斗结算 v0.23 / 冒险结构 v0.5 / 关卡节点地图 v1.1 / registry / 切片代码同批）**：① 八型→九型（+gp 金币——正向 gp_gain 金币袋 weight 2、负向 gp_loss 破财 weight=0 纯字典，power 语义 = 战斗内 GP 缓冲 ±，兑付编排归战斗结算、钱包账本归冒险结构）；② 负向恒即时节补 gp 两向缓冲语义（战斗完成随 gp_dropped 统一到账，无库存语义不变）；③ 候选集合/调参表/结构冻结（九型封闭枚举）/验收标准同步——正向权重合计 74→76；字典 16 格→18 格 |
|
|
||||||
| v0.16 | 2026-10-03 | **偏运硬币权重投影注记（迭代 11 第①批同调实施批——需求卡片 §十连带；池结构与冻结项零触碰）**：同调被动件「偏运硬币」装配时对装板摇号（roll_board 身份批，reward_roll 封闭流）注入池内权重投影——稀有正向 kinds {heal, gp, pierce, magic} 行 weight +N（表值 magnitude，provisional），危险格与安全格仍同池同分布、池成员集合与取号次数零变化（reward_economy._biased_cell_rows，luck_bias=0 时逐位返回原行集=off 态零扰动）；摇号权重合计面 76 为九型基准值、投影后合计随 N 浮动（逐行归因不受影响——抽签按调整后池权重消费同一取号） |
|
|
||||||
| v0.17 | 2026-10-07 | **类型层身份裁决（道具三层重设计·地图层开场题——案甲用户裁，与 05-不做清单 v1.4 同批）**：设计目的节补「类型层身份」段——本层=规划素材层，未开格类型经微光可见（只读类型不读危险格与安全格，呈现归 HUD框架），「读敌拍板、抢类型」为正式设计意图；05 清单第 14 条同批收窄移出禁止面；微光实施归呈现批（06「未开格类型徽章呈现时机」条在案） |
|
|
||||||
| v0.18 | 2026-10-07 | 地图层内容题①裁案A（用户裁）：兑付形态差异化方向转正——九型枚举不动、同型兑付形态将拉开（pierce/magic 同构为首要对象），具体形态设计归用户、实施归后续批次；九型字典节补方向注记 |
|
|
||||||
| 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 依赖表对齐） |
|
|
||||||
| v0.23 | 2026-10-12 | **玩家向显示名跟随批（锻造工坊裁决会话 8a 连带·D 项执行）**：defense 正向行 `ac_up` 显示名「护甲强化」→「盾牌加护」（`reward.tres:22` / `status_effects.tres:18` 同批改名，`smoke_all.gd:1199` 断言同步；用户裁口径=临时叠层 AC 状态不该叫"护甲"，附带约定「加护」=AC 判定层、「护盾」=吸收层不得混用）；本文九型字典表与设计意图句跟随改现名；另 art-bible.md §4.6.1/§4.6.2 键名列、07 体验验证清单⑫同批跟随。机制与数值零改动 |
|
|
||||||
| v0.24 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 2 处——四档概率结构与保底节「任何概率提升不得改变本档保底承诺」改「禁止改变」；验收标准加载护栏条「加载报错中止」改「加载时返回错误并中止」。机制与数值零改动 |
|
|
||||||
@@ -96,7 +96,7 @@
|
|||||||
|
|
||||||
### 剩余次数怎么倒数：按结算次数衰减
|
### 剩余次数怎么倒数：按结算次数衰减
|
||||||
|
|
||||||
每个状态实例自带一个倒数计数——剩余结算次数（本文说的"衰减"就是它逐次递减、归零消失）。它不承诺"活几轮"，而是数"经历过几次轮末结算"：每轮结算先让状态起作用，随后计数减一，减到零状态即被移除。持续 1 的状态就是"一次性"：在授予它的那轮结算里生效一次，轮末消失。MVP 时期六行内容均为一次性（削弱后改续时——见版本历史；2026-09-20 起主角增益两行也走续时、duration 表值仍为 1——重复拿等于重新获得一次当轮增益）；跨轮持续的状态，寿命由表行初始值表达，给几就活几次结算。
|
每个状态实例自带一个倒数计数——剩余结算次数（本文说的"衰减"就是它逐次递减、归零消失）。它不承诺"活几轮"，而是数"经历过几次轮末结算"：每轮结算先让状态起作用，随后计数减一，减到零状态即被移除。持续 1 的状态就是"一次性"：在授予它的那轮结算里生效一次，轮末消失。MVP 时期六行内容均为一次性（削弱后改续时——见 git 提交史；2026-09-20 起主角增益两行也走续时、duration 表值仍为 1——重复拿等于重新获得一次当轮增益）；跨轮持续的状态，寿命由表行初始值表达，给几就活几次结算。
|
||||||
|
|
||||||
```
|
```
|
||||||
一轮结算：查询生效清单 → 逐行兑付（层数 × 行值）→ 轮末衰减（全部实例剩余次数 −1）→ 归零实例移除
|
一轮结算：查询生效清单 → 逐行兑付（层数 × 行值）→ 轮末衰减（全部实例剩余次数 −1）→ 归零实例移除
|
||||||
@@ -126,7 +126,7 @@
|
|||||||
|
|
||||||
| 例子 | 容器输出 | 消费侧读法 |
|
| 例子 | 容器输出 | 消费侧读法 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 暴走叠两层 | +(2 × enrage 行幅度)（读表；越出单行取值域，原样输出） | 压在天花板 +100% 上：敌方输出乘区封顶 ×2（削弱已改续时——"叠两层压地板 −100% 归零"的读法随 2026-09-18 结构修复批退役，见版本历史） |
|
| 暴走叠两层 | +(2 × enrage 行幅度)（读表；越出单行取值域，原样输出） | 压在天花板 +100% 上：敌方输出乘区封顶 ×2（削弱已改续时——"叠两层压地板 −100% 归零"的读法随 2026-09-18 结构修复批退役） |
|
||||||
| 主角盾牌加护再拿一份 | 层数恒 1、剩余结算次数重置（refresh——2026-09-20 主角增益续时批） | 不经任何池：掷点判定阈值 = 主角基准（读 hero 表）+ 层数（现行 +1——上限 2 层叠读取法退役，局内可达 AC 上限 11） |
|
| 主角盾牌加护再拿一份 | 层数恒 1、剩余结算次数重置（refresh——2026-09-20 主角增益续时批） | 不经任何池：掷点判定阈值 = 主角基准（读 hero 表）+ 层数（现行 +1——上限 2 层叠读取法退役，局内可达 AC 上限 11） |
|
||||||
|
|
||||||
容器还有一条快照纪律：实例的幅度、初始次数、量纲在授予那一刻从表行拷贝。战斗中配置表即使被重载，已授予实例不受任何影响，只影响后续授予。
|
容器还有一条快照纪律：实例的幅度、初始次数、量纲在授予那一刻从表行拷贝。战斗中配置表即使被重载，已授予实例不受任何影响，只影响后续授予。
|
||||||
@@ -149,7 +149,7 @@
|
|||||||
| 状态 | 效果一句话 | 发给谁 | 幅度（现行值） | 时限 / 合并 | 来源类别 |
|
| 状态 | 效果一句话 | 发给谁 | 幅度（现行值） | 时限 / 合并 | 来源类别 |
|
||||||
|---|---|---|---|---|---|
|
|---|---|---|---|---|---|
|
||||||
| attack_up 增伤 | 主角攻击提升 | 主角 | 见 `data/tables/status_effects.tres` attack_up 行 | 时限/上限读表 / 刷新（2026-09-20 续时批 stack→refresh，层数恒 1） | 安全格 |
|
| 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） | 安全格 |
|
| 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 型负向） |
|
| alert 警觉 | 敌方护甲等级 +1/层 | 敌方 | 见 `status_effects.tres` alert 行 | 1 结算 / 叠加读表 | 踩雷 / 标空封印（blast 型负向） |
|
||||||
| weaken 削弱 | 敌方攻击被削弱（同名重复标中只刷新剩余次数、层数恒 1） | 敌方 | 见 `status_effects.tres` weaken 行（取值域 [60,85]，取负生效） | 时限读表 / 刷新（2026-09-18 续时定案） | 封印标中 |
|
| weaken 削弱 | 敌方攻击被削弱（同名重复标中只刷新剩余次数、层数恒 1） | 敌方 | 见 `status_effects.tres` weaken 行（取值域 [60,85]，取负生效） | 时限读表 / 刷新（2026-09-18 续时定案） | 封印标中 |
|
||||||
| enrage 暴走 | 敌方攻击提升 | 敌方 | 见 `status_effects.tres` enrage 行 | 时限/上限读表 / 叠加 | 标空封印反噬 / 踩雷（attack 型负向） |
|
| enrage 暴走 | 敌方攻击提升 | 敌方 | 见 `status_effects.tres` enrage 行 | 时限/上限读表 / 叠加 | 标空封印反噬 / 踩雷（attack 型负向） |
|
||||||
@@ -240,24 +240,3 @@ empower 与 fortify 是敌方技能池增益技在容器侧的数据落点（技
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 状态表四行改六行：补暴走（enrage，敌方 +25%）与失衡（off_guard，主角承伤 +25%）两行，承载[战斗结算](战斗结算.md)标错反噬机制（2026-09-12 批已上线）；来源类别四选一改五选一（新增标空旗）；连带更新"MVP 四行/四类"表述与调参表 |
|
|
||||||
| v0.3 | 2026-09-15 | 并存分支补容量语义（实例数上界 = 受理授予数，有界确定、无满层语义）；P2 后置登记并存行高频授予（持续伤害类）的容量复核 |
|
|
||||||
| v0.4 | 2026-09-16 | **护甲等级掷点批·换装（与战斗结算 / 难度曲线与Boss / registry / 切片同批）**：defense_up（减伤 −30% ×2 层）整行退役换装 ac_up（护甲强化 +1 护甲等级 ×2 层）——unit 新增 ac 量纲（护甲等级阈值轴，幅度域 [−20,20] 且非 0，不入任何池），消费面 = 战斗结算护甲等级掷点判定；例子表与调参表同步；"叠满减伤触池底"的免伤墙随换装结构性消失。注：sapped 行与极性路由措辞的文档同步归增益状态既有修订批（本批不扩 scope） |
|
|
||||||
| v0.5 | 2026-09-16 | **敌人技能池批（与敌人系统 / 战斗结算 / 难度曲线与Boss / registry / 切片同批）**：状态表六行 → 九行——新增 empower（蓄力：敌方 +100% 入 enemy_output 池）与 fortify（硬化：敌方 +100% 入**敌方防御池 enemy_defense** 新池——硬化技载体，主角攻击乘区消费面归战斗结算）两行敌方技能施放增益，来源类别 = 敌方技能施放（技能行 buff_ref 引用、施放时长由技能行 buff_duration 覆盖——技能冷却与增益持续两个计时器）；两行 duration 2 = 1 个有效增益拍的容器口径成文；**顺手清偿 v0.4 挂起的 sapped 文档同步**（2026-09-15 格面资源批入表未登记的文档漂移——状态行表与调参表补行）；P1"刷新类首批内容行"核销（empower/fortify 即首批） |
|
|
||||||
| v0.7 | 2026-09-17 | **数值压缩批·文档同步（与 doc-conventions.md §5 数值纪律·强制收口条款同批）**：ambush 幅度 +3 flat → +1 flat（量纲未变、压缩倍数三阶下发，参见 `data/tables/status_effects.tres` 注释）。**双写失同步收口**：① 状态行表与调参表数值列改指路存根（指向 `data/tables/status_effects.tres` 与 旧 registry 条目 status_effect mvp_content）；② 调参表删除「现行值」列（敌人系统 v0.6 先例），仅保留 schema 模板与取值域；③ 与 `地图战斗资源.md` v0.7 / 旧 registry 条目 同批落地——五步收口一并兑现 |
|
|
||||||
| v0.8 | 2026-09-17 | **数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 `data/tables/*.tres` 与 registry），8 处失同步值修正**——幅度例"两层 +50% 合计 +100"改"2 × 单行幅度（读表）"；削弱例"−130 个百分点"改"−(2 × weaken 行幅度)（读表）"；护甲例"AC10 → AC12（期望减免 21.25% → 28.75%）"改"基准 AC（读 hero 表）+ 层数"、派生读数删除；状态行表"时限/合并"列 1 次/×2/×16/×1 字面量改读表措辞；defense_up 退役条目删"−30%"数值；"两行 duration = 2"改"duration 表值（读表）"；empower"×2"幅度与调参表"AC10 → 11 → 12"、"2 次 = 1 个有效增益拍"同步指路化 |
|
|
||||||
| v0.9 | 2026-09-18 | **战斗数值结构修复批（2026-09-18 盘问会话用户拍板，与战斗结算 / registry / 切片代码同批）**：三行语义改写（数值全部 provisional 归状态层重设计批）——① off_guard（失衡）换装 AC 轴：unit percent→ac、退出 hero_defense 池（effect_pool_map 删键，池清空结构保留），状态行表与调参表同步，"标错反噬三池"措辞改"三行"；② fortify（硬化）符号纠正：旧正值入池实际 ×2 翻倍与"硬化=减伤"语义相反，改负值后主角攻击折半（正负号语义成文：负值 = 减伤方向）；③ weaken（削弱）叠层改续时：stack→refresh、duration 表值 2——同名重复授予只刷新剩余次数、层数恒 1，×2 叠满池触底 ×0 的免伤轮结构性根治；消费侧例子表"削弱叠两层压地板"改"暴走叠两层封顶 ×2"（削弱叠层读法退役）；"叠层不续命"对削弱不再适用，行动经济联动句随之失效；调参表一次性/叠层上限两行措辞同步 |
|
|
||||||
| v0.10 | 2026-09-19 | **技能池新效应词汇批（用户拍板——设计权威 proposal-status-vocabulary.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 词汇表/增益状态.md〕 v1.0，与 敌人系统 / 战斗结算 / registry / 切片代码同批）**：off_guard（失衡）新增第二来源类别 = 敌方技能施放（妨害技"蛛网束缚"的容器落点——首实装于 L2 Boss 蛛化卓尔精灵池；duration 由技能行 buff_duration=2 覆盖 = 1 个有效结算，empower/fortify 同款口径）；容器语义零改动——同构实例、side 路由照常，妨害技零新状态行（乏力 sapped 留作妨害第二词汇，暂无载体） |
|
|
||||||
| v0.11 | 2026-09-20 | **格面资源八型批（用户拍板——与敌人系统 / 战斗结算 / registry / 切片代码同批）**：① 状态行表 ambush 行 → alert 警觉行（敌方护甲等级 +1，ac 量纲，side-wide）；② 标空旗路由措辞纠正（2026-09-15 极性矩阵后已无三选一反噬，本批顺手收口）；③ 敌人系统的伏击量纲定义/上限锚义务面随伏击退役移除 |
|
|
||||||
| v0.12 | 2026-09-20 | **主角增益只续时不叠层批（用户拍板「主角的其实也一样，都是按照叙事的方式，不要有叠层；只续时不叠层，变相削弱主角性能可接受」；与 status_effects.tres / smoke / registry / 06 清单同批）**：① attack_up（增伤）/ ac_up（护甲强化）两行 stack_policy stack→refresh——重复授予层数恒 1、剩余结算次数重置，对齐削弱 2026-09-18 续时定案；至此主角可重复获取的增益与减益合并语义统一（叠层策略仅剩敌侧 alert / enrage / off_guard / sapped 等行）；② duration 表值 1 与 max_stack 2 不动（refresh 下 max_stack 不消费——weaken 先例；dur=1 下续时表现为重复拿重置当轮倒数，跨轮延续随将来 duration 拉长自然显形，数值归状态层重设计批）；③ 影响面：增伤不再 +100%（hero_offense 池单层封顶 +50）、护甲强化不再 +2 AC（局内可达 AC 上限 11，AC12 折扣档采样探针随行降为 AC11）、这两行不再可达满层拒绝行；④ 同名状态合并策略表/幅度量纲例子表/调参表两行/联动纪律句/验收"叠层不减钟"条改述；06 清单「叠层不续命的读感」条目解决移除；冒烟三闸全过（ac_up 行断言与 AC 探针改形，无净增断言） |
|
|
||||||
| v0.13 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①设计目的「失衡是个例外」补乏力——主角侧减益为失衡与乏力两行（与「现行九行」节对齐）；②状态行表来源类别列补全极性矩阵负向双分支——alert / enrage / off_guard / sapped 四负向行各补「标空旗 / 踩雷」另一分支（开危险格与标错旗均兑该型负向）；③sapped 行与正文「暂无载体」订正——妨害第二词汇载体已落地（L3 Boss 石君王独占妨害技「大地脉动」，skills.tres earth_pulse→sapped）。注：版本号 v0.6 缺号（v0.5→v0.7）系既有断档不动，另行列呈报。 |
|
|
||||||
| v0.14 | 2026-10-12 | **玩家向显示名跟随批（锻造工坊裁决会话 8a 连带·D 项执行）**：`ac_up` 状态显示名「护甲强化」→「盾牌加护」（`status_effects.tres:18` 同批改名；用户裁口径=临时叠层 AC 状态不该叫"护甲"，附带约定「加护」=AC 判定层、「护盾」=吸收层不得混用）——现行九行节、状态行表、同名状态合并策略表、幅度量纲例子表、联动纪律句五处现役描述跟随改现名；机制与数值零改动（版本历史各行的旧名留档不动） |
|
|
||||||
| v0.0 | 2026-10-11 | 术语统一补扫批（危险格更名收尾，2026-10-11 用户裁无类型划分）：标中旗/踩雷两行「巢穴」表述换代——机制文档巢穴清零 |
|
|
||||||
| —— | 2026-10-09 | 缺号注记：v0.6 未登记（对应批次=未考——v0.5→v0.7 跳号，v0.7 行注引「敌人系统 v0.6 先例」，疑系 2026-09-17 文档降级为模板批未在本文件单独成行，登记见正文），卫生批仅注记不补写 |
|
|
||||||
| v0.15 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 2 处——验收标准「合成不收口」改「合成不设上下限」（同句「不封顶不保底」语义不变）；P1/P2 表并存容量行「随批复核容量读法」改「顺带复核」。机制与数值零改动 |
|
|
||||||
@@ -214,7 +214,7 @@ percent 类（每结算、每层）: E = |层数 × 行值| ÷ 100 ×
|
|||||||
|
|
||||||
**护甲等级掷点：必中、非归零，只吃基础攻击分量**（2026-09-16 定稿落地，判定式与全部数值已拍板；判定对象措辞随敌人技能池批改述）。防守方由此多了一条数值轴——护甲等级（数据键 `armor_class`）：攻击永远命中，没有 miss、没有零收益白回合；只有吃掷点的分量在掷点低于防守方护甲等级时按减伤档位打折，档位再重也不归零。判定式：攻击结算时掷单骰（骰面读表），掷点 ≥ 防守方护甲等级 + 攻击加成 → 全额；掷点 < 护甲等级按缺口（护甲等级 − 掷点）查减伤档位表打折——边界与档值读 `settlement.tres` 减伤档位表，三档皆非零档。暴击：天然最大面（读表）使该次基础攻击分量 ×暴击倍率（读表），双方同规，且天然最大面恒全额（暴击与折扣互斥；天然最大面〔nat20〕暴击是掷点层概念，与技能重击〔池技能〕严格区分——两层禁止混述）。伤害下限：**任何来源的伤害落地**至少 damage_floor（读表，全局 max(damage_floor, ·)——2026-09-20 用户拍板扩全来源：攻击双方、棋盘直伤与爆裂、地形变异、负向反噬；伤害取值域 [1, +∞)，**不设上限**）——"被减伤归零 v=0"零值伤害行语义顺带退役，重档折扣的攻击行在行文本记"被压制"。掷点范围：只有基础攻击分量吃掷点——主角先手攻击的基础分量，敌方技能的基础伤害分量（= 攻击基线 × 技能伤害倍率，普通攻击倍率 1 为特例）；无伤害分量的技能（增益/妨害类）不掷不折；棋盘来源一律无视护甲等级——爆裂、清障炸药、奖励即时伤害、技能必中附加分量（rider，2026-09-19）全部必中全额不掷，这是本机制的边界切口，与"奖励/惩罚必中"同构。护甲等级（数值轴，掷点打折）与护甲类型（属性轴，克制修正）严格分离：护甲类型不做护甲等级映射，克制修正点数读表、消费面不变，两概念在文档、表字段与代码键中禁止混用。数值载体：主角与敌方护甲等级行值读 hero / enemy 表的 armor_class 列（正式行值归怪物设定批，登记[待办清单](../../06-待办清单.md)），ac_up（盾牌加护）在其上加算（幅度/层数读 `status_effects.tres`）。攻击加成（`attack_bonus`）为结构位预留字段，切片恒 0，未来归元进度 / 武器附魔投值。掷点时机在结算战斗段内、每次基础攻击伤害计算时判定，消费 `armor_roll` 封闭流（逐次掷逐次取号，可逐位回放）。
|
**护甲等级掷点：必中、非归零，只吃基础攻击分量**（2026-09-16 定稿落地，判定式与全部数值已拍板；判定对象措辞随敌人技能池批改述）。防守方由此多了一条数值轴——护甲等级（数据键 `armor_class`）：攻击永远命中，没有 miss、没有零收益白回合；只有吃掷点的分量在掷点低于防守方护甲等级时按减伤档位打折，档位再重也不归零。判定式：攻击结算时掷单骰（骰面读表），掷点 ≥ 防守方护甲等级 + 攻击加成 → 全额；掷点 < 护甲等级按缺口（护甲等级 − 掷点）查减伤档位表打折——边界与档值读 `settlement.tres` 减伤档位表，三档皆非零档。暴击：天然最大面（读表）使该次基础攻击分量 ×暴击倍率（读表），双方同规，且天然最大面恒全额（暴击与折扣互斥；天然最大面〔nat20〕暴击是掷点层概念，与技能重击〔池技能〕严格区分——两层禁止混述）。伤害下限：**任何来源的伤害落地**至少 damage_floor（读表，全局 max(damage_floor, ·)——2026-09-20 用户拍板扩全来源：攻击双方、棋盘直伤与爆裂、地形变异、负向反噬；伤害取值域 [1, +∞)，**不设上限**）——"被减伤归零 v=0"零值伤害行语义顺带退役，重档折扣的攻击行在行文本记"被压制"。掷点范围：只有基础攻击分量吃掷点——主角先手攻击的基础分量，敌方技能的基础伤害分量（= 攻击基线 × 技能伤害倍率，普通攻击倍率 1 为特例）；无伤害分量的技能（增益/妨害类）不掷不折；棋盘来源一律无视护甲等级——爆裂、清障炸药、奖励即时伤害、技能必中附加分量（rider，2026-09-19）全部必中全额不掷，这是本机制的边界切口，与"奖励/惩罚必中"同构。护甲等级（数值轴，掷点打折）与护甲类型（属性轴，克制修正）严格分离：护甲类型不做护甲等级映射，克制修正点数读表、消费面不变，两概念在文档、表字段与代码键中禁止混用。数值载体：主角与敌方护甲等级行值读 hero / enemy 表的 armor_class 列（正式行值归怪物设定批，登记[待办清单](../../06-待办清单.md)），ac_up（盾牌加护）在其上加算（幅度/层数读 `status_effects.tres`）。攻击加成（`attack_bonus`）为结构位预留字段，切片恒 0，未来归元进度 / 武器附魔投值。掷点时机在结算战斗段内、每次基础攻击伤害计算时判定，消费 `armor_roll` 封闭流（逐次掷逐次取号，可逐位回放）。
|
||||||
|
|
||||||
EV 参考数不入正文（派生读数，需要时按判定式与现行表值自行复算）；旧 defense_up 的减伤墙已整体退役换装为 AC（无双轨，见版本历史）。微调旋钮 = 档位边界与档位值，不动护甲等级值。换装点锚定：基准 AC（读 hero 表）自带的方向性偏移与[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)已登记的加难杠杆扫描合并处理；其生存链区间模型按掷点带宽口径复核（带宽含暴击档与折扣档），"零红档"验收保留。
|
EV 参考数不入正文（派生读数，需要时按判定式与现行表值自行复算）；旧 defense_up 的减伤墙已整体退役换装为 AC（无双轨）。微调旋钮 = 档位边界与档位值，不动护甲等级值。换装点锚定：基准 AC（读 hero 表）自带的方向性偏移与[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)已登记的加难杠杆扫描合并处理；其生存链区间模型按掷点带宽口径复核
|
||||||
|
|
||||||
**结论**：先合成、再取整、全程非负；吃掷点分量必中非归零、低掷按档位折扣、天然最大面暴击恒全额（倍率读表）、落地伤害保底 ≥ damage_floor（读表）；溢杀丢弃、治疗封顶、死亡即时判定。
|
**结论**：先合成、再取整、全程非负；吃掷点分量必中非归零、低掷按档位折扣、天然最大面暴击恒全额（倍率读表）、落地伤害保底 ≥ damage_floor（读表）；溢杀丢弃、治疗封顶、死亡即时判定。
|
||||||
|
|
||||||
@@ -357,40 +357,3 @@ EV 参考数不入正文（派生读数，需要时按判定式与现行表值
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 标错反噬机制收编（2026-09-12 批已上线）：旗判定批标空分支补"触发三选一确定性反噬"，授予段新增反噬规则正文（三池内容、一次性时效、坐标×板序号确定性派生载体、不走随机流的可回放理由）；P1 后置删除"标错惩罚落地"条目；待拍板"标错惩罚未定案"改写为已定案描述并保留正式侧载体候选注记 |
|
|
||||||
| v0.3 | 2026-09-15 | 明细流水行型清单 13 → 15：补窗口打开锚行 window_open / 窗口跳过锚行 window_skip 的语义、字段与落行时机，服务"窗口段恒在案、零选择记跳过、空库存记跳过"；"无来源即炸"的两层豁免集合（行型四类 / 来源类别四类）成文并说明豁免不等于免检；验收标准窗口段措辞与实现对齐，新增行型封闭与行型新增纪律条目 |
|
|
||||||
| v0.4 | 2026-09-15 | 雾格残留清理：关闭「待拍板」的对账输入雾相关分量失义条目（原对账输入含雾成本负担比与雾板分层等分量）。现行对账输入 = 实测可推理率分布低分位值等现行读数，条款③⑤对账协议与判定式不变 |
|
|
||||||
| v0.5 | 2026-09-15 | 攻击/护甲命名去位置化（全仓统一，跨文档 + registry + 切片代码同批）：攻击分量与充能池 {基础, 伤害A, 伤害B} → {普通, 穿刺, 魔法}（数据键 {base, dmg_a, dmg_b} → {normal, pierce, magic}），敌方护甲 {无甲, 护甲A, 护甲B} → {轻甲, 魔法护甲, 重甲}（数据键 {none, a, b} → {light, ward, heavy}，映射沿教学梯度 none→light / a→ward / b→heavy）；战斗段把甲效表从"三档措辞"改为 3×3 显式矩阵（行 = 攻击类型、列 = 护甲类型，克制 ×150 / 中性 ×100 / 被克 ×50，普通行恒 100）并补语义列；hero_attack 行分量字段 base/dmg_a/dmg_b → normal/pierce/magic；调参表参数名与措辞同步（伤害A→穿刺、伤害B→魔法、"被对位克制"→"被克"）；registry 与 敌人系统/难度曲线与Boss/03-内容规模/切片 schema·tres·core·presentation·smoke 同批改键（旧名仅在本次修订与各文件批次注记中作为"原名"留存） |
|
|
||||||
| v0.6 | 2026-09-15 | **攻击类型与奖励抽象分离**（用户裁定"攻击类型的定义和格子奖励要分离开；开格\|标雷 → 奖励；奖励如何定义是可以修改的；不要将两者绑定"）：修正 v0.5 遗留的焊死命名——攻击类型是**伤害的属性轴**（只决定查甲效表哪一行，定义里不含任何棋盘来源）；充能是**按攻击类型分桶的附加伤害储备**，"谁能充、充哪个桶"归**奖励定义**，开格 / 标中旗 / 踩雷 / 清图一律只作奖励触发源。战斗段：矩阵表去掉来源措辞（语义列改"穿透附魔护甲…"），新增"谁往桶里放东西属奖励定义"一段与"奖励触发源 × 现行奖励内容 × 换算上限"表；授予段：挖格批与旗判定批改为"按奖励定义累加充能计数"并加一句充能归属说明；调参表：穿刺每格 / 魔法每雷两行合并为「充能奖励定义 `charge_grants`」（触发源 → {attack_type, per_unit, cap}），v0.5 落下的 pierce_per_cell / pierce_cap / magic_per_flag 同批作废；新增「待拍板」条目登记充能奖励的正式归属。切片同批：`charge_grants` 承接三字段、`_charge_counts`（只计数）与 `_charge_points()`（按奖励定义投桶）、round_facts 改 `charge_counts` / `charge_points`、冒烟加"奖励定义在位 ×2 + 改投桶行为断言" |
|
|
||||||
| v0.7 | 2026-09-15 | **格面资源批（用户拍板四点）**：① 段序七段 → 五段——道具使用窗口与道具段随可选类道具整体删除（2026-09-15 用户裁定）下线，段序常量与 registry settlement_table 同步修订；② 授予段改述为"结算队列 + 抵消过滤"：开格 / 标旗 / 撤旗入队，标旗后被撤旗的动作不结算（零兑付、行动点不返）；③ 兑付统一走极性矩阵（开安全格 / 标中旗 = 正向，开危险格 / 标错旗 = 负向，字典归奖励道具经济），取代踩雷固定伏击、标中固定削弱、标错三选一哈希反噬三套固定兑付；④ 明细行型 15 → 10（删道具行 / 已消耗未生效行 / 使用被拒行 / 窗口打开锚行 / 窗口跳过锚行），两层豁免集合改两类 + 三类；⑤ 战斗道具背包与库存语义下线，关卡收束只清辅助道具背包；⑥ 收益对照表 flat 类措辞去道具；验收标准改五段全序 + 抵消过滤 + 极性路由正确，删窗口类断言。行动经济 F1 对账锚（伏击共享池）与难度曲线重推义务随批登记（见 registry 修订记录），切片侧修改指导随批产出 |
|
|
||||||
| v0.8 | 2026-09-15 | **护甲等级批（用户拍板登记，只改文档与 registry、不动代码）**：战斗段新增护甲等级掷点规则——必中、非归零，掷点低于防守方护甲等级按减伤档位折扣，没有 miss、没有零收益白回合；只吃基础攻击分量（主角普通分量 / 敌方攻击拍与重击拍基线），穿刺/魔法充能分量不吃；棋盘来源（伏击附加、道具、清障炸药、奖励即时）一律无视；护甲等级（数值轴，数据键 `armor_class`）与护甲类型（克制属性轴）命名区分成文。随机口径修订：结算换算层首次引入回合内随机，可回放契约从"结算路径零随机"改为"封闭随机流可回放"（同种子同输入逐位复现）；开战掷骰属初始化随机维持不变。调参表新增护甲等级掷点 / 减伤档位表 / `armor_class` 三行（全部 provisional 未定值）；伤害行补掷点读数与折扣档位随行留档（行型 10 类封闭不变）；验收标准新增护甲等级掷点与折扣零值归路两条、可回放条改封闭随机流口径；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 | **敌人技能池批（用户拍板，设计权威 proposal-skill-pool.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.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.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.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 | **技能池新效应词汇批（用户拍板——设计权威 proposal-status-vocabulary.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 词汇表/增益状态.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-10-12 | **玩家向显示名跟随批（锻造工坊裁决会话 8a 连带·D 项执行）**：数值载体节 `ac_up`（护甲强化）→ `ac_up`（盾牌加护）——`reward.tres:22` / `status_effects.tres:18` 同批改名（用户裁口径=临时叠层 AC 状态不该叫"护甲"；附带约定「加护」=AC 判定层、「护盾」=吸收层不得混用）；机制描述与数值零改动，版本历史各行旧名留档不动 |
|
|
||||||
| 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 对拍四配置全确定且真实分岔（行数恒等、纯次序位移）；历史基线读数自本批起以段界结账口径为准（重测归曲线调参批） |
|
|
||||||
| 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 第①批全退役、现行恒空，同调装配件不经此域，拆线归实装批；行为描述与代码一致，仅补现状口径 |
|
|
||||||
| v0.0 | 2026-10-11 | 术语统一补扫批（危险格更名收尾，2026-10-11）：②插旗后挖开行「惊动危险格」表述换代 |
|
|
||||||
| v0.29 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 7 处——明细流水节「宁可报错」改「宁可返回错误」；伤害控制器节「全部收口控制器单点」改「全部统一到控制器单点」；护甲等级掷点节「两层不得混述」「两概念在文档、表字段与代码键中不得混用」改「禁止」；边界表「每池独立收口 ±100 百分点」改「每池独立封顶」（与池乘区公式行同词）；调参表护甲等级行「两概念不得混用」改「禁止混用」；行型封闭条「未登记行型不得落行」改「禁止落行」。机制与数值零改动 |
|
|
||||||
| **v0.30** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：图「账本扣费」→ 系统资源扣费；「非伤害账/地图伤害账」→ 非伤害单据/地图伤害单据；节标题「四类动作各归各账」→ 各归各系统资源——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -159,15 +159,3 @@ MVP 不要求本文的闭环：不做清单把战斗动画演出列为 MVP 打
|
|||||||
3. 演出速度档位：逐行兑现的加速与跳过交互（约束：信息载体不可整体跳过）。
|
3. 演出速度档位：逐行兑现的加速与跳过交互（约束：信息载体不可整体跳过）。
|
||||||
4. 来源格可读化的形态二选一：缩略图还是格子高亮（登记时两者并列，未裁决）。
|
4. 来源格可读化的形态二选一：缩略图还是格子高亮（登记时两者并列，未裁决）。
|
||||||
5. 坍塌显形连锁动画与音效的挂点协同，安排在哪个批次合并设计。——已约定：对位批次 = 表现层升级批（P1，随样张锁定的动画方案后；音效侧同口径登记）。
|
5. 坍塌显形连锁动画与音效的挂点协同，安排在哪个批次合并设计。——已约定：对位批次 = 表现层升级批（P1，随样张锁定的动画方案后；音效侧同口径登记）。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v0.2 | 2026-09-16 | 新增「一屏样张的验收标准」：内容清单、五项按序判定与判定回退成文，四件锁定物（角色剪影/动画方案/战斗空间/敌层插入位置）的过判口径落到已冻结口径上（06 清单「样张验收标准未成文」闭合）；依赖与输出表"五区"改"四区"随 UI 收口批同步 |
|
|
||||||
| v0.3 | 2026-09-16 | **敌人技能池批（与敌人系统 / 战斗结算 / HUD框架 / registry / 切片代码同批）**：上游呈现输入清单「敌种姿态资产定稿」行改型——行为环姿态预告（一态与三态）随行为环退役，改「特殊技技能动画定稿」（普通攻击零表示、特殊技攻/防系两型动画映射，暴击掷点层无前置表示）；摇定动画位呈现语义 = 开轮摇定即可见、纯类型级提醒（池与权重不公开），样张验收联动口径不变 |
|
|
||||||
| v0.4 | 2026-09-20 | **敌人卡形态裁决收口批（与 battle.md / HUD框架 / 06 清单同批，台账 99）**：敌人呈现形态拍板全站桩式（无框立绘+底座，主角同站桩、状态小图标挂血条下，卡片式退役）——「前置美术测试是硬前置」节相邻裁定句改裁决已下；样张内容清单「敌人卡两候选形态对照」项划线解除（正式样张按站桩形态单版出样，owner 修订）；判定与回退节第 5 项拆出形态对照半边（已收口）；敌人层插入位置裁决义务保留随样张批 |
|
|
||||||
| v0.5 | 2026-09-30 | **拍板点 3 收口批（GDD 概念覆盖审计——用户裁甲：演出权威定义节落位）**：新增「结算演出与轮间节奏」节（五要素：定义/作用对象与范围/生命周期/关联与边界/状态）——结算演出覆盖层（迭代 6）与轮间结算节奏化（迭代 8 卡⑦：段间 0.3s/段内 0.22s/轮横幅 0.6s+减动效双态）的呈现规则自 06 已收口条目与代码注释收编入现行事实源；段内常量按代码实态 0.22s 登记（06 条目旧记 0.06s 系三轮修改批前值）；常量以代码为事实源。孤儿 1（演出 spec 零承载）随本节解除 |
|
|
||||||
| v0.6 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①输入清单「特殊技攻/防系两型动画」订正——2026-09-19 新效应词汇批已扩三族（攻击系/增益系/妨害系，敌人系统意图呈现节）；②P1「溢出行呈现」改「奖励未生效行呈现」（溢出未生效行型已随 2026-09-20 伏击上限删除批下线，与输入清单行措辞对齐）。 |
|
|
||||||
| v0.7 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 10 处——「死亡不得瞬消」「退场有过程不得瞬消」「不得被遮挡到不可辨」「都不得越过」「不得遮挡数字」「不得在挖掘期抢焦」「不得进入生产」7 处「不得」改「禁止」；「提前收口」「提前裁决收口」2 处改「完成」（样张内容清单/判定与回退节）；结算演出节「MC 对拍口径」改「MC 与基线数据逐项比对」口径。机制与数值零改动 |
|
|
||||||
@@ -282,28 +282,3 @@ Boss 专属身份 = 专属池承载：独占技能 + 权重轮廓（**技能错
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 教学位掷骰口径自洽（随[难度曲线与Boss](../冒险循环/难度曲线与Boss.md)同批修订）：unit_count 字段说明、地精敌种定位与现行行值句中"教学位固定 1 只/固定不掷"改为 ×[1,2] 开战掷定 |
|
|
||||||
| v0.3 | 2026-09-15 | **护甲等级批（用户拍板登记，与战斗结算 / 难度曲线与Boss / registry 同批，不动代码）**：敌人表与主角表 schema 各增 armor_class（护甲等级）字段（取值域随掷点形式定稿，provisional）；三敌种表补护甲等级列（行值未定）；护甲等级（数值轴）与护甲类型（克制属性轴）命名区分成文；结构冻结清单"零随机"措辞按新口径修订——本系统自身语义零随机不变，掷点随机在战斗结算换算层按封闭随机流消费、可回放契约 = 同种子同输入逐位复现；待拍板新增"护甲等级行值未定"条目 |
|
|
||||||
| v0.4 | 2026-09-16 | **护甲等级掷点批·定稿落地（与战斗结算 / 难度曲线与Boss / registry / 切片代码同批）**：armor_class 域定稿 [0, 999]（缺省 0 向后兼容）；主角行值 10（暂定）、三敌种首关行值 0（暂定）——"行值未定"改"暂定值 + 待办"，敌方正式行值归怪物设定批（第一关怪物 AC 相对较低，值待怪物设定投值，登记待办清单）；敌种表护甲等级列同步落值；调参表两行改域与现行值 |
|
|
||||||
| v0.5 | 2026-09-16 | **敌人技能池批（用户拍板，设计权威 proposal-skill-pool.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.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.10 | 2026-09-19 | **技能池新效应词汇批（用户拍板——设计权威 proposal-status-vocabulary.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 词汇表/增益状态.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），定义与承载移交增益状态 |
|
|
||||||
| v0.13 | 2026-10-05 | **技能池执行批（迭代14④——D1-D8 全裁零待裁，与 skills.tres/enemy.tres/registry 同批）**：①池构成表 8 敌种全覆盖（补 L2+L3 五敌种行：巨蜘蛛/蛛化卓尔精灵/灰矮人/钩爪恐魔/石君王——池构成轮廓+定位列，权重数值不登）+护甲列改读表口径（失同步欠账清偿）；②Boss 句改三代错峰口径；③意图呈现节补半血解锁弹出规格句（**Boss 半血解锁新独占伤害技**：字段 unlock_hp_pct〔1,99] 缺省无=无门槛/单向闩/双面过滤/保底不逼锁定/解锁出一次归因行+一次性技能名 toast——D8 只报名不报数值零演出；三 Boss=震地怒击 ×2.5/CD4·遏毒 ×2.0/CD3·岩崩 ×2.5/CD4 案甲 provisional 归调参）；④首拍加权取消〔D2〕杂鱼纹理注销不立文 |
|
|
||||||
| v0.14 | 2026-10-06 | **事件发射点登记（内容数据驱动扩展批）**：半血解锁判定点升级为通用事件 `enemy_hp_threshold` 发射点（对所有带 unlock_hp_pct 字段的敌人逐个发射——非 Boss 专属，Boss 语义留给订阅者条件判定；本批零订阅者，登记归效果引擎事件词汇 16 发射点之一，后续内容批随批接线）。零行为变化。
|
|
||||||
| v0.15 | 2026-10-07 | **行集混编口径批（敌人表行集多行批·组 A 先行——与 难度曲线与Boss / registry / 06 清单 / 切片代码同批）**：①「每个坐标只出一种敌种」规则改写为行集构成纪律三条（行集内 enemy_id 唯一 / 同坐标多行文件内相邻且行序 = 声明序 = 生成序 / 行集实例总数 ≤ 4〔= 各行骰后数量求和，行数不设上限，单行数量域 [1,3] 不变、UNIT_COUNT_MAX 语义改单种数〕）——同坐标多行混编合法（P1 甲 + P4 乙用户裁：Boss 行集同样放开）；②开战生成节改「取出整个行集逐行实例化」口径（生成序 = 文件行序即契约）+ 区间掷定改按行各掷一次（单行行集掷定次数与既有逐位一致——零内容期随机流零变化）；③「敌方效果对全体生效」前提句去同种假设（效果按存活单位逐一生效）；④结构冻结「每坐标恰一敌种」换代、验收标准开战生成与表校验两条同步。知情代价登记：Boss 行集多行后开战叙述取首行 display_name、Boss 节点遭遇骰读首行数量区间（= 全行集骰域）——两读数面随批写出口报告。零内容投放（P3 丙）：本批表内容不变，首个混编行归后续内容批 |
|
|
||||||
| v0.16 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①不负责表「遭遇构成与跨战斗血量保留→关卡节点地图」拆分——跨战斗血量保留归冒险结构生命账本；②敌种表引言「首发敌种共三种」与表内八行不符——补「L2/L3 内容批扩至现行八种」；③P2「精英 / Boss 遭遇编码位」行收口——不设编码位（同层多遭遇由节点编号消解，关卡节点地图 v1.0⑥ 裁决），「随定稿强制核对」前置已解除；④结构冻结节「见待办」悬空指针改指 06-待办清单。注：版本表 v0.15 居首、v0.14/v0.13 在尾的既有乱序不动，另行列呈报。 |
|
|
||||||
| v0.0 | 2026-10-11 | 术语统一补扫批（危险格更名收尾，2026-10-11）：头部「惊动危险格」表述换代 |
|
|
||||||
| v0.17 | 2026-10-12 | **玩家向显示名跟随批（锻造工坊裁决会话 8a 连带·D 项执行）**：enemy.tres 字段表 armor_class 行「ac_up（护甲强化）」→「ac_up（盾牌加护）」——`reward.tres:22` / `status_effects.tres:18` 同批改名（用户裁口径=临时叠层 AC 状态不该叫"护甲"；附带约定「加护」=AC 判定层、「护盾」=吸收层不得混用）；字段语义与数值零改动 |
|
|
||||||
| v0.18 | 2026-10-14 | **迭代 24 反哺落文批（实现报告 §六，用户裁「全部按呈报落文」）**：①调参表敌人表字段集增 `attack_type` 行（枚举 {普通, 穿刺, 魔法}、缺省普通、消费面=敌方技兑付查克制矩阵）+ 主角表 armor_type 行休眠注记换代（矩阵消费面双向在役，现役敌方全 normal 档，三甲型读数差 重甲 −1/魔法甲 +1/轻甲 0）；②Boss 专属身份节「三代错峰」口径扩为**技能错峰两轨**（Boss 独占技轨 + 普通敌错峰轨，N2 毒吐/盾击投放实录）；③敌种表巨蜘蛛族+毒吐、灰矮人族+盾击两行池构成列随 N2 变动；④敌种表增 hobgoblin 缺口登记注（有数据行 (1,3)、无立绘、不在敌种表——已知缺口归敌种内容批）。机制零改动（N2/N3 实现事实登记） |
|
|
||||||
| v0.19 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 8 处——设计目的「敌人若干」改「敌人一至四个（数量随遭遇行集骰定，见开战生成节）」；「报错止动」2 处（行集构成纪律/验收标准表校验）改「返回错误并止动」；「不得混用」2 处与「保底不得逼出未解锁技」改「禁止」；P1 单体寻址「随批裁决」改「顺带裁决」；P2 编码位「已收口」改「已完成」。机制与数值零改动 |
|
|
||||||
@@ -155,18 +155,3 @@ region 型变异是「格子级」的：布置段往候选格域写格子快照
|
|||||||
- 布置域：变异格全在初始展开区外（伤害型 closed_only 由设置顺序结构保障）且不吃危险格；每图至多一种类型；连通片 ≤ pack_max。
|
- 布置域：变异格全在初始展开区外（伤害型 closed_only 由设置顺序结构保障）且不吃危险格；每图至多一种类型；连通片 ≤ pack_max。
|
||||||
- 配套义务闭环（**已作废，2026-10-03 终裁**）：原「定稿批须含反制兑现条目否则验收不通过」随反制道具配套义务一并作废；counter_items 恒空为合法态。
|
- 配套义务闭环（**已作废，2026-10-03 终裁**）：原「定稿批须含反制兑现条目否则验收不通过」随反制道具配套义务一并作废；counter_items 恒空为合法态。
|
||||||
- 全局作用域型（2026-10-04 首发批）：替换制生效——Boss 图恰一行整图变异+零格子级变异标记；普通图 region 路径逐位不变（同种子布置/摇号快照与批前基线逐项比对）；off 态零扰动（effect_value=0 资源摇号与无偏斜逐位相同，白名单三行任何状态逐位不动）；L1 Boss 零全局变异；Boss 图全局池空回落 region；全局取用零取号（确定性，不消费布置随机流）；资源面偏斜正向池合计恒 77。
|
- 全局作用域型（2026-10-04 首发批）：替换制生效——Boss 图恰一行整图变异+零格子级变异标记；普通图 region 路径逐位不变（同种子布置/摇号快照与批前基线逐项比对）；off 态零扰动（effect_value=0 资源摇号与无偏斜逐位相同，白名单三行任何状态逐位不动）；L1 Boss 零全局变异；Boss 图全局池空回落 region；全局取用零取号（确定性，不消费布置随机流）；资源面偏斜正向池合计恒 77。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：删除上一版设计遗留的「待拍板」失义条目十条；变异框架本体不变 |
|
|
||||||
| v0.3 | 2026-09-20 | 首批类型定稿批：四类型两轴×两关（荆棘丛/藤蔓缠绕/岩浆/烬覆）落地；机制枚举化（effect/trigger/placement 三枚举 + 跨字段互锁）；布置段改排战斗初始化第 4 步（2026-09-19 用户拍板棋盘设置顺序）；biome 系命名退役对齐 board_type 词表；反制兑现与全局作用域改排 Alpha；岩浆/冰冻旧占位名退役（冰冻退役、岩浆落位第二关） |
|
|
||||||
| v0.4 | 2026-09-20 | **第三关内容批（与切片代码 / registry / 03-内容规模 / 棋盘生成 / 难度曲线与Boss 同批）**：类型清单加第三关两行——落石（伤害型 flat_damage 3）+ 矿尘（信息型 hide_number 数字遮蔽），凑齐两轴 × 三关（unlock_level 3、地形 deep_underdark）；布量走既有公式（第三关自动 9%，零新配置）；反制道具兑现维持改排 Alpha（counter_items 字段位同批预留）；调参表直伤量行随批补落石 3。行值全 provisional 归 难度曲线与Boss |
|
|
||||||
| v0.5 | 2026-09-21 | **变异布置基数修正批（用户试玩反馈「小图变异格非常多」+基数假设实测证实后拍板）**：数量公式百分比基数由总格数改候选池格数（安全格 − 初始展开区，即实际可挖格）——实测初始展开均值占全板 56–67%，旧基数使有效密度膨胀 4–6 倍（L1 10×10 板配置 5% 实际 30.1%，极端板可挖格 100% 覆盖）；percent 语义 = 占可挖格比例，关卡递增由 per_level_bonus 绝对格数承载；表值零变更（provisional 归 难度曲线与Boss 调参批重标，正式重基线同批） |
|
|
||||||
| v0.6 | 2026-10-03 | **反制道具配套义务作废批（2026-10-03 用户终裁——层级错配失败设计）**：①负责表义务行+§反制道具配套义务节改作废注记并附终裁理由（同调位反制件=冒险周期常驻资源对抗关卡周期局部威胁；变异=受控纯税现状维持）；②counter_items 字段保留恒空=合法态，承载形态待迭代 12 双层 BD 调研重定（变异应对若做只挂局内）；③依赖表秘宝行/P1P2 后置表 Alpha 行/验收「配套义务闭环」条同步作废；④批位移迭代 12（调研前置后重新立项）。连带 秘宝.md v0.8 同批；范围裁定注记见 roadmap 迭代 11+ 行（原 06 条目已收口移除） |
|
|
||||||
| v0.7 | 2026-10-04 | **全局作用域变异首发批（迭代 14 ③号卡——需求卡片裁决 P1-P8+Q1-Q4 全按推荐案）**：①类型清单加行贫矿脉（scope=global 首发型=案A 资源面·微贫向偏斜，effect_value=30 provisional）；②新增 §全局作用域型 语义节（整图承载/替换制/兜底回落/恒定制/资源面偏斜口径/三层预告）；③「每图一型」整图推广=普通图 region、Boss/精英图 global；④候选池门控扩第三维=节点身份（global 行仅 boss/elite 入池，普通节点静默跳过；elite 前向词位零表行）；⑤布置段节补全局决议前置于资源格设置（数据依赖——偏斜旋钮先于摇号定型，零取号）；⑥P1/P2 表 Alpha 行换代已落地（撤 2026-09-19「留 Alpha 再设计」挂起——P1 裁决）；⑦调参表+验收标准+影响面随批；⑧呈现三层承载归 HUD框架.md 同批（横幅+常驻角标+手册行）；⑨遗留知情代价：迭代 12 四件地形应对件在 Boss 图无的放矢（替换制无地形格——Q3 知情代价，registry/调参日志登记） |
|
|
||||||
| v0.8 | 2026-10-04 | **文案常规化修订（用户人闸反馈）**：§全局作用域型 玩家体验句俚语表述（「这层奶薄、枪很肥」）改常规描述——玩家可见三层文案同步（横幅/角标/手册，代码同批）；机制与数值零改动 |
|
|
||||||
| v0.9 | 2026-10-09 | 文档正确性审查批（定点）：P1/P2 表全局作用域行「（M-4）」裸标签按 2026-10-09 里程碑口径改「（Beta 阶段，未排期）」；行其余部分不动（批次登记事实保留） |
|
|
||||||
| v1.0 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 3 处——候选池门控节「不报错、不警告」改「不返回错误、不警告」；零特判原则节「变异不得改写扫雷规则本体」改「变异禁止改写」；验收标准全局作用域型条「快照对拍批前基线」改「快照与批前基线逐项比对」。机制与数值零改动 |
|
|
||||||
@@ -240,16 +240,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：关闭「待拍板」三条雾失义登记（连锁开雾格与雾内旗恒不中、开格事件的变异标记透传、四格态中的两个雾态）——现行连锁与旗判定口径已按"全部安全格"写在正文，开格事件仍携带随格只读的变异标记（通用变异框架保留），格态呈现收窄为已开 / 未开两态。规则本体不变 |
|
|
||||||
| 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` 在案） |
|
|
||||||
| v0.0 | 2026-10-11 | **术语统一批（全库危险格/整图/专长凭证更名，2026-10-11 用户裁）**：首节定义句换代——对内名「雷格」与界面名「惩罚格」统一为「危险格」（怪物巢穴保留为危险格类型名、简称巢穴）；机制零改动 |
|
|
||||||
| v0.6 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 1 处——初始展开铁律表「无格面资源」行「下游不得对它们做任何兑付」改「禁止下游对它们做任何兑付」。机制与数值零改动 |
|
|
||||||
| **v0.7** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「账本归行动经济」→ 系统资源归行动经济；「请账本扣费」→ 请行动经济扣费——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -232,14 +232,3 @@
|
|||||||
- R₀≤cap 闸（2026-10-05 初始展开收窄批）：每张出图自然 R₀ ≤ 该行 r0_max_cap（合法板），或带非法产物标记（accept_worst 诚实降级）；闸触发次数入指标集 r0_cap_rejected。
|
- R₀≤cap 闸（2026-10-05 初始展开收窄批）：每张出图自然 R₀ ≤ 该行 r0_max_cap（合法板），或带非法产物标记（accept_worst 诚实降级）；闸触发次数入指标集 r0_cap_rejected。
|
||||||
- 剃雷域参数化（同批）：剃雷域=出生中心切比雪夫 ≤1+shave_ring_radius 的方域，出图 ring_removed ≤ 域内候选危险格数 (3+2r)²−9；同种子布雷序列与收窄前逐位一致（零 RNG 消费变化）。
|
- 剃雷域参数化（同批）：剃雷域=出生中心切比雪夫 ≤1+shave_ring_radius 的方域，出图 ring_removed ≤ 域内候选危险格数 (3+2r)²−9；同种子布雷序列与收窄前逐位一致（零 RNG 消费变化）。
|
||||||
- 表实一致：配置表字段定义与 `data/schemas/board_gen_table.gd` 一致。
|
- 表实一致：配置表字段定义与 `data/schemas/board_gen_table.gd` 一致。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| 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 启用仍为预留 |
|
|
||||||
| v0.5 | 2026-10-05 | **初始展开收窄批（迭代14①号卡 T7——甲乙混合，用户裁 D1-D5+S1 方案A）**：①反退化规则表「先布后删」行换代（剃雷域=出生 3×3∪外扩 r 环参数化，全域 flood 剃雷退役）+新增「R₀≤cap 重掷闸」行；②调参表 +2 行（shave_ring_radius [0,2] 现行 1 / r0_max_cap 护栏 [9,半板] 现行 45/43/51/59——10×10 经 S1 停机呈报用户裁上调 30→45）；③验收标准 +2 条（R₀≤cap 闸 / 剃雷域参数化+ring_removed 量级）；④改后结构读数入 registry initial_expansion_narrowing 条（R₀ 均值 39.7/37.9/42.8/46.6，收窄自 68.6/83.2；雷密度 19.2-21.6% <25% 相变线；inf 全行达标）；玩法侧零改动（排雷玩法「初始展开恰等」验收原样为真）；裸数字截断路否决退役（D3）不立文 |
|
|
||||||
| v0.6 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 4 处——设计目的「终局不得不猜的一格」改「终局只能猜的一格」（清「不得」词面误中，语义不变）；反退化规则表「开局白给板拒绝」行「不得覆盖」改「禁止覆盖」；生成重试节「质量分不得掩盖功能残废」改「质量分禁止掩盖」；P1/P2 表划线条目「已收口」改「已完成」。机制与数值零改动 |
|
|
||||||
@@ -258,23 +258,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-14 | 自归档 GDD 压缩改写 |
|
|
||||||
| 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.12 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三⑦，用户裁「落文」）**：「停手与储备行动点」节补转存率参数化注记——`finish_round_stop(transfer_pct)` 缺省 100=1:1 逐位同旧；秘宝「储备罐」注入 125=1.25:1（整数除法向下取整，每 4 点剩余 AP 多转 1）。机制结构零改动（参数面已随迭代 22 T3 在役） |
|
|
||||||
| v0.5 | 2026-09-20 | **格面资源八型批同步（用户拍板——与敌人系统 / 战斗结算 / 地图战斗资源 / registry / 切片代码同批）**：① F1 条款 3 改写——原"敌方伏击暴露不等式"随伏击机制退役作废，惩罚当量对账模型归难度曲线与Boss 调参批重立；② 新增「下轮行动点修正」节——action 型格面资源经 queue_ap_delta 排队、下一轮开始兑现（基线 ap_per_round + 净值、下限 0、兑现后清零），跨轮携带量口径改写（RAP 唯一显式携带资源 + 一次性修正队列）；③ 节拍不变式（满停一轮 = 恰好一刷）补扰动注记 |
|
|
||||||
| v0.6 | 2026-10-01 | **失同步清偿 + 跨冒险行动点加成轴节（迭代 10 奖励重构批——与冒险结构 / registry 同批）**：①失同步项清偿——ap_per_round 真实配置 = **8**（action_economy.tres，Package B 2026-09-22 批 6→8 回调，表内批注在案）；v0.2 批 8→6 系最后一次文档面记录，此后配置面单独回调未回写本文，本批补记（rap_refresh_cost 与 ap_per_round 的「满预算停手 = 恰好一刷」节拍耦合以现行 8/8 维持）；②新增「跨冒险行动点加成轴」节——统一冒险加算区扩第四轴（行动点），经战斗开始入参覆盖值通道、只在每场战斗开轮首轮兑现一次；价值锚 = 冒险表 bonus_ap_flat / bonus_cap_ap（迭代 10 三选一 AP 件，全冒险 2 次上限），调参表补跨表行 |
|
|
||||||
| v0.7 | 2026-10-03 | **两 AP 件兑现通道注记（迭代 11 第①批同调实施批——需求卡片 §十连带）**：同调目录两 AP 件兑现通道落位——①工兵晨令（被动·限时）=战斗开始首轮 queue_ap_delta 入队 + 轮始段续队（前 effective_rounds 轮每轮 +1，表值化 P4 甲），复用「跨冒险行动点加成轴」同族排队通道；②掘进蓄能（主动·充能）=grant_ap 当轮加量（同挖掘期 ap_grant 通道），受理闸=战斗域安全开格积点（charge_n 格/点）；账本零新机制（queue_ap_delta/grant_ap 两既有原语），充能扣减经共享账本（attune_charges）同引用直改 |
|
|
||||||
| 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 批六处删「拔旗」时本处漏网 |
|
|
||||||
| v0.0 | 2026-10-11 | 术语统一补扫批（2026-10-11）：「巢穴」机制表述两处换代危险格 |
|
|
||||||
| v0.13 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 3 处——推导节条件二「登记态（落文时点）」改「登记态（写入文档时点）」、「按…纪律落文」改「按…纪律写入文档」；调参表注「任一动作成本不得超过每轮预算」改「禁止超过」。机制与数值零改动 |
|
|
||||||
| **v0.14** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：定义句「这本账」→ 行动点这一笔系统资源；表行「行动点账本」→「行动点（当前池）」；「AP 分两本账」→ 行动点分两笔；扣费入口/事务/休眠表述统一——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -168,7 +168,7 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
|||||||
|
|
||||||
配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +2 格，flat 整数档）随迷雾立项；**类型微光不随视野扩大**（类型先读仍只贴身 8 格，微光锚=可挖域）；提灯载体归 aux_items 新行（登记原文——2026-10-07 用户令改道为独立卡，2026-10-08 裁案A=秘宝·同调位新行落位，见下方实施状态注记；**2026-10-09 用户裁退役**——新目录 15 件未收提灯，fog_lantern 数据行与卡④接线拆除归退役删行批〔实装批〕，功能由新目录普通档「阔视野带」承接，06 登记条在册），呈现面挂「资产升档重产批」（挂账不动）。
|
配套拍板（同日）：魔法提灯=灯甲形态（光照圈外扩 +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 信息件重定批」登记去向就此注销（改道留痕=原提灯载体道具批卡（已按「吸收即死」退役，git 历史可考））。验收线（本篇「验收标准」视野迷雾行）逐条转正式验收：区内完整渲染／区外已开格灰显可读／区外未开格不可见／灯光区随移动跟随／两态结算逐位一致；实机目检人闸（迷雾观感/记忆态可读性/移动跟随流畅度）随出口闸。黑暗区域渲染规格承载 = art-bible §6.5（v3.5）。
|
**实施状态（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）。
|
||||||
|
|
||||||
### 营地覆盖层：四柜台并排（程序占位——视觉终稿归营地视觉批）
|
### 营地覆盖层：四柜台并排（程序占位——视觉终稿归营地视觉批）
|
||||||
|
|
||||||
@@ -288,29 +288,3 @@ HUD框架站在玩家与全部玩法系统之间：挖掘期它是输入的翻
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.17 | 2026-10-13 | **迭代 21 反哺⑤落文（用户裁「按呈报落文」）**：核心规则新增「营地覆盖层：四柜台并排（程序占位）」小节——树淬炼/锻造工坊/秘宝匣/图鉴四柜台结构实态登记（迭代 21 落地），视觉与布局终稿归 HUD 营地视觉批（未立项）；本篇原无营地柜台登记面，随批补缺。机制零改动 |
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：关闭「待拍板」五条雾失义登记（雾图例条目、雾首遇一次性提示、四格态中的两个雾态、雾纹带与已开雾格 tint 残留、雾区全开合并域完成信号）。现行口径 = 格态两态一眼可辨（已开 / 未开）、图例面板只载现行格态与变异语义；通用变异框架的纹带形状通道保留为未来变异类型的呈现位 |
|
|
||||||
| v0.4 | 2026-09-16 | **敌人技能池批（与敌人系统 / 战斗结算 / registry / 切片代码同批）**：敌人卡义务改写——行为环环点拆除（proposal §2.4），意图徽标语义改「本拍摇定结果的动画占位」（普通攻击零表示 / 特殊技类型级提示两型：攻击系 ⚔ / 增益系 ✦），护甲行（护甲类型 + AC）保留常驻；敌方增益显示（蓄力/硬化）入敌卡状态行 + 状态槽图标键增 empower/fortify 两键（状态表九行全映射）；呈现快照敌人字段消费面同步（摇定动作三字段 + effects，池与权重不投影）；上游敌人系统行与验收条目同步 |
|
|
||||||
| v0.3 | 2026-09-16 | 格面资源批 UI 欠账收口（可选类道具与其轮末窗口已随 2026-09-15 代码批删除）：战斗屏布局五区 → 四区（删 E 道具栏行，D 区加宽至约 1036px 并同步装板校验变量）；删道具窗口弹层条款（原位点亮、非模态不入栈）、P0 闭环窗口锚点条目、「道具窗口原位点亮 / 至多选一件 / 禁用件带原因 / 空库存不弹窗」验收行；依赖与输出表的窗口选择提交、道具使用窗口呈现、库存查询义务删除或改述为现行口径（奖励身份投影经 `query_identity` 只读回调，零直读）；关卡末清库反馈义务改载秘宝背包，随秘宝 P0 落地。秘宝预留义务行与「待拍板」登记保持 |
|
|
||||||
| v0.5 | 2026-09-17 | 数值纪律收口批：调参表标注文档自持口径（无表承载常量的唯一事实源声明） |
|
|
||||||
| v0.6 | 2026-09-20 | **敌人卡形态裁决收口批（与 battle.md / 战斗表现 / 06 清单同批，台账 99）**：全站桩形态拍板——B 区主角与敌人均为无框立绘+底座、状态小图标挂血条正下方，英雄卡/敌人卡退役；B 区行、敌人呈现义务行（载体由卡改立绘，意图占位/共享层数各立绘同值/死亡灰化退场等义务面平移）、下游战斗表现交付行、就地更新示例措辞四处同步；攻击值等规划数据仍归 C 区数据框（C 区不动）。呈现快照数据面零改动（消费字段不变，只换呈现载体） |
|
|
||||||
| v0.7 | 2026-09-20 | **表现层三批落地 + 义务清单补行（代码同日三批：样式收敛 / 站桩改造 / 结算演出链）**：呈现义务来源清单补「关卡节点地图」行（节点链进度常显 + 选路覆盖层只读呈现——此前漏登记）；新增结算演出覆盖层（跨区弹道/光带载体，兑现演出因果可视）；减动效承诺落地（UiKit.motion 单点包装全部呈现层 tween 时长，开启时长减半、可挖域呼吸停格；切片期入口 = TunePanel 开关，正式设置层归设置批）。代码侧站桩载体（StandeeView）与卡片退役随 v0.6 裁决执行 |
|
|
||||||
| v0.8 | 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批（已执行完毕，git 历史可查），代码实装另批并行）**：① 战斗屏布局四区 → 三区——删 A 区关卡进度条行（LevelStripView 退役删除，节点链进度呈现移出战斗屏、只留关卡画面）；C/D 区纵向 520 → 548；装板校验变量与实算同步（棋盘区高 504、可用高度 488）；② 呈现义务来源清单「关卡节点地图」行改承载口径——节点链进度由关卡画面选路覆盖层节点态承载（暗金已过 / 金当前 / 候选下一跳通道亮金 / Boss 旗朱描边），不另设进度条组件；③ 「四区」措辞全线改「三区」（负责表、节题、结构冻结、验收、下游战斗表现交付行），双舞台常驻语义不动。**批内代拍板三项已追认（2026-09-24 用户确认）**：① B/C/D 字母保持不重编（字母是跨文档/代码注释的承载标识）；② A 区 28px 纵向空间划归 C/D 底行（520 → 548；1920 档换算仍归表现层升级批）；③ 关卡画面进度呈现由选路覆盖层节点态直接承载、不另设进度条组件 |
|
|
||||||
| v0.9 | 2026-09-23 | 渲染技术注记（棋盘 Node2D 迁移批 Phase A，代码实装同批）：棋盘本体 Node2D 化——BoardView 内部由 GridContainer+逐格控件改为 Control 壳 + SubViewport + Node2D 世界，类名/信号/公共方法契约不变、探针零改造；三区布局与性能预算（同屏 draw calls < 200）不变；程序化占位视觉等价平移，素材终稿按 art-bible §8.2 格面 32×32 暂定档槽位 1:1 换入 |
|
|
||||||
| v0.10 | 2026-09-26 | 渲染技术注记（战斗舞台 Node2D 迁移批 Phase B，代码实装同批）：B 区战斗舞台 Node2D 化——BattleStageView 内部由 PanelContainer+Control 站桩改为 Control 壳 + SubViewportContainer + SubViewport + Node2D 世界（StageWorld/StandeeBody），类名/setter 面/公共方法契约不变、调用点零改造；状态图标行与悬停 tooltip 保留 Control 载体挂壳层（伴随件）；C6 字体注入挂点复用（set_world_font）；三区布局与性能预算（同屏 draw calls < 200）不变；占位表现等价平移（时序常量逐字对照——等价证明=git 提交 7f24b64,文件已按生命周期条款退役） |
|
|
||||||
| v0.11 | 2026-09-27 | 关卡画面 UX spec 建档（[level-map](../../ux/level-map.md)，关卡画面 UX 批——用户拍板立项）：义务清单「关卡节点地图」行挂屏级 spec 指针；屏级权威行与不负责表改按屏分治口径（战斗屏 = battle.md / 关卡画面 = level-map.md）。文档面零机制改动 |
|
|
||||||
| v0.12 | 2026-09-30 | **未开格类型微光概念收口批（用户裁决落位）**：新增「未开格类型微光」节=全项目唯一权威定义（五要素——作用对象=英雄周围 8 格内的未开格〔与可挖域同圈〕/信息内容=只类型不泄危险格与安全格/生命周期=入圈亮出圈灭开格灭/关联边界/实装状态=契约定稿〔样张 v2〕游戏内待实施批）；核心规则章六节改七节；呈现义务来源清单「地图战斗资源」行补微光指路；验收标准补微光呈现线。背景：该概念此前只活在 06 登记与 art-bible 复述，「常显/全部未开格」无范围表述酿成理解事故（2026-09-30 用户纠正口径），本批落位权威文档、他文只许指路 |
|
|
||||||
| 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 令牌池已在役） |
|
|
||||||
| v0.16 | 2026-10-10 | 柜台名扫改（2026-10-10 天赋树设计会话裁「道具工坊」改名「秘宝匣」）：迭代 19 卡④入库注记内「营地道具工坊同调装配获渠」改「营地秘宝匣同调装配获渠」。机制与接线零改动 |
|
|
||||||
| v0.18 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 5 处——核心规则导语「收口」→「完成」；装板校验「报错中止」→「显示错误并中止」；迷雾实施状态注记「随批」→「顺带」2 处（探针断言扩、测试引导语）；营地覆盖层注记「随批补缺」→「顺带补缺」。机制、数值、结构零改动 |
|
|
||||||
| v0.19 | 2026-10-17 | **未开格类型微光实装入库注记（迭代 30 卡①，合并 `7ffd1dc0`）**：①微光节实装状态行「游戏内待实施批」→「已实装」（2026-09-30 核证的「无独立实现」状态注销），在役实现（ui_kit TG_GLOW_* 五组、格面微光子件 + 距离场 shader）随行登记；②口径史注记后补「两带分工」注记（卡顶色带 = 条目级静态色带 / 格面微光 = 棋盘格内动态微光，禁互为引用；统一面归 06 两带统一条）；③验收标准类型微光行去「待实施批落地后验收」括注转正式验收。微光定义（一句话/作用范围/生命周期/关联边界）零改动；明度档 provisional 值登记归 art-bible 版本历史 |
|
|
||||||
| v0.20 | 2026-10-20 | 死链清偿：视野迷雾实施状态注记内「改道留痕=需求卡片-提灯载体道具批」指路句改指提交史——该卡早已按 doc-conventions §11「吸收即死」退役，原句为死链；同批十一张失归属卡片退役。机制、数值、结构零改动 |
|
|
||||||
@@ -181,20 +181,3 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)把单
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v1.0 | 2026-09-21 | **存档序列化批（SaveManager 落地）**：格式裁决 JSON 单档 `user://save.json`；数据模型逐域成文（元进度四件 + 最近冒险摘要 cap 10）；读写时机（启动读盘/冒险收束写盘/营地即时写/测试入口不写）+ tmp+rename 原子写；版本策略（高版本拒读禁写/低版本链式迁移/缺域补齐）；损坏兜底（.corrupt.bak 备份 + 默认新档）；待设计问题清单六条全部裁决成文（1/2/3/5/6 入核心规则，4 = 单档 MVP 多档留 P2）。自范围草案升定稿 |
|
|
||||||
| 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 四次升版当时均未回写本文，本批一次性清偿 |
|
|
||||||
| v1.5 | 2026-10-12 | **锻造工坊完备性检查批随迁（用户令：新加内容现在补、不等实装批）**：①**预登记锻造路线域**（计划 v7）：域清单表 + 版本沿革补 `forge_routes`（三武器等级+三甲等级+当前选中标记、无特效域、旧档破坏性废弃归锻造工坊实装批；域名以实装批定名为准）；②**清偿 forge_levels 残留**——JSON 示例、域清单表删该域（代码侧已随迭代 21 T5 删除：`save_manager.gd:12-14/:399-401` 白名单收窄）；迁移链 v4→v5 的「三体系迁移」体改述为已删除（`save_manager.gd:96-98`、`meta_progression.gd:294-295`）；③**补登两漏域**（代码实证 `save_manager.gd:119-139`）：`tree_struct`（树结构版本标记，迭代 21 T5，缺失=换代前结构加载废弃重置，owner 天赋树）、`first_adventure_done`（首冒险完成标记，新档默认 false、旧档缺省按已完成兜底，`meta_progression.gd:100` 置位，owner 元进度）；④消费面纪律句「读写锻造等级」→「读写树等级」（访问器已随行族退役删除）。版本号常量仍 =6（v7 未落地） |
|
|
||||||
| v1.6 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三⑥，用户裁「落文」）**：域清单表补 `vision_used` 行（真视使用终身计数，迭代 22 新增，v6 域后扩列补零不升版本——迭代 21 先例；断点随件 `vision_counter_used` 同批新增、旧随件键 `bonus_aux_carry` 随替换子交互拆除退役）；缺键补齐纪律句补 v6 扩列注；零迁移口径复核=SAVE_FORMAT_VERSION 仍 6（`save_manager.gd:49`），无迁移分支新增 |
|
|
||||||
| v1.7 | 2026-10-12 | **锻造工坊实装批随迁（迭代 23 T5——v7 落地；承 v1.6 的 vision_used 登记）**：①域清单表 `forge_routes` 计划行→实际落地态（{levels 六路线等级 + unlocked 直购解锁清单 + weapon/armor 当前选中标记}，域内键名以实装批定名）；②版本与迁移节——当前 =7、迁移链补 v6→v7（空迁移=缺键补齐模式，解锁态派生不落档三通道）；③旧档口径订正——「破坏性废弃」→「缺键补齐 = 初始持有态」（开发阶段禁迁移禁折算纪律不变，契约 4）；④域界注记——forge_routes 属 meta 永久进度域（契约 2 反面清单不涉） |
|
|
||||||
| v1.8 | 2026-10-13 | **Y 断点随存缺陷修批（06「天赋树实装批登记欠账三条」③——用户令单独开修）**：断点域扩列随件键 `attune_refresh_y`（Y 冒险周期池消耗余量——续玩优先读断点、不自参数面整额重注入=堵「用完退菜单再续玩满血复活」可利用漏洞；旧断点缺键回退参数面整额注入=旧档行为零变化）；**v7 域后扩列不升版**（v1.6 vision_used 先例同款，SAVE_FORMAT_VERSION 仍 7、无迁移分支新增）；断点字段口径 owner=冒险结构（v0.21 随批登记） |
|
|
||||||
| v1.9 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 5 处——断点域豁免注记「随批」→「顺带」2 处；「白名单收口」→「白名单收窄」2 处（forge_levels 退役行与迁移链 v4→v5 述——「收口」系白名单收紧义，按本篇既有词「收窄」就近改写）；钥石判据「不得破坏」→「禁止破坏」。域、版本、迁移语义零改动 |
|
|
||||||
| **v1.10** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「局内资源」→ 局内系统资源（不入档/单局清零两处）；「生命账本、GP」→ 生命、GP——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -108,14 +108,3 @@ HUD 框架定稿时已为教学留好两个承载位，本系统的内容将来
|
|||||||
3. 图例面板的条目全集与分组方式。
|
3. 图例面板的条目全集与分组方式。
|
||||||
4. 教学文案的定稿权归属，以及与本地化流程的分工。
|
4. 教学文案的定稿权归属，以及与本地化流程的分工。
|
||||||
5. 是否提供"再教一次"的入口（图例面板是否兼任手册）。
|
5. 是否提供"再教一次"的入口（图例面板是否兼任手册）。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| 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.5 | 2026-10-09 | **文档正确性审查批·独立复核（worktree docaudit-2026-10-09）**：①内容原则与 P1 后置「里程碑定位 Alpha」改排 **Beta 阶段**（2026-10-04 用户拍板教学引导整体改排，06 节头注记在案——本文漏同步）；②教学条目「库存关卡末清空」行补机械惰性承载注（清空对象=关卡域库存恒空、拆线归实装批，本条目随拆线失效——与战斗结算 v0.28 同款口径） |
|
|
||||||
| **v0.6** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「教血账与恢复」→ 教生命与恢复——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -210,15 +210,3 @@
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档 GDD 压缩改写 |
|
|
||||||
| v0.2 | 2026-09-15 | 雾格残留清理：关闭「待拍板」的棋盘生成参数表雾字段清理登记（fog_region_count / fog_target_ratio 两字段、雾占比绝对上限与雾域跨字段校验）——字段与校验随雾格移除同批删除，registry `board_gen_table` 条目同步修订。表清单与校验纪律不变 |
|
|
||||||
| 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，迭代 19 退役删除，断言并入 `tests/unit/data_config/config_db_fatal_oob_test.gd`〕 + 冒烟 ceil 断言） |
|
|
||||||
| v0.5 | 2026-09-27 | **统一随机流批（2026-09-27 用户两轮复裁终选「统一用一个流」并拍「全面执行」）**：§「封闭随机流」整节改「统一随机流」口径——唯一主种子+单盐派生+唯一全局取数计数器，七流并一；取号参数降格为**用途标签**（只进事件日志不参与派生，七流名保留为封闭词表）；新增**全事件日志**（冒险会话制 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 字段 |
|
|
||||||
| v0.7 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 5 处——fail-fast 节与 P0 第 3 步「报错」→「显示错误」3 处（均动词义）；MetaTable 行与越域验收行「随批」→「顺带」2 处。另 v0.4 行死链清偿 1 处：smoke/config_fatal_probe.gd 探针迭代 19 退役删除、断言并入 `tests/unit/data_config/config_db_fatal_oob_test.gd`（去向经 roadmap 迭代 19 卡①「探针收编」与本文验收行双证）。表、校验、随机语义零改动 |
|
|
||||||
@@ -122,10 +122,3 @@ MVP 不要求本系统的闭环：[不做清单](../../05-不做清单.md)把设
|
|||||||
4. 文案生产流程：文本键（每条文案在工程里的唯一编号，机器据此找到译文）怎么管理、谁负责校对、翻译在流程的哪一步介入。
|
4. 文案生产流程：文本键（每条文案在工程里的唯一编号，机器据此找到译文）怎么管理、谁负责校对、翻译在流程的哪一步介入。
|
||||||
5. 设置界面的入口与形态：从哪里打开、什么时刻可以打开——与 HUD 框架协作定。
|
5. 设置界面的入口与形态：从哪里打开、什么时刻可以打开——与 HUD 框架协作定。
|
||||||
6. 键位映射表是否转化为改键设置项。
|
6. 键位映射表是否转化为改键设置项。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v0.2 | 2026-09-29 | **最小设置面落地（迭代 8 卡④）**：P1 两项（音量入口+减动效开关）随迭代 8 兑现——三件面（音量 master bus 实时生效+即改即存/全屏/减动效转正）+退出游戏入口+调试入口 DS_DEBUG 门控；独立存储落地=`user://settings.cfg`（ConfigFile 三节 audio/display/motion，与存档两分按 2026-09-19 拍板）；减动效开关自测试调整板退役（设置面唯一入口，battle.md 呈现承诺不变） |
|
|
||||||
@@ -151,12 +151,3 @@
|
|||||||
3. 混音与总线方案：音乐与音效怎么分层、相对音量关系怎么定。
|
3. 混音与总线方案：音乐与音效怎么分层、相对音量关系怎么定。
|
||||||
4. 与减动效选项的关系：呈现侧已承诺减动效——音频侧是否配对应的减噪、动态范围收缩，未拍板。
|
4. 与减动效选项的关系：呈现侧已承诺减动效——音频侧是否配对应的减噪、动态范围收缩，未拍板。
|
||||||
5. 四个基础反馈位之外的基础音效（封印、移动、清图奖励等）尚未见挂点登记——是否补登记、归谁提出，未定。
|
5. 四个基础反馈位之外的基础音效（封印、移动、清图奖励等）尚未见挂点登记——是否补登记、归谁提出，未定。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v0.2 | 2026-09-16 | 新增「临时音效的覆盖清单」：必覆盖五挂点、选配两候选、明确不覆盖两挂点与切片期验收口径成文（06 清单「临时音效的覆盖清单」闭合），P0 最小闭环改指本节；明细流水行型数 15→10、例举去"道具"行，随战斗结算格面资源批行协议同步（追记 2026-09-30：现行 9 类——2026-09-20 伏击上限删除批下线溢出未生效行） |
|
|
||||||
| v0.0 | 2026-10-11 | 术语统一补扫批（2026-10-11）：音频触发名「惊动巢穴」三处换代「惊动危险格」 |
|
|
||||||
| v0.3 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 1 处——「切片期验收口径」句内「不得先于事件」→「禁止先于事件」。覆盖清单与验收判据零改动 |
|
|
||||||
@@ -157,35 +157,3 @@ MVP 不要求本系统的闭环（[不做清单](../../05-不做清单.md)整体
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.18 | 2026-10-13 | **迭代 23 反哺落文批（实现报告 §五，用户裁「在这里进行更新」）**：①「跨局注入」节补终态句——入战 AC 三层第一层「甲型基础 AC」= 选中甲路线行 base_ac（forge.tres 轻 10/重 12/魔法护甲 9 provisional），effective_ac 三层已随迭代 23 在役；②属性锻造段落代——「实装待办在册 06、待用户发令」过期态换代为已随迭代 23 实装入库（新表 forge.tres），并登记营地钥石入口族三写口（forge_buy_level/forge_buy_unlock/forge_select_*——buy_forge 退役后的新族，契约 9 写口唯一）。机制与数值零改动 |
|
|
||||||
| v1.19 | 2026-10-13 | **暂停层改名批随迁（用户令：暂停层/暂停角标→状态面板/状态角标，全标识符+文案换代、行为零变化）**：「解锁界面：双入口框架」节正文名称换代+改名括注（版本历史行内旧名按历史记载保留）；pause_overlay.gd→status_panel.gd（StatusPanel）。机制零改动 |
|
|
||||||
| v1.20 | 2026-10-13 | **迭代 21 反哺②落文（用户裁「按呈报落文」）**：「营地统一」段落地终态换代——属性锻造柜台已随迭代 21 退役、属性升级唯一入口=树脊柱淬炼节点、四柜台并排已实装（原「落地前维持现役」过渡态终结）。机制零改动 |
|
|
||||||
| v0.1 | 2026-09-15 | 自归档线索整合为范围草案（旧体系未单独成文） |
|
|
||||||
| v0.2 | 2026-09-17 | 代币→钥石统一拍板随批措辞清偿：资源模型裁决闭合（同一资源，渠道 = 关卡大奖励入账 + Boss 掉落），「代币记账」改名「钥石入账」。机制未动（本文仍为范围草案） |
|
|
||||||
| v0.3 | 2026-09-17 | 数值纪律收口批：正文 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），3 处失同步修正（钥石入账 +10/关 三处改「每关固定值，行值读冒险表 keystone_per_level」） |
|
|
||||||
| v1.0 | 2026-09-18 | **元进度定稿批（用户拍板六件收口）**：定名「永久强化」（系统族名元进度保留，「天赋树」退役、「营地」为界面壳）；营地三柜台（属性锻造三档含护甲等级 / 道具工坊六件首版通关次数渠道 / 奖励格图鉴结构位）；Boss 重复获取 = 首杀全量 + 重复杀固定小额；定价几何递增原则；区间平移换算率启用（换算率表首版三行、护甲行强条目、数值读 data/tables）；注入 = 冒险开始参数面 + 覆盖值通道（override 集合操作：追加 / 替换）；解锁界面双入口框架。本文自范围草案升定稿 |
|
|
||||||
| v1.1 | 2026-09-18 | **数值语言拍板批（与 01-核心循环 数值语言条款 / 难度曲线与Boss / registry / 06-待办清单 / 切片代码同批）**：营地三柜台节新增投值语言锁定条款——属性投值语言锁定 flat 整数加减，数值投值仍归设计批 |
|
|
||||||
| v1.2 | 2026-09-20 | GP+商店房批注记（知会性质——与冒险结构 v0.5 同批）：钥石节新增与 GP 的分工一行——钥石 = 跨局持久解锁、GP（「金币」）= 冒险内一次性属性提升、局内清零不入存档，双币生命周期切分成文、永不互兑。机制零改动 |
|
|
||||||
| v1.3 | 2026-09-21 | **元进度实现批（与切片代码 / registry / 02 / 03 / 05 / 06 同批）**：本批 = 本文的实现批——MetaTable 四行族建表（`data/tables/meta.tres`，数值全 provisional 归设计批配读数）；MetaProgression 账本服务（余额/几何定价/购买/工坊解锁/Boss 两档入账/注入计算，Core 层零 UI 零信号）；注入通道落地（start_adventure params.hero_override → LevelRunner base_override，叠加序 = 表值+永久强化 flat+加算区 flat × 测试面板 pct）；呈现面（营地覆盖层三柜台+主菜单入口+A 区顶栏钥石余额+结算屏入账明细，ui_kit 程序占位——视觉终稿归 HUD 协作批）。正文零改动（实现面不回流正文——正文零历史叙述纪律） |
|
|
||||||
| v1.4 | 2026-09-23 | **换算率标定批（用户指令「现在标定」；与切片代码 / registry / 06-待办清单 / 判定端工具同批）**：换算率节回填现行表值（生命 6 / 攻击 9 / 护甲 1 点每级——OFAT 冒险注入档与白板同种子配对的逐关条件通关率差实测，冒险条件口径；同日单关直入口口径退役使首轮直入口面读数作废重测）；护甲行强条目重测履行并暴露修复护甲断链（begin_battle hero_armor_class 参数零消费→_defender_ac 接线）；判定端带平移表值驱动接线（带重锚后随换算率平移判）；排期表 P1 行销项 |
|
|
||||||
| v1.5 | 2026-10-01 | **钥石渠道改一批（迭代 10 奖励重构——用户 2026-09-30 拍板；与冒险结构 v0.12 / registry 同批）**：钥石渠道自二改一——「关卡大奖励入账（keystone_per_level）」随大奖励三件套退役，渠道 = Boss/精英怪击杀掉落（逐杀实时入账，行值读 meta.tres boss_keystone 首杀/复杀两档；精英掉 1 预留）；首杀大额/复杀小额规则不变。**产出重标义务重开**：现行两关冒险产出结构从「大奖励 10×2 + Boss 首杀 5」改「Boss 掉落 ×N（精英未实装零贡献）」，标定随元进度设计批/调参批重开（06 登记） |
|
|
||||||
| v1.6 | 2026-10-03 | **同调位账本批（迭代 11 第①批同调实施批——save v4 / meta.tres attune_refresh_upgrade 行族 / registry 同批）**：①道具工坊柜台职责改写——解锁→谓词表形态（unlock_requires 行，首批全解锁=空谓词合法态，底稿 §2.2 用户裁），柜台内新增「同调装配」段（装配/换装/Slots 点亮 + Y 刷新升级行购买——程序占位面，视觉终稿归营地批；满位禁选/写档持久 MetaProgression.toggle_attunement 唯一写口）；②Boss 击杀总数计数登记（boss_kill_count 含重复，收束入账=apply_adventure_summary 逐通关关次 +1，attunement_growth 谓词表计数源）；③Y 刷新升级行登记（attune_refresh_upgrade 行族 L1→Y1/L2→Y2，钥石直购，provisional）；④装配关系入存档持久（attunement_equipped save v4 域，冒险中途不可换装——底稿 §8.5） |
|
|
||||||
| v1.7 | 2026-10-07 | **生命周期轴裁决随批（框架现行事实源=核心循环「生命周期轴」节同批落文）**：设计目的节补独立资源口径——钥石与 GP=两条平行独立资源不立统一上位概念，钥石=存档级账归本文、GP=冒险级账归冒险结构（同批落文）；既有账本语义零改动 |
|
|
||||||
| v1.8 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①设计目的「渠道有二：关卡大奖励入账、关底 Boss 掉落」与核心规则「渠道自迭代 10 起改一」自相矛盾——订正为 Boss/精英怪击杀掉落单渠道；②道具工坊行订正——工兵令已退役（treasure_items.tres retired 旗），可解锁在役=探巢摆钟/爆破工兵包两件；「本柜台职责随同调实施批改写」的未来式订正为已落地（2026-10-03 v1.6）；③定名节补审查注——「本作不存在树形结构」失义（属性锻造随迭代 12 T9 落地为锻造脉节点结构，存档域 tree_nodes/fork_sides），章节归后续修订；④里程碑前缀按 2026-10-09 口径删「M-3」（视觉终稿行）只留「迭代 9」；⑤调参表钥石产出行删「每关入账值 keystone_per_level」（行值已退役）改 boss_keystone 行指路。 |
|
|
||||||
| v1.9 | 2026-10-09 | 文档正确性审查批（定点）：解锁双入口框架节「局内暂停层入口未实装（随 HUD 批 M-4）」过期订正——暂停层只读入口已实装（2026-10-06 迭代 17 卡③，实机目检待用户；06 登记条在册）；裸 M-4 标签随订正消除 |
|
|
||||||
| v1.10 | 2026-10-09 | **B2 裁决落文（用户令「删除旧的、直接写新的」）**：道具工坊行删旧写新——旧「现行六行」登记作废（旧目录已随秘宝 v1.5 全退役），改写=件的目录与效果现行事实源指路秘宝.md「目录（重设计 v1）」+解锁门槛谓词分级（普通 0 门槛/优秀中里程碑/稀有高里程碑，阈值归调参批）+通关次数渠道与钥石直购价归定价批后补 |
|
|
||||||
| v1.11 | 2026-10-09 | **B1 裁决落文（用户令「元进度让他们都独立去写」——天赋树独立成文）**：①定名节冲突表述换代——「归档线索里的『天赋树』一词就此退役」与 v1.8 审查注（「本作不存在树形结构」失义登记）同步摘除，改写 = 退役的是归档线索旧概念的旧义、树形结构已随迭代 12 以锻造脉形态落地在役（系统现行事实源 = 天赋树.md，本批新建 v0.1）；②三柜台节补指路句——属性锻造树形节点结构现行事实源 = 天赋树.md，旧三档柜台与树四线 flat 注入面叠加实态随句登记。机制零改动 |
|
|
||||||
| v1.12 | 2026-10-09 | 武器锻造成文批随迁（用户令「完成文档编写、代码不实现、记录待办」）：三柜台节补指路句——属性锻造攻击/护甲两档的路线化改造设计权威文档 = [武器锻造](锻造工坊.md) v0.1（按 2026-10-07 提案推荐案成文、17 裁点开放在册、实装待办在册 06；改造落地前三档直购维持现役）。机制零改动 |
|
|
||||||
| v1.14 | 2026-10-11 | 秘宝匣行换代随批（秘宝.md v2.7 目录修正批）：13 件三档+解锁混合制口径；旧「正主/谓词分级」表述同步清除（拾取渠道指路同日追加又随终裁废止） |
|
|
||||||
| v1.13 | 2026-10-10 | **「道具工坊」改名「秘宝匣」（2026-10-10 天赋树设计会话裁——树上解锁节点与营地柜台同名）**：现行正文六处扫改（三柜台行 / 柜台行 / 柜台纪律 / 后续商品行 / 调参表 P1 / 定价表行）；版本历史行一律不动；别名「道具工坊」登记 registry 术语条保留检索。机制零改动 |
|
|
||||||
| v1.14 | 2026-10-11 | **营地统一案甲随迁（2026-10-11 天赋树设计会话终裁）**：三柜台节补「营地统一」段——树=营地本体、属性升级唯一入口=树脊柱淬炼节点、本属性锻造柜台随 06「天赋树实装批」退役吸收进脊柱（落地前维持现役）、锻造柜台与秘宝匣转工作间钥匙模型、图鉴常开；设计权威文档指路 = 天赋树.md v0.2。机制零改动（退役与公式换代随实装批） |
|
|
||||||
| v1.15 | 2026-10-11 | 锻造工坊更名批随迁（机械扫）：三柜台节指路句随系统更名「武器锻造→锻造工坊」换代链接与名称（06 实装批条名同步「锻造工坊实装批」；版本历史行内旧名按历史记载保留）。机制零改动 |
|
|
||||||
| v1.16 | 2026-10-12 | **完备性检查批随迁（用户令：有缺漏即补齐）**：①「跨局注入」节补开局属性四层叠加公式（角色基础值+树生命/命中 flat+锻造路线加值+局内加算区 flat；入战 AC 三层）——锻造工坊与天赋树两文档共指本节为「通道现行事实源」而公式缺位，本次落实；原「属性锻造三档是数值覆盖」随迭代 21 T5 行族退役换代；②锻造工坊 v0.6 引用版本号 v0.1→v0.5 连带校正（三柜台节）。机制零改动 |
|
|
||||||
| v1.17 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三④，用户裁「落文」）**：秘宝匣行补迭代 22 实装实录（购买钮禁用态/条件进度呈现/分档装配呈现/空目录合法态/treasure_shop_status 投影/旧道具工坊渠道面退役）；柜台纪律「首版只挂通关次数渠道」排期态消解注记；P1 秘宝匣定价行换代（provisional 10/25 已投，终值归调参批）。机制零改动 |
|
|
||||||
| v1.21 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 2 处＋死链修复 1 处**——「收口」→删（文头状态行「用户拍板收口」→「用户拍板」，已定稿语义由句首承载）；「不得」→「禁止」1 处（验收·换算可审计条护甲行）；死链修复：v1.12 行的武器锻造死链指路改指锻造工坊.md（2026-10-11 更名漏改，显示文字与行内其余文字同步换代为现行名，其余不动）。机制与数值零改动 |
|
|
||||||
| **v1.22** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「独立资源口径…两条平行独立资源」→「系统资源口径…两条平行独立的系统资源」；钥石表行改「钥石（存档级）」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -196,20 +196,3 @@ A/B 态只放规则面：节点行持 a/b 双效果键（封闭规则键词表 R
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)「天赋树实装批」条，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)「天赋树实装批」条，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.10 | 2026-10-13 | **R1 机制位批（用户推翻迭代 21 追认单 #1 裁撤案）**：「等级阈值前置」以机制位形态随批重立——schema requires_level 字段（Dictionary{node_id: n}，键悬空/阈值 <1/类型错加载即拒）+ tree_can_buy 判定分支 + 行板门槛呈现（未达标 🔒+悬停文案 gate_text）+ 单测 tree_requires_level_test 八断言（run_all 24→25 套）；现役 12 行零配置=空转零行为影响（冒烟 938/0+全闸复跑零漂移），配置归表行随需填。六处 R1 表述换代（状态行/范围表/schema 连带/购买校验③/调参表/验收前置行） |
|
|
||||||
| v0.9 | 2026-10-13 | **迭代 21 反哺落文批（实现报告 §五①③⑥，用户裁「按呈报落文」）**：①实装落地态全文档换代七处——头部状态行 / 系统范围表 / 节点总表前言与三行 / schema 连带句 / 依赖表 / P0 段 / 验收实态注（原「实装未落、现役 33 节点」过渡态终结；迭代 21 = 2026-10-12 入库）；③「财富之道」设计避让句按卡片 v1.7 ⑪②裁决改写为折扣定义边界口径（散=只覆盖商品购买价，键 gp_cost_mult，不含两处刷新——定义边界非临时避让）；⑥验收实态注（机检读数+命中线契约 6 括注定性）；连带：已建未接面节换代（同调位判定源已切树点亮数 / 刷新升级同账路由 / 命中线契约 6 维持——两接一维持）。机制与数值零改动 |
|
|
||||||
| v0.8 | 2026-10-11 | **Fork 一节点双态换代批（用户裁）**：①开局姿态/危险直觉/财富之道三天赋=三节点——现役 A/B 双行结构（迭代 12 沿袭，「付一次钱得双态开关」裁决未落进节点组织=落文错误已纠正）收编为单行双态，同调脉 9→6（同调位 3+Fork 3）、全树 15→12；②节点语义=购买解锁双态开关（cap1、零重复购买）、解锁默认 A 态、营地零币切换（互斥由单态承载）；fork_sides 存档语义不变（组→激活态），tree_buy_fork=购买解锁/tree_toggle_fork=零币切态；schema=Fork 行持 a/b 双效果键、效果按激活态取值、Fork 组词表校验改每组恰一节点；③R1（「等级阈值前置」形态去留）不随本批变化，仍开放待裁（推荐裁撤）。实装归 06「天赋树实装批」（33→12 连带，需求卡片 v1.6 同批） |
|
|
||||||
| v0.7 | 2026-10-11 | **一线一节点换代批（用户裁）**：①脊柱淬炼一线一节点——生命淬炼/命中淬炼各收编为单节点 4 级（原「一线 4 层×层内 3 购」层=级收编；用户明裁：一个内容一个节点、等级在节点内、不拆多节点），脊柱 8→2、全树 21→15；②行门槛平移——SPINE_ROW_GATE=4 公式不变，门槛主语从「层 N」改「节点第 N 级」（第 2~4 级需全树总投入 ≥4/8/12），row 字段随层行退役；③彩蛋条件随结构换代为「生命/命中两节点 4 级拉满 且 同调位 1/2/3 全部解锁」；④R1（「等级阈值前置」形态去留）不随本批变化，仍开放待裁（推荐裁撤）。实装归 06「天赋树实装批」（33→15 连带，需求卡片 v1.5 同批） |
|
|
||||||
| v0.6 | 2026-10-11 | **攻防所有权切分落文批（锻造工坊裁决会话 A 组定案，天赋树会话交接落文）**：①脊柱换代 16→8——攻击淬炼×4 层与护甲淬炼×4 层删除，脊柱=生命/命中两线×4 层，全树 29→21 节点（每根数值轴全游戏单一来源：生命/命中→树脊柱、攻击→锻造工坊武器路线、AC→甲路线，树零攻防来源=红线）；②锻造工坊钥匙节点前置改「无」（free、直接可点亮，原「攻击淬炼累计 ≥2 且 护甲淬炼累计 ≥2」等级阈值前置随两线砍除作废）——连带开放待裁点 R1：schema「等级阈值前置」新形态现无消费者，裁撤（推荐）/留作机制位待用户裁；③地脉共鸣换代——条件改「生命/命中两线全部买满（8 节点全上限）且 同调位 1/2/3 全部解锁」、效果改生命/命中两线 flat（攻/护分量摘除），上限 3 枚不变；④行门槛 SPINE_ROW_GATE=4 规则保留（层 N 需全树总等级 ≥4×(N−1)），两线换代后总等级供给结构变化=达成节奏重算注记在册、值归数值批；⑤叠加公式换代——开局属性=角色基础值+树生命/命中淬炼 flat+锻造路线加值（只按当前选中生效）+局内加算区 flat（命中在账未注入披露不变）；⑥营地呈现措辞对齐四柜台并排（树淬炼柜台=树脊柱界面形态、锻造工坊柜台钥匙点亮前=锁定态，机制语义=树营地本体/钥匙模型/图鉴常开不变，A② 裁）；⑦节点总表/一脊三脉/验收标准/调参表/依赖表连带换代。实装归 06「天赋树实装批」（结构目标 33→21 连带换代，需求卡片 v1.4 同批） |
|
|
||||||
| v0.5 | 2026-10-11 | 锻造工坊更名批随迁（机械扫）：五处「武器锻造」链接随系统更名「锻造工坊」换代为 [锻造工坊](锻造工坊.md)（v0.2 历史行内旧名按历史记载保留）。结构零改动 |
|
|
||||||
| v0.4 | 2026-10-11 | **歧义扫描清零批（/grilling 六裁落文）**：①Q1 术语回归正主——分叉效果废「陷阱/危险标记」自造词，改「踩中危险格伤害减半」「危险格标记错误返还行动点」，玩家文案沿「危险格/安全格」；②Q2 地脉共鸣效果改生命/攻击/护甲三线（命中分量待命中线注入随批加回，不留永久无效分量）；③Q3 行门槛总等级口径写明=tree_nodes 全部节点等级之和（免费点亮与分叉激活计入，沿现役实态）；④Q4 财富之道范围定界——聚=仅战斗掉落渠道、散=全部 GP 消费面（用户裁）；⑤Q5 限次计数生命周期落句（随冒险持久/按关重置/新冒险清零/断点保留）；⑥Q6 三处旧裁决换代——已建未接面槽位判定源句换 Q2 裁决（树点亮数+旧条件作废删除）、刷新升级条补 Q1 双入口并存、存档域节「迁移重做」整节换代为「旧档废弃」（Q3 裁决落文，禁迁移红线）；顺带清「Y 升级行族」黑话为「刷新升级行族」。结构零改动 |
|
|
||||||
| v0.3 | 2026-10-11 | **节点台账补全批（用户令：台账指引升格文首+29 节点总表落文）**：文档最前新增「节点台账指引」块（节点结构查本文总表 / 数值查配置文件 `game/data/tables/meta_tree.tres` 双源分工声明）；核心规则节补「节点总表（29 节点）」——17 行折叠式全名单（脊柱四线按层折叠），逐节点名称/脉/类型/前置/效果方向，数值不进正文沿配置纪律。结构零改动（纯台账补全） |
|
|
||||||
| v0.2 | 2026-10-11 | **天赋树设计会话裁决批（结构换代+分叉效果定案+营地统一）**：①结构换代 33→29——锻造枝三属性节点（武器锻造/护身锻造/甲胄锻造，旧柜台镜像重复件）删除换单个免费解锁节点「锻造工坊」（前置=攻击淬炼累计≥2 且护甲淬炼累计≥2，等级阈值前置新形态）；克制专精 Fork 对整组砍除（类型表达归武器锻造）；②分叉效果定案——开局姿态两侧收每关首轮窗（先手压制=每关首轮 AP+1 / 稳健拓荒=每关首轮内受击减伤）、雷感直觉改名危险直觉（锋=陷阱伤害减半 / 守=误标返 AP·均每关限次；标错机制存在性 T0 实查在册）、经济人格改名财富之道（聚=GP 获取增益 / 散=消费折价，避开两处在册旋钮）；现役两键占位态随实装批终结；③营地统一案甲——树=营地本体，属性升级唯一入口=树淬炼节点，旧属性锻造柜台退役吸收进脊柱，工作间钥匙模型（锻造工坊/秘宝匣两钥匙+图鉴常开）；④叠加公式换代=基础值+树淬炼+锻造路线加值+局内加算；⑤同调位 1 改无前置根节点、串行保留；地脉共鸣条件改四线全部买满；⑥「道具工坊」改名「秘宝匣」；⑦树上刷新升级节点定性缺陷（购买写 attune_refresh_level 同账修复随批）；迁移映射重做（forge_levels→脊柱线）。全部实装归 06「天赋树实装批」（原「已建未接面两件」+「结构重构批」两条合并） |
|
|
||||||
| v0.1 | 2026-10-09 | **B1 裁决补写批（用户令「元进度让他们都独立去写」）**：系统随迭代 12 双层 BD 实施批实装在役（33 节点 + 存档 v5 树域 + 营地树界面 + A/B 面 MC 两侧差 0.0pp 过 <~3pp 验收线，2026-10-04 落地 = 合并 e780063 系），本文补写其设计文档——机制描述以代码实态（meta_tree.tres / MetaTreeTable schema / MetaProgression 树段 / save_manager v5 域 / 效果引擎规则键消费面）与迭代 12 落地裁决（整合定稿 R1 甲融合案、2026-10-07 树全钥石单币裁甲）为据；设计底稿《双层BD体系-整合定稿-2026-10-03》已按吸收即死退役（删除 = git 8e02dcf，内容经 git 历史取证）。已建未接面三条如实登记（同调位 / 刷新升级 / 命中线），处置权归后续批 |
|
|
||||||
| v0.11 | 2026-10-15 | **简明技术中文用语规范批（用户令）：死链修复 1 处**——v0.5 行更名记载内的武器锻造死链改指锻造工坊.md（2026-10-11 更名漏改指路；显示文字「武器锻造」系更名记载的旧名内容本身，按对照性豁免保留，仅换链接目标）。词面修正 0 处、机制零改动 |
|
|
||||||
| **v0.12** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「跨局账/这本账/树域账/钥石账本」→ 系统资源表述；「同账路由」→ 同路由；「命中在账未注入」→ 命中未注入——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -99,11 +99,3 @@ P0-P5 六点已于 2026-10-06 用户全裁（案甲 × 6，备选案与淘汰依
|
|||||||
| 丙 | 条带原样永久保留（固定存 10 条，不随 N 动） | 改动最小；淘汰候选：与生涯列表长期双轨，上限语义分裂（营地固定 10 / 生涯 N），N 大于 10 后两处看到的条数对不上 |
|
| 丙 | 条带原样永久保留（固定存 10 条，不随 N 动） | 改动最小；淘汰候选：与生涯列表长期双轨，上限语义分裂（营地固定 10 / 生涯 N），N 大于 10 后两处看到的条数对不上 |
|
||||||
|
|
||||||
裁决方式：随本提纲评审一并定案，期二实装批执行。
|
裁决方式：随本提纲评审一并定案，期二实装批执行。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.2 | 2026-10-07 | 期一实装随批换代（迭代 18 卡④）：状态行升「期一已实装」+主菜单组列生涯钮落位+§四期一行挂实装留痕。设计内容零改版——本文仍是三段内容的范围权威；期二/期三范围与 P6 待裁点维持原状 |
|
|
||||||
| v0.3 | 2026-10-09 | **文档正确性审查批（用户令——状态记录与证据对齐）**：①跨局汇总表「冒险总局数 / 通关局数」行订正——save v6 两终身计数域已随期一落地（2026-10-07 迭代 18 卡④），「无现成数据源、须新增」改为现成；②两处「终局特性（集） relics」改「终局专长持有集 relics」（特性系奇物旧称已退役；存档键名沿用历史形态不动）。 |
|
|
||||||
| v0.1 | 2026-10-06 | 设计提纲首版（迭代 17 卡④设计批，纯文档）：五节成文；P0-P5 已裁结论落文；新发现待裁点 P6（营地最近冒险条带去留）；现状描述全部经代码级复核（F1-F10，见 design/qa/iter17-career-exit-report-2026-10-06.md）。状态 = 范围草案待评审 |
|
|
||||||
@@ -9,7 +9,7 @@
|
|||||||
|
|
||||||
**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已顺带退役；解锁条件=数据行内 `unlock_requires` 字段承载——迭代 22 实装落地，2026-10-12）。**新目录 12 件已随迭代 22 实装批全量落地（2026-10-12，T1-T7）**，逐件实录见「目录（重设计 v1）」各表实态列。
|
**现行形态 = 局外同调件**：开局前在营地装配（营地·秘宝匣柜台「同调装配」段）、占同调位（0 起步、固定 3 格，每件固定占 1 格）、被动件整局生效/主动件每冒险充能（冒险开始重置）。实现面 = `treasure_items.tres` + `game/core/attunement.gd`（同调位数量判定源=天赋树同调位节点点亮数——2026-10-11 Q2 裁甲、迭代 21 T4 槽位收编落地；原 `attunement_growth.tres` 谓词表已顺带退役；解锁条件=数据行内 `unlock_requires` 字段承载——迭代 22 实装落地，2026-10-12）。**新目录 12 件已随迭代 22 实装批全量落地（2026-10-12，T1-T7）**，逐件实录见「目录（重设计 v1）」各表实态列。
|
||||||
|
|
||||||
**沿革一句话**：本系统前身为切片期掉落消耗品形态（2026-09-29 迭代 7），2026-10-03 随同调实施批整体替换为现行形态；旧目录九件已全数退役入素材库（2026-10-08/10 用户裁）。历史细节见版本历史与 git 提交史。
|
**沿革一句话**：本系统前身为切片期掉落消耗品形态（2026-09-29 迭代 7），2026-10-03 随同调实施批整体替换为现行形态；旧目录九件已全数退役入素材库（2026-10-08/10 用户裁）。历史细节见 git 提交史。
|
||||||
|
|
||||||
**现行形态速览**：
|
**现行形态速览**：
|
||||||
|
|
||||||
@@ -258,40 +258,3 @@ playtest 预警（预注册，归难度曲线与Boss）：
|
|||||||
## 待办
|
## 待办
|
||||||
|
|
||||||
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
本系统待办条目已统一收编至 [06-待办清单](../../06-待办清单.md)，本节不再逐条登记。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v3.0 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三①②③，用户逐点裁「落文」）**：①目录三表补实态三列（item_id/解锁〔价格或条件，阈值 provisional〕/效果实现 kind）+试炼镐行换代自动兑付语义+全部「实装批落地前」现状句换代（定位形态节/目录引言/负责表/受理框架节/调参表/验收护栏覆盖两行）+旧目录退役指针补代码旧行已删；②代价轴转化获取行换代=试炼镐每开 8 安全格自动兑当轮 AP+1（2026-10-12 用户裁：无玩家发起入口、战斗级重置、兑付时序=揭示先于扣费故 AP 归零恰逢满点轮不结束）——设计留白〔积点计数重置周期〕随裁补记；③解锁混合制节条件表实录（钥石 8 件 10/25+条件 4 件三计数键阈值）+承载换代=行内 unlock_requires 字段 |
|
|
||||||
| v3.1 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 3 处**——「报错」→「返回错误」2 处（真视窄域护栏句、验收·护栏强制条）；「收口」→「收束」1 处（P0 第 5 条「装配与充能账随冒险收口」——冒险生命周期收束为本文件既有用词）。机制与数值零改动；目录表线香/天眼行「战斗级/关卡级充能」系术语表在册秘宝主动件术语，不属退役词命中，原样保留 |
|
|
||||||
| v0.2 | 2026-09-16 | 更名批（用户拍板 2026-09-16）：系统更名"辅助道具"→"秘宝"——定位已非纯数值道具，含信息/妙用向效果；文件同步重命名；英文代号 AUXILIARY_ITEMS 暂沿用 |
|
|
||||||
| v0.3 | 2026-09-17 | 切片期空内容拍板（用户拍板）：道具定义表为空列为合法态——五维度覆盖检查改为仅对非空清单执行；验收标准覆盖检查条目同步；06「维度覆盖检查破缺」「失义道具的掉落投放」两条随批关闭 |
|
|
||||||
| v0.4 | 2026-09-17 | 数值纪律收口批：正文与调参表 knob 现行值改指路存根（事实源 data/tables/*.tres 与 registry），1 处失同步修正（AP 8→6 漏改）——行名与表结构列保留 |
|
|
||||||
| v0.5 | 2026-09-29 | **内容批落地修订（迭代 7——用户八拍板）**：道具定义表六行入表（三有效实装：工兵令/探巢摆钟/爆破工兵包；探宝罗盘退役留痕；显影尘/地穴全图卷封存）；投放维度覆盖口径+豁免面 {plan, info, counter} 登记；解锁语义定稿；奖励节点=三选一构筑点；掉落投放权重 provisional |
|
|
||||||
| v0.6a | 2026-09-30 | **拍板点 1 收口批（用户裁决甲：同调=终局方向）**：新增「定位与形态沿革」节——现行=过渡形态、终局=局外同调件，两态关系=形态替换；正文口径回写四处；实施批登记见 06「秘宝同调实施批」条 |
|
|
||||||
| v0.6b | 2026-10-04 | **迭代 13 D6 实装修订**：爆破工兵包换装启用+「中立移除」实装口径节落文+投放态注记换代〔版本号 2026-10-09 由重复的 v0.6 改注 b 后缀——原两行同号系 10-04 批落行未查前账所致，node-reward v2.2a/b 先例〕 |
|
|
||||||
| v0.7 | 2026-10-01 | **奖励节点渠道改写注记（迭代 10 追加批）**：「奖励节点三选一构筑点」形态退役——奖励节点改提升三选一共享池；道具件经节点渠道入本关库存；同调实施批的全渠道统一收口义务 |
|
|
||||||
| v0.8 | 2026-10-03 | **反制契约作废批（用户终裁——层级错配失败设计）**：五维度「反制」行改终裁态；上游地形变异依赖行、P2 后置行同步；地形变异.md v0.6 同批落义务作废注记 |
|
|
||||||
| v0.9 | 2026-10-05 | **消歧更名批（用户拍板）：系统更名「魔法道具」→「秘宝」**——「魔法」已被本作征用为敌方侧伤害/护甲语汇；同调位机制名保留；本批仅改文档称谓，代码标识符 aux_* 沿用（对齐另批） |
|
|
||||||
| v1.0 | 2026-10-06 | **效果声明换代（内容数据驱动扩展批）**：被动件改订阅行（on/when/do 由效果引擎统一解释）+主动件受理闸数据化——按件 id 硬编码清零；结构冻结零触碰，行为与迁移前逐位一致（MC 同种子 40 局对拍实证） |
|
|
||||||
| v1.1 | 2026-10-07 | **生命周期轴裁决随批（框架现行事实源=核心循环「生命周期轴」节）**：三选一刷新双源补两账语义（存量账/临时账/消耗顺序）；「三选一呈现」=比节点更细的事件 |
|
|
||||||
| v1.2 | 2026-10-07 | **三层职责分界批（用户裁）**：头部一句话换代为「营地装配的角色机能件」（操作包络加强，不出裸属性值、不改战斗结算机制）；机制向三件归留本层重设计批处置 |
|
|
||||||
| v1.3 | 2026-10-07 | **三件机制向现件归留裁决（用户裁）**：淬毒刃纹→专长池；标中殉爆→专长池插旗系；惊巢反制→退役进素材库；现役目录九→六 |
|
|
||||||
| v1.4 | 2026-10-07 | **同调位分档（用户裁）**：同调位分三档（普通格/优秀格/稀有格）、槽位可装 ≤ 槽位档位的件、里程碑分档发槽；费用制落选留档 |
|
|
||||||
| v1.5 | 2026-10-08 | **新目录 15 件落地批（用户终审全落）**：新增「目录（重设计 v1）」节=新现行事实源——三档骨架+15 件表；旧目录全数退役只作素材库；数据迁移与旧行删除归实装批 |
|
|
||||||
| v1.6 | 2026-10-09 | **去毒批**：速览旧目录九件表加退役标注+魔法提灯归属待裁指路 06/老正文过期声称清扫——新老框架分家 |
|
|
||||||
| v1.7 | 2026-10-09 | **文档正确性审查批**：头部横幅重写/沿革节两态表述换代/实现面表名失同步修正/老正文深层逐节收口+四节隔离标注/调参表与验收旧语境改写 |
|
|
||||||
| v1.8 | 2026-10-10 | 营地柜台名扫改（天赋树设计会话裁「道具工坊」改名「秘宝匣」）：两处改「营地·秘宝匣柜台」。机制零改动 |
|
|
||||||
| v1.9 | 2026-10-10 | **第一版秘宝全弃用收官批（用户裁「退役与封存都进素材库」）**：显影尘/地穴全图卷由 deferred 改 retired；正文四处换代；素材库四件迁表一；数据表四行删除归退役删行批 |
|
|
||||||
| v2.0 | 2026-10-10 | **秘宝解锁与槽位裁定批（grilling 审查轮，用户逐裁）**：①同调位上限=基础 3 格+第四只手突破至 4；②槽位数量与品质归天赋树同调位节点（1=普通格/2=优秀格/3=稀有格递增）；秘宝侧同调增长表改造为解锁条件表随实装批；③解锁方式换代=混合制（基础件钥石购买+特定件条件解锁，旧「档位谓词分级」作废）；④换装券=自主换装唯一渠道（显式例外）；⑤三选一刷新双源正文改「存量账/临时账」称谓（先扣临时后扣存量定案；X/Y 字母对表归实装批 T0）；⑥分界尺精确化=属性值指角色战斗属性值、经济与操作参数属操作包络（头部+核心循环分界节同步）；⑦中立移除「重生待定」标注摘除（素材库件同规）；⑧速览旧目录三段退役清理折叠为指针 |
|
|
||||||
| v2.9 | 2026-10-11 | **第四只手删除批（用户推导「带了等于没带」成立，主会话上轮净收益分析有算术错误致漏删）**：净账=占一槽换一槽（3=3）且自锁唯一稀有格（稀有格只能装它自己、额外格为优秀格）——严格劣于任何真秘宝，删除；稀有档 3→2、全目录 13→12 件；「跨域」概念撤回（用户澄清：天赋树与秘宝同为角色属性贡献者，不存在所有权排他——「归天赋树管」措辞改中性「由树节点提供」） |
|
|
||||||
| v2.8 | 2026-10-11 | **拾取渠道废止批（用户裁「秘宝只在冒险开始前配置，不存在任何冒险中更换方式」）**：删「冒险中的秘宝拾取」段；来路口径回单渠道（营地解锁）+绝对规则落文（无例外——拾取与效果均不产生装配变化）；验收增「装配不可变」条（冒险全程装配快照逐位不变断言）；受影响件扫描=13 件零件失效（唯一依赖换装的换装券已于 v2.7 删除） |
|
|
||||||
| v2.7 | 2026-10-11 | **目录修正批（用户复核抓出两个设计错误）**：①回能器删除（孤儿件——新目录无冒险级限量件，且关卡级/战斗级件天然周期重置、开局回充结构性冗余；优秀档 5→3，两位空位不构成补件议程）；②换装券撤消（**设计错误承认**：换装券系从「中途不可换装」规则反推的错误造物，从来不是秘宝件——真实机制=冒险中拾取未知秘宝、打开选择、携带满则替换）；③获取渠道换代=营地解锁+冒险拾取两条（原「不掉落」口径废止）；新增「冒险中的秘宝拾取」段（替换=获取事件与不可自主换装不冲突；投放渠道/候选构成/频率归实装批与数值批）；④效果轴操作能力/行动资源两格改空位、恢复机制改无现役来源；⑤全部「15 件」计数换代 13 件 |
|
|
||||||
| v2.6 | 2026-10-11 | **怪物巢穴类型退役批（用户裁）**：巢穴预告件效果文本换代（揭示本板危险格数量——件代号保留，命名归用户）；「巢穴计数」账名同步；世界观风味层巢穴隐喻保留（00-游戏概念隐喻轴） |
|
|
||||||
| v2.5 | 2026-10-11 | **可读性审查批（grilling，用户令「谁看了都知道它在说什么」）**：①术语指路行入头部（全库术语表同批建立）；②首用术语白话化/查表化（同调位、操作包络、RAP、GP、微光、巢穴等入术语表；slot_cost→每件固定占 1 格）；③黑话清扫=正主/落籍/P1 甲死指针/charges/结构闸/边界锚/批前/在册/单口/旋钮；④承重契约白话化+头注修正（非全部由加载校验强制）+真视前向引用补注；⑤验收分层句白话化；⑥两处过时事实修正=战斗道具窗口（2026-09-15 已下线，实证战斗结算文档）/21 项义务死指针（registry aux_items 实证无 obligations 字段，改写为随实装批消解）；⑦版本历史 v2.2-v2.4 行序修复；⑧全库术语统一随批（危险格/整图/专长凭证，见术语表 v1.0） |
|
|
||||||
| v2.1 | 2026-10-10 | **系统目录归位批（用户发现结构问题）**：本文件自 `systems/排雷循环/` 迁入 `systems/跨局循环/`——生命周期裁定=解锁/装配/存档持久全在跨局侧，排雷循环仅是生效现场；成因=前身「辅助道具」系切片期掉落形态故旧置排雷循环，同调换代只换内容未搬位置。文内向排雷循环四文档的引用改跨目录路径 |
|
|
||||||
| v2.2 | 2026-10-10 | **正文换代批（方案甲，用户裁「旧的删、误标改」）**：①定位与形态节压缩（沿革一句话；删过渡形态长段/中立移除规格段〔规格迁素材库 blast_kit 行〕/衔接纪律/事故留痕——正文零历史纪律）；②五维度框架节去「在役旧实现」错标改写（信息/风险/行动三维列新目录承载件，规划/反制豁免维持；逐件标注随实装批）；③使用编排/叠加层/边缘零信息三节去⚠（机制为新目录沿用）+举例换新件；④调参表清理（删旧目录六行句/投放态注记/playtest 预读行；订阅行段去件名举例与错标——效果引擎机制在役沿用）；⑤验收护栏与覆盖检查两条换代新目录语境；⑥「旧目录处置」小节删除（素材库表一承载）。真旧内容承载=素材库+git 历史 |
|
|
||||||
| v2.3 | 2026-10-10 | **设计骨架节落地（用户逐轮裁：三大类方向+代价×效果矩阵+使用代价空间+转化获取三通道）**：新增「## 设计骨架」节替换旧维度框架节——①叙述总纲=玩家体验两面（信息/操作）；②效果轴三方向（信息/行动资源/操作能力）+细分格开放清单（奖励预读空位备注微光常显重合；资源容量扩展/奖励预读等空位在案）；③代价轴三段=获取代价（钥石/条件解锁）+使用代价（按重置周期分层：冒险级/关卡级/战斗级/转化获取〔行为/资源/时间三通道，后两空位〕/常时；恢复机制独立参数=回能器关级回充只作用于冒险级件）+装配代价（slot_cost/档位格约束）；④用法规则五条（新件=效果格×代价格/档位=预置平衡带/覆盖检查只跑三方向且空位不构成议程/信息方向按减赌目的检验/账本独立值 provisional）；⑤旧五维度框架概念退役（v0.5 起在册的自查清单由骨架三方向继承；逐件归属随实装批登记）；⑥负责表/验收/依赖表相关行同步。骨架定位=可设计方向清单（类比奇物骨架、机能面层次），非既有件分类；本批过程事故在册=先行的行切片脚本损坏提交（deb1a80）已全文重写修复 |
|
|
||||||
| v2.4 | 2026-10-10 | **棋盘事实不可变裁定批（用户裁）**：①承重契约增条——秘宝效果不得移除/增改危险格位置与邻接数字，效果形态只允许信息呈现与开格动作；原爆破工兵包「中立移除」定性为违规形态、随件退役废止（规格留素材库作反面留档）；②设计骨架增预留方向行——无差别开格（3×3 全开、收益不获取惩罚不触发）预留，现不做后续拓展再裁，与天眼有差别开格相区分 |
|
|
||||||
| **v2.5** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「存量账+临时账两本账」→ 存量＋临时两笔；三处表头「写哪本账」→「写哪笔系统资源」；「各周期账本独立」→ 系统资源独立——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
# 锻造工坊
|
# 锻造工坊
|
||||||
|
|
||||||
> 一句话：营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的，钥石消费，一次冒险各选一件，满级特效留位本期不做
|
> 一句话：营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的，钥石消费，一次冒险各选一件，满级特效留位本期不做
|
||||||
> 状态：**v0.8 迭代 21 反哺④残余写入文档（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归 06」悬置指针终结（详见版本历史 v0.8 行）。承 v0.7 迭代 23 反哺写入（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装已随迭代 23 入库（2026-10-12，见版本历史 v0.7 行）
|
> 状态：**v0.8 迭代 21 反哺④残余写入文档（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归 06」悬置指针终结。承 v0.7 迭代 23 反哺写入（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装已随迭代 23 入库（2026-10-12）
|
||||||
> 成文底稿：`design/research/提案-武器锻造系统-2026-10-07.md`（提案过程稿——全部备选案与淘汰依据、用户原案逐条对照见彼；本文只收录定案口径；**未启用的满级特效候选池亦留彼 §八**，不进正文）
|
> 成文底稿：`design/research/提案-武器锻造系统-2026-10-07.md`（提案过程稿——全部备选案与淘汰依据、用户原案逐条对照见彼；本文只收录定案口径；**未启用的满级特效候选池亦留彼 §八**，不进正文）
|
||||||
|
|
||||||
## 设计目的
|
## 设计目的
|
||||||
@@ -224,20 +224,3 @@
|
|||||||
|
|
||||||
### 10 · 数值与验证
|
### 10 · 数值与验证
|
||||||
全部数值 provisional 归 Alpha 收官 M4 数值批；实装批必须带改前 / 改后同随机种子配对读数验证难度影响。
|
全部数值 provisional 归 Alpha 收官 M4 数值批；实装批必须带改前 / 改后同随机种子配对读数验证难度影响。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 变更 |
|
|
||||||
|---|---|---|
|
|
||||||
| v0.8 | 2026-10-13 | **迭代 21 反哺④残余落文（用户裁「按呈报落文」）**：「树侧钥匙」句换代——钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归 06「天赋树实装批」」悬置指针（该 06 条已随 480 清理批销号）终结。机制零改动 |
|
|
||||||
| v0.7 | 2026-10-13 | **迭代 23 反哺落文批（实现报告 §五，用户裁「在这里进行更新」；追认单九项同日全数追认）**：①正文补 Q1 等级语义衔接——「三件武器」节与「工作间内容清单·4」两处补「0 级 = 未练合法态」（未解锁/未锻造 = 0 加值裸体态，锻出第 1 级 = 首个 +1；原正文「1 到上限」未同步 Q1 续裁）；②「满级特效扩展位」节与「现役代码事实」表——效果引擎效果类型闭集 24 种→**31 种**（原记系 2026-10-07 旧快照，迭代 20 T1 +7、迭代 22 T3 +1；冒烟断言钉 31）；③实装边界 1 回填实装实态——落表=新表 forge.tres（ForgeTable 默认两轴+六路线行族）、路线 id 六个、字段闭集 12 项、ConfigDB.forge_* 访问器（「归实装批定义」已兑现）。机制与数值零改动（provisional 终值仍归 M4） |
|
|
||||||
| v0.1 | 2026-10-09 | 首版成文（用户令「完成文档编写、代码不实现、记录待办」）——按提案 v1.1 推荐案收录定案口径：柜台就地改造/三武器三甲独立路线/纯钥石零材料/前缓后陡/复用为主特效框架；17 裁点开放在册待用户逐点裁决；02-系统清单、元进度指路句、06 专条与实装待办随批同步 |
|
|
||||||
| v0.2 | 2026-10-10 | 天赋树设计会话裁定跨文档同步批：「柜台承载」节补登记树侧解锁门——本柜台以天赋树「锻造工坊」解锁节点为前置（免费节点，前置 = 攻击淬炼/护甲淬炼累计各 ≥2 级，等级阈值前置属新机制；实装归 06「天赋树结构重构批」）。机制设计零改动 |
|
|
||||||
| v0.3 | 2026-10-11 | **更名批（用户令，锻造工坊裁决会话）**：系统名「武器锻造」→「锻造工坊」——本文档改名 `锻造工坊.md`，与树上钥匙节点同名；全库现行指路链接与 06 实装批条名随批换代，提案过程稿文件名、用户原案引文、迭代 18 qa 清单与各版本历史行内旧名按历史记载保留；「武器锻造区/护甲锻造区」区名随承载裁决收口另改。机制设计零改动 |
|
|
||||||
| v0.5 | 2026-10-12 | **B 组定案落文（锻造工坊裁决会话续，用户逐点裁决）——17 裁点清零**：①1 丙=当前武器单选+每件独立路线；②1a 扩面=**一次冒险一个武器类型+一个甲型**（原只问武器携带数）；③1b/1c=营地免费切换·冒险开始后锁死；④**2a 推翻**——伪裁点消解：伤害结算只有一套、单据自带 attack_type 栏，删"叠加/替代/互斥"三分法，改陈述「同一矩阵·单据自带类型·差异只在单据形态与生命周期」；⑤**2b 随 3a 自动消解**（非独立裁点，条件是"魔法甲≠ward"）；⑥3a=统一命名**魔法护甲**（ward；「魔法甲」系**笔误**不做简称处理，registry 不登记别名）；⑦**3b 推翻**——敌方攻击有类型、未设置=默认普通 ⇒ 甲型差异「基础 AC + 克制修正」两轴当下即生效，原"诚实收窄/克制反向留结构位"整段作废，并如实登记现役落差（敌方单据 attack_type="" 恒不查矩阵、`enemy.tres:527` 轴未开）为**跨系统汇合点**（填值面归敌人系统/战斗结算）+ 连带后果（三型成纯序、魔法护甲双负无优势窗口）；⑧3c=每型独立路线；⑨4a=前缓后陡（只锁方向）；⑩**4a-1 撤回**——"曲线×定价=又贵又弱"结论无依据，不落方向性判断，只留"两条旋钮同批标定"程序句；⑪4b=锻造内自闭环；⑫4b-1=**并联双通道**（练满前一档 OR 一次性解锁价，互不影响）；⑬5b=纯钥石（用户注：后续若要区分再重构，不预先建面）；⑭5c=零材料；⑮**6 推翻**——满级特效**本期不做**，只留扩展位（不设计清单/不定值/不实装/不开参数位/存档不设特效域），七条候选池退回过程稿 §八；⑯8a=工作间**两区定名 + 路线行名**（区=武器锻造区/护甲锻造区；行=长剑锻造·长枪锻造·法杖锻造、轻甲锻造·重甲锻造·魔法护甲锻造，第一件武器显示名 剑→**长剑**）；**并核结用户指出的事实——局内不存在武器/护甲提升**：商店货架三行"攻击锻升/生命锻升/护甲锻升"实为奇物「属性值提升」三轴的货架前台标签（`shop.tres` pool_shelf kind_id → `adventure.tres` CURIO_KINDS），与锻造无关，是否去"锻"字归实装批呈现面。连带：设计目的节能力台阶收缩为新武器/新甲解锁；实装边界重编号（特效条目改"本期不实装"、新增敌方攻击类型填值条）；「待裁决清单」换代为「裁决结果清单（17 裁点全表）」+新增「工作间内容清单（实装批需求卡片输入）」两件交付。**同日五点澄清（不升版本）**：①2a 用户确认无异议——按**统一伤害轴**走（删三分法）；②2b 连带确认：只有魔法护甲一型，**「魔法甲」系笔误**而非别名，registry 不登记别名、第四甲型议题彻底消解；③3b 的连带后果**不在本批考虑**——用户裁定其为**后续开发改造的前置信息**（敌方攻击差异化与魔法护甲正当性归后续批，本批只按统一伤害轴落结构与字段）；④**8a 的 Y 层**（路线行名）定案="件名 + 锻造"，第一件武器显示名 剑 → **长剑**；⑤**用户指出局内不存在武器提升——属实**：货架三行"锻升"是奇物「属性值提升」三轴（`shop.tres` pool_shelf 的 kind_id 指向 `adventure.tres` CURIO_KINDS）的货架前台标签，进冒险加算区、冒险结束清零，不是武器也不是护甲；**⑥同日 C/D 两项改名裁决**——C：货架三行「X锻升」→「**X祝福**」（攻击祝福 / 生命祝福 / 护甲祝福，后缀 = 用户选定，D&D 参照为 Blessing），机制分类名「属性值提升」不动、只改玩家向显示名，执行归独立改名小批（06 在册，本会话按禁动 game/ 纪律不代执行）；D：棋盘格 defense 正向行与 `ac_up` 状态的同名次 **护甲强化** → **盾牌加护**（用户提案，理由=它是临时叠层状态而非护甲本体；附带约定「加护 = AC 判定层，护盾 = 保险丝那种吸收层，两者不得混用」），同样归改名小批——**注：D 改名连带 `smoke_all.gd:1199` 一条硬编码断言，必须同步改，否则冒烟红**。开工门（17 裁点清零）已满足 |
|
|
||||||
| v0.4 | 2026-10-11 | **A 组定案落文（锻造工坊裁决会话，用户逐裁）**：①承载换代——营地四柜台并排（树淬炼/锻造工坊/秘宝匣/奖励格图鉴），攻防独立柜台、工作间内武器/护甲两区并列零顺序门槛、宽度不足滚动条兜底、程序占位视觉终稿归 HUD 营地批（A②A③）；②生命档移除——生命强化唯一入口=树脊柱生命线，本工作间纯攻防（A①；实装边界①同步）；③**攻防所有权切分**——攻击唯一入口=武器路线、AC 唯一入口=甲路线，树脊柱砍攻击/护甲两线、树零攻防来源（红线；树侧 29→21 落文归天赋树会话交接批）；④树侧钥匙改无前置直接可点亮（原等级阈值前置随两线砍除作废）；⑤注入衔接落文——锻造路线加值=当前武器攻击加值+当前甲 AC 加值，只按当前选中生效；⑥死条件 magic_vs_magic 复活案作废（D 组核结：魔网织者在素材库表二退役名单；2c 结案）；⑦「道具工坊」退役词清除（承载节随 A② 改写一并换代为秘宝匣）；⑧存档域改旧档废弃口径（开发阶段无迁移）。B 组 15 裁点挂起待用户发令 |
|
|
||||||
| v0.6 | 2026-10-12 | **完备性检查批（grilling 全库核查——现役代码事实/关联文档/引用一致性三路，用户逐条裁）**：①**现役事实基线换代**——`meta.tres` forge_products 行族已随迭代 21 T5 攻防所有权切分整体退役（行族/访问器/购买面三处退役登记），「改造现役行（吸收）」语义全线订正为「新建行族」（现役代码事实表/三件武器表/工作间清单/实装边界 1 五处）；定价「现役参数沿用」改「历史考古参数（20 钥石/150% 公比，`meta.tres:82-84` 退役批注）、实装投值归 M4 从零标定」；②**两根类型轴所有权移交（用户裁）**——`attack_type`/`armor_type` 默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除；选中态写存档域+冒险开始参数面注入（订正原「写 hero.tres 休眠轴」口径——与现役「表运行期只读」纪律 `meta_progression.gd:12-13/119` 及本文存档域条目双重冲突）；默认值与柜台解锁状态解耦（未解锁=无交互入口但配置常驻可读，不存在读不到默认值的窗口）；③**两处无依据表述订正删除**——「与秘宝解锁的混合制同构」（「同构」非本项目概念；与秘宝仅共享钥石单币+直购/条件解锁成分语义，通道结构不同：件级单通道分派 vs 同路线双通道并联）、「选长枪激活穿刺系专长的价值」（现役专长均为跨攻击类型通用件、不按 attack_type 分系，`feats.tres` 29 行实证，该表述无现役对应物）；④货架坐标订正（CURIO_KINDS 实为 `adventure_table.gd:29` schema 常量、feat_ticket 为显式豁免种 5/6 命中）+ 改名小批执行态回写（已合入 master `0c93a71`/`0144f60`）；⑤存档域预登记存档序列化.md（用户令：验收文档现在做、不等实装批）；⑥联动落文：元进度.md「跨局注入」节补四层叠加公式（v1.4）、术语表.md 新增锻造工坊节、entities.yaml terminology 补词条+新建锻造工坊条目。**不在本批范围（呈报归属，谁的问题谁改）**：registry ac_up 显示名失同步（归改名小批 D 项）、「魔法甲」四处残留（敌人系统/美术三档，归 3a 裁执行面）、registry meta_table 条目 forge_products 滞后（归元进度线）、天赋树.md 状态行滞后、06 提案条标题旧名 |
|
|
||||||
| —— | 2026-10-12 | **同日续裁写入文档（不升版本）**：①**编入迭代 23**（用户令——roadmap 主线序列 + 06 实装批条状态同步；M4 数值批顺延迭代 24+）；②实装边界 6 订正——敌方 attack_type 为敌方定义数据（enemy.tres/skills.tres 行级，与敌种名字/血量同批同时读写、无独立时序），「两批排期协商」句删除（用户 D 裁：时序问题不存在；本批只按 3b 裁落结构面）；③存档域「合并评估」语境订正——forge_routes 独立成域已预登记，树批入库后无共域冲突（用户 C 裁：非裁点，06 实装批条同句订正）；④A 项（未解锁时默认值读取路径）确认口径=配置表常驻持有、解锁只门控交互不门控读取，v0.6 正文已落此文；⑤**等级语义裁（Q1）**——初始持有路线 0 级起步：未解锁/未锻造=0 加值（裸体态，类型=普通/轻甲）；解锁并锻造第一级=「获得装备」=1 级=首个 +1 加值；逐级递进。正文「1 到上限」为量级描述（1-5 级），0=未练合法态；⑥**provisional 值落卡（Q2）**——需求卡片 T1 锚表：cap 5/武器与护甲每级增量统一 +1（累计 1/2/3/4/5；provisional 线性起步，4a 前缓后陡为终值形状方向归 M4）/甲型基础 AC 10/12/9（现役结构值）/价格 20×150%^n（20/30/45/67/101）/解锁价 200（中段三级 213 的九折）；provisional 归代拍板沿锚投值、终值 M4 |
|
|
||||||
| v0.9 | 2026-10-15 | **简明技术中文用语规范批（用户令）：词面修正 2 处**——「落文」→「写入」1 处（裁决结果清单表头「落文处」→「写入处」）；「收口」→「完成裁决」1 处（4b-1 行备注「原正文"或"字歧义收口」）。另按失同步核对修正文头状态行：版本注 v0.7 → v0.8（v0.8 迭代 21 反哺④残余落文行已入库而状态行未随批更替，本批补齐，事实零变更）。机制与数值零改动 |
|
|
||||||
| v0.10 | 2026-10-18 | **文档卫生批（用户令）：死链清偿**——文头状态行尾句「实装待办在册 06-待办清单「锻造工坊实装批」条——开工门 = 17 裁点清零 + 用户发令，裁点门已满足」过期指路换代：该 06 条已随批次完成销号，状态行尾句改记入库事实（实装已随迭代 23 入库，2026-10-12，见 v0.7 行）。机制与数值零改动 |
|
|
||||||
| **v0.11** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「钥石账本与营地柜台结构」→ 钥石与营地柜台结构——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
+1
-22
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> **Status**: Complete — /ux-review 修订落稿（2026-09-12，blocking 7 项已修，待复检）
|
> **Status**: Complete — /ux-review 修订落稿（2026-09-12，blocking 7 项已修，待复检）
|
||||||
> **Author**: user + ux-designer
|
> **Author**: user + ux-designer
|
||||||
> **Last Updated**: 2026-10-15（简明技术中文用语规范批：词面修正 30 处——见文末修订记录）
|
> **Last Updated**: 2026-10-15（简明技术中文用语规范批：词面修正 30 处）
|
||||||
> **Platform Target**: PC (Steam)——Keyboard/Mouse 主（全部操作纯鼠标可完成）、Gamepad Partial 非 MVP、Touch None（同 technical-preferences）
|
> **Platform Target**: PC (Steam)——Keyboard/Mouse 主（全部操作纯鼠标可完成）、Gamepad Partial 非 MVP、Touch None（同 technical-preferences）
|
||||||
> **上游修订依赖**: 弃图刷新挖掘期受理已随布局决策 4 落稿上游（2026-09-12：行动经济 Active 受理 + 每轮上限 2 次、排雷玩法 Active·仅刷新路径装板、战斗结算 `refresh_board` 编排 + 恒 same_board、registry `rap_rules` 同步——见 OQ11）
|
> **上游修订依赖**: 弃图刷新挖掘期受理已随布局决策 4 落稿上游（2026-09-12：行动经济 Active 受理 + 每轮上限 2 次、排雷玩法 Active·仅刷新路径装板、战斗结算 `refresh_board` 编排 + 恒 same_board、registry `rap_rules` 同步——见 OQ11）
|
||||||
> **Template**: UX Spec
|
> **Template**: UX Spec
|
||||||
@@ -427,24 +427,3 @@
|
|||||||
| 敌人系统资产下限 | 受击反馈/死亡表现/顺位标记 | §Transitions 受击 + §States 敌人死亡呈现（禁瞬消）+ §Component 顺位徽标；呈现语义在本 spec（同等 blocking），动画密度归战斗表现 |
|
| 敌人系统资产下限 | 受击反馈/死亡表现/顺位标记 | §Transitions 受击 + §States 敌人死亡呈现（禁瞬消）+ §Component 顺位徽标；呈现语义在本 spec（同等 blocking），动画密度归战斗表现 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 修订记录
|
|
||||||
|
|
||||||
| 日期 | 改动 |
|
|
||||||
|---|---|
|
|
||||||
| 2026-09-15 | 雾格残留清理：格态收窄为已开 / 未开两态（删除雾图变体状态行、四格态 AC 与已开雾格 tint / 雾区全开信号两条 AC）；图例面板与 toast 槽去掉雾条目与雾首遇提示；BoardView 纹带、绘制优先级与色弱冗余改按通用变异纹带表述；`ux_hint_shown` 的 hint_id 枚举去掉 fog_first；输入义务与 §13 义务对照表去掉 地形变异×3 一项；目标感知示例与提示文案 OQ 措辞同步。本 spec 不装载被移除机制的呈现义务 |
|
|
||||||
| 2026-09-16 | 格面资源批 UI 欠账完成（随 2026-09-15 可选类道具删除的代码完成同步文档）：① 布局四区化——删 E 区道具面板行、布局决策 2（道具窗口形态=右栏原位激活）整段删除（编号留空防交叉引用失锚）、ASCII 线框图重绘为 A/B/C/D 四区（D 区横向加宽 ~1036px）、A 区节点链示例改文字签槽实际渲染（战/赏/疗/王）；② States 删道具窗口态与零库存空态（「道包空空」）；③ 结算口径五段化（授予→增益/减益→战斗→衰减→判定）与明细行 10 类封闭协议（删 15 类行、四类行旧口径；「奖励未生效」行保留）；④ 交互/动效/事件表删道具窗口行、跳过按钮、`ux_window_choice`、`submit_window_selection`；⑤ 数据源登记删 `query_inventory` 与窗口载荷，奖励身份按现行 `query_identity` 只读回调口径校正；⑥ 验收清单删窗口断言、五区改四区、未生效类行改现行两型（溢出未生效/奖励未生效）；⑦ 关卡末清库反馈义务改载秘宝背包（随秘宝 P0 落地，本批不设计具体呈现）；⑧ OQ7（道具窗口原位激活）删除、OQ 重编号，「囤刀待机」等旧可选类措辞清理。本 spec 不装载被删除机制的呈现义务 |
|
|
||||||
| 2026-09-20 | **敌人卡形态裁决完成（2026-09-20 用户看对照样张拍板，06 待办「敌人卡形态」解决移除——状态记录 99）**：全站桩形态定稿——① B 区主角与敌人均为无框立绘+底座（站桩式），**英雄卡/敌人卡组件整体退役，卡片式不再作为候选**；主角血条悬浮头顶、状态效果小图标一排挂血条正下方，敌人血条+顺位徽标悬浮头顶、状态小图标同款挂血条下；攻击值等规划数据仍归 C 区数据框（C 区不动）；② 布局表 B 区行、Component Inventory 英雄卡/敌人卡两行随裁决改写（敌方 side 池共享层数各立绘同值、意图动画占位等既有语义平移到站桩载体，不随形态改变）；③ ASCII 线框图 B 区重绘（旧"意图:爪击/环点"示意早已随行为环退役，本次一并清掉）；④ OQ4 改写为裁决已完成注记，对照样张存档 `production/mockups/`；呈现义务细节重述（受击/退场演出挂点等）随表现层升级批执行 |
|
|
||||||
| 2026-09-23 | **停点前移批（冒险入口流程倒置修复，用户 2026-09-23 拍板；上位裁决 = 棋盘/战斗舞台 Node2D 迁移批（已执行完毕，git 历史可查），代码实装另批并行）**：① 布局四区 → 三区——删布局表 A 区关卡进度条行与 Component Inventory LevelStripView 行（LevelStripView 退役删除，节点链进度只留关卡画面，战斗屏零进度承载）；C/D 底行 520 → 548；ASCII 线框图重绘为 B/C/D 三区；② 新流程口径写入文档——关卡画面（选路覆盖层常驻形态）为关卡内常驻枢纽：Navigation Position 图、到达语境、Entry 表、信息层级第 5 层、Data Requirements 节点图行改「关卡开始即出图选路、战后返回关卡画面再选路」；③ AC 四区措辞改三区。**批内代拍板三项已追认（2026-09-24 用户确认）**：① B/C/D 字母保持不重编；② 28px 纵向空间划归 C/D 底行（520 → 548）；③ 关卡画面进度呈现由选路覆盖层节点态承载（暗金已过 / 金当前 / 亮金候选通道 / 旗朱 Boss）、不另设进度条组件 |
|
|
||||||
| 2026-09-23 | 实现注记（棋盘 Node2D 迁移批 Phase A，代码实装同批）：棋盘渲染 Node2D 化（BoardView = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界，信号/click_cell/_cells 契约保持，新增 push_input 端到端输入探针）；格尺寸公式锚点不变（set_cell_area = floor((min(宽,高) − 预留 − (N−1)×格间距) / N) 单点可调），布局与交互语义零改动 |
|
|
||||||
| 2026-09-26 | 实现注记（战斗舞台 Node2D 迁移批 Phase B，代码实装同批）：B 区战斗画面 Node2D 化（BattleStageView = Control 壳 + SubViewportContainer + SubViewport + Node2D 世界，站桩本体 StandeeBody 世界精灵；set_enemies/clear_enemies/on_step_row_fx/gray_all_enemies 等 setter 面签名保持，弹道落点锚点=壳层口径 world_to_shell 单点）；状态图标行与悬停 tooltip 保留 Control 载体挂壳层；三区布局尺寸零改动（B 区外框 252px 逐位） |
|
|
||||||
| 2026-09-26 | **封印紫批**（用户拍板）：插旗呈现色 旗朱 #C63D22 → 封印紫 #7C3AA8（色相 ≈267°，避开禁入带）——旗字形/已承诺封印框/旗化暴击弹道顺带换色；拒绝边框闪语义归危险红；Boss 节点描边归紫赤本色。修订记录历史行旗朱字样系当时口径留痕不改 |
|
|
||||||
| 2026-09-26 | **战斗屏信息归属批（用户 2026-09-26 三轮纠偏后拍板；代码实装另批——hero_info_panel_view.gd / hud_presenter.gd 改造 + 探针断言迁移，登记待办）**：立两条信息归属原则并全屏贯行——①循环口径原则（战斗屏只展小循环内被消费、影响当下决策的数据；中/大循环资源禁止入侵）②单一展示面原则（同一信息全屏唯一展示面；单位本体已承载的信息数据框不重复；资源数字贴唯一消费口）。随拍板落地：① B 区站桩 = HP 与状态效果唯一展示面——C 区 HP 条/HP 文字/立绘占位/状态效果槽×4 退役（重复展示；证据链 = hud_presenter.gd 同一 s.hero.hp/s.hero_effects 双投喂 B/C 两区）；② RAP 读数（点阵+数字）迁 D 区 AP 条、置弃图刷新按钮旁（RAP 唯一消费口 = 弃图刷新——就近原则）；③ C 区状态槽悬停 tooltip 职责并入 B 区站桩状态小图标；④ GP（中循环）/钥石（大循环）迁出战斗屏，去向挂 OQ14；⑤ C 区改「攻击数据框 + 秘宝槽（预留）+ 本关强化列表（预留）」——预留区来自秘宝与关卡内属性提升的既有立项；⑥ 空态/清零反馈/悬停交互/AC/§13 义务表载体同步改写。**批内遗留两项待拍板（OQ13/14）**：护甲 AC 是否补入 C 区数据框；GP/钥石去向 |
|
|
||||||
| 2026-09-26 | **信息归属二轮拍板（用户 2026-09-26，OQ13/14 完成）**：① 我方护甲 AC 补入 C 区攻击数据框（唯一展示面——布局表/组件清单/线框图同步）；② GP/钥石去向定案：GP = 关卡画面常驻总量 + 战斗结算画面总量+增量，钥石 = 结算画面 + 营地（具体呈现归对应 UX spec 批次）；③ 敌方 AC 展示面挂起——用户口径「敌方 AC 无任何展示」与现行代码冲突（standee_view.gd 底库名字行渲染「名字·护甲·AC%d」，系敌人技能池批克制对策可读性义务），证据链已呈报待终裁，本 spec 暂不改敌人站桩行 |
|
|
||||||
| 2026-09-26 | **敌方 AC 展示终裁完成（用户 2026-09-26 终裁）**：敌方 AC 数值全屏退役（任何区不直接展示）、护甲类型改图标方式展示（形状+色相双通道，终稿图标资产归美术批）、敌人站桩底座下名字行退回纯名字+护甲类型图标；旧「克制对策可读性义务」降级承载——类型保留、数值退役。终裁理由（用户口径）：HP 信息已足够，攻防数值不直接写上；护甲类型图标保留克制对策可读性。同步改写：信息归属树敌人站桩行、Component Inventory 敌人站桩立绘行、OQ13。**代码实装说明**：`standee_view.gd` 改造（站桩名字行去 AC 数值 + 护甲类型图标化）由并行代码批执行，本批只做文档同步 |
|
|
||||||
| 2026-09-27 | **UX 文档欠账处置批（用户四项拍板：player-journey 不建 / accessibility 不另立改指 HUD框架 / node-reward 改挂秘宝内容重定批 / level-clear 建档 design/gdd/ux/level-clear.md）**：① 删 §Player Context ⚠️ player-journey 未建注记，OQ1 改完成注记；② §Accessibility 头、§Transitions 减动效行、OQ2 改指 HUD框架「可访问性基线」节 + 设置与本地化待设计清单 #1（tools/doc_link_known.txt 欠账行随之清空）；③ 导航残留修正——§Navigation Position 图胜利分支、§Entry/Exit 离开表、§Interaction Map 胜利 overlay 行改按现行代码实态（胜利后返回关卡画面选路；节点覆盖层 = 关卡画面域、落地奖励/恢复节点时开出；胜利/失败 overlay 组件锚 battle_end_overlay.gd）——原「胜利 → 节点奖励/恢复覆盖层」系停点前移批前残留；④ OQ3 过期陈述更正（interaction-patterns.md 2026-09-12 已建成）、OQ8 改完成注记。本批只动文档面，代码零改动 |
|
|
||||||
| 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），系投放渠道全退役后恒空的机械惰性承载，拆线归实装批；同调装配件不经此域的结论不变 |
|
|
||||||
| 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 30 处——不得×5→禁止（信息层级依据句/信息归属循环口径条/敌人意图映射目录注记〔键名禁作现行 enemy_id 引用〕/敌人死亡呈现行〔敌人系统资产下限〕/AC 效果行）；收口×11→完成（C 区奇物列表批注〔含随批→顺带〕/布局表 B 区行/意图映射目录命名双轨注记/线框图头注 2026-09-20/OQ1/OQ2/OQ8/OQ9/OQ13 已终裁收口→已终裁完成/OQ14 已拍板收口→已拍板完成＋「随 spec 命名收口退役」→「随 spec 命名完成退役」）；buff×1→增益（胜利终局行微文案引句「我的增益哪去了」）；台账×10→状态记录（Events 呈现订阅行/Data Requirements 三处/终局数据锚行/架构注记/更新触发注记/场景级测试头/§13 记法注/义务表战斗结算行与地图战斗资源行）；随批×2→顺带（下游屏行/可挖域微光注记）；Last Updated 同步本批。ambusher（伏击者）历史退役词留痕行一字未动 |
|
|
||||||
+2
-14
@@ -1,6 +1,6 @@
|
|||||||
# 营地覆盖层 UX spec（camp）
|
# 营地覆盖层 UX spec（camp）
|
||||||
|
|
||||||
> 状态：v1.5（2026-10-15 简明技术中文用语规范批：文头状态行对齐版本历史——原标 v1.1 滞后，实态=v1.4 状态面板改名批补漏；spec 基线=2026-09-30 审计拍板点 4A 用户裁决落文〔乙案新建 ux spec+元进度配套更改〕；视觉终稿已随迭代 9 9A 段落码，本 spec 成文其呈现规则）
|
> 状态：v1.5（2026-10-15 简明技术中文用语规范批：文头状态行按实态订正；spec 基线=2026-09-30 审计拍板点 4A 用户裁决落文〔乙案新建 ux spec+元进度配套更改〕；视觉终稿已随迭代 9 9A 段落码，本 spec 成文其呈现规则）
|
||||||
> 事实源：`game/presentation/views/camp_overlay_view.gd`（CampOverlay——9A 视觉终稿后实态）
|
> 事实源：`game/presentation/views/camp_overlay_view.gd`（CampOverlay——9A 视觉终稿后实态）
|
||||||
> 机制权威：[元进度](../systems/跨局循环/元进度.md)（营地三柜台/钥石/永久强化——营地=界面壳、机制主语=永久强化）
|
> 机制权威：[元进度](../systems/跨局循环/元进度.md)（营地三柜台/钥石/永久强化——营地=界面壳、机制主语=永久强化）
|
||||||
> 相邻：[settlement-summary.md](settlement-summary.md)（最近冒险摘要数据同源）/ [level-map.md](level-map.md)（主菜单语境）
|
> 相邻：[settlement-summary.md](settlement-summary.md)（最近冒险摘要数据同源）/ [level-map.md](level-map.md)（主菜单语境）
|
||||||
@@ -21,7 +21,7 @@
|
|||||||
## 口径
|
## 口径
|
||||||
|
|
||||||
- 呈现数据源 = MetaProgression 只读投影经组合根喂入；本层不持有系统资源、不算价。
|
- 呈现数据源 = MetaProgression 只读投影经组合根喂入；本层不持有系统资源、不算价。
|
||||||
- 退役/封存件呈现语义已随旧目录整体退役消解（探宝罗盘/显影尘/地穴全图卷等状态行已删——迭代 22 旧 12 行删除后目录内零 deferred/retired 态，2026-10-12）；历史语义见版本历史 v1.1。
|
- 退役/封存件呈现语义已随旧目录整体退役消解（探宝罗盘/显影尘/地穴全图卷等状态行已删——迭代 22 旧 12 行删除后目录内零 deferred/retired 态，2026-10-12）；
|
||||||
- 双入口框架（主菜单入口+局内状态面板只读入口〔2026-10-13 由「暂停层」改名——游戏非实时无暂停语义〕）的需求面归元进度「解锁双入口框架」节；状态面板入口已实装（2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户，06 登记条在册），其呈现面不归本 spec。
|
- 双入口框架（主菜单入口+局内状态面板只读入口〔2026-10-13 由「暂停层」改名——游戏非实时无暂停语义〕）的需求面归元进度「解锁双入口框架」节；状态面板入口已实装（2026-10-06 迭代 17 卡③〔时名暂停层〕——实机目检待用户，06 登记条在册），其呈现面不归本 spec。
|
||||||
|
|
||||||
## 秘宝匣柜台呈现细则（迭代 22 实装态，2026-10-12）
|
## 秘宝匣柜台呈现细则（迭代 22 实装态，2026-10-12）
|
||||||
@@ -33,15 +33,3 @@
|
|||||||
- **空目录合法态**：白板档（12 件全未解锁）柜台零可装行=合法态非缺陷（装配面空目录断言 V18 在役）。
|
- **空目录合法态**：白板档（12 件全未解锁）柜台零可装行=合法态非缺陷（装配面空目录断言 V18 在役）。
|
||||||
- **状态面板只读概览**：局内状态面板秘宝匣段=12 行只读清单（解锁态+装配态概览，零写入口——装配只在营地）。
|
- **状态面板只读概览**：局内状态面板秘宝匣段=12 行只读清单（解锁态+装配态概览，零写入口——装配只在营地）。
|
||||||
- 机制权威=元进度/秘宝.md；本节只锁呈现规则。
|
- 机制权威=元进度/秘宝.md；本节只锁呈现规则。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.4 | 2026-10-13 | **状态面板改名批补漏（用户质询发现——原改名批漏扫本文件：批内 grep 路径误写 design/ux/〔不存在〕致假阴性「零命中」）**：正文两处换代（双入口框架句+秘宝匣段「状态面板只读概览」，均括注改名来历；版本历史行内旧名按历史记载保留）。机制零改动 |
|
|
||||||
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 4A 裁决：乙案新建+元进度配套更改；9A 视觉终稿实态成文） |
|
|
||||||
| v1.1 | 2026-10-09 | 文档正确性审查批：①头注「M-3 迭代 9」前缀按里程碑口径删除只留「迭代 9」；②口径节「暂停层入口未实装（随 HUD 批 M-4）」过期订正——暂停层只读入口已实装（迭代 17 卡③，2026-10-06，实机目检待用户） |
|
|
||||||
| v1.2 | 2026-10-10 | 「道具工坊」改名「秘宝匣」扫改（2026-10-10 天赋树设计会话裁）：定位句与三柜台列两处。机制零改动 |
|
|
||||||
| v1.3 | 2026-10-12 | **迭代 22 反哺落文批（实现报告 §三⑤，用户裁「落文」）**：新增「秘宝匣柜台呈现细则」节（购买钮禁用态/条件进度/名后缀·档位/装配行档位标签/未解锁禁装/悬停 desc/空目录合法态/暂停层 12 行只读概览）；三柜台列秘宝匣行换代指路；退役/封存件呈现语义口径随旧目录删除消解（历史语义留版本历史）。机制零改动 |
|
|
||||||
| v1.5 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 0 处；文头状态行失同步修复——原标 v1.1〔2026-09-30〕滞后于版本历史最新行 v1.4〔2026-10-13 状态面板改名批补漏〕，本行对齐。机制零改动 |
|
|
||||||
| **v1.6** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「只读账面」→ 只读读数；「零账本/不持有账本」→ 零系统资源写入/不持有系统资源——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
> **Status**: Complete（核心 8 成文〔2 号已退役留档〕+ 12 目录占位）
|
> **Status**: Complete（核心 8 成文〔2 号已退役留档〕+ 12 目录占位）
|
||||||
> **Author**: user + ux-designer
|
> **Author**: user + ux-designer
|
||||||
> **Last Updated**: 2026-10-15（简明技术中文用语规范批：词面修正 6 处，见文末修订记录）
|
> **Last Updated**: 2026-10-15（简明技术中文用语规范批：词面修正 6 处）
|
||||||
> **Template**: Interaction Pattern Library
|
> **Template**: Interaction Pattern Library
|
||||||
> **来源**: `design/gdd/ux/battle.md`（2026-09-12 /ux-review APPROVED）已拍板内容的成文固化——本库不引入新设计决策
|
> **来源**: `design/gdd/ux/battle.md`（2026-09-12 /ux-review APPROVED）已拍板内容的成文固化——本库不引入新设计决策
|
||||||
|
|
||||||
@@ -213,13 +213,3 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab
|
|||||||
2. Gamepad 批次引入时，需为 pattern 4/12/15 增补手柄映射节（焦点序已在 battle.md OQ8 留位）
|
2. Gamepad 批次引入时，需为 pattern 4/12/15 增补手柄映射节（焦点序已在 battle.md OQ8 留位）
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 修订记录
|
|
||||||
|
|
||||||
| 日期 | 改动 |
|
|
||||||
|---|---|
|
|
||||||
| 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 全史复核**从未入库**（「已实现」系失实登记），库存面已随秘宝过渡形态退役，状态改「占位失效」 |
|
|
||||||
| 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 6 处——不得×5→禁止（pattern 1 触发条/pattern 5 更新触发条/pattern 6 内容条/pattern 7 Description/pattern 偏差规则）；随批×1→顺带（Open Questions 目录占位补全时点条）；Last Updated 同步本批 |
|
|
||||||
@@ -120,15 +120,3 @@
|
|||||||
5. **替换子交互视觉形态——已随渠道退役**：秘宝件出池后本屏无道具件候选，替换子交互不于本屏触发（原功能性判据留档）
|
5. **替换子交互视觉形态——已随渠道退役**：秘宝件出池后本屏无道具件候选，替换子交互不于本屏触发（原功能性判据留档）
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 修订记录
|
|
||||||
|
|
||||||
| 日期 | 改动 |
|
|
||||||
|---|---|
|
|
||||||
| 2026-09-27 | 初稿（UX 文档欠账处置批，用户拍板建档）：义务锁定版——大奖励三件套/钥石入账/清库反馈预留成文；现行载体（_inter_overlay 与 BattleEndOverlay 复用）与代码锚如实登记；GP 归属两处登记不一致挂 OQ1，拍板前不新增 GP 呈现义务 |
|
|
||||||
| 2026-09-27 | GP 归属拍板对齐批（用户口径：战斗胜利→战斗总结结算展示获得资源〔目前 GP〕；战斗失败→冒险总结结算→确认回存档首页）：OQ1 完成——GP 总量+增量归战斗胜利总结结算（battle.md OQ14 为准），本屏不承载 GP；OQ3 完成——「结算画面」指认 = 冒险总结结算，大奖励屏钥石进账 + 冒险总结结算明细两处并存维持；信息归属 GP 移入禁入清单；Data Requirements GP 行改零访问；06 归属行同步修正 |
|
|
||||||
| 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 同口径 |
|
|
||||||
| 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 4 处——随批×2→顺带（Status 行目检清单交付/OQ4 实装后目检清单交付）；收口×2→已完成（OQ1 GP 增量展示面归属/OQ3 钥石呈现三面化）；文头 Last Updated 滞后对齐（原 2026-10-01 → 本批） |
|
|
||||||
@@ -236,15 +236,3 @@
|
|||||||
| [art-bible](../../art/art-bible.md) | 方块地牢观感（§3.2 圆角方形世界侧）、色板冻结（§4.1）、半拟物（§7.1）、明度分层（§2，v3.0——状态不走明度、空间光照可走） | 图区组件 + Accessibility 对比条 |
|
| [art-bible](../../art/art-bible.md) | 方块地牢观感（§3.2 圆角方形世界侧）、色板冻结（§4.1）、半拟物（§7.1）、明度分层（§2，v3.0——状态不走明度、空间光照可走） | 图区组件 + Accessibility 对比条 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 修订记录
|
|
||||||
|
|
||||||
| 日期 | 改动 |
|
|
||||||
|---|---|
|
|
||||||
| 2026-09-28 | **视觉终稿冻结批（M-2 迭代 4 T1–T4，闸形 A：样张 v1 机检 11/11 全绿即冻结）**：Status 升格定稿版；Layout 节点图区冻结值成文（画布公式 70+层×122+34 / 52+槽×58+26+8 下限 620×240、通道 2/3/4px、节点图标 ♻ kenney 五键 20px 烘焙+双色墨制、编号右上角）；已过态 = GOLD_DONE #68562C 冻结新值（旧 GOLD_DIM 对双色墨 <4.5:1 逼守）；Accessibility 增 Boss 深墨环灰度冗余+对比断言承载注记；States 换层进入改「淡入+换层色板渐变挂点（§2.7 切片档）」；组件清单节点图画布实现锚更新；OQ ④ 视觉终稿完成；线框图注记随改。产物：样张 `artwork/mockups/level-map-sheet-v1-2026-09-28.png` + 机检报告 git 提交 9a79927 + 出口闸检查单 `M2 出口检查单（已退役，git 历史可查）` |
|
|
||||||
| 2026-09-28 | **形态升格独立屏批（M-2 迭代 3 T1，用户裁决：独立存在为最终形态，覆盖层实现定性=测试阶段形态）**：Status/覆盖范围/到达方式/Navigation Position——「模态覆盖层形态（暗幕 0.6 底层透出）」全量改写为「独立屏独占呈现（战斗屏宿主整体隐藏，零透出）」；Layout 屏底=深底+石纹底噪（M-1 框材件）；Transitions=独立屏淡入 200ms（alpha 淡入非明度变化——art-bible §2）；AC「模态纪律」条改「独立性断言」（激活期战斗屏隐藏/选路提交战斗节点后恢复/兑付覆盖层关闭后本屏恢复）；节点/商店覆盖层「本屏域内弹出」语义随形态明确（本屏保持激活，模态栈遮挡恢复语义复用）；实现锚改名 level_map_screen.gd（RouteOverlay 退役）；battle.md 三处选路覆盖层措辞随改；视觉终稿前置改指 M-2 迭代 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） |
|
|
||||||
| 2026-10-15 | **简明技术中文用语规范批（用户令，词面层）**：词面修正 6 处——收口×4→完成（Status 行三项提案拍板/顶栏语境行 HP 拍板注/Open Questions 两「已收口」头注→「已完成」）；台账×2→状态记录（布局决策 1 清偿 143 遗留/AC 三停点标题条）；Last Updated 同步本批 |
|
|
||||||
@@ -21,19 +21,3 @@
|
|||||||
- **同库同池耗（v2.4）**：池=固定配额令牌库（普通 70/稀有 25/罕见 3=98 张；罕见档原列「道具件 2」随 aux_item 池种退役〔迭代 11 第①批 T7，落地晚于追认 b〕收窄——状态记录自决披露项）；洗牌不放回抽 3（**同 kind 去重每 kind 至多一枚**——「三种不同选项」体验延续，kind 出现率∝剩余令牌数）、选中踢池未选回池、池耗即枯竭（余库不足出齐剩余，空库=零候选合法态直通）；**种类次数上限退役**（池消耗即上限）。数值对：小GP 20/大GP 50、小增伤 +1/大 +2、小护甲 +1/大 +2、小生命 +5/大 +10、恢复 +6 当即回血（封顶生效上限）、AP +1。**MC 策略 316-f**：1 级优先度=最稀有（rarest>rare>common）、2 级=最左（并列同档取最左）。配额结构锚与档位构成读冒险表（schema validate 硬断言 70/25/3——见 `data/schemas/adventure_table.gd`）。**v2.3 第三渠道并账维持**：商店货架=同库付费渠道（令牌级货架，买一件=奖励面少一件），库存=剩余令牌数，账本语义与切边注记归[冒险结构](../systems/冒险循环/冒险结构.md)共享池账本节。
|
- **同库同池耗（v2.4）**：池=固定配额令牌库（普通 70/稀有 25/罕见 3=98 张；罕见档原列「道具件 2」随 aux_item 池种退役〔迭代 11 第①批 T7，落地晚于追认 b〕收窄——状态记录自决披露项）；洗牌不放回抽 3（**同 kind 去重每 kind 至多一枚**——「三种不同选项」体验延续，kind 出现率∝剩余令牌数）、选中踢池未选回池、池耗即枯竭（余库不足出齐剩余，空库=零候选合法态直通）；**种类次数上限退役**（池消耗即上限）。数值对：小GP 20/大GP 50、小增伤 +1/大 +2、小护甲 +1/大 +2、小生命 +5/大 +10、恢复 +6 当即回血（封顶生效上限）、AP +1。**MC 策略 316-f**：1 级优先度=最稀有（rarest>rare>common）、2 级=最左（并列同档取最左）。配额结构锚与档位构成读冒险表（schema validate 硬断言 70/25/3——见 `data/schemas/adventure_table.gd`）。**v2.3 第三渠道并账维持**：商店货架=同库付费渠道（令牌级货架，买一件=奖励面少一件），库存=剩余令牌数，账本语义与切边注记归[冒险结构](../systems/冒险循环/冒险结构.md)共享池账本节。
|
||||||
- ~~道具件入本关库存~~（v2.2 退役——秘宝局内不掉落机制道具，三轴 doctrine 锁死）。
|
- ~~道具件入本关库存~~（v2.2 退役——秘宝局内不掉落机制道具，三轴 doctrine 锁死）。
|
||||||
- ~~「池空直通」合法态~~（v2.4 随令牌池换代退役又回归异形：旧口径=GP 无上限保证牌库恒非空；现口径=98 张池真可耗尽，空库=零候选直通合法态——池耗即枯竭既定后果）。
|
- ~~「池空直通」合法态~~（v2.4 随令牌池换代退役又回归异形：旧口径=GP 无上限保证牌库恒非空；现口径=98 张池真可耗尽，空库=零候选直通合法态——池耗即枯竭既定后果）。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-29 | 迭代 7 T5 随批出生（三选一构筑点形态——用户拍板②丙） |
|
|
||||||
| v2.0 | 2026-10-01 | **共享池改写（迭代 10 追加批——用户拍板「奖励节点与通关三选一相同、共享同一个池子」）**：①定位改提升三选一选择面（六种共享池、同权重同次数上限、同 reward_pick 流）；②载体改 BonusPickOverlay 共用面（原 node_overlay 道具三选一面退役）；③道具件满位升级为替换子交互两路（原过渡形态=满位不授予）；④「池空直通」合法态退役（牌库恒非空）；⑤道具件入本关库存（即时可用），区别于通关渠道的跨关携带 |
|
|
||||||
| v2.1 | 2026-10-01 | **掷定前置（目检反馈批——用户反馈「抽到秘宝不显示详情不直观」，推荐案获批）**：道具件具体道具随候选抽定（reward_pick 流序内挪，消费数不变），卡片直显「秘宝 / 道具名 · 效果摘要」；断点停点快照随载 aux_detail（续玩卡片详情不丢）；node_bonus_candidates 返回扩 dict {candidates, aux_detail} |
|
|
||||||
| v2.2a | 2026-10-03 | **池种退役+刷新件面（迭代 11 第①批同调实施批 T7/T5b——P1 甲）**：①aux_item 池种退役出三选一牌库（BONUS_IDS 除名+权重/件数/掷定前置字段随批退役）——秘宝改走营地同调装配面（三轴 doctrine），v2.1 直显/满位替换两面随渠道退役（机械惰性承载零投放）；②三选一刷新件面新增（X/Y 双源：刷新件每碰三选一重给优先消耗不结转+营地刷新升级冒险周期池；重抽消费 reward_pick 既有洗牌流池规则全保留；autoplay 默认不刷） |
|
|
||||||
| v2.2b | 2026-10-03 | **三档位令牌池（用户全裁——待 M-4 数值批实施，现行 v2.1 平铺池维持到实施）**：池改固定配额令牌池（普通 70/稀有 25/罕见 5=100 张；洗牌不放回抽 3、选中踢池未选回池、池耗即枯竭）；档位构成=普通〔小GP 18/小增伤 18/小护甲 17/小生命 17〕+稀有〔大GP/大增伤/大护甲/大生命/恢复 各 5〕+罕见〔AP 3/道具 2〕；数值对 20/50、+1/+2、+1/+2、+5/+10、恢复+6、AP+1、道具 1 件；**种类次数上限退役**（池消耗即上限；同调位上限保留）；恢复件=新入池种类；MC 策略改判 1 级最稀有/2 级最左（确定性）——设计全稿与执行口径见 [06 待办「奖励池三档位令牌池重设计」条](../06-待办清单.md)；卡片呈现面（本 spec 交互节）零改动 |
|
|
||||||
| 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 后缀区分 |
|
|
||||||
| v2.7 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 1 处（口径节「同库同池耗」条「台账自决披露项」→「状态记录自决披露项」）；头注状态行版本号随本行对齐 |
|
|
||||||
@@ -34,13 +34,3 @@
|
|||||||
- **GP / 钥石呈现分工**（battle.md OQ14 完成口径 + 迭代 10 扩）：GP = 本 spec 战斗面（增量+总量）+ 关卡画面常驻总量；钥石 = 本 spec 战斗面（Boss/精英击杀增量行，迭代 10 起）+ 冒险面（收束明细）+ 营地存量。钥石多处并存系「进账时刻 / 收束明细 / 存量可用」不同义，不构成重复展示（level-clear.md OQ3 完成维持）。
|
- **GP / 钥石呈现分工**（battle.md OQ14 完成口径 + 迭代 10 扩）：GP = 本 spec 战斗面（增量+总量）+ 关卡画面常驻总量；钥石 = 本 spec 战斗面（Boss/精英击杀增量行，迭代 10 起）+ 冒险面（收束明细）+ 营地存量。钥石多处并存系「进账时刻 / 收束明细 / 存量可用」不同义，不构成重复展示（level-clear.md OQ3 完成维持）。
|
||||||
- **失败面不呈战利品**：冒险总结结算不呈现 GP 增量（倒下即终语义，失败侧恒不呈现）。
|
- **失败面不呈战利品**：冒险总结结算不呈现 GP 增量（倒下即终语义，失败侧恒不呈现）。
|
||||||
- **禁重复展示**：本面不呈状态效果、不呈结算明细正文（明细回看 overlay 已随 P-C7 退役——冒险中明细回看归「生涯」）——[battle.md](battle.md) 信息归属两原则（循环限定 + 单一展示面）对面级呈现同样适用。
|
- **禁重复展示**：本面不呈状态效果、不呈结算明细正文（明细回看 overlay 已随 P-C7 退役——冒险中明细回看归「生涯」）——[battle.md](battle.md) 信息归属两原则（循环限定 + 单一展示面）对面级呈现同样适用。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 2 用户裁决：丙案两面分节 + 纯呈现轻量 spec——成文已实装显示规则，无新概念；命名三名并存收口为拍板文本口径） |
|
|
||||||
| v1.1 | 2026-10-01 | **钥石呈现接线批注记（迭代 10 奖励重构——呈现侧 spec 先行，实装随批）**：战斗面触发扩 Boss 胜利（钥石逐杀掉落增量行上战斗总结结算框——契约「钥石增量一面承载」推荐案）+ 呈现内容补钥石增量行；冒险面钥石明细口径改「本局逐杀 Boss 掉落合计」；GP/钥石分工口径三面化（战斗面增量/冒险面明细/营地存量）。原「Boss 胜利不经本面」退役 |
|
|
||||||
| v1.2 | 2026-10-09 | 文档正确性审查批：明细回看入口两处订正——已随 2026-10-04 P-C7 退役（冒险中回看归「生涯」；battle_end_overlay review_pressed 已退役在码），战斗面呈现内容与禁重复展示条同步 |
|
|
||||||
| v1.3 | 2026-10-15 | 简明技术中文用语规范（用户令）：词面修正 8 处——台账×4→状态记录（定位节接线登记条/冒险面载体条「06 状态记录旧称」/命名清单③⑤）；收口×4→完成（冒险面载体条「随本条完成」/命名清单头「历史变体收口清单」→「历史变体退役清单」/GP钥石分工条 OQ14 完成口径与 OQ3 完成维持）；头注状态行版本号随本行对齐 |
|
|
||||||
| **v1.4** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「钥石入账明细」→ 钥石写入明细——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -20,11 +20,3 @@
|
|||||||
- GP 余额读数 = runner 钱包投影（GP 归[冒险结构](../systems/冒险循环/冒险结构.md) GP 节）；本层不作计算。
|
- GP 余额读数 = runner 钱包投影（GP 归[冒险结构](../systems/冒险循环/冒险结构.md) GP 节）；本层不作计算。
|
||||||
- 与关卡画面 GP 常驻徽章的关系：进店语境余额与选路常驻总量不同义（本层带购买语境），不构成重复展示——钥石「写入/存量」拆名逻辑同款。
|
- 与关卡画面 GP 常驻徽章的关系：进店语境余额与选路常驻总量不同义（本层带购买语境），不构成重复展示——钥石「写入/存量」拆名逻辑同款。
|
||||||
- 购买确认交互：现行直接购买（无二次确认步）；是否需破坏性确认异位（pattern 7）未裁决，本 spec 只登记现状不立新裁。
|
- 购买确认交互：现行直接购买（无二次确认步）；是否需破坏性确认异位（pattern 7）未裁决，本 spec 只登记现状不立新裁。
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-09-30 | 首版落文（审计拍板点 4B 裁决：甲+乙并行——编排面小节落关卡节点地图、呈现面独立成文） |
|
|
||||||
| v1.1 | 2026-10-09 | 文档正确性审查批（在役态对齐）：商店现行 = pool 模式（令牌级货架与三选一同池六行，含回复与专长凭证；进店抽 3、买一件 = 池少一件货架重抽）+ GP 付费刷新（SR-1/MC-1 已落码）——原「三商品卡全陈列、无刷新」为 legacy 形态（shop=off 对照保留），定位/布局/口径三节订正 |
|
|
||||||
| **v1.2** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：「同一令牌账」→ 同一令牌库；「账本归冒险结构」→ GP 归冒险结构；「本层不算账」→ 本层不作计算——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
+1
-21
@@ -115,7 +115,7 @@
|
|||||||
|
|
||||||
### B. 豁免条款（三类文本不改写）
|
### B. 豁免条款（三类文本不改写）
|
||||||
|
|
||||||
1. **历史文本**：版本历史表已入库的行、git 提交说明、裁决记录中引用用户原话的句子——保留原用词，不按 A 表追改。
|
1. **历史文本**：git 提交说明、裁决记录中引用用户原话的句子——保留原用词，不按 A 表追改。
|
||||||
2. **对照性文本**：「退役词对照」表本身、「原 ××」式更名记载、禁令引举句——旧词在这些位置是内容本身，不是残留。
|
2. **对照性文本**：「退役词对照」表本身、「原 ××」式更名记载、禁令引举句——旧词在这些位置是内容本身，不是残留。
|
||||||
3. **玩家可见专名与机制词**：按「对外命名纪律」节与各系统文档现行用语使用（标中/踩雷等机制词在文档内部照常用）。
|
3. **玩家可见专名与机制词**：按「对外命名纪律」节与各系统文档现行用语使用（标中/踩雷等机制词在文档内部照常用）。
|
||||||
|
|
||||||
@@ -145,23 +145,3 @@
|
|||||||
| 危险格的对外风味 | **地下城陷阱 / 怪物巢穴**（巢穴仅限世界观风味层使用——产品名清巢者出处、美术纹样名；机制表述仍用危险格） |
|
| 危险格的对外风味 | **地下城陷阱 / 怪物巢穴**（巢穴仅限世界观风味层使用——产品名清巢者出处、美术纹样名；机制表述仍用危险格） |
|
||||||
| 连锁展开的对外表达 | **坍塌显形**：挖穿薄壳、整片松动地面塌陷露出（00 篇巢穴隐喻轴定名；机制文档内部仍用连锁展开） |
|
| 连锁展开的对外表达 | **坍塌显形**：挖穿薄壳、整片松动地面塌陷露出（00 篇巢穴隐喻轴定名；机制文档内部仍用连锁展开） |
|
||||||
| 适用范围 | 全部对外命名：道具件名、显示名、UI 文案、成就与百科措辞（首例=专长 27 件第一版命名，[奇物](systems/冒险循环/奇物.md)基础件表 v3.15）；封印/旗族与金币的禁令扩为**全库正文**（2026-10-18 用户裁）——机制文档内部一律用封印，无内部用语豁免 |
|
| 适用范围 | 全部对外命名：道具件名、显示名、UI 文案、成就与百科措辞（首例=专长 27 件第一版命名，[奇物](systems/冒险循环/奇物.md)基础件表 v3.15）；封印/旗族与金币的禁令扩为**全库正文**（2026-10-18 用户裁）——机制文档内部一律用封印，无内部用语豁免 |
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
| 版本 | 日期 | 改动 |
|
|
||||||
|---|---|---|
|
|
||||||
| v1.0 | 2026-10-11 | 首版建立（用户令「做一个专用术语表，让读者查表阅读」）：格与棋盘/资源与经济/秘宝系统/道具体系四节+退役词对照表；同批全库统一更名=危险格（原雷格/惩罚格）/整图（原板级）/专长凭证（原门票） |
|
|
||||||
| v1.1 | 2026-10-11 | **怪物巢穴类型概念退役批（用户裁「目前没有具体的怪物巢穴类型，全部改成危险格」）**：删怪物巢穴词条、危险格与旗/控制两行换代；世界观风味层的「巢穴」隐喻〔00-游戏概念巢穴隐喻轴，产品名清巢者出处〕与美术纹样名保留，机制文档零巢穴 |
|
|
||||||
| v1.2 | 2026-10-11 | **机制表述巢穴补扫收尾（用户裁无类型划分）**：行动经济/音频/敌人系统等机制文档「惊动巢穴/巢穴被控制」系表述全量换代危险格（惊动 4/标中 1/被控制 2）；对照表补巢穴行 |
|
|
||||||
| v1.3 | 2026-10-11 | 秘宝目录修正批随批：新增「未知秘宝」词条（冒险拾取替换渠道，2026-10-11 用户裁） |
|
|
||||||
| v1.4 | 2026-10-11 | **正主/落籍全库扫尾批（用户令收尾）**：正主→现行事实源 130 行+落籍→已入库 79 行全库换代（39 文件 194 行；语境微调=权威文档/权威定义节/拼表制主选/入库注记等）；雷格/惩罚格/板级/门票/工作日志五词终验零真残留（存量命中均系对照行/更名记载句/禁令引举等对照性文本）；技能 SKILL.md 三件与记忆目录随批同扫 |
|
|
||||||
| v1.5 | 2026-10-11 | 拾取渠道废止批随批：删「未知秘宝」词条（用户终裁装配只在冒险开始前配置、冒险中零更换途径） |
|
|
||||||
| v1.6 | 2026-10-11 | **对外命名纪律节新增（用户令「对外命名不要有雷跟插旗相关名词」）**：禁「雷/插旗」字面入对外命名；插旗对外=封印、危险格对外风味=地下城陷阱/怪物巢穴（风味层巢穴除外）；适用=件名/显示名/UI 文案/成就百科，机制文档内部用语不受限；首例=专长 27 件第一版命名（奇物.md v3.15 九件换代） |
|
|
||||||
| v1.7 | 2026-10-11 | **通关术语裁定（用户裁）**：通关=打通整局冒险、通过第 N 关=打通第 N 关卡，两词非同义；存量文档中「通关次数」指每关卡澄清（历史行不动，全库口径统一随术语执行批） |
|
|
||||||
| v1.8 | 2026-10-11 | 新增「开发流程」节两词条：逐需求点验收清单（req-card 技能 §7 三层结构核心名词）、测试方式两分法（能力验证走调试接口/体验验证用户目检）——需求卡片逻辑验收方法论批随批登记 |
|
|
||||||
| v1.9 | 2026-10-12 | **迭代 22 反哺落文批随迁**：秘宝系统节补「自动兑付」（2026-10-12 用户裁——手动积点兑换钮形态退役）与「真视使用计数」（vision_used 生涯计数域，信标网络解锁条件）两词条（本行原误编号 v1.2，2026-10-15 重排时更正，原 v1.9/v1.10 顺延为 v1.10/v1.11） |
|
|
||||||
| v1.10 | 2026-10-13 | **迭代 23 反哺落文批随迁**（实现报告 §五③「若需登记补登」经用户令落文）：锻造工坊节新增「路线 id / 存档域键名」词条——六路线 id 与 forge_routes 域四键（levels/unlocked/weapon/armor），实现层词汇非玩家可见；玩家向术语零新增 |
|
|
||||||
| v1.11 | 2026-10-13 | 「道具」统称登记（用户立内部用语习惯）：道具=秘宝/奇物/地图战斗资源三类的内部开发统称，可单说或组合（秘宝道具/奇物道具/专长道具/战斗资源道具），仅限开发内部、玩家可见面用各类正式名称；同批补登「地图战斗资源」词条（原「奖励道具经济」2026-09-16 更名后一直未入表） |
|
|
||||||
| v1.12 | 2026-10-15 | **用语规范节新立 + 简明技术中文用语规范批（用户令「全部 GDD 做语言规范并融合词表」）**：新立「用语规范」节=词面权威指向 STC 词表+已裁替换表 12 行（STC 词面 5 行〔对标/若干/不得/报错/buff〕+doc-conventions §4 流程动词 7 行）+豁免条款三类（历史文本/对照性文本/玩家可见专名）；新词条：装板（装板期）/摇号、机能件/机制件、总线/抽屉（新「结算目标」节）、坍塌显形（对外命名纪律节）；版本历史重排修复双 v1.2（详见 v1.9 行注） |
|
|
||||||
| v1.13 | 2026-10-18 | **设计文档术语刷新批（用户裁）**：金币退役（GP 是唯一正式命名，「金币」系 AI 噪音）、插旗退役（正式动作名=封印，全库统一）、旗概念退役（印记=封印印记）——三词入退役词对照表＋机检词表（doc_term_audit.py）；封印定性由「插旗的对外表达」更正为正式术语（非比喻）；禁用字面从对外命名扩为全库；删「机制文档内部用语不受限」条款；旗/控制词条更名封印/控制；雷格/惩罚格存量正文补扫（2026-10-11 退役批残留） |
|
|
||||||
| **v1.14** | 2026-10-19 | **系统资源定名传导批（用户裁，承接 42d64ec2／17ef0180）**：节名「资源与经济」→「系统资源与经济」；新增「系统资源」「补给」词条；AP 去「次数资源」；「时沙挂账」→「时沙暂记」——跨文档引用一律「规范名＋指路 01-核心循环「系统资源」节」，定义源单点。机制与数值零改动。 |
|
|
||||||
@@ -15,7 +15,7 @@
|
|||||||
| J1 | 一 · 跨局循环：**锻造工坊 = 待做** | ✅ **已入库**（迭代 23，2026-10-12；实现报告已退役〔git 历史可考〕，合入 `52fdaf6`）。六路线行族在役、两轴所有权已移交、存档 v7 已落、工作间 UI 已实装。**残留 = 人闸**：实机目检工作间形态与购买交互（[07](../gdd/07-体验验证清单.md) ㉒） | 08「Alpha 完成判据」里这一行其实已满足，不订正会白做一轮实装 |
|
| J1 | 一 · 跨局循环：**锻造工坊 = 待做** | ✅ **已入库**（迭代 23，2026-10-12；实现报告已退役〔git 历史可考〕，合入 `52fdaf6`）。六路线行族在役、两轴所有权已移交、存档 v7 已落、工作间 UI 已实装。**残留 = 人闸**：实机目检工作间形态与购买交互（[07](../gdd/07-体验验证清单.md) ㉒） | 08「Alpha 完成判据」里这一行其实已满足，不订正会白做一轮实装 |
|
||||||
| J2 | 二 · 内容量：**锻造工坊路线行族 = `meta_forge.tres` = 待做** | 落表为 **`forge.tres`**（`ForgeTable`，六路线 sword/spear/staff/light/heavy/ward 在役）；`meta_forge` 系 2026-10-12 立项时的**选型旧名**，从未落盘（`meta.tres` 的 `forge_products` 行族已随迭代 21 退役） | 表名错误会让后续按图索骥的人找不到表 |
|
| J2 | 二 · 内容量：**锻造工坊路线行族 = `meta_forge.tres` = 待做** | 落表为 **`forge.tres`**（`ForgeTable`，六路线 sword/spear/staff/light/heavy/ward 在役）；`meta_forge` 系 2026-10-12 立项时的**选型旧名**，从未落盘（`meta.tres` 的 `forge_products` 行族已随迭代 21 退役） | 表名错误会让后续按图索骥的人找不到表 |
|
||||||
|
|
||||||
> J1/J2 属**文档事实订正**，不是设计决策，不进 §三 的待裁清单——建议随本次讨论结论一并订正 08 版本历史。
|
> J1/J2 属**文档事实订正**，不是设计决策，不进 §三 的待裁清单——建议随本次讨论结论一并订正 08 的 git 提交史。
|
||||||
|
|
||||||
另两条文档面欠账（不属游戏内容，仅登记）：`gdd_lint` 表格占比存量 3 件（01/06/07）、`doc_term` 退役术语旗 1 件（06「拔旗回收返 AP」备选条目文字引用）。
|
另两条文档面欠账（不属游戏内容，仅登记）：`gdd_lint` 表格占比存量 3 件（01/06/07）、`doc_term` 退役术语旗 1 件（06「拔旗回收返 AP」备选条目文字引用）。
|
||||||
|
|
||||||
@@ -316,7 +316,7 @@
|
|||||||
| **F6-文档面** 商店刷新机制文档回写三处 | 直接做（冒险结构共享池账本节 / 关卡节点地图商店行 v1.6 / 06 本条收口核对） | 小 | 纯文档，不依赖 M4 调参 |
|
| **F6-文档面** 商店刷新机制文档回写三处 | 直接做（冒险结构共享池账本节 / 关卡节点地图商店行 v1.6 / 06 本条收口核对） | 小 | 纯文档，不依赖 M4 调参 |
|
||||||
| **H2** 类型色 `TG_*` 常量化 | 直接做：把内联 `Color8` 提为 `ui_kit` 常量并补第五族 aoe `#E25676`（与格面微光同族不同落点） | 小 | ui_kit + 两处消费点 |
|
| **H2** 类型色 `TG_*` 常量化 | 直接做：把内联 `Color8` 提为 `ui_kit` 常量并补第五族 aoe `#E25676`（与格面微光同族不同落点） | 小 | ui_kit + 两处消费点 |
|
||||||
| **I14** 在途草稿整理 | **先 dry-run 呈报清单**，经确认再分批执行（按用户惯例） | 中 | 批量文件移动/删除，属个人目录高风险操作，必须 dry-run 先行 |
|
| **I14** 在途草稿整理 | **先 dry-run 呈报清单**，经确认再分批执行（按用户惯例） | 中 | 批量文件移动/删除，属个人目录高风险操作，必须 dry-run 先行 |
|
||||||
| **J1/J2** 08 两行订正 | 随本次结论一并改 | 小 | 08 版本历史 |
|
| **J1/J2** 08 两行订正 | 随本次结论一并改 | 小 | 08 的 git 提交史 |
|
||||||
|
|
||||||
> 以上六条**都不是设计决策**，建议从讨论里摘出来直接排执行批。
|
> 以上六条**都不是设计决策**，建议从讨论里摘出来直接排执行批。
|
||||||
|
|
||||||
|
|||||||
@@ -210,7 +210,7 @@ AC（护甲等级）单值现役生效（`hero.tres:9`=10；敌方攻击掷点
|
|||||||
|
|
||||||
- **等级上限**：每件武器/每型甲各自封顶（provisional 锚点 = 5 级量级）。量纲理由：满级特效要"值得等"，级数太多会稀释解锁节奏（与 F6 冲突）。终值归 M4。
|
- **等级上限**：每件武器/每型甲各自封顶（provisional 锚点 = 5 级量级）。量纲理由：满级特效要"值得等"，级数太多会稀释解锁节奏（与 F6 冲突）。终值归 M4。
|
||||||
- **定价结构**：沿用现役几何递增——每级价格 = 基础价 × 150%^(已购级数)（现役参数：单次 20 钥石、每级涨 150%，`meta.tres:11-24`；《元进度》定价曲线几何递增是已拍板条款）。甲型解锁 = 一次性解锁价（量纲 ≈ 中段几级锻造的花费，provisional）。全部终值归 M4。
|
- **定价结构**：沿用现役几何递增——每级价格 = 基础价 × 150%^(已购级数)（现役参数：单次 20 钥石、每级涨 150%，`meta.tres:11-24`；《元进度》定价曲线几何递增是已拍板条款）。甲型解锁 = 一次性解锁价（量纲 ≈ 中段几级锻造的花费，provisional）。全部终值归 M4。
|
||||||
- **货币裁点（v1.1 重组——现役营地一切消费货币=钥石非金币，事实依据见文末修订记录）**：
|
- **货币裁点（v1.1 重组——现役营地一切消费货币=钥石非金币，事实依据见本文文末审查回写段）**：
|
||||||
- **甲=纯钥石（推荐）**：与现役属性锻造/天赋树（2026-10-07 用户裁甲后树全钥石单币）/同调刷新升级同币同柜——原案语义是"攻击力提升改造"，即同一笔钱换个花法，语义保真；零新经济面；Boss 击杀掉落产出与几何递增定价配套现成（`meta.tres:26-38`）。
|
- **甲=纯钥石（推荐）**：与现役属性锻造/天赋树（2026-10-07 用户裁甲后树全钥石单币）/同调刷新升级同币同柜——原案语义是"攻击力提升改造"，即同一笔钱换个花法，语义保真；零新经济面；Boss 击杀掉落产出与几何递增定价配套现成（`meta.tres:26-38`）。
|
||||||
- **乙=引入局外持久金币余额域**（金币入存档、可付营地消费）：**淘汰依据**：须推翻两币分工拍板条款（《元进度》："GP（金币）= 冒险内一次性属性提升货币——局内清零、不入存档……两币永不互兑"，元进度.md:55）+ 新存档域 + 金币出口入账规则一套；与"金币无法带出冒险"（2026-10-07 用户判定）直接相逆。
|
- **乙=引入局外持久金币余额域**（金币入存档、可付营地消费）：**淘汰依据**：须推翻两币分工拍板条款（《元进度》："GP（金币）= 冒险内一次性属性提升货币——局内清零、不入存档……两币永不互兑"，元进度.md:55）+ 新存档域 + 金币出口入账规则一套；与"金币无法带出冒险"（2026-10-07 用户判定）直接相逆。
|
||||||
- **丙=第三货币锻造币**（独立于钥石/金币的专用锻造币）：**淘汰依据**：无产出渠道凭空造经济——产出渠道、兑换规则、存档域、呈现位全套新建，实装量三案最大。
|
- **丙=第三货币锻造币**（独立于钥石/金币的专用锻造币）：**淘汰依据**：无产出渠道凭空造经济——产出渠道、兑换规则、存档域、呈现位全套新建，实装量三案最大。
|
||||||
@@ -311,7 +311,3 @@ AC（护甲等级）单值现役生效（`hero.tres:9`=10；敌方攻击掷点
|
|||||||
每个裁点独立拍板，互不绑死（推荐列只是提案立场，不是打包方案）。裁决结果落 06-待办清单「武器锻造系统」专条与路线图卡③行；裁决通过后实装批另行立项，以本提案+裁决记录为需求卡片输入。
|
每个裁点独立拍板，互不绑死（推荐列只是提案立场，不是打包方案）。裁决结果落 06-待办清单「武器锻造系统」专条与路线图卡③行；裁决通过后实装批另行立项，以本提案+裁决记录为需求卡片输入。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 修订记录
|
|
||||||
|
|
||||||
- **v1.1（2026-10-07 盘问轮 S2 纠偏）——货币前提全案订正**。事实修正依据：现役营地一切消费货币=钥石（buy_forge→spend_keystone `meta_progression.gd:59`；树 tree_buy/tree_buy_fork 与刷新升级 buy_attune_refresh 同走 spend_keystone 钥石消费口）；GP（显示名金币）=局内一次性货币，开局清零（`adventure_runner.gd:116`）、不入存档（save schema 无 gp 域），两币永不互兑（《元进度》两币分工拍板条款，元进度.md:55）；金币无法支付营地柜台账（用户判定 2026-10-07）。错误根源=meta_tree.tres 脊柱行 gp 声明 + meta.tres 表尾陈旧注释「与 GP 商店同族」误导成文。订正面：〇节原案一注记、F1 事实行、裁点 4b 乙引文、裁点 5a 丙论据、裁点 5b 货币裁点整节重组（甲=纯钥石/乙=局外金币余额域/丙=第三货币锻造币）、裁点 5c 前提换钥石（甲=纯钥石零材料）、第九节定价行、第十节汇总表 5b-1/5c 行。配套实况：天赋树货币甲案同日修复（树全钥石单币落定，T8「GP 余额域缺位」双币骨架披露销账）。
|
|
||||||
@@ -342,11 +342,3 @@ active.md 只记「render_gate golden 0.00%（登记即结未重制）」——
|
|||||||
这份审计**找方向是准的**（术语倒挂、三处判定缺陷、L2 零承载，三条都是代码级确凿），但**证据硬度不够**——它是"读出来的结论"，不是"跑出来的结论"。扭转方案的第一步必须是**先把 C 类结论全部坐实成 A 类**，否则后面所有改动都建立在我自己的推断上。
|
这份审计**找方向是准的**（术语倒挂、三处判定缺陷、L2 零承载，三条都是代码级确凿），但**证据硬度不够**——它是"读出来的结论"，不是"跑出来的结论"。扭转方案的第一步必须是**先把 C 类结论全部坐实成 A 类**，否则后面所有改动都建立在我自己的推断上。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 版本历史
|
|
||||||
|
|
||||||
- v1.0（2026-10-15）：审计会话首版。范围 = 单测覆盖 + 验收门禁标准；未跑测，结论全出静态审计；缺口按 A–E 五级分档，§七为标准建议（待裁），§八列未决项。
|
|
||||||
- v1.1（2026-10-15 同日，应「报告有什么可优化」问询）：①§〇 加证据等级列，全文 ⚠ 标注 C 类结论；②补 §5.2b CI 注释漂移、§5.2c example_test 占位、§5.4 游离测量脚本台账、§5.5 golden 基线时效、§5.6 扫描域半数未落地；③§六 增 A-5 与 F 级（15/16/17）；④新增 §九 自评十条 + 证据等级表。仍未跑测。
|
|
||||||
- v1.2（2026-10-15 同日，应「CI 现在有用吗」问询）：①§〇 加「CI 实态」行；②新增 §5.0（无远端、CI 从未执行、本地闸五件洞况表）；③§一/§5.1 修正「smoke_all 不被执行」的错误表述（它本就在本地轻闸首项）；④§九 自评补第 11 条（最大视角错误＝未核实 CI 通不通电）。
|
|
||||||
- v1.3（2026-10-15 同日，**用户裁「CI 没有用、后面也不用、不留死配置」后**）：①`.github/workflows/` 全数删除（分支 `ci-removal-20261015`），全文 CI 表述改注为「已删除的历史状态」；②§5.3「本地重闸 vs CI」对比表作废、改为「本地闸是唯一门禁」；③§六 A-4/A-5 中 CI 项作废（保留 example_test 一件）；④§七/§八 中 CI job 改名、Q2 作废；⑤架构事实源纪律：历史决策文档只作沿革引用、不回改；现行事实以 architecture.md 为准。
|
|
||||||
- v1.4（2026-10-15 同日，用户裁「决策记录归 git commit log、不另存决策文档」后）：七份历史决策文件已删（沿革归 git 历史），全文引用清除——原引用处改指 `design/dev/architecture/architecture.md`「测试与质量域」节；§5.6/Q1/时长预算等表述随清；结论本体零改动。
|
|
||||||
+1
-533
@@ -58,536 +58,4 @@ Godot_v4.7.2-stable_win64_console.exe --headless --path . --script res://smoke/a
|
|||||||
- **v2 追加**：LevelTable（线性节点链数据表）· C1-lite 关卡推进器 `level_runner.gd`（原 c1_level_runner，2026-09-11 领域命名批更名）（关卡域生命周期：共享 B4 关内延续 + HP 跨战斗携带 + 奖励/恢复节点兑付 + 关卡末清库）· Boss 遭遇行（Dmax=4）· 节点奖励 API（B4 `grant_node_active`）· **测试用角色数值调整板**（atk%/hp% 覆盖 + 批量模拟，模拟天赋树——正式侧归 C4）
|
- **v2 追加**：LevelTable（线性节点链数据表）· C1-lite 关卡推进器 `level_runner.gd`（原 c1_level_runner，2026-09-11 领域命名批更名）（关卡域生命周期：共享 B4 关内延续 + HP 跨战斗携带 + 奖励/恢复节点兑付 + 关卡末清库）· Boss 遭遇行（Dmax=4）· 节点奖励 API（B4 `grant_node_active`）· **测试用角色数值调整板**（atk%/hp% 覆盖 + 批量模拟，模拟天赋树——正式侧归 C4）
|
||||||
- **裁剪不变**：A5 / C1 路径分支选择（用户拍板线性）· C2–C4 / B5 战斗动画 / D3–D6 / A1 黄金向量与 F4 批量工具 / gdUnit · 注：标错惩罚（原 A2 OQ1）已于 2026-09-12 批上线（标空封印三选一确定性反噬：暴走 / 伏击 +2 层 / 失衡，坐标×板序号派生、不走随机流），本批（2026-09-15）已收编进现行文档，不再属裁剪项
|
- **裁剪不变**：A5 / C1 路径分支选择（用户拍板线性）· C2–C4 / B5 战斗动画 / D3–D6 / A1 黄金向量与 F4 批量工具 / gdUnit · 注：标错惩罚（原 A2 OQ1）已于 2026-09-12 批上线（标空封印三选一确定性反噬：暴走 / 伏击 +2 层 / 失衡，坐标×板序号派生、不走随机流），本批（2026-09-15）已收编进现行文档，不再属裁剪项
|
||||||
|
|
||||||
## 2026-09-11 可选类供给控制器（用户拍板批——修改记录）
|
> 历次批次的改动明细与决策过程见 git 提交史（`git log -- game/README.md` 及各批提交信息），本文只保留运行说明与范围。
|
||||||
|
|
||||||
**背景**：供给控制器批前实测每关可选类 ≈24.8 件（≈18.5 把刀，刀总伤 ≈180 > Boss 130 HP）——"道具获取期望太高"定量坐实。用户重新定义三尺度指标并拍板实现：
|
|
||||||
|
|
||||||
| 尺度 | 指标 | 实现机制 |
|
|
||||||
|---|---|---|
|
|
||||||
| 安全格 | 期望极小（全图摊平 < 0.01/格） | 可选类**退出格子权重池**——格子池只剩即时类四行 |
|
|
||||||
| 雷图 | ≈0.78/板 | 战斗首件保证 ÷ 每战板数（≈1.28）折算 |
|
|
||||||
| 战斗 | 期望 ≈1，**首件保证**：获取首件前每张新板必注入 1 件；之后按 **p0×decay^(j-1) 指数递减**（永不绝育） | `RewardSupplyController`（B4 私有组合件，战斗域计数） |
|
|
||||||
|
|
||||||
**拍板四条 → 落点**：① 注入占比 小刀 60% / 精工短刀 30% / **治疗包 10%**（治疗资源宝贵）→ `reward.tres` active_inject 池；② **清图奖励改一次性高额伤害**（clear_knife 入库刀 → clear_blast instant_aoe 40，当场兑付全体存活敌，不入库、不占可选类供给——清图与供给脱钩）；③ 注入选格**均匀随机**（雾格不加权）；④ **指数递减**（active_p0=0.4 / active_decay=0.5 → 0.4/0.2/0.1/0.05…，RewardConfigTable 新参数，provisional 归 C3 标定）。
|
|
||||||
|
|
||||||
**实现结构**（对象封装——伪代码审阅后落地）：
|
|
||||||
|
|
||||||
- `core/reward_supply_controller.gd`（新）：`notify_battle_start()`（计数清零）/ `should_inject(stream)`（j==0 恒真；否则 `randf < p0×decay^(j-1)`，取号经传入封闭流）/ `notify_granted()` / `granted_count()`。行值快照抗热重载；零自有随机数。
|
|
||||||
- `B4RewardEconomy`（改造）：`_supply` 组合件 · `notify_battle_start()`（B1.begin_battle 转发）· `roll_board` 重写（身份批即时类单遍 → 清图槽 → 注入判定/选格；旧 F5 草稿重 roll 循环删除）· `grant()` 挂钩 `notify_granted()`（**发放即获取**——预分配未挖到不计数；去重幂等天然防双计）· `supply_granted_count()` 观测面。
|
|
||||||
- `B1BattleOrchestrator`：begin_battle 门序列增 `b4.notify_battle_start()`（编排唯一性不变）。
|
|
||||||
- 表/护栏：RewardTable `POOL_TAGS` + `active_inject`；RewardConfigTable + `active_p0/active_decay`、k_dmg 1→0（F5 休眠）；ConfigDB 跨表护栏更新（clear_no_value 含即时类 / no_damage_row 扫描全池活行 / 新增 inject_pool 护栏：非可选类拒绝 + 空池致命）。
|
|
||||||
|
|
||||||
**实测（N=200 板/深度，工具 reward_expectation.gd）**：注入 1.00 件/板（j=0，多件板 0）· 占比 小刀 59–65% / 精工 25–29% / 治疗包 7–17%（名义 60/30/10）· 格池零可选类泄漏 ✓。**实际获取期望**（level_monte_carlo「可选类/战」列，N=15——工具已退役，数据归档）：基线 0.88 → +200% 攻击 0.68 件/战（低于分配保证 1.0 的机理 = 注入格均匀随机，落在残余格/速杀未挖区时该件不获取；战斗末无兜底补发——**是否加"战斗末 j==0 补发 1 件"待用户拍板**）。每关合计 ≈ 4.5–6.5 件（原 24.8）✓ 拍板目标达成。
|
|
||||||
|
|
||||||
**⚠️ 供给侧副作用（本轮扫描发现，待拍板）**：可选类退出格子池后，其 25% 概率质量被动流向即时类——攻防 buff 每格频率从 44% 升至 59%，基线通关率 55%→80%（N=15）、整关承伤 127→80：**难度不降反升方向反了**。即时类是"每格必有货"锁定设计下无法清空的（除非引入空白格 = 违反锁定事实）。候选杠杆：① 接受更快的 buff 节奏，敌 HP 曲线上调对冲（C3 主杠杆）② 下调 attack_up/defense_up 在即时池内的相对权重（压 buff 频率）③ buff 幅度下调（触碰 B3 表值）。
|
|
||||||
|
|
||||||
**正式侧义务**：B4 GDD「install 期 roll / F5」章节修订（F5 → 战斗首件保证语义）+ registry reward_table/reward_config 条目改写 + RewardConfigTable knob 登记（active_p0/active_decay）——接口漂移批随实现落位。
|
|
||||||
|
|
||||||
## 2026-09-12 轮内刷新（方案 A，用户拍板批——修改记录）
|
|
||||||
|
|
||||||
**背景**：用户发现刷新实现（仅 Waiting 结算窗口受理）与设计预期不符——预期为**扫雷阶段遇到推理死路时，有剩余 AP 且 RAP 足够即可当场刷新继续挖**。影响分析（三方案对比 + 16 代码触点 + 8 文档 + 5 数值连锁）后用户拍板方案 A。
|
|
||||||
|
|
||||||
**拍板语义**：① Active 相位可刷（RAP ≥ 8 且本轮未达上限）→ 当场 retire+install 换新图，**轮次继续**：AP 保留不重置、相位不动、不触发结算（敌方时间税语义变更——GDD 修订义务）；② Waiting 相位刷新保持现状（登记意图，exit_distribution 换图）；③ **每轮兜底上限 2 次**（Active/Waiting 合计，`ActionEconomyTable.refresh_max_per_round = 2` 表值）；④ RAP 来源不变（停手 1:1 转存）。
|
|
||||||
|
|
||||||
**实现落点**：A3 `request_refresh_active()`（仅扣 RAP，相位/AP 不动）· A2 `install_board/retire_board` 增 `during_round` 显式参数（Active 通道，其余相位守卫不变——fail-fast 保留）· B4 `query_full_snapshot()` · B1 `can_request_refresh()` 查询面 + `player_request_refresh()` 双相位重写 + `_refresh_used_this_round` 计数 + **facts 身份快照隔离**（缓冲期捕获身份快照、授予走快照——防旧图已挖格在轮末错拿新图同坐标身份；`_grant_cell` 增 snap_override）· 呈现层按钮"弃图刷新（RAP -8 · 每轮至多 2 次）"。
|
|
||||||
|
|
||||||
**核心实现难点（分析批未暴露）**：轮内换图后旧图已挖未结算格与新图**坐标重叠**——轮末授予 `b4.grant(cell)` 会错拿新图身份。解法 = facts 缓冲期用 `query_full_snapshot` 冻结身份，授予段直通快照（绕过现行 mapping/_granted，批次隔离；库存语义不变）。
|
|
||||||
|
|
||||||
**验证**：冒烟 88/88（+14 轮内刷新断言：当场换图/相位 AP 保留/RAP 扣减/上限拒绝/跨图 facts 完整兑现〔4 格跨三图快照授予〕/回放确定性）· 三探针全 PASS · 期望扫描与刷新前持平（80%/0.88——模拟策略不主动刷图，真人专用出口）。**调试教训**（规范 4.6 补充案例）：蛆虫 HP 已调 24 而"18 未掉血"误判——排查数值问题先核对当前表值；GDScript lambda 对局部 int 按值捕获（计数器必须用容器）。
|
|
||||||
|
|
||||||
**正式侧义务（GDD/registry 修订清单）**：A3 GDD Rule 11（受理相位 Waiting → Active∪Waiting + 相位机表 + 时间税语义注记）· A2 GDD install 四不变式轮内场景 · B1 GDD 编排专章（轮内换图 + facts 快照协议）· B4 GDD E5/E6（query_full_snapshot/grant 快照直通）· game-concept 轮次流程 + "战斗:扫雷图 = 1:M"措辞（一轮跨多图新形态）· registry `action_economy`（refresh_max_per_round）· 数值连锁重跑（清图支配性条款⑤/获取期望——模拟不覆盖真人刷图行为，需 playtest 实测）。
|
|
||||||
|
|
||||||
**2026-09-15 补记（用户拍板）**：**Waiting（等待结算）相位刷新通道整体移除**——呈现层入口此前已按 OQ12 退役（2026-09-12 战斗屏批），本批拆除核心层残留：账本侧 Waiting 受理入口 `request_refresh()` 删除、编排侧 `can_request_refresh` 不再放行 Waiting、`player_request_refresh` 等待期登记意图分支删除、出口分发删除 `_refresh_used_this_waiting → new_board` 换图分支（非清图轮恒同图）、字段与诊断快照键同步移除。文档侧无需修订——[行动经济](../../design/gdd/systems/排雷循环/行动经济.md)只写挖掘期刷新、[战斗结算](../../design/gdd/systems/战斗循环/战斗结算.md)明文"非清图轮恒同图"，拆完代码即双双收敛。冒烟断言改为"等待期刷新请求被拒且状态不变"。
|
|
||||||
|
|
||||||
**同批其它改动（口径读法）**：明细行协议 **13 类 → 15 类**（新增窗口打开锚行 `window_open`、窗口跳过锚行 `window_skip`，服务"窗口段恒在案"验收；单点定义见[战斗结算](../../design/gdd/systems/战斗循环/战斗结算.md)）；状态表 **四行 → 六行**（暴走 / 失衡两行随标错反噬批收编）；达标判定回归**单一判据**（可推理率 ≥ 及格线）；求解器禁读雷位真值。本文正文的 v1/v2 范围登记与各历史批条目保留当时陈述，计数以现行文档与代码为准。
|
|
||||||
|
|
||||||
## 2026-09-11 关卡扩展批 · 切片级偏差登记（实现期决策，正式化时须回 GDD/架构文档）
|
|
||||||
|
|
||||||
1. **C1 线性推进器 provisional**：节点链来自 LevelTable（结构位 = 未来 C1 的数据承载面）；路径分支/奖励点分布定稿权归 C1/C3。节点类型 closed enum {battle, reward, rest, boss}；末节点必须 Boss（LevelTable schema 校验）。
|
|
||||||
2. **B4 新增 `grant_node_active()`**（接口漂移）：关卡奖励点在可选类活行 {damage_item, heal_pack} 中 roll 一件直接入库；消耗 `reward_roll` 恰一 scope（与 board install 批同流异 scope，流集合封闭不变）。正式侧应走 B4 GDD 修订（节点奖励 = clear_reward 插槽族的新来源候选）。
|
|
||||||
3. **B2 spawn max_hp 语义修复**（切片 bug）：原实现 `max_hp = hero_hp 入参`——跨战斗携带 HP 时 max_hp 被压扁成当前 HP，恢复点/治疗包满血守卫失效。修复为 `max_hp = HeroTable.max_hp`（接口语义澄清，正式侧回 B2 GDD Rule 注记）。
|
|
||||||
4. **A4 迷雾纪律遵守**：L1 全程无雾（迷雾 `unlock_level=2` 已锁事实——迷雾自第二层解锁）；Boss 板以 12×12 大板区分。
|
|
||||||
5. **属性覆盖 = 测试专用**：调整板直接写运行时 HeroTable（atk 域 [1,999] 内 clamp ≥1）；关卡结束/回菜单恢复基线。正式天赋树归 C4，禁止生产代码引用本机制。
|
|
||||||
6. **UI 复用 b1 引用**：关卡模式下呈现层 `b1 = runner.b1`（与调试模式共用 HUD/棋盘路径）；runner 在关卡结束置 `b1 = null`。
|
|
||||||
7. **runner 信号时序（playtest 缺陷①修复登记）**：`node_entered` 必须先于 `begin_battle` 发出——后发时首板安装的 `board_changed` 到达呈现层时 `b1` 尚未接手，首战棋盘不渲染。场景级探针 `smoke/ui_probe.tscn` 为该缺陷的回归断言载体。
|
|
||||||
8. **A2 封印动作末点 AP 软锁（playtest 缺陷②修复登记——A2 核心 bug，v1 即存在）**：`_do_seal_place/_do_seal_pull` 花完末点 AP 后 A3 相位翻 Waiting 但不发 round_end——B1 的 Waiting 结算点依赖 round_end 到达，事件缺席 = 整局软锁（Boss 图封印多，末点 AP 花在封印上即触发）。修复 = 封印动作检查相位翻转并补发 `_emit_round_end_seals_and_payload()`（与 `_do_dig` 同款）。v1 冒烟盲区根源：自动玩家不用封印。回归断言入 smoke_all（封印动作耗尽 AP 必须进入第 2 轮）+ 行为探针 `smoke/ui_click_probe.tscn`（合成鼠标事件走真实 UI 路径，随机混合封印/撤封印/停手/窗口刷新/无效点击，4 种子全关通扫）。**正式侧义务**：A2 GDD F4 事件序契约须补"封印动作路径的 round_end 发射"措辞（接口漂移）。
|
|
||||||
9. **呈现层固定分区（playtest 缺陷③修复登记）**：侧栏全部动态区（RAP/敌人/增益/库存/悬停状态）固定槽高 + `clip_contents`——悬停文案切换与库存增长不再推挤整体布局（此前"第 N 轮"库存行被挤出视口 + 全 UI 抖动）。区域独立，超长裁剪不回流。
|
|
||||||
10. **L1 12×12 板生成余量**：D2–D4（及 L2）`max_gen_attempts` 16→24（F2c 24×144=3456 ≤ 16384 合法）——16 次尝试下偶发"重试耗尽接受最优"（best≈0.85–0.87 < target 0.88）；24 次后仍偶发（best 0.866），密度×推理率的根本解归 C3。
|
|
||||||
11. **道具使用后不消失（playtest 缺陷④修复登记——UI 层契约违例）**：B1 窗口选择契约 = `_window_items` **位置**（义务④"选定序"），UI 选用按钮却传 `item.index`（库存数组句柄）——未消耗过时二者巧合相等；一旦消耗过一件，已耗条目仍占库存数组位，后续窗口条目"句柄 = 位置 + 已耗数"错位 → 选中件不消耗、邻件被误耗（可用次数语义本身存在且正确：`use()` 一次性标记 Used 不可逆）。修复 = UI/行为探针一律传窗口位置；探针加"选用必生效"断言（选用件库存态变 Used，失效即退出码非零）。
|
|
||||||
12. **数值调整板被遮挡不可见（playtest 缺陷⑤修复登记 + 专属测试补建）**：调整板覆盖层在场景树中位于**不透明的开始覆盖层之前**，`_show_tune_panel` 只置 visible 不隐藏开始层 → 面板被完全遮住 = "点击无反应"。修复 = 打开隐藏开始层 / 关闭（含"应用并关闭"）恢复。**专属测试**：`smoke/ui_tune_probe.tscn`（场景级全链路：打开可见性〔缺陷⑤回归〕/ 滑条→生效预览联动 / 应用写 hero 表 12/75 / 重置回基线 6/50 / 批量模拟 N=10 全链路〔与 headless 扫描同口径〕/ 关闭回开始界面 / 加成跨模式持久）。
|
|
||||||
13. **呈现层模块化重构（2026-09-11 用户批——"上帝对象"拆分）**：`main.gd` 随功能追加长成 ~1100 行上帝对象（棋盘渲染/HUD/日志/四种覆盖层/调整板/模拟器/关卡流程全糊在一个类）。拆分为 **9 个单一职责单元**（总行数不变，最大单类 433 行）：`views/board_view.gd`（棋盘渲染+输入意图翻译，动作经信号外发）· `views/hud_view.gd`（侧栏纯视图，setter+定长槽）· `hud_presenter.gd`（核心状态→文案装配，MVP 静态装配器）· `views/battle_log_view.gd`（13 类行协议格式化）· `views/item_window_overlay.gd`（窗口，选择=位置语义收口）· `views/node_overlay.gd` · `views/level_strip_view.gd` · `views/tune_panel.gd`（调整板自持加成语义+批量模拟）· `views/ui_kit.gd`（共享小部件）。**组合根纪律**：main.gd（433 行）= 模式流转 + 信号接线，核心写调用（settle_batch/submit_window_selection/runner 推进）只在此处发生；视图零核心写、装配器无状态。**回归验证**：冒烟 74/74 + ui_probe/ui_tune_probe PASS + 行为探针 2 种子（通关 + 选用生效 1/2 失效 0）。
|
|
||||||
|
|
||||||
## 切片调参登记 v2（2026-09-12 起已由 C3 GDD 转正为 MVP 默认曲线——下方登记保留作溯源）
|
|
||||||
|
|
||||||
**EnemyTable L1 深度轴（D0–D4，Boss=Dmax=4——A1 第三轴登记约定）**，设计意图 = 基线难、天赋拉回可玩带：
|
|
||||||
|
|
||||||
| 节点 | 行 | 敌种×数量 | hp | atk | 环 |
|
|
||||||
|---|---|---|---|---|---|
|
|
||||||
| 战1 | (1,0) | 蛆虫×1 | 24 | 4 | [attack] |
|
|
||||||
| 战2 | (1,1) | 蛆虫群×2 | 24 | 4 | [attack] |
|
|
||||||
| 战3 | (1,2) | 伏击兽×1 | 36 | 6 | [attack,charge,heavy] |
|
|
||||||
| 战4 | (1,3) | 伏击兽群×2 | 26 | 4 | [attack,charge,heavy] |
|
|
||||||
| Boss | (1,4) | 遗迹守卫×1 | 130 | 7 | [attack,attack,charge,heavy] |
|
|
||||||
|
|
||||||
首版（敌 HP 总量 208：18/36/26/40/88）实测**基线通关率 73%**——预警⑥速杀退化在关卡尺度依旧成立，与"基线非常难"意图相反；v2 上调至 290（24/48/36/52/130）+ Boss atk 7。**群战对价**：unit_count=2 行单位 hp/atk 下调（B1 条款③满配语境约束；C3 正式调参须按 clause3_supply 复算——registry 已登记 unit_count>1 行须降密度或降 m_amb）。
|
|
||||||
|
|
||||||
**BoardGenTable L1 深度行**：D0/D1 = 10×10、D2/D3/D4 = 12×12，全部 d0.25/t0.88。**登记**：d0.28/t0.87 首测**不达标**（best≈0.805–0.817，降级告警"接受最优出图"）——密度轴上调与求解器能力一起解，留给 C3。
|
|
||||||
|
|
||||||
**奖励获取期望实测（问题2 汇报批，工具 `smoke/reward_expectation.gd`，N=200 板/深度，走真实 B4 roll 管线含 F5 保底条件化）**：
|
|
||||||
|
|
||||||
| 深度 | 板面 | 资格格均（min/max） | 可选类/板 均 | 其中刀 | 治疗包 |
|
|
||||||
|---|---|---|---|---|---|
|
|
||||||
| D0 | 10×10 | 12.4（1/36） | 3.32 | 2.57 | 0.75 |
|
|
||||||
| D1 | 10×10 | 11.1（2/32） | 3.00 | 2.40 | 0.60 |
|
|
||||||
| D2 | 12×12 | 22.8（4/63） | 5.70 | 4.42 | 1.27 |
|
|
||||||
| D3 | 12×12 | 23.8（5/61） | 5.87 | 4.55 | 1.31 |
|
|
||||||
| D4 | 12×12 | 24.1（6/64） | 5.87 | 4.54 | 1.33 |
|
|
||||||
|
|
||||||
**公式**：每资格格 P(可选类) = 25/100 = 25%（小刀 15% / 精工短刀 4% / 治疗包 6%）；每板期望 ≈ 25%×|资格格| + F5 保底条件化加成（k_dmg=1 整批重 roll 至少 1 刀——12×12 板无刀概率 0.81²³<1%，加成可忽略；10×10 板 ≈+0.2）；清图奖励 clear_knife 仅真清图兑付（理性策略不整清 ≈0）；完美排雷 ×2 条件苛刻不计基线；**节点奖励恒为 1 件可选类**。
|
|
||||||
|
|
||||||
**每关合计 ≈ 23.8（板）+ 1（节点奖励）≈ 24.8 件可选类**（≈18.5 把刀 + ≈5.3 治疗包）——刀总伤 ≈180，超过 Boss 单体 130 HP。**用户"道具获取期望太高"的定量坐实**：关内不清库（2026-09-11 裁决③）× 每格必有货（B4 锁定）× 12×12 深板资格格翻倍，三者相乘。**候选杠杆（全部 C3 所有权，等拍板再动）**：① 可选类占比 25%→8–12%（改 knife_t1/knife_adv/heal_pack 权重）② 敌 HP 曲线上调对冲 ③ 刀伤下调 ④ 库存上限（触碰 B4 E 节结构，需修订）。
|
|
||||||
|
|
||||||
**期望扫描数据（N=20/格，种子 4200+20，工具 level_monte_carlo.gd；理性玩家策略近似）**：
|
|
||||||
|
|
||||||
| atk% / hp% | 通关率 | 整关承伤 均/p90 | 通关剩余HP均(胜) | 进BossHP均 | 平均轮数 | 败北节点分布 |
|
|
||||||
|---|---|---|---|---|---|---|
|
|
||||||
| +0 / +0（基线） | **55%** | 126.8 / 190 | 33.1 | 44.6 | 18.4 | 蛆虫群×4 · 伏击兽×2 · 伏击兽群×3 |
|
|
||||||
| +0 / +100 | 100% | 165.8 / 219 | 61.5 | 88.7 | 26.1 | — |
|
|
||||||
| +50 / +0 | 70% | 109.8 / 155 | 27.1 | 45.5 | 17.1 | 分散（含 Boss×1） |
|
|
||||||
| +100 / +0 | **100%** | 96.3 / 121 | 33.5 | 47.4 | 17.4 | — |
|
|
||||||
| +200 / +0 | 95% | 61.1 / 99 | 36.6 | 49.0 | 12.9 | 伏击兽群×1 |
|
|
||||||
|
|
||||||
读法：**基线=明显吃紧（55%，死亡集中在前中期群战）→ 攻击+100% 即满通关带**；HP 翻倍是独立有效的第二杠杆（战斗拖长 → 承伤期望上涨 165 但预算翻倍）。v1 敌数值（HP 208）时基线通关 73%——预警⑥速杀退化在关卡尺度坐实，v2（HP 290）压到 55%。注意：模拟者 = 理性策略近似（免费链式开格、无避雷推理），真人基线通关率应显著低于 55%——**目标带定在哪儿（30%？10%？）待 playtest 拍板，杠杆 = EnemyTable hp/atk 深度曲线（C3）**。
|
|
||||||
|
|
||||||
## 已知热点（playtest 观察项）
|
|
||||||
|
|
||||||
- **基线难度体感**：基线（无面板加成）应"明显吃紧、可能打不过"；如果基线就能轻松通关 → 敌数值仍偏弱（找 C3 杠杆：EnemyTable hp/atk 曲线）；如果 +100% 攻击还打不过 → 奖励供给或恢复点数值偏弱。
|
|
||||||
- **奖励点随机主动道具的体感**：roll 池 = 小刀 8 / 精工短刀 16 / 治疗包 12（等权）；到手的刀是否改变了 Boss 战规划（囤刀 vs 即用）。
|
|
||||||
- **恢复点（30% max_hp）时机**：位于战4 与 Boss 之间——是否制造"要不要省治疗包给 Boss"的决策。
|
|
||||||
- **Boss 战节拍**：遗迹守卫环 [attack,attack,charge,heavy]——蓄力拍是否被玩家用作"安全挖掘拍"；重击 14 点是否构成规划压力。
|
|
||||||
- 节点进度条/奖励恢复覆盖层可读性；v1 遗留观测项（结算逐行归因、完美排雷可达性）继续有效（原"雾池体感"一项随雾格移除作废）。
|
|
||||||
|
|
||||||
## L2 试玩采集清单（分支节点图批 2026-09-17——关卡 2「幽暗地域」试玩观测项）
|
|
||||||
|
|
||||||
入口：「开始冒险」主入口推进到第二关段（单关测试直入口已退役——2026-09-23 用户拍板，唯一试玩入口 = 完整三关冒险；种子框同用）。
|
|
||||||
|
|
||||||
- **选路行为**：战斗胜利/兑付确认后弹出选路覆盖层（整图 + 候选按钮）——玩家是否理解"零自动推进、每跳都要选"；单候选节点（恢复点→编号 6）是否被读成"卡住"。
|
|
||||||
- **岔路使用率**：四处真实岔路的走向分布（入口 0→[1,2]；战斗 1→[3,4]；奖励 2→[4,5]；深层 4→[6,7]）——奖励点路线 vs 纯战斗路线的选择比例；整图渲染是否被实际用来规划（对比只点按钮的玩家）。
|
|
||||||
- **新敌种可读性**：熊地精（突刺/重击池）的意图可读性；巨蜘蛛群行（2–3 只）的数量压力体感；蛛化卓尔精灵 Boss 的毒爆（×2.5）与重击（×2.0）是否构成规划差异（对照关卡 1 酋长的硬化池）。
|
|
||||||
- **顶栏图条**：图形态行进序列（已过暗金 → 当前金 → 候选亮边）是否足以反映位置；编号显示（节点编号 = 关内地址）是否被理解。
|
|
||||||
- **数值读数参照**（provisional，N=20 双策略扫描 2026-09-17）：基线裸值通关 0%（死因集中 Boss×16）；hp+100% 档 35% → atk+150%/hp+100% 档 80%——真人试玩体感与读数的偏差即试玩采集的主要增量。
|
|
||||||
|
|
||||||
## 2026-09-11 用户拍板（四条，已落地本切片）
|
|
||||||
|
|
||||||
| # | 拍板 | 切片实现落点 |
|
|
||||||
|---|---|---|
|
|
||||||
| ① | 基础攻击恒存在：atk 域 [1,999]、0 拒绝加载、MVP=6；战斗段主角先手攻击顺位最前敌，attack_up 唯一吃修正 | `hero.tres` atk=6 · `hero_table.gd` 域校验 · B1 战斗段⓪先手（`hero_attack` 行）；attack_up 经 `effect_pool_map → hero_offense` 活行 |
|
|
||||||
| ② | 奖励两类：即时 75%（当场兑付不进库存）/ 可选 25%（刀/治疗包入库走窗口）；heal_pack 稀缺化 w6 p12 | `reward.tres` 行集 w75/25；B1 `_resolve_instant` |
|
|
||||||
| ③ | 库存关内延续：跨战斗不清，关卡末 level_clear 清空 | B1 `_battle_over` 不清库；v2 起由 C1 runner 在关卡末统一调用 |
|
|
||||||
| ④ | 道具窗口至多选一件 | B1 `submit_window_selection` 截断 `slice(0, 1)` |
|
|
||||||
|
|
||||||
**文档对齐**：四条拍板的 GDD/registry 回写已由文档会话先行完成（b1/b2/b4 GDD、registry、systems-index、d2、game-concept、b3）；本切片程序与文档逐项对齐核查通过（详见 session-state 条目 16）。语义注：本切片为参考实现，与文档冲突以 GDD/registry 为准。
|
|
||||||
|
|
||||||
|
|
||||||
## 2026-09-12 试玩日志器 + 诊断转储（playtest 数据采集基建）
|
|
||||||
|
|
||||||
**新增**：① **`PlaytestLogger`**（呈现层组件）——订阅 B1 新信号 `settlement_snapshot`（每结算末尾全量状态：关卡/深度/轮次/verdict/英雄/敌人/行动经济/板序号统计/buff/库存/本轮 facts）+ battle_finished/node_entered/level_finished，逐行写 **JSONL**：`user://logs/playtest_<seed>_<时间戳>.jsonl`（每行一个完整状态，直接可喂 pandas）；② **诊断转储按钮**（侧栏底部"🩺 诊断转储"）——卡死时点击，全量核心状态（B1 相位机/计数器/facts、A2 棋盘、A3、B4、runner）+ 最近 200 结算行/100 操作环形缓冲 → `user://logs/diag_*.json`（行为探针 _dump_state 的产品化）。
|
|
||||||
|
|
||||||
**顺手修复（日志首秀即抓真 bug）**：_start_full_level 面板加成**双写叠加**——tune_panel.apply() 先写表（6→18），runner.set_hero_override 再以 18 为基线 ×3（→54）。修复 = 关卡模式单一应用路径（runner 写表），日志快照 atk 54→18 证实。**教训（规范 5.x 补充案例）**：同一加成的多应用路径必须单一事实源；JSONL 快照是数值回归的最低成本探测器。
|
|
||||||
|
|
||||||
**冒烟 103/103**（+7：快照信号/字段齐备/板序号/JSONL 解析/诊断文件）。日志目录：`%APPDATA%/Godot/app_userdata/DungeonSweeperVerticalSlice/logs/`。
|
|
||||||
|
|
||||||
## 2026-09-12 C3 GDD 落地 + 试玩采集清单
|
|
||||||
|
|
||||||
**落地**：C3 GDD（`design/gdd/c3-difficulty-curve.md`，solo 出稿未评审）的设计承诺落回切片——① **DifficultyTable 结构位**（schema + 空表 + ConfigDB 挂载 + B2.spawn 套乘钩子：行值快照前施加、越域 clamp 至 [0.1,10]；MVP 空表零行为——AC-10 冒烟断言含注入/越域验证）；② 切片调参登记（敌深度轴/板参数/供给参数）**转正为 MVP 默认曲线**——切片当前数值 = C3 GDD 背书的设计态，试玩即体验 C3 定稿难度。冒烟 96/96。
|
|
||||||
|
|
||||||
**试玩数据采集清单（反哺 C3 六个 OQ——试玩时请记录）**：
|
|
||||||
1. **OQ3 真人修正系数（首要）**：你无面板加成打第一关的通关/败北结果（模拟基线 80% 通关——真人预期显著更低，落差就是修正系数）。
|
|
||||||
2. **OQ2 Boss 血量**：Boss 战实际打了多少轮、是否觉得血量压迫合理还是拖沓（模拟值 130HP 占比 0.81 越带）。
|
|
||||||
3. **OQ6 轮内刷新**：你实际用了几次"弃图刷新"、是否觉得"挖-刷-挖"太顺滑（免结算=敌人不出手）。
|
|
||||||
4. **OQ4 弃图倾向**：有没有"挖一半就想弃图刷 RAP"的冲动（模拟测不到真人策略）。
|
|
||||||
5. **难度台阶可感知性**：D2 伏击兽/D4 Boss 相比 D0 蛆虫的变强是否有具体面孔（新敌种=新图像线索）。
|
|
||||||
6. **奖励供给体感**：可选类道具（刀/治疗包）获取频率与囤积感受（供给控制器批后每关 ≈4.5–6.5 件）。
|
|
||||||
|
|
||||||
试玩方式：F5 → 「▶ 开始冒险」基线打一局（一条命三关连探——冒险结构实现批 2026-09-21 起，第一关读数即冒险首关） → 调整板 +100% 攻击再打一局（对照"数值提升→通关期望改善"的元进度体感）。
|
|
||||||
|
|
||||||
|
|
||||||
## 2026-09-12 试玩批次 1 → v3 数值批（F7 流程实践）
|
|
||||||
|
|
||||||
**试玩反馈（v2 数值）**：满血全通关（三策略均通）/ Boss 血量 OK 或可上调 / 刷新零使用 / 零弃图倾向 / 治疗包零使用 / DND 命名指令（地精/熊地精/食人魔酋长）。
|
|
||||||
|
|
||||||
**v3 数值批**：atk 4/4/6/4/7 → **7/5/9/6/9**（承伤主杠杆）；D0 goblin 24 保持（20 会被首轮粉尘秒杀——冒烟封印回归断言抓获）、D1 群 13×2、D2 bugbear 40/9、D3 群 26×2、**Boss ogre_chief 150/9**（用户拍板可上调）；L2 锚行同步。**DND 命名**：goblin 地精 → bugbear 熊地精（DND 原型即伏击手）→ ogre_chief 食人魔酋长；enemy_id 同步更名。
|
|
||||||
|
|
||||||
**v3 扫描对照 F5**：基线 **60%**（带 40–60% 上沿 ✓，v2 80%）· 败北 4/6 集中 Boss（压迫预期兑现）· +50%→87% / +100%→93% / +200%→100%（天赋曲线成立）· 承伤 90（v2 80）。C3 GDD 回写：F3 带 [0.5,1.1]（OQ2 裁决）、OQ2/3/4/6 试玩读数、试玩批次记录。
|
|
||||||
|
|
||||||
**冒烟 103/103**（封印回归断言改用 Boss 行——D0 20HP 级被盲挖粉尘秒杀无法承载场景；DifficultyTable 断言对齐 v3 行值）。**下一批 = v3 真人试玩**（OQ3 定量/OQ2 终裁）。
|
|
||||||
|
|
||||||
## 2026-09-12 遭遇随机化（Roguelike 局感引入批——Peglin 对比报告落地项）
|
|
||||||
|
|
||||||
**触发**：用户试玩反馈"关卡完全没有 Roguelike 的体现"→ Peglin 对比报告（`design/research/peglin-comparison-2026-09-12.md`）→ 用户拍板先做遭遇随机化（节点分支/多波/遗物协同后置）。
|
|
||||||
|
|
||||||
**设计**（C3 GDD Core Rule 8）：EnemyTable 行 `unit_count` 升级为**区间语义** `[unit_count, unit_count_max]`（新字段可省略=定值，旧行零迁移）；B1.begin_battle 实例化期按区间均匀骰，**RngService 新增 `encounter` 封闭流**（registry 接口漂移登记——挖掘决策域之外 P1 合规）；**B2 零随机纪律保持**（spawn 收 override 即确定值）；同种子全程可回放；新敌种首遇节点固定数量（教学位不加骰）。
|
|
||||||
|
|
||||||
**L1 区间**：地精 [1,2] · 地精一伙 [2,3]（hp 13）· 熊地精固定（教学位）· 熊地精双雄 [2,3]（hp 18）· Boss 固定——期望总量 ≈304（+8%），F6 带内。
|
|
||||||
|
|
||||||
**扫描（N=15）**：基线通关 **47%**（区间期望总量上移 +8% 的叠加效应——F5 带 40-60% 带内 ✓）；+50% → 67%；败北分散（Boss×3/战1×4/战3×1）。**注意**：区间骰使难度分布更宽（运气成分进入遭遇层——Roguelike 体的核心），真人体感待批次 2。
|
|
||||||
|
|
||||||
**冒烟 149/149**（+46：区间双值出现/全域内/同种子可回放/D2 教学位固定）。
|
|
||||||
|
|
||||||
## 2026-09-12 试玩批次 1 → v3 数值批（F7 流程实践）
|
|
||||||
|
|
||||||
## 2026-09-12 攻击类型 × 护甲克制批（用户拍板——三段伤害 + 标错惩罚落地）
|
|
||||||
|
|
||||||
**触发**：设计会话（本日）定稿"怪物护甲类型（轻甲/魔法护甲/重甲）× 角色伤害三段构成（普通/穿刺/魔法）"的克制对策系统（穿甲弹/高爆弹式三角）+ 标错封印随机惩罚。（本段写于 2026-09-12，原文使用位置名 无甲/护甲A/护甲B 与 基础/伤害A/伤害B——2026-09-15 命名统一批已全仓改为语义名，映射见下方该批小节。）设定表经用户多轮审阅确认"没有问题"后落程序（GDD 正式修订另批进行——本批以表格结论为实现依据）。
|
|
||||||
|
|
||||||
**拍板结构 → 落点**：
|
|
||||||
|
|
||||||
| 设定 | 实现落点 |
|
|
||||||
|---|---|
|
|
||||||
| 敌人护甲类型：轻甲 / 魔法护甲 / 重甲 | EnemyTable 新字段 `armor_type`（{light,ward,heavy}，缺省 light 向后兼容）· 映射：goblin=light / bugbear=ward / ogre_chief=heavy（教学梯度候选，provisional）· B2.spawn 行值快照入单位字典 |
|
|
||||||
| 伤害单分量（2026-09-19 充能退役） | ~~B1 三分量~~ 主角攻击 = 单一基础分量：量 = atk（表值）、类型 = hero.attack_type（营地换型 = 改字段）；hero_attack 行携带实际攻击类型键 + roll/ac/tier 掷点读数（P2 归因）。**攻击类型是伤害的属性轴，与来源无关**（2026-09-15 抽象分离批纪律保留） |
|
|
||||||
| ~~充能供给~~（2026-09-19 退役） | SettlementTable 字段 `charge_grants` 已删除——挖掘攒弹药的第二伤害供给取消，克制应对 = 冒险前配型（hero.attack_type）+ 棋盘火力（穿刺弹/魔法矢直伤道具） |
|
|
||||||
| 克制矩阵：克制 ×150 / 中性 ×100 / 被克 ×50 | SettlementTable 新字段 `armor_effectiveness`（{normal,pierce,magic}×{light,ward,heavy} percent，缺项回退 100）——刀/AOE/清图奖励**恒定表值不吃克制**（道具=万能稳定伤害，暂定待拍板） |
|
|
||||||
| 标错封印 → 随机轻惩罚三选一（时效 1 结算） | `_apply_miss_backlash()`：① `enrage` 暴走（敌 +25% 进 enemy_output 池）② 敌方伏击 +2 层（复用 ambush 行）③ `off_guard` 失衡（我方 +25% 进 hero_defense 池 = 多挨打）；新 B3 行 ×2（dur=1 与 weaken/ambush 同款先兑付后衰减）；沿用 `_seal_miss_seen` 每危险格实例一次去重 |
|
|
||||||
| 随机载体 | **零新流确定性派生**：(x×7 + y×13 + 板序号×5) mod 3——同种子可回放、不扰动既有三条封闭流取号序；正式侧候选 = RngService 新增封闭流（待拍板） |
|
|
||||||
| 呈现 | 敌人卡环点行常驻护甲标签（轻甲/魔法护甲/重甲——克制对策可读前提）· 结算明细主角攻击行拆"（普通 X + 穿刺 Y + 魔法 Z）" · 反噬效果行入明细流 · settlement_snapshot 增 armor/charge 字段（JSONL 数值分析面） |
|
|
||||||
|
|
||||||
**数值全部 provisional 待拍板/调参**（登记于 enemy.tres / settlement.tres 注释）：~~charge_grants~~（2026-09-19 退役）· ~~矩阵 150/100/50~~（加法核 +1/0/−1 换装）· enrage/off_guard 25% · 伏击 +2 层 · 护甲映射 goblin/bugbear/ogre——C3 调参时按 F6 供给平衡式复算（三段充能是新增伤害供给，裸装败北/基线通关率两条冒烟路径已复验仍成立）。
|
|
||||||
|
|
||||||
**正式侧义务（GDD/registry 修订清单，待文档批）**：B2 GDD（EnemyTable armor_type 字段 + schema）、B1 GDD（F3 主角攻击三分量构成 + seal_miss 反噬编排 + 克制矩阵载体）、B3 GDD（六行 MVP 状态表 + source_class seal_miss 授予）、A2 OQ1（标错惩罚候选升级为三选一随机池 + 重复性口径＝每危险格实例一次）、registry（enemy/settlement_table/status_effect 条目 + A3 条款②锚与条款③不等式重推导——封印命中收益从纯 weaken 变"weaken+魔法 充能"）、C3（数值 provisional 接管）。lore 侧：`design/research/lore-nest-metaphor-2026-09-12.md`（穿刺=地利/魔法=封印暴露、反噬=封印失败——待新会话拍板后写回 game-concept）。
|
|
||||||
|
|
||||||
**验证**：冒烟 **161/161**（+12：护甲快照三档传播 / 克制矩阵三行表值 / hero_attack 行三分量字段〔全战斗回放 ×2〕/ 标错封印 seal_miss+反噬效果行 / 标中雷充能进主角攻击 / 反噬派生同种子回放）· ui_probe PASS · ui_tune_probe PASS · ui_click_probe（done=true、选用失效=0、问题=0）。
|
|
||||||
|
|
||||||
## 2026-09-12 战斗屏五区改造批（battle.md 落地——ui-programmer 批）
|
|
||||||
|
|
||||||
**背景**：`design/ux/battle.md`（/ux-review APPROVED）+ `design/ux/interaction-patterns.md`（核心 8 pattern）落地到切片呈现层。**core/ 与 data/ 零改动**（本批纯 presentation/ + smoke/）。
|
|
||||||
|
|
||||||
**五区布局**（1280×800 基座）：A 区 28px 顶栏关卡进度条（`level_strip_view.gd` 改造：暗金已过/奖励金当前高亮）；B 区 252px 战斗画面（`battle_stage_view.gd` 新建 = `hero_card_view.gd` + 轮次·阶段指示 + 兑现演出区 + `enemy_card_view.gd` ×1–3〔顺位徽标/意图徽标常驻/环点拍数/伏击共享池/死亡灰化+碎裂残位禁瞬消〕+ 底部结算明细带）；C 区 240px `hero_info_panel_view.gd`（直角细线数据框 + 修正来源角标 + RAP 点阵 + `status_slot_row.gd` ×4〔形状+色相双通道/层数角标/剩余结算点/悬停 tooltip 来源+语义+剩余/空态槽隐藏〕）；D 区 `board_zone_view.gd`（`ap_bar_view.gd` 44px〔AP 点阵+停手居左；图例+弃图刷新居右——确认 chips 异位 pattern 7〕+ `board_view.gd` 改造〔悬停三语义自绘光标/目标格边框/BFS 路径蓝点预览/可挖域 8 向呼吸微光/奖励徽章 R₀ 域外/去饱和 shader〕+ `toast_stack.gd` 2.5s 消退 + `board_fx_view.gd` 演出层）+ `desaturation.gdshader`（去饱和+金橙偏移、明度不变）；E 区 280px `inventory_panel_view.gd`（常读列表固定槽高 + 原位窗口态 pattern 2/8：描边金光/标题切换/时机指示/usable_now 禁选+原因/跳过/政策注记；属性简述投影、来源不呈现）。**旧 `hud_view.gd` 删除**（HUDView 职责由 B/C/D 三区视图承接）。
|
|
||||||
|
|
||||||
**全屏 States 与模态**：`legend_overlay.gd`（图例，状态槽空态说明）/ `settlement_review_overlay.gd`（明细回看）/ `battle_end_overlay.gd`（胜=金蜡封落于棋盘中央+判定行+回看入口；败=暮蓝 #5A6C8C+封印化光点收回）——统一模态登记序管理（`_open_modal` 打开时显式隐藏上方遮挡层，缺陷⑤纪律）。清图金粒喷泉+彩纸 / 完美排雷金光带+横幅 / 封印命中加重弹道 / Boss 紫赤影子爬棋盘 / 零合法板诚实 toast / chord·非相邻一次性提示（每 run 去重，`ux_hint_shown` 遥测）。**发现并修复历史 quirk**：TunePanel 默认 `visible=true` 靠被不透明开始层遮蔽的树序巧合——已显式初始化 false（缺陷⑤家族）。
|
|
||||||
|
|
||||||
**遥测**（playtest_logger 增 ux 行族，呈现层观测不改 core）：`ux_round_input_ratio`（原始输入:AP 消耗，快照驱动）/ `ux_round_exit{path_tag}`（快照 round_facts.path——呈现层只订 B1 的接线纪律下唯一合法源）/ `ux_refresh_attempt{result, round_refresh_index}` / `ux_window_choice` / `ux_reject{source, sub_reason}` / `ux_hint_shown{hint_id}`。
|
|
||||||
|
|
||||||
**探针**：ui_probe 增五区构建断言；ui_click_probe 增刷新确认链/图例开关/tooltip 触发/模态遮挡断言（图例/回看/窗口态/终局）/窗口期去饱和断言/首格可点计时（进入战斗屏口径 133–151ms ≤500ms AC；场景冷启动 ~700ms 为脚本首载编译域，观测项）——既有全部断言保留。** Waiting 刷新代理已按 OQ12 退役**：UI 刷新按钮仅挖掘期 Active 受理（presenter 门禁），原探针"窗口期点刷新"行为由 Active 确认链测试替代。
|
|
||||||
|
|
||||||
**回归**：smoke_all 149/149 · ui_probe PASS · ui_tune_probe PASS · ui_click_probe PASS（PROBE_SEED 7/11/23/99/42/77 六种子 done=true、选用失效=0、问题=0）。
|
|
||||||
|
|
||||||
**占位登记**：敌人意图视觉映射按 enemy_id 程序化占位（资产定稿归 B5）；D区演出（喷泉/彩纸/弹道/影子）全部程序化占位；CJK 字体依赖系统回退（Windows 可用，随包字体归 D1 正式化硬性前置——2026-09-12 定）；金蜡封/暮蓝氛围为色块占位级。
|
|
||||||
|
|
||||||
**2026-09-15 补记（雾格移除）**：雾格机制已整体移除（见[不做清单](../../design/gdd/05-不做清单.md)）——本节五区规格里的已开雾格 tint 残留、雾区全开一次性信号、图例「迷雾 = 无雷盲区」条目与雾首遇提示已随机制同批从实现与探针中删除（现行格态收窄为已开 / 未开两态，一次性提示只余 chord 与非相邻两项）。本文以上各历史批次条目保留当时陈述，现行实现与呈现义务以[战斗屏规格](../../design/ux/battle.md)与 [HUD框架](../../design/gdd/systems/表现与支撑/HUD框架.md)等现行文档为准。
|
|
||||||
|
|
||||||
## 2026-09-12 呈现层 code-review 修复批（/code-review CHANGES REQUIRED → 全项清偿）
|
|
||||||
|
|
||||||
**触发**：全切片 53 脚本 ~9400 行 /code-review（AGENTS.md 代码规范 + 架构文档对照），裁决 CHANGES REQUIRED（7 项必改）。core/ 12 文件与 smoke 断言面整体健康；病灶集中于 tune_panel 封装破口、main.gd 结构回涨、三处呈现契约错位。
|
|
||||||
|
|
||||||
**BLOCKING 修复**：
|
|
||||||
|
|
||||||
| # | 缺陷 | 修复 |
|
|
||||||
|---|---|---|
|
|
||||||
| 1 | **TunePanel 视图写核心表**（`apply()` 直写 `_db.hero.atk/.max_hp`）+ `run_simulation` 内 `load("res://smoke/...")` 驱动 core——面板模拟按 pct² 口径、模拟后表值残留污染真实对局（runner 把放大值当基线再乘） | tune_panel 重构为纯视图（`apply_requested`/`reset_requested`/`simulate_requested` 信号外发 + setter 注入）；加成落表收口组合根唯一路径 `_apply_hero_override`（每次从 `_ready` 捕获基线重算，幂等禁叠加）；模拟编排拆 `tune_sim_controller.gd`（先复位基线再移交）；报告文案归 `HudPresenter.tune_sim_report` |
|
|
||||||
| 2 | **意图徽标双翻译**：presenter 先把 beat key 译中文投影、EnemyCardView 再按英文 key 匹配 → 色相/重击"▼"通道永久失效；`BEAT_NAMES` 两处重复 | presenter 直传 B2 原键（attack/charge/heavy）；名/色/标记渲染映射唯一定义处 = EnemyCardView（set_intent 契约头注成文） |
|
|
||||||
| 3 | **C 区 RAP 死分支**：`_refresh_economy` 从不投影 `a3.rap`，"RAP 滚动归零"反馈（A3 D1 义务）不可达；视图靠解析自身 label 文本当状态 | presenter 持续投影 `a3.rap`；`hero_info_panel_view` 改 `_last_rap` 成员存储，删除 `_rap_value()` 文本解析 |
|
|
||||||
| 4 | **smoke_all 恒真断言**（`check(true, "全部计数在域内")`——越域也 PASS） | 改带分布标签的真实域内断言 |
|
|
||||||
|
|
||||||
**结构/封装修复**：
|
|
||||||
|
|
||||||
- **main.gd 761 → 667 行**（评审记录基线 433 行，400 行审视线）：节点构建拆 `ui_assembler.gd`（只 new/add_child/布局，零接线零核心写）；模态层级状态机拆 `modal_stack.gd`（缺陷⑤纪律载体）；战斗流程叙事文案拆 `battle_narrator.gd`（兑现 main 头注"不拼呈现字符串"）；模拟编排拆 `tune_sim_controller.gd`。剩余行数 = 组合根规定的接线 + 模式流转 + 核心写调用唯一出口（再压需移动组合根规定职责，登记为 D1 正式化批候审）。
|
|
||||||
- **level_runner core↔core 接线 lambda → 方法 Callable ×4**（静态规则 S6——lambda 捕获 self 延长 RefCounted 生命周期/成环）。
|
|
||||||
- **B1 新增 `diagnostic_snapshot()` 诊断观测面**：组合根诊断转储与 click_probe 停滞诊断全部改走成文 API，零下划线私有字段直读（此前直读 8 个）。
|
|
||||||
- **信号处理体去 lambda 化**：main 三处多行/单行 lambda（inter 层继续/单场入口/库存拒绝）改命名方法 + `bind`（规范 4.1）。
|
|
||||||
- 顺带：`can_request_refresh()` 断行格式修复（原单行内嵌 tab 不可读）；`_build_inter_overlay` 死参 `parent_root` 删除；`_start_battle` 重复 `_start_overlay.visible = false` 去重；调试两层入口改由 `_start_battle` 统一取加成后满血（原传参在加成前取表值）。
|
|
||||||
|
|
||||||
**探针同步（缺陷回归断言随契约更新——3.3）**：ui_tune_probe 重写——应用/重置走真实按钮信号路径（`press_apply_for_probe` 接缝——合成输入走真实翻译出口口径）；**新增两条回归断言**：⑦模拟后 hero 表保持基线（无残留）⑧应用加成 + 启动完整关卡后 runner 写表值 = 基线 × 单次加成（12/75；旧缺陷表现 24/112 在此被抓获）；ui_click_probe 停滞状态与诊断转储改走 `diagnostic_snapshot()`。
|
|
||||||
|
|
||||||
**验证**：smoke_all **141/141** · ui_probe PASS · ui_tune_probe PASS（含新回归⑦⑧）· ui_click_probe 六种子（7/11/23/99/42/77）全 PASS（done=true、选用失效=0、问题=0）。新增 4 脚本 `.uid` 经 headless 编辑器扫描生成（语言纪律⑤）。
|
|
||||||
|
|
||||||
**登记待办（非本批范围）**：自动玩家策略四份复制收口（评审 W-3）；schema 溯源行补齐（W-9）；S1–S8 静态扫描脚本化后 S1 自建 RNG 豁免口径登记（W-1）；views 转发层信号契约头注补齐（W-2）。
|
|
||||||
|
|
||||||
## 2026-09-13 封装收口批（代码架构审查 E1–E5/O1–O5/P3 修复——接口正式化候选项的切片侧预收口）
|
|
||||||
|
|
||||||
**触发**：/architecture-review 改编批——以 architecture.md + code-conventions 为基线做代码组织/封装专项审查（报告：`代码架构评审（已退役，git 历史可查）`，Verdict: CONCERNS），用户拍板 P1+P2+P3 全修（P2 中涉接口漂移两项另出设计稿待审）。
|
|
||||||
|
|
||||||
**核心封装修复（P1）**：
|
|
||||||
|
|
||||||
| # | 项 | 修复 |
|
|
||||||
|---|---|---|
|
|
||||||
| E1 | **B1 协作对象全公开 → 呈现层链式穿透**（`b1.b2.hero`、`b1.a3.phase` 式层层下钻 main×18 / presenter×15 处） | a1/b2/b3/b4 私有化（a2/a3 保留公有 = 架构文档 API Boundaries 的 D1 契约面）；新增 `presentation_snapshot()`（载荷 schema 头注成文）/`is_battle_live()`/`stock_count()`/`query_reward_identity()` 四个成文只读出口——diagnostic_snapshot 同款模式 |
|
|
||||||
| E2 | **A2 状态字典公开且被视图绕过查询面直读**（board_view:278/303 直读 `.revealed`，头注自称"只读查询面"自相矛盾） | `board/revealed/seals` 私有化；新增 `current_board()`/`reveal_record()` 查询面；B1/组合根/探针全部改走命名面 |
|
|
||||||
| E3 | **B2 裸字典容器公开**（`hero/enemies` 可被任意写；presenter 为死亡残位直读原始数组） | 私有化 + `hero_unit()`/`all_enemies()`（含死亡残位，句柄语义与 query_alive 同构）投影面；presenter 残位渲染需求收进 API |
|
|
||||||
| E5 | **"只读"字段仅靠纪律**（phase/ap/rap/last_round_end/master_seed 架构文档定只读，实际公开可变） | getter-only 属性 + 下划线后备字段（外部读法 `a3.phase` 不变，写入仅剩方法通道——GDScript 层面机制化） |
|
|
||||||
|
|
||||||
**组织修复（P1/P2/P3）**：
|
|
||||||
|
|
||||||
- **O1/O2 调试模式抽离**：main.gd 调试分支（单场/连续两层/HP 携带/共享 B4）拆 `presentation/debug_session.gd`——调试语义单一实现点（O2 双实现漂移收口）；组合根保留接线（battle_created 先于 begin_battle 发出，接线唯一归组合根 + 缺陷①时序义务）与终局 UI 决策。ui_probe 抓获初版时序缺陷（battle_ready 才接手 b1）——即缺陷①同款，battle_created 接手修复。
|
|
||||||
- **O3 DamageMath 抽取**：B1 伤害公式族（F2 乘区/充能分量，零状态纯算术）拆 `core/damage_math.gd`（规范 1.2 工具函数挂宿主类）；board_generator 同一合法板重复调用两次 measure_inferability 合并为一次（全库最贵求解器）。
|
|
||||||
- **P3 清债**：头注溯源补齐 ×4（board_data/config_db/rng_service/reward_supply_controller——规范 1.4）；B4 grant/grant_clear/stock/use 失败返回统一 `false`→`null`（E6 消费方 `is Dictionary` 判定天然兼容）；equivalence_supply 表行 duplicate 防配置源泄漏；load()→preload/类名直引 ×3（main logger/runner、tune_sim autoplay）。
|
|
||||||
|
|
||||||
**加固（基线既有噪声根治）**：main.gd `_on_board_action` 的清图演出判定在 settle_batch 同步重入（结算→battle_over→关卡终局置空 b1）后仍摸 `b1.a2` → SCRIPT ERROR（基线 click_probe 每跑必现）——补 `b1 != null` 守卫，探针 stderr 归零。
|
|
||||||
|
|
||||||
**验证**：冒烟 **141/141**（与基线一致）· ui_probe PASS · ui_tune_probe PASS · ui_click_probe PASS（done=true、选用失效=0、问题=0，**SCRIPT ERROR 0**——优于基线）· 新增脚本 .uid 经 headless 编辑器扫描生成（语言纪律⑤）· presentation 层残留穿透引用 grep 归零（呈现面调用 19 处全部为命名 API）。
|
|
||||||
|
|
||||||
**登记待办（P2 设计稿待审——见审查报告 §4）**：E4 `db.hero` 表值运行时改写参数化（涉 B2.spawn 契约 = 接口漂移，须 GDD/registry 修订批）；O4 自动玩家策略四份复制收口（与既有待办 W-3 合并）。
|
|
||||||
|
|
||||||
## 2026-09-13 P2 收口批（E4 表值参数化 + O4 自动玩家单一实现——用户拍板两项均做）
|
|
||||||
|
|
||||||
**E4（db.hero 表值运行时改写 → 参数显式传递）**：
|
|
||||||
- `B2.spawn` 增 `atk_override/max_hp_override` 参数（-1 = 表值兜底；沿用 unit_count_override 先例；EC16 越界守卫改对生效上限判）；
|
|
||||||
- `B1.begin_battle` encounter 增 `hero_atk/hero_max_hp` 字段（缺省表值——冒烟直呼路径零改动），战斗段 `_hero_atk` 快照替代 `db.hero.atk` 读取；
|
|
||||||
- `LevelRunner`：`start_level` 表写删除、生效值进 encounter、`restore_hero_base` 只清百分比（表值不可变后无基线可恢复）、`_base_*` 字段删除（直接读恒定的表）；
|
|
||||||
- main：`_apply_hero_override/_scaled_override` 表写路径废除 → `_debug_hero_override()` 生效值供给 Callable（面板百分比现算经 encounter 入战斗）；`_on_tune_apply/_on_tune_simulate` 去复位步骤；`_db_base_*` 字段删除。
|
|
||||||
- **收益**：双写叠加（6→18→54）与双基线同步整类隐患随表写移除；D2「单一事实源」原则机制化（表值运行期不可变）。
|
|
||||||
- **登记义务**：registry architecture.yaml 新增 `hero_override_parameter_passing` 条目（接口漂移候选；B2.spawn 签名 +2 / B1 encounter +2 = 接口漂移，正式侧 B1/B2 GDD 修订随正式化批）。
|
|
||||||
- **探针语义升级**：ui_tune_probe ⑦「表值残留」→「hero 表运行期不可变」（reintroduce 表写即 FAIL）；⑧ 双写叠加回归改为完整关卡路径 + 呈现快照单次生效断言（12/75；旧缺陷形态 24/112 仍被抓获）。ui_probe 的 `_start_single` 语义注记：调试单场恒基线（入口清零滑条——原行为，非缺陷）。
|
|
||||||
|
|
||||||
**O4（自动玩家策略四份复制 → 单一实现，合并既有待办 W-3）**：
|
|
||||||
- 新增 `smoke/auto_player.gd`：`choose_dig`（最近可挖格）+ `window_selection`（治疗优先于刀；差异参数化 heal_hp_div 2/3 · round_gate 0/3 · knife_compare best/sum——四调用点原语义逐一保留：smoke_all 3/3/best · monte_carlo 2/0/sum · dump_battle 3/3/sum · level_autoplay 2/3/best）；
|
|
||||||
- 四消费方删除各自的 `_choose_dig`/窗口策略块改走单一实现；click_probe 的 `level_autoplay._choose_dig` 引用同步改指 AutoPlayer；
|
|
||||||
- **等价性证明**：smoke_all 同种子回放断言（步骤流逐行相同）重构后保持全绿。
|
|
||||||
|
|
||||||
**验证**：冒烟 **141/141** · ui_probe PASS · ui_tune_probe PASS（含 E4 新断言）· ui_click_probe PASS（done=true、选用失效=0、问题=0）。
|
|
||||||
|
|
||||||
|
|
||||||
## 2026-09-13 零承伤根因分割探针 + playtest-09-12 Bug #1–#3 处置批（报告 Top3 授权任务）
|
|
||||||
|
|
||||||
**触发**：playtest-2026-09-12-designer 报告 Top 3 Priorities（探针分割 → Bug 建档修复 → 多种子复扫基线）；数值拍板与设计变更不在授权范围（待拍板清单见文末）。
|
|
||||||
|
|
||||||
**① 零承伤根因分割（新探针 `smoke/damage_probe.gd`——boss/level 两模式）**：
|
|
||||||
- **快照盲区发现**：settlement_snapshot 取在衰减段之后，时效 1 的 defense_up 当轮授予当轮衰减——真人局 JSONL `buffs[]` 恒空 ≠ 池为空（报告悬置的直接原因）。探针改从结算行（effect 行 pool_value）重建战斗段时点池值，池归属经 settlement.effect_pool_map 表驱动（零字面量）。
|
|
||||||
- **Run A（fresh 池零挖掘裸验）**：Boss 攻击拍 d_tick = atk.total 全额兑现（attack 9/9 ×2 · charge 0 设计语义 · heavy 18/18），6 轮击倒英雄（defeat）——**「Boss/敌攻击链缺陷」否证**；拍名轮转与真人局逐拍一致（attack→attack→charge→heavy→attack）。
|
|
||||||
- **Run B（自动挖掘墙行为）**：池 -30 → d_tick 21→14、池 -60 → 残余 ×0.40，墙轮承伤恒 >0；表值判定墙最深 -60 > pool_clamp_lo -100 = **归零不可达（09-13 调参批在当前数据上重证）**。
|
|
||||||
- **结论**：真人局 12/12 轮零承伤 = 旧数据 defense_up -50×2 = 池触 clamp 下限 ×0（设计语义）——任何 atk 曲线乘在 ×0 上（原报「v3 主杠杆乘在 ×0 上」坐实）。报告 Bug #2 = 设计问题非 bug。
|
|
||||||
|
|
||||||
**② Bug #1–#3 建档与处置（BUG-0002/0003/0004，`production/qa/bugs/`，编号自 BUG-0001 顺延）**：
|
|
||||||
- **BUG-0002（报告 #1 浅深度空遭遇）——Rejected as coded**：seed 42 当前构建全关回放复现同款遥测签名（d0 spawn=1 / d1 spawn=3 + round-1 victory + unit_count 0）但实为**首轮全灭**（英雄爆发 + 爆裂粉尘 instant_aoe 全歼低 HP 敌群；与 20:41 局 d1 双地精各剩 1 HP 逐点吻合）；遭遇骰数学下限 ≥1（B1 roll_lo）+ B2.spawn count<1 fail-fast 双闸，100 场扫描零越域。**快照盲区修复**：settlement_snapshot 增 `spawn_count`（实例化总数含死亡残位）——unit_count=0 时「全灭 vs 空场」可判别，同类误读机制化排除。
|
|
||||||
- **BUG-0003（报告 #2 Boss 攻击零兑现）——Rejected as coded**：根因见①；候选改法（clamp 收紧 / 乘法衰减 / 重击拍穿防）列待设计批。
|
|
||||||
- **BUG-0004（报告 #3 grant_node_active 绕过 _supply.notify_granted）——Fixed**：stock 受理成功后补入账（与 grant() 同一「发放即获取」口径）；计数器战斗域清零语义不变 = **零战斗数值影响**，纯计数口径修复（报告 Top3 #3 的上报义务执行）。
|
|
||||||
- **回归断言（代码规范 3.3）**：smoke_all +7——快照 spawn_count 字段与等值断言；遭遇全深度 × 12 种子全域内扫描（60 场 spawn ≥1 且 ∈[unit_count, unit_count_max]）；`_smoke_attack_chain_fresh_pool`（fresh 池非蓄力拍 d_tick == atk.total 全额兑现——攻击链健康钉死，未来真缺陷在此被抓）；`_smoke_supply` ⑦ 节点奖励发放即入账。
|
|
||||||
|
|
||||||
**③ 多种子关卡复扫（Q1 调参批基线——level_monte_carlo 增 F4 两列「普通承伤/场% · Boss承伤%」：逐战斗承伤切分 = round 回卷分段 + 末段 Boss 判定（须抵达 Boss 节点））**：
|
|
||||||
- N=30 × 10 档（种子 4200–4229；F7 切片样本量口径）。**结论：全档位越带**——F5 基线通关率 **17%**（带 40–60%）· +100% 档 43%（中天赋 ≥95%）· +200% 档 63%（高天赋 100%）；F4 普通场承伤 **35.1–43.1%/场**（带 ≤20%）、Boss 场 **71.3–134.9%**（带 ≤50%）（hp+0 档；hp+100 档普通 13.9–22.6 带内 / Boss 35.8–76.7 仍多数越带）。拆墙（-50→-30 且权重 24→16）与 v3 atk 曲线叠加后，难度由严重不足摆向**严重过剩**。**本批未动任何数值**（敌 hp 曲线与奖励供给禁独立调参——registry 预警⑥联动义务；杠杆方向列待拍板，本基线 = F7 流程的测量输入）。
|
|
||||||
|
|
||||||
**验证**：冒烟 **148/148**（141 既有 + 7 新回归）· 三探针 PASS（ui_probe / ui_click_probe 6 种子 done=true、选用失效=0、问题=0 / ui_tune_probe）· damage_probe boss 模式 7/7 + level 模式（种子 42/43/44）4/4 全 PASS。
|
|
||||||
|
|
||||||
**待拍板/待设计批清单（本会话零数值变更、零 GDD 变更）**：
|
|
||||||
1. **难度杠杆重拍板**（F4/F5 全档位越带）——候选：enemy atk 曲线回撤部分 v3 增量 / defense_up 权重回升 / heal 供给联动——归 C3 按 F7 流程（本基线为测量输入）；
|
|
||||||
2. **墙语义候选改法**（clamp 收紧至 -60/-70 / stack 乘法衰减 / heavy 拍穿防）→ C3 + /propagate-design-change（连带 B1 池 clamp 语义 + B3 GDD "-50" 文字同步）；
|
|
||||||
3. **供给量重拍板**：「每战斗首件保证」的总量语义（候选：关卡域首件）→ C3（BUG-0004 已封计数漏洞，关卡供给账目可完整观测）；
|
|
||||||
4. **浅深度首轮跳战可玩性**（autoplay/真人 d0-d3 round-1 全灭跳过战斗过程）→ C3 结合 F4 复验数据裁决。
|
|
||||||
|
|
||||||
|
|
||||||
## 2026-09-13 拍板落地批（四项拍板——难度杠杆/墙语义/供给量/跳战）
|
|
||||||
|
|
||||||
**拍板结果**（用户四问裁决）：①难度主杠杆 = **先真人试玩再拍**（F5 真人修正系数标定优先于数值调整）；②墙语义 = **维持现状 + 归零护栏**；③供给量语义 = **先观测再拍**；④跳战 = **并入难度复测再议**。本批零玩法数值变更。
|
|
||||||
|
|
||||||
**落地变更**：
|
|
||||||
- smoke_all 新增 `_smoke_wall_zero_guard`（表级不变式：`2×defense_up.magnitude > pool_clamp_lo`）——BUG-0003 事故类（叠满触池底 = ×0 全额免伤）永久免疫：任何未来 magnitude/clamp 调参重新造出 ×0 墙即冒烟红灯，强制显式重审；
|
|
||||||
- level_monte_carlo 增「**跳战率**」列（普通战斗 round-1 即胜占比——拍板④观测面，此后每次复测自动携带）；`_damage_segments` 升级为逐段 {承伤, r1_win} 结构；
|
|
||||||
- defense_scan 输出标签修正：「墙轮承伤（应为 0）」→「（合法——-30 批墙帽 ×0.40）」（旧 -50 数据时代的期望文案过时清理）。
|
|
||||||
|
|
||||||
**跳战率基线（N=30，拍板④"再议"数据）**：基线 **8%** · +50% 13% · +100% 24% · +150% 27% · +200% 38%（普通场 round-1 全灭占比）。**seed 42（试玩固定种子）为高跳战轨迹**（autoplay d0–d3 四场全部 round-1 全灭）——真人局 d0–d3 全跳的体验含显著种子成分；基线 talent 下跳战是少数派，拍板④"复测再议"的数据前提成立。其余各列与 Q1 基线逐值一致（collect_rows=true 开启不改变行为——确定性交叉验证）。
|
|
||||||
|
|
||||||
**验证**：冒烟 **149/149**（+1 护栏）。
|
|
||||||
|
|
||||||
**下一步（用户侧）**：开一局真人试玩（任意种子；JSONL 自动落 user://logs/）。观测清单（服务拍板①③复议）：通关与否 + 败北节点（F5 修正系数 = 真人通关率 ÷ 模拟 17%）· 普通场掉血体感（对照 ≤20% 带）· Boss 战撑过几轮 · d0–d3 是否发生跳战 · 治疗包是否出现缺血时刻与库存残留（拍板③数据）。事后由会话分析 JSONL 出修正系数。
|
|
||||||
|
|
||||||
## 2026-09-14 完美策略档测量批（OQ7 技能轴上界仪——用户拍板"增加完美策略档测试验证"，零玩法数值变更）
|
|
||||||
|
|
||||||
**背景**：用户（扫雷强玩家）指出"完全正确开图/标雷、零踩雷 ⇒ 存活无压力"——现行扫描只有弱策略基线档（不封印/邻格盲挖/朴素选道具），技能轴不可测；registry `calibration_gap`（真人显著强于模拟者）此前只有方向无机制。本批 = 测量工具批。
|
|
||||||
|
|
||||||
**落地变更**：
|
|
||||||
- `auto_player.gd` 增完美策略求解器（`perfect_action`/`_deduce`）：single + subset 推理不动点（A1 F1 `measure_inferability` 同族规则集，**去 safe_set oracle**——约束未知邻格含危险格，比生成期闸保守）；**零盲挖**（只挖已证安全格 = 构造保证零踩雷，扫描末断言兜底违例 quit(1)）· **已证危险格全封印**（封印先于挖——轮末 weaken + 魔法 首次充能，雷上封印不阻连锁）· 卡死且资源可 → `b1.player_request_refresh()` 轮内刷新 · 否则停手（残 AP 1:1 入 RAP）。输入只经 A2 查询面（reveal_record/is_revealed/has_seal），**禁读棋盘雷区真值**——测推理上界，非全知作弊。core 层零改动；
|
|
||||||
- `window_selection` 增 `heal_no_waste` 选项（缺口 < 治疗量不用；完美档启用）+ 完美档轮次门解除（round_gate=0）；
|
|
||||||
- `level_autoplay.gd` 增 `policy` 参数（默认 "normal"——tune_sim_controller/defense_scan/level_debug 既有调用零改动）；完美档经 `policy="perfect"` 由 `_decide_act` 分派承载（原专职驱动 `_autoplay_battle_perfect` 已随样板收口并入分派——move/dig/seal 走 A2 settle_batch、refresh 走 B1 编排、连续拒绝 ≥3 停手防死循环）；st 增 `mine_hits`/`refreshes` 计数（mine_hit 证据行埋点）；
|
|
||||||
- `level_monte_carlo.gd` 增第 3 CLI 参 `[policy]`（normal/perfect/both，缺省 normal 兼容既有文档命令）+ 策略/踩雷/刷新列；脚注 F5 带文案同步 [30,50] 带锚定稿。
|
|
||||||
|
|
||||||
**完美档基线（N=30 · 种子 4200–4229 · 耗时 597.6s）**：**0 加成通关率 100%**（弱策略基线档 60%）、通关剩余 HP 均 **47.4/50**、整关承伤均 3.5（p90 18.0）、普通场承伤 0.5%（带 ≤20%）、Boss 场 5.3%（带 ≤50%）、踩雷 0.00/局（断言 ✓）、刷新 0.23/局、跳战率 20%。+50%～+200% 全档位恒 100% 满血通关（+200% 承伤均 0.4）——**技能轴上界完全碾压现行曲线：F5 带与 F6 S/K 区间对完美档零分辨力**（区间模型无策略水平轴的结构性证实；calibration_gap 获得机制解释与定量上界）。
|
|
||||||
|
|
||||||
**验证**：冒烟 **149/149** 全绿（默认行为零变更——弱策略档既有断言全通过）。
|
|
||||||
|
|
||||||
**待拍板**：① 0 加成完美档通关率的目标带（现行 [30,50] 按弱策略口径定义——是否改为按完美档口径验收？）；② 杠杆选择（已预登记：r_boss 走廊 180–207 / 群战上探 / decay 0.6；本批新增候选："上限掺运气"系——供给量值随机化（power 区间化）/ 承伤硬地板——均待完美档复测验证效果）。
|
|
||||||
|
|
||||||
## 2026-09-14 伤害量值区间批（用户拍板②——"上限掺运气"两步全落地 + 完美档无效性实测，宽度 provisional）
|
|
||||||
|
|
||||||
**拍板**：验收口径改完美策略档（0 加成通关 ≤40%）；杠杆 = 伤害值区间随机（上阶/下阶，范围内 roll）；覆盖面 = 奖励侧五行先行、不足扩敌方侧（分步授权已用尽）。roll 时机 = 身份预分配批（E14 快照口径不变）；中点恒等现值（A3 条款①当量锚不漂移）；宽度 provisional 归测量迭代。
|
|
||||||
|
|
||||||
**落地变更**：
|
|
||||||
- **第一步·奖励侧五行**（reward.tres + reward_table.gd schema + reward_economy.gd）：heal_minor [2,6] / knife_t1 [5,11] / heal_pack [6,18] / knife_adv [10,22] / clear_blast [25,55]——power_min/power_max 可选配对字段（缺省定值行向后兼容，armor_type 先例）；schema 校验 = 成对/buff 禁止/中点锚；roll 在 roll_board 身份批内**追加取号**（既有取号序零扰动）+ grant_node_active 同路径；快照 power = roll 值，B1/呈现零改动，授予期零随机纪律不变；
|
|
||||||
- **第二步·敌方攻击侧**（enemy.tres 六行 + enemy_table.gd schema + unit_container.spawn + battle_orchestrator）：atk [min,max] = 行值 ±3 provisional（d0 7[4,10] / d1 5[2,8] / d2 9[6,12] / d3 6[3,9] / Boss 9[6,12] / L2 7[4,10]）；roll = 遭遇骰同流（encounter 恰一 scope，数量骰先、atk 骰后）spawn 期**整战持久**——每拍抖动否决（数字可读性锚），B2 零随机纪律保持（收 override 即确定值）；spawn 签名 +1 参数（接口漂移登记，随正式化批）；
|
|
||||||
- smoke_all 新增 `_smoke_power_interval`（4 断言：五行中点锚/roll 域内含清图槽/定值行零外溢/节点路径域内）。
|
|
||||||
|
|
||||||
**实测（N=30，种子 4200–4229）**：
|
|
||||||
- 奖励侧单独：完美档 0 加成 **100%**（承伤 3.5——与区间前逐值一致）；基线档 17%（不变）；
|
|
||||||
- 敌方侧叠加：完美档 0 加成仍 **100%**（承伤 3.5→3.9 / p90 18→19——方差真实流动但被血缓冲全吞）；剩余 HP 均 47.4 不变；
|
|
||||||
- **验收结论：≤40% 线用数值区间杠杆族到不了**——完美玩家结构性优势（零踩雷 = 零直伤 + 全封印 = weaken −65% 顶格 + 快杀 = 敌出手次数最少）不受值域方差影响。三选待裁决：①承伤硬地板（每结算不可减免平伤——S_min 压缩，B1/B2 域）；②weaken 饱和/递减语义（拆"全封印顶格"基石，B3/B1 域）；③极端宽度（数值可用但毁基线档与可读性锚——建议否决）。**本批区间机制保留**（对普通玩家方差体验有效，中点锚不伤当量）。
|
|
||||||
|
|
||||||
**验证**：冒烟 **154/149+5 全绿**（区间批 5 新断言 + 既有全部回归含遭遇骰分布/回放）。
|
|
||||||
|
|
||||||
## 2026-09-15 攻击/护甲命名统一批（用户拍板"一并修改，统一称呼"——纯改名，数值零改动）
|
|
||||||
|
|
||||||
**触发**：GDD 评审（战斗结算）问题 1——位置键 `{base, dmg_a, dmg_b}` / `{none, a, b}` 不承载语义（a/b 是纯位置占位符：既说不出来源，也说不出来克制谁），且同一件事在仓内已分裂成四种写法（敌人系统 `{无, 甲, 重甲}` / 03-内容规模 `无甲/甲A/甲B` / registry `{none, a, b}` / 本 README `无甲/护甲A/护甲B`）。
|
|
||||||
|
|
||||||
**新词汇（全仓唯一现行词）**：
|
|
||||||
|
|
||||||
| 面 | 新 | 旧（作废） |
|
|
||||||
|---|---|---|
|
|
||||||
| 攻击类型（结算表矩阵行键 / hero_attack 行分量） | `normal` / `pierce` / `magic` = 普通 / 穿刺 / 魔法 | `base` / `dmg_a` / `dmg_b` = 基础 / 伤害A / 伤害B |
|
|
||||||
| 护甲类型（`armor_type` / 矩阵列键） | `light` / `ward` / `heavy` = 轻甲 / 魔法护甲 / 重甲 | `none` / `a` / `b` = 无甲 / 护甲A / 护甲B |
|
|
||||||
| 结算表字段 | `charge_grants`（触发源→{attack_type, per_unit, cap}，同日第二批抽象分离后定型） | `damage_a_per_cell` / `damage_a_cap` / `damage_b_per_seal`（"类型×来源"焊死命名；同名批曾短暂改 `pierce_per_cell` / `pierce_cap` / `magic_per_seal`，随即作废） |
|
|
||||||
| 结算快照 round_facts | `charge_counts`（各触发源计数）+ `charge_points`（按攻击类型分桶点数） | `charge_dmg_a` / `charge_dmg_b`（既有 JSONL 留存文件仍用旧键） |
|
|
||||||
|
|
||||||
映射沿教学梯度：goblin `none`→`light`、bugbear `a`→`ward`、ogre_chief `b`→`heavy`；**矩阵数值逐格不动**（pierce→ward 150 / pierce→heavy 50 / magic→heavy 150 / magic→ward 50 / normal 全 100）。
|
|
||||||
|
|
||||||
**同日第二批 · 攻击类型与奖励抽象分离**（用户裁定"攻击类型的定义和格子奖励要分离开；开格|标雷 → 奖励；奖励如何定义是可以修改的；不要将两者绑定"）：攻击类型 = 伤害的属性轴（普通 / 穿刺 / 魔法，只决定查甲效矩阵哪一行，定义里不含任何棋盘来源）；充能 = 按攻击类型分桶的附加伤害储备，**谁能充、充哪个桶 = 奖励定义**（`charge_grants`；开格 / 封印命中 / 踩雷 / 清图一律只作奖励触发源）。原 `pierce_per_cell` / `magic_per_seal` 式命名（类型与来源焊在一根名字里）作废。冒烟新增三条断言：奖励定义在位 ×2 + 行为断言（把"封印命中"奖励改投穿刺桶 → 同一战斗魔法分量归零；还原后步骤流逐行相同——证明改道唯一入口是奖励定义）。
|
|
||||||
|
|
||||||
**落点**：GDD（战斗结算 v0.5 / 敌人系统 / 难度曲线与Boss / 03-内容规模）+ registry（`enemy.armor_type`、`settlement_table.armor_effectiveness` 与三字段 + 批次注记）+ 切片（`enemy_table.gd` `ARMOR_TYPES`、`settlement_table.gd` `ARMOR_KEYS` / `ATTACK_TYPE_KEYS`〔原 `COMPONENT_KEYS`〕、`enemy.tres`、`settlement.tres`、`damage_math.gd`、`unit_container.gd`、`battle_orchestrator.gd`、`enemy_card_view.gd`〔敌卡常驻标签改 轻甲 / 魔法护甲 / 重甲〕、`battle_log_view.gd`〔拆行文案改"（普通 X + 穿刺 Y + 魔法 Z）"〕、`smoke_all.gd` / `damage_probe.gd` / `auto_player.gd`）；playtest 观测记录保留当时键名并附现名。
|
|
||||||
|
|
||||||
**验证（本批实跑）**：冒烟 **201 项检查 0 失败**（含分离批三条新断言：奖励定义在位 ×2 + 行为断言"封印命中奖励改投穿刺桶 → 魔法分量归零、还原后步骤流逐行相同"）· `ui_probe` PASS · `ui_tune_probe` PASS · `ui_click_probe`（done=true、选用失效=0、问题=0）· `ui_layout_probe` PASS——四探针 exit=0、FAIL 行 0。命名批纯改名零行为变更；分离批为结构重构，数值链路等价（旧"计数×每单位×克制"与现行"计数→按奖励定义折算点数→×克制"结果相同，冒烟全量回归含回放断言未动）。
|
|
||||||
|
|
||||||
## 2026-09-15 验收 + 收口批（两批改动闭合核对；零数值零机制改动；不碰 v0.7 文件）
|
|
||||||
|
|
||||||
**背景**：2026-09-15 两批（攻击/护甲命名统一 v0.5 + 攻击类型/奖励抽象分离 v0.6）已完成；本批只读核对"文档口径 ↔ 切片实现"是否闭合，并收口遗留开口。**范围纪律**：`战斗结算.md` / `地图战斗资源.md` 属 v0.7 格面资源批所有者文件、口径仍在移动——本批不改；③ 收口项落在 `registry` + 本 README + `active.md`，GDD 侧只报告、待 v0.7 批整体收口后回填。
|
|
||||||
|
|
||||||
**核对结论（两批核心语义 9 项全闭合）**：`charge_grants` 键与值（safe_cell→pierce 1/格 cap 8 · seal_hit→magic 2/雷 cap 0）· 甲效矩阵 9 格（normal 全 100 / pierce→ward 150、heavy 50 / magic→heavy 150、ward 50）· `armor_type` 三值（light/ward/heavy）· `hero_attack` 行分量字段（normal/pierce/magic）· round_facts 键（`charge_counts`/`charge_points`）· 敌卡标签文案（轻甲/魔法护甲/重甲）· 明细行拆行文案"（普通 X + 穿刺 Y + 魔法 Z）"· 攻击类型定义不含来源 · 矩阵数值逐格不动——GDD/registry/tres/代码逐项一致。残留旧名扫描仅命中批次注记"原名"与历史观测记录；来源-类型硬绑扫描确认代码只剩两处计数埋点（`_charge_counts["safe_cell"]` / `["seal_hit"]`）+ `charge_grants` 键 + 行 `source_class` 归因。
|
|
||||||
|
|
||||||
**实跑（本批）**：冒烟 **201 项检查 0 失败**；四场景探针 `ui_probe` / `ui_tune_probe` / `ui_click_probe` / `ui_layout_probe` 全部 **exit=0、无 FAIL 行**。
|
|
||||||
|
|
||||||
**收口（③，落在非 GDD 文件）**：
|
|
||||||
- ① **收益对照表充能当量覆盖缺口**：登记于本 README + registry + `active.md`（GDD 收益对照表回填待 v0.7 批收口后）。候选口径 = 充能当量 = Σ各桶点数 × 当轮目标护甲平均甲效倍率 ÷ 100（与直伤同类 1 伤害 = 1 当量，守 行动经济 条款①单一当量）；补式 / 登记待拍板二选一待回填批裁定。
|
|
||||||
- ② **两处已知落差登记**：a) `charge_grants` 触发源可扩展 vs 切片仅两个触发源计数埋点（新增源须加埋点）；b) `safe_cell`/`seal_hit` 来源标识跨命名空间同名（明细行 `source_class` / `charge_grants` 键；RewardTable.pool_tag 已随格面资源批改 `cell`）。
|
|
||||||
- ③ playtest 观测记录的快照键"现名"注记由中间名订正为现行名 `charge_counts`/`charge_points`。
|
|
||||||
|
|
||||||
**注意（口径移动）**：本批运行期间 **v0.7 格面资源批**已在 GDD（战斗结算 v0.7 / 地图战斗资源 v0.4）与 registry 落地——段序七→五、行型 15→10、极性路由取代三套固定兑付、可选类道具删除。切片代码尚未同步（registry 注明"切片代码修改随新会话执行、指导已产出"），故本文以上各历史批次条目保留当时陈述。
|
|
||||||
|
|
||||||
**两轴分离措辞不变**：攻击类型 = 伤害属性轴（定义不含来源）；充能 = 按攻击类型分桶的附加伤害储备，投桶归奖励定义 `charge_grants`；开格/封印命中/踩雷/清图只作奖励触发源。
|
|
||||||
|
|
||||||
## 2026-09-15 格面资源批 · 批 1（数据面 + 极性路由——设计权威 = 地图战斗资源 v0.4 / 战斗结算 v0.7 / 排雷玩法 v0.3 / registry 2026-09-15 条目）
|
|
||||||
|
|
||||||
**模型一句话**：格子分 安全|雷|封锁格 三型；每个非封锁格（安全格 + 危险格，雷安同池同分布）装板期一次摇定格面资源类型（五型 attack/defense/heal/blast/weaken）；极性不在资源内，由「动作 × 格型」矩阵决定——开安全格/标中雷 = 正向（奖励），开危险格/标错安全格 = 负向（惩罚），封印后撤封印零兑付；全部兑付在轮末授予段。可选类道具（刀/治疗包）与库存/供给控制器/道具窗口整体删除。
|
|
||||||
|
|
||||||
**数据面**：
|
|
||||||
- `reward.tres` 结构性重写（`reward_table.gd` 同批）：删 `category`/`use_timing` 字段与 CATEGORIES/USE_TIMINGS 常量；新增 `cell_type`（五型封闭枚举，清单外加载拒绝）× `polarity`（positive/negative）+ `stacks`（可省，缺省 1）；`pool_tag` 收窄 {cell, clear_default}。行集 = 十一行：格面池正向五行 attack_up(w20,t2)/defense_up(w16,t2)/spark_aoe(flat 4,w16,t1)/heal_minor(flat [2,6],w15,t1)/weaken(w12,t1) + 负向五行 enrage(attack,t2)/off_guard(defense,t2)/heal_backlash(heal 直伤 flat 4,t1,无 effect_id)/ambush_double(blast 加层 stacks=2,t1,无 effect_id)/sapped(weaken,t1)——负向行 weight=0 纯兑付字典不参与摇号；clear_blast 保留（flat [25,55],w1,t2,clear_default）。加载校验族重写：五型 × 正负两行齐备（缺任一致命）/ cell 池 ≥1 正向行 weight>0 / percent 行 effect_id 必填（悬空校验在 ConfigDB）/ flat 行 power≥1（**例外 = blast 负向加层行，消费 stacks 不消费 power**——战斗结算 兑付形态表"伏击加层"独立形态的行级兑现）/ 区间配对 + 中点锚不变。
|
|
||||||
- **删除三件**：`core/reward_supply_controller.gd`（可选类供给控制器——首件保证/指数递减整体下线）、`data/schemas/reward_config_table.gd`、`data/tables/reward_config.tres`（RewardConfigTable 随可选类删除废止——注入概率/按板保底参数失义）。
|
|
||||||
- `status_effects.tres` 六行→七行：新增 **sapped（乏力——weaken 型负向：hero · −25 percent · dur 1 · max_stack 16 · stack**，hero_offense 池，attack_up 镜像；值 provisional 归 难度曲线与Boss）。
|
|
||||||
- `settlement.tres`：`segment_order` 七段→五段 [grant, buff_debuff, combat, decay, verdict]（schema 冻结常量同步）；`effect_pool_map` 增 sapped→hero_offense；`source_label_map` 删 item 键（ConfigDB 必需键清单同步）。`charge_grants` 路径不动（开格→穿刺 1/格 cap8 · 封印命中→魔法 2/雷）。
|
|
||||||
- `config_db.gd`：reward_config 出表清单；跨表校验族重写——旧 ②池空/③clear正当量并入 RewardTable.validate，旧 ④⑤⑨（k_dmg 保底/零伤害后闸/注入池护栏）随 reward_config 删除退役，保留 ①effect_id 悬空 / poolmap 悬空 / source_label_map 键集 / level 节点悬空。
|
|
||||||
|
|
||||||
**路由面（core）**：
|
|
||||||
- `minesweeper_rules.gd`：cell_revealed 事件字段 `reward_eligible` → **`resource`**——initial 恒 false（封锁格），chain/dig 恒 true **含危险格**（雷安同池——旧"mine 恒 false"作废）。
|
|
||||||
- `reward_economy.gd` 重写为纯格面资源身份面：roll_board 对全部非封锁格逐一摇定类型（摇号只用正向行权重 = 类型频次，合计 79）+ 清图批尾摇 clear_blast + 区间行 power 追加取号；query_identity 返回 {reward_id, cell_type, tier}，未开格恒可查（危险格同权）；grant/grant_clear 幂等保持；新增 `polarity_row(cell_type, polarity)`（类型化字典行查询面，拷贝出口）与静默 `is_mapped`/`phase` 只读出口；**删库存轴整族**（stock/use/query_inventory/in_stock_count/clear_inventory/grant_node_active/supply_granted_count/notify_battle_start）；equivalence_supply 投影保留（tier_min_buff = 我侧 percent 正向行最低档 = 2）。
|
|
||||||
- `battle_orchestrator.gd` 授予段改**极性路由**：结算队列（开格/封印判定/清图三批）逐格兑付——开安全格→该格 cell_type 正向行（charge_grants 计数埋点不变）、开危险格→负向行、标中→该危险格正向行（_seal_consumed 每雷实例一次去重不变，高光 seal_hit 保持）、标空→封印未中归因行 + 该安全格负向行（_seal_miss_seen 同键去重不变）；**删旧三套固定兑付**（`_convert_ambush` 踩雷固定伏击 / `_judge_seal` 标中固定 weaken / `_apply_miss_backlash` 标错三选一哈希派生——整段删除）。负向兑付：percent 走 apply_effect（enrage/off_guard/sapped）；heal 负向 = 主角直伤 4（apply_damage，不经增益状态；战斗段增 hero 存活守卫 = 致死短路；同轮后到 heal 正向遇已倒下主角记"奖励未生效"行）；blast 负向 = ambush +stacks 层（`_apply_ambush_grant` 逐层经 ambush_grant_plan 对 cap=4 守恒，溢出逐层"溢出未生效"行——协议不变）。正向兑付：percent 挂状态、flat 当场（满层/满血/无敌/主角已倒下记"奖励未生效"行）。抵消过滤既有语义保持（封印判定批以轮末在场封印为基线——发射面过滤，勿改）。区间行快照 power 只在正向路由覆盖表值（负向字典行自带定值 power）。**行型协议 15→10**（删 item/consumed_ineffective/use_rejected/window_open/window_skip），SOURCE_EXEMPT 两层豁免集合同步收窄。
|
|
||||||
- `level_runner.gd`/`debug_session.gd`：共享 地图战斗资源 容器与库存延续语义随库存删除收窄——战斗各自持容器（映射随战斗退役，零跨战斗状态），runner 删 window 转发/inventory()/level_clear 清库/submit_window_selection；奖励点节点内容随功能道具渠道（P1 未定）**悬置为直通节点**（零兑付，node_entered 零载荷——内容归 关卡节点地图 定稿批，**待拍板**）；battle_finished 载荷删 remaining_items。
|
|
||||||
|
|
||||||
**呈现面**：
|
|
||||||
- 删除 `inventory_panel_view.gd`（E 区道具面板/窗口态整件）；`ui_assembler` 五区→四区（玩法说明文案改格面资源口径）；`hud_presenter` 删 _fill_inventory/_inventory_row/window_rows，refresh 签名收窄；`main.gd` 删窗口接线/窗口状态机/库存引用（ux_window_choice 遥测随之退役）；`battle_narrator` 文案去道具（层间延续 = HP only）；`battle_log_view` 行格式化收窄 10 类（AGG_TYPES = reward_ineffective/overflow 两类）；`board_view` 奖励徽章键 category→cell_type（攻/守/医/爆/弱 占位字形——**类型图标预读/极性视觉归批 2，纯呈现**）；`status_slot_row` 补 sapped 图标键与语义（七行全映射）；`playtest_logger` battle_end/level_end 载荷去 remaining_items、reward 节点零载荷。
|
|
||||||
- "剩余安全格计数"注记：切片呈现层现无该计数器（safe_remaining 无 UI 消费方），无可改文案；呈现口径改动随批 2 一并处理。
|
|
||||||
|
|
||||||
**smoke/tools**：
|
|
||||||
- 删 `supply_scan.gd`（可选类供给跨种子扫描——对象已不存在）；`_smoke_supply` 整段删除。
|
|
||||||
- `smoke_all.gd` 大改（201→211 项）：删窗口接线族与窗口锚行段、等待期刷新探针改挂衰减行（结算段内 Waiting 相位刷新必拒）；`_smoke_power_interval` 收窄两区间行；`_smoke_damage_types` 标错断言改类型化负向兑付。**新增五段**：`_smoke_reward_identity_unit`（roll 恰一次/query_identity 投影/同格重复 grant 幂等/grant_clear 幂等/退役拒绝）、`_smoke_polarity_routing`（真实流多轮：挖安全格只出正向 + 每格 ≥1 行、挖危险格只出负向、标中正向 origin 指回危险格、标空归因 + 负向同格同批、封印兑付零泄漏）、`_smoke_negative_dictionary`（sapped 数据面在位 + effect_pool_map 收编 + 逐型负向直验：enrage/off_guard/sapped 效果行、heal 直伤 4、blast +2 层与 cap 溢出守恒）、`_smoke_resource_surface`（chain/dig resource 恒 true 含危险格、initial 恒 false、封锁格查询 null、未开危险格可查）、`_smoke_settlement_segments`（segment_order 五段冻结 + 行型封闭零残留 + 逐轮行相位单调 + 衰减/判定恰一段）。
|
|
||||||
- `reward_expectation.gd` 重写为类型频次测量（实测收敛权重涌现值 attack 25.3/defense 20.3/blast 20.3/heal 19.0/weaken 15.2%，封锁格泄漏 0）；`level_autoplay`/`monte_carlo`/`dump_battle`/`damage_probe`/`level_debug`/`level_monte_carlo`/`ui_probe`/`ui_click_probe`/`ui_layout_probe` 去窗口/库存面。**顺手修**：`monte_carlo.gd` 缺 AutoPlayer preload（HEAD 起即解析失败）已补。
|
|
||||||
|
|
||||||
**验证（本批实跑）**：冒烟 **211 项检查 0 失败**（回放断言全量保持——同 master_seed 同意图序列结算步骤流逐行相同）；四场景探针 ui_probe / ui_tune_probe / ui_click_probe（PROBE_SEED=7 与 91 双种子）/ ui_layout_probe 全 PASS；工具回归 reward_expectation / monte_carlo / dump_battle / damage_probe(boss) / level_debug / level_monte_carlo(N=5) 零脚本错误。
|
|
||||||
|
|
||||||
**表实一致注记（对 registry reward_table 条目）**：十一行逐字段一致；两处切片级补全登记——① 负向 heal/blast 行 registry 未定 reward_id，切片取语义名 `heal_backlash` / `ambush_double`；② blast 负向加层行 effect_id 恒空（registry flat 行口径）+ power 校验例外（power 不消费——伏击加层为独立兑付形态，见战斗结算 GDD 兑付形态表）。
|
|
||||||
|
|
||||||
**待拍板（本批登记）**：① 关卡奖励点节点内容（功能道具渠道 P1——归 关卡节点地图 定稿批）；② 已开格类型徽章与极性视觉（批 2——纯呈现）；③ "剩余未探索安全区域"计数呈现口径（切片现无该计数器，随批 2）。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2026-09-16 敌人技能池批（批 1+2+3 合并落地——设计权威 proposal-skill-pool.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 技能池节〕 v1.0；文档面 v0.5/v0.11/v0.5/v0.6/v0.3/v0.4 同批）
|
|
||||||
|
|
||||||
**机制**：确定性出招剧本（行为环：拍枚举/环指针/同种锁步/heavy_multiplier）整体退役，改技能池 + 开轮摇号——每轮轮次开始排除冷却中技能、按行序逐敌摇定本拍动作（behavior_roll 封闭流，每敌子流 scope = spawn_index×1000000+摇号序），战斗段按技能行兑现（伤害技 = 三乘法链〔基线×倍率→d20 掷点→甲效→伏击后置→池乘区→max(1,·)〕，增益技 = 施放行 cast + 状态授予〔0 伤害不掷不折不兑伏击〕）；两道闸 = 全技能各自冷却（普攻恒 0 锁死）+ 保底 M=4（连续 4 拍执行普攻 → 下拍必出特殊技、不受冷却限制）；死亡即不动手改"摇定后兑现前死亡 → 作废不进账"；拍结构保留（每结算每存活敌恰行动一次/行序/先作用后推进）。
|
|
||||||
|
|
||||||
**数据面**：新增 `skills.tres` + `skill_table.gd`（五行：普攻/突刺×1.5 cd2/蓄力 cd3/重击×2 cd3/硬化 cd4；pity_threshold=4；普攻倍率/冷却域校验锁死）；`enemy.tres` 六行 pattern/heavy_multiplier → pool（地精 9/1 · 熊地精 6/2/2 · 酋长 6/2/2，全部 provisional）；`status_effects.tres` 七→九行（empower 蓄力 +100 enemy_output 池 / fortify 硬化 +100 **enemy_defense 敌方防御池新词汇**——duration 2 = 1 个有效增益拍〔先兑付后衰减含施放当轮〕）；`settlement.tres` effect_pool_map 增 empower/fortify 两键。
|
|
||||||
|
|
||||||
**core 面**：`rng_service.gd` 增 behavior_roll 流（salt 0x85EBCA7758C24E15，黄金向量 m=42 scope0=426657203655691839 见冒烟；open_scope 显式 scope 取号门 + BEHAVIOR_SUBSTREAM_STRIDE）；新增 `core/skill_lottery.gd`（独立抽签器——输入可摇条目+子流、输出 skill_id，D9 封装纪律）；`unit_container.gd` 重写（实例池快照/冷却递减/待发动作/保底计数；query_beat/query_attack/advance/steps/pattern 退役）；`battle_orchestrator.gd` 开轮摇号编排 `_roll_round_actions()`（首轮同样摇、轮内刷新不重摇）+ 战斗段技能行兑现 + 主角攻击增敌方防御池乘区（Σ三分量后 ×(100+clamp(enemy_defense))/100）；`status_container.apply_effect` 增 duration_override（技能行 buff_duration 覆盖）；`config_db.gd` 挂技能表 + validate_skill_pool_links 跨表校验（悬空致命/每池恰一普攻/增益 ≤1）。
|
|
||||||
|
|
||||||
**呈现面（批 2）**：`presentation_snapshot` 敌人数组字段定稿（beat/ring_size/ring_index 拆除 → pending_skill/pending_type/pending_name + effects 敌方增益投影；池与权重不公开）；`enemy_card_view` 环点拆除（护甲行常驻）、意图徽标 = 摇定动画占位（普攻零表示 —/攻击系 ⚔/增益系 ✦）；`battle_log_view` 施放行 ✦ 格式化、伤害行具名技能；`status_slot_row` 图标键补 empower ⇧ / fortify ▣（九行全映射）；`settlement_snapshot` 敌方 beat 键 → pending_skill；damage_probe 拍名重建改 pending_skill 口径。
|
|
||||||
|
|
||||||
**smoke（211→263 项）**：行为环断言全部改型（行相位 cast、fresh 池采样、削弱触底/AC12 采样改多种子扫描）；新增 `_smoke_skill_pool` 六项验收（proposal §8）：数据面（池模板/普攻锁死/空池不可能）、同种子回放逐位复现 + 单敌轨迹独立复放（D3 多实例逐轮记录 vs 只喂该敌子流的独立重放器逐位对照）、EV 抽样对锚（×5000 拍）、死亡打断作废（D2 特殊技种子 + hero_atk 999 先手击杀零行动行 + 不进账）、加载校验拒绝（悬空/池构成/普攻锁死/倍率域/权重域/空池）。
|
|
||||||
|
|
||||||
**验证（本批实跑）**：冒烟 **263 项检查 0 失败**；四探针 ui_probe / ui_tune_probe / ui_layout_probe / ui_click_probe（种子 7、23）全 PASS；damage_probe（boss/level 全 PASS 含施放行）、defense_scan、monte_carlo 工具零脚本错误。
|
|
||||||
|
|
||||||
**EV 抽样读数（×5000 拍，含闸长期速率 vs 静态锚）**：地精 1.1056（静态 1.05——保底闸把突刺率从自然 10% 抬到 ~22%，登记难度曲线重锚）/ 熊地精 0.9998（结构守恒恒 1）/ 酋长 1.0236。
|
|
||||||
|
|
||||||
**文档/registry 同批（批 3）**：敌人系统 v0.5（技能池章节重写）/ 战斗结算 v0.11（随机口径三处/三乘法链/施放行/敌方防御池/AC 措辞四处）/ 增益状态 v0.5（九行 + 敌方防御池；顺手清偿 v0.4 挂起的 sapped 文档同步）/ 难度曲线与Boss v0.6（曲线纪律/Boss 专属池/技能池投值表 + EV 实测登记）/ 战斗表现 v0.3 / HUD框架 v0.4 / 数据配置（敌人表措辞 + 技能表行）/ 03-内容规模 / 02-系统清单 / 关卡节点地图 / ux battle.md（改型注记）/ architecture.md（单位容器 API 面）/ registry（rng/skill 新条目/enemy/status_effect/settlement/术语七词条/修订记录）/ 06-待办清单（改型"单拍行为环体验验证"、收编关闭"行为环废除与蓄力拍退役"、新增 P1 五项 + P2 技能图鉴）。
|
|
||||||
|
|
||||||
**实现决策登记（提案未定处的自行拍板，按封装纪律报告）**：① 保底 M 载体 = 技能表全局单字段 pity_threshold（不分敌种，难度曲线单旋钮）；② 冷却"施放后连续 N 拍不可摇中"的实现 = 摇号按当前冷却值排除、递减在其后（与提案"递减→排除"的可摇集合逐拍恒等）；③ 增益持续与技能冷却两计时器 = apply_effect duration_override 通道；④ 敌方防御池乘区落点 = 主角攻击 Σ三分量后（hero_offense 现行走普通分量直乘的切片现状不动——登记遗留）；⑤ 摇号器类名 SkillLottery（core/skill_lottery.gd）。
|
|
||||||
|
|
||||||
## 2026-09-19 技能池新效应词汇批（用户拍板——设计权威 proposal-status-vocabulary.md〔提案已吸收退役 git a6833b6a——现行事实源=敌人系统.md 词汇表/增益状态.md〕 v1.0）
|
|
||||||
|
|
||||||
**三词收敛两词**：妨害技（debuff 新类型）+ 必中附加分量（rider_mult，"固定值伤害"改形）；多段命中经用户拍板退役（无防御磨损体系，无对照机制）。**实装面 = 仅 L2 Boss 蛛化卓尔精灵，其余敌种不动**：
|
|
||||||
- 毒爆 venom_burst + `rider_mult = 0.75`——必中毒分量 = max(1, floor(atk × 0.75))（atk 开战掷定 2–4 → 毒 1–3 点），后置加法、必中全额、不进乘区不出暴击；伤害行 payload 增 `rider` 键 + 行文本「＋附加N（必中）」。
|
|
||||||
- 新技能行**蛛网束缚 web_snare**（debuff → off_guard 失衡，duration 2 = 1 有效结算，冷却 4，池权重 2 → 卓尔池 6/2/2/2 全 provisional）——0 伤害施放行，状态按 target_side 落主角（掷点阈值 10 → 8）。
|
|
||||||
- 结构面：SkillTable type 枚举 +debuff；池纪律 +每池妨害 ≤1；施放类 side 守卫（buff→enemy / debuff→hero，`validate_skill_pool_links` 增 status_table 显式入参——装载序修正）；意图徽标 +妨害系 ☠（紫）。
|
|
||||||
- 验证：冒烟 306 项 0 失败（+新探针 `_smoke_debuff_rider`：毒爆行逐拍精确复算 / rider 键封闭 / 蛛网束缚落主角端到端 / 六项加载校验拒绝）+ 四探针 PASS；800 局模拟试玩（两关 × 20 种子 × 双画像）——L2 基线通关 90%→80%、死因全部集中 Boss（设计方向生效），L1 零行为变更回归一致（65%/85%）。
|
|
||||||
- 顺手收口：smoke_all `variant_pool(1, ["dungeon"])` → `"dungeon"`（并行 board_type 批签名 Array→String 的漏网同步——此前该断言被 SCRIPT ERROR 静默吞掉）；analyze_playtest.py 反事实重算 +rider 识别。
|
|
||||||
|
|
||||||
## 2026-09-21 冒险结构实现批（三关正式序列生效——AdventureRunner + LevelRunner 账本外置 + AdventureTable 建表）
|
|
||||||
|
|
||||||
**主入口升级**：「▶ 开始冒险（三关连探：地精洞窟 → 幽暗地域 → 灰矮人矿城）」——一条命走完三关的完整 Roguelike 冒险；`▶ 测试直入口 · 第二关/第三关` 保留单关试玩模式，L1 单关直入口随批取消（冒险首关即 L1）。
|
|
||||||
|
|
||||||
**冒险级语义**（设计权威 = 冒险结构.md v0.6）：主种子恰一次注入（冒险内不重播种，同种子同操作序列逐位可复现）；生命账本跨关同账（战后回写、恢复点按比例封顶、大奖励回满）；GP 钱包跨关延续、冒险收束清零；统一冒险加算区（商店购买与大奖励同账）；非末关通关发大奖励（上限提升 +10 读 adventure.tres、血回满、钥石 +10），末关不发上限提升、钥石照记；任意战斗倒下 = 冒险失败；结算屏出冒险摘要五件事（打穿没有/通关几关/止步第几关/钥石合计/主种子）。
|
|
||||||
|
|
||||||
**验证**：冒烟 437→482 项 0 失败三闸全过（冒险表 +4 / API 闸 +8 / 冒险验收 +33：表覆盖义务、满配通关、种子复现、大奖励恰 2 次与覆盖值传播、败北线两种子扫描、重复宣布拒绝、GP 跨关延续、加算区同账、恢复数学、放弃两态）；MC 回归零行为变更（run_level 旧路径同种子逐位一致）。
|
|
||||||
|
|
||||||
## 2026-09-21 元进度实现批（跨局循环闭合——MetaTable + MetaProgression + 营地 + 跨局注入）
|
|
||||||
|
|
||||||
**跨局成长首批落地**（设计权威 = 元进度.md v1.2）：「存档在变厚」成为玩家可感的现实——冒险收束入账（大奖励渠道 + Boss 首杀/重复杀两档，明细在结算屏可归因）、营地消费、余额 HUD 常驻、永久强化在下一局开局注入。
|
|
||||||
|
|
||||||
**玩法面**：首页新增「营地 · 永久强化」入口（三柜台：属性锻造三档 flat 直购可重复升级、几何递增定价；秘宝匣六件按累计通关次数解锁——局内效果排 Alpha 魔法道具重设计批；奖励格图鉴占位锁定）；A 区顶栏钥石余额常驻；冒险结算屏追加钥石入账明细（大奖励 / 逐关 Boss 首杀或重复 / 工坊新解锁）。买强化 → 下一局开局即生效（表值 + 永久强化 flat + 冒险加算区，再乘调整板百分比）。
|
|
||||||
|
|
||||||
**技术面**：`data/tables/meta.tres` 四行族（forge_products / boss_keystone / workshop_items / conversion）+ `core/meta_progression.gd` 账本服务（Core 层零 UI 零信号）；SaveManager.apply_adventure_summary 增第二参 boss_drops（缺省 [] 零行为兼容，摘要元素附副本）；AdventureRunner.start_adventure 增 params.hero_override（缺省全零 = 白板）→ LevelRunner base_override。**数值全 provisional 归元进度设计批配读数**（骨架先行先例 = GP+商店房批）。
|
|
||||||
|
|
||||||
**验证**：冒烟 522→549 项 0 失败三闸全过（表结构 +4 / 定价与购买 +7 / 注入与白板 +8 / 入账工坊摘要 +8）；四探针全 PASS（ui_probe 营地开合/禁用态、click_probe 营地购买合成点击全路径——隔离存档换注保确定性，禁碰真实档）；白板成立 = 空参数 = 零强化参数 = 纯表值三轴逐位一致。
|
|
||||||
|
|
||||||
## 2026-09-24 伤害管线单据化批（伤害对象抽象补全——伤害控制器统一入口）
|
|
||||||
|
|
||||||
**架构面**：伤害此前无对象抽象——五族伤害来源（主角先手 / 敌方伤害技 / 棋盘克制直伤 / 群伤 / 反噬地形）在战斗编排器内各自内联组装管线。本批新建 `core/damage_controller.gd`（伤害单据 + 唯一兑付管线）：九栏单据、五种兑付配方封闭枚举；battle_orchestrator 六调用点退化为开单点（流程决定何时开单给谁开单，单据怎么算归控制器），掷点 / 折扣 / 暴击 / 克制 / 池乘区 / 下限 / 攻击行文本算术全部迁入控制器（`_defender_ac` / `_clamped_pool` 留薄委托供快照面与冒烟白盒直呼）；unit_container 新增 `unit_died` 死亡事件信号（单位自行宣布死亡——怪死其未结单据作废〔死亡即不动手〕、主角死兑付终止，Game Over 仍归判定段读数）。
|
|
||||||
|
|
||||||
**结账时机双模式（2026-09-24 用户三裁决之二三）**：目标 = 结账时刻照规则看现场解析（最前存活敌 / 主角 / 全体存活敌），开单不冻结对象；现行 = 段界结账（授予段尾 / 清图批同步点 / 战斗段尾统一兑现），开单即结保留为回切结构位（控制器 policy 常量一行切回＝逐位还原迁移前行为）。同一输入两模式结果可不同（兑现时机语义差异），历史基线读数自本批以段界结账口径为准（重测归曲线调参批）。
|
|
||||||
|
|
||||||
**验证**：冒烟 557 项 0 失败双模式全绿三闸过；A/B 对拍探针四配置（L1/L2 × 双种子）两模式各自同种子逐位确定、四配置全部真实分岔（行数两两恒等、纯次序位移——分岔面 = 伤害行攒批位移与治疗满血判定时机，符合段界结账语义）；三场景探针全 PASS。设计权威 = 战斗结算.md v0.24「伤害单据与伤害控制器」节。
|
|
||||||
|
|
||||||
## 2026-10-06 地图伤害账殿后批（案C，用户裁——「主角先手」歧义质询触发；设计权威 = 战斗结算.md v0.26）
|
|
||||||
|
|
||||||
**裁决**：每轮结算内三者顺序定死 = ①授予段兑非伤害账（资源/增益/治疗/行动点/GP/警觉）→ ③战斗段「主角先基础攻击 → 敌人按生成序逐个还手 → 地图伤害账殿后」→ ④衰减 → ⑤判定。授予段不再当场兑付任何伤害——全部伤害形态单据（爆裂/直伤/反噬/地形变异/战封印军规/熔火反噬/惊巢反制/魔能共鸣/清障炸药等）暂存，战斗段怪物还手后按授予段事件序补提交统一结账；主角死于敌方还手 → 暂存单整体不兑，逐单留「未生效（主角已倒下）」行（载荷 forfeit=hero_down）。
|
|
||||||
|
|
||||||
**切片落点**：`battle_orchestrator.gd` 暂存闸 `_defer_board_damage`/`_deferred_board` + `_submit` 案C 分流（sync 同闸——清图批一致延后）+ `_outcome_of`（暂存单按「将兑付」回报——完美第二份/高光份数依据开单时点事实）+ 授予段四处直提改走闸 + 战斗段末补提交块（死亡守卫+留痕）；授予段界 flush 保留（对空队 no-op 防御位）；`smoke_all.gd` 行相位分类器换代（damage 恒战斗段/reward_ineffective 按 forfeit 分流）+ 先手断言收紧（「存在或授予段终局」→「必存在」）+ 新增案C 段内序断言（地图账不得先于主角先手或插入敌方还手中间）。
|
|
||||||
|
|
||||||
**验证**：冒烟 783 项 0 失败三闸过 + run_all 17 套全绿 + probe_gate（ui_input/ui_struct/ui_contrast/--click 行为走查）全绿、残留 0。**旧行为 MC 锚全数作废**（死亡短路语义变化：授予段伤害不再能致死短路先手；读数重采归数值批）。
|
|
||||||
|
|
||||||
## 2026-10-10 秘宝匣改名（文档面同步——2026-10-10 天赋树设计会话裁）
|
|
||||||
|
|
||||||
营地柜台「道具工坊」正名「秘宝匣」（树上解锁节点与营地柜台同名）：本文档现行正文扫改完毕；**代码标识符（workshop_items 等）与界面文案暂未动**——柜台 UI 名/表行语义连带面归 design/gdd/06-待办清单.md「天赋树结构重构批」实装批办理。
|
|
||||||
|
|
||||||
## 2026-10-11 专长实装批（迭代 20——奇物重设计 T0-T10 全落）
|
|
||||||
|
|
||||||
**换代面**：feats.tres 整表换代（旧 27 件退役→重设计 29 行=基础 27+迁入淬毒刃纹/封印爆裂——订阅行 on/when/do 四级 rarity+cap）；效果引擎词表扩签（事件 18/效果类型 30/事实 18/算子 +mod_eq——heal/ac_bonus/damage_reduce/bonus_delta/blast_scaled/preview_area/target_attack_bonus 七新类型+adventure 域计数器跨战账本）；池结构案D（四级档位 70/25/9/0=104+曝光槽 2+1+概率上限解耦案②+Boss 按档配比加权抽取）；凭证五件入池（刷新券 F-1 修复/储备金袋/同调电池〔choose_battery_target 玩家点选〕/时沙/完美保险）；流派标签/档位激活机制退役（战斗路径 FeatsEngine 求值与 rider_tier 注入摘除；HUD 特性段呈现随 2026-10-12 呈现修复批换代——逐流派聚合行退役改逐件行「件名 ×N」、卡面摘族名，原聚合行在新 29 行下的空键兜底僵尸呈现随之消解）。
|
|
||||||
**验证**：冒烟 864/0+run_all 21 套+probe_gate 全绿；MC 同种子重放 30 局逐位复现；新基线 normal/off 100 局通关 0%（master 对照同为 0%=零配基线本相，止步分布 90/10→93/7 可归因曝光槽）。设计权威=奇物.md（反哺点清单见 design/qa/iter20-实现报告-2026-10-11.md）。
|
|
||||||
|
|
||||||
## 2026-10-12 迭代 21 天赋树实装批（U0——需求卡片 v1.7；设计权威 = 天赋树.md v0.8）
|
|
||||||
|
|
||||||
**结构换代 33→12 节点**：脊柱 2（生命/命中淬炼一线一节点 cap4——攻/护淬炼线随攻防所有权切分砍除，攻唯一入口=锻造工坊武器路线、AC 唯一入口=甲路线）+ 锻造脉 2（forge_workshop 钥匙 free 无前置 + easter_ley 彩蛋〔effects 摘攻/护分量〕）+ 钥石脉 2（秘宝匣/刷新升级）+ 同调脉 6（同调位 1/2/3——socket1 改根节点无前置 + Fork 3 单行双态）。schema 换代：FORK_GROUPS 4→3（fg_mastery 退役）/ RULE_KEYS 2→6 / row 字段退役（行门槛主语=节点第 N 级需全树总投入 ≥4×(N−1)）/ requires 只留点亮前置（R1 裁撤案执行）。
|
|
||||||
|
|
||||||
**六键真效果**：开局姿态窗=每关首战首轮（FACTS 扩签 battle_index=关卡域战斗序）；危险直觉锋=踩雷减半·守=标错返还 AP（EVENTS 扩签 seal_missed、契约 12 去重闸语义）——两组每关限次（adventure_counters domain=adventure、按关重置）；财富之道聚=战斗掉落 GP 入账前×1.5、散=商品购买价×80%（双计价单点，刷新价不折）。数值全 provisional 归 M4。
|
|
||||||
|
|
||||||
**退役删除**：属性锻造柜台全家（buy_forge/forge_flat/meta_forge_row/forge_products 行族/forge_levels 存档域/营地·暂停层·生涯三投影）；migrate_tree 三体系迁移（旧档=tree_struct 标记检测破坏性废弃重置，禁迁移折算）；attunement_growth 谓词表（同调位槽位判定源切树点亮数——Q2 裁甲）。
|
|
||||||
|
|
||||||
**营地统一**：四柜台并排（树淬炼=树脊柱界面形态主界面/锻造工坊柜台钥匙门+零交互占位面板/秘宝匣柜台钥匙门+工坊六行+同调装配段+Y 升级行迁入/图鉴常开）；刷新升级双入口同账（树上 ks_refresh 路由 buy_attune_refresh）。
|
|
||||||
|
|
||||||
**验证**：冒烟 886/0（基线 864/0+存量红修复——fx_reveal 三处空 source_class 补标签，a57489e9 落地件 51 行脚本错误清零）+ run_all 22 套（新增 tree_rules_v11 六键闭集校验）+ probe --click 全绿（树购买/双态切换点击路径换代）；V10 行为段=引擎直构+编排授予段直注（守侧五场景/聚散同种子配对/限次生命周期）。存量红修复与帐目细节见 design/qa/iter21-实现报告-2026-10-12.md。
|
|
||||||
|
|
||||||
## 2026-10-12 迭代 23 锻造工坊实装批（U0——需求卡片 v1.2；设计权威 = 锻造工坊.md v0.6）
|
|
||||||
|
|
||||||
**六路线行族新建**：新表 `forge.tres`（schema `forge_table.gd`/ForgeTable——默认两轴常驻持有 + routes 六行；ConfigDB `forge_*` 访问器：forge_route/forge_routes/forge_default_attack_type/forge_default_armor_type/forge_weapon_route_by_type/forge_armor_route_by_type）。路线 id=sword/spear/staff/light/heavy/ward（甲路线 id=甲型值本身）；provisional 沿锚表：cap 5/每级增量统一 +1/基础价 20×150%^n（20/30/45/67/101）/一次性解锁价 200/甲型基础 AC 10-12-9/初始持有 sword+light/并联双通道前置 spear·staff←sword、heavy·ward←light。
|
|
||||||
|
|
||||||
**两根类型轴所有权移交**：`hero.tres` armor_type/attack_type 两字段删除（schema 同步删）——默认值归 forge.tres 常驻持有（normal/light）；选中态写存档域 forge_routes、冒险开始经参数面注入。单位快照读取面=unit_container.spawn 新两参（空串=锻造配置默认值回退，行为逐位连续）；冒烟 hero_attack 行类型键主语换代为 forge_default_attack_type()。
|
|
||||||
|
|
||||||
**写口族与注入链**：MetaProgression 锻造写口（契约 9 唯一）——forge_buy_level（几何价扣钥石即盘）/forge_buy_unlock（一次性解锁价，已解锁含派生=拒绝零收费）/forge_select_weapon·armor（免费切换只受理已解锁）/forge_route_unlocked（派生单点：初始持有∨直购∨练满前一档）。hero_override 公式换代（FORGE_ROUTE_BONUS 预留常量退役）：atk=当前选中武器攻击加值+树 flat、armor_class=当前甲 AC 加值+树 flat、max_hp=树 flat；main.build_adventure_params +attack_type/armor_type 两键 → AdventureRunner 参数面快照（契约 8 冒险开始锁死）→ LevelRunner.set_hero_axes → enc → spawn；入战 AC 三层=甲型基础 AC（选中甲路线 base_ac）+甲路线等级加值+局内加算区。
|
|
||||||
|
|
||||||
**存档 v7**：SAVE_FORMAT_VERSION 6→7 + 新域 forge_routes（{levels 六键/unlocked 直购清单/weapon/armor 选中}，无特效域）+ _migrate_v6_v7 空迁移（缺键补齐=初始持有态）+ 访问器组；旧档缺键补齐零折算。
|
|
||||||
|
|
||||||
**营地工作间**：锻造工坊柜台占位面板→两区六路线行板（武器锻造区/护甲锻造区；件名+Lv+解锁态双通道文案+锻造/解锁/选中钮；余额联动禁用；锁定态零行板零购买路径——占位纪律延续）；三意图信号 forge_buy/unlock/select_requested 经 camp_shop_presenter 走写口唯一路径。
|
|
||||||
|
|
||||||
**验证**：冒烟 938/0（基线 898/0+40 锻造断言）+ run_all 24 套（新增 forge_table_test 41 断言+forge_workbench_test 12 断言）+ probe --click/--full 全绿 + render_gate + doc 三闸/熵增对基线零新增 + MC 同种子配对零漂移。实现报告=design/qa/iter23-实现报告-2026-10-12.md。
|
|
||||||
+26
-30
@@ -12,12 +12,12 @@ const PHASE_IDLE := "Idle"
|
|||||||
const PHASE_ACTIVE := "Active"
|
const PHASE_ACTIVE := "Active"
|
||||||
const PHASE_WAITING := "Waiting"
|
const PHASE_WAITING := "Waiting"
|
||||||
|
|
||||||
# 相位轴（P6 状态机——code-review 2026-09-29 P2-2）：内部 enum + match，外部 phase getter 保持
|
# 相位轴：内部 enum + match，外部 phase getter 保持
|
||||||
# String 面（presentation_snapshot 与冒烟链的 "Idle"/"Active"/"Waiting" 对照契约零变化）。
|
# String 面（presentation_snapshot 与冒烟链的 "Idle"/"Active"/"Waiting" 对照契约）。
|
||||||
enum Phase { IDLE, ACTIVE, WAITING }
|
enum Phase { IDLE, ACTIVE, WAITING }
|
||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
# 相位与账本只读出口（E5 封装收口 2026-09-13）：外部读取经 getter-only 属性（架构文档
|
# 相位与账本只读出口：外部读取经 getter-only 属性（架构文档
|
||||||
# "ap/rap/phase 只读" 的机制化），写入只经 notify_* / request_* 方法通道。
|
# "ap/rap/phase 只读" 的机制化），写入只经 notify_* / request_* 方法通道。
|
||||||
var _phase: int = Phase.IDLE
|
var _phase: int = Phase.IDLE
|
||||||
var phase: String:
|
var phase: String:
|
||||||
@@ -33,17 +33,16 @@ var last_round_end: Dictionary[Variant, Variant]:
|
|||||||
get: return _last_round_end
|
get: return _last_round_end
|
||||||
var _settlement_consumed := false # AC-14 门：notify_settlement_done 消费后才受理 round_start
|
var _settlement_consumed := false # AC-14 门：notify_settlement_done 消费后才受理 round_start
|
||||||
var _next_round_mode := "" # 调试观测量（同板续轮 / 换新图）
|
var _next_round_mode := "" # 调试观测量（同板续轮 / 换新图）
|
||||||
var _pending_ap_delta := 0 # 下轮行动点修正排队（格面资源八型批 2026-09-20——action 型 ±1 排队，轮开始兑现后清零）
|
var _pending_ap_delta := 0 # 下轮行动点修正排队（action 型 ±1 排队，轮开始兑现后清零）
|
||||||
# 蓄力流运行态（迭代 12 T5 → 内容数据驱动扩展批 T3 换代：旧 feat_ap_carry/feat_dig_extra 注入封印
|
# 蓄力流运行态：转蓄力=round_end grant_ap(mode:transfer) 订阅（finish_round_stop 定夺）、
|
||||||
# 退役——转蓄力=round_end grant_ap(mode:transfer) 订阅（finish_round_stop 定夺）、深挖对价=dig_paid
|
# 深挖对价=dig_paid counter_spend 订阅（request_dig 施加面）；charge_layers=蓄力层账本
|
||||||
# counter_spend 订阅（request_dig 施加面）；charge_layers=蓄力层账本）
|
|
||||||
var _charge_layers := 0
|
var _charge_layers := 0
|
||||||
var charge_layers: int:
|
var charge_layers: int:
|
||||||
get: return _charge_layers
|
get: return _charge_layers
|
||||||
# 效果引擎（内容数据驱动扩展批 T1——dig_paid/charge_full 发射面；round_end 转存决策面）
|
# 效果引擎（dig_paid/charge_full 发射面；round_end 转存决策面）
|
||||||
var _fx: EffectEngine = null
|
var _fx: EffectEngine = null
|
||||||
var _last_stop_ap := 0 # 停手侧剩余 AP 记账（转存决策移至 round_end 发射点——grant_ap(transfer) 订阅定夺）
|
var _last_stop_ap := 0 # 停手侧剩余 AP 记账（转存决策在 round_end 发射点——grant_ap(transfer) 订阅定夺）
|
||||||
var _ap_exhausted_last := false # 上轮 AP 耗尽封印（迭代 20 T1——一滴不剩 round_start when 面）
|
var _ap_exhausted_last := false # 上轮 AP 耗尽封印（一滴不剩 round_start when 面）
|
||||||
|
|
||||||
|
|
||||||
func set_fx(fx: EffectEngine) -> void:
|
func set_fx(fx: EffectEngine) -> void:
|
||||||
@@ -67,7 +66,7 @@ func _cost(kind: String) -> int:
|
|||||||
var ae = db.action_economy
|
var ae = db.action_economy
|
||||||
match kind:
|
match kind:
|
||||||
"dig":
|
"dig":
|
||||||
return ae.dig_ap_cost # 基础挖格成本恒表值（钻头对价挂付费开掘侧——2026-10-04 缺陷修复）
|
return ae.dig_ap_cost # 基础挖格成本恒表值（钻头对价挂付费开掘侧）
|
||||||
"seal_place":
|
"seal_place":
|
||||||
return ae.seal_place_ap_cost
|
return ae.seal_place_ap_cost
|
||||||
"move":
|
"move":
|
||||||
@@ -87,8 +86,7 @@ func try_spend(action_kind: String) -> bool:
|
|||||||
|
|
||||||
|
|
||||||
# 排雷玩法 挖掘专用：chain_size = 连锁附加格数（不含首格）；clears_map = 本次动作后全图安全格开完。
|
# 排雷玩法 挖掘专用：chain_size = 连锁附加格数（不含首格）；clears_map = 本次动作后全图安全格开完。
|
||||||
# 深挖钻头付费开掘（内容数据驱动扩展批 T3——dig_paid counter_spend 订阅施加面，2026-10-04 缺陷
|
# 深挖钻头付费开掘（dig_paid counter_spend 订阅施加面）：按序消耗族——AP 富余（≥基础+对价）时本动作付全价并积本轮付费计数（效果引擎
|
||||||
# 修复口径不变）：按序消耗族——AP 富余（≥基础+对价）时本动作付全价并积本轮付费计数（效果引擎
|
|
||||||
# 计数器=授予段追加产出配额取数面）；AP 不足全价时 fallback 降级只付基础 1 照常开格、不积计数
|
# 计数器=授予段追加产出配额取数面）；AP 不足全价时 fallback 降级只付基础 1 照常开格、不积计数
|
||||||
# ——持有钻头永不锁死普通挖格（散件保底 B-2）。
|
# ——持有钻头永不锁死普通挖格（散件保底 B-2）。
|
||||||
func request_dig(chain_size: int, clears_map: bool) -> bool:
|
func request_dig(chain_size: int, clears_map: bool) -> bool:
|
||||||
@@ -96,9 +94,9 @@ func request_dig(chain_size: int, clears_map: bool) -> bool:
|
|||||||
_reject("phase")
|
_reject("phase")
|
||||||
return false
|
return false
|
||||||
var cost := _cost("dig")
|
var cost := _cost("dig")
|
||||||
# dig_paid 发射+施加（内容数据驱动扩展批 T3——付费开掘发起、动作经济闸收对价前：
|
# dig_paid 发射+施加（付费开掘发起、动作经济闸收对价前：
|
||||||
# counter_spend 命中=尝试加收对价并积计数；资源不足走 fallback/耗尽即止=只付常规基础对价。
|
# counter_spend 命中=尝试加收对价并积计数；资源不足走 fallback/耗尽即止=只付常规基础对价。
|
||||||
# 迭代 20 T1——counter_add〔双管镐 付费挖格计数〕/ grant_ap〔每第 2 次返 1 AP——对价减免，
|
# counter_add〔双管镐 付费挖格计数〕/ grant_ap〔每第 2 次返 1 AP——对价减免，
|
||||||
# mod_eq 闸在行 when〕同面施加）
|
# mod_eq 闸在行 when〕同面施加）
|
||||||
var dig_refund := 0
|
var dig_refund := 0
|
||||||
if _fx != null:
|
if _fx != null:
|
||||||
@@ -153,16 +151,14 @@ func _spend_and_arbitrate(action_kind: String, clears_map: bool) -> bool:
|
|||||||
|
|
||||||
|
|
||||||
# 停手：剩余 AP 1:1 转存 RAP；行动经济 直发 stopped 路径 round_end（双发射源）。
|
# 停手：剩余 AP 1:1 转存 RAP；行动经济 直发 stopped 路径 round_end（双发射源）。
|
||||||
# 整备军备改写（迭代 12 T5——feat_ap_carry=true 时剩余 AP 转蓄力层〔上限 3〕替代 RAP 转存：
|
# 转蓄力层〔上限 3〕替代 RAP 转存——「不动也是行动」；cleared 分支 AP 恒清零维持作废语义。
|
||||||
# 「不动也是行动」——cleared 作废口径改写的停手侧承载；cleared 分支 AP 恒清零维持既有作废语义）。
|
# 本方法只记账——剩余 AP 存 _last_stop_ap 后清零，转存决策在 round_end 发射点
|
||||||
# 内容数据驱动扩展批 T1：本方法改记账制——剩余 AP 存 _last_stop_ap 后清零，转存决策移至
|
# finish_round_stop（grant_ap(mode:transfer) 订阅定夺）。
|
||||||
# round_end 发射点 finish_round_stop（grant_ap(mode:transfer) 订阅定夺；双轨期旧封印 feat_ap_carry
|
|
||||||
# 并行生效，行为与迁移前逐位一致）。
|
|
||||||
func request_stop() -> bool:
|
func request_stop() -> bool:
|
||||||
if _phase != Phase.ACTIVE:
|
if _phase != Phase.ACTIVE:
|
||||||
_reject("phase")
|
_reject("phase")
|
||||||
return false
|
return false
|
||||||
# dig_stop 发射+施加（迭代 20 T1——停手挂点〔弃图兑换〕：剩余 AP 随载荷外发，counter_add
|
# dig_stop 发射+施加（停手挂点〔弃图兑换〕：剩余 AP 随载荷外发，counter_add
|
||||||
# value_event="ap_left" 取值面〔值=停手时刻真实余量〕；发射先于记账清零）
|
# value_event="ap_left" 取值面〔值=停手时刻真实余量〕；发射先于记账清零）
|
||||||
if _fx != null:
|
if _fx != null:
|
||||||
for h in _fx.dispatch("dig_stop", {"ap_left": _ap}):
|
for h in _fx.dispatch("dig_stop", {"ap_left": _ap}):
|
||||||
@@ -178,14 +174,14 @@ func request_stop() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 储备池注入（迭代 20 T4——储备金袋凭证：战首 RAP +N，节点级一次性；任意相位受理=战首注入时 Idle/Active 均合法）
|
# 储备池注入（储备金袋凭证：战首 RAP +N，节点级一次性；任意相位受理=战首注入时 Idle/Active 均合法）
|
||||||
func grant_reserve_ap(n: int) -> void:
|
func grant_reserve_ap(n: int) -> void:
|
||||||
_rap += maxi(0, n)
|
_rap += maxi(0, n)
|
||||||
|
|
||||||
|
|
||||||
# 轮末停手转存决策（round_end 发射点调用——编排器授予段尾）：transfer=true=剩余 AP 转蓄力层
|
# 轮末停手转存决策（round_end 发射点调用——编排器授予段尾）：transfer=true=剩余 AP 转蓄力层
|
||||||
# （上限 3，整备军备面）；false=按转存率转存 RAP（transfer_pct 百分比口径缺省 100=1:1 与旧逐位一致；
|
# （上限 3，整备军备面）；false=按转存率转存 RAP（transfer_pct 百分比口径缺省 100=1:1；
|
||||||
# 迭代 22 秘宝批 T3——储备罐 rap_transfer_mult magnitude 125=1.25:1，整数除法向下取整=每 4 AP 多转 1）。
|
# 储备罐 rap_transfer_mult magnitude 125=1.25:1，整数除法向下取整=每 4 AP 多转 1）。
|
||||||
# 非停手轮（cleared/耗尽）_last_stop_ap=0 两分支均零操作。转蓄后达上限的沿发 charge_full（R6 框架先行——现无订阅者）。
|
# 非停手轮（cleared/耗尽）_last_stop_ap=0 两分支均零操作。转蓄后达上限的沿发 charge_full（R6 框架先行——现无订阅者）。
|
||||||
func finish_round_stop(transfer: bool, transfer_pct: int = 100) -> void:
|
func finish_round_stop(transfer: bool, transfer_pct: int = 100) -> void:
|
||||||
if transfer:
|
if transfer:
|
||||||
@@ -198,7 +194,7 @@ func finish_round_stop(transfer: bool, transfer_pct: int = 100) -> void:
|
|||||||
_last_stop_ap = 0
|
_last_stop_ap = 0
|
||||||
|
|
||||||
|
|
||||||
# 轮内刷新（2026-09-12 方案 A 用户拍板；等待期通道 2026-09-15 用户拍板整体移除）：唯一入口 =
|
# 轮内刷新：唯一入口 =
|
||||||
# Active 相位——仅扣 RAP，相位与 AP 均不动。刷新不打断轮次、不触发结算；换图编排归 战斗结算
|
# Active 相位——仅扣 RAP，相位与 AP 均不动。刷新不打断轮次、不触发结算；换图编排归 战斗结算
|
||||||
# （retire + install 立即执行，玩家同轮继续挖新图）。决策主体 = 玩家（经 HUD框架发起）纪律不变。
|
# （retire + install 立即执行，玩家同轮继续挖新图）。决策主体 = 玩家（经 HUD框架发起）纪律不变。
|
||||||
func request_refresh() -> bool:
|
func request_refresh() -> bool:
|
||||||
@@ -221,9 +217,9 @@ func notify_settlement_done(next_round_mode: String) -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 下轮行动点修正排队（格面资源八型批 2026-09-20）：action 型正负行结算期调用，同轮多次授予累加；
|
# 下轮行动点修正排队：action 型正负行结算期调用，同轮多次授予累加；
|
||||||
# 相位无关（授予发生在结算段，此时本类可能处于 ACTIVE/WAITING 任一相位）
|
# 相位无关（授予发生在结算段，此时本类可能处于 ACTIVE/WAITING 任一相位）
|
||||||
# 第 9 API（registry 行动经济×① 接口漂移预授权——迭代 7 T2 秘宝内容批落位）：ap_grant 道具的
|
# 第 9 API（registry 行动经济×① 接口漂移预授权）：ap_grant 道具的
|
||||||
# 当轮行动点加量（GDD「加行动点效果给当轮」——区别于 queue_ap_delta 的下轮排队语义）。Active 受理、
|
# 当轮行动点加量（GDD「加行动点效果给当轮」——区别于 queue_ap_delta 的下轮排队语义）。Active 受理、
|
||||||
# 无上限域、零随机；使用道具本身零扣费（成本在获取时已付——捡道具格不出战斗奖励）。
|
# 无上限域、零随机；使用道具本身零扣费（成本在获取时已付——捡道具格不出战斗奖励）。
|
||||||
func grant_ap(amount: int) -> bool:
|
func grant_ap(amount: int) -> bool:
|
||||||
@@ -262,7 +258,7 @@ func notify_combat_end() -> bool:
|
|||||||
_reject("phase")
|
_reject("phase")
|
||||||
return false
|
return false
|
||||||
_phase = Phase.IDLE
|
_phase = Phase.IDLE
|
||||||
_rap = 0 # RAP 战斗域清零（用户拍板；HUD框架可见反馈义务）
|
_rap = 0 # RAP 战斗域清零（HUD框架可见反馈义务）
|
||||||
_ap = 0
|
_ap = 0
|
||||||
return true
|
return true
|
||||||
|
|
||||||
@@ -273,11 +269,11 @@ func _finish_round(path_tag: String, continuation_hint: String) -> void:
|
|||||||
assert(path_tag != "ap_exhausted" or _ap == 0, "耗尽轮剩余行动点恒为 0（实现层断言兜底）")
|
assert(path_tag != "ap_exhausted" or _ap == 0, "耗尽轮剩余行动点恒为 0（实现层断言兜底）")
|
||||||
assert(path_tag != "cleared" or _ap == 0, "清图轮剩余行动点当场清零（不进储备池）")
|
assert(path_tag != "cleared" or _ap == 0, "清图轮剩余行动点当场清零（不进储备池）")
|
||||||
_last_round_end = {"path_tag": path_tag, "continuation_hint": continuation_hint}
|
_last_round_end = {"path_tag": path_tag, "continuation_hint": continuation_hint}
|
||||||
_ap_exhausted_last = path_tag == "ap_exhausted" # 迭代 20 T1——一滴不剩 when 面（轮始发射读数）
|
_ap_exhausted_last = path_tag == "ap_exhausted" # 一滴不剩 when 面（轮始发射读数）
|
||||||
_phase = Phase.WAITING
|
_phase = Phase.WAITING
|
||||||
|
|
||||||
|
|
||||||
# 上轮 AP 是否耗尽（迭代 20 T1——round_start 发射 payload 读数面；轮始兑现后保持到本轮末）
|
# 上轮 AP 是否耗尽（round_start 发射 payload 读数面；轮始兑现后保持到本轮末）
|
||||||
func ap_exhausted_last_round() -> bool:
|
func ap_exhausted_last_round() -> bool:
|
||||||
return _ap_exhausted_last
|
return _ap_exhausted_last
|
||||||
|
|
||||||
|
|||||||
+132
-134
@@ -7,9 +7,9 @@ class_name AdventureRunner
|
|||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
signal level_started(level_index: int, display_name: String) # 每关开始（含冒险首关）——呈现层重取 runner()、刷新图条与层名行
|
signal level_started(level_index: int, display_name: String) # 每关开始（含冒险首关）——呈现层重取 runner()、刷新图条与层名行
|
||||||
signal curio_choice_presented(payload: Dictionary) # 专长三选一停点（非末关通关恰一次；迭代 20 T5 换代正名——旧「提升三选一」退役，通道白名单后候选恒专长+回血在载荷）——{level_index, candidates, heal_gained, hp_before, hp_after, keystone_gained, keystone_total, gp, aux_cleared}
|
signal curio_choice_presented(payload: Dictionary) # 专长三选一停点（非末关通关恰一次；通道白名单后候选恒专长+回血在载荷）——{level_index, candidates, heal_gained, hp_before, hp_after, keystone_gained, keystone_total, gp, aux_cleared}
|
||||||
signal curio_resolved(result: Dictionary) # 三选一兑付完成（pick_curio/替换受理后恰一次）——{picked, value, hp_before, hp_after, level_index}
|
signal curio_resolved(result: Dictionary) # 三选一兑付完成（pick_curio/替换受理后恰一次）——{picked, value, hp_before, hp_after, level_index}
|
||||||
signal adventure_finished(summary: Dictionary) # 冒险结算（completed/failed/abandoned）——summary 五件事：打穿没有/通关几关/止步第几关/钥石合计/主种子（+additive keystone_drops 迭代 10）
|
signal adventure_finished(summary: Dictionary) # 冒险结算（completed/failed/abandoned）——summary 五件事：打穿没有/通关几关/止步第几关/钥石合计/主种子（+additive keystone_drops）
|
||||||
# ---- 转发族（签名与 LevelRunner 同款——呈现层对接透明；S6 经 _forward_* 方法）----
|
# ---- 转发族（签名与 LevelRunner 同款——呈现层对接透明；S6 经 _forward_* 方法）----
|
||||||
signal node_entered(node: Dictionary, info: Dictionary)
|
signal node_entered(node: Dictionary, info: Dictionary)
|
||||||
signal choices_presented(candidates: Array)
|
signal choices_presented(candidates: Array)
|
||||||
@@ -20,19 +20,19 @@ signal wallet_changed(event: String, gp: int, extra: Dictionary)
|
|||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
var rng: RngServiceCore
|
var rng: RngServiceCore
|
||||||
enum State { IDLE, RUNNING, SETTLING } # 会话状态机（迭代 27 T6——裸字符串 enum 化：内部 enum，外部 String 契约 getter 词表逐位一致）
|
enum State { IDLE, RUNNING, SETTLING } # 会话状态机（内部 enum，外部 String 契约经 getter 词表）
|
||||||
var _state: State = State.IDLE
|
var _state: State = State.IDLE
|
||||||
var state: String: # 外部契约面（只读——外部零写点实证；"idle"/"running"/"settling" 零变化）
|
var state: String: # 外部契约面（只读——外部零写点实证；词表 "idle"/"running"/"settling"）
|
||||||
get:
|
get:
|
||||||
return State.keys()[_state].to_lower()
|
return State.keys()[_state].to_lower()
|
||||||
var ledger := {"hero_hp": 0, "gp": 0} # 冒险账本（生命 + GP 钱包——经 start_level_external 注入 runner 共享）
|
var ledger := {"hero_hp": 0, "gp": 0} # 冒险账本（生命 + GP 钱包——经 start_level_external 注入 runner 共享）
|
||||||
var run_ledger := RunLedger.new() # 共享四本账（迭代 27 T3——P1-4 收口：attune_charges/vision_counter/adventure_counters/bonus 单类持账；裁点②甲）
|
var run_ledger := RunLedger.new() # 共享四本账（attune_charges/vision_counter/adventure_counters/bonus 单类持账）
|
||||||
var purchased := {} # product_id → 已购档数（跨关延续、冒险收束清零——递增定价输入）
|
var purchased := {} # product_id → 已购档数（跨关延续、冒险收束清零——递增定价输入）
|
||||||
var level_index := 0 # 当前关卡序号（1 起）
|
var level_index := 0 # 当前关卡序号（1 起）
|
||||||
var levels_total := 0 # 序列总关数（读 level 表行数）
|
var levels_total := 0 # 序列总关数（读 level 表行数）
|
||||||
var keystone := 0 # 钥石入账累计（摘要第三件事的账面）
|
var keystone := 0 # 钥石入账累计（摘要第三件事的账面）
|
||||||
var master_seed := 0 # 本局主种子（摘要第五件事）
|
var master_seed := 0 # 本局主种子（摘要第五件事）
|
||||||
# 两根类型轴冒险开始快照（迭代 23 T4——契约 8：营地选中态经参数面注入、冒险开始后锁死；
|
# 两根类型轴冒险开始快照（契约 8：营地选中态经参数面注入、冒险开始后锁死；
|
||||||
# 公有=参数面快照的可断言面〔契约 9 写口唯一，本字段只读不改〕。空串=未注入→消费面回退锻造配置默认值）
|
# 公有=参数面快照的可断言面〔契约 9 写口唯一，本字段只读不改〕。空串=未注入→消费面回退锻造配置默认值）
|
||||||
var hero_attack_type := ""
|
var hero_attack_type := ""
|
||||||
var hero_armor_type := ""
|
var hero_armor_type := ""
|
||||||
@@ -42,32 +42,32 @@ var _pending_next_level := false # 大奖励已兑付、等 continue_to
|
|||||||
var _last_level_payload := {} # 最近一次关卡结束载荷（失败结算的败退节点明细来源——数值验证取数面）
|
var _last_level_payload := {} # 最近一次关卡结束载荷（失败结算的败退节点明细来源——数值验证取数面）
|
||||||
var _override := [0, 0] # 调试浮窗百分比通道 [atk_pct, hp_pct]（每关新 runner 都要应用）
|
var _override := [0, 0] # 调试浮窗百分比通道 [atk_pct, hp_pct]（每关新 runner 都要应用）
|
||||||
var _base_override := {"atk": 0, "max_hp": 0, "armor_class": 0}
|
var _base_override := {"atk": 0, "max_hp": 0, "armor_class": 0}
|
||||||
var _first_script := false # 首次脚本模式（关卡节点图生成 v0.4——true = 全关零抽签取池内模板 0；测量夹具恒 false） # 永久强化 flat 注入（元进度实现批——冒险开始参数面 params.hero_override 存入，共享给 LevelRunner；全零 = 白板）
|
var _first_script := false # 首次脚本模式（关卡节点图生成 v0.4——true = 全关零抽签取池内模板 0；测量夹具恒 false） # 永久强化 flat 注入（冒险开始参数面 params.hero_override 存入，共享给 LevelRunner；全零 = 白板）
|
||||||
var _last_treasure_cleared := 0 # additive（迭代 7 T4——最近一次关卡末清空计数，summary 取数面）
|
var _last_treasure_cleared := 0 # additive（最近一次关卡末清空计数，summary 取数面）
|
||||||
var _treasure_unlocked := {} # aux 解锁门控集（迭代 7 T5——params.treasure_unlocked 接收面）
|
var _treasure_unlocked := {} # aux 解锁门控集（params.treasure_unlocked 接收面）
|
||||||
var _attunement: Array[Variant] = [] # 同调装配集（迭代 11 第①批 T5——params.attunement 接收面，start_level 外下传 LevelRunner）
|
var _attunement: Array[Variant] = [] # 同调装配集（params.attunement 接收面，start_level 外下传 LevelRunner）
|
||||||
var _attune_refresh_x := 0 # 刷新件余量（迭代 11 第①批 T5b P1 甲——每碰三选一重置=X 表值；优先消耗、不结转）
|
var _attune_refresh_x := 0 # 刷新件余量（每碰三选一重置=X 表值；优先消耗、不结转）
|
||||||
var _attune_refresh_y := 0 # Y 冒险周期池（开局参数面注入，用完即无——营地升级行表值）
|
var _attune_refresh_y := 0 # Y 冒险周期池（开局参数面注入，用完即无——营地升级行表值）
|
||||||
var _curio_paid_refreshes := 0 # 本次停点已付费刷新次数（2026-10-06 用户令对齐商店 MC-1——GP 刷新价曲线输入，随停点创建清零=与商店进店清零同构）
|
var _curio_paid_refreshes := 0 # 本次停点已付费刷新次数（对齐商店 MC-1——GP 刷新价曲线输入，随停点创建清零=与商店进店清零同构）
|
||||||
# ---- 凭证件三本新账（迭代 20 T4——奇物.md 凭证件表新 5 件；F-1 刷新写错账修复承载面）----
|
# ---- 凭证件三本账（奇物.md 凭证件表 5 件；F-1 刷新写错账修复承载面）----
|
||||||
var _refresh_stock := 0 # 刷新存量账（冒险级——刷新券加仓；**不经 _attune_refresh_x**：X 每停点重置会吞存量=旧写错账缺陷 F-1）
|
var _refresh_stock := 0 # 刷新存量账（冒险级——刷新券加仓；**不经 _attune_refresh_x**：X 每停点重置会吞存量=写错账缺陷 F-1）
|
||||||
var _pending_rap := 0 # 储备金袋待注入（节点级——下一战 RAP +N，战首注入后清零）
|
var _pending_rap := 0 # 储备金袋待注入（节点级——下一战 RAP +N，战首注入后清零）
|
||||||
var _time_sand_queue := 0 # 时沙待注入（回合级——下一战首轮 AP +N，战首入队后清零）
|
var _time_sand_queue := 0 # 时沙待注入（回合级——下一战首轮 AP +N，战首入队后清零）
|
||||||
var _save_manager = null # 断点承载注入（迭代 8 卡①——null = 不写断点；模拟/冒烟缺省）
|
var _save_manager = null # 断点承载注入（null = 不写断点；模拟/冒烟缺省）
|
||||||
var _resume_bp := {} # 续玩快照暂存（resume_adventure → _start_current_level 单跳传递）
|
var _resume_bp := {} # 续玩快照暂存（resume_adventure → _start_current_level 单跳传递）
|
||||||
# ---- 三选一停点态（迭代 10 奖励重构批）----
|
# ---- 三选一停点态 ----
|
||||||
var _curio_taken := {} # 件获取次数计数（kind 维度派生账本——断点附随件与摘要读数承载；池库存正主=_curio_deck）
|
var _curio_taken := {} # 件获取次数计数（kind 维度派生账本——断点附随件与摘要读数承载；池库存正主=_curio_deck）
|
||||||
var _curio_deck: Array[Variant] = [] # 令牌池（TP0 v2.2——持久多重集，元素 {"kind","tier"}；洗牌抽候选/选中踢池未选回池/池耗即枯竭；商店货架同库共账；迭代 12 T1 起规则改写型特性带=relic 令牌随表追加）
|
var _curio_deck: Array[Variant] = [] # 令牌池（TP0 v2.2——持久多重集，元素 {"kind","tier"}；洗牌抽候选/选中踢池未选回池/池耗即枯竭；商店货架同库共账；规则改写型特性带=relic 令牌随表追加）
|
||||||
var _feats: Array[String] = [] # 特性持有集（迭代 12 T1——局内随机渠道获得、冒险级跨关携带、收束清零；🔴 层级纪律承载面：不入同调位不入局外树）
|
var _feats: Array[String] = [] # 特性持有集（局内随机渠道获得、冒险级跨关携带、收束清零；🔴 层级纪律承载面：不入同调位不入局外树）
|
||||||
var _tree_rules: Array[Variant] = [] # 树 rule 键集（迭代 12 T10——Fork 激活侧 effects 透传；下传 enc.tree_rules 消费面）
|
var _tree_rules: Array[Variant] = [] # 树 rule 键集（Fork 激活侧 effects 透传；下传 enc.tree_rules 消费面）
|
||||||
var _curio_pending := {} # 停点态：{"candidates": Array, "payload": Dictionary, "chosen"/"incoming": 替换在途}——空 = 无停点
|
var _curio_pending := {} # 停点态：{"candidates": Array, "payload": Dictionary, "chosen"/"incoming": 替换在途}——空 = 无停点
|
||||||
var _curio_result := {} # 已兑付待推进态（curio_resolved 载荷副本——中断续玩不重兑付）
|
var _curio_result := {} # 已兑付待推进态（curio_resolved 载荷副本——中断续玩不重兑付）
|
||||||
var _keystone_drops: Array[Variant] = [] # Boss 逐杀掉落明细（additive 摘要键 keystone_drops——结算明细/复盘归因数据源）
|
var _keystone_drops: Array[Variant] = [] # Boss 逐杀掉落明细（additive 摘要键 keystone_drops——结算明细/复盘归因数据源）
|
||||||
var _node_curio_pending := {} # 奖励节点三选一停点态（迭代 10 追加批——共享池；断点不载：续玩重建到选路停点重走，恢复的计数器保证同候选重抽）
|
var _node_curio_pending := {} # 奖励节点三选一停点态（共享池；断点不载：续玩重建到选路停点重走，恢复的计数器保证同候选重抽）
|
||||||
var _feat_ticket_pity := 0 # 门票保底计数（T5——展示次数：节点开面/货架抽签/刷新重展各计一次；触发清零）
|
var _feat_ticket_pity := 0 # 门票保底计数（T5——展示次数：节点开面/货架抽签/刷新重展各计一次；触发清零）
|
||||||
var _feat_ticket_sold := 0 # 门票限购计数（T5——选中/买下即 +1；拿到即开不进持有集）
|
var _feat_ticket_sold := 0 # 门票限购计数（T5——选中/买下即 +1；拿到即开不进持有集）
|
||||||
var _feat_ticket_appeared := 0 # 门票出现计数（T5——quota 上限面）
|
var _feat_ticket_appeared := 0 # 门票出现计数（T5——quota 上限面）
|
||||||
var _shop_mode := "legacy" # 商店模式（迭代 11 第②批 T3——"legacy"=固定三件加定价〔off 对照承载，缺省零扰动〕/"pool"=共享池抽 3 买 1 重抽；真实入口 main.gd 显式投 pool）
|
var _shop_mode := "legacy" # 商店模式（"legacy"=固定三件加定价〔off 对照承载，缺省零扰动〕/"pool"=共享池抽 3 买 1 重抽；真实入口 main.gd 显式投 pool）
|
||||||
|
|
||||||
|
|
||||||
func _init(db_ref: ConfigDb, rng_ref: RngServiceCore) -> void:
|
func _init(db_ref: ConfigDb, rng_ref: RngServiceCore) -> void:
|
||||||
@@ -93,34 +93,34 @@ func start_adventure(seed_val: int, params: Dictionary = {}) -> bool:
|
|||||||
keystone = 0
|
keystone = 0
|
||||||
summary = {}
|
summary = {}
|
||||||
_reset_curio_state()
|
_reset_curio_state()
|
||||||
levels_total = db.level_count() # 表访问收口（2026-10-02——行集直扫退役）
|
levels_total = db.level_count() # 表访问收口（关数读 level 表行数）
|
||||||
level_index = 1
|
level_index = 1
|
||||||
_pending_next_level = false
|
_pending_next_level = false
|
||||||
_base_override = _normalize_override(params.get("hero_override", {}))
|
_base_override = _normalize_override(params.get("hero_override", {}))
|
||||||
hero_attack_type = String(params.get("attack_type", "")) # 迭代 23 T4——两根类型轴快照（契约 8 锁死：开局后不随存档选中变化）
|
hero_attack_type = String(params.get("attack_type", "")) # 两根类型轴快照（契约 8 锁死：开局后不随存档选中变化）
|
||||||
hero_armor_type = String(params.get("armor_type", ""))
|
hero_armor_type = String(params.get("armor_type", ""))
|
||||||
_first_script = bool(params.get("first_script", false)) # 缺省 = 非首次（抽签路径；真实侧由呈现层读存档布尔位传入）
|
_first_script = bool(params.get("first_script", false)) # 缺省 = 非首次（抽签路径；真实侧由呈现层读存档布尔位传入）
|
||||||
_shop_mode = "pool" if String(params.get("shop_mode", "legacy")) == "pool" else "legacy" # 迭代 11 第②批 T3——缺省 legacy（off 对照零扰动）
|
_shop_mode = "pool" if String(params.get("shop_mode", "legacy")) == "pool" else "legacy" # 缺省 legacy（off 对照零扰动）
|
||||||
_treasure_unlocked = params.get("treasure_unlocked", {}) if params.get("treasure_unlocked", {}) is Dictionary else {}
|
_treasure_unlocked = params.get("treasure_unlocked", {}) if params.get("treasure_unlocked", {}) is Dictionary else {}
|
||||||
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive（迭代 11 第①批 T5）
|
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive
|
||||||
_attune_refresh_y = maxi(0, int(params.get("attune_refresh_y", 0))) # additive（迭代 11 第①批 T5b——Y 冒险周期池）
|
_attune_refresh_y = maxi(0, int(params.get("attune_refresh_y", 0))) # additive（Y 冒险周期池）
|
||||||
_seed_attune_charges() # 迭代 11 第①批 T6——冒险开始充能账本按装备主动件重置（每冒险充能语义）
|
_seed_attune_charges() # 冒险开始充能账本按装备主动件重置（每冒险充能语义）
|
||||||
run_ledger.vision_counter = {"used": 0} # 迭代 22 秘宝批 T3——真视使用计数冒险开始归零（跨局累计归生涯档）
|
run_ledger.vision_counter = {"used": 0} # 真视使用计数冒险开始归零（跨局累计归生涯档）
|
||||||
# 刷新练习开局注入（迭代 22 秘宝批 T3——refresh_stock_grant 装配即得一次性加仓：
|
# 刷新练习开局注入（refresh_stock_grant 装配即得一次性加仓：
|
||||||
# 装配集 kind 分发扫描；只入存量账 _refresh_stock、临时账不动=V8 契约；resume 不重注入〔存量随断点已在〕）
|
# 装配集 kind 分发扫描；只入存量账 _refresh_stock、临时账不动=V8 契约；resume 不重注入〔存量随断点已在〕）
|
||||||
for iid_v2 in _attunement:
|
for iid_v2 in _attunement:
|
||||||
var rp_row: Dictionary[Variant, Variant] = db.treasure_item_row(String(iid_v2))
|
var rp_row: Dictionary[Variant, Variant] = db.treasure_item_row(String(iid_v2))
|
||||||
if (rp_row.get("effect_kinds", []) as Array).has("refresh_stock_grant"):
|
if (rp_row.get("effect_kinds", []) as Array).has("refresh_stock_grant"):
|
||||||
_refresh_stock += int(rp_row.get("magnitude", 0))
|
_refresh_stock += int(rp_row.get("magnitude", 0))
|
||||||
# 特性开局注入（迭代 12 T7——MC 成型画像载体：params.relics_seed 非空=开局持有集〔七流派
|
# 特性开局注入（MC 成型画像载体：params.relics_seed 非空=开局持有集〔七流派
|
||||||
# 各 2 件档一成型——测量面专用；真实局规则改写型特性只走局内随机渠道，红线②层级纪律不破〕）
|
# 各 2 件档一成型——测量面专用；真实局规则改写型特性只走局内随机渠道，红线②层级纪律不破〕）
|
||||||
var feat_seed: Array[Variant] = params.get("relics_seed", []) if params.get("relics_seed", []) is Array else []
|
var feat_seed: Array[Variant] = params.get("relics_seed", []) if params.get("relics_seed", []) is Array else []
|
||||||
_tree_rules = params.get("tree_rules", []) if params.get("tree_rules", []) is Array else [] # 迭代 12 T10——A/B 面 rule 键集
|
_tree_rules = params.get("tree_rules", []) if params.get("tree_rules", []) is Array else [] # A/B 面 rule 键集
|
||||||
if not feat_seed.is_empty():
|
if not feat_seed.is_empty():
|
||||||
_feats = []
|
_feats = []
|
||||||
for r in feat_seed:
|
for r in feat_seed:
|
||||||
_feats.append(String(r))
|
_feats.append(String(r))
|
||||||
ledger["hero_hp"] = effective_max_hp() # 生命账本置满（生效上限口径——T17 修复：含调试浮窗 pct，与战斗内同源）
|
ledger["hero_hp"] = effective_max_hp() # 生命账本置满（生效上限口径：含调试浮窗 pct，与战斗内同源）
|
||||||
_state = State.RUNNING
|
_state = State.RUNNING
|
||||||
return _start_current_level()
|
return _start_current_level()
|
||||||
|
|
||||||
@@ -133,7 +133,7 @@ func _normalize_override(raw: Dictionary) -> Dictionary:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# 断点续玩（迭代 8 卡①——「继续上局」入口；bp = save.breakpoint_snapshot() 快照，params 同 start_adventure
|
# 断点续玩（「继续上局」入口；bp = save.breakpoint_snapshot() 快照，params 同 start_adventure
|
||||||
# 的注入参数面）：账面（生命/GP/加算区/已购档/钥石累计）逐字段回填 + rng.restore_adventure 回填
|
# 的注入参数面）：账面（生命/GP/加算区/已购档/钥石累计）逐字段回填 + rng.restore_adventure 回填
|
||||||
# 「主种子+计数器」→ _start_current_level 续玩路径（模板随快照强制、重建到停点节点，零重抽）。
|
# 「主种子+计数器」→ _start_current_level 续玩路径（模板随快照强制、重建到停点节点，零重抽）。
|
||||||
# 快照缺字段按防御默认（空快照拒绝——调用方先 has_breakpoint）。
|
# 快照缺字段按防御默认（空快照拒绝——调用方先 has_breakpoint）。
|
||||||
@@ -155,7 +155,7 @@ func resume_adventure(bp: Dictionary, params: Dictionary = {}) -> bool:
|
|||||||
purchased = (bp.get("shop_purchased", {}) as Dictionary).duplicate(true)
|
purchased = (bp.get("shop_purchased", {}) as Dictionary).duplicate(true)
|
||||||
keystone = int(bp.get("keystone", 0))
|
keystone = int(bp.get("keystone", 0))
|
||||||
summary = {}
|
summary = {}
|
||||||
levels_total = db.level_count() # 表访问收口（2026-10-02——行集直扫退役）
|
levels_total = db.level_count() # 表访问收口（关数读 level 表行数）
|
||||||
level_index = int(bp.get("level_index", 1))
|
level_index = int(bp.get("level_index", 1))
|
||||||
_pending_next_level = false
|
_pending_next_level = false
|
||||||
_reset_curio_state()
|
_reset_curio_state()
|
||||||
@@ -163,9 +163,9 @@ func resume_adventure(bp: Dictionary, params: Dictionary = {}) -> bool:
|
|||||||
for id in _curio_taken.keys():
|
for id in _curio_taken.keys():
|
||||||
_curio_taken[id] = maxi(0, int(bp_taken.get(id, 0)))
|
_curio_taken[id] = maxi(0, int(bp_taken.get(id, 0)))
|
||||||
for id in bp_taken.keys():
|
for id in bp_taken.keys():
|
||||||
_curio_taken[String(id)] = maxi(0, int(bp_taken.get(id, 0))) # 迭代 20 T2——身份维键（relic:<feat_id>）随快照还原
|
_curio_taken[String(id)] = maxi(0, int(bp_taken.get(id, 0))) # 身份维键（relic:<feat_id>）随快照还原
|
||||||
# 令牌池余库还原（TP0 v2.2——快照缺键 = 旧版断点，保持满库重建态：旧档只读一版周期的防御口径；
|
# 令牌池余库还原（TP0 v2.2——快照缺键 = 旧版断点，保持满库重建态：旧档只读一版周期的防御口径；
|
||||||
# 迭代 12 T1——relic 令牌 feat_id 随还原）
|
# relic 令牌 feat_id 随还原）
|
||||||
var bp_deck = bp.get("bonus_deck", null)
|
var bp_deck = bp.get("bonus_deck", null)
|
||||||
if bp_deck is Array:
|
if bp_deck is Array:
|
||||||
var restored: Array[Variant] = []
|
var restored: Array[Variant] = []
|
||||||
@@ -176,38 +176,38 @@ func resume_adventure(bp: Dictionary, params: Dictionary = {}) -> bool:
|
|||||||
rtok["feat_id"] = String(tok.get("feat_id", ""))
|
rtok["feat_id"] = String(tok.get("feat_id", ""))
|
||||||
restored.append(rtok)
|
restored.append(rtok)
|
||||||
_curio_deck = restored
|
_curio_deck = restored
|
||||||
# 特性持有集还原（迭代 12 T1——缺键 = 旧版断点防御空集）
|
# 特性持有集还原（缺键 = 旧版断点防御空集）
|
||||||
_feats = []
|
_feats = []
|
||||||
for r in (bp.get("relics", []) as Array):
|
for r in (bp.get("relics", []) as Array):
|
||||||
_feats.append(String(r))
|
_feats.append(String(r))
|
||||||
_keystone_drops = (bp.get("keystone_drops", []) as Array).duplicate(true)
|
_keystone_drops = (bp.get("keystone_drops", []) as Array).duplicate(true)
|
||||||
_base_override = _normalize_override(params.get("hero_override", {}))
|
_base_override = _normalize_override(params.get("hero_override", {}))
|
||||||
hero_attack_type = String(params.get("attack_type", "")) # 迭代 23 T4——续玩参数面同 start_adventure（账号层选中态随 resume 重注入）
|
hero_attack_type = String(params.get("attack_type", "")) # 续玩参数面同 start_adventure（账号层选中态随 resume 重注入）
|
||||||
hero_armor_type = String(params.get("armor_type", ""))
|
hero_armor_type = String(params.get("armor_type", ""))
|
||||||
# 生命账本越界钳制（T17——spawn 守卫 EC16 免疫）：断点可能由旧口径版本写出（如调试上限
|
# 生命账本越界钳制（T17——spawn 守卫 EC16 免疫）：断点可能带出高于生效上限的账本值
|
||||||
# 调高期带出的账本值 > 新口径生效上限，实例：hero_hp=28 > 基础 26）——恢复后钳到生效上限，
|
# （如调试浮窗调高期写出的值，实例：hero_hp=28 > 基础 26）——恢复后钳到生效上限，
|
||||||
# 否则首战 spawn「hero_hp 入参越界」拒收 → 「敌人系统 spawn 被拒」fatal。上限 = 表值+永久
|
# 否则首战 spawn「hero_hp 入参越界」拒收 → 「敌人系统 spawn 被拒」fatal。上限 = 表值+永久
|
||||||
# 强化 flat+加算区 flat 后乘调试浮窗 pct（effective_max_hp 同式——此刻加算区尚未恢复，
|
# 强化 flat+加算区 flat 后乘调试浮窗 pct（effective_max_hp 同式——此刻加算区尚未恢复，
|
||||||
# 钳制用 flat 已含的保守口径即可，加算区恢复后其余战斗照常）。
|
# 钳制用 flat 已含的保守口径即可，加算区恢复后其余战斗照常）。
|
||||||
ledger["hero_hp"] = mini(int(ledger.get("hero_hp", 0)), maxi(1,
|
ledger["hero_hp"] = mini(int(ledger.get("hero_hp", 0)), maxi(1,
|
||||||
int(round(float(int(db.hero.max_hp) + int(_base_override.get("max_hp", 0))) * (100.0 + float(_override[1])) / 100.0))))
|
int(round(float(int(db.hero.max_hp) + int(_base_override.get("max_hp", 0))) * (100.0 + float(_override[1])) / 100.0))))
|
||||||
_first_script = false # 续玩模板已随快照强制（已抽模板零重抽）——脚本模式不重放
|
_first_script = false # 续玩模板已随快照强制（已抽模板零重抽）——脚本模式不重放
|
||||||
_shop_mode = "pool" if String(params.get("shop_mode", "legacy")) == "pool" else "legacy" # 迭代 11 第②批 T3——续玩参数面同 start_adventure（缺省 legacy）
|
_shop_mode = "pool" if String(params.get("shop_mode", "legacy")) == "pool" else "legacy" # 续玩参数面同 start_adventure（缺省 legacy）
|
||||||
_treasure_unlocked = params.get("treasure_unlocked", {}) if params.get("treasure_unlocked", {}) is Dictionary else {}
|
_treasure_unlocked = params.get("treasure_unlocked", {}) if params.get("treasure_unlocked", {}) is Dictionary else {}
|
||||||
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive（迭代 11 第①批 T5）
|
_attunement = params.get("attunement", []) if params.get("attunement", []) is Array else [] # additive
|
||||||
_attune_refresh_y = maxi(0, int(bp.get("attune_refresh_y", int(params.get("attune_refresh_y", 0))))) # 2026-10-13 缺陷修批——Y 余量优先读断点（花掉不回血=堵「用完退菜单再续玩满血复活」可利用漏洞）；缺键=旧版断点，回退参数面整额注入（旧档行为零变化）
|
_attune_refresh_y = maxi(0, int(bp.get("attune_refresh_y", int(params.get("attune_refresh_y", 0))))) # Y 余量优先读断点（花掉不回血=堵「用完退菜单再续玩满血复活」可利用漏洞）；缺键=旧版断点，回退参数面整额注入（旧档行为零变化）
|
||||||
_seed_attune_charges() # 迭代 11 第①批 T6——冒险开始充能账本按装备主动件重置（每冒险充能语义）
|
_seed_attune_charges() # 冒险开始充能账本按装备主动件重置（每冒险充能语义）
|
||||||
_tree_rules = params.get("tree_rules", []) if params.get("tree_rules", []) is Array else [] # 迭代 12 T10——A/B 面 rule 键集（尾裁微批b 2026-10-08 卡⓪受理闭环：续玩参数面同 start_adventure :135 同式，消费面 set_tree_rules 下传现成零改）
|
_tree_rules = params.get("tree_rules", []) if params.get("tree_rules", []) is Array else [] # A/B 面 rule 键集（续玩参数面同 start_adventure 同式，消费面 set_tree_rules 下传）
|
||||||
# 三选一停点续玩分支（迭代 10——选择态/已兑付态不重跑关卡；奖励选择态不重抽、已兑付不重付）
|
# 三选一停点续玩分支（选择态/已兑付态不重跑关卡；奖励选择态不重抽、已兑付不重付）
|
||||||
var bp_pending: Dictionary[Variant, Variant] = bp.get("bonus_pending", {}) as Dictionary
|
var bp_pending: Dictionary[Variant, Variant] = bp.get("bonus_pending", {}) as Dictionary
|
||||||
_feat_ticket_pity = int(bp.get("feat_ticket_pity", 0)) # T5 扩列——旧档缺键缺省 0（存档兼容）
|
_feat_ticket_pity = int(bp.get("feat_ticket_pity", 0)) # T5 扩列——旧档缺键缺省 0（存档兼容）
|
||||||
_feat_ticket_sold = int(bp.get("feat_ticket_sold", 0))
|
_feat_ticket_sold = int(bp.get("feat_ticket_sold", 0))
|
||||||
# 迭代 20 T6/T7——adventure 域计数器回填（缺键 = 旧版断点防御空集；_reset_curio_state 已清零在先）
|
# adventure 域计数器回填（缺键 = 旧版断点防御空集；_reset_curio_state 已清零在先）
|
||||||
var bp_counters = bp.get("adventure_counters", null)
|
var bp_counters = bp.get("adventure_counters", null)
|
||||||
if bp_counters is Dictionary:
|
if bp_counters is Dictionary:
|
||||||
run_ledger.adventure_counters = (bp_counters as Dictionary).duplicate(true)
|
run_ledger.adventure_counters = (bp_counters as Dictionary).duplicate(true)
|
||||||
_refresh_stock = maxi(0, int(bp.get("refresh_stock", 0))) # 迭代 20 T4/T7——旧档缺键缺省 0
|
_refresh_stock = maxi(0, int(bp.get("refresh_stock", 0))) # 旧档缺键缺省 0
|
||||||
run_ledger.vision_counter = {"used": maxi(0, int(bp.get("vision_counter_used", 0)))} # 迭代 22 秘宝批 T3——真视计数随断点回填（缺键=旧断点缺省 0）
|
run_ledger.vision_counter = {"used": maxi(0, int(bp.get("vision_counter_used", 0)))} # 真视计数随断点回填（缺键=旧断点缺省 0）
|
||||||
var bp_result: Dictionary[Variant, Variant] = bp.get("bonus_result", {}) as Dictionary
|
var bp_result: Dictionary[Variant, Variant] = bp.get("bonus_result", {}) as Dictionary
|
||||||
if not bp_pending.is_empty():
|
if not bp_pending.is_empty():
|
||||||
_pending_next_level = true
|
_pending_next_level = true
|
||||||
@@ -234,7 +234,7 @@ func resume_adventure(bp: Dictionary, params: Dictionary = {}) -> bool:
|
|||||||
curio_resolved.emit(_curio_result.duplicate(true))
|
curio_resolved.emit(_curio_result.duplicate(true))
|
||||||
return true
|
return true
|
||||||
_resume_bp = bp.duplicate(true)
|
_resume_bp = bp.duplicate(true)
|
||||||
# 迭代 11 第①批 T6——充能账本随断点回局（缺键 = 旧档/无断点，保持 _seed_attune_charges 种子态）
|
# 充能账本随断点回局（缺键 = 旧档/无断点，保持 _seed_attune_charges 种子态）
|
||||||
var bp_charges = bp.get("attunement_charges", null)
|
var bp_charges = bp.get("attunement_charges", null)
|
||||||
if bp_charges is Dictionary:
|
if bp_charges is Dictionary:
|
||||||
run_ledger.attune_charges = (bp_charges as Dictionary).duplicate(true)
|
run_ledger.attune_charges = (bp_charges as Dictionary).duplicate(true)
|
||||||
@@ -243,7 +243,7 @@ func resume_adventure(bp: Dictionary, params: Dictionary = {}) -> bool:
|
|||||||
|
|
||||||
|
|
||||||
# 三选一停点态归零（冒险开始/结算收束共用；令牌池按表配额重建——池消耗即上限，账本随池重生。
|
# 三选一停点态归零（冒险开始/结算收束共用；令牌池按表配额重建——池消耗即上限，账本随池重生。
|
||||||
# 迭代 20 T6——adventure 域计数器账本随冒险开始清零；resume 路径调用后由断点附随件回填）
|
# adventure 域计数器账本随冒险开始清零；resume 路径调用后由断点附随件回填）
|
||||||
func _reset_curio_state() -> void:
|
func _reset_curio_state() -> void:
|
||||||
_curio_taken = {"attack": 0, "max_hp": 0, "armor": 0, "gp": 0, "ap": 0, "heal": 0}
|
_curio_taken = {"attack": 0, "max_hp": 0, "armor": 0, "gp": 0, "ap": 0, "heal": 0}
|
||||||
_curio_deck = _build_curio_deck()
|
_curio_deck = _build_curio_deck()
|
||||||
@@ -259,10 +259,9 @@ func _reset_curio_state() -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 令牌池构建（TP0 v2.2——按表 kind×tier 配额展开为持久多重集；构建序确定 = CURIO_KINDS×TIERS 逐层，
|
# 令牌池构建（TP0 v2.2——按表 kind×tier 配额展开为持久多重集；构建序确定 = CURIO_KINDS×TIERS 逐层，
|
||||||
# 随机性只发生在洗牌消费 reward_pick 封闭流的时刻。迭代 12 T1：规则改写型特性带=relic 活行每件 1 张追加。
|
# 随机性只发生在洗牌消费 reward_pick 封闭流的时刻。规则改写型特性带=relic 活行每件 1 张追加。
|
||||||
# 迭代 20 T2/T3 四级换代——relic 令牌档 = 行 rarity 直映射（四级词表内直用；旧三档值 transitional
|
# relic 令牌档 = 行 rarity 直映射（四级词表内直用；词表外的 transitional 值回退映射
|
||||||
# 回退映射 rarest→rare/其余→excellent，T3 行换代后回退分支自然休眠）；relic 入普通档随新档位框架
|
# rarest→rare/其余→excellent）；relic 可入普通档（奇物.md 池结构节无档位限制）。
|
||||||
# 解禁〔旧「永不入普通档」系 TP0 三档时代约束，四级框架未沿用——奇物.md 池结构节无此限制〕）
|
|
||||||
func _build_curio_deck() -> Array:
|
func _build_curio_deck() -> Array:
|
||||||
var deck: Array[Variant] = []
|
var deck: Array[Variant] = []
|
||||||
for kind in db.adventure.CURIO_KINDS:
|
for kind in db.adventure.CURIO_KINDS:
|
||||||
@@ -290,16 +289,15 @@ func set_hero_override(atk_pct: int, hp_pct: int) -> void:
|
|||||||
_runner.set_hero_override(atk_pct, hp_pct)
|
_runner.set_hero_override(atk_pct, hp_pct)
|
||||||
|
|
||||||
|
|
||||||
# 冒险账本侧生效上限（T17 修复——账本置满/回血封顶与战斗内上限同式同源）：
|
# 冒险账本侧生效上限（账本置满/回血封顶与战斗内上限同式同源）：
|
||||||
# （表值 + 永久强化 flat + 加算区 flat）后乘调试浮窗百分比——叠加次序与 LevelRunner.effective_max_hp
|
# （表值 + 永久强化 flat + 加算区 flat）后乘调试浮窗百分比——叠加次序与 LevelRunner.effective_max_hp
|
||||||
# 逐字一致。旧口径两处只算 flat 不乘 pct：调生命上限 26→104 时开局血仍 26（账本 26 / 战斗内 104）、
|
# 逐字一致。pct=0（模拟/冒烟默认）时乘法恒等——MC 锚零漂移。
|
||||||
# 通关 20% 回血封顶按 26 算。pct=0（模拟/冒烟默认）时乘法恒等——MC 锚零漂移。
|
|
||||||
func effective_max_hp() -> int:
|
func effective_max_hp() -> int:
|
||||||
var base: int = int(db.hero.max_hp) + int(_base_override.get("max_hp", 0)) + int(run_ledger.bonus.get("max_hp", 0))
|
var base: int = int(db.hero.max_hp) + int(_base_override.get("max_hp", 0)) + int(run_ledger.bonus.get("max_hp", 0))
|
||||||
return maxi(1, int(round(float(base) * (100.0 + float(_override[1])) / 100.0)))
|
return maxi(1, int(round(float(base) * (100.0 + float(_override[1])) / 100.0)))
|
||||||
|
|
||||||
|
|
||||||
# 断点承载注入（迭代 8 卡①——组合根冒险开始时调用；模拟/冒烟不注入 = 断点面整体静默）
|
# 断点承载注入（组合根冒险开始时调用；模拟/冒烟不注入 = 断点面整体静默）
|
||||||
func set_save_manager(sm: SaveManagerCore) -> void:
|
func set_save_manager(sm: SaveManagerCore) -> void:
|
||||||
_save_manager = sm
|
_save_manager = sm
|
||||||
|
|
||||||
@@ -310,7 +308,7 @@ func runner() -> LevelRunner:
|
|||||||
|
|
||||||
|
|
||||||
# 接口③治疗封顶回报执行体（恢复点节点兑付——按比例回血并封顶）。算术宿主 = LevelRunner.rest_heal
|
# 接口③治疗封顶回报执行体（恢复点节点兑付——按比例回血并封顶）。算术宿主 = LevelRunner.rest_heal
|
||||||
#（2026-10-02 修复批——同式双落点字面量退役，与 LevelRunner.rest_heal_amount 同一单点）
|
#（与 LevelRunner.rest_heal_amount 同一单点）
|
||||||
func apply_rest(pct: int, hp: int, max_hp: int) -> int:
|
func apply_rest(pct: int, hp: int, max_hp: int) -> int:
|
||||||
return LevelRunner.rest_heal(pct, hp, max_hp)
|
return LevelRunner.rest_heal(pct, hp, max_hp)
|
||||||
|
|
||||||
@@ -329,7 +327,7 @@ func continue_to_next_level() -> bool:
|
|||||||
return _start_current_level()
|
return _start_current_level()
|
||||||
|
|
||||||
|
|
||||||
# 停点空候选消化（2026-10-06 用户令——池空=三选一环节整体跳过：候选 0 件时停点视同已处理，
|
# 停点空候选消化（池空=三选一环节整体跳过：候选 0 件时停点视同已处理，
|
||||||
# 呈现层跳开选择面直接走后续推进。仅空候选合法；非空停点拒绝——零自动推进契约不破，正常
|
# 呈现层跳开选择面直接走后续推进。仅空候选合法；非空停点拒绝——零自动推进契约不破，正常
|
||||||
# 消化仍只走 pick_curio/apply_node_curio 兑付。触发源=渠道白名单过滤后池空（关卡 Boss 通关
|
# 消化仍只走 pick_curio/apply_node_curio 兑付。触发源=渠道白名单过滤后池空（关卡 Boss 通关
|
||||||
# 渠道只出专长，专长零配置/旧档 deck 无 relic 余库即空集）。）
|
# 渠道只出专长，专长零配置/旧档 deck 无 relic 余库即空集）。）
|
||||||
@@ -342,9 +340,9 @@ func skip_empty_curio() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# ---- 提升三选一（迭代 10 奖励重构批——选择停点零自动推进、重复兑付被拒；兑付恰一件、未选项零生效）----
|
# ---- 提升三选一（选择停点零自动推进、重复兑付被拒；兑付恰一件、未选项零生效）----
|
||||||
|
|
||||||
# 候选令牌匹配（身份键恒等——属性加成型特性 kind+tier、规则改写型特性 feat_id；迭代 12 T1 规则改写型特性带）
|
# 候选令牌匹配（身份键恒等——属性加成型特性 kind+tier、规则改写型特性 feat_id）
|
||||||
func _find_token(candidates: Array, kind: String, tier: String, feat_id: String = "") -> Dictionary:
|
func _find_token(candidates: Array, kind: String, tier: String, feat_id: String = "") -> Dictionary:
|
||||||
for t in candidates:
|
for t in candidates:
|
||||||
var tok: Dictionary[Variant, Variant] = t as Dictionary
|
var tok: Dictionary[Variant, Variant] = t as Dictionary
|
||||||
@@ -358,7 +356,7 @@ func _find_token(candidates: Array, kind: String, tier: String, feat_id: String
|
|||||||
|
|
||||||
# 玩家点选兑付（呈现层/冒烟/自动模拟确认入口）：令牌 ∈ 停点候选（身份键精确匹配——relic 件
|
# 玩家点选兑付（呈现层/冒烟/自动模拟确认入口）：令牌 ∈ 停点候选（身份键精确匹配——relic 件
|
||||||
# 另须 feat_id）。属性件写加算区、AP 件写第四轴、GP 件走钱包「奖励入账」入口、恢复件当即回血、
|
# 另须 feat_id）。属性件写加算区、AP 件写第四轴、GP 件走钱包「奖励入账」入口、恢复件当即回血、
|
||||||
# relic 件入特性持有集（🔴 层级纪律：只走局内随机渠道）、道具件受同调位约束（随池种退役不可达）。
|
# relic 件入特性持有集（🔴 层级纪律：只走局内随机渠道）、道具件受同调位约束。
|
||||||
# 消费=选中令牌踢池（未选回池由「抽签不摘牌、兑付才摘牌」语义承载——TP0 v2.2）。
|
# 消费=选中令牌踢池（未选回池由「抽签不摘牌、兑付才摘牌」语义承载——TP0 v2.2）。
|
||||||
func pick_curio(kind: String, tier: String = "", feat_id: String = "") -> bool:
|
func pick_curio(kind: String, tier: String = "", feat_id: String = "") -> bool:
|
||||||
if state != "running" or _curio_pending.is_empty():
|
if state != "running" or _curio_pending.is_empty():
|
||||||
@@ -379,7 +377,7 @@ func pick_curio(kind: String, tier: String = "", feat_id: String = "") -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 兑付载荷 relic 伴随键（迭代 12 T1——反馈行取数面；非 relic 件零新增键）
|
# 兑付载荷 relic 伴随键（反馈行取数面；非 relic 件零新增键）
|
||||||
func _feat_payload_keys(feat_id: String) -> Dictionary:
|
func _feat_payload_keys(feat_id: String) -> Dictionary:
|
||||||
if feat_id == "":
|
if feat_id == "":
|
||||||
return {}
|
return {}
|
||||||
@@ -387,7 +385,7 @@ func _feat_payload_keys(feat_id: String) -> Dictionary:
|
|||||||
return {"feat_id": feat_id, "feat_name": String(row.get("display_name", "")), "feat_archetype": String(row.get("archetype", ""))}
|
return {"feat_id": feat_id, "feat_name": String(row.get("display_name", "")), "feat_archetype": String(row.get("archetype", ""))}
|
||||||
|
|
||||||
|
|
||||||
# 三选一件兑付共享体（2026-10-02 修复批双胞胎收口；TP0 改令牌消费——摘牌单点；迭代 12 T1 relic 分支）：
|
# 三选一件兑付共享体（TP0——令牌消费、摘牌单点，含 relic 分支）：
|
||||||
# 属性件写加算区 + 件获取计数、AP 件写第四轴、GP 件走钱包、恢复件当即回血（封顶生效上限——
|
# 属性件写加算区 + 件获取计数、AP 件写第四轴、GP 件走钱包、恢复件当即回血（封顶生效上限——
|
||||||
# 与账本置满/通关回血同式 effective_max_hp）、relic 件入持有集（散件单体保底——效果接线面
|
# 与账本置满/通关回血同式 effective_max_hp）、relic 件入持有集（散件单体保底——效果接线面
|
||||||
# 按挂点消费，档位质变由 FeatsEngine 求值）。兑付即从 _curio_deck 摘除该令牌（选中踢池；
|
# 按挂点消费，档位质变由 FeatsEngine 求值）。兑付即从 _curio_deck 摘除该令牌（选中踢池；
|
||||||
@@ -400,7 +398,7 @@ func _apply_curio_pick(kind: String, tier: String, value: int, feat_id: String =
|
|||||||
push_error("[冒险结构] 令牌消费失败——牌库无此令牌: %s|%s|%s" % [kind, tier, feat_id])
|
push_error("[冒险结构] 令牌消费失败——牌库无此令牌: %s|%s|%s" % [kind, tier, feat_id])
|
||||||
return false
|
return false
|
||||||
if kind == "refresh":
|
if kind == "refresh":
|
||||||
_refresh_stock += value # T4 F-1 修复——刷新券入刷新存量账（冒险级；**退役 _attune_refresh_x 写口**：X 每停点 _reset_refresh_x 重置会吞存量=写错账缺陷正主；摘牌先于落账=选中即消尽，旧早退路径零摘牌缺陷同批修正）
|
_refresh_stock += value # T4 F-1——刷新券入刷新存量账（冒险级；**不写 _attune_refresh_x**：X 每停点 _reset_refresh_x 重置会吞存量；摘牌先于落账=选中即消尽）
|
||||||
_curio_taken["refresh"] = int(_curio_taken.get("refresh", 0)) + 1
|
_curio_taken["refresh"] = int(_curio_taken.get("refresh", 0)) + 1
|
||||||
return true
|
return true
|
||||||
if kind == "rap":
|
if kind == "rap":
|
||||||
@@ -415,9 +413,9 @@ func _apply_curio_pick(kind: String, tier: String, value: int, feat_id: String =
|
|||||||
if not _feats.has(feat_id):
|
if not _feats.has(feat_id):
|
||||||
_feats.append(feat_id)
|
_feats.append(feat_id)
|
||||||
_curio_taken["relic"] = int(_curio_taken.get("relic", 0)) + 1
|
_curio_taken["relic"] = int(_curio_taken.get("relic", 0)) + 1
|
||||||
_curio_taken["relic:" + feat_id] = int(_curio_taken.get("relic:" + feat_id, 0)) + 1 # 迭代 20 T2 案②——身份维已拿计数（cap 消费面）
|
_curio_taken["relic:" + feat_id] = int(_curio_taken.get("relic:" + feat_id, 0)) + 1 # 身份维已拿计数（cap 消费面）
|
||||||
return true
|
return true
|
||||||
# 加算形态路由（内容数据驱动扩展批 T5——match 收敛进效果类型：属性值提升四类走
|
# 加算形态路由（match 收敛进效果类型：属性值提升四类走
|
||||||
# adventure_table.CURIO_APPLY_ROUTES 声明路由（bonus 落点键），加新加算类令牌零代码）
|
# adventure_table.CURIO_APPLY_ROUTES 声明路由（bonus 落点键），加新加算类令牌零代码）
|
||||||
var sink := db.adventure.curio_apply_route(kind)
|
var sink := db.adventure.curio_apply_route(kind)
|
||||||
if sink != "":
|
if sink != "":
|
||||||
@@ -438,7 +436,7 @@ func _apply_curio_pick(kind: String, tier: String, value: int, feat_id: String =
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 从牌库摘除一枚令牌（TP0——选中踢池单点；迭代 12 T1 relic 按 feat_id 精确摘；找不到 = false）
|
# 从牌库摘除一枚令牌（TP0——选中踢池单点；relic 按 feat_id 精确摘；找不到 = false）
|
||||||
func _consume_deck_token(kind: String, tier: String, feat_id: String = "") -> bool:
|
func _consume_deck_token(kind: String, tier: String, feat_id: String = "") -> bool:
|
||||||
for i in _curio_deck.size():
|
for i in _curio_deck.size():
|
||||||
var tok: Dictionary[Variant, Variant] = _curio_deck[i] as Dictionary
|
var tok: Dictionary[Variant, Variant] = _curio_deck[i] as Dictionary
|
||||||
@@ -456,9 +454,9 @@ func feats_held() -> Array:
|
|||||||
return _feats.duplicate()
|
return _feats.duplicate()
|
||||||
|
|
||||||
|
|
||||||
# ---- 商店共享池消费面（迭代 11 第②批 T3——P1 共享池单点账本；TP0 令牌池换代——库存=牌库剩余令牌）----
|
# ---- 商店共享池消费面（共享池单点账本；TP0——库存=牌库剩余令牌）----
|
||||||
|
|
||||||
# 库存余量（TP0：stock = 牌库内该 kind 剩余令牌数——「池消耗即上限」，种类次数上限退役；
|
# 库存余量（TP0：stock = 牌库内该 kind 剩余令牌数——「池消耗即上限」，无种类次数上限；
|
||||||
# 奖励三选一兑付摘牌 与 商店购买消费 由同一 _curio_deck 承载——两渠道跨关共库，全冒险一次性）。
|
# 奖励三选一兑付摘牌 与 商店购买消费 由同一 _curio_deck 承载——两渠道跨关共库，全冒险一次性）。
|
||||||
func pool_stock(kind: String) -> int:
|
func pool_stock(kind: String) -> int:
|
||||||
var n := 0
|
var n := 0
|
||||||
@@ -492,7 +490,7 @@ func _pool_stock_snapshot() -> Dictionary:
|
|||||||
|
|
||||||
|
|
||||||
# 兑付收口（恰一次）：清停点态 → 记已兑付态 → emit → 停点快照（等继续确认——中断续玩不重兑付）。
|
# 兑付收口（恰一次）：清停点态 → 记已兑付态 → emit → 停点快照（等继续确认——中断续玩不重兑付）。
|
||||||
# picked = kind；tier 随载荷（TP0——大小档位读数面）；relic 伴随键随载荷（迭代 12 T1——反馈行取数）
|
# picked = kind；tier 随载荷（TP0——大小档位读数面）；relic 伴随键随载荷（反馈行取数）
|
||||||
func _finish_curio_pick(picked: String, value: int, hp_before: int, tier: String = "", feat_id: String = "") -> void:
|
func _finish_curio_pick(picked: String, value: int, hp_before: int, tier: String = "", feat_id: String = "") -> void:
|
||||||
_curio_pending = {}
|
_curio_pending = {}
|
||||||
_curio_result = {
|
_curio_result = {
|
||||||
@@ -508,7 +506,7 @@ func _finish_curio_pick(picked: String, value: int, hp_before: int, tier: String
|
|||||||
_snapshot_breakpoint()
|
_snapshot_breakpoint()
|
||||||
|
|
||||||
|
|
||||||
# ---- 奖励节点三选一（迭代 10 追加批——用户拍板：与通关三选一共享同池同权重同次数上限）----
|
# ---- 奖励节点三选一（与通关三选一共享同池同权重同次数上限）----
|
||||||
|
|
||||||
# 候选呈现（节点到达时调用——恰一 reward_pick scope 洗牌 + 道具件掷定 scope；本停点断点不载，
|
# 候选呈现（节点到达时调用——恰一 reward_pick scope 洗牌 + 道具件掷定 scope；本停点断点不载，
|
||||||
# 续玩重建到选路停点后重走重抽，恢复的全局计数器保证同候选逐位复现）。
|
# 续玩重建到选路停点后重走重抽，恢复的全局计数器保证同候选逐位复现）。
|
||||||
@@ -518,8 +516,8 @@ func node_curio_candidates() -> Dictionary:
|
|||||||
|
|
||||||
|
|
||||||
func present_node_curio(candidates: Array) -> void:
|
func present_node_curio(candidates: Array) -> void:
|
||||||
_reset_refresh_x() # 迭代 11 第①批 T5b——碰三选一重置 X 余量（不结转）
|
_reset_refresh_x() # 碰三选一重置 X 余量（不结转）
|
||||||
_curio_paid_refreshes = 0 # 付费刷计数随停点清零（对齐商店进店清零——2026-10-06）
|
_curio_paid_refreshes = 0 # 付费刷计数随停点清零（对齐商店进店清零）
|
||||||
_node_curio_pending = {"candidates": candidates.duplicate(true)}
|
_node_curio_pending = {"candidates": candidates.duplicate(true)}
|
||||||
|
|
||||||
|
|
||||||
@@ -551,12 +549,12 @@ func _seed_attune_charges() -> void:
|
|||||||
run_ledger.attune_charges[String(iid)] = maxi(0, int(arow.get("charges_per_adventure", 0)))
|
run_ledger.attune_charges[String(iid)] = maxi(0, int(arow.get("charges_per_adventure", 0)))
|
||||||
|
|
||||||
|
|
||||||
# ---- 三选一刷新（迭代 11 第①批 T5b——P1 甲 X/Y 双源：X=刷新件每碰三选一重给〔优先消耗、不结转〕、
|
# ---- 三选一刷新（X/Y 双源：X=刷新件每碰三选一重给〔优先消耗、不结转〕、
|
||||||
# Y=营地升级行冒险周期池〔用完即无〕；重抽消费 reward_pick 既有洗牌流，池规则全保留——不放回/
|
# Y=营地升级行冒险周期池〔用完即无〕；重抽消费 reward_pick 既有洗牌流，池规则全保留——不放回/
|
||||||
# 达上限剔牌/掷定前置直显；停点可中断）----
|
# 达上限剔牌/掷定前置直显；停点可中断）----
|
||||||
|
|
||||||
func _attune_refresh_x_total() -> int:
|
func _attune_refresh_x_total() -> int:
|
||||||
# 内容数据驱动扩展批 T4——按 id 特判拆除：kind 分发查询（装配集内 effect_kinds 含 bonus_refresh
|
# kind 分发查询（装配集内 effect_kinds 含 bonus_refresh
|
||||||
# 的行 magnitude 合计；刷新件类加件零 id 分支）
|
# 的行 magnitude 合计；刷新件类加件零 id 分支）
|
||||||
var total := 0
|
var total := 0
|
||||||
for iid_v in _attunement:
|
for iid_v in _attunement:
|
||||||
@@ -570,7 +568,7 @@ func _reset_refresh_x() -> void:
|
|||||||
_attune_refresh_x = _attune_refresh_x_total()
|
_attune_refresh_x = _attune_refresh_x_total()
|
||||||
|
|
||||||
|
|
||||||
# 当前可刷新次数（X 优先 + Y 池 + 刷新存量账——呈现层余量读数口；T4 F-1 修复扩第三源）
|
# 当前可刷新次数（X 优先 + Y 池 + 刷新存量账——呈现层余量读数口）
|
||||||
func attune_refresh_left() -> int:
|
func attune_refresh_left() -> int:
|
||||||
return _attune_refresh_x + _attune_refresh_y + _refresh_stock
|
return _attune_refresh_x + _attune_refresh_y + _refresh_stock
|
||||||
|
|
||||||
@@ -593,7 +591,7 @@ func refresh_curio() -> bool:
|
|||||||
return _refresh_curio_common(false)
|
return _refresh_curio_common(false)
|
||||||
|
|
||||||
|
|
||||||
# 三选一 GP 付费刷新（2026-10-06 用户令对齐商店 MC-1——免费位 X/Y 用尽后转付费，同旋钮同曲线同钱包；
|
# 三选一 GP 付费刷新（对齐商店 MC-1——免费位 X/Y 用尽后转付费，同旋钮同曲线同钱包；
|
||||||
# 组合根先经 curio_stop_pending+钱包支出再调，本口只做计数与重抽）。池规则全保留——不放回/达上限剔牌/掷定前置直显。
|
# 组合根先经 curio_stop_pending+钱包支出再调，本口只做计数与重抽）。池规则全保留——不放回/达上限剔牌/掷定前置直显。
|
||||||
func refresh_curio_paid() -> bool:
|
func refresh_curio_paid() -> bool:
|
||||||
return _refresh_curio_common(true)
|
return _refresh_curio_common(true)
|
||||||
@@ -617,7 +615,7 @@ func _refresh_curio_common(paid: bool) -> bool:
|
|||||||
_curio_paid_refreshes += 1
|
_curio_paid_refreshes += 1
|
||||||
else:
|
else:
|
||||||
# 免费位消耗序：X（刷新件每停点重给，优先消耗）→ Y（营地冒险周期池）→ 存量账（刷新券加仓，
|
# 免费位消耗序：X（刷新件每停点重给，优先消耗）→ Y（营地冒险周期池）→ 存量账（刷新券加仓，
|
||||||
# 迭代 20 T4 F-1 修复新账——跨停点持久）
|
# 跨停点持久）
|
||||||
if _attune_refresh_x <= 0 and _attune_refresh_y <= 0 and _refresh_stock <= 0:
|
if _attune_refresh_x <= 0 and _attune_refresh_y <= 0 and _refresh_stock <= 0:
|
||||||
return false
|
return false
|
||||||
if _attune_refresh_x > 0:
|
if _attune_refresh_x > 0:
|
||||||
@@ -631,7 +629,7 @@ func _refresh_curio_common(paid: bool) -> bool:
|
|||||||
_curio_pending["candidates"] = cands.duplicate(true)
|
_curio_pending["candidates"] = cands.duplicate(true)
|
||||||
var payload: Dictionary[Variant, Variant] = (_curio_pending.get("payload", {}) as Dictionary).duplicate(true)
|
var payload: Dictionary[Variant, Variant] = (_curio_pending.get("payload", {}) as Dictionary).duplicate(true)
|
||||||
payload["candidates"] = cands
|
payload["candidates"] = cands
|
||||||
payload["refreshed"] = true # 重发载荷带标——呈现层直落选择面，不再重开胜利总结面（2026-10-06）
|
payload["refreshed"] = true # 重发载荷带标——呈现层直落选择面，不再重开胜利总结面
|
||||||
curio_choice_presented.emit(payload) # 同信号重 present（零自动推进契约不破——停点仍在途）
|
curio_choice_presented.emit(payload) # 同信号重 present（零自动推进契约不破——停点仍在途）
|
||||||
_snapshot_breakpoint()
|
_snapshot_breakpoint()
|
||||||
return true
|
return true
|
||||||
@@ -660,13 +658,13 @@ func _finish_node_bonus(picked: String, value: int, tier: String = "", feat_id:
|
|||||||
# kind 出现率∝剩余令牌数〔档位配额即分布——无独立权重 knob〕；抽签不摘牌、兑付才摘牌=未选
|
# kind 出现率∝剩余令牌数〔档位配额即分布——无独立权重 knob〕；抽签不摘牌、兑付才摘牌=未选
|
||||||
# 自动回池；池耗即枯竭——余库不足 N kind 时出齐剩余，空库 = 零候选合法态）。候选 = 令牌字典
|
# 自动回池；池耗即枯竭——余库不足 N kind 时出齐剩余，空库 = 零候选合法态）。候选 = 令牌字典
|
||||||
# {"kind","tier"}。消费 reward_pick 封闭流——一次停点恰一 scope，同种子同候选。
|
# {"kind","tier"}。消费 reward_pick 封闭流——一次停点恰一 scope，同种子同候选。
|
||||||
# 渠道白名单过滤（迭代 15 卡② T4——渠道轴定位：关底 Boss 击败＝通关渠道只出专长（feat 令牌）；
|
# 渠道白名单过滤（渠道轴定位：关底 Boss 击败＝通关渠道只出专长（feat 令牌）；
|
||||||
# 奖励节点/商店只出属性值提升+资源（非 relic 令牌），专长在非 Boss 渠道只以门票形态出现（T5）。
|
# 奖励节点/商店只出属性值提升+资源（非 relic 令牌），专长在非 Boss 渠道只以门票形态出现（T5）。
|
||||||
# 过滤式而非物理拆池：deck 物理结构/存档键 bonus_deck 混编余库/消耗语义（选中踢池未选回池）原样，
|
# 过滤式而非物理拆池：deck 物理结构/存档键 bonus_deck 混编余库/消耗语义（选中踢池未选回池）原样，
|
||||||
# 白名单在候选视图层生效——配额结构锚 TIER_QUOTAS 70/25/3=98 零改动（专长令牌本系活行追加面，在锚外）。
|
# 白名单在候选视图层生效——配额结构锚 TIER_QUOTAS 70/25/3=98 零改动（专长令牌本系活行追加面，在锚外）。
|
||||||
# 迭代 20 T2 案D 换代——曝光槽：非 Boss 渠道三选一 = **2 格全池 + 1 格优秀档以上子池**
|
# 曝光槽：非 Boss 渠道三选一 = **2 格全池 + 1 格优秀档以上子池**
|
||||||
# （rank≥excellent；子池空该格回退全池；池空直通同族兜底）；凭证（feat_ticket）不进子池
|
# （rank≥excellent；子池空该格回退全池；池空直通同族兜底）；凭证（feat_ticket）不进子池
|
||||||
# 〔独立计数体系〕；已拿上限 cap（案②提前退役）：taken≥cap 的身份在候选视图剔除〔牌库本体不动，
|
# 〔独立计数体系〕；已拿上限 cap：taken≥cap 的身份在候选视图剔除〔牌库本体不动，
|
||||||
# 拿了才计、刷出不计——_curio_cap_ok〕。
|
# 拿了才计、刷出不计——_curio_cap_ok〕。
|
||||||
func _draw_curio_candidates(channel: String = "reward_node") -> Array:
|
func _draw_curio_candidates(channel: String = "reward_node") -> Array:
|
||||||
var pool := _curio_deck.duplicate()
|
var pool := _curio_deck.duplicate()
|
||||||
@@ -681,8 +679,8 @@ func _draw_curio_candidates(channel: String = "reward_node") -> Array:
|
|||||||
return _curio_cap_ok(String(t.get("kind", "")), String(t.get("feat_id", ""))))
|
return _curio_cap_ok(String(t.get("kind", "")), String(t.get("feat_id", ""))))
|
||||||
var rg: RandomNumberGenerator = rng.open_stream("reward_pick")
|
var rg: RandomNumberGenerator = rng.open_stream("reward_pick")
|
||||||
if channel == "level_clear":
|
if channel == "level_clear":
|
||||||
# 迭代 20 T5——Boss 渠道按档配比加权抽取（无放回加权抽：逐席按 boss_feat_weight 掷点，
|
# Boss 渠道按档配比加权抽取（无放回加权抽：逐席按 boss_feat_weight 掷点，
|
||||||
# 身份去重照旧；rarity 语义约束兑付面——奇物.md v3.1，配比数值归调参批）
|
# 身份去重；rarity 语义约束兑付面——奇物.md v3.1，配比数值归 adventure 表）
|
||||||
var out_w: Array[Variant] = []
|
var out_w: Array[Variant] = []
|
||||||
var seen_w: Array[Variant] = []
|
var seen_w: Array[Variant] = []
|
||||||
var want_w := int(db.adventure.curio_candidate_count)
|
var want_w := int(db.adventure.curio_candidate_count)
|
||||||
@@ -754,7 +752,7 @@ func _draw_curio_candidates(channel: String = "reward_node") -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# 已拿上限判定（迭代 20 T2 案②——身份维度：kind 走 curio_cap、relic 走 feats 行 cap 字段；
|
# 已拿上限判定（身份维度：kind 走 curio_cap、relic 走 feats 行 cap 字段；
|
||||||
# taken 只在兑付时 +1〔拿了才计〕、刷出不计）。缺省放行=白名单外 kind 兜底。
|
# taken 只在兑付时 +1〔拿了才计〕、刷出不计）。缺省放行=白名单外 kind 兜底。
|
||||||
func _curio_cap_ok(kind: String, feat_id: String = "") -> bool:
|
func _curio_cap_ok(kind: String, feat_id: String = "") -> bool:
|
||||||
var cap := 99
|
var cap := 99
|
||||||
@@ -768,7 +766,7 @@ func _curio_cap_ok(kind: String, feat_id: String = "") -> bool:
|
|||||||
return int(_curio_taken.get(kind, 0)) < cap
|
return int(_curio_taken.get(kind, 0)) < cap
|
||||||
|
|
||||||
|
|
||||||
# —— 专长获取门票（T5 迭代 15 卡②——非 Boss 渠道的专长入口；四口径契约④：拿到即开不可囤积/
|
# —— 专长获取门票（T5——非 Boss 渠道的专长入口；四口径契约④：拿到即开不可囤积/
|
||||||
# 罕见只在概率不在价格/一局限购一次/计步保底连续 5 展示未出第 6 必出——计数=展示次数、刷新
|
# 罕见只在概率不在价格/一局限购一次/计步保底连续 5 展示未出第 6 必出——计数=展示次数、刷新
|
||||||
# 重展计入、节点与商店共享、触发清零、限购满不再触发。调用即一次展示判定与记账）——
|
# 重展计入、节点与商店共享、触发清零、限购满不再触发。调用即一次展示判定与记账）——
|
||||||
func _feat_ticket_consider(rg: RandomNumberGenerator) -> bool:
|
func _feat_ticket_consider(rg: RandomNumberGenerator) -> bool:
|
||||||
@@ -806,7 +804,7 @@ func _redeem_feat_ticket() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# Boss 钥石逐杀掉落（迭代 10——渠道改 Boss/精英击杀掉落；首杀/复杀两档读 meta.tres boss_keystone；
|
# Boss 钥石逐杀掉落（掉落渠道 = Boss/精英击杀；首杀/复杀两档读 meta.tres boss_keystone；
|
||||||
# 首杀判据 = 存档 boss_first_kill 标记位〔断点未注入 = 恒首杀——模拟/冒烟零扰动；标记仍在收束
|
# 首杀判据 = 存档 boss_first_kill 标记位〔断点未注入 = 恒首杀——模拟/冒烟零扰动；标记仍在收束
|
||||||
# apply_adventure_summary 逐通关关次置位〕；末关 Boss 照常入账；明细随摘要 additive 键供结算面归因）
|
# apply_adventure_summary 逐通关关次置位〕；末关 Boss 照常入账；明细随摘要 additive 键供结算面归因）
|
||||||
func _boss_keystone_drop(li: int) -> void:
|
func _boss_keystone_drop(li: int) -> void:
|
||||||
@@ -834,7 +832,7 @@ func abandon() -> bool:
|
|||||||
|
|
||||||
# ---- 关卡推进（私有——序列编排单一出口）----
|
# ---- 关卡推进（私有——序列编排单一出口）----
|
||||||
|
|
||||||
# 树限次计数按关重置（迭代 21 T3——危险直觉锋/守两组「每关限次」账本键：跨战持久由 adventure
|
# 树限次计数按关重置（危险直觉锋/守两组「每关限次」账本键：跨战持久由 adventure
|
||||||
# 域导出/回灌承载，此处随关清零闭合生命周期四态；键集=效果引擎树合成行声明的 counter_id；
|
# 域导出/回灌承载，此处随关清零闭合生命周期四态；键集=效果引擎树合成行声明的 counter_id；
|
||||||
# 独立成口=V10 断言面直呼）
|
# 独立成口=V10 断言面直呼）
|
||||||
func _reset_tree_limited_counters() -> void:
|
func _reset_tree_limited_counters() -> void:
|
||||||
@@ -854,38 +852,38 @@ func _start_current_level() -> bool:
|
|||||||
_runner.wallet_changed.connect(_forward_wallet_changed)
|
_runner.wallet_changed.connect(_forward_wallet_changed)
|
||||||
_runner.level_finished.connect(_on_level_finished)
|
_runner.level_finished.connect(_on_level_finished)
|
||||||
_runner.set_hero_override(int(_override[0]), int(_override[1]))
|
_runner.set_hero_override(int(_override[0]), int(_override[1]))
|
||||||
# 断点续玩分支（迭代 8 卡①）：模板随快照强制（已抽模板零重抽零 RNG）、resume_state 带
|
# 断点续玩分支：模板随快照强制（已抽模板零重抽零 RNG）、resume_state 带
|
||||||
# 停点节点与已到序——重建到停点后经 present_resumed_choice 呈现（信号顺序契约同入口）。
|
# 停点节点与已到序——重建到停点后经 present_resumed_choice 呈现（信号顺序契约同入口）。
|
||||||
var resume_state: Dictionary[Variant, Variant] = {}
|
var resume_state: Dictionary[Variant, Variant] = {}
|
||||||
var template_pick: int = 0 if _first_script else -1 # 首次脚本 = 每关固定模板 0 零抽签（v0.4 拍板点①）；否则逐关抽签
|
var template_pick: int = 0 if _first_script else -1 # 首次脚本 = 每关固定模板 0 零抽签；否则逐关抽签
|
||||||
if not _resume_bp.is_empty():
|
if not _resume_bp.is_empty():
|
||||||
resume_state = {"node_id": int(_resume_bp.get("node_id", -1)),
|
resume_state = {"node_id": int(_resume_bp.get("node_id", -1)),
|
||||||
"visited_ids": _resume_bp.get("visited_ids", []) as Array}
|
"visited_ids": _resume_bp.get("visited_ids", []) as Array}
|
||||||
template_pick = int(_resume_bp.get("template_pick", -1))
|
template_pick = int(_resume_bp.get("template_pick", -1))
|
||||||
# 接口①开始关卡：生命经共享账本交接（账本当前值即开局生命——冒险开始置满 / 大奖励回满已写好）；
|
# 接口①开始关卡：生命经共享账本交接（账本当前值即开局生命——冒险开始置满 / 大奖励回满已写好）；
|
||||||
# _base_override 共享引用随载荷传入（永久强化 flat——LevelRunner.effective_* 叠加序第二项）。
|
# _base_override 共享引用随载荷传入（永久强化 flat——LevelRunner.effective_* 叠加序第二项）。
|
||||||
# 停点前移批 2026-09-23：defer_entry=true 起每关（含首关）——先 emit level_started（呈现层在
|
# defer_entry=true 起每关（含首关）——先 emit level_started（呈现层在
|
||||||
# 该回调重取 runner 实例），后入口候选呈现；顺序反了选路口会被呈现层的 runner 空防御静默丢弃。
|
# 该回调重取 runner 实例），后入口候选呈现；顺序反了选路口会被呈现层的 runner 空防御静默丢弃。
|
||||||
# 呈现零 RNG 消耗、pick 走同一 _enter_node——测量面逐位零漂移。
|
# 呈现零 RNG 消耗、pick 走同一 _enter_node——测量面逐位零漂移。
|
||||||
_runner.set_run_ledger(run_ledger) # 迭代 27 T3——共享四账单类下传（原四 setter/参数散传收口；run_ledger=四账类，ledger=关卡账沿用旧名）
|
_runner.set_run_ledger(run_ledger) # 共享四账单类下传（run_ledger=四账类，ledger=关卡账）
|
||||||
_runner.sync_attune_inventory() # 迭代 11 第①批 T6 原语义——能力件骑库存面注入（随账下传同拍）
|
_runner.sync_attune_inventory() # 能力件骑库存面注入（随账下传同拍）
|
||||||
var ok: bool = _runner.start_level_external(level_index, ledger, purchased,
|
var ok: bool = _runner.start_level_external(level_index, ledger, purchased,
|
||||||
apply_rest, _base_override, true, template_pick, resume_state)
|
apply_rest, _base_override, true, template_pick, resume_state)
|
||||||
if ok:
|
if ok:
|
||||||
_runner.set_attunement(_attunement) # 迭代 11 第①批 T5——同调装配下传（enc 携带进战斗结算）
|
_runner.set_attunement(_attunement) # 同调装配下传（enc 携带进战斗结算）
|
||||||
_runner.set_feats(_feats) # 迭代 12 T1——特性持有集下传（begin_battle enc.feats 求值面）
|
_runner.set_feats(_feats) # 特性持有集下传（begin_battle enc.feats 求值面）
|
||||||
_runner.set_tree_rules(_tree_rules) # 迭代 12 T10——树 rule 键集下传（A/B 面消费）
|
_runner.set_tree_rules(_tree_rules) # 树 rule 键集下传（A/B 面消费）
|
||||||
_runner.set_hero_axes(hero_attack_type, hero_armor_type) # 迭代 23 T4——两根类型轴快照下传（effective_ac 甲型基础 AC 层+enc 携带进 spawn）
|
_runner.set_hero_axes(hero_attack_type, hero_armor_type) # 两根类型轴快照下传（effective_ac 甲型基础 AC 层+enc 携带进 spawn）
|
||||||
if _shop_mode == "pool":
|
if _shop_mode == "pool":
|
||||||
# 商店共享池注入（迭代 11 第②批 T3——库存账本引用+消费 handler 双下传；legacy 模式零注入零扰动。
|
# 商店共享池注入（库存账本引用+消费 handler 双下传；legacy 模式零注入零扰动。
|
||||||
# 迭代 20 T2——cap 检查回调四参注入）
|
# cap 检查回调四参注入）
|
||||||
_runner.set_shop_pool(_curio_deck, _consume_pool_purchase, _feat_ticket_consider, _curio_cap_ok)
|
_runner.set_shop_pool(_curio_deck, _consume_pool_purchase, _feat_ticket_consider, _curio_cap_ok)
|
||||||
# 迭代 20 T4——凭证件三账注入（节点级/回合级一次性：注入即清零，未用即过期=寿命档语义）
|
# 凭证件三账注入（节点级/回合级一次性：注入即清零，未用即过期=寿命档语义）
|
||||||
_runner.set_voucher_grants(_pending_rap, _time_sand_queue)
|
_runner.set_voucher_grants(_pending_rap, _time_sand_queue)
|
||||||
_pending_rap = 0
|
_pending_rap = 0
|
||||||
_time_sand_queue = 0
|
_time_sand_queue = 0
|
||||||
# 三选一道具件跨关携带注入（迭代 10）——迭代 11 第①批 T7 退役：aux 卡出池后 carry 恒空集，
|
# 三选一道具件跨关携带注入面不存在（aux 卡不在池种内→ carry 恒空集；
|
||||||
# 注入面随停点渠道退役拆除（容器字段保留=替换子交互机械惰性承载，零投放零行为）
|
# 容器字段保留=替换子交互惰性承载，零投放零行为）
|
||||||
level_started.emit(level_index, String(_runner.level_row.get("display_name", "")))
|
level_started.emit(level_index, String(_runner.level_row.get("display_name", "")))
|
||||||
# 入口停点断点（node_id=-1）与 defer_entry 同态（node_index=-1+单候选）——走入口呈现；
|
# 入口停点断点（node_id=-1）与 defer_entry 同态（node_index=-1+单候选）——走入口呈现；
|
||||||
# 中途停点（node_id>=0）走停点呈现（restore_treasure_items 先于呈现=C 区库存就位）。
|
# 中途停点（node_id>=0）走停点呈现（restore_treasure_items 先于呈现=C 区库存就位）。
|
||||||
@@ -912,20 +910,20 @@ func _on_level_finished(payload: Dictionary) -> void:
|
|||||||
if result != "victory":
|
if result != "victory":
|
||||||
push_error("[冒险结构] 关卡结束结果出域: %s" % result)
|
push_error("[冒险结构] 关卡结束结果出域: %s" % result)
|
||||||
return
|
return
|
||||||
_last_treasure_cleared = int(payload.get("aux_cleared", 0)) # additive（迭代 7 T4——末关 summary 取数面）
|
_last_treasure_cleared = int(payload.get("aux_cleared", 0)) # additive（末关 summary 取数面）
|
||||||
# Boss 钥石逐杀掉落（迭代 10——渠道改击杀掉落，末关照常入账；首杀/复杀读 meta.tres boss_keystone）
|
# Boss 钥石逐杀掉落（击杀掉落渠道，末关照常入账；首杀/复杀读 meta.tres boss_keystone）
|
||||||
_boss_keystone_drop(level_index)
|
_boss_keystone_drop(level_index)
|
||||||
if level_index < levels_total:
|
if level_index < levels_total:
|
||||||
# 通关兑付（非末关恰一次；迭代 10 三层奖励框架）：部分回血先行 → 加权洗牌掷 3 → 三选一停点
|
# 通关兑付（非末关恰一次；三层奖励框架）：部分回血先行 → 加权洗牌掷 3 → 三选一停点
|
||||||
#（顺序即契约——回血按当刻账本与上限结算，选择停点零自动推进）
|
#（顺序即契约——回血按当刻账本与上限结算，选择停点零自动推进）
|
||||||
var hp_before := int(ledger.get("hero_hp", 0))
|
var hp_before := int(ledger.get("hero_hp", 0))
|
||||||
var max_eff := effective_max_hp() # T17 修复：回血封顶口径含调试浮窗 pct（同战斗内上限）
|
var max_eff := effective_max_hp() # 回血封顶口径含调试浮窗 pct（同战斗内上限）
|
||||||
var heal := mini(int(floor(float(max_eff) * float(int(db.adventure.clear_heal_pct)) / 100.0)), max_eff - hp_before)
|
var heal := mini(int(floor(float(max_eff) * float(int(db.adventure.clear_heal_pct)) / 100.0)), max_eff - hp_before)
|
||||||
ledger["hero_hp"] = hp_before + heal
|
ledger["hero_hp"] = hp_before + heal
|
||||||
# 置位先于 emit（信号同步派发——处理器内立即确认时 _pending_next_level 必须已就位）
|
# 置位先于 emit（信号同步派发——处理器内立即确认时 _pending_next_level 必须已就位）
|
||||||
_pending_next_level = true
|
_pending_next_level = true
|
||||||
_reset_refresh_x() # 迭代 11 第①批 T5b——碰三选一重置 X 余量（不结转）
|
_reset_refresh_x() # 碰三选一重置 X 余量（不结转）
|
||||||
_curio_paid_refreshes = 0 # 付费刷计数随停点清零（对齐商店进店清零——2026-10-06）
|
_curio_paid_refreshes = 0 # 付费刷计数随停点清零（对齐商店进店清零）
|
||||||
var pick_payload: Dictionary[Variant, Variant] = {
|
var pick_payload: Dictionary[Variant, Variant] = {
|
||||||
"level_index": level_index,
|
"level_index": level_index,
|
||||||
"candidates": _draw_curio_candidates("level_clear"), # T4 渠道白名单——关底 Boss 击败＝通关渠道只出专长
|
"candidates": _draw_curio_candidates("level_clear"), # T4 渠道白名单——关底 Boss 击败＝通关渠道只出专长
|
||||||
@@ -935,7 +933,7 @@ func _on_level_finished(payload: Dictionary) -> void:
|
|||||||
"keystone_gained": int(_keystone_drops.back().get("amount", 0)) if not _keystone_drops.is_empty() else 0,
|
"keystone_gained": int(_keystone_drops.back().get("amount", 0)) if not _keystone_drops.is_empty() else 0,
|
||||||
"keystone_total": keystone,
|
"keystone_total": keystone,
|
||||||
"gp": int(ledger.get("gp", 0)),
|
"gp": int(ledger.get("gp", 0)),
|
||||||
"aux_cleared": int(payload.get("aux_cleared", 0)), # additive 扩签（迭代 7 T4——关卡末清空反馈取数）
|
"aux_cleared": int(payload.get("aux_cleared", 0)), # additive 扩签（关卡末清空反馈取数）
|
||||||
}
|
}
|
||||||
_curio_pending = {"candidates": (pick_payload["candidates"] as Array).duplicate(true),
|
_curio_pending = {"candidates": (pick_payload["candidates"] as Array).duplicate(true),
|
||||||
"payload": pick_payload.duplicate(true)}
|
"payload": pick_payload.duplicate(true)}
|
||||||
@@ -955,13 +953,13 @@ func _settle(result: String) -> void:
|
|||||||
"stopped_at": 0 if result == "completed" else level_index,
|
"stopped_at": 0 if result == "completed" else level_index,
|
||||||
"keystone_total": keystone,
|
"keystone_total": keystone,
|
||||||
"master_seed": master_seed,
|
"master_seed": master_seed,
|
||||||
"aux_cleared_last": _last_treasure_cleared, # additive 扩签（迭代 7 T4——末关清空反馈；非末关走 bonus 载荷）
|
"aux_cleared_last": _last_treasure_cleared, # additive 扩签（末关清空反馈；非末关走 bonus 载荷）
|
||||||
"keystone_drops": _keystone_drops.duplicate(true), # additive 扩签（迭代 10——逐杀掉落明细；settle 入账明细/复盘归因数据源）
|
"keystone_drops": _keystone_drops.duplicate(true), # additive 扩签（逐杀掉落明细；settle 入账明细/复盘归因数据源）
|
||||||
"vision_used_delta": int(run_ledger.vision_counter.get("used", 0)), # additive 扩签（迭代 22 秘宝批 T3——真视使用本局计数；settle 聚合入档）
|
"vision_used_delta": int(run_ledger.vision_counter.get("used", 0)), # additive 扩签（真视使用本局计数；settle 聚合入档）
|
||||||
"pool_stock": _pool_stock_snapshot(), # additive 扩签（迭代 11 第②批 T5——终局池读数：清账前快照，商店买走 vs 奖励领走 vs 枯竭的终局面）
|
"pool_stock": _pool_stock_snapshot(), # additive 扩签（终局池读数：清账前快照，商店买走 vs 奖励领走 vs 枯竭的终局面）
|
||||||
"relics": _feats.duplicate(), # additive 扩签（迭代 12 T1——特性终局持有集：清账前快照，成型判读取数面）
|
"relics": _feats.duplicate(), # additive 扩签（特性终局持有集：清账前快照，成型判读取数面）
|
||||||
}
|
}
|
||||||
# 败退明细（数值验证工具取数面 2026-09-22——tools/balance_verifier.py 止步节点分布数据源；
|
# 败退明细（数值验证工具取数面——tools/balance_verifier.py 止步节点分布数据源；
|
||||||
# 仅失败局附加，键缺省 = 未败退，既有五件事消费方零感知）
|
# 仅失败局附加，键缺省 = 未败退，既有五件事消费方零感知）
|
||||||
if result == "failed" and not _last_level_payload.is_empty():
|
if result == "failed" and not _last_level_payload.is_empty():
|
||||||
summary["defeat"] = {
|
summary["defeat"] = {
|
||||||
@@ -970,11 +968,11 @@ func _settle(result: String) -> void:
|
|||||||
"node_type": String(_last_level_payload.get("node_type", "")),
|
"node_type": String(_last_level_payload.get("node_type", "")),
|
||||||
}
|
}
|
||||||
if _runner != null:
|
if _runner != null:
|
||||||
summary["gp_final"] = int(_runner.gp) # gp_final 清账前快照（迭代 27 T3——P1-3 GP 影子账收口：终局面板取数源，影子账随批退役）
|
summary["gp_final"] = int(_runner.gp) # gp_final 清账前快照（终局面板取数源=runner 钱包单点）
|
||||||
_runner.close_wallet() # GP 冒险收束清零（三结局都清——经转发发 wallet_changed "clear" 供日志/呈现）
|
_runner.close_wallet() # GP 冒险收束清零（三结局都清——经转发发 wallet_changed "clear" 供日志/呈现）
|
||||||
_reset_curio_state() # 三选一停点态收束清零（结算受理只算一次语义——重复宣布零变化）
|
_reset_curio_state() # 三选一停点态收束清零（结算受理只算一次语义——重复宣布零变化）
|
||||||
if _save_manager != null:
|
if _save_manager != null:
|
||||||
_save_manager.clear_breakpoint() # 三结局清断点（迭代 8 卡①/T3——退出冒险=放弃流程+清除断点）
|
_save_manager.clear_breakpoint() # 三结局清断点（退出冒险=放弃流程+清除断点）
|
||||||
_save_manager.write_to_disk()
|
_save_manager.write_to_disk()
|
||||||
_state = State.SETTLING
|
_state = State.SETTLING
|
||||||
adventure_finished.emit(summary)
|
adventure_finished.emit(summary)
|
||||||
@@ -989,12 +987,12 @@ func _forward_node_entered(node: Dictionary, info: Dictionary) -> void:
|
|||||||
|
|
||||||
func _forward_choices_presented(candidates: Array) -> void:
|
func _forward_choices_presented(candidates: Array) -> void:
|
||||||
choices_presented.emit(candidates)
|
choices_presented.emit(candidates)
|
||||||
_snapshot_breakpoint() # 停点快照（迭代 8 卡①——选路停点=唯一可恢复停点形态；战斗中不存）
|
_snapshot_breakpoint() # 停点快照（选路停点=唯一可恢复停点形态；战斗中不存）
|
||||||
|
|
||||||
|
|
||||||
# ---- 断点快照（迭代 8 卡①——七字段拍板面+恢复必需附随件）----
|
# ---- 断点快照（七字段契约面+恢复必需附随件）----
|
||||||
# 七字段（拍板面）：关卡序号/节点位/生命/属性加成区/GP 钱包/商店已购档/已抽模板；
|
# 七字段（契约面）：关卡序号/节点位/生命/属性加成区/GP 钱包/商店已购档/已抽模板；
|
||||||
# 附随件（续玩正确性必需，随批注记）：主种子+取数计数器（rng 快照契约回填——续接原时间线）、
|
# 附随件（续玩正确性必需）：主种子+取数计数器（rng 快照契约回填——续接原时间线）、
|
||||||
# 钥石累计（大奖励中途值——终局摘要五件事不失真）、已到节点序（呈现层图条重建）、道具库存
|
# 钥石累计（大奖励中途值——终局摘要五件事不失真）、已到节点序（呈现层图条重建）、道具库存
|
||||||
# （奖励节点已选件——防静默丢失）。注入缺省 null = 整面静默（模拟/冒烟零扰动）。
|
# （奖励节点已选件——防静默丢失）。注入缺省 null = 整面静默（模拟/冒烟零扰动）。
|
||||||
func _snapshot_breakpoint() -> void:
|
func _snapshot_breakpoint() -> void:
|
||||||
@@ -1004,7 +1002,7 @@ func _snapshot_breakpoint() -> void:
|
|||||||
if _runner != null and _runner.treasure_inventory != null:
|
if _runner != null and _runner.treasure_inventory != null:
|
||||||
treasure_snapshot = _runner.treasure_inventory.snapshot_inventory()
|
treasure_snapshot = _runner.treasure_inventory.snapshot_inventory()
|
||||||
# 三选一停点续玩分支 _runner 为 null（关卡已收束、下一关未开）——节点域字段按缺省落档，
|
# 三选一停点续玩分支 _runner 为 null（关卡已收束、下一关未开）——节点域字段按缺省落档，
|
||||||
# 该两态的续玩只消费 bonus_* 附随件（选择停点/已兑付停点快照，迭代 10）
|
# 该两态的续玩只消费 bonus_* 附随件（选择停点/已兑付停点快照）
|
||||||
var bp: Dictionary[Variant, Variant] = {
|
var bp: Dictionary[Variant, Variant] = {
|
||||||
"level_index": level_index,
|
"level_index": level_index,
|
||||||
"node_id": _runner.current_node_id() if _runner != null else -1,
|
"node_id": _runner.current_node_id() if _runner != null else -1,
|
||||||
@@ -1017,9 +1015,9 @@ func _snapshot_breakpoint() -> void:
|
|||||||
},
|
},
|
||||||
"gp": int(ledger.get("gp", 0)),
|
"gp": int(ledger.get("gp", 0)),
|
||||||
"shop_purchased": purchased.duplicate(true),
|
"shop_purchased": purchased.duplicate(true),
|
||||||
"shop_shelf": _runner.shop_bp_shelf() if _runner != null else [], # 迭代 11 第②批 T2——P2 甲货架入断点（离开店/非店停点 = 空架合法态）
|
"shop_shelf": _runner.shop_bp_shelf() if _runner != null else [], # 货架入断点（离开店/非店停点 = 空架合法态）
|
||||||
"shop_visit_buys": _runner.shop_bp_visit_buys() if _runner != null else 0, # 迭代 11 第②批 T2——本次进店已购次数（A 链定价输入，P2 甲扩列）
|
"shop_visit_buys": _runner.shop_bp_visit_buys() if _runner != null else 0, # 本次进店已购次数（A 链定价输入）
|
||||||
"attunement_charges": run_ledger.attune_charges.duplicate(true), # 迭代 11 第①批 T6——同调主动件充能余量随断点（save v4 域）
|
"attunement_charges": run_ledger.attune_charges.duplicate(true), # 同调主动件充能余量随断点（save v4 域）
|
||||||
"template_pick": _runner.active_template_index if _runner != null else -1,
|
"template_pick": _runner.active_template_index if _runner != null else -1,
|
||||||
"master_seed": master_seed,
|
"master_seed": master_seed,
|
||||||
"rng_counter": rng.counter(),
|
"rng_counter": rng.counter(),
|
||||||
@@ -1028,16 +1026,16 @@ func _snapshot_breakpoint() -> void:
|
|||||||
"aux_items": treasure_snapshot,
|
"aux_items": treasure_snapshot,
|
||||||
"bonus_taken": _curio_taken.duplicate(true), # 三选一件获取次数（kind 维度派生账本——断点附随件与读数承载）
|
"bonus_taken": _curio_taken.duplicate(true), # 三选一件获取次数（kind 维度派生账本——断点附随件与读数承载）
|
||||||
"bonus_deck": _curio_deck.duplicate(true), # 令牌池余库（TP0 v2.2——池消耗即上限，续玩余库逐枚还原）
|
"bonus_deck": _curio_deck.duplicate(true), # 令牌池余库（TP0 v2.2——池消耗即上限，续玩余库逐枚还原）
|
||||||
"relics": _feats.duplicate(), # 特性持有集（迭代 12 T1——局内随机渠道获得态续玩防丢失）
|
"relics": _feats.duplicate(), # 特性持有集（局内随机渠道获得态续玩防丢失）
|
||||||
"bonus_pending": _curio_pending.duplicate(true), # 三选一停点态（空 = 无停点——选择停点可中断契约）
|
"bonus_pending": _curio_pending.duplicate(true), # 三选一停点态（空 = 无停点——选择停点可中断契约）
|
||||||
"feat_ticket_pity": _feat_ticket_pity, # T5 门票保底计数（扩列向后兼容——旧档缺键缺省 0）
|
"feat_ticket_pity": _feat_ticket_pity, # T5 门票保底计数（扩列向后兼容——旧档缺键缺省 0）
|
||||||
"feat_ticket_sold": _feat_ticket_sold, # T5 门票限购计数（同上）
|
"feat_ticket_sold": _feat_ticket_sold, # T5 门票限购计数（同上）
|
||||||
"adventure_counters": run_ledger.adventure_counters.duplicate(true), # 迭代 20 T6/T7——adventure 域计数器随断点（续玩跨战账不丢）
|
"adventure_counters": run_ledger.adventure_counters.duplicate(true), # adventure 域计数器随断点（续玩跨战账不丢）
|
||||||
"vision_counter_used": int(run_ledger.vision_counter.get("used", 0)), # 迭代 22 秘宝批 T3——真视使用计数随断点（续玩跨战账不丢）
|
"vision_counter_used": int(run_ledger.vision_counter.get("used", 0)), # 真视使用计数随断点（续玩跨战账不丢）
|
||||||
"refresh_stock": _refresh_stock, # 迭代 20 T4/T7——刷新存量账随断点（F-1 新账）
|
"refresh_stock": _refresh_stock, # 刷新存量账随断点
|
||||||
"attune_refresh_y": _attune_refresh_y, # 2026-10-13 缺陷修批——Y 冒险周期池余量随断点（续玩不再自参数面整额重注入=堵「用完退菜单再续玩满血复活」可利用漏洞；扩列向后兼容——旧档缺键回退参数面）
|
"attune_refresh_y": _attune_refresh_y, # Y 冒险周期池余量随断点（续玩不再自参数面整额重注入=堵「用完退菜单再续玩满血复活」可利用漏洞；扩列向后兼容——旧档缺键回退参数面）
|
||||||
"bonus_result": _curio_result.duplicate(true), # 已兑付待推进态（空 = 无——中断续玩不重兑付）
|
"bonus_result": _curio_result.duplicate(true), # 已兑付待推进态（空 = 无——中断续玩不重兑付）
|
||||||
"keystone_drops": _keystone_drops.duplicate(true), # 逐杀掉落明细（摘要归因续接——迭代 10）
|
"keystone_drops": _keystone_drops.duplicate(true), # 逐杀掉落明细（摘要归因续接）
|
||||||
}
|
}
|
||||||
_save_manager.set_breakpoint(bp)
|
_save_manager.set_breakpoint(bp)
|
||||||
_save_manager.write_to_disk()
|
_save_manager.write_to_disk()
|
||||||
|
|||||||
+140
-144
@@ -7,28 +7,26 @@ class_name BattleOrchestrator
|
|||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
signal step_row(row: Dictionary)
|
signal step_row(row: Dictionary)
|
||||||
signal battle_finished(payload: Dictionary) # {result, hero_hp, gp_dropped}——hero 在 despawn 前捕获（呈现层销毁后读状态的时序防护）；gp_dropped = 战斗掉落合计（GP+商店房实施批 2026-09-21）
|
signal battle_finished(payload: Dictionary) # {result, hero_hp, gp_dropped}——hero 在 despawn 前捕获（呈现层销毁后读状态的时序防护）；gp_dropped = 战斗掉落合计
|
||||||
signal round_started(round_index: int)
|
signal round_started(round_index: int)
|
||||||
signal board_changed()
|
signal board_changed()
|
||||||
signal settlement_snapshot(snap: Dictionary) # 每结算末尾的全量状态快照（playtest_logger 消费——JSONL 数值分析）
|
signal settlement_snapshot(snap: Dictionary) # 每结算末尾的全量状态快照（playtest_logger 消费——JSONL 数值分析）
|
||||||
|
|
||||||
# 明细流水行型协议（战斗结算 Core Rule；9 类——2026-09-20 伏击单轮上限退役，溢出未生效行 overflow 随之下线；
|
# 明细流水行型协议（战斗结算 Core Rule；9 类；
|
||||||
# 2026-09-15 格面资源批由 15 类收拢，清单改动须同步 battle_log_view 的 _format_row 与本文档头注）：
|
# 清单改动须同步 battle_log_view 的 _format_row 与本文档头注）：
|
||||||
# 效果行 effect · 伤害行 damage · 治疗行 heal ·
|
# 效果行 effect · 伤害行 damage · 治疗行 heal ·
|
||||||
# 奖励未生效行 reward_ineffective · 封印未中行 seal_miss · 施放行 cast（敌人技能池批由蓄力行 charge 改型）· 衰减行 decay ·
|
# 奖励未生效行 reward_ineffective · 封印未中行 seal_miss · 施放行 cast · 衰减行 decay ·
|
||||||
# 判定行 verdict · 高光行 highlight
|
# 判定行 verdict · 高光行 highlight
|
||||||
# 行来源断言豁免集合（行型层）——判定段 / 衰减段本就无棋盘来源，勿一刀切误炸
|
# 行来源断言豁免集合（行型层）——判定段 / 衰减段本就无棋盘来源，勿一刀切误炸
|
||||||
const SOURCE_EXEMPT_TYPES := ["decay", "verdict"]
|
const SOURCE_EXEMPT_TYPES := ["decay", "verdict"]
|
||||||
# 行来源断言豁免集合（来源类别层）——事实来源是单位 / 清图而非棋盘格；
|
# 行来源断言豁免集合（来源类别层）——事实来源是单位 / 清图而非棋盘格；
|
||||||
# fx_reveal=专长揭示掷格（落空行无真实格〔迭代 21 存量红修复——a57489e9 落地件三处空来源
|
# fx_reveal=专长揭示掷格（落空行无真实格）；
|
||||||
# 触发行来源断言，51 行/冒烟，两轮确定性复现〕）；
|
# fx_grant_gp=专长·GP 入账（钱包面而非棋盘面，行无格子可指）
|
||||||
# fx_grant_gp=专长·GP 入账（钱包面而非棋盘面，行无格子可指——与 fx_reveal 同款的漏网豁免，
|
|
||||||
# 未豁免时每局触发行来源断言失败 7 次，因脚本错误不改退出码而被闸长期漏过）
|
|
||||||
const SOURCE_EXEMPT_CLASSES := ["hero_attack", "enemy_action", "clear_reward", "fx_reveal", "fx_grant_gp"]
|
const SOURCE_EXEMPT_CLASSES := ["hero_attack", "enemy_action", "clear_reward", "fx_reveal", "fx_grant_gp"]
|
||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
var rng: RngServiceCore
|
var rng: RngServiceCore
|
||||||
# E1 封装收口（2026-09-13）：协作对象 board_generator/enemy_system/status_effects/reward_economy 私有化——跨层读取一律经 presentation_snapshot()/
|
# E1 封装收口：协作对象 board_generator/enemy_system/status_effects/reward_economy 私有化——跨层读取一律经 presentation_snapshot()/
|
||||||
# diagnostic_snapshot() 成文出口（呈现层链式穿透 settlement._enemy_system.hero_unit() 的根因收口）。
|
# diagnostic_snapshot() 成文出口（呈现层链式穿透 settlement._enemy_system.hero_unit() 的根因收口）。
|
||||||
# minesweeper/action_economy 保持公有 = 架构文档 API Boundaries 的 HUD框架消费面（意图提交 settle_batch + compute_move_path
|
# minesweeper/action_economy 保持公有 = 架构文档 API Boundaries 的 HUD框架消费面（意图提交 settle_batch + compute_move_path
|
||||||
# 只读；ap/rap/相位读取）——非本文档登记的契约面，勿增新用途。
|
# 只读；ap/rap/相位读取）——非本文档登记的契约面，勿增新用途。
|
||||||
@@ -38,9 +36,9 @@ var action_economy: ActionEconomy
|
|||||||
var _enemy_system: UnitContainer
|
var _enemy_system: UnitContainer
|
||||||
var _status_effects: StatusContainer
|
var _status_effects: StatusContainer
|
||||||
var _reward_economy: RewardEconomy
|
var _reward_economy: RewardEconomy
|
||||||
var treasure_inventory: TreasureItems # 迭代 7 T3——LevelRunner 注入的关卡域库存引用；
|
var treasure_inventory: TreasureItems # LevelRunner 注入的关卡域库存引用；
|
||||||
# 每战新建本类，库存不归本类所有——注入面
|
# 每战新建本类，库存不归本类所有——注入面
|
||||||
var _damage: DamageController # 伤害控制器（伤害管线单据化批 2026-09-24——单据唯一兑付管线）
|
var _damage: DamageController # 伤害控制器（单据唯一兑付管线）
|
||||||
|
|
||||||
var encounter: Dictionary[String, Variant] = {}
|
var encounter: Dictionary[String, Variant] = {}
|
||||||
var round_index := 0
|
var round_index := 0
|
||||||
@@ -51,38 +49,38 @@ var _facts_reveals: Array[Dictionary] = []
|
|||||||
var _facts_seals: Array[Dictionary] = []
|
var _facts_seals: Array[Dictionary] = []
|
||||||
var _facts_path := ""
|
var _facts_path := ""
|
||||||
var _settling := false
|
var _settling := false
|
||||||
var _defer_board_damage := false # 案C 暂存闸（2026-10-06 用户裁：地图奖励伤害兑付迁战斗段末——怪物还手后）
|
var _defer_board_damage := false # 案C 暂存闸（地图奖励伤害兑付在战斗段末——怪物还手后）
|
||||||
var _deferred_board: Array[Dictionary] = [] # 授予段暂存伤害单据（保授予段事件序；战斗段怪物还手后按序补提交统一结账）
|
var _deferred_board: Array[Dictionary] = [] # 授予段暂存伤害单据（保授予段事件序；战斗段怪物还手后按序补提交统一结账）
|
||||||
# 结算五段 Segment（迭代 27 T2——P1-1 拆段；段边界=审计五段〔裁点③甲〕，段序骨架冻结于
|
# 结算五段 Segment（段边界=审计五段，段序骨架冻结于
|
||||||
# SettlementTable.segment_order 语义：授予→增益/减益→战斗→衰减→判定。本类退为段序编排+
|
# SettlementTable.segment_order 语义：授予→增益/减益→战斗→衰减→判定。本类做段序编排+
|
||||||
# 行发射/开单原语单点——段体逻辑归 game/core/settlement/ 五类）
|
# 行发射/开单原语单点——段体逻辑归 game/core/settlement/ 五类）
|
||||||
var _grant_seg = null # GrantSegment（①授予段——含封印判与 counter/grant 助手单点）
|
var _grant_seg = null # GrantSegment（①授予段——含封印判与 counter/grant 助手单点）
|
||||||
var _aura_seg = null # AuraSegment（②增益/减益段）
|
var _aura_seg = null # AuraSegment（②增益/减益段）
|
||||||
var _combat_seg = null # CombatSegment（③战斗段——原 _combat_segment 体）
|
var _combat_seg = null # CombatSegment（③战斗段）
|
||||||
var _decay_seg = null # DecaySegment（④衰减段）
|
var _decay_seg = null # DecaySegment（④衰减段）
|
||||||
var _verdict_seg = null # VerdictSegment（⑤判定段——返回裁定，终局早退语义归本类）
|
var _verdict_seg = null # VerdictSegment（⑤判定段——返回裁定，终局早退语义归本类）
|
||||||
var _refresh_used_this_round := 0 # 每轮刷新计数（Active 相位合计，兜底上限 = ActionEconomyTable.refresh_cap_per_round）
|
var _refresh_used_this_round := 0 # 每轮刷新计数（Active 相位合计，兜底上限 = ActionEconomyTable.refresh_cap_per_round）
|
||||||
var _board_seq := 0 # 板序号（本战斗第几张板——快照归因用）
|
var _board_seq := 0 # 板序号（本战斗第几张板——快照归因用）
|
||||||
var _board_from_midround_refresh := false # 装板 provenance：轮内刷新换来的图 = true（清图奖励守卫——刷新图不发清图奖励）
|
var _board_from_midround_refresh := false # 装板 provenance：轮内刷新换来的图 = true（清图奖励守卫——刷新图不发清图奖励）
|
||||||
var _seal_consumed := {} # 兑付资格以危险格实例为键（板级；换图重置）
|
var _seal_consumed := {} # 兑付资格以危险格实例为键（板级；换图重置）
|
||||||
# 同调装配运行态（迭代 11 第①批 T5——begin_battle 经 enc.attunement 注入；off=空集全部效果零扰动）
|
# 同调装配运行态（begin_battle 经 enc.attunement 注入；off=空集全部效果零扰动）
|
||||||
var attunement: Array[Variant] = [] # 装备中同调件 item_id 集
|
var attunement: Array[Variant] = [] # 装备中同调件 item_id 集
|
||||||
var _ledger: RunLedger = null # 共享四本账（迭代 27 T3——begin_battle 经 enc["ledger"] 持引用；缺省新账=调试面）
|
var _ledger: RunLedger = null # 共享四本账（begin_battle 经 enc["ledger"] 持引用；缺省新账=调试面）
|
||||||
var _attune_safe_seen := 0 # 积点制件 battle 域安全开格计数（迭代 22 T3 通用化——装配集 ap_charge_safe 行扫描；反哺批⑤ 2026-10-12 用户裁：满 charge_n 自动兑付当轮 AP+1，无玩家发起入口）
|
var _attune_safe_seen := 0 # 积点制件 battle 域安全开格计数（装配集 ap_charge_safe 行扫描；满 charge_n 自动兑付当轮 AP+1，无玩家发起入口）
|
||||||
# ---- 效果引擎扩签运行态（迭代 20 专长实装批 T1——新效果类型施加面；空订阅零扰动）----
|
# ---- 效果引擎扩签运行态（新效果类型施加面；空订阅零扰动）----
|
||||||
var _fx_hero_ac_base := -1 # 主角 AC 基线快照（enc.hero_armor_class；-1=表值兜底未解析）
|
var _fx_hero_ac_base := -1 # 主角 AC 基线快照（enc.hero_armor_class；-1=表值兜底未解析）
|
||||||
var _fx_ac_round := 0 # ac_bonus 本轮累积器（封印桩形态——round_start 清零）
|
var _fx_ac_round := 0 # ac_bonus 本轮累积器（封印桩形态——round_start 清零）
|
||||||
var nest_preview_count := -1 # 巢穴预告读数口（迭代 22 秘宝批 T3——board_installed 命中落值；-1=未装配/未发射；呈现桥消费）
|
var nest_preview_count := -1 # 巢穴预告读数口（board_installed 命中落值；-1=未装配/未发射；呈现桥消费）
|
||||||
var _fx_ac_battle := 0 # ac_bonus 本战累积器（石肤形态——cap 封顶，begin_battle 清零）
|
var _fx_ac_battle := 0 # ac_bonus 本战累积器（石肤形态——cap 封顶，begin_battle 清零）
|
||||||
var _fx_bonus_delta := {"atk": 0, "max_hp": 0, "armor_class": 0, "ap": 0} # 本战 bonus_delta 累积（战末经 _ledger.bonus_add_axis 汇入后清零）
|
var _fx_bonus_delta := {"atk": 0, "max_hp": 0, "armor_class": 0, "ap": 0} # 本战 bonus_delta 累积（战末经 _ledger.bonus_add_axis 汇入后清零）
|
||||||
var _fx_new_resource_types := {} # 本战已见资源类型集（地质学家 fact new_resource_type 判定——battle 域）
|
var _fx_new_resource_types := {} # 本战已见资源类型集（地质学家 fact new_resource_type 判定——battle 域）
|
||||||
var _fx_pending_reveals: Array[Dictionary] = [] # 揭示效果待兑队列（见血开窍/斩首学者/地质学家/跳格采掘——授予段末统一兑付，防轮 facts 迭代中追加重入）
|
var _fx_pending_reveals: Array[Dictionary] = [] # 揭示效果待兑队列（见血开窍/斩首学者/地质学家/跳格采掘——授予段末统一兑付，防轮 facts 迭代中追加重入）
|
||||||
var _fx_revealing := false # fx 揭示兑付中标记（_on_cell_revealed 缓冲旁路——fx 揭示的奖励由兑付点直接入账，防二次缓冲二次兑付）
|
var _fx_revealing := false # fx 揭示兑付中标记（_on_cell_revealed 缓冲旁路——fx 揭示的奖励由兑付点直接入账，防二次缓冲二次兑付）
|
||||||
# 特性运行态（内容数据驱动扩展批 T3——relic 持有集经 enc.feats 注入：效果行为=数据行 triggers 经
|
# 特性运行态（relic 持有集经 enc.feats 注入：效果行为=数据行 triggers 经
|
||||||
# 效果引擎分发；魔矢每战首次计数 battle 域。空集=零扰动）
|
# 效果引擎分发；魔矢每战首次计数 battle 域。空集=零扰动）
|
||||||
var _feat_first_dig_used := false
|
var _feat_first_dig_used := false
|
||||||
# 效果引擎（内容数据驱动扩展批 T1——发布订阅解释器；begin_battle 从持有集/装备集重建订阅。
|
# 效果引擎（发布订阅解释器；begin_battle 从持有集/装备集重建订阅。
|
||||||
# T3 起施加面全量切换：发射点 dispatch 返回命中，发射点按组合规则施加——旧 feat_seals 封印注入消亡）
|
# 施加面：发射点 dispatch 返回命中，发射点按组合规则施加）
|
||||||
var _fx: EffectEngine
|
var _fx: EffectEngine
|
||||||
|
|
||||||
|
|
||||||
@@ -95,7 +93,7 @@ func _fx_emit(event: String, payload: Dictionary) -> Array:
|
|||||||
|
|
||||||
# round_start 发射+施加（内容数据驱动扩展批 T3——grant_ap mode:queue=当轮入队，行动经济轮切换
|
# round_start 发射+施加（内容数据驱动扩展批 T3——grant_ap mode:queue=当轮入队，行动经济轮切换
|
||||||
# 即兑现；计数器 round_start 重置点在 dispatch 内生效。调用点两处：begin_battle 首轮 / 轮始段续轮。
|
# 即兑现；计数器 round_start 重置点在 dispatch 内生效。调用点两处：begin_battle 首轮 / 轮始段续轮。
|
||||||
# 迭代 20 T1——payload 扩 ap_exhausted_last〔一滴不剩 when 面〕+ac_bonus 本轮累积器清零）
|
# payload 扩 ap_exhausted_last〔一滴不剩 when 面〕+ac_bonus 本轮累积器清零）
|
||||||
func _emit_round_start() -> void:
|
func _emit_round_start() -> void:
|
||||||
_fx_ac_round = 0
|
_fx_ac_round = 0
|
||||||
_sync_hero_ac()
|
_sync_hero_ac()
|
||||||
@@ -113,7 +111,7 @@ func _sync_hero_ac() -> void:
|
|||||||
_damage.set_hero_ac_override(_fx_hero_ac_base + _fx_ac_round + _fx_ac_battle)
|
_damage.set_hero_ac_override(_fx_hero_ac_base + _fx_ac_round + _fx_ac_battle)
|
||||||
|
|
||||||
|
|
||||||
# ac_bonus 施加（迭代 20 T1——mode=round 本轮累积器〔封印桩，round_start 清零〕/
|
# ac_bonus 施加（mode=round 本轮累积器〔封印桩，round_start 清零〕/
|
||||||
# mode=battle 本战累积器〔石肤，cap 封顶；缺省 battle〕；cap=0/缺省=无上限）
|
# mode=battle 本战累积器〔石肤，cap 封顶；缺省 battle〕；cap=0/缺省=无上限）
|
||||||
func _apply_ac_bonus(h: Dictionary) -> void:
|
func _apply_ac_bonus(h: Dictionary) -> void:
|
||||||
var mode := String(h.get("mode", "battle"))
|
var mode := String(h.get("mode", "battle"))
|
||||||
@@ -192,16 +190,15 @@ func _attune_has(item_id: String) -> bool:
|
|||||||
return attunement.has(item_id)
|
return attunement.has(item_id)
|
||||||
|
|
||||||
|
|
||||||
# 装配集只读出口（迭代 19 卡④立——呈现桥消费面现归 attune_param_sum〔迭代 22 T4 换代〕。
|
# 装配集只读出口（_attune_has 契约化出口，save v6 只读访问器先例。只读零副作用——
|
||||||
# _attune_has 契约化出口，save v6 只读访问器先例；private 面内部调用零改动。只读零副作用——
|
|
||||||
# 呈现侧判定专用，非结算写入口）
|
# 呈现侧判定专用，非结算写入口）
|
||||||
func attune_has(item_id: String) -> bool:
|
func attune_has(item_id: String) -> bool:
|
||||||
return _attune_has(item_id)
|
return _attune_has(item_id)
|
||||||
|
|
||||||
|
|
||||||
# 装备件表值读取（charge_n 等——TreasureItemTable 行；未装配不读表。magnitude 读数面随 T4
|
# 装备件表值读取（charge_n 等——TreasureItemTable 行；未装配不读表。
|
||||||
# 秘宝订阅迁移退役——行值经 value_from 在 rebuild 定影，零运行期按件取值）
|
# 行值经 value_from 在 rebuild 定影，零运行期按件取值）
|
||||||
# 装配集参数合计（迭代 22 秘宝批 T3——常时参数面 kind 的装配集 Σmagnitude 读数口；
|
# 装配集参数合计（常时参数面 kind 的装配集 Σmagnitude 读数口；
|
||||||
# kind 分发查询先例=_attune_refresh_x_total bonus_refresh。零装配=0）
|
# kind 分发查询先例=_attune_refresh_x_total bonus_refresh。零装配=0）
|
||||||
func attune_param_sum(kind: String) -> int:
|
func attune_param_sum(kind: String) -> int:
|
||||||
var total := 0
|
var total := 0
|
||||||
@@ -212,8 +209,8 @@ func attune_param_sum(kind: String) -> int:
|
|||||||
return total
|
return total
|
||||||
|
|
||||||
|
|
||||||
# 装配集内 ap_charge_safe 行读取（迭代 22 秘宝批 T3——掘进蓄能 id 特判通用化取数源；
|
# 装配集内 ap_charge_safe 行读取（取数源=装配集行扫描；
|
||||||
# 首行语义=装配集内至多一件积点制〔新目录恰试炼镐〕）
|
# 首行语义=装配集内至多一件积点制〔试炼镐〕）
|
||||||
func _attune_charge_safe_row() -> Dictionary:
|
func _attune_charge_safe_row() -> Dictionary:
|
||||||
for iid_v in attunement:
|
for iid_v in attunement:
|
||||||
var arow: Dictionary[Variant, Variant] = db.treasure_item_row(String(iid_v))
|
var arow: Dictionary[Variant, Variant] = db.treasure_item_row(String(iid_v))
|
||||||
@@ -222,7 +219,7 @@ func _attune_charge_safe_row() -> Dictionary:
|
|||||||
return {}
|
return {}
|
||||||
|
|
||||||
|
|
||||||
# 充能重置（迭代 22 秘宝批 T3——按周期回满：账本回 charges_per_adventure+骑库存差额补注入
|
# 充能重置（按周期回满：账本回 charges_per_adventure+骑库存差额补注入
|
||||||
# （used handle 不回收=本轮已耗充能作废，补新 handle=「回满」；差额注入防双份=level_runner
|
# （used handle 不回收=本轮已耗充能作废，补新 handle=「回满」；差额注入防双份=level_runner
|
||||||
# set_attune_charges 同构）。reset ∈ {battle, level}——adventure 周期归冒险开始种子面）
|
# set_attune_charges 同构）。reset ∈ {battle, level}——adventure 周期归冒险开始种子面）
|
||||||
func _reseed_attune_charges(reset: String) -> void:
|
func _reseed_attune_charges(reset: String) -> void:
|
||||||
@@ -246,7 +243,7 @@ func _reseed_attune_charges(reset: String) -> void:
|
|||||||
treasure_inventory.add_item(iid, "attunement", Vector2i(-1, -1), 0)
|
treasure_inventory.add_item(iid, "attunement", Vector2i(-1, -1), 0)
|
||||||
|
|
||||||
|
|
||||||
# 积点制件进度读数（迭代 22 反哺批⑤——自动兑付无玩家发起入口，读数口=C 区秘宝槽悬停浮窗进度行：
|
# 积点制件进度读数（自动兑付无玩家发起入口，读数口=C 区秘宝槽悬停浮窗进度行：
|
||||||
# assembled=装配在册/points=本战安全格进度（charge_n 取余）/need=charge_n/item_id=装配行 id。
|
# assembled=装配在册/points=本战安全格进度（charge_n 取余）/need=charge_n/item_id=装配行 id。
|
||||||
# 未装配=assembled false）
|
# 未装配=assembled false）
|
||||||
func attune_convert_state() -> Dictionary:
|
func attune_convert_state() -> Dictionary:
|
||||||
@@ -258,13 +255,13 @@ func attune_convert_state() -> Dictionary:
|
|||||||
"display_name": String(row.get("display_name", "")), "item_id": String(row.get("item_id", ""))}
|
"display_name": String(row.get("display_name", "")), "item_id": String(row.get("item_id", ""))}
|
||||||
|
|
||||||
|
|
||||||
# 特性求值（内容数据驱动扩展批 T3——_feat_seals_for 挂点求值退役：效果行为=数据行 triggers 订阅，
|
# 特性求值（效果行为=数据行 triggers 订阅，效果引擎 dispatch 分发；
|
||||||
# 效果引擎 dispatch 分发；旧 23 hook 枚举与封印注入消亡。流派档位质变=FeatsEngine 纯函数求值
|
# 流派档位质变=FeatsEngine 纯函数求值
|
||||||
# （档位机制本身系引擎基建非内容效果），两运行态注伤害控制器：档一 rider+1 / 档二 rider 可暴击）
|
# （档位机制本身系引擎基建非内容效果），两运行态注伤害控制器：档一 rider+1 / 档二 rider 可暴击）
|
||||||
var _seal_miss_seen := {} # 封印未中行去重（每安全格实例一次）
|
var _seal_miss_seen := {} # 封印未中行去重（每安全格实例一次）
|
||||||
var _perfect_hit_true := 0 # 板级完美排雷计数（install 重置）
|
var _perfect_hit_true := 0 # 板级完美排雷计数（install 重置）
|
||||||
var _perfect_hit_false := 0
|
var _perfect_hit_false := 0
|
||||||
var _perfect_forgiven := 0 # 完美保险豁免累计（迭代 31 卡②——单向累加自有账；契约 2 禁改写 _perfect_hit_false）
|
var _perfect_forgiven := 0 # 完美保险豁免累计（单向累加自有账；契约 2 禁改写 _perfect_hit_false）
|
||||||
var _hero_atk := 0 # 主角攻击基值快照（encounter.hero_atk；E4 收口——表值运行期不可变）
|
var _hero_atk := 0 # 主角攻击基值快照（encounter.hero_atk；E4 收口——表值运行期不可变）
|
||||||
|
|
||||||
|
|
||||||
@@ -287,7 +284,7 @@ func _init(db_ref: ConfigDb, rng_ref: RngServiceCore) -> void:
|
|||||||
minesweeper.seal_judged.connect(_on_seal_judged)
|
minesweeper.seal_judged.connect(_on_seal_judged)
|
||||||
minesweeper.round_end_board.connect(_on_round_end)
|
minesweeper.round_end_board.connect(_on_round_end)
|
||||||
action_economy.round_end_stopped.connect(_on_round_end)
|
action_economy.round_end_stopped.connect(_on_round_end)
|
||||||
# 结算五段接线（迭代 27 T2——段持宿主引用；信号连接纪律不涉段〔段零信号连接〕）
|
# 结算五段接线（段持宿主引用；信号连接纪律不涉段〔段零信号连接〕）
|
||||||
_grant_seg = GrantSegment.new(self)
|
_grant_seg = GrantSegment.new(self)
|
||||||
_aura_seg = AuraSegment.new(self)
|
_aura_seg = AuraSegment.new(self)
|
||||||
_combat_seg = CombatSegment.new(self)
|
_combat_seg = CombatSegment.new(self)
|
||||||
@@ -302,24 +299,24 @@ func begin_battle(enc: Dictionary) -> bool:
|
|||||||
push_warning("[战斗结算] begin_battle 重复受理")
|
push_warning("[战斗结算] begin_battle 重复受理")
|
||||||
return false
|
return false
|
||||||
encounter.assign(enc)
|
encounter.assign(enc)
|
||||||
escrow = 0 # 战斗域零 GP 持久（GP+商店房实施批——每场战斗缓冲从零起算）
|
escrow = 0 # 战斗域零 GP 持久（每场战斗缓冲从零起算）
|
||||||
_damage.set_hero_ac_override(int(enc.get("hero_armor_class", -1))) # 主角护甲合流入参（伤害控制器 defender_ac 消费——口径同原 _defender_ac）
|
_damage.set_hero_ac_override(int(enc.get("hero_armor_class", -1))) # 主角护甲合流入参（伤害控制器 defender_ac 消费）
|
||||||
db.set_reload_gate(true)
|
db.set_reload_gate(true)
|
||||||
if not _status_effects.notify_battle_start():
|
if not _status_effects.notify_battle_start():
|
||||||
_fatal("增益状态 开域被拒（编排违例）")
|
_fatal("增益状态 开域被拒（编排违例）")
|
||||||
return false
|
return false
|
||||||
# 遭遇骰（难度曲线与Boss GDD Core Rule 8——2026-09-12 用户拍板）：行有 unit_count_max 时按 [unit_count, max] 均匀骰；
|
# 遭遇骰（难度曲线与Boss GDD Core Rule 8）：行有 unit_count_max 时按 [unit_count, max] 均匀骰；
|
||||||
# 2026-09-14 敌方攻击区间批扩展：行有 atk_min 时按 [atk_min, atk_max] 骰 spawn 期整战持久值
|
# 行有 atk_min 时按 [atk_min, atk_max] 骰 spawn 期整战持久值
|
||||||
# （每拍抖动否决——数字可读性锚；中点 = 行值）。encounter 封闭流恰一 scope（数量骰先、atk 骰后）；
|
# （每拍抖动否决——数字可读性锚；中点 = 行值）。encounter 封闭流恰一 scope（数量骰先、atk 骰后）；
|
||||||
# 挖掘决策域之外——P1 合规；敌人系统 零随机纪律保持（收 override 即确定值）。
|
# 挖掘决策域之外——P1 合规；敌人系统 零随机纪律保持（收 override 即确定值）。
|
||||||
# 遭遇骰（难度曲线与Boss GDD Core Rule 8——2026-09-12 用户拍板）：行有 unit_count_max 时按 [unit_count, max] 均匀骰；
|
# 遭遇骰（难度曲线与Boss GDD Core Rule 8）：行有 unit_count_max 时按 [unit_count, max] 均匀骰；
|
||||||
# 2026-09-14 敌方攻击区间批扩展：行有 atk_min 时按 [atk_min, atk_max] 骰 spawn 期整战持久值
|
# 行有 atk_min 时按 [atk_min, atk_max] 骰 spawn 期整战持久值
|
||||||
# （每拍抖动否决——数字可读性锚；中点 = 行值）。encounter 封闭流恰一 scope（数量骰先、atk 骰后）；
|
# （每拍抖动否决——数字可读性锚；中点 = 行值）。encounter 封闭流恰一 scope（数量骰先、atk 骰后）；
|
||||||
# 挖掘决策域之外——P1 合规；敌人系统 零随机纪律保持（收 override 即确定值）。
|
# 挖掘决策域之外——P1 合规；敌人系统 零随机纪律保持（收 override 即确定值）。
|
||||||
# 逐行骰换代（2026-10-07 行集多行批 Q8 用户裁 + P1 补充）：混编行集**每行各掷自己的区间骰**——
|
# 逐行骰：混编行集**每行各掷自己的区间骰**——
|
||||||
# 先按行序逐行数量骰、再按行序逐行 atk 骰（单行行集 = 既有一次数量骰 + 一次 atk 骰，判定条件、
|
# 先按行序逐行数量骰、再按行序逐行 atk 骰（单行行集 = 既有一次数量骰 + 一次 atk 骰，判定条件、
|
||||||
# 开流条件、消费序、消费次数逐位一致——零内容期随机流零变化；区间宽度为零的行不掷 = 「定值不骰」
|
# 开流条件、消费序、消费次数逐位一致——零内容期随机流零变化；区间宽度为零的行不掷 = 「定值不骰」
|
||||||
# 既有口径；atk 区间逐行同构 = 行值语义完整，代拍板随批留痕：属「每行一骰」预批准语义内的
|
# 既有口径；atk 区间逐行同构 = 行值语义完整，属「每行一骰」语义内的
|
||||||
# 行字段区间骰逐行化，非新增随机源形态）。
|
# 行字段区间骰逐行化，非新增随机源形态）。
|
||||||
var erowset_pre: Array[Variant] = db.resolve_enemy_rowset(int(enc.level_index), int(enc.node_depth))
|
var erowset_pre: Array[Variant] = db.resolve_enemy_rowset(int(enc.level_index), int(enc.node_depth))
|
||||||
if erowset_pre.is_empty():
|
if erowset_pre.is_empty():
|
||||||
@@ -351,21 +348,21 @@ func begin_battle(enc: Dictionary) -> bool:
|
|||||||
_hero_atk = int(enc.get("hero_atk", int(db.hero.atk)))
|
_hero_atk = int(enc.get("hero_atk", int(db.hero.atk)))
|
||||||
if not _enemy_system.spawn(int(enc.level_index), int(enc.node_depth), int(enc.hero_hp), count_overrides,
|
if not _enemy_system.spawn(int(enc.level_index), int(enc.node_depth), int(enc.hero_hp), count_overrides,
|
||||||
_hero_atk, int(enc.get("hero_max_hp", -1)), atk_overrides,
|
_hero_atk, int(enc.get("hero_max_hp", -1)), atk_overrides,
|
||||||
String(enc.get("attack_type", "")), String(enc.get("armor_type", ""))): # 迭代 23 T4——两根类型轴（空串=锻造配置默认值回退，行为连续）
|
String(enc.get("attack_type", "")), String(enc.get("armor_type", ""))): # 两根类型轴（空串=锻造配置默认值回退，行为连续）
|
||||||
_fatal("敌人系统 spawn 被拒")
|
_fatal("敌人系统 spawn 被拒")
|
||||||
return false
|
return false
|
||||||
if not _install_new_board():
|
if not _install_new_board():
|
||||||
return false
|
return false
|
||||||
_reset_round_facts() # 首板 install 的初始展开事件不入轮 facts（resource 恒 false 的双保险）
|
_reset_round_facts() # 首板 install 的初始展开事件不入轮 facts（resource 恒 false 的双保险）
|
||||||
# 同调装配运行态注入（迭代 11 第①批 T5——enc.attunement 携带；off=空集零扰动。淬毒 N 注入
|
# 同调装配运行态注入（enc.attunement 携带；off=空集零扰动。淬毒 N 注入
|
||||||
# 伤害控制器、偏运 N 注入地图战斗资源——均须先于首板 install）
|
# 伤害控制器、偏运 N 注入地图战斗资源——均须先于首板 install）
|
||||||
attunement = (enc.get("attunement", []) as Array).duplicate()
|
attunement = (enc.get("attunement", []) as Array).duplicate()
|
||||||
_attune_safe_seen = 0
|
_attune_safe_seen = 0
|
||||||
# 淬毒/偏运注入拆除（内容数据驱动扩展批 T4——两件被动改 triggers 订阅行：淬毒=clamp_check
|
# 淬毒/偏运=triggers 订阅行（淬毒=clamp_check
|
||||||
# modify 窗口、偏运=reward_roll bias_rewards；value 行字段 value_from 定影，零 begin_battle 注入）
|
# modify 窗口、偏运=reward_roll bias_rewards；value 行字段 value_from 定影，begin_battle 不注入）
|
||||||
# 特性运行态（内容数据驱动扩展批 T3——enc.feats 携带持有集：效果行为=数据行 triggers 经效果
|
# 特性运行态（enc.feats 携带持有集：效果行为=数据行 triggers 经效果
|
||||||
# 引擎分发；流派档位=FeatsEngine 纯函数求值两运行态注伤害控制器。魔矢每战首次开格计数同步归零）
|
# 引擎分发；流派档位=FeatsEngine 纯函数求值两运行态注伤害控制器。魔矢每战首次开格计数同步归零）
|
||||||
# 迭代 20 T1——扩签运行态就位：AC 基线快照、累积器清零、adventure 计数器/加算区共享引用接收
|
# 扩签运行态就位：AC 基线快照、累积器清零、adventure 计数器/加算区共享引用接收
|
||||||
_fx_hero_ac_base = int(enc.get("hero_armor_class", -1))
|
_fx_hero_ac_base = int(enc.get("hero_armor_class", -1))
|
||||||
_fx_ac_round = 0
|
_fx_ac_round = 0
|
||||||
_fx_ac_battle = 0
|
_fx_ac_battle = 0
|
||||||
@@ -377,31 +374,31 @@ func begin_battle(enc: Dictionary) -> bool:
|
|||||||
_damage.fx_reveal_request = _fx_enqueue_reveal
|
_damage.fx_reveal_request = _fx_enqueue_reveal
|
||||||
_damage.fx_ac_request = _apply_ac_bonus
|
_damage.fx_ac_request = _apply_ac_bonus
|
||||||
var feat_ids: Array[Variant] = enc.get("feats", []) as Array
|
var feat_ids: Array[Variant] = enc.get("feats", []) as Array
|
||||||
# 迭代 20 T3 换代（V14 旧实现摘除）——流派档位质变随重设计退役（奇物.md v1「不设流派标签、
|
# 流派档位质变不设（奇物.md v1「不设流派标签、
|
||||||
# 不设档位机制」）：FeatsEngine 求值与 rider_tier 注入拆除，散件单体效果=唯一形态
|
# 不设档位机制」）：rider_tier 两注入恒零，散件单体效果=唯一形态
|
||||||
_damage.rider_tier_bonus = 0
|
_damage.rider_tier_bonus = 0
|
||||||
_damage.rider_tier_crit = false
|
_damage.rider_tier_crit = false
|
||||||
_feat_first_dig_used = false
|
_feat_first_dig_used = false
|
||||||
# 树 rule 键消费（迭代 12 T10 → 内容数据驱动扩展批 T3 换代：Fork 激活侧效果=效果引擎合成
|
# 树 rule 键消费（Fork 激活侧效果=效果引擎合成
|
||||||
# 订阅（rebuild 注入——round_start 首轮 AP+1 / damage_taken 减伤+1），旧直调拆除。其余 rule 键
|
# 订阅（rebuild 注入——round_start 首轮 AP+1 / damage_taken 减伤+1）。其余 rule 键
|
||||||
# =stat 面投影不入战斗（T8 表内容 provisional 口径披露））
|
# =stat 面投影不入战斗（T8 表内容 provisional 口径披露））
|
||||||
var tree_rules: Array[Variant] = enc.get("tree_rules", []) as Array
|
var tree_rules: Array[Variant] = enc.get("tree_rules", []) as Array
|
||||||
# 效果引擎订阅重建（内容数据驱动扩展批 T1——每战从持有集/装备集重建，中途获得下一战生效；
|
# 效果引擎订阅重建（每战从持有集/装备集重建，中途获得下一战生效；
|
||||||
# 树规则合成订阅同面装载。装载序=feats 表序→treasure 表序→树规则，写死保种子复放。
|
# 树规则合成订阅同面装载。装载序=feats 表序→treasure 表序→树规则，写死保种子复放。
|
||||||
# 迭代 20 T6——adventure 域计数器从共享引用回灌〔跨战持久〕）
|
# adventure 域计数器从共享引用回灌〔跨战持久〕）
|
||||||
_fx.rebuild(feat_ids, attunement, tree_rules)
|
_fx.rebuild(feat_ids, attunement, tree_rules)
|
||||||
_fx.counters_seed(_ledger.counters_seed_snapshot())
|
_fx.counters_seed(_ledger.counters_seed_snapshot())
|
||||||
# 秘宝常时参数注入（迭代 22 秘宝批 T3——装配集 kind 分发：远程镐挖距放宽/信标网络封印可达豁免；
|
# 秘宝常时参数注入（装配集 kind 分发：远程镐挖距放宽/信标网络封印可达豁免；
|
||||||
# 缺省 0/false=零装配零扰动。注入先于首板 install 已不成立〔板在早段〕——本批板生成不读两参数，
|
# 缺省 0/false=零装配零扰动。注入在首板 install 之后〔板在早段〕——板生成不读两参数，
|
||||||
# 参数只影响挖掘/插棋动作判据，时序安全）
|
# 参数只影响挖掘/插棋动作判据，时序安全）
|
||||||
minesweeper.dig_range_bonus = attune_param_sum("dig_range_bonus")
|
minesweeper.dig_range_bonus = attune_param_sum("dig_range_bonus")
|
||||||
minesweeper.seal_range_free = attune_param_sum("seal_range_free") > 0
|
minesweeper.seal_range_free = attune_param_sum("seal_range_free") > 0
|
||||||
# 充能重置周期（迭代 22 秘宝批 T3——battle=每战回满/level=每关首战回满〔battle_index==1〕；
|
# 充能重置周期（battle=每战回满/level=每关首战回满〔battle_index==1〕；
|
||||||
# adventure 周期维持冒险开始 _seed_attune_charges 单次）
|
# adventure 周期维持冒险开始 _seed_attune_charges 单次）
|
||||||
_reseed_attune_charges("battle")
|
_reseed_attune_charges("battle")
|
||||||
if int(enc.get("battle_index", 1)) == 1:
|
if int(enc.get("battle_index", 1)) == 1:
|
||||||
_reseed_attune_charges("level")
|
_reseed_attune_charges("level")
|
||||||
# board_installed 发射+施加（迭代 22 秘宝批 T3——巢穴预告：装板后一次报本板危险格数量；
|
# board_installed 发射+施加（巢穴预告：装板后一次报本板危险格数量；
|
||||||
# 只报数量不标位置=信息红线，不碰分布=棋盘事实不可变契约 3。命中=读数口落值，呈现归
|
# 只报数量不标位置=信息红线，不碰分布=棋盘事实不可变契约 3。命中=读数口落值，呈现归
|
||||||
# 呈现桥消费（无格来源不进结算明细行——行来源纪律）；板已就绪〔早段 install〕、订阅行已在 rebuild 装载）
|
# 呈现桥消费（无格来源不进结算明细行——行来源纪律）；板已就绪〔早段 install〕、订阅行已在 rebuild 装载）
|
||||||
nest_preview_count = -1
|
nest_preview_count = -1
|
||||||
@@ -409,27 +406,27 @@ func begin_battle(enc: Dictionary) -> bool:
|
|||||||
for h in bi_hits:
|
for h in bi_hits:
|
||||||
if String(h.get("kind", "")) == "mine_count_preview":
|
if String(h.get("kind", "")) == "mine_count_preview":
|
||||||
nest_preview_count = minesweeper.mine_total()
|
nest_preview_count = minesweeper.mine_total()
|
||||||
# 迭代 10 奖励重构批——跨冒险行动点加成轴（统一冒险加算区第四轴）：经排队修正通道兑现
|
# 跨冒险行动点加成轴（统一冒险加算区第四轴）：经排队修正通道兑现
|
||||||
# 「每场战斗开始首轮 AP +加成值」（queue_ap_delta = 下轮开轮基线加算、notify_round_start 兑现后
|
# 「每场战斗开始首轮 AP +加成值」（queue_ap_delta = 下轮开轮基线加算、notify_round_start 兑现后
|
||||||
# 清零——首轮即消费，后续轮次不重复兑现；语义锚 = 行动经济 GDD「跨冒险行动点加成轴」节）
|
# 清零——首轮即消费，后续轮次不重复兑现；语义锚 = 行动经济 GDD「跨冒险行动点加成轴」节）
|
||||||
var ap_bonus: int = int(enc.get("hero_ap_bonus", 0)) + int(enc.get("voucher_time_sand", 0)) # 迭代 20 T4——时沙同通道（首轮池增量，不改上限）
|
var ap_bonus: int = int(enc.get("hero_ap_bonus", 0)) + int(enc.get("voucher_time_sand", 0)) # 时沙同通道（首轮池增量，不改上限）
|
||||||
if ap_bonus > 0:
|
if ap_bonus > 0:
|
||||||
action_economy.queue_ap_delta(ap_bonus)
|
action_economy.queue_ap_delta(ap_bonus)
|
||||||
# 迭代 20 T4——储备金袋（节点级 RAP 注入）接收（完美保险注入通道随迭代 31 卡② 拆除——改由 feats.tres 订阅承载）
|
# 储备金袋（节点级 RAP 注入）接收（完美保险注入= feats.tres 订阅承载，不经此通道）
|
||||||
var voucher_rap: int = int(enc.get("voucher_rap", 0))
|
var voucher_rap: int = int(enc.get("voucher_rap", 0))
|
||||||
if voucher_rap > 0:
|
if voucher_rap > 0:
|
||||||
action_economy.grant_reserve_ap(voucher_rap)
|
action_economy.grant_reserve_ap(voucher_rap)
|
||||||
# 工兵晨令直调拆除（内容数据驱动扩展批 T4——round_start grant_ap(mode:queue) 订阅行承载，
|
# 工兵晨令=round_start grant_ap(mode:queue) 订阅行承载，
|
||||||
# when round_index ≤ effective_rounds 行字段 value_from 定影；发射位先于轮切换=当轮兑现）
|
# when round_index ≤ effective_rounds 行字段 value_from 定影；发射位先于轮切换=当轮兑现
|
||||||
# round_start 发射+施加（内容数据驱动扩展批 T3——发射位先于行动经济轮切换：树规则 grant_ap
|
# round_start 发射+施加（发射位先于行动经济轮切换：树规则 grant_ap
|
||||||
# mode:queue 当轮入队、notify_round_start 即兑现（先手压制=首轮 AP+1 语义锚，与迁移前
|
# mode:queue 当轮入队、notify_round_start 即兑现（先手压制=首轮 AP+1 语义锚）；
|
||||||
# begin_battle 直调 queue_ap_delta 逐位一致）；计数器 round_start 重置点同点生效）
|
# 计数器 round_start 重置点同点生效）
|
||||||
round_index = 1
|
round_index = 1
|
||||||
_emit_round_start()
|
_emit_round_start()
|
||||||
if not action_economy.notify_round_start():
|
if not action_economy.notify_round_start():
|
||||||
_fatal("行动经济 首轮 notify_round_start 被拒")
|
_fatal("行动经济 首轮 notify_round_start 被拒")
|
||||||
return false
|
return false
|
||||||
_roll_round_actions() # 开轮摇号（敌人技能池批——首轮同样摇；先于 round_started，挖掘期动画位可读）
|
_roll_round_actions() # 开轮摇号（首轮同样摇；先于 round_started，挖掘期动画位可读）
|
||||||
round_started.emit(round_index)
|
round_started.emit(round_index)
|
||||||
return true
|
return true
|
||||||
|
|
||||||
@@ -439,7 +436,7 @@ func _install_new_board(during_round := false) -> bool:
|
|||||||
var board: BoardData = _board_generator.generate(int(encounter.level_index), int(encounter.node_depth), stream, db)
|
var board: BoardData = _board_generator.generate(int(encounter.level_index), int(encounter.node_depth), stream, db)
|
||||||
if board == null:
|
if board == null:
|
||||||
return false
|
return false
|
||||||
# 全局作用域变异决议（首发批 2026-10-04——装板序内前置于 roll_board：图级偏斜旋钮须在资源
|
# 全局作用域变异决议（装板序内前置于 roll_board：图级偏斜旋钮须在资源
|
||||||
# 摇号前定型；全局门控与板无关〔节点身份+unlock+board_types〕，确定性取用零取号）。
|
# 摇号前定型；全局门控与板无关〔节点身份+unlock+board_types〕，确定性取用零取号）。
|
||||||
# boss/elite 图命中全局型 → 写 board_variants（_place_variants 见非空即跳 region=替换制）；
|
# boss/elite 图命中全局型 → 写 board_variants（_place_variants 见非空即跳 region=替换制）；
|
||||||
# 全局池空 → 板级字段留空（_place_variants 原路走 region=兜底回落合法态）。
|
# 全局池空 → 板级字段留空（_place_variants 原路走 region=兜底回落合法态）。
|
||||||
@@ -462,7 +459,7 @@ func _install_new_board(during_round := false) -> bool:
|
|||||||
if not _reward_economy.roll_board(eligible):
|
if not _reward_economy.roll_board(eligible):
|
||||||
_fatal("地图战斗资源 roll_board 被拒")
|
_fatal("地图战斗资源 roll_board 被拒")
|
||||||
return false
|
return false
|
||||||
# 地形变异 布置段（2026-09-19 用户拍板棋盘设置顺序第 4 步：生成棋盘 → 打开状态初始化 →
|
# 地形变异 布置段（棋盘设置顺序第 4 步：生成棋盘 → 打开状态初始化 →
|
||||||
# 战斗资源格设置 → 变异格设置）——布置在初始展开与资源格之后，变异天然不落已开区
|
# 战斗资源格设置 → 变异格设置）——布置在初始展开与资源格之后，变异天然不落已开区
|
||||||
_place_variants(board)
|
_place_variants(board)
|
||||||
_seal_consumed.clear() # 换图新雷 = 新实例，资格自然重置（行动经济 Rule 8）
|
_seal_consumed.clear() # 换图新雷 = 新实例，资格自然重置（行动经济 Rule 8）
|
||||||
@@ -474,11 +471,11 @@ func _install_new_board(during_round := false) -> bool:
|
|||||||
_board_seq += 1
|
_board_seq += 1
|
||||||
board_changed.emit()
|
board_changed.emit()
|
||||||
if treasure_inventory != null:
|
if treasure_inventory != null:
|
||||||
treasure_inventory.retire_overlays() # 迭代 7 T3——叠加层随图消亡（换图/刷新图装板点；已花道具不返还）
|
treasure_inventory.retire_overlays() # 叠加层随图消亡（换图/刷新图装板点；已花道具不返还）
|
||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# ---- 全局作用域变异 决议（首发批 2026-10-04——装板序内 roll_board 之前）----
|
# ---- 全局作用域变异 决议（装板序内 roll_board 之前）----
|
||||||
# boss/elite 图命中全局型：写板级 board_variants（恰一行）+ 注入资源面偏斜旋钮（图级投影在
|
# boss/elite 图命中全局型：写板级 board_variants（恰一行）+ 注入资源面偏斜旋钮（图级投影在
|
||||||
# RewardEconomy.roll_board 消费）；不消费 variant_place 流（全局取用确定性——零取号合法态）。
|
# RewardEconomy.roll_board 消费）；不消费 variant_place 流（全局取用确定性——零取号合法态）。
|
||||||
# 全局池空（含 L1 Boss 免疫/unlock 门控未达）：字段留空、旋钮归零——_place_variants 原路走
|
# 全局池空（含 L1 Boss 免疫/unlock 门控未达）：字段留空、旋钮归零——_place_variants 原路走
|
||||||
@@ -494,16 +491,16 @@ func _resolve_global_variant(board: BoardData) -> void:
|
|||||||
_reward_economy.board_skew = int(row.get("effect_value", 0))
|
_reward_economy.board_skew = int(row.get("effect_value", 0))
|
||||||
|
|
||||||
|
|
||||||
# ---- 地形变异 布置段（首批类型定稿批 2026-09-19——棋盘设置顺序第 4 步）----
|
# ---- 地形变异 布置段（棋盘设置顺序第 4 步）----
|
||||||
# 候选池门控（unlock_level ≤ 关卡序号 + board_types 与本地形交集，∅ 通配）经 config_db.variant_pool；
|
# 候选池门控（unlock_level ≤ 关卡序号 + board_types 与本地形交集，∅ 通配）经 config_db.variant_pool；
|
||||||
# 池空 = 合法态，静默零布置（框架 P0 口径不变）。零特判：本段只写格子变异数据快照，不改扫雷规则本体。
|
# 池空 = 合法态，静默零布置（框架 P0 口径不变）。零特判：本段只写格子变异数据快照，不改扫雷规则本体。
|
||||||
# 候选格域 = 安全格 − 初始展开区（伤害型 placement=closed_only 的结构保障——布置发生在初始展开之后，
|
# 候选格域 = 安全格 − 初始展开区（伤害型 placement=closed_only 的结构保障——布置发生在初始展开之后，
|
||||||
# 已开格天然排除）；危险格不吃变异（挖雷一层惩罚 + 变异伤害双层叠罚污染逐行归因，首版排除——provisional）。
|
# 已开格天然排除）；危险格不吃变异（挖雷一层惩罚 + 变异伤害双层叠罚污染逐行归因，首版排除——provisional）。
|
||||||
# 每图至多一种类型（候选池内均匀选一，混型布置归因复杂留待后续批）；数量 = round(候选池格数×percent) +
|
# 每图至多一种类型（候选池内均匀选一，混型布置归因复杂留待后续）；数量 = round(候选池格数×percent) +
|
||||||
# (关卡序号−1)×per_level_bonus——基数为候选池而非总格数（2026-09-21 用户拍板基数修正批：初始展开
|
# (关卡序号−1)×per_level_bonus——基数为候选池而非总格数（初始展开
|
||||||
# 占全板 56–67%，总格数基数使有效密度膨胀 4–6 倍、L1 小板极端全池覆盖；percent 语义 = 占可挖格比例，
|
# 占全板 56–67%，总格数基数使有效密度膨胀 4–6 倍、L1 小板极端全池覆盖；percent 语义 = 占可挖格比例，
|
||||||
# 关卡递增由 per_level_bonus 绝对格数承载）；连通片生长（8 邻），单片 ≤ pack_max（2×2 / 1×4 / 1×3+1 等形）。
|
# 关卡递增由 per_level_bonus 绝对格数承载）；连通片生长（8 邻），单片 ≤ pack_max（2×2 / 1×4 / 1×3+1 等形）。
|
||||||
# 替换制（全局作用域变异首发批 2026-10-04）：板级 board_variants 非空 = 本图已带全局型，跳过 region
|
# 替换制（全局作用域变异）：板级 board_variants 非空 = 本图已带全局型，跳过 region
|
||||||
# 布置（每图一型的板级推广：普通图=region，Boss/精英图=global）；空 = 原路径（含 Boss 图全局池空回落）。
|
# 布置（每图一型的板级推广：普通图=region，Boss/精英图=global）；空 = 原路径（含 Boss 图全局池空回落）。
|
||||||
func _place_variants(board: BoardData) -> void:
|
func _place_variants(board: BoardData) -> void:
|
||||||
if not board.board_variants.is_empty():
|
if not board.board_variants.is_empty():
|
||||||
@@ -572,14 +569,14 @@ func _on_cell_revealed(evt: Dictionary) -> void:
|
|||||||
# 轮 facts 缓冲不设相位守卫——轮末最后一挖的揭示事件在 request_dig 翻相之后才到（事件序：
|
# 轮 facts 缓冲不设相位守卫——轮末最后一挖的揭示事件在 request_dig 翻相之后才到（事件序：
|
||||||
# cell_revealed 批 → seal_judged 批 → round_end），phase==Active 守卫会丢最后一挖的事实；
|
# cell_revealed 批 → seal_judged 批 → round_end），phase==Active 守卫会丢最后一挖的事实；
|
||||||
# initial 通道事件（install 初始展开——封锁格）resource=false，进入授予段被资格检查自然跳过。
|
# initial 通道事件（install 初始展开——封锁格）resource=false，进入授予段被资格检查自然跳过。
|
||||||
# fx_reveal 通道事件旁路缓冲（迭代 20 T1——专长揭示的奖励由 _flush_pending_reveals 兑付点
|
# fx_reveal 通道事件旁路缓冲（专长揭示的奖励由 _flush_pending_reveals 兑付点
|
||||||
# 直接入账，此处缓冲会导致二次兑付）。
|
# 直接入账，此处缓冲会导致二次兑付）。
|
||||||
if battle_result == "" and not _fx_revealing:
|
if battle_result == "" and not _fx_revealing:
|
||||||
# 积点自动兑付（迭代 11 同调批 T6 → 迭代 22 秘宝批 T3 通用化 → 反哺批⑤ 2026-10-12 用户裁：
|
# 积点自动兑付：
|
||||||
# 满 charge_n 直接当轮 grant_ap，无玩家发起入口、无积点账中转〔账即时清空，battle 域重置
|
# 满 charge_n 直接当轮 grant_ap，无玩家发起入口、无积点账中转〔账即时清空，battle 域重置
|
||||||
# 自然无感〕。落位=揭示缓冲点——事件序 cell_revealed 批先于本格扣费，AP 归零恰逢积点满时
|
# 自然无感〕。落位=揭示缓冲点——事件序 cell_revealed 批先于本格扣费，AP 归零恰逢积点满时
|
||||||
# 先兑再扣，轮次不因本格结束；授予段已无积点段（本段唯一计数点）。fx_reveal 旁路不计数=
|
# 先兑再扣，轮次不因本格结束；授予段已无积点段（本段唯一计数点）。fx_reveal 旁路不计数=
|
||||||
# 沿现役缓冲路径口径〔天眼开格不计积点〕。grant_ap 相位防御在 ACTIVE 挖格链内恒过）
|
# 缓冲路径口径〔天眼开格不计积点〕。grant_ap 相位防御在 ACTIVE 挖格链内恒过）
|
||||||
if String(evt.get("kind", "")) == "safe":
|
if String(evt.get("kind", "")) == "safe":
|
||||||
var cs_row: Dictionary[Variant, Variant] = _attune_charge_safe_row()
|
var cs_row: Dictionary[Variant, Variant] = _attune_charge_safe_row()
|
||||||
if not cs_row.is_empty():
|
if not cs_row.is_empty():
|
||||||
@@ -619,24 +616,24 @@ func _maybe_settle() -> void:
|
|||||||
func _settle() -> void:
|
func _settle() -> void:
|
||||||
_settling = true
|
_settling = true
|
||||||
var ri := round_index
|
var ri := round_index
|
||||||
# 段序编排（迭代 27 T2——五段 Segment；段体归 game/core/settlement/，本类退为段序+
|
# 段序编排（五段 Segment；段体归 game/core/settlement/，本类只做段序+
|
||||||
# 行发射/开单原语单点。旧 259 行巨函数体已逐字迁五段类，git 史留痕）
|
# 行发射/开单原语单点）
|
||||||
_grant_seg.run(ri) # ① 授予段（案C 闸随段装载）
|
_grant_seg.run(ri) # ① 授予段（案C 闸随段装载）
|
||||||
_aura_seg.run(ri) # ② 增益/减益段（续存实例组合行）
|
_aura_seg.run(ri) # ② 增益/减益段（续存实例组合行）
|
||||||
_combat_seg.run(ri) # ③ 战斗段（主角先手 → 逐敌还手 → 地图伤害账殿后〔案C〕）
|
_combat_seg.run(ri) # ③ 战斗段（主角先手 → 逐敌还手 → 地图伤害账殿后〔案C〕）
|
||||||
_decay_seg.run(ri) # ④ 衰减段（恰一次恒执行含末轮——先兑付后衰减）
|
_decay_seg.run(ri) # ④ 衰减段（恰一次恒执行含末轮——先兑付后衰减）
|
||||||
var verdict: String = _verdict_seg.run(ri) # ⑤ 判定段（防御性优先级 hero 先判）
|
var verdict: String = _verdict_seg.run(ri) # ⑤ 判定段（防御性优先级 hero 先判）
|
||||||
if verdict != "continue":
|
if verdict != "continue":
|
||||||
return # 终局：旧早退语义逐位一致（_settling 不回置——_battle_over 已接管）
|
return # 终局：_settling 不回置——_battle_over 已接管
|
||||||
_settling = false
|
_settling = false
|
||||||
|
|
||||||
|
|
||||||
# ---- 授予段 helpers（极性路由）----
|
# ---- 授予段 helpers（极性路由）----
|
||||||
|
|
||||||
# 开格产出乘区（内容数据驱动扩展批 T3 参数化——贪婪矿灯/矿脉直觉/赌徒的血签事件收集器注入）：
|
# 开格产出乘区（贪婪矿灯/矿脉直觉/赌徒的血签事件收集器注入）：
|
||||||
# positive=power ×(1+静态 mult% + 矿脉直觉连击加成 min(cap,combo)×10%)；negative=power ×(1+cost%)。
|
# positive=power ×(1+静态 mult% + 矿脉直觉连击加成 min(cap,combo)×10%)；negative=power ×(1+cost%)。
|
||||||
# 全零收集器=原快照原样返回（零扰动）。combo 读数=效果引擎 dig_combo 计数器（safe+1/mine 清零，
|
# 全零收集器=原快照原样返回（零扰动）。combo 读数=效果引擎 dig_combo 计数器（safe+1/mine 清零，
|
||||||
# 跨轮累计——与迁移前 _feat_combo 逐位一致）。
|
# 跨轮累计）。
|
||||||
func _feat_yield_adjust(snap: Dictionary, positive: bool, pos_m: int, neg_m: int, combo_cap: int) -> Dictionary:
|
func _feat_yield_adjust(snap: Dictionary, positive: bool, pos_m: int, neg_m: int, combo_cap: int) -> Dictionary:
|
||||||
var combo_val := _fx.counter("dig_combo") if _fx != null else 0
|
var combo_val := _fx.counter("dig_combo") if _fx != null else 0
|
||||||
if positive and pos_m <= 0 and combo_cap <= 0:
|
if positive and pos_m <= 0 and combo_cap <= 0:
|
||||||
@@ -687,8 +684,8 @@ func _hits_of(hits: Array, kind: String) -> Array:
|
|||||||
# 「动作 × 格型」矩阵的执行面：snap = 缓冲期冻结身份快照（cell_type = 该格装板期摇定的类型身份），
|
# 「动作 × 格型」矩阵的执行面：snap = 缓冲期冻结身份快照（cell_type = 该格装板期摇定的类型身份），
|
||||||
# polarity 由动作决定（开安全格/封印命中 = positive，开危险格/标错封印 = negative），
|
# polarity 由动作决定（开安全格/封印命中 = positive，开危险格/标错封印 = negative），
|
||||||
# 兑付行 = 奖励字典（类型, 极性）行。返回 true = percent 行实际生效（flat 行恒 false——兑付结果由行协议承载）。
|
# 兑付行 = 奖励字典（类型, 极性）行。返回 true = percent 行实际生效（flat 行恒 false——兑付结果由行协议承载）。
|
||||||
# ---- 秘宝（use_treasure 四步受理编排保留给同调主动件复用——迭代 11 第①批 T7：过渡授予路由
|
# ---- 秘宝（use_treasure 四步受理编排，调用方=同调主动件；能力件注入归
|
||||||
# _grant_treasure 随掉落/停点渠道退役拆除；能力件注入归 LevelRunner.set_attune_charges 骑库存面）----
|
# LevelRunner.set_attune_charges 骑库存面）----
|
||||||
|
|
||||||
|
|
||||||
# use_treasure 四步受理（registry use_orchestration 规范序——唯一调用权归本类；序即原子：
|
# use_treasure 四步受理（registry use_orchestration 规范序——唯一调用权归本类；序即原子：
|
||||||
@@ -701,26 +698,26 @@ func use_treasure(handle: int, target: Vector2i) -> Dictionary:
|
|||||||
return {"ok": false, "reason": "库存未接线"}
|
return {"ok": false, "reason": "库存未接线"}
|
||||||
if action_economy.phase != action_economy.PHASE_ACTIVE:
|
if action_economy.phase != action_economy.PHASE_ACTIVE:
|
||||||
return {"ok": false, "reason": "非挖掘期（使用窗口=Active）"}
|
return {"ok": false, "reason": "非挖掘期（使用窗口=Active）"}
|
||||||
var board: MinesweeperRules = minesweeper # 恒等包装退役（2026-10-02 修复批——use_treasure 直引公有成员）
|
var board: MinesweeperRules = minesweeper # 直引公有成员（无包装层）
|
||||||
# 板维度读数（迭代 22 T3 修——Rules 无 width 代理〔潜伏缺陷：旧目录期零直呼覆盖掩盖〕，读 BoardData 本体）
|
# 板维度读数（Rules 无 width 代理，读 BoardData 本体）
|
||||||
var board_b: BoardData = board.current_board()
|
var board_b: BoardData = board.current_board()
|
||||||
var v: Dictionary[Variant, Variant] = treasure_inventory.validate_use(handle, target,
|
var v: Dictionary[Variant, Variant] = treasure_inventory.validate_use(handle, target,
|
||||||
Vector2(board_b.width, board_b.height),
|
Vector2(board_b.width, board_b.height),
|
||||||
func(c: Vector2i): return not board.is_revealed(c))
|
func(c: Vector2i): return not board.is_revealed(c))
|
||||||
if not bool(v.ok):
|
if not bool(v.ok):
|
||||||
return v # ② 拒绝零消耗
|
return v # ② 拒绝零消耗
|
||||||
# treasure_used 发射+施加（内容数据驱动扩展批 T4——使用主动秘宝受理面：counter_spend 订阅=受理闸
|
# treasure_used 发射+施加（使用主动秘宝受理面：counter_spend 订阅=受理闸
|
||||||
# （掘进蓄能积点账本），消耗成功才受理；积点不足拒绝零消耗。按 item_id 特判随本批拆除）
|
# （掘进蓄能积点账本），消耗成功才受理；积点不足拒绝零消耗。零 item_id 特判）
|
||||||
var tu_hits := _fx_emit("treasure_used", {"item_id": String(v.item_id), "target": target})
|
var tu_hits := _fx_emit("treasure_used", {"item_id": String(v.item_id), "target": target})
|
||||||
for h in tu_hits:
|
for h in tu_hits:
|
||||||
if String(h.get("kind", "")) == "counter_spend":
|
if String(h.get("kind", "")) == "counter_spend":
|
||||||
if not _fx.counter_spend(String(h.get("counter_id", "")), int(h.get("value", 1))):
|
if not _fx.counter_spend(String(h.get("counter_id", "")), int(h.get("value", 1))):
|
||||||
var vrow: Dictionary[Variant, Variant] = db.treasure_item_row(String(v.item_id))
|
var vrow: Dictionary[Variant, Variant] = db.treasure_item_row(String(v.item_id))
|
||||||
var cn_info: int = int(vrow.get("charge_n", 0)) # 迭代 22 T3——读受理行自身（旧 dig_charge 硬编码随行退役）
|
var cn_info: int = int(vrow.get("charge_n", 0)) # 读受理行自身
|
||||||
return {"ok": false, "reason": "%s：安全格积点未达（%d/%d）" % [String(vrow.get("display_name", "")), _attune_safe_seen % cn_info if cn_info > 0 else 0, cn_info]}
|
return {"ok": false, "reason": "%s：安全格积点未达（%d/%d）" % [String(vrow.get("display_name", "")), _attune_safe_seen % cn_info if cn_info > 0 else 0, cn_info]}
|
||||||
var kinds: Array[Variant] = v.kinds
|
var kinds: Array[Variant] = v.kinds
|
||||||
if kinds.has("mine_reveal") or kinds.has("reveal_tiles"):
|
if kinds.has("mine_reveal") or kinds.has("reveal_tiles"):
|
||||||
# 真视写入（迭代 22 T3——reveal_tiles 新真视 kind 与 mine_reveal 同叠加层通道：
|
# 真视写入（reveal_tiles 这类真视 kind 与 mine_reveal 同叠加层通道：
|
||||||
# 危险格显示=信息呈现零回写，棋盘事实不可变契约 3）
|
# 危险格显示=信息呈现零回写，棋盘事实不可变契约 3）
|
||||||
treasure_inventory.apply_overlay("mine_reveal", v.resolved)
|
treasure_inventory.apply_overlay("mine_reveal", v.resolved)
|
||||||
if kinds.has("reward_preview"):
|
if kinds.has("reward_preview"):
|
||||||
@@ -729,7 +726,7 @@ func use_treasure(handle: int, target: Vector2i) -> Dictionary:
|
|||||||
if not action_economy.grant_ap(int(v.magnitude)):
|
if not action_economy.grant_ap(int(v.magnitude)):
|
||||||
return {"ok": false, "reason": "行动点加量被拒（相位防御）"}
|
return {"ok": false, "reason": "行动点加量被拒（相位防御）"}
|
||||||
if kinds.has("safe_dig"):
|
if kinds.has("safe_dig"):
|
||||||
# 天眼安全格直开（迭代 22 秘宝批 T3——C5 裁全额兑付：fx_reveal 通道复用=免 AP 零相位、
|
# 天眼安全格直开（C5 全额兑付：fx_reveal 通道复用=免 AP 零相位、
|
||||||
# 连锁与格面资源与普通挖格同链；危险格仅真视显示不移除=契约 3；有封印格跳过——封印=玩家承诺不代开）
|
# 连锁与格面资源与普通挖格同链；危险格仅真视显示不移除=契约 3；有封印格跳过——封印=玩家承诺不代开）
|
||||||
var opened_any := false
|
var opened_any := false
|
||||||
for c_v in v.resolved:
|
for c_v in v.resolved:
|
||||||
@@ -741,51 +738,51 @@ func use_treasure(handle: int, target: Vector2i) -> Dictionary:
|
|||||||
if not opened_any:
|
if not opened_any:
|
||||||
return {"ok": false, "reason": "天眼：窗口内安全格均已开（无可开格）"}
|
return {"ok": false, "reason": "天眼：窗口内安全格均已开（无可开格）"}
|
||||||
if kinds.has("cell_removal"):
|
if kinds.has("cell_removal"):
|
||||||
# 爆破工兵包兑付（迭代 13 T8/D6——中立移除危险格：未揭示/无封印/是雷过滤归排雷玩法；
|
# 爆破工兵包兑付（中立移除危险格：未揭示/无封印/是雷过滤归排雷玩法；
|
||||||
# P1 甲邻接数字冻结零重算、清图分母零涉（危险格不入分母）；空集拒绝零消耗——
|
# 邻接数字冻结零重算、清图分母零涉（危险格不入分母）；空集拒绝零消耗——
|
||||||
# consume 之前 return（拒绝面注记扩「③内零消耗分支」），拒绝 reason 可呈现）
|
# consume 之前 return（拒绝面注记扩「③内零消耗分支」），拒绝 reason 可呈现）
|
||||||
var blasted: Array[Variant] = board.remove_mines_in(v.resolved)
|
var blasted: Array[Variant] = board.remove_mines_in(v.resolved)
|
||||||
if blasted.is_empty():
|
if blasted.is_empty():
|
||||||
return {"ok": false, "reason": "爆破工兵包：3×3 区域内无可移除危险格（须未揭示且未封印）"}
|
return {"ok": false, "reason": "爆破工兵包：3×3 区域内无可移除危险格（须未揭示且未封印）"}
|
||||||
var rec: Dictionary[Variant, Variant] = treasure_inventory.consume(handle)
|
var rec: Dictionary[Variant, Variant] = treasure_inventory.consume(handle)
|
||||||
# 同调主动件充能扣减（迭代 11 第①批 T6——共享账本直改：adventure/level/settlement 同一字典引用）
|
# 同调主动件充能扣减（共享账本直改：adventure/level/settlement 同一字典引用）
|
||||||
if not rec.is_empty() and String(rec.get("source_class", "")) == "attunement":
|
if not rec.is_empty() and String(rec.get("source_class", "")) == "attunement":
|
||||||
_ledger.attune_charge_consume(String(rec.get("item_id", "")))
|
_ledger.attune_charge_consume(String(rec.get("item_id", "")))
|
||||||
# 真视类工具使用计数（迭代 22 秘宝批 T3——信标网络解锁行为条件：受理成功恰计一次；
|
# 真视类工具使用计数（信标网络解锁行为条件：受理成功恰计一次；
|
||||||
# 共享 dict 引用下传〔attune_charges 同款〕，冒险收束聚合入档 save.add_vision_used）
|
# 共享 dict 引用下传〔attune_charges 同款〕，冒险收束聚合入档 save.add_vision_used）
|
||||||
if kinds.has("reveal_tiles") or kinds.has("safe_dig") or kinds.has("mine_reveal"):
|
if kinds.has("reveal_tiles") or kinds.has("safe_dig") or kinds.has("mine_reveal"):
|
||||||
if not _ledger.vision_counter.is_empty():
|
if not _ledger.vision_counter.is_empty():
|
||||||
_ledger.vision_count_add(1) # 迭代 22 秘宝批 T3——受理成功恰计一次（缺省空账=调试不计）
|
_ledger.vision_count_add(1) # 受理成功恰计一次（缺省空账=调试不计）
|
||||||
return {"ok": true, "item_id": v.item_id, "resolved": v.resolved, "record": rec}
|
return {"ok": true, "item_id": v.item_id, "resolved": v.resolved, "record": rec}
|
||||||
|
|
||||||
|
|
||||||
# aux 解锁门控转发（迭代 7 T5——LevelRunner 注入；E1/E3 封装：外部经公有面，禁直读 _reward_economy）
|
# aux 解锁门控转发（LevelRunner 注入；E1/E3 封装：外部经公有面，禁直读 _reward_economy）
|
||||||
func set_treasure_unlocked(ids: Dictionary) -> void:
|
func set_treasure_unlocked(ids: Dictionary) -> void:
|
||||||
_reward_economy.set_treasure_unlocked(ids)
|
_reward_economy.set_treasure_unlocked(ids)
|
||||||
|
|
||||||
|
|
||||||
func _grant_routed(snap: Dictionary, polarity: String, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "", halve_pct: int = 0) -> bool:
|
func _grant_routed(snap: Dictionary, polarity: String, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "", halve_pct: int = 0) -> bool:
|
||||||
# 迭代 11 第①批 T7——aux 授予分支随掉落/停点渠道退役拆除（reward 词表第十型 treasure_item 保留但零投放：
|
# treasure_item 型零投放（无 aux 行入池、CURIO_KINDS 词表无此型），本口不处理；
|
||||||
# 无 aux 行入池、CURIO_KINDS 词表已除名）；剩余类型走极性字典路由。
|
# 剩余类型走极性字典路由。
|
||||||
var row: Dictionary[Variant, Variant] = _reward_economy.polarity_row(String(snap.get("cell_type", "")), polarity)
|
var row: Dictionary[Variant, Variant] = _reward_economy.polarity_row(String(snap.get("cell_type", "")), polarity)
|
||||||
if row.is_empty():
|
if row.is_empty():
|
||||||
_fatal("极性字典缺行: %s %s" % [String(snap.get("cell_type", "")), polarity])
|
_fatal("极性字典缺行: %s %s" % [String(snap.get("cell_type", "")), polarity])
|
||||||
return false
|
return false
|
||||||
if polarity == "positive":
|
if polarity == "positive":
|
||||||
row["power"] = int(snap.get("power", int(row.power))) # 区间行快照 power（身份批 roll 值）覆盖表值——授予期零随机口径（E14）
|
row["power"] = int(snap.get("power", int(row.power))) # 区间行快照 power（身份批 roll 值）覆盖表值——授予期零随机口径（E14）
|
||||||
# 标中兑付溢价（迭代14②判式换代批 T4——条款3 条件二封印溢价形态 a，2026-10-04 用户裁 P3）：
|
# 标中兑付溢价（条款3 条件二封印溢价形态 a）：
|
||||||
# δ 读 settlement.seal_hit_premium（percent 域 125=×1.25 provisional）；100=无溢价直通零扰动。
|
# δ 读 settlement.seal_hit_premium（percent 域 125=×1.25 provisional）；100=无溢价直通零扰动。
|
||||||
# 兑付公式一处=本块：只乘封印命中正向（flat power 乘后入单据/治疗/排队；percent 幅度经
|
# 兑付公式一处=本块：只乘封印命中正向（flat power 乘后入单据/治疗/排队；percent 幅度经
|
||||||
# premium_pct 贯穿 _apply_percent_row 应用与呈现同乘）——标空/挖格/清图不乘，雷安同池冻结不动。
|
# premium_pct 贯穿 _apply_percent_row 应用与呈现同乘）——标空/挖格/清图不乘，雷安同池冻结不动。
|
||||||
# 取整=四舍五入（与伤害管线 round_direction=floor 分域——registry clause3_inequality 随批登记；
|
# 取整=四舍五入（与伤害管线 round_direction=floor 分域——registry clause3_inequality 登记；
|
||||||
# 1 点量纲行 ac_up/action 取整后不变=整数粒度地板）。
|
# 1 点量纲行 ac_up/action 取整后不变=整数粒度地板）。
|
||||||
if source_class == "seal_hit" and int(db.settlement.seal_hit_premium) != 100:
|
if source_class == "seal_hit" and int(db.settlement.seal_hit_premium) != 100:
|
||||||
var prem_pct: int = int(db.settlement.seal_hit_premium)
|
var prem_pct: int = int(db.settlement.seal_hit_premium)
|
||||||
row = row.duplicate()
|
row = row.duplicate()
|
||||||
row["power"] = int(round(int(row.power) * prem_pct / 100.0))
|
row["power"] = int(round(int(row.power) * prem_pct / 100.0))
|
||||||
row["premium_pct"] = prem_pct
|
row["premium_pct"] = prem_pct
|
||||||
# 惊巢反制（迭代 11 同调批 T5 → 内容数据驱动扩展批 T4：按 id 特判拆除——减半系数=mine_hit
|
# 惊巢反制（减半系数=mine_hit
|
||||||
# damage_mult 订阅命中（行 value 50=减 50%，取整 ceil 与迁移前逐位一致）；反弹单=mine_hit
|
# damage_mult 订阅命中（行 value 50=减 50%，取整 ceil）；反弹单=mine_hit
|
||||||
# open_ticket channel reflect 订阅施加（编排器 mine_hit 施加段）；duplicate 隔离——减半不回写极性字典）
|
# open_ticket channel reflect 订阅施加（编排器 mine_hit 施加段）；duplicate 隔离——减半不回写极性字典）
|
||||||
if halve_pct > 0 and polarity == "negative" and source_class == "mine_hit":
|
if halve_pct > 0 and polarity == "negative" and source_class == "mine_hit":
|
||||||
row = row.duplicate()
|
row = row.duplicate()
|
||||||
@@ -804,7 +801,7 @@ func _dispatch_row(row: Dictionary, source_class: String, cell: Vector2i, ri: in
|
|||||||
return false
|
return false
|
||||||
|
|
||||||
|
|
||||||
# percent 行兑付：GP 型行走战斗内缓冲记账（GP+商店房实施批）；其余 apply_effect 入容器；
|
# percent 行兑付：GP 型行走战斗内缓冲记账；其余 apply_effect 入容器；
|
||||||
# 满层拒收 = "奖励未生效"行（零静默）
|
# 满层拒收 = "奖励未生效"行（零静默）
|
||||||
func _apply_percent_row(row: Dictionary, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "") -> bool:
|
func _apply_percent_row(row: Dictionary, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "") -> bool:
|
||||||
var eff := String(row.effect_id)
|
var eff := String(row.effect_id)
|
||||||
@@ -827,7 +824,7 @@ func _apply_percent_row(row: Dictionary, source_class: String, cell: Vector2i, r
|
|||||||
return false
|
return false
|
||||||
|
|
||||||
|
|
||||||
# GP 型行兑付（GP+商店房实施批 2026-09-21）：战斗内缓冲 escrow 记账——不入钱包不入增益容器。
|
# GP 型行兑付：战斗内缓冲 escrow 记账——不入钱包不入增益容器。
|
||||||
# 正向（gp_gain）= 挖开GP安全格/封印命中；负向（gp_loss）= 挖危险格/标错封印。兑付行经既有 effect 行
|
# 正向（gp_gain）= 挖开GP安全格/封印命中；负向（gp_loss）= 挖危险格/标错封印。兑付行经既有 effect 行
|
||||||
# 通道外发（escrow 随行——归因可读），战斗结束随 gp_dropped 一次上抛后即弃。
|
# 通道外发（escrow 随行——归因可读），战斗结束随 gp_dropped 一次上抛后即弃。
|
||||||
func _apply_gp_row(row: Dictionary, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "") -> bool:
|
func _apply_gp_row(row: Dictionary, source_class: String, cell: Vector2i, ri: int, highlight: String = "", label_suffix: String = "") -> bool:
|
||||||
@@ -838,7 +835,7 @@ func _apply_gp_row(row: Dictionary, source_class: String, cell: Vector2i, ri: in
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# flat 行兑付（负向恒即时，无库存语义）：伤害型分支全部改开单据（伤害管线单据化批 2026-09-24——
|
# flat 行兑付（负向恒即时，无库存语义）：伤害型分支走开单据（
|
||||||
# 管线/下限/目标解析归 伤害控制器，本函数只保留非伤害分支与单据装配）：
|
# 管线/下限/目标解析归 伤害控制器，本函数只保留非伤害分支与单据装配）：
|
||||||
# action = 行动点排队（非伤害）；blast 正向 = 群伤单据（无类型恒定表值打全体存活敌；负向 = 警觉 percent 行走 _apply_percent_row）；
|
# action = 行动点排队（非伤害）；blast 正向 = 群伤单据（无类型恒定表值打全体存活敌；负向 = 警觉 percent 行走 _apply_percent_row）；
|
||||||
# heal 正向 = 主角回复 clamp（满血 → 奖励未生效行）；heal 负向 = 主角直伤单据（不经增益状态）；
|
# heal 正向 = 主角回复 clamp（满血 → 奖励未生效行）；heal 负向 = 主角直伤单据（不经增益状态）；
|
||||||
@@ -859,7 +856,7 @@ func _apply_flat_row(row: Dictionary, source_class: String, cell: Vector2i, ri:
|
|||||||
DamageController.TARGET_ALL_ALIVE, ri, cell, "", 0, highlight, {"batch_key": String(row.reward_id)})
|
DamageController.TARGET_ALL_ALIVE, ri, cell, "", 0, highlight, {"batch_key": String(row.reward_id)})
|
||||||
return _outcome_of(_submit(t, sync))
|
return _outcome_of(_submit(t, sync))
|
||||||
if ctype == "pierce" or ctype == "magic":
|
if ctype == "pierce" or ctype == "magic":
|
||||||
# 伤害道具批（2026-09-18）语义不变：正向 = 单目标克制直伤（必中全额不掷点——棋盘来源伤害既有口径）；
|
# 正向 = 单目标克制直伤（必中全额不掷点——棋盘来源伤害既有口径）；
|
||||||
# 负向 = 主角直伤（复用反噬通道）。
|
# 负向 = 主角直伤（复用反噬通道）。
|
||||||
if String(row.get("polarity", "positive")) == "negative":
|
if String(row.get("polarity", "positive")) == "negative":
|
||||||
return _submit_flat_hero(source_class, display, power, cell, ri, highlight, sync)
|
return _submit_flat_hero(source_class, display, power, cell, ri, highlight, sync)
|
||||||
@@ -927,7 +924,7 @@ func _grant_clear_reward(ri: int) -> void:
|
|||||||
|
|
||||||
# 清图奖励 = 板级独立对象（不属于任何一格）：兑付形态按其 cell_type 的正向字典形态走，
|
# 清图奖励 = 板级独立对象（不属于任何一格）：兑付形态按其 cell_type 的正向字典形态走，
|
||||||
# 行值全部取快照（身份批 roll 值）。返回实际有效兑付。
|
# 行值全部取快照（身份批 roll 值）。返回实际有效兑付。
|
||||||
# 同步开单（sync）——完美第二份与高光份数的流程依赖需要同步读数（开单权归流程 用户裁决③）；
|
# 同步开单（sync）——完美第二份与高光份数的流程依赖需要同步读数（开单权归流程）；
|
||||||
# 同步路径内先按序结清段内排队单据（B 模式保序），随后本批无视结账政策当场兑现。
|
# 同步路径内先按序结清段内排队单据（B 模式保序），随后本批无视结账政策当场兑现。
|
||||||
func _grant_clear_identity(snap: Dictionary, ri: int, suffix: String) -> bool:
|
func _grant_clear_identity(snap: Dictionary, ri: int, suffix: String) -> bool:
|
||||||
var row := {
|
var row := {
|
||||||
@@ -945,12 +942,12 @@ func _grant_clear_identity(snap: Dictionary, ri: int, suffix: String) -> bool:
|
|||||||
return _apply_flat_row(row, "clear_reward", Vector2i(-1, -1), ri, "clear_reward_h2", suffix, true) == "redeemed"
|
return _apply_flat_row(row, "clear_reward", Vector2i(-1, -1), ri, "clear_reward_h2", suffix, true) == "redeemed"
|
||||||
|
|
||||||
|
|
||||||
# ---- 开轮摇号（敌人技能池批——共识点 B：技能选择前置到轮次开始，数值计算留结算段）----
|
# ---- 开轮摇号（共识点 B：技能选择前置到轮次开始，数值计算留结算段）----
|
||||||
# 每实例：保底判定（连续执行普攻 ≥ M → 必出特殊技、特殊技内按权重、不受冷却限制）→ 排除冷却中技能
|
# 每实例：保底判定（连续执行普攻 ≥ M → 必出特殊技、特殊技内按权重、不受冷却限制）→ 排除冷却中技能
|
||||||
# （中签率 = 权重 ÷ 可摇权重合计——份额归一）→ 按行序逐敌从统一流顺序取号摇定本拍动作。
|
# （中签率 = 权重 ÷ 可摇权重合计——份额归一）→ 按行序逐敌从统一流顺序取号摇定本拍动作。
|
||||||
# 随机消费只在换算层（本方法 + SkillLottery）；单位容器收确定值（零随机纪律——armor_roll 先例同构）。
|
# 随机消费只在换算层（本方法 + SkillLottery）；单位容器收确定值（零随机纪律——armor_roll 先例同构）。
|
||||||
# 并流批（2026-09-27 统一流裁决）：behavior_roll 子流派生向量（spawn_index×STRIDE+序）退役——
|
# 统一流：behavior_roll 无子流派生向量（位置交错，单点定位由事件日志承载）。
|
||||||
# 「单敌轨迹独立复放」前提随之移除（位置交错，单点定位由事件日志承载）。摇定后、兑现前死亡 → 本拍技能作废。
|
# 摇定后、兑现前死亡 → 本拍技能作废。
|
||||||
func _roll_round_actions() -> void:
|
func _roll_round_actions() -> void:
|
||||||
var pity_m: int = int(db.skill.pity_threshold)
|
var pity_m: int = int(db.skill.pity_threshold)
|
||||||
for u in _enemy_system.query_alive("enemy"):
|
for u in _enemy_system.query_alive("enemy"):
|
||||||
@@ -970,7 +967,7 @@ func _roll_round_actions() -> void:
|
|||||||
if String((pe as Dictionary).get("skill_id", "")) == sid and (pe as Dictionary).has("unlock_hp_pct"):
|
if String((pe as Dictionary).get("skill_id", "")) == sid and (pe as Dictionary).has("unlock_hp_pct"):
|
||||||
pct_v = int((pe as Dictionary).unlock_hp_pct)
|
pct_v = int((pe as Dictionary).unlock_hp_pct)
|
||||||
break
|
break
|
||||||
# 迭代 20 T1——target_attack_bonus 施加面（处刑台：敌血量阈值沿挂单位字典标记，
|
# target_attack_bonus 施加面（处刑台：敌血量阈值沿挂单位字典标记，
|
||||||
# 主角攻击面 _resolve_hero_attack 通用消费——fx_atk_bonus 键加算进 base_value）
|
# 主角攻击面 _resolve_hero_attack 通用消费——fx_atk_bonus 键加算进 base_value）
|
||||||
var eht_hits := _fx_emit("enemy_hp_threshold", {"unit": String(u.enemy_id), "pct": pct_v,
|
var eht_hits := _fx_emit("enemy_hp_threshold", {"unit": String(u.enemy_id), "pct": pct_v,
|
||||||
"is_boss": String(encounter.get("node_type", "")) == "boss"})
|
"is_boss": String(encounter.get("node_type", "")) == "boss"})
|
||||||
@@ -988,15 +985,14 @@ func _roll_round_actions() -> void:
|
|||||||
|
|
||||||
|
|
||||||
# ---- 战斗段 ----
|
# ---- 战斗段 ----
|
||||||
# 伤害管线单据化批（2026-09-24）：本段只开单——主角先手单 + 敌方伤害技单；掷点/折扣/暴击/克制/
|
# 本段只开单——主角先手单 + 敌方伤害技单；掷点/折扣/暴击/克制/
|
||||||
# 池乘区/下限/交付/commit 全部收口 伤害控制器（A 模式提交即结＝与迁移前逐位一致；B 模式段尾 flush）。
|
# 池乘区/下限/交付/commit 全部收口 伤害控制器（A 模式提交即结；B 模式段尾 flush）。
|
||||||
# 开单守卫归流程（用户裁决③——流程决定给谁开单）：主角存活+目标存在才开先手单；hero hp=0 立即
|
# 开单守卫归流程（流程决定给谁开单）：主角存活+目标存在才开先手单；hero hp=0 立即
|
||||||
# 停开（B 模式下若 flush 中主角倒下，由控制器死亡事件终止余单——两模式同一结果）。
|
# 停开（B 模式下若 flush 中主角倒下，由控制器死亡事件终止余单——两模式同一结果）。
|
||||||
|
|
||||||
# ---- 算术读数（伤害管线单据化批 2026-09-24 迁移注记）----
|
# ---- 算术读数 ----
|
||||||
# 掷点/折扣/克制点数/池乘区/攻击行文本已全部迁入 伤害控制器（damage_controller.gd 管线单点）；
|
# 掷点/折扣/克制点数/池乘区/攻击行文本 归 伤害控制器（damage_controller.gd 管线单点）；
|
||||||
# 本类仅保留一处薄委托——_defender_ac（快照面消费）。_clamped_pool 委托壳已随 2026-10-02 修复批删除
|
# 本类只保留一处薄委托——_defender_ac（快照面消费）。
|
||||||
# （冒烟白盒断言消费面改直引 settlement._damage.clamped_pool——并行卡同批改 smoke_all）。
|
|
||||||
|
|
||||||
# 防守方护甲等级读数——实现归 伤害控制器 defender_ac（本委托供结算快照/呈现快照）
|
# 防守方护甲等级读数——实现归 伤害控制器 defender_ac（本委托供结算快照/呈现快照）
|
||||||
func _defender_ac(unit: Dictionary) -> int:
|
func _defender_ac(unit: Dictionary) -> int:
|
||||||
@@ -1052,7 +1048,7 @@ func _emit_settlement_snapshot(verdict: String) -> void:
|
|||||||
"round": round_index,
|
"round": round_index,
|
||||||
"verdict": verdict,
|
"verdict": verdict,
|
||||||
"unit_count": enemies.size(),
|
"unit_count": enemies.size(),
|
||||||
"spawn_count": _enemy_system.all_enemies().size(), # 本战斗实例化总数（含死亡残位）——unit_count=0 时区分「首轮全灭」vs「空场」（playtest-2026-09-12 报告 Bug#1 误读教训）
|
"spawn_count": _enemy_system.all_enemies().size(), # 本战斗实例化总数（含死亡残位）——unit_count=0 时区分「首轮全灭」vs「空场」
|
||||||
"hero": {"hp": int(_enemy_system.hero_unit().get("hp", 0)), "max_hp": int(_enemy_system.hero_unit().get("max_hp", 0)), "atk": int(_enemy_system.hero_unit().get("atk", 0)), "armor_class": _defender_ac(_enemy_system.hero_unit())},
|
"hero": {"hp": int(_enemy_system.hero_unit().get("hp", 0)), "max_hp": int(_enemy_system.hero_unit().get("max_hp", 0)), "atk": int(_enemy_system.hero_unit().get("atk", 0)), "armor_class": _defender_ac(_enemy_system.hero_unit())},
|
||||||
"economy": {"phase": String(action_economy.phase), "ap": int(action_economy.ap), "rap": int(action_economy.rap), "refresh_used": _refresh_used_this_round},
|
"economy": {"phase": String(action_economy.phase), "ap": int(action_economy.ap), "rap": int(action_economy.rap), "refresh_used": _refresh_used_this_round},
|
||||||
"board": board_stats,
|
"board": board_stats,
|
||||||
@@ -1095,7 +1091,7 @@ func can_refresh() -> bool:
|
|||||||
|
|
||||||
|
|
||||||
# 玩家经 HUD框架发起、战斗结算 代理调用（禁止 RAP 满自动刷）。
|
# 玩家经 HUD框架发起、战斗结算 代理调用（禁止 RAP 满自动刷）。
|
||||||
# 挖掘期唯一通道（2026-09-12 方案 A 拍板 + 2026-09-15 等待期通道整体移除）：Active 相位立即换图
|
# 挖掘期唯一通道：Active 相位立即换图
|
||||||
# 继续挖（RAP -8；AP 保留、相位不动、不触发结算）；非挖掘期请求一律拒绝——非清图轮恒同图。
|
# 继续挖（RAP -8；AP 保留、相位不动、不触发结算）；非挖掘期请求一律拒绝——非清图轮恒同图。
|
||||||
func player_request_refresh() -> bool:
|
func player_request_refresh() -> bool:
|
||||||
if not can_refresh():
|
if not can_refresh():
|
||||||
@@ -1110,14 +1106,14 @@ func player_request_refresh() -> bool:
|
|||||||
|
|
||||||
func _battle_over(result: String) -> void:
|
func _battle_over(result: String) -> void:
|
||||||
battle_result = result
|
battle_result = result
|
||||||
# battle_won 发射+施加（迭代 20 T1——战地包扎 heal 订阅面；败北不发射。heal=英雄单位回血
|
# battle_won 发射+施加（战地包扎 heal 订阅面；败北不发射。heal=英雄单位回血
|
||||||
# 〔封顶单位上限〕，战后生命经 hero_hp_left 回写冒险账本——时点在捕获前=回血计入带入下一层）
|
# 〔封顶单位上限〕，战后生命经 hero_hp_left 回写冒险账本——时点在捕获前=回血计入带入下一层）
|
||||||
if result == "victory":
|
if result == "victory":
|
||||||
for h in _fx_emit("battle_won", {"round": round_index}):
|
for h in _fx_emit("battle_won", {"round": round_index}):
|
||||||
if String(h.get("kind", "")) == "heal":
|
if String(h.get("kind", "")) == "heal":
|
||||||
var hu_w: Dictionary[Variant, Variant] = _enemy_system.hero_unit()
|
var hu_w: Dictionary[Variant, Variant] = _enemy_system.hero_unit()
|
||||||
hu_w["hp"] = mini(int(hu_w.get("hp", 0)) + int(h.get("value", 0)), maxi(1, int(hu_w.get("max_hp", 1))))
|
hu_w["hp"] = mini(int(hu_w.get("hp", 0)) + int(h.get("value", 0)), maxi(1, int(hu_w.get("max_hp", 1))))
|
||||||
# bonus_delta 战末汇入（迭代 20 T1——血税双向账：本战累积并入冒险加算区共享引用后清零）+
|
# bonus_delta 战末汇入（血税双向账：本战累积并入冒险加算区共享引用后清零）+
|
||||||
# adventure 域计数器导出回写（T6——共享引用覆写，attune_charges 先例）
|
# adventure 域计数器导出回写（T6——共享引用覆写，attune_charges 先例）
|
||||||
if not _ledger.bonus.is_empty():
|
if not _ledger.bonus.is_empty():
|
||||||
for axis in _fx_bonus_delta.keys():
|
for axis in _fx_bonus_delta.keys():
|
||||||
@@ -1127,19 +1123,19 @@ func _battle_over(result: String) -> void:
|
|||||||
_ledger.counters_merge_export(_fx.counters_export())
|
_ledger.counters_merge_export(_fx.counters_export())
|
||||||
# 映射随战斗结束退役（地图战斗资源 义务④——下一场战斗 = 新板新 scope 批，roll_board 相位守卫的前提）
|
# 映射随战斗结束退役（地图战斗资源 义务④——下一场战斗 = 新板新 scope 批，roll_board 相位守卫的前提）
|
||||||
var hero_hp_left := int(_enemy_system.hero_unit().get("hp", 0)) # despawn 前捕获（信号载荷供呈现层"HP 带入下一层"）
|
var hero_hp_left := int(_enemy_system.hero_unit().get("hp", 0)) # despawn 前捕获（信号载荷供呈现层"HP 带入下一层"）
|
||||||
var gp_dropped := _roll_gp_drop() # 战斗掉落（GP+商店房实施批——escrow 随此值上抛即弃）
|
var gp_dropped := _roll_gp_drop() # 战斗掉落（escrow 随此值上抛即弃）
|
||||||
_reward_economy.retire_mapping()
|
_reward_economy.retire_mapping()
|
||||||
_enemy_system.despawn_all()
|
_enemy_system.despawn_all()
|
||||||
_status_effects.notify_battle_end()
|
_status_effects.notify_battle_end()
|
||||||
if treasure_inventory != null:
|
if treasure_inventory != null:
|
||||||
treasure_inventory.retire_overlays() # 迭代 7 T3——叠加层随战斗结束清空（库存不动——关卡域跨战斗）
|
treasure_inventory.retire_overlays() # 叠加层随战斗结束清空（库存不动——关卡域跨战斗）
|
||||||
action_economy.notify_combat_end() # → Idle，RAP 清零（2026-10-02 修复批：原被 tab 事故并进上一行行尾注释从不执行——每战新建实例掩盖了症状；P0-3）
|
action_economy.notify_combat_end() # → Idle，RAP 清零
|
||||||
db.set_reload_gate(false)
|
db.set_reload_gate(false)
|
||||||
_reset_round_facts()
|
_reset_round_facts()
|
||||||
battle_finished.emit({"result": result, "hero_hp": hero_hp_left, "gp_dropped": gp_dropped})
|
battle_finished.emit({"result": result, "hero_hp": hero_hp_left, "gp_dropped": gp_dropped})
|
||||||
|
|
||||||
|
|
||||||
# 战斗掉落掷定（GP+商店房实施批 2026-09-21）：tier = Boss 节点 ? "boss" : "normal"（elite 留分支位）；
|
# 战斗掉落掷定：tier = Boss 节点 ? "boss" : "normal"（elite 留分支位）；
|
||||||
# gp_dropped = gp_drop 封闭流掷定（tier 行的 roll_min..roll_max 均匀整数——每战斗末恰一 scope）
|
# gp_dropped = gp_drop 封闭流掷定（tier 行的 roll_min..roll_max 均匀整数——每战斗末恰一 scope）
|
||||||
# + level_gp_bonus(level_index) + escrow。掷定行缺位 = 数据面缺行（fail 报错按 0 兑付——不哑掉）。
|
# + level_gp_bonus(level_index) + escrow。掷定行缺位 = 数据面缺行（fail 报错按 0 兑付——不哑掉）。
|
||||||
func _roll_gp_drop() -> int:
|
func _roll_gp_drop() -> int:
|
||||||
@@ -1152,25 +1148,25 @@ func _roll_gp_drop() -> int:
|
|||||||
var stream: RandomNumberGenerator = rng.open_stream("gp_drop")
|
var stream: RandomNumberGenerator = rng.open_stream("gp_drop")
|
||||||
roll = stream.randi_range(int(drops.get("roll_min", 0)), int(drops.get("roll_max", 0)))
|
roll = stream.randi_range(int(drops.get("roll_min", 0)), int(drops.get("roll_max", 0)))
|
||||||
var drop := roll + db.shop_level_gp_bonus(int(encounter.get("level_index", 0)))
|
var drop := roll + db.shop_level_gp_bonus(int(encounter.get("level_index", 0)))
|
||||||
# 财富之道·聚（迭代 21 T3——战斗掉落 GP 乘算·入账前：只乘战斗掉落两成分〔掷定+关卡加成〕，
|
# 财富之道·聚（战斗掉落 GP 乘算·入账前：只乘战斗掉落两成分〔掷定+关卡加成〕，
|
||||||
# 店内 escrow 不乘〔范围=仅战斗掉落渠道，卡片§11②裁决〕；本函数返回值=结算框「GP 增量」行
|
# 店内 escrow 不乘〔范围=仅战斗掉落渠道〕；本函数返回值=结算框「GP 增量」行
|
||||||
# 显示源，落在入账前=显示即实得；乘数 provisional 150%，值归 M4 数值批）
|
# 显示源，落在入账前=显示即实得；乘数 provisional 150%）
|
||||||
if (encounter.get("tree_rules", []) as Array).has("economy_hoard"):
|
if (encounter.get("tree_rules", []) as Array).has("economy_hoard"):
|
||||||
drop = int(round(float(drop) * 1.5))
|
drop = int(round(float(drop) * 1.5))
|
||||||
return drop + escrow
|
return drop + escrow
|
||||||
|
|
||||||
|
|
||||||
# ---- 呈现状态面（E1 封装收口 2026-09-13）：呈现层 / headless 自动玩家的唯一读取出口——
|
# ---- 呈现状态面（E1 封装收口）：呈现层 / headless 自动玩家的唯一读取出口——
|
||||||
# 协作对象（_enemy_system/_status_effects/_reward_economy）私有化后，跨层读取一律经本快照或下列命名面（diagnostic_snapshot 同款模式，
|
# 协作对象（_enemy_system/_status_effects/_reward_economy）私有化后，跨层读取一律经本快照或下列命名面（diagnostic_snapshot 同款模式，
|
||||||
# 禁再链式穿透 settlement.enemy_system.hero 一类路径）。载荷 schema 成文（code-conventions 2.1）：
|
# 禁再链式穿透 settlement.enemy_system.hero 一类路径）。载荷 schema 成文（code-conventions 2.1）：
|
||||||
# round / battle_result / phase / ap / rap / can_refresh / hero{hp,max_hp,atk,alive,armor_class} /
|
# round / battle_result / phase / ap / rap / can_refresh / hero{hp,max_hp,atk,alive,armor_class} /
|
||||||
# enemies[{order,display_name,hp,max_hp,enemy_id,armor_type,armor_class,pending_skill,pending_type,pending_name,effects[],alive}] /
|
# enemies[{order,display_name,hp,max_hp,enemy_id,armor_type,armor_class,pending_skill,pending_type,pending_name,effects[],alive}] /
|
||||||
# （敌人技能池批批 2 定稿：beat/ring_size/ring_index 拆除 → pending_* 三字段 + 敌方增益 effects 投影；池与权重不公开；
|
# （字段面=pending_* 三字段 + 敌方增益 effects 投影；池与权重不公开；警觉走 effects 投影）
|
||||||
# 八型批 2026-09-20：ambush_layers 拆除——伏击退役，警觉并入 effects 投影）hero_effects[]（增益状态 query_active 投影）
|
# hero_effects[]（增益状态 query_active 投影）
|
||||||
func presentation_snapshot() -> Dictionary:
|
func presentation_snapshot() -> Dictionary:
|
||||||
var enemies: Array[Dictionary] = []
|
var enemies: Array[Dictionary] = []
|
||||||
var all: Array[Variant] = _enemy_system.all_enemies()
|
var all: Array[Variant] = _enemy_system.all_enemies()
|
||||||
# 敌方增益投影（side-wide 状态——蓄力/硬化/削弱/暴走 percent 行 + 警觉 ac 行，八型批 2026-09-20）
|
# 敌方增益投影（side-wide 状态——蓄力/硬化/削弱/暴走 percent 行 + 警觉 ac 行）
|
||||||
var enemy_effects: Array[Dictionary] = []
|
var enemy_effects: Array[Dictionary] = []
|
||||||
for eff in _status_effects.query_active("enemy"):
|
for eff in _status_effects.query_active("enemy"):
|
||||||
var erow: Dictionary[Variant, Variant] = db.status_effect_row(eff.effect_id)
|
var erow: Dictionary[Variant, Variant] = db.status_effect_row(eff.effect_id)
|
||||||
@@ -1206,11 +1202,11 @@ func presentation_snapshot() -> Dictionary:
|
|||||||
"phase": String(action_economy.phase),
|
"phase": String(action_economy.phase),
|
||||||
"ap": int(action_economy.ap), "rap": int(action_economy.rap),
|
"ap": int(action_economy.ap), "rap": int(action_economy.rap),
|
||||||
"can_refresh": can_refresh(),
|
"can_refresh": can_refresh(),
|
||||||
"refresh_used": _refresh_used_this_round, # 迭代 27 T3——P1-2 刷新双账收口：受理计数入呈现成文面（HUD 余量单源读此处）
|
"refresh_used": _refresh_used_this_round, # 受理计数入呈现成文面（HUD 余量单源读此处）
|
||||||
"hero": hero,
|
"hero": hero,
|
||||||
"enemies": enemies,
|
"enemies": enemies,
|
||||||
"hero_effects": _status_effects.query_active("hero").duplicate(true), # 值拷贝出户（code-review 2026-09-29 P2-3——快照消费方直改不渗入状态容器）
|
"hero_effects": _status_effects.query_active("hero").duplicate(true), # 值拷贝出户（快照消费方直改不渗入状态容器）
|
||||||
# 板级变异投影（全局作用域变异首发批 2026-10-04——呈现横幅/常驻角标唯一读取面；
|
# 板级变异投影（呈现横幅/常驻角标唯一读取面；
|
||||||
# 空数组 = 无全局型合法态：普通图与全局池空回落图恒空）
|
# 空数组 = 无全局型合法态：普通图与全局池空回落图恒空）
|
||||||
"board_variants": (minesweeper.current_board().board_variant_ids().duplicate()
|
"board_variants": (minesweeper.current_board().board_variant_ids().duplicate()
|
||||||
if minesweeper.current_board() != null else ([] as Array[String])),
|
if minesweeper.current_board() != null else ([] as Array[String])),
|
||||||
@@ -1228,7 +1224,7 @@ func query_reward_identity(cell: Vector2i):
|
|||||||
|
|
||||||
|
|
||||||
# 诊断观测面（组合根诊断转储 / 行为探针消费）：私有编排状态的成文只读出口——
|
# 诊断观测面（组合根诊断转储 / 行为探针消费）：私有编排状态的成文只读出口——
|
||||||
# 消费方禁止再直读本类下划线字段（code-review 2026-09-12 封装收口批）
|
# 消费方禁止再直读本类下划线字段（封装收口）
|
||||||
func diagnostic_snapshot() -> Dictionary:
|
func diagnostic_snapshot() -> Dictionary:
|
||||||
return {
|
return {
|
||||||
"battle_result": battle_result,
|
"battle_result": battle_result,
|
||||||
@@ -1293,7 +1289,7 @@ func _fatal(msg: String) -> void:
|
|||||||
assert(false, msg)
|
assert(false, msg)
|
||||||
|
|
||||||
|
|
||||||
## 完美排雷谓词（迭代 31 卡② T4——两账相减：有效误标=误标总数−豁免数）
|
## 完美排雷谓词（两账相减：有效误标=误标总数−豁免数）
|
||||||
## 契约 2：_perfect_hit_false 保持纯净，豁免只累加 _perfect_forgiven，禁回退式改写与拦截式吞事件。
|
## 契约 2：_perfect_hit_false 保持纯净，豁免只累加 _perfect_forgiven，禁回退式改写与拦截式吞事件。
|
||||||
func perfect_sweep_earned() -> bool:
|
func perfect_sweep_earned() -> bool:
|
||||||
return _perfect_hit_false - _perfect_forgiven <= 0 and _perfect_hit_true >= 1
|
return _perfect_hit_false - _perfect_forgiven <= 0 and _perfect_hit_true >= 1
|
||||||
@@ -4,7 +4,7 @@
|
|||||||
class_name BoardData
|
class_name BoardData
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
# 出生 3×3 区格数（2026-10-02 修复批 T2 魔法数结构化——W×H−9 布雷域基的双落点收口单点：
|
# 出生 3×3 区格数（W×H−9 布雷域基的双落点收口单点：
|
||||||
# 棋盘生成 _attempt/_finalize 与 BoardGenTable 布雷数下限校验共用；与 spawn_cells() 的 3×3 几何同源）
|
# 棋盘生成 _attempt/_finalize 与 BoardGenTable 布雷数下限校验共用；与 spawn_cells() 的 3×3 几何同源）
|
||||||
const SPAWN_AREA_CELLS := 9
|
const SPAWN_AREA_CELLS := 9
|
||||||
|
|
||||||
@@ -14,7 +14,7 @@ var spawn_center := Vector2i.ZERO
|
|||||||
var mines := {} # Vector2i → true
|
var mines := {} # Vector2i → true
|
||||||
var digits := {} # Vector2i → int（安全格恒有值；数字恒真 = 8 邻雷数）
|
var digits := {} # Vector2i → int（安全格恒有值；数字恒真 = 8 邻雷数）
|
||||||
var variants := {} # Vector2i → Array[String]（生成期快照，抗表重载）
|
var variants := {} # Vector2i → Array[String]（生成期快照，抗表重载）
|
||||||
var board_variants: Array[String] = [] # 板级变异 id 集（scope=global 整图作用域——全局作用域变异批 2026-10-04：
|
var board_variants: Array[String] = [] # 板级变异 id 集（scope=global 整图作用域——
|
||||||
# 战斗编排装板决议写入，随图生灭同 variants；普通图恒空）
|
# 战斗编排装板决议写入，随图生灭同 variants；普通图恒空）
|
||||||
var board_type := "" # 图类型标签（词表 v1.0：dungeon/underdark；玩家侧显示名「地图类型」）
|
var board_type := "" # 图类型标签（词表 v1.0：dungeon/underdark；玩家侧显示名「地图类型」）
|
||||||
var level_index: int = 1
|
var level_index: int = 1
|
||||||
@@ -28,7 +28,7 @@ func in_bounds(c: Vector2i) -> bool:
|
|||||||
return c.x >= 0 and c.y >= 0 and c.x < width and c.y < height
|
return c.x >= 0 and c.y >= 0 and c.x < width and c.y < height
|
||||||
|
|
||||||
|
|
||||||
# 行主序排序键（2026-10-02 修复批——排雷玩法 封印判定批与 地图战斗资源 资格规范化两处手抄收口单点）：
|
# 行主序排序键（排雷玩法 封印判定批与 地图战斗资源 资格规范化两处手抄收口单点）：
|
||||||
# y×1000+x 字典序 = 行主序；板宽域 [8,64] 远小于 1000，x 不跨行、键值不碰撞。
|
# y×1000+x 字典序 = 行主序；板宽域 [8,64] 远小于 1000，x 不跨行、键值不碰撞。
|
||||||
static func row_major_key(c: Vector2i) -> int:
|
static func row_major_key(c: Vector2i) -> int:
|
||||||
return c.y * 1000 + c.x
|
return c.y * 1000 + c.x
|
||||||
@@ -55,7 +55,7 @@ func board_variant_ids() -> Array[String]:
|
|||||||
return board_variants
|
return board_variants
|
||||||
|
|
||||||
|
|
||||||
# 中和格变异（迭代 12 T6 净化工兵——伤害型地形格变普通格；🔴 R4 甲仅限伤害型的过滤在调用方）
|
# 中和格变异（伤害型地形格变普通格；🔴 仅限伤害型的过滤在调用方）
|
||||||
func neighbors8(c: Vector2i) -> Array:
|
func neighbors8(c: Vector2i) -> Array:
|
||||||
var out: Array[Vector2i] = []
|
var out: Array[Vector2i] = []
|
||||||
for dy in range(-1, 2):
|
for dy in range(-1, 2):
|
||||||
@@ -103,7 +103,7 @@ func compute_r0() -> Array:
|
|||||||
var queue: Array[Variant] = b3.duplicate()
|
var queue: Array[Variant] = b3.duplicate()
|
||||||
while not queue.is_empty():
|
while not queue.is_empty():
|
||||||
var c: Vector2i = queue.pop_front()
|
var c: Vector2i = queue.pop_front()
|
||||||
if is_safe(c) and digit_of(c) == 0: # 变异死分支退役（2026-09-18 用户拍板删——与 排雷玩法 展开实现口径归一；变异定稿批按正式语义重接）
|
if is_safe(c) and digit_of(c) == 0: # 与 排雷玩法 展开实现同口径（安全且数字 0 才扩散）
|
||||||
for n in neighbors8(c):
|
for n in neighbors8(c):
|
||||||
if is_safe(n) and not r0.has(n):
|
if is_safe(n) and not r0.has(n):
|
||||||
r0[n] = true
|
r0[n] = true
|
||||||
|
|||||||
@@ -11,7 +11,7 @@ const METRIC_VERSION := 1
|
|||||||
# ==================== 生成入口 ====================
|
# ==================== 生成入口 ====================
|
||||||
|
|
||||||
# rng_stream = 一次 open_stream("board_gen") 实例（一张图的全部取数；重试共用——attempt 边界非 scope 事件）。
|
# rng_stream = 一次 open_stream("board_gen") 实例（一张图的全部取数；重试共用——attempt 边界非 scope 事件）。
|
||||||
# db 参数不标具体类型原因：冒烟工具注入 FakeDB 桩（experiment_density.gd 等）——typed 形参会拒收桩表（2026-10-02 注）
|
# db 参数不标具体类型原因：冒烟工具注入 FakeDB 桩（experiment_density.gd 等）——typed 形参会拒收桩表
|
||||||
func generate(L: int, D: int, rng_stream: RandomNumberGenerator, db) -> BoardData: # type-hint: ignore（测量面 _BoardRowStub 冒烟夹具鸭子型注入——typed 参拒 stub）
|
func generate(L: int, D: int, rng_stream: RandomNumberGenerator, db) -> BoardData: # type-hint: ignore（测量面 _BoardRowStub 冒烟夹具鸭子型注入——typed 参拒 stub）
|
||||||
var row: Dictionary[Variant, Variant] = db.resolve_board_gen(L, D)
|
var row: Dictionary[Variant, Variant] = db.resolve_board_gen(L, D)
|
||||||
if row.is_empty():
|
if row.is_empty():
|
||||||
@@ -86,7 +86,7 @@ func _attempt(params: Dictionary, rng_stream: RandomNumberGenerator, db) -> Boar
|
|||||||
b.level_index = params.L
|
b.level_index = params.L
|
||||||
b.node_depth = params.D
|
b.node_depth = params.D
|
||||||
# ② 布雷：N = round(d×(W×H−9)) 先定数；域 = 全格 − 出生 3×3；均匀布雷后"先布后删"
|
# ② 布雷：N = round(d×(W×H−9)) 先定数；域 = 全格 − 出生 3×3；均匀布雷后"先布后删"
|
||||||
# （−9 = 出生区格数，常量单点 BoardData.SPAWN_AREA_CELLS——2026-10-02 修复批）
|
# （−9 = 出生区格数，常量单点 BoardData.SPAWN_AREA_CELLS）
|
||||||
var spawn := {}
|
var spawn := {}
|
||||||
for c in b.spawn_cells():
|
for c in b.spawn_cells():
|
||||||
spawn[c] = true
|
spawn[c] = true
|
||||||
|
|||||||
+42
-42
@@ -19,13 +19,13 @@ const TABLE_MANIFEST := {
|
|||||||
"settlement": "settlement.tres",
|
"settlement": "settlement.tres",
|
||||||
"level": "level.tres",
|
"level": "level.tres",
|
||||||
"difficulty": "difficulty.tres",
|
"difficulty": "difficulty.tres",
|
||||||
"shop": "shop.tres", # GP+商店房实施批 2026-09-21（表与 schema 落籍归并行数据面——本批只接线加载与消费）
|
"shop": "shop.tres", # ShopTable（表与 schema 落籍归数据面——本处只接线加载与消费）
|
||||||
"meta": "meta.tres", # 元进度实现批 2026-09-21（MetaTable 四行族——schema 与表同批落籍）
|
"meta": "meta.tres", # MetaTable 四行族（schema 与表同源落籍）
|
||||||
"meta_tree": "meta_tree.tres", # 迭代 12 T8 建域、迭代 21 T1 换代 12 节点（MetaTreeTable 定义表 Rule 4 豁免——天赋树.md v0.8 结构事实源）
|
"meta_tree": "meta_tree.tres", # MetaTreeTable 12 节点（定义表 Rule 4 豁免——天赋树.md v0.8 结构事实源）
|
||||||
"treasure_items": "treasure_items.tres", # 迭代 7 T1 秘宝内容批（TreasureItemTable 六行——定义表 Rule 4 豁免；罗盘 retired/失义件 deferred 标记见 schema 头注）
|
"treasure_items": "treasure_items.tres", # TreasureItemTable 六行（定义表 Rule 4 豁免；罗盘 retired/失义件 deferred 标记见 schema 头注）
|
||||||
"adventure": "adventure.tres", # 冒险结构实现批 2026-09-21（AdventureTable 建表——大奖励与钥石行值单点）
|
"adventure": "adventure.tres", # AdventureTable（大奖励与钥石行值单点）
|
||||||
"feats": "feats.tres", # 迭代 12 T1 双层 BD 规则改写型特性基建（FeatTable 定义表 Rule 4 豁免——TreasureItemTable 先例；空表合法态=主时间线零扰动）
|
"feats": "feats.tres", # FeatTable 规则改写型特性（定义表 Rule 4 豁免——TreasureItemTable 先例；空表合法态=主时间线零扰动）
|
||||||
"forge": "forge.tres", # 迭代 23 T1 锻造工坊实装批（ForgeTable——两根类型轴默认值+六路线行族；攻防所有权切分唯一数据面）
|
"forge": "forge.tres", # ForgeTable——两根类型轴默认值+六路线行族；攻防所有权切分唯一数据面
|
||||||
}
|
}
|
||||||
|
|
||||||
var action_economy: ActionEconomyTable
|
var action_economy: ActionEconomyTable
|
||||||
@@ -39,20 +39,20 @@ var reward: RewardTable
|
|||||||
var settlement: SettlementTable
|
var settlement: SettlementTable
|
||||||
var level: LevelTable
|
var level: LevelTable
|
||||||
var difficulty: DifficultyTable
|
var difficulty: DifficultyTable
|
||||||
# GP+商店房实施批（2026-09-21）：ShopTable 类型化持用（schema class_name 已落籍——code-review 2026-09-29 P2-4 收口；
|
# ShopTable 类型化持用（schema class_name 已落籍；
|
||||||
# 消费面一律走下方 shop_* 访问器，禁直读行集）
|
# 消费面一律走下方 shop_* 访问器，禁直读行集）
|
||||||
var shop: ShopTable = null
|
var shop: ShopTable = null
|
||||||
# 元进度实现批（2026-09-21）：MetaTable 类型化持用（schema 与表同批落籍，无 shop 先例的落籍间隙问题）
|
# MetaTable 类型化持用（schema 与表同源落籍）
|
||||||
var meta: MetaTable
|
var meta: MetaTable
|
||||||
var meta_tree: MetaTreeTable # 迭代 12 T8 类型化持用（消费面走 tree_node 访问器）
|
var meta_tree: MetaTreeTable # 类型化持用（消费面走 tree_node 访问器）
|
||||||
var treasure_items: TreasureItemTable # 迭代 7 T1 类型化持用（消费面走 treasure_* 访问器）
|
var treasure_items: TreasureItemTable # 类型化持用（消费面走 treasure_* 访问器）
|
||||||
var adventure: AdventureTable
|
var adventure: AdventureTable
|
||||||
var feats: FeatTable # 迭代 12 T1 类型化持用（消费面走 feat_* 访问器）
|
var feats: FeatTable # 类型化持用（消费面走 feat_* 访问器）
|
||||||
var forge: ForgeTable # 迭代 23 T1 锻造工坊配置（默认两轴+六路线行族——消费面走 forge_* 访问器）
|
var forge: ForgeTable # 锻造工坊配置（默认两轴+六路线行族——消费面走 forge_* 访问器）
|
||||||
|
|
||||||
var is_ready := false
|
var is_ready := false
|
||||||
var _diagnostics: Array[Dictionary] = [] # {severity, category, message}
|
var _diagnostics: Array[Dictionary] = [] # {severity, category, message}
|
||||||
var _resolver: ConfigDbResolver # R1 难度行解析协作类（2026-10-02 修复批 T5 拆分——门面公有签名零变化）
|
var _resolver: ConfigDbResolver # R1 难度行解析协作类（门面公有签名不变）
|
||||||
var _validator := ConfigDbCrossValidator.new() # 跨表校验协作类（无状态——声明期即建）
|
var _validator := ConfigDbCrossValidator.new() # 跨表校验协作类（无状态——声明期即建）
|
||||||
var _reload_gate := false # 数据配置 EC8——战斗结算 唯一调用方
|
var _reload_gate := false # 数据配置 EC8——战斗结算 唯一调用方
|
||||||
|
|
||||||
@@ -70,7 +70,7 @@ func push_diag(severity: String, category: String, message: String) -> void:
|
|||||||
push_error("[ConfigDB/%s] %s" % [category, message])
|
push_error("[ConfigDB/%s] %s" % [category, message])
|
||||||
|
|
||||||
|
|
||||||
# 运行期数据致命（2026-09-18 用户拍板 fail-fast；迭代 27 T6——退出执行归根：核心层不再自携
|
# 运行期数据致命（fail-fast；退出执行归根：核心层不自携
|
||||||
# quit/crash，越域记 Fatal 级日志后置 _fatal_flag，进程退出决策归组合根（main._ready 表加载
|
# quit/crash，越域记 Fatal 级日志后置 _fatal_flag，进程退出决策归组合根（main._ready 表加载
|
||||||
# 失败已有同通道 fatal 屏+fail-fast 边界）——查询期消费方按返回值安全面走既有默认值回退）
|
# 失败已有同通道 fatal 屏+fail-fast 边界）——查询期消费方按返回值安全面走既有默认值回退）
|
||||||
func _fatal(category: String, message: String) -> void:
|
func _fatal(category: String, message: String) -> void:
|
||||||
@@ -79,7 +79,7 @@ func _fatal(category: String, message: String) -> void:
|
|||||||
_fatal_flag = true
|
_fatal_flag = true
|
||||||
|
|
||||||
|
|
||||||
var _fatal_flag := false # 运行期致命封印（迭代 27 T6——退出归根承载；组合根/闸读面）
|
var _fatal_flag := false # 运行期致命封印（退出归根承载；组合根/闸读面）
|
||||||
|
|
||||||
|
|
||||||
func is_fatal() -> bool:
|
func is_fatal() -> bool:
|
||||||
@@ -152,7 +152,7 @@ func load_tables(root: String, collect_only: bool) -> bool:
|
|||||||
return not has_errors
|
return not has_errors
|
||||||
|
|
||||||
|
|
||||||
# ---- relic 访问器（迭代 12 T1——消费面一律走本组，禁直读行集）----
|
# ---- relic 访问器（消费面一律走本组，禁直读行集）----
|
||||||
|
|
||||||
func feat_row(feat_id: String) -> Dictionary:
|
func feat_row(feat_id: String) -> Dictionary:
|
||||||
return feats.row_by_id(feat_id) if feats != null else {}
|
return feats.row_by_id(feat_id) if feats != null else {}
|
||||||
@@ -163,7 +163,7 @@ func feat_rows() -> Array:
|
|||||||
return feats.rows if feats != null else []
|
return feats.rows if feats != null else []
|
||||||
|
|
||||||
|
|
||||||
# 天赋树节点行（迭代 12 T8——MetaProgression 树段/营地树 UI 取数口）
|
# 天赋树节点行（MetaProgression 树段/营地树 UI 取数口）
|
||||||
func tree_node(node_id: String) -> Dictionary:
|
func tree_node(node_id: String) -> Dictionary:
|
||||||
return meta_tree.row_by_id(node_id) if meta_tree != null else {}
|
return meta_tree.row_by_id(node_id) if meta_tree != null else {}
|
||||||
|
|
||||||
@@ -172,8 +172,8 @@ func tree_rows() -> Array:
|
|||||||
return meta_tree.rows if meta_tree != null else []
|
return meta_tree.rows if meta_tree != null else []
|
||||||
|
|
||||||
|
|
||||||
# 跨表校验（悬空引用 / 池护栏——全部加载期致命）本体自 2026-10-02 修复批迁出：
|
# 跨表校验（悬空引用 / 池护栏——全部加载期致命）本体：
|
||||||
# ConfigDbCrossValidator（core/config_db_cross_validator.gd）承载，门面公有签名零变化。
|
# ConfigDbCrossValidator（core/config_db_cross_validator.gd）承载，门面公有签名不变。
|
||||||
func _cross_validate(loaded: Dictionary) -> void:
|
func _cross_validate(loaded: Dictionary) -> void:
|
||||||
_validator.cross_validate(loaded, push_diag)
|
_validator.cross_validate(loaded, push_diag)
|
||||||
|
|
||||||
@@ -183,15 +183,15 @@ func validate_skill_pool_links(skill_table: SkillTable, enemy_table: EnemyTable,
|
|||||||
return _validator.validate_skill_pool_links(skill_table, enemy_table, status_table)
|
return _validator.validate_skill_pool_links(skill_table, enemy_table, status_table)
|
||||||
|
|
||||||
|
|
||||||
# ---- R1 难度行解析（2026-09-18 用户拍板修订：ceil 向上取整保证偏难；域越界与内容缺口 Fatal 退出）----
|
# ---- R1 难度行解析（ceil 向上取整保证偏难；域越界与内容缺口 Fatal 退出）----
|
||||||
# 解析本体自 2026-10-02 修复批迁出：ConfigDbResolver（core/config_db_resolver.gd）承载——
|
# 解析本体：ConfigDbResolver（core/config_db_resolver.gd）承载——
|
||||||
# 含 _resolve_progress/_ceil_key 与 R1 告警去重注册表；门面同名方法委托，越域 Fatal 语义逐位一致。
|
# 含 _resolve_progress/_ceil_key 与 R1 告警去重注册表；门面同名方法委托，越域 Fatal 语义一致。
|
||||||
func resolve_board_gen(L: int, D: int) -> Dictionary:
|
func resolve_board_gen(L: int, D: int) -> Dictionary:
|
||||||
return _resolver.resolve_board_gen(L, D)
|
return _resolver.resolve_board_gen(L, D)
|
||||||
|
|
||||||
|
|
||||||
func resolve_enemy_rowset(L: int, D: int) -> Array[Dictionary]:
|
func resolve_enemy_rowset(L: int, D: int) -> Array[Dictionary]:
|
||||||
return _resolver.resolve_enemy_rowset(L, D) # 行集数组形态（2026-10-07 行集多行批——原单行 Dictionary 退役）
|
return _resolver.resolve_enemy_rowset(L, D) # 行集数组形态（非单行 Dictionary）
|
||||||
|
|
||||||
|
|
||||||
# 难度曲线与Boss DifficultyTable 消费面（敌人系统.spawn 调用）：(L,D) 精确匹配修饰乘数，越域值 clamp（GDD Edge Case——组合事故非配置事故）
|
# 难度曲线与Boss DifficultyTable 消费面（敌人系统.spawn 调用）：(L,D) 精确匹配修饰乘数，越域值 clamp（GDD Edge Case——组合事故非配置事故）
|
||||||
@@ -199,9 +199,9 @@ func resolve_difficulty_modifiers(L: int, D: int) -> Dictionary:
|
|||||||
return _resolver.resolve_difficulty_modifiers(L, D)
|
return _resolver.resolve_difficulty_modifiers(L, D)
|
||||||
|
|
||||||
|
|
||||||
# ---- 地形变异 variant_pool_gate：候选池门控（∅ board_types = 通配；2026-09-19 用户裁定字段名对齐
|
# ---- 地形变异 variant_pool_gate：候选池门控（∅ board_types = 通配；字段名对齐
|
||||||
# board_type 词表——biome_tags 系旧观念残留退役）----
|
# board_type 词表，无 biome_tags）----
|
||||||
# 门控第三维 = 节点身份（全局作用域变异首发批 2026-10-04）：scope=global 行仅 boss/elite 节点入池，
|
# 门控第三维 = 节点身份（全局作用域变异）：scope=global 行仅 boss/elite 节点入池，
|
||||||
# 其余节点（battle 等）静默跳过——门控兜底 P0 口径（零报错零警告）；elite 系前向词位（首发零表行）。
|
# 其余节点（battle 等）静默跳过——门控兜底 P0 口径（零报错零警告）；elite 系前向词位（首发零表行）。
|
||||||
# node_type 缺省 "" = 旧双参调用口径（global 行跳过）——既有测试/冒烟调用零扰动。
|
# node_type 缺省 "" = 旧双参调用口径（global 行跳过）——既有测试/冒烟调用零扰动。
|
||||||
|
|
||||||
@@ -238,8 +238,8 @@ func status_effect_row(effect_id: String) -> Dictionary:
|
|||||||
return status_effects.row_by_id(effect_id)
|
return status_effects.row_by_id(effect_id)
|
||||||
|
|
||||||
|
|
||||||
# ---- 关卡行集访问器（2026-10-02 修复批 T5 表访问收口——level_runner/meta_progression/adventure_runner
|
# ---- 关卡行集访问器（表访问收口——level_runner/meta_progression/adventure_runner
|
||||||
# 直扫 db.level.rows 退役；消费面一律走本访问器，行集解析单点归 LevelTable）----
|
# 不直扫 db.level.rows；消费面一律走本访问器，行集解析单点归 LevelTable）----
|
||||||
|
|
||||||
# 关卡行单点读取（键 = level_index，缺行返回空字典——消费方按既有空行防御路径处理）
|
# 关卡行单点读取（键 = level_index，缺行返回空字典——消费方按既有空行防御路径处理）
|
||||||
func level_row(level_index: int) -> Dictionary:
|
func level_row(level_index: int) -> Dictionary:
|
||||||
@@ -251,27 +251,27 @@ func level_count() -> int:
|
|||||||
return level.rows.size() if level != null else 0
|
return level.rows.size() if level != null else 0
|
||||||
|
|
||||||
|
|
||||||
# ---- GP+商店房实施批（2026-09-21）：ShopTable 消费面（行集解析单点——runner/战斗编排禁自扫表）----
|
# ---- ShopTable 消费面（行集解析单点——runner/战斗编排禁自扫表）----
|
||||||
# ── 秘宝访问器（迭代 7 T1——消费面一律走访问器，禁直读行集）──
|
# ── 秘宝访问器（消费面一律走访问器，禁直读行集）──
|
||||||
# 活行集（非 retired 非 deferred）——投放校验/奖励节点池/呈现可用性的唯一取数口径
|
# 活行集（非 retired 非 deferred）——投放校验/奖励节点池/呈现可用性的唯一取数口径
|
||||||
func treasure_item_row(item_id: String) -> Dictionary:
|
func treasure_item_row(item_id: String) -> Dictionary:
|
||||||
return treasure_items.row_by_id(item_id) if treasure_items != null else {}
|
return treasure_items.row_by_id(item_id) if treasure_items != null else {}
|
||||||
|
|
||||||
|
|
||||||
# 过渡渠道活行（form 空 = 切片期过渡形态）——掉落投放/停点池/工坊解锁取数口径；同调行（form 非空）
|
# 过渡渠道活行（form 空 = 切片期过渡形态）——掉落投放/停点池/工坊解锁取数口径；同调行（form 非空）
|
||||||
# 永不入过渡渠道（迭代 11 第①批 T1；T7 退役面切换后本口径随渠道消亡）
|
# 永不入过渡渠道
|
||||||
func treasure_transitional_rows() -> Array:
|
func treasure_transitional_rows() -> Array:
|
||||||
return treasure_items.transitional_rows() if treasure_items != null else []
|
return treasure_items.transitional_rows() if treasure_items != null else []
|
||||||
|
|
||||||
|
|
||||||
# 同调行集（form 非空——装配覆盖层/效果接线的取数口径，迭代 11 第①批 T1/T4）
|
# 同调行集（form 非空——装配覆盖层/效果接线的取数口径）
|
||||||
func treasure_attunement_rows() -> Array:
|
func treasure_attunement_rows() -> Array:
|
||||||
return treasure_items.attunement_rows() if treasure_items != null else []
|
return treasure_items.attunement_rows() if treasure_items != null else []
|
||||||
|
|
||||||
|
|
||||||
# 活行词表（掉落投放 effect_id 白名单——过渡渠道口径）
|
# 活行词表（掉落投放 effect_id 白名单——过渡渠道口径）
|
||||||
# ── 同调轴访问器已删除（迭代 21 T5——attunement_growth 谓词表随槽位收编退役：槽位数量=树同调位
|
# ── 同调槽位数=树同调位节点点亮数，判定源=Attunement.slots（无 attunement_growth 谓词表访问器）；
|
||||||
# 节点点亮数，判定源=Attunement.slots；boss_kill_count/clear_count 计数域保留——非槽位硬消费在册）──
|
# boss_kill_count/clear_count 计数域保留——非槽位硬消费在册 ──
|
||||||
|
|
||||||
|
|
||||||
# 行族四轴（数据契约，行集归 shop.tres）：gp_drops {tier, mean, roll_min, roll_max} ·
|
# 行族四轴（数据契约，行集归 shop.tres）：gp_drops {tier, mean, roll_min, roll_max} ·
|
||||||
@@ -311,7 +311,7 @@ func shop_product_row(product_id: String) -> Dictionary:
|
|||||||
return {}
|
return {}
|
||||||
|
|
||||||
|
|
||||||
# ── 共享池货架访问器（M-4 迭代 11 第②批 T1——消费面一律走访问器，禁直读行集）──
|
# ── 共享池货架访问器（M-4——消费面一律走访问器，禁直读行集）──
|
||||||
|
|
||||||
# 货架行族（{kind_id, display_name, base_price}——行序即抽签/呈现稳定序）
|
# 货架行族（{kind_id, display_name, base_price}——行序即抽签/呈现稳定序）
|
||||||
func shop_pool_rows() -> Array:
|
func shop_pool_rows() -> Array:
|
||||||
@@ -342,8 +342,8 @@ func _shop_rows(family: String) -> Array:
|
|||||||
return arr if arr is Array else []
|
return arr if arr is Array else []
|
||||||
|
|
||||||
|
|
||||||
# ---- 元进度实现批（2026-09-21）：MetaTable 消费面（行集解析单点——MetaProgression/呈现层禁自扫表）----
|
# ---- MetaTable 消费面（行集解析单点——MetaProgression/呈现层禁自扫表）----
|
||||||
# 行族四轴（数据契约，行集归 meta.tres，数值全 provisional 归元进度设计批配读数）：
|
# 行族四轴（数据契约，行集归 meta.tres，数值全 provisional）：
|
||||||
# forge_products {attr, display_name, flat_value, base_price, price_ratio_pct} ·
|
# forge_products {attr, display_name, flat_value, base_price, price_ratio_pct} ·
|
||||||
# boss_keystone {level_index, first_kill, repeat_kill} ·
|
# boss_keystone {level_index, first_kill, repeat_kill} ·
|
||||||
# workshop_items {item_id, display_name, clear_threshold} ·
|
# workshop_items {item_id, display_name, clear_threshold} ·
|
||||||
@@ -356,8 +356,8 @@ func meta_boss_keystone_row(level_index: int) -> Dictionary:
|
|||||||
return {}
|
return {}
|
||||||
|
|
||||||
|
|
||||||
# meta_workshop_items 访问器已删除（迭代 22 T2——工坊行族退役，解锁混合制挂 treasure_items 行内；
|
# 秘宝解锁混合制挂 treasure_items 行内（无 meta_workshop_items 访问器）；
|
||||||
# 秘宝解锁投影面=MetaProgression.treasure_shop_status）
|
# 秘宝解锁投影面=MetaProgression.treasure_shop_status
|
||||||
|
|
||||||
|
|
||||||
func meta_conversion_row(attr: String) -> Dictionary:
|
func meta_conversion_row(attr: String) -> Dictionary:
|
||||||
@@ -367,7 +367,7 @@ func meta_conversion_row(attr: String) -> Dictionary:
|
|||||||
return {}
|
return {}
|
||||||
|
|
||||||
|
|
||||||
# Y 刷新升级行单点读取（迭代 11 第①批 T4——键 = 等级，缺行返回空字典=未购/已满级合法态）
|
# Y 刷新升级行单点读取（键 = 等级，缺行返回空字典=未购/已满级合法态）
|
||||||
func meta_attune_refresh_row(level: int) -> Dictionary:
|
func meta_attune_refresh_row(level: int) -> Dictionary:
|
||||||
for row in _meta_rows("attune_refresh_upgrade"):
|
for row in _meta_rows("attune_refresh_upgrade"):
|
||||||
if int(row.get("level", -1)) == level:
|
if int(row.get("level", -1)) == level:
|
||||||
@@ -383,7 +383,7 @@ func _meta_rows(family: String) -> Array:
|
|||||||
return arr if arr is Array else []
|
return arr if arr is Array else []
|
||||||
|
|
||||||
|
|
||||||
# ---- 锻造工坊（迭代 23 T1——ForgeTable 消费面：两根类型轴默认值+六路线行族；禁自扫行集）----
|
# ---- 锻造工坊（ForgeTable 消费面：两根类型轴默认值+六路线行族；禁自扫行集）----
|
||||||
# 设计权威 design/gdd/systems/跨局循环/锻造工坊.md v0.6：默认值归本表常驻持有（hero.tres 两轴已删——
|
# 设计权威 design/gdd/systems/跨局循环/锻造工坊.md v0.6：默认值归本表常驻持有（hero.tres 两轴已删——
|
||||||
# 契约 2）；路线行族=攻防数值成长唯一数据面（契约 1）。数值全 provisional 归 M4。
|
# 契约 2）；路线行族=攻防数值成长唯一数据面（契约 1）。数值全 provisional 归 M4。
|
||||||
|
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ func cross_validate(loaded: Dictionary, push_diag: Callable) -> void:
|
|||||||
for row in st.rows:
|
for row in st.rows:
|
||||||
effect_ids[row.get("effect_id", "")] = true
|
effect_ids[row.get("effect_id", "")] = true
|
||||||
# ① RewardTable effect_id 悬空（percent 行引用 StatusEffectTable——悬空加载致命）。
|
# ① RewardTable effect_id 悬空（percent 行引用 StatusEffectTable——悬空加载致命）。
|
||||||
# GP+商店房实施批（2026-09-21）例外：gp_gain/gp_loss = GP 战斗内缓冲（escrow）通道的路由键
|
# 例外：gp_gain/gp_loss = GP 战斗内缓冲（escrow）通道的路由键
|
||||||
# （战斗结算 _apply_gp_row 兑付——不入增益状态容器），词表封闭按字面豁免悬空引用校验。
|
# （战斗结算 _apply_gp_row 兑付——不入增益状态容器），词表封闭按字面豁免悬空引用校验。
|
||||||
for row in rt.rows:
|
for row in rt.rows:
|
||||||
if String(row.get("cell_type", "")) == RewardTable.TREASURE_ITEM_TYPE:
|
if String(row.get("cell_type", "")) == RewardTable.TREASURE_ITEM_TYPE:
|
||||||
@@ -23,7 +23,7 @@ func cross_validate(loaded: Dictionary, push_diag: Callable) -> void:
|
|||||||
var eff: String = row.get("effect_id", "")
|
var eff: String = row.get("effect_id", "")
|
||||||
if eff != "" and eff != "gp_gain" and eff != "gp_loss" and not effect_ids.has(eff):
|
if eff != "" and eff != "gp_gain" and eff != "gp_loss" and not effect_ids.has(eff):
|
||||||
push_diag.call("error", "dangling_effect", "RewardTable %s 引用不存在的 effect_id: %s" % [row.get("reward_id"), eff])
|
push_diag.call("error", "dangling_effect", "RewardTable %s 引用不存在的 effect_id: %s" % [row.get("reward_id"), eff])
|
||||||
# ①b RewardTable aux 投放行双表校验（迭代 7 T1——reward_dangling_treasure）：aux 行 effect_id = item_id，
|
# ①b RewardTable aux 投放行双表校验（reward_dangling_treasure）：aux 行 effect_id = item_id，
|
||||||
# 须命中 TreasureItemTable 活行（非 retired 非 deferred——罗盘退役/失义件不投放）。retired 行被引用=退役
|
# 须命中 TreasureItemTable 活行（非 retired 非 deferred——罗盘退役/失义件不投放）。retired 行被引用=退役
|
||||||
# 后仍投放（连带错误），同拦。
|
# 后仍投放（连带错误），同拦。
|
||||||
var treasure_live := {}
|
var treasure_live := {}
|
||||||
@@ -39,17 +39,14 @@ func cross_validate(loaded: Dictionary, push_diag: Callable) -> void:
|
|||||||
continue
|
continue
|
||||||
if not treasure_live.has(treasure_eff):
|
if not treasure_live.has(treasure_eff):
|
||||||
push_diag.call("error", "reward_dangling_treasure", "RewardTable %s aux 行引用无效道具 %s（retired/deferred/不存在）: %s" % [row.get("reward_id"), treasure_eff, "双表校验"])
|
push_diag.call("error", "reward_dangling_treasure", "RewardTable %s aux 行引用无效道具 %s（retired/deferred/不存在）: %s" % [row.get("reward_id"), treasure_eff, "双表校验"])
|
||||||
# ①c F2 投放维度覆盖（秘宝 GDD——五维度各 ≥1 掉落权重为正的活行）：豁免面 {plan, info, counter}
|
# ①c F2 投放维度覆盖校验不启用：挖格不掉道具，秘宝
|
||||||
# = 罗盘退役（plan，2026-09-29 拍板①乙）+显影件 Alpha 重定（info/counter 悬置）——豁免随 Alpha 重定批消减
|
# 唯一来路=三选一共享池〔节点/通关〕；共享池为「抽到道具位再动态掷定具体道具」，维度覆盖不可
|
||||||
# ①c F2 投放维度覆盖校验随战斗掉落渠道退役（2026-10-01 用户拍板甲——挖格不掉道具，秘宝
|
# 静态校验。
|
||||||
# 唯一来路=三选一共享池〔节点/通关〕）：旧校验=「掉落池五维度各 ≥1 正权重活行」，载体已随
|
|
||||||
# reward.tres aux 投放四行删除而消失；共享池为「抽到道具位再动态掷定具体道具」，维度覆盖不可
|
|
||||||
# 静态校验。静态覆盖保证的重立（如按维度钉共享池抽签面）归同调实施批/渠道设计批。
|
|
||||||
# ② SettlementTable.effect_pool_map 悬空
|
# ② SettlementTable.effect_pool_map 悬空
|
||||||
for eff in st_tab.effect_pool_map.keys():
|
for eff in st_tab.effect_pool_map.keys():
|
||||||
if not effect_ids.has(eff):
|
if not effect_ids.has(eff):
|
||||||
push_diag.call("error", "poolmap_dangling", "SettlementTable.effect_pool_map 悬空 effect_id: %s" % eff)
|
push_diag.call("error", "poolmap_dangling", "SettlementTable.effect_pool_map 悬空 effect_id: %s" % eff)
|
||||||
# ③ source_label_map 键集封闭性（键 = 增益状态 source_class ∪ {enemy_action, hero_attack, seal_miss}——2026-09-15 格面资源批删 item 键）
|
# ③ source_label_map 键集封闭性（键 = 增益状态 source_class ∪ {enemy_action, hero_attack, seal_miss}）
|
||||||
var required_sources := ["safe_cell", "seal_hit", "mine_hit", "clear_reward", "hero_attack", "enemy_action", "seal_miss"]
|
var required_sources := ["safe_cell", "seal_hit", "mine_hit", "clear_reward", "hero_attack", "enemy_action", "seal_miss"]
|
||||||
for s in required_sources:
|
for s in required_sources:
|
||||||
if not st_tab.source_label_map.has(s):
|
if not st_tab.source_label_map.has(s):
|
||||||
@@ -91,7 +88,7 @@ func cross_validate(loaded: Dictionary, push_diag: Callable) -> void:
|
|||||||
if skt != null and en != null:
|
if skt != null and en != null:
|
||||||
for e in validate_skill_pool_links(skt, en, loaded.get("status_effects")):
|
for e in validate_skill_pool_links(skt, en, loaded.get("status_effects")):
|
||||||
push_diag.call("error", e.category, e.message)
|
push_diag.call("error", e.category, e.message)
|
||||||
# ⑥ 商店货架 × 冒险共享池跨表校验（M-4 迭代 11 第②批 T1——次数上限域）：
|
# ⑥ 商店货架 × 冒险共享池跨表校验（M-4——次数上限域）：
|
||||||
# pool_shelf kind 须命中 adventure.CURIO_KINDS 且为有限库存种（cap ∈ [1,99]——gp 无上限种/牌库外种
|
# pool_shelf kind 须命中 adventure.CURIO_KINDS 且为有限库存种（cap ∈ [1,99]——gp 无上限种/牌库外种
|
||||||
# 入货架 = 库存账本无锚，加载致命；gp 袋负交易切边/规则改写型特性三轴切边由 ShopTable 词表封闭另拦）
|
# 入货架 = 库存账本无锚，加载致命；gp 袋负交易切边/规则改写型特性三轴切边由 ShopTable 词表封闭另拦）
|
||||||
var adv = loaded.get("adventure")
|
var adv = loaded.get("adventure")
|
||||||
@@ -100,12 +97,12 @@ func cross_validate(loaded: Dictionary, push_diag: Callable) -> void:
|
|||||||
for row in shp.pool_shelf:
|
for row in shp.pool_shelf:
|
||||||
var kind: String = String(row.get("kind_id", ""))
|
var kind: String = String(row.get("kind_id", ""))
|
||||||
if kind == "feat_ticket":
|
if kind == "feat_ticket":
|
||||||
continue # T5 门票豁免——货架专属机制种（非 deck 池种，零摘牌拿到即开），不入 CURIO_KINDS
|
continue # 门票豁免——货架专属机制种（非 deck 池种，零摘牌拿到即开），不入 CURIO_KINDS
|
||||||
if not adv.CURIO_KINDS.has(kind):
|
if not adv.CURIO_KINDS.has(kind):
|
||||||
push_diag.call("error", "shelf_dangling_kind", "ShopTable.pool_shelf kind %s 不在 AdventureTable.CURIO_KINDS（共享池牌库外种）" % kind)
|
push_diag.call("error", "shelf_dangling_kind", "ShopTable.pool_shelf kind %s 不在 AdventureTable.CURIO_KINDS（共享池牌库外种）" % kind)
|
||||||
continue
|
continue
|
||||||
# TP0 令牌池——货架件须为有限令牌种（配额 >0；种类次数上限退役后库存=剩余令牌数。
|
# TP0 令牌池——货架件须为有限令牌种（配额 >0；种类次数上限已废除，库存=剩余令牌数。
|
||||||
# 迭代 20 T2 四级换代——逐档累计遍历 TIERS 词表，不再点名档位常量）
|
# 四级词表——逐档累计遍历 TIERS 词表，不点名档位常量）
|
||||||
var quota := 0
|
var quota := 0
|
||||||
for tier_v in adv.TIERS:
|
for tier_v in adv.TIERS:
|
||||||
quota += int(adv.curio_quota(kind, String(tier_v)))
|
quota += int(adv.curio_quota(kind, String(tier_v)))
|
||||||
@@ -123,7 +120,7 @@ func validate_skill_pool_links(skill_table: SkillTable, enemy_table: EnemyTable,
|
|||||||
var skill_types := {}
|
var skill_types := {}
|
||||||
for row in skill_table.rows:
|
for row in skill_table.rows:
|
||||||
skill_types[String(row.get("skill_id", ""))] = String(row.get("type", ""))
|
skill_types[String(row.get("skill_id", ""))] = String(row.get("type", ""))
|
||||||
# 施放类 side 守卫（新效应词汇批 2026-09-19）：buff → 敌方侧状态 / debuff → 主角侧状态，防反向挂接
|
# 施放类 side 守卫：buff → 敌方侧状态 / debuff → 主角侧状态，防反向挂接
|
||||||
for row in skill_table.rows:
|
for row in skill_table.rows:
|
||||||
var st: String = String(row.get("type", ""))
|
var st: String = String(row.get("type", ""))
|
||||||
if st != "buff" and st != "debuff":
|
if st != "buff" and st != "debuff":
|
||||||
|
|||||||
@@ -4,11 +4,11 @@
|
|||||||
class_name ConfigDbResolver
|
class_name ConfigDbResolver
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
var _diag: Callable # 诊断/致命通道（迭代 27 T6——门面类型反持解耦，validator 先例：签名 (level, category, message)）
|
var _diag: Callable # 诊断/致命通道（门面类型反持解耦，validator 先例：签名 (level, category, message)）
|
||||||
var _board_gen_rows_get: Callable # () -> Array——board_gen 行集活读（数据面经 Callable 注入，ConfigDb 类型环断根）
|
var _board_gen_rows_get: Callable # () -> Array——board_gen 行集活读（数据面经 Callable 注入，ConfigDb 类型环断根）
|
||||||
var _enemy_rows_get: Callable # () -> Array——enemy 行集活读
|
var _enemy_rows_get: Callable # () -> Array——enemy 行集活读
|
||||||
var _difficulty_get: Callable # () -> DifficultyTable（可空——表缺省合法态）
|
var _difficulty_get: Callable # () -> DifficultyTable（可空——表缺省合法态）
|
||||||
var _warn_dedup: Dictionary[String, bool] = {} # R1 四元组去重注册表（自 ConfigDb 迁入）
|
var _warn_dedup: Dictionary[String, bool] = {} # R1 四元组去重注册表
|
||||||
|
|
||||||
|
|
||||||
func _init(diag_cb: Callable, board_gen_rows_cb: Callable,
|
func _init(diag_cb: Callable, board_gen_rows_cb: Callable,
|
||||||
@@ -19,19 +19,19 @@ func _init(diag_cb: Callable, board_gen_rows_cb: Callable,
|
|||||||
_difficulty_get = difficulty_cb
|
_difficulty_get = difficulty_cb
|
||||||
|
|
||||||
|
|
||||||
# 去重注册表清空（门面 load_tables / reset_diagnostics 调用——与拆分前清空时点逐位一致）
|
# 去重注册表清空（门面 load_tables / reset_diagnostics 调用）
|
||||||
func reset_warn_dedup() -> void:
|
func reset_warn_dedup() -> void:
|
||||||
_warn_dedup.clear()
|
_warn_dedup.clear()
|
||||||
|
|
||||||
|
|
||||||
# ---- R1 难度行解析（2026-09-18 用户拍板修订：ceil 向上取整保证偏难；域越界与内容缺口 Fatal 退出）----
|
# ---- R1 难度行解析（ceil 向上取整保证偏难；域越界与内容缺口 Fatal 退出）----
|
||||||
|
|
||||||
func resolve_board_gen(L: int, D: int) -> Dictionary:
|
func resolve_board_gen(L: int, D: int) -> Dictionary:
|
||||||
return _resolve_progress(_board_gen_rows_get.call(), L, D, "board_gen")
|
return _resolve_progress(_board_gen_rows_get.call(), L, D, "board_gen")
|
||||||
|
|
||||||
|
|
||||||
func resolve_enemy_rowset(L: int, D: int) -> Array[Dictionary]:
|
func resolve_enemy_rowset(L: int, D: int) -> Array[Dictionary]:
|
||||||
# 行集数组形态（2026-10-07 敌人表行集多行批——原单行 Dictionary 退役）：ceil 命中 (l*,d*) 后
|
# 行集数组形态：ceil 命中 (l*,d*) 后
|
||||||
# 返回该坐标全部行、按表文件行序（行序即契约——同坐标多行文件内相邻由 EnemyTable.validate 兜底）。
|
# 返回该坐标全部行、按表文件行序（行序即契约——同坐标多行文件内相邻由 EnemyTable.validate 兜底）。
|
||||||
# 空集表达 = 空数组（生产表下 ceil 命中坐标恒有行，空集仅表空时可达——validate 已拦）。
|
# 空集表达 = 空数组（生产表下 ceil 命中坐标恒有行，空集仅表空时可达——validate 已拦）。
|
||||||
return _resolve_progress(_enemy_rows_get.call(), L, D, "enemy", true)
|
return _resolve_progress(_enemy_rows_get.call(), L, D, "enemy", true)
|
||||||
@@ -67,7 +67,7 @@ func _resolve_progress(rows: Array, L: int, D: int, table_id: String, return_all
|
|||||||
var l_star := _ceil_key(level_keys, L)
|
var l_star := _ceil_key(level_keys, L)
|
||||||
var l_clamped := l_star < 0
|
var l_clamped := l_star < 0
|
||||||
if l_clamped:
|
if l_clamped:
|
||||||
l_star = int(level_keys[-1]) # 超出最大行 → 取最大行封顶（2026-09-18 追加拍板：可取范围内向上取整，超出用最大值）
|
l_star = int(level_keys[-1]) # 超出最大行 → 取最大行封顶（可取范围内向上取整，超出用最大值）
|
||||||
var depth_keys: Array[int] = []
|
var depth_keys: Array[int] = []
|
||||||
for row in rows:
|
for row in rows:
|
||||||
if int(row.get("level_index", 0)) == l_star:
|
if int(row.get("level_index", 0)) == l_star:
|
||||||
|
|||||||
@@ -7,14 +7,14 @@ class_name DamageController
|
|||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
const POLICY_IMMEDIATE := "immediate" # A：开单即结（现状行为——回切位）
|
const POLICY_IMMEDIATE := "immediate" # A：开单即结（现状行为——回切位）
|
||||||
const POLICY_SEGMENT := "segment" # B：攒批到段界 flush 统一结（2026-09-24 用户拍板目标形态）
|
const POLICY_SEGMENT := "segment" # B：攒批到段界 flush 统一结（目标形态）
|
||||||
|
|
||||||
# 兑付配方（kind → 步序）：
|
# 兑付配方（kind → 步序）：
|
||||||
# hero_attack 战斗段·主角先手：掷点折扣暴击 → 克制点数（attack_type vs 敌护甲类型）→
|
# hero_attack 战斗段·主角先手：掷点折扣暴击 → 克制点数（attack_type vs 敌护甲类型）→
|
||||||
# hero_offense×enemy_defense 池乘区 → 下限 → 交付；行载荷带 roll/ac/tier/killed。
|
# hero_offense×enemy_defense 池乘区 → 下限 → 交付；行载荷带 roll/ac/tier/killed。
|
||||||
# enemy_skill 战斗段·敌方伤害技（含普攻）：基线 = round(atk×倍率)（开单侧算好入 base_value）→
|
# enemy_skill 战斗段·敌方伤害技（含普攻）：基线 = round(atk×倍率)（开单侧算好入 base_value）→
|
||||||
# 掷点折扣暴击 → 克制点数（attack_type vs 主角护甲类型——迭代 24 N3 轴开列，
|
# 掷点折扣暴击 → 克制点数（attack_type vs 主角护甲类型——
|
||||||
# 前态恒中性 delta 0）→ hero_defense×enemy_output
|
# 无类型恒中性 delta 0）→ hero_defense×enemy_output
|
||||||
# 池乘区 → 下限 → +rider（必中附加）→ 交付 → commit_action；来源敌已死 = 作废。
|
# 池乘区 → 下限 → +rider（必中附加）→ 交付 → commit_action；来源敌已死 = 作废。
|
||||||
# board_typed 棋盘·单目标克制直伤（穿刺弹/魔法矢正向）：必中全额，克制点数进加法核，下限保底。
|
# board_typed 棋盘·单目标克制直伤（穿刺弹/魔法矢正向）：必中全额，克制点数进加法核，下限保底。
|
||||||
# board_blast 棋盘·群伤（爆裂粉尘/清障炸药）：无类型恒定表值，全体存活敌逐个交付。
|
# board_blast 棋盘·群伤（爆裂粉尘/清障炸药）：无类型恒定表值，全体存活敌逐个交付。
|
||||||
@@ -30,19 +30,19 @@ const TARGET_HERO := "hero"
|
|||||||
const TARGET_ALL_ALIVE := "all_alive_enemies"
|
const TARGET_ALL_ALIVE := "all_alive_enemies"
|
||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
var rng: RngServiceCore # 注入成员类型注（2026-10-02 修复批——单测经真实 RngService 构造，标注安全）
|
var rng: RngServiceCore # 注入成员类型注（单测经真实 RngService 构造，标注安全）
|
||||||
var units: UnitContainer # UnitContainer——目标解析/伤害交付/存活查询（句柄即 Dictionary 引用）
|
var units: UnitContainer # UnitContainer——目标解析/伤害交付/存活查询（句柄即 Dictionary 引用）
|
||||||
var effects: StatusContainer # StatusContainer——池值/AC 型效果读取（增益状态 只读消费面）
|
var effects: StatusContainer # StatusContainer——池值/AC 型效果读取（增益状态 只读消费面）
|
||||||
var emit_row_cb: Callable # 行协议注入口：func(type, source_class, origin_cell, ri, display, value, extra, highlight)
|
var emit_row_cb: Callable # 行协议注入口：func(type, source_class, origin_cell, ri, display, value, extra, highlight)
|
||||||
|
|
||||||
var policy := POLICY_SEGMENT # 结账时机开关（2026-09-24 用户拍板第二步拨 B＝攒批段界统一结；回切 A 改回 POLICY_IMMEDIATE 即还原迁移前行为）
|
var policy := POLICY_SEGMENT # 结账时机开关（B＝攒批段界统一结；回切 A 改 POLICY_IMMEDIATE 即开单即结）
|
||||||
var _queue: Array[Dictionary] = [] # 未结单据（B 模式攒批；A 模式恒空）
|
var _queue: Array[Dictionary] = [] # 未结单据（B 模式攒批；A 模式恒空）
|
||||||
var _outcomes := {} # ticket_id → "redeemed"/"zero"/"voided"（结账后可查——清图高光份数消费）
|
var _outcomes := {} # ticket_id → "redeemed"/"zero"/"voided"（结账后可查——清图高光份数消费）
|
||||||
var _seq := 0 # 流水号
|
var _seq := 0 # 流水号
|
||||||
var _halted := false # 主角倒下终止封印（死亡事件置位——flush 余单作废）
|
var _halted := false # 主角倒下终止封印（死亡事件置位——flush 余单作废）
|
||||||
var _hero_ac_override := -1 # 主角护甲等级合流入参（begin_battle 显式设定——-1 = 表值兜底，口径同战斗编排器）
|
var _hero_ac_override := -1 # 主角护甲等级合流入参（begin_battle 显式设定——-1 = 表值兜底，口径同战斗编排器）
|
||||||
# 效果引擎（内容数据驱动扩展批 T1/T3——attack_commit/clamp_check/armor_roll/kill/damage_taken
|
# 效果引擎（attack_commit/clamp_check/armor_roll/kill/damage_taken
|
||||||
# 发射+施加面：dispatch 返回命中，本类按组合规则施加——T3 起旧 feat_seals 封印消费点全部拆除）
|
# 发射+施加面：dispatch 返回命中，本类按组合规则施加）
|
||||||
var _fx: EffectEngine = null
|
var _fx: EffectEngine = null
|
||||||
# 战斗段运行态事实（编排器每轮刷新——fact 取数面：attack_commit 载荷 dig_streak /
|
# 战斗段运行态事实（编排器每轮刷新——fact 取数面：attack_commit 载荷 dig_streak /
|
||||||
# charge_layers facts〔猎巢人 per/整备 attack_bonus per/厚积薄发 when/铁壁 shield per〕；
|
# charge_layers facts〔猎巢人 per/整备 attack_bonus per/厚积薄发 when/铁壁 shield per〕；
|
||||||
@@ -80,7 +80,7 @@ func _fx_hits(event: String, payload: Dictionary) -> Array:
|
|||||||
|
|
||||||
# 事件发射薄面（免施加观测位——enemy_hp_threshold 等现无订阅者的事件保留零扰动面）
|
# 事件发射薄面（免施加观测位——enemy_hp_threshold 等现无订阅者的事件保留零扰动面）
|
||||||
# 补充事实面（fact 取值第二优先源——payload 未携带的运行态读数：charge_layers 编排器每轮注入。
|
# 补充事实面（fact 取值第二优先源——payload 未携带的运行态读数：charge_layers 编排器每轮注入。
|
||||||
# 迭代 20 T1——hp_ratio 补入〔背水 when 面，敌技 damage_taken 载荷不带血比例时回落〕；
|
# hp_ratio 补入〔背水 when 面，敌技 damage_taken 载荷不带血比例时回落〕；
|
||||||
# fx_reveal_request=揭示效果回调〔斩首学者 kill 订阅面——编排器注入，入队授予段末兑付〕）
|
# fx_reveal_request=揭示效果回调〔斩首学者 kill 订阅面——编排器注入，入队授予段末兑付〕）
|
||||||
func _fx_fact(fact: String):
|
func _fx_fact(fact: String):
|
||||||
match fact:
|
match fact:
|
||||||
@@ -135,7 +135,7 @@ func submit(t: Dictionary) -> int:
|
|||||||
|
|
||||||
# 单据构造（缺省填齐——调用点只写差异栏；context = kind 专用：enemy_skill 带 skill_id/baseline，
|
# 单据构造（缺省填齐——调用点只写差异栏；context = kind 专用：enemy_skill 带 skill_id/baseline，
|
||||||
# board_flat_hero 的键并入行载荷，board_blast/board_typed 带 batch_key 供未生效行归因）。
|
# board_flat_hero 的键并入行载荷，board_blast/board_typed 带 batch_key 供未生效行归因）。
|
||||||
# attack_commit 发射点（内容数据驱动扩展批 T3——我方伤害单据开立入口，需求卡片 §3.1 定稿位；
|
# attack_commit 发射点（我方伤害单据开立入口；
|
||||||
# 命中挂单据 context 随行——施加面在 _resolve_hero_attack 管线算术前逐族施加，开单时点=主角攻击
|
# 命中挂单据 context 随行——施加面在 _resolve_hero_attack 管线算术前逐族施加，开单时点=主角攻击
|
||||||
# 单恒为段内首单（结账现场与开单现场一致）。载荷 atk/target/matchup + 挖掘 streak 事实〔连珠矢/
|
# 单恒为段内首单（结账现场与开单现场一致）。载荷 atk/target/matchup + 挖掘 streak 事实〔连珠矢/
|
||||||
# 执拗订阅面〕+巢穴控制数〔猎巢人〕）
|
# 执拗订阅面〕+巢穴控制数〔猎巢人〕）
|
||||||
@@ -170,7 +170,7 @@ func open_ticket(kind: String, source_class: String, display: String, channel: S
|
|||||||
return t
|
return t
|
||||||
|
|
||||||
|
|
||||||
# 同步开单（清图批专用——完美第二份与高光份数的流程依赖需要同步读数，开单权归流程 用户裁决③）：
|
# 同步开单（清图批专用——完美第二份与高光份数的流程依赖需要同步读数，开单权归流程）：
|
||||||
# 先按开单序结清段内排队的单据（保序），再无视结账时机政策当场兑现本单。
|
# 先按开单序结清段内排队的单据（保序），再无视结账时机政策当场兑现本单。
|
||||||
func flush_submit(t: Dictionary) -> int:
|
func flush_submit(t: Dictionary) -> int:
|
||||||
flush()
|
flush()
|
||||||
@@ -203,7 +203,7 @@ func outcome(ticket_id: int) -> String:
|
|||||||
return String(_outcomes.get(ticket_id, "pending"))
|
return String(_outcomes.get(ticket_id, "pending"))
|
||||||
|
|
||||||
|
|
||||||
# ---- 死亡事件（用户裁决③——单位自行宣布，本类消费）----
|
# ---- 死亡事件（单位自行宣布，本类消费）----
|
||||||
|
|
||||||
func _on_unit_died(u: Dictionary) -> void:
|
func _on_unit_died(u: Dictionary) -> void:
|
||||||
if bool(u.get("is_hero", false)):
|
if bool(u.get("is_hero", false)):
|
||||||
@@ -243,12 +243,12 @@ func _resolve(t: Dictionary) -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 主角先手攻击：掷点 → 折扣/暴击 → 克制点数 → hero_offense×enemy_defense 池乘区 → 下限 → 交付
|
# 主角先手攻击：掷点 → 折扣/暴击 → 克制点数 → hero_offense×enemy_defense 池乘区 → 下限 → 交付
|
||||||
# （内容数据驱动扩展批 T3——attack_commit/clamp_check/armor_roll 订阅施加面：命中=开单入口随单
|
# （attack_commit/clamp_check/armor_roll 订阅施加面：命中=开单入口随单
|
||||||
# context 携带，按迁移前算序逐族施加——命中序=数据表声明序，确定性）。
|
# context 携带，按固定算序逐族施加——命中序=数据表声明序，确定性）。
|
||||||
# 迭代 27 T2 姊妹病灶拆段（P1-1）：原 148 行单体拆四步——命中面(_hero_attack_ctx，目标/护甲/
|
# 四步分段：命中面(_hero_attack_ctx，目标/护甲/
|
||||||
# 掷点/按序改写族四拍/克制点数) → 基值装配(_hero_attack_base_value，加法族/计数器施加/倍乘) →
|
# 掷点/按序改写族四拍/克制点数) → 基值装配(_hero_attack_base_value，加法族/计数器施加/倍乘) →
|
||||||
# 掷点兑现(_hero_attack_redeem，rolled/池乘/下限/rider/落地/击杀发射) → 交付(_hero_attack_deliver，
|
# 掷点兑现(_hero_attack_redeem，rolled/池乘/下限/rider/落地/击杀发射) → 交付(_hero_attack_deliver，
|
||||||
# 状态施加/标签/明细行)。步骤间经 ctx/redemption 字典穿线——算序/取值逐字保留（🔴 逐位一致契约）。
|
# 状态施加/标签/明细行)。步骤间经 ctx/redemption 字典穿线——算序/取值固定（🔴 逐位一致契约）。
|
||||||
func _resolve_hero_attack(t: Dictionary) -> void:
|
func _resolve_hero_attack(t: Dictionary) -> void:
|
||||||
var ctx := _hero_attack_ctx(t)
|
var ctx := _hero_attack_ctx(t)
|
||||||
if ctx.is_empty():
|
if ctx.is_empty():
|
||||||
@@ -272,10 +272,10 @@ func _hero_attack_ctx(t: Dictionary) -> Dictionary:
|
|||||||
var ac_payload: Dictionary[Variant, Variant] = (t.context.get("fx_attack_payload", {}) as Dictionary)
|
var ac_payload: Dictionary[Variant, Variant] = (t.context.get("fx_attack_payload", {}) as Dictionary)
|
||||||
var roll_read: Dictionary[Variant, Variant] = _armor_roll()
|
var roll_read: Dictionary[Variant, Variant] = _armor_roll()
|
||||||
var threshold: int = defender_ac(target) + int(db.settlement.attack_bonus)
|
var threshold: int = defender_ac(target) + int(db.settlement.attack_bonus)
|
||||||
# armor_roll 发射点（内容数据驱动扩展批 T1——敌护甲掷骰判定；免掷恒折扣订阅面）
|
# armor_roll 发射点（敌护甲掷骰判定；免掷恒折扣订阅面）
|
||||||
var ar_hits := _fx_hits("armor_roll", {"target_ac": threshold, "roll": int(roll_read.roll)})
|
var ar_hits := _fx_hits("armor_roll", {"target_ac": threshold, "roll": int(roll_read.roll)})
|
||||||
# 按序改写族第一拍：矿工重锤命中交换（正负双修原生形态：命中判定减成 trade_hit 点〔更易命中〕
|
# 按序改写族第一拍：矿工重锤命中交换（正负双修原生形态：命中判定减成 trade_hit 点〔更易命中〕
|
||||||
# 换攻击增伤 trade_atk%——高 AC 负期望/低 AC 正期望；改写位先于掷点折扣读数，与迁移前一致）
|
# 换攻击增伤 trade_atk%——高 AC 负期望/低 AC 正期望；改写位先于掷点折扣读数）
|
||||||
var trade_hit := 0
|
var trade_hit := 0
|
||||||
for h in ac_hits:
|
for h in ac_hits:
|
||||||
if String(h.get("kind", "")) == "modify_ticket" and int(h.get("trade_hit", 0)) > 0:
|
if String(h.get("kind", "")) == "modify_ticket" and int(h.get("trade_hit", 0)) > 0:
|
||||||
@@ -314,9 +314,9 @@ func _hero_attack_ctx(t: Dictionary) -> Dictionary:
|
|||||||
for h in clamp_hits:
|
for h in clamp_hits:
|
||||||
if String(h.get("kind", "")) == "modify_ticket" and h.has("delta"):
|
if String(h.get("kind", "")) == "modify_ticket" and h.has("delta"):
|
||||||
cdelta += int(h.delta)
|
cdelta += int(h.delta)
|
||||||
# 淬毒刃纹（迭代 11 同调批 T5 → 内容数据驱动扩展批 T4：特判拆除——行 triggers clamp_check
|
# 淬毒刃纹（行 triggers clamp_check
|
||||||
# modify(mode:clamp_bonus) 订阅命中已并入上方 delta 合计；mode 路由=主角攻击面专享，
|
# modify(mode:clamp_bonus) 订阅命中并入上方 delta 合计；mode 路由=主角攻击面专享，
|
||||||
# 棋盘克制直伤窗只消费无模式 delta——棋盘不吃毒面与迁移前一致）
|
# 棋盘克制直伤窗只消费无模式 delta——棋盘不吃毒面）
|
||||||
return {"target": target, "armor": armor, "atk_type": atk_type, "ac_hits": ac_hits,
|
return {"target": target, "armor": armor, "atk_type": atk_type, "ac_hits": ac_hits,
|
||||||
"ac_payload": ac_payload, "roll_read": roll_read, "threshold": threshold,
|
"ac_payload": ac_payload, "roll_read": roll_read, "threshold": threshold,
|
||||||
"crit": crit, "discount": discount, "spike_ready": spike_ready, "cdelta": cdelta}
|
"crit": crit, "discount": discount, "spike_ready": spike_ready, "cdelta": cdelta}
|
||||||
@@ -328,7 +328,7 @@ func _hero_attack_base_value(t: Dictionary, ctx: Dictionary) -> float:
|
|||||||
var ac_hits: Array[Variant] = ctx["ac_hits"]
|
var ac_hits: Array[Variant] = ctx["ac_hits"]
|
||||||
var ac_payload: Dictionary[Variant, Variant] = ctx["ac_payload"]
|
var ac_payload: Dictionary[Variant, Variant] = ctx["ac_payload"]
|
||||||
var base_value := float(t.base_value)
|
var base_value := float(t.base_value)
|
||||||
# 单位标记加伤（迭代 20 T1——处刑台 target_attack_bonus 挂单位字典 fx_atk_bonus 键；
|
# 单位标记加伤（处刑台 target_attack_bonus 挂单位字典 fx_atk_bonus 键；
|
||||||
# 阈值沿发射点已写入，本处通用消费——对该敌伤害加算）
|
# 阈值沿发射点已写入，本处通用消费——对该敌伤害加算）
|
||||||
base_value += float(int((ctx["target"] as Dictionary).get("fx_atk_bonus", 0)))
|
base_value += float(int((ctx["target"] as Dictionary).get("fx_atk_bonus", 0)))
|
||||||
# 按序改写族第五拍：矿工重锤增伤面（交换的正向侧）
|
# 按序改写族第五拍：矿工重锤增伤面（交换的正向侧）
|
||||||
@@ -336,7 +336,7 @@ func _hero_attack_base_value(t: Dictionary, ctx: Dictionary) -> float:
|
|||||||
if String(h.get("kind", "")) == "modify_ticket" and int(h.get("trade_atk", 0)) > 0:
|
if String(h.get("kind", "")) == "modify_ticket" and int(h.get("trade_atk", 0)) > 0:
|
||||||
base_value *= 1.0 + float(int(h.trade_atk)) / 100.0
|
base_value *= 1.0 + float(int(h.trade_atk)) / 100.0
|
||||||
# 加法族：整备军备「每层下轮首段 +1」（层数×value 加算）——attack_bonus per charge_layers。
|
# 加法族：整备军备「每层下轮首段 +1」（层数×value 加算）——attack_bonus per charge_layers。
|
||||||
# 迭代 20 T1——value_counter 扩展〔疼痛记忆/弃图兑换/陷阱本能——rider 值=计数器账面，
|
# value_counter 扩展〔疼痛记忆/弃图兑换/陷阱本能——rider 值=计数器账面，
|
||||||
# 值读于施加时点=命中序先行 rider 后清零行〕
|
# 值读于施加时点=命中序先行 rider 后清零行〕
|
||||||
for h in ac_hits:
|
for h in ac_hits:
|
||||||
if String(h.get("kind", "")) == "attack_bonus":
|
if String(h.get("kind", "")) == "attack_bonus":
|
||||||
@@ -344,7 +344,7 @@ func _hero_attack_base_value(t: Dictionary, ctx: Dictionary) -> float:
|
|||||||
if h.has("value_counter") and String(h.get("value_counter", "")) != "":
|
if h.has("value_counter") and String(h.get("value_counter", "")) != "":
|
||||||
contrib = _fx.counter(String(h.get("value_counter", "")))
|
contrib = _fx.counter(String(h.get("value_counter", "")))
|
||||||
base_value += float(contrib)
|
base_value += float(contrib)
|
||||||
# 计数器施加（迭代 20 T1——attack_commit 命中行内 counter_add〔用后清零行〕，命中序=声明序）
|
# 计数器施加（attack_commit 命中行内 counter_add〔用后清零行〕，命中序=声明序）
|
||||||
for h in ac_hits:
|
for h in ac_hits:
|
||||||
if String(h.get("kind", "")) == "counter_add":
|
if String(h.get("kind", "")) == "counter_add":
|
||||||
var set_v = h.get("set", null)
|
var set_v = h.get("set", null)
|
||||||
@@ -391,8 +391,8 @@ func _hero_attack_redeem(t: Dictionary, ctx: Dictionary, base_value: float) -> D
|
|||||||
landed += hero_rider
|
landed += hero_rider
|
||||||
payload["hero_rider"] = hero_rider
|
payload["hero_rider"] = hero_rider
|
||||||
units.apply_damage(target, landed)
|
units.apply_damage(target, landed)
|
||||||
payload["killed"] = not target.alive # 击杀标记在扣血后取（原语义不变）
|
payload["killed"] = not target.alive # 击杀标记在扣血后取
|
||||||
# kill 发射+施加（内容数据驱动扩展批 T3——敌人死亡确认；贯穿射击溢出弹射订阅面：对下一存活敌
|
# kill 发射+施加（敌人死亡确认；贯穿射击溢出弹射订阅面：对下一存活敌
|
||||||
# 以穿刺类型弹射本体 value%〔无次敌=弹射落空〕。B 模式入队段尾 flush 兑现；A 模式递归 resolve）
|
# 以穿刺类型弹射本体 value%〔无次敌=弹射落空〕。B 模式入队段尾 flush 兑现；A 模式递归 resolve）
|
||||||
if bool(payload.get("killed", false)):
|
if bool(payload.get("killed", false)):
|
||||||
for h in _fx_hits("kill", {"target": String(target.display_name), "overflow": landed}):
|
for h in _fx_hits("kill", {"target": String(target.display_name), "overflow": landed}):
|
||||||
@@ -403,7 +403,7 @@ func _hero_attack_redeem(t: Dictionary, ctx: Dictionary, base_value: float) -> D
|
|||||||
continue
|
continue
|
||||||
var next_target = units.default_target()
|
var next_target = units.default_target()
|
||||||
if next_target != null:
|
if next_target != null:
|
||||||
# 迭代 20 T9——source_class 中性名（旧件名 feat_pierce_shot 随贯穿射击退役；overflow 通道保留泛用面）
|
# source_class 用中性名（fx_overflow 泛用通道，不挂件名）
|
||||||
var of_t := open_ticket(DamageController.KIND_BOARD_TYPED, "fx_overflow",
|
var of_t := open_ticket(DamageController.KIND_BOARD_TYPED, "fx_overflow",
|
||||||
"贯穿弹射", "board", maxi(int(db.settlement.damage_floor), int(landed * int(h.get("value", 50)) / 100)),
|
"贯穿弹射", "board", maxi(int(db.settlement.damage_floor), int(landed * int(h.get("value", 50)) / 100)),
|
||||||
DamageController.TARGET_FRONT_ALIVE, int(t.round_index), t.origin_cell, "pierce")
|
DamageController.TARGET_FRONT_ALIVE, int(t.round_index), t.origin_cell, "pierce")
|
||||||
@@ -421,7 +421,7 @@ func _hero_attack_deliver(t: Dictionary, ctx: Dictionary, redemption: Dictionary
|
|||||||
# 重复授予由状态容器自行守卫）
|
# 重复授予由状态容器自行守卫）
|
||||||
for h in (ctx["ac_hits"] as Array):
|
for h in (ctx["ac_hits"] as Array):
|
||||||
if String(h.get("kind", "")) == "apply_status":
|
if String(h.get("kind", "")) == "apply_status":
|
||||||
# 迭代 20 T9——source_class 中性名（旧件名 feat_armor_crack 随碎甲震击退役；apply_status 通道保留泛用面）
|
# source_class 用中性名（fx_apply_status 泛用通道，不挂件名）
|
||||||
effects.apply_effect(String(h.get("status_id", "")), {"source_class": "fx_apply_status"}, -1)
|
effects.apply_effect(String(h.get("status_id", "")), {"source_class": "fx_apply_status"}, -1)
|
||||||
payload["cracked"] = true
|
payload["cracked"] = true
|
||||||
var label := _attack_label(String(t.display), bool(ctx["crit"]), int(ctx["discount"]))
|
var label := _attack_label(String(t.display), bool(ctx["crit"]), int(ctx["discount"]))
|
||||||
@@ -431,8 +431,8 @@ func _hero_attack_deliver(t: Dictionary, ctx: Dictionary, redemption: Dictionary
|
|||||||
_outcomes[int(t.ticket_id)] = "redeemed"
|
_outcomes[int(t.ticket_id)] = "redeemed"
|
||||||
|
|
||||||
|
|
||||||
# 敌方伤害技：掷点 → 折扣/暴击 → 克制点数（attack_type vs 主角护甲类型——迭代 24 N3 轴开列；
|
# 敌方伤害技：掷点 → 折扣/暴击 → 克制点数（attack_type vs 主角护甲类型——
|
||||||
# 前态恒中性 delta 0，写法同 hero_attack 的 _counter_delta 消费位）→ hero_defense×enemy_output
|
# 无类型恒中性 delta 0，写法同 hero_attack 的 _counter_delta 消费位）→ hero_defense×enemy_output
|
||||||
# 池乘区 → 下限 → +rider（后置必中附加）→ 交付 → commit_action（作废单不 commit——死亡即不动手）
|
# 池乘区 → 下限 → +rider（后置必中附加）→ 交付 → commit_action（作废单不 commit——死亡即不动手）
|
||||||
func _resolve_enemy_skill(t: Dictionary) -> void:
|
func _resolve_enemy_skill(t: Dictionary) -> void:
|
||||||
var hero: Dictionary[Variant, Variant] = units.hero_unit()
|
var hero: Dictionary[Variant, Variant] = units.hero_unit()
|
||||||
@@ -444,9 +444,9 @@ func _resolve_enemy_skill(t: Dictionary) -> void:
|
|||||||
var rolled: int = DamageMath.rolled_component(float(t.base_value), discount, crit, int(db.settlement.crit_multiplier), cdelta)
|
var rolled: int = DamageMath.rolled_component(float(t.base_value), discount, crit, int(db.settlement.crit_multiplier), cdelta)
|
||||||
var pooled: int = DamageMath.pool_damage(rolled, clamped_pool("hero_defense"), clamped_pool("enemy_output"))
|
var pooled: int = DamageMath.pool_damage(rolled, clamped_pool("hero_defense"), clamped_pool("enemy_output"))
|
||||||
var total: int = maxi(int(db.settlement.damage_floor), pooled) + int(t.rider) # rider 后置于伤害下限——独立必中加项，不进乘区
|
var total: int = maxi(int(db.settlement.damage_floor), pooled) + int(t.rider) # rider 后置于伤害下限——独立必中加项，不进乘区
|
||||||
# damage_taken 发射+施加（内容数据驱动扩展批 T3——kind=enemy_skill；铁壁整备减伤订阅面：
|
# damage_taken 发射+施加（kind=enemy_skill；铁壁整备减伤订阅面：
|
||||||
# shield 加法族合计 value×per(charge_layers)，稳健拓荒树规则同面（rebuild 合成订阅）；
|
# shield 加法族合计 value×per(charge_layers)，稳健拓荒树规则同面（rebuild 合成订阅）；
|
||||||
# 减后过下限保底。迭代 20 T1——damage_reduce〔背水 hp_ratio when〕/counter_add〔保险丝/
|
# 减后过下限保底。damage_reduce〔背水 hp_ratio when〕/counter_add〔保险丝/
|
||||||
# 石肤〕/ac_bonus〔石肤〕同面施加；hp_ratio fact 由 _fx_fact 补充事实面回落提供）
|
# 石肤〕/ac_bonus〔石肤〕同面施加；hp_ratio fact 由 _fx_fact 补充事实面回落提供）
|
||||||
var shield := 0
|
var shield := 0
|
||||||
for h in _fx_hits("damage_taken", {"kind": "enemy_skill", "amount": total,
|
for h in _fx_hits("damage_taken", {"kind": "enemy_skill", "amount": total,
|
||||||
@@ -488,7 +488,7 @@ func _resolve_board_typed(t: Dictionary) -> void:
|
|||||||
return
|
return
|
||||||
var armor_b: String = String(target.get("armor_type", "light"))
|
var armor_b: String = String(target.get("armor_type", "light"))
|
||||||
var atk_b: String = String(t.attack_type)
|
var atk_b: String = String(t.attack_type)
|
||||||
# clamp_check 发射+施加（内容数据驱动扩展批 T3——克制判定修正点棋盘面；与 hero_attack 同表同点：
|
# clamp_check 发射+施加（克制判定修正点棋盘面；与 hero_attack 同表同点：
|
||||||
# modify delta 订阅改写合计进克制点数；discount_shift 档位面属主角攻击专享，本面不施加）
|
# modify delta 订阅改写合计进克制点数；discount_shift 档位面属主角攻击专享，本面不施加）
|
||||||
var cdelta: int = _counter_delta(atk_b, armor_b)
|
var cdelta: int = _counter_delta(atk_b, armor_b)
|
||||||
if atk_b != "":
|
if atk_b != "":
|
||||||
@@ -510,7 +510,7 @@ func _resolve_board_blast(t: Dictionary) -> void:
|
|||||||
_ineffective_row(t, "无存活敌人")
|
_ineffective_row(t, "无存活敌人")
|
||||||
_outcomes[int(t.ticket_id)] = "zero"
|
_outcomes[int(t.ticket_id)] = "zero"
|
||||||
return
|
return
|
||||||
var blast_dmg: int = maxi(int(db.settlement.damage_floor), int(t.base_value)) # 伤害下限全来源（2026-09-20）
|
var blast_dmg: int = maxi(int(db.settlement.damage_floor), int(t.base_value)) # 伤害下限全来源
|
||||||
for u in alive:
|
for u in alive:
|
||||||
units.apply_damage(u, blast_dmg) # 恒定表值（下限保底），逐个；受击即死——死亡即不动手
|
units.apply_damage(u, blast_dmg) # 恒定表值（下限保底），逐个；受击即死——死亡即不动手
|
||||||
emit_row_cb.call("damage", String(t.source_class), t.origin_cell, int(t.round_index), "%s → 全体敌人 ×%d" % [String(t.display), alive.size()], blast_dmg,
|
emit_row_cb.call("damage", String(t.source_class), t.origin_cell, int(t.round_index), "%s → 全体敌人 ×%d" % [String(t.display), alive.size()], blast_dmg,
|
||||||
@@ -520,7 +520,7 @@ func _resolve_board_blast(t: Dictionary) -> void:
|
|||||||
|
|
||||||
# 棋盘主角直伤（反噬/治疗包负向/地形变异）：无类型必中，下限保底；context 键并入行载荷
|
# 棋盘主角直伤（反噬/治疗包负向/地形变异）：无类型必中，下限保底；context 键并入行载荷
|
||||||
func _resolve_board_flat_hero(t: Dictionary) -> void:
|
func _resolve_board_flat_hero(t: Dictionary) -> void:
|
||||||
var dealt: int = maxi(int(db.settlement.damage_floor), int(t.base_value)) # 伤害下限全来源（2026-09-20）
|
var dealt: int = maxi(int(db.settlement.damage_floor), int(t.base_value)) # 伤害下限全来源
|
||||||
units.apply_damage(units.hero_unit(), dealt)
|
units.apply_damage(units.hero_unit(), dealt)
|
||||||
var extra: Dictionary[Variant, Variant] = {"target": "hero"}
|
var extra: Dictionary[Variant, Variant] = {"target": "hero"}
|
||||||
for k in t.context.keys():
|
for k in t.context.keys():
|
||||||
@@ -567,7 +567,7 @@ func defender_ac(unit: Dictionary) -> int:
|
|||||||
|
|
||||||
|
|
||||||
# 克制修正点数读值（SettlementTable.armor_effectiveness：{攻击类型: {护甲: 点数}}——缺项回退 0 中性；
|
# 克制修正点数读值（SettlementTable.armor_effectiveness：{攻击类型: {护甲: 点数}}——缺项回退 0 中性；
|
||||||
# attack_type "" = 无类型恒不查（群伤/反噬/地形——敌方技自迭代 24 N3 起随单轴查表））
|
# attack_type "" = 无类型恒不查（群伤/反噬/地形——敌方技随单轴查表））
|
||||||
func _counter_delta(attack_type: String, armor: String) -> int:
|
func _counter_delta(attack_type: String, armor: String) -> int:
|
||||||
if attack_type == "":
|
if attack_type == "":
|
||||||
return 0
|
return 0
|
||||||
@@ -576,7 +576,7 @@ func _counter_delta(attack_type: String, armor: String) -> int:
|
|||||||
return int(row.get(armor, 0))
|
return int(row.get(armor, 0))
|
||||||
|
|
||||||
|
|
||||||
# 折扣档改善（迭代 12 T4 猎弱本能——折扣表向全额方向移 value 档；查不到当前档 = 不动防御口径）
|
# 折扣档改善（猎弱本能——折扣表向全额方向移 value 档；查不到当前档 = 不动防御口径）
|
||||||
func _discount_shift_up(discount: int, shift: int) -> int:
|
func _discount_shift_up(discount: int, shift: int) -> int:
|
||||||
var tbl: Array[Variant] = db.settlement.roll_tier_discounts
|
var tbl: Array[Variant] = db.settlement.roll_tier_discounts
|
||||||
var idx := tbl.find(discount)
|
var idx := tbl.find(discount)
|
||||||
@@ -608,7 +608,7 @@ func _attack_label(base: String, crit: bool, discount: int) -> String:
|
|||||||
|
|
||||||
# ---- 内部 ----
|
# ---- 内部 ----
|
||||||
|
|
||||||
# 目标解析（裁决②——结账时刻照规则看现场；句柄即 Dictionary 引用）
|
# 目标解析（结账时刻照规则看现场；句柄即 Dictionary 引用）
|
||||||
func _target_for(rule: String):
|
func _target_for(rule: String):
|
||||||
match rule:
|
match rule:
|
||||||
TARGET_FRONT_ALIVE:
|
TARGET_FRONT_ALIVE:
|
||||||
|
|||||||
@@ -11,11 +11,11 @@ static func pool_damage(d_raw: int, p_hero: int, p_enemy: int) -> int:
|
|||||||
return maxi(0, v)
|
return maxi(0, v)
|
||||||
|
|
||||||
|
|
||||||
# 充能分量：充能点数（调用方已按奖励定义换算）+ 克制修正点数（加法核——2026-09-18 换装，原 percent 乘区退役）；
|
# 充能分量：充能点数（调用方已按奖励定义换算）+ 克制修正点数（加法核）；
|
||||||
# 空桶（点数 ≤ 0）不吃修正恒 0——零充能分量无伤害可修正，不产生负贡献（等价旧量纲 0×任何 percent = 0；
|
# 空桶（点数 ≤ 0）不吃修正恒 0——零充能分量无伤害可修正，不产生负贡献；
|
||||||
# 空桶不受 landed_floor 影响——没有伤害落地就没有下限可言）
|
# 空桶不受 landed_floor 影响——没有伤害落地就没有下限可言。
|
||||||
# 类型化点数分量：点数 + 克制修正（加法核）——2026-09-19 充能退役后唯一消费方 = 奖励直伤道具（棋盘火力）
|
# 类型化点数分量：点数 + 克制修正（加法核）——唯一消费方 = 奖励直伤道具（棋盘火力）
|
||||||
# landed_floor：落地伤害全局下限（读 settlement.damage_floor，调用方传入）——2026-09-20 用户拍板
|
# landed_floor：落地伤害全局下限（读 settlement.damage_floor，调用方传入）——
|
||||||
# 「任何伤害落地取值域 [1,+∞)」：克制修正后触底也保底 1，调参降档不可能打出 0/负伤害
|
# 「任何伤害落地取值域 [1,+∞)」：克制修正后触底也保底 1，调参降档不可能打出 0/负伤害
|
||||||
static func counter_component(points: int, counter_delta: int, landed_floor: int = 0) -> int:
|
static func counter_component(points: int, counter_delta: int, landed_floor: int = 0) -> int:
|
||||||
if points <= 0:
|
if points <= 0:
|
||||||
@@ -23,7 +23,7 @@ static func counter_component(points: int, counter_delta: int, landed_floor: int
|
|||||||
return maxi(landed_floor, points + counter_delta)
|
return maxi(landed_floor, points + counter_delta)
|
||||||
|
|
||||||
|
|
||||||
# ---- 护甲等级掷点批（2026-09-16 用户拍板——判定式与档位参数全在 settlement.tres，本类只做算术）----
|
# ---- 护甲等级掷点（判定式与档位参数全在 settlement.tres，本类只做算术）----
|
||||||
|
|
||||||
# 掷点折扣查档（纯函数）：掷点 ≥ 阈值 → 100 全额；低掷按缺口（阈值 − 掷点）查升序边界落档，
|
# 掷点折扣查档（纯函数）：掷点 ≥ 阈值 → 100 全额；低掷按缺口（阈值 − 掷点）查升序边界落档，
|
||||||
# 返回档位值 percent（档数 = 边界数 + 1：缺口 ∈ [1, bounds[0]] → discounts[0]，(bounds[i], bounds[i+1]] →
|
# 返回档位值 percent（档数 = 边界数 + 1：缺口 ∈ [1, bounds[0]] → discounts[0]，(bounds[i], bounds[i+1]] →
|
||||||
|
|||||||
+24
-27
@@ -5,11 +5,10 @@
|
|||||||
class_name EffectEngine
|
class_name EffectEngine
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
## 事件词汇（迭代 20 专长实装批 T1 扩签——16→18：+dig_stop 停手挂点〔弃图兑换〕
|
## 事件词汇（封闭枚举——dig_stop 停手挂点〔弃图兑换〕、battle_won 战斗胜利〔战地包扎〕、
|
||||||
## +battle_won 战斗胜利〔战地包扎〕；迭代 21 天赋树批 T3 扩签 18→19：+seal_missed 标错判定
|
## seal_missed 标错判定〔危险直觉·守挂点——_judge_seal 去重闸后发射，契约 12 触发主语=
|
||||||
## 〔危险直觉·守挂点——_judge_seal 去重闸后发射，契约 12 触发主语=当回合标错动作；
|
## 当回合标错动作；命名避让 _emit_row 在册 source_class 名 seal_miss〕、board_installed
|
||||||
## 命名避让 _emit_row 在册 source_class 名 seal_miss〕；迭代 22 秘宝实装批 T3 扩签 19→20：
|
## 装板完成〔巢穴预告——每板恰一次，战斗板生成/重建发射点〕）
|
||||||
## +board_installed 装板完成〔巢穴预告——每板恰一次，战斗板生成/重建发射点〕；原发射点不动）
|
|
||||||
const EVENTS := ["dig_reveal", "dig_paid", "seal_hit", "mine_hit", "attack_commit", "clamp_check",
|
const EVENTS := ["dig_reveal", "dig_paid", "seal_hit", "mine_hit", "attack_commit", "clamp_check",
|
||||||
"armor_roll", "kill", "damage_taken", "enemy_hp_threshold", "round_start", "seal_settle",
|
"armor_roll", "kill", "damage_taken", "enemy_hp_threshold", "round_start", "seal_settle",
|
||||||
"round_end", "reward_roll", "treasure_used", "charge_full", "dig_stop", "battle_won", "seal_missed",
|
"round_end", "reward_roll", "treasure_used", "charge_full", "dig_stop", "battle_won", "seal_missed",
|
||||||
@@ -27,7 +26,7 @@ const EFFECT_KINDS := ["add_ticket_rider", "modify_ticket", "damage_mult", "open
|
|||||||
"grant_ap", "grant_gp", "bias_wallet", "shield", "spike", "apply_status", "counter_add",
|
"grant_ap", "grant_gp", "bias_wallet", "shield", "spike", "apply_status", "counter_add",
|
||||||
"counter_spend", "reveal_tiles", "remove_mines", "refresh_pick",
|
"counter_spend", "reveal_tiles", "remove_mines", "refresh_pick",
|
||||||
"bias_rewards", "preview",
|
"bias_rewards", "preview",
|
||||||
# 迭代 20 专长实装批 T1 扩签六型（奇物.md 基础件表 27 件声明清单——落法映射 commit 留痕）：
|
# 六型效果（奇物.md 基础件表 27 件声明清单）：
|
||||||
# heal=回复生命〔血蜜/战地包扎〕；ac_bonus=护甲加值累积器〔封印桩本轮/石肤本场 cap〕；
|
# heal=回复生命〔血蜜/战地包扎〕；ac_bonus=护甲加值累积器〔封印桩本轮/石肤本场 cap〕；
|
||||||
# damage_reduce=受伤减免〔背水/安全帽〕；bonus_delta=冒险加算区增量〔血税 双向——battle 末汇入
|
# damage_reduce=受伤减免〔背水/安全帽〕；bonus_delta=冒险加算区增量〔血税 双向——battle 末汇入
|
||||||
# runner.bonus〕；blast_scaled=雷罚标定群伤〔陷阱爆发——值=事件伤害×mult〕；
|
# runner.bonus〕；blast_scaled=雷罚标定群伤〔陷阱爆发——值=事件伤害×mult〕；
|
||||||
@@ -35,17 +34,15 @@ const EFFECT_KINDS := ["add_ticket_rider", "modify_ticket", "damage_mult", "open
|
|||||||
# target_attack_bonus=单位标记加伤〔处刑台——敌血量阈值挂单位字典，主角攻击面通用消费〕
|
# target_attack_bonus=单位标记加伤〔处刑台——敌血量阈值挂单位字典，主角攻击面通用消费〕
|
||||||
"heal", "ac_bonus", "damage_reduce", "bonus_delta", "blast_scaled", "preview_area",
|
"heal", "ac_bonus", "damage_reduce", "bonus_delta", "blast_scaled", "preview_area",
|
||||||
"target_attack_bonus",
|
"target_attack_bonus",
|
||||||
# 迭代 22 秘宝实装批 T3 扩签一型：mine_count_preview=危险格数量预告（巢穴预告——board_installed
|
# mine_count_preview=危险格数量预告（巢穴预告——board_installed
|
||||||
# 订阅 do；只报数量不标位置、不碰危险格分布=棋盘事实不可变契约；参数面常时 kind 不入本词表——
|
# 订阅 do；只报数量不标位置、不碰危险格分布=棋盘事实不可变契约；参数面常时 kind 不入本词表——
|
||||||
# 它们无订阅行，schema 行内 effect_kinds 校验走 treasure_item_table 自有词表）
|
# 它们无订阅行，schema 行内 effect_kinds 校验走 treasure_item_table 自有词表）
|
||||||
"mine_count_preview",
|
"mine_count_preview",
|
||||||
# 迭代 31 卡② 凭证件裁削批 T4 扩签一型：forgive_seal_miss=完美保险（本场首次封印落空不计入完美
|
# forgive_seal_miss=完美保险（本场首次封印落空不计入完美
|
||||||
# 封印判定——订阅 seal_missed 的豁免效果，消费点在授予段；feats.tres 首例 domain=battle 行）
|
# 封印判定——订阅 seal_missed 的豁免效果，消费点在授予段；feats.tres 首例 domain=battle 行）
|
||||||
"forgive_seal_miss"]
|
"forgive_seal_miss"]
|
||||||
# 注：rewrite_board 已除名（迭代 20 T9——净化工兵随老 27 件退役，V14 连带清理；
|
|
||||||
# 编排器消费分支 T1 先行摘除）
|
|
||||||
|
|
||||||
## fact 条件词汇（封闭枚举——迭代 20 T1 扩签 9→17：payload 同名键直读面〔fact 取值序 payload
|
## fact 条件词汇（封闭枚举——payload 同名键直读面〔fact 取值序 payload
|
||||||
## 优先——effect_engine._fact_value 既有机制〕。new_resource_type=首开资源类型〔地质学家〕；
|
## 优先——effect_engine._fact_value 既有机制〕。new_resource_type=首开资源类型〔地质学家〕；
|
||||||
## is_edge_cell=边缘格〔边陲矿工〕；is_blank_zero=空白连锁〔跳格采掘〕；dug_under_seal=被挖格
|
## is_edge_cell=边缘格〔边陲矿工〕；is_blank_zero=空白连锁〔跳格采掘〕；dug_under_seal=被挖格
|
||||||
## 当时有封印〔破封一击〕；ap_exhausted_last=上轮 AP 耗尽〔一滴不剩〕；hp_ratio=生命比例〔背水
|
## 当时有封印〔破封一击〕；ap_exhausted_last=上轮 AP 耗尽〔一滴不剩〕；hp_ratio=生命比例〔背水
|
||||||
@@ -54,13 +51,13 @@ const FACTS := ["matchup", "is_first_dig_of_battle", "terrain_kind", "target_arm
|
|||||||
"seals_count", "charge_layers", "nest_count", "round_index", "counter",
|
"seals_count", "charge_layers", "nest_count", "round_index", "counter",
|
||||||
"new_resource_type", "is_edge_cell", "is_blank_zero", "dug_under_seal",
|
"new_resource_type", "is_edge_cell", "is_blank_zero", "dug_under_seal",
|
||||||
"ap_exhausted_last", "hp_ratio", "amount", "ap_left", "pct",
|
"ap_exhausted_last", "hp_ratio", "amount", "ap_left", "pct",
|
||||||
"battle_index"] # 迭代 21 T3 扩签——关卡域战斗序（1 基，enc 携带；开局姿态组「每关首轮窗」条件面）
|
"battle_index"] # 关卡域战斗序（1 基，enc 携带；开局姿态组「每关首轮窗」条件面）
|
||||||
|
|
||||||
## when 算子词汇（封闭——fact 查询面落法随批登记：mod_zero=计数器取模判满〔掘进蓄能〕、
|
## when 算子词汇（封闭——fact 查询面落法：mod_zero=计数器取模判满〔掘进蓄能〕、
|
||||||
## advantageous=克制矩阵正面判定〔淬毒刃纹〕、gte_ref/lt_ref=与另一计数器比较〔深挖钻头配额〕、
|
## advantageous=克制矩阵正面判定〔淬毒刃纹〕、gte_ref/lt_ref=与另一计数器比较〔深挖钻头配额〕、
|
||||||
## ends_with=后缀匹配〔对某甲族的泛条件〕、mod_eq=取模余数判定〔双管镐每第 2 次——value=模数
|
## ends_with=后缀匹配〔对某甲族的泛条件〕、mod_eq=取模余数判定〔双管镐每第 2 次——value=模数
|
||||||
## ref=余数；dispatch 预评估口径〔when 于命中前读计数器现值〕下「每第 N 次」系用 ref=N-1 表达〕。
|
## ref=余数；dispatch 预评估口径〔when 于命中前读计数器现值〕下「每第 N 次」系用 ref=N-1 表达〕。
|
||||||
## 均系映射表现状条件装进 fact 的查询面落法，代拍板白名单覆盖，commit 留痕）
|
## 均系映射表现状条件装进 fact 的查询面落法，白名单覆盖）
|
||||||
const OPS := ["eq", "neq", "gt", "gte", "lt", "lte", "ends_with", "has", "mod_zero",
|
const OPS := ["eq", "neq", "gt", "gte", "lt", "lte", "ends_with", "has", "mod_zero",
|
||||||
"advantageous", "gte_ref", "lt_ref", "mod_eq"]
|
"advantageous", "gte_ref", "lt_ref", "mod_eq"]
|
||||||
|
|
||||||
@@ -68,7 +65,7 @@ const OPS := ["eq", "neq", "gt", "gte", "lt", "lte", "ends_with", "has", "mod_ze
|
|||||||
const WHEN_KEYS := ["fact", "op", "value", "id", "ref", "value_from"]
|
const WHEN_KEYS := ["fact", "op", "value", "id", "ref", "value_from"]
|
||||||
|
|
||||||
## do 效果键白名单（trigger 行 do 字典键——零裸 flat 同族护栏：kind 外键全部参数引用面。
|
## do 效果键白名单（trigger 行 do 字典键——零裸 flat 同族护栏：kind 外键全部参数引用面。
|
||||||
## 迭代 20 T1 扩签四键：value_event=事件载荷取值键名〔爆破会计——counter_add 值=本轮挖格花费
|
## value_event=事件载荷取值键名〔爆破会计——counter_add 值=本轮挖格花费
|
||||||
## payload.ap_cost〕；value_counter=计数器取值键〔疼痛记忆/弃图兑换——attack rider 值=账面层值〕；
|
## payload.ap_cost〕；value_counter=计数器取值键〔疼痛记忆/弃图兑换——attack rider 值=账面层值〕；
|
||||||
## domain=计数器寿命域〔battle=战斗域重建清零〔缺省〕/adventure=跨战持久随 battle 末导出〕；
|
## domain=计数器寿命域〔battle=战斗域重建清零〔缺省〕/adventure=跨战持久随 battle 末导出〕；
|
||||||
## axis=bonus_delta 加算区轴向）
|
## axis=bonus_delta 加算区轴向）
|
||||||
@@ -78,15 +75,15 @@ const DO_KEYS := ["kind", "value", "value_from", "delta", "delta_from", "mult",
|
|||||||
"value_event", "value_counter", "domain", "axis"]
|
"value_event", "value_counter", "domain", "axis"]
|
||||||
|
|
||||||
## 主动件分发通道（不经事件订阅——刷新/显影/移除是玩家主动动作；use_treasure 按 kind 分发）
|
## 主动件分发通道（不经事件订阅——刷新/显影/移除是玩家主动动作；use_treasure 按 kind 分发）
|
||||||
## 迭代 22 秘宝实装批 T3 扩签：+safe_dig 安全格直开（天眼——3×3 内安全格按普通挖格规则全额兑付
|
## safe_dig 安全格直开（天眼——3×3 内安全格按普通挖格规则全额兑付
|
||||||
## 含连锁展开与格面资源，危险格仅真视显示不移除——棋盘事实不可变契约；免行动点即效果本身，C5 裁）
|
## 含连锁展开与格面资源，危险格仅真视显示不移除——棋盘事实不可变契约；免行动点即效果本身）
|
||||||
const ACTIVE_KINDS := ["reveal_tiles", "preview", "grant_ap", "remove_mines", "refresh_pick", "safe_dig"]
|
const ACTIVE_KINDS := ["reveal_tiles", "preview", "grant_ap", "remove_mines", "refresh_pick", "safe_dig"]
|
||||||
|
|
||||||
# ---- 订阅集与计数器账本 ----
|
# ---- 订阅集与计数器账本 ----
|
||||||
var _triggers: Array[Variant] = [] # [{source, id, on, when, do}]（装载序=声明序，重建时定死）
|
var _triggers: Array[Variant] = [] # [{source, id, on, when, do}]（装载序=声明序，重建时定死）
|
||||||
var _counters: Dictionary[Variant, Variant] = {} # counter_id → int（battle 域账本；重建清零；重置点由订阅行声明）
|
var _counters: Dictionary[Variant, Variant] = {} # counter_id → int（battle 域账本；重建清零；重置点由订阅行声明）
|
||||||
var _reset_on_round_start: Array[String] = [] # round_start 重置点计数器名单（装载时收集）
|
var _reset_on_round_start: Array[String] = [] # round_start 重置点计数器名单（装载时收集）
|
||||||
var _adventure_counter_ids: Array[String] = [] # domain=adventure 计数器名单（T6——重建时收集、不清零；
|
var _adventure_counter_ids: Array[String] = [] # domain=adventure 计数器名单（重建时收集、不清零；
|
||||||
# battle 末 export → 冒险账本、begin_battle seed 回灌）
|
# battle 末 export → 冒险账本、begin_battle seed 回灌）
|
||||||
var db: ConfigDb # 矩阵/表读取（advantageous 算子消费）——可空（纯计数器用法零依赖）
|
var db: ConfigDb # 矩阵/表读取（advantageous 算子消费）——可空（纯计数器用法零依赖）
|
||||||
|
|
||||||
@@ -116,9 +113,9 @@ func rebuild(feat_ids: Array, item_ids: Array, tree_rules: Array = []) -> void:
|
|||||||
continue
|
continue
|
||||||
for tr in (row.get("triggers", []) as Array):
|
for tr in (row.get("triggers", []) as Array):
|
||||||
_push_trigger("attune", iid, tr, row)
|
_push_trigger("attune", iid, tr, row)
|
||||||
# 树规则合成订阅（迭代 21 T3 换代——六键按 v0.8 三组双态）：posture 两键=「每关首轮窗」语义
|
# 树规则合成订阅（六键按 v0.8 三组双态）：posture 两键=「每关首轮窗」语义
|
||||||
# 〔battle_index==1 且 round_index==1；battle_index=关卡域战斗序由 enc 携带，原「每战首轮」
|
# 〔battle_index==1 且 round_index==1；battle_index=关卡域战斗序由 enc 携带〕；
|
||||||
# 实态随窗语义换代〕；sense 两组=每关限次〔adventure 域计数器 lt 上限闸 + 命中即 counter_add
|
# sense 两组=每关限次〔adventure 域计数器 lt 上限闸 + 命中即 counter_add
|
||||||
# 记账双行——同事件双行同预评估态见闸同记，序=装载序确定；生命周期四态：跨战持久=domain
|
# 记账双行——同事件双行同预评估态见闸同记，序=装载序确定；生命周期四态：跨战持久=domain
|
||||||
# adventure 导出/回灌、按关重置=AdventureRunner._start_current_level 清零、新冒险清零=账本
|
# adventure 导出/回灌、按关重置=AdventureRunner._start_current_level 清零、新冒险清零=账本
|
||||||
# 归零、断点保留=断点快照随键〕；economy 两组零订阅行——消费点=GP 掉落乘算与商品计价折价的
|
# 归零、断点保留=断点快照随键〕；economy 两组零订阅行——消费点=GP 掉落乘算与商品计价折价的
|
||||||
@@ -156,7 +153,7 @@ func rebuild(feat_ids: Array, item_ids: Array, tree_rules: Array = []) -> void:
|
|||||||
"when": [{"fact": "counter", "id": "tree_sense_guard_used", "op": "lt", "value": 2}],
|
"when": [{"fact": "counter", "id": "tree_sense_guard_used", "op": "lt", "value": 2}],
|
||||||
"do": {"kind": "counter_add", "counter_id": "tree_sense_guard_used",
|
"do": {"kind": "counter_add", "counter_id": "tree_sense_guard_used",
|
||||||
"value": 1, "domain": "adventure"}}, {})
|
"value": 1, "domain": "adventure"}}, {})
|
||||||
# 计数器账本重建（T6——battle 域清零照旧；adventure 域由 counters_seed 回灌〔rebuild 后调用〕）
|
# 计数器账本重建（battle 域清零；adventure 域由 counters_seed 回灌〔rebuild 后调用〕）
|
||||||
_counters = {}
|
_counters = {}
|
||||||
|
|
||||||
|
|
||||||
@@ -186,7 +183,7 @@ func _push_trigger(source: String, id: String, tr: Dictionary, row: Dictionary)
|
|||||||
var cid := String(do_d.counter_id)
|
var cid := String(do_d.counter_id)
|
||||||
if not _reset_on_round_start.has(cid):
|
if not _reset_on_round_start.has(cid):
|
||||||
_reset_on_round_start.append(cid)
|
_reset_on_round_start.append(cid)
|
||||||
# 寿命域收集（T6——domain=adventure 计数器跨战持久：重建不清零、battle 末导出回冒险账本）
|
# 寿命域收集（domain=adventure 计数器跨战持久：重建不清零、battle 末导出回冒险账本）
|
||||||
if do_d.has("counter_id") and String(do_d.get("domain", "")) == "adventure":
|
if do_d.has("counter_id") and String(do_d.get("domain", "")) == "adventure":
|
||||||
var aid := String(do_d.counter_id)
|
var aid := String(do_d.counter_id)
|
||||||
if not _adventure_counter_ids.has(aid):
|
if not _adventure_counter_ids.has(aid):
|
||||||
@@ -245,7 +242,7 @@ func counter_spend(counter_id: String, value: int) -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
## adventure 域计数器导出（T6——battle 末调用，快照回冒险账本；仅 domain=adventure 名单内键）
|
## adventure 域计数器导出（battle 末调用，快照回冒险账本；仅 domain=adventure 名单内键）
|
||||||
func counters_export() -> Dictionary:
|
func counters_export() -> Dictionary:
|
||||||
var out := {}
|
var out := {}
|
||||||
for cid in _adventure_counter_ids:
|
for cid in _adventure_counter_ids:
|
||||||
@@ -253,7 +250,7 @@ func counters_export() -> Dictionary:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
## adventure 域计数器回灌（T6——rebuild 后由发射宿主调用：冒险账本值回填名单内键，缺省 0；
|
## adventure 域计数器回灌（rebuild 后由发射宿主调用：冒险账本值回填名单内键，缺省 0；
|
||||||
## 名单=本次 rebuild 装载行声明 domain=adventure 的 counter_id 集）
|
## 名单=本次 rebuild 装载行声明 domain=adventure 的 counter_id 集）
|
||||||
func counters_seed(seed: Dictionary) -> void:
|
func counters_seed(seed: Dictionary) -> void:
|
||||||
for cid in _adventure_counter_ids:
|
for cid in _adventure_counter_ids:
|
||||||
@@ -295,7 +292,7 @@ func _cond_ok(c: Dictionary, payload: Dictionary, facts: Callable) -> bool:
|
|||||||
return false
|
return false
|
||||||
return String(actual).ends_with(String(val))
|
return String(actual).ends_with(String(val))
|
||||||
"has":
|
"has":
|
||||||
# 在场判定（fact 查询面落法——代拍板白名单，commit 留痕）：value 缺省=非空判定
|
# 在场判定（fact 查询面落法——白名单覆盖）：value 缺省=非空判定
|
||||||
# （terrain_kind fact：伤害型变异集非空=挖开伤害型地形格/邻格有伤害型地形/地形伤种类在场）；
|
# （terrain_kind fact：伤害型变异集非空=挖开伤害型地形格/邻格有伤害型地形/地形伤种类在场）；
|
||||||
# value 给定=数组包含判定（保留泛用面）。
|
# value 给定=数组包含判定（保留泛用面）。
|
||||||
if c.has("value"):
|
if c.has("value"):
|
||||||
@@ -304,7 +301,7 @@ func _cond_ok(c: Dictionary, payload: Dictionary, facts: Callable) -> bool:
|
|||||||
return false
|
return false
|
||||||
if actual is Array:
|
if actual is Array:
|
||||||
return not (actual as Array).is_empty()
|
return not (actual as Array).is_empty()
|
||||||
return actual != null and String(actual) != "" # null 安全（迭代 20 T2 修正——敌技伤害载荷无 terrain_kind 时事实面回落 null，判「不在场」而非抛错；候选流变化后 devour 件首次被持有而暴露的潜伏缺陷）
|
return actual != null and String(actual) != "" # null 安全（敌技伤害载荷无 terrain_kind 时事实面回落 null，判「不在场」而非抛错）
|
||||||
"mod_zero":
|
"mod_zero":
|
||||||
var m := int(val)
|
var m := int(val)
|
||||||
return m > 0 and int(actual) % m == 0
|
return m > 0 and int(actual) % m == 0
|
||||||
|
|||||||
+76
-80
@@ -7,7 +7,7 @@
|
|||||||
class_name LevelRunner
|
class_name LevelRunner
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
signal node_entered(node: Dictionary, info: Dictionary) # info 按 type：battle/boss={} · reward={}（内容待拍板） · rest={healed,hp,max_hp} · shop={gp}
|
signal node_entered(node: Dictionary, info: Dictionary) # info 按 type：battle/boss={} · reward={}（内容待定） · rest={healed,hp,max_hp} · shop={gp}
|
||||||
signal choices_presented(candidates: Array) # 选路口（兑付确认后——候选节点引用数组，零自动推进）
|
signal choices_presented(candidates: Array) # 选路口（兑付确认后——候选节点引用数组，零自动推进）
|
||||||
signal step_row(row: Dictionary) # 转发当前 战斗结算 结算行
|
signal step_row(row: Dictionary) # 转发当前 战斗结算 结算行
|
||||||
signal round_started(round_index: int)
|
signal round_started(round_index: int)
|
||||||
@@ -34,34 +34,33 @@ var gp: int: # GP 冒险钱包（局内货币—
|
|||||||
set(v): _ledger["gp"] = v
|
set(v): _ledger["gp"] = v
|
||||||
var base_override := {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat 注入（元进度实现批——冒险模式 = AdventureRunner 共享字典经 start_level_external 注入；单关测试模式 = 私有全零）
|
var base_override := {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat 注入（元进度实现批——冒险模式 = AdventureRunner 共享字典经 start_level_external 注入；单关测试模式 = 私有全零）
|
||||||
var _shop_purchased := {} # product_id → 已购档数（现价重算输入；冒险开始清零）
|
var _shop_purchased := {} # product_id → 已购档数（现价重算输入；冒险开始清零）
|
||||||
# 协作对象私有（E1/E3 封装收口 2026-09-13）：settlement 读取经 current_battle() 成文出口
|
# 协作对象私有（E1/E3 封装收口）：settlement 读取经 current_battle() 成文出口
|
||||||
var _settlement: BattleOrchestrator = null # 当前战斗编排器（关卡结束置 null）
|
var _settlement: BattleOrchestrator = null # 当前战斗编排器（关卡结束置 null）
|
||||||
var treasure_inventory: TreasureItems = null # 秘宝 关卡域库存（迭代 7 T3——TreasureItems；跨战斗延续，
|
var treasure_inventory: TreasureItems = null # 秘宝 关卡域库存（TreasureItems；跨战斗延续，
|
||||||
var _treasure_unlocked := {} # aux 解锁门控集（迭代 7 T5——拍板③甲；空集=零投放）
|
var _treasure_unlocked := {} # aux 解锁门控集（空集=零投放）
|
||||||
var _attunement: Array[Variant] = [] # 同调装配集（迭代 11 第①批 T5——adventure params.attunement 下传，begin_battle enc 携带进战斗结算；空集=off 零扰动）
|
var _attunement: Array[Variant] = [] # 同调装配集（adventure params.attunement 下传，begin_battle enc 携带进战斗结算；空集=off 零扰动）
|
||||||
# 关卡末清空+快照计数入 level_finished 载荷）
|
# 关卡末清空+快照计数入 level_finished 载荷）
|
||||||
# 两根类型轴（迭代 23 T4——adventure 参数面快照经 set_hero_axes 下传；空串=未注入→锻造配置默认值回退。
|
# 两根类型轴（adventure 参数面快照经 set_hero_axes 下传；空串=未注入→锻造配置默认值回退。
|
||||||
# 消费面：effective_ac 甲型基础 AC 层 + begin_battle enc 携带进 unit_container.spawn 英雄快照）
|
# 消费面：effective_ac 甲型基础 AC 层 + begin_battle enc 携带进 unit_container.spawn 英雄快照）
|
||||||
var _hero_attack_type := ""
|
var _hero_attack_type := ""
|
||||||
var _hero_armor_type := ""
|
var _hero_armor_type := ""
|
||||||
# ---- 商店共享池模式态（迭代 11 第②批 T3——缺省 legacy=固定三件加定价 off 对照承载，零 RNG 零池消费；TP0 令牌池换代）----
|
# ---- 商店共享池模式态（缺省 legacy=固定三件加定价 off 对照承载，零 RNG 零池消费；TP0 令牌池）----
|
||||||
var _shop_pool_mode := false # pool 模式封印（set_shop_pool 注入时置位——AdventureRunner 按 params.shop_mode 下传）
|
var _shop_pool_mode := false # pool 模式封印（set_shop_pool 注入时置位——AdventureRunner 按 params.shop_mode 下传）
|
||||||
var _pool_deck: Array[Variant] = [] # 共享池令牌库共享引用（AdventureRunner._curio_deck——库存=剩余令牌数单点）
|
var _pool_deck: Array[Variant] = [] # 共享池令牌库共享引用（AdventureRunner._curio_deck——库存=剩余令牌数单点）
|
||||||
var _pool_consume := Callable() # 池消费 handler（AdventureRunner._consume_pool_purchase——_apply_curio_pick 同口写加算区+账本+摘牌）
|
var _pool_consume := Callable() # 池消费 handler（AdventureRunner._consume_pool_purchase——_apply_curio_pick 同口写加算区+账本+摘牌）
|
||||||
var _pool_ticket := Callable() # 门票展示判定 handler（T5——AdventureRunner._feat_ticket_consider；节点与商店共享计数）
|
var _pool_ticket := Callable() # 门票展示判定 handler（T5——AdventureRunner._feat_ticket_consider；节点与商店共享计数）
|
||||||
var _pool_cap_check := Callable() # cap 检查回调（迭代 20 T2——AdventureRunner._curio_cap_ok；案②提前退役）
|
var _pool_cap_check := Callable() # cap 检查回调（AdventureRunner._curio_cap_ok；cap 满剔出货架候选视图）
|
||||||
var _shop_shelf: Array[Variant] = [] # 当前货架（进店抽 3/买后全重抽——令牌字典 {"kind","tier"} 序，同 kind 去重每 kind 至多一卡）
|
var _shop_shelf: Array[Variant] = [] # 当前货架（进店抽 3/买后全重抽——令牌字典 {"kind","tier"} 序，同 kind 去重每 kind 至多一卡）
|
||||||
var _shop_visit_buys := 0 # 本次进店已购次数（A 链定价输入——离开清零）
|
var _shop_visit_buys := 0 # 本次进店已购次数（A 链定价输入——离开清零）
|
||||||
var _shop_paid_refreshes := 0 # 本次进店已付费刷新次数（MC-1——GP 刷新价曲线输入，离开清零）
|
var _shop_paid_refreshes := 0 # 本次进店已付费刷新次数（MC-1——GP 刷新价曲线输入，离开清零）
|
||||||
|
|
||||||
var hero_atk_pct := 0 # 测试面板覆盖值（切片专用）
|
var hero_atk_pct := 0 # 测试面板覆盖值（切片专用）
|
||||||
var hero_hp_pct := 0
|
var hero_hp_pct := 0
|
||||||
# ---- 关卡相位轴（2026-10-02 修复批——布尔封印收拢：_running/_awaiting_choice 两封印 → 显式 Phase enum；
|
# ---- 关卡相位轴（显式 Phase enum：内部 enum + 守卫换算，对齐 行动经济 Phase 先例；
|
||||||
# 对齐 行动经济 Phase 先例（action_economy.gd：内部 enum + 守卫换算，外部读面契约零变化）——
|
# level_result:String 与 awaiting_choice() 是 AdventureRunner/呈现层消费的外部契约面）----
|
||||||
# level_result:String 与 awaiting_choice() 被 AdventureRunner/呈现层消费的语义逐字不变）----
|
|
||||||
enum Phase { IDLE, RUNNING, AWAITING_CHOICE, ENDED }
|
enum Phase { IDLE, RUNNING, AWAITING_CHOICE, ENDED }
|
||||||
var _phase: int = Phase.IDLE
|
var _phase: int = Phase.IDLE
|
||||||
var level_result := "" # "" / "victory" / "defeat"（外部契约面——语义零变化）
|
var level_result := "" # "" / "victory" / "defeat"（外部契约面）
|
||||||
var _candidates: Array[Dictionary] = [] # 当前选路候选（节点引用数组）
|
var _candidates: Array[Dictionary] = [] # 当前选路候选（节点引用数组）
|
||||||
var visited: Array[Dictionary] = [] # 已兑付/到达节点序列（呈现层图条数据源；含当前节点）
|
var visited: Array[Dictionary] = [] # 已兑付/到达节点序列（呈现层图条数据源；含当前节点）
|
||||||
var _graph_mode := false # 图形态缓存（行集任一节点带 next；单链 = false）
|
var _graph_mode := false # 图形态缓存（行集任一节点带 next；单链 = false）
|
||||||
@@ -72,7 +71,7 @@ func _init(db_ref: ConfigDb, rng_ref: RngServiceCore) -> void:
|
|||||||
rng = rng_ref
|
rng = rng_ref
|
||||||
|
|
||||||
|
|
||||||
# 进行中谓词（原 _running 语义——RUNNING 或 AWAITING_CHOICE 两相位合计；内部守卫专用）
|
# 进行中谓词（RUNNING 或 AWAITING_CHOICE 两相位合计；内部守卫专用）
|
||||||
func _is_running() -> bool:
|
func _is_running() -> bool:
|
||||||
return _phase == Phase.RUNNING or _phase == Phase.AWAITING_CHOICE
|
return _phase == Phase.RUNNING or _phase == Phase.AWAITING_CHOICE
|
||||||
|
|
||||||
@@ -84,8 +83,8 @@ func set_hero_override(atk_pct: int, hp_pct: int) -> void:
|
|||||||
hero_hp_pct = hp_pct
|
hero_hp_pct = hp_pct
|
||||||
|
|
||||||
|
|
||||||
# 叠加次序（元进度实现批钉死）：表值 → 永久强化 flat（base_override）→ 加算区 flat（bonus）先加
|
# 叠加次序（钉死）：表值 → 永久强化 flat（base_override）→ 加算区 flat（bonus）先加
|
||||||
# → 调试浮窗百分比后乘（调试数值工具恒乘最后——代拍板 6，与 GP 批既有次序兼容）
|
# → 调试浮窗百分比后乘（调试数值工具恒乘最后）
|
||||||
func effective_atk() -> int:
|
func effective_atk() -> int:
|
||||||
var base: int = int(db.hero.atk) + int(base_override.get("atk", 0)) + int(run_ledger.bonus.get("atk", 0))
|
var base: int = int(db.hero.atk) + int(base_override.get("atk", 0)) + int(run_ledger.bonus.get("atk", 0))
|
||||||
return maxi(1, int(round(float(base) * (100.0 + float(hero_atk_pct)) / 100.0)))
|
return maxi(1, int(round(float(base) * (100.0 + float(hero_atk_pct)) / 100.0)))
|
||||||
@@ -96,7 +95,7 @@ func effective_max_hp() -> int:
|
|||||||
return maxi(1, int(round(float(base) * (100.0 + float(hero_hp_pct)) / 100.0)))
|
return maxi(1, int(round(float(base) * (100.0 + float(hero_hp_pct)) / 100.0)))
|
||||||
|
|
||||||
|
|
||||||
# 护甲等级生效值（入战 AC 三层可加——迭代 23 T4：甲型基础 AC〔forge.tres 选中甲路线 base_ac〕+
|
# 护甲等级生效值（入战 AC 三层可加：甲型基础 AC〔forge.tres 选中甲路线 base_ac〕+
|
||||||
# 甲路线等级加值〔base_override.armor_class——hero_override 锻造分量〕+ 加算区 armor_class 轴；
|
# 甲路线等级加值〔base_override.armor_class——hero_override 锻造分量〕+ 加算区 armor_class 轴；
|
||||||
# 无调试浮窗百分比通道，纯 flat）
|
# 无调试浮窗百分比通道，纯 flat）
|
||||||
func effective_ac() -> int:
|
func effective_ac() -> int:
|
||||||
@@ -113,7 +112,7 @@ func _armor_base_ac() -> int:
|
|||||||
return int(row.get("base_ac", 0))
|
return int(row.get("base_ac", 0))
|
||||||
|
|
||||||
|
|
||||||
# 行动点加成生效值（迭代 10 奖励重构批——统一冒险加算区第四轴 ap；经战斗开始入参 hero_ap_bonus
|
# 行动点加成生效值（统一冒险加算区第四轴 ap；经战斗开始入参 hero_ap_bonus
|
||||||
# 传入战斗域，兑现 = 每场战斗开始首轮行动点基线 +加成值〔行动经济 GDD 跨冒险行动点加成轴节〕）
|
# 传入战斗域，兑现 = 每场战斗开始首轮行动点基线 +加成值〔行动经济 GDD 跨冒险行动点加成轴节〕）
|
||||||
func effective_ap_bonus() -> int:
|
func effective_ap_bonus() -> int:
|
||||||
return maxi(0, int(run_ledger.bonus.get("ap", 0)))
|
return maxi(0, int(run_ledger.bonus.get("ap", 0)))
|
||||||
@@ -128,10 +127,10 @@ func restore_hero_base() -> void:
|
|||||||
# ---- 关卡生命周期 ----
|
# ---- 关卡生命周期 ----
|
||||||
|
|
||||||
func start_level(level_index: int, seed_val: int, base_override_in: Dictionary = {}, template_pick: int = -1) -> bool:
|
func start_level(level_index: int, seed_val: int, base_override_in: Dictionary = {}, template_pick: int = -1) -> bool:
|
||||||
# 单关测试模式（旧路径——既有语义一字不改）：私有账本、内置恢复数学、自调 new_adventure（漂移①
|
# 单关测试模式：私有账本、内置恢复数学、自调 new_adventure（漂移①
|
||||||
# 单关=冒险的历史简化在测试模式保留；正式种子域归 AdventureRunner.start_adventure）
|
# 单关=冒险的历史简化在测试模式保留；正式种子域归 AdventureRunner.start_adventure）
|
||||||
# base_override_in = 永久强化 flat 注入尾参（换算率标定批 2026-09-23——缺省 {} 全零白板，
|
# base_override_in = 永久强化 flat 注入尾参（缺省 {} 全零白板，
|
||||||
# 与既有调用方逐位一致零行为变更；契约同 AdventureRunner.start_adventure params.hero_override：
|
# 契约同 AdventureRunner.start_adventure params.hero_override：
|
||||||
# 三键 {atk, max_hp, armor_class}、缺键/-1 = 0、负值 clamp 0。游戏直入口仍恒白板——
|
# 三键 {atk, max_hp, armor_class}、缺键/-1 = 0、负值 clamp 0。游戏直入口仍恒白板——
|
||||||
# 注入面只服务数值验证工具，非玩家可达路径）
|
# 注入面只服务数值验证工具，非玩家可达路径）
|
||||||
_external = false
|
_external = false
|
||||||
@@ -147,7 +146,7 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
|
|||||||
_candidates = []
|
_candidates = []
|
||||||
visited = []
|
visited = []
|
||||||
_graph_mode = false
|
_graph_mode = false
|
||||||
gp = 0 # 冒险钱包清零开局（GP+商店房实施批——局内货币生命周期起点）
|
gp = 0 # 冒险钱包清零开局（局内货币生命周期起点）
|
||||||
run_ledger.bonus = {"atk": 0, "max_hp": 0, "armor_class": 0} # 加算区冒险开始全 0（单关入口零元进度——注入面见上）
|
run_ledger.bonus = {"atk": 0, "max_hp": 0, "armor_class": 0} # 加算区冒险开始全 0（单关入口零元进度——注入面见上）
|
||||||
base_override = {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat：缺省全零白板（单关入口零元进度——注入面见上）
|
base_override = {"atk": 0, "max_hp": 0, "armor_class": 0} # 永久强化 flat：缺省全零白板（单关入口零元进度——注入面见上）
|
||||||
_shop_purchased = {} # 已购档数清零（跨冒险不延续——递增定价按冒险内累计）
|
_shop_purchased = {} # 已购档数清零（跨冒险不延续——递增定价按冒险内累计）
|
||||||
@@ -172,15 +171,15 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
|
|||||||
# 冒险结构接口①：开始关卡（载荷 = 关卡序号 + 当前生命 + 生效上限——生命经共享账本交接；
|
# 冒险结构接口①：开始关卡（载荷 = 关卡序号 + 当前生命 + 生效上限——生命经共享账本交接；
|
||||||
# 种子域归冒险结构：本路径不重播种；账本归冒险结构：本路径不重置 gp/bonus/_shop_purchased，
|
# 种子域归冒险结构：本路径不重播种；账本归冒险结构：本路径不重置 gp/bonus/_shop_purchased，
|
||||||
# 也不重置 hero_hp——账本当前值即开局生命，AdventureRunner 已在 ledger 写好）。
|
# 也不重置 hero_hp——账本当前值即开局生命，AdventureRunner 已在 ledger 写好）。
|
||||||
# base_override = 永久强化 flat 共享引用（元进度实现批——缺省 {} 全零白板，与 B1 空参数路径逐位一致）。
|
# base_override = 永久强化 flat 共享引用（缺省 {} 全零白板，与 B1 空参数路径同值）。
|
||||||
# 流程与 start_level 同款（_find_level_row → 状态初始化 → _graph_mode 探测 → _enter_node(entry)），
|
# 流程与 start_level 同款（_find_level_row → 状态初始化 → _graph_mode 探测 → _enter_node(entry)），
|
||||||
# 差异仅在账本/加算区/已购档/恢复执行体的注入与零重置。
|
# 差异仅在账本/加算区/已购档/恢复执行体的注入与零重置。
|
||||||
# 停点前移批 2026-09-23：defer_entry 尾参（缺省 false = 既有调用方零变更）——true 时不自动
|
# defer_entry 尾参（缺省 false = 直接进节点）——true 时不自动
|
||||||
# _enter_node(entry)，改置选路态（awaiting_choice + 单候选 = 入口节点），由 AdventureRunner 在
|
# _enter_node(entry)，改置选路态（awaiting_choice + 单候选 = 入口节点），由 AdventureRunner 在
|
||||||
# level_started 之后调 present_entry_choice() 呈现、玩家 pick_next_node 显式进首战。拆两步的
|
# level_started 之后调 present_entry_choice() 呈现、玩家 pick_next_node 显式进首战。拆两步的
|
||||||
# 信号顺序契约：呈现层须先经 level_started 重取 runner 实例，choices_presented 才不会被
|
# 信号顺序契约：呈现层须先经 level_started 重取 runner 实例，choices_presented 才不会被
|
||||||
# _on_choices_presented 的 runner 空防御静默丢弃。入口呈现零 RNG 消耗、pick 走同一个
|
# _on_choices_presented 的 runner 空防御静默丢弃。入口呈现零 RNG 消耗、pick 走同一个
|
||||||
# _enter_node(entry)——与旧自动进入逐位等价（测量面零漂移红线）。
|
# _enter_node(entry)——测量面零漂移红线。
|
||||||
func start_level_external(level_index: int, ledger: Dictionary,
|
func start_level_external(level_index: int, ledger: Dictionary,
|
||||||
purchased_ref: Dictionary, rest_handler: Callable, base_override_ref: Dictionary = {},
|
purchased_ref: Dictionary, rest_handler: Callable, base_override_ref: Dictionary = {},
|
||||||
defer_entry: bool = false, template_pick: int = -1, resume_state: Dictionary = {}) -> bool:
|
defer_entry: bool = false, template_pick: int = -1, resume_state: Dictionary = {}) -> bool:
|
||||||
@@ -205,7 +204,7 @@ func start_level_external(level_index: int, ledger: Dictionary,
|
|||||||
_graph_mode = true
|
_graph_mode = true
|
||||||
break
|
break
|
||||||
_phase = Phase.RUNNING
|
_phase = Phase.RUNNING
|
||||||
# 断点续玩路径（迭代 8 卡①——defer_entry 之外的第三种停点入口）：直接重建到停点所在节点，
|
# 断点续玩路径（defer_entry 之外的第三种停点入口）：直接重建到停点所在节点，
|
||||||
# 零 RNG 消耗（模板已随 template_pick 强制、节点状态纯重建不 _enter_node——当场战斗从头打）。
|
# 零 RNG 消耗（模板已随 template_pick 强制、节点状态纯重建不 _enter_node——当场战斗从头打）。
|
||||||
# resume_state = {"node_id": int（-1 = 入口停点）, "visited_ids": Array[int]}；空字典 = 既有路径逐位不变。
|
# resume_state = {"node_id": int（-1 = 入口停点）, "visited_ids": Array[int]}；空字典 = 既有路径逐位不变。
|
||||||
if not resume_state.is_empty():
|
if not resume_state.is_empty():
|
||||||
@@ -223,7 +222,7 @@ func start_level_external(level_index: int, ledger: Dictionary,
|
|||||||
return _enter_node(entry)
|
return _enter_node(entry)
|
||||||
|
|
||||||
|
|
||||||
# 入口停点呈现（停点前移批 2026-09-23——defer_entry=true 的第二步）：发出入口候选供呈现层弹
|
# 入口停点呈现（defer_entry=true 的第二步）：发出入口候选供呈现层弹
|
||||||
# 选路层；非停点态（缺省自动进入路径）拒绝。零 RNG 消耗——呈现与行进取号解耦。
|
# 选路层；非停点态（缺省自动进入路径）拒绝。零 RNG 消耗——呈现与行进取号解耦。
|
||||||
func present_entry_choice() -> bool:
|
func present_entry_choice() -> bool:
|
||||||
if _phase != Phase.AWAITING_CHOICE or _candidates.is_empty() or node_index != -1:
|
if _phase != Phase.AWAITING_CHOICE or _candidates.is_empty() or node_index != -1:
|
||||||
@@ -233,7 +232,7 @@ func present_entry_choice() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# ---- 断点续玩（迭代 8 卡①——停点粒度重建）----
|
# ---- 断点续玩（停点粒度重建）----
|
||||||
|
|
||||||
# 停点重建（start_level_external resume_state 路径的落点）：node_id = 停点所在节点编号（-1 = 入口
|
# 停点重建（start_level_external resume_state 路径的落点）：node_id = 停点所在节点编号（-1 = 入口
|
||||||
# 停点），visited_ids = 已到节点编号序（呈现层图条数据源重建）。纯状态重建零 RNG 消耗；
|
# 停点），visited_ids = 已到节点编号序（呈现层图条数据源重建）。纯状态重建零 RNG 消耗；
|
||||||
@@ -284,7 +283,7 @@ func present_resumed_choice() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 断点道具库存回填（迭代 8 卡①——奖励节点已选道具随停点快照回局；幂等，先清后入受理序重排）
|
# 断点道具库存回填（奖励节点已选道具随停点快照回局；幂等，先清后入受理序重排）
|
||||||
func restore_treasure_items(items: Array) -> void:
|
func restore_treasure_items(items: Array) -> void:
|
||||||
if treasure_inventory == null:
|
if treasure_inventory == null:
|
||||||
treasure_inventory = TreasureItems.new(db)
|
treasure_inventory = TreasureItems.new(db)
|
||||||
@@ -293,14 +292,14 @@ func restore_treasure_items(items: Array) -> void:
|
|||||||
|
|
||||||
|
|
||||||
func _find_level_row(level_index: int) -> Dictionary:
|
func _find_level_row(level_index: int) -> Dictionary:
|
||||||
return db.level_row(level_index) # 表访问收口（2026-10-02——行集直扫归 LevelTable/ConfigDB 访问器）
|
return db.level_row(level_index) # 表访问收口（行集直扫归 LevelTable/ConfigDB 访问器）
|
||||||
|
|
||||||
|
|
||||||
# ---- 模板池解析（关卡节点图生成 v0.4——M-3 迭代 5 T5）----
|
# ---- 模板池解析（关卡节点图生成 v0.4——M-3）----
|
||||||
# row.templates 非空 = 池形态：template_pick >= 0 = 强制取该模板（首次脚本模式/冒烟固定图，零 RNG 消费）；
|
# row.templates 非空 = 池形态：template_pick >= 0 = 强制取该模板（首次脚本模式/冒烟固定图，零 RNG 消费）；
|
||||||
# -1 = 抽签（node_map 用途标签恰一 scope，均匀取模）。空池 = 旧单图形态原样返回（向后兼容零迁移）。
|
# -1 = 抽签（node_map 用途标签恰一 scope，均匀取模）。空池 = 旧单图形态原样返回（向后兼容零迁移）。
|
||||||
# 解析产物 = row 副本换 nodes（下游 nodes()/校验/呈现全透明）；active_template_name 供 MC 分层出数；
|
# 解析产物 = row 副本换 nodes（下游 nodes()/校验/呈现全透明）；active_template_name 供 MC 分层出数；
|
||||||
# active_template_index 供断点快照备案（迭代 8 卡①——已抽模板续玩零重抽零 RNG 消耗）。
|
# active_template_index 供断点快照备案（已抽模板续玩零重抽零 RNG 消耗）。
|
||||||
var active_template_name := ""
|
var active_template_name := ""
|
||||||
var active_template_index := -1 # -1 = 非池形态（旧单图）/未解析
|
var active_template_index := -1 # -1 = 非池形态（旧单图）/未解析
|
||||||
|
|
||||||
@@ -427,7 +426,7 @@ func _enter_node(node: Dictionary) -> bool:
|
|||||||
"battle", "boss":
|
"battle", "boss":
|
||||||
return _start_battle(node)
|
return _start_battle(node)
|
||||||
"reward":
|
"reward":
|
||||||
# 奖励点内容待拍板（格面资源批 2026-09-15：可选类道具删除，功能道具渠道 P1 未定——
|
# 奖励点内容未定（可选类道具不在池、功能道具渠道未定——
|
||||||
# 节点保留占位、零兑付直通）；推进 = 兑付确认后选路（零自动推进）
|
# 节点保留占位、零兑付直通）；推进 = 兑付确认后选路（零自动推进）
|
||||||
node_entered.emit(node, {})
|
node_entered.emit(node, {})
|
||||||
return true
|
return true
|
||||||
@@ -436,10 +435,10 @@ func _enter_node(node: Dictionary) -> bool:
|
|||||||
node_entered.emit(node, {"healed": healed, "hp": hero_hp, "max_hp": effective_max_hp()})
|
node_entered.emit(node, {"healed": healed, "hp": hero_hp, "max_hp": effective_max_hp()})
|
||||||
return true
|
return true
|
||||||
"shop":
|
"shop":
|
||||||
# 商店房兑付（GP+商店房实施批 2026-09-21）：到达即开店（覆盖层归呈现层），购买出账/
|
# 商店房兑付：到达即开店（覆盖层归呈现层），购买出账/
|
||||||
# 离开归玩家意图——零自动推进；离开确认经 continue_after_node 回选路口
|
# 离开归玩家意图——零自动推进；离开确认经 continue_after_node 回选路口
|
||||||
if _shop_pool_mode:
|
if _shop_pool_mode:
|
||||||
_shop_open_pool() # 迭代 11 第②批 T3——进店抽 3（恰一 shop_draw scope；买后全重抽同签）
|
_shop_open_pool() # 进店抽 3（恰一 shop_draw scope；买后全重抽同签）
|
||||||
node_entered.emit(node, {"gp": gp, "shelf": true})
|
node_entered.emit(node, {"gp": gp, "shelf": true})
|
||||||
return true
|
return true
|
||||||
node_entered.emit(node, {"gp": gp}) # legacy 固定三件（off 对照承载——零 RNG 零池消费）
|
node_entered.emit(node, {"gp": gp}) # legacy 固定三件（off 对照承载——零 RNG 零池消费）
|
||||||
@@ -452,9 +451,9 @@ func _start_battle(node: Dictionary) -> bool:
|
|||||||
_settlement = BattleOrchestrator.new(db, rng)
|
_settlement = BattleOrchestrator.new(db, rng)
|
||||||
if treasure_inventory == null:
|
if treasure_inventory == null:
|
||||||
treasure_inventory = TreasureItems.new(db) # 惰性建——关卡域单实例（跨战斗延续）
|
treasure_inventory = TreasureItems.new(db) # 惰性建——关卡域单实例（跨战斗延续）
|
||||||
_settlement.treasure_inventory = treasure_inventory # 迭代 7 T3——库存注入（授予路由+use_treasure 编排消费面）
|
_settlement.treasure_inventory = treasure_inventory # 库存注入（授予路由+use_treasure 编排消费面）
|
||||||
if _settlement != null:
|
if _settlement != null:
|
||||||
_settlement.set_treasure_unlocked(_treasure_unlocked) # 迭代 7 T5——解锁门控下传（装板摇号前）
|
_settlement.set_treasure_unlocked(_treasure_unlocked) # 解锁门控下传（装板摇号前）
|
||||||
# core↔core 接线只许方法 Callable（静态规则 S6——lambda 捕获 self 会延长
|
# core↔core 接线只许方法 Callable（静态规则 S6——lambda 捕获 self 会延长
|
||||||
# RefCounted 生命周期乃至成环：settlement 的信号持捕获 runner 的 lambda，runner 又持 settlement）
|
# RefCounted 生命周期乃至成环：settlement 的信号持捕获 runner 的 lambda，runner 又持 settlement）
|
||||||
_settlement.step_row.connect(_forward_step_row)
|
_settlement.step_row.connect(_forward_step_row)
|
||||||
@@ -462,14 +461,14 @@ func _start_battle(node: Dictionary) -> bool:
|
|||||||
_settlement.board_changed.connect(_forward_board_changed)
|
_settlement.board_changed.connect(_forward_board_changed)
|
||||||
_settlement.battle_finished.connect(_on_battle_finished)
|
_settlement.battle_finished.connect(_on_battle_finished)
|
||||||
# node_entered 先于 begin_battle：呈现层须先拿到 settlement 引用，才能响应 begin 期间发出的
|
# node_entered 先于 begin_battle：呈现层须先拿到 settlement 引用，才能响应 begin 期间发出的
|
||||||
# board_changed（首板安装）并重建棋盘——后发会导致首战棋盘不渲染（2026-09-11 playtest 缺陷①）
|
# board_changed（首板安装）并重建棋盘——后发会导致首战棋盘不渲染
|
||||||
node_entered.emit(node, {})
|
node_entered.emit(node, {})
|
||||||
if not _settlement.begin_battle({"level_index": int(level_row.level_index), "node_depth": int(node.get("node_depth", 0)),
|
if not _settlement.begin_battle({"level_index": int(level_row.level_index), "node_depth": int(node.get("node_depth", 0)),
|
||||||
"hero_hp": hero_hp, "hero_atk": effective_atk(), "hero_max_hp": effective_max_hp(),
|
"hero_hp": hero_hp, "hero_atk": effective_atk(), "hero_max_hp": effective_max_hp(),
|
||||||
"hero_armor_class": effective_ac(), "hero_ap_bonus": effective_ap_bonus(),
|
"hero_armor_class": effective_ac(), "hero_ap_bonus": effective_ap_bonus(),
|
||||||
"attack_type": _hero_attack_type, "armor_type": _hero_armor_type, # 迭代 23 T4——两根类型轴（spawn 英雄快照；空串=锻造配置默认值回退）
|
"attack_type": _hero_attack_type, "armor_type": _hero_armor_type, # 两根类型轴（spawn 英雄快照；空串=锻造配置默认值回退）
|
||||||
"attunement": _attunement,
|
"attunement": _attunement,
|
||||||
"ledger": run_ledger, # 迭代 27 T3——共享四账单类下传（原四散 dict 引用键收口；裁点②甲）
|
"ledger": run_ledger, # 共享四账单类下传（单引用键）
|
||||||
"feats": _feats,
|
"feats": _feats,
|
||||||
"tree_rules": _tree_rules,
|
"tree_rules": _tree_rules,
|
||||||
"battle_index": _battle_index(),
|
"battle_index": _battle_index(),
|
||||||
@@ -478,7 +477,7 @@ func _start_battle(node: Dictionary) -> bool:
|
|||||||
"node_type": String(node.get("type", ""))}):
|
"node_type": String(node.get("type", ""))}):
|
||||||
push_error("[关卡节点地图] 战斗启动失败（depth %s）" % str(node.get("node_depth", -1)))
|
push_error("[关卡节点地图] 战斗启动失败（depth %s）" % str(node.get("node_depth", -1)))
|
||||||
return false
|
return false
|
||||||
_voucher_rap = 0 # 迭代 20 T4——节点级一次性：注入即消费（战斗未启动则保留至下次注入前不清）
|
_voucher_rap = 0 # 节点级一次性：注入即消费（战斗未启动则保留至下次注入前不清）
|
||||||
_voucher_time_sand = 0
|
_voucher_time_sand = 0
|
||||||
return true
|
return true
|
||||||
|
|
||||||
@@ -489,7 +488,7 @@ func _forward_step_row(row: Dictionary) -> void:
|
|||||||
|
|
||||||
# battle_index=第几场战斗（关卡域 1 基序——visited 已含当前节点〔_enter_node :437 先追加后启动〕；
|
# battle_index=第几场战斗（关卡域 1 基序——visited 已含当前节点〔_enter_node :437 先追加后启动〕；
|
||||||
# 按已到节点 type=battle 计数，与图形态 node_depth/单链数组下标两编号空间解耦〔混编碰撞免疫〕；
|
# 按已到节点 type=battle 计数，与图形态 node_depth/单链数组下标两编号空间解耦〔混编碰撞免疫〕；
|
||||||
# 开局姿态组「每关首轮窗」条件面——迭代 21 T3）
|
# 开局姿态组「每关首轮窗」条件面）
|
||||||
func _battle_index() -> int:
|
func _battle_index() -> int:
|
||||||
var n := 0
|
var n := 0
|
||||||
for v in visited:
|
for v in visited:
|
||||||
@@ -524,7 +523,7 @@ func _on_battle_finished(payload: Dictionary) -> void:
|
|||||||
var treasure_cleared := 0
|
var treasure_cleared := 0
|
||||||
if treasure_inventory != null:
|
if treasure_inventory != null:
|
||||||
treasure_cleared = treasure_inventory.inventory_count() # 快照计数（清空前——「剩余道具随关卡结束清空」可见反馈取数）
|
treasure_cleared = treasure_inventory.inventory_count() # 快照计数（清空前——「剩余道具随关卡结束清空」可见反馈取数）
|
||||||
treasure_inventory.reset() # 迭代 7 T3——关卡末库存清空（无论输赢，幂等）
|
treasure_inventory.reset() # 关卡末库存清空（无论输赢，幂等）
|
||||||
level_finished.emit({"result": level_result, "hp": hp_left, "node_index": node_index,
|
level_finished.emit({"result": level_result, "hp": hp_left, "node_index": node_index,
|
||||||
"node_id": _node_id(node), "node_type": String(node.get("type", "")),
|
"node_id": _node_id(node), "node_type": String(node.get("type", "")),
|
||||||
"aux_cleared": treasure_cleared}) # additive 扩签（不参与派生——node_map 扩签先例）
|
"aux_cleared": treasure_cleared}) # additive 扩签（不参与派生——node_map 扩签先例）
|
||||||
@@ -534,8 +533,8 @@ func _on_battle_finished(payload: Dictionary) -> void:
|
|||||||
_present_choices()
|
_present_choices()
|
||||||
|
|
||||||
|
|
||||||
# 恢复数学单一路径（漂移③清偿；2026-10-02 修复批——同式双落点收口：算术宿主 = 本静态方法，
|
# 恢复数学单一路径（漂移③清偿；算术宿主 = 本静态方法，
|
||||||
# AdventureRunner.apply_rest 同式委托，字面量双写退役）。floor(上限 × 比例 ÷ 100) 后封顶缺口；
|
# AdventureRunner.apply_rest 同式委托）。floor(上限 × 比例 ÷ 100) 后封顶缺口；
|
||||||
# 冒险结构 GDD 公式逐位一致
|
# 冒险结构 GDD 公式逐位一致
|
||||||
static func rest_heal(pct: int, hp: int, max_hp: int) -> int:
|
static func rest_heal(pct: int, hp: int, max_hp: int) -> int:
|
||||||
return mini(int(floor(float(max_hp) * float(pct) / 100.0)), max_hp - hp)
|
return mini(int(floor(float(max_hp) * float(pct) / 100.0)), max_hp - hp)
|
||||||
@@ -585,19 +584,19 @@ func pick_next_node(node_id: int) -> bool:
|
|||||||
func current_battle():
|
func current_battle():
|
||||||
return _settlement
|
return _settlement
|
||||||
|
|
||||||
# aux 解锁门控集注入（迭代 7 T5——AdventureRunner 自 params 传递）
|
# aux 解锁门控集注入（AdventureRunner 自 params 传递）
|
||||||
func set_treasure_unlocked(ids: Dictionary) -> void:
|
func set_treasure_unlocked(ids: Dictionary) -> void:
|
||||||
_treasure_unlocked = ids
|
_treasure_unlocked = ids
|
||||||
if _settlement != null:
|
if _settlement != null:
|
||||||
_settlement.set_treasure_unlocked(ids)
|
_settlement.set_treasure_unlocked(ids)
|
||||||
|
|
||||||
|
|
||||||
# 同调装配集注入（迭代 11 第①批 T5——冒险开始参数面；AdventureRunner 唯一调用方）
|
# 同调装配集注入（冒险开始参数面；AdventureRunner 唯一调用方）
|
||||||
func set_attunement(ids: Array) -> void:
|
func set_attunement(ids: Array) -> void:
|
||||||
_attunement = ids.duplicate()
|
_attunement = ids.duplicate()
|
||||||
|
|
||||||
|
|
||||||
# 特性持有集注入（迭代 12 T1——AdventureRunner._start_current_level 唯一调用方；begin_battle
|
# 特性持有集注入（AdventureRunner._start_current_level 唯一调用方；begin_battle
|
||||||
# enc.feats 携带进战斗求值；**共享引用不复制**——关内奖励节点兑付的 relic 须当关后续战斗生效
|
# enc.feats 携带进战斗求值；**共享引用不复制**——关内奖励节点兑付的 relic 须当关后续战斗生效
|
||||||
# （attune_charges 共享账本同款）；空集=零扰动）
|
# （attune_charges 共享账本同款）；空集=零扰动）
|
||||||
var _feats: Array[Variant] = []
|
var _feats: Array[Variant] = []
|
||||||
@@ -607,12 +606,12 @@ func set_feats(ids: Array) -> void:
|
|||||||
_feats = ids
|
_feats = ids
|
||||||
|
|
||||||
|
|
||||||
# 特性持有集读面（迭代 12 呈现补齐——HUD C 区特性段数据源）
|
# 特性持有集读面（HUD C 区特性段数据源）
|
||||||
func feats_held() -> Array:
|
func feats_held() -> Array:
|
||||||
return _feats.duplicate()
|
return _feats.duplicate()
|
||||||
|
|
||||||
|
|
||||||
# 树 rule 键集注入（迭代 12 T10——begin_battle enc.tree_rules 携带；Fork 激活侧 effects）
|
# 树 rule 键集注入（begin_battle enc.tree_rules 携带；Fork 激活侧 effects）
|
||||||
var _tree_rules: Array[Variant] = []
|
var _tree_rules: Array[Variant] = []
|
||||||
|
|
||||||
|
|
||||||
@@ -620,16 +619,16 @@ func set_tree_rules(rules: Array) -> void:
|
|||||||
_tree_rules = rules.duplicate()
|
_tree_rules = rules.duplicate()
|
||||||
|
|
||||||
|
|
||||||
# 两根类型轴注入（迭代 23 T4——adventure 参数面快照；空串=未注入→锻造配置默认值回退。
|
# 两根类型轴注入（adventure 参数面快照；空串=未注入→锻造配置默认值回退。
|
||||||
# 消费面：effective_ac 甲型基础 AC 层 + begin_battle enc 携带进 unit_container.spawn 英雄快照）
|
# 消费面：effective_ac 甲型基础 AC 层 + begin_battle enc 携带进 unit_container.spawn 英雄快照）
|
||||||
func set_hero_axes(attack_type: String, armor_type: String) -> void:
|
func set_hero_axes(attack_type: String, armor_type: String) -> void:
|
||||||
_hero_attack_type = attack_type
|
_hero_attack_type = attack_type
|
||||||
_hero_armor_type = armor_type
|
_hero_armor_type = armor_type
|
||||||
|
|
||||||
|
|
||||||
# 共享四本账注入（迭代 27 T3——P1-4 收口：RunLedger 单类下传，替代原 bonus/attune_charges/
|
# 共享四本账注入（RunLedger 单类下传，含 bonus/attune_charges/
|
||||||
# vision_counter/adventure_counters 四散引用；战斗侧只走账类原语，战末 export/开局 seed
|
# vision_counter/adventure_counters 四账；战斗侧只走账类原语，战末 export/开局 seed
|
||||||
# 时点语义不变〔裁点②甲〕）
|
# 时点语义不变）
|
||||||
var run_ledger: RunLedger = RunLedger.new()
|
var run_ledger: RunLedger = RunLedger.new()
|
||||||
|
|
||||||
|
|
||||||
@@ -637,7 +636,7 @@ func set_run_ledger(l: RunLedger) -> void:
|
|||||||
run_ledger = l
|
run_ledger = l
|
||||||
|
|
||||||
|
|
||||||
# 凭证件三账注入（迭代 20 T4——储备金袋 RAP/时沙 首轮 AP/完美保险 标错豁免；节点级一次性，
|
# 凭证件三账注入（储备金袋 RAP/时沙 首轮 AP/完美保险 标错豁免；节点级一次性，
|
||||||
# battle begin 消费后归零；缺省 0=零扰动）
|
# battle begin 消费后归零；缺省 0=零扰动）
|
||||||
var _voucher_rap := 0
|
var _voucher_rap := 0
|
||||||
var _voucher_time_sand := 0
|
var _voucher_time_sand := 0
|
||||||
@@ -648,10 +647,9 @@ func set_voucher_grants(rap: int, time_sand: int) -> void:
|
|||||||
_voucher_time_sand = maxi(0, time_sand)
|
_voucher_time_sand = maxi(0, time_sand)
|
||||||
|
|
||||||
|
|
||||||
# 同调主动件充能账骑库存面注入（迭代 11 第①批 T6 原语义 + 迭代 27 T3 换代——账本住
|
# 同调主动件充能账骑库存面注入（账本住
|
||||||
# RunLedger；能力件骑库存面注入保留：差额注入防续玩双份——resume 路径 restore_inventory
|
# RunLedger；差额注入防续玩双份——resume 路径 restore_inventory
|
||||||
# 已含断点内 attune 记录。原 set_attune_charges/set_vision_counter/set_adventure_counters
|
# 已含断点内 attune 记录）
|
||||||
# 三散 setter 随单类下传承接）
|
|
||||||
func sync_attune_inventory() -> void:
|
func sync_attune_inventory() -> void:
|
||||||
var charges: Dictionary[Variant, Variant] = run_ledger.attune_charges
|
var charges: Dictionary[Variant, Variant] = run_ledger.attune_charges
|
||||||
if treasure_inventory == null:
|
if treasure_inventory == null:
|
||||||
@@ -664,7 +662,7 @@ func sync_attune_inventory() -> void:
|
|||||||
for i in range(maxi(0, int(charges[iid]) - existing)):
|
for i in range(maxi(0, int(charges[iid]) - existing)):
|
||||||
treasure_inventory.add_item(String(iid), "attunement", Vector2i(-1, -1), 0)
|
treasure_inventory.add_item(String(iid), "attunement", Vector2i(-1, -1), 0)
|
||||||
|
|
||||||
# 三选一 GP 袋件入账（迭代 10——钱包收口扩「奖励入账」入口；复用战斗完成同一入账原语，
|
# 三选一 GP 袋件入账（钱包收口的「奖励入账」入口；复用战斗完成同一入账原语，
|
||||||
# wallet_changed 载荷带 source 供呈现归因）
|
# wallet_changed 载荷带 source 供呈现归因）
|
||||||
func grant_curio_gp(amount: int) -> void:
|
func grant_curio_gp(amount: int) -> void:
|
||||||
gp = maxi(0, gp + amount)
|
gp = maxi(0, gp + amount)
|
||||||
@@ -680,13 +678,13 @@ func continue_after_node() -> bool:
|
|||||||
if t != "reward" and t != "rest" and t != "shop":
|
if t != "reward" and t != "rest" and t != "shop":
|
||||||
return false
|
return false
|
||||||
if t == "shop":
|
if t == "shop":
|
||||||
_shop_shelf = [] # 离开店面货架态清零（断点快照 shop_shelf 键随离开落空架合法态——迭代 11 第②批 T2）
|
_shop_shelf = [] # 离开店面货架态清零（断点快照 shop_shelf 键随离开落空架合法态）
|
||||||
_shop_visit_buys = 0
|
_shop_visit_buys = 0
|
||||||
_shop_paid_refreshes = 0 # MC-1
|
_shop_paid_refreshes = 0 # MC-1
|
||||||
return _present_choices()
|
return _present_choices()
|
||||||
|
|
||||||
|
|
||||||
# ---- GP 冒险钱包（GP+商店房实施批 2026-09-21：入账/出账/收束清零三收口）----
|
# ---- GP 冒险钱包（入账/出账/收束清零三收口）----
|
||||||
|
|
||||||
# 战斗完成入账（gp_dropped 载荷——clamp ≥0；破财可把战斗域 escrow 打负，钱包不透支）
|
# 战斗完成入账（gp_dropped 载荷——clamp ≥0；破财可把战斗域 escrow 打负，钱包不透支）
|
||||||
func _gain_wallet(amount: int) -> void:
|
func _gain_wallet(amount: int) -> void:
|
||||||
@@ -719,16 +717,15 @@ func shop_products() -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 现价 = base_price + price_level_bonus(level_index) + price_increment × 该商品已购档数
|
# 现价 = base_price + price_level_bonus(level_index) + price_increment × 该商品已购档数
|
||||||
# （散折价随批：economy_spend 激活时商品标价 ×80%——见 _spend_discounted）
|
# （散折价：economy_spend 激活时商品标价 ×80%——见 _spend_discounted）
|
||||||
func current_price(prow: Dictionary) -> int:
|
func current_price(prow: Dictionary) -> int:
|
||||||
return _spend_discounted(int(prow.get("base_price", 0)) + db.shop_price_level_bonus(int(level_row.level_index)) \
|
return _spend_discounted(int(prow.get("base_price", 0)) + db.shop_price_level_bonus(int(level_row.level_index)) \
|
||||||
+ int(prow.get("price_increment", 0)) * purchased_tier(String(prow.get("product_id", ""))))
|
+ int(prow.get("price_increment", 0)) * purchased_tier(String(prow.get("product_id", ""))))
|
||||||
|
|
||||||
|
|
||||||
# 散折价单点（迭代 21 T3——财富之道·散 economy_spend 激活时商品购买价 ×80% provisional，
|
# 散折价单点（财富之道·散 economy_spend 激活时商品购买价 ×80% provisional，
|
||||||
# floor 取整偏向玩家、下限 1 防 1 元商品折成 0；范围=商品标价定义边界〔legacy 商品面 current_price
|
# floor 取整偏向玩家、下限 1 防 1 元商品折成 0；范围=商品标价定义边界〔legacy 商品面 current_price
|
||||||
# + 池货架面 pool_price 同折〕——商店刷新价 shop_refresh_cost 与三选一付费刷新不折〔卡片§11②裁决〕；
|
# + 池货架面 pool_price 同折〕——商店刷新价 shop_refresh_cost 与三选一付费刷新不折）
|
||||||
# 折率归 M4 数值批）
|
|
||||||
func _spend_discounted(price: int) -> int:
|
func _spend_discounted(price: int) -> int:
|
||||||
if _tree_rules.has("economy_spend"):
|
if _tree_rules.has("economy_spend"):
|
||||||
return maxi(1, int(floor(float(price) * 0.8)))
|
return maxi(1, int(floor(float(price) * 0.8)))
|
||||||
@@ -753,7 +750,7 @@ func buy_product(product_id: String) -> bool:
|
|||||||
var price := current_price(prow)
|
var price := current_price(prow)
|
||||||
if gp < price:
|
if gp < price:
|
||||||
push_warning("[关卡节点地图] 购买拒绝——余额不足: %s（需 %d，钱包 %d）" % [product_id, price, gp])
|
push_warning("[关卡节点地图] 购买拒绝——余额不足: %s（需 %d，钱包 %d）" % [product_id, price, gp])
|
||||||
return false # 余额不足（覆盖层按钮禁用为常态防线——此处兜底拒绝；2026-10-02 补静默留痕）
|
return false # 余额不足（覆盖层按钮禁用为常态防线——此处兜底拒绝＋静默留痕）
|
||||||
gp -= price
|
gp -= price
|
||||||
var flat := int(prow.get("flat_value", 0))
|
var flat := int(prow.get("flat_value", 0))
|
||||||
run_ledger.bonus[attr] = int(run_ledger.bonus[attr]) + flat
|
run_ledger.bonus[attr] = int(run_ledger.bonus[attr]) + flat
|
||||||
@@ -770,11 +767,11 @@ func player_request_refresh() -> bool:
|
|||||||
return _settlement.player_request_refresh()
|
return _settlement.player_request_refresh()
|
||||||
|
|
||||||
|
|
||||||
# ---- 商店共享池模式（迭代 11 第②批 T3——P1 共享池/P4 ceil；legacy 固定三件路径上方原样保留为 off 对照承载）----
|
# ---- 商店共享池模式（legacy 固定三件路径保留为 off 对照承载）----
|
||||||
|
|
||||||
# 注入（AdventureRunner._start_current_level 唯一调用方——pool 模式专用）：令牌库共享引用 +
|
# 注入（AdventureRunner._start_current_level 唯一调用方——pool 模式专用）：令牌库共享引用 +
|
||||||
# 池消费 handler。legacy 模式不注入（_shop_pool_mode 恒 false——off 态零 RNG 零池消费零扰动）。
|
# 池消费 handler。legacy 模式不注入（_shop_pool_mode 恒 false——off 态零 RNG 零池消费零扰动）。
|
||||||
# 迭代 20 T2——cap 检查回调（案②提前退役：cap 满 kind 剔出货架候选视图）。
|
# cap 检查回调（cap 满 kind 剔出货架候选视图）。
|
||||||
func set_shop_pool(deck_ref: Array, consume_handler: Callable, ticket_consider: Callable = Callable(), cap_check: Callable = Callable()) -> void:
|
func set_shop_pool(deck_ref: Array, consume_handler: Callable, ticket_consider: Callable = Callable(), cap_check: Callable = Callable()) -> void:
|
||||||
_pool_deck = deck_ref
|
_pool_deck = deck_ref
|
||||||
_pool_consume = consume_handler
|
_pool_consume = consume_handler
|
||||||
@@ -801,7 +798,7 @@ func _shop_draw_shelf() -> void:
|
|||||||
for row in db.shop_pool_rows():
|
for row in db.shop_pool_rows():
|
||||||
var shelf_kind := String(row.get("kind_id", ""))
|
var shelf_kind := String(row.get("kind_id", ""))
|
||||||
if _pool_cap_check.is_valid() and not bool(_pool_cap_check.call(shelf_kind, "")):
|
if _pool_cap_check.is_valid() and not bool(_pool_cap_check.call(shelf_kind, "")):
|
||||||
continue # 迭代 20 T2 案②——cap 满提前退役（货架候选视图剔除；牌库本体不动）
|
continue # cap 满剔除（货架候选视图剔除；牌库本体不动）
|
||||||
for t in _pool_deck:
|
for t in _pool_deck:
|
||||||
var tok: Dictionary[Variant, Variant] = t as Dictionary
|
var tok: Dictionary[Variant, Variant] = t as Dictionary
|
||||||
if String(tok.get("kind", "")) == shelf_kind:
|
if String(tok.get("kind", "")) == shelf_kind:
|
||||||
@@ -826,10 +823,9 @@ func _shop_draw_shelf() -> void:
|
|||||||
# T5 门票注入（非 Boss 渠道唯一专长入口——货架与节点共享保底计数；判定含 pity 记账，替换末位占一席。
|
# T5 门票注入（非 Boss 渠道唯一专长入口——货架与节点共享保底计数；判定含 pity 记账，替换末位占一席。
|
||||||
# 取数复用本函数 shop_draw scope 的 stream——零新 scope，确定性序列不漂移）
|
# 取数复用本函数 shop_draw scope 的 stream——零新 scope，确定性序列不漂移）
|
||||||
if _pool_ticket.is_valid() and not _shop_shelf.is_empty() and bool(_pool_ticket.call(stream)):
|
if _pool_ticket.is_valid() and not _shop_shelf.is_empty() and bool(_pool_ticket.call(stream)):
|
||||||
_shop_shelf[_shop_shelf.size() - 1] = {"kind": "feat_ticket", "tier": "excellent"} # 迭代 20 T2——档名四级换代（旧 rare 语义=优秀）
|
_shop_shelf[_shop_shelf.size() - 1] = {"kind": "feat_ticket", "tier": "excellent"} # 门票占位档名 = excellent
|
||||||
# 商店保底退役（迭代 15 卡② T4——渠道轴定位裁决：商店渠道只出属性值提升+资源，专长在非 Boss
|
# 商店渠道无专长直接投放（渠道白名单：商店渠道只出属性值提升+资源，专长在非 Boss
|
||||||
# 渠道只以门票形态出现（奇物.md v2.7/A4 断言）。迭代 12 T6「货架零特性挤卡换吞噬流件」简化口径
|
# 渠道只以门票形态出现——奇物.md v2.7/A4 断言；专长商店入口=T5 门票）。
|
||||||
# 与渠道白名单直接冲突（devour=规则改写型=专长系），随渠道分离退役；专长商店入口=T5 门票。
|
|
||||||
|
|
||||||
|
|
||||||
# 库存余量（TP0——令牌库内该 kind 剩余枚数单点读；未注入/防御读 = 0）
|
# 库存余量（TP0——令牌库内该 kind 剩余枚数单点读；未注入/防御读 = 0）
|
||||||
@@ -857,7 +853,7 @@ func pool_price(kind: String) -> int:
|
|||||||
|
|
||||||
|
|
||||||
# 货架只读投影（呈现层数据源——kind/显示名/件值/现价/库存余量齐备，UI 零复算）。
|
# 货架只读投影（呈现层数据源——kind/显示名/件值/现价/库存余量齐备，UI 零复算）。
|
||||||
# 件值=在架令牌本体值（TP0——令牌级货架，kind+tier 定值；价格公式维持批②裁定 tier-blind）。
|
# 件值=在架令牌本体值（TP0——令牌级货架，kind+tier 定值；价格公式 tier-blind〔不随档位变〕）。
|
||||||
func shop_shelf() -> Array:
|
func shop_shelf() -> Array:
|
||||||
var out: Array[Dictionary] = []
|
var out: Array[Dictionary] = []
|
||||||
for tok in _shop_shelf:
|
for tok in _shop_shelf:
|
||||||
@@ -882,16 +878,16 @@ func shop_shelf() -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# 商店独立刷新（MC-1——P-C2 裁 2026-10-04 推翻 v1.5「无独立刷新」）：免费次数（天赋增益位，基础
|
# 商店独立刷新（MC-1）：免费次数（天赋增益位，基础
|
||||||
# knob=0——Q2 裁「基础免费 0 次」）用尽后 GP 付费刷新；刷新=货架整架重抽（shop_draw 恰一新 scope，
|
# knob=0=「基础免费 0 次」）用尽后 GP 付费刷新；刷新=货架整架重抽（shop_draw 恰一新 scope，
|
||||||
# 与进店/买后重抽同签——重抽同源共享池）；池空/非池模式=不可刷新合法态。
|
# 与进店/买后重抽同签——重抽同源共享池）；池空/非池模式=不可刷新合法态。
|
||||||
func shop_refresh_free_left() -> int:
|
func shop_refresh_free_left() -> int:
|
||||||
# 迭代 22 秘宝批 T3——刷新执照 shop_refresh_bonus 装配合计叠加（进店入账语义=读数即本店可用，
|
# 刷新执照 shop_refresh_bonus 装配合计叠加（进店入账语义=读数即本店可用，
|
||||||
# 与基础 knob 同生命周期；未装配=基值逐位同旧）
|
# 与基础 knob 同生命周期；未装配=基值）
|
||||||
return maxi(0, int(db.adventure.shop_refresh_free) + _attune_shop_refresh_bonus())
|
return maxi(0, int(db.adventure.shop_refresh_free) + _attune_shop_refresh_bonus())
|
||||||
|
|
||||||
|
|
||||||
# 刷新执照装配合计（迭代 22 秘宝批 T3——装配集 kind 分发扫描；零装配=0）
|
# 刷新执照装配合计（装配集 kind 分发扫描；零装配=0）
|
||||||
func _attune_shop_refresh_bonus() -> int:
|
func _attune_shop_refresh_bonus() -> int:
|
||||||
var total := 0
|
var total := 0
|
||||||
for iid_v in _attunement:
|
for iid_v in _attunement:
|
||||||
@@ -919,7 +915,7 @@ func shop_refresh() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# GP 冒险钱包单口支出（2026-10-06——三选一 GP 付费刷新与商店刷新共用同一钱包；余额不足 false 零副作用）
|
# GP 冒险钱包单口支出（三选一 GP 付费刷新与商店刷新共用同一钱包；余额不足 false 零副作用）
|
||||||
func spend_gp(amount: int) -> bool:
|
func spend_gp(amount: int) -> bool:
|
||||||
if amount <= 0 or gp < amount:
|
if amount <= 0 or gp < amount:
|
||||||
return false
|
return false
|
||||||
|
|||||||
@@ -9,7 +9,7 @@ var db: ConfigDb
|
|||||||
var save: SaveManagerCore
|
var save: SaveManagerCore
|
||||||
|
|
||||||
|
|
||||||
# 迭代 27 T1 裁点①——MetaProgression 升格 autoload（RngService 先例：类名加 Core 后缀、
|
# MetaProgression 是 autoload（仿 RngService 先例：类名加 Core 后缀、
|
||||||
# autoload 占净名）。_init 参数可缺省兼容双形态：autoload 实例化走 .new() 零参 + _ready 从
|
# autoload 占净名）。_init 参数可缺省兼容双形态：autoload 实例化走 .new() 零参 + _ready 从
|
||||||
# autoload 链取依赖（工程序 ConfigDB→RngService→SaveManager→MetaProgression，_ready 时序
|
# autoload 链取依赖（工程序 ConfigDB→RngService→SaveManager→MetaProgression，_ready 时序
|
||||||
# 已就绪）；单测/工具直呼 .new(db, save) 形态不变（不入树零 _ready）。
|
# 已就绪）；单测/工具直呼 .new(db, save) 形态不变（不入树零 _ready）。
|
||||||
@@ -29,11 +29,9 @@ func keystone_balance() -> int:
|
|||||||
return save.keystone_balance()
|
return save.keystone_balance()
|
||||||
|
|
||||||
|
|
||||||
# ---- 秘宝解锁服务（迭代 22 T2 换代——解锁混合制，契约 6；旧工坊渠道面随批删除）----
|
# ---- 秘宝解锁服务（解锁混合制，契约 6）----
|
||||||
# 〔属性锻造柜台退役——迭代 21 T4/T5：buy_forge/forge_flat/forge_level/forge_price 与 meta_forge
|
# 解锁条件单一事实源=treasure_items.tres 行内 unlock_keystone_cost/unlock_requires 谓词
|
||||||
# 表族随攻防所有权切分删除。〕〔道具工坊解锁渠道面退役——迭代 22 T2：旧「总通关次数达阈值」
|
# （C1 逐件分配锁定表）。
|
||||||
# 行族与 _workshop_progress/workshop_status/refresh_workshop_unlocks 删除，解锁条件单一事实源=
|
|
||||||
# treasure_items.tres 行内 unlock_keystone_cost/unlock_requires 谓词（C1 逐件分配锁定表）。〕
|
|
||||||
|
|
||||||
# 道具解锁读数访问器（组合根/呈现层解锁门控查询面——禁再穿透 meta.save 直读 save_manager）
|
# 道具解锁读数访问器（组合根/呈现层解锁门控查询面——禁再穿透 meta.save 直读 save_manager）
|
||||||
func is_item_unlocked(item_id: String) -> bool:
|
func is_item_unlocked(item_id: String) -> bool:
|
||||||
@@ -123,11 +121,11 @@ func treasure_shop_status() -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# ---- 锻造工坊写口族（迭代 23 T3——契约 9：扣币/升级/解锁/选中/写盘只经本组；UI 只发意图信号）----
|
# ---- 锻造工坊写口族（契约 9：扣币/升级/解锁/选中/写盘只经本组；UI 只发意图信号）----
|
||||||
# 设计权威 design/gdd/systems/跨局循环/锻造工坊.md v0.6：钥石单币（契约 3——GP 局内一次性货币
|
# 设计权威 design/gdd/systems/跨局循环/锻造工坊.md v0.6：钥石单币（契约 3——GP 局内一次性货币
|
||||||
# 永不互兑）、并联双通道解锁（4b-1——练满前一档 OR 一次性解锁价，互不影响不设串联）、
|
# 永不互兑）、并联双通道解锁（4b-1——练满前一档 OR 一次性解锁价，互不影响不设串联）、
|
||||||
# 一次冒险一武器一甲（契约 8——营地免费切换、冒险开始锁死由参数面快照保证）。
|
# 一次冒险一武器一甲（契约 8——营地免费切换、冒险开始锁死由参数面快照保证）。
|
||||||
# 等级语义（Q1）：未解锁/未锻造=0 加值（裸体态）；锻造第一级=「获得装备」=首个 +1；逐级递进。
|
# 等级语义：未解锁/未锻造=0 加值（裸体态）；锻造第一级=「获得装备」=首个 +1；逐级递进。
|
||||||
|
|
||||||
# 路线解锁态派生（不落档——初始持有∨直购∨练满前一档；派生单点只此一处）
|
# 路线解锁态派生（不落档——初始持有∨直购∨练满前一档；派生单点只此一处）
|
||||||
func forge_route_unlocked(route_id: String) -> bool:
|
func forge_route_unlocked(route_id: String) -> bool:
|
||||||
@@ -231,7 +229,7 @@ func hero_armor_type() -> String:
|
|||||||
return String(row.get("type_axis", ""))
|
return String(row.get("type_axis", ""))
|
||||||
|
|
||||||
|
|
||||||
# ---- 锻造工坊柜台只读投影（迭代 23 T6——呈现层数据源：两区六路线行板；余额联动禁用归视图）----
|
# ---- 锻造工坊柜台只读投影（呈现层数据源：两区六路线行板；余额联动禁用归视图）----
|
||||||
# 每行 {route_id, display_name, kind, type_axis, level, cap, unlocked, initial_owned, selected,
|
# 每行 {route_id, display_name, kind, type_axis, level, cap, unlocked, initial_owned, selected,
|
||||||
# next_price(未满级已解锁=下级几何价/否则 0), unlock_price, prereq_route, prereq_name,
|
# next_price(未满级已解锁=下级几何价/否则 0), unlock_price, prereq_route, prereq_name,
|
||||||
# prereq_level, prereq_cap, prereq_maxed}——纯结构面，禁嵌余额判断（视图按 balance 禁用，同秘宝匣先例）。
|
# prereq_level, prereq_cap, prereq_maxed}——纯结构面，禁嵌余额判断（视图按 balance 禁用，同秘宝匣先例）。
|
||||||
@@ -271,16 +269,16 @@ func forge_shop_status() -> Array:
|
|||||||
# ---- Boss 两档与收束入账（结算屏文案数据源）----
|
# ---- Boss 两档与收束入账（结算屏文案数据源）----
|
||||||
# 明细 {big_reward, boss_drops, total, new_unlocks}；入账与标记经 save.apply_adventure_summary
|
# 明细 {big_reward, boss_drops, total, new_unlocks}；入账与标记经 save.apply_adventure_summary
|
||||||
# （keystone_drops 副本随摘要入 recent_summaries）。
|
# （keystone_drops 副本随摘要入 recent_summaries）。
|
||||||
# 迭代 10 奖励重构批：钥石改 Boss 逐杀掉落——掉落金额已在冒险内逐杀入账（summary.keystone_total
|
# 钥石为 Boss 逐杀掉落——掉落金额已在冒险内逐杀入账（summary.keystone_total
|
||||||
# 含全部掉落；首杀/复杀裁决在 AdventureRunner._boss_keystone_drop，首杀标记仍在下方
|
# 含全部掉落；首杀/复杀判定在 AdventureRunner._boss_keystone_drop，首杀标记在下方
|
||||||
# apply_adventure_summary 逐通关关次置位）。本函数不再派生掉落金额，只做标记+入账+归档。
|
# apply_adventure_summary 逐通关关次置位）。本函数只做标记+入账+归档。
|
||||||
func settle_adventure(summary: Dictionary) -> Dictionary:
|
func settle_adventure(summary: Dictionary) -> Dictionary:
|
||||||
# 首次冒险布尔位置位（关卡节点图生成 v0.4——完成/失败/放弃三结局同经本收束挂点，写入只在收束）
|
# 首次冒险布尔位置位（关卡节点图生成 v0.4——完成/失败/放弃三结局同经本收束挂点，写入只在收束）
|
||||||
save.mark_first_adventure_done()
|
save.mark_first_adventure_done()
|
||||||
var drops: Array[Variant] = (summary.get("keystone_drops", []) as Array).duplicate(true)
|
var drops: Array[Variant] = (summary.get("keystone_drops", []) as Array).duplicate(true)
|
||||||
save.apply_adventure_summary(summary, drops)
|
save.apply_adventure_summary(summary, drops)
|
||||||
save.add_vision_used(int(summary.get("vision_used_delta", 0))) # 迭代 22 T3——真视使用计数收束聚合入档（信标网络行为条件）
|
save.add_vision_used(int(summary.get("vision_used_delta", 0))) # 真视使用计数收束聚合入档（信标网络行为条件）
|
||||||
var new_unlocks := refresh_treasure_unlocks() # 迭代 22 T2——条件解锁刷新换代（旧工坊面退役）
|
var new_unlocks := refresh_treasure_unlocks() # 条件解锁刷新
|
||||||
save.write_to_disk()
|
save.write_to_disk()
|
||||||
var total := int(summary.get("keystone_total", 0))
|
var total := int(summary.get("keystone_total", 0))
|
||||||
return {
|
return {
|
||||||
@@ -292,13 +290,12 @@ func settle_adventure(summary: Dictionary) -> Dictionary:
|
|||||||
|
|
||||||
|
|
||||||
# ---- 跨局注入（冒险开始参数面）----
|
# ---- 跨局注入（冒险开始参数面）----
|
||||||
# 迭代 23 T4 注入公式换代（锻造工坊实装批——契约 1 攻防所有权切分落地）：基础值 + 树生命/命中淬炼
|
# 注入公式（契约 1 攻防所有权切分）：基础值 + 树生命/命中淬炼
|
||||||
# flat（命中线在账未注入——契约 6，消费面归数值批）+ **锻造路线加值**（当前选中武器攻击加值 + 当前甲
|
# flat（命中线在账未注入——契约 6）+ **锻造路线加值**（当前选中武器攻击加值 + 当前甲
|
||||||
# AC 加值——读存档 forge_routes 域+路线表）+ 局内加算区（bonus 区域不经本面）。入战 AC 三层可加：
|
# AC 加值——读存档 forge_routes 域+路线表）+ 局内加算区（bonus 区域不经本面）。入战 AC 三层可加：
|
||||||
# 甲型基础 AC（forge.tres 行 base_ac）+ 甲路线等级加值（本面 armor_class 分量）+ 局内加算区。
|
# 甲型基础 AC（forge.tres 行 base_ac）+ 甲路线等级加值（本面 armor_class 分量）+ 局内加算区。
|
||||||
# 旧属性柜台 forge_flat 项退役移除（V7/V12）；攻/AC 树来源随所有权切分砍除（契约 9——树零攻防来源，
|
# 攻/AC 树来源按所有权切分砍除（契约 9——树零攻防来源，
|
||||||
# 现表零 atk/armor_class 行，tree_stat_flat 二轴恒 0 保留通式）。原 FORGE_ROUTE_BONUS 预留常量随本批
|
# 现表零 atk/armor_class 行，tree_stat_flat 二轴恒 0 保留通式）。
|
||||||
# 退役（公式不再出现——V7/V12）。
|
|
||||||
# 全零 = 白板合法态（无解锁不得改变任何局内规则）；override 禁写表（表运行期只读）。
|
# 全零 = 白板合法态（无解锁不得改变任何局内规则）；override 禁写表（表运行期只读）。
|
||||||
|
|
||||||
func hero_override() -> Dictionary:
|
func hero_override() -> Dictionary:
|
||||||
@@ -309,7 +306,7 @@ func hero_override() -> Dictionary:
|
|||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
# ---- 天赋树段（迭代 12 T8——R1 甲融合案；设计权威 整合定稿 §1.4 一树双币三脉一脊）----
|
# ---- 天赋树段（设计权威 整合定稿 §1.4 一树双币三脉一脊）----
|
||||||
|
|
||||||
# 全树已购总等级（row-gating 输入——「投入点数累计解锁新行」）
|
# 全树已购总等级（row-gating 输入——「投入点数累计解锁新行」）
|
||||||
func tree_spent_total() -> int:
|
func tree_spent_total() -> int:
|
||||||
@@ -333,15 +330,15 @@ func tree_can_buy(node_id: String) -> bool:
|
|||||||
# 刷新升级节点：cap 主语=Y 账本（单一事实源——树上入口与装配段同 cap 同价，防双账漂移）
|
# 刷新升级节点：cap 主语=Y 账本（单一事实源——树上入口与装配段同 cap 同价，防双账漂移）
|
||||||
if node_id == "ks_refresh" and db.meta_attune_refresh_row(save.attune_refresh_level() + 1).is_empty():
|
if node_id == "ks_refresh" and db.meta_attune_refresh_row(save.attune_refresh_level() + 1).is_empty():
|
||||||
return false
|
return false
|
||||||
# 行门槛（一线一节点：脊柱节点第 N 级需全树总投入 ≥4×(N−1)——迭代 21 主语平移，row 字段退役）
|
# 行门槛（一线一节点：脊柱节点第 N 级需全树总投入 ≥4×(N−1)）
|
||||||
if String(row.get("vein", "")) == "spine" and String(row.get("kind", "")) == "stat":
|
if String(row.get("vein", "")) == "spine" and String(row.get("kind", "")) == "stat":
|
||||||
if tree_spent_total() < db.meta_tree.level_gate(lvl + 1):
|
if tree_spent_total() < db.meta_tree.level_gate(lvl + 1):
|
||||||
return false
|
return false
|
||||||
for req in (row.get("requires", []) as Array):
|
for req in (row.get("requires", []) as Array):
|
||||||
if save.tree_level(String(req)) < 1:
|
if save.tree_level(String(req)) < 1:
|
||||||
return false
|
return false
|
||||||
# 等级阈值前置（R1 机制位——requires_level {node_id: n}：前置节点等级 ≥ n 才可购；
|
# 等级阈值前置（requires_level {node_id: n}：前置节点等级 ≥ n 才可购；
|
||||||
# 2026-10-13 用户推翻裁撤案随批重立，现役表零配置=空转零行为影响）
|
# 现役表零配置=空转零行为影响）
|
||||||
var req_lv: Dictionary[Variant, Variant] = row.get("requires_level", {}) as Dictionary
|
var req_lv: Dictionary[Variant, Variant] = row.get("requires_level", {}) as Dictionary
|
||||||
for req_id in req_lv.keys():
|
for req_id in req_lv.keys():
|
||||||
if save.tree_level(String(req_id)) < int(req_lv[req_id]):
|
if save.tree_level(String(req_id)) < int(req_lv[req_id]):
|
||||||
@@ -349,9 +346,9 @@ func tree_can_buy(node_id: String) -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 节点购买（营地树 UI 唯一写口）：树全钥石单币（2026-10-07 用户裁甲）。free=工作间钥匙零币点亮
|
# 节点购买（营地树 UI 唯一写口）：树全钥石单币。free=工作间钥匙零币点亮
|
||||||
# （price 0，零额消费无副作用）；彩蛋不经购买（can_buy 已拒——觉醒唯一入口=_check_easter_egg）。
|
# （price 0，零额消费无副作用）；彩蛋不经购买（can_buy 已拒——觉醒唯一入口=_check_easter_egg）。
|
||||||
# 刷新升级节点走同账路由（Q1 裁乙——树上+秘宝匣装配段双入口写同一 attune_refresh_level 账本，
|
# 刷新升级节点走同账路由（树上+秘宝匣装配段双入口写同一 attune_refresh_level 账本，
|
||||||
# 价格/上限单一事实源=Y 行表值 keystone_cost；V15）。
|
# 价格/上限单一事实源=Y 行表值 keystone_cost；V15）。
|
||||||
func tree_buy(node_id: String) -> bool:
|
func tree_buy(node_id: String) -> bool:
|
||||||
if node_id == "ks_refresh":
|
if node_id == "ks_refresh":
|
||||||
@@ -479,7 +476,7 @@ func tree_fork_groups() -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 彩蛋觉醒检查（特化判定——生命/命中两线拉满 且 同调位 1/2/3 全解锁 → easter_ley 免费点亮；
|
# 彩蛋觉醒检查（特化判定——生命/命中两线拉满 且 同调位 1/2/3 全解锁 → easter_ley 免费点亮；
|
||||||
# 迭代 21 T2 换代：不依赖 requires/requires_level 前置形态，发现率监控呈报面沿袭）
|
# 不依赖 requires/requires_level 前置形态）
|
||||||
func _check_easter_egg() -> void:
|
func _check_easter_egg() -> void:
|
||||||
if save.tree_level("easter_ley") > 0:
|
if save.tree_level("easter_ley") > 0:
|
||||||
return
|
return
|
||||||
@@ -493,15 +490,11 @@ func _check_easter_egg() -> void:
|
|||||||
save.set_tree_level("easter_ley", 1)
|
save.set_tree_level("easter_ley", 1)
|
||||||
|
|
||||||
|
|
||||||
# 三体系迁移函数已删除（迭代 21 T5——旧档破坏性废弃〔Q3 用户裁：开发阶段无迁移〕；换代前结构
|
# ---- 同调位账本（装配关系/同调位求值/Y 刷新升级；设计权威 proposal §2）----
|
||||||
# 由 SaveManager._normalize 的 tree_struct 标记检测废弃重置，禁迁移禁折算）。
|
|
||||||
|
|
||||||
|
|
||||||
# ---- 同调位账本（迭代 11 第①批 T4——装配关系/同调位求值/Y 刷新升级；设计权威 proposal §2 + 需求卡片 P1 甲）----
|
|
||||||
|
|
||||||
# 装配切换（营地装配覆盖层唯一写口——冒险开始前配置；冒险中零写口=装配不可变契约 1，本口只服务营地）：
|
# 装配切换（营地装配覆盖层唯一写口——冒险开始前配置；冒险中零写口=装配不可变契约 1，本口只服务营地）：
|
||||||
# 已装 → 卸下恒可（卸下后其余件前移位序——效果面只读装配集不受格位影响）；未装 → 非同调行拒绝 +
|
# 已装 → 卸下恒可（卸下后其余件前移位序——效果面只读装配集不受格位影响）；未装 → 非同调行拒绝 +
|
||||||
# 满位禁选 + 档位格校验（迭代 22 T2 契约 2：装入件 append 至末位 k=已装数+1，件档 rank ≤ k——
|
# 满位禁选 + 档位格校验（契约 2：装入件 append 至末位 k=已装数+1，件档 rank ≤ k——
|
||||||
# 格 1=普通格/格 2=优秀格/格 3=稀有格递增向下兼容；槽位来源=树同调位节点点亮数，树接口接缝现役）。
|
# 格 1=普通格/格 2=优秀格/格 3=稀有格递增向下兼容；槽位来源=树同调位节点点亮数，树接口接缝现役）。
|
||||||
# 装配关系写存档持久。
|
# 装配关系写存档持久。
|
||||||
func toggle_attunement(item_id: String) -> bool:
|
func toggle_attunement(item_id: String) -> bool:
|
||||||
|
|||||||
@@ -11,18 +11,18 @@ signal round_end_board(payload: Dictionary) # 双发射源之棋盘路径（
|
|||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
var action_economy: ActionEconomy
|
var action_economy: ActionEconomy
|
||||||
# 秘宝常时参数注入面（迭代 22 秘宝批 T3——编排器 begin_battle 按装配集 kind 分发注入：
|
# 秘宝常时参数注入面（编排器 begin_battle 按装配集 kind 分发注入：
|
||||||
# dig_range_bonus=挖掘切比雪夫距离放宽〔远程镐 dig_range_bonus magnitude〕/seal_range_free=
|
# dig_range_bonus=挖掘切比雪夫距离放宽〔远程镐 dig_range_bonus magnitude〕/seal_range_free=
|
||||||
# 封印不限相邻〔信标网络〕；缺省 0/false=零装配零扰动，棋盘事实不可变契约不受影响——
|
# 封印不限相邻〔信标网络〕；缺省 0/false=零装配零扰动，棋盘事实不可变契约不受影响——
|
||||||
# 两参数只放宽「动作可达性」判据，禁碰危险格/安全格分布）
|
# 两参数只放宽「动作可达性」判据，禁碰危险格/安全格分布）
|
||||||
var dig_range_bonus := 0
|
var dig_range_bonus := 0
|
||||||
var seal_range_free := false
|
var seal_range_free := false
|
||||||
# 棋盘状态私有（E2 封装收口 2026-09-13）：对外只暴露 current_board()/reveal_record() 等查询面，
|
# 棋盘状态私有（E2 封装收口）：对外只暴露 current_board()/reveal_record() 等查询面，
|
||||||
# 禁止跨模块直读/直写原始字典——先例教训 = board_view 绕过查询面直读 revealed。
|
# 禁止跨模块直读/直写原始字典。
|
||||||
var _board: BoardData = null
|
var _board: BoardData = null
|
||||||
var _revealed := {} # Vector2i → {"kind": "safe"/"mine", "digit": int}
|
var _revealed := {} # Vector2i → {"kind": "safe"/"mine", "digit": int}
|
||||||
var _seals := {} # Vector2i → true（棋盘单态；跨轮保留随图存续）
|
var _seals := {} # Vector2i → true（棋盘单态；跨轮保留随图存续）
|
||||||
var _removed := {} # Vector2i → true（迭代 13 T8/D6——中立移除危险格集；随 install/retire 清空）
|
var _removed := {} # Vector2i → true（中立移除危险格集；随 install/retire 清空）
|
||||||
var _hero := Vector2i.ZERO
|
var _hero := Vector2i.ZERO
|
||||||
var _spawn: Dictionary[Vector2i, bool] = {}
|
var _spawn: Dictionary[Vector2i, bool] = {}
|
||||||
|
|
||||||
@@ -72,7 +72,7 @@ func clear_map_cleared() -> bool:
|
|||||||
return safe_remaining() == 0
|
return safe_remaining() == 0
|
||||||
|
|
||||||
|
|
||||||
# ---- 中立移除（迭代 13 T8/D6——P1 甲：邻接数字=原始雷数冻结零重算；P2 甲：移除格呈现退色降档；
|
# ---- 中立移除（P1 甲：邻接数字=原始雷数冻结零重算；P2 甲：移除格呈现退色降档；
|
||||||
# 移除集=未揭示、无封印、是雷——封印判定基线零回溯；危险格不入清图分母/连锁/C_dig 模拟，判定逻辑零改动） ----
|
# 移除集=未揭示、无封印、是雷——封印判定基线零回溯；危险格不入清图分母/连锁/C_dig 模拟，判定逻辑零改动） ----
|
||||||
|
|
||||||
func remove_mines_in(cells: Array) -> Array:
|
func remove_mines_in(cells: Array) -> Array:
|
||||||
@@ -103,7 +103,7 @@ func has_unrevealed() -> bool:
|
|||||||
|
|
||||||
# ---- install（编排边界相位 = 行动经济 Idle/Waiting；Active 拒绝——防轮内换板）----
|
# ---- install（编排边界相位 = 行动经济 Idle/Waiting；Active 拒绝——防轮内换板）----
|
||||||
|
|
||||||
# during_round = 轮内刷新编排路径（2026-09-12 方案 A，战斗结算 唯一调用方）：Active 相位合法——
|
# during_round = 轮内刷新编排路径（战斗结算 唯一调用方）：Active 相位合法——
|
||||||
# 玩家挖掘中立即换图，棋盘状态（revealed/seals）随 install 重置，初始展开事件照发（initial 通道）
|
# 玩家挖掘中立即换图，棋盘状态（revealed/seals）随 install 重置，初始展开事件照发（initial 通道）
|
||||||
func install_board(b: BoardData, during_round := false) -> Dictionary:
|
func install_board(b: BoardData, during_round := false) -> Dictionary:
|
||||||
if action_economy.phase == action_economy.PHASE_ACTIVE and not during_round:
|
if action_economy.phase == action_economy.PHASE_ACTIVE and not during_round:
|
||||||
@@ -138,7 +138,7 @@ func seal_count() -> int:
|
|||||||
return _seals.size()
|
return _seals.size()
|
||||||
|
|
||||||
|
|
||||||
# during_round = 轮内刷新编排路径（2026-09-12 方案 A）：Active 相位合法——换图前退役旧板
|
# during_round = 轮内刷新编排路径：Active 相位合法——换图前退役旧板
|
||||||
func retire_board(during_round := false) -> Dictionary:
|
func retire_board(during_round := false) -> Dictionary:
|
||||||
if _board == null:
|
if _board == null:
|
||||||
return _outcome(true, "executed", "", "") # 幂等受理
|
return _outcome(true, "executed", "", "") # 幂等受理
|
||||||
@@ -267,7 +267,7 @@ func _do_dig(c: Vector2i) -> Dictionary:
|
|||||||
var sub := _board_face_dig(c)
|
var sub := _board_face_dig(c)
|
||||||
if sub != "":
|
if sub != "":
|
||||||
return _outcome(false, "rejected", "board_face", sub)
|
return _outcome(false, "rejected", "board_face", sub)
|
||||||
# 挖封印格（封印不可逆批 2026-09-19）：本格封印事务内隐式退役——链闭包按「本格无封印、其余封印照挡」
|
# 挖封印格（封印不可逆）：本格封印事务内隐式退役——链闭包按「本格无封印、其余封印照挡」
|
||||||
# 计算（封印格为 0 时连锁照常外扩）；request_dig 被拒则封印原地保留（事务性），受理后该封印轮末不判
|
# 计算（封印格为 0 时连锁照常外扩）；request_dig 被拒则封印原地保留（事务性），受理后该封印轮末不判
|
||||||
# （发射面基线 = 在场封印——标中/标空兑付让位于挖掘本体结局，四情况②④）。
|
# （发射面基线 = 在场封印——标中/标空兑付让位于挖掘本体结局，四情况②④）。
|
||||||
var was_sealed := has_seal(c)
|
var was_sealed := has_seal(c)
|
||||||
@@ -295,7 +295,7 @@ func _do_dig(c: Vector2i) -> Dictionary:
|
|||||||
continue # 闭包可穿过已开区——已开格零事件（cell_revealed × |O′ ∖ O|）
|
continue # 闭包可穿过已开区——已开格零事件（cell_revealed × |O′ ∖ O|）
|
||||||
var is_mine := _board.is_mine(rc)
|
var is_mine := _board.is_mine(rc)
|
||||||
var channel := "dig" if rc == c else "chain"
|
var channel := "dig" if rc == c else "chain"
|
||||||
# 格面资源资格（2026-09-15 格面资源批）：chain/dig 恒 true——安全格与危险格一视同仁（危险格亦携带，
|
# 格面资源资格：chain/dig 恒 true——安全格与危险格一视同仁（危险格亦携带，
|
||||||
# 负向兑付归 战斗结算 极性路由）；initial（封锁格）恒 false。资源本体与极性不在本系统。
|
# 负向兑付归 战斗结算 极性路由）；initial（封锁格）恒 false。资源本体与极性不在本系统。
|
||||||
# dug_under_seal = 首格带封印直挖标记（战斗结算 情况④兑付改判消费；连锁格恒 false——连锁不越封印）
|
# dug_under_seal = 首格带封印直挖标记（战斗结算 情况④兑付改判消费；连锁格恒 false——连锁不越封印）
|
||||||
if is_mine:
|
if is_mine:
|
||||||
@@ -325,12 +325,12 @@ func _board_face_dig(c: Vector2i) -> String:
|
|||||||
if is_revealed(c):
|
if is_revealed(c):
|
||||||
return "target_revealed"
|
return "target_revealed"
|
||||||
if _removed.has(c):
|
if _removed.has(c):
|
||||||
return "target_removed" # 迭代 13 T8/D6——中立移除格不可交互（拒绝先于消耗，pattern 1 board_face 腿）
|
return "target_removed" # 中立移除格不可交互（拒绝先于消耗，pattern 1 board_face 腿）
|
||||||
# 封印不拦挖掘（封印不可逆批 2026-09-19）：有封印格直接挖 = 对承诺的兑现，兑付改判归 战斗结算。
|
# 封印不拦挖掘（封印不可逆）：有封印格直接挖 = 对承诺的兑现，兑付改判归 战斗结算。
|
||||||
return ""
|
return ""
|
||||||
|
|
||||||
|
|
||||||
# fx_reveal 效果通道揭示（迭代 20 专长实装批 T1——订阅类「揭示 1 格」效果的棋盘面执行口：
|
# fx_reveal 效果通道揭示（订阅类「揭示 1 格」效果的棋盘面执行口：
|
||||||
# 不经行动经济〔零 AP 消耗零相位要求〕、不要求邻接〔任意揭示〕、只受理安全格〔信息红线=只揭真格，
|
# 不经行动经济〔零 AP 消耗零相位要求〕、不要求邻接〔任意揭示〕、只受理安全格〔信息红线=只揭真格，
|
||||||
# 危险格/已开/出界/移除格=拒绝零副作用〕。连锁与揭示事件与 _do_dig 同构（chain 通道复用），资源兑付归
|
# 危险格/已开/出界/移除格=拒绝零副作用〕。连锁与揭示事件与 _do_dig 同构（chain 通道复用），资源兑付归
|
||||||
# 战斗结算 _flush_pending_reveals 直接入账——channel=fx_reveal 供归因）
|
# 战斗结算 _flush_pending_reveals 直接入账——channel=fx_reveal 供归因）
|
||||||
@@ -400,7 +400,7 @@ func _do_seal_place(c: Vector2i) -> Dictionary:
|
|||||||
elif has_seal(c):
|
elif has_seal(c):
|
||||||
sub = "seal_present"
|
sub = "seal_present"
|
||||||
elif _removed.has(c):
|
elif _removed.has(c):
|
||||||
sub = "target_removed" # 迭代 13 T8/D6——中立移除格不可交互
|
sub = "target_removed" # 中立移除格不可交互
|
||||||
if sub != "":
|
if sub != "":
|
||||||
return _outcome(false, "rejected", "board_face", sub)
|
return _outcome(false, "rejected", "board_face", sub)
|
||||||
if not action_economy.try_spend("seal_place"):
|
if not action_economy.try_spend("seal_place"):
|
||||||
@@ -408,7 +408,7 @@ func _do_seal_place(c: Vector2i) -> Dictionary:
|
|||||||
_seals[c] = true # 封印动作零格子事件外发（发射面封闭；反馈经调用返回值命令式驱动）
|
_seals[c] = true # 封印动作零格子事件外发（发射面封闭；反馈经调用返回值命令式驱动）
|
||||||
if action_economy.phase != action_economy.PHASE_ACTIVE:
|
if action_economy.phase != action_economy.PHASE_ACTIVE:
|
||||||
# 封印动作花完末点 AP 同样终结轮次（行动经济 三出口——AP 用完与动作种类无关；缺漏使 round_end
|
# 封印动作花完末点 AP 同样终结轮次（行动经济 三出口——AP 用完与动作种类无关；缺漏使 round_end
|
||||||
# 永不发出、战斗结算 的 Waiting 结算点永不到达 = 整局软锁。playtest 缺陷②，行为探针复现）
|
# 永不发出、战斗结算 的 Waiting 结算点永不到达 = 整局软锁）
|
||||||
_emit_round_end_seals_and_payload()
|
_emit_round_end_seals_and_payload()
|
||||||
return _outcome(true, "executed", "", "")
|
return _outcome(true, "executed", "", "")
|
||||||
|
|
||||||
@@ -468,8 +468,8 @@ func _do_stop() -> Dictionary:
|
|||||||
# ---- 轮末封印判定 + 棋盘路径 round_end 外发 ----
|
# ---- 轮末封印判定 + 棋盘路径 round_end 外发 ----
|
||||||
|
|
||||||
func _emit_seals_batch() -> void:
|
func _emit_seals_batch() -> void:
|
||||||
# 判定基线 = 轮次结束事务开始时封印位；行主序枚举（确定性——排序键单点 BoardData.row_major_key，
|
# 判定基线 = 轮次结束事务开始时封印位；行主序枚举（确定性——排序键单点 BoardData.row_major_key）；
|
||||||
# 2026-10-02 修复批）；被拔的不判；诚实重复上报（去重归 战斗结算）
|
# 被拔的不判；诚实重复上报（去重归 战斗结算）
|
||||||
var cells: Array[Variant] = _seals.keys()
|
var cells: Array[Variant] = _seals.keys()
|
||||||
cells.sort_custom(func(a, b): return BoardData.row_major_key(a) < BoardData.row_major_key(b))
|
cells.sort_custom(func(a, b): return BoardData.row_major_key(a) < BoardData.row_major_key(b))
|
||||||
for c in cells:
|
for c in cells:
|
||||||
@@ -487,14 +487,14 @@ func _adjacent_to_hero(c: Vector2i) -> bool:
|
|||||||
return maxi(d.x, d.y) == 1
|
return maxi(d.x, d.y) == 1
|
||||||
|
|
||||||
|
|
||||||
# 挖掘可达判据（迭代 22 秘宝批 T3——远程镐 dig_range_bonus 放宽：切比雪夫距离 ≤ 1+加值，
|
# 挖掘可达判据（远程镐 dig_range_bonus 放宽：切比雪夫距离 ≤ 1+加值，
|
||||||
# 加值 0=与旧「恰相邻」逐位一致；开格仍走既有格规则=不挖开不相邻事实之外 anything）
|
# 加值 0=恰相邻；开格仍走既有格规则=不挖开不相邻事实之外 anything）
|
||||||
func _within_dig_range(c: Vector2i) -> bool:
|
func _within_dig_range(c: Vector2i) -> bool:
|
||||||
var d := Vector2i(absi(c.x - _hero.x), absi(c.y - _hero.y))
|
var d := Vector2i(absi(c.x - _hero.x), absi(c.y - _hero.y))
|
||||||
return maxi(d.x, d.y) <= 1 + dig_range_bonus
|
return maxi(d.x, d.y) <= 1 + dig_range_bonus
|
||||||
|
|
||||||
|
|
||||||
# 本板危险格总数（迭代 22 秘宝批 T3——巢穴预告「装板后揭示本板危险格数量」取数口；
|
# 本板危险格总数（巢穴预告「装板后揭示本板危险格数量」取数口；
|
||||||
# 只读投影 BoardData.mines 规模，零分布泄露——数量非位置）
|
# 只读投影 BoardData.mines 规模，零分布泄露——数量非位置）
|
||||||
func mine_total() -> int:
|
func mine_total() -> int:
|
||||||
return _board.mines.size() if _board != null else 0
|
return _board.mines.size() if _board != null else 0
|
||||||
|
|||||||
@@ -16,7 +16,7 @@ var _granted := {} # Vector2i → 快照（重复受理幂等返
|
|||||||
var _clear_identity := ""
|
var _clear_identity := ""
|
||||||
var _clear_granted := false
|
var _clear_granted := false
|
||||||
var _clear_snapshot := {}
|
var _clear_snapshot := {}
|
||||||
# 效果引擎（内容数据驱动扩展批 T1——reward_roll 发射面；偏运硬币 bias_rewards 订阅面）
|
# 效果引擎（reward_roll 发射面；偏运硬币 bias_rewards 订阅面）
|
||||||
var _fx: EffectEngine = null
|
var _fx: EffectEngine = null
|
||||||
|
|
||||||
|
|
||||||
@@ -40,7 +40,7 @@ func roll_board(eligible: Array) -> bool:
|
|||||||
if eligible.is_empty():
|
if eligible.is_empty():
|
||||||
_fatal("roll_board 空资格清单（E1 兜底 fail-fast——排雷玩法 不变式④前置）")
|
_fatal("roll_board 空资格清单（E1 兜底 fail-fast——排雷玩法 不变式④前置）")
|
||||||
return false
|
return false
|
||||||
# 行主序规范化 + 去重（排序责任不外推给 战斗结算；排序键单点 BoardData.row_major_key——2026-10-02 修复批）
|
# 行主序规范化 + 去重（排序责任不外推给 战斗结算；排序键单点 BoardData.row_major_key）
|
||||||
var seen := {}
|
var seen := {}
|
||||||
var list: Array[Dictionary] = []
|
var list: Array[Dictionary] = []
|
||||||
for e in eligible:
|
for e in eligible:
|
||||||
@@ -58,7 +58,7 @@ func roll_board(eligible: Array) -> bool:
|
|||||||
_clear_granted = false
|
_clear_granted = false
|
||||||
_clear_snapshot = {}
|
_clear_snapshot = {}
|
||||||
var stream: RandomNumberGenerator = rng.open_stream("reward_roll") # 恰一 scope 批（格批 + 清图批尾 + 区间行追加取号）
|
var stream: RandomNumberGenerator = rng.open_stream("reward_roll") # 恰一 scope 批（格批 + 清图批尾 + 区间行追加取号）
|
||||||
# reward_roll 发射+施加（内容数据驱动扩展批 T4——格面资源掷定、摇号前权重合成层：
|
# reward_roll 发射+施加（格面资源掷定、摇号前权重合成层：
|
||||||
# bias_rewards 订阅命中合计=偏运权重加算（行 value_from magnitude 定影）；零命中=原行集零扰动）
|
# bias_rewards 订阅命中合计=偏运权重加算（行 value_from magnitude 定影）；零命中=原行集零扰动）
|
||||||
var luck_bias := 0
|
var luck_bias := 0
|
||||||
if _fx != null:
|
if _fx != null:
|
||||||
@@ -124,7 +124,7 @@ func query_full_snapshot(cell: Vector2i):
|
|||||||
return _snapshot(_row_by_id(rid), int(_power_roll.get(cell, -1)))
|
return _snapshot(_row_by_id(rid), int(_power_roll.get(cell, -1)))
|
||||||
|
|
||||||
|
|
||||||
# ---- 受理面（战斗结算 编排期调用；E6 收口 2026-09-13：失败统一返回 null）----
|
# ---- 受理面（战斗结算 编排期调用；E6 收口：失败统一返回 null）----
|
||||||
|
|
||||||
func grant(cell: Vector2i):
|
func grant(cell: Vector2i):
|
||||||
if _phase != "ready":
|
if _phase != "ready":
|
||||||
@@ -180,12 +180,11 @@ func polarity_row(cell_type: String, polarity: String) -> Dictionary:
|
|||||||
|
|
||||||
# ---- F1 选行算子纯函数 ----
|
# ---- F1 选行算子纯函数 ----
|
||||||
|
|
||||||
# 偏运硬币 N（迭代 11 同调批 T5 → 内容数据驱动扩展批 T4：begin_battle 注入拆除——
|
# 偏运硬币 N（reward_roll bias_rewards 订阅命中合计经 _biased_cell_rows 入参；0 = 未装配零扰动）
|
||||||
# reward_roll bias_rewards 订阅命中合计经 _biased_cell_rows 入参；0 = 未装配零扰动）
|
|
||||||
# 稀有正向资源 kinds（底稿 §3——权重投影面，池结构零触碰）
|
# 稀有正向资源 kinds（底稿 §3——权重投影面，池结构零触碰）
|
||||||
const LUCK_BIAS_KINDS := ["heal", "gp", "pierce", "magic"]
|
const LUCK_BIAS_KINDS := ["heal", "gp", "pierce", "magic"]
|
||||||
|
|
||||||
# 图级偏斜旋钮（全局作用域变异首发批 2026-10-04——battle_orchestrator 装板决议注入，全局型行
|
# 图级偏斜旋钮（battle_orchestrator 装板决议注入，全局型行
|
||||||
# effect_value 语义=生存族权重下调百分比；0 = 中性 off 态。每板决议时显式重置/写入）
|
# effect_value 语义=生存族权重下调百分比；0 = 中性 off 态。每板决议时显式重置/写入）
|
||||||
var board_skew: int = 0
|
var board_skew: int = 0
|
||||||
|
|
||||||
@@ -196,7 +195,7 @@ const SKEW_UP_KINDS := ["attack", "blast", "pierce", "magic"]
|
|||||||
|
|
||||||
|
|
||||||
# 偏运硬币权重投影（底稿 §3：只动池内权重、雷安仍同池同分布；luck_bias=0 逐位返回原行集——off 态零扰动）
|
# 偏运硬币权重投影（底稿 §3：只动池内权重、雷安仍同池同分布；luck_bias=0 逐位返回原行集——off 态零扰动）
|
||||||
# 基座换源（首发批 2026-10-04）：先经图级偏斜投影再叠件级加法——合成序锚=图级先、件级后
|
# 合成序：先经图级偏斜投影再叠件级加法——合成序锚=图级先、件级后
|
||||||
#（环境事实先定型、玩家构筑叠其上；两投影均为池内权重面，雷安同池与取号次数零变化）
|
#（环境事实先定型、玩家构筑叠其上；两投影均为池内权重面，雷安同池与取号次数零变化）
|
||||||
func _biased_cell_rows(bias: int) -> Array:
|
func _biased_cell_rows(bias: int) -> Array:
|
||||||
var base: Array[Variant] = _skewed_cell_rows()
|
var base: Array[Variant] = _skewed_cell_rows()
|
||||||
@@ -213,7 +212,7 @@ func _biased_cell_rows(bias: int) -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# 图级资源面偏斜投影（首发批 T3——整数最大余数法：生存族按 board_skew% 下调，下调量按进攻族
|
# 图级资源面偏斜投影（整数最大余数法：生存族按 board_skew% 下调，下调量按进攻族
|
||||||
# 原权重比例整数重分配，合计恒等于原池合计 77；负向行与白名单三行逐位不动）。
|
# 原权重比例整数重分配，合计恒等于原池合计 77；负向行与白名单三行逐位不动）。
|
||||||
# board_skew<=0 逐位返回原行集 = off 态零扰动第一断言：不进投影域、行集/行序/取号域与基线逐位同。
|
# board_skew<=0 逐位返回原行集 = off 态零扰动第一断言：不进投影域、行集/行序/取号域与基线逐位同。
|
||||||
func _skewed_cell_rows() -> Array:
|
func _skewed_cell_rows() -> Array:
|
||||||
@@ -300,7 +299,7 @@ func weighted_pick(rows: Array, r: int) -> String:
|
|||||||
return ""
|
return ""
|
||||||
|
|
||||||
|
|
||||||
# aux 解锁门控集（迭代 7 T5——拍板③甲「解锁→进投放池」：未解锁 aux 行不入摇号池。
|
# aux 解锁门控集（「解锁→进投放池」：未解锁 aux 行不入摇号池。
|
||||||
# 空集默认 = 全部 aux 不投放（白板/夹具态零投放——模拟读数零扰动；真实侧 main 组装工坊解锁集传入）
|
# 空集默认 = 全部 aux 不投放（白板/夹具态零投放——模拟读数零扰动；真实侧 main 组装工坊解锁集传入）
|
||||||
var _treasure_unlocked := {}
|
var _treasure_unlocked := {}
|
||||||
|
|
||||||
|
|||||||
@@ -5,8 +5,8 @@
|
|||||||
class_name RngServiceCore
|
class_name RngServiceCore
|
||||||
extends Node
|
extends Node
|
||||||
|
|
||||||
# 用途标签封闭词表（并流前七流名全保留；新增用途走扩签通道 = 改代码 + 评审——清单封闭语义由「流」改「标签」）
|
# 用途标签封闭词表（流名清单封闭；新增用途走扩签通道 = 改代码 + 评审）
|
||||||
const PURPOSE_TAGS := ["board_gen", "reward_roll", "encounter", "armor_roll", "behavior_roll", "variant_place", "gp_drop", "node_map", "reward_pick", "shop_draw", "fx_reveal"] # node_map = 关卡节点图生成 v0.4 扩签（M-3 迭代 5 T5）；reward_pick = 提升三选一加权洗牌扩签（M-3 迭代 10 奖励重构批——每关大奖励抽签恰一 scope：E-S weight-key 每候选一取，标签不参与派生只进事件日志，派生/黄金向量零改动）；shop_draw = 商店房货架抽签扩签（M-4 迭代 11 第②批 T1——每次抽 3〔进店+每次买后重抽〕恰一 scope，与 reward_pick 分签防取数序互扰；shop=off 零消费零扰动）；fx_reveal = 专长订阅类揭示效果掷格（迭代 20 T1——见血开窍/斩首学者等「揭示 1 格」，与 reward_pick 分签防取数序互扰；只揭真格=安全格信息红线承载）
|
const PURPOSE_TAGS := ["board_gen", "reward_roll", "encounter", "armor_roll", "behavior_roll", "variant_place", "gp_drop", "node_map", "reward_pick", "shop_draw", "fx_reveal"] # node_map = 关卡节点图生成 v0.4 扩签；reward_pick = 提升三选一加权洗牌扩签（每关大奖励抽签恰一 scope：E-S weight-key 每候选一取，标签不参与派生只进事件日志，派生/黄金向量零改动）；shop_draw = 商店房货架抽签扩签（每次抽 3〔进店+每次买后重抽〕恰一 scope，与 reward_pick 分签防取数序互扰；shop=off 零消费零扰动）；fx_reveal = 专长订阅类揭示效果掷格（见血开窍/斩首学者等「揭示 1 格」，与 reward_pick 分签防取数序互扰；只揭真格=安全格信息红线承载）
|
||||||
|
|
||||||
# 分段表达式书写（数据配置 R3 实现级规约——禁 ≥2^63 完整字面量）
|
# 分段表达式书写（数据配置 R3 实现级规约——禁 ≥2^63 完整字面量）
|
||||||
const GOLDEN_RATIO := (0x9E3779B9 << 32) | 0x7F4A7C15 # 0x9E3779B97F4A7C15
|
const GOLDEN_RATIO := (0x9E3779B9 << 32) | 0x7F4A7C15 # 0x9E3779B97F4A7C15
|
||||||
@@ -18,7 +18,7 @@ const MIX_MUL_B := (0x94D049BB << 32) | 0x133111EB # 0x94D049BB133111EB
|
|||||||
const OUT_MASK := 0x7FFFFFFFFFFFFFFF
|
const OUT_MASK := 0x7FFFFFFFFFFFFFFF
|
||||||
const INT64_MIN := -9223372036854775808
|
const INT64_MIN := -9223372036854775808
|
||||||
|
|
||||||
# master_seed 只读出口（E5 封装收口 2026-09-13）：写入只经 set_master_seed（计数器全零断言
|
# master_seed 只读出口（E5 封装收口）：写入只经 set_master_seed（计数器全零断言
|
||||||
# 不可绕过）；外部读 master_seed 供 存档序列化 快照契约观测。
|
# 不可绕过）；外部读 master_seed 供 存档序列化 快照契约观测。
|
||||||
var _master_seed: int = -1 # -1 = 未播种（取数即致命，EC7）
|
var _master_seed: int = -1 # -1 = 未播种（取数即致命，EC7）
|
||||||
var master_seed: int:
|
var master_seed: int:
|
||||||
@@ -30,16 +30,16 @@ var _log_fa: FileAccess = null
|
|||||||
var _log_warned := false
|
var _log_warned := false
|
||||||
|
|
||||||
|
|
||||||
# 纯函数（测试/预览/日志回放入口，不推计数器）——单盐单参数（并流前 (流, scope) 双参退役）
|
# 纯函数（测试/预览/日志回放入口，不推计数器）——单盐单参数
|
||||||
func derive_at(scope: int) -> int:
|
func derive_at(scope: int) -> int:
|
||||||
assert(scope >= 0, "负 scope 与 scope+2^63 经输出掩码别名（禁止）")
|
assert(scope >= 0, "负 scope 与 scope+2^63 经输出掩码别名（禁止）")
|
||||||
var t: int = _master_seed + scope * GOLDEN_RATIO # wrap64 自然回绕——禁 float 中间量/禁 %/禁主动修复
|
var t: int = _master_seed + scope * GOLDEN_RATIO # wrap64 自然回绕——禁 float 中间量/禁 %/禁主动修复
|
||||||
return _mix64(SINGLE_SALT ^ t)
|
return _mix64(SINGLE_SALT ^ t)
|
||||||
|
|
||||||
|
|
||||||
# R3 派生终末混淆（splitmix64 finalizer 变体，2026-09-19 掷点测量修复批 B 案）：裸派生种子直接作
|
# R3 派生终末混淆（splitmix64 finalizer 变体）：裸派生种子直接作
|
||||||
# PCG 初始状态时，「连续小整数 master × 头部 scope 窗口」的面值彩票会被短局复用放大进聚合统计
|
# PCG 初始状态时，「连续小整数 master × 头部 scope 窗口」的面值彩票会被短局复用放大进聚合统计
|
||||||
# （验收重测批实证：30 连续种子 × 头部窗口 × 40 局复用 → 18 点聚合 +57%）；此混淆使任何窄种子窗
|
# （30 连续种子 × 头部窗口 × 40 局复用 → 18 点聚合 +57%）；此混淆使任何窄种子窗
|
||||||
# 表现如随机抽样。纯函数、逐 scope 复放语义不变；全程 OUT_MASK 63 位掩码——有符号 int64 的 >>
|
# 表现如随机抽样。纯函数、逐 scope 复放语义不变；全程 OUT_MASK 63 位掩码——有符号 int64 的 >>
|
||||||
# 为算术移位，63 位正值域内与逻辑移位逐位一致，这是与参考实现（Python 无符号模型）对齐的关键。
|
# 为算术移位，63 位正值域内与逻辑移位逐位一致，这是与参考实现（Python 无符号模型）对齐的关键。
|
||||||
func _mix64(z: int) -> int:
|
func _mix64(z: int) -> int:
|
||||||
@@ -63,14 +63,14 @@ func set_master_seed(seed_val: int) -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 切片登记：冒险开始重播种入口（正式侧调用权归 冒险结构；切片主菜单 = 冒险起点）——
|
# 切片登记：冒险开始重播种入口（正式侧调用权归 冒险结构；切片主菜单 = 冒险起点）——
|
||||||
# 并流批（2026-09-27 统一流裁决）：重播种同时开本次冒险的事件日志会话。
|
# 重播种同时开本次冒险的事件日志会话。
|
||||||
func new_adventure(seed_val: int) -> void:
|
func new_adventure(seed_val: int) -> void:
|
||||||
_counter = 0
|
_counter = 0
|
||||||
set_master_seed(seed_val)
|
set_master_seed(seed_val)
|
||||||
_open_log_session(_master_seed)
|
_open_log_session(_master_seed)
|
||||||
|
|
||||||
|
|
||||||
# 断点续玩恢复入口（迭代 8 卡①——快照契约「主种子+计数器」的回填面，调用权归 冒险结构）：
|
# 断点续玩恢复入口（快照契约「主种子+计数器」的回填面，调用权归 冒险结构）：
|
||||||
# 回填后首个 open_stream(scope=counter_val) 的派生种子与中断前逐位一致——续玩从断点号位精确
|
# 回填后首个 open_stream(scope=counter_val) 的派生种子与中断前逐位一致——续玩从断点号位精确
|
||||||
# 续接原时间线（停点前已消耗的号位不重耗，停点后取数逐位可复现）。仅续玩路径调用；模拟/冒烟
|
# 续接原时间线（停点前已消耗的号位不重耗，停点后取数逐位可复现）。仅续玩路径调用；模拟/冒烟
|
||||||
# 零触达（MC 对拍零扰动）。
|
# 零触达（MC 对拍零扰动）。
|
||||||
|
|||||||
@@ -1,15 +1,15 @@
|
|||||||
class_name RunLedger
|
class_name RunLedger
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# 共享四本账显式承载（迭代 27 T3——审计 P1-4「共享可变字典跨三层：所有权名义单点、实际三处
|
# 共享四本账显式承载（审计 P1-4「共享可变字典跨三层：所有权名义单点、实际三处
|
||||||
# 可写」收口；裁点②甲 = 单类持四账）。
|
# 可写」收口 = 单类持四账）。
|
||||||
# 所有权：AdventureRunner 持有（开局构造、冒险全程唯一宿主）；LevelRunner 经 set_run_ledger
|
# 所有权：AdventureRunner 持有（开局构造、冒险全程唯一宿主）；LevelRunner 经 set_run_ledger
|
||||||
# 下传并装配 encounter；战斗侧（BattleOrchestrator）经 encounter["ledger"] 拿本类引用，
|
# 下传并装配 encounter；战斗侧（BattleOrchestrator）经 encounter["ledger"] 拿本类引用，
|
||||||
# 只走下方 read/append 原语——战末 export/开局 seed 时点语义不变（确定性设计原样保留，
|
# 只走下方 read/append 原语——战末 export/开局 seed 时点语义不变（确定性设计原样保留，
|
||||||
# 只把「函数签名上不可见的共享可变引用」换成签名可见的显式类）。
|
# 只把「函数签名上不可见的共享可变引用」换成签名可见的显式类）。
|
||||||
var attune_charges: Dictionary[Variant, Variant] = {} # 同调主动件充能账（迭代 11 第①批 T6——use_treasure 扣减；断点随局回档）
|
var attune_charges: Dictionary[Variant, Variant] = {} # 同调主动件充能账（use_treasure 扣减；断点随局回档）
|
||||||
var vision_counter: Dictionary[Variant, Variant] = {} # 真视类使用计数（迭代 22 秘宝批 T3——冒险开始置 {"used":0}；
|
var vision_counter: Dictionary[Variant, Variant] = {} # 真视类使用计数（冒险开始置 {"used":0}；
|
||||||
# 缺省空 = 调试/单场战斗不计——原 enc 缺键守卫语义）
|
# 缺省空 = 调试/单场战斗不计——enc 缺键守卫语义）
|
||||||
var adventure_counters: Dictionary[Variant, Variant] = {} # adventure 域效果计数器（迭代 20 T6——rebuild 回灌/战末导出回写目标）
|
var adventure_counters: Dictionary[Variant, Variant] = {} # adventure 域效果计数器（rebuild 回灌/战末导出回写目标）
|
||||||
var bonus: Dictionary[Variant, Variant] = {} # 统一冒险加算区（冒险开始置四轴零账——商店购买/三选一属性件/战末 bonus_delta 汇入）
|
var bonus: Dictionary[Variant, Variant] = {} # 统一冒险加算区（冒险开始置四轴零账——商店购买/三选一属性件/战末 bonus_delta 汇入）
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
+39
-39
@@ -6,10 +6,10 @@
|
|||||||
class_name SaveManagerCore
|
class_name SaveManagerCore
|
||||||
extends Node
|
extends Node
|
||||||
|
|
||||||
const SAVE_FORMAT_VERSION := 7 # registry schema_version：v7=锻造工坊域（迭代 23 T5——meta 新域 forge_routes〔六路线等级 levels+直购解锁清单 unlocked+当前武器/甲选中标记 weapon/armor；无特效域——裁 6 满级特效本期不做〕，旧档缺键由 _normalize 按默认补齐=初始持有态〔sword/light 在档余四锁、选中=初始路线〕，v6→v7 空迁移=缺键补齐模式——v3→v4 先例）；v6=生涯终身计数域（迭代 18 卡④——meta 两新域 adventure_total〔冒险总局数，开局即计含放弃与失败〕/adventure_cleared〔通关局数，三关全通才计 1——判定字段 summary.cleared〕，旧档缺键由 _normalize 按默认补零，收束自增唯一入账=apply_adventure_summary）；v5=天赋树域（迭代 12 T9——meta 三新域 tree_nodes〔node_id→已购等级〕/fork_sides〔fork_group→a|b〕/migration_note〔三体系迁移补偿注记〕——M-4 迭代 12 批次二；需求卡片「v3→v4」系同调批未落时行文，v4 已被同调批占用顺延 v5 披露）；v4=同调批扩域（meta 三新域 boss_kill_count/attunement_equipped/attune_refresh_level——M-4 迭代 11 第①批 T2；断点充能余量随 T6 接线，旧档缺键 = 合法空态）；v3=断点附随件扩列+摘要 keystone_drops（M-3 迭代 10 奖励重构）；v2=断点域出生（M-3 迭代 8 卡①）；v1=首版；高版本拒读 owner=存档序列化
|
const SAVE_FORMAT_VERSION := 7 # registry schema_version：v7=锻造工坊域（meta 新域 forge_routes〔六路线等级 levels+直购解锁清单 unlocked+当前武器/甲选中标记 weapon/armor；无特效域〕，旧档缺键由 _normalize 按默认补齐=初始持有态〔sword/light 在档余四锁、选中=初始路线〕，v6→v7 空迁移=缺键补齐模式）；v6=生涯终身计数域（meta 两新域 adventure_total〔冒险总局数，开局即计含放弃与失败〕/adventure_cleared〔通关局数，三关全通才计 1——判定字段 summary.cleared〕，旧档缺键由 _normalize 按默认补零，收束自增唯一入账=apply_adventure_summary）；v5=天赋树域（meta 三新域 tree_nodes〔node_id→已购等级〕/fork_sides〔fork_group→a|b〕/migration_note〔三体系迁移补偿注记〕）；v4=同调位域（meta 三新域 boss_kill_count/attunement_equipped/attune_refresh_level——旧档缺键 = 合法空态）；v3=断点附随件扩列+摘要 keystone_drops；v2=断点域出生；v1=首版；高版本拒读 owner=存档序列化
|
||||||
const SUMMARY_CAP := 10 # 最近冒险摘要保留条数（最新在前）
|
const SUMMARY_CAP := 10 # 最近冒险摘要保留条数（最新在前）
|
||||||
|
|
||||||
const TREE_STRUCT_VERSION := 2 # 树结构版本标记（迭代 21 T5——12 节点 v0.8 结构；加载检测缺失
|
const TREE_STRUCT_VERSION := 2 # 树结构版本标记（12 节点 v0.8 结构；加载检测缺失
|
||||||
# 或更低 = 换代前结构 → 树域破坏性废弃重置〔契约 4：禁迁移禁折算〕）
|
# 或更低 = 换代前结构 → 树域破坏性废弃重置〔契约 4：禁迁移禁折算〕）
|
||||||
|
|
||||||
var _path: String # 存档文件路径（默认 user://save.json；冒烟注入隔离路径）
|
var _path: String # 存档文件路径（默认 user://save.json；冒烟注入隔离路径）
|
||||||
@@ -30,14 +30,14 @@ func _init(path: String = "user://save.json") -> void:
|
|||||||
register_migration(6, _migrate_v6_v7)
|
register_migration(6, _migrate_v6_v7)
|
||||||
|
|
||||||
|
|
||||||
# autoload 生命周期（迭代 27 T1 裁点①——SaveManager 升格跨场景持有者，RngService 先例：
|
# autoload 生命周期（SaveManager 为跨场景持有者，仿 RngService 先例：
|
||||||
# 类名加 Core 后缀、autoload 占净名；读盘挂 _ready=autoload 先于主场景就绪，时序与旧
|
# 类名加 Core 后缀、autoload 占净名；读盘挂 _ready=autoload 先于主场景就绪）。独立
|
||||||
# main._ready 读盘等价）。独立 .new() 实例（单测/工具）不入树零 _ready，读盘仍由调用方显式触发。
|
# .new() 实例（单测/工具）不入树零 _ready，读盘仍由调用方显式触发。
|
||||||
func _ready() -> void:
|
func _ready() -> void:
|
||||||
load_from_disk()
|
load_from_disk()
|
||||||
|
|
||||||
|
|
||||||
# 原地重置（迭代 27 T1——探针隔离面，沿 RngService.set_master_seed 单例原地重置先例：
|
# 原地重置（探针隔离面，仿 RngService.set_master_seed 单例原地重置：
|
||||||
# 换路径+回默认数据+重读盘；对象引用恒定，MetaProgression 持有的 save 引用零失效）
|
# 换路径+回默认数据+重读盘；对象引用恒定，MetaProgression 持有的 save 引用零失效）
|
||||||
func attach_path(path: String) -> void:
|
func attach_path(path: String) -> void:
|
||||||
_path = path
|
_path = path
|
||||||
@@ -54,25 +54,25 @@ func _migrate_v1_v2(data: Dictionary) -> Dictionary:
|
|||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
# v2→v3：断点附随件扩列（迭代 10 奖励重构批——bonus_taken/bonus_pending/bonus_result/
|
# v2→v3：断点附随件扩列（bonus_taken/bonus_pending/bonus_result/
|
||||||
# keystone_drops + bonus.ap 轴）与摘要 additive 键 keystone_drops——旧档缺键〔bonus_aux_carry 键随迭代 22 T5 替换子交互拆除退役〕
|
# keystone_drops + bonus.ap 轴）与摘要 additive 键 keystone_drops——旧档缺键
|
||||||
# = 合法空态（读取方 .get 兜底），无结构迁移体；版本号推进仅为 schema_version 对齐
|
# = 合法空态（读取方 .get 兜底），无结构迁移体；版本号推进仅为 schema_version 对齐
|
||||||
func _migrate_v2_v3(data: Dictionary) -> Dictionary:
|
func _migrate_v2_v3(data: Dictionary) -> Dictionary:
|
||||||
data["version"] = SAVE_FORMAT_VERSION
|
data["version"] = SAVE_FORMAT_VERSION
|
||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
# v3→v4：同调批扩域（迭代 11 第①批 T2——meta 三新域 boss_kill_count/attunement_equipped/
|
# v3→v4：同调位域（meta 三新域 boss_kill_count/attunement_equipped/
|
||||||
# attune_refresh_level，旧档缺键由 _normalize 按默认补齐，无结构迁移体；版本号推进仅为
|
# attune_refresh_level，旧档缺键由 _normalize 按默认补齐，无结构迁移体；版本号推进仅为
|
||||||
# schema_version 对齐——v2→v3 先例）
|
# schema_version 对齐）
|
||||||
func _migrate_v3_v4(data: Dictionary) -> Dictionary:
|
func _migrate_v3_v4(data: Dictionary) -> Dictionary:
|
||||||
data["version"] = SAVE_FORMAT_VERSION
|
data["version"] = SAVE_FORMAT_VERSION
|
||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
# v4→v5：天赋树域（迭代 12 T9 建域——meta 三新域 tree_nodes/fork_sides/migration_note，缺键默认
|
# v4→v5：天赋树域（meta 三新域 tree_nodes/fork_sides/migration_note，缺键默认
|
||||||
# 补齐；迭代 21 T5 换代：原「三体系迁移」映射体随 migrate_tree 一并删除——开发阶段破坏性废弃
|
# 补齐；开发阶段破坏性废弃口径：换代前结构由 _normalize 的 tree_struct 标记检测废弃重置，
|
||||||
# 〔Q3 用户裁〕，换代前结构由 _normalize 的 tree_struct 标记检测废弃重置，本函数只剩缺键补齐）。
|
# 本函数只做缺键补齐）。
|
||||||
func _migrate_v4_v5(data: Dictionary) -> Dictionary:
|
func _migrate_v4_v5(data: Dictionary) -> Dictionary:
|
||||||
var meta: Dictionary[Variant, Variant] = data.get("meta", {}) as Dictionary
|
var meta: Dictionary[Variant, Variant] = data.get("meta", {}) as Dictionary
|
||||||
if not meta.has("tree_nodes"):
|
if not meta.has("tree_nodes"):
|
||||||
@@ -83,17 +83,17 @@ func _migrate_v4_v5(data: Dictionary) -> Dictionary:
|
|||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
# v5→v6：生涯终身计数域（迭代 18 卡④——meta 两新域 adventure_total/adventure_cleared，旧档缺键
|
# v5→v6：生涯终身计数域（meta 两新域 adventure_total/adventure_cleared，旧档缺键
|
||||||
# 由 _normalize 按默认补零，无结构迁移体；版本号推进仅为 schema_version 对齐——v3→v4 先例。
|
# 由 _normalize 按默认补零，无结构迁移体；版本号推进仅为 schema_version 对齐。
|
||||||
# 幂等性：重复迁移只覆写 version，既有值零改动；加载后 _normalize 补齐缺省——旧档可载可玩）
|
# 幂等性：重复迁移只覆写 version，既有值零改动；加载后 _normalize 补齐缺省——旧档可载可玩）
|
||||||
func _migrate_v5_v6(data: Dictionary) -> Dictionary:
|
func _migrate_v5_v6(data: Dictionary) -> Dictionary:
|
||||||
data["version"] = SAVE_FORMAT_VERSION
|
data["version"] = SAVE_FORMAT_VERSION
|
||||||
return data
|
return data
|
||||||
|
|
||||||
|
|
||||||
# v6→v7：锻造工坊域（迭代 23 T5——meta 新域 forge_routes，旧档缺键由 _normalize 按默认补齐=
|
# v6→v7：锻造工坊域（meta 新域 forge_routes，旧档缺键由 _normalize 按默认补齐=
|
||||||
# 初始持有态〔开发阶段无迁移禁折算——契约 4〕，无结构迁移体；版本号推进仅为 schema_version 对齐
|
# 初始持有态〔开发阶段无迁移禁折算——契约 4〕，无结构迁移体；版本号推进仅为 schema_version 对齐
|
||||||
# ——v3→v4 先例。幂等性：重复迁移只覆写 version，既有值零改动；加载后 _normalize 补齐缺省——旧档可载可玩）
|
# 幂等性：重复迁移只覆写 version，既有值零改动；加载后 _normalize 补齐缺省——旧档可载可玩）
|
||||||
func _migrate_v6_v7(data: Dictionary) -> Dictionary:
|
func _migrate_v6_v7(data: Dictionary) -> Dictionary:
|
||||||
data["version"] = SAVE_FORMAT_VERSION
|
data["version"] = SAVE_FORMAT_VERSION
|
||||||
return data
|
return data
|
||||||
@@ -112,27 +112,27 @@ func _default_data() -> Dictionary[String, Variant]:
|
|||||||
"boss_kill_count": 0,
|
"boss_kill_count": 0,
|
||||||
"attunement_equipped": [],
|
"attunement_equipped": [],
|
||||||
"attune_refresh_level": 0,
|
"attune_refresh_level": 0,
|
||||||
"tree_nodes": {}, # 天赋树已购等级（node_id→int——迭代 12 T9 建域）
|
"tree_nodes": {}, # 天赋树已购等级（node_id→int）
|
||||||
"fork_sides": {}, # Fork 激活态（fork_group→"a"|"b"——一节点双态切换承载，迭代 21 收编语义）
|
"fork_sides": {}, # Fork 激活态（fork_group→"a"|"b"——一节点双态切换承载）
|
||||||
"tree_struct": TREE_STRUCT_VERSION, # 树结构版本标记（迭代 21 T5——缺失=换代前结构，加载废弃重置）
|
"tree_struct": TREE_STRUCT_VERSION, # 树结构版本标记（缺失=换代前结构，加载废弃重置）
|
||||||
"recent_summaries": [],
|
"recent_summaries": [],
|
||||||
"first_adventure_done": false,
|
"first_adventure_done": false,
|
||||||
"adventure_total": 0, # 生涯终身计数·冒险总局数（迭代 18 卡④——开局即计含放弃与失败，收束唯一入账）
|
"adventure_total": 0, # 生涯终身计数·冒险总局数（开局即计含放弃与失败，收束唯一入账）
|
||||||
"adventure_cleared": 0, # 生涯终身计数·通关局数（三关全通才计 1——判定字段 summary.cleared）
|
"adventure_cleared": 0, # 生涯终身计数·通关局数（三关全通才计 1——判定字段 summary.cleared）
|
||||||
"vision_used": 0, # 生涯终身计数·真视类工具累计使用次数（迭代 22 T2——信标网络解锁行为条件；
|
"vision_used": 0, # 生涯终身计数·真视类工具累计使用次数（信标网络解锁行为条件；
|
||||||
# 受理成功唯一计数点=battle 层经冒险层聚合、收束入账；缺键补零不升版本——迭代 21 先例）
|
# 受理成功唯一计数点=battle 层经冒险层聚合、收束入账；缺键补零不升版本）
|
||||||
"forge_routes": { # 锻造工坊域（迭代 23 T5——六路线等级+直购解锁清单+当前选中标记；无特效域）
|
"forge_routes": { # 锻造工坊域（六路线等级+直购解锁清单+当前选中标记；无特效域）
|
||||||
"levels": {"sword": 0, "spear": 0, "staff": 0, "light": 0, "heavy": 0, "ward": 0},
|
"levels": {"sword": 0, "spear": 0, "staff": 0, "light": 0, "heavy": 0, "ward": 0},
|
||||||
"unlocked": [], # 直购解锁路线 id 清单（初始持有与练满前一档=派生解锁不落档）
|
"unlocked": [], # 直购解锁路线 id 清单（初始持有与练满前一档=派生解锁不落档）
|
||||||
"weapon": "sword", # 当前选中武器路线（初始持有=sword）
|
"weapon": "sword", # 当前选中武器路线（初始持有=sword）
|
||||||
"armor": "light", # 当前选中甲路线（初始持有=light）
|
"armor": "light", # 当前选中甲路线（初始持有=light）
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
"breakpoint": {}, # 冒险断点快照（空 = 无断点合法态——「继续上局」隐藏；迭代 8 卡①）
|
"breakpoint": {}, # 冒险断点快照（空 = 无断点合法态——「继续上局」隐藏）
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
# ---- 首次冒险布尔位（关卡节点图生成 v0.4——唯一新增存档字段，M-3 迭代 5 T5）----
|
# ---- 首次冒险布尔位（关卡节点图生成 v0.4）----
|
||||||
# false = 首次脚本模式（全关零抽签取池内模板 0=现行固定图）；置位只在冒险收束挂点（MetaProgression.settle_adventure）。
|
# false = 首次脚本模式（全关零抽签取池内模板 0=现行固定图）；置位只在冒险收束挂点（MetaProgression.settle_adventure）。
|
||||||
# 老档迁移：缺字段 = 该档已有游玩史 → true（不重放教学脚本）。
|
# 老档迁移：缺字段 = 该档已有游玩史 → true（不重放教学脚本）。
|
||||||
|
|
||||||
@@ -243,7 +243,7 @@ func boss_first_kill_marked(level_index: int) -> bool:
|
|||||||
return _data["meta"]["boss_first_kill"].has(str(level_index))
|
return _data["meta"]["boss_first_kill"].has(str(level_index))
|
||||||
|
|
||||||
|
|
||||||
# ---- 同调位账本域（迭代 11 第①批 T2——里程碑谓词表计数源 + 装配关系 + Y 升级态）----
|
# ---- 同调位账本域（里程碑谓词表计数源 + 装配关系 + Y 升级态）----
|
||||||
|
|
||||||
# Boss 击杀总数（含重复——底稿裁决 4 计数源；收束入账 = apply_adventure_summary 逐通关关次 +1，
|
# Boss 击杀总数（含重复——底稿裁决 4 计数源；收束入账 = apply_adventure_summary 逐通关关次 +1，
|
||||||
# Boss 恒唯一终点故 levels_cleared 即本次冒险 Boss 击杀数）
|
# Boss 恒唯一终点故 levels_cleared 即本次冒险 Boss 击杀数）
|
||||||
@@ -251,7 +251,7 @@ func boss_kill_count() -> int:
|
|||||||
return int(_data["meta"].get("boss_kill_count", 0))
|
return int(_data["meta"].get("boss_kill_count", 0))
|
||||||
|
|
||||||
|
|
||||||
# ---- 生涯终身计数域（迭代 18 卡④——跨局汇总页数据源；只读面经访问器，
|
# ---- 生涯终身计数域（跨局汇总页数据源；只读面经访问器，
|
||||||
# 写入唯一经 apply_adventure_summary 收束口，禁第二写入点）----
|
# 写入唯一经 apply_adventure_summary 收束口，禁第二写入点）----
|
||||||
|
|
||||||
# 冒险总局数（口径=开局即计：三结局 completed/failed/abandoned 同经收束恰计一次，含放弃与失败）
|
# 冒险总局数（口径=开局即计：三结局 completed/failed/abandoned 同经收束恰计一次，含放弃与失败）
|
||||||
@@ -265,7 +265,7 @@ func adventure_cleared() -> int:
|
|||||||
return int(_data["meta"].get("adventure_cleared", 0))
|
return int(_data["meta"].get("adventure_cleared", 0))
|
||||||
|
|
||||||
|
|
||||||
# 真视类工具累计使用次数（迭代 22 T2——信标网络解锁行为条件；写入唯一经 add_vision_used
|
# 真视类工具累计使用次数（信标网络解锁行为条件；写入唯一经 add_vision_used
|
||||||
# 冒险收束聚合入账，受理计数点=battle 层经冒险层聚合）
|
# 冒险收束聚合入账，受理计数点=battle 层经冒险层聚合）
|
||||||
func vision_used() -> int:
|
func vision_used() -> int:
|
||||||
return int(_data["meta"].get("vision_used", 0))
|
return int(_data["meta"].get("vision_used", 0))
|
||||||
@@ -275,7 +275,7 @@ func add_vision_used(n: int) -> void:
|
|||||||
_data["meta"]["vision_used"] = maxi(0, vision_used() + maxi(0, n))
|
_data["meta"]["vision_used"] = maxi(0, vision_used() + maxi(0, n))
|
||||||
|
|
||||||
|
|
||||||
# ---- 天赋树域（迭代 12 T9——MetaProgression 树段读写面）----
|
# ---- 天赋树域（MetaProgression 树段读写面）----
|
||||||
|
|
||||||
func tree_nodes() -> Dictionary:
|
func tree_nodes() -> Dictionary:
|
||||||
return (_data["meta"].get("tree_nodes", {}) as Dictionary).duplicate()
|
return (_data["meta"].get("tree_nodes", {}) as Dictionary).duplicate()
|
||||||
@@ -305,7 +305,7 @@ func set_fork_side(group: String, side: String) -> void:
|
|||||||
_data["meta"]["fork_sides"] = fs
|
_data["meta"]["fork_sides"] = fs
|
||||||
|
|
||||||
|
|
||||||
# ---- 锻造工坊域 forge_routes（迭代 23 T5——MetaProgression 锻造写口读写面；无特效域）----
|
# ---- 锻造工坊域 forge_routes（MetaProgression 锻造写口读写面；无特效域）----
|
||||||
# 解锁态不落档（派生）：初始持有=表 initial_owned、练满前一档=levels[prereq]≥cap——判定单点在
|
# 解锁态不落档（派生）：初始持有=表 initial_owned、练满前一档=levels[prereq]≥cap——判定单点在
|
||||||
# MetaProgression.forge_route_unlocked（读表+读档）；本类只承载直购清单 unlocked 与选中标记。
|
# MetaProgression.forge_route_unlocked（读表+读档）；本类只承载直购清单 unlocked 与选中标记。
|
||||||
# 域结构：{levels:{六路线 id→等级}, unlocked:[直购路线 id], weapon:当前武器路线 id, armor:当前甲路线 id}
|
# 域结构：{levels:{六路线 id→等级}, unlocked:[直购路线 id], weapon:当前武器路线 id, armor:当前甲路线 id}
|
||||||
@@ -365,7 +365,7 @@ func set_forge_armor(route_id: String) -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 装配关系（同调目录 item_id 有序数组——装配序即呈现序；跨冒险持久，冒险中途不可换装〔底稿 §8.5〕）。
|
# 装配关系（同调目录 item_id 有序数组——装配序即呈现序；跨冒险持久，冒险中途不可换装〔底稿 §8.5〕）。
|
||||||
# 局外进度事实（元进度域同族），非契约 2 反面清单的「局内道具库存」——存档序列化.md 契约 2 随批注记。
|
# 局外进度事实（元进度域同族），非契约 2 反面清单的「局内道具库存」——口径见 存档序列化.md 契约 2。
|
||||||
func attunement_equipped() -> Array:
|
func attunement_equipped() -> Array:
|
||||||
return (_data["meta"].get("attunement_equipped", []) as Array).duplicate()
|
return (_data["meta"].get("attunement_equipped", []) as Array).duplicate()
|
||||||
|
|
||||||
@@ -377,7 +377,7 @@ func set_attunement_equipped(item_ids: Array) -> void:
|
|||||||
_data["meta"]["attunement_equipped"] = out
|
_data["meta"]["attunement_equipped"] = out
|
||||||
|
|
||||||
|
|
||||||
# Y 刷新升级购买等级（0 = 未购 → 每冒险刷新次数 0；等级行值归营地升级行族——T4 接线）
|
# Y 刷新升级购买等级（0 = 未购 → 每冒险刷新次数 0；等级行值归营地升级行族）
|
||||||
func attune_refresh_level() -> int:
|
func attune_refresh_level() -> int:
|
||||||
return int(_data["meta"].get("attune_refresh_level", 0))
|
return int(_data["meta"].get("attune_refresh_level", 0))
|
||||||
|
|
||||||
@@ -393,10 +393,10 @@ func recent_summaries() -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 域更新原语（正式冒险收束唯一入账口——组合根经本函数入账，禁直改内部结构）：
|
# 域更新原语（正式冒险收束唯一入账口——组合根经本函数入账，禁直改内部结构）：
|
||||||
# 钥石入账（summary.keystone_total——迭代 10 起逐杀掉落已在冒险内计入，boss_drops 参数降级为
|
# 钥石入账（summary.keystone_total——逐杀掉落已在冒险内计入，boss_drops 参数为
|
||||||
# 摘要归档副本不重复入账）+ 逐通关关次 clear_count +1 与 Boss 首杀标记 + Boss 击杀总数累计
|
# 摘要归档副本不重复入账）+ 逐通关关次 clear_count +1 与 Boss 首杀标记 + Boss 击杀总数累计
|
||||||
# （迭代 11 第①批 T2——同调位里程碑计数源）+ 摘要头部插入（cap 10，最新在前，元素附
|
# （同调位里程碑计数源）+ 摘要头部插入（cap 10，最新在前，元素附
|
||||||
# keystone_drops 副本——复盘可归因）+ 生涯终身计数自增（迭代 18 卡④——总局数开局即计：
|
# keystone_drops 副本——复盘可归因）+ 生涯终身计数自增（总局数开局即计：
|
||||||
# 三结局同经本口恰计一次；通关局数按 summary.cleared 判定三关全通才计 1。终身计数写入
|
# 三结局同经本口恰计一次；通关局数按 summary.cleared 判定三关全通才计 1。终身计数写入
|
||||||
# 单口=本函数，禁第二写入点）。
|
# 单口=本函数，禁第二写入点）。
|
||||||
func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> void:
|
func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> void:
|
||||||
@@ -409,7 +409,7 @@ func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> voi
|
|||||||
var key := str(li)
|
var key := str(li)
|
||||||
_data["meta"]["level_clear_counts"][key] = int(_data["meta"]["level_clear_counts"].get(key, 0)) + 1
|
_data["meta"]["level_clear_counts"][key] = int(_data["meta"]["level_clear_counts"].get(key, 0)) + 1
|
||||||
_data["meta"]["boss_first_kill"][key] = true
|
_data["meta"]["boss_first_kill"][key] = true
|
||||||
_data["meta"]["boss_kill_count"] = boss_kill_count() + cleared # 迭代 11 T2——Boss 恒唯一终点：levels_cleared 即本次冒险 Boss 击杀数（含重复）
|
_data["meta"]["boss_kill_count"] = boss_kill_count() + cleared # Boss 恒唯一终点：levels_cleared 即本次冒险 Boss 击杀数（含重复）
|
||||||
var entry: Dictionary[Variant, Variant] = summary.duplicate(true)
|
var entry: Dictionary[Variant, Variant] = summary.duplicate(true)
|
||||||
entry["boss_drops"] = boss_drops.duplicate(true)
|
entry["boss_drops"] = boss_drops.duplicate(true)
|
||||||
var arr: Array[Variant] = _data["meta"]["recent_summaries"]
|
var arr: Array[Variant] = _data["meta"]["recent_summaries"]
|
||||||
@@ -418,7 +418,7 @@ func apply_adventure_summary(summary: Dictionary, boss_drops: Array = []) -> voi
|
|||||||
arr.pop_back()
|
arr.pop_back()
|
||||||
|
|
||||||
|
|
||||||
# ---- 冒险断点域（迭代 8 卡①——停点粒度续玩快照；内容装配归 AdventureRunner，本类照单承载）----
|
# ---- 冒险断点域（停点粒度续玩快照；内容装配归 AdventureRunner，本类照单承载）----
|
||||||
# 空字典 = 无断点合法态。值拷贝进出（禁碰内部结构契约同款）——快照写入后调用方再改不渗入存档态。
|
# 空字典 = 无断点合法态。值拷贝进出（禁碰内部结构契约同款）——快照写入后调用方再改不渗入存档态。
|
||||||
|
|
||||||
func set_breakpoint(bp: Dictionary) -> void:
|
func set_breakpoint(bp: Dictionary) -> void:
|
||||||
@@ -452,7 +452,7 @@ func _corrupt_fallback(reason: String) -> bool:
|
|||||||
|
|
||||||
# 迁移后/低版本档字段补齐 + 退役域清退（改版不弃档：缺新域按默认补齐，既有值保留；
|
# 迁移后/低版本档字段补齐 + 退役域清退（改版不弃档：缺新域按默认补齐，既有值保留；
|
||||||
# 退役域按默认模型键集白名单收口——换代退役键〔forge_levels/migration_note 等树域旧件〕不流入
|
# 退役域按默认模型键集白名单收口——换代退役键〔forge_levels/migration_note 等树域旧件〕不流入
|
||||||
# 内存不回写盘，开发阶段破坏性废弃口径〔迭代 21 T5，Q3 用户裁：禁迁移禁折算〕）。
|
# 内存不回写盘，开发阶段破坏性废弃口径〔禁迁移禁折算〕）。
|
||||||
# 树结构检查先于缺键补齐：换代前结构（tree_struct 标记缺失或更低）→ 树域废弃重置——
|
# 树结构检查先于缺键补齐：换代前结构（tree_struct 标记缺失或更低）→ 树域废弃重置——
|
||||||
# tree_nodes/fork_sides 清空、钥石余额等他域零触碰（V16 断言面）。
|
# tree_nodes/fork_sides 清空、钥石余额等他域零触碰（V16 断言面）。
|
||||||
func _normalize(data: Dictionary) -> Dictionary[String, Variant]:
|
func _normalize(data: Dictionary) -> Dictionary[String, Variant]:
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name AuraSegment
|
class_name AuraSegment
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# ② 增益/减益段 Segment（迭代 27 T2——P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
# ② 增益/减益段 Segment（P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
||||||
# 职责：续存实例组合行（本结算新授予的已在授予段逐 grant 出行——增益状态 义务⑦）。
|
# 职责：续存实例组合行（本结算新授予的已在授予段逐 grant 出行——增益状态 义务⑦）。
|
||||||
# 行发射归宿主编排器（oc）——零算法改动（🔴 零行为变更契约）。
|
# 行发射归宿主编排器（oc）——零算法改动（🔴 零行为变更契约）。
|
||||||
|
|
||||||
|
|||||||
@@ -1,9 +1,9 @@
|
|||||||
class_name CombatSegment
|
class_name CombatSegment
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# ③ 战斗段 Segment（迭代 27 T2——P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
# ③ 战斗段 Segment（P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
||||||
# 职责：案C 闸复位 + 本轮扫雷事实推导（执拗 streak/连珠矢段数）+ 蓄力层注入 + 主角先手
|
# 职责：案C 闸复位 + 本轮扫雷事实推导（执拗 streak/连珠矢段数）+ 蓄力层注入 + 主角先手
|
||||||
# （含连珠矢分段开单）+ 敌方行动兑现 + 地图伤害账殿后（补提交统一结账）。
|
# （含连珠矢分段开单）+ 敌方行动兑现 + 地图伤害账殿后（补提交统一结账）。
|
||||||
# 调用序：主角先手 → 逐敌还手 → 地图伤害账殿后〔案C 2026-10-06 用户裁〕；hero hp=0 短路。
|
# 调用序：主角先手 → 逐敌还手 → 地图伤害账殿后〔案C〕；hero hp=0 短路。
|
||||||
# 行发射/开单/兑付原语仍归宿主编排器（oc）——本函数体为原编排器 _combat_segment 逐字搬运
|
# 行发射/开单/兑付原语仍归宿主编排器（oc）——本函数体为原编排器 _combat_segment 逐字搬运
|
||||||
# （🔴 零行为变更契约）。
|
# （🔴 零行为变更契约）。
|
||||||
|
|
||||||
@@ -16,7 +16,7 @@ func _init(host) -> void:
|
|||||||
|
|
||||||
func run(ri: int) -> void:
|
func run(ri: int) -> void:
|
||||||
oc._defer_board_damage = false # 案C 闸复位——战斗段起开单即入队（主角/敌方/补提交的地图单按开单序统一结账）
|
oc._defer_board_damage = false # 案C 闸复位——战斗段起开单即入队（主角/敌方/补提交的地图单按开单序统一结账）
|
||||||
# 本轮扫雷事实推导（迭代 12 T4——执拗 streak/连珠矢段数共用取数面）：本轮 safe 事件数=
|
# 本轮扫雷事实推导（执拗 streak/连珠矢段数共用取数面）：本轮 safe 事件数=
|
||||||
# streak；踩雷即清零（mine_hit 监听同口——执拗「踩雷清零」承载）。攻击在战斗段=授予段后
|
# streak；踩雷即清零（mine_hit 监听同口——执拗「踩雷清零」承载）。攻击在战斗段=授予段后
|
||||||
# 同一次 _settle 内，facts 已定。
|
# 同一次 _settle 内，facts 已定。
|
||||||
var round_safe := 0
|
var round_safe := 0
|
||||||
@@ -30,14 +30,14 @@ func run(ri: int) -> void:
|
|||||||
# 蓄力层注入（内容数据驱动扩展批 T3——整备军备「每层下轮首段 +1」/厚积薄发满层 spike/铁壁整备
|
# 蓄力层注入（内容数据驱动扩展批 T3——整备军备「每层下轮首段 +1」/厚积薄发满层 spike/铁壁整备
|
||||||
# 减伤——三件 fact charge_layers 同读 action_economy；battle 域每轮刷新）
|
# 减伤——三件 fact charge_layers 同读 action_economy；battle 域每轮刷新）
|
||||||
oc._damage.charge_layers = oc.action_economy.charge_layers
|
oc._damage.charge_layers = oc.action_economy.charge_layers
|
||||||
# ⓪ 主角先手攻击（基础攻击恒存在——2026-09-11 用户裁决；先于敌方行动。案C 后授予段不再产出伤害，
|
# ⓪ 主角先手攻击（基础攻击恒存在；先于敌方行动。案C：授予段不再产出伤害，
|
||||||
# 主角进入战斗段时恒存活——先手必兑，除非场上无敌）。
|
# 主角进入战斗段时恒存活——先手必兑，除非场上无敌）。
|
||||||
# 单分量伤害构成（2026-09-19 充能退役批·用户拍板）：主角攻击 = 唯一基础分量（atk，吃掷点含暴击；
|
# 单分量伤害构成：主角攻击 = 唯一基础分量（atk，吃掷点含暴击；
|
||||||
# 类型 = 主角 attack_type 表值——2026-09-18 营地扩展前置批：量与类型抽象分离；查甲效矩阵对应行取克制修正）。
|
# 类型 = 主角 attack_type 表值（量与类型抽象分离）；查甲效矩阵对应行取克制修正）。
|
||||||
# 原"基础 + 穿刺/魔法充能三分量"模型随充能系统整体退役——克制策略归冒险前配置（营地换型 / 未来冒险前参数面），
|
# 原"基础 + 穿刺/魔法充能三分量"模型随充能系统整体退役——克制策略归冒险前配置（营地换型 / 未来冒险前参数面），
|
||||||
# 局内不再有挖掘攒弹药的第二伤害供给。attack_up 增益经 hero_offense 池乘攻击合计（见池乘区注记）。
|
# 局内不再有挖掘攒弹药的第二伤害供给。attack_up 增益经 hero_offense 池乘攻击合计（见池乘区注记）。
|
||||||
# 护甲等级掷点批（2026-09-16）：基础分量吃掷点判定（含暴击）；棋盘来源伤害不掷不折；
|
# 护甲等级掷点：基础分量吃掷点判定（含暴击）；棋盘来源伤害不掷不折；
|
||||||
# 任何伤害落地 ≥ damage_floor（全局 max(1,·)——2026-09-20 用户拍板扩全来源，下限在控制器管线单点收口）。
|
# 任何伤害落地 ≥ damage_floor（全局 max(1,·) 适用所有来源，下限在控制器管线单点收口）。
|
||||||
var hero_alive: bool = int(oc._enemy_system.hero_unit().get("hp", 0)) > 0
|
var hero_alive: bool = int(oc._enemy_system.hero_unit().get("hp", 0)) > 0
|
||||||
var hero_target = oc._enemy_system.default_target()
|
var hero_target = oc._enemy_system.default_target()
|
||||||
if hero_alive and hero_target != null:
|
if hero_alive and hero_target != null:
|
||||||
@@ -50,7 +50,7 @@ func run(ri: int) -> void:
|
|||||||
for h in oc._hits_of(ht.context.get("fx_attack_hits", []) as Array, "attack_segments"):
|
for h in oc._hits_of(ht.context.get("fx_attack_hits", []) as Array, "attack_segments"):
|
||||||
var segments := mini(int(h.get("cap", 2)), oc._damage.dig_streak / maxi(1, int(h.get("divisor", 3))))
|
var segments := mini(int(h.get("cap", 2)), oc._damage.dig_streak / maxi(1, int(h.get("divisor", 3))))
|
||||||
for s in segments:
|
for s in segments:
|
||||||
# 迭代 20 T9——source_class 中性名（旧件名 feat_chain_arrows 随连珠矢退役；attack_segments 兑付通道保留泛用面）
|
# source_class 用中性名；attack_segments 兑付通道保留泛用面
|
||||||
var ct := oc._damage.open_ticket(DamageController.KIND_BOARD_TYPED, "fx_streak_segments",
|
var ct := oc._damage.open_ticket(DamageController.KIND_BOARD_TYPED, "fx_streak_segments",
|
||||||
"连击分段", "board", int(h.get("value", 0)), DamageController.TARGET_FRONT_ALIVE, ri,
|
"连击分段", "board", int(h.get("value", 0)), DamageController.TARGET_FRONT_ALIVE, ri,
|
||||||
oc.minesweeper.hero_pos(), "pierce")
|
oc.minesweeper.hero_pos(), "pierce")
|
||||||
@@ -66,8 +66,7 @@ func run(ri: int) -> void:
|
|||||||
oc._fatal("敌实例待发动作悬空: %s" % skill_id)
|
oc._fatal("敌实例待发动作悬空: %s" % skill_id)
|
||||||
continue
|
continue
|
||||||
if String(srow.type) == "buff" or String(srow.type) == "debuff":
|
if String(srow.type) == "buff" or String(srow.type) == "debuff":
|
||||||
# 增益/妨害技（新效应词汇批 2026-09-19）= 0 伤害施放行：不掷不折；状态授予即数值兑现，技能冷却与增益持续两计时器分账。
|
# 增益/妨害技 = 0 伤害施放行：不掷不折；状态授予即数值兑现，技能冷却与增益持续两计时器分账。
|
||||||
# （原"本轮喂的伏击逢施放拍不兑现"读怪奖励随伏击退役一并作废——2026-09-20 八型批）
|
|
||||||
# 落点由状态行 target_side 路由（buff → 敌方侧 / debuff → 主角侧——容器零改动，proposal-status-vocabulary §1）。
|
# 落点由状态行 target_side 路由（buff → 敌方侧 / debuff → 主角侧——容器零改动，proposal-status-vocabulary §1）。
|
||||||
var dur: int = int(srow.get("buff_duration", 1))
|
var dur: int = int(srow.get("buff_duration", 1))
|
||||||
oc._status_effects.apply_effect(String(srow.buff_ref), {"source_class": "enemy_action", "origin_cell": Vector2i(-1, -1), "round_index": ri}, dur)
|
oc._status_effects.apply_effect(String(srow.buff_ref), {"source_class": "enemy_action", "origin_cell": Vector2i(-1, -1), "round_index": ri}, dur)
|
||||||
@@ -87,7 +86,7 @@ func run(ri: int) -> void:
|
|||||||
et["source_unit"] = u
|
et["source_unit"] = u
|
||||||
et["context"] = {"skill_id": skill_id, "baseline": baseline}
|
et["context"] = {"skill_id": skill_id, "baseline": baseline}
|
||||||
oc._damage.submit(et)
|
oc._damage.submit(et)
|
||||||
# 地图伤害兑付（案C 2026-10-06 用户裁——战斗段末：怪物还手后按授予段事件序补提交统一结账；
|
# 地图伤害兑付（案C：战斗段末——怪物还手后按授予段事件序补提交统一结账；
|
||||||
# 主角死于怪物 → 地图账不兑，逐单留「未生效」行不作废静默——没生效也要留痕口径；
|
# 主角死于怪物 → 地图账不兑，逐单留「未生效」行不作废静默——没生效也要留痕口径；
|
||||||
# 补提交后若地图直伤反杀主角，控制器 _halted 作废余单——战斗已败，胜负归判定段）
|
# 补提交后若地图直伤反杀主角，控制器 _halted 作废余单——战斗已败，胜负归判定段）
|
||||||
if int(oc._enemy_system.hero_unit().get("hp", 0)) <= 0:
|
if int(oc._enemy_system.hero_unit().get("hp", 0)) <= 0:
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name DecaySegment
|
class_name DecaySegment
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# ④ 衰减段 Segment（迭代 27 T2——P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
# ④ 衰减段 Segment（P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
||||||
# 职责：状态衰减恰一次恒执行含末轮——先兑付后衰减。行发射归宿主编排器（oc）——
|
# 职责：状态衰减恰一次恒执行含末轮——先兑付后衰减。行发射归宿主编排器（oc）——
|
||||||
# 零算法改动（🔴 零行为变更契约）。
|
# 零算法改动（🔴 零行为变更契约）。
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name GrantSegment
|
class_name GrantSegment
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# ① 授予段 Segment（迭代 27 T2——P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
# ① 授予段 Segment（P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
||||||
# 职责：结算队列（开格/封印判定/清图）→ 极性路由逐批兑付 + 封印判/军规开单 + round_end 施加 +
|
# 职责：结算队列（开格/封印判定/清图）→ 极性路由逐批兑付 + 封印判/军规开单 + round_end 施加 +
|
||||||
# 转存收口 + 揭示兑付 + 段界结账。行发射/开单/兑付原语仍归宿主编排器（oc）——
|
# 转存收口 + 揭示兑付 + 段界结账。行发射/开单/兑付原语仍归宿主编排器（oc）——
|
||||||
# 本段只搬运时序，零算法改动（🔴 零行为变更契约：同种子完整局输出逐位一致）。
|
# 本段只搬运时序，零算法改动（🔴 零行为变更契约：同种子完整局输出逐位一致）。
|
||||||
@@ -17,9 +17,9 @@ func _init(host) -> void:
|
|||||||
|
|
||||||
func run(ri: int) -> void:
|
func run(ri: int) -> void:
|
||||||
# ① 授予段：结算队列（开格/封印判定/清图）→ 极性路由逐批兑付（伤害形态单据暂存——见 _submit 案C 闸）。
|
# ① 授予段：结算队列（开格/封印判定/清图）→ 极性路由逐批兑付（伤害形态单据暂存——见 _submit 案C 闸）。
|
||||||
# 判定基线 = 轮末在场封印（发射面已过滤——被挖开的封印已随挖掘擦除零兑付，封印不可逆批 2026-09-19；
|
# 判定基线 = 轮末在场封印（发射面已过滤——被挖开的封印已随挖掘擦除零兑付；
|
||||||
# 开格事实不可撤）。
|
# 开格事实不可撤）。
|
||||||
oc._defer_board_damage = true # 案C：授予段伤害单据只暂存不结账（2026-10-06 用户裁——兑付时点=战斗段末）
|
oc._defer_board_damage = true # 案C：授予段伤害单据只暂存不结账（兑付时点=战斗段末）
|
||||||
for evt in oc._facts_reveals:
|
for evt in oc._facts_reveals:
|
||||||
if not bool(evt.get("resource", false)):
|
if not bool(evt.get("resource", false)):
|
||||||
continue # 封锁格（initial 通道）恒无资源——不入账（战斗结算 义务②）
|
continue # 封锁格（initial 通道）恒无资源——不入账（战斗结算 义务②）
|
||||||
@@ -28,13 +28,13 @@ func run(ri: int) -> void:
|
|||||||
continue
|
continue
|
||||||
if evt.kind == "safe":
|
if evt.kind == "safe":
|
||||||
if bool(evt.get("dug_under_seal", false)):
|
if bool(evt.get("dug_under_seal", false)):
|
||||||
# 封印不可逆四情况④（2026-09-19 用户拍板）：插安全格再挖开 = 零惩罚零奖励——正向兑付
|
# 封印不可逆四情况④：插安全格再挖开 = 零惩罚零奖励——正向兑付
|
||||||
# 作废（归因行在案）；标空判定已随封印擦除自然缺席（被挖的封印不在轮末在场基线）。
|
# 作废（归因行在案）；标空判定已随封印擦除自然缺席（被挖的封印不在轮末在场基线）。
|
||||||
oc._emit_row("reward_ineffective", "safe_cell", evt.cell, ri, "奖励作废（封印格直接挖开——零惩罚零奖励）", 0, {}, "")
|
oc._emit_row("reward_ineffective", "safe_cell", evt.cell, ri, "奖励作废（封印格直接挖开——零惩罚零奖励）", 0, {}, "")
|
||||||
continue
|
continue
|
||||||
# dig_reveal 发射+施加（内容数据驱动扩展批 T3——桶序固定承载等价：
|
# dig_reveal 发射+施加（内容数据驱动扩展批 T3——桶序固定承载等价：
|
||||||
# 乘区收集 → 正向兑付 → 计数器 → 追加产出（深挖）→ 奥术矢。
|
# 乘区收集 → 正向兑付 → 计数器 → 追加产出（深挖）→ 奥术矢。
|
||||||
# 迭代 20 T1——payload 扩三事实：is_edge_cell〔边陲矿工〕/is_blank_zero〔跳格采掘〕/
|
# payload 携三事实：is_edge_cell〔边陲矿工〕/is_blank_zero〔跳格采掘〕/
|
||||||
# new_resource_type〔地质学家——快照 cell_type 首见判定，见后集登记〕）
|
# new_resource_type〔地质学家——快照 cell_type 首见判定，见后集登记〕）
|
||||||
var board_b: BoardData = oc.minesweeper.current_board()
|
var board_b: BoardData = oc.minesweeper.current_board()
|
||||||
var snap_pre = evt.get("reward_snapshot")
|
var snap_pre = evt.get("reward_snapshot")
|
||||||
@@ -64,7 +64,7 @@ func run(ri: int) -> void:
|
|||||||
for h in dr_hits:
|
for h in dr_hits:
|
||||||
if String(h.get("kind", "")) == "counter_add":
|
if String(h.get("kind", "")) == "counter_add":
|
||||||
_apply_counter_hit(h)
|
_apply_counter_hit(h)
|
||||||
# 揭示效果入队（迭代 20 T1——地质学家/跳格采掘 reveal_tiles 订阅面；授予段末
|
# 揭示效果入队（地质学家/跳格采掘 reveal_tiles 订阅面；授予段末
|
||||||
# _flush_pending_reveals 统一掷格兑付）
|
# _flush_pending_reveals 统一掷格兑付）
|
||||||
if not oc._hits_of(dr_hits, "reveal_tiles").is_empty():
|
if not oc._hits_of(dr_hits, "reveal_tiles").is_empty():
|
||||||
oc._fx_enqueue_reveal()
|
oc._fx_enqueue_reveal()
|
||||||
@@ -85,7 +85,7 @@ func run(ri: int) -> void:
|
|||||||
# 标中不发（封印已随挖掘擦除、不入轮末判定基线）。
|
# 标中不发（封印已随挖掘擦除、不入轮末判定基线）。
|
||||||
# mine_hit 发射+施加（内容数据驱动扩展批 T3——桶序固定承载等价：
|
# mine_hit 发射+施加（内容数据驱动扩展批 T3——桶序固定承载等价：
|
||||||
# 减半收集 → 负向兑付〔带减半系数〕→ 反打开单 → 连击清零计数器。
|
# 减半收集 → 负向兑付〔带减半系数〕→ 反打开单 → 连击清零计数器。
|
||||||
# 迭代 20 T1——发射前移+payload 扩 dug_under_seal〔破封一击〕；新增施加面：
|
# 发射时点前移并扩 payload dug_under_seal〔破封一击〕；施加面：
|
||||||
# damage_reduce〔安全帽耗层减伤——value_counter 层值，一次清零〕/ heal〔血蜜〕/
|
# damage_reduce〔安全帽耗层减伤——value_counter 层值，一次清零〕/ heal〔血蜜〕/
|
||||||
# blast_scaled〔陷阱爆发——雷伤×倍率全体敌〕/ bonus_delta〔血税〕/ reveal_tiles〔见血开窍〕）
|
# blast_scaled〔陷阱爆发——雷伤×倍率全体敌〕/ bonus_delta〔血税〕/ reveal_tiles〔见血开窍〕）
|
||||||
var mine_power := int((snap as Dictionary).get("power", 0))
|
var mine_power := int((snap as Dictionary).get("power", 0))
|
||||||
@@ -129,7 +129,7 @@ func run(ri: int) -> void:
|
|||||||
int(h.get("value", 0)), DamageController.TARGET_ALL_ALIVE, ri, evt.cell, "", 0, "", {})
|
int(h.get("value", 0)), DamageController.TARGET_ALL_ALIVE, ri, evt.cell, "", 0, "", {})
|
||||||
oc._submit(nct, false)
|
oc._submit(nct, false)
|
||||||
# 地形变异 兑付段（授予段尾——触发枚举 on_open：挖开即伤、chain 通道同口径；伤害单据案C 暂存到
|
# 地形变异 兑付段（授予段尾——触发枚举 on_open：挖开即伤、chain 通道同口径；伤害单据案C 暂存到
|
||||||
# 战斗段末兑付〔2026-10-06 用户裁〕；信息型 hide_number 不进结算——呈现层读取，见 board_view 数字遮蔽；
|
# 战斗段末兑付〔案C〕；信息型 hide_number 不进结算——呈现层读取，见 board_view 数字遮蔽；
|
||||||
# 危险格恒无变异——布置段排除，双层叠罚不存在；封印格直挖照吃变异伤害——地形后果同 mine_hit 口径，
|
# 危险格恒无变异——布置段排除，双层叠罚不存在；封印格直挖照吃变异伤害——地形后果同 mine_hit 口径，
|
||||||
# 非奖励不作废；吞噬流资源兑付〔荆棘编织/地脉补偿〕中伤害形态行同样经案C闸暂存，非伤害形态照常当场）
|
# 非奖励不作废；吞噬流资源兑付〔荆棘编织/地脉补偿〕中伤害形态行同样经案C闸暂存，非伤害形态照常当场）
|
||||||
for evt in oc._facts_reveals:
|
for evt in oc._facts_reveals:
|
||||||
@@ -138,8 +138,8 @@ func run(ri: int) -> void:
|
|||||||
var vrow: Dictionary[Variant, Variant] = oc.db.variation.row_by_id(String(vid))
|
var vrow: Dictionary[Variant, Variant] = oc.db.variation.row_by_id(String(vid))
|
||||||
if String(vrow.get("effect", "")) != "flat_damage":
|
if String(vrow.get("effect", "")) != "flat_damage":
|
||||||
continue # 触发词表按 effect 路由：flat_damage=on_open 兑现；hide_number/on_open 外组合 = 数据行新词表未接线（显式忽略面）
|
continue # 触发词表按 effect 路由：flat_damage=on_open 兑现；hide_number/on_open 外组合 = 数据行新词表未接线（显式忽略面）
|
||||||
# 地形变异伤害单据（伤害管线单据化批 2026-09-24）——无类型必中，下限保底在控制器管线内
|
# 地形变异伤害单据——无类型必中，下限保底在控制器管线内
|
||||||
# 迭代 20 T1——damage_taken 发射前移（单据开立前）：damage_reduce〔背水——hp_ratio when
|
# damage_taken 发射在单据开立前：damage_reduce〔背水——hp_ratio when
|
||||||
# 面〕先收集再按减后值开单；counter_add〔保险丝/石肤〕+ ac_bonus〔石肤〕照常施加；
|
# 面〕先收集再按减后值开单；counter_add〔保险丝/石肤〕+ ac_bonus〔石肤〕照常施加；
|
||||||
# grant_material〔荆棘/地脉〕移到单据提交后（与迁移前兑付值序一致——收益不因减伤变化）
|
# grant_material〔荆棘/地脉〕移到单据提交后（与迁移前兑付值序一致——收益不因减伤变化）
|
||||||
var dt_amount := int(vrow.get("effect_value", 0))
|
var dt_amount := int(vrow.get("effect_value", 0))
|
||||||
@@ -162,7 +162,7 @@ func run(ri: int) -> void:
|
|||||||
_apply_material_hit(h, evt.cell, ri)
|
_apply_material_hit(h, evt.cell, ri)
|
||||||
for evt in oc._facts_seals:
|
for evt in oc._facts_seals:
|
||||||
_judge_seal(evt, ri)
|
_judge_seal(evt, ri)
|
||||||
# 战封印军规开单段（迭代 12 T3 封印流——seal_judged 批后统一开单：轮末每面封印命中对最前存活敌
|
# 战封印军规开单段（封印流：seal_judged 批后统一开单：轮末每面封印命中对最前存活敌
|
||||||
# 结算 board_typed 必中伤害〔复用零新配方；「封印所在巢穴敌」简化为 default_target 最前存活敌——
|
# 结算 board_typed 必中伤害〔复用零新配方；「封印所在巢穴敌」简化为 default_target 最前存活敌——
|
||||||
# 台账披露待追认〕；完美布防=本轮封印批全中（hit>0 且 miss==0）时封印伤 ×mult——全对推理奖励）。
|
# 台账披露待追认〕；完美布防=本轮封印批全中（hit>0 且 miss==0）时封印伤 ×mult——全对推理奖励）。
|
||||||
# 伤害单据案C 暂存战斗段末兑付。
|
# 伤害单据案C 暂存战斗段末兑付。
|
||||||
@@ -205,7 +205,7 @@ func run(ri: int) -> void:
|
|||||||
var mg_layers := oc._fx.counter(String(h.get("per", "")))
|
var mg_layers := oc._fx.counter(String(h.get("per", "")))
|
||||||
var mg_total := int(h.get("value", 0)) * mg_layers
|
var mg_total := int(h.get("value", 0)) * mg_layers
|
||||||
if mg_total > 0:
|
if mg_total > 0:
|
||||||
# 迭代 20 T9——source_class 中性名（旧件名 feat_magma_body 随熔火之躯退役；per-counter 反打通道保留泛用面）
|
# source_class 用中性名；per-counter 反打通道保留泛用面
|
||||||
var mg_t := oc._damage.open_ticket(DamageController.KIND_BOARD_BLAST, "fx_blast_counter",
|
var mg_t := oc._damage.open_ticket(DamageController.KIND_BOARD_BLAST, "fx_blast_counter",
|
||||||
"积层反噬 ×%d" % mg_layers, "board", mg_total,
|
"积层反噬 ×%d" % mg_layers, "board", mg_total,
|
||||||
DamageController.TARGET_ALL_ALIVE, ri, oc.minesweeper.hero_pos(), "", 0, "", {})
|
DamageController.TARGET_ALL_ALIVE, ri, oc.minesweeper.hero_pos(), "", 0, "", {})
|
||||||
@@ -213,7 +213,7 @@ func run(ri: int) -> void:
|
|||||||
for h in re_fx:
|
for h in re_fx:
|
||||||
if String(h.get("kind", "")) == "counter_add":
|
if String(h.get("kind", "")) == "counter_add":
|
||||||
_apply_counter_hit(h)
|
_apply_counter_hit(h)
|
||||||
# 迭代 20 T1——round_end 新施加面：grant_gp〔爆破会计/收盘——escrow 战斗域缓冲，随 gp_dropped 上抛〕/
|
# round_end 施加面：grant_gp〔爆破会计/收盘——escrow 战斗域缓冲，随 gp_dropped 上抛〕/
|
||||||
# grant_ap mode:queue〔封印回响——返 1 AP 下轮，queue_ap_delta 通道与轮始加成同面〕
|
# grant_ap mode:queue〔封印回响——返 1 AP 下轮，queue_ap_delta 通道与轮始加成同面〕
|
||||||
for h in re_fx:
|
for h in re_fx:
|
||||||
if String(h.get("kind", "")) == "grant_gp":
|
if String(h.get("kind", "")) == "grant_gp":
|
||||||
@@ -228,11 +228,11 @@ func run(ri: int) -> void:
|
|||||||
rap_pct if rap_pct > 0 else 100)
|
rap_pct if rap_pct > 0 else 100)
|
||||||
if oc._facts_path == "cleared":
|
if oc._facts_path == "cleared":
|
||||||
oc._grant_clear_reward(ri)
|
oc._grant_clear_reward(ri)
|
||||||
oc._flush_pending_reveals(ri) # 迭代 20 T1——揭示效果兑付（授予段末统一掷格，防轮 facts 迭代重入）
|
oc._flush_pending_reveals(ri) # 揭示效果兑付（授予段末统一掷格，防轮 facts 迭代重入）
|
||||||
oc._damage.flush() # 授予段界结账（案C 后本段伤害单据全数暂存，此处对空队 no-op——保留作防御性段界）
|
oc._damage.flush() # 授予段界结账（案C 后本段伤害单据全数暂存，此处对空队 no-op——保留作防御性段界）
|
||||||
|
|
||||||
|
|
||||||
# 封印判定（迭代 12 T3 封印流本体随段迁入——原编排器 _judge_seal 逐字搬运，仅宿主引用加前缀；
|
# 封印判定（封印流本体——自编排器 _judge_seal 迁入，宿主引用加前缀；
|
||||||
# 唯一调用面=本段 run 的 facts_seals 循环）。
|
# 唯一调用面=本段 run 的 facts_seals 循环）。
|
||||||
func _judge_seal(evt: Dictionary, ri: int) -> void:
|
func _judge_seal(evt: Dictionary, ri: int) -> void:
|
||||||
var cell: Vector2i = evt.cell
|
var cell: Vector2i = evt.cell
|
||||||
@@ -247,14 +247,14 @@ func _judge_seal(evt: Dictionary, ri: int) -> void:
|
|||||||
"terrain_kind": oc._harmful_adjacent(cell)})
|
"terrain_kind": oc._harmful_adjacent(cell)})
|
||||||
# 标中殉爆（迭代 11 同调批 T5 → 内容数据驱动扩展批 T4：订阅施加——行 triggers open_ticket
|
# 标中殉爆（迭代 11 同调批 T5 → 内容数据驱动扩展批 T4：订阅施加——行 triggers open_ticket
|
||||||
# channel blast value_from magnitude；每标中一面封印全体存活敌吃 N 群伤，无类型走 blast 通道。
|
# channel blast value_from magnitude；每标中一面封印全体存活敌吃 N 群伤，无类型走 blast 通道。
|
||||||
# 迭代 20 T1——封印爆裂〔迁入专长〕同面消费：行 triggers open_ticket channel blast）
|
# 封印爆裂〔专长〕同面消费：行 triggers open_ticket channel blast）
|
||||||
for h in oc._hits_of(fh_hits, "open_ticket"):
|
for h in oc._hits_of(fh_hits, "open_ticket"):
|
||||||
if String(h.get("channel", "")) != "blast":
|
if String(h.get("channel", "")) != "blast":
|
||||||
continue
|
continue
|
||||||
var fbt := oc._damage.open_ticket(DamageController.KIND_BOARD_BLAST, "feat_seal_burst", "封印爆裂", "board",
|
var fbt := oc._damage.open_ticket(DamageController.KIND_BOARD_BLAST, "feat_seal_burst", "封印爆裂", "board",
|
||||||
int(h.get("value", 0)), DamageController.TARGET_ALL_ALIVE, ri, cell, "", 0, "highlight", {})
|
int(h.get("value", 0)), DamageController.TARGET_ALL_ALIVE, ri, cell, "", 0, "highlight", {})
|
||||||
oc._submit(fbt, false)
|
oc._submit(fbt, false)
|
||||||
# 迭代 20 T1——标中新施加面：counter_add〔血税 标中+1 攻——bonus_delta atk 轴〕/
|
# 标中施加面：counter_add〔血税 标中+1 攻——bonus_delta atk 轴〕/
|
||||||
# ac_bonus〔封印桩 本轮 AC+N〕/ preview_area〔示警烟火 3×3 资源类型预告〕/
|
# ac_bonus〔封印桩 本轮 AC+N〕/ preview_area〔示警烟火 3×3 资源类型预告〕/
|
||||||
# remove_mines〔封印匠 每第 3 次该危险格中立移除——mod_eq 闸在行 when〕。
|
# remove_mines〔封印匠 每第 3 次该危险格中立移除——mod_eq 闸在行 when〕。
|
||||||
# （净化工兵 rewrite_board 分支随老 27 件退役摘除——效果类型同批除名，T1 落法 commit 留痕）
|
# （净化工兵 rewrite_board 分支随老 27 件退役摘除——效果类型同批除名，T1 落法 commit 留痕）
|
||||||
@@ -282,7 +282,7 @@ func _judge_seal(evt: Dictionary, ri: int) -> void:
|
|||||||
if oc.treasure_inventory != null and not types.is_empty():
|
if oc.treasure_inventory != null and not types.is_empty():
|
||||||
oc.treasure_inventory.apply_overlay("reward_preview", board_p.neighbors8(cell))
|
oc.treasure_inventory.apply_overlay("reward_preview", board_p.neighbors8(cell))
|
||||||
oc._emit_row("fx_preview_area", "", cell, ri, "示警烟火·周围资源类型", 0, {"types": types}, "")
|
oc._emit_row("fx_preview_area", "", cell, ri, "示警烟火·周围资源类型", 0, {"types": types}, "")
|
||||||
# 雷区图谱（迭代 12 T3 封印流——标中雷额外获得一份格面资源：封印开始产出对标开格；
|
# 雷区图谱（封印流——标中雷额外获得一份格面资源：封印开始产出对标开格；
|
||||||
# 复用 grant 单点，额外兑付走同一 _grant_routed 正向路由）
|
# 复用 grant 单点，额外兑付走同一 _grant_routed 正向路由）
|
||||||
for h in fh_hits:
|
for h in fh_hits:
|
||||||
if String(h.get("kind", "")) == "grant_material":
|
if String(h.get("kind", "")) == "grant_material":
|
||||||
@@ -300,7 +300,7 @@ func _judge_seal(evt: Dictionary, ri: int) -> void:
|
|||||||
if oc._perfect_hit_false == 1:
|
if oc._perfect_hit_false == 1:
|
||||||
hl = "perfect_broken" # 本板完美谓词已破的归因锚
|
hl = "perfect_broken" # 本板完美谓词已破的归因锚
|
||||||
oc._emit_row("seal_miss", "seal_miss", cell, ri, "封印未中", 0, {}, hl)
|
oc._emit_row("seal_miss", "seal_miss", cell, ri, "封印未中", 0, {}, hl)
|
||||||
# 危险直觉·守挂点（迭代 21 T3——seal_missed 发射：契约 12 触发主语=「当回合发生的标错
|
# 危险直觉·守挂点（seal_missed 发射：契约 12 触发主语=「当回合发生的标错
|
||||||
# 动作」——去重闸=新旧标错判别器〔后续轮重判旧封印被闸挡回零触发〕；双条件②「结算时封印仍在
|
# 动作」——去重闸=新旧标错判别器〔后续轮重判旧封印被闸挡回零触发〕；双条件②「结算时封印仍在
|
||||||
# 场」由发射面既有过滤承载〔被挖开的封印已随挖掘擦除零兑付〕；grant_ap mode:queue 下一轮
|
# 场」由发射面既有过滤承载〔被挖开的封印已随挖掘擦除零兑付〕；grant_ap mode:queue 下一轮
|
||||||
# 开轮兑现——末轮判出无下一轮=合法作废自动成立〔编排器每战新建，队列不跨战〕；限次=合成行
|
# 开轮兑现——末轮判出无下一轮=合法作废自动成立〔编排器每战新建，队列不跨战〕；限次=合成行
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name VerdictSegment
|
class_name VerdictSegment
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# ⑤ 判定段 Segment（迭代 27 T2——P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
# ⑤ 判定段 Segment（P1-1 结算巨函数拆段；段边界=审计五段〔裁点③甲〕）。
|
||||||
# 职责：防御性优先级 hero 先判（双死结构不可达的纵深防御）→ 全量状态快照（despawn 前
|
# 职责：防御性优先级 hero 先判（双死结构不可达的纵深防御）→ 全量状态快照（despawn 前
|
||||||
# 组装——终局含 result）→ 终局行+收束分派 / 下一轮出口分发。
|
# 组装——终局含 result）→ 终局行+收束分派 / 下一轮出口分发。
|
||||||
# 返回值 = 裁定（"victory"/"defeat"/"continue"）——宿主 _settle 据此保持旧早退语义
|
# 返回值 = 裁定（"victory"/"defeat"/"continue"）——宿主 _settle 据此保持旧早退语义
|
||||||
|
|||||||
+10
-10
@@ -52,17 +52,17 @@ func inventory_count() -> int:
|
|||||||
return _items.size()
|
return _items.size()
|
||||||
|
|
||||||
|
|
||||||
# 持有数（迭代 10 奖励重构批——同调位上限判定读数：只计未消耗件；Used 不可逆即不再持有）
|
# 持有数（同调位上限判定读数：只计未消耗件；Used 不可逆即不再持有）
|
||||||
# 同调位守卫谓词——迭代 11 第①批 T7 退役（读取源 transitional_sync_slots 过渡键已随表退役；
|
# 同调位守卫谓词（读取源 transitional_sync_slots 过渡键已随表退役；
|
||||||
# 容量闸正主 = 营地装配面 Attunement.slots 满位禁选。函数体保留空壳防四散引用误删遗漏——
|
# 容量闸正主 = 营地装配面 Attunement.slots 满位禁选。函数体保留空壳防四散引用误删遗漏——
|
||||||
# T8 冒烟「过渡键读取点归零」断言覆盖）
|
# 冒烟「过渡键读取点归零」断言覆盖）
|
||||||
|
|
||||||
|
|
||||||
# 持有件记录（迭代 10 追加批——奖励节点替换子交互数据源：只列未消耗件，handle 定位丢弃目标）
|
# 持有件记录（奖励节点替换子交互数据源：只列未消耗件，handle 定位丢弃目标）
|
||||||
# 丢弃（同调位替换交互节点渠道——腾位收新；与 Used 消费分轨的一次性移除，快照不再含）
|
# 丢弃（同调位替换交互节点渠道——腾位收新；与 Used 消费分轨的一次性移除，快照不再含）
|
||||||
# 板级零信息可用性预判（图标置灰/入口禁用判据——GDD「整张图都没东西可看」级）：
|
# 板级零信息可用性预判（图标置灰/入口禁用判据——GDD「整张图都没东西可看」级）：
|
||||||
# 真视恒可用（零雷窗口=信息非空）；AP 类恒可用（组合判据取 OR——任一效果有信息即可用）；
|
# 真视恒可用（零雷窗口=信息非空）；AP 类恒可用（组合判据取 OR——任一效果有信息即可用）；
|
||||||
# 纯预读行 = 板上还有未开格才可用。（积点件不入使用面——反哺批⑤自动兑付无玩家入口）
|
# 纯预读行 = 板上还有未开格才可用。（积点件不入使用面——自动兑付无玩家入口）
|
||||||
func _usable_now(item_id: String, board_has_preview_info: Callable) -> bool:
|
func _usable_now(item_id: String, board_has_preview_info: Callable) -> bool:
|
||||||
var row: Dictionary[Variant, Variant] = _item_row(item_id)
|
var row: Dictionary[Variant, Variant] = _item_row(item_id)
|
||||||
if row.is_empty():
|
if row.is_empty():
|
||||||
@@ -77,7 +77,7 @@ func _item_row(item_id: String) -> Dictionary:
|
|||||||
if _db == null:
|
if _db == null:
|
||||||
return {}
|
return {}
|
||||||
if _db.has_method("treasure_item_row"):
|
if _db.has_method("treasure_item_row"):
|
||||||
return _db.treasure_item_row(item_id) # 表访问收口（2026-10-02——正式面走 ConfigDB 访问器）
|
return _db.treasure_item_row(item_id) # 表访问收口（正式面走 ConfigDB 访问器）
|
||||||
return _db.treasure_items.row_by_id(item_id) # 桩表面（单测 StubDB 无访问器——直读保留，随测试面演进退役）
|
return _db.treasure_items.row_by_id(item_id) # 桩表面（单测 StubDB 无访问器——直读保留，随测试面演进退役）
|
||||||
|
|
||||||
# 不标具体类型原因：单元测试注入 StubDB 桩表（treasure_items_test.gd）——typed 赋值会运行期拒收，保守保持 null 注
|
# 不标具体类型原因：单元测试注入 StubDB 桩表（treasure_items_test.gd）——typed 赋值会运行期拒收，保守保持 null 注
|
||||||
@@ -105,12 +105,12 @@ func validate_use(handle: int, target: Vector2i, board_size: Vector2i, cell_unre
|
|||||||
var kinds: Array[Variant] = row.get("effect_kinds", [])
|
var kinds: Array[Variant] = row.get("effect_kinds", [])
|
||||||
var resolved: Array[Variant] = []
|
var resolved: Array[Variant] = []
|
||||||
if kinds.has("mine_reveal") or kinds.has("reward_preview") or kinds.has("reveal_tiles") or kinds.has("safe_dig"):
|
if kinds.has("mine_reveal") or kinds.has("reward_preview") or kinds.has("reveal_tiles") or kinds.has("safe_dig"):
|
||||||
# 空间效果（迭代 22 秘宝批 T3 扩面——真视 reveal_tiles/天眼复合 safe_dig 入空间解析；
|
# 空间效果（真视 reveal_tiles/天眼复合 safe_dig 入空间解析；
|
||||||
# 真视窄域护栏 REVEAL_KINDS 同守）：
|
# 真视窄域护栏 REVEAL_KINDS 同守）：
|
||||||
if target.x < 0 or target.y < 0 or target.x >= int(board_size.x) or target.y >= int(board_size.y):
|
if target.x < 0 or target.y < 0 or target.x >= int(board_size.x) or target.y >= int(board_size.y):
|
||||||
return _reject("目标越板")
|
return _reject("目标越板")
|
||||||
if String(row.get("target", "")) == "cell":
|
if String(row.get("target", "")) == "cell":
|
||||||
# 单格档（迭代 22 T1——线香真视单格；≤3×3 窄域契约内的点目标）
|
# 单格档（线香真视单格；≤3×3 窄域契约内的点目标）
|
||||||
resolved.append(target)
|
resolved.append(target)
|
||||||
else:
|
else:
|
||||||
# 3×3 窗口 ∩ 板内格（边缘受理——护栏只缩不扩）
|
# 3×3 窗口 ∩ 板内格（边缘受理——护栏只缩不扩）
|
||||||
@@ -172,7 +172,7 @@ func consume(handle: int) -> Dictionary:
|
|||||||
return rec.duplicate()
|
return rec.duplicate()
|
||||||
|
|
||||||
|
|
||||||
# ---- 断点快照（迭代 8 卡①——关卡域库存随停点入档/回局）----
|
# ---- 断点快照（关卡域库存随停点入档/回局）----
|
||||||
# 快照面 = {item_id, source_class, origin_cell:[x,y], round_index, used}（JSON 安全形——Vector2i 转
|
# 快照面 = {item_id, source_class, origin_cell:[x,y], round_index, used}（JSON 安全形——Vector2i 转
|
||||||
# 数组、键全 String）；handle 不入档（受理序句柄，回局时按序重排）。叠加层集不入快照（战斗域
|
# 数组、键全 String）；handle 不入档（受理序句柄，回局时按序重排）。叠加层集不入快照（战斗域
|
||||||
# 随图消亡——停点处无战斗在飞，天然空集）。
|
# 随图消亡——停点处无战斗在飞，天然空集）。
|
||||||
@@ -222,7 +222,7 @@ func _reject(reason: String) -> Dictionary:
|
|||||||
return {"ok": false, "reason": reason, "resolved": [], "item_id": "", "kinds": [], "magnitude": 0}
|
return {"ok": false, "reason": reason, "resolved": [], "item_id": "", "kinds": [], "magnitude": 0}
|
||||||
|
|
||||||
|
|
||||||
# 探针出口（T7 收拢——断言面：库存序/叠加层集/拒绝原因）
|
# 探针出口（断言面：库存序/叠加层集/拒绝原因）
|
||||||
func probe() -> Dictionary:
|
func probe() -> Dictionary:
|
||||||
return {
|
return {
|
||||||
"count": _items.size(),
|
"count": _items.size(),
|
||||||
|
|||||||
+24
-24
@@ -5,16 +5,16 @@
|
|||||||
class_name UnitContainer
|
class_name UnitContainer
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
# 死亡事件（伤害管线单据化批 2026-09-24 用户裁决③——单位自行宣布死亡）：apply_damage 扣血归零、
|
# 死亡事件（单位自行宣布死亡）：apply_damage 扣血归零、
|
||||||
# alive 翻 false 的同一时点发出；载荷 = 单位句柄（Dictionary 引用，is_hero 区分主角/敌）。
|
# alive 翻 false 的同一时点发出；载荷 = 单位句柄（Dictionary 引用，is_hero 区分主角/敌）。
|
||||||
# 消费方 = 伤害控制器（怪死 → 其未结单据作废〔死亡即不动手〕；主角死 → 兑付终止封印）。
|
# 消费方 = 伤害控制器（怪死 → 其未结单据作废〔死亡即不动手〕；主角死 → 兑付终止封印）。
|
||||||
signal unit_died(u: Dictionary)
|
signal unit_died(u: Dictionary)
|
||||||
|
|
||||||
var db: ConfigDb
|
var db: ConfigDb
|
||||||
# 单位容器私有（E3 封装收口 2026-09-13）：hero/enemies 原始数组不再外露——读取经 hero_unit()/
|
# 单位容器私有（E3 封装收口）：hero/enemies 原始数组不外露——读取经 hero_unit()/
|
||||||
# all_enemies() 投影面（死亡残位查询包含在内），写入只经 apply_damage/heal/set_pending_action/commit_action/
|
# all_enemies() 投影面（死亡残位查询包含在内），写入只经 apply_damage/heal/set_pending_action/commit_action/
|
||||||
# tick_cooldowns/spawn/despawn。
|
# tick_cooldowns/spawn/despawn。
|
||||||
# 句柄语义不变：投影返回的 Dictionary 引用即单位句柄（同 query_alive 先例）。
|
# 句柄语义：投影返回的 Dictionary 引用即单位句柄（同 query_alive）。
|
||||||
var _hero: Dictionary[String, Variant] = {} # {hp, max_hp, atk, is_hero: true}
|
var _hero: Dictionary[String, Variant] = {} # {hp, max_hp, atk, is_hero: true}
|
||||||
var _enemies: Array[Dictionary] = [] # 行主序生成序；元素 = 单位 Dictionary
|
var _enemies: Array[Dictionary] = [] # 行主序生成序；元素 = 单位 Dictionary
|
||||||
var _spawned := false
|
var _spawned := false
|
||||||
@@ -25,12 +25,12 @@ func _init(db_ref: ConfigDb) -> void:
|
|||||||
db = db_ref
|
db = db_ref
|
||||||
|
|
||||||
|
|
||||||
# E4 收口（2026-09-13）：加成值经参数显式传入（atk_override/max_hp_override，-1 = 表值兜底）——
|
# E4 收口：加成值经参数显式传入（atk_override/max_hp_override，-1 = 表值兜底）——
|
||||||
# 此前调用方写 db.hero 表值再由本类读表 = 共享可变单例传参（双写叠加 6→18→54 教训根源）。
|
# 调用方写 db.hero 表值再由本类读表 = 共享可变单例传参（双写叠加教训根源）。
|
||||||
# enemy_atk_override（2026-09-14 敌方攻击区间批）：遭遇骰同流的 spawn 期整战持久 roll 结果
|
# enemy_atk_override：遭遇骰同流的 spawn 期整战持久 roll 结果
|
||||||
# （-1 = 表值定值路径；≥0 = 行值替换后再乘关卡 atk_mult）。敌人系统 零随机纪律保持。
|
# （-1 = 表值定值路径；≥0 = 行值替换后再乘关卡 atk_mult）。敌人系统 零随机纪律保持。
|
||||||
# 行集受理换代（2026-10-07 行集多行批 P1 甲）：unit_count_overrides / enemy_atk_overrides 改**逐行数组**
|
# 行集受理：unit_count_overrides / enemy_atk_overrides 为**逐行数组**
|
||||||
# （下标=行集行序，长度短于行集时缺省 -1 = 该行行值路径；空数组 = 全行定值——旧调用点零适配）。
|
# （下标=行集行序，长度短于行集时缺省 -1 = 该行行值路径；空数组 = 全行定值）。
|
||||||
# 逐行实例化、生成序 = 文件行序（行序即契约，敌人系统 v0.15）；行集实例总数（各行传入数量求和）
|
# 逐行实例化、生成序 = 文件行序（行序即契约，敌人系统 v0.15）；行集实例总数（各行传入数量求和）
|
||||||
# ≤ ENEMY_ROWSET_INSTANCE_MAX 守卫 fail-fast。
|
# ≤ ENEMY_ROWSET_INSTANCE_MAX 守卫 fail-fast。
|
||||||
func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides: Array = [],
|
func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides: Array = [],
|
||||||
@@ -39,7 +39,7 @@ func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides
|
|||||||
if _spawned:
|
if _spawned:
|
||||||
push_warning("[敌人系统] Alive 相位重复 spawn（相位守卫）")
|
push_warning("[敌人系统] Alive 相位重复 spawn（相位守卫）")
|
||||||
return false
|
return false
|
||||||
# 行集数组口径（2026-10-07 行集多行批——resolver 返回该坐标全部行、文件序）
|
# 行集数组口径（resolver 返回该坐标全部行、文件序）
|
||||||
var rowset: Array[Variant] = db.resolve_enemy_rowset(level_index, node_depth)
|
var rowset: Array[Variant] = db.resolve_enemy_rowset(level_index, node_depth)
|
||||||
if rowset.is_empty():
|
if rowset.is_empty():
|
||||||
push_error("[敌人系统] 遭遇行解析失败/越域 (%d,%d)" % [level_index, node_depth])
|
push_error("[敌人系统] 遭遇行解析失败/越域 (%d,%d)" % [level_index, node_depth])
|
||||||
@@ -50,10 +50,10 @@ func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides
|
|||||||
if hero_hp > eff_max_hp or hero_hp <= 0:
|
if hero_hp > eff_max_hp or hero_hp <= 0:
|
||||||
push_warning("[敌人系统] hero_hp 入参越界（EC16）: %d" % hero_hp)
|
push_warning("[敌人系统] hero_hp 入参越界（EC16）: %d" % hero_hp)
|
||||||
return false
|
return false
|
||||||
# max_hp = 生效上限（非入参 hero_hp）——2026-09-11 关卡扩展批修复：跨战斗携带 HP 时上限不得压扁
|
# max_hp = 生效上限（非入参 hero_hp）——跨战斗携带 HP 时上限不得压扁
|
||||||
# （恢复点/治疗包的满血守卫与治疗上限随之失效——切片登记接口语义澄清）
|
# （恢复点/治疗包的满血守卫与治疗上限随之失效）
|
||||||
_hero = {"hp": hero_hp, "max_hp": eff_max_hp, "atk": eff_atk, "is_hero": true, "alive": true, "display_name": "探险者", "enemy_id": "hero", "armor_type": hero_armor_type if hero_armor_type != "" else db.forge_default_armor_type(), "attack_type": hero_attack_type if hero_attack_type != "" else db.forge_default_attack_type()} # 护甲/攻击类型轴快照（迭代 23 T2——hero.tres 两轴删除后改读注入值，空串回退锻造工坊配置默认值 normal/light=行为连续；甲效矩阵消费面）
|
_hero = {"hp": hero_hp, "max_hp": eff_max_hp, "atk": eff_atk, "is_hero": true, "alive": true, "display_name": "探险者", "enemy_id": "hero", "armor_type": hero_armor_type if hero_armor_type != "" else db.forge_default_armor_type(), "attack_type": hero_attack_type if hero_attack_type != "" else db.forge_default_attack_type()} # 护甲/攻击类型轴快照（读注入值，空串回退锻造工坊配置默认值 normal/light；甲效矩阵消费面）
|
||||||
_enemies.clear() # 难度曲线与Boss DifficultyTable 修饰（2026-09-12 结构位兑现）：施加于行值、行值快照之前——MVP 空表 = 恒 1.0 无行为（AC-10）；混编行集内全部敌种同乘（(L,D) 精确匹配一次取值——F9 同乘不改变异，敌人系统 v0.15）
|
_enemies.clear() # 难度曲线与Boss DifficultyTable 修饰：施加于行值、行值快照之前——MVP 空表 = 恒 1.0 无行为（AC-10）；混编行集内全部敌种同乘（(L,D) 精确匹配一次取值——F9 同乘不改变异，敌人系统 v0.15）
|
||||||
var mod: Dictionary[Variant, Variant] = db.resolve_difficulty_modifiers(level_index, node_depth)
|
var mod: Dictionary[Variant, Variant] = db.resolve_difficulty_modifiers(level_index, node_depth)
|
||||||
var hp_mult: float = float(mod.get("hp_mult", 1.0))
|
var hp_mult: float = float(mod.get("hp_mult", 1.0))
|
||||||
var atk_mult: float = float(mod.get("atk_mult", 1.0))
|
var atk_mult: float = float(mod.get("atk_mult", 1.0))
|
||||||
@@ -88,7 +88,7 @@ func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides
|
|||||||
"weight": int(entry.get("weight", 0)),
|
"weight": int(entry.get("weight", 0)),
|
||||||
"cooldown_left": 0,
|
"cooldown_left": 0,
|
||||||
}
|
}
|
||||||
# Boss 半血解锁技（迭代14④ T3——unlock_hp_pct 随池模板快照进实例池；缺省无字段=无门槛；
|
# Boss 半血解锁技（unlock_hp_pct 随池模板快照进实例池；缺省无字段=无门槛；
|
||||||
# unlocked=单向闩标记，初始锁定）
|
# unlocked=单向闩标记，初始锁定）
|
||||||
if entry.has("unlock_hp_pct"):
|
if entry.has("unlock_hp_pct"):
|
||||||
snap_entry["unlock_hp_pct"] = int(entry.get("unlock_hp_pct", 0))
|
snap_entry["unlock_hp_pct"] = int(entry.get("unlock_hp_pct", 0))
|
||||||
@@ -103,11 +103,11 @@ func spawn(level_index: int, node_depth: int, hero_hp: int, unit_count_overrides
|
|||||||
"atk": maxi(0, int(round(float(eff_row_atk) * atk_mult))),
|
"atk": maxi(0, int(round(float(eff_row_atk) * atk_mult))),
|
||||||
"pool": pool_snap, # 实例池（模板快照 + 冷却状态——独立摇号互不干涉）
|
"pool": pool_snap, # 实例池（模板快照 + 冷却状态——独立摇号互不干涉）
|
||||||
"pending_skill": "", # 本拍摇定动作（开轮摇号写入；兑现前死亡 = 作废不 commit）
|
"pending_skill": "", # 本拍摇定动作（开轮摇号写入；兑现前死亡 = 作废不 commit）
|
||||||
"roll_seq": 0, # 单敌摇号拍序（诊断标签——并流后不参与派生，2026-09-27 统一流裁决）
|
"roll_seq": 0, # 单敌摇号拍序（诊断标签——不参与派生）
|
||||||
"basic_streak": 0, # 保底计数：连续执行普攻的拍数（执行上报驱动）
|
"basic_streak": 0, # 保底计数：连续执行普攻的拍数（执行上报驱动）
|
||||||
"armor_type": String(row.get("armor_type", "light")), # 护甲类型快照（克制矩阵消费面——战斗结算·战斗段；2026-09-15 命名统一批：light/ward/heavy）
|
"armor_type": String(row.get("armor_type", "light")), # 护甲类型快照（克制矩阵消费面——战斗结算·战斗段：light/ward/heavy）
|
||||||
"armor_class": int(row.get("armor_class", 0)), # 护甲等级快照（掷点判定阈值基数——战斗结算·战斗段；2026-09-16 护甲等级掷点批）
|
"armor_class": int(row.get("armor_class", 0)), # 护甲等级快照（掷点判定阈值基数——战斗结算·战斗段）
|
||||||
"attack_type": String(row.get("attack_type", "normal")), # 攻击类型快照（克制矩阵消费面——敌方伤害单据第 9 参；迭代 24 N3 轴开列，缺省 normal 向后兼容）
|
"attack_type": String(row.get("attack_type", "normal")), # 攻击类型快照（克制矩阵消费面——敌方伤害单据第 9 参；缺省 normal）
|
||||||
"alive": true,
|
"alive": true,
|
||||||
"is_hero": false,
|
"is_hero": false,
|
||||||
})
|
})
|
||||||
@@ -130,9 +130,9 @@ func query_alive(side: String) -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# ---- 实例池状态机（敌人技能池批——全部确定性状态，随机在 战斗结算换算层）----
|
# ---- 实例池状态机（全部确定性状态，随机在 战斗结算换算层）----
|
||||||
|
|
||||||
# 池条目锁定判定（迭代14④ Boss 半血解锁——带 unlock_hp_pct 且未过闩 = 锁定：双面过滤不进
|
# 池条目锁定判定（Boss 半血解锁——带 unlock_hp_pct 且未过闩 = 锁定：双面过滤不进
|
||||||
# 可摇集合与保底特殊技集合；解锁后即可摇，冷却初值 0）
|
# 可摇集合与保底特殊技集合；解锁后即可摇，冷却初值 0）
|
||||||
func _entry_locked(e: Dictionary) -> bool:
|
func _entry_locked(e: Dictionary) -> bool:
|
||||||
return e.has("unlock_hp_pct") and not bool(e.get("unlocked", false))
|
return e.has("unlock_hp_pct") and not bool(e.get("unlocked", false))
|
||||||
@@ -154,7 +154,7 @@ func rollable_skills(u: Dictionary) -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 特殊技集合（保底专用——proposal §2.1：必出特殊技、特殊技内按权重、不受冷却限制）：type ≠ 普攻的全部池条目。
|
# 特殊技集合（保底专用——proposal §2.1：必出特殊技、特殊技内按权重、不受冷却限制）：type ≠ 普攻的全部池条目。
|
||||||
# 锁定条目（半血未解锁）双面过滤——保底不得逼出未解锁技（迭代14④ T3）。
|
# 锁定条目（半血未解锁）双面过滤——保底不得逼出未解锁技。
|
||||||
func special_skills(u: Dictionary) -> Array:
|
func special_skills(u: Dictionary) -> Array:
|
||||||
if u.is_empty() or _despawned or u.get("is_hero", false):
|
if u.is_empty() or _despawned or u.get("is_hero", false):
|
||||||
_diag("special_skills 失效句柄")
|
_diag("special_skills 失效句柄")
|
||||||
@@ -169,7 +169,7 @@ func special_skills(u: Dictionary) -> Array:
|
|||||||
return out
|
return out
|
||||||
|
|
||||||
|
|
||||||
# 半血解锁闩检查（迭代14④ T3——开轮摇号前逐敌检查；hp ≤ round(max_hp × unlock_hp_pct/100) →
|
# 半血解锁闩检查（开轮摇号前逐敌检查；hp ≤ round(max_hp × unlock_hp_pct/100) →
|
||||||
# 一次过门、单向闩〔实例标记，不解锁回退〕。门=确定性谓词零随机；返回本拍新解锁的 skill_id 列表
|
# 一次过门、单向闩〔实例标记，不解锁回退〕。门=确定性谓词零随机；返回本拍新解锁的 skill_id 列表
|
||||||
# 供编排层出归因行〔每技恰一次——闩已置位不再返回〕）
|
# 供编排层出归因行〔每技恰一次——闩已置位不再返回〕）
|
||||||
func check_skill_unlocks(u: Dictionary) -> Array:
|
func check_skill_unlocks(u: Dictionary) -> Array:
|
||||||
@@ -257,7 +257,7 @@ func apply_damage(u: Dictionary, n: int) -> bool:
|
|||||||
u.hp = maxi(0, u.hp - n)
|
u.hp = maxi(0, u.hp - n)
|
||||||
if u.hp == 0:
|
if u.hp == 0:
|
||||||
u.alive = false # Dead 不可逆（死亡判定时机归 战斗结算）
|
u.alive = false # Dead 不可逆（死亡判定时机归 战斗结算）
|
||||||
unit_died.emit(u) # 死亡事件——单位自行宣布（伤害管线单据化批 2026-09-24 用户裁决③）
|
unit_died.emit(u) # 死亡事件——单位自行宣布
|
||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
@@ -281,7 +281,7 @@ func default_target():
|
|||||||
|
|
||||||
# ---- 只读投影面（E3 封装收口：外部读单位经此，禁直读容器数组）----
|
# ---- 只读投影面（E3 封装收口：外部读单位经此，禁直读容器数组）----
|
||||||
|
|
||||||
# 主角句柄（未 spawn/despawn 后 = {}）——句柄即 Dictionary 引用（同 query_alive 先例）
|
# 主角句柄（未 spawn/despawn 后 = {}）——句柄即 Dictionary 引用（同 query_alive）
|
||||||
func hero_unit() -> Dictionary:
|
func hero_unit() -> Dictionary:
|
||||||
return _hero
|
return _hero
|
||||||
|
|
||||||
|
|||||||
@@ -4,11 +4,11 @@
|
|||||||
class_name ActionEconomyTable
|
class_name ActionEconomyTable
|
||||||
extends Resource
|
extends Resource
|
||||||
|
|
||||||
@export var ap_per_round: int = 6 # [1,32] knob（默认值 = 现行表值基线，2026-09-16 AP 压速批 8→6 随动）
|
@export var ap_per_round: int = 6 # [1,32] knob（默认值 = 现行表值基线，随 AP 压速调整）
|
||||||
@export var dig_ap_cost: int = 1 # [1,8] knob（域下限 1 = 零预算系统失效拒绝）
|
@export var dig_ap_cost: int = 1 # [1,8] knob（域下限 1 = 零预算系统失效拒绝）
|
||||||
@export var seal_place_ap_cost: int = 1 # [0,8] knob（seal_pull_ap_cost 随撤封印退役批 2026-09-19 删除）
|
@export var seal_place_ap_cost: int = 1 # [0,8] knob（无 seal_pull_ap_cost 字段——拔印不占 AP）
|
||||||
@export var rap_refresh_cost: int = 6 # [1,64] knob（默认值随 AP 压速批 8→6 随动）
|
@export var rap_refresh_cost: int = 6 # [1,64] knob（默认值随 AP 压速调整）
|
||||||
@export var refresh_cap_per_round: int = 2 # [1,8] knob（2026-09-12 轮内刷新批——每轮刷新兜底上限，Active/Waiting 合计）
|
@export var refresh_cap_per_round: int = 2 # [1,8] knob（每轮刷新兜底上限，Active/Waiting 合计）
|
||||||
@export var move_ap_cost: int = 0 # 冻结 0（P4 氛围承载）
|
@export var move_ap_cost: int = 0 # 冻结 0（P4 氛围承载）
|
||||||
@export var chain_ap_cost: int = 0 # 冻结 0（v2 定稿）
|
@export var chain_ap_cost: int = 0 # 冻结 0（v2 定稿）
|
||||||
|
|
||||||
|
|||||||
@@ -9,44 +9,44 @@ extends Resource
|
|||||||
## 「奇物」（一次冒险内各渠道给予玩家的增益总称）。定义见 design/gdd/systems/冒险循环/奇物.md。
|
## 「奇物」（一次冒险内各渠道给予玩家的增益总称）。定义见 design/gdd/systems/冒险循环/奇物.md。
|
||||||
## 它们是它的分类轴上的枚举（专长 / 属性值提升 / 资源），不是三套系统；
|
## 它们是它的分类轴上的枚举（专长 / 属性值提升 / 资源），不是三套系统；
|
||||||
## 本表承载属性值提升与资源的种类配额与件值。
|
## 本表承载属性值提升与资源的种类配额与件值。
|
||||||
## （2026-10-05 命名统一 + v2.0 改名：旧称「数值件」→ 属性提升；顶层「特性」→「奖励」→「奇物」。
|
## （顶层总称=奇物；属性值提升与资源是本表承载的两类。
|
||||||
## 常量与字段随之前缀 curio_*，**尚未**随顶层改名换到 reward_*——见 06-待办清单。
|
## 常量与字段前缀 curio_*，**尚未**换到 reward_*——见 06-待办清单。
|
||||||
## 分类轴三个枚举：属性值提升〔生命上限 / AC / 攻击〕；资源〔行动点上限 /
|
## 分类轴三个枚举：属性值提升〔生命上限 / AC / 攻击〕；资源〔行动点上限 /
|
||||||
## 刷新次数 / GP / 回复，命名待定〕——本表两类混编；刷新次数与专长获取两项尚未入表。
|
## 刷新次数 / GP / 回复，命名待定〕——本表两类混编；刷新次数与专长获取两项尚未入表。
|
||||||
## 类内异质性：GP与回复是即时兑付，不进持有集、不持续生效。）
|
## 类内异质性：GP与回复是即时兑付，不进持有集、不持续生效。）
|
||||||
## 三选一提升池 kind 词表（封闭——断点附随件与牌库剔除态依赖它；扩件走本表+registry 修订）。
|
## 三选一提升池 kind 词表（封闭——断点附随件与牌库剔除态依赖它；扩件走本表+registry 修订）。
|
||||||
## treasure_item 池种退役（迭代 11 第①批 T7——同调批出池）；heal 恢复件新入池（v2.2 令牌池追认 b）。
|
## treasure_item 不在池种内（已出池）；heal 恢复件在池（v2.2 令牌池口径）。
|
||||||
## 迭代 20 T4 资源凭证入池五件；迭代 31 卡② 凭证件裁削批（用户 2026-10-18 逐裁）两件出池：
|
## 资源凭证入池五件，两件出池：
|
||||||
## 同调电池整件删除（呈现层零接线、玩家无分配途径——有 API 有账本唯独没有入口）；
|
## 同调电池整件删除（呈现层零接线、玩家无分配途径——有 API 有账本唯独没有入口）；
|
||||||
## 完美保险整件迁出资源类归专长（它给的是规则豁免而非可调动的余量——判据见奇物.md §1.1，
|
## 完美保险整件迁出资源类归专长（它给的是规则豁免而非可调动的余量——判据见奇物.md §1.1，
|
||||||
## 落表 feats.tres 第 30 行，效果类型 forgive_seal_miss）。留任 rap 储备金袋/time_sand 时沙。
|
## 落表 feats.tres 第 30 行，效果类型 forgive_seal_miss）。留任 rap 储备金袋/time_sand 时沙。
|
||||||
const CURIO_KINDS: Array[String] = ["attack", "max_hp", "armor", "gp", "ap", "heal", "refresh",
|
const CURIO_KINDS: Array[String] = ["attack", "max_hp", "armor", "gp", "ap", "heal", "refresh",
|
||||||
"rap", "time_sand"] # T6 扩第七类（refresh=资源类成员——作为奇物授予的三选一重抽次数，作用对象=三选一界面非角色；见 registry refresh_boundary）
|
"rap", "time_sand"] # 第七类（refresh=资源类成员——作为奇物授予的三选一重抽次数，作用对象=三选一界面非角色；见 registry refresh_boundary）
|
||||||
## 令牌档位词表（迭代 20 T2 换代——跨层四级稀有度框架〔01-核心循环 v1.5 档名映射：普通→普通、
|
## 令牌档位词表（跨层四级稀有度框架〔01-核心循环 v1.5 档名映射：普通→普通、
|
||||||
## 稀有→优秀、罕见→稀有、传说=新增头奖位〕；1 级最稀有=legendary 优先）
|
## 稀有→优秀、罕见→稀有、传说=新增头奖位〕；1 级最稀有=legendary 优先）
|
||||||
const TIERS: Array[String] = ["common", "excellent", "rare", "legendary"]
|
const TIERS: Array[String] = ["common", "excellent", "rare", "legendary"]
|
||||||
const TIER_COMMON := "common"
|
const TIER_COMMON := "common"
|
||||||
const TIER_EXCELLENT := "excellent"
|
const TIER_EXCELLENT := "excellent"
|
||||||
const TIER_RARE := "rare"
|
const TIER_RARE := "rare"
|
||||||
const TIER_LEGENDARY := "legendary"
|
const TIER_LEGENDARY := "legendary"
|
||||||
## 档位配额结构锚（迭代 20 换代——T2 四级直映射 70/25/3/0；T4 凭证四件入稀有档投放 +6
|
## 档位配额结构锚（四级直映射 70/25/3/0；
|
||||||
## （rap 2/battery 1/时沙 2/保险 1）→ 稀有 9、总量 104；迭代 31 卡② 净删两件投放（battery 1/保险 1）
|
## 稀有档投放三 kind=ap 3/rap 2/时沙 2
|
||||||
## → 稀有 7、总量 102（用户裁「净删」，禁把令牌转给别件保住总量）。已裁换代授权内的 provisional 投放
|
## → 合计 稀有 7、总量 102（「净删」口径=出池件配额直接归零，禁转给别件保住总量）。provisional 投放
|
||||||
## （卡文 T2「四级配额表重构」+Q3 单迭代全量），偏离 GDD 占位记录随代拍板追认单呈报；
|
## （「四级配额表重构」+Q3 单迭代全量），偏离 GDD 占位记录随追认单呈报；
|
||||||
## validate() 硬断言；此后改总量=重裁非调参）。
|
## validate() 硬断言；此后改总量=重裁非调参）。
|
||||||
const TIER_QUOTAS := {"common": 70, "excellent": 25, "rare": 7, "legendary": 0}
|
const TIER_QUOTAS := {"common": 70, "excellent": 25, "rare": 7, "legendary": 0}
|
||||||
|
|
||||||
# —— 通关部分回血（固定型，非末关通关兑付）——
|
# —— 通关部分回血（固定型，非末关通关兑付）——
|
||||||
@export var clear_heal_pct: int = 20 # [0,100] knob——回复生效上限的百分比，封顶上限不回满
|
@export var clear_heal_pct: int = 20 # [0,100] knob——回复生效上限的百分比，封顶上限不回满
|
||||||
|
|
||||||
# —— 三选一候选数（2026-10-02 修复批 T2 魔法数结构化）——
|
# —— 三选一候选数——
|
||||||
@export var curio_candidate_count: int = 3 # [1,6] knob——令牌洗牌不放回抽取张数上界
|
@export var curio_candidate_count: int = 3 # [1,6] knob——令牌洗牌不放回抽取张数上界
|
||||||
@export var shop_refresh_free: int = 0 # [0,9] knob（MC-1 provisional——进店免费刷新次数；基础 0=Q2 裁，天赋增益位预留）
|
@export var shop_refresh_free: int = 0 # [0,9] knob（MC-1 provisional——进店免费刷新次数；基础 0=Q2 裁，天赋增益位预留）
|
||||||
@export var shop_refresh_cost_base: int = 20 # [1,999] knob（MC-1 provisional——GP 刷新基价）
|
@export var shop_refresh_cost_base: int = 20 # [1,999] knob（MC-1 provisional——GP 刷新基价）
|
||||||
@export var shop_refresh_cost_curve: float = 1.8 # [1.0,4.0] knob（MC-1 provisional——按已付费刷新数幂曲线，A 链同族）
|
@export var shop_refresh_cost_curve: float = 1.8 # [1.0,4.0] knob（MC-1 provisional——按已付费刷新数幂曲线，A 链同族）
|
||||||
|
|
||||||
# —— 令牌配额（kind × tier 计数；未列组合 = 0。迭代 20 T2 四级换代：旧 rare→excellent、
|
# —— 令牌配额（kind × tier 计数；未列组合 = 0。四级档名 common/excellent/rare/legendary
|
||||||
# 旧 rarest→rare 物理承袭〔70/25/3 零偏离〕+凭证四 kind 占位 rare 档配额 0〔T4 落路由同批投放〕）——
|
# 承袭同一物理位序〔70/25/3 零偏离〕；资源凭证 kind 的 rare 档配额见各行现值）——
|
||||||
@export var curio_quota_attack_common: int = 18 # [0,99]
|
@export var curio_quota_attack_common: int = 18 # [0,99]
|
||||||
@export var curio_quota_attack_excellent: int = 5 # [0,99]
|
@export var curio_quota_attack_excellent: int = 5 # [0,99]
|
||||||
@export var curio_quota_max_hp_common: int = 17 # [0,99]
|
@export var curio_quota_max_hp_common: int = 17 # [0,99]
|
||||||
@@ -55,13 +55,13 @@ const TIER_QUOTAS := {"common": 70, "excellent": 25, "rare": 7, "legendary": 0}
|
|||||||
@export var curio_quota_armor_excellent: int = 5 # [0,99]
|
@export var curio_quota_armor_excellent: int = 5 # [0,99]
|
||||||
@export var curio_quota_gp_common: int = 18 # [0,99]
|
@export var curio_quota_gp_common: int = 18 # [0,99]
|
||||||
@export var curio_quota_gp_excellent: int = 5 # [0,99]
|
@export var curio_quota_gp_excellent: int = 5 # [0,99]
|
||||||
@export var curio_quota_heal_excellent: int = 3 # [0,99]——恢复件（原 5；T6 挤占 2 席位予 refresh——用户 2026-10-05 裁方案B，总量 98 锚不变）
|
@export var curio_quota_heal_excellent: int = 3 # [0,99]——恢复件（refresh 挤占 2 席位，总量 98 锚不变）
|
||||||
@export var curio_quota_refresh_excellent: int = 2 # [0,99]——刷新次数件（T6 新入池资源类成员；provisional 归曲线调参批）
|
@export var curio_quota_refresh_excellent: int = 2 # [0,99]——刷新次数件（资源类成员；provisional 归曲线调参）
|
||||||
@export var curio_quota_ap_rare: int = 3 # [0,99]——AP 件（稀有档；旧罕见档物理承袭）
|
@export var curio_quota_ap_rare: int = 3 # [0,99]——AP 件（稀有档）
|
||||||
@export var curio_quota_rap_rare: int = 2 # [0,99]——储备金袋（T4 投放 provisional 归调参批）
|
@export var curio_quota_rap_rare: int = 2 # [0,99]——储备金袋（投放 provisional 归调参）
|
||||||
@export var curio_quota_time_sand_rare: int = 2 # [0,99]——时沙（T4 投放 provisional 归调参批）
|
@export var curio_quota_time_sand_rare: int = 2 # [0,99]——时沙（投放 provisional 归调参）
|
||||||
|
|
||||||
# —— 令牌件值（小/大数值对——v2.2 追认 b 定稿：20/50、+1/+2、+1/+2、+5/+10、恢复+6、AP+1）——
|
# —— 令牌件值（小/大数值对——v2.2 令牌池口径定稿：20/50、+1/+2、+1/+2、+5/+10、恢复+6、AP+1）——
|
||||||
@export var curio_value_attack_common: int = 1 # [0,999] knob——小增伤
|
@export var curio_value_attack_common: int = 1 # [0,999] knob——小增伤
|
||||||
@export var curio_value_attack_excellent: int = 2 # [0,999] knob——大增伤
|
@export var curio_value_attack_excellent: int = 2 # [0,999] knob——大增伤
|
||||||
@export var curio_value_max_hp_common: int = 5 # [0,999] knob——小生命
|
@export var curio_value_max_hp_common: int = 5 # [0,999] knob——小生命
|
||||||
@@ -76,9 +76,9 @@ const TIER_QUOTAS := {"common": 70, "excellent": 25, "rare": 7, "legendary": 0}
|
|||||||
@export var curio_value_rap_rare: int = 3 # [0,99] knob（provisional）——储备金袋 RAP +N
|
@export var curio_value_rap_rare: int = 3 # [0,99] knob（provisional）——储备金袋 RAP +N
|
||||||
@export var curio_value_time_sand_rare: int = 2 # [0,99] knob（provisional）——时沙 下轮 AP +N
|
@export var curio_value_time_sand_rare: int = 2 # [0,99] knob（provisional）——时沙 下轮 AP +N
|
||||||
|
|
||||||
# —— 已拿上限 cap（迭代 20 T2 概率与上限解耦〔奇物.md 池结构案D〕——案②令牌池+提前退役：
|
# —— 已拿上限 cap（概率与上限解耦〔奇物.md 池结构案D〕——案②令牌池+提前退役：
|
||||||
# 概率位=档+令牌数〔牌库物理张数〕、上限=本字段〔拿了才计、刷出不计〕；cap 满后该 kind 从候选
|
# 概率位=档+令牌数〔牌库物理张数〕、上限=本字段〔拿了才计、刷出不计〕；cap 满后该 kind 从候选
|
||||||
# 视图剔除〔提前退役〕。99=实质无上限占位，实数归调参批；专长 cap 在 feats.tres 行字段〕）——
|
# 视图剔除〔提前退役〕。99=实质无上限占位，实数归调参；专长 cap 在 feats.tres 行字段〕）——
|
||||||
@export var curio_cap_attack: int = 99 # [1,99]
|
@export var curio_cap_attack: int = 99 # [1,99]
|
||||||
@export var curio_cap_max_hp: int = 99 # [1,99]
|
@export var curio_cap_max_hp: int = 99 # [1,99]
|
||||||
@export var curio_cap_armor: int = 99 # [1,99]
|
@export var curio_cap_armor: int = 99 # [1,99]
|
||||||
@@ -89,10 +89,10 @@ const TIER_QUOTAS := {"common": 70, "excellent": 25, "rare": 7, "legendary": 0}
|
|||||||
@export var curio_cap_rap: int = 99 # [1,99]
|
@export var curio_cap_rap: int = 99 # [1,99]
|
||||||
@export var curio_cap_time_sand: int = 99 # [1,99]
|
@export var curio_cap_time_sand: int = 99 # [1,99]
|
||||||
|
|
||||||
# —— 专长获取门票（迭代 15 卡② T5——非 Boss 渠道的专长入口形态，奇物.md v2.7 渠道轴定位；
|
# —— 专长获取门票（非 Boss 渠道的专长入口形态，奇物.md v2.7 渠道轴定位；
|
||||||
# 四口径契约④：拿到即开不可囤积/罕见只在概率不在价格/一局限购一次/计步保底连续 5 展示未出
|
# 四口径契约④：拿到即开不可囤积/罕见只在概率不在价格/一局限购一次/计步保底连续 5 展示未出
|
||||||
# 第 6 必出（计数=展示次数、刷新重展计入、节点与商店共享、触发清零、限购满不再触发）。
|
# 第 6 必出（计数=展示次数、刷新重展计入、节点与商店共享、触发清零、限购满不再触发）。
|
||||||
# 四参数全部 provisional 归曲线调参批；limit/pity_step 系口径定死值调参批可复议）——
|
# 四参数全部 provisional 归曲线调参；limit/pity_step 系口径定死值，调参可复议）——
|
||||||
@export var feat_ticket_chance: int = 20 # [0,100] knob（provisional）——每次非 Boss 渠道展示门票出现概率 %
|
@export var feat_ticket_chance: int = 20 # [0,100] knob（provisional）——每次非 Boss 渠道展示门票出现概率 %
|
||||||
@export var feat_ticket_quota: int = 2 # [0,9] knob（provisional）——每局门票出现次数上限
|
@export var feat_ticket_quota: int = 2 # [0,9] knob（provisional）——每局门票出现次数上限
|
||||||
@export var feat_ticket_limit: int = 1 # [1,9] knob（口径定死=1）——一局限购（选中/买下）次数
|
@export var feat_ticket_limit: int = 1 # [1,9] knob（口径定死=1）——一局限购（选中/买下）次数
|
||||||
@@ -116,8 +116,8 @@ func curio_apply_route(kind: String) -> String:
|
|||||||
return String(CURIO_APPLY_ROUTES.get(kind, ""))
|
return String(CURIO_APPLY_ROUTES.get(kind, ""))
|
||||||
|
|
||||||
|
|
||||||
## 令牌配额读数（未列 kind×tier 组合 = 0——迭代 20 T2 四级构成：属性四类 common/excellent、
|
## 令牌配额读数（未列 kind×tier 组合 = 0——四级构成：属性四类 common/excellent、
|
||||||
## heal/refresh excellent、ap rare、凭证四 kind rare 占位 0）
|
## heal/refresh excellent、ap rare、凭证 kind rare 档）
|
||||||
func curio_quota(kind: String, tier: String) -> int:
|
func curio_quota(kind: String, tier: String) -> int:
|
||||||
match [kind, tier]:
|
match [kind, tier]:
|
||||||
["attack", TIER_COMMON]: return curio_quota_attack_common
|
["attack", TIER_COMMON]: return curio_quota_attack_common
|
||||||
@@ -155,7 +155,7 @@ func curio_value(kind: String, tier: String = TIER_COMMON) -> int:
|
|||||||
return 0
|
return 0
|
||||||
|
|
||||||
|
|
||||||
## 已拿上限读数（迭代 20 T2 案②——kind 维度；专长 cap 走 feats.tres 行字段不走本面）
|
## 已拿上限读数（案②——kind 维度；专长 cap 走 feats.tres 行字段不走本面）
|
||||||
func curio_cap(kind: String) -> int:
|
func curio_cap(kind: String) -> int:
|
||||||
match kind:
|
match kind:
|
||||||
"attack": return curio_cap_attack
|
"attack": return curio_cap_attack
|
||||||
@@ -170,8 +170,8 @@ func curio_cap(kind: String) -> int:
|
|||||||
return 99
|
return 99
|
||||||
|
|
||||||
|
|
||||||
## Boss 专长三选一按档配比加权（迭代 20 T5——奇物.md v3.1 rarity 语义约束「候选按档配比或
|
## Boss 专长三选一按档配比加权（奇物.md v3.1 rarity 语义约束「候选按档配比或
|
||||||
## 加权抽取」兑付面；权重 provisional 归调参批——普通打底/优秀期待/稀有稀缺/传说头奖形态）
|
## 加权抽取」兑付面；权重 provisional 归调参——普通打底/优秀期待/稀有稀缺/传说头奖形态）
|
||||||
func boss_feat_weight(tier: String) -> int:
|
func boss_feat_weight(tier: String) -> int:
|
||||||
match tier:
|
match tier:
|
||||||
TIER_COMMON: return 100
|
TIER_COMMON: return 100
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ extends Resource
|
|||||||
const SOLVER_RULES := ["single", "single_subset"]
|
const SOLVER_RULES := ["single", "single_subset"]
|
||||||
const COST_BUDGET := 16384 # F2c provisional 量级护栏（禁墙钟逃生）
|
const COST_BUDGET := 16384 # F2c provisional 量级护栏（禁墙钟逃生）
|
||||||
const TARGET_ABS_FLOOR := 0.85 # 战斗结算 修订——target 域下限（P1 绝对锚）
|
const TARGET_ABS_FLOOR := 0.85 # 战斗结算 修订——target 域下限（P1 绝对锚）
|
||||||
const BOARD_TYPE_VOCABULARY := ["dungeon", "underdark", "deep_underdark"] # 图类型词表 v1.1（2026-09-20 L3 内容批 +deep_underdark 灰矮人矿道；玩家侧显示名「地图类型」）
|
const BOARD_TYPE_VOCABULARY := ["dungeon", "underdark", "deep_underdark"] # 图类型词表 v1.1（含 deep_underdark 灰矮人矿道；玩家侧显示名「地图类型」）
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
@@ -49,7 +49,7 @@ func validate() -> Array:
|
|||||||
var att: int = int(row.get("max_gen_attempts", 0))
|
var att: int = int(row.get("max_gen_attempts", 0))
|
||||||
if att < 1 or att > 32:
|
if att < 1 or att > 32:
|
||||||
errs.append({"category": "domain", "message": "(%d,%d) max_gen_attempts 越域 [1,32]" % [L, D]})
|
errs.append({"category": "domain", "message": "(%d,%d) max_gen_attempts 越域 [1,32]" % [L, D]})
|
||||||
# 布雷数下限（R3）——零雷板拒绝（−9 = 出生区格数，常量单点 BoardData.SPAWN_AREA_CELLS——2026-10-02 修复批）
|
# 布雷数下限（R3）——零雷板拒绝（−9 = 出生区格数，常量单点 BoardData.SPAWN_AREA_CELLS）
|
||||||
var n_mines := int(round(d * float(w * h - BoardData.SPAWN_AREA_CELLS)))
|
var n_mines := int(round(d * float(w * h - BoardData.SPAWN_AREA_CELLS)))
|
||||||
if n_mines < 1:
|
if n_mines < 1:
|
||||||
errs.append({"category": "cross_field", "message": "(%d,%d) 布雷数下限违例 round(d×(W×H−9)) ≥ 1" % [L, D]})
|
errs.append({"category": "cross_field", "message": "(%d,%d) 布雷数下限违例 round(d×(W×H−9)) ≥ 1" % [L, D]})
|
||||||
@@ -59,11 +59,11 @@ func validate() -> Array:
|
|||||||
# F2c 成本可行性
|
# F2c 成本可行性
|
||||||
if att * w * h > COST_BUDGET:
|
if att * w * h > COST_BUDGET:
|
||||||
errs.append({"category": "cross_field", "message": "(%d,%d) cost_feasible 违例 attempts×W×H ≤ %d" % [L, D, COST_BUDGET]})
|
errs.append({"category": "cross_field", "message": "(%d,%d) cost_feasible 违例 attempts×W×H ≤ %d" % [L, D, COST_BUDGET]})
|
||||||
# 图类型词表 v1.0（2026-09-19 用户拍板定稿：dungeon=地牢基线 / underdark=幽暗地域；扩词随内容批走修订）
|
# 图类型词表 v1.0（dungeon=地牢基线 / underdark=幽暗地域；扩词走本表修订）
|
||||||
var bt: String = str(row.get("board_type", ""))
|
var bt: String = str(row.get("board_type", ""))
|
||||||
if not BOARD_TYPE_VOCABULARY.has(bt):
|
if not BOARD_TYPE_VOCABULARY.has(bt):
|
||||||
errs.append({"category": "cross_field", "message": "(%d,%d) board_type 越词表: %s" % [L, D, bt]})
|
errs.append({"category": "cross_field", "message": "(%d,%d) board_type 越词表: %s" % [L, D, bt]})
|
||||||
# 初始展开收窄批两参数（迭代14① T1——加载期校验违例致命；缺省 shave=1 现行投值 / cap=0 闸关防御口径）
|
# 初始展开收窄两参数（加载期校验违例致命；缺省 shave=1 现行投值 / cap=0 闸关防御口径）
|
||||||
var sr: int = int(row.get("shave_ring_radius", 1))
|
var sr: int = int(row.get("shave_ring_radius", 1))
|
||||||
if sr < 0 or sr > 2:
|
if sr < 0 or sr > 2:
|
||||||
errs.append({"category": "domain", "message": "(%d,%d) shave_ring_radius 越域 [0,2]: %d" % [L, D, sr]})
|
errs.append({"category": "domain", "message": "(%d,%d) shave_ring_radius 越域 [0,2]: %d" % [L, D, sr]})
|
||||||
|
|||||||
@@ -7,23 +7,23 @@ extends Resource
|
|||||||
|
|
||||||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||||||
|
|
||||||
# 护甲类型封闭枚举（攻击类型 × 护甲克制批——克制矩阵本体在 SettlementTable；
|
# 护甲类型封闭枚举（克制矩阵本体在 SettlementTable；
|
||||||
# 2026-09-15 命名统一批：位置键 {none, a, b} → 语义键 {light, ward, heavy} = 轻甲 / 魔法护甲 / 重甲）
|
# 语义键 {light, ward, heavy} = 轻甲 / 魔法护甲 / 重甲）
|
||||||
const ARMOR_TYPES := ["light", "ward", "heavy"]
|
const ARMOR_TYPES := ["light", "ward", "heavy"]
|
||||||
|
|
||||||
# 攻击类型封闭枚举（迭代 24 N3 2026-10-13——敌方攻击类型轴开列，承接锻造工坊迁移面⑥；
|
# 攻击类型封闭枚举（敌方攻击类型轴开列，承接锻造工坊迁移面⑥；
|
||||||
# 克制矩阵点数制键前缀 = 本枚举：normal → light 0 / ward +1 / heavy −1；pierce/magic 为差异化
|
# 克制矩阵点数制键前缀 = 本枚举：normal → light 0 / ward +1 / heavy −1；pierce/magic 为差异化
|
||||||
# 预留档，差异化填值属新设计另立项。可省略 + 缺省 normal 向后兼容）
|
# 预留档，差异化填值属新设计另立项。可省略 + 缺省 normal 向后兼容）
|
||||||
const ATTACK_TYPES := ["normal", "pierce", "magic"]
|
const ATTACK_TYPES := ["normal", "pierce", "magic"]
|
||||||
|
|
||||||
# 实例化数量域（2026-10-02 修复批 T2 魔法数结构化——数量域 [1,3] 双落点收口单点：
|
# 实例化数量域（域 [1,3] 双落点收口单点：
|
||||||
# 本表 validate 与 单位容器 spawn 守卫共用；遭遇骰结果与行值 unit_count/unit_count_max 同域。
|
# 本表 validate 与 单位容器 spawn 守卫共用；遭遇骰结果与行值 unit_count/unit_count_max 同域。
|
||||||
# 2026-10-07 行集多行批：MAX 语义 = **单种数**（单行实例数上限），行集实例总数 ≤4 另由
|
# MAX 语义 = **单种数**（单行实例数上限），行集实例总数 ≤4 另由
|
||||||
# spawn 期守卫承担——骰后值加载期不可判，双闸分工见 敌人系统 v0.15 行集构成纪律③）
|
# spawn 期守卫承担——骰后值加载期不可判，双闸分工见 敌人系统 v0.15 行集构成纪律③）
|
||||||
const UNIT_COUNT_MIN := 1
|
const UNIT_COUNT_MIN := 1
|
||||||
const UNIT_COUNT_MAX := 3
|
const UNIT_COUNT_MAX := 3
|
||||||
|
|
||||||
# 行集实例总数上限（2026-10-07 行集多行批 P1 甲——行集构成纪律③：各行开战骰后数量求和 ≤4；
|
# 行集实例总数上限（行集构成纪律③：各行开战骰后数量求和 ≤4；
|
||||||
# 「总数」= 实例数非行数〔Q9 二裁〕，行数不设上限。骰后值加载期不可判——守卫在 单位容器 spawn，
|
# 「总数」= 实例数非行数〔Q9 二裁〕，行数不设上限。骰后值加载期不可判——守卫在 单位容器 spawn，
|
||||||
# 常量单点在本表与数量域同位收口）
|
# 常量单点在本表与数量域同位收口）
|
||||||
const ROWSET_INSTANCE_MAX := 4
|
const ROWSET_INSTANCE_MAX := 4
|
||||||
@@ -66,7 +66,7 @@ func validate() -> Array:
|
|||||||
var atk: int = int(row.get("atk", -1))
|
var atk: int = int(row.get("atk", -1))
|
||||||
if atk < 0 or atk > 999:
|
if atk < 0 or atk > 999:
|
||||||
errs.append({"category": "domain", "message": "%s atk 越域 [0,999]" % eid})
|
errs.append({"category": "domain", "message": "%s atk 越域 [0,999]" % eid})
|
||||||
# atk_min/atk_max（可省略配对——2026-09-14 敌方攻击区间批）：遭遇骰同流 spawn 期整战持久 roll；
|
# atk_min/atk_max（可省略配对）：遭遇骰同流 spawn 期整战持久 roll；
|
||||||
# 中点锚 = 行动经济 条款①同款期望当量纪律（调区间必同步调 atk）
|
# 中点锚 = 行动经济 条款①同款期望当量纪律（调区间必同步调 atk）
|
||||||
var has_amin: bool = row.has("atk_min")
|
var has_amin: bool = row.has("atk_min")
|
||||||
var has_amax: bool = row.has("atk_max")
|
var has_amax: bool = row.has("atk_max")
|
||||||
@@ -79,7 +79,7 @@ func validate() -> Array:
|
|||||||
errs.append({"category": "domain", "message": "%s atk 区间越域 [0,999] 且 min≤max: %d..%d" % [eid, amin, amax]})
|
errs.append({"category": "domain", "message": "%s atk 区间越域 [0,999] 且 min≤max: %d..%d" % [eid, amin, amax]})
|
||||||
if atk != int((amin + amax) / 2.0):
|
if atk != int((amin + amax) / 2.0):
|
||||||
errs.append({"category": "cross_field", "message": "%s atk(%d) ≠ 区间中点(%d)——中点恒等期望当量锚" % [eid, atk, (amin + amax) / 2]})
|
errs.append({"category": "cross_field", "message": "%s atk(%d) ≠ 区间中点(%d)——中点恒等期望当量锚" % [eid, atk, (amin + amax) / 2]})
|
||||||
# 池模板（敌人技能池批——单表结构校验；跨表构成纪律在 ConfigDB）：
|
# 池模板（单表结构校验；跨表构成纪律在 ConfigDB）：
|
||||||
# 非空池 + 条目 {skill_id 非空, weight > 0} + 池内 skill_id 不重复。
|
# 非空池 + 条目 {skill_id 非空, weight > 0} + 池内 skill_id 不重复。
|
||||||
# 普攻冷却恒 0（SkillTable schema 锁死）→ 可摇集合恒非空，"空池不可能"由此结构保证。
|
# 普攻冷却恒 0（SkillTable schema 锁死）→ 可摇集合恒非空，"空池不可能"由此结构保证。
|
||||||
var pool: Array[Variant] = row.get("pool", [])
|
var pool: Array[Variant] = row.get("pool", [])
|
||||||
@@ -100,7 +100,7 @@ func validate() -> Array:
|
|||||||
var w: int = int(entry.get("weight", 0))
|
var w: int = int(entry.get("weight", 0))
|
||||||
if w <= 0 or w > 9999:
|
if w <= 0 or w > 9999:
|
||||||
errs.append({"category": "domain", "message": "%s pool 权重越域 (0,9999]: %d" % [eid, w]})
|
errs.append({"category": "domain", "message": "%s pool 权重越域 (0,9999]: %d" % [eid, w]})
|
||||||
# unlock_hp_pct（可省略——迭代14④ Boss 半血解锁技：缺省无字段=无门槛；域 [1,99] percent。
|
# unlock_hp_pct（可省略——Boss 半血解锁技：缺省无字段=无门槛；域 [1,99] percent。
|
||||||
# 投放纪律=仅 Boss 行〔enemy 表无 boss 编码位，硬闸须跨表查节点类型——不做硬闸，文档纪律登记〕）
|
# 投放纪律=仅 Boss 行〔enemy 表无 boss 编码位，硬闸须跨表查节点类型——不做硬闸，文档纪律登记〕）
|
||||||
if entry.has("unlock_hp_pct"):
|
if entry.has("unlock_hp_pct"):
|
||||||
var uhp: int = int(entry.get("unlock_hp_pct", 0))
|
var uhp: int = int(entry.get("unlock_hp_pct", 0))
|
||||||
@@ -110,17 +110,17 @@ func validate() -> Array:
|
|||||||
var at: String = String(row.get("armor_type", "light"))
|
var at: String = String(row.get("armor_type", "light"))
|
||||||
if not ARMOR_TYPES.has(at):
|
if not ARMOR_TYPES.has(at):
|
||||||
errs.append({"category": "enum", "message": "%s armor_type 未知枚举: %s（域 {light, ward, heavy}）" % [eid, at]})
|
errs.append({"category": "enum", "message": "%s armor_type 未知枚举: %s（域 {light, ward, heavy}）" % [eid, at]})
|
||||||
# attack_type（迭代 24 N3——可省略，缺省 normal 向后兼容；写法沿用 armor_type 同款）
|
# attack_type（可省略，缺省 normal 向后兼容；写法沿用 armor_type 同款）
|
||||||
var att: String = String(row.get("attack_type", "normal"))
|
var att: String = String(row.get("attack_type", "normal"))
|
||||||
if not ATTACK_TYPES.has(att):
|
if not ATTACK_TYPES.has(att):
|
||||||
errs.append({"category": "enum", "message": "%s attack_type 未知枚举: %s（域 {normal, pierce, magic}）" % [eid, att]})
|
errs.append({"category": "enum", "message": "%s attack_type 未知枚举: %s（域 {normal, pierce, magic}）" % [eid, att]})
|
||||||
# armor_class（可省略——缺省 0 向后兼容；2026-09-16 护甲等级掷点批：防守方掷点判定阈值基数）
|
# armor_class（可省略——缺省 0 向后兼容；防守方掷点判定阈值基数）
|
||||||
var ac: int = int(row.get("armor_class", 0))
|
var ac: int = int(row.get("armor_class", 0))
|
||||||
if ac < 0 or ac > 999:
|
if ac < 0 or ac > 999:
|
||||||
errs.append({"category": "domain", "message": "%s armor_class 越域 [0,999]: %d" % [eid, ac]})
|
errs.append({"category": "domain", "message": "%s armor_class 越域 [0,999]: %d" % [eid, ac]})
|
||||||
# 行集构成纪律②（2026-10-07 行集多行批——行序即契约，敌人系统 v0.15）：同坐标多行必须
|
# 行集构成纪律②（行序即契约，敌人系统 v0.15）：同坐标多行必须
|
||||||
# 文件内相邻。迭代中记录上一行坐标；当前坐标曾出现过但 ≠ 上一行坐标 = 同坐标行被隔断，报错。
|
# 文件内相邻。迭代中记录上一行坐标；当前坐标曾出现过但 ≠ 上一行坐标 = 同坐标行被隔断，报错。
|
||||||
# 原纪律「每行集恰一敌种」同批退役——同坐标多敌种混编合法；同坐标同敌种第二行仍由
|
# 同坐标多敌种混编合法；同坐标同敌种第二行仍由
|
||||||
# dup_key 拦截（键含 enemy_id）。错误类别沿用 rowset_rule（定位面不变）。
|
# dup_key 拦截（键含 enemy_id）。错误类别沿用 rowset_rule（定位面不变）。
|
||||||
var rk := "%d_%d" % [L, D]
|
var rk := "%d_%d" % [L, D]
|
||||||
if rk != last_rk:
|
if rk != last_rk:
|
||||||
@@ -135,6 +135,6 @@ func validate() -> Array:
|
|||||||
return errs
|
return errs
|
||||||
|
|
||||||
|
|
||||||
# 进度键解析单点收口（2026-10-07 行集多行批 P2 甲——原 floor 语义 resolve_rowset 退役，全仓统走
|
# 进度键解析单点收口（全仓统走
|
||||||
# ConfigDbResolver.resolve_enemy_rowset ceil 版行集数组：2026-09-18 用户拍板 ceil 保证偏难，
|
# ConfigDbResolver.resolve_enemy_rowset ceil 版行集数组：ceil 保证偏难，
|
||||||
# 双算法并存至本批销号〔状态记录 312 待裁项〕；原冒烟四调用点随批迁移，坐标全精确命中零行为差）。
|
# 禁双算法并存〔状态记录 312〕；坐标须全精确命中）。
|
||||||
@@ -5,7 +5,7 @@
|
|||||||
class_name ForgeTable
|
class_name ForgeTable
|
||||||
extends Resource
|
extends Resource
|
||||||
|
|
||||||
# 路线 id 词表（代拍板立项：甲路线 id=甲型值本身——ward=魔法护甲，3a 裁统一命名）
|
# 路线 id 词表（甲路线 id=甲型值本身——ward=魔法护甲，统一命名）
|
||||||
const WEAPON_IDS := ["sword", "spear", "staff"]
|
const WEAPON_IDS := ["sword", "spear", "staff"]
|
||||||
const ARMOR_IDS := ["light", "heavy", "ward"]
|
const ARMOR_IDS := ["light", "heavy", "ward"]
|
||||||
const ROUTE_IDS := ["sword", "spear", "staff", "light", "heavy", "ward"]
|
const ROUTE_IDS := ["sword", "spear", "staff", "light", "heavy", "ward"]
|
||||||
@@ -104,7 +104,7 @@ func validate() -> Array:
|
|||||||
errs.append({"category": "cross_field", "message": "%s prereq_route 不得自指" % rid})
|
errs.append({"category": "cross_field", "message": "%s prereq_route 不得自指" % rid})
|
||||||
elif kind_by_id.has(prereq) and String(kind_by_id[prereq]) != kind:
|
elif kind_by_id.has(prereq) and String(kind_by_id[prereq]) != kind:
|
||||||
errs.append({"category": "cross_field", "message": "%s 前置 %s 类型不符（武器←武器/甲←甲）: %s vs %s" % [rid, prereq, kind, String(kind_by_id[prereq])]})
|
errs.append({"category": "cross_field", "message": "%s 前置 %s 类型不符（武器←武器/甲←甲）: %s vs %s" % [rid, prereq, kind, String(kind_by_id[prereq])]})
|
||||||
# 初始持有恰两行且一武器一甲（长剑/轻甲——语义继承自已退役属性锻造行）
|
# 初始持有恰两行且一武器一甲（长剑/轻甲）
|
||||||
var init_weapons := 0
|
var init_weapons := 0
|
||||||
var init_armors := 0
|
var init_armors := 0
|
||||||
for k in initial_ids.keys():
|
for k in initial_ids.keys():
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ extends Resource
|
|||||||
|
|
||||||
@export var max_hp: int = 50 # [1,999] knob（provisional，溯源 = 原型锚）
|
@export var max_hp: int = 50 # [1,999] knob（provisional，溯源 = 原型锚）
|
||||||
@export var atk: int = 6 # [1,999] knob——基础攻击（溯源 = 概念原型 HERO_BASE_ATK，provisional 归 难度曲线与Boss）；消费面 = 战斗结算·战斗段先手攻击
|
@export var atk: int = 6 # [1,999] knob——基础攻击（溯源 = 概念原型 HERO_BASE_ATK，provisional 归 难度曲线与Boss）；消费面 = 战斗结算·战斗段先手攻击
|
||||||
@export var armor_class: int = 10 # [0,999] knob——防守方护甲等级基准（2026-09-16 护甲等级掷点批，暂定 10 归 难度曲线与Boss）；消费面 = 战斗结算掷点判定阈值基数（ac_up 效果加算其上）
|
@export var armor_class: int = 10 # [0,999] knob——防守方护甲等级基准（暂定 10 归 难度曲线与Boss）；消费面 = 战斗结算掷点判定阈值基数（ac_up 效果加算其上）
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
|
|||||||
@@ -6,10 +6,10 @@ extends Resource
|
|||||||
|
|
||||||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||||||
|
|
||||||
const NODE_TYPES := ["battle", "reward", "rest", "boss", "shop"] # 商店房批 2026-09-21 四→五类（关卡节点地图 v1.1）
|
const NODE_TYPES := ["battle", "reward", "rest", "boss", "shop"] # 五类（关卡节点地图 v1.1）
|
||||||
|
|
||||||
|
|
||||||
# 行单点读取（2026-10-02 修复批 T5 表访问收口——LevelRunner._find_level_row 直扫收口；键 = level_index）
|
# 行单点读取（表访问收口——LevelRunner._find_level_row 禁直扫；键 = level_index）
|
||||||
func row_by_level_index(level_index: int) -> Dictionary:
|
func row_by_level_index(level_index: int) -> Dictionary:
|
||||||
for row in rows:
|
for row in rows:
|
||||||
if int(row.level_index) == level_index:
|
if int(row.level_index) == level_index:
|
||||||
@@ -35,8 +35,8 @@ func validate() -> Array:
|
|||||||
var heal: int = int(row.get("rest_heal_pct", -1))
|
var heal: int = int(row.get("rest_heal_pct", -1))
|
||||||
if heal < 0 or heal > 100:
|
if heal < 0 or heal > 100:
|
||||||
errs.append({"category": "domain", "message": "level %d rest_heal_pct 越域 [0,100]" % L})
|
errs.append({"category": "domain", "message": "level %d rest_heal_pct 越域 [0,100]" % L})
|
||||||
# 模板池（关卡节点图生成 v0.4——M-3 迭代 5 T5）：row.templates 非空 = 池形态，池内全模板加载期校验
|
# 模板池（关卡节点图生成 v0.4）：row.templates 非空 = 池形态，池内全模板加载期校验
|
||||||
# （违规致命——不只抽中的那张）；空 = 旧单图形态（row.nodes 直读，向后兼容零迁移）。
|
# （违规致命——不只抽中的那张）；空 = 单图形态（row.nodes 直读，向后兼容）。
|
||||||
var node_lists: Array[Array] = [] # [ [上下文标签, nodes 数组], ... ]
|
var node_lists: Array[Array] = [] # [ [上下文标签, nodes 数组], ... ]
|
||||||
var templates: Array[Variant] = row.get("templates", [])
|
var templates: Array[Variant] = row.get("templates", [])
|
||||||
if templates.is_empty():
|
if templates.is_empty():
|
||||||
@@ -88,7 +88,7 @@ func _validate_level_nodes(L: int, ctx: String, nodes: Array) -> Array:
|
|||||||
# 图合法性（单链与图同一套算法——单链 = 出边恰一的退化形态，违规同样加载致命）
|
# 图合法性（单链与图同一套算法——单链 = 出边恰一的退化形态，违规同样加载致命）
|
||||||
for e in _validate_graph(L, nodes, is_graph, tag):
|
for e in _validate_graph(L, nodes, is_graph, tag):
|
||||||
errs.append(e)
|
errs.append(e)
|
||||||
# U2 目检新规则（迭代 5 返工批 2026-09-29 两条，加载期同检）：①单链前三位纯战斗（奖励/休整禁入前三）
|
# U2 目检规则（两条，加载期同检）：①单链前三位纯战斗（奖励/休整禁入前三）
|
||||||
if not is_graph and nodes.size() >= 3:
|
if not is_graph and nodes.size() >= 3:
|
||||||
for i in 3:
|
for i in 3:
|
||||||
if String(nodes[i].get("type", "")) != "battle":
|
if String(nodes[i].get("type", "")) != "battle":
|
||||||
@@ -127,9 +127,9 @@ func _validate_graph(L: int, nodes: Array, is_graph: bool, tag: String = "") ->
|
|||||||
errs.append({"category": "dangling_next", "message": "level %d%s 节点 %d 出边指向不存在编号: %d" % [L, tag, ids[i], tid]})
|
errs.append({"category": "dangling_next", "message": "level %d%s 节点 %d 出边指向不存在编号: %d" % [L, tag, ids[i], tid]})
|
||||||
elif tid <= ids[i]:
|
elif tid <= ids[i]:
|
||||||
errs.append({"category": "structural", "message": "level %d%s 连线 %d→%d 违反前进方向（目标编号须严格更大）" % [L, tag, ids[i], tid]})
|
errs.append({"category": "structural", "message": "level %d%s 连线 %d→%d 违反前进方向（目标编号须严格更大）" % [L, tag, ids[i], tid]})
|
||||||
# ③b 出度上限（T17 用户拍板 2026-10-01「节点出度最大为 2」）：单节点出边 >2 即加载致命。
|
# ③b 出度上限（「节点出度最大为 2」）：单节点出边 >2 即加载致命。
|
||||||
# 规则连带：出度 ≤2 + 入口唯一下 BFS 层宽上限 = 4（序列 1,2,4——原「层宽上限 5」与出度约束
|
# 规则连带：出度 ≤2 + 入口唯一下 BFS 层宽上限 = 4（序列 1,2,4——层宽上限 5 与出度约束
|
||||||
# 不相容，模板池随本检同批按层宽 ≤4 重建）。
|
# 不相容，模板池按层宽 ≤4 构造）。
|
||||||
for i in nodes.size():
|
for i in nodes.size():
|
||||||
if nexts[i].size() > 2:
|
if nexts[i].size() > 2:
|
||||||
errs.append({"category": "fanout_violation", "message": "level %d%s 节点 %d 出度 %d > 2（出度上限拍板 2026-10-01）" % [L, tag, ids[i], nexts[i].size()]})
|
errs.append({"category": "fanout_violation", "message": "level %d%s 节点 %d 出度 %d > 2（出度上限拍板 2026-10-01）" % [L, tag, ids[i], nexts[i].size()]})
|
||||||
@@ -177,7 +177,7 @@ func _validate_graph(L: int, nodes: Array, is_graph: bool, tag: String = "") ->
|
|||||||
for i in nodes.size():
|
for i in nodes.size():
|
||||||
if not to_boss.has(i):
|
if not to_boss.has(i):
|
||||||
errs.append({"category": "structural", "message": "level %d 节点 %d 沿连线不可达 Boss" % [L, ids[i]]})
|
errs.append({"category": "structural", "message": "level %d 节点 %d 沿连线不可达 Boss" % [L, ids[i]]})
|
||||||
# ⑧ U2 目检新规则（迭代 5 返工批 2026-09-29）：BFS 同深度层节点数上限 5（分支宽度天花板）
|
# ⑧ U2 目检规则：BFS 同深度层节点数上限 5（分支宽度天花板）
|
||||||
var layer_of := {}
|
var layer_of := {}
|
||||||
var bfs: Array[Variant] = [entries[0]]
|
var bfs: Array[Variant] = [entries[0]]
|
||||||
layer_of[entries[0]] = 0
|
layer_of[entries[0]] = 0
|
||||||
|
|||||||
@@ -7,9 +7,9 @@ extends Resource
|
|||||||
|
|
||||||
@export var boss_keystone: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
@export var boss_keystone: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
||||||
@export var conversion: Array[Dictionary] = [] # Array[Dictionary] 键 attr
|
@export var conversion: Array[Dictionary] = [] # Array[Dictionary] 键 attr
|
||||||
@export var attune_refresh_upgrade: Array[Dictionary] = [] # Array[Dictionary] 键 level——Y 刷新升级行族（迭代 11 第①批 T4）
|
@export var attune_refresh_upgrade: Array[Dictionary] = [] # Array[Dictionary] 键 level——Y 刷新升级行族
|
||||||
|
|
||||||
const FORGE_ATTRS := ["max_hp", "atk", "armor_class"] # 三属性轴词表（conversion 行键域——原 forge 词表名沿用作轴名）
|
const FORGE_ATTRS := ["max_hp", "atk", "armor_class"] # 三属性轴词表（conversion 行键域=forge 词表名）
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
@@ -36,8 +36,8 @@ func validate() -> Array:
|
|||||||
if li_at != i + 1:
|
if li_at != i + 1:
|
||||||
errs.append({"category": "structural", "message": "boss_keystone level_index 不连续（须从 1 连续递增）: 位 %d = %d" % [i + 1, li_at]})
|
errs.append({"category": "structural", "message": "boss_keystone level_index 不连续（须从 1 连续递增）: 位 %d = %d" % [i + 1, li_at]})
|
||||||
break
|
break
|
||||||
# workshop_items 行族已退役（迭代 22 T2——解锁混合制换代，条件谓词挂 treasure_items 行内；
|
# 无 workshop_items 行族（解锁混合制——条件谓词挂 treasure_items 行内；
|
||||||
# 校验段随批删除——秘宝解锁条件校验单点=TreasureItemTable.validate）
|
# 本表不校验秘宝解锁，单点=TreasureItemTable.validate）
|
||||||
# conversion：attr 词表与 forge 一致 + 唯一 + 覆盖恰三 + 平移量域 [0,100]
|
# conversion：attr 词表与 forge 一致 + 唯一 + 覆盖恰三 + 平移量域 [0,100]
|
||||||
var seen_conv := {}
|
var seen_conv := {}
|
||||||
for row in conversion:
|
for row in conversion:
|
||||||
@@ -54,7 +54,7 @@ func validate() -> Array:
|
|||||||
for conv_key in FORGE_ATTRS:
|
for conv_key in FORGE_ATTRS:
|
||||||
if not seen_conv.has(conv_key):
|
if not seen_conv.has(conv_key):
|
||||||
errs.append({"category": "coverage", "message": "conversion 缺属性行: %s（三行与 forge 词表一致）" % conv_key})
|
errs.append({"category": "coverage", "message": "conversion 缺属性行: %s（三行与 forge 词表一致）" % conv_key})
|
||||||
# attune_refresh_upgrade：level 唯一 + 连续从 1 + charges/cost 域（迭代 11 第①批 T4）
|
# attune_refresh_upgrade：level 唯一 + 连续从 1 + charges/cost 域
|
||||||
var seen_al := {}
|
var seen_al := {}
|
||||||
for row in attune_refresh_upgrade:
|
for row in attune_refresh_upgrade:
|
||||||
var al: int = int(row.get("level", -1))
|
var al: int = int(row.get("level", -1))
|
||||||
|
|||||||
@@ -9,10 +9,10 @@ extends Resource
|
|||||||
|
|
||||||
const VEINS := ["spine", "forge", "keystone", "attune"]
|
const VEINS := ["spine", "forge", "keystone", "attune"]
|
||||||
const KINDS := ["stat", "rule", "unlock", "socket", "fork", "easter"]
|
const KINDS := ["stat", "rule", "unlock", "socket", "fork", "easter"]
|
||||||
const CURRENCIES := ["keystone", "free"] # 树全钥石单币（2026-10-07 用户裁甲——原 gp 枚举值退役，字段保留为呈现元数据）
|
const CURRENCIES := ["keystone", "free"] # 树全钥石单币（无 gp 枚举值，字段保留为呈现元数据）
|
||||||
const STAT_KEYS := ["atk", "max_hp", "hit", "armor_class"]
|
const STAT_KEYS := ["atk", "max_hp", "hit", "armor_class"]
|
||||||
## 规则键封闭词表（零裸 flat 同族护栏——effects.rule 键出域=加载致命；六键=三组 Fork 双态真实接线，
|
## 规则键封闭词表（零裸 flat 同族护栏——effects.rule 键出域=加载致命；六键=三组 Fork 双态真实接线，
|
||||||
## 迭代 21 T1 扩签：posture 两键现役沿袭，sense/economy 四键随危险直觉/财富之道两组建效面新增）
|
## posture 两键 + sense/economy 四键〔危险直觉/财富之道两组建效面〕）
|
||||||
const RULE_KEYS := ["posture_first_strike", "posture_bulwark", "sense_sharp", "sense_guard", "economy_hoard", "economy_spend"]
|
const RULE_KEYS := ["posture_first_strike", "posture_bulwark", "sense_sharp", "sense_guard", "economy_hoard", "economy_spend"]
|
||||||
const KEY_WHITELIST := ["node_id", "display_name", "vein", "kind", "currency", "price", "cap",
|
const KEY_WHITELIST := ["node_id", "display_name", "vein", "kind", "currency", "price", "cap",
|
||||||
"requires", "requires_level", "effects", "effects_a", "effects_b", "name_a", "name_b", "fork_group", "note"]
|
"requires", "requires_level", "effects", "effects_a", "effects_b", "name_a", "name_b", "fork_group", "note"]
|
||||||
@@ -20,14 +20,14 @@ const KEY_WHITELIST := ["node_id", "display_name", "vein", "kind", "currency", "
|
|||||||
const SPINE_ROW_GATE := 4
|
const SPINE_ROW_GATE := 4
|
||||||
|
|
||||||
## Fork 双态组词表（每组恰一节点——互斥由单态承载；营地零币切换承载面；
|
## Fork 双态组词表（每组恰一节点——互斥由单态承载；营地零币切换承载面；
|
||||||
## fg_mastery 克制专精整组砍除——2026-10-11 裁，类型表达归锻造工坊）
|
## 无 fg_mastery 克制专精组——类型表达归锻造工坊）
|
||||||
const FORK_GROUPS := ["fg_posture", "fg_sense", "fg_economy"]
|
const FORK_GROUPS := ["fg_posture", "fg_sense", "fg_economy"]
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
var errs: Array[Variant] = []
|
var errs: Array[Variant] = []
|
||||||
if rows.is_empty():
|
if rows.is_empty():
|
||||||
return errs # 空表合法态（建表先行——内容随换代批落）
|
return errs # 空表合法态（建表先行——内容后补）
|
||||||
var seen := {}
|
var seen := {}
|
||||||
var fork_seen := {}
|
var fork_seen := {}
|
||||||
for row in rows:
|
for row in rows:
|
||||||
@@ -118,7 +118,7 @@ func row_by_id(node_id: String) -> Dictionary:
|
|||||||
return {}
|
return {}
|
||||||
|
|
||||||
|
|
||||||
## 行门槛（一线一节点：脊柱节点第 N 级可购需全树总等级 ≥ GATE×(N−1)；原 row-gating 行号主语
|
## 行门槛（一线一节点：脊柱节点第 N 级可购需全树总等级 ≥ GATE×(N−1)；
|
||||||
## 随层行退役平移到节点等级轴）
|
## 门槛主语=节点等级轴）
|
||||||
func level_gate(level: int) -> int:
|
func level_gate(level: int) -> int:
|
||||||
return SPINE_ROW_GATE * maxi(0, level - 1)
|
return SPINE_ROW_GATE * maxi(0, level - 1)
|
||||||
@@ -6,7 +6,7 @@ extends Resource
|
|||||||
|
|
||||||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||||||
|
|
||||||
const CELL_TYPES := ["attack", "defense", "heal", "blast", "weaken", "pierce", "magic", "action", "gp", "treasure_item"] # 十型（迭代 7 T1 秘宝内容批扩值——registry 秘宝词表；aux 行 effect_id = item_id 双表校验键）
|
const CELL_TYPES := ["attack", "defense", "heal", "blast", "weaken", "pierce", "magic", "action", "gp", "treasure_item"] # 十型（registry 秘宝词表；aux 行 effect_id = item_id 双表校验键）
|
||||||
const TREASURE_ITEM_TYPE := "treasure_item" # aux 行标识（掉落投放行：挖开→战斗结算 grant 路由关卡域库存，不入增益容器）
|
const TREASURE_ITEM_TYPE := "treasure_item" # aux 行标识（掉落投放行：挖开→战斗结算 grant 路由关卡域库存，不入增益容器）
|
||||||
const POLARITIES := ["positive", "negative"]
|
const POLARITIES := ["positive", "negative"]
|
||||||
const POOL_TAGS := ["cell", "clear_default"] # cell = 格面资源单一池；clear_<biome> 命名空间预留拒绝
|
const POOL_TAGS := ["cell", "clear_default"] # cell = 格面资源单一池；clear_<biome> 命名空间预留拒绝
|
||||||
@@ -39,11 +39,11 @@ func validate() -> Array:
|
|||||||
var atk_type: String = String(row.get("attack_type", ""))
|
var atk_type: String = String(row.get("attack_type", ""))
|
||||||
if atk_type != "" and not ["normal", "pierce", "magic"].has(atk_type):
|
if atk_type != "" and not ["normal", "pierce", "magic"].has(atk_type):
|
||||||
errs.append({"category": "enum", "message": "%s attack_type 出域 {normal, pierce, magic}: %s" % [rid, atk_type]})
|
errs.append({"category": "enum", "message": "%s attack_type 出域 {normal, pierce, magic}: %s" % [rid, atk_type]})
|
||||||
# aux 投放行专属校验（迭代 7 T1）：极性恒正/加权入池/effect_id=item_id 非空（悬空在 config_db 跨表层
|
# aux 投放行专属校验：极性恒正/加权入池/effect_id=item_id 非空（悬空在 config_db 跨表层
|
||||||
# 对秘宝词表校验——reward_dangling_treasure）/无 power 无区间（数值语义不复用，道具效果读 TreasureItemTable）
|
# 对秘宝词表校验——reward_dangling_treasure）/无 power 无区间（数值语义不复用，道具效果读 TreasureItemTable）
|
||||||
if ctype == TREASURE_ITEM_TYPE:
|
if ctype == TREASURE_ITEM_TYPE:
|
||||||
# 负向行 = 危险格极性字典占位（雷安同池摇号下危险格可摇中 aux 身份——负路由零兑付兜底，
|
# 负向行 = 危险格极性字典占位（雷安同池摇号下危险格可摇中 aux 身份——负路由零兑付兜底，
|
||||||
# effect_id 空/power 0/weight 0 不入池；2026-09-29 T1）
|
# effect_id 空/power 0/weight 0 不入池）
|
||||||
if pol == "negative":
|
if pol == "negative":
|
||||||
if String(row.get("effect_id", "")) != "" or int(row.get("power", 0)) != 0 or int(row.get("weight", 0)) != 0:
|
if String(row.get("effect_id", "")) != "" or int(row.get("power", 0)) != 0 or int(row.get("weight", 0)) != 0:
|
||||||
errs.append({"category": "cross_field", "message": "%s aux 负占位行仅允许 空effect_id/0power/0weight" % rid})
|
errs.append({"category": "cross_field", "message": "%s aux 负占位行仅允许 空effect_id/0power/0weight" % rid})
|
||||||
|
|||||||
@@ -6,23 +6,23 @@ extends Resource
|
|||||||
|
|
||||||
@export var equivalence_ref_damage: int = 12 # [1,999] knob——当量参考敞口 D_ref
|
@export var equivalence_ref_damage: int = 12 # [1,999] knob——当量参考敞口 D_ref
|
||||||
@export var p_perfect: int = 200 # {100,200} percent——完美排雷第二份兑付触发（载体域）
|
@export var p_perfect: int = 200 # {100,200} percent——完美排雷第二份兑付触发（载体域）
|
||||||
@export var seal_hit_premium: int = 100 # [100,999] percent knob——封印命中兑付溢价 ×(1+(n−100)/100)：125=×1.25（条款3 条件二封印溢价形态 a，2026-10-05 判式换代批 provisional）；100=无溢价直通零扰动。只乘封印命中正向兑付（flat power/percent 幅度/gp 缓冲三形态），标空/挖格/清图不乘；雷安同池冻结不动
|
@export var seal_hit_premium: int = 100 # [100,999] percent knob——封印命中兑付溢价 ×(1+(n−100)/100)：125=×1.25（条款3 条件二封印溢价形态 a，provisional）；100=无溢价直通零扰动。只乘封印命中正向兑付（flat power/percent 幅度/gp 缓冲三形态），标空/挖格/清图不乘；雷安同池冻结不动
|
||||||
@export var segment_order: PackedStringArray = [] # 结构冻结——恒等拍板段序校验违例致命
|
@export var segment_order: PackedStringArray = [] # 结构冻结——段序恒等校验违例致命
|
||||||
@export var source_label_map: Dictionary[String, Variant] = {} # 结构冻结——source_class→文案键
|
@export var source_label_map: Dictionary[String, Variant] = {} # 结构冻结——source_class→文案键
|
||||||
@export var effect_pool_map: Dictionary[String, Variant] = {} # 结构冻结——effect_id→pool（悬空加载致命）
|
@export var effect_pool_map: Dictionary[String, Variant] = {} # 结构冻结——effect_id→pool（悬空加载致命）
|
||||||
@export var pool_clamp_lo: int = -100 # 结构冻结
|
@export var pool_clamp_lo: int = -100 # 结构冻结
|
||||||
@export var pool_clamp_hi: int = 100 # 结构冻结
|
@export var pool_clamp_hi: int = 100 # 结构冻结
|
||||||
@export var round_direction: String = "floor" # 结构冻结——单一取整规则
|
@export var round_direction: String = "floor" # 结构冻结——单一取整规则
|
||||||
# ---- 攻击类型 × 护甲克制批 + 充能奖励定义（2026-09-12 用户拍板结构；2026-09-15 命名统一批 / 抽象分离批；数值 provisional）----
|
# ---- 攻击类型 × 护甲克制 + 充能奖励定义（数值 provisional）----
|
||||||
# 主角攻击 = 普通（atk×(1+attack_up)，不吃克制）+ 穿刺 + 魔法（后两者由充能供给），三分量各自 floor 后相加。
|
# 主角攻击 = 普通（atk×(1+attack_up)，不吃克制）+ 穿刺 + 魔法（后两者由充能供给），三分量各自 floor 后相加。
|
||||||
# 【两条抽象分离，勿焊死】攻击类型 = 伤害的属性轴，只决定查 armor_effectiveness 哪一行，定义里不含任何棋盘来源；
|
# 【两条抽象分离，勿焊死】攻击类型 = 伤害的属性轴，只决定查 armor_effectiveness 哪一行，定义里不含任何棋盘来源；
|
||||||
# 充能 = 按攻击类型分桶的附加伤害储备，"谁往桶里放东西"属**奖励的定义**（开格/标雷只是奖励触发源，奖励内容可改）。
|
# 充能 = 按攻击类型分桶的附加伤害储备，"谁往桶里放东西"属**奖励的定义**（开格/标雷只是奖励触发源，奖励内容可改）。
|
||||||
# 原 damage_a_per_cell / damage_a_cap / damage_b_per_seal 与 charge_grants 充能奖励定义均退役（2026-09-19 充能退役批——攻击模型回归单分量）。
|
# 无 damage_a_per_cell / damage_a_cap / damage_b_per_seal 与 charge_grants 字段（攻击模型=单分量）。
|
||||||
@export var armor_effectiveness: Dictionary[String, Variant] = {} # 克制修正矩阵（加法点数 delta）：{攻击类型 {normal|pierce|magic}: {护甲 {light|ward|heavy}: 点数 [-3,+3]}}
|
@export var armor_effectiveness: Dictionary[String, Variant] = {} # 克制修正矩阵（加法点数 delta）：{攻击类型 {normal|pierce|magic}: {护甲 {light|ward|heavy}: 点数 [-3,+3]}}
|
||||||
# ---- 护甲等级掷点批（2026-09-16 用户拍板，数字即规范——registry settlement_table.ac_roll/ac_discount_tiers 同批定稿）----
|
# ---- 护甲等级掷点（数字即规范——registry settlement_table.ac_roll/ac_discount_tiers 定稿）----
|
||||||
# 判定式：掷 1d20，掷点 ≥ 防守方 AC + 攻击加成 → 全额；低掷按缺口（AC−掷点）查档打折，无 miss、无零收益档；
|
# 判定式：掷 1d20，掷点 ≥ 防守方 AC + 攻击加成 → 全额；低掷按缺口（AC−掷点）查档打折，无 miss、无零收益档；
|
||||||
# nat 最大面（crit_roll）= 暴击：该次基础攻击分量 ×2 且恒全额；任何伤害落地全局下限 damage_floor（≥1）——
|
# nat 最大面（crit_roll）= 暴击：该次基础攻击分量 ×2 且恒全额；任何伤害落地全局下限 damage_floor（≥1）——
|
||||||
# 2026-09-20 用户拍板扩全来源（攻击双方/棋盘直伤/地形变异/反噬，取值域 [1,+∞) 无上限）。
|
# 全来源（攻击双方/棋盘直伤/地形变异/反噬，取值域 [1,+∞) 无上限）。
|
||||||
# 掷点只吃基础攻击分量（主角普通分量 / 敌方攻击拍与重击拍基线），穿刺/魔法充能与棋盘来源伤害不掷不折。
|
# 掷点只吃基础攻击分量（主角普通分量 / 敌方攻击拍与重击拍基线），穿刺/魔法充能与棋盘来源伤害不掷不折。
|
||||||
# 微调旋钮 = 档位边界（roll_tier_bounds）与档位值（roll_tier_discounts），不动 AC 值（armor_class 归单位表）。
|
# 微调旋钮 = 档位边界（roll_tier_bounds）与档位值（roll_tier_discounts），不动 AC 值（armor_class 归单位表）。
|
||||||
@export var roll_faces: int = 20 # [2,1000] knob——掷点骰面（d20）
|
@export var roll_faces: int = 20 # [2,1000] knob——掷点骰面（d20）
|
||||||
@@ -31,8 +31,8 @@ extends Resource
|
|||||||
@export var roll_tier_discounts: Array[int] = [] # 档位值 percent 降序（与 bounds 同长；[75,50,25] = ×0.75/×0.5/×0.25）
|
@export var roll_tier_discounts: Array[int] = [] # 档位值 percent 降序（与 bounds 同长；[75,50,25] = ×0.75/×0.5/×0.25）
|
||||||
@export var crit_roll: int = 20 # [1,roll_faces] knob——nat 最大面 = 暴击触发掷点（恒全额）
|
@export var crit_roll: int = 20 # [1,roll_faces] knob——nat 最大面 = 暴击触发掷点（恒全额）
|
||||||
@export var crit_multiplier: int = 200 # [100,999] percent knob——暴击倍率（200 = ×2，只乘该次基础攻击分量）
|
@export var crit_multiplier: int = 200 # [100,999] percent knob——暴击倍率（200 = ×2，只乘该次基础攻击分量）
|
||||||
@export var damage_floor: int = 1 # [1,999] knob——任何伤害落地全局下限·全来源（"被减伤归零 v=0"行语义随批退役）
|
@export var damage_floor: int = 1 # [1,999] knob——任何伤害落地全局下限·全来源（无"被减伤归零 v=0"语义）
|
||||||
@export var armor_roll_stream: String = "armor_roll" # 掷点用途标签（rng_service PURPOSE_TAGS 成员——并流后不参与派生，仅作事件日志用途标记；2026-09-27 统一流裁决）
|
@export var armor_roll_stream: String = "armor_roll" # 掷点用途标签（rng_service PURPOSE_TAGS 成员——不参与派生，仅作事件日志用途标记）
|
||||||
|
|
||||||
const ARMOR_KEYS := ["light", "ward", "heavy"]
|
const ARMOR_KEYS := ["light", "ward", "heavy"]
|
||||||
const ATTACK_TYPE_KEYS := ["normal", "pierce", "magic"]
|
const ATTACK_TYPE_KEYS := ["normal", "pierce", "magic"]
|
||||||
|
|||||||
@@ -9,13 +9,13 @@ extends Resource
|
|||||||
@export var level_gp_bonus: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
@export var level_gp_bonus: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
||||||
@export var products: Array[Dictionary] = [] # Array[Dictionary] 键 product_id
|
@export var products: Array[Dictionary] = [] # Array[Dictionary] 键 product_id
|
||||||
@export var price_level_bonus: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
@export var price_level_bonus: Array[Dictionary] = [] # Array[Dictionary] 键 level_index
|
||||||
@export var pool_shelf: Array[Dictionary] = [] # Array[Dictionary] 键 kind_id（迭代 11 第②批 T1）
|
@export var pool_shelf: Array[Dictionary] = [] # Array[Dictionary] 键 kind_id
|
||||||
@export var price_a: float = 0.0 # 进店已购次数爬价因子（provisional——0 = 未投值即致命域）
|
@export var price_a: float = 0.0 # 进店已购次数爬价因子（provisional——0 = 未投值即致命域）
|
||||||
@export var price_b: float = 0.0 # 跨关递增因子（provisional）
|
@export var price_b: float = 0.0 # 跨关递增因子（provisional）
|
||||||
|
|
||||||
const GP_TIERS := ["normal", "elite", "boss"]
|
const GP_TIERS := ["normal", "elite", "boss"]
|
||||||
const PRODUCT_ATTRS := ["atk", "max_hp", "armor_class"]
|
const PRODUCT_ATTRS := ["atk", "max_hp", "armor_class"]
|
||||||
const SHELF_KINDS := ["attack", "max_hp", "armor", "ap", "feat_ticket", "heal"] # 货架候选词表（四切边后种 + T5 门票行 + T6 heal 补回复〔默认原则：分类内成员都入该渠道池〕——奇物批迭代15②）
|
const SHELF_KINDS := ["attack", "max_hp", "armor", "ap", "feat_ticket", "heal"] # 货架候选词表（四切边后种 + 门票行 + heal 补回复〔默认原则：分类内成员都入该渠道池〕）
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
@@ -83,7 +83,7 @@ func validate() -> Array:
|
|||||||
var inc: int = int(row.get("price_increment", -1))
|
var inc: int = int(row.get("price_increment", -1))
|
||||||
if inc < 0 or inc > 999:
|
if inc < 0 or inc > 999:
|
||||||
errs.append({"category": "domain", "message": "%s price_increment 越域 [0,999]: %d" % [pid, inc]})
|
errs.append({"category": "domain", "message": "%s price_increment 越域 [0,999]: %d" % [pid, inc]})
|
||||||
# pool_shelf：kind_id 词表封闭（四切边后种）+ 唯一 + display_name + base_price 域 [1,999]（迭代 11 第②批 T1）
|
# pool_shelf：kind_id 词表封闭（四切边后种）+ 唯一 + display_name + base_price 域 [1,999]
|
||||||
var seen_kind := {}
|
var seen_kind := {}
|
||||||
for row in pool_shelf:
|
for row in pool_shelf:
|
||||||
var kind: String = row.get("kind_id", "")
|
var kind: String = row.get("kind_id", "")
|
||||||
|
|||||||
@@ -10,7 +10,7 @@ extends Resource
|
|||||||
# （特殊技内按权重、不受冷却限制——proposal §2.1 两道闸之二）。全局单旋钮（不分敌种）。
|
# （特殊技内按权重、不受冷却限制——proposal §2.1 两道闸之二）。全局单旋钮（不分敌种）。
|
||||||
@export var pity_threshold: int = 4
|
@export var pity_threshold: int = 4
|
||||||
|
|
||||||
const SKILL_TYPES := ["basic", "damage", "buff", "debuff"] # 普通攻击 / 伤害 / 增益 / 妨害（封闭枚举——新效应词汇批 2026-09-19 由三扩四）
|
const SKILL_TYPES := ["basic", "damage", "buff", "debuff"] # 普通攻击 / 伤害 / 增益 / 妨害（封闭枚举四型）
|
||||||
const MULT_DOMAIN_MIN := 1.1 # damage_mult 域 [1.1, 16] provisional（proposal §2.2）
|
const MULT_DOMAIN_MIN := 1.1 # damage_mult 域 [1.1, 16] provisional（proposal §2.2）
|
||||||
const MULT_DOMAIN_MAX := 16.0
|
const MULT_DOMAIN_MAX := 16.0
|
||||||
const RIDER_MULT_MAX := 1.0 # rider_mult 域 (0, 1]（必中附加分量——proposal-status-vocabulary §2；首发 0.75 锚 AC 折扣档最轻档）
|
const RIDER_MULT_MAX := 1.0 # rider_mult 域 (0, 1]（必中附加分量——proposal-status-vocabulary §2；首发 0.75 锚 AC 折扣档最轻档）
|
||||||
@@ -78,7 +78,7 @@ func validate() -> Array:
|
|||||||
var bd: int = int(row.get("buff_duration", 0))
|
var bd: int = int(row.get("buff_duration", 0))
|
||||||
if bd < 1 or bd > 99:
|
if bd < 1 or bd > 99:
|
||||||
errs.append({"category": "domain", "message": "%s buff_duration 越域 [1,99]: %d" % [sid, bd]})
|
errs.append({"category": "domain", "message": "%s buff_duration 越域 [1,99]: %d" % [sid, bd]})
|
||||||
# 妨害技（新效应词汇批 2026-09-19）：0 伤害施放动作，对主角施加负面状态——
|
# 妨害技：0 伤害施放动作，对主角施加负面状态——
|
||||||
# 字段复用 buff_ref/buff_duration（落点由状态行 target_side 路由，ConfigDB side 守卫兜底）；池纪律妨害 ≤1 在跨表通道
|
# 字段复用 buff_ref/buff_duration（落点由状态行 target_side 路由，ConfigDB side 守卫兜底）；池纪律妨害 ≤1 在跨表通道
|
||||||
if type == "debuff":
|
if type == "debuff":
|
||||||
if row.has("damage_mult"):
|
if row.has("damage_mult"):
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ extends Resource
|
|||||||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||||||
|
|
||||||
const TARGET_SIDES := ["hero", "enemy"]
|
const TARGET_SIDES := ["hero", "enemy"]
|
||||||
const UNITS := ["percent", "flat", "ac"] # 2026-09-16 护甲等级掷点批增 ac——AC 阈值轴效果（ac_up），非池百分比非定点值
|
const UNITS := ["percent", "flat", "ac"] # ac——AC 阈值轴效果（ac_up），非池百分比非定点值
|
||||||
const STACK_POLICIES := ["stack", "refresh", "independent"]
|
const STACK_POLICIES := ["stack", "refresh", "independent"]
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -8,25 +8,25 @@ extends Resource
|
|||||||
|
|
||||||
@export var rows: Array[Variant] = [] # Array[Dictionary] 键 item_id
|
@export var rows: Array[Variant] = [] # Array[Dictionary] 键 item_id
|
||||||
|
|
||||||
# 计数键封闭枚举（原 AttunementGrowthTable.COUNTER_KEYS——迭代 21 T5 谓词表退役后就地内联；
|
# 计数键封闭枚举（就地内联于本表，无独立谓词表；
|
||||||
# 迭代 22 T1 换代：clear_count（旧工坊按关累计渠道）与 C6 通关口径（通关=打通整局冒险）不符，
|
# 通关口径=C6（通关=打通整局冒险），键名 adventure_cleared
|
||||||
# 换名 adventure_cleared（生涯通关局数，save_manager 生涯计数域在役）并扩 vision_used（真视类工具
|
# （生涯通关局数，save_manager 生涯计数域在役）；扩 vision_used（真视类工具
|
||||||
# 累计使用——信标网络行为条件计数，本批新增；use_treasure 受理成功处累计、冒险收束导出入档）；
|
# 累计使用——信标网络行为条件计数；use_treasure 受理成功处累计、冒险收束导出入档）；
|
||||||
# 旧 clear_count 零行消费，换名安全）
|
# 键域以本枚举为准）
|
||||||
const UNLOCK_COUNTER_KEYS := ["adventure_cleared", "boss_kill_count", "vision_used"]
|
const UNLOCK_COUNTER_KEYS := ["adventure_cleared", "boss_kill_count", "vision_used"]
|
||||||
|
|
||||||
const DIMENSIONS := ["info", "risk", "action", "plan", "counter"]
|
const DIMENSIONS := ["info", "risk", "action", "plan", "counter"]
|
||||||
# 同调批扩 enum（迭代 11 第①批 T1）——新增九 kind 全部条件触发/机制修正类；mine_reveal/ap_grant 语义不变。
|
# enum 九 kind 全部条件触发/机制修正类；mine_reveal/ap_grant 语义不变。
|
||||||
# cell_removal = 爆破工兵包中立移除格（T7 原位换装时启用——T6 影响评估前置）；mine_hit_halve 系固定
|
# cell_removal = 爆破工兵包中立移除格；mine_hit_halve 系固定
|
||||||
# 「减半」语义不消费 magnitude（反弹 N 由 reflect_damage 行 magnitude 承载）。
|
# 「减半」语义不消费 magnitude（反弹 N 由 reflect_damage 行 magnitude 承载）。
|
||||||
# 内容数据驱动扩展批 T2 挂账：主动件 kind 词族换代（reveal_tiles/preview/grant_ap/remove_mines/
|
# 主动件 kind 词族（reveal_tiles/preview/grant_ap/remove_mines/
|
||||||
# refresh_pick——效果引擎 ACTIVE_KINDS 同名闭集），被动件 effect_kinds 词族随 T4 秘宝迁移退役
|
# refresh_pick——效果引擎 ACTIVE_KINDS 同名闭集）；被动件不走 effect_kinds 词族
|
||||||
# （passive 行改 triggers 事件订阅形态）；旧词保留共存至迁移完成。
|
# （passive 行走 triggers 事件订阅形态）；旧词保留共存至迁移完成。
|
||||||
const EFFECT_KINDS := ["mine_reveal", "reward_preview", "ap_grant",
|
const EFFECT_KINDS := ["mine_reveal", "reward_preview", "ap_grant",
|
||||||
"mine_hit_halve", "reflect_damage", "ap_rounds_front", "ap_charge_safe", "cell_removal",
|
"mine_hit_halve", "reflect_damage", "ap_rounds_front", "ap_charge_safe", "cell_removal",
|
||||||
"reward_weight_bias", "bonus_refresh",
|
"reward_weight_bias", "bonus_refresh",
|
||||||
"reveal_tiles", "preview", "grant_ap", "remove_mines", "refresh_pick",
|
"reveal_tiles", "preview", "grant_ap", "remove_mines", "refresh_pick",
|
||||||
# 迭代 22 秘宝实装批 T1 扩签八型：
|
# 以下八型：
|
||||||
# 常时参数面六型（无事件订阅——开局/装板参数注入，注入面按装配集 kind 分发读取）：
|
# 常时参数面六型（无事件订阅——开局/装板参数注入，注入面按装配集 kind 分发读取）：
|
||||||
# light_radius_bonus=微光半径加值〔阔视野带〕/rap_transfer_mult=停手转存率千分比〔储备罐 125=1.25〕/
|
# light_radius_bonus=微光半径加值〔阔视野带〕/rap_transfer_mult=停手转存率千分比〔储备罐 125=1.25〕/
|
||||||
# dig_range_bonus=挖掘距离加值〔远程镐〕/seal_range_free=封印不限相邻〔信标网络〕/
|
# dig_range_bonus=挖掘距离加值〔远程镐〕/seal_range_free=封印不限相邻〔信标网络〕/
|
||||||
@@ -34,34 +34,34 @@ const EFFECT_KINDS := ["mine_reveal", "reward_preview", "ap_grant",
|
|||||||
# 主动分发两型：safe_dig=安全格直开（天眼——走普通挖格规则全额兑付，C5 裁）/mine_count_preview=危险格数量预告（巢穴预告）
|
# 主动分发两型：safe_dig=安全格直开（天眼——走普通挖格规则全额兑付，C5 裁）/mine_count_preview=危险格数量预告（巢穴预告）
|
||||||
"light_radius_bonus", "rap_transfer_mult", "dig_range_bonus", "seal_range_free",
|
"light_radius_bonus", "rap_transfer_mult", "dig_range_bonus", "seal_range_free",
|
||||||
"refresh_stock_grant", "shop_refresh_bonus", "safe_dig", "mine_count_preview"]
|
"refresh_stock_grant", "shop_refresh_bonus", "safe_dig", "mine_count_preview"]
|
||||||
const TARGETS := ["none", "area_3x3", "board_wide", "cell"] # 迭代 22 T1 扩 cell=单格真视（线香——≤3×3 窄域契约内）
|
const TARGETS := ["none", "area_3x3", "board_wide", "cell"] # cell=单格真视（线香——≤3×3 窄域契约内）
|
||||||
const USE_PHASES := ["active_dig"]
|
const USE_PHASES := ["active_dig"]
|
||||||
const FORMS := ["", "passive", "active_charged"]
|
const FORMS := ["", "passive", "active_charged"]
|
||||||
# 档位词表（迭代 22 T1——槽位档位约束数据面：槽位可装 ≤ 槽位档位的件；词表沿 feats/adventure TIERS）
|
# 档位词表（槽位档位约束数据面：槽位可装 ≤ 槽位档位的件；词表沿 feats/adventure TIERS）
|
||||||
const TIERS := ["common", "excellent", "rare", "legendary"]
|
const TIERS := ["common", "excellent", "rare", "legendary"]
|
||||||
# 档位序（迭代 22 T2——装配档位校验取数源：件档 rank ≤ 装入位序（格 1=普通格/格 2=优秀格/格 3=稀有格
|
# 档位序（装配档位校验取数源：件档 rank ≤ 装入位序（格 1=普通格/格 2=优秀格/格 3=稀有格
|
||||||
# 递增，向下兼容=高档格可装低档件）；rank 越大档越高）
|
# 递增，向下兼容=高档格可装低档件）；rank 越大档越高）
|
||||||
const TIER_RANK := {"common": 1, "excellent": 2, "rare": 3, "legendary": 4}
|
const TIER_RANK := {"common": 1, "excellent": 2, "rare": 3, "legendary": 4}
|
||||||
# 充能重置周期（迭代 22 T1 扩签——现役仅 adventure=每冒险；battle=每战重置〔线香〕/level=每关重置〔天眼〕）
|
# 充能重置周期（现役仅 adventure=每冒险；battle=每战重置〔线香〕/level=每关重置〔天眼〕）
|
||||||
const CHARGE_RESETS := ["adventure", "battle", "level"]
|
const CHARGE_RESETS := ["adventure", "battle", "level"]
|
||||||
# magnitude 消费面（≥1 校验）：grant_ap 与同调 N 值 kind；其余 kind 活行 magnitude 恒 0
|
# magnitude 消费面（≥1 校验）：grant_ap 与同调 N 值 kind；其余 kind 活行 magnitude 恒 0
|
||||||
const MAGNITUDE_KINDS := ["ap_grant", "reflect_damage", "ap_rounds_front",
|
const MAGNITUDE_KINDS := ["ap_grant", "reflect_damage", "ap_rounds_front",
|
||||||
"ap_charge_safe", "reward_weight_bias", "bonus_refresh", "grant_ap",
|
"ap_charge_safe", "reward_weight_bias", "bonus_refresh", "grant_ap",
|
||||||
"light_radius_bonus", "rap_transfer_mult", "dig_range_bonus", "seal_range_free",
|
"light_radius_bonus", "rap_transfer_mult", "dig_range_bonus", "seal_range_free",
|
||||||
"refresh_stock_grant", "shop_refresh_bonus"]
|
"refresh_stock_grant", "shop_refresh_bonus"]
|
||||||
# 真视类 kind（迭代 22 T1 护栏扩面——活行 target 必须 ∈ {area_3x3, cell}：真视窄域 ≤3×3 契约）
|
# 真视类 kind（护栏：活行 target 必须 ∈ {area_3x3, cell}：真视窄域 ≤3×3 契约）
|
||||||
const REVEAL_KINDS := ["mine_reveal", "reveal_tiles"]
|
const REVEAL_KINDS := ["mine_reveal", "reveal_tiles"]
|
||||||
# 🔴 零裸 flat 结构护栏：行键白名单封闭（键出域=加载致命）——机制轴禁无条件属性加项的表结构承载
|
# 🔴 零裸 flat 结构护栏：行键白名单封闭（键出域=加载致命）——机制轴禁无条件属性加项的表结构承载
|
||||||
const KEY_WHITELIST := ["item_id", "display_name", "dimension_tags", "effect_kinds", "target",
|
const KEY_WHITELIST := ["item_id", "display_name", "dimension_tags", "effect_kinds", "target",
|
||||||
"magnitude", "use_phase", "retired", "deferred", "form", "charges_per_adventure", "slot_cost",
|
"magnitude", "use_phase", "retired", "deferred", "form", "charges_per_adventure", "slot_cost",
|
||||||
"unlock_requires", "effective_rounds", "charge_n", "triggers", "desc",
|
"unlock_requires", "effective_rounds", "charge_n", "triggers", "desc",
|
||||||
"tier", "charge_reset", "unlock_keystone_cost"] # 迭代 22 T1 扩三键（档位/充能周期/钥石购买价）
|
"tier", "charge_reset", "unlock_keystone_cost"] # 三键=档位/充能周期/钥石购买价
|
||||||
|
|
||||||
|
|
||||||
func validate() -> Array:
|
func validate() -> Array:
|
||||||
var errs: Array[Variant] = []
|
var errs: Array[Variant] = []
|
||||||
if rows.is_empty():
|
if rows.is_empty():
|
||||||
# 空表合法态（2026-09-17 用户拍板——切片期无道具内容；F2 覆盖检查仅对非空清单执行）
|
# 空表合法态（切片期无道具内容；F2 覆盖检查仅对非空清单执行）
|
||||||
return errs
|
return errs
|
||||||
var seen := {}
|
var seen := {}
|
||||||
for row in rows:
|
for row in rows:
|
||||||
@@ -95,8 +95,8 @@ func validate() -> Array:
|
|||||||
for k in row.keys():
|
for k in row.keys():
|
||||||
if not KEY_WHITELIST.has(String(k)):
|
if not KEY_WHITELIST.has(String(k)):
|
||||||
errs.append({"category": "zero_flat", "message": "%s 行键出白名单: %s（KEY_WHITELIST 外键禁入）" % [iid, String(k)]})
|
errs.append({"category": "zero_flat", "message": "%s 行键出白名单: %s（KEY_WHITELIST 外键禁入）" % [iid, String(k)]})
|
||||||
# triggers 事件订阅行（内容数据驱动扩展批 T2/T4——被动件换代形态；与 effect_kinds 互斥校验
|
# triggers 事件订阅行（被动件形态；与 effect_kinds 互斥校验
|
||||||
# 面=passive 行（换代单形态——效果行为只走订阅）；active_charged 行两形合法并存
|
# 面=passive 行（单形态——效果行为只走订阅）；active_charged 行两形合法并存
|
||||||
# （effect_kinds=主动分发通道 + triggers=受理闸订阅，掘进蓄能先例））
|
# （effect_kinds=主动分发通道 + triggers=受理闸订阅，掘进蓄能先例））
|
||||||
if row.has("triggers"):
|
if row.has("triggers"):
|
||||||
if (row.get("effect_kinds", []) as Array).size() > 0 and String(row.get("form", "")) != "active_charged" and not bool(row.get("retired", false)):
|
if (row.get("effect_kinds", []) as Array).size() > 0 and String(row.get("form", "")) != "active_charged" and not bool(row.get("retired", false)):
|
||||||
@@ -120,7 +120,7 @@ func validate() -> Array:
|
|||||||
errs.append({"category": "dup_key", "message": "%s effect_kind 重复: %s" % [iid, kind]})
|
errs.append({"category": "dup_key", "message": "%s effect_kind 重复: %s" % [iid, kind]})
|
||||||
kind_seen[kind] = true
|
kind_seen[kind] = true
|
||||||
# 承重护栏①真视窄域：真视类活行 target 必须 area_3x3 或 cell（一次最多 3×3，禁全图看雷；
|
# 承重护栏①真视窄域：真视类活行 target 必须 area_3x3 或 cell（一次最多 3×3，禁全图看雷；
|
||||||
# 迭代 22 T1 护栏扩面——reveal_tiles 与新 cell 档纳入同护栏，线香单格=cell ⊂ 3×3 契约内）
|
# reveal_tiles 与 cell 档纳入同护栏，线香单格=cell ⊂ 3×3 契约内）
|
||||||
for rv in REVEAL_KINDS:
|
for rv in REVEAL_KINDS:
|
||||||
if kind_seen.has(String(rv)) and not (target == "area_3x3" or target == "cell"):
|
if kind_seen.has(String(rv)) and not (target == "area_3x3" or target == "cell"):
|
||||||
errs.append({"category": "load_bearing", "message": "%s 真视窄域护栏：%s 行 target 必须 area_3x3 或 cell，实得 %s（秘宝 GDD 结构冻结）" % [iid, String(rv), target]})
|
errs.append({"category": "load_bearing", "message": "%s 真视窄域护栏：%s 行 target 必须 area_3x3 或 cell，实得 %s（秘宝 GDD 结构冻结）" % [iid, String(rv), target]})
|
||||||
@@ -143,7 +143,7 @@ func validate() -> Array:
|
|||||||
if form != "":
|
if form != "":
|
||||||
if int(row.get("slot_cost", 1)) != 1:
|
if int(row.get("slot_cost", 1)) != 1:
|
||||||
errs.append({"category": "load_bearing", "message": "%s 同调占位统一 1 槽（slot_cost 恒 1——底稿裁决 5，schema 强制）" % iid})
|
errs.append({"category": "load_bearing", "message": "%s 同调占位统一 1 槽（slot_cost 恒 1——底稿裁决 5，schema 强制）" % iid})
|
||||||
# 档位必填（迭代 22 T1——槽位档位约束数据面：件档≤格档判定的取数源）
|
# 档位必填（槽位档位约束数据面：件档≤格档判定的取数源）
|
||||||
var tier: String = String(row.get("tier", ""))
|
var tier: String = String(row.get("tier", ""))
|
||||||
if not TIERS.has(tier):
|
if not TIERS.has(tier):
|
||||||
errs.append({"category": "domain", "message": "%s 同调行 tier 必填且 ∈ %s，实得 %s" % [iid, str(TIERS), tier]})
|
errs.append({"category": "domain", "message": "%s 同调行 tier 必填且 ∈ %s，实得 %s" % [iid, str(TIERS), tier]})
|
||||||
@@ -153,7 +153,7 @@ func validate() -> Array:
|
|||||||
if form == "active_charged" and charges < 0:
|
if form == "active_charged" and charges < 0:
|
||||||
errs.append({"category": "domain", "message": "%s active_charged 行 charges_per_adventure 越域 ≥0，实得 %d" % [iid, charges]})
|
errs.append({"category": "domain", "message": "%s active_charged 行 charges_per_adventure 越域 ≥0，实得 %d" % [iid, charges]})
|
||||||
if form == "active_charged" and charges == 0:
|
if form == "active_charged" and charges == 0:
|
||||||
# 充能 0=积点制/滑耗制合法态（迭代 22 T1——试炼镐转化获取，无固定充能上限）：
|
# 充能 0=积点制/滑耗制合法态（试炼镐转化获取，无固定充能上限）：
|
||||||
# 必须带使用闸——ap_charge_safe 滑耗（安全格积点）或 treasure_used+counter_spend 受理闸，二者缺一即孤儿行
|
# 必须带使用闸——ap_charge_safe 滑耗（安全格积点）或 treasure_used+counter_spend 受理闸，二者缺一即孤儿行
|
||||||
var has_gate := kind_seen.has("ap_charge_safe")
|
var has_gate := kind_seen.has("ap_charge_safe")
|
||||||
if not has_gate and row.has("triggers"):
|
if not has_gate and row.has("triggers"):
|
||||||
@@ -163,13 +163,13 @@ func validate() -> Array:
|
|||||||
break
|
break
|
||||||
if not has_gate:
|
if not has_gate:
|
||||||
errs.append({"category": "cross_field", "message": "%s active_charged 行 charges=0（积点制）须带 ap_charge_safe 或 counter_spend 受理闸，实得二者皆无" % iid})
|
errs.append({"category": "cross_field", "message": "%s active_charged 行 charges=0（积点制）须带 ap_charge_safe 或 counter_spend 受理闸，实得二者皆无" % iid})
|
||||||
# 充能重置周期（迭代 22 T1 扩签：adventure 缺省/battle 每战/level 每关；仅 active_charged 行可设）
|
# 充能重置周期（adventure 缺省/battle 每战/level 每关；仅 active_charged 行可设）
|
||||||
var creset: String = String(row.get("charge_reset", "adventure"))
|
var creset: String = String(row.get("charge_reset", "adventure"))
|
||||||
if not CHARGE_RESETS.has(creset):
|
if not CHARGE_RESETS.has(creset):
|
||||||
errs.append({"category": "enum", "message": "%s charge_reset 出域 %s: %s" % [iid, str(CHARGE_RESETS), creset]})
|
errs.append({"category": "enum", "message": "%s charge_reset 出域 %s: %s" % [iid, str(CHARGE_RESETS), creset]})
|
||||||
if form != "active_charged" and row.has("charge_reset") and creset != "adventure":
|
if form != "active_charged" and row.has("charge_reset") and creset != "adventure":
|
||||||
errs.append({"category": "cross_field", "message": "%s 非 active_charged 行 charge_reset 仅可缺省（adventure），实得 %s" % [iid, creset]})
|
errs.append({"category": "cross_field", "message": "%s 非 active_charged 行 charge_reset 仅可缺省（adventure），实得 %s" % [iid, creset]})
|
||||||
# 解锁混合制字段校验（迭代 22 T1 契约 6：钥石购买价与条件谓词互斥——每件单解锁方式，混合不做）
|
# 解锁混合制字段校验（契约 6：钥石购买价与条件谓词互斥——每件单解锁方式，混合不做）
|
||||||
var price: int = int(row.get("unlock_keystone_cost", 0))
|
var price: int = int(row.get("unlock_keystone_cost", 0))
|
||||||
var ureq_count: int = (row.get("unlock_requires", []) as Array).size()
|
var ureq_count: int = (row.get("unlock_requires", []) as Array).size()
|
||||||
if price != 0 and ureq_count > 0:
|
if price != 0 and ureq_count > 0:
|
||||||
@@ -206,7 +206,7 @@ func validate() -> Array:
|
|||||||
return errs
|
return errs
|
||||||
|
|
||||||
|
|
||||||
# 同调行词表（form 非空）——装配覆盖层/效果接线/同调位上限的唯一取数口径（迭代 11 第①批 T1）
|
# 同调行词表（form 非空）——装配覆盖层/效果接线/同调位上限的唯一取数口径
|
||||||
func attunement_rows() -> Array:
|
func attunement_rows() -> Array:
|
||||||
var out: Array[Variant] = []
|
var out: Array[Variant] = []
|
||||||
for row in rows:
|
for row in rows:
|
||||||
@@ -216,7 +216,7 @@ func attunement_rows() -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 过渡行词表（form 空 = 切片期过渡形态活行）——掉落投放/停点池/过渡覆盖面的取数口径；
|
# 过渡行词表（form 空 = 切片期过渡形态活行）——掉落投放/停点池/过渡覆盖面的取数口径；
|
||||||
# 同调行永不入过渡渠道。T7 退役面切换后本口径随渠道消亡。
|
# 同调行永不入过渡渠道。
|
||||||
func transitional_rows() -> Array:
|
func transitional_rows() -> Array:
|
||||||
var out: Array[Variant] = []
|
var out: Array[Variant] = []
|
||||||
for row in rows:
|
for row in rows:
|
||||||
|
|||||||
@@ -7,14 +7,14 @@ extends Resource
|
|||||||
|
|
||||||
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
@export var rows: Array[Dictionary] = [] # Array[Dictionary]
|
||||||
# 布置参数（表头字段；数量公式 = round(候选池格数 × percent_of_cells / 100) + (关卡序号 − 1) × per_level_bonus，
|
# 布置参数（表头字段；数量公式 = round(候选池格数 × percent_of_cells / 100) + (关卡序号 − 1) × per_level_bonus，
|
||||||
# 连通片生长、单片 ≤ pack_max——2026-09-19 用户拍板：图规模百分比 × 关卡递增，全连通、单片不超 4；
|
# 连通片生长、单片 ≤ pack_max——图规模百分比 × 关卡递增，全连通、单片不超 4；
|
||||||
# 2026-09-21 用户拍板基数修正：百分比基数 = 候选池（安全格 − 初始展开区，即实际可挖格）而非总格数）
|
# 百分比基数 = 候选池（安全格 − 初始展开区，即实际可挖格）而非总格数）
|
||||||
@export var percent_of_cells: int = 5
|
@export var percent_of_cells: int = 5
|
||||||
@export var per_level_bonus: int = 2
|
@export var per_level_bonus: int = 2
|
||||||
@export var pack_max: int = 4
|
@export var pack_max: int = 4
|
||||||
|
|
||||||
const SCOPES := ["region", "global"]
|
const SCOPES := ["region", "global"]
|
||||||
# resource_face = 资源面偏斜（全局作用域变异首发批 2026-10-04——整图修摇号分布：生存族按 effect_value%
|
# resource_face = 资源面偏斜（全局作用域变异——整图修摇号分布：生存族按 effect_value%
|
||||||
# 下调、进攻族等比上浮重归一，不动任何格子数据；effect_value 语义随行域切换，不适用 flat_damage [1,9]）
|
# 下调、进攻族等比上浮重归一，不动任何格子数据；effect_value 语义随行域切换，不适用 flat_damage [1,9]）
|
||||||
const EFFECTS := ["none", "flat_damage", "hide_number", "resource_face"] # 效果词表：直伤 / 数字遮蔽 / 资源面偏斜（可扩充）
|
const EFFECTS := ["none", "flat_damage", "hide_number", "resource_face"] # 效果词表：直伤 / 数字遮蔽 / 资源面偏斜（可扩充）
|
||||||
const TRIGGERS := ["on_open", "on_number_shown", "always"] # 触发词表：被打开即触发 / 打开且显示数字时触发 / 板级恒在无触发时机（可扩充）
|
const TRIGGERS := ["on_open", "on_number_shown", "always"] # 触发词表：被打开即触发 / 打开且显示数字时触发 / 板级恒在无触发时机（可扩充）
|
||||||
@@ -46,7 +46,7 @@ func validate() -> Array:
|
|||||||
errs.append({"category": "enum", "message": "%s trigger 出域: %s" % [vid, row.get("trigger")]})
|
errs.append({"category": "enum", "message": "%s trigger 出域: %s" % [vid, row.get("trigger")]})
|
||||||
if not PLACEMENTS.has(row.get("placement", "")):
|
if not PLACEMENTS.has(row.get("placement", "")):
|
||||||
errs.append({"category": "enum", "message": "%s placement 出域: %s" % [vid, row.get("placement")]})
|
errs.append({"category": "enum", "message": "%s placement 出域: %s" % [vid, row.get("placement")]})
|
||||||
# 跨字段互锁（加载期致命——枚举语义一致性随首批类型定稿批 2026-09-19 立闸）：
|
# 跨字段互锁（加载期致命——枚举语义一致性立闸）：
|
||||||
# 伤害型 = 挖开即伤 ⇒ 触发 on_open + 只落未开格（closed_only）+ 伤害量为加法核小整数
|
# 伤害型 = 挖开即伤 ⇒ 触发 on_open + 只落未开格（closed_only）+ 伤害量为加法核小整数
|
||||||
if row.get("effect", "") == "flat_damage":
|
if row.get("effect", "") == "flat_damage":
|
||||||
if row.get("trigger", "") != "on_open":
|
if row.get("trigger", "") != "on_open":
|
||||||
@@ -61,7 +61,7 @@ func validate() -> Array:
|
|||||||
errs.append({"category": "cross_field", "message": "%s hide_number ⇒ trigger 必为 on_number_shown" % vid})
|
errs.append({"category": "cross_field", "message": "%s hide_number ⇒ trigger 必为 on_number_shown" % vid})
|
||||||
# 信息遮蔽型只允许落安全格（遮蔽对象是数字；危险格无数字可遮）——placement=any 时由读取方
|
# 信息遮蔽型只允许落安全格（遮蔽对象是数字；危险格无数字可遮）——placement=any 时由读取方
|
||||||
# 呈现面按 kind=safe 自然短路，此处不设布置约束
|
# 呈现面按 kind=safe 自然短路，此处不设布置约束
|
||||||
# 全局作用域型互锁（2026-10-04 首发批——resource_face ⟺ scope=global 三条 + 新值域；
|
# 全局作用域型互锁（resource_face ⟺ scope=global 三条 + 新值域；
|
||||||
# 判定键=effect/scope 词值，既有六 region 行（flat_damage/hide_number）不入本组——零误伤）
|
# 判定键=effect/scope 词值，既有六 region 行（flat_damage/hide_number）不入本组——零误伤）
|
||||||
if row.get("effect", "") == "resource_face":
|
if row.get("effect", "") == "resource_face":
|
||||||
if row.get("scope", "") != "global":
|
if row.get("scope", "") != "global":
|
||||||
|
|||||||
@@ -19,7 +19,7 @@ static func rest_line(healed: int, hp: int, max_hp: int) -> String:
|
|||||||
return "[color=#%s]恢复点：回复 %d HP（→ %d/%d）[/color]" % [UiKit.HEX_LOG_HEAL, healed, hp, max_hp]
|
return "[color=#%s]恢复点：回复 %d HP（→ %d/%d）[/color]" % [UiKit.HEX_LOG_HEAL, healed, hp, max_hp]
|
||||||
|
|
||||||
|
|
||||||
# 商店房行（GP+商店房实施批——到达即开店；购买/离开归玩家意图）
|
# 商店房行（到达即开店；购买/离开归玩家意图）
|
||||||
static func shop_line(gp: int) -> String:
|
static func shop_line(gp: int) -> String:
|
||||||
return "[color=#%s]商店房：GP %d——购买即时生效，离开后选下一跳[/color]" % [UiKit.HEX_LOG_GAIN, gp]
|
return "[color=#%s]商店房：GP %d——购买即时生效，离开后选下一跳[/color]" % [UiKit.HEX_LOG_GAIN, gp]
|
||||||
|
|
||||||
@@ -57,8 +57,8 @@ static func battle_end_text(result: String, level_end: bool) -> String:
|
|||||||
static func phase_text(round_index: int, battle_result: String, waiting: bool, boss_active: bool, boss_name: String) -> String:
|
static func phase_text(round_index: int, battle_result: String, waiting: bool, boss_active: bool, boss_name: String) -> String:
|
||||||
var boss_tag := " · Boss：%s" % boss_name if boss_active else ""
|
var boss_tag := " · Boss：%s" % boss_name if boss_active else ""
|
||||||
if battle_result != "":
|
if battle_result != "":
|
||||||
# 打磨包 2026-09-29——判定文案两处措辞统一：相位行随结算判定行同词（战斗胜利/战斗失败，
|
# 判定文案两处措辞统一：相位行随结算判定行同词（战斗胜利/战斗失败，
|
||||||
# 与 battle_end_text 同源措辞），「战斗结束」退役
|
# 与 battle_end_text 同源措辞），不用「战斗结束」
|
||||||
return "第 %d 轮 · %s%s" % [round_index, "战斗胜利" if battle_result == "victory" else "战斗失败", boss_tag]
|
return "第 %d 轮 · %s%s" % [round_index, "战斗胜利" if battle_result == "victory" else "战斗失败", boss_tag]
|
||||||
if waiting:
|
if waiting:
|
||||||
return "第 %d 轮 · 结算中%s" % [round_index, boss_tag]
|
return "第 %d 轮 · 结算中%s" % [round_index, boss_tag]
|
||||||
@@ -66,9 +66,9 @@ static func phase_text(round_index: int, battle_result: String, waiting: bool, b
|
|||||||
|
|
||||||
|
|
||||||
# Boss 名解析（runner Boss 节点 → enemy 表行名；缺省遗迹守卫）。
|
# Boss 名解析（runner Boss 节点 → enemy 表行名；缺省遗迹守卫）。
|
||||||
# 行集多行后取**首行** display_name（2026-10-07 行集多行批——行序即契约的呈现面后果，
|
# 行集多行时取**首行** display_name（行序即契约的呈现面后果，
|
||||||
# Boss 行集混编护卫时 Boss 名显示可能为护卫名，知情代价登记 敌人系统 v0.15 / 出口报告；
|
# Boss 行集混编护卫时 Boss 名显示可能为护卫名，知情代价登记 敌人系统 v0.15 / 出口报告；
|
||||||
# 零内容期每坐标恰一行，行为零变化）
|
# 每坐标恰一行时无此歧义）
|
||||||
static func boss_name(runner, db) -> String:
|
static func boss_name(runner, db) -> String:
|
||||||
if runner != null:
|
if runner != null:
|
||||||
var node: Dictionary[Variant, Variant] = runner.current_node()
|
var node: Dictionary[Variant, Variant] = runner.current_node()
|
||||||
@@ -79,7 +79,7 @@ static func boss_name(runner, db) -> String:
|
|||||||
return "遗迹守卫"
|
return "遗迹守卫"
|
||||||
|
|
||||||
|
|
||||||
# ---- 提升三选一文案族（迭代 10 奖励重构批——big_reward_text 随三件套退役）----
|
# ---- 提升三选一文案族 ----
|
||||||
|
|
||||||
# 三选一停点头部行（回血反馈 + 选择引导；钥石增量行不上本面——单一展示面归战斗总结结算框，
|
# 三选一停点头部行（回血反馈 + 选择引导；钥石增量行不上本面——单一展示面归战斗总结结算框，
|
||||||
# level-clear.md v2 禁入清单口径）
|
# level-clear.md v2 禁入清单口径）
|
||||||
@@ -96,7 +96,7 @@ static func curio_pick_header(payload: Dictionary) -> String:
|
|||||||
|
|
||||||
# 三选一选项卡文案（件名 + 档位 + 效果读数；值 = 冒险表行值，组合根喂入；TP0 令牌池——档位词
|
# 三选一选项卡文案（件名 + 档位 + 效果读数；值 = 冒险表行值，组合根喂入；TP0 令牌池——档位词
|
||||||
# 对齐 v2.2 追认 b 口径：小/大前缀（小GP/大GP 族）、恢复/AP 不带档位词；道具件掷定前置时
|
# 对齐 v2.2 追认 b 口径：小/大前缀（小GP/大GP 族）、恢复/AP 不带档位词；道具件掷定前置时
|
||||||
# treasure_line = 具体道具「名 · 效果摘要」行——池种退役后恒空走通用分支，机械惰性保留）
|
# treasure_line = 具体道具「名 · 效果摘要」行——常空走通用分支）
|
||||||
static func bonus_card_text(id: String, tier: String, value: int, treasure_line: String = "") -> String:
|
static func bonus_card_text(id: String, tier: String, value: int, treasure_line: String = "") -> String:
|
||||||
var ts := ""
|
var ts := ""
|
||||||
if tier == "common":
|
if tier == "common":
|
||||||
@@ -133,10 +133,10 @@ static func bonus_result_text(result: Dictionary) -> String:
|
|||||||
return "已选择：%s\n其余选项已丢弃（不可反悔）" % name
|
return "已选择：%s\n其余选项已丢弃（不可反悔）" % name
|
||||||
|
|
||||||
|
|
||||||
# 特性卡片文案（迭代 12 T1；2026-10-04 呈现补强——第二行=效果摘要，用户反馈「不知道件是
|
# 特性卡片文案（第二行=效果摘要——须可读「不知道件是
|
||||||
# 干嘛的」缺口承载。内容数据驱动扩展批 T3 文案表值化：摘要=数据行 desc 字段，零硬编码映射。
|
# 干嘛的」。文案表值化：摘要=数据行 desc 字段，零硬编码映射。
|
||||||
# 2026-10-12 奇物呈现整改批：「件名 · 流派」族名字样摘除（内部分类禁上玩家可见面——新 29 行
|
# 「件名 · 流派」族名字样不上卡片（内部分类禁上玩家可见面——29 行
|
||||||
# 无 archetype，原 fallback 实显兜底词「流派」=僵尸文案），卡片=件名+效果摘要两行）
|
# 表无 archetype，fallback 兜底词「流派」会实显僵尸文案），卡片=件名+效果摘要两行）
|
||||||
static func feat_card_text(row: Dictionary) -> String:
|
static func feat_card_text(row: Dictionary) -> String:
|
||||||
if row.is_empty() or String(row.get("feat_id", "")) == "":
|
if row.is_empty() or String(row.get("feat_id", "")) == "":
|
||||||
return "特性\n???"
|
return "特性\n???"
|
||||||
@@ -151,7 +151,7 @@ static func bonus_keystone_line(payload: Dictionary) -> String:
|
|||||||
return "钥石 +%d · 累计 %d" % [int(payload.get("keystone_gained", 0)), int(payload.get("keystone_total", 0))]
|
return "钥石 +%d · 累计 %d" % [int(payload.get("keystone_gained", 0)), int(payload.get("keystone_total", 0))]
|
||||||
|
|
||||||
|
|
||||||
# 奖励节点三选一头部行（迭代 10 追加批——与通关三选一共享同池；node-reward.md v2）
|
# 奖励节点三选一头部行（与通关三选一共享同池；node-reward.md v2）
|
||||||
static func node_curio_header() -> String:
|
static func node_curio_header() -> String:
|
||||||
return "关卡奖励点\n从提升池抽三选一（与通关三选一同池同权重同上限）：\n选择一件带走："
|
return "关卡奖励点\n从提升池抽三选一（与通关三选一同池同权重同上限）：\n选择一件带走："
|
||||||
|
|
||||||
@@ -168,7 +168,7 @@ static func adventure_summary_text(summary: Dictionary) -> String:
|
|||||||
int(summary.get("keystone_total", 0)), int(summary.get("master_seed", 0))]
|
int(summary.get("keystone_total", 0)), int(summary.get("master_seed", 0))]
|
||||||
|
|
||||||
|
|
||||||
# 钥石入账明细文案（元进度实现批；迭代 10 改口径——钥石全源 = Boss 逐杀掉落，「大奖励」行退役；
|
# 钥石入账明细文案（钥石全源 = Boss 逐杀掉落，无「大奖励」行；
|
||||||
# name_lookup = item_id → 显示名投影，由组合根自 meta 表喂入）
|
# name_lookup = item_id → 显示名投影，由组合根自 meta 表喂入）
|
||||||
static func keystone_settle_text(detail: Dictionary, name_lookup: Dictionary = {}) -> String:
|
static func keystone_settle_text(detail: Dictionary, name_lookup: Dictionary = {}) -> String:
|
||||||
var parts: Array[Variant] = []
|
var parts: Array[Variant] = []
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name CampFlowContext
|
class_name CampFlowContext
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# 营地/商店投影的构造上下文（迭代 27 T4——审计 P1-5：控制器构造参数收拢为 context 对象，
|
# 营地/商店投影的构造上下文（控制器构造参数收拢为 context 对象，
|
||||||
# 原 13 参长签名收一处命名面——单测可直接 new() 本 context + 控制器获得独立实例化缝）。
|
# 原 13 参长签名收一处命名面——单测可直接 new() 本 context + 控制器获得独立实例化缝）。
|
||||||
# 字段即原构造参数逐一同名迁移；依赖仅视图句柄 + 查询/编排 Callable（组合根注入）。
|
# 字段即原构造参数逐一同名迁移；依赖仅视图句柄 + 查询/编排 Callable（组合根注入）。
|
||||||
|
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
extends RefCounted
|
extends RefCounted
|
||||||
|
|
||||||
var db
|
var db
|
||||||
var _meta_get: Callable # () → 元进度账本现值（组合根 lambda——探针 isolate_save 换注面，迭代13 T4 实证）
|
var _meta_get: Callable # () → 元进度账本现值（组合根 lambda——探针 isolate_save 换注面）
|
||||||
var _save_get: Callable # () → 存档承载现值（同上——营地 recent 摘要读数面）
|
var _save_get: Callable # () → 存档承载现值（同上——营地 recent 摘要读数面）
|
||||||
var camp_overlay: CampOverlay
|
var camp_overlay: CampOverlay
|
||||||
var shop_overlay: ShopOverlay
|
var shop_overlay: ShopOverlay
|
||||||
@@ -20,7 +20,7 @@ var _refresh_resume_button: Callable
|
|||||||
|
|
||||||
|
|
||||||
func _init(ctx: CampFlowContext) -> void:
|
func _init(ctx: CampFlowContext) -> void:
|
||||||
# 迭代 27 T4——构造参数收拢 context 对象（P1-5：13 参长签名收一处命名面；字段逐一同名迁移）
|
# 构造参数收拢 context 对象（13 参长签名收一处命名面）
|
||||||
db = ctx.db
|
db = ctx.db
|
||||||
_meta_get = ctx.meta_get
|
_meta_get = ctx.meta_get
|
||||||
_save_get = ctx.save_get
|
_save_get = ctx.save_get
|
||||||
@@ -42,30 +42,30 @@ func open_camp() -> void:
|
|||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
if meta == null:
|
if meta == null:
|
||||||
return
|
return
|
||||||
meta.refresh_treasure_unlocks() # 迭代 22 T2——条件解锁刷新换代（旧工坊面退役）
|
meta.refresh_treasure_unlocks() # 条件解锁刷新
|
||||||
start_overlay.visible = false
|
start_overlay.visible = false
|
||||||
_open_modal.call(camp_overlay) # 模态栈单口（T3 收口批——登记层开合一律走栈）
|
_open_modal.call(camp_overlay) # 模态栈单口（登记层开合一律走栈）
|
||||||
camp_overlay.open_camp(camp_data())
|
camp_overlay.open_camp(camp_data())
|
||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
func on_camp_closed() -> void:
|
func on_camp_closed() -> void:
|
||||||
_close_modal.call(camp_overlay) # 模态栈单口（T3 收口批）
|
_close_modal.call(camp_overlay) # 模态栈单口
|
||||||
start_overlay.visible = true
|
start_overlay.visible = true
|
||||||
_refresh_resume_button.call() # 迭代 8 卡②——回菜单按断点在档态刷新
|
_refresh_resume_button.call() # 回菜单按断点在档态刷新
|
||||||
_refresh_presentations.call() # 关闭后刷新顶栏（工坊解锁可能变了余额侧读数面）
|
_refresh_presentations.call() # 关闭后刷新顶栏（工坊解锁可能变了余额侧读数面）
|
||||||
|
|
||||||
|
|
||||||
# 营地快照投影（纯读——秘宝匣 12 件/同调装配/树面/锻造工坊两区六路线/余额/最近冒险；拼句归
|
# 营地快照投影（纯读——秘宝匣 12 件/同调装配/树面/锻造工坊两区六路线/余额/最近冒险；拼句归
|
||||||
# CampOverlay，账面归 MetaProgression。属性锻造三行投影已删——迭代 21 T4 柜台退役；工坊六行换代
|
# CampOverlay，账面归 MetaProgression。锻造三行投影不在本投影内；
|
||||||
# = 迭代 22 T2 秘宝匣；forge 键=迭代 23 T6 锻造工坊路线行板投影）
|
# workshop 键=秘宝匣 12 件；forge 键=锻造工坊路线行板投影）
|
||||||
func camp_data() -> Dictionary:
|
func camp_data() -> Dictionary:
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
return {
|
return {
|
||||||
"balance": meta.keystone_balance() if meta != null else 0,
|
"balance": meta.keystone_balance() if meta != null else 0,
|
||||||
"workshop": meta.treasure_shop_status() if meta != null else [], # 键名沿 workshop（视图消费键不变——行内容=秘宝匣 12 件解锁投影）
|
"workshop": meta.treasure_shop_status() if meta != null else [], # 键名沿 workshop（视图消费键不变——行内容=秘宝匣 12 件解锁投影）
|
||||||
"forge": meta.forge_shop_status() if meta != null else [], # 迭代 23 T6——锻造工坊两区六路线投影
|
"forge": meta.forge_shop_status() if meta != null else [], # 锻造工坊两区六路线投影
|
||||||
"attune": meta.attune_camp_status() if meta != null else {}, # 迭代 11 第①批 T4——同调装配面投影
|
"attune": meta.attune_camp_status() if meta != null else {}, # 同调装配面投影
|
||||||
"tree": meta.tree_camp_rows() if meta != null else [], # 树面投影（含 forge_workshop/ks_workshop 钥匙门判据行）
|
"tree": meta.tree_camp_rows() if meta != null else [], # 树面投影（含 forge_workshop/ks_workshop 钥匙门判据行）
|
||||||
"fork_groups": meta.tree_fork_groups() if meta != null else [],
|
"fork_groups": meta.tree_fork_groups() if meta != null else [],
|
||||||
"recent": _save_get.call().recent_summaries() if _save_get.call() != null else [],
|
"recent": _save_get.call().recent_summaries() if _save_get.call() != null else [],
|
||||||
@@ -76,7 +76,7 @@ func on_camp_buy(attr: String) -> void:
|
|||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
if meta == null:
|
if meta == null:
|
||||||
return
|
return
|
||||||
# 秘宝钥石购买（迭代 22 秘宝批 T4——秘宝匣柜台购买钮意图；写口唯一=buy_treasure_unlock，
|
# 秘宝钥石购买（秘宝匣柜台购买钮意图；写口唯一=buy_treasure_unlock，
|
||||||
# 余额闸/重复购/条件件误购三重拒绝零副作用）
|
# 余额闸/重复购/条件件误购三重拒绝零副作用）
|
||||||
if attr != "attune_refresh":
|
if attr != "attune_refresh":
|
||||||
if not meta.buy_treasure_unlock(attr):
|
if not meta.buy_treasure_unlock(attr):
|
||||||
@@ -85,8 +85,8 @@ func on_camp_buy(attr: String) -> void:
|
|||||||
camp_overlay.refresh_camp(camp_data())
|
camp_overlay.refresh_camp(camp_data())
|
||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
return
|
return
|
||||||
# Y 刷新升级行购买（迭代 11 第①批 T4——P1 甲；双入口之一 Q1 裁乙——树上 ks_refresh 同账；
|
# Y 刷新升级行购买（双入口之一——树上 ks_refresh 同账；
|
||||||
# 按钮禁用为常态防线，兜底拒绝可见 pattern 1。属性锻造面已退役——buy_forge 分支随批删除）
|
# 按钮禁用为常态防线，兜底拒绝可见 pattern 1。本函数无属性锻造分支）
|
||||||
if not meta.buy_attune_refresh():
|
if not meta.buy_attune_refresh():
|
||||||
toast.show_toast("购买被拒", "warn")
|
toast.show_toast("购买被拒", "warn")
|
||||||
return
|
return
|
||||||
@@ -94,7 +94,7 @@ func on_camp_buy(attr: String) -> void:
|
|||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
# 同调装配切换（迭代 11 第①批 T4——装配关系唯一写口经 MetaProgression.toggle_attunement；满位兜底拒绝可见）
|
# 同调装配切换（装配关系唯一写口经 MetaProgression.toggle_attunement；满位兜底拒绝可见）
|
||||||
func on_camp_attune_toggle(item_id: String) -> void:
|
func on_camp_attune_toggle(item_id: String) -> void:
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
if meta == null:
|
if meta == null:
|
||||||
@@ -105,7 +105,7 @@ func on_camp_attune_toggle(item_id: String) -> void:
|
|||||||
camp_overlay.refresh_camp(camp_data())
|
camp_overlay.refresh_camp(camp_data())
|
||||||
|
|
||||||
|
|
||||||
# 天赋树购买（迭代 12 T9——写口唯一归 MetaProgression.tree_buy/tree_buy_fork；Fork 节点购=激活侧）
|
# 天赋树购买（写口唯一归 MetaProgression.tree_buy/tree_buy_fork；Fork 节点购=激活侧）
|
||||||
func on_camp_tree_buy(node_id: String) -> void:
|
func on_camp_tree_buy(node_id: String) -> void:
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
if meta == null:
|
if meta == null:
|
||||||
@@ -118,7 +118,7 @@ func on_camp_tree_buy(node_id: String) -> void:
|
|||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
# A/B 免费切换（迭代 12 T8——同组换侧零币；未激活组走购买面）
|
# A/B 免费切换（同组换侧零币；未激活组走购买面）
|
||||||
func on_camp_fork_toggle(group: String, side: String) -> void:
|
func on_camp_fork_toggle(group: String, side: String) -> void:
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
if meta == null:
|
if meta == null:
|
||||||
@@ -130,7 +130,7 @@ func on_camp_fork_toggle(group: String, side: String) -> void:
|
|||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
# ---- 锻造工坊三意图（迭代 23 T6——契约 9：写口唯一归 MetaProgression 锻造写口族；UI 只发意图）----
|
# ---- 锻造工坊三意图（契约 9：写口唯一归 MetaProgression 锻造写口族；UI 只发意图）----
|
||||||
# 路线购买（几何价；余额不足/未解锁/满级=核心拒绝零副作用，兜底拒绝可见 pattern 1）
|
# 路线购买（几何价；余额不足/未解锁/满级=核心拒绝零副作用，兜底拒绝可见 pattern 1）
|
||||||
func on_camp_forge_buy(route_id: String) -> void:
|
func on_camp_forge_buy(route_id: String) -> void:
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
class_name CurioFlowContext
|
class_name CurioFlowContext
|
||||||
extends RefCounted
|
extends RefCounted
|
||||||
# 三选一/替换子交互的构造上下文（迭代 27 T4——审计 P1-5：控制器构造参数收拢为 context 对象，
|
# 三选一/替换子交互的构造上下文（控制器构造参数收拢为 context 对象，
|
||||||
# 原 16 参长签名收一处命名面——单测可直接 new() 本 context + 控制器获得独立实例化缝）。
|
# 原 16 参长签名收一处命名面——单测可直接 new() 本 context + 控制器获得独立实例化缝）。
|
||||||
# 字段即原构造参数逐一同名迁移；依赖仅视图句柄 + 查询/编排 Callable（组合根注入）。
|
# 字段即原构造参数逐一同名迁移；依赖仅视图句柄 + 查询/编排 Callable（组合根注入）。
|
||||||
|
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ extends RefCounted
|
|||||||
const Narrator := preload("res://presentation/battle_narrator.gd")
|
const Narrator := preload("res://presentation/battle_narrator.gd")
|
||||||
|
|
||||||
var db
|
var db
|
||||||
var _meta_get: Callable # () → 元进度账本现值（组合根 lambda——探针 isolate_save 换注面，迭代13 T4 实证）
|
var _meta_get: Callable # () → 元进度账本现值（组合根 lambda——探针 isolate_save 换注面）
|
||||||
var curio_overlay: CurioPickOverlay
|
var curio_overlay: CurioPickOverlay
|
||||||
var end_overlay: BattleEndOverlay
|
var end_overlay: BattleEndOverlay
|
||||||
var board_view: BoardView
|
var board_view: BoardView
|
||||||
@@ -18,18 +18,18 @@ var _adventure_get: Callable # () → 冒险结构现值（组合根
|
|||||||
var _runner_get: Callable # () → 关卡推进器现值（组合根 lambda——reward_node 继续推进）
|
var _runner_get: Callable # () → 关卡推进器现值（组合根 lambda——reward_node 继续推进）
|
||||||
var _adventure_mode_get: Callable # () → 冒险模式标记现值（组合根 lambda）
|
var _adventure_mode_get: Callable # () → 冒险模式标记现值（组合根 lambda）
|
||||||
var _open_modal: Callable # 模态栈单口（组合根）
|
var _open_modal: Callable # 模态栈单口（组合根）
|
||||||
var _open_modal_after_playback: Callable # 演播后排窗单口（T17——组合根）
|
var _open_modal_after_playback: Callable # 演播后排窗单口（组合根）
|
||||||
var _close_modal: Callable
|
var _close_modal: Callable
|
||||||
var _refresh_presentations: Callable
|
var _refresh_presentations: Callable
|
||||||
var _fatal_screen: Callable
|
var _fatal_screen: Callable
|
||||||
var _gp_summary: Callable # () → 战斗总结 GP 行文案（组合根 lambda——_last_gain_amount 取数面在根）
|
var _gp_summary: Callable # () → 战斗总结 GP 行文案（组合根 lambda——_last_gain_amount 取数面在根）
|
||||||
|
|
||||||
var _pending_curio := {} # 三选一停点载荷暂存（迭代 10——战斗总结结算确认后开三选一面；续玩停点复用）
|
var _pending_curio := {} # 三选一停点载荷暂存（战斗总结结算确认后开三选一面；续玩停点复用）
|
||||||
var _curio_context := "level_clear" # 三选一面上下文（level_clear=通关停点→推进下一关 / reward_node=奖励节点→回图选路）
|
var _curio_context := "level_clear" # 三选一面上下文（level_clear=通关停点→推进下一关 / reward_node=奖励节点→回图选路）
|
||||||
|
|
||||||
|
|
||||||
func _init(ctx: CurioFlowContext) -> void:
|
func _init(ctx: CurioFlowContext) -> void:
|
||||||
# 迭代 27 T4——构造参数收拢 context 对象（P1-5：16 参长签名收一处命名面；字段逐一同名迁移）
|
# 构造参数收拢 context 对象（16 参长签名收一处命名面）
|
||||||
db = ctx.db
|
db = ctx.db
|
||||||
_meta_get = ctx.meta_get
|
_meta_get = ctx.meta_get
|
||||||
curio_overlay = ctx.curio_overlay
|
curio_overlay = ctx.curio_overlay
|
||||||
@@ -49,7 +49,7 @@ func _init(ctx: CurioFlowContext) -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 停点在途判据（组合根 _on_battle_end_continue 分派面——战斗总结确认后开三选一）
|
# 停点在途判据（组合根 _on_battle_end_continue 分派面——战斗总结确认后开三选一）
|
||||||
# 续玩停点恢复入口（true=已接手呈现，调用方中止后续分派）。空候选降级（2026-10-06 用户令）：
|
# 续玩停点恢复入口（true=已接手呈现，调用方中止后续分派）。空候选降级：
|
||||||
# 候选 0 件不开选择面（空面无卡无钮=死面）——消化停点后按上下文直落后续推进（战斗总结面已
|
# 候选 0 件不开选择面（空面无卡无钮=死面）——消化停点后按上下文直落后续推进（战斗总结面已
|
||||||
# 给过玩家确认拍，三选一环节整体跳过）
|
# 给过玩家确认拍，三选一环节整体跳过）
|
||||||
func resume_if_pending() -> bool:
|
func resume_if_pending() -> bool:
|
||||||
@@ -61,7 +61,7 @@ func resume_if_pending() -> bool:
|
|||||||
return true
|
return true
|
||||||
|
|
||||||
|
|
||||||
# 停点空候选跳过（2026-10-06 用户令——「选出来 0 个则直接跳过该环节」）：分派与 on_continue
|
# 停点空候选跳过（「选出来 0 个则直接跳过该环节」）：分派与 on_continue
|
||||||
# 同构（level_clear=推进下一关 / reward_node=兑付确认回图选路 / feat_ticket=只关面回店），
|
# 同构（level_clear=推进下一关 / reward_node=兑付确认回图选路 / feat_ticket=只关面回店），
|
||||||
# 差异仅零面可收——curio_overlay 未开不 close。core 停点经 skip_empty_curio 消化后推进
|
# 差异仅零面可收——curio_overlay 未开不 close。core 停点经 skip_empty_curio 消化后推进
|
||||||
#（continue_to_next_level 的「停点未兑付拒推进」守卫因此放行）。
|
#（continue_to_next_level 的「停点未兑付拒推进」守卫因此放行）。
|
||||||
@@ -90,18 +90,18 @@ func on_presented(payload: Dictionary) -> void:
|
|||||||
_pending_curio = payload.duplicate(true)
|
_pending_curio = payload.duplicate(true)
|
||||||
_curio_context = "feat_ticket"
|
_curio_context = "feat_ticket"
|
||||||
if (_pending_curio.get("candidates", []) as Array).is_empty():
|
if (_pending_curio.get("candidates", []) as Array).is_empty():
|
||||||
# 空候选防御（2026-10-06 用户令——零卡不开死面；core _redeem_feat_ticket 守卫外的末道）
|
# 空候选防御（零卡不开死面；core _redeem_feat_ticket 守卫外的末道）
|
||||||
_skip_empty_stop()
|
_skip_empty_stop()
|
||||||
return
|
return
|
||||||
_open_modal.call(curio_overlay)
|
_open_modal.call(curio_overlay)
|
||||||
curio_overlay.open_pick(Narrator.node_curio_header(), _curio_card_texts(payload.get("candidates", []) as Array))
|
curio_overlay.open_pick(Narrator.node_curio_header(), _curio_card_texts(payload.get("candidates", []) as Array))
|
||||||
return
|
return
|
||||||
if int(payload.get("aux_cleared", 0)) > 0:
|
if int(payload.get("aux_cleared", 0)) > 0:
|
||||||
toast.show_toast("上关剩余 %d 件秘宝已随关卡结束清空" % int(payload.get("aux_cleared", 0)), "info") # 迭代 7 T4 清空反馈
|
toast.show_toast("上关剩余 %d 件秘宝已随关卡结束清空" % int(payload.get("aux_cleared", 0)), "info") # 清空反馈
|
||||||
_pending_curio = payload.duplicate(true)
|
_pending_curio = payload.duplicate(true)
|
||||||
_curio_context = "level_clear"
|
_curio_context = "level_clear"
|
||||||
if bool(payload.get("refreshed", false)):
|
if bool(payload.get("refreshed", false)):
|
||||||
# 刷新重发（2026-10-06）：refreshed 标直落选择面——不再重开胜利总结面
|
# 刷新重发：refreshed 标直落选择面——不再重开胜利总结面
|
||||||
show_pick()
|
show_pick()
|
||||||
return
|
return
|
||||||
end_overlay.open_victory(Narrator.battle_end_text("victory", false), "继续",
|
end_overlay.open_victory(Narrator.battle_end_text("victory", false), "继续",
|
||||||
@@ -111,15 +111,15 @@ func on_presented(payload: Dictionary) -> void:
|
|||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
# 奖励节点三选一（迭代 10 追加批——与通关三选一共享同池同权重同上限；CurioPickOverlay 共用面）。
|
# 奖励节点三选一（与通关三选一共享同池同权重同上限；CurioPickOverlay 共用面）。
|
||||||
# 原「秘宝投放渠道」三选一（迭代 7 过渡形态）随批退役；替换子交互随迭代 22 T5 拆除。
|
# 无替换子交互（同调装配不可变，见类头）。
|
||||||
func present_node_curio() -> void:
|
func present_node_curio() -> void:
|
||||||
var adventure = _adventure_get.call()
|
var adventure = _adventure_get.call()
|
||||||
_curio_context = "reward_node"
|
_curio_context = "reward_node"
|
||||||
var node_draw: Dictionary[Variant, Variant] = adventure.node_curio_candidates()
|
var node_draw: Dictionary[Variant, Variant] = adventure.node_curio_candidates()
|
||||||
var node_cands: Array[Variant] = node_draw.get("candidates", []) as Array
|
var node_cands: Array[Variant] = node_draw.get("candidates", []) as Array
|
||||||
if node_cands.is_empty():
|
if node_cands.is_empty():
|
||||||
# 空池降级（2026-10-06 用户令）——不开面、不挂节点停点（present_node_curio 未调即未挂），
|
# 空池降级——不开面、不挂节点停点（present_node_curio 未调即未挂），
|
||||||
# 兑付确认直落回图选路（auto-sim「node_entered 回调内立即 continue_after_node」先例）
|
# 兑付确认直落回图选路（auto-sim「node_entered 回调内立即 continue_after_node」先例）
|
||||||
toast.show_toast("可用战利品为空——本次三选一跳过", "info")
|
toast.show_toast("可用战利品为空——本次三选一跳过", "info")
|
||||||
var runner = _runner_get.call()
|
var runner = _runner_get.call()
|
||||||
@@ -129,7 +129,7 @@ func present_node_curio() -> void:
|
|||||||
_open_modal.call(curio_overlay)
|
_open_modal.call(curio_overlay)
|
||||||
curio_overlay.open_pick(Narrator.node_curio_header(), _curio_card_texts(node_cands))
|
curio_overlay.open_pick(Narrator.node_curio_header(), _curio_card_texts(node_cands))
|
||||||
adventure.present_node_curio(node_cands)
|
adventure.present_node_curio(node_cands)
|
||||||
_feed_refresh_display(adventure) # 迭代 11 第①批 T5b + 2026-10-06 对齐商店——刷新面投喂单点
|
_feed_refresh_display(adventure) # 刷新面投喂单点
|
||||||
|
|
||||||
|
|
||||||
# 三选一面开出（战斗总结结算确认 / 续玩停点恢复）
|
# 三选一面开出（战斗总结结算确认 / 续玩停点恢复）
|
||||||
@@ -139,7 +139,7 @@ func show_pick() -> void:
|
|||||||
curio_overlay.open_pick(Narrator.curio_pick_header(payload), _curio_card_texts(payload.get("candidates", []) as Array))
|
curio_overlay.open_pick(Narrator.curio_pick_header(payload), _curio_card_texts(payload.get("candidates", []) as Array))
|
||||||
var adventure = _adventure_get.call()
|
var adventure = _adventure_get.call()
|
||||||
if adventure != null:
|
if adventure != null:
|
||||||
_feed_refresh_display(adventure) # 迭代 11 第①批 T5b + 2026-10-06 对齐商店——刷新面投喂单点
|
_feed_refresh_display(adventure) # 刷新面投喂单点
|
||||||
_refresh_presentations.call()
|
_refresh_presentations.call()
|
||||||
|
|
||||||
|
|
||||||
@@ -173,10 +173,10 @@ func _curio_card_texts(candidates: Array) -> Array:
|
|||||||
|
|
||||||
|
|
||||||
# 道具件卡片行（掷定前置——具体道具名 + 效果摘要；空 iid = 无预掷回退态显示通用文案）。
|
# 道具件卡片行（掷定前置——具体道具名 + 效果摘要；空 iid = 无预掷回退态显示通用文案）。
|
||||||
# 内容数据驱动扩展批 T4 文案表值化：效果摘要=数据行 desc 字段直读（零 kind 硬编码映射——
|
# 文案表值化：效果摘要=数据行 desc 字段直读（零 kind 硬编码映射——
|
||||||
# 新件写行即有名有姓）
|
# 新件写行即有名有姓）
|
||||||
|
|
||||||
# 三选一刷新（迭代 11 第①批 T5b X/Y 双源 + 2026-10-06 用户令对齐商店 MC-1——免费位用尽转 GP 付费档：
|
# 三选一刷新（X/Y 双源 + 对齐商店 MC-1——免费位用尽转 GP 付费档：
|
||||||
# 同 shop_refresh_cost_base/curve 旋钮、同冒险钱包 runner.gp；通关停点经重发 curio_choice_presented 直落
|
# 同 shop_refresh_cost_base/curve 旋钮、同冒险钱包 runner.gp；通关停点经重发 curio_choice_presented 直落
|
||||||
# 选择面，节点停点在此读在途态重 present——零自动推进契约不破，停点仍在途）
|
# 选择面，节点停点在此读在途态重 present——零自动推进契约不破，停点仍在途）
|
||||||
func on_refresh() -> void:
|
func on_refresh() -> void:
|
||||||
@@ -246,7 +246,7 @@ func on_continue() -> void:
|
|||||||
|
|
||||||
|
|
||||||
# 秘宝 item_id → 显示名投影（keystone_settle_text/替换子命名文案数据源——拼句归 Narrator）；
|
# 秘宝 item_id → 显示名投影（keystone_settle_text/替换子命名文案数据源——拼句归 Narrator）；
|
||||||
# 迭代 22 T2 数据源换代：旧工坊行族退役，改读 treasure 装配词表 12 件
|
# 数据源=treasure 装配词表 12 件
|
||||||
func item_name_lookup() -> Dictionary:
|
func item_name_lookup() -> Dictionary:
|
||||||
var lookup := {}
|
var lookup := {}
|
||||||
var meta = _meta_get.call()
|
var meta = _meta_get.call()
|
||||||
|
|||||||
@@ -26,7 +26,7 @@ func _init(db_ref, rng_ref, hero_override: Callable, seed_value: Callable) -> vo
|
|||||||
_seed_value = seed_value
|
_seed_value = seed_value
|
||||||
|
|
||||||
|
|
||||||
# 单场遭遇原语（2026-09-13 用户裁决：单场用户入口已删——本方法仅 ui_probe 单场段使用；
|
# 单场遭遇原语（无单场用户入口——本方法仅 ui_probe 单场段使用；
|
||||||
# 无延续、standalone 终局语义保留供探针战斗收尾）
|
# 无延续、standalone 终局语义保留供探针战斗收尾）
|
||||||
func start_single(level: int) -> bool:
|
func start_single(level: int) -> bool:
|
||||||
_level_mode = false
|
_level_mode = false
|
||||||
|
|||||||
Loaded 100 of 235 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user