Merge branch 'master' into qa-harness

# Conflicts: # game/probe/probe_ui_util.gd
2026-11-06 01:52:17 +08:00
commit 886368684c
@@ -79,7 +79,7 @@

 ### 8.2 四层与真实入口

- **单元**：不依赖场景树和真实宿主的纯逻辑；测试从领域类的对外方法进出，断言钉对外可观测面（返回值／信号／查询接口／落盘内容）。内部字段直查＝受控例外：仅当该行为没有公开可观测面可钉时允许，对照表该行注明理由；存量不回头清扫，被批次触碰时顺带换代。
+- **单元**：不依赖场景树和真实宿主的纯逻辑；测试从领域类的对外方法进出，断言钉对外可观测面（返回值／信号／查询接口／落盘内容）。内部字段直查＝受控例外：仅当该行为没有公开可观测面可钉时允许，对照表该行注明理由；存量不回头清扫，被批次触碰时顺带换代。探针直读视口承载子件结构（画布取视口首子件、渐隐带两片与平移提示子件按名取）属此类——断言对象即承载结构本身，无公开可观测面可钉，理由随对照表行申报。
 - **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。接口级断言随单元套件落（`unit/contracts/`），不另设承载目录。
 - **集成**：跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩；测试必须实例化真实宿主链，禁止用裸 EffectEngine 代替。
 - **探针/golden**：玩家可达性与观感；真实实例化场景、驱动真实输入。
@@ -47,12 +47,6 @@

 | 专名 | 是什么 | 出处条目 |
 |---|---|---|
-| 显影尘 | 信息类秘宝 | aux_items |
-| 工兵令 | 加行动点的秘宝 | aux_items |
-| 探宝罗盘 | 预读奖励身份的秘宝 | aux_items |
-| 探巢摆钟 | 探知巢穴位置的秘宝 | aux_items |
-| 地穴全图卷 | 全图级稀有秘宝 | aux_items |
-| 爆破工兵包 | 行动点 + 探巢的稀有秘宝 | aux_items |
 | 地精 / 熊地精 / 食人魔酋长 | 首发三敌种（末者为 Boss） | enemy |
 | 第一层 · 地精洞窟 | 首关层名 | level_table |
 | 封印 | 正式动作名（全库统一，非比喻、非呈现层别名）——对未开格实施封印，印记=封印印记 | terminology |
@@ -38,7 +38,7 @@ MVP 不加新敌种，也不做同深度多敌种混搭；敌种扩容走 `enemy

 目录（重设计 v1）已定稿 **12 件**（普通 7 / 优秀 3 / 稀有 2——代号制，正式命名归用户；数值全 provisional 归调参批），现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录（重设计 v1）」节。数据行随实装批落表（同调件数据表 = `data/tables/treasure_items.tres`），MVP 不新增。

-旧目录（旧 aux_items 六行：显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包，及过渡形态诸件）已全数退役、只作素材库（design/content-archive/道具退役素材库.md）；旧行删除归实装批。
+旧目录（旧 aux_items 六行：显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包，及过渡形态诸件）已全数退役、留底 design/content-archive/道具退役素材库.md（数据表旧行已删净——treasure_items.tres 旧六名扫描零命中）。

 ## 增益与状态

@@ -1,7 +1,7 @@
 # 地图战斗资源

 > 一句话：格面资源的产出、极性字典与清图奖励封装
-> 状态：已定稿；现行为 v1.5
+> 状态：已定稿；现行为 v1.6

 ## 设计目的

@@ -96,7 +96,7 @@

 - **档由两个参数定义：概率位 + 保底上限**。「永不保底」不单立规则——T4 的保底上限 = 0 即其统一表达；T1/T2 上限同为 0。
 - **保底数量挂在型上、不挂在档上**：每个型各自登记「每板至少出几个」。档内登记保底的型数 ≤ 档上限 → 全部兑现；> 上限 → 每板从登记型中随机选定「上限」个兑现，其余型该板按普通概率出现、不保底。
- **补签纪律**：执行序 = 装板摇号（含偏运硬币投影）→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份：危险格与安全格不动（补签格可为雷可为安全格，危险格与安全格同池不破）、不消费权重（补签不是一次取号）、清图判定不动、不泄露元信息（补签格与摇号格不可区分）。粒度 = 板，换板重新校验。
+- **补签纪律**：执行序 = 装板摇号（含订阅加权投影）→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份：危险格与安全格不动（补签格可为雷可为安全格，危险格与安全格同池不破）、不消费权重（补签不是一次取号）、清图判定不动、不泄露元信息（补签格与摇号格不可区分）。粒度 = 板，换板重新校验。
 - **GP 数值锚**：以战斗结束 GP 奖励为锚——小 GP 袋 ≈ 其 1/10、大宝箱 ≈ 其 1 倍（具体数值归调参批）。
 - 大宝箱为枚举新增（九型→十型走本文修订流程，不随手加行）；微光归通用增益组（五色相不变，组内不细分正好容下）。
 - **对外稀有度映射**（现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节）：T1=普通 / T2=优秀 / T3=稀有 / T4=传说；任何概率提升禁止改变本档保底承诺（保底=承诺非概率）。
@@ -1,7 +1,7 @@
 # 战斗结算

 > 一句话：轮末结算的编排与逐行兑现
-> 状态：已定稿；现行为 v1.7
+> 状态：已定稿；现行为 v1.8

 ## 设计目的

@@ -84,7 +84,7 @@
 | 判定行 | 胜 / 负 / 继续各一行；终局判定行同时是胜负画面的数据锚 |
 | 高光行 | 完美封印成立时一行，只记实际有效兑付 |

-每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：两类"未生效"行如实记录合法例外，呈现时聚合计数，不逐行刷屏。
+每行还携带公共字段：来源类别、来源格、轮次、显示名、数值，以及可空的高光标记（用于强调封印标中、清图奖励这类值得高亮的结果）。**显示名等玩家可见文案是数据面字段：文案值登记在数据表行，代码按来源类别与效果身份读表拼行，不在代码里写死文案字串**（2026-11-06 用户裁——文案归属数据表承载；承载表与字段形态归表结构设计段定，设计闭合后由实装批落表）。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约，改动须连动分析工具面。没生效也要留痕：两类"未生效"行如实记录合法例外，呈现时聚合计数，不逐行刷屏。

 任何一行找不到来源即断言失败——宁可返回错误，也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源，断言为此留了两层豁免，豁免集合是封闭清单，改动同样走本文修订。

@@ -1,7 +1,7 @@
 # 术语表

 > 全库专用术语的唯一对照表（2026-10-11 用户令建立）。规矩：新术语先登记本表、再在文档使用；退役词见文末对照表，文档正文一律使用现行词。文档中遇到看不懂的词，查本表。用词纪律（禁用词、替换值、豁免范围）见「用语规范」节。
-> 状态：**现行 v1.26**——2026-10-11 建立；历次升版明细见 git 提交史。
+> 状态：**现行 v1.27**——2026-10-11 建立；历次升版明细见 git 提交史。

 ## 格与棋盘

@@ -95,7 +95,7 @@
 | 术语 | 定义 |
 |---|---|
 | 效果端口件 | 战斗业务类（伤害管线／行动经济）唯一的效果发射出口：收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连（机制归属见架构文档「战斗编排域拆件定稿」节轴戊；实现类 EffectPort） |
-| 掷格件 | 装配期格面资源摇号的承载件：池行装配、区间行 roll、权重合成（偏运硬币／board_skew 两路投影）；受理账面留守地图战斗资源件（机制归属同上；实现类 RewardRoller） |
+| 掷格件 | 装配期格面资源摇号的承载件：池行装配、区间行 roll、权重合成（订阅加权/board_skew 两路投影）；受理账面留守地图战斗资源件（机制归属同上；实现类 RewardRoller） |
 | `seal_missed` | 封印落空事件（旧名已换代）：封印动作落在安全格上时发出，订阅面据此做限次与豁免判定 |
 | `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型，`domain=battle` 首例；有效误标＝误标总数 − 豁免数，豁免不改写误标账 |