game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

合并(内容锚改版批): 判据锚行号形态废止全改内容节锚——用户裁(2026-11-09): 锚指向内容不指向行号,文档增删行不牵动锚与测试代码,判据句内容真改动才失配(失配=红,改句文档批同批改锚)。规约落文(test-conventions/req-card/iter/iter-plan/process-conventions 七处)+闸件改核(pipeline_gate C5 与 capability_audit 注记道核「节名在档+关键词命中节内」,共用件 anchor_util.py 逻辑单点,行号形态出现即红)+存量迁移(测试/探针注记 604 条全量内容化+在盘五卡 74 行号指针+写卡段半成品锚 14 处修正); 顺手修红: CI run 152 真红=调试角标恢复批漏网第四处恒隐断言,ui_struct_probe ESC批 V8 按恢复批同口径翻回(探针直跑 exit 0)。区内凭据: 流水线闸 PASS(34 条目/57 行/5 卡全过)+能力审计 --strict 455 函数 0 红+文档域闸【验收通过】; 合回前置检查读数见 pre-merge 钩子; post-merge 钩子推送触发远端 CI
ci / gates (push) Successful in 7m21s
Details

Browse Source
This commit is contained in:
DKChan committed 2026-11-09 08:23:57 +08:00
2 parents 30d63ae94b 04121574c8
commit 57f28922a1
124 files changed
+843 -731
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

.zcode/skills/iter-plan/SKILL.md
+1 -1
View File
@@ -50,7 +50,7 @@ description: g-plan2（Dungeon Sweeper）五段流水线第四段的迭代编排
|---|---|---|
| 1 | 卡内一致性互证 | 🔴契约 vs 任务卡 vs 验证闸对照表 vs 落位预检互相印证——汇总级抽查即可，逐条细查归写卡段复核（req-card grilling 门） |
| 2 | 代码现状锚实核 | 卡片「现状事实」每条 file:line 打开实读；落位预检的新名 grep 全仓应零命中；「计划新增」件核不存在、「复用既有」件核存在 |
| 3 | 判据出处行锚实核 | 对照表每行锚所指文档行打开实读，核句子在位**且内容与该行判据匹配**——机检 C5 只查存在性，查不出内容错位；写卡后文档被其他批改动会使锚漂移（2026-11-07 退役卡 ux 四锚漂移实证） |
| 3 | 判据出处锚实核 | 对照表每行锚按索引（节名定位、行关键词命中行）打开文档节句实读，核句子在位**且内容与该行判据匹配**——机检 C5 核到「关键词命中节内」粒度、查不出语义错位，实读兜语义（2026-11-09 内容锚改版后行号漂移面已消，句内容真改动时关键词失配机检即红） |
| 4 | 验收协议可执行性 | 对拍／等价／重放类判据的「改前基线＋改后载体」两腿齐备：基线怎么来（采集步骤在卡内）、载体在盘可跑（工具在 tools/、锚在 sim-data/、golden 基线在 game/tests/golden/） |
| 5 | 跨卡触碰面交集与卡序语义依赖 | 点名卡集两两过文件交集；同文件改动的语义序（前卡删除面 vs 后卡引用面）；卡序与卡片内取用/产出声明一致 |
| 6 | 跨批次断言钉死面 | 在飞或刚合回批次新增的断言（词表在册、表值钉、行为断言）是否钉住本批要改的退役面 |
.zcode/skills/iter/SKILL.md
+1 -1
View File
@@ -27,7 +27,7 @@ description: g-plan2 迭代开工总指挥。当用户输入 /iter <迭代号>
- **待裁点 ≠ 0**：需求卡片声明待裁点未全裁，或行内有「待用户裁甲/乙」句。
- **迭代估时总量 <5 个工作日**：迭代行状态应处「冻结待凑批」——处待开工/进行中且总量不足即编排缺陷，拒启动并呈报凑批方案（可补卡清单）等用户裁（2026-10-25 两层模型：卡片无工作量门槛，冻结线属迭代层）。
- **需求卡片缺失**：行内引用的需求卡片文件不存在或版本明显滞后于行内裁决记录。
- **改动—验收对照表缺失或不闭合（2026-10-11 立，2026-10-21 升级）**：需求卡片没有改动—验收对照表，或对照表有空行（无真实入口、无判据绑定面），或 T 卡内无对应验收条目 → 不过，停工呈报。**判定口径：每个需求点至少一行；每行必须有落点、真实入口、判据绑定面**——施工性质的验证工作（如「MC 对账适配」）、完成定义里的笼统验证手段（如「MC 对拍留证」）都不算。禁拿 AGENTS.md「新功能必配新测试」红线代偿——那条只保证写了测试，不保证测得对。2026-10-21 前的旧卡缺对照表 → 停工，退回写卡段补，补完再开工。**判据出处行锚（2026-11-05 起）：生效日后（文件名日期不早于该日）的卡，对照表「需求点」格须带 `<现行文档相对路径>:<行号>` 判据出处行锚（机检=pipeline_gate C5）——行缺锚或锚指向不存在＝停工呈报退写卡段；旧卡不回头改，开工前由写卡段补挂**（test-conventions §8.3）。
- **改动—验收对照表缺失或不闭合（2026-10-11 立，2026-10-21 升级）**：需求卡片没有改动—验收对照表，或对照表有空行（无真实入口、无判据绑定面），或 T 卡内无对应验收条目 → 不过，停工呈报。**判定口径：每个需求点至少一行；每行必须有落点、真实入口、判据绑定面**——施工性质的验证工作（如「MC 对账适配」）、完成定义里的笼统验证手段（如「MC 对拍留证」）都不算。禁拿 AGENTS.md「新功能必配新测试」红线代偿——那条只保证写了测试，不保证测得对。2026-10-21 前的旧卡缺对照表 → 停工，退回写卡段补，补完再开工。**判据出处锚（2026-11-05 立，2026-11-09 内容化改版）：对照表「需求点」格须带 `<现行文档相对路径>「节名」<行关键词>` 判据出处锚（机检=pipeline_gate C5：内容锚形态唯一＋节名在档＋关键词命中节内，行号形态出现即红）——行缺锚或锚不可核＝停工呈报退写卡段**（test-conventions §8.3）。
- **自洽扫描（轻量，非拷打）**：声明零待裁点≠逻辑无冲突——读卡后快速核三类：①需求卡片内部矛盾（范围/契约/估时/裁决记录互相打架）；②需求卡片与 roadmap 行冲突（两处说法不一致）；③事实抽查——从需求卡片「现状考证」里抽 3-5 处关键 file:line 到现行代码核对（防需求卡片成文后代码已被其他批改掉，需求卡片变质）。发现疑似冲突 → 逐条列单呈报（哪里矛盾/两种读法各是什么/建议哪边改），**用户裁决后才开工**；零发现则直接通过，不为此拉长开工。全量拷打（/grilling）不在此步做——那是需求卡片成文时的责任，这里只兜网；但**本步必查卡里留没留复核的记录**（见下条），记录不在＝上游没跑，停工退写卡段。
- **复核记录缺失（2026-11-05 用户立规）**：需求卡片内没有「复核记录」节、或该节申报的复核报告文件在 `reports/` 盘上不存在 → 不过，停工呈报退回写卡段。本步不代跑复核、不代补记录、不把缺记录的卡当旧卡放行；生效＝卡片文件名日期 ≥2026-11-06（与 `tools/pipeline_gate.py` 该条卡片判据同口径），更早的卡不回头改。
- **真人检测遗留项不算门（2026-10-12 用户立规）**：往期迭代/批次登记未验的实机目检项（体验验证清单/实现报告总清单在册）不构成开工阻塞——开工呈报带一句提醒即可，禁为此停工等验。
.zcode/skills/req-card/SKILL.md
+3 -3
View File
@@ -1,6 +1,6 @@
---
name: req-card
description: g-plan2（Dungeon Sweeper）仓库写需求卡片的固定流程与结构。当用户要求起草/修订需求卡片、给迭代需求写实施文档、或迭代规划进入写卡阶段时使用。固化需求卡片必备结构——尤其「关联文档同步面」必填节（2026-10-17 文档同步闸 v3：卡片服务的是**代码实现批**，该批禁写 `design/` 与根规则文件，要改文档的点一律列进 `reports/` 反哺点清单，用户在会话中裁决后归文档批落文）、「改动—验收对照表」（2026-10-11 立，2026-10-21 升级：每个需求点与每个行为改动都必须有真实入口断言和判据绑定面；无验收标准的需求点＝卡片不成立，/iter 开工门同规拦截）与「落位与可复用性预检」必填节（2026-10-21 立：新增文件/函数/数据件前先核仓库既有实现，能复用不新增，落点唯一、禁散落 helper、跨层交互显式声明）、「实现规范预算」必填节（2026-10-27 迭代 39 实证立规：新增件接口块/成员面先对 gdstyle 默认阈值做预算——公开方法 ≤20、类变量 ≤15、迁移函数对账基线键，超了写卡段拆件，例外走显式申报＋用户特批，禁把超预算面带进实现段）与「拆分边界纪律」结构类卡必填条款（2026-10-28 用户裁立：拆分边界沿职责轴不沿阈值轴——拆出单元须有职责语句/单一变化原因/集体身份，凑计数袋禁、阈值只作发现信号、拆不出内聚单元停卡呈报走豁免通道，判据权威=code-conventions §1.1）。任务卡 T0..Tn 的步骤写作遵循 superpowers:writing-plans 方法论（2026-10-19 起按本项目适配内联：卡前文件结构图/范围检查/任务右尺寸/步骤粒度/步骤内容四分/接口声明/禁行句式/自审六查）。复核门含判据出处行锚逐行实读（2026-11-07 起，对照表每行锚所指文档行实读核句子在位且内容匹配——机检 C5 只查存在性）与引擎技术面三查（2026-11-04 起，godot-master 窄口径：NEVER/Gotchas/性能预算＋按需领域 reference，权威仍在项目规范）。复核发现按四类去向处置（2026-11-05 立：自判＝查规范或查代码有唯一答案，复核者自己改卡；补写＝卡里漏写，回炉补全；待裁＝多种做法都不违规且代价不同，才交用户；退回上游＝文档线或美术线未闭合、或架构与代码规范本身冲突）；卡片必带「复核记录」节（缺节＝不成立，机检=pipeline_gate），复核先于提交、提交先于合回，顺序没走完禁对用户称完成。
description: g-plan2（Dungeon Sweeper）仓库写需求卡片的固定流程与结构。当用户要求起草/修订需求卡片、给迭代需求写实施文档、或迭代规划进入写卡阶段时使用。固化需求卡片必备结构——尤其「关联文档同步面」必填节（2026-10-17 文档同步闸 v3：卡片服务的是**代码实现批**，该批禁写 `design/` 与根规则文件，要改文档的点一律列进 `reports/` 反哺点清单，用户在会话中裁决后归文档批落文）、「改动—验收对照表」（2026-10-11 立，2026-10-21 升级：每个需求点与每个行为改动都必须有真实入口断言和判据绑定面；无验收标准的需求点＝卡片不成立，/iter 开工门同规拦截）与「落位与可复用性预检」必填节（2026-10-21 立：新增文件/函数/数据件前先核仓库既有实现，能复用不新增，落点唯一、禁散落 helper、跨层交互显式声明）、「实现规范预算」必填节（2026-10-27 迭代 39 实证立规：新增件接口块/成员面先对 gdstyle 默认阈值做预算——公开方法 ≤20、类变量 ≤15、迁移函数对账基线键，超了写卡段拆件，例外走显式申报＋用户特批，禁把超预算面带进实现段）与「拆分边界纪律」结构类卡必填条款（2026-10-28 用户裁立：拆分边界沿职责轴不沿阈值轴——拆出单元须有职责语句/单一变化原因/集体身份，凑计数袋禁、阈值只作发现信号、拆不出内聚单元停卡呈报走豁免通道，判据权威=code-conventions §1.1）。任务卡 T0..Tn 的步骤写作遵循 superpowers:writing-plans 方法论（2026-10-19 起按本项目适配内联：卡前文件结构图/范围检查/任务右尺寸/步骤粒度/步骤内容四分/接口声明/禁行句式/自审六查）。复核门含判据出处锚逐行实读（2026-11-07 起；2026-11-09 内容锚改版后按索引实读——节名定位、行关键词命中行，核句子在位且内容匹配——机检 C5 核到关键词命中节内粒度、语义错位归实读）与引擎技术面三查（2026-11-04 起，godot-master 窄口径：NEVER/Gotchas/性能预算＋按需领域 reference，权威仍在项目规范）。复核发现按四类去向处置（2026-11-05 立：自判＝查规范或查代码有唯一答案，复核者自己改卡；补写＝卡里漏写，回炉补全；待裁＝多种做法都不违规且代价不同，才交用户；退回上游＝文档线或美术线未闭合、或架构与代码规范本身冲突）；卡片必带「复核记录」节（缺节＝不成立，机检=pipeline_gate），复核先于提交、提交先于合回，顺序没走完禁对用户称完成。
---
# 需求卡片写作规范（g-plan2）
@@ -37,7 +37,7 @@ description: g-plan2（Dungeon Sweeper）仓库写需求卡片的固定流程与
5. **范围边界**——做什么不做什么；明示不收件的去向（待办清单登记/后续批）。
6. **关联文档同步面（必填，2026-10-17 改口径：实现批禁写文档）**——三列：文档｜关联点（本批实现会改变它的哪条陈述）｜同步义务。同步义务分三层标注：**设计权威文档**（GDD/art-bible）与**机械面文档**（roadmap 行/术语表/体验验证清单/README）对代码实现批**一律不直改**——实现批**禁写 `design/` 整个目录与根规则文件**，把该改哪一节、改成什么、依据是什么逐条列进 `reports/iter<N>-反哺点-<日期>.md`，由用户在会话中裁决后归文档批落文（不设文档 skill，文档靠会话讨论落地）。实现批唯一可写目录＝`reports/`（2026-10-18 用户裁：根目录会话状态文件已废除，无任何例外）。写卡时就要把「实现会影响哪些文档的哪些说法」查全；查不出也要写「无关联文档」四字，不许省略本节。**机检（2026-10-18 卡片冲突修订批补）**＝`tools/pipeline_gate.py` 判据 C1「文档义务口径」：同步面表内目标格指向 `design/`（含 `../gdd/` 等相对写法）或根规则文件、而义务格仍写「随批」者红——旧口径措辞「机械面随批」自 2026-10-17 起作废，写卡禁沿用；生效＝文件名日期 ≥2026-10-17。
7. **任务卡 T0..Tn**——逐卡估时；**末卡必含「产出物落位卡」**：轻闸全绿后、合并前，把 `reports/` 两份写齐——实现报告（各卡状态＋实机目检总清单＋遗留读数义务＋实现决定记录）、反哺点清单（同步面所列每条都要有落点），方算收口。**禁把任何 `design/` 文件或根规则文件的编辑写进实现批的任务卡**（那是文档批的活）（AGENTS.md 批次工作流 §3.13）。（T 卡内步骤说明的写作纪律见下文「任务卡写作纪律」节，2026-10-19 立。）
8. **验证闸（改动—验收对照表，2026-10-11 立，2026-10-21 升级；2026-10-28 判据口径换代）**——每个需求点列明验收测试内容；每个行为改动也要有一行。表列至少七格：需求点｜改动（文件:行/行为）｜验收测试（名称＋落点＋尾缀）｜层级（单元/接口/集成/探针）｜真实入口｜判据绑定面｜能力行（2026-10-29 起：`既有：<能力名>／新增：<能力名>`；两形态的名称都须在 `game/tests/README.md` 能力表在场，机检=pipeline_gate）。**能力行当场入表（2026-10-29 用户裁，废「滞后一个迭代」）**：写卡时同批维护能力清单（`game/tests/README.md`，四列＝能力｜系统｜真实入口｜代表用例）——本批新增能力当场增行（真实入口取自设计文档已定的入口；代表用例＝本卡定死的计划测试 `文件:函数` 名）；受影响存量行（入口／用例名变更）同批更新；能力退役删行。**实现照单落名**：测试函数名以清单为唯一依据，名实不符＝本卡没写清＝停卡退回；实现批禁写 README 的红线不变，批末收尾只核对表上名字与实际落地一致（改名则回表）。落点位置二选一：写在对应 T 卡里，或集中列在验证闸节逐条编号、由 T 卡交叉引用。**每个需求点至少一行；每行必须有真实入口和判据绑定面——缺任一项＝该需求点未验收，卡片不成立**。**判据出处行锚（2026-11-05 起，对文件名日期不早于该日的卡生效）**：「需求点」格每行必须带判据出处行锚——该行验收判据所依据的现行文档句子，格式 `<文档相对路径>:<行号>`（如 `design/gdd/ux/camp.md:16`）；已退役卡片不算现行文档；规格缺席写不出锚＝停卡退回需求澄清（test-conventions §8.3，机检=pipeline_gate C5）。画面类需求的锚指向 ux/ 文档内嵌预览节的判据句（预览图=设计段已人审的目标画面效果图，也是实现批基线冻结时用户对照的参照——test-conventions §8.2）。**基线审核关卡特殊标注（2026-11-08 用户立）**：需求点触碰渲染黄金图基线（新增锚面／换代／迁移／容差修订）时，该行验收标准必须显式标注「触发基线审核关卡」——基线逐张呈报用户审核确认后才入库生效，T 卡步骤须含呈报审核点；漏标＝复核门退回补写（test-conventions §8.2 审核关卡）。承接 AGENTS.md 硬红线「新功能必配新测试」：那条只兜「有没有」，本表兜「测得对不对、是不是钉在这个改动上」——写卡期不定稿，实现期就自由发挥。
8. **验证闸（改动—验收对照表，2026-10-11 立，2026-10-21 升级；2026-10-28 判据口径换代）**——每个需求点列明验收测试内容；每个行为改动也要有一行。表列至少七格：需求点｜改动（文件:行/行为）｜验收测试（名称＋落点＋尾缀）｜层级（单元/接口/集成/探针）｜真实入口｜判据绑定面｜能力行（2026-10-29 起：`既有：<能力名>／新增：<能力名>`；两形态的名称都须在 `game/tests/README.md` 能力表在场，机检=pipeline_gate）。**能力行当场入表（2026-10-29 用户裁，废「滞后一个迭代」）**：写卡时同批维护能力清单（`game/tests/README.md`，四列＝能力｜系统｜真实入口｜代表用例）——本批新增能力当场增行（真实入口取自设计文档已定的入口；代表用例＝本卡定死的计划测试 `文件:函数` 名）；受影响存量行（入口／用例名变更）同批更新；能力退役删行。**实现照单落名**：测试函数名以清单为唯一依据，名实不符＝本卡没写清＝停卡退回；实现批禁写 README 的红线不变，批末收尾只核对表上名字与实际落地一致（改名则回表）。落点位置二选一：写在对应 T 卡里，或集中列在验证闸节逐条编号、由 T 卡交叉引用。**每个需求点至少一行；每行必须有真实入口和判据绑定面——缺任一项＝该需求点未验收，卡片不成立**。**判据出处锚（2026-11-05 立；2026-11-09 用户裁内容化改版——内容节锚唯一形态，行号形态废止）**：「需求点」格每行必须带判据出处锚——该行验收判据所依据的现行文档句子，格式 `<文档相对路径>「节名」<行关键词>`（如 `design/ux/camp.md「Navigation Position」开始冒险`）；节名＝判据句所在节标题词（首段「·」前须命中目标文档标题行），行关键词＝判据句上的无空白子串（须落在节块内）；锚指向内容不指向行号，文档增删行不牵动卡片；已退役卡片不算现行文档；规格缺席写不出锚＝停卡退回需求澄清（test-conventions §8.3，机检=pipeline_gate C5：内容锚形态唯一＋节名在档＋关键词命中节内，行号形态出现即红）。画面类需求的锚指向 ux/ 文档内嵌预览节的判据句（预览图=设计段已人审的目标画面效果图，也是实现批基线冻结时用户对照的参照——test-conventions §8.2）。**基线审核关卡特殊标注（2026-11-08 用户立）**：需求点触碰渲染黄金图基线（新增锚面／换代／迁移／容差修订）时，该行验收标准必须显式标注「触发基线审核关卡」——基线逐张呈报用户审核确认后才入库生效，T 卡步骤须含呈报审核点；漏标＝复核门退回补写（test-conventions §8.2 审核关卡）。承接 AGENTS.md 硬红线「新功能必配新测试」：那条只兜「有没有」，本表兜「测得对不对、是不是钉在这个改动上」——写卡期不定稿，实现期就自由发挥。
- **测试方式两分法**（2026-10-11 用户定）：能力验证＝调试接口直改游戏数据（改钥石/槽位/解锁状态等，不走正常资源积累流程，沿用现役 DebugOverlay/DS_DEBUG 门控）；正常流程体验验证＝用户目检，观测项写进 `reports/iter<N>-实现报告-<日期>.md` 的实机目检总清单（2026-10-17 起：`体验验证清单.md` 属设计文档，实现批禁写，入册该体验验证清单的条目作为反哺点由文档批落）。每张卡写明哪些点归调试接口验、哪些点归用户目检验。**用户目检一律「登记不阻塞」（2026-10-12 用户立规）**：登记完成即卡内义务了结，验收时间由用户自行安排，不得作为批末收尾、合并或下一迭代开工的前置条件。
- **闸口径（2026-10-17 改按域；2026-10-26 判据改按文件性质）**：轻闸/重闸按 AGENTS.md 分级周期口径——**重闸＝`tools/run_all_gates.sh` 按本批改动域选档**（改动含 `game/` 下非 `.md` 的行为载体 → `--code`；只有文档件——`game/` 内 `.md`、`design/`、根规则文件、`tools/` 工具脚本 → `--docs`；两类都有或改闸件本身 → 不带参数全量），所选域全绿才合并。**卡内禁写死闸件名单与"全量档"字样**（域划分的唯一出处在脚本里）；批末四闸语义改述为「代码域闸全绿（冒烟＋单元＋探针＋渲染/静态）＋改前改后读数对拍」。改完即测铁规照履行：卡内改动落笔即测自己改过的那部分，不请示。
- **回归措辞模板（2026-10-14 闸机轮次纪律，AGENTS.md 同源）**：禁用「每步对拍+全量回归」「每轮全量回归」类措辞——会被执行侧解读成每次修复跑全套；改用模板句：「里程碑步（波/T 段）出口跑一次全套闸；波内修复只做出红最小单元的最窄确认；新增测试/工具先行孤立验证再并入全套」。
@@ -105,7 +105,7 @@ description: g-plan2（Dungeon Sweeper）仓库写需求卡片的固定流程与
- 平实中文，禁自造缩写与名词堆叠；仓库既有术语照用。
- 估时给区间+切分预案（超软盒预挂）。
- **任务卡自审七查（2026-10-19 立五查，2026-10-21 补第六查，2026-10-27 补第七查；借自 superpowers:writing-plans 自审节适配）**：任务卡写完、交 grilling 复核前必跑——①规格覆盖：逐条过「目标与完成定义」的规格项/需求点，每条都能指到一张 T 卡，并指到验收对照表的一行，指不到的补卡/补行；②步骤扫描：每步只能让实施者写出一个合情合理的东西、且一步不多带——不决定事的行是缺口，签名与验收已定的函数体是抄写，两样都就地改；③类型一致性：后卡引用的签名/属性名与早卡定义逐字一致；④审查焦点＋改动覆盖：规格暗示、但没有任何 T 卡测试覆盖的失败模式——对照「验证闸」节逐条过，把最可能坑到玩家的列出来、挂到责任 T 卡补验收条目；同时核文件结构图里的每个行为改动都能指到对照表行，指不到的补测试或标非行为改动；查完确实没有才写「无」；⑤篇幅比例：卡片比它实现的规格长几倍＝在抄程序，代码块占大半就把函数体换成签名＋断言名，再验每步仍无歧义；⑥落位与复用（2026-10-21 用户立规）：逐条过本批每个新增文件、新增函数、新增数据件——**盘上是否已有做同样事的东西（grep 同职责实现、grep 同名与同义标识符）？该功能是否已有唯一落点？同一事实是否只在一处定义、有无 helper 散落「就近的文件」？新增件之间的调用路径与跨层出口是否显式声明？**答案写进卡内「落位与可复用性预检」节并与文件结构图对得上（标「新增」的必须能指到不能复用的理由）；对不上就改成复用既有件、或把重复的落点并进唯一一处；⑦指标预算（2026-10-27 迭代 39 实证立规）：逐条过本批每个新增文件——「实现规范预算」节三查一查的数字与接口块/文件结构图实数一致（数接口块 func 行、数成员 var 行、迁移函数逐个对 `tools/gdstyle_baseline.txt` 源键），少报、漏对账或预算节缺失的回炉补节，存量触面写明「S13 键只降不升」预期。七查发现问题就地改完再交复核，不用再自审一轮；自审在 grilling 之前跑，不替代 grilling 对抗复核。
- **grilling 复核门（2026-10-10 用户立规；2026-11-05 补处置登记义务）**：卡片成文后必经 grilling 多轮复核，裁决全落、零待裁点，卡片才算成立；每轮发现与处置逐条写进卡内「复核记录」节（必备结构第 17 节）。**复核审点含验收清单：逐需求点过「测什么/怎么测/谁验」三问，答不上来的需求点回炉（2026-10-11 用户立规）；并核对照表两端是否对得上、真实入口是否绕过改动点、判据绑定面是否绑被测改动特有的可观测提交面（2026-10-21 立）；再核「落位与可复用性预检」节与文件结构图是否对得上——每个标「新增」的件都要有不能复用的理由与唯一落点，给不出的回炉改成复用（2026-10-21 用户立规）；再核「实现规范预算」节数字与接口块/文件结构图实数一致——少报方法数、漏迁移函数对账、预算节缺失的回炉（2026-10-27 用户立规）；再核「拆分边界纪律」条款在位、每个拆出单元有职责语句与集体身份——凑计数袋形态回炉（2026-10-28 用户立规）；再核「验证闸」对照表每行**判据出处行锚逐行实读**（2026-11-07 用户立）——打开锚所指文档行，核句子在位且内容与该行判据匹配；机检 C5 只查存在性、查不出内容错位，写卡后文档被其他批改动会使锚漂移（2026-11-07 退役卡 ux 四锚漂移实证）；锚失位＝发现清单一条，按四类分流处置；再核引擎技术面三查（接口与边界见下条）：①卡内签名与实装步骤涉及的 Godot API 在 4.7 存在且行为如卡所述；②实装步骤不踩 godot-master NEVER list 与 Gotchas；③热路径/批量/线程形态匹配其性能预算——产出发现清单，逐条按「复核发现四类分流」处置（2026-11-04 用户立规；2026-11-05 补去向口径：只有待裁类归用户裁决，自判与补写两类由复核者自己落卡，退回上游类退对应段）。**
- **grilling 复核门（2026-10-10 用户立规；2026-11-05 补处置登记义务）**：卡片成文后必经 grilling 多轮复核，裁决全落、零待裁点，卡片才算成立；每轮发现与处置逐条写进卡内「复核记录」节（必备结构第 17 节）。**复核审点含验收清单：逐需求点过「测什么/怎么测/谁验」三问，答不上来的需求点回炉（2026-10-11 用户立规）；并核对照表两端是否对得上、真实入口是否绕过改动点、判据绑定面是否绑被测改动特有的可观测提交面（2026-10-21 立）；再核「落位与可复用性预检」节与文件结构图是否对得上——每个标「新增」的件都要有不能复用的理由与唯一落点，给不出的回炉改成复用（2026-10-21 用户立规）；再核「实现规范预算」节数字与接口块/文件结构图实数一致——少报方法数、漏迁移函数对账、预算节缺失的回炉（2026-10-27 用户立规）；再核「拆分边界纪律」条款在位、每个拆出单元有职责语句与集体身份——凑计数袋形态回炉（2026-10-28 用户立规）；再核「验证闸」对照表每行**判据出处锚逐行实读**（2026-11-07 用户立）——按锚索引（节名定位、行关键词命中行）打开文档节句，核句子在位且内容与该行判据匹配；机检 C5 核到「关键词命中节内」粒度、查不出语义错位（句被改写而关键词仍为其子串时机器盲），实读兜语义；锚失位＝发现清单一条，按四类分流处置；再核引擎技术面三查（接口与边界见下条）：①卡内签名与实装步骤涉及的 Godot API 在 4.7 存在且行为如卡所述；②实装步骤不踩 godot-master NEVER list 与 Gotchas；③热路径/批量/线程形态匹配其性能预算——产出发现清单，逐条按「复核发现四类分流」处置（2026-11-04 用户立规；2026-11-05 补去向口径：只有待裁类归用户裁决，自判与补写两类由复核者自己落卡，退回上游类退对应段）。**
- **引擎技术面复核接口（2026-11-04 立，godot-master 窄口径接入）**：本条是 req-card 对 godot-master 技能的唯一引用面，四条收窄——①取用白名单：只取其 SKILL.md 内三块——Part 4 NEVER list（33 条）、Part 8 Gotchas（8 条）、Part 5 性能预算表；卡涉及具体领域（物理/动画/UI/存档/寻路等）时另按其 Part 2 决策矩阵加载与改动面直接相关的 reference，至多 2 个；禁加载工作流链、genre 蓝图与其余整库。②权威边界：只取引擎事实（API 行为、已知坑、预算数字），不取其工程组织主张（目录结构、autoload/signal bus 模式）——架构/分层/数值判断权威仍是本项目 architecture.md、code-conventions 与 data/tables；两者冲突时项目规范赢，冲突本身当轮作为待裁点呈报用户，禁按任一方默默改卡。③输出形态：复核产出＝发现清单（卡内位置＋违反条目号如 NEVER-7/Gotcha-1＋一句依据）＋四类去向之一，其中待裁与退回上游两类不改写方案，自判与补写两类的处置就是把卡改对；引用条目须给编号，判不了标「未判」禁硬判。④成本约束：成本地板＝hub SKILL.md 单文件；卡内 T 步不含节点/信号/Tween/Resource/物理/线程/渲染面时只跑②清单对照，不加载领域 reference；每个领域 reference 一轮复核只加载一次。
- **复核发现四类分流（2026-11-05 用户立规）**：复核者每拿到一条发现，先问「答案从哪来」，四选一登记去向（写进卡内「复核记录」节的去向格）；前两类的处置由复核者自己完成，禁转成问句向用户求裁：
- **自判**——查权威文档或查代码现状就能得到唯一答案。权威文档＝本卡设计事实源那一份 owner 文档＋`design/engineering/` 五份规约与 architecture＋术语表＋在册先例（git 提交信息与库内已入库实现）。处置＝复核者当场下结论并把卡改成那个答案，处置格写结论＋`文件:行号` 依据。**禁问用户**：这类问题问出去等于把可查的事推给人决策。
design/engineering/process-conventions.md
+1 -1
View File
@@ -23,7 +23,7 @@
|---|---|---|---|
| 一·登记 | 无（闸管格式） | 待办清单条目 | 条目=标题登记元数据（日期/来源/可选优先级）＋正文四属性（实况/缺口/改动面/状态）；标题登记后不再变，正文随进程演进。格式与状态机权威=doc-conventions 第 12 节 |
| 二·文档设计／美术设计 | doc-design（文档线，兼任反哺点写入）／asset-ingest（美术录入；样张素材由用户主导产出） | GDD 文档或 art-bible／过审样张素材；画面类需求另出预览图（文档线，2026-11-05 用户裁） | 用户提起或从待办清单取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许写入文档；完成判据=待裁点清零，带未裁点的是讨论稿；设计线闭合凭据记入待办清单实况清单（文档线=文档路径+版本号，美术线=art-bible 条款版本）；缺哪条线写在缺口属性，闭合与否写在状态段。画面类需求（新增画面要素／布局／配色／动效等触碰画面呈现规格的改动）设计段先出预览图＝目标画面的 HTML/SVG 效果图（diagram-design 通道，AGENTS.md 图优先的同款载体），经用户人审通过才许进写卡段；预览图内嵌对应 ux/ 规格文档并随附像素级视觉判据句（§7 第 2 条同款写法）；缺陷修复以现行规格与在库基线为准，不触发新预览 |
| 三·写需求卡片 | req-card | 需求卡片 | 设计线闭合后用户发令；新玩法/新系统/新内容必须有设计定稿前置，例外=需求性工程条目（缺陷修复／重构等改游戏行为）凭实况里的证据指认跳过设计线；配套维护类（工程债/测试基建/工具维护，不动游戏行为）＝工程改动直改类，不走本段，由用户发令直改；卡片必经 grilling 多轮复核、零待裁点才成立；复核发现按四类去向处置（2026-11-05 用户立规，定义在 req-card 技能「复核发现四类分流」：自判＝查权威文档或查代码现状有唯一答案，复核者自己下结论改卡；补写＝卡里漏写，回炉补全；待裁＝几种做法都不违规且代价不同、影响玩法取向，才交用户；退回上游＝文档设计线未闭合、美术设计线未闭合、或架构与代码规范本身冲突，停笔退对应段）；成立凭据＝卡内「复核记录」节（2026-11-06 用户裁：不另设复核报告文件），顺序未走完禁对用户称完成、禁落 commit（同 §1 第 2 条卡片复核前置判据）；写完在待办清单状态记「已写卡」，卡片路径记入实况清单（防遗忘）；画面类需求卡片必引设计段已人审的预览图（验收判据的判据出处行锚指向 ux/ 内嵌预览节，test-conventions §8.3 锚口径不变） |
| 三·写需求卡片 | req-card | 需求卡片 | 设计线闭合后用户发令；新玩法/新系统/新内容必须有设计定稿前置，例外=需求性工程条目（缺陷修复／重构等改游戏行为）凭实况里的证据指认跳过设计线；配套维护类（工程债/测试基建/工具维护，不动游戏行为）＝工程改动直改类，不走本段，由用户发令直改；卡片必经 grilling 多轮复核、零待裁点才成立；复核发现按四类去向处置（2026-11-05 用户立规，定义在 req-card 技能「复核发现四类分流」：自判＝查权威文档或查代码现状有唯一答案，复核者自己下结论改卡；补写＝卡里漏写，回炉补全；待裁＝几种做法都不违规且代价不同、影响玩法取向，才交用户；退回上游＝文档设计线未闭合、美术设计线未闭合、或架构与代码规范本身冲突，停笔退对应段）；成立凭据＝卡内「复核记录」节（2026-11-06 用户裁：不另设复核报告文件），顺序未走完禁对用户称完成、禁落 commit（同 §1 第 2 条卡片复核前置判据）；写完在待办清单状态记「已写卡」，卡片路径记入实况清单（防遗忘）；画面类需求卡片必引设计段已人审的预览图（验收判据的判据出处锚指向 ux/ 内嵌预览节，test-conventions §8.3 锚口径不变） |
| 四·迭代编排 | iter-plan | roadmap 迭代行 | **开工前预检（2026-11-07 用户立）**：收令点名拟编卡集后、五查与落表前，对卡集做一轮只读事实面预检——八类检查、P1/P2/P3 分级去向与只读子代理执行方式＝iter-plan 技能「第 3 步·开工前预检」；P1 红项停编排、退回写卡段，禁编入。预检目标＝尽量减少实现期停工、非杜绝——环境漂移与卡片并行修改仍可在实现期停工，由实现段异常分级与 iter T0 开工日窄复核兜底。编排五查：①每卡卡片文件存在 ②每卡设计闭合凭据齐（或需求性工程条目的证据指认）③估时与冻结线——所选卡估时按区间**中值**求和（单位工作日、写精确值不取整）：**卡片任何工作量均可编入**（2026-10-25 用户立：工作量限制属迭代层、非卡片层）；编入后迭代总量 <5 个工作日＝迭代行状态「冻结待凑批」、不可开工，凑批 ≥5 后由编排段改「待开工」（迭代体量偏好，2026-10-21 用户立、2026-10-25 改冻结制）；5–10 个工作日为常规区间；超过 10 个工作日须经用户确认（确认前呈报整批/拆批两案等裁，禁自行拆分或塞入），确认后迭代行随带日期特批标记；超过 20 个工作日禁止编（硬上限，用户确认也不放行，必须拆批）④每卡复核记录在位（2026-11-05 用户立规；2026-11-06 用户裁凭据换代——复核凭据＝「复核记录」节自身，不另查报告文件）——卡内有「复核记录」节；缺节或节内任一条发现没有去向标记则呈报退回写卡段，禁编入，本段不代跑复核也不代补记录（生效＝卡片文件名日期 ≥2026-11-06，旧卡不回头改）⑤写完 roadmap 行后跑流水线闸确认绿；编入未完成迭代，新开迭代行经用户确认 |
| 五·实现 | iter | 代码与配置，可运行的游戏 | 需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令），按 iter 技能与本文 §3 执行；**本段是代码实现批：禁写 `design/` 与根规则文件，产出物只落 `reports/`（见 §3 第 12 条）**；设计权威文档（GDD/art-bible）批内一律不更新；完成人闸=实机目检清单+实现决定记录写齐即完成批内义务；画面类需求实现批另按 test-conventions §8.2 黄金图基线冻结口径执行（实跑截图入基线前用户逐张审核确认＋审核记录落档，此后渲染闸自动盯）；**golden 基线改动批（含非卡片批的迁移/重构/容差修订）merge 前须用户审核通过（test-conventions §8.2 审核关卡），未审核的基线禁合回** |
design/engineering/test-conventions.md
+4 -4
View File
@@ -97,7 +97,7 @@
- **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。接口级断言随单元套件落（`unit/contracts/`），不另设承载目录。
- **跨宿主**：跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩；测试必须实例化真实宿主链，禁止用裸 EffectEngine 代替。断言载体归单元层跨系统闭环套件（§1.1 三元组表），验收入口不变。
- **探针/golden**：玩家可达性与观感；真实实例化场景、驱动真实输入。
- **golden 测试项扩项（2026-11-05 立）**：触碰画面呈现规格的需求批（新增画面要素／布局／配色／动效；判据＝设计段出了预览图），实现段把该画面纳入渲染闸机器面：截图采集清单扩项＋实跑截图冻结进 `game/tests/golden/`（基线属入库测试资产，render_gate.sh 在册例外）。黄金图＝游戏真实渲染截屏冻结的逐像素基准，比对器与容差口径见 render_gate.sh 头注释（脚本即清单，本文不另列）。基线冻结（新建与换代同口径）＝**用户逐张审核确认后执行**，触发原因写进当批提交说明（`tools/golden_baseline_refresh.sh` 现役义务）；此后渲染闸逐像素自动盯、零人工。预览图（HTML/SVG 效果图）与引擎渲染是两套管线，禁直接充当比对基线——预览图只作人审参照与验收判据句的出处（判据出处行锚指向 ux/ 内嵌预览节）；缺陷修复以现行规格与在库基线为准，不触发新预览。
- **golden 测试项扩项（2026-11-05 立）**：触碰画面呈现规格的需求批（新增画面要素／布局／配色／动效；判据＝设计段出了预览图），实现段把该画面纳入渲染闸机器面：截图采集清单扩项＋实跑截图冻结进 `game/tests/golden/`（基线属入库测试资产，render_gate.sh 在册例外）。黄金图＝游戏真实渲染截屏冻结的逐像素基准，比对器与容差口径见 render_gate.sh 头注释（脚本即清单，本文不另列）。基线冻结（新建与换代同口径）＝**用户逐张审核确认后执行**，触发原因写进当批提交说明（`tools/golden_baseline_refresh.sh` 现役义务）；此后渲染闸逐像素自动盯、零人工。预览图（HTML/SVG 效果图）与引擎渲染是两套管线，禁直接充当比对基线——预览图只作人审参照与验收判据句的出处（判据出处锚指向 ux/ 内嵌预览节）；缺陷修复以现行规格与在库基线为准，不触发新预览。
- **golden 基线冻结审核关卡（2026-11-08 用户立）**：基线＝人定标准、机器守标准——**任何基线的新建／换代／迁移／容差修订，呈报用户逐张审核、确认后才能提交入库生效**；该关卡适用于两类批：①画面类需求批（候选基线对照该卡预览图逐张呈报）②**非卡片批的基线操作**（目录重构／平台迁移／容差修订等工程批——同样逐张呈报审核，禁以「纯搬运/纯工程」为由跳过）。确认记录登记于 `game/tests/golden/README.md` 审核记录节（审核人＋时间＋基线清单），**未审核的基线禁合回**。机器侧前置：探针自检 PASS（结构断言在案）才允许出候选图，采集失败不得送审。基线**跨平台单套**（同日用户裁：跨平台渲染必须一致，全平台对拍同一份基线，跨平台字形锯齿噪声由容差带吸收，禁以加基线方式消化差异；细则=golden/README「基线冻结与审核」节）。
分层不是形式。改动发生在哪一层，验收就必须从那一层的真实入口进入。测试绕过了改动点，就不算这个改动的验收——这正是「断言存在、接线坏了却不红」的来源。
@@ -115,9 +115,9 @@
- **反向**：diff 里每个行为改动至少一行；没有对应行的改动，必须写明「非行为改动」或「由第 X 行覆盖」。
- **测试侧**：新增或改写的每条断言至少挂一行；挂不上的孤儿断言删掉或补挂到需求点。
**判据出处行锚（2026-11-05 立，自 2026-11-05 起对文件名日期不早于该日的需求卡片生效；旧卡不回头改，被编入迭代开工前由写卡段按本粒度补挂）**：对照表「需求点」列每行必须带**判据出处行锚**——该行验收判据所依据的现行文档句子，格式「`<文档相对路径>:<行号>`」。现行文档＝`design/` 全域现行文档（含 `ux/` 交互规格与 art-bible 的判据行）；已退役的需求卡片不是现行文档，不得充当判据出处。作用＝断言预期值从规格句抄出，不从实现反推：实现行为与规格句冲突时断言红；规格缺席的行写不出锚，即停卡退回写卡段（那是需求澄清缺口，不是测试缺口）。机检＝`tools/pipeline_gate.py` 判据 C5（锚格式与指向存在性，按卡文件名日期分流）＋`tools/capability_audit.py` 链式锚检查（断言→套件→能力行→系统文档，见 §8.9）。
**判据出处锚（2026-11-05 立；2026-11-09 用户裁内容化改版——行号形态废止，内容节锚为唯一形态）**：对照表「需求点」列每行必须带**判据出处锚**——该行验收判据所依据的现行文档句子，格式「`<文档相对路径>「节名」<行关键词>`」。现行文档＝`design/` 全域现行文档（含 `ux/` 交互规格与 art-bible 的判据行）；已退役的需求卡片不是现行文档，不得充当判据出处。节名＝判据句所在节的标题词（节名首段「·」前须命中目标文档标题行）；行关键词＝判据句上的无空白子串（须落在该节块内）。锚指向内容不指向行号——文档增删行不牵动锚与测试代码，只有判据句内容真被改动才使锚失配；失配（节名不在档／关键词不命中）＝红，改动该句的文档批同批改锚。作用＝断言预期值从规格句抄出，不从实现反推：实现行为与规格句冲突时断言红；规格缺席的行写不出锚，即停卡退回写卡段（那是需求澄清缺口，不是测试缺口）。机检＝`tools/pipeline_gate.py` 判据 C5（内容锚形态唯一＋节名在档＋关键词命中节内，核验口径归 `tools/anchor_util.py` 共用件；行号形态出现即红）＋`tools/capability_audit.py` 链式锚检查（断言→套件→能力行→系统文档，见 §8.9）。
**测试函数的判据出处注记（2026-11-06 立）**：`game/tests/**` 与 `game/probe/**` 内每个**验证函数**（函数体含 `check(`／`check_quiet(`／`_problems.append(`／`push_error(` 判定调用的函数——定义行与 `_check(` 前缀不作判定计）必须带至少一条**判据出处注记**，格式「`# 判据出处: <design/相对路径>:<行号> <判据一句>`」——指针在前、判据摘要句在后；锚形态两档：行号锚（默认）与节锚（`<design/相对路径>「节名」<行关键词>`）——所指文档整节重排时同批把行号锚重锚为节锚，免行号漂移（2026-11-07 架构收窄批立），断言预期值的出处随断言走：断言红时读注记即达出处文档句，零查表。指针空间＝`design/` 全域现行文档（行为测试锚 owner 系统文档「验收标准」句或 `ux/` 规格句；惯例类测试〔封装扫描、判定通道纪律、驱动契约〕锚规约条款行；测量面驱动契约锚 `game/sim/` 实现件文件头注——规范句在哪锚哪，2026-11-09 架构收敛批立）；`game/sim/` 不进扫描面（测量面直构惯例）。与链式锚的分工：链式锚（断言→套件→能力行→系统文档）不变、属义务清单层；本注记属执行证据层、写在断言文件内，非独立账本（§8.9 法则 4 不变）。写新测试函数时当场挂注记；被指规格句改行号时随批维护指针——死指针即红。局限如实声明：注记是被动文本，句内容改而行数不变时机检抓不到（与卡片判据 C5 同限）。机检＝`tools/capability_audit.py` 判据出处注记道（覆盖检查＋指针存在性；扫描面零文件自检红）。规格缺席写不出锚＝发现规格缺口：记发现不造锚、收尾呈报，禁锚到非现行文档凑数。
**测试函数的判据出处注记（2026-11-06 立；2026-11-09 内容化改版——内容节锚唯一形态）**：`game/tests/**` 与 `game/probe/**` 内每个**验证函数**（函数体含 `check(`／`check_quiet(`／`_problems.append(`／`push_error(` 判定调用的函数——定义行与 `_check(` 前缀不作判定计）必须带至少一条**判据出处注记**，格式「`# 判据出处: <design/相对路径>「节名」<行关键词> <判据一句>`」——指针在前、判据摘要句在后；节名与行关键词口径同上（卡片判据锚同款，`game/sim/` 测量面实现件无标题结构，节名与关键词按文件内子串命中），断言预期值的出处随断言走：断言红时读注记即达出处文档句，零查表。指针空间＝`design/` 全域现行文档（行为测试锚 owner 系统文档「验收标准」句或 `ux/` 规格句；惯例类测试〔封装扫描、判定通道纪律、驱动契约〕锚规约条款行；测量面驱动契约锚 `game/sim/` 实现件文件头注——规范句在哪锚哪，2026-11-09 架构收敛批立）；`game/sim/` 不进扫描面（测量面直构惯例）。与链式锚的分工：链式锚（断言→套件→能力行→系统文档）不变、属义务清单层；本注记属执行证据层、写在断言文件内，非独立账本（§8.9 法则 4 不变）。写新测试函数时当场挂注记；判据句被改动使关键词失配时，改动该句的文档批同批改锚——失配即红。局限如实声明：注记核验到「关键词命中节内」粒度，判据句被改写而关键词仍为其子串时语义漂移机检抓不到，由复核门实读兜（与卡片判据 C5 同限）。机检＝`tools/capability_audit.py` 判据出处注记道（覆盖检查＋内容锚核验，行号形态出现即红；扫描面零文件自检红）。规格缺席写不出锚＝发现规格缺口：记发现不造锚、收尾呈报，禁锚到非现行文档凑数。
**验收档申报（2026-11-04 立，自 2026-11-05 起对文件名日期不早于该日的需求卡片生效；旧卡不回头改）**：每张需求卡片在头部信息区（与设计事实源声明同区）申报一个验收档，三档：高／中／低。判据＝失败代价单维——这条改动做错了，后果随存档或结算传播的（存档写读与迁移、RNG 流、战斗结算公式与乘区、经济入账、数值表结构校验）＝高；后果玩家可见但不损持久状态的（常规玩法逻辑、门控、交互逻辑、呈现数据面）＝中；后果即看即知且无状态残留的（文案、纯呈现样式、布局微调）＝低。一张卡触多档按最高档申报；申报由写卡段落笔，用户批卡（U0）时确认或改判。档位只调节 §8.7 审计深度——闸机与 CI 的域划分、选闸算法、全量强制档一概不因档位变化，真实入口、判据绑定面、禁削弱等验收闭合判据全部照旧。未申报档位的卡一律按高档全量审计。机检＝`tools/pipeline_gate.py` 判据 C4：卡内须含「验收档：高／中／低」申报行。
@@ -153,7 +153,7 @@
2. 抽查判据绑定面：断言从真实入口进入、钉在被测改动的特有可观测提交面上，且当轮真实跑批执行过；
3. 检查测试削弱：删除断言、放宽阈值、缩小扫描面、换下层直调，逐处要卡片申报或用户批准。
4. 核对内部字段直查的受控例外：直查行是否已在对照表注明理由（该行为无公开可观测面可钉）。
5. 核对判据出处：抽查断言的预期值能否从其判据出处行锚（§8.3）的规格句独立写出——预期值只在实现里有的（同义反复，判据镜像实现），判红。
5. 核对判据出处：抽查断言的预期值能否从其判据出处锚（§8.3）的规格句独立写出——预期值只在实现里有的（同义反复，判据镜像实现），判红。
**审计深度分级（2026-11-04 立）**：审计按卡内申报的验收档（§8.3）逐卡定深度；梯度只落在昂贵的判断件上，机械且堵造假向量的两件（削弱检查、例外核对）三档全保留不抽。中/低档省略的测试复跑以远端 CI 读数为执行证据——`tools/ci_check.sh <合并提交>` 的现查输出（commit＋run 号＋conclusion）是机器产物，run 号在远端永久可复核，审计报告照抄该行即可；照抄前先核对读数必须是「绿」——「未验」（零触发批跑闸步全跳过）与「不可判」不作证据，那种批的回补办法是等一次含代码面的合回或用户自发全量回归（2026-11-04 用户裁：回执等待件退役，证据由落盘文件改为现查读数；「不采信实现者自述已全绿」的口径不变）：
game/probe/board_shot_probe.gd
+3 -3
View File
@@ -93,7 +93,7 @@ func _mark_domain_counts(view: Node, tag: String) -> Dictionary:
func _ready() -> void:
# 判据出处: design/engineering/test-conventions.md:84 （棋盘截图取证——渲染闸采集组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（棋盘截图取证——渲染闸采集组）
# 运行前提=窗口化真渲染面（shot_probe 同款护栏——headless 下 frame_post_draw 永不触发+视口纹理恒空）
if DisplayServer.get_name() == "headless":
print("[board_shot] FAIL — 本探针必须窗口化运行（headless 无渲染面，截图必空）；现行事实源=tools/render_gate.sh 取证段")
@@ -259,7 +259,7 @@ func _ready() -> void:
# 判据：环外径像素 ÷ 格边 落 0.82±1px；封印格最外圈 1px 框最暗值与相邻未封印未开格同位框最暗值差 ≤1/255
#（halo 在 0.455×格边归零——格边框不应被压暗；相邻未开格同砖纹理同套瓦片为无封印参照）。
func _seal_evidence(tag: String, view: Node, settlement: Object, off_img: Image, out: String) -> void:
# 判据出处: design/engineering/test-conventions.md:84 （封印印记像素取证组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（封印印记像素取证组）
var ms = settlement.minesweeper
var seal_cell := Vector2i(-9, -9)
var ref_cell := Vector2i(-9, -9)
@@ -367,7 +367,7 @@ func _probe_identity_lookup(c: Vector2i):
# 双帧逐像素比对：所有变化像素必须落在生效格的内缘带内
# （de < cell÷8——带外含砖心零侵入＝禁整格染色／禁越圈）；每个生效格须有实绘像素（不空转）。
func _check_dual_frames(tag: String, view, glow_cells: Dictionary, off_img: Image, on_img: Image) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var board = view.board()
if board == null:
_problems.append("%s 双帧比对取板失败（view.board() 为 null）" % tag)
game/probe/fx_probe.gd
+1 -1
View File
@@ -8,7 +8,7 @@ extends Node
func _ready() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗表现.md:148 （结算演出——挖掘期零打扰组）
# 判据出处: design/gdd/systems/战斗循环/战斗表现.md「验收标准」挖掘期零打扰 （结算演出——挖掘期零打扰组）
await get_tree().process_frame
var problems: Array = []
game/probe/fx_shot_probe.gd
+3 -3
View File
@@ -21,7 +21,7 @@ var _problems: Array = []
func _ready() -> void:
# 判据出处: design/engineering/test-conventions.md:84 （特效截图取证——渲染闸采集组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（特效截图取证——渲染闸采集组）
var args := OS.get_cmdline_user_args()
out_dir = args[0] if args.size() >= 1 and args[0] != "" else "user://qa-fx"
DirAccess.make_dir_recursive_absolute(out_dir)
@@ -108,7 +108,7 @@ func _ready() -> void:
func _snap(tag: String) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
await RenderingServer.frame_post_draw
var img: Image = get_viewport().get_texture().get_image()
if img == null or img.is_empty():
@@ -118,7 +118,7 @@ func _snap(tag: String) -> void:
func _fail(msg: String) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_problems.append(msg)
push_error("[fx_shot_probe] FAIL — " + msg)
get_tree().quit(1)
game/probe/layout_probe.gd
+2 -2
View File
@@ -19,7 +19,7 @@ var _est_reads: Dictionary = {} # 逐档 13/14 板推定读数留痕（label
func _ready() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:264 （战斗屏三区几何与棋盘格边长——分辨率档位组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（战斗屏三区几何与棋盘格边长——分辨率档位组）
await get_tree().process_frame
var main: Node = load("res://presentation/main.tscn").instantiate()
add_child(main)
@@ -59,7 +59,7 @@ func _ready() -> void:
# 一份不变量断言，逐档代入——代码量与档数无关
func _check_one(label: String, main: Node) -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:264 （单档几何断言组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（单档几何断言组）
var vr: Rect2 = get_viewport().get_visible_rect()
if vr.size != Vector2(VIEWPORTS[0]["size"]) and vr.size.y < 1.0:
_problems.append("[%s] 逻辑视口退化 %s" % [label, vr.size])
game/probe/level_map_shot_probe.gd
+3 -3
View File
@@ -11,7 +11,7 @@ extends Node
const SEED_L3 := 910212 # 深图固定种子（与 level_map_viewport_probe 同源——图确定性承载）
func _ready() -> void:
# 判据出处: design/engineering/test-conventions.md:84 （关卡画面截图取证——载入守卫组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（关卡画面截图取证——载入守卫组）
var args := OS.get_cmdline_user_args()
var out_dir := args[0] if args.size() > 0 else "user://"
await get_tree().process_frame
@@ -45,7 +45,7 @@ func _settle() -> void:
func _make_runner(entry: bool, node_id: int):
# 判据出处: design/engineering/test-conventions.md:84 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（判定上报通道——验证函数组）
var rng = load("res://core/rng_service.gd").new()
rng.new_adventure(SEED_L3)
var runner = load("res://core/level_runner.gd").new(get_node("/root/ConfigDB"), rng)
@@ -85,7 +85,7 @@ func _deepest_with_outs(screen, runner) -> int:
func _shot(out_dir: String, fname: String) -> void:
# 判据出处: design/engineering/test-conventions.md:84 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（判定上报通道——验证函数组）
DirAccess.make_dir_recursive_absolute(out_dir) # 落盘目录自建（save_png 对缺目录静默失败——刷新链不预建）
var img := get_viewport().get_texture().get_image()
var err := img.save_png(out_dir.path_join(fname))
game/probe/level_map_viewport_probe.gd
+11 -11
View File
@@ -22,14 +22,14 @@ var _runner # 当前停点的单关 runner（open_choices 驱动随记——
func _check(desc: String, ok: bool) -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
_checks += 1
if not ok:
_problems.append(desc)
func _ready() -> void:
# 判据出处: design/ux/level-map.md:3 （关卡画面视口跟随——卷轴视口组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（关卡画面视口跟随——卷轴视口组）
await get_tree().process_frame
await get_tree().process_frame
var host := Control.new()
@@ -62,7 +62,7 @@ func _ready() -> void:
## R1 浅图整幅居中无裁切＋画布入视口件承载（画布=视口首子件——setup 注入序）
func _probe_shallow_no_crop(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （浅层不裁切组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（浅层不裁切组）
_runner = _make_runner_entry(1, SEED_L1)
screen.open_choices(_cand_nodes(_runner), _runner)
await get_tree().process_frame
@@ -81,7 +81,7 @@ func _probe_shallow_no_crop(screen, vp) -> void:
## R5 前置＋深图入口停点：锚点=入口组包围盒中心夹紧（spec :101——多入口并列取包围盒居中）
func _probe_deep_entry_clamp(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （深层入口钳制组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（深层入口钳制组）
_runner = _make_runner_entry(3, SEED_L3)
screen.open_choices(_cand_nodes(_runner), _runner)
await get_tree().process_frame
@@ -175,7 +175,7 @@ func _probe_clamp_bounds_and_columns(screen, vp) -> void:
## R6 拖拽不触发选路提交；阈值另一侧完整点击仍提交（提交语义零改动）
func _probe_drag_no_submit(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
# 重建到中段可居中停点（候选=停点出边——候选节点居屏中可拖可达）
var stops := _centerable_stops(screen, vp)
if stops.size() < 3:
@@ -214,7 +214,7 @@ func _probe_drag_no_submit(screen, vp) -> void:
## R2 停点切换后当前节点居中（视口中线投影 x=640±2——视口满屏宽即屏中线）
func _probe_follow_anchor(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
var stops := _centerable_stops(screen, vp)
if stops.size() < 3:
_problems.append("R2 可居中停点不足（=%d）" % stops.size())
@@ -230,7 +230,7 @@ func _probe_follow_anchor(screen, vp) -> void:
## R7 平滑滚动有 tween 中间帧；减动效开＝位置即达（画布坐标域判定）
func _probe_smooth_scroll_reduced_motion(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
var saved_scale: float = UiKit.motion_scale
UiKit.motion_scale = 1.0
var stops := _centerable_stops(screen, vp)
@@ -270,7 +270,7 @@ func _probe_smooth_scroll_reduced_motion(screen, vp) -> void:
## R8 指引件可见性与几何（深图超窗——像素级判据②③）
func _probe_guidance_chrome(screen, vp) -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
var band_l: Control = vp.get_node_or_null(NodePath("FadeL"))
var band_r: Control = vp.get_node_or_null(NodePath("FadeR"))
var chip: Control = vp.get_node_or_null(NodePath("PanHint"))
@@ -302,7 +302,7 @@ func _probe_shallow_guidance_hidden(screen, vp) -> void:
## 入口停点 runner（defer_entry——选路态挂起、候选=入口节点）
func _make_runner_entry(level_index: int, seed_val: int):
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
var rng = load("res://core/rng_service.gd").new()
rng.new_adventure(seed_val)
var runner = load("res://core/level_runner.gd").new(get_node("/root/ConfigDB"), rng)
@@ -313,7 +313,7 @@ func _make_runner_entry(level_index: int, seed_val: int):
## 中段停点 runner（断点续玩重建——图由种子+参数档重生成同图，零 RNG 消耗）
func _make_runner_at_stop(level_index: int, seed_val: int, node_id: int):
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
var rng = load("res://core/rng_service.gd").new()
rng.new_adventure(seed_val)
var runner = load("res://core/level_runner.gd").new(get_node("/root/ConfigDB"), rng)
@@ -388,7 +388,7 @@ func _extreme_node(pos: Dictionary, nodes: Array, first: bool) -> Dictionary:
func _finish() -> void:
# 判据出处: design/ux/level-map.md:3 （判定上报通道——验证函数组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（判定上报通道——验证函数组）
if _checks == 0:
_problems.append("零断言执行（断言数下限闸——三硬闸③）")
if _problems.is_empty():
game/probe/probe_coverage_recorder.gd
+1 -1
View File
@@ -234,7 +234,7 @@ func _seen_into(node: Node, keys: Array[String]) -> void:
# ---- 落盘（JSONP 式 .js——file:// 页面 <script src> 直载）----
func dump_js() -> void:
# 判据出处: design/engineering/test-conventions.md:30 （覆盖登记落盘守卫——判定上报通道组）
# 判据出处: design/engineering/test-conventions.md「2. 场景级探针标配」每新增一个可交互 每新增一个可交互（覆盖登记落盘守卫——判定上报通道组）
var dir := DirAccess.open("res://")
if dir == null:
push_error("[coverage] res:// 打不开，登记未落盘")
game/probe/screen_flow_probe.gd
+13 -13
View File
@@ -76,14 +76,14 @@ func _seals_text(f: Dictionary) -> String:
# ---- 流程状态位（与可见性是两回事，逐步单独判）----
func _expect_adventure_seal(step: String, expect: bool) -> void:
# 判据出处: design/engineering/architecture/architecture.md「呈现层装配与会话生命周期」 （状态位判据组）
# 判据出处: design/engineering/architecture/architecture.md「呈现层装配与会话生命周期」呈现场景拆为三屏壳 呈现场景拆为三屏壳（状态位判据组）
var got: bool = main.run_scope != null and main.run_scope.is_adventure
if got != expect:
_problems.append("%s：流程状态位 is_adventure 应为 %s，实测 %s" % [step, str(expect), str(got)])
func _expect_exclusive(step: String, expect: String) -> void:
# 判据出处: design/engineering/architecture/architecture.md「呈现层装配与会话生命周期」 （屏级互斥组）
# 判据出处: design/engineering/architecture/architecture.md「呈现层装配与会话生命周期」呈现场景拆为三屏壳 呈现场景拆为三屏壳（屏级互斥组）
var f: Dictionary = _screen_seals()
var pairs := [["菜单", "营地"], ["菜单", "冒险"], ["营地", "冒险"], ["终局", "营地"], ["终局", "菜单"]]
for pair in pairs:
@@ -110,7 +110,7 @@ func _frames(n: int = 2) -> void:
# ---- ① boot：菜单独占 ----
func _step_boot_menu() -> void:
# 判据出处: design/engineering/test-conventions.md:49 （boot 组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（boot 组）
_expect_exclusive("①boot", "菜单")
_expect_adventure_seal("①boot", false)
if main.ui.modals.menu.debug_overlay != null and main.ui.modals.menu.debug_overlay.visible:
@@ -119,7 +119,7 @@ func _step_boot_menu() -> void:
# ---- ② 菜单 → 营地（真实按钮信号路径）----
func _step_menu_to_camp() -> void:
# 判据出处: design/ux/camp.md:10 （菜单→营地组）
# 判据出处: design/ux/camp.md「定位」存档内的局外枢纽 存档内的局外枢纽（菜单→营地组）
# 营地经进档开层（卡② mn9 新路径——campbtn 已撤；槽模板注入隔离命名空间）
if not await ProbeUiUtil.open_camp_via_savesel(main, "smoke_screen_flow_camp"):
_problems.append("②菜单→营地：选档层新档钮缺失（新路径驱动中断）")
@@ -130,7 +130,7 @@ func _step_menu_to_camp() -> void:
# ---- ③ 营地 → 菜单（回退路径：篝火二次确认动线——卡④ 营地唯一回菜单出口；选档层随关层收闭同收）----
func _step_camp_back_to_menu() -> void:
# 判据出处: design/ux/camp.md:22 （营地→菜单组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（营地→菜单组）
if main.ui.modals.camp.scene == null:
_problems.append("③营地→菜单：营地场景根句柄缺失〔句柄子容器批 V1〕")
return
@@ -147,7 +147,7 @@ func _step_camp_back_to_menu() -> void:
# ---- 选档界面开合（卡③ sl10）：函数直调开层（「进入存档」钮归卡② mn3）→屏级互斥采样→
# 返回钮真实信号路径关闭→ESC 语境不响应（卡⑤ 契约 2 范围外——零实现即断言）。----
func _step_save_select_open_back() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （选档开合组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（选档开合组）
ProbeUiUtil.isolate_save(main, "smoke_screen_flow_savesel", false, false, true)
main.save_manager.slots.attach_slot_template("user://smoke_screen_flow_savesel_slot_%d.json")
var esb: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "进入存档", "prefix")
@@ -194,7 +194,7 @@ func seals_check_single(f: Dictionary) -> bool:
func _step_menu_to_adventure() -> void:
# 判据出处: design/ux/level-map.md:11 （菜单→冒险组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（菜单→冒险组）
# 开始冒险钮已随三入口化撤出——函数直调中间态（卡② mn10；卡④ 大门两分支换代）
main._start_adventure_from_menu()
await _frames(3)
@@ -208,7 +208,7 @@ func _step_menu_to_adventure() -> void:
# ---- ⑤ 冒险内屏切换：关卡地图屏 ⇄ 战斗屏（屏内两态，屏级仍独占）----
func _step_level_to_battle_and_back() -> void:
# 判据出处: design/ux/battle.md:57 （冒险内切换组）
# 判据出处: design/ux/battle.md「Entry & Exit Points」Entry Entry（冒险内切换组）
if not main.ui.modals.run.level_screen.visible:
_problems.append("⑤冒险内切换：前置不在关卡地图屏")
return
@@ -228,7 +228,7 @@ func _step_level_to_battle_and_back() -> void:
# ---- ⑥ 放弃 → 终局（放弃路径＝回退路径的非正常出口）----
func _step_abandon_to_end() -> void:
# 判据出处: design/ux/level-map.md:42 （放弃→终局组）
# 判据出处: design/ux/level-map.md「Navigation Position」放弃冒险 （放弃→终局组）
if main.run_scope == null or main.run_scope.adventure == null:
_problems.append("⑥放弃→终局：前置无冒险实例")
return
@@ -241,7 +241,7 @@ func _step_abandon_to_end() -> void:
# ---- ⑦ 终局 → 菜单（终局出口返回开始界面）----
func _step_end_back_to_menu() -> void:
# 判据出处: design/ux/settlement-summary.md:24 （终局→菜单组）
# 判据出处: design/ux/settlement-summary.md「定位」承载两个 承载两个（终局→菜单组）
if main.ui.modals.run.end_overlay == null or not main.ui.modals.run.end_overlay.visible:
_problems.append("⑦终局→菜单：前置不在终局")
return
@@ -254,7 +254,7 @@ func _step_end_back_to_menu() -> void:
# ---- ③' 营地 Esc 浮窗＋HUD（卡⑤——真实键盘合成路径 push_input；四态路由＋三出口＋语境分支＋余额单口）----
func _step_camp_esc_and_hud() -> void:
# 判据出处: design/ux/camp.md:45 （Esc 段组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（Esc 段组）
ProbeUiUtil.isolate_save(main, "smoke_screen_flow_esc", false, false, true)
if not await ProbeUiUtil.open_camp_via_savesel(main, "smoke_screen_flow_esc"):
_problems.append("[esc] 营地入口缺失（选档层新档钮驱动中断）〔ESC批 V1〕")
@@ -320,7 +320,7 @@ func _step_camp_esc_and_hud() -> void:
# 判的是呈现形态换壳（近全屏面板→居中定尺寸窗壳 720×640）：窗几何/场景根留底/遮罩 0.6/关闭钮/
# 互斥单开/ESC 优先序/窗内滚动/生涯同壳——行为面（开合路由）零改，只钉窗壳可观测提交面。
func _step_camp_window_shell() -> void:
# 判据出处: design/ux/camp.md:45 （窗壳 V1–V8 组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（窗壳 V1–V8 组）
ProbeUiUtil.isolate_save(main, "smoke_screen_flow_winshell", false, false, true)
if not await ProbeUiUtil.open_camp_via_savesel(main, "smoke_screen_flow_winshell"):
_problems.append("[winshell] 营地入口缺失（选档层新档钮驱动中断）〔窗口化批 V1〕")
@@ -478,7 +478,7 @@ func _step_camp_window_shell() -> void:
# 清窗经真实钮（逐窗巡检 visible→钮 pressed——栈 close 恢复账随层清空）
func _close_all_windows(views: Dictionary) -> void:
# 判据出处: design/ux/camp.md:45 （清窗组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（清窗组）
for k: StringName in [&"forge", &"chest", &"dummy", &"board"]:
var w: Control = views[k]
if not w.visible:
game/probe/shot_probe.gd
+16 -16
View File
@@ -47,7 +47,7 @@ func _ready() -> void:
await get_tree().process_frame
# ① 菜单（启动态）——无帮助文腿（玩法速览牌不在画面，checker 无对应断言段）；
# 无副标题件，菜单文字锚只剩标题
# 判据出处: design/engineering/code-conventions.md:54 模态覆盖层层级规则——boot 态顶层=start_overlay、菜单文字在屏（菜单组）
# 判据出处: design/engineering/code-conventions.md「2.3 模态覆盖层层级规则」打开任何模态覆盖层时 打开任何模态覆盖层时、菜单文字在屏（菜单组）
# 自检一：boot 态顶层可见全屏层=start_overlay（内容层树遍历——屏壳是容器不当候选：
# camp 壳 boot 态 vis=true 但成员恒隐，裸树遍历自顶向下会先命中透明壳）
var top: Node = null
@@ -84,7 +84,7 @@ func _ready() -> void:
_meta[String(pair[0])] = ProbeUiUtil.label_rect(main.ui.screens.start_overlay, String(pair[1]))
await _snap("menu")
# ①b 设置面（settingsbtn 真实信号路径，开合同款真实钮）
# 判据出处: design/gdd/systems/表现与支撑/设置与本地化.md:95 最小设置面已兑现：音量/减动效/全屏/退出，载体＝独立设置存储＋设置界面视图（设置组）
# 判据出处: design/gdd/systems/表现与支撑/设置与本地化.md「P1 / P2 后置」独立设置存储 独立设置存储，载体＝独立设置存储＋设置界面视图（设置组）
var setbtn: Button = ProbeUiUtil.find_button(main.ui.screens.start_overlay, "设置", "prefix")
if setbtn == null:
_problems.append("设置入口缺失（开始层 settingsbtn）")
@@ -104,7 +104,7 @@ func _ready() -> void:
ProbeUiUtil.push_click(main, set_close)
await get_tree().process_frame
# ①c 生涯页（函数直调中间态——卡② mn10：careerbtn 已撤，卡④ 笔记本改挂前无 UI 路径）
# 判据出处: design/ux/camp.md:45 生涯页与四子界面同壳同形态（生涯组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（生涯组）
if true:
main._open_career()
for i in 3:
@@ -124,14 +124,14 @@ func _ready() -> void:
if main.ui.modals.menu.career_overlay.visible or not main.ui.screens.start_overlay.visible:
_problems.append("生涯页关闭后页未隐藏或开始层未恢复")
# ② 营地场景图（进档开层新路径——卡② mn9；截图=可点击场景图形态——卡④ 契约 9 V1 验收载体）
# 判据出处: design/ux/camp.md:16 营地＝可点击场景图（七物件命中区表——场景图形态组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（七物件命中区表——场景图形态组）
if not await ProbeUiUtil.open_camp_via_savesel(main, "smoke_shot_probe_camp"):
_problems.append("营地入口缺失（选档层新档钮——新路径驱动中断）〔句柄子容器批 V1〕")
else:
await get_tree().process_frame
await _snap("camp")
# ②b 营地五窗打开态（真点热点开窗→截→「返回」前缀真点关——screen_flow_probe 窗壳链同款）
# 判据出处: design/ux/camp.md:45 五窗统一窗壳形态·互斥单开（营地窗态组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（营地窗态组）
for k: StringName in [&"forge", &"chest", &"dummy", &"board", &"notebook"]:
ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(k).get_center())
for i in 3:
@@ -157,16 +157,16 @@ func _ready() -> void:
ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"campfire").get_center()) # 收闭改接篝火动线（营地根态无关闭钮——卡④ T5）
await get_tree().process_frame
ProbeUiUtil.push_click(main, main.ui.modals.menu.confirm_dialog._confirm_btn) # 二次确认离场（关层收闭——选档层随收）
# 判据出处: design/ux/camp.md:22 篝火＝离开营地回主菜单、必须二次确认（篝心动线组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」必须二次确认 必须二次确认、必须二次确认（篝心动线组）
await get_tree().process_frame
# ③ 关卡画面（开始冒险→停点出图——入口停点语义；函数直调中间态 mn10）
# 判据出处: design/ux/level-map.md:11 入口停点候选数＝入口个数（关卡画面出图组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（关卡画面出图组）
main._start_adventure_from_menu()
for i in 4:
await get_tree().process_frame
await _snap("level")
# GP 常驻徽章断言（读数=runner.gp 现值，刷新=写路径回执后重查〔open_choices〕）
# 判据出处: design/ux/level-map.md:77 GP 常驻徽章＝GP 图标+数字（冒险钱包读数；写路径回执后重查）
# 判据出处: design/ux/level-map.md「Component Inventory」冒险钱包读数 冒险钱包读数（冒险钱包读数；写路径回执后重查）
var gp_label: Label = ProbeUiUtil.find_label(main.ui.modals.run.level_screen, "◈ ")
if gp_label == null or not gp_label.is_visible_in_tree():
_problems.append("GP 徽章不可见（关卡画面顶栏）")
@@ -175,7 +175,7 @@ func _ready() -> void:
if gp_label.text != expect:
_problems.append("GP 徽章读数不符: %s != %s" % [gp_label.text, expect])
# ④ 战斗（节点一——candidate_rect 命中矩形真点选路提交，ui_click_probe 同款）
# 判据出处: design/ux/battle.md:122 B 区构建：站桩/明细带/轮次指示（战斗出图与几何锚组）
# 判据出处: design/ux/battle.md「Layout Zones」采用用户拍板的布局图 采用用户拍板的布局图（战斗出图与几何锚组）
if main.ui.modals.run.level_screen != null and main.ui.modals.run.level_screen.visible:
# 接触带呼吸相位冻结（board_shot_probe 同款：motion_scale<1.0 ⇒ 施静态带色）——
# golden 基线逐像素比对禁动画相位抖动；必须在进战 rebuild 前置位（rebuild/带色施用按当时相位取样）
@@ -192,14 +192,14 @@ func _ready() -> void:
_meta["stage_view"] = _node_rect(main.ui.battle.stage)
_meta["board_zone"] = _node_rect(main.ui.battle.board_zone)
# draw calls 真机测量（基线 270→目标 <200；窗口化渲染帧读数，
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:264 同屏 draw calls < 200（战斗屏性能预算组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（战斗屏性能预算组）
# 取值时机=战斗截图同帧后一帧——呈现终态满负荷）
await get_tree().process_frame
var dc := int(Performance.get_monitor(Performance.RENDER_TOTAL_DRAW_CALLS_IN_FRAME))
_meta["battle_draw_calls"] = dc
print("[shot_probe] battle draw_calls=%d（基线 270/目标 <200）" % dc)
# ⑤ 状态面板（战斗屏状态角标真实信号路径；层在战斗屏之上开合）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:277 模态打开遮挡或输入锁定、关闭逐层恢复（状态面板组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」关闭逐层恢复 关闭逐层恢复、关闭逐层恢复（状态面板组）
var pb: Button = main.ui.battle.board_zone.status_badge
if pb == null or not pb.visible or pb.disabled:
_problems.append("状态面板入口角标缺失/置灰（战斗屏 board_zone）")
@@ -221,7 +221,7 @@ func _ready() -> void:
if main.ui.modals.run.status_panel.visible:
_problems.append("状态面板关闭后未隐藏（继续钮路径）")
# ⑤b 图例浮窗（战斗屏 AP 条真点开→截→close() 关——ui_click_probe 真点先例）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:88 图例面板＝模态族（图例组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（图例组）
var lgb: Button = main.ui.battle.board_zone.ap_bar._btn_legend
if lgb == null or not lgb.visible:
_problems.append("图例钮缺失/不可见（战斗屏 AP 条）")
@@ -237,7 +237,7 @@ func _ready() -> void:
for i in 3:
await get_tree().process_frame
# ⑤c 战末结算浮层（直调 open_victory 喂真实形态摘要——ui_struct_probe 合成先例）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:276 终局：胜利金蜡封（战末结算组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（战末结算组）
main.ui.modals.run.end_overlay.open_victory("胜利", "继续", Rect2(200, 200, 400, 300),
{"gp_summary": "GP +3", "ks_summary": "击杀 2", "bonus_summary": "无伤奖励", "gp_gain": 3, "gp_total": 3})
for i in 3:
@@ -250,7 +250,7 @@ func _ready() -> void:
for i in 3:
await get_tree().process_frame
# ⑤d 三选一浮层（直调 open_pick 喂真实形态卡——ui_struct_probe 合成先例）
# 判据出处: design/gdd/systems/冒险循环/奇物.md:166 三选一呈现（三选一组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（三选一组）
main.ui.modals.run.curio_overlay.open_pick("三选一", [
{"id": "probe_heal", "text": "回血\n恢复 3 点"},
{"id": "probe_magic", "text": "爆裂轰击\n下一击 +5"},
@@ -266,7 +266,7 @@ func _ready() -> void:
for i in 3:
await get_tree().process_frame
# ⑤e 调试浮窗（函数直调开/关——ui_struct_probe/ui_tune_probe 先例；对局中可开）
# 判据出处: design/engineering/test-conventions.md:65 人工体验=DebugOverlay/DS_DEBUG 调试面（调试浮窗组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（调试浮窗组）
main._show_debug_overlay()
for i in 3:
await get_tree().process_frame
@@ -300,7 +300,7 @@ func _ready() -> void:
func _snap(key: String) -> void:
# 判据出处: design/engineering/test-conventions.md:84 golden 测试项扩项——截图采集清单扩项、实跑截图冻结（截图采集组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩、实跑截图冻结（截图采集组）
await RenderingServer.frame_post_draw
await RenderingServer.frame_post_draw
var img: Image = get_viewport().get_texture().get_image()
game/probe/t17_defer_probe.gd
+1 -1
View File
@@ -13,7 +13,7 @@ var _problems: Array = []
func _ready() -> void:
# 判据出处: design/ux/battle.md:122 （明细带挖掘期收起——T17 视觉扩展时序组）
# 判据出处: design/ux/battle.md「Purpose & Player Need」战斗屏是 战斗屏是（明细带挖掘期收起——T17 视觉扩展时序组）
await get_tree().process_frame
main = load("res://presentation/main.tscn").instantiate()
add_child(main)
game/probe/type_glow_shot_probe.gd
+1 -1
View File
@@ -30,7 +30,7 @@ var _hero_pos := Vector2i.ZERO
func _ready() -> void:
# 判据出处: design/engineering/test-conventions.md:84 （微光截图取证——渲染闸采集组）
# 判据出处: design/engineering/test-conventions.md「7. 判定可靠性优先于覆盖率」跑一遍没崩 跑一遍没崩（微光截图取证——渲染闸采集组）
if DisplayServer.get_name() == "headless":
print("[type_glow_shot] FAIL — 本探针必须窗口化运行（headless 无渲染面，截图必空）")
get_tree().quit(1)
game/probe/ui_click_probe.gd
+26 -26
View File
@@ -64,7 +64,7 @@ func _ready() -> void:
if main.ui.modals.menu.debug_overlay.visible:
_problems.append("调试浮窗 boot 自动开（菜单优先失守）")
# ---- 营地购买合成点击路径（选档进档开层→购买→关闭全走真实按钮信号路径；
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:198 （营地购买段——单币购买只扣钥石组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（营地购买段——单币购买只扣钥石组）
# 隔离存档换注 main.meta 保确定性（禁碰真实档 user://save.json）；陈旧档段首清理）----
for p0 in ["user://smoke_click_probe_reset.json", "user://smoke_click_probe_reset.json.tmp"]:
if FileAccess.file_exists(p0):
@@ -143,7 +143,7 @@ func _ready() -> void:
if String(iso_fk.meta_state.tree_state().fork_sides.get("fg_posture", "")) != "b":
_problems.append("Fork 切态未持久（reload 后激活态 != b）〔句柄子容器批 V1〕")
# ---- 树面高档钮扩面段（迭代 55 B5——购买0/20/40/60 档经调试注钥后真点＋先手压制 A 侧回切）----
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:198 （营地购买段——购买面真输入扩面组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（营地购买段——购买面真输入扩面组）
iso_c.meta_state._add_keystone(9999)
main.ui.modals.camp.tree.refresh_camp(main._camp_data())
await get_tree().process_frame
@@ -238,7 +238,7 @@ func _ready() -> void:
ProbeUiUtil.push_click(main, treasure_back) # 真点返回（closed 同源钮）
await get_tree().process_frame
# ---- 秘宝架扩面段（迭代 55 B5——购买10/购买25/装配/升级30 真点；钥匙门先经树购 ks_workshop 点亮）----
# 判据出处: design/gdd/systems/跨局循环/秘宝.md:246 （秘宝匣柜台——购买/装配/升级真输入扩面组）
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「验收标准」护栏强制 护栏强制（秘宝匣柜台——购买/装配/升级真输入扩面组）
ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center()) # 木桩→树界面
await get_tree().process_frame
var ks_btn: Button = null
@@ -364,7 +364,7 @@ func _ready() -> void:
ProbeUiUtil.push_click(main, codex_back) # 真点返回（closed 同源钮）
await get_tree().process_frame
# ---- 营地 Esc 浮窗设置动线（迭代 55 B5——Esc 真键唤起浮窗→设置钮真点开设置层）----
# 判据出处: design/ux/camp.md:45 （Esc 段组——三出口真输入扩面）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（Esc 段组——三出口真输入扩面）
var esc_ev := InputEventKey.new()
esc_ev.keycode = KEY_ESCAPE
esc_ev.physical_keycode = KEY_ESCAPE
@@ -400,7 +400,7 @@ func _ready() -> void:
if main.ui.modals.camp.scene.visible or not main.ui.screens.start_overlay.visible:
_problems.append("营地关闭后未恢复开始层〔句柄子容器批 V1〕")
# ---- 选档界面行为走查（迭代 33 卡③）：sl5 空槽新档链／sl6 有档槽进档链／sl7 删档二次确认双路径
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （选档走查段——激活态建立组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（选档走查段——激活态建立组）
# ／sl8 消费方分派单口／sl12 动线序不回闪。开层=函数直调（「进入存档」钮归卡② mn3——中间态在案）；
# 隔离=attach_slot_template 注入命名空间，夹具按槽直写（卡① 注入口）。----
var csel_tpl := "user://smoke_click_probe_savesel_slot_%d.json"
@@ -504,7 +504,7 @@ func _ready() -> void:
_problems.append("[savesel] 关闭后层未隐藏或开始层未恢复（模态栈单口失守）")
# ---- 设置面段（隔离 store 换注禁碰真实 user://settings.cfg；真实按钮信号路径）----
# 判据出处: design/gdd/systems/表现与支撑/设置与本地化.md:4 （设置面段——最小设置面组）
# 判据出处: design/gdd/systems/表现与支撑/设置与本地化.md「设置与本地化」设置项与多语言 设置项与多语言（设置面段——最小设置面组）
for p0 in ["user://smoke_click_probe_settings.cfg"]:
if FileAccess.file_exists(p0):
DirAccess.remove_absolute(p0)
@@ -586,7 +586,7 @@ func _ready() -> void:
if ProbeUiUtil.find_button(main.ui.modals.menu.settings_overlay, "退出游戏", "prefix") != null:
_problems.append("设置面仍含退出游戏按钮（二轮 D1——只在一级菜单出现）")
# ---- 生涯页段（入口点击链+关闭回返，真实按钮信号路径；本页只读零写，
# 判据出处: design/ux/camp.md:45 （生涯页段——同壳同形态组）
# 判据出处: design/ux/camp.md「叠层与开合」各界面开合走模态栈单口 各界面开合走模态栈单口（生涯页段——同壳同形态组）
# 值断言归冒烟投影段与 ui_struct 结构族，此处只验开合路径与零跳转）----
# 生涯页驱动=函数直调中间态（卡② mn10——careerbtn 已撤，卡④ 笔记本改挂前无 UI 路径）
if true:
@@ -903,7 +903,7 @@ func _ready() -> void:
_run_modal_probes_once()
_play_one_action()
# ---- 预算耗尽收口（T17 硬锁批适配）：选件变强后 probe 可能活过预算不再战败——断点段前提
# 判据出处: design/ux/level-map.md:11 （主循环选路段——入口候选组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（主循环选路段——入口候选组）
# （冒险终局面在案）须主动满足。收口驱动：任何停点层逐个推进（复用主循环分支语义）至
# level_screen 选路停点→真实放弃二击→终局面。战斗中则继续 autoplay 打完。
if not _done and not main.ui.modals.run.end_overlay.is_open():
@@ -952,7 +952,7 @@ func _ready() -> void:
_play_one_action()
# 排播期/Waiting 等待态=自然流逝（演播秒级、锁随队列空解除）
# T17 适配：战败或放弃二途皆达终局面（放弃=预算耗尽收口路径——见上），断点段前提不变。
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:180 （断点段——断点域与续玩组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（断点段——断点域与续玩组）
await get_tree().process_frame
var bp_file := "user://smoke_click_probe_reset.json"
var iso_chk = load("res://core/save_manager.gd").new(bp_file)
@@ -984,7 +984,7 @@ func _ready() -> void:
# ① 战斗收口断点写盘断言保留（上方——冒险流直调中间态 mn10）。
# ---- 迭代 55 B5 扩面收尾段（地图放弃动线——主循环流不定达放弃，独立新局确定性驱动）----
# 判据出处: design/ux/level-map.md:11 （主循环选路段——放弃二击真输入组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（主循环选路段——放弃二击真输入组）
ProbeUiUtil.isolate_save(main, "smoke_click_probe_expansion", true, false, true)
main.ui.modals.menu.debug_overlay.set_sliders(2000, 2000) # 高加成上限（与主循环同口径——层速推进保放弃停点快达）
main.ui.modals.menu.debug_overlay.seed_edit.text = "44"
@@ -1032,7 +1032,7 @@ func _ready() -> void:
await get_tree().process_frame
# ---- 大门两分支断言段（卡④ T5 接收——卡② 移交落点；V3 断言面）----
# 判据出处: design/ux/camp.md:16 （大门段——点大门先出确认组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（大门段——点大门先出确认组）
# 驱动=营地场景根点选信号（真实路由）→组合根 _on_camp_object_pressed→确认弹窗。
# 无断点=两出口（是/否）；有断点=三出口（set_breakpoint 注入选路停点形——同下方开场行③先例）。
# 判据绑可观测提交面：点大门不直接进冒险（is_adventure 翻转只在 confirmed 后）；cancelled 恒=
@@ -1057,7 +1057,7 @@ func _ready() -> void:
await get_tree().process_frame
# R4 位次真点（营地交互修复批——位次与语义绑定钉）：真点前消费方前置读（gate_new 在册）→
# 按类型定位按钮行 child(0) 全局矩形中心真点——位次若错接，此点命中「否」，下方主证（翻转）即红。
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:90 确认弹窗位次定值：推进在左、维持居右（R4 位次真点）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族、维持居右（R4 位次真点）
if String(main._confirm_consumer) != "gate_new":
_problems.append("R4 前置：确认消费方非 gate_new（分派面漂移）〔营地交互批 V3〕")
var gate_row := _first_hbox(main.ui.modals.menu.confirm_dialog)
@@ -1072,7 +1072,7 @@ func _ready() -> void:
if String(main._confirm_consumer) != "":
_problems.append("R4 主证：确认后消费方未清零〔营地交互批 V3〕")
# 开局终态两钉（营地交互修复批——开始层隐藏收一处后的落点断言）：
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:78 关卡开始 → 呈现节点图选路停点（开局终态两钉）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「行进与选路：兑付后确认，选路就是行进」关卡里没有一次自动前进 关卡里没有一次自动前进（开局终态两钉）
# R1＝确认后开始层不可见（被测改动特有提交面——修复前该句恒红＝「开局被开始层盖住」缺陷本体）；
# R2＝关卡画面（选路停点）在位（开局终态呈现面，与既有 is_adventure 断言同批缺一即红）
if main.ui.screens.start_overlay.visible:
@@ -1181,10 +1181,10 @@ func _ready() -> void:
# ---- 模态/tooltip/刷新链一次性覆盖（真实信号路径驱动） ----
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:277 （模态/tooltip 段——遮挡与输入锁组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（模态/tooltip 段——遮挡与输入锁组）
func _run_modal_probes_once() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:277 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（判定上报通道——验证函数组）
# ⓪ 玩家面文案真实入口断言（迭代36 卡A wa1——C 区两段头随战斗常驻）
if not _tested_copy and main.ui.battle.info_panel != null and main.ui.battle.info_panel.visible:
_tested_copy = true
@@ -1377,7 +1377,7 @@ func _labels_with_text(labels: Array, needle: String) -> Array:
func _play_one_action() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（判定上报通道——验证函数组）
var settlement = main.run_scope.settlement
if settlement == null:
return # 结算竞态防抖：battle_finished 与本轮动作调度同帧到达时 settlement 可能已被置空（基线既有噪声——加固）
@@ -1414,7 +1414,7 @@ func _play_one_action() -> void:
func _random_unknown_adjacent(minesweeper) -> Vector2i:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（判定上报通道——验证函数组）
var hero: Vector2i = minesweeper.hero_pos()
var cands: Array = []
for dy in range(-1, 2):
@@ -1430,13 +1430,13 @@ func _random_unknown_adjacent(minesweeper) -> Vector2i:
func _click_stop() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:262 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P1 / P2 后置」后置原因 后置原因（判定上报通道——验证函数组）
# 停手走真实点击路径（AP 条「停手」钮 → 组合根 settle_batch——排雷玩法 D1×6① 回归载体）
ProbeUiUtil.push_click(main, main.ui.battle.board_zone.ap_bar._btn_stop)
# ---- T1 D1：锁期/重放断言（每 run 一次，脚本化场景——演播期豁免的断言化承载） ----
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （锁期/重放段——拒绝与锁组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（锁期/重放段——拒绝与锁组）
# 锁期断言（排播队列活跃=锁面）：注入封印击 → 直落被冻结不受理（封印未置）+ `_locked_click`
# 缓存命中且为本注入（「最后一次」语义——注入帧内无并发点击）。
# 重放断言（演播完边沿 pump_ended→_replay_locked_click 重入唯一动作通道）：缓存清空 +
@@ -1444,7 +1444,7 @@ func _click_stop() -> void:
# 前提消失守卫：等重放期间出现停点层/战斗收场（注入时点恰逢终结演播）→ 静默弃测不计
# problem（封印动作不杀伤，正常局不触发；断言实现形态取舍在代拍白名单内）。
func _locktest_tick() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（判定上报通道——验证函数组）
if _locktest_state == 2:
return
var settlement = main.run_scope.settlement
@@ -1501,7 +1501,7 @@ func _locktest_tick() -> void:
func _locktest_pick_cell(minesweeper) -> Vector2i:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （判定上报通道——验证函数组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（判定上报通道——验证函数组）
var hero: Vector2i = minesweeper.hero_pos()
for dy in range(-1, 2):
for dx in range(-1, 2):
@@ -1519,7 +1519,7 @@ func _locktest_pick_cell(minesweeper) -> Vector2i:
# 断言两钉：①覆盖登记件停手键在场（零命中＝驱动空转假绿，即红）；②相位离开 Active（停手
# 收轮）。前提消失守卫：点击后战局收场（终结演播竞态）→ 静默弃测不计 problem（正常局不触发）。
func _stoptest_tick() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:167 （停手＝玩家主动收轮——判定上报通道）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「一帧一个意图、对外只有三种事件：批次仲裁与事件面」玩家主动收轮 玩家主动收轮（停手＝玩家主动收轮——判定上报通道）
if _stoptest_state == 2:
return
var settlement = main.run_scope.settlement
@@ -1556,7 +1556,7 @@ func _stoptest_tick() -> void:
func _stoptest_assert_hit() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:167 （停手钮真输入命中登记——判定上报通道）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「一帧一个意图、对外只有三种事件：批次仲裁与事件面」玩家每帧只提交一个意图 玩家每帧只提交一个意图（停手钮真输入命中登记——判定上报通道）
var stop_btn: Button = main.ui.battle.board_zone.ap_bar._btn_stop
var stop_key := String(_recorder._node_keys.get(stop_btn.get_instance_id(), ""))
if stop_key == "" or not _recorder._hits.has(stop_key):
@@ -1574,7 +1574,7 @@ func _latest_open_line(main: Node) -> String:
func _first_hbox(node: Node) -> HBoxContainer:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:90 （位次真点定位——R4 判据面辅助）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（位次真点定位——R4 判据面辅助）
if node is HBoxContainer:
return node
for ch in node.get_children():
@@ -1585,7 +1585,7 @@ func _first_hbox(node: Node) -> HBoxContainer:
func _report_stall(st: Dictionary) -> void:
# 判据出处: design/engineering/test-conventions.md:30 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「2. 场景级探针标配」每新增一个可交互 每新增一个可交互（判定上报通道——验证函数组）
var why := ""
if st.phase == "Waiting":
why = "结算停滞：Waiting 相位无推进（结算应同步走完——窗口段已删除）"
@@ -1601,7 +1601,7 @@ func _report_stall(st: Dictionary) -> void:
func _dump_state() -> void:
# 判据出处: design/engineering/test-conventions.md:30 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「2. 场景级探针标配」每新增一个可交互 每新增一个可交互（判定上报通道——验证函数组）
var diag: Dictionary = main.run_scope.settlement.diagnostic_snapshot() # 诊断观测面（私有字段零直读）
print(" node_index=%s round=%s phase=%s ap=%s rap=%s" % [
str(main.run_scope.runner.node_index), str(main.run_scope.settlement.round_index),
game/probe/ui_contrast_probe.gd
+1 -1
View File
@@ -88,7 +88,7 @@ func _ratio(a: Color, b: Color) -> float:
func _ready() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:281 （UI 文字对比度机检 ≥4.5:1 无区域例外——对比度组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（UI 文字对比度机检 ≥4.5:1 无区域例外——对比度组）
var problems: Array = []
var pairs := _pairs()
for p in pairs:
game/probe/ui_input_probe.gd
+13 -13
View File
@@ -242,7 +242,7 @@ func _ready() -> void:
_pre_fail("目标格选取失败 seal=%s dig=%s forbid=%s reveal=%s" % [seal_t, dig_t, forbid_t, reveal_t])
return
# ---- case① 悬停可挖域：motion → 悬停态到达（金框 + 十字光标）----
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:269 悬停光标三语义随目标切换、已开格路径预览、可挖域常驻微光（case①-③ 输入面）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测、已开格路径预览、可挖域常驻微光（case①-③ 输入面）
_push_motion(_pos(bv, seal_t))
await get_tree().process_frame
if bv.hover_probe() != seal_t:
@@ -271,7 +271,7 @@ func _ready() -> void:
if bv.mouse_default_cursor_shape != Input.CURSOR_ARROW:
_problems.append("case③ 移动光标缺失（%d）" % bv.mouse_default_cursor_shape)
# ---- case④ 右键封印：seal_place 到达组合根 + 核心封印态落位 ----
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:52 封印受理即揭示、受理零兑付零事件（case④/④b——受理即揭示改版换代）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「挖、封印、移动：每个动作怎么才算合法」玩家对棋盘只做三件事 玩家对棋盘只做三件事、受理零兑付零事件（case④/④b——受理即揭示改版换代）
_push_click(_pos(bv, seal_t), MOUSE_BUTTON_RIGHT)
await get_tree().process_frame
if not _has_action(seal_t, "seal_place"):
@@ -285,7 +285,7 @@ func _ready() -> void:
if seal_unit == null or not seal_unit.seal_on:
_problems.append("case④b 封印印记未下发（seal_on=%s）" % ["无单元" if seal_unit == null else str(seal_unit.seal_on)])
# ---- case④c（V9 新增）已封印格零动作：真输入左/右键 → action_requested 零发射、光标态=禁止 ----
# 判据出处: design/ux/battle.md Interaction Map 已封印格行——已封印格无动作（左右键同零意图）
# 判据出处: design/ux/battle.md「Interaction Map」输入前提 输入前提
var acts_before_v9: int = _actions.size()
_push_motion(_pos(bv, seal_t))
await get_tree().process_frame
@@ -311,14 +311,14 @@ func _ready() -> void:
if not legend_seal_line.contains("受理即揭示"):
_problems.append("case④c 悬停说明在册缺新口径（图例封印行=%s）〔封印改 V9〕" % legend_seal_line)
# ---- case⑤ 双击 chord：禁入格双左击（核心拒挖零副作用）→ chord_attempted ----
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 拒绝三源可辨、任何拒绝零副作用（case⑤ chord）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」任何拒绝零副作用 任何拒绝零副作用、任何拒绝零副作用（case⑤ chord）
_push_click(_pos(bv, forbid_t), MOUSE_BUTTON_LEFT)
_push_click(_pos(bv, forbid_t), MOUSE_BUTTON_LEFT)
await get_tree().process_frame
if _chords.is_empty() or _chords[_chords.size() - 1] != forbid_t:
_problems.append("case⑤ chord_attempted 未达（chords=%s）" % [str(_chords)])
# ---- case⑥ 左键挖：dig 到达组合根 + 核心揭格落位 ----
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 挖掘受理与揭格落位（case⑥）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（case⑥）
_push_click(_pos(bv, dig_t), MOUSE_BUTTON_LEFT)
await get_tree().process_frame
if not _has_action(dig_t, "dig"):
@@ -327,7 +327,7 @@ func _ready() -> void:
if not ms.is_revealed(dig_t):
_problems.append("case⑥ 核心揭格未落位（目标=%s）" % dig_t)
# ---- case⑦ 英雄精灵世界落位（回归闸）：精灵在 SubViewport 世界内，
# 判据出处: design/ux/battle.md:154 主角站桩立绘带落影、贴脚与缩放档（case⑦-⑩ 呈现落位）
# 判据出处: design/ux/battle.md「封印格呈现预览」封印受理后格子进入 封印受理后格子进入、贴脚与缩放档（case⑦-⑩ 呈现落位）
# 落位 = 格×步距 + 脚底锚（横=格中线/纵=格底往上 25% 线=HERO_GROUND_FRAC 自底边口径——「脚踩
# 格子 1/4 处·从下往上数」；禁带壳层 _svp_container.position 居中偏移——上批误用壳层
# cell_origin 实测右偏 ~7 格+偏离格心，实机截图用户报缺陷）。素材缺位树（hero==null，字形
@@ -394,7 +394,7 @@ func _ready() -> void:
if bv._world.hero.position.distance_to(expect10b) > 0.5:
_problems.append("case⑩ 还原后英雄未复位（pos=%s expect=%s）" % [str(bv._world.hero.position), str(expect10b)])
# ---- case⑪ 贴图缺位回退（字形「人」回归闸）：texture 置 null + refresh → 英雄格数字 0 时字形
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:264 棋盘格子与数字完整可见——贴图缺位回退字形保可读（case⑪）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（case⑪）
# 必须回退「人」（数字格仍显数字——回退判据与抑制判据同源）；验毕还原纹理重绘。 ----
if bv._world.hero != null:
var hp11: Vector2i = ms.hero_pos()
@@ -411,7 +411,7 @@ func _ready() -> void:
bv._hero_sprite.tex_idle = tex_saved
bv.refresh()
# ---- case⑭ 变异角标（flat_damage 未开格视觉标记；resolver 注入面+落位+复位） ----
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:154 呈现按 effect/trigger/placement 数据路由、零特判（case⑭ 角标）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「验收标准」候选池空合法 候选池空合法、零特判（case⑭ 角标）
var mark_t: Vector2i = _pick_forbidden(bv, ms) # 任一未开格（禁入=未开非相邻）
if mark_t.x >= 0:
bv.set_variant_mark_resolver(func(_c): return "flat_damage")
@@ -425,7 +425,7 @@ func _ready() -> void:
else:
_problems.append("case⑭ 无未开格可验（板面异常）")
# ---- case⑮ 视野迷雾（三态呈态/半径圈/移动跟随/开关两态零扰动/提灯插值位；
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:268 视野迷雾：灯光区随移动跟随、开关两态结算逐位一致（case⑮）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测、开关两态结算逐位一致（case⑮）
# 纯呈现零逻辑——迷雾开关切换前后 minesweeper 状态摘要逐位一致） ----
var fogp: Dictionary = bv.fog_params_probe()
if int(bv.FOG_RADIUS) != 8 or int(fogp["lantern"]) != 0 or not fogp["enabled"]:
@@ -521,7 +521,7 @@ func _ready() -> void:
# attune_param_sum 只读出口→set_fog_glow_bonus〕→视野 +4 生效与卸装复原。
# settlement.attunement 手动注入=模拟 begin_battle enc 注入后的运行态〔注入面本体归
# 冒烟+单测覆盖〕；不重启冒险——case⑯ 起既有板面继续用）
# 判据出处: design/gdd/systems/跨局循环/元进度.md:156 解锁可见：装配强化下一局生效（case⑮ 装配链）
# 判据出处: design/gdd/systems/跨局循环/元进度.md「验收标准」钥石不丢 钥石不丢（case⑮ 装配链）
main.save_manager.meta_state.set_attunement_equipped(["wide_scout_band"])
var p_lantern: Dictionary = main.build_adventure_params(main.save_manager, main.meta)
if not (p_lantern.get("attunement", []) as Array).has("wide_scout_band"):
@@ -540,7 +540,7 @@ func _ready() -> void:
_problems.append("case⑮ 卸装后 dist==R+1 格未复原遮蔽")
main.save_manager.meta_state.set_attunement_equipped([])
# ---- case⑯ 状态面板输入锁语义（R3——开层锁棋盘、关层恢复无残留；真实 push_input
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:277 模态打开输入锁定、关闭逐层恢复（case⑯ R3）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」关闭逐层恢复 关闭逐层恢复、关闭逐层恢复（case⑯ R3）
# 路径：入口角标本体 press+release 真点击 → 状态面板开；锁期挖掘点击零穿透；「继续」关层后
# 同格挖掘重新到达——锁语义与既有模态同款，无状态残留。置于全 case 之尾：取格若需前沿移位
#（真实点击 move 扩大可挖域），其板面扰动不再波及任何既有断言——域恰 2 枚时 seal_t 带封印+
@@ -596,7 +596,7 @@ func _ready() -> void:
if not _has_action(status_dig, "dig") or not ms.is_revealed(status_dig):
_problems.append("case⑯ 关闭后挖掘未到达（恢复无残留验证失守）")
# ---- case⑰ 未开格类型微光（活板面走查：作用集恒等／开格灭／移动复亮
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:267 类型微光出圈即灭入圈即亮、已开与封锁格恒无微光（case⑰）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测、已开与封锁格恒无微光（case⑰）
# 与出圈灭／相位门控／开关两态零扰动。与冒烟段数据面断言分工：此处走真实点击路径） ----
if not bool(bv.type_glow_probe().get("enabled", false)):
_problems.append("case⑰ 微光默认态非开（生产默认开——Q4 丙案）")
@@ -785,7 +785,7 @@ func _push_release(pos: Vector2, btn: int) -> void:
func _pre_fail(why: String) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
push_error("[ui_input_probe] FAIL — " + why)
print("[ui_input_probe] FAIL — " + why)
get_tree().quit(1)
game/probe/ui_probe.gd
+14 -14
View File
@@ -16,7 +16,7 @@ func _ready() -> void:
await get_tree().process_frame
var problems: Array = []
# ---- 放弃入口（台账 119）：默认隐藏（非冒险模式无冒险可放弃——开始层/调试两层）----
# 判据出处: design/ux/level-map.md:59 放弃冒险入口＝边缘动作、任意选路停点承载——非冒险模式无入口（默认隐藏）
# 判据出处: design/ux/level-map.md「Information Hierarchy」本屏必须传达的全部信息 本屏必须传达的全部信息、任意选路停点承载——非冒险模式无入口（默认隐藏）
if main.ui.modals.run.level_screen.abandon_btn == null or main.ui.modals.run.level_screen.abandon_btn.visible:
print("[ui_probe] FAIL — 放弃按钮默认应隐藏（非冒险模式关）")
get_tree().quit(1)
@@ -24,7 +24,7 @@ func _ready() -> void:
# ---- 营地覆盖层（主菜单入口/开合/余额文案/购买禁用态；
# 隔离存档换注 main.meta 保确定性（禁碰真实档 user://save.json——SaveManager 路径注入纪律；
# 营地先行段只换 meta 不换 save_manager——冒险段换注零档在前）----
# 判据出处: design/ux/camp.md:45 五功能窗统一窗壳、五窗互斥单开、各窗自带关闭钮（营地开合组）
# 判据出处: design/ux/camp.md「叠层与开合」五窗互斥单开 五窗互斥单开、五窗互斥单开、各窗自带关闭钮（营地开合组）
ProbeUiUtil.isolate_save(main, "smoke_ui_probe_camp", false, false, false)
if not await ProbeUiUtil.open_camp_via_savesel(main, "smoke_ui_probe_camp"):
problems.append("营地入口缺失（选档层新档钮——mn9 新路径驱动中断）〔句柄子容器批 V1〕")
@@ -36,12 +36,12 @@ func _ready() -> void:
problems.append("营地层打开时开始层未隐藏（规范 2.3 遮挡纪律）〔句柄子容器批 V1〕")
else:
# 天赋树子界面（场景点选真实路由——木桩命中区进树界面；卡④ T5 深员改指）
# 判据出处: design/ux/camp.md:20 木桩命中区→天赋树界面入口（场景点选路由）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（场景点选路由）
ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"dummy").get_center())
await get_tree().process_frame
if not main.ui.modals.camp.tree.visible:
problems.append("天赋树子界面未打开（场景点选路由中断）〔营地图批 V2〕")
# 判据出处: design/ux/camp.md:41 钥石余额常驻画面顶部 HUD 栏（余额文案组）
# 判据出处: design/ux/camp.md「顶栏」钥石余额常驻画面顶部一行小 钥石余额常驻画面顶部一行小（余额文案组）
if not String(main.ui.modals.camp.tree._balance_label.text).begins_with("钥石"):
problems.append("营地余额文案缺失（%s）〔句柄子容器批 V1〕" % main.ui.modals.camp.tree._balance_label.text)
if main.ui.modals.camp.tree._tree_buy_btns.is_empty():
@@ -57,7 +57,7 @@ func _ready() -> void:
ProbeUiUtil.push_click(main, ProbeUiUtil.find_button(main.ui.modals.camp.tree, "返回营地")) # 真点底栏返回钮→_emit_closed（camp_sub_view_base.gd:66-84）
await get_tree().process_frame
# 秘宝匣子界面（场景点选真实路由——宝箱命中区）
# 判据出处: design/ux/camp.md:18 宝箱命中区→秘宝匣界面入口
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇
ProbeUiUtil.push_click_at(main, main.ui.modals.camp.scene.get_hotspot_rect(&"chest").get_center())
await get_tree().process_frame
if main.ui.modals.camp.treasure._workshop_rows.size() != 12:
@@ -76,7 +76,7 @@ func _ready() -> void:
await get_tree().process_frame
# ---- 入口选路停点（关卡开始即出节点图——level_started 后、首战前弹选路层；
# candidate_rect 命中矩形真点 pick 入口单候选进首战）----
# 判据出处: design/ux/level-map.md:11 入口停点候选数＝入口个数（入口单候选断言）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（入口单候选断言）
# ---- 独立性断言（独立屏激活期战斗屏宿主整体隐藏，零透出）----
if not main.ui.modals.run.level_screen.visible:
problems.append("关卡开始未弹入口选路停点（level_screen 应可见）")
@@ -92,7 +92,7 @@ func _ready() -> void:
if not main.ui.screens.battle_root.visible or main.ui.modals.run.level_screen.visible:
problems.append("选路提交战斗节点后未切回战斗屏（屏级互斥恢复失守）")
# ---- 放弃入口·冒险模式可见 + 战斗中按下被拒（真实按钮路径——入口挂选路停点，战斗中拒绝为防御分支）----
# 判据出处: design/ux/level-map.md:42 放弃冒险（任意选路停点）→ 冒险落幕——战斗域单事务在飞时拒绝
# 判据出处: design/ux/level-map.md「Navigation Position」任意选路停点 任意选路停点（任意选路停点）→ 冒险落幕——战斗域单事务在飞时拒绝
if main.ui.modals.run.level_screen.abandon_btn == null or not main.ui.modals.run.level_screen.abandon_btn.visible:
problems.append("冒险模式放弃按钮未开放（选路停点入口在案）")
else:
@@ -101,7 +101,7 @@ func _ready() -> void:
if main.run_scope.adventure == null or String(main.run_scope.adventure.state) != "running":
problems.append("首战中放弃未被拒（战斗域单事务在飞——state 应保持 running）")
# ---- 既有断言（回归基线；A 区无进度条——节点链进度由关卡画面独立屏承载）----
# 判据出处: design/ux/battle.md:122 B 区构建组：主角与敌人站桩、明细带挖掘期收起、轮次指示、棋盘与 C 区/秘宝槽、首战进行中
# 判据出处: design/ux/battle.md「Layout Zones」采用用户拍板的布局图 采用用户拍板的布局图、明细带挖掘期收起、轮次指示、棋盘与 C 区/秘宝槽、首战进行中
if main.ui.battle.board_zone.board_view.cells_probe().is_empty():
problems.append("棋盘格未生成（cells=0）")
if main.ui.battle.board_zone.board_view.board() == null:
@@ -119,7 +119,7 @@ func _ready() -> void:
problems.append("B 区敌方站桩未构建（%d 个）" % main.ui.battle.stage.enemy_box.get_child_count())
if main.ui.battle.board_zone.ap_bar._dots.get_child_count() != int(main.db.run.action_economy.ap_per_round):
problems.append("D 区 AP 点阵数量错误（%d）" % main.ui.battle.board_zone.ap_bar._dots.get_child_count())
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:258 开轮硬重置：行动点回到表值（AP 点阵数=ap_per_round）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（AP 点阵数=ap_per_round）
if main.ui.battle.board_zone.ap_bar.refresh_remaining_text() == "":
problems.append("D 区弃图刷新按钮文案缺失")
if main.ui.battle.board_zone.toast == null:
@@ -136,7 +136,7 @@ func _ready() -> void:
# E 区无道具面板——四区构建由其余断言覆盖
# ---- 敌方站桩投影（顺位徽标/意图三档动作动画占位——敌人系统×4，全站桩）----
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:275 敌人呈现：意图占位三档可见性——普通攻击零表示、类型级提示（站桩投影组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」类型级提示 类型级提示、类型级提示（站桩投影组）
# B 区站桩子件伴随件化（壳层 tooltip 载体）——断言口径见台账 171：
# 伴随件化（壳层 tooltip 载体），穿透明（子件 _name_label/_armor_icon/_intent_badge）改本体
# 探针出口 stage.enemy_body_at(i).name_line_probe()/intent_probe()——呈现口径逐字保持
@@ -163,7 +163,7 @@ func _ready() -> void:
elif not bool(main.ui.battle.stage.hero_standee.portrait_probe().get("has_tex", false)):
problems.append("主角立绘纹理未落位（显示档 hero=144——显示档批）")
# ---- BUG-0001 回归（tooltip 入树后 set_effects 槽位不错位——结算软锁修复沉淀）----
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:274 状态槽图标+层数+剩余次数、悬停见来源（tooltip 回归组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」悬停见来源 悬停见来源、悬停见来源（tooltip 回归组）
var slots_row = main.ui.battle.stage.hero_standee.slot_row # BUG-0001 回归随组件迁入站桩（tooltip/槽位错位同源）
var probe_eff: Array = [{"effect_id": "attack_up", "display_name": "增伤", "layers": 1,
"remaining_settlements": 1, "source_class": "safe_cell", "round_index": 1, "effective_value": 50}]
@@ -189,7 +189,7 @@ func _ready() -> void:
# ---- 图标键回归（HUD框架 图标键契约：状态表九行全映射〔定稿 PNG 纹理〕、
# 格面资源 cell_type 九型全映射〔含 gp 键〕；查不到的键 fail-fast + ? 占位
# ——此处钉死映射不残缺，未知键断言由 _icon_tex/_badge_glyph 承担）----
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:274 极性按键级表呈现——状态图标键映射不残缺（图标键回归组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（图标键回归组）
for eid in ["attack_up", "ac_up", "alert", "weaken", "enrage", "off_guard", "sapped", "empower", "fortify"]:
if not StatusSlotRow.EFFECT_ICON.has(eid) or StatusSlotRow.EFFECT_ICON[eid] == null:
problems.append("状态图标九键纹理映射缺失（%s）" % eid)
@@ -214,7 +214,7 @@ func _ready() -> void:
# ---- L2 单场段（debug_session 单场原语 + 去饱和接口可用性；雾格机制已整体移除，不再断言变体呈现）----
# 单场无用户入口——探针直调 debug_session 原语（battle_created/ready 仍经组合根接线；
# _reset_run_scope 复现 _start_single 的提示去重复位）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:156 布置域：变异格全在初始展开区外（L2 布置域组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「验收标准」候选池空合法 候选池空合法（L2 布置域组）
main.begin_session(false)
main._debug.start_single(2)
await get_tree().process_frame
@@ -237,7 +237,7 @@ func _ready() -> void:
# ---- GP 终局行：summary gp_final 键取数+胜利面板 GP 行呈现（C5：GP 行只上冒险终局面板；
# 断言面 = summary 键，无影子账清零转存）----
# （置于战斗态断言之后——合成收束会灰化站桩并清 settlement 引用，具污染性）
# 判据出处: design/ux/settlement-summary.md:20 战利品行＝GP 增量+总量（冒险终局面板 GP 行组）
# 判据出处: design/ux/settlement-summary.md「战斗总结结算」冒险模式战斗胜利 冒险模式战斗胜利（冒险终局面板 GP 行组）
var meta_saved = main.meta.save
for p2 in ["user://smoke_ui_probe_settle_scratch.json", "user://smoke_ui_probe_settle_scratch.json.tmp"]:
if FileAccess.file_exists(p2):
game/probe/ui_struct_probe.gd
+15 -13
View File
@@ -89,7 +89,7 @@ func _ready() -> void:
# ---- 生涯页：入口=帐篷旁笔记本（卡④ T3 改挂——场景点选信号真实路由→组合根 _open_career）→
# 结构断言族→只读巡检（契约 3）+零动效契约+零跳转契约（提纲 P4 甲）→组合根真实路径关闭。
#（登记序/树序契约统一在全模态 _modal_registry_contract——boot 段跑）----
# 判据出处: design/ux/camp.md:19 帐篷旁笔记本→生涯记录；生涯页返回钮口径由结构校验兜底（生涯段）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇；生涯页返回钮口径由结构校验兜底（生涯段）
# 营地语境：开始层全程隐藏（笔记本入口在营地场景根——关生涯回营地不回开始层，卡④ T3 语境分支）
main._camp_pres.open_camp() # 重开营地场景根（笔记本入口语境）
_settle()
@@ -106,7 +106,7 @@ func _ready() -> void:
if main.ui.modals.menu.career_overlay.visible or main.ui.screens.start_overlay.visible:
problems.append("[career] 关闭后页未隐藏或开始层回弹（营地语境分支失守）〔营地图批 V5〕")
# ---- Esc 浮窗结构段（卡⑤——三钮在位且仅三＋零动效契约＋登记序在册＋debug_badge 不波及）----
# 判据出处: design/ux/camp.md:45 ESC 优先序：有窗先关最上层窗、无窗才进浮窗；各窗自带关闭钮（Esc 段）
# 判据出处: design/ux/camp.md「叠层与开合」各窗自带关闭钮 各窗自带关闭钮、无窗才进浮窗；各窗自带关闭钮（Esc 段）
main._camp_pres.open_camp()
_settle()
var gpos_gate: Vector2 = main.ui.modals.camp.scene.get_hotspot_rect(&"gate").get_center()
@@ -159,8 +159,10 @@ func _ready() -> void:
var quit_chain := FileAccess.get_file_as_string("res://presentation/main.gd") + FileAccess.get_file_as_string("res://presentation/main_esc_flow.gd")
if not quit_chain.contains("MainEscFlow.on_quit(self)") or not quit_chain.contains("root.quit_game()"):
problems.append("[esc] 退出调用链断裂（_on_esc_quit→_on_quit→_quit_game）〔ESC批 V5〕")
if main.ui.screens.debug_badge.visible:
problems.append("[esc] 浮窗开态 debug_badge 可见（发布态恒隐——float 类不注册 ModalStack 应零波及）〔ESC批 V8〕")
# 调试入口断言（V8 随恢复批换代——全局浮层角标=UI 最顶层、任何 UI 不遮挡，浮窗开态仍应可见；
# 2026-11-09 特批恢复批——发布态恒隐语义退役，原「浮窗开态不可见」预期过期漏翻，CI run 152 红实证）
if main.ui.screens.debug_badge == null or not main.ui.screens.debug_badge.visible:
problems.append("[esc] 浮窗开态调试角标不可见（全局浮层最顶层失守——被遮挡）〔ESC批 V8〕")
push_esc.call()
_settle()
if main.ui.modals.camp.esc_overlay.visible:
@@ -213,7 +215,7 @@ func _ready() -> void:
_settle()
# ---- 冒险簇（真流推进：开冒险→地图选路态→选战斗节点→战斗 HUD）----
# 判据出处: design/ux/level-map.md:3 图上点击选路·候选按钮退役（冒险簇选路真点组）
# 判据出处: design/ux/level-map.md「UX Spec: 关卡画面」四项设计拍板 四项设计拍板（冒险簇选路真点组）
ProbeUiUtil.isolate_save(main, "smoke_ui_struct_probe_adv", true, false, true)
main.ui.modals.menu.debug_overlay.seed_edit.text = "42" # 种子钉死（种子框默认为空=非首局随机，结构采样确定性禁依赖默认分支）
main._start_adventure_from_menu()
@@ -243,7 +245,7 @@ func _ready() -> void:
# ---- 图例层（旧模态、首过结构族）：ap_bar legend_toggled
# 信号真路径开（board_zone 信号→组合根 _on_legend_toggled→_open_modal）→结构断言族→
# closed 信号真路径关（close()→组合根 _on_modal_closed）。
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:88 图例面板＝模态族：统一登记序栈、入栈出栈、关闭逐层恢复（图例组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」入栈出栈 入栈出栈、入栈出栈、关闭逐层恢复（图例组）
main.ui.battle.board_zone.ap_bar._btn_legend.pressed.emit() # 前提注入（保留 emit）：emit 选路路径下 battle_root 未及显示且输入锁在（实证在案），真点不可达——图例开启的真输入承载随「route 信号路径屏幕切换时序」发现一并呈报待裁
_settle()
if not main.ui.modals.run.legend_overlay.visible:
@@ -406,7 +408,7 @@ const _PAUSE_READONLY_SIGNALS: Array[String] = [
func _status_readonly_contract(main: Node) -> void:
# 判据出处: design/engineering/code-conventions.md:21 视图零核心写调用、依赖单向（status 只读巡检组）
# 判据出处: design/engineering/code-conventions.md「1.3 依赖单向，核心写调用完成」依赖单向 依赖单向、依赖单向（status 只读巡检组）
var overlay: Control = main.ui.modals.run.status_panel
var stack: Array = [overlay]
var conn_count := 0
@@ -453,7 +455,7 @@ func _status_zero_motion_contract(main: Node) -> void:
# 清单外零连接。白名单={视图自身 _emit_closed〔返回钮〕, 组合根 _on_career_closed}；页内任何
# 购买/导航/写入方向的新连接一律红，须先入册审查。
func _career_readonly_contract(main: Node) -> void:
# 判据出处: design/engineering/code-conventions.md:21 视图零核心写调用、依赖单向（career 只读巡检组）
# 判据出处: design/engineering/code-conventions.md「1.3 依赖单向，核心写调用完成」依赖单向 依赖单向、依赖单向（career 只读巡检组）
var overlay: Control = main.ui.modals.menu.career_overlay
var stack: Array = [overlay]
var conn_count := 0
@@ -500,7 +502,7 @@ func _career_zero_motion_contract(main: Node) -> void:
# _career_registry_contract 的断言（career=状态面板后/确认弹窗前、树序同步）由本全量合同覆盖）
# ⑭选档界面契约（卡③ sl1/sl2/sl3/sl4/sl9——呈现面全部来自喂入数据，视图零自判）
func _save_select_contract(main: Node, tpl: String) -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 三存档位独立文件、激活态由选档界面建立（选档契约组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「存什么：表与档分家，局内系统资源不入档」第一条边界 第一条边界、激活态由选档界面建立（选档契约组）
var sso: Node = main.ui.modals.menu.save_select_overlay
# sl1 三槽呈现：槽卡计数==3＋零滚动容器（禁滚动长列表形态——契约 1）
var rows: VBoxContainer = sso._rows_box
@@ -580,7 +582,7 @@ func _collect_labels(node: Node, out: Array[String]) -> void:
func _modal_registry_contract(main: Node) -> void:
# 判据出处: design/engineering/code-conventions.md:54 模态覆盖层层级规则——新增覆盖层必须登记 z 序位置（登记序契约组）
# 判据出处: design/engineering/code-conventions.md「2.3 模态覆盖层层级规则」打开任何模态覆盖层时 打开任何模态覆盖层时（登记序契约组）
var list: Array = main.ui.flow.stack._list
# ① 登记册序==合同模态序（逐位点名——合同是登记序唯一事实源）
var contract_modals: Array = []
@@ -648,7 +650,7 @@ func _modal_registry_contract(main: Node) -> void:
# ⑬career 零跳转契约（提纲 P4 甲——页内零「前往他处」入口：除「返回」外任何导航钮=红）
func _career_nojump_contract(main: Node) -> void:
# 判据出处: design/ux/camp.md:19 生涯记录入口与返回钮口径由结构校验兜底——页内零导航入口（零跳转契约组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（零跳转契约组）
for nav in ["营地", "商店", "设置", "冒险", "继续上局", "退出", "前往"]:
if ProbeUiUtil.find_button(main.ui.modals.menu.career_overlay, nav, "contains") != null:
problems.append("[career][nojump] 页内出现导航入口「%s」（零跳转违约——生涯纯只读）" % nav)
@@ -658,7 +660,7 @@ func _career_nojump_contract(main: Node) -> void:
# （名行基线离盒底 1px 同型高危写法返修回归闸；
# 内容矩形=StandeeBody.content_rect()，最低绘制元素=底座下缘）
func _standeefit_contract(main: Node) -> void:
# 判据出处: design/ux/battle.md:154 主角站桩立绘（无框立绘+落影）——站桩内容矩形⊆舞台（站桩适配组）
# 判据出处: design/ux/battle.md「封印格呈现预览」封印受理后格子进入 封印受理后格子进入（无框立绘+落影）——站桩内容矩形⊆舞台（站桩适配组）
var st: Node = main.ui.battle.stage
if st == null or st.hero_standee == null:
problems.append("[standee] 舞台/主角站桩缺失（断言中断）")
@@ -743,7 +745,7 @@ func _in_scroll(c: Control) -> bool:
func _audit(screen: String, roots: Array) -> void:
# 判据出处: design/engineering/architecture/architecture.md「三屏壳与组合根」(组合根交接面) 组合根交接面与呈现装配——屏结构审计宿主面（结构审计组）
# 判据出处: design/engineering/architecture/architecture.md「三屏壳与组合根」呈现场景拆为三屏壳 呈现场景拆为三屏壳(组合根交接面) 组合根交接面与呈现装配——屏结构审计宿主面（结构审计组）
for r in roots:
if r != null and is_instance_valid(r):
_force_layout(r)
game/probe/ui_tune_probe.gd
+6 -6
View File
@@ -43,7 +43,7 @@ func _ready() -> void:
# ① 全局浮层角标开窗（调试入口=UI 最顶层浮层，任何 UI 不遮挡——
# main 直接子层、LAYER_CONTRACT 末位 float 类；boot 菜单优先不开浮窗，角标真实点击路径开窗；
# 悬浮于菜单之上——开始层不隐藏；树序新基准=登记册末位（确认弹窗之后=绘制序最上））
# 判据出处: design/engineering/test-conventions.md §5-4 调试面＝DebugOverlay 常驻目检面（2026-11-09 特批恢复批，①开窗层级组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」2026 2026（2026-11-09 特批恢复批，①开窗层级组）
main.ui.screens.debug_badge.pressed.emit() # 角标真实信号路径 → 组合根 _on_debug_badge_pressed → C6 单口（2026-11-09 恢复）
await get_tree().process_frame
if not main.ui.modals.menu.debug_overlay.visible:
@@ -57,7 +57,7 @@ func _ready() -> void:
if str(boosted_atk) not in main.ui.modals.menu.debug_overlay.effect_text() or str(boosted_hp) not in main.ui.modals.menu.debug_overlay.effect_text():
problems.append("生效预览未联动（%s）" % main.ui.modals.menu.debug_overlay.effect_text())
# ③ 应用（真实信号路径：apply_requested → 组合根）——E4 后加成零表写，生效断言移至 ⑧ 战斗快照
# 判据出处: design/engineering/test-conventions.md:49 调试面加成链路：滑条联动/应用/重置、hero 表运行期只读（②③④⑦组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片、hero 表运行期只读（②③④⑦组）
var apply_btn: Button = ProbeUiUtil.find_button(main.ui.modals.menu.debug_overlay, "应用并关闭")
if apply_btn == null:
problems.append("调试浮窗「应用并关闭」钮缺失")
@@ -72,7 +72,7 @@ func _ready() -> void:
ProbeUiUtil.push_click(main, reset_btn)
# ⑤ 批量模拟全链路（N=10——走 level_autoplay 与 headless 扫描同口径；表基线由组合根复位；
# 菜单态上下文未锁定=按钮可点，is_running 语义=模拟在跑〔18卡⑦ 与对局禁用态拆分〕）
# 判据出处: design/engineering/test-conventions.md:49 调试面批量模拟链路：N=10 输出关卡完成率/剩余 HP/败北节点（⑤组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（⑤组）
main.ui.modals.menu.debug_overlay.set_sliders(100, 0)
main.ui.modals.menu.debug_overlay.set_sim_count(10)
# 折叠区控件真输入通道（test-conventions §2——先滚轮滚入可视区再点）：sim 钮在滚动列表 boot
@@ -155,7 +155,7 @@ func _ready() -> void:
# ⑨ 对局中可开（18卡⑦ P2 甲/T2 防护——S1+ 停机点回归闸）：战斗屏角标真实信号路径开窗；
# 棋盘输入不锁、状态角标不置灰（「默认开×遮挡复活」下必锁死的破约回归面）；
# 对局中批量模拟/两层调试两钮禁用；当局数据六项与只读访问器逐项一致；关闭钮真实路径收窗恢复
# 判据出处: design/engineering/test-conventions.md:49 调试面对局态：不锁棋盘输入/两钮禁用/当局数据只读一致（⑨组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（⑨组）
var dbg_badge: Button = main.ui.screens.debug_badge
if dbg_badge == null or not dbg_badge.visible:
problems.append("对局中调试浮层角标未点亮（全局浮层最顶层失守）")
@@ -201,7 +201,7 @@ func _ready() -> void:
_overlay_zero_motion_contract(main, problems)
# ⑩ 种子三分单点断言（18卡⑦ C1——判定只落 _seed_value() 单点；对局态不影响本判定面）：
# 显式合法整数全场景优先（含首局）→ 首局（存档布尔 false）恒 42 → 非首局空框引擎熵连抽不全等 42
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「主种子」(组合根交接面) seed_value＝组合根公开服务面（⑩种子三分判定单点组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「失败重开与主种子：倒下即终，重开即全新一轮」失败没有中间态 失败没有中间态(组合根交接面) seed_value＝组合根公开服务面（⑩种子三分判定单点组）
main.ui.modals.menu.debug_overlay.seed_edit.text = "777"
if main.seed_value() != 777:
problems.append("显式种子输入未优先（_seed_value != 777——C1 ①失守）")
@@ -242,7 +242,7 @@ func _ready() -> void:
# 全连接巡检——白名单={视图自身八方法 + 注册面模态编排口 ui.flow.close（closed 外发消费——
# 注册面批把该连接目标从组合根转发壳改为 flow 真方法，机检白名单随批登记同一连接）}；
# 当局数据区块=纯标签零连接在此被一并约束（新增任何连接=红须入册审查）。
# 判据出处: design/engineering/code-conventions.md:21 视图零核心写调用、依赖单向（白名单外零连接巡检组）
# 判据出处: design/engineering/code-conventions.md「1.3 依赖单向，核心写调用完成」依赖单向 依赖单向、依赖单向（白名单外零连接巡检组）
func _overlay_readonly_contract(main: Node, problems: Array) -> void:
var overlay: Control = main.ui.modals.menu.debug_overlay
var stack: Array = [overlay]
game/tests/smoke_boot.gd
+3 -3
View File
@@ -16,7 +16,7 @@ var _checks: int = 0
func check(cond: bool, label: String) -> void:
# 判据出处: design/engineering/test-conventions.md「测试层三元组」冒烟测试行 （测试层三元组——冒烟存活检查组）
# 判据出处: design/engineering/test-conventions.md「1.1 测试层三元组」测试层三元组 测试层三元组（测试层三元组——冒烟存活检查组）
_checks += 1
if cond:
print(" [PASS] " + label)
@@ -35,7 +35,7 @@ func _ready() -> void:
# 开机前置面：autoload 注册与资源可加载（挂主屏之前先查，失败时主屏断言整段跳过）
func _check_autoloads() -> void:
# 判据出处: design/engineering/test-conventions.md「测试层三元组」冒烟测试行 （测试层三元组——冒烟存活检查组）
# 判据出处: design/engineering/test-conventions.md「1.1 测试层三元组」测试层三元组 测试层三元组（测试层三元组——冒烟存活检查组）
for autoload_name in ["ConfigDB", "RngService", "SaveManager", "MetaProgression"]:
var node: Node = get_node_or_null(NodePath("/root/" + autoload_name))
check(node != null, "autoload %s 在位" % autoload_name)
@@ -64,7 +64,7 @@ func _boot_main_scene() -> Node:
# 主屏存活面：组合根装配句柄在位（main.X 一级句柄契约，探针挂载假设的启动侧证明）
func _check_main_scene(main: Node) -> void:
# 判据出处: design/engineering/test-conventions.md「测试层三元组」冒烟测试行 （测试层三元组——冒烟存活检查组）
# 判据出处: design/engineering/test-conventions.md「1.1 测试层三元组」测试层三元组 测试层三元组（测试层三元组——冒烟存活检查组）
check(main != null and main.is_inside_tree(), "主屏场景已实例化并在树")
if main == null:
return
game/tests/system_test.gd
+8 -8
View File
@@ -34,7 +34,7 @@ func _initialize() -> void:
# （自 game/smoke/smoke_all.gd 剪切迁入——断言 label 逐字原样；G12 两套调用不随迁，
# 归 source_guard_test.gd，断言迁移批 B G1）
func _split_tail() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
await process_frame
await process_frame
var autoload_ok: bool = get_root().get_node_or_null("/root/ConfigDB") != null and get_root().get_node_or_null("/root/SaveManager") != null
@@ -54,7 +54,7 @@ func _split_tail() -> void:
# ---- 三屏场景化断言（V2——独立实例化+关键节点在位+组合根树序/z 序保序）----
# （自 game/smoke/smoke_all.gd 剪切迁入——label 与 cond 逐字原样，断言迁移批 B G1）
func _smoke_scene_split() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 迭代27 T1 三屏场景化（V2：屏壳独立实例化+组合根装配保序）---")
# ① 三屏壳独立实例化（F6 等价——headless 直挂；视图代码构建在屏壳 _ready）
var menu: Node = load("res://presentation/scenes/menu_screen.tscn").instantiate()
@@ -151,7 +151,7 @@ func _count_visible_buttons(node: Node) -> int:
# ---- boot 链路时序后置条件（启动态六断言；只立行为可判断言，不造假时序）----
func _smoke_boot_chain() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 迭代28 T2 boot 链路时序后置条件（V2：六断言）---")
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
@@ -216,7 +216,7 @@ func _smoke_boot_chain() -> void:
func _smoke_run_lifecycle() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 迭代27 T1 会话物化（V3：两连局复位+脏状态不残留）---")
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
@@ -274,7 +274,7 @@ func _smoke_run_lifecycle() -> void:
# ---- d6/d7 批量模拟互斥守卫（wd6/wd7——白盒置态直调入口，以守卫早退的可见后果为断言面）----
func _smoke_sim_guards() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 卡① T2：批量模拟互斥两守卫（d6/d7）---")
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
@@ -348,7 +348,7 @@ func _face_snapshot(main: Node) -> Dictionary:
# 阶段面断言：adv/run/set=alive|null|both（会话三面存活态）；恒活面每阶段必查；
# 现值回调与 run_scope 成员必须同源（回调链无悬挂铁证）；extra=阶段附加判据。
func _stage_faces(main: Node, tag: String, adv: String, run: String, set: String, extra: Dictionary = {}) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var snap := _face_snapshot(main)
var bad := ""
for k in ["bonus_meta", "bonus_save", "camp_meta", "camp_save", "rp_stage", "rp_board_zone", "rp_fx", "rp_board"]:
@@ -417,7 +417,7 @@ func _face_liveness(name: String, v, want: String) -> String:
#（level_started→choices_presented 同步到达，无可观测中间态）——合并为 V3b 一处断言。
# （自 game/smoke/smoke_all.gd 剪切迁入——label 与 cond 逐字原样，断言迁移批 B G1）
func _smoke_lifecycle_matrix() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:284 （生命周期矩阵——三关序列组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「验收标准」开始新冒险 开始新冒险（生命周期矩阵——三关序列组）
print("--- 迭代28 T3 生命周期存活性矩阵（V3：九阶段×五引用面）---")
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
@@ -608,7 +608,7 @@ func _smoke_lifecycle_matrix() -> void:
func _smoke_camp_hud_band() -> void:
# 判据出处: design/ux/camp.md:41 （营地顶栏栏体定值与落座——几何/色值/吃点击五钉组）
# 判据出处: design/ux/camp.md「顶栏」钥石余额常驻画面顶部一行小 钥石余额常驻画面顶部一行小（营地顶栏栏体定值与落座——几何/色值/吃点击五钉组）
print("--- 营地交互修复批 T3 顶栏栏体（R5：色值/铺满/不吃点击/首子件/徽章落座）---")
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
game/tests/unit/battle_settlement/boss_gate_test.gd
+2 -2
View File
@@ -8,13 +8,13 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:293 Boss 节点开战行集宿主（装载组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」配置表共三张 配置表共三张（装载组）
_test_boss_node_spawns_boss_rowset()
quit(Kit.finish("boss_gate_test"))
func _test_boss_node_spawns_boss_rowset() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:295 开战生成按遭遇坐标取行集（Boss 行集组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」Boss Boss（Boss 行集组）
var db = load("res://core/config_db.gd").new()
var load_ok: bool = db.load_tables("res://data/tables", true) and db.diagnostics_count("error") == 0
Kit.check("前置：表加载零 error", load_ok)
game/tests/unit/battle_settlement/damage_controller_test.gd
+13 -13
View File
@@ -23,7 +23,7 @@ var _rows: Array = [] # 当前 run 的行协议收集（_on_row 绑定法—
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 伤害单据编排宿主（装载组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（装载组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("前置：表加载零 error", load_ok and db.diagnostics_count("error") == 0)
@@ -71,7 +71,7 @@ func _row_by_display_prefix(prefix: String) -> Dictionary:
# ---- 五配方一次全流程 + 双跑逐位复现 ----
func _run_recipe_sequence(db) -> Array:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （五段全序——配方序列组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（五段全序——配方序列组）
_rows = []
var h = _harness(db)
var units = h.units
@@ -178,7 +178,7 @@ func _run_recipe_sequence(db) -> Array:
func _test_five_recipes_and_replay(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:363 （同种子回放逐行相同组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「明细流水：每一行都能指回你刚才的哪一步棋」结算过程中每一件事都写一行明细 结算过程中每一件事都写一行明细（同种子回放逐行相同组）
var run1: Array = _run_recipe_sequence(db)
Kit.check("五配方序列产出 5 行伤害行", run1.size() == 5)
var run2: Array = _run_recipe_sequence(db)
@@ -188,7 +188,7 @@ func _test_five_recipes_and_replay(db) -> void:
# ---- A 模式（开单即结——回切位） ----
func _test_policy_immediate_mode(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （结算策略即时面组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（结算策略即时面组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -204,7 +204,7 @@ func _test_policy_immediate_mode(db) -> void:
# ---- 来源敌死亡：队列中未结单据作废（死亡即不动手） ----
func _test_source_death_void(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:133 （摇定后兑现前被杀本拍作废组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「技能池：每敌种一张带权技能池，每拍开轮摇号出招」每种敌人有一张技能池 每种敌人有一张技能池（摇定后兑现前被杀本拍作废组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -238,7 +238,7 @@ func _unit_fixture() -> Dictionary:
func _test_identical_content_dual_enemy(db: ConfigDb) -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:303 （双敌同内容顺位组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「开战生成：主角数据行与一场 1–4 个敌人」战斗开始时 战斗开始时（双敌同内容顺位组）
var a := _unit_fixture()
var b := _unit_fixture()
Kit.check("前置：双敌字典内容全同且非同一实例", a == b and not is_same(a, b))
@@ -268,7 +268,7 @@ func _test_identical_content_dual_enemy(db: ConfigDb) -> void:
# d12 产发端增键：目标身份随行/随载荷下发（同名敌按 id 精确解析的产发半）
func _test_target_id_payload(db: ConfigDb) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -291,7 +291,7 @@ func _test_target_id_payload(db: ConfigDb) -> void:
func _test_requires_gate_and_zero(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -318,7 +318,7 @@ func _test_requires_gate_and_zero(db) -> void:
# ---- 主角倒下：flush 余单全部作废（_halted 终止） ----
func _test_hero_death_halt(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -336,7 +336,7 @@ func _test_hero_death_halt(db) -> void:
# ---- AC 合流：override 入参 / 表值兜底 / ac 型状态叠层（不入池） ----
func _test_ac_merge(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -364,7 +364,7 @@ func _test_ac_merge(db) -> void:
# ---- 池乘区收口：池内加算 → clamp；ac 型不入池 ----
func _test_pool_clamp(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_rows = []
var h = _harness(db)
if not h.spawn_ok:
@@ -422,7 +422,7 @@ func _test_pool_clamp(db) -> void:
# ---- 个体池读数 / 个体 AC 合流（增益状态 v1.5——敌方状态个体化批）----
func _test_pool_consumption_per_unit(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var h = _harness(db, 3) # depth 3 = 混编行集（熊地精 1 + 地精 1–2，最少 2 只——个体对照面需 ≥2 敌）
if not h.spawn_ok:
return
@@ -442,7 +442,7 @@ func _test_pool_consumption_per_unit(db) -> void:
func _test_defender_ac_per_unit(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var h = _harness(db, 3)
if not h.spawn_ok:
return
game/tests/unit/battle_settlement/damage_math_test.gd
+5 -5
View File
@@ -12,7 +12,7 @@ var db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （伤害公式宿主——装载组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（伤害公式宿主——装载组）
db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("前置：settlement 表加载零 error", load_ok and db.diagnostics_count("error") == 0)
@@ -31,7 +31,7 @@ func _floor_val() -> int:
# ---- F2 乘区：池内加算 → 池间乘算 → floor（单一取整规则）----
func _test_pool_damage() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （池伤害公式组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（池伤害公式组）
var d := _floor_val() + 9 # 表值推导的任意正探针量（非玩法行值）
Kit.check("中性双池 (0,0) 原样透传", DamageMathScript.pool_damage(d, 0, 0) == d)
Kit.check("负敌方池压低不增高", DamageMathScript.pool_damage(d, 0, int(db.combat.settlement.core.pool_clamp_lo)) <= d)
@@ -44,7 +44,7 @@ func _test_pool_damage() -> void:
# ---- 克制分量：空桶不吃修正恒 0；落地下限保底（[1,+∞) 全来源）----
func _test_counter_component() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （计数器分量组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（计数器分量组）
var floor_v := _floor_val()
Kit.check("空桶（点数≤0）恒 0 不吃修正", DamageMathScript.counter_component(0, floor_v, floor_v) == 0
and DamageMathScript.counter_component(-1, 5, floor_v) == 0)
@@ -56,7 +56,7 @@ func _test_counter_component() -> void:
# ---- 掷点折扣查档（纯函数）：满阈值恒全额；档位边界/末档语义与表数组一致 ----
func _test_roll_discount_percent() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （乘区折扣组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（乘区折扣组）
var threshold := 10 # 查档探针阈值（夹具值——档位参数本身全部来自表）
var bounds: Array = db.combat.settlement.damage_roll.roll_tier_bounds
var discounts: Array = db.combat.settlement.damage_roll.roll_tier_discounts
@@ -81,7 +81,7 @@ func _test_roll_discount_percent() -> void:
# ---- 吃掷点分量算术：折扣→(暴击)→floor→+克制修正（单一取整链）----
func _test_rolled_component() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （掷点分量组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（掷点分量组）
var base := float(_floor_val() + 7) # 表值推导探针基线
var crit_mult: int = int(db.combat.settlement.damage_roll.crit_multiplier)
Kit.check("满额折扣无暴击 = floor(基线) + 修正 0", DamageMathScript.rolled_component(base, 100, false, crit_mult, 0) == int(floor(base)))
game/tests/unit/battle_settlement/effect_port_test.gd
+4 -4
View File
@@ -19,7 +19,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （效果端口宿主——装载组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」类写的是裸机制的账 类写的是裸机制的账（效果端口宿主——装载组）
_db = ConfigDBScript.new()
var load_ok: bool = _db.load_tables("res://data/tables", true)
Kit.check("前置：表加载零 error", load_ok and _db.diagnostics_count("error") == 0)
@@ -54,7 +54,7 @@ func _hero_attack_value(rows: Array) -> int:
# ---- V1 端口单实例与真实发射路由 ----
func _smoke_effect_port_wiring() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （端口单实例与六 Callable 路由组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」类写的是裸机制的账 类写的是裸机制的账（端口单实例与六 Callable 路由组）
print("--- 效果端口：装配链单实例＋真实发射路由 ---")
# 充能跑（蓄力周转 charge_rotation 在册——attack_commit 订阅行 attack_bonus per 蓄力周转计数器）
var orch_c = _orch(TEST_SEED)
@@ -88,7 +88,7 @@ func _smoke_effect_port_wiring() -> void:
# ---- V2 业务类零引擎直连（源码契约锚——theme_projection_test 源码锚惯例）----
func _test_business_classes_engine_free() -> void:
# 判据出处: design/gdd/术语表.md「效果端口件」 （业务类零引擎直连组）
# 判据出处: design/gdd/术语表.md「战斗与效果」效果端口件 效果端口件（业务类零引擎直连组）
print("--- 效果端口：业务类零引擎直连源码锚 ---")
for path in ["res://core/damage_controller.gd", "res://core/action_economy.gd"]:
var src := FileAccess.get_file_as_string(path)
@@ -100,7 +100,7 @@ func _test_business_classes_engine_free() -> void:
# ---- V3 伤害域事实面闭集（合成行两对照——damage_taken 真实单据流）----
func _test_biz_fact_face_closed() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」 （闭面四键 biz_fact 组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「扩展行：专长插入的结算效果」类写的是裸机制的账 类写的是裸机制的账（闭面四键 biz_fact 组）
print("--- 效果端口：业务发射事实面闭集 ---")
var orch = _orch(TEST_SEED)
Kit.check("V3 begin_battle 受理", orch.begin_battle(_enc([])))
game/tests/unit/battle_settlement/extended_row_violation_test.gd
+1 -1
View File
@@ -11,7 +11,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 （扩展行必载 effect_id——加载致命组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（扩展行必载 effect_id——加载致命组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
push_error("[extended_row_violation_test] 表加载失败")
game/tests/unit/battle_settlement/refresh_feats_test.gd
+13 -13
View File
@@ -154,7 +154,7 @@ func _seal_direct_with_expansion(orch) -> Vector2i:
# 四条真实路径（敌方攻击/危险格/错误封印/地形）逐路驱动：每条至少一张主角承伤单据在案，
# 且承伤计数器 == 主角承伤单据行数（每单据恰发射一次的全量判据——重复发射即计数器>行数）。
func test_all_hero_damage_paths_emit_once() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （换图生存：全局固定减伤全伤害路径恰一次组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（换图生存：全局固定减伤全伤害路径恰一次组）
print("--- V5 全局 damage_taken：四路径逐路恰一次 ---")
# ① 敌方攻击路径（Boss 战零挖掘连停三轮——干净样本：零地形零资源单据；多轮保证伤害技在案）
var orch1 = _orch(46001)
@@ -224,7 +224,7 @@ func _plan_seal(orch, target: Vector2i) -> Dictionary:
# 同一伤害不得出现两次消费（重复发射=计数器>行数）：敌方路径与地形路径两样本逐位核对——
# 地形单据带 hero_damage_consumed 标记，战斗段末 _resolve_board_flat_hero 跳过二次发射由此钉住。
func test_no_duplicate_damage_taken_event() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （受击事件零重复组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（受击事件零重复组）
print("--- V5 全局 damage_taken：无重复消费 ---")
var orch1 = _orch(46011)
var rows1 := _collect_hero_rows(orch1)
@@ -266,7 +266,7 @@ func _auto_dig(orch) -> void:
# V2 矿脉储能：受理的付费挖格 RAP 恰 +1、AP 按表扣、板资源不变
func test_reserve_on_accepted_dig() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （换图基座：挖格产 RAP 组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（换图基座：挖格产 RAP 组）
print("--- V2 矿脉储能：付费挖格产 RAP ---")
var orch = _orch(46021)
Kit.check("V2 前置：战斗受理", orch.begin_battle(_enc(["vein_reserve"])))
@@ -304,7 +304,7 @@ func _drain_round_rap_accounting(orch) -> bool:
# V3 省力周转：折价门槛与扣费（can 与执行同源；base 8→扣 4）
func test_refresh_discount_gate_and_charge() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （刷新折扣门控与充能组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（刷新折扣门控与充能组）
print("--- V3 省力周转：折价门槛与扣费 ---")
var orch = _orch(46022)
Kit.check("V3 前置：战斗受理", orch.begin_battle(_enc(["easy_swap"])))
@@ -326,7 +326,7 @@ func test_refresh_discount_gate_and_charge() -> void:
# V3 双基座叠加：挖格产 RAP 与刷新折价同场生效
func test_double_base_stack() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （双基座叠加组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（双基座叠加组）
print("--- V3 双基座叠加 ---")
var orch = _orch(46023)
Kit.check("V3 前置：战斗受理", orch.begin_battle(_enc(["vein_reserve", "easy_swap"])))
@@ -343,7 +343,7 @@ func test_double_base_stack() -> void:
# V12（refresh_feats 侧）：无专长基线——挖格零产 RAP、刷新按表基线扣、AP 保留、上限照旧
func test_no_feats_baseline() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （零专长基线组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（零专长基线组）
print("--- V12 无专长基线（refresh_feats 侧） ---")
var orch = _orch(46024)
Kit.check("V12 前置：战斗受理", orch.begin_battle(_enc([])))
@@ -379,7 +379,7 @@ func _br_count(orch) -> int:
# V4 成功事实只在新板就位后发射：成功恰一次；非 Active／每轮上限／RAP 不足三拒面全零事实零换图
func test_board_refresh_fact_only_on_success() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （弃图刷新事实面仅成功态组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（弃图刷新事实面仅成功态组）
print("--- V4 成功刷新事实：拒绝零事实 ---")
_install_br_probe()
var orch = _orch(46031)
@@ -414,7 +414,7 @@ func test_board_refresh_fact_only_on_success() -> void:
# V10 矿道红利：每次成功刷新 escrow 恰 +1 且 fx_grant_gp 行在案；拒绝零变化
func test_mine_profit_gp() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （换图资源：刷新固定 GP 收益组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（换图资源：刷新固定 GP 收益组）
print("--- V10 矿道红利：刷新固定 GP ---")
var orch = _orch(46032)
var gp_rows := {"n": 0}
@@ -461,7 +461,7 @@ func _damage_rows_by_source(rows: Array, source: String) -> Array:
# V6 石层缓冲：全局固定减伤（危险格 pierce 8→6 两档钉死：单刷减 2·同轮多刷不叠加·未刷新轮不减；
# 地形路径减后值=max(下限, effect_value−2)——含下限保持；敌方路径照常单次发射）
func test_stone_mitigation_all_damage() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （全局减伤全覆盖组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（全局减伤全覆盖组）
print("--- V6 石层缓冲：全局固定减伤 ---")
# S1 同轮双刷 → 危险格 pierce 8 减 2=6（叠加即 4——多刷不增钉死）
var orch1 = _orch(46041)
@@ -517,7 +517,7 @@ func test_stone_mitigation_all_damage() -> void:
# V9 坑道小憩：轮末合计回复（白盒预置承载上限 3——计数器直改属数据面注入；
# 自然累计 2 与满血未生效两形态分战场钉死）
func test_rest_rotation_cap_and_clear() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （轮末恢复 cap 与清账组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（轮末恢复 cap 与清账组）
print("--- V9 坑道小憩：轮末恢复 ---")
# R1 白盒预置 3 层 + 刷新闸（when<3 拒第 4 层）→ 停手回复 min(3, 缺血)——护甲降档保缺血 ≥3
var orch1 = _orch(46051)
@@ -575,7 +575,7 @@ func test_rest_rotation_cap_and_clear() -> void:
# V8 蓄力周转：当轮攻击消费全部层数（上限 3 闸=白盒预置；战斗新建自然清空）
func test_charge_layers_consumed_same_round() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （充能当轮消耗组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（充能当轮消耗组）
print("--- V8 蓄力周转：攻击消费层 ---")
var orch1 = _orch(46061)
var rows1 := _collect_damage_rows(orch1)
@@ -602,7 +602,7 @@ func test_charge_layers_consumed_same_round() -> void:
# V7 崩壁冲击：延迟群伤单（刷新时点零伤害行——战斗段末按存活目标结账）
func test_blast_defers_to_combat_segment() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （刷新群伤让位战斗段组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（刷新群伤让位战斗段组）
print("--- V7 崩壁冲击：延迟群伤 ---")
var orch = _orch(46071)
var rows := _collect_damage_rows(orch)
@@ -621,7 +621,7 @@ func test_blast_defers_to_combat_segment() -> void:
# 七件 validate/在册/稀有度 cap 对表/跨表计数器引用闭合/desc 禁词
func test_seven_feats_validate_and_pool() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （换图系七件校验与池组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（换图系七件校验与池组）
print("--- V11 七件数据与池 ---")
var seven := {"vein_reserve": "excellent", "easy_swap": "excellent", "wall_blast": "excellent",
"charge_rotation": "excellent", "stone_mitigation": "common", "tunnel_rest": "common", "mine_profit": "rare"}
game/tests/unit/battle_settlement/reward_ineffective_reason_test.gd
+3 -3
View File
@@ -16,8 +16,8 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:80 奖励未生效行=满层拒收、满血治疗等合法例外一行
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:87 显示名等玩家可见文案是数据面字段（日志消费端零文案——reason 结构化替代）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「明细流水：每一行都能指回你刚才的哪一步棋」结算过程中每一件事都写一行明细 结算过程中每一件事都写一行明细、满血治疗等合法例外一行
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「明细流水：每一行都能指回你刚才的哪一步棋」reason reason（日志消费端零文案——reason 结构化替代）
_db = ConfigDBScript.new()
if not _db.load_tables("res://data/tables", true):
print("[reward_ineffective_reason_test] FAIL — 数值表加载失败")
@@ -61,7 +61,7 @@ func _ineffective_rows(rows: Array) -> Array:
# 四类 reason 逐一命中（断言前提=各类未生效行在案；reason 键取值=分析判读契约四值）
func _assert_four_reasons() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:80 奖励未生效行四类合法例外
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「明细流水：每一行都能指回你刚才的哪一步棋」结算过程中每一件事都写一行明细 结算过程中每一件事都写一行明细
print("--- 奖励未生效 reason 四类逐一命中 ---")
# ---- ① full_hp：满血主角 + heal 型格正向（_flat_heal 满血分支即时兑付）----
game/tests/unit/battle_settlement/roll_multiplier_test.gd
+7 -7
View File
@@ -19,7 +19,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （掷点与乘区宿主——装载组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（掷点与乘区宿主——装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -44,7 +44,7 @@ func _init() -> void:
# 受理后不变量（encounter 受理后只读）。攻击单 base_value 贯通由 _smoke_damage_types 的
# hero_atk_val=100 全链路行值承载（同夹具既有覆盖——派生读在攻击链上工作即行值随 override 走）----
func _smoke_hero_atk_derived() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （英雄攻击派生组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（英雄攻击派生组）
var rng_a = load("res://core/rng_service.gd").new()
rng_a.set_master_seed(4242)
var s_a = load("res://core/battle_orchestrator.gd").new(_db, rng_a)
@@ -67,7 +67,7 @@ func _smoke_hero_atk_derived() -> void:
# → heavy 伤害 == light −1、ward == light +1（要求基线伤害 ≥ 2——地板 1 会吞 −1 位移）。
# 承伤位移红线（卡片 §8 L3）：全局位移只允许 ±1 量级——非此量级 = 矩阵消费面有未盘点的第二落点（停机）。
func _smoke_enemy_attack_type() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:295 （敌攻击类型行集组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」配置表共三张 配置表共三张（敌攻击类型行集组）
print("--- 敌方攻击类型轴（迭代 24 N3）---")
# ① 表列：20 行全填 normal（N3 全填不做差异化——Q9）
var at_ok := true
@@ -126,7 +126,7 @@ func _smoke_enemy_attack_type() -> void:
# ---- 护甲等级掷点·行为面（折扣档分布 / nat20 暴击 / 伤害下限 / 棋盘来源必中）----
func _smoke_armor_roll() -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:254 （护甲掷点与叠层合并组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（护甲掷点与叠层合并组）
print("--- 护甲等级掷点（查档纯函数 + 暴击 + 伤害下限 + AC12 分布 + 棋盘必中）---")
# ① 查档纯函数：全掷点域逐位对照（AC10 / AC12）+ EV 锚（AC10 期望减免 21.25% —— registry 参考数）
var expect_ac10 := {100: 11, 75: 3, 50: 4, 25: 2} # 掷 10-20 全额 / 7-9 / 3-6 / 1-2
@@ -345,7 +345,7 @@ func _auto_play_round(settlement, out: Dictionary) -> void:
# 基线构成：基线 100——hero 攻击类型=normal（锻造工坊配置默认值，
# hero.tres 无两轴字段）对轻甲中性 0 修正（目标 = L1 地精轻甲；AC 0 恒全额非暴击种子）。
func _smoke_pool_wiring() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 主角乘区接线 + 硬化折半方向 ---")
var base_row := _hero_attack_row_with({}, 100, 20260918)
var up_row := _hero_attack_row_with({"effects": ["attack_up"]}, 100, 20260918)
@@ -387,7 +387,7 @@ func _hero_attack_row_with(opts: Dictionary, hero_atk_val: int, seed_val: int) -
# ---- 攻击类型 × 护甲克制 + 标错惩罚冒烟（护甲快照/克制矩阵/充能/反噬三选一）----
func _smoke_damage_types() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 攻击类型 × 护甲克制 + 标错惩罚 ---")
# ① 护甲类型快照传播（spawn 行值 → 单位字典）
var enemy_system = load("res://core/unit_container.gd").new(_db)
@@ -482,7 +482,7 @@ func _find_seal_target(minesweeper, want_mine: bool) -> Dictionary:
# d_tick = max(damage_floor, pool_damage(floor(基线×档位%), 0, 0))，档位读数随行重建可归因）----
func _smoke_attack_chain_fresh_pool() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 战斗结算·fresh 池攻击链回归（Bug#2·掷点口径）---")
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260913)
game/tests/unit/battle_settlement/round_flow_skill_pool_test.gd
+16 -16
View File
@@ -22,7 +22,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:360 （轮内流与技能池宿主——装载组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（轮内流与技能池宿主——装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -49,7 +49,7 @@ func _init() -> void:
# ---- 完整战斗回放（自动玩家，确定性）——回放断言：同种子两遍步骤流逐行相同 ----
func _smoke_full_battle(L: int, D: int, label: String) -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （全战斗回放——五段全序组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（全战斗回放——五段全序组）
print("--- 完整战斗回放：%s ---" % label)
var run1 = _run_battle(L, D)
var run2 = _run_battle(L, D)
@@ -84,7 +84,7 @@ func _smoke_full_battle(L: int, D: int, label: String) -> void:
func _run_battle(L: int, D: int, axes: Dictionary = {}) -> Dictionary:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （战斗驱动组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（战斗驱动组）
# 每遍全新 RngService（同 master 种子）——回放断言的隔离前提（地图战斗资源 AC"两套全新 RngService+地图战斗资源"同款）
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(42)
@@ -149,7 +149,7 @@ func _auto_play_round(settlement, out: Dictionary) -> void:
# ---- 行动经济·轮内刷新冒烟（方案 A：Active 相位当场换图继续挖）----
func _smoke_active_refresh() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:262 （停手转存储备与轮内刷新组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P1 / P2 后置」后置原因 后置原因（停手转存储备与轮内刷新组）
print("--- 行动经济·轮内刷新（方案 A）---")
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260912)
@@ -256,7 +256,7 @@ func _active_refresh_replay() -> Array:
# ---- 遭遇随机化冒烟（难度曲线与Boss Core Rule 8：区间骰/encounter 流/可回放/空表定值路径）----
func _smoke_encounter_roll() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:296 （遭遇区间骰——摇号确定性组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」配置表共三张 配置表共三张（遭遇区间骰——摇号确定性组）
print("--- 遭遇随机化（unit_count 区间骰）---")
var counts: Array = []
for i in range(20):
@@ -391,7 +391,7 @@ func _encounter_replay(seed_val: int) -> Array:
# 五段全序断言（战斗结算 验收"五段全序"+ 行型封闭 10 类）：逐轮行相位序 = 授予 → 增益/减益 → 战斗 → 衰减 → 判定。
func _smoke_settlement_segments() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 五段全序 + 行型封闭 ---")
Kit.check("segment_order 五段冻结在位（表值 = 拍板序恒等）",
Array(_db.combat.settlement.segment_order) == SettlementTable.FROZEN_SEGMENT_ORDER
@@ -510,7 +510,7 @@ func _smoke_skill_pool() -> void:
# ① 数据面：技能表行集 + 普攻锁死 + 建议池行值 + 空池不可能（结构断言）
func _smoke_skill_pool_data() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
Kit.check("技能表十六行（普攻/突刺/蓄力/重击/硬化 + 撕咬/毒爆/蛛网束缚 + 大地脉动 + 震地怒击/遏毒/岩崩 + 毒吐/盾击——前三批 + Boss 半血解锁技三行〔迭代14④ T5〕+ 普通敌错峰两行〔迭代 24 N2〕+ 触发条件批示范两行〔孤注守势/趁隙偷袭〕）", _db.combat.skill.rows.size() == 16)
var basic: Dictionary = _db.combat.skill.row_by_id("attack")
Kit.check("普攻行：倍率恒 1 · 冷却恒 0（域校验锁死——池恒非空的结构前提）",
@@ -727,7 +727,7 @@ func _fresh_rng(seed_val: int):
# 单敌轨迹不独立复放——轨迹取数与其它流交错，无法脱离全序重建；
# 同种子全战斗逐位复现由 ② 全对拍承载，单点定位归事件日志。
func _smoke_skill_pool_replay_independence() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var seed_val := -1
for s in range(1, 60):
var seqs := _record_pool_trajectories(s, 1)
@@ -781,7 +781,7 @@ func _record_pool_trajectories(seed_val: int, rounds: int) -> Dictionary:
# 2026-10-28 重锚 [0.82, 1.02]（照酋长先例 ±0.10 绝对幅度，中值取理论稳态 0.92；旧带 [1.00,1.20] 系触发器前
# 唯一特殊技＝突刺的池结构下登记，随池构成换代作废；撤销证明＝带宽回退旧值本断言复红）→ 宽带登记。
func _smoke_skill_pool_ev_anchor() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var bands := {"goblin": [0.82, 1.02], "bugbear": [0.97, 1.03], "ogre_chief": [1.10, 1.30]} # 地精重锚 2026-10-28（触发条件批孤注守势入池稀释，无情境口径实测 0.9148；EV 锚注 enemy.tres）· 酋长重锚（震地怒击半血解锁入池，含闸长期速率上移：实测 1.1948；EV 锚注 enemy.tres）
var species := ["goblin", "bugbear", "ogre_chief"]
var rng = load("res://core/rng_service.gd").new()
@@ -837,7 +837,7 @@ func _smoke_skill_pool_ev_anchor() -> void:
# ⑤ 死亡打断作废（摇定后、兑现前死亡 → 本拍技能作废、不动手、不进账）
func _smoke_skill_pool_death_void() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var void_seed := -1
for s in range(1, 400):
var rg = load("res://core/rng_service.gd").new()
@@ -877,7 +877,7 @@ func _smoke_skill_pool_death_void() -> void:
# ⑥ 加载校验拒绝（单表域校验 + 跨表池构成纪律）
func _smoke_skill_pool_validation_reject() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var skill_table = load("res://data/schemas/skill_table.gd").new()
var enemy_table = load("res://data/schemas/enemy_table.gd").new()
enemy_table.rows.assign([{"enemy_id": "x", "display_name": "x", "pool": [{"skill_id": "ghost", "weight": 1}]}])
@@ -936,7 +936,7 @@ func _has_err_category(errs: Array, category: String) -> bool:
# 停手轮驱动 (2,9)——零挖掘零封印 → 零池，伤害行可逐拍精确复算；种子 hunt 至少各命一粒毒爆伤害行
# 与蛛网束缚施放行；毒分量随开战掷定的攻击基线缩放（atk 区间 2–4 → rider 1–3）。
func _smoke_debuff_rider() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var venom_seed := -1
var venom_check_ok := true
var venom_rows_seen := 0
@@ -1007,7 +1007,7 @@ func _smoke_debuff_rider() -> void:
# ---- 天赋树六键行为冒烟（V10：开局姿态窗/危险直觉限次/财富之道聚散/守侧失误补偿；
# 引擎直构 + 编排授予段直注（_grant_seg._judge_seal=结算授予段封印判定单口））----
func _smoke_counter_buckets() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 效果引擎无状态化四桶正向验收（卡② §9 V1/V6）---")
# V1——adventure 桶跨战持久：同一宿主字典下两战各真实 request_dig 一次，
# 断付费计数经 ctx 就地写入宿主字典并跨战累积（副本搬运态：读不到上一战值→第 2 战仍 1，此断言会红）。
@@ -1070,7 +1070,7 @@ func _smoke_counter_buckets() -> void:
# V6 形态先例同源：直入真实管线缝（_judge_seal 直调同款口径）。
func _smoke_extended_rows() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
print("--- 扩展行收敛：fx_reveal 兑付/落空 ---")
var RigS = load("res://core/battle_orchestrator.gd") # 局部装配别名（_smoke_counter_buckets 同款——跨函数不共享局部量）
var enc_fx = {"level_index": 1, "node_depth": 0, "hero_hp": 40, "hero_atk": 8, "hero_max_hp": 40,
@@ -1116,7 +1116,7 @@ func _smoke_extended_rows() -> void:
# 蓄力表值 2 拍衰减后剩 1 拍仍在池）→ 逐敌读敌方输出池。判据=施放者与被他敌的池读数差。
func _smoke_enemy_buff_targets_self() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var emp_mag: int = int(_db.combat.status_effects.row_by_id("empower").magnitude)
var sc_script = load("res://core/status_container.gd")
var found_seed := -1
@@ -1165,7 +1165,7 @@ func _smoke_enemy_buff_targets_self() -> void:
# 种子狩猎沿 _smoke_enemy_buff_targets_self 同款；叠层行为=容器级再授（roll_multiplier 先例形态）。
func _check_defensive_stance_values() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var row: Dictionary = _db.combat.status_effects.row_by_id("defensive_stance")
Kit.check("defensive_stance 生产行值：magnitude=-25 percent／duration_settlements=2／accumulate max_stack=1〔QA余 V9〕",
int(row.get("magnitude", 0)) == -25 and String(row.get("unit", "")) == "percent"
game/tests/unit/battle_settlement/seal_polarity_test.gd
+20 -20
View File
@@ -22,7 +22,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 （封印与极性宿主——装载组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「调参表」本系统无自有参数 本系统无自有参数（封印与极性宿主——装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -48,8 +48,8 @@ func _init() -> void:
# ---- 末点 AP 封印轮末结算（playtest 缺陷②回归：末点 AP 花在封印必须终结轮次进入下一轮）----
func _smoke_seal_ap_exhausted() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:139 封印判定批与溢价兑付链照常（保留组——封印受理即揭示改版零改动）〔封印改 V5〕
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:260 （末点 AP 耗尽即收轮组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「授予段兑付：极性路由，四类动作各归各系统资源」授予段消费结算队列 授予段消费结算队列（保留组——封印受理即揭示改版零改动）〔封印改 V5〕
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P1 / P2 后置」后置原因 后置原因（末点 AP 耗尽即收轮组）
print("--- 排雷玩法·封印动作耗尽末点 AP 回归 ---")
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260911)
@@ -327,8 +327,8 @@ func _rows_at(rows: Array, source_class: String, cell) -> Array:
func _smoke_clear_reward_chain() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:235 （清图奖励链——清图槽对象身份组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:235 （清图奖励链——清图槽对象身份组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「格面资源：每个非封锁格都带一个，摇号纪律不变」每张雷图装上时 每张雷图装上时（清图奖励链——清图槽对象身份组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「格面资源：每个非封锁格都带一个，摇号纪律不变」每张雷图装上时 每张雷图装上时（清图奖励链——清图槽对象身份组）
print("--- 清图奖励·双份兑付链（完美封印 / 零兑付 / 第二份被拒 / 高光记实）---")
# ① 真实流完美封印：标中一面真雷封印 + 零误标 + 清全图 → grant_clear 身份（clear_blast）双份真实兑付
var rows: Array = []
@@ -357,8 +357,8 @@ func _smoke_clear_reward_chain() -> void:
# 弱形式登记：正常战斗流下"授段时刻无存活敌"不可达——敌全灭当轮判定段即判胜并终止战斗，而清图批在判定段之前，
# 恒有存活敌；故本组直调编排私有面构造状态，只断言"路径存在 + 行为符合契约"（构造手法见各行注释）。
func _smoke_clear_reward_zero_paths() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:240 （无存活敌群伤记「奖励未生效」组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:240 （无存活敌群伤记「奖励未生效」组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」奖励未生效 奖励未生效（无存活敌群伤记「奖励未生效」组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」奖励未生效 奖励未生效（无存活敌群伤记「奖励未生效」组）
# ②-a 首份零兑付判定（无存活敌）→ first_ok=false + 未生效行
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260915)
@@ -413,8 +413,8 @@ func _smoke_clear_reward_zero_paths() -> void:
# 轮内刷新 provenance 守卫：刷新换来的图同轮清图不发清图奖励（_board_from_midround_refresh 守卫）
func _smoke_refresh_provenance_guard() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:237 （换图重置：旧封印印记先判定后消失组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:237 （换图重置：旧封印印记先判定后消失组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」换图重置 换图重置（换图重置：旧封印印记先判定后消失组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」换图重置 换图重置（换图重置：旧封印印记先判定后消失组）
print("--- 轮内刷新 provenance 守卫（刷新图清图不发清图奖励）---")
var rows: Array = []
var run := _run_full_clear(20260916, true, rows)
@@ -441,9 +441,9 @@ func _smoke_refresh_provenance_guard() -> void:
func _smoke_polarity_routing() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:139 封印判定批与溢价兑付链照常（保留组——封印受理即揭示改版零改动）〔封印改 V5〕
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:366 （极性路由：正向只兑正向、负向只兑负向组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:366 （极性路由：正向只兑正向、负向只兑负向组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「授予段兑付：极性路由，四类动作各归各系统资源」授予段消费结算队列 授予段消费结算队列（保留组——封印受理即揭示改版零改动）〔封印改 V5〕
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「轮末五段结算：一轮从收场走到判定」玩家行动点花完 玩家行动点花完（极性路由：正向只兑正向、负向只兑负向组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「轮末五段结算：一轮从收场走到判定」玩家行动点花完 玩家行动点花完（极性路由：正向只兑正向、负向只兑负向组）
print("--- 极性路由（挖安全格正向 / 挖危险格负向 / 标中正向 / 标空负向）---")
# 战斗随机值面随全局序漂移——构造种子按行为面扫描（谓词见 _polarity_probe_accepts）
var probe := {}
@@ -581,8 +581,8 @@ func _smoke_polarity_routing() -> void:
# 场景 B（② 改判〔封印改 V2〕）：标危险格 → 挖封印格被拒 → 收轮（标中判定照发）。
# 场景 C（①③）：标安全格 + 标危险格 → 不挖收轮 → 标空/标中判定照常。
func _smoke_seal_irreversible_quadrants() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 （封印不可逆四情况组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 （封印不可逆四情况组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「调参表」本系统无自有参数 本系统无自有参数（封印不可逆四情况组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「调参表」本系统无自有参数 本系统无自有参数（封印不可逆四情况组）
print("--- 封印不可逆四情况（禁撤封印 + 挖封印格兑付改判）---")
# 场景 A：安全格直挖（情况④）+ seal_pull/重复封印拒绝面
var rng_a = load("res://core/rng_service.gd").new()
@@ -696,8 +696,8 @@ func _smoke_seal_irreversible_quadrants() -> void:
# 负向字典逐型直验（类型化兑付行协议）：找真实板上各型非封锁格，直调 grant_routed 负向路由（att 归因束形态），
# 断言每型的兑付形态（enrage/off_guard/sapped 效果行、heal 直伤行、blast 警觉行、action 行动点排队）。
func _smoke_negative_dictionary() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （下轮行动点修正排队与兑现组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （下轮行动点修正排队与兑现组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（下轮行动点修正排队与兑现组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（下轮行动点修正排队与兑现组）
print("--- 负向字典逐型直验（sapped 在位 / heal 直伤 / blast 警觉 / action 行动点）---")
# 数据面：sapped 行在位（状态表七行 + effect_pool_map 映射在位）
var sapped: Dictionary = _db.combat.status_effects.row_by_id("sapped")
@@ -791,8 +791,8 @@ func _smoke_negative_dictionary() -> void:
# 资源面断言：chain/dig 事件恒携带 resource=true（危险格同权）；initial 恒 false（封锁格）；
# 封锁格查询 = null、危险格未开恒可查。
func _smoke_resource_surface() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:235 （资源面只读查询组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:235 （资源面只读查询组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「格面资源：每个非封锁格都带一个，摇号纪律不变」每张雷图装上时 每张雷图装上时（资源面只读查询组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「格面资源：每个非封锁格都带一个，摇号纪律不变」每张雷图装上时 每张雷图装上时（资源面只读查询组）
print("--- 格面资源资格面（危险格携带 / 封锁格无资源）---")
var run1 = _run_battle(1, 0)
var run2 = _run_battle(2, 0)
@@ -843,7 +843,7 @@ func _smoke_resource_surface() -> void:
# 断言真值依赖生产行值（行值变更即红）。合成行旧断言保留并存（零删除）。
func _check_enemy_alert_production_row() -> void:
# 判据出处: design/engineering/test-conventions.md:133 （真实入口断言——生产行值驱动）
# 判据出处: design/engineering/test-conventions.md「8.4 真实入口断言」真实入口断言 真实入口断言（真实入口断言——生产行值驱动）
var row: Dictionary = _db.run.reward.row_by_id("enemy_alert")
Kit.check("enemy_alert 生产行值：blast 负向 effect=alert power0 weight0（不入池警觉行）〔QA余 V12〕",
String(row.get("cell_type", "")) == "blast" and String(row.get("polarity", "")) == "negative"
@@ -863,7 +863,7 @@ func _check_enemy_alert_production_row() -> void:
func _check_ap_drain_production_row() -> void:
# 判据出处: design/engineering/test-conventions.md:133 （真实入口断言——生产行值驱动）
# 判据出处: design/engineering/test-conventions.md「8.4 真实入口断言」真实入口断言 真实入口断言（真实入口断言——生产行值驱动）
var row: Dictionary = _db.run.reward.row_by_id("ap_drain")
Kit.check("ap_drain 生产行值：action 负向 power=1 weight0〔QA余 V12〕",
String(row.get("cell_type", "")) == "action" and String(row.get("polarity", "")) == "negative"
game/tests/unit/battle_settlement/settlement_wiring_snapshot_test.gd
+2 -2
View File
@@ -419,8 +419,8 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （结算接线同种子逐项 golden 对拍组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:134 受理零兑付、改判路径死——流水零「奖励作废（封印格直接挖开）」行、
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（结算接线同种子逐项 golden 对拍组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「授予段兑付：极性路由，四类动作各归各系统资源」授予段消费结算队列 授予段消费结算队列、改判路径死——流水零「奖励作废（封印格直接挖开）」行、
# 同种子驱动序 golden 实测零漂移零重录（挖封印格被拒——驱动序不含该路径）〔封印改 V6〕
_db = ConfigDBScript.new()
var load_ok: bool = _db.load_tables("res://data/tables", true)
game/tests/unit/battle_settlement/skill_unlock_test.gd
+5 -5
View File
@@ -13,7 +13,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:293 Boss 半血解锁技宿主（装载组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」配置表共三张 配置表共三张（装载组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("前置：表加载零 error", load_ok and db.diagnostics_count("error") == 0)
@@ -26,7 +26,7 @@ func _init() -> void:
# 门谓词：卓尔 (2,9) hp 130（×mult 1.0）→ venom_curb unlock 50 → 阈值 round(130×0.5)=65
func _boss(db, L: int, D: int, kind := "boss"):
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var ec = UnitContainerScript.new(db)
var ok: bool = ec.spawn({"level_index": L, "node_depth": D, "hero_hp": int(db.combat.hero.max_hp), "row_kind": kind})
Kit.check("前置：spawn (%d,%d) 受理" % [L, D], ok)
@@ -45,7 +45,7 @@ func _has_sid(arr: Array, sid: String) -> bool:
func _test_gate_predicate(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:143 （门谓词：条件不满足不进可摇集合组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本（门谓词：条件不满足不进可摇集合组）
var ec = _boss(db, 2, 9)
var u: Dictionary = _boss_u(ec)
var mhp: int = int(u.max_hp)
@@ -74,7 +74,7 @@ func _test_gate_predicate(db) -> void:
# 闩不可逆：解锁后治疗抬回满血 → 复查零新解锁、可摇集合不回退
func _test_latch_irreversible(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:143 （闩型条件首次为真整场保持组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本（闩型条件首次为真整场保持组）
var ec = _boss(db, 2, 9)
var u: Dictionary = _boss_u(ec)
ec.apply_damage(u, int(u.max_hp) / 2) # → 半血触发
@@ -86,7 +86,7 @@ func _test_latch_irreversible(db) -> void:
# 普通行无字段逐位零扰动：地精 (1,0) 池快照零 unlock 键、过滤恒空转、可摇=全池
func _test_plain_rows_zero_drift(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:301 （普攻倍率 1 特例——零漂移组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「开战生成：主角数据行与一场 1–4 个敌人」战斗开始时 战斗开始时（普攻倍率 1 特例——零漂移组）
var ec = load("res://core/unit_container.gd").new(db)
Kit.check("零扰动前置：巨蜘蛛首遇带 spawn（池三行全无 trigger——快照键策略钉死载体）", ec.spawn({"level_index": 2, "node_depth": 1, "hero_hp": int(db.combat.hero.max_hp)}))
var u: Dictionary = ec.all_enemies()[0]
game/tests/unit/battle_settlement/trigger_cond_test.gd
+1 -1
View File
@@ -9,7 +9,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:143 （触发条件机制 V1–V10 组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本（触发条件机制 V1–V10 组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[trigger_cond_test] FAIL — 数值表加载失败")
game/tests/unit/battle_settlement/variant_placement_test.gd
+5 -5
View File
@@ -15,7 +15,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:151 变异布置宿主（装载组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「验收标准」候选池空合法 候选池空合法（装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -55,7 +55,7 @@ class _CountVariantRng extends RngServiceCore:
# 本段经 begin_battle 走完整初始化序后断言：门控一致性 / 布置域 / 数量公式 / 连通片上限 / 确定性。
func _smoke_variant_placement(L: int) -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:63 （战内布置段门控组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「变异框架与类型清单」每种变异是配置表里的一行具名声明 每种变异是配置表里的一行具名声明（战内布置段门控组）
print("--- 地形变异 布置段（L%d）---" % L)
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(42)
@@ -149,7 +149,7 @@ func _variant_dump(b) -> String:
func _smoke_global_variant() -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:74 （全局替换制与回落组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「全局作用域型」型变异是 型变异是（全局替换制与回落组）
print("--- 全局作用域变异（门控三维 + 全局池空兜底回落 + 资源面偏斜）---")
# ① 跨字段互锁负样本（resource_face ⟺ scope=global 三条 + effect_value 新域 [0,50]）
var vt = load("res://data/schemas/variation_table.gd").new()
@@ -344,7 +344,7 @@ func _errs_has_cross_field(errs: Array) -> bool:
# 全称不可断）。可达判据=①静态（布置面零字面量下界）＋②同种子改值产物互异（真实入口=begin_battle 布置段）。
func _test_pack_min_from_table() -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:63 （连通片格数 [pack_min,pack_max] 读表组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「变异框架与类型清单」每种变异是配置表里的一行具名声明 每种变异是配置表里的一行具名声明（连通片格数 [pack_min,pack_max] 读表组）
# ① 静态：布置面零字面量下界（randi_range(2, 退役——下界读 pack_min 表头单点）
var src := FileAccess.get_file_as_string("res://core/board_installer.gd")
Kit.check("布置面零字面量下界（randi_range(2, 退役、下界读表单点在位）〔架构整改 V10·静态〕",
@@ -376,7 +376,7 @@ func _test_pack_min_from_table() -> void:
# 授予段地形批（on_open 兑现 flat_damage）；mine_dust=信息型遮蔽解析数据面（board.variant_ids×表行 effect）。
func _test_l3_rockfall_minedust_rows() -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:63 （L3 布置段门控与效果兑现组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「变异框架与类型清单」每种变异是配置表里的一行具名声明 每种变异是配置表里的一行具名声明（L3 布置段门控与效果兑现组）
var pool := {}
for r in _db.combat.variation.variant_pool(3, "deep_underdark"):
pool[String(r.variant_id)] = r
game/tests/unit/contracts/source_guard_test.gd
+2 -2
View File
@@ -27,7 +27,7 @@ func _init() -> void:
# ---- 类型闸断言（V7——project.godot warning 配置在位〔源码断言〕+审计器脚本在位；
# 审计器归零判定走 static_scan S9 闸机，此处兜配置面）----
func _smoke_type_gate() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （封装边界——类型闸源码扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」封装边界 封装边界（封装边界——类型闸源码扫描组）
var pj: String = FileAccess.get_file_as_string("res://project.godot")
Kit.check("V7 类型闸 warning 配置在位（untyped_declaration=1 显形）〔迭代27 T5〕",
pj.contains("gdscript/warnings/untyped_declaration=1"))
@@ -38,7 +38,7 @@ func _smoke_type_gate() -> void:
# ---- 卫生件 grep 闸（V8——死代码/字符串 Callable/影子账残留零命中；源码扫描面）----
func _smoke_hygiene_gates() -> void:
# 判据出处: design/engineering/code-conventions.md:54 （模态覆盖层层级与登记纪律——卫生闸组）
# 判据出处: design/engineering/code-conventions.md「2.3 模态覆盖层层级规则」打开任何模态覆盖层时 打开任何模态覆盖层时（模态覆盖层层级与登记纪律——卫生闸组）
var callables := 0
for d in ["res://core", "res://presentation", "res://data"]:
var dir := DirAccess.open(d)
game/tests/unit/contracts/system_contracts_test.gd
+25 -25
View File
@@ -18,7 +18,7 @@ const Kit := preload("res://tests/unit/test_kit.gd") # T6 收口：_check/汇
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("前置：表加载零 error", load_ok and db.diagnostics_count("error") == 0)
@@ -41,8 +41,8 @@ func _init() -> void:
# ---- B1 兑付配方词表：五配方/三目标规则/双结账政策——常量非空且互异（封闭枚举负空间） ----
func _test_damage_controller_vocabularies() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器」 （事件/事实/效果类型/算子四词表封闭——契约词表组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器」 （事件/事实/效果类型/算子四词表封闭——契约词表组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器：所有伤害走同一道门」游戏里的每一份伤害 游戏里的每一份伤害（事件/事实/效果类型/算子四词表封闭——契约词表组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「伤害单据与伤害控制器：所有伤害走同一道门」游戏里的每一份伤害 游戏里的每一份伤害（事件/事实/效果类型/算子四词表封闭——契约词表组）
var kinds: Array = [
DamageControllerScript.KIND_HERO_ATTACK, DamageControllerScript.KIND_ENEMY_SKILL,
DamageControllerScript.KIND_BOARD_TYPED, DamageControllerScript.KIND_BOARD_BLAST,
@@ -72,8 +72,8 @@ func _test_damage_controller_vocabularies() -> void:
# ---- D2↔B1：掷点用途标签 ∈ RngService 封闭词表（EC12——跨系统字面量契约的成员性断言） ----
func _test_rng_tag_closure(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （流 scope 封闭词表组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （流 scope 封闭词表组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流：随机只从一个服务按号取，同种子必同局」用户两轮复裁 用户两轮复裁（流 scope 封闭词表组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流：随机只从一个服务按号取，同种子必同局」用户两轮复裁 用户两轮复裁（流 scope 封闭词表组）
var stream_label: String = String(db.combat.settlement.damage_roll.armor_roll_stream)
Kit.check("settlement.armor_roll_stream ∈ RngService 封闭标签词表（EC12）",
RngServiceScript.PURPOSE_TAGS.has(stream_label))
@@ -87,8 +87,8 @@ func _test_rng_tag_closure(db) -> void:
# ---- B1→D1 行协议：单据九栏缺省齐备 + 协议公共键形态 ----
func _test_ticket_nine_columns() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （单据九列协议组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （单据九列协议组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（单据九列协议组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（单据九列协议组）
var ctrl = _bare_controller()
var t: Dictionary = ctrl.open_ticket(DamageControllerScript.KIND_BOARD_FLAT_HERO, "mine_hit", "契约探针",
{"channel": "棋盘兑付", "base_value": 1, "target_rule": DamageControllerScript.TARGET_HERO, "ri": 0})
@@ -118,8 +118,8 @@ func _bare_controller():
# ---- B4→B3：增益授予布尔受理口径（受理/拒绝二元面 + 投影一致性） ----
func _test_status_boolean_acceptance(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:250 （受理布尔面组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:250 （受理布尔面组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（受理布尔面组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（受理布尔面组）
var effects = StatusContainerScript.new(db)
# EC1 域闭：notify_battle_start 前授予 = false（受理面封闭）
var any_row: Dictionary = {}
@@ -146,8 +146,8 @@ func _test_status_boolean_acceptance(db) -> void:
# 个体键直传字面量（"e1"/"e2"/"e3"——拼写约定单点在 StatusContainer.owner_key_for，测试面模拟授予路径逐只授）
func _test_status_individual_isolation(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:251 （按个体归属组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:251 （按个体归属组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（按个体归属组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（按个体归属组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "seal_hit", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -169,8 +169,8 @@ func _test_status_individual_isolation(db) -> void:
func _test_status_grant_all_per_unit(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:252 （授予即生效组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:252 （授予即生效组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（授予即生效组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（授予即生效组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "mine_hit", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -197,8 +197,8 @@ func _test_status_grant_all_per_unit(db) -> void:
func _test_status_death_clears(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:250 （战斗结束清空组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:250 （战斗结束清空组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（战斗结束清空组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（战斗结束清空组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "seal_hit", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -212,8 +212,8 @@ func _test_status_death_clears(db) -> void:
func _test_status_merge_per_unit(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:253 （只登记不去重组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:253 （只登记不去重组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（只登记不去重组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（只登记不去重组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "enemy_action", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -236,8 +236,8 @@ func _test_status_merge_per_unit(db) -> void:
# ---- B4 结算链契约（断言补齐批——①增益状态结算链）：衰减逐值/战斗结束全清/满层拒绝/独立并存/首授快照 ----
func _test_status_decay_and_clear(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:21 （先兑付后衰减组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:21 （先兑付后衰减组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「系统范围」边界这样划 边界这样划（先兑付后衰减组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「系统范围」边界这样划 边界这样划（先兑付后衰减组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "seal_hit", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -258,8 +258,8 @@ func _test_status_decay_and_clear(db) -> void:
func _test_status_stack_full_reject(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:255 （满层拒绝原子且留痕组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:255 （满层拒绝原子且留痕组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（满层拒绝原子且留痕组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（满层拒绝原子且留痕组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src := {"source_class": "seal_hit", "origin_cell": Vector2i(-1, -1), "round_index": 0}
@@ -277,8 +277,8 @@ func _test_status_stack_full_reject(db) -> void:
func _test_status_independent_branch(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:257 （合成不设上下限组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:257 （合成不设上下限组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（合成不设上下限组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（合成不设上下限组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var probe := {
@@ -303,8 +303,8 @@ func _test_status_independent_branch(db) -> void:
func _test_status_snapshot_first_grant(db) -> void:
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:258 （快照抗重载组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md:258 （快照抗重载组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（快照抗重载组）
# 判据出处: design/gdd/systems/战斗循环/增益状态.md「验收标准」状态池寿命可答 状态池寿命可答（快照抗重载组）
var effects = StatusContainerScript.new(db)
effects.notify_battle_start()
var src_first := {"source_class": "seal_hit", "origin_cell": Vector2i(3, 4), "round_index": 1}
game/tests/unit/core/adventure_feats_test.gd
+5 -5
View File
@@ -17,7 +17,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:281 冒险结构与专长宿主（装载组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「验收标准」开始新冒险 开始新冒险（装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -59,7 +59,7 @@ func _hits_kind(hits: Array, kind: String) -> Array:
# ② 冒险结构 API 闸（状态机受理面——重复开始拒绝 / 入口停点 / 放弃两态）
func _smoke_adventure_api() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:283 （冒险 API 组：开始受理/序列/回调）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「冒险的一生：开始、推进与三种结局」在本文是一个计量单位 在本文是一个计量单位（冒险 API 组：开始受理/序列/回调）
print("--- 冒险结构 API 闸（重复开始拒绝 · 入口停点 · 放弃两态受理）---")
var adr = load("res://core/adventure_runner.gd").new(_db, _fresh_rng(42))
adr.set_hero_override(900, 400) # 首战速胜档（放弃的非战斗受理要走到选路态）
@@ -122,7 +122,7 @@ func _api_mark_node(_node: Dictionary, _info: Dictionary, seq: Array) -> void:
# ③ 冒险验收断言（映射 冒险结构.md 验收标准——表覆盖/满配冒险成功/种子复现/大奖励/败北线/
# 重复拒绝/GP 跨关延续/加算区同账/恢复数学/放弃）
func _smoke_adventure() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:284 （冒险生命周期组：推进/末关/倒下/重开/生命账）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「验收标准」开始新冒险 开始新冒险（冒险生命周期组：推进/末关/倒下/重开/生命账）
print("--- 冒险结构验收（三关序列 · 大奖励 · 摘要五件事 · 账本封闭）---")
var autoplay = load("res://sim/level_autoplay.gd")
# ① 表与覆盖义务（序列关数 = 行集关数；节点源 = 参数档在固定种子下的生成图，
@@ -465,7 +465,7 @@ func _smoke_adventure() -> void:
# ---- 专长冒烟（feats 四级 · 案D 池接线 · V3 订阅面逐件三列）----
func _smoke_feats() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （奇物授予与凭证保底组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（奇物授予与凭证保底组）
print("--- 专长重设计实装（feat_table 四级 · 专长带池接线 · 订阅面逐件）---")
# ① 现行表牌库构成：36 件全量入池（破封一击随封印受理即揭示退役〔退役改 V7〕）——102 数值令牌+36 relic 令牌（四级 rarity 直映射）
Kit.check("feat_table 已加载（36 件=基础 27+迁入 2+完美保险 1+迭代 46 换图系七件−破封一击退役〔退役改 V7〕——换代）", _db.crossrun.feats != null and (_db.crossrun.feats.rows as Array).size() == 36)
@@ -920,7 +920,7 @@ func _level_active_nodes(level_index: int) -> Array:
# 生产 feat_ticket_quota==2 读表驱动；保底同置满使 false 只能来自配额分支（先于概率掷点）。
# 真实入口链 = node_curio_candidates→draw_candidates("reward_node")→feat_ticket_consider。
func _check_ticket_quota_exhausted(a_t) -> void:
# 判据出处: design/engineering/test-conventions.md:133 （真实入口断言——配额满分支售满后恒 false）
# 判据出处: design/engineering/test-conventions.md「8.4 真实入口断言」真实入口断言 真实入口断言（真实入口断言——配额满分支售满后恒 false）
Kit.check("生产配额值在役：feat_ticket_quota==2〔QA余 V4〕", int(a_t.db.run.adventure.feat_ticket_quota) == 2)
a_t.stop()._deck.ticket_appeared = int(a_t.db.run.adventure.feat_ticket_quota) # 配额满注入（A6 同款测试通道直填）
a_t.stop()._deck.ticket_pity = int(a_t.db.run.adventure.feat_ticket_pity_step) # 保底同置满——false 唯一来源=配额分支
game/tests/unit/core/auto_player_deduce_test.gd
+1 -1
View File
@@ -16,7 +16,7 @@ func _init() -> void:
func _smoke_zero_chain_rule() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:230 （0 格连锁传播闭包——模拟玩家算子组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（0 格连锁传播闭包——模拟玩家算子组）
var db = load("res://core/config_db.gd").new()
var load_ok: bool = db.load_tables("res://data/tables", true) and db.diagnostics_count("error") == 0
Kit.check("前置：表加载零 error", load_ok)
game/tests/unit/core/battle_driver_drive_test.gd
+4 -4
View File
@@ -55,7 +55,7 @@ func _init() -> void:
# ① 缺省两参（真编排器）：同种子两跑整轮驱动逐位（确定性自证——动作序列快照经 cell_revealed 事件流）
func _smoke_drive_round_contract() -> void:
# 判据出处: design/gdd/术语表.md「效果端口件」 （效果端口件：收事件交结算取回命中批——驱动循环契约组）
# 判据出处: design/gdd/术语表.md「战斗与效果」效果端口件 效果端口件（效果端口件：收事件交结算取回命中批——驱动循环契约组）
var db = load("res://core/config_db.gd").new()
var load_ok: bool = db.load_tables("res://data/tables", true) and db.diagnostics_count("error") == 0
Kit.check("前置：表加载零 error", load_ok)
@@ -81,7 +81,7 @@ func _smoke_drive_round_contract() -> void:
# ② provider 形态：策略回调产出 dig/seal_place/refresh 各一——提交与日志回调四元组在案
func _provider_shapes() -> void:
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （端口应答束形状组）
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」族探针共用的 族探针共用的（端口应答束形状组）
var st := _StubSettlement.new()
var script := [ {"kind": "dig", "cell": Vector2i(1, 1)}, {"kind": "seal", "cell": Vector2i(2, 2)}, {"kind": "refresh"}, {"kind": "stop"} ]
var logs: Array = []
@@ -102,7 +102,7 @@ func _provider_shapes() -> void:
# ③ max_rejects：策略恒返被拒动作——第 3 拒后停手出环（循环次数=3）
func _max_rejects() -> void:
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （拒绝通道组）
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」族探针共用的 族探针共用的（拒绝通道组）
var st := _StubSettlement.new()
st.minesweeper.accept = false
st.minesweeper.reject_cells = {Vector2i(9, 9): true}
@@ -122,7 +122,7 @@ func _max_rejects() -> void:
# ④ 合步 next：move 后相位变更即断弃 dig（桩 on_submit 钩子把 phase 推离 Active）
func _combined_step_next() -> void:
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」 （合并步进组）
# 判据出处: game/sim/battle_driver.gd「战斗驱动循环单点」族探针共用的 族探针共用的（合并步进组）
var st := _StubSettlement.new()
st.minesweeper.on_submit = func(action: String) -> void:
if action == "move":
game/tests/unit/core/board_gen_reward_test.gd
+5 -5
View File
@@ -18,7 +18,7 @@ var _rng
func _init() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:166 棋盘生成宿主（装载组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「验收标准」确定性复现 确定性复现（装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -52,7 +52,7 @@ func _mk_stream(stream_name: String, scope: int) -> RandomNumberGenerator:
# 公式 N×cell ≤ 可用高−12 必须计入 (N−1)×2px 网格间距，否则网格实高溢出被 clip_contents 裁掉；
# 现公式 = 计入间距 + 垂直预留 24px〔上 12/下 12——底部不贴 D 区边框〕）----
func _smoke_layout_cell_formula() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:75 （出生区边长表单点——格边长公式组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「出生区安全与反退化布雷：脚下无雷、白给板不出厂」玩家开局站在棋盘上的 玩家开局站在棋盘上的（出生区边长表单点——格边长公式组）
print("--- 棋盘布局格边长公式（底部预留回归·四档板型）---")
var board_generator = load("res://core/board_generator.gd").new()
var board_view = load("res://presentation/views/board_view.gd").new()
@@ -82,7 +82,7 @@ func _smoke_layout_cell_formula() -> void:
# ---- 地图战斗资源·身份面单元冒烟（格面资源：roll 恰一次 / 雷安同池 / 幂等 / 清图批尾）----
func _smoke_reward_identity_unit() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:233 （格面资源身份——三分出口与资源身份组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」每格必有货 每格必有货（格面资源身份——三分出口与资源身份组）
print("--- 地图战斗资源·格面资源身份面 ---")
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260911)
@@ -144,7 +144,7 @@ class _BoardRowStub:
func _smoke_board_generator() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:168 （确定性复现＋布雷纪律组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「P1 / P2 后置」确定性复现 确定性复现（确定性复现＋布雷纪律组）
print("--- 棋盘生成 ---")
var board_generator = load("res://core/board_generator.gd").new()
for L in [1, 2]:
@@ -239,7 +239,7 @@ func _board_dump(b) -> String:
# ---- 地图战斗资源·伤害量值区间冒烟（roll 域内 + 中点锚 + 变异实际流动 + 定值行不受扰）----
func _smoke_power_interval() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:233 （资源量值区间——伤害量值区间组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」每格必有货 每格必有货（资源量值区间——伤害量值区间组）
print("--- 地图战斗资源·伤害量值区间（上阶/下阶随机）---")
# ① 表侧静态锚（配置推导——改表不断锚）：凡带 power_min/power_max 的行 = 区间行，
# 校验配对齐全（lo ≤ hi）+ power = floor 中点（行动经济 条款①期望当量锚）；其余行必须零区间字段。
game/tests/unit/core/board_generator_test.gd
+7 -7
View File
@@ -13,7 +13,7 @@ var _db: ConfigDb
func _init() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:166 棋盘生成（装载组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「验收标准」确定性复现 确定性复现（装载组）
_db = load("res://core/config_db.gd").new() as ConfigDb
if not _db.load_tables("res://data/tables", false):
Kit.check("数值表加载", false)
@@ -40,7 +40,7 @@ func _generate(L: int, D: int, seed0: int) -> BoardData:
func _test_generate_shape_and_mines() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:170 （布雷纪律组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「验收标准」确定性复现 确定性复现（布雷纪律组）
var b := _generate(1, 0, 71000)
if b == null:
Kit.check("生成返回棋盘", false)
@@ -61,7 +61,7 @@ func _test_generate_shape_and_mines() -> void:
# 目标雷数公式单点（d14）：同参同值对拍原式 + 真实产图指标读数同源
func _test_target_mine_count_single_source() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:170 （雷数单源组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「验收标准」确定性复现 确定性复现（雷数单源组）
var bad := 0
var checked := 0
for L in [1, 2, 3]:
@@ -92,7 +92,7 @@ func _test_target_mine_count_single_source() -> void:
func _test_digits_equal_neighbor_mine_count() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:98 （数字恒真组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「出生区安全与反退化布雷：脚下无雷、白给板不出厂」玩家开局站在棋盘上的 玩家开局站在棋盘上的（数字恒真组）
var b := _generate(1, 1, 72000)
if b == null:
Kit.check("生成返回棋盘（数字段）", false)
@@ -113,7 +113,7 @@ func _test_digits_equal_neighbor_mine_count() -> void:
func _test_same_seed_bit_identical() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:168 （同种子逐位复现组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「P1 / P2 后置」后置原因 后置原因（同种子逐位复现组）
var a := _generate(2, 0, 73000)
var b := _generate(2, 0, 73000)
if a == null or b == null:
@@ -124,7 +124,7 @@ func _test_same_seed_bit_identical() -> void:
func _test_clearable_and_inferability_selfconsistent() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:100 （可清图与及格线自洽组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「棋盘生成」棋盘怎么生成 棋盘怎么生成（可清图与及格线自洽组）
var b := _generate(1, 0, 74000)
if b == null:
Kit.check("生成返回棋盘（可推理段）", false)
@@ -140,7 +140,7 @@ func _test_clearable_and_inferability_selfconsistent() -> void:
# ---- V8 出生区边长表单点（架构整改——spawn_edge 表头驱动布雷域基/几何/护栏全导出）----
func _test_spawn_edge_from_table() -> void:
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md:75 （出生区边长读表组）
# 判据出处: design/gdd/systems/排雷循环/棋盘生成.md「出生区安全与反退化布雷：脚下无雷、白给板不出厂」玩家开局站在棋盘上的 玩家开局站在棋盘上的（出生区边长读表组）
# ① 纯函数对拍：edge=5 夹具 → target = round(d×(W×H−25))（25 格布雷域基可观测）
var p5 := {"w": 12, "h": 12, "density": 0.15, "spawn_edge": 5}
Kit.check("V8 纯函数：edge=5 布雷域基 25 格（target=round(d×(144−25))）〔架构整改 V8〕",
game/tests/unit/core/breakpoint_resume_test.gd
+1 -1
View File
@@ -15,7 +15,7 @@ var _bp_path := "user://test_breakpoint_resume.json"
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:180 （断点域契约：七字段往返/续玩确定性/幂等/三结局清除组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」断点域契约 断点域契约（断点域契约：七字段往返/续玩确定性/幂等/三结局清除组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[breakpoint_resume_test] FAIL — 数值表加载失败")
game/tests/unit/core/config_db_cross_validator_test.gd
+4 -4
View File
@@ -13,7 +13,7 @@ const StatusTableScript := preload("res://data/schemas/status_effect_table.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:195 （跨表校验宿主——装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「P1 / P2 后置」后置原因 后置原因（跨表校验宿主——装载组）
_test_all_links_valid()
_test_dangling_skill_id()
_test_cast_side_mismatch()
@@ -47,7 +47,7 @@ func _cats(errs: Array) -> Array[String]:
# ---- 正向：技能池全对齿（普攻恰一行、buff 挂敌方侧）应零错，防校验误伤 ----
func _test_all_links_valid() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:195 （悬空引用类别：跨表链接全有效组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「P1 / P2 后置」后置原因 后置原因（悬空引用类别：跨表链接全有效组）
var skills := _skill([
{"skill_id": "attack", "type": "basic"},
{"skill_id": "raise_morale", "type": "buff", "buff_ref": "st_strong"},
@@ -63,7 +63,7 @@ func _test_all_links_valid() -> void:
# ---- 负向：技能池引用表里不存在的 skill_id 必须报 ----
func _test_dangling_skill_id() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:195 （悬空引用类别：skill_id 悬空组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「P1 / P2 后置」后置原因 后置原因（悬空引用类别：skill_id 悬空组）
var skills := _skill([{"skill_id": "attack", "type": "basic"}])
var enemies := _enemy([
{"level_index": 1, "row_kind": "battle", "depth_band": 0, "enemy_id": "goblin", "pool": [
@@ -76,7 +76,7 @@ func _test_dangling_skill_id() -> void:
# ---- 负向：buff 挂到主角侧状态（side 反向）必须报 ----
func _test_cast_side_mismatch() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:195 （side 反向校验组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「P1 / P2 后置」后置原因 后置原因（side 反向校验组）
var skills := _skill([{"skill_id": "raise_morale", "type": "buff", "buff_ref": "st_hero_side"}])
var enemies := _enemy([
{"level_index": 1, "row_kind": "battle", "depth_band": 0, "enemy_id": "goblin", "pool": [
game/tests/unit/core/config_db_resolver_test.gd
+7 -7
View File
@@ -12,7 +12,7 @@ var _resolver: ConfigDbResolver
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （解析器宿主——装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（解析器宿主——装载组）
_resolver = ResolverScript.new(
func(level, category, message) -> void: # 诊断通道签名按调用实参收（首参为表 id 字符串）
_diags.append("%s/%s/%s" % [str(level), str(category), str(message)]),
@@ -55,7 +55,7 @@ func _difficulty_table():
func _test_band_hit() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （精确命中零警告组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（精确命中零警告组）
var hit: Array = _resolver.resolve_enemy_rowset(1, 4, "battle")
Kit.check("带命中取偏难一侧：请求深度 4 命中带 5（逐字不回带 0）〔fv1〕",
hit.size() == 1 and String((hit[0] as Dictionary).get("enemy_id", "")) == "giant_spider")
@@ -65,7 +65,7 @@ func _test_band_hit() -> void:
func _test_rowset_order_preserved() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （行集寻址与行序保序组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（行集寻址与行序保序组）
var rows: Array = _resolver.resolve_enemy_rowset(1, 0, "battle")
var ids: Array[String] = []
for r in rows:
@@ -75,7 +75,7 @@ func _test_rowset_order_preserved() -> void:
func _test_top_band_clamp() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （超最大行走封顶取最大行组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（超最大行走封顶取最大行组）
_diags.clear()
var rows: Array = _resolver.resolve_enemy_rowset(1, 99, "battle")
Kit.check("越顶带 clamp 取顶带行集（battle 顶带 5）〔fv3〕",
@@ -91,7 +91,7 @@ func _test_top_band_clamp() -> void:
func _test_row_kind_routing() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （行类别路由组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（行类别路由组）
var battle_rows: Array = _resolver.resolve_enemy_rowset(1, 0, "battle")
var boss_rows: Array = _resolver.resolve_enemy_rowset(1, 0, "boss")
Kit.check("行类路由：同请求深度 battle 与 boss 命中不同键域〔fv4〕",
@@ -100,7 +100,7 @@ func _test_row_kind_routing() -> void:
func _test_request_oob() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:203 （越域致命中止组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（越域致命中止组）
_diags.clear()
_resolver.resolve_enemy_rowset(0, 0, "battle")
Kit.check("关卡序号 <1 → fatal request_oob〔fv5〕", _has_fatal_oob())
@@ -120,7 +120,7 @@ func _has_fatal_oob() -> bool:
func _test_difficulty_clamp() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 （难度 clamp 组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（难度 clamp 组）
var m: Dictionary = _resolver.resolve_difficulty_modifiers(1, 0)
Kit.check("难度乘数越域被 clamp：hp 99 → 上限 10", absf(float(m.get("hp_mult", 0.0)) - 10.0) < 0.001)
Kit.check("难度乘数越域被 clamp：atk 0.01 → 下限 0.1", absf(float(m.get("atk_mult", 0.0)) - 0.1) < 0.001)
game/tests/unit/core/curio_refresh_paid_test.gd
+1 -1
View File
@@ -8,7 +8,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「定位与形态」 （CurioDeck：三选一/商店共享池、抽签、cap 库存——刷新付费组）
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「定位与形态」现行形态 现行形态（CurioDeck：三选一/商店共享池、抽签、cap 库存——刷新付费组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[curio_refresh_paid_test] FAIL — 数值表加载失败")
game/tests/unit/core/effect_words_t1_test.gd
+1 -1
View File
@@ -11,7 +11,7 @@ const EffectEngineScript = preload("res://core/effect_engine.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「扩签登记」 （效果词表封闭——扩签封闭性组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「扩签登记」落地结果 落地结果（效果词表封闭——扩签封闭性组）
# ① 词表在册断言（扩签面：2 事件+8 事实+7 效果类型+1 算子）
Kit.check_quiet(EffectEngineScript.EVENTS.has("dig_stop") and EffectEngineScript.EVENTS.has("battle_won"),
"新事件在册：dig_stop/battle_won〔专长批 V1〕")
game/tests/unit/core/encapsulation_p2_sweep_test.gd
+6 -6
View File
@@ -11,34 +11,34 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （封装边界：跨对象往来只走公开方法与属性——P2 词表单点扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」封装边界 封装边界（封装边界：跨对象往来只走公开方法与属性——P2 词表单点扫描组）
_sweep_generator()
_sweep_production_face()
quit(Kit.finish("encapsulation_p2_sweep_test"))
func _src(path: String) -> String:
# 判据出处: design/engineering/code-conventions.md:41 （源码采样组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（源码采样组）
var src := FileAccess.get_file_as_string(path)
Kit.check("扫描面非空前置：%s" % path, src.length() > 0)
return src
func _zero(pattern: String, src: String, label: String) -> void:
# 判据出处: design/engineering/code-conventions.md:41 （零命中扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（零命中扫描组）
var re := RegEx.create_from_string(pattern)
Kit.check("%s：%s 零命中〔架构P2〕" % [label, pattern], re.search(src) == null)
func _anchor(pattern: String, src: String, label: String) -> void:
# 判据出处: design/engineering/code-conventions.md:41 （正锚存在组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（正锚存在组）
var re := RegEx.create_from_string(pattern)
Kit.check("%s：%s 正锚在案〔架构P2〕" % [label, pattern], re.search(src) != null)
# ① V1 生成器词表定义删除与改指
func _sweep_generator() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （生成器本地副本归零组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（生成器本地副本归零组）
var src := _src("res://core/node_map_generator.gd")
if src.length() == 0:
return
@@ -48,7 +48,7 @@ func _sweep_generator() -> void:
# ② V2 生产三目录定义唯一性（递归扫 .gd，恰好 1 处且落 level_table.gd）
func _sweep_production_face() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （schema 唯一定点组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（schema 唯一定点组）
var files: Array[String] = []
for dir_path in ["res://core", "res://data", "res://presentation"]:
_collect_gd(dir_path, files)
game/tests/unit/core/encapsulation_sweep_test.gd
+10 -10
View File
@@ -14,7 +14,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （封装边界——五处结构性零命中扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」封装边界 封装边界（封装边界——五处结构性零命中扫描组）
_sweep_settlement_segments()
_sweep_orchestrator_methods()
_sweep_breakpoint_pair()
@@ -26,7 +26,7 @@ func _init() -> void:
# 源文件读取＋非空前置（返 "" 即已判红——调用侧跳过后续正则断言）
func _src(path: String) -> String:
# 判据出处: design/engineering/code-conventions.md:41 （源码采样组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（源码采样组）
var src := FileAccess.get_file_as_string(path)
Kit.check("扫描面非空前置：%s" % path, src.length() > 0)
return src
@@ -34,21 +34,21 @@ func _src(path: String) -> String:
# 正则零命中断言（-pattern 意图写入断言文案——可 grep 定位）
func _zero(pattern: String, src: String, label: String, path: String) -> void:
# 判据出处: design/engineering/code-conventions.md:41 （零命中扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（零命中扫描组）
var re := RegEx.create_from_string(pattern)
Kit.check("%s：%s 零命中〔封装5.1〕" % [label, pattern], re.search(src) == null)
# 正锚在案断言（正则命中 ≥1——新公开面/新形态在用）
func _anchor(pattern: String, src: String, label: String, path: String) -> void:
# 判据出处: design/engineering/code-conventions.md:41 （正锚存在组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（正锚存在组）
var re := RegEx.create_from_string(pattern)
Kit.check("%s：%s 正锚在案〔封装5.1〕" % [label, pattern], re.search(src) != null)
# ① V2 settlement 七文件（束注入换代——对编排器引用归零）
func _sweep_settlement_segments() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （结算段封装扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（结算段封装扫描组）
var classes := {
"res://core/settlement/grant_segment.gd": "GrantSegment",
"res://core/settlement/combat_segment.gd": "CombatSegment",
@@ -68,7 +68,7 @@ func _sweep_settlement_segments() -> void:
# ② V3 编排器搬家五方法零残留
func _sweep_orchestrator_methods() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （编排器方法面扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（编排器方法面扫描组）
var src := _src("res://core/battle_orchestrator.gd")
if src.length() == 0:
return
@@ -78,7 +78,7 @@ func _sweep_orchestrator_methods() -> void:
# ③ V4 断点域（adventure_runner → BreakpointStore 公开面）
func _sweep_breakpoint_pair() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （断点对封装扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（断点对封装扫描组）
var src := _src("res://core/adventure_runner.gd")
if src.length() == 0:
return
@@ -88,7 +88,7 @@ func _sweep_breakpoint_pair() -> void:
# ④ V5 存档双向公开面（save_manager↔slot_store）
func _sweep_save_pair() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （存档对封装扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（存档对封装扫描组）
var src_m := _src("res://core/save_manager.gd")
if src_m.length() > 0:
_zero("slots\\._", src_m, "save_manager 对槽位件私取归零", "res://core/save_manager.gd")
@@ -102,7 +102,7 @@ func _sweep_save_pair() -> void:
# ⑤ V6 效果宿主累积面（grant → BattleFxHost 公开累积方法）
func _sweep_fx_host_accumulators() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （特效宿主累积面扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（特效宿主累积面扫描组）
var src := _src("res://core/settlement/grant_segment.gd")
if src.length() == 0:
return
@@ -112,7 +112,7 @@ func _sweep_fx_host_accumulators() -> void:
# ⑥ V7 配置挂载面（config_db → 三 schema bind_resolver）
func _sweep_config_resolver() -> void:
# 判据出处: design/engineering/code-conventions.md:41 （配置挂载面扫描组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（配置挂载面扫描组）
var src := _src("res://core/config_db.gd")
if src.length() == 0:
return
game/tests/unit/core/feat_vouchers_test.gd
+1 -1
View File
@@ -16,7 +16,7 @@ func EffectEngineKindProbe(_db) -> bool:
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md:465 （奇物凭证五件与留任二件组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「验收标准」三个分类走同一套获取流程 三个分类走同一套获取流程（奇物凭证五件与留任二件组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[feat_vouchers_test] FAIL — 数值表加载失败")
game/tests/unit/core/hero_ledger_test.gd
+1 -1
View File
@@ -14,7 +14,7 @@ const LevelRunnerScript := preload("res://core/level_runner.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:288 （生命一致性：三写入口封顶 [0,生效上限]——主角账组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「验收标准」生命一致性 生命一致性（生命一致性：三写入口封顶 [0,生效上限]——主角账组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[hero_ledger_test] FAIL — 数值表加载失败")
game/tests/unit/core/level_map_type_vis_test.gd
+9 -9
View File
@@ -10,7 +10,7 @@ const LevelTableScript := preload("res://data/schemas/level_table.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （信息迷雾类型可见性宿主——装载组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（信息迷雾类型可见性宿主——装载组）
var db = load("res://core/config_db.gd").new()
var loaded: bool = db.load_tables("res://data/tables", false)
Kit.check_quiet(loaded, "可见性用例：数值表加载成功")
@@ -103,7 +103,7 @@ func _runner(db, nodes: Array, anchor_id: int, candidates: Array, n: int = 2):
# ---- ⑥ N 进数据表（含越域校验）〔fv6〕----
func _test_field_in_table(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （迷雾参数读表——字段在表组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（迷雾参数读表——字段在表组）
var n_in_table: int = int(db.run.level.info_visible_layers)
Kit.check("N 落表：level.tres 读数 2（实际 %d）〔fv6〕" % n_in_table, n_in_table == 2)
var t := LevelTableScript.new()
@@ -127,7 +127,7 @@ func _has_n_domain_err(errs: Array) -> bool:
# ---- ① 邻近 N 层见类型（层距边界）〔fv1〕----
func _test_layer_distance(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （层距 N 可见性组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（层距 N 可见性组）
var nodes := _graph_nodes()
var r = _runner(db, nodes, 1, [nodes[2]]) # 锚 = 节点 1（层 1），候选 = 节点 2
var vis: Array = r.type_visible_ids()
@@ -139,7 +139,7 @@ func _test_layer_distance(db) -> void:
# ---- ② 下一跳恒可见（跨层跳边候选）〔fv4〕----
func _test_candidate_exempt(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （候选豁免组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（候选豁免组）
var nodes := _graph_nodes()
var r = _runner(db, nodes, 6, [nodes[3]]) # 锚 = 节点 6（层 5），候选 = 节点 3（层 2，层距 3）
var vis: Array = r.type_visible_ids()
@@ -150,7 +150,7 @@ func _test_candidate_exempt(db) -> void:
# ---- ③ Boss/终点不入雾＋⑤ 入口停点锚层 0〔fv3〕〔fv1〕----
func _test_boss_exempt(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （Boss 豁免组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」Boss Boss（Boss 豁免组）
var nodes := _graph_nodes()
var r = _runner(db, nodes, -1, [nodes[0]]) # 入口停点（无当前节点，锚层 0）
var vis: Array = r.type_visible_ids()
@@ -163,7 +163,7 @@ func _test_boss_exempt(db) -> void:
# ---- ④ 单圈回雾（visited 不豁免）〔fv7〕----
func _test_single_circle(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （单圈可见组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（单圈可见组）
var nodes := _graph_nodes()
var r = _runner(db, nodes, 6, [nodes[7], nodes[3]])
r.visited.assign([nodes[0], nodes[1], nodes[2], nodes[3], nodes[4], nodes[5], nodes[6]])
@@ -176,7 +176,7 @@ func _test_single_circle(db) -> void:
# ---- ⑤ 单链退化形态（出度 ≤1 图，编号 = id 句柄）〔fv1〕----
func _test_single_chain_entry(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （单链入口组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（单链入口组）
var nodes := _chain_nodes()
var r = _runner(db, nodes, -1, [nodes[0]])
var vis: Array = r.type_visible_ids()
@@ -189,7 +189,7 @@ func _test_single_chain_entry(db) -> void:
# ---- ⑥ N 读表：可见窗随表值随动〔fv6〕----
func _test_n_from_table(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:176 （N 读表组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（N 读表组）
var nodes := _graph_nodes()
var r = _runner(db, nodes, 1, [nodes[2]]) # 锚层 1
db.run.level.info_visible_layers = 1
@@ -207,7 +207,7 @@ func _test_n_from_table(db) -> void:
# ---- ⑦ 续玩重建同值〔fv7〕----
func _test_resume_rebuild(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var t := LevelTableScript.new()
t.info_visible_layers = 2
t.rows = [{"level_index": 1, "display_name": "夹具关", "rest_heal_pct": 30}]
game/tests/unit/core/level_shop_economy_test.gd
+14 -14
View File
@@ -232,7 +232,7 @@ func _board_row_exact(level_index: int, depth: int) -> bool:
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -262,7 +262,7 @@ func _init() -> void:
# ---- 数值入表等价证明（d11/d16a——原字面量迁移：表值 == 迁移前字面量，消费端读表）----
func _smoke_table_migration() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:195 （行集纪律——表迁移组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「P1 / P2 后置」后置原因 后置原因（行集纪律——表迁移组）
print("--- 数值入表（shop 两 knob + hero 显示名 · 原值迁移）---")
Kit.check("shop.relic_base_price 表值 == 迁移前字面量（15.0）〔wd11〕", _db.run.shop.relic_base_price == 15.0)
Kit.check("hero.display_name 表值 == 迁移前字面量（探险者）〔wd16〕", _db.combat.hero.display_name == "探险者")
@@ -277,7 +277,7 @@ func _smoke_table_migration() -> void:
# 敌侧/板侧解析一律走 ConfigDB 真实消费链，禁直读行集自算）----
func _smoke_generated_coverage() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:184 （每终点前恰一店——生成覆盖扫描组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（每终点前恰一店——生成覆盖扫描组）
var enemy_ok := true
var board_ok := true
var boss_band_ok := true
@@ -328,7 +328,7 @@ func _smoke_generated_coverage() -> void:
# ---- 关卡节点图·生成图推进冒烟（图 = 该关参数档 × 种子）----
func _smoke_level() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （关卡图校验推进组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（关卡图校验推进组）
print("--- 关卡节点图·生成图推进（参数档×种子产图·满配冒险成功/恢复公式/败北线/回放确定性）---")
var autoplay = load("res://sim/level_autoplay.gd")
var hero_base := {"atk": int(_db.combat.hero.atk), "hp": int(_db.combat.hero.max_hp), "ac": int(_db.combat.hero.armor_class)} # 配置基线快照——⑤ 回基线对比用（改表自动跟随，不再硬编码）
@@ -442,7 +442,7 @@ func _drive_to_rest(level_index: int, seed_val: int, gap: int) -> Dictionary:
# ---- 分支节点图冒烟：图合法性校验 + L2 幽暗地域生成图行进（图 = 参数档 × 种子）----
func _smoke_level_graph() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （图结构与行进纪律组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（图结构与行进纪律组）
print("--- 关卡节点图·分支节点图（L2 幽暗地域·生成图）---")
var autoplay = load("res://sim/level_autoplay.gd")
# ① 关卡表行级校验零错误（关卡表只承载序号/显示名/恢复比例——图合法性由 validate_graph 在起关时承担）
@@ -801,7 +801,7 @@ func _fresh_rng(seed_val: int):
# ---- ① GP 冒险钱包·到账 ----
func _smoke_gp_wallet() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:233 （GP 钱包入账组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」每格必有货 每格必有货（GP 钱包入账组）
print("--- GP 冒险钱包·到账（战斗完成入账恰一次 + Boss 加值）---")
var autoplay = load("res://sim/level_autoplay.gd")
# ① L1 首战（普通战档——掷定 [2,4] + 关级加值 0）：runner 驱动，收集 battle_finished 与钱包事件
@@ -867,7 +867,7 @@ func _escrow_sum_of(rows: Array) -> int:
# ---- ② escrow 隔离（GP安全格兑付 / 破财直验 / 钱包 clamp）----
func _smoke_gp_escrow() -> void:
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md:233 （GP escrow 组）
# 判据出处: design/gdd/systems/战斗循环/地图战斗资源.md「验收标准」每格必有货 每格必有货（GP escrow 组）
print("--- GP escrow 隔离（GP安全格兑付入缓冲 · 破财不透支）---")
# ① 种子扫描：找GP 袋（gp 型安全格）可挖掘局——挖开兑付 +3 入 escrow，战斗末随 gp_dropped 一次上抛
var scan := {}
@@ -981,7 +981,7 @@ func _find_gp_dig(minesweeper, settlement) -> Dictionary:
# ---- ③ 商店房三收口 ----
func _smoke_shop_room() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:184 （商店房呈现组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（商店房呈现组）
print("--- 商店房三收口（现价/加算区/余额不足拒/离开回选路/收束清零）---")
var autoplay = load("res://sim/level_autoplay.gd")
# 行进到商店房（按图型别定位商店节点——候选取最小句柄行进，到达即停）：
@@ -1115,7 +1115,7 @@ func _shop_products_by_id(prods: Array) -> Dictionary:
# ---- ④ 商店编排性质（生成图扫描面——三条性质 + 终点跨表解析）----
func _smoke_shop_graph() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:184 （必经恰一店图纪律组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（必经恰一店图纪律组）
print("--- 商店编排性质（每终点前一位恰一店 · 店数＝终点数 · 全路径恰穿一店）---")
var pred_bad := 0
var term_total := 0
@@ -1186,7 +1186,7 @@ func _smoke_shop_graph() -> void:
# ---- ⑥ 大岔口分区域兑付（V3——多终点图走哪条路决定打谁，任一 Boss 胜即收束恰一次）----
func _smoke_multi_terminal_settlement() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:185 （多终局收束组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（多终局收束组）
print("--- 大岔口分区域兑付（L2 两轴各打各的终点）---")
var autoplay = load("res://sim/level_autoplay.gd")
var nodes: Array = _generated_graph(2, 42).get("nodes", [])
@@ -1254,7 +1254,7 @@ func _paths_all_one_shop(nodes: Array) -> bool:
# ---- ⑤ 商店共享池（三选一同构/乘法价/跨渠道共账/切边/断点扩键）----
func _smoke_shop_pool() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「共享池账本」 （商店共享池组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「GP：战斗掉落的局内钱包与统一冒险加算区」是冒险内的一次性属性提升货币 是冒险内的一次性属性提升货币（商店共享池组）
print("--- 商店共享池（抽3买1全重抽 · 乘法定价 ceil · 池空硬闸 · 切边零入店）---")
var autoplay = load("res://sim/level_autoplay.gd")
var shelf_kinds: Array = []
@@ -1417,7 +1417,7 @@ func _smoke_shop_pool() -> void:
# ---- 商店房 node_entered 载荷（尾波 V1——_enter_node pool/legacy 双发射路径归一后的行为保持断言）----
func _test_shop_node_entered_payload() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:184 （行进至此打开商店覆盖层——载荷组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行进至此打开商店覆盖层 行进至此打开商店覆盖层（行进至此打开商店覆盖层——载荷组）
print("--- 商店房 node_entered 载荷（pool 含 shelf:true＋gp 现值／legacy 无 shelf 键）---")
var autoplay = load("res://sim/level_autoplay.gd")
# pool 态：载荷字典经信号闭包当场取样（字典为引用累积器——lambda 按值捕获标量的绕行惯例）
@@ -1576,7 +1576,7 @@ func _has_err_category(errs: Array, category: String) -> bool:
# ---- 货架位数读表（架构整改——shelf_size 表头单点：进店与重抽同源）----
func _test_shelf_size_from_table() -> void:
# 判据出处: design/ux/shop.md:13 （货架位数读表组）
# 判据出处: design/ux/shop.md「布局与交互」模态覆盖层 模态覆盖层（货架位数读表组）
var autoplay = load("res://sim/level_autoplay.gd")
var st = _db.run.shop
var saved: int = int(st.shelf_size)
@@ -1598,7 +1598,7 @@ func _test_shelf_size_from_table() -> void:
# ---- 散折价收回规则键（架构整改 R2——shop.spend_discount 表字段退役，折价读 economy_spend.discount_pct）----
func _test_spend_discount_from_rule_key() -> void:
# 判据出处: design/gdd/systems/排雷循环/行动经济.md:256 （换图基座：挖格产 RAP 与刷新折扣组）
# 判据出处: design/gdd/systems/排雷循环/行动经济.md「P0 最小闭环」战斗结算发开轮通知 战斗结算发开轮通知（换图基座：挖格产 RAP 与刷新折扣组）
# 字段真删：shop.tres 加载零诊断 + spend_discount 属性不在位
Kit.check("shop.tres 加载零诊断（spend_discount 字段真删——schema 与表行同卸）〔架构整改 V2〕",
_db.diagnostics_count("error") == 0 and _db.run.shop.get("spend_discount") == null)
game/tests/unit/core/level_table_validate_test.gd
+4 -4
View File
@@ -11,7 +11,7 @@ const LevelTableScript := preload("res://data/schemas/level_table.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （关卡表消费侧校验宿主）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（关卡表消费侧校验宿主）
_test_positive()
_test_negative()
_test_scope_not_extended()
@@ -38,7 +38,7 @@ func _has(errs: Array, cat: String, needle: String = "") -> bool:
# ---- 正例（四检全过）----
func _test_positive() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （良构基底正向组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（良构基底正向组）
# 多入口多终点：两入口共汇入一岔口，两终点各在互异深度
var multi := [
_n(0, "battle", 0, [2]), _n(1, "battle", 0, [2]),
@@ -61,7 +61,7 @@ func _test_positive() -> void:
# ---- 负例九类（各报对应类别与判据消息）----
func _test_negative() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （违规配置加载期致命——负向组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」违规配置加载期致命 违规配置加载期致命（违规配置加载期致命——负向组）
var non_boss_end := [_n(0, "battle", 0, [1]), _n(1, "battle", 1, [])]
Kit.check("负例：终点非 Boss 命中「终点恒为 Boss」〔v1〕",
_has(_errs(non_boss_end), "structural", "终点 1 非 Boss"))
@@ -95,7 +95,7 @@ func _test_negative() -> void:
# ---- 「勿扩勿缩」反证：本检不含商店位与个数对参数档的核对 ----
func _test_scope_not_extended() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （校验范围不外扩组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（校验范围不外扩组）
# 合法形状但全程无商店／三个终点同入口图——四检不该因此报错（商店位归冒烟断言、个数归产出侧）
var no_shop := [_n(0, "battle", 0, [1, 2]), _n(1, "battle", 1, [3]), _n(2, "rest", 1, [3]), _n(3, "boss", 2, [])]
Kit.check("范围反证：无商店图不在加载校验内报错（商店位由冒烟断言把关）〔v1〕", _errs(no_shop).is_empty())
game/tests/unit/core/meta_progression_forge_test.gd
+15 -15
View File
@@ -21,7 +21,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/元进度.md:148 元进度与锻造宿主（装载组）
# 判据出处: design/gdd/systems/跨局循环/元进度.md「验收标准」钥石不丢 钥石不丢（装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -139,7 +139,7 @@ func _auto_play_round(settlement, out: Dictionary) -> void:
# ---- 元进度 ②树购买面（购买受理/持久/余额不足拒绝/未知节点拒绝；
# 行价=表值 flat 单价）----
func _meta_pricing_and_buy() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:198 （单币可判：购买只扣钥石、余额不足拒绝零变化组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」单币可判 单币可判（单币可判：购买只扣钥石、余额不足拒绝零变化组）
print("--- 元进度·树购买面（隔离档 smoke_meta_buy/dry）---")
_meta_smoke_cleanup()
var sv = _meta_new_save(_META_SMOKE_PATHS[0])
@@ -166,7 +166,7 @@ func _meta_pricing_and_buy() -> void:
# ---- 元进度 ⑥Boss 两档 ⑦钥石不丢 ⑧工坊解锁 ⑩摘要副本与 cap（合成摘要驱动——settle 纯账面零跑局）----
func _meta_settle_and_workshop() -> void:
# 判据出处: design/gdd/systems/跨局循环/元进度.md:150 （钥石收束入账不丢组）
# 判据出处: design/gdd/systems/跨局循环/元进度.md「验收标准」钥石不丢 钥石不丢（钥石收束入账不丢组）
print("--- 元进度·收束入账与工坊（隔离档 smoke_meta_settle/workshop/cap）---")
var sv = _meta_new_save(_META_SMOKE_PATHS[2])
var mp = load("res://core/meta_progression.gd").new(_db, sv)
@@ -359,7 +359,7 @@ func _meta_settle_and_workshop() -> void:
# ---- 元进度 ④注入可见 + 白板成立（验收 4/2/3——程序面；MC 逐位回归归 T7 全量验证）----
func _meta_injection() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:201 （注入可判：开局覆盖值分层可加组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」注入可判 注入可判（注入可判：开局覆盖值分层可加组）
print("--- 元进度·注入可见与白板（隔离档 smoke_meta_white/dry）---")
var sv = _meta_new_save(_META_SMOKE_PATHS[1])
var mp = load("res://core/meta_progression.gd").new(_db, sv)
@@ -403,7 +403,7 @@ func _meta_injection() -> void:
# ---- 锻造工坊·两根类型轴所有权移交（V5 前半：hero.tres 两轴删除+锻造配置默认值）----
# 后半（build_adventure_params 注入默认值/选中覆盖）随 T4 注入接线同批断言；写口/解锁面归 T3。
func _smoke_forge_axes() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:220 （锻造两轴单选注入与树零攻防组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」本节判据全部绑结构与关系 本节判据全部绑结构与关系（锻造两轴单选注入与树零攻防组）
print("--- 锻造工坊·类型轴所有权移交（T2）---")
# V5：hero.tres 静态表两轴已删（全表加载零违例——config_db_test 同款闸；此处钉字段不在位）
Kit.check("hero.tres 无 attack_type/armor_type 字段（契约 2——静态表两轴删除）〔锻造工坊批 V5〕",
@@ -566,7 +566,7 @@ func _smoke_forge_axes() -> void:
# ---- 天赋树冒烟（v0.8 12 节点：schema/购买面/Fork 一节点双态/彩蛋特化）----
func _smoke_tree() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:194 （天赋树购买与六键合成组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（天赋树购买与六键合成组）
print("--- 天赋树（12 节点 · 购买面 · Fork 双态 · 彩蛋觉醒）---")
# 〔V1〕结构：12 行 + schema 零违例
Kit.check("meta_tree 已加载（12 节点=脊柱 2〔生命/命中淬炼一线一节点 cap4〕+锻造 2〔钥匙+彩蛋——彩蛋含在锻造 2 内非第 13 行〕+钥石 2〔秘宝匣/刷新升级〕+同调 6〔socket 3+Fork 3 双态〕——v0.8 终态）〔天赋树批 V1〕",
@@ -649,7 +649,7 @@ func _smoke_tree() -> void:
# ---- 天赋树六键行为冒烟（V10：开局姿态窗/危险直觉限次/财富之道聚散/守侧失误补偿；
# 引擎直构 + 编排授予段直注（_grant_seg._judge_seal=结算授予段封印判定单口））----
func _smoke_tree_rules() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:194 （规则键参数读表组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（规则键参数读表组）
print("--- 天赋树六键行为（V10：窗/限次/聚散/守侧）---")
# 开局姿态组：每关首轮窗（battle_index 事实——引擎直构 + 自建 ctx）
var fx = load("res://core/effect_engine.gd").new(null)
@@ -790,7 +790,7 @@ func _smoke_tree_rules() -> void:
# ---- 锻造契约补齐（断言补齐批——⑥锻造工坊）：拒购零副作用/祝福件零泄漏/默认值解耦/甲型双轴 ----
func _test_forge_buy_reject() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:222 （钥石不足购买被拒、余额与等级零变化组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」本节判据全部绑结构与关系 本节判据全部绑结构与关系（钥石不足购买被拒、余额与等级零变化组）
var sv = _meta_new_save("user://smoke_meta_reject.json")
var mp = load("res://core/meta_progression.gd").new(_db, sv)
sv.meta_state._add_keystone(10) # 低于首购价 20——余额不足面
@@ -805,7 +805,7 @@ func _test_forge_buy_reject() -> void:
func _test_blessing_no_forge_leak() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:220 （树淬炼对攻击与 AC 零贡献组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」树淬炼对攻击与 树淬炼对攻击与（树淬炼对攻击与 AC 零贡献组）
var sv = _meta_new_save("user://smoke_meta_blessing.json")
var mp = load("res://core/meta_progression.gd").new(_db, sv)
var fs0: Dictionary = sv.meta_state.forge_state().duplicate(true)
@@ -824,7 +824,7 @@ func _test_blessing_no_forge_leak() -> void:
func _test_default_axes_pre_key() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:217 （未点亮期间默认值照常注入组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」本节判据全部绑结构与关系 本节判据全部绑结构与关系（未点亮期间默认值照常注入组）
var sv = _meta_new_save("user://smoke_meta_axesw.json")
var mp = load("res://core/meta_progression.gd").new(_db, sv)
var ax: Dictionary = mp.hero_type_axes()
@@ -833,7 +833,7 @@ func _test_default_axes_pre_key() -> void:
func _test_armor_switch_dual_axes() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:221 （换装不丢级不生效——双轴组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」换装不丢级不生效 换装不丢级不生效（换装不丢级不生效——双轴组）
var sv = _meta_new_save("user://smoke_meta_axesw.json")
sv.meta_state._add_keystone(1000)
var mp = load("res://core/meta_progression.gd").new(_db, sv)
@@ -863,7 +863,7 @@ func _test_armor_switch_dual_axes() -> void:
# ---- G5 天赋树行与投影断言（迭代 55「QA覆盖余量收口批」T5——ks_workshop／ks_refresh／fork 两行／侧投影＋spine 读行）----
func _check_ks_workshop_row() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:30 （钥匙门行——前置/零价/柜台展开）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「系统范围」边界这样划 边界这样划（钥匙门行——前置/零价/柜台展开）
var row: Dictionary = _db.crossrun.meta_tree.row_by_id("ks_workshop")
Kit.check("ks_workshop 行值：keystone 脉络 unlock 行且前置=[sp_hp]（脊柱生命第 1 级）〔QA余 V7〕",
String(row.get("vein", "")) == "keystone" and String(row.get("kind", "")) == "unlock"
@@ -892,7 +892,7 @@ func _ks_row_level(mp, node_id: String) -> int:
func _check_ks_refresh_row() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:30 （刷新升级行——同账路由与零刷新分支）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「系统范围」边界这样划 边界这样划（刷新升级行——同账路由与零刷新分支）
var row: Dictionary = _db.crossrun.meta_tree.row_by_id("ks_refresh")
Kit.check("ks_refresh 行值：rule 行 keystone 币 price=30 cap=2 前置=[ks_workshop]〔QA余 V7〕",
String(row.get("kind", "")) == "rule" and String(row.get("currency", "")) == "keystone"
@@ -915,7 +915,7 @@ func _check_ks_refresh_row() -> void:
func _check_fork_rows() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:30 （fork 一节点双态行——行值经购买面驱动）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「系统范围」fork fork（fork 一节点双态行——行值经购买面驱动）
for spec in [{"id": "fork_sense", "group": "fg_sense", "na": "锋", "nb": "守"},
{"id": "fork_economy", "group": "fg_economy", "na": "聚", "nb": "散"}]:
var row: Dictionary = _db.crossrun.meta_tree.row_by_id(String(spec["id"]))
@@ -941,7 +941,7 @@ func _check_fork_rows() -> void:
func _check_fork_side_projection() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:30 （组侧投影与脉络行板——真实表行读出）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「系统范围」边界这样划 边界这样划（组侧投影与脉络行板——真实表行读出）
var sv = _meta_new_save("user://smoke_meta_fork_side.json")
var mp = load("res://core/meta_progression.gd").new(_db, sv)
sv.meta_state._add_keystone(1000)
game/tests/unit/core/minesweeper_rules_test.gd
+11 -11
View File
@@ -17,7 +17,7 @@ var _ae: ActionEconomy
func _init() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:224 （排雷规则宿主——装载组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（排雷规则宿主——装载组）
_db = load("res://core/config_db.gd").new() as ConfigDb
if not _db.load_tables("res://data/tables", false):
Kit.check("数值表加载", false)
@@ -50,7 +50,7 @@ func _init() -> void:
func _test_install_invariants() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:228 （装板四不变式组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「挖开空地整片塌开：数字提示与连锁展开」每个已开安全格都亮着一个数字 每个已开安全格都亮着一个数字（装板四不变式组）
_rules.install_board(_board)
Kit.check("装板后 current_board 即所装棋盘", _rules.current_board() == _board)
var opened: int = _rules.revealed_cells().size()
@@ -74,7 +74,7 @@ func _unrevealed_safe() -> Vector2i:
func _test_dig_face_rules() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 （挖/封印合法性与可辨拒绝组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「调参表」本系统无自有参数 本系统无自有参数（挖/封印合法性与可辨拒绝组）
var revealed_first = _rules.revealed_cells()[0] as Vector2i
var out: Array = _rules.settle_batch([{"action": "dig", "cell": revealed_first}])
var o: Dictionary = (out[0] as Dictionary) if not out.is_empty() else {}
@@ -89,7 +89,7 @@ func _test_dig_face_rules() -> void:
func _test_reveal_advances() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:230 （揭示推进与连锁组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（揭示推进与连锁组）
var c := _unrevealed_safe()
if c == Vector2i(-1, -1):
Kit.check("存在未揭示安全格（揭示推进前置）", false)
@@ -103,7 +103,7 @@ func _test_reveal_advances() -> void:
func _test_seal_place() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:231 （重复封印拒绝组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「调参表」本系统无自有参数 本系统无自有参数（重复封印拒绝组）
var c := _unrevealed_safe()
if c == Vector2i(-1, -1):
Kit.check("存在未揭示安全格（封印前置）", false)
@@ -116,7 +116,7 @@ func _test_seal_place() -> void:
func _test_reject_out_of_catalog() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:236 （目录外拒绝组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「验收标准」每条都可单独验证 每条都可单独验证（目录外拒绝组）
var out: Array = _rules.settle_batch([{"action": "not_a_real_action", "cell": Vector2i(0, 0)}])
var o: Dictionary = (out[0] as Dictionary) if not out.is_empty() else {}
Kit.check("目录外意图被拒（不静默吞掉）——实际载荷 %s" % str(o).substr(0, 80),
@@ -126,7 +126,7 @@ func _test_reject_out_of_catalog() -> void:
# ---- V14 棋盘揭示预览只读口（架构整改——preview_reveal 与实挖揭示集同口径、零状态写入零事件）----
func _test_preview_reveal_readonly() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「核心规则」 （preview_reveal 只读预览口——零写入零事件组）
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「核心规则」玩家对棋盘只做三件事 玩家对棋盘只做三件事（preview_reveal 只读预览口——零写入零事件组）
var events := 0
_rules.cell_revealed.connect(func(_evt): events += 1) # 零发射哨兵（preview 全程不触发揭示事件）
# 形态 A：封印在场——preview(未开格) 不越封印且零状态写入
@@ -199,7 +199,7 @@ func _unrevealed_unsealed_safe() -> Vector2i:
# V1 封印受理即揭示：身份当场可查（sealed_identity 与板事实逐位一致）、受理零事件零兑付
func _test_seal_reveal_identity() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:52 封印受理那一刻身份当场可见、受理当场零兑付零事件
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「挖、封印、移动：每个动作怎么才算合法」玩家对棋盘只做三件事 玩家对棋盘只做三件事、受理当场零兑付零事件
_ae.grant_ap(20)
_rules.seal_range_free = true
var safe_c := _unrevealed_unsealed_safe()
@@ -232,7 +232,7 @@ func _test_seal_reveal_identity() -> void:
# V2 挖已封印格被拒：原因可辨 target_sealed、封印/揭示/AP 三态零变化
func _test_dig_sealed_rejected() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:56 动作合法性表——挖的拒绝情形含已封印
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「挖、封印、移动：每个动作怎么才算合法」玩家对棋盘只做三件事 玩家对棋盘只做三件事
var sealed_c := Vector2i(-1, -1)
for c in _board.all_cells():
if _rules.has_seal(c) and not _rules.is_revealed(c):
@@ -253,7 +253,7 @@ func _test_dig_sealed_rejected() -> void:
# V3 清图口径换代：封印可完成清图（封掉最后安全格→cleared 收束）；非末封印不清图
func _test_clear_by_seal() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:139 清图=全部安全格完成，完成=挖开或封印
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「封印立得住、也带不走：封印印记的生命周期与换图重置」挖开或封印 挖开或封印，完成=挖开或封印
_ae.grant_ap(20)
_rules.seal_range_free = true
# 阶段 a：封一张非末安全格 → clear_map_cleared 仍 false（封印计入完成但未清完）
@@ -290,7 +290,7 @@ func _test_clear_by_seal() -> void:
# V4 批次语义序：同批「停手 + 能清图的封」提交 → 赢家=清图收束而非停手
func _test_classify_seal_clears() -> void:
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md:167 最先=能清图的挖或封——防耗尽优先把清图高光结算成最差结局
# 判据出处: design/gdd/systems/排雷循环/排雷玩法.md「一帧一个意图、对外只有三种事件：批次仲裁与事件面」玩家每帧只提交一个意图 玩家每帧只提交一个意图
# 收敛未完成格到恰 1 格（封它即清图；fx_reveal 连锁不可控——逐格揭至剩 1，连锁越格则换种子重试）
var left: Array = []
var last_c := Vector2i(-1, -1)
game/tests/unit/core/node_map_generator_test.gd
+11 -11
View File
@@ -16,7 +16,7 @@ var _gen
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_db = ConfigDBScript.new()
var load_ok: bool = _db.load_tables("res://data/tables", true)
if not load_ok:
@@ -78,7 +78,7 @@ func _max_depth(g: Dictionary) -> int:
# ---- V1 产出合格：三档×种子扫描，自证零错误 ----
func _test_output_ok() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:129 （产出约束六条＋结构铁律组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出约束六条 产出约束六条（产出约束六条＋结构铁律组）
var all_ok := true
var entry_exit_ok := true
for L in [1, 2, 3]:
@@ -96,7 +96,7 @@ func _test_output_ok() -> void:
# ---- V3 可复现：纯函数＋counter 无关 ----
func _test_reproducible() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:134 （同种子同参数同图组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」合法图是一张岔路发散式道路系统 合法图是一张岔路发散式道路系统（同种子同参数同图组）
var same := true
for L in [1, 2, 3]:
if _sig(_graph(L, 42)) != _sig(_graph(L, 42)):
@@ -127,7 +127,7 @@ func _test_reproducible() -> void:
# ---- V5 岔路取舍两条 ----
func _test_fork_rules() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:88 （岔路取舍组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「节点类型配比：类型分布怎么掷、内容归谁」配比是生成旋钮 配比是生成旋钮（岔路取舍组）
var next_hop_ok := true
var comp_ok := true
for L in [1, 2, 3]:
@@ -203,7 +203,7 @@ func _branch_types(g: Dictionary, head_id: int, sibling_outs: Array) -> Array:
# ---- V6 必经恰一店＋归属锁定＋多终点深度互异 ----
func _test_shop_and_attribution() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:48 （必经恰一店与归属锁定组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」合法图是一张岔路发散式道路系统 合法图是一张岔路发散式道路系统（必经恰一店与归属锁定组）
var paths_ok := true
var lock_ok := true
var depth_ok := true
@@ -256,7 +256,7 @@ func _all_paths(g: Dictionary) -> Array:
# ---- V7 战斗保底 ----
func _test_battle_floor() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:129 （战斗保底组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出合格 产出合格（战斗保底组）
var ok := true
for L in [1, 2, 3]:
for s in range(42, 52):
@@ -268,7 +268,7 @@ func _test_battle_floor() -> void:
# ---- V9 含岔口与出口结构 ----
func _test_exit_structure() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:48 （出口结构与分支互斥组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」合法图是一张岔路发散式道路系统 合法图是一张岔路发散式道路系统（出口结构与分支互斥组）
var fork_all := true
var l1_single := true
var big_fork_ok := true
@@ -315,7 +315,7 @@ func _terminals_reachable(g: Dictionary, id: int) -> int:
# ---- V9 Boss 出场门控（难度曲线与Boss——每区域恰一 Boss 终点）----
func _test_boss_exit_per_region() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:48 （每区域 Boss 出口组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」Boss Boss（每区域 Boss 出口组）
# 真实生成多区域图：全部终点 type=="boss"、boss 终点数==exit_count、深度=L−r（r∈[0,exit_count)
# ——每区域恰一 boss、深度互异即分属不同区域）
# 节点 depth 字段=入口起最长路径深（生成器校验轴）；区域序号 r 的可观测形态=最深 boss（r=0）
@@ -351,7 +351,7 @@ func _test_boss_exit_per_region() -> void:
# ---- V10 RNG 单点（纯流面 counter 不变）----
func _test_rng_single_point() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:134 （RNG 单点流组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」合法图是一张岔路发散式道路系统 合法图是一张岔路发散式道路系统（RNG 单点流组）
var svc = RngScript.new()
svc.new_adventure(4242)
var before: int = svc.counter()
@@ -366,7 +366,7 @@ func _test_rng_single_point() -> void:
# ---- V1 违规夹具：各报对应错误类别 ----
func _test_negative_fixtures() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 （无解 fail-fast 夹具组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（无解 fail-fast 夹具组）
# 夹具构造器：手写 nodes/entries/terminals
var dup := _fx([
{"id": 0, "type": "battle", "depth": 0, "next": [1]},
@@ -493,7 +493,7 @@ func _has_msg(errs: Array, needle: String) -> bool:
# ---- V6 节点图三参数表值驱动（架构整改——fork_third_way_pct/fill_rest_first_pct/width_max 入 level_gen_params）----
func _test_gen_params_table_driven() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:129 （参数档读表驱动组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出合格 产出合格（参数档读表驱动组）
# ① 同种子真实表行产图逐位（表值驱动回归锚）
var g1 := _graph(2, 42)
var g2 := _graph(2, 42)
game/tests/unit/core/node_map_growth_test.gd
+5 -5
View File
@@ -12,7 +12,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
if OS.get_cmdline_user_args().has("fatal-fixture"):
_trigger_fatal()
return
@@ -39,7 +39,7 @@ func _reading(gen, db, L: int) -> Dictionary:
# ---- V8 生长递增（三档×多种子逐档读数）----
func _test_growth(gen, db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:130 （生长递增组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出合格 产出合格（生长递增组）
var steps_ok := true
var count_ok := true
for s in [42, 43, 44, 45, 46]:
@@ -63,7 +63,7 @@ func _test_growth(gen, db) -> void:
# ---- V4 参数无解判定（静态面：域/预算无解夹具必须被 check_params 拦下）----
func _test_fail_fast_static(gen, db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 （参数无解静态拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（参数无解静态拒绝组）
Kit.check("生产三档参数档可行性判定零错误〔fv4〕",
NodeMapGenerator.check_params(db.run.level_gen_params.row_by_level_index(1)).is_empty()
and NodeMapGenerator.check_params(db.run.level_gen_params.row_by_level_index(3)).is_empty())
@@ -82,7 +82,7 @@ func _test_fail_fast_static(gen, db) -> void:
# ---- V4 致命中止真实通道（子进程退出码非零；零回退分支＝件核）----
func _test_fatal_subprocess() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 （无解致命子进程组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（无解致命子进程组）
var bin := _engine_bin()
if bin == "":
Kit.check("未找到引擎二进制，致命子进程通道未跑（如实标注）〔fv4〕", false)
@@ -98,7 +98,7 @@ func _test_fatal_subprocess() -> void:
func _trigger_fatal() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var gen = GenScript.new(RngScript.new())
# 域内合法但深度预算无解：层深 6 放三出口（check_params 拦下 → 致命中止）
var unsolvable := {"layers": 6, "branch_density": 0.0, "battle_ratio": 0.5, "reward_ratio": 0.2,
game/tests/unit/core/playtest_logger_guard_test.gd
+1 -1
View File
@@ -13,7 +13,7 @@ func _init() -> void:
func _smoke_required_injection() -> void:
# 判据出处: design/engineering/code-conventions.md:40 （拆分交接：依赖构造期一次交付——日志器必填注入守卫组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」拆分交接 拆分交接（拆分交接：依赖构造期一次交付——日志器必填注入守卫组）
# 未注入（缺省 0）：start_session 返回空串、零文件产出
var lg0 = load("res://presentation/playtest_logger.gd").new()
var p0: String = lg0.start_session(42)
game/tests/unit/core/pool_case_d_test.gd
+5 -5
View File
@@ -9,7 +9,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池结构案 D：候选抽取与池纪律组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（池结构案 D：候选抽取与池纪律组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[pool_case_d_test] FAIL — 数值表加载失败")
@@ -66,7 +66,7 @@ func _tiers_of(cands: Array) -> Array:
func check_v7(a, db) -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V7 组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（池案 D V7 组）
if not a.start_adventure(201):
Kit.check_quiet(false, "V7 前置：冒险启动")
return
@@ -112,7 +112,7 @@ func check_v7(a, db) -> void:
func check_v6(b, db) -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V6 组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（池案 D V6 组）
if not b.start_adventure(202):
Kit.check_quiet(false, "V6 前置：冒险启动")
return
@@ -142,7 +142,7 @@ func check_v6(b, db) -> void:
func check_v12(m, db) -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V12 组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（池案 D V12 组）
if not m.start_adventure(401):
Kit.check_quiet(false, "V12 前置：冒险启动")
return
@@ -161,7 +161,7 @@ func check_v12(m, db) -> void:
func check_v8(c, db) -> void:
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取（重设计 v1）」 （池案 D V8 组）
# 判据出处: design/gdd/systems/冒险循环/奇物.md「池结构与抽取」令牌牌库 令牌牌库（池案 D V8 组）
if not c.start_adventure(203):
Kit.check_quiet(false, "V8 前置：冒险启动")
return
game/tests/unit/core/run_time_fatal_test.gd
+6 -6
View File
@@ -20,7 +20,7 @@ const TAG_OK := "board_gen" # 在册合法标签（PURPOSE_TAGS 含；wr7 必
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 （运行期违约通道——致命真的会死组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（运行期违约通道——致命真的会死组）
var db = ConfigDBScript.new()
if not db.load_tables("res://data/tables", true):
push_error("[run_time_fatal_test] 表加载失败——夹具不可用（回归）")
@@ -45,7 +45,7 @@ func _init() -> void:
# 缺省形态（契约 2）：不接组装点的协作件违约只落自身 push_error+assert，不外溢封印
func _default_form(db) -> bool:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var rng = RngScript.new()
rng.set_master_seed(3)
var oc = OrchestratorScript.new(db, rng)
@@ -70,7 +70,7 @@ func _default_form(db) -> bool:
# （棋盘生成半边：装板域拆件后生成器随 BoardInstaller 件内自建——组装点＝引用束 fatal_cb 接线，
# 经新组装点构建后触发生成器违约，封印传导断言不变）
func _seal_propagation(db) -> bool:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var rng_a = RngScript.new()
rng_a.set_master_seed(5)
var oc_bg = OrchestratorScript.new(db, rng_a)
@@ -92,7 +92,7 @@ func _seal_propagation(db) -> bool:
# ②wr6（p6）：未知用途标签 → handler 记录位为真（判据主体）＋拿不到可用 RNG；合法标签对照另行验过
func _unknown_tag_channel() -> bool:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var rng_bad = RngScript.new()
rng_bad.set_master_seed(7)
if not _inject_handler(rng_bad, "wr6"):
@@ -111,7 +111,7 @@ func _unknown_tag_channel() -> bool:
# ③wr7（p7）：未播种取数 → handler 记录位为真＋拿不到可用 RNG；同标签播种对照另行验过
func _unseeded_channel() -> bool:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var rng_bad = RngScript.new() # 不播种（_master_seed 缺省 -1）
if not _inject_handler(rng_bad, "wr7"):
return false
@@ -129,7 +129,7 @@ func _unseeded_channel() -> bool:
# 成员在位前提检查（成员被移除时走干净退出 2，不落「赋值不存在的属性」式中途中断）
func _inject_handler(rng, label: String) -> bool:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
if not (rng.get("violation_handler") is Callable):
push_error("[run_time_fatal_test/%s] violation_handler 成员缺失（p6/p7 形态未实装——回归）" % label)
return false
game/tests/unit/core/save_boot_no_activate_test.gd
+4 -4
View File
@@ -22,7 +22,7 @@ func _init() -> void:
# ① 无参实例（autoload 实例化形态）＝无激活态＋默认合法空态（sv2 类级）
func _test_no_arg_instance_has_no_activation() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （启动态无激活不读写组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（启动态无激活不读写组）
var sm := SaveManagerScript.new()
Kit.check_quiet(sm.slots.active_slot() == 0 and not sm.slots.has_write_target(),
"sv2 无参实例无激活态（路径空/激活号 0/写盘目标空）〔卡① sv2〕")
@@ -41,7 +41,7 @@ func _test_no_arg_instance_has_no_activation() -> void:
# 判别锚：空 _path 的退化写目标=裸 ".tmp"（落 res://，拆闸实验实测杂散落点）——
# 断言先清退化目标再核零新增，闸短路缺陷（拒绝口旁路、写盘真实发生）必红。
func _test_write_rejected_without_target() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （无激活态写盘拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（无激活态写盘拒绝组）
var sm := SaveManagerScript.new()
var before := {}
for i in range(1, 4):
@@ -81,7 +81,7 @@ func _test_write_rejected_without_target() -> void:
# （生产结算链全段在位：mark_first_adventure_done→apply_adventure_summary→refresh_treasure_unlocks
# →write_to_disk；无激活态下落账内存、写盘拒绝、盘面零触碰——已知中间态的机检面）
func _test_settle_chain_write_rejected() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （结算链写盘拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（结算链写盘拒绝组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
Kit.check_quiet(false, "sv3 链测试前置：数值表加载失败〔卡① sv3〕")
@@ -104,7 +104,7 @@ func _test_settle_chain_write_rejected() -> void:
# ③ 越界槽号三原语拒绝＋窥视越界返回不可读（原语边界 fail-safe）
func _test_out_of_range_slots_rejected() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （三存档位域界——越域槽拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（三存档位域界——越域槽拒绝组）
var sm := SaveManagerScript.new()
sm.slots.attach_slot_template("user://smoke_boot_noact_%d.json")
Kit.check_quiet(not sm.slots.activate_slot(0) and not sm.slots.activate_slot(4)
game/tests/unit/core/save_manager_domain_test.gd
+3 -3
View File
@@ -19,7 +19,7 @@ var _db
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2–G5 同款：表损坏的红落在具体断言上）
var load_ok: bool = _db.load_tables("res://data/tables", true)
@@ -47,7 +47,7 @@ func _fresh_rng(seed_val: int):
# 损坏兜底/迁移链/域界干净/摘要 cap/摘要跨系统块/生涯终身计数域 v6）。测试文件统一 user://smoke_save_*.json 隔离，
# 段首清场+段尾清理——绝不碰 user://save.json（红线）。
func _smoke_save() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:176 （存档域读写往返/迁移链/损坏兜底/域界组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（存档域读写往返/迁移链/损坏兜底/域界组）
print("--- SaveManager 存档读写/迁移/兜底 ---")
var sm_script = load("res://core/save_manager.gd")
var paths := ["user://smoke_save_roundtrip.json", "user://smoke_save_fresh.json",
@@ -340,7 +340,7 @@ func _smoke_save() -> void:
# 测试文件统一 user://smoke_save_slot_%d.json 模板隔离（attach_slot_template 注入口——禁各自拼槽名），
# 段首清场+段尾清理——绝不碰 user://save.json 与真实槽 user://save_slot_N.json（红线）。
func _smoke_save_slots() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （三槽位与摘要 cap——槽位域组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（三槽位与摘要 cap——槽位域组）
print("--- SaveManager 三存档位承载（迭代 33 卡①）---")
var sm_script = load("res://core/save_manager.gd")
var slot_tpl := "user://smoke_save_slot_%d.json"
game/tests/unit/core/save_slot_isolation_test.gd
+3 -3
View File
@@ -38,7 +38,7 @@ func _write_v7_keystone(path: String, keystone: int) -> void:
# ① 三槽往返：各槽写异值 → 写盘 → 新实例按位读回逐域相等；改槽 1 槽 2 字节不动（sv1）
func _test_three_slot_roundtrip_and_isolation() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （三槽位独立文件隔离组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（三槽位独立文件隔离组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
for i in range(1, 4):
@@ -66,7 +66,7 @@ func _test_three_slot_roundtrip_and_isolation() -> void:
# ② 高版本槽进档失败：拒绝＋恢复切换前三态（路径/激活号/数据）＋拒读槽零误写（sv9/sv10）
func _test_activate_failure_restores_previous_slot() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:61 （激活失败回滚组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「系统范围」边界这样划 边界这样划（激活失败回滚组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
_write_v7_keystone(TPL % 1, 311)
@@ -88,7 +88,7 @@ func _test_activate_failure_restores_previous_slot() -> void:
# ③ MetaProgression 宿主链切槽：引用同一性保持＋写盘落当前槽（sv10——禁换实例先例）
func _test_metaprogression_reference_identity() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:176 （元进度引用同一性——往返一致组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（元进度引用同一性——往返一致组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
_write_v7_keystone(TPL % 1, 533)
game/tests/unit/core/save_slot_summary_test.gd
+3 -3
View File
@@ -36,7 +36,7 @@ func _write_slot_json(path: String, content: String) -> void:
# ① 三槽异值逐槽三项正确＋不激活不写内存（sv7）
func _test_peek_three_slots_distinct_values() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:174 （槽位摘要按槽窥视组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（槽位摘要按槽窥视组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
for i in range(1, 4):
@@ -58,7 +58,7 @@ func _test_peek_three_slots_distinct_values() -> void:
# ② 空槽零值合法态＋不可读三态显式标记（sv7/契约 9）
func _test_peek_empty_and_unreadable_states() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:174 （坏槽三态组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（坏槽三态组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
DirAccess.remove_absolute(TPL % 3) # 清①段残留——空槽夹具
@@ -79,7 +79,7 @@ func _test_peek_empty_and_unreadable_states() -> void:
# ③ 窥视零副作用：字节+mtime 双比对不变＋零 .corrupt.bak 改名（sv8——真实入口冒烟段同判据）
func _test_peek_zero_side_effect() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:174 （窥视零副作用组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（窥视零副作用组）
var t := SaveManagerScript.new()
t.slots.attach_slot_template(TPL)
_write_slot_json(TPL % 1, "corrupt bytes {{{{")
game/tests/unit/core/settle_segments_test.gd
+1 -1
View File
@@ -9,7 +9,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:362 （结算五段 Segment——五段全序组）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「验收标准」五段全序 五段全序（结算五段 Segment——五段全序组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
print("[settle_segments_test] FAIL — 数值表加载失败")
game/tests/unit/core/treasure_effects_test.gd
+2 -2
View File
@@ -10,7 +10,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/秘宝.md:246 （秘宝 12 件逐件行为——效果行为组）
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「验收标准」护栏强制 护栏强制（秘宝 12 件逐件行为——效果行为组）
var db = load("res://core/config_db.gd").new()
if not db.load_tables("res://data/tables", false):
Kit.check_quiet(false, "数值表加载")
@@ -424,7 +424,7 @@ class StubAutoInvRunner:
# 保留并存；本函数断言全链依赖生产行值：add_item 入库→装配集直注（套件既定调试注入口径）→attune 参数和
# ==行值 125→转存兑付按 grant_segment 生产入参形态（装配面读数为入参）兑现。行值变更即红。
func _test_rap_transfer_row_e2e(db) -> void:
# 判据出处: design/gdd/systems/跨局循环/秘宝.md:246 （秘宝逐件行为——储备罐转存率行值）
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「验收标准」护栏强制 护栏强制（秘宝逐件行为——储备罐转存率行值）
var inv = load("res://core/treasure_items.gd").new()
var got: Dictionary = inv.add_item("reserve_jar", "clear_reward", Vector2i(-1, -1), 0)
Kit.check_quiet(not got.is_empty() and String(got.get("item_id", "")) == "reserve_jar",
game/tests/unit/core/treasure_items_test.gd
+1 -1
View File
@@ -53,7 +53,7 @@ func _all_revealed(_c: Vector2i) -> bool:
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/秘宝.md:246 （秘宝结构冻结与护栏校验——结构组）
# 判据出处: design/gdd/systems/跨局循环/秘宝.md「验收标准」护栏强制 护栏强制（秘宝结构冻结与护栏校验——结构组）
# ① 授予归因+受理序+Used 不可逆
var inv = _new_inv()
var r1: Dictionary = inv.add_item("morning_order", "safe_cell", Vector2i(3, 4), 2)
game/tests/unit/core/tree_requires_level_test.gd
+1 -1
View File
@@ -7,7 +7,7 @@ extends SceneTree
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:195 （等级阈值前置：schema 四拒一过＋判定三态＋投影两态组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」等级阈值前置 等级阈值前置（等级阈值前置：schema 四拒一过＋判定三态＋投影两态组）
var failures := 0
var db = load("res://core/config_db.gd").new()
var mt = load("res://data/schemas/meta_tree_table.gd").new()
game/tests/unit/core/tree_rules_v11_test.gd
+2 -2
View File
@@ -12,7 +12,7 @@ extends SceneTree
func _init() -> void:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:194 （结构封闭：六键合成行闭集校验组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（结构封闭：六键合成行闭集校验组）
var eng = load("res://core/effect_engine.gd")
var tree_tbl = load("res://data/schemas/meta_tree_table.gd")
var db = load("res://core/config_db.gd").new()
@@ -89,7 +89,7 @@ func _init() -> void:
# ---- 规则键参数域校验（架构整改批 R1——六键参数字典）：正例全过/缺参数拒/多参数拒/越域拒/非字典拒 ----
func _test_rule_key_params(eng, tree_tbl, db) -> Array:
# 判据出处: design/gdd/systems/跨局循环/天赋树.md:194 （规则键参数字典——参数名/取值域合规组）
# 判据出处: design/gdd/systems/跨局循环/天赋树.md「验收标准」结构封闭 结构封闭（规则键参数字典——参数名/取值域合规组）
var errs: Array = []
var params_tbl: Dictionary = tree_tbl.RULE_KEY_PARAMS
# 正例：meta_tree.tres 现行 Fork 行逐键过 validate（加载期已验——此处显式复核）
game/tests/unit/cross_system_flow_test.gd
+5 -5
View File
@@ -20,7 +20,7 @@ var _db
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_db = ConfigDBScript.new()
# 表加载失败不中止（承 G2–G5 同款：表损坏的红落在具体断言上）
var load_ok: bool = _db.load_tables("res://data/tables", true)
@@ -47,7 +47,7 @@ func _fresh_rng(seed_val: int):
# ---- ① RNG 事件日志会话落盘（源 `_initialize` :70，主会话裁决一改判跨系统闭环承载——
# 驱动沿源 :60–70 取号序列自持：master 种子 42 → 前置取号 → new_adventure 开日志会话 → 会话内取号）----
func _rng_event_log_session() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 （事件日志落盘会话组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流：随机只从一个服务按号取，同种子必同局」用户两轮复裁 用户两轮复裁（事件日志落盘会话组）
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(42)
rng.open_stream("board_gen")
@@ -62,7 +62,7 @@ func _rng_event_log_session() -> void:
# _on_level_finished(victory)＋breakpoint_snapshot 取读＋clear_breakpoint；
# 起局与兑付两步的受理断言留单元宿主（adventure_feats_test），此处纯驱动——前置失败自然落红）----
func _feats_breakpoint_roundtrip() -> void:
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md:180 （专长断点附随件往返组）
# 判据出处: design/gdd/systems/表现与支撑/存档序列化.md「验收标准」往返一致 往返一致（专长断点附随件往返组）
var rt := FeatTable.new()
rt.rows = [
{"feat_id": "x1", "display_name": "试一", "rarity": "common", "desc": "测试揭示", "cap": 1,
@@ -108,7 +108,7 @@ func _feats_breakpoint_roundtrip() -> void:
# level_autoplay 真局摘要 → apply 原语 → 域读数 → 写盘读回保持；临时档 user://smoke_save_integration.json
# 段首清场+段尾清理（源 _smoke_save 隔离纪律），绝不碰 user://save.json（红线））----
func _save_summary_integration() -> void:
# 判据出处: design/gdd/systems/跨局循环/元进度.md:150 （摘要跨系统块与钥石只增不减组）
# 判据出处: design/gdd/systems/跨局循环/元进度.md「验收标准」钥石不丢 钥石不丢（摘要跨系统块与钥石只增不减组）
var sm_script = load("res://core/save_manager.gd")
var path9 := "user://smoke_save_integration.json" # 源 paths[8]
if FileAccess.file_exists(path9):
@@ -141,7 +141,7 @@ func _save_summary_integration() -> void:
# ---- ④ 试玩记录仪（源 `_smoke_playtest_logger` 整套八条，主会话裁决七改判跨系统闭环承载——
# PlaytestLogger 挂真实结算流：会话文件/逐结算快照/字段齐备/spawn_count 回归/诊断转储/JSONL 回读）----
func _smoke_playtest_logger() -> void:
# 判据出处: design/engineering/code-conventions.md:40 （试玩日志器跨系统接线组）
# 判据出处: design/engineering/code-conventions.md「1.6 拆分交接与封装边界」本节管拆分类改动的交接面与封装面 本节管拆分类改动的交接面与封装面（试玩日志器跨系统接线组）
print("--- PlaytestLogger（结算快照 JSONL + 诊断转储）---")
var rng = load("res://core/rng_service.gd").new()
rng.set_master_seed(20260912)
game/tests/unit/data_config/config_db_fatal_oob_test.gd
+2 -2
View File
@@ -12,7 +12,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:200 致命真的会死：正式通道加载进程非 0 退出（装载前提组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（装载前提组）
_db = ConfigDBScript.new()
var load_ok: bool = _db.load_tables("res://data/tables", true)
if not load_ok:
@@ -24,7 +24,7 @@ func _init() -> void:
func _trigger_oob() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:204 越域请求在进入解析前致命中止（Fatal 级诊断＋进程非 0，无兜底）（越域组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（Fatal 级诊断＋进程非 0，无兜底）（越域组）
# 共享 .tres 上的 resolver 归最后装载的实例——autoload ConfigDB 的 _ready 在测试 _init 之后
# 二次注入覆盖私有实例，故触发前把解析通道归还被测实例（诊断落 _db，退出码判据才成立）
_db.combat.board_gen._resolver = _db._resolver
game/tests/unit/data_config/config_db_test.gd
+7 -7
View File
@@ -9,7 +9,7 @@ const Kit := preload("res://tests/unit/test_kit.gd") # T6 收口：_check/汇
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 干净检出：表清单内全部表加载成功、就绪态断言（装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者、就绪态断言（装载组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("全部表加载 + 校验通过（含跨表护栏零 error 诊断）〔fv6〕", load_ok and db.diagnostics_count("error") == 0)
@@ -31,7 +31,7 @@ func _init() -> void:
# ---- 进度坐标 ceil 解析（R1：向上下取整保证偏难；越最大行 clamp 取最大值 + 警告去重）----
func _test_progress_resolution(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:203 向上取整解析：请求无精确行返回不低于请求坐标的最近行（进度查行组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（进度查行组）
var bg_rows: Array = db.combat.board_gen.rows
# 行键全集自表推导（禁写死关卡/深度数值）
var level_keys: Array = []
@@ -88,7 +88,7 @@ func _test_progress_resolution(db) -> void:
# ---- 变异池门控（unlock_level 闸 + ∅ board_types 通配 + 节点身份第三维）----
func _test_variant_pool_gate(db) -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:153 候选池空合法：门控筛空时静默零布置（变异门控组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「验收标准」候选池空合法 候选池空合法（变异门控组）
var rows: Array = db.combat.variation.rows
var gated_row := {}
var wildcard_row := {}
@@ -131,7 +131,7 @@ func _rows_contain(pool: Array, row: Dictionary) -> bool:
# ---- ShopTable 消费面（行集解析单点——runner/编排禁自扫表的契约消费侧验证）----
func _test_shop_accessors(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：行结构与引用闭合（商店访问器行结构组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（商店访问器行结构组）
var products: Array = db.run.shop.product_rows()
if products.is_empty():
Kit.check("ShopTable products 行族非空（表已已入库前提）", false)
@@ -159,7 +159,7 @@ func _test_shop_accessors(db) -> void:
# ---- MetaTable 消费面 ----
func _test_meta_accessors(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：行结构与引用闭合（元进度访问器行结构组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（元进度访问器行结构组）
# 无 forge_products 行族断言（行族/访问器不在表，V20 清单）
var key_rows: Array = db.crossrun.meta.boss_keystone
if not key_rows.is_empty():
@@ -179,7 +179,7 @@ func _test_meta_accessors(db) -> void:
# ---- TABLE_MANIFEST ↔ data/tables 目录同步（各系统→D2 单点契约的登记面）----
func _test_manifest_dir_sync(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 表目录无清单外文件（清单对账组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（清单对账组）
var manifest: Dictionary = db.TABLE_MANIFEST
var dir := DirAccess.open("res://data/tables")
var disk_files: Array = []
@@ -204,7 +204,7 @@ func _test_manifest_dir_sync(db) -> void:
# （rowset_rule——行序即契约，R6 加载期兜底）③行集实例总数 ≤4（骰后值运行面，spawn 守卫——冒烟侧验证）。
func _test_rowset_discipline() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别：重复键与缺锚行逐类断言（行集纪律组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（行集纪律组）
# 行集用 rows.assign([...]) 而非直接赋值：rows 是 Array[Dictionary] 定型属性，直接赋 untyped
# 数组字面量会触发「Invalid assignment」脚本错误——该错误不改退出码，却会**中断本函数剩余断言**
#（本函数五条纪律断言曾因此全部静默不跑，套件仍报 all green，是零覆盖假象）。
game/tests/unit/data_config/counter_prefix_fatal_test.gd
+2 -2
View File
@@ -20,7 +20,7 @@ const PROBE_REF := ' {\n "feat_id": "ref_probe",\n "display_name": "引用探
func _inject(dir: String, probe: String) -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：前缀违规夹具注入（前缀夹具组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（前缀夹具组）
var path := dir + "/feats.tres"
var f := FileAccess.open(path, FileAccess.READ)
if f == null:
@@ -45,7 +45,7 @@ func _inject(dir: String, probe: String) -> bool:
func _assert_rejected(bad_dir: String, probe: String, label: String) -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:200 致命真的会死：违规表拒绝且进程非 0（拒绝判定组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（拒绝判定组）
# 返回 true=正确拒绝；false=放行或夹具失败（调用方据此退出 2）
if not Kit.copy_tables(SRC_DIR, bad_dir) or not _inject(bad_dir, probe):
push_error("[%s] 夹具目录准备失败" % label)
game/tests/unit/data_config/effect_kind_retired_test.gd
+2 -2
View File
@@ -39,7 +39,7 @@ const PROBE_TRADE_KEY := ' {
func _inject(dir: String, probe: String) -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：退役词夹具注入（退役词夹具组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（退役词夹具组）
var path := dir + "/feats.tres"
var f := FileAccess.open(path, FileAccess.READ)
if f == null:
@@ -64,7 +64,7 @@ func _inject(dir: String, probe: String) -> bool:
func _assert_rejected(bad_dir: String, probe: String, label: String) -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:200 致命真的会死：退役词加载致命中止（拒绝判定组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（拒绝判定组）
# 返回 true=正确拒绝；false=放行或夹具失败（调用方据此退出 2）
if not Kit.copy_tables(SRC_DIR, bad_dir) or not _inject(bad_dir, probe):
push_error("[%s] 夹具目录准备失败" % label)
game/tests/unit/data_config/elite_row_test.gd
+6 -6
View File
@@ -58,7 +58,7 @@ func _count_cat(errs: Array, cat: String) -> int:
# ---- R1：elite 行类合法与字段互锁、引用校验（合法零错＋十一违例各自「含」预期类别）----
func _test_elite_validation_rejects() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:325 elite 行字段互锁与基础引用违例加载期返回错误
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「验收标准」开战生成 开战生成
var t_ok = EnemyTableScript.new()
t_ok.rows.assign(_legal_rows())
var errs: Array = t_ok.validate()
@@ -130,7 +130,7 @@ func _validate_rows(rows: Array) -> Array:
# ---- R2：有效池＝基础池＋附加技，基础池取深度带最小行（深带行在前防取首行假绿）----
func _test_effective_pool_merge() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:149 精英有效池＝同关战斗行类基础敌种深度带最小行的池＋附加技
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本
var rows := [
_mk_row(1, "battle", 3, "goblin"), # 深带行在前（取首行的错误实现必红）
_mk_row(1, "battle", 0, "goblin"),
@@ -155,7 +155,7 @@ func _test_effective_pool_merge() -> void:
# ---- R3：继承不复制——基础池改表传到精英、改写返回数组不回灌 ----
func _test_base_pool_change_propagates() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:149 继承不复制——基础池调参自动传到精英
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本
var rows := [
_mk_row(1, "battle", 3, "goblin"),
_mk_row(1, "battle", 0, "goblin"),
@@ -181,7 +181,7 @@ func _test_base_pool_change_propagates() -> void:
# ---- R4：合并池过池构成纪律（跨表件校验对象=合并后的池）----
func _test_merged_pool_composition() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:150 池构成纪律校验对象是合并后的池
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本
var skills := SkillTableScript.new()
skills.rows.assign([
{"skill_id": "attack", "type": "basic"},
@@ -239,7 +239,7 @@ func _msgs(errs: Array) -> Array[String]:
# ---- R5：暂不接线——表里有 elite 行时寻址拿不到它（行类门改动特有判据）----
func _test_elite_unreachable_by_encounter() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:151 精英行接线前不会被任何节点读到
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本
_diags.clear()
var resolver = ResolverScript.new(
func(level, category, message) -> void:
@@ -272,7 +272,7 @@ func _test_elite_unreachable_by_encounter() -> void:
# ---- R6：生产表地精精英落表（真实加载零错＋行值逐位＋有效池字典）----
func _test_production_goblin_elite() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:147 精英＝敌人表行类为 elite 的独立一行
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「精英行：现役敌种的强化版，池＝继承基础池＋附加技」精英怪是某个现役敌种的强化版本 精英怪是某个现役敌种的强化版本
var db = load("res://core/config_db.gd").new()
var ok: bool = db.load_tables("res://data/tables", true)
Kit.check("生产表 ConfigDB.load_tables 装载（is_ready=%s）〔精英批 V6〕" % str(db.is_ready), ok and db.is_ready)
game/tests/unit/data_config/forge_table_test.gd
+5 -5
View File
@@ -12,7 +12,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 锻造表装载与就绪态（装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（装载组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("生产 forge.tres 随全表加载 + validate 零违例〔锻造工坊批 V1〕", load_ok and db.diagnostics_count("error") == 0)
@@ -27,7 +27,7 @@ func _init() -> void:
# ---- 生产表六行正向（V1 生产面 + V11 行字段闭集）----
func _test_production_rows(db) -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：行 schema 正反逐类断言（生产行结构组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（生产行结构组）
var rows: Array = db.crossrun.forge.route_rows()
Kit.check("六路线行族规模恰 6（三武器+三甲）〔锻造工坊批 V1〕", rows.size() == 6)
var ids := []
@@ -91,7 +91,7 @@ func _test_production_rows(db) -> void:
# ---- 几何价格梯（V2 价格面单测半边——购买写在 T3 冒烟）----
func _test_price_ladder(db) -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:220 定价结构：每级价格随已购级数几何递增、基价与公比读表单点（价格梯组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」基价与公比读表单点 基价与公比读表单点、基价与公比读表单点（价格梯组）
var row: Dictionary = db.crossrun.forge.route("sword")
var prices := []
for owned in range(5):
@@ -150,7 +150,7 @@ func _mut_spear_initial(t) -> void:
func _test_negative_cases() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖（负向 schema 组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（负向 schema 组）
# 夹具本身须零违例（否则负向判读失效）
var t_ok = ForgeTableScript.new()
t_ok.routes = _base_rows()
@@ -218,7 +218,7 @@ func _test_negative_cases() -> void:
# 现行 30；本套件零扩签，钉现行数（将来任何加词即转红提示复核）。
func _test_effect_kinds_closed() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「满级特效扩展位」 事件/事实/效果类型/算子四词表封闭（特效闭集组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「满级特效扩展位」满级特效 满级特效（特效闭集组）
Kit.check("效果引擎效果类型闭集 30 种〔锻造工坊批 V11〕",
EffectEngineScript.EFFECT_KINDS.size() == 30)
Kit.check("效果引擎事件词表在册 21 种（charge_full 位摘名——蓄力层删键批）〔锻造工坊批 V11〕",
game/tests/unit/data_config/level_gen_params_test.gd
+4 -4
View File
@@ -11,7 +11,7 @@ const Kit := preload("res://tests/unit/test_kit.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 参数档表装载与就绪态（装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（装载组）
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
Kit.check("生产 level_gen_params.tres 随全表加载 + validate 零违例〔fv2〕",
@@ -43,7 +43,7 @@ func _table(rows: Array) -> Variant:
# ---- 生产三行正向（V2）----
func _test_production(db) -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:127 产出合格：任意参数档产出的图必过产出约束（生产档组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出合格 产出合格（生产档组）
var r1: Dictionary = db.run.level_gen_params.row_by_level_index(1)
var r2: Dictionary = db.run.level_gen_params.row_by_level_index(2)
var r3: Dictionary = db.run.level_gen_params.row_by_level_index(3)
@@ -61,7 +61,7 @@ func _test_production(db) -> void:
# ---- 访问器缺行防御 ----
func _test_accessor() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:127 参数档访问器读回与产出约束（访问器组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「验收标准」产出合格 产出合格（访问器组）
var t = _table([_row(1, 6, 0.3, [0.5, 0.2, 0.2, 0.1], 1, 1, 4)])
Kit.check("row_by_level_index 缺行返回空字典〔fv2〕", t.row_by_level_index(9).is_empty())
@@ -69,7 +69,7 @@ func _test_accessor() -> void:
# ---- 域校验逐类负向（V2）----
func _test_negative() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：参数档 schema 拒绝（负向组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（负向组）
# 合法基线三行
var base := [_row(1, 6, 0.3, [0.5, 0.2, 0.2, 0.1], 1, 1, 4),
_row(2, 9, 0.5, [0.5, 0.2, 0.15, 0.15], 2, 2, 6),
game/tests/unit/data_config/reward_dangling_treasure_test.gd
+2 -2
View File
@@ -14,7 +14,7 @@ const BAD_DIR := "user://treasure_fixture_dangling"
func _inject_violation() -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别：悬空引用夹具（悬空引用组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（悬空引用组）
var path := BAD_DIR + "/reward.tres"
var f := FileAccess.open(path, FileAccess.READ)
if f == null:
@@ -37,7 +37,7 @@ func _inject_violation() -> bool:
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:200 致命真的会死：悬空引用被拒绝、进程非 0（拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者、进程非 0（拒绝组）
if not Kit.copy_tables(SRC_DIR, BAD_DIR) or not _inject_violation():
push_error("[reward_dangling_treasure_test] 夹具目录准备失败")
quit(2)
game/tests/unit/data_config/rng_service_test.gd
+5 -5
View File
@@ -12,7 +12,7 @@ const TEST_SEED := 20260928 # 夹具种子（任意固定值；语义 = 可复
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 黄金向量：登记向量逐个复算（装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（装载组）
_test_derive_determinism()
_test_counter_ledger()
_test_stream_draw_determinism()
@@ -28,7 +28,7 @@ func _fresh_service():
# 单盐派生纯函数：两全新实例同种子逐位一致（derive_at 不推计数器——纯函数契约）
func _test_derive_determinism() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 黄金向量：随机派生纯函数对登记向量逐个复算相等、同输入恒同输出（派生确定性组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者、同输入恒同输出（派生确定性组）
var a = _fresh_service()
var b = _fresh_service()
var same := true
@@ -44,7 +44,7 @@ func _test_derive_determinism() -> void:
# 全局取数计数器：唯一账本——open_stream 逐次 +1（scope 单调）
func _test_counter_ledger() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:202 计数器纪律：连续取号跨模拟关卡切换单调不重置（计数账本组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（计数账本组）
var rng = _fresh_service()
var c0: int = rng.counter()
rng.open_stream("armor_roll")
@@ -62,7 +62,7 @@ func _test_counter_ledger() -> void:
# 同种子两实例同标签流的实际取数序列逐位一致（回放确定性契约——存档快照=主种子+计数器的前提）
func _test_stream_draw_determinism() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:201 同输入恒同输出：流取号确定性（流取号组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（流取号组）
var faces := 20 # d20 探针面数（夹具值，非玩法表值——只用于产生可比较序列）
var a = _fresh_service()
var b = _fresh_service()
@@ -77,7 +77,7 @@ func _test_stream_draw_determinism() -> void:
# 负输入 abs 归一化（警告通道）——|−s| 与 s 同派生
func _test_negative_seed_normalization() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 RngService：master_seed 与各流 scope 计数器单点（种子规约组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流：随机只从一个服务按号取，同种子必同局」用户两轮复裁 用户两轮复裁（种子规约组）
var pos = _fresh_service()
var neg = RngServiceScript.new()
neg.set_master_seed(-TEST_SEED)
game/tests/unit/data_config/rng_stream_boot_test.gd
+1 -1
View File
@@ -22,7 +22,7 @@ func _init() -> void:
# 单元宿主改由 `_init` 显式调用，断言逐字未动；源 :70 事件日志落盘条经主会话裁决一
# 改判跨系统闭环套件——不随本宿主，见迁移账本转办清单）----
func _smoke_initialize() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流」 RngService autoload：open_stream 有状态门面与启动初始化（启动流组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「统一随机流：随机只从一个服务按号取，同种子必同局」用户两轮复裁 用户两轮复裁（启动流组）
print("=== Dungeon Sweeper 垂直切片冒烟 ===")
var db = ConfigDBScript.new()
var load_ok: bool = db.load_tables("res://data/tables", true)
game/tests/unit/data_config/table_structure_guard_test.gd
+16 -16
View File
@@ -29,7 +29,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:198 表结构守卫装载与就绪态（装载组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（装载组）
_db = ConfigDBScript.new()
# 表加载失败不中止（沿被迁断言面的源语义：表损坏的红落在具体断言上——
# 诊断在此展开，后续断言按坏表实况逐条验红；collect_only=true 下成员照常赋值可评）
@@ -96,7 +96,7 @@ func _first_encounter_band(level_index: int, enemy_id: String) -> int:
# ① 冒险表（单行全局 Rule 4 豁免——建表与接线闸；TP0 令牌池：配额结构/件值对/池总量域检）
func _smoke_adventure_table() -> void:
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md:281 冒险结构表校验（冒险表组）
# 判据出处: design/gdd/systems/冒险循环/冒险结构.md「验收标准」开始新冒险 开始新冒险（冒险表组）
print("--- 冒险表（AdventureTable——令牌池行值单点：回血/配额/件值对/同调位）---")
Kit.check("db.adventure 已加载（adventure.tres 入 manifest）", _db.run.adventure != null)
if _db.run.adventure == null:
@@ -215,7 +215,7 @@ func _smoke_adventure_table() -> void:
# ---- 敌人表深度带键结构（迭代 34 建·L1 混编批换代：30 行键序=覆盖表序·(1,3) 混编行集·Boss 行集带键清单·精英行）----
func _smoke_enemy_bands() -> void:
# 判据出处: design/gdd/systems/冒险循环/难度曲线与Boss.md:316 难度与敌人带校验（敌人带组）
# 判据出处: design/gdd/systems/冒险循环/难度曲线与Boss.md「验收标准」坐标行齐备 坐标行齐备（敌人带组）
print("--- 敌人表深度带键结构（30 行键序 · (1,3) 混编 · Boss 带键覆盖表 · 精英行）---")
# ① 30 行计数 + 键序 = 覆盖表序（文件行序不变——行序即契约；(1,3) 两行相邻、熊地精在前；精英行随精英专属池批）
# 迭代 35 生成图深度扩面覆盖批随动：战斗带顶扩到各关最大生成深度（L1→6／L2→9／L3→13）、
@@ -304,7 +304,7 @@ func _smoke_enemy_bands() -> void:
# ④ 掷点参数域：档位边界升序/档位值降序无零档/骰面与暴击参数在域（加载校验双保险）。
func _smoke_ac_swap_guard() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:219 切换语义：一次冒险＝一个武器类型＋一个甲型，冒险开始后锁死（AC 换装守卫组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」冒险开始后锁死 冒险开始后锁死，冒险开始后锁死（AC 换装守卫组）
print("--- 护甲等级掷点批·换装护栏 ---")
# ① 三处无双轨
Kit.check("状态表 defense_up 行已退役（无双轨）", _db.combat.status_effects.row_by_id("defense_up").is_empty())
@@ -425,7 +425,7 @@ func _smoke_ac_swap_guard() -> void:
# ---- 地形变异 框架面（四行两轴×两关 + 门控 + 跨字段互锁）----
func _smoke_variation_framework() -> void:
# 判据出处: design/gdd/systems/排雷循环/地形变异.md:153 候选池门控与静默零布置（变异框架组）
# 判据出处: design/gdd/systems/排雷循环/地形变异.md「验收标准」候选池空合法 候选池空合法（变异框架组）
print("--- 地形变异 框架面（首批四类型 + 候选池门控 + 跨字段互锁）---")
Kit.check("变异清单 6 行（荆棘丛/藤蔓缠绕/岩浆/烬覆 + 落石/矿尘——首批类型定稿批 + 第三关内容批；贫矿脉 2026-10-16 用户令屏蔽删行）",
_db.combat.variation.rows.size() == 6)
@@ -461,7 +461,7 @@ func _smoke_variation_framework() -> void:
# ---- 难度曲线与Boss DifficultyTable 结构位冒烟（AC-10：空表零行为 + 套乘点 = 行值快照前）----
func _smoke_difficulty_table() -> void:
# 判据出处: design/gdd/systems/冒险循环/难度曲线与Boss.md:316 难度修饰套乘（难度表组）
# 判据出处: design/gdd/systems/冒险循环/难度曲线与Boss.md「验收标准」坐标行齐备 坐标行齐备（难度表组）
print("--- 难度曲线与Boss·DifficultyTable 结构位 ---")
Kit.check("DifficultyTable MVP 空表加载（结构位）", _db.run.difficulty != null and _db.run.difficulty.rows.is_empty())
# ① 空表零行为：敌人系统.spawn 敌值 = EnemyTable 行值原样
@@ -492,7 +492,7 @@ func _smoke_difficulty_table() -> void:
# ---- ⑤ 格面资源九型 + gp_drop 流（黄金向量）----
func _smoke_nine_types_gp_stream() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：九型 GP 流校验（九型流组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（九型流组）
print("--- 格面资源九型 + gp_drop 流（奖励字典 18 格 + 黄金向量）---")
Kit.check("格面资源十型封闭（第九型 gp 九型批 2026-09-20 / 第十型 treasure_item 秘宝内容批 2026-09-29——词表 v1.2）",
RewardTable.CELL_TYPES.size() == 10 and RewardTable.CELL_TYPES.has("gp") and RewardTable.CELL_TYPES.has("treasure_item"))
@@ -542,7 +542,7 @@ func _smoke_nine_types_gp_stream() -> void:
# ---- 元进度·MetaTable 表结构（行值全 provisional 归元进度设计文档配读数；
# conversion 覆盖恰三，Boss 两档 first ≥ repeat）----
func _smoke_meta() -> void:
# 判据出处: design/gdd/systems/跨局循环/元进度.md:148 元进度行族校验（meta 行族组）
# 判据出处: design/gdd/systems/跨局循环/元进度.md「验收标准」钥石不丢 钥石不丢（meta 行族组）
print("--- 元进度·MetaTable 表结构 ---")
var meta_tbl = _db.crossrun.meta
Kit.check("MetaTable 非空 + validate 零错（三行族词表封闭/唯一/连续/域界/first≥repeat/ratio 全过）",
@@ -582,7 +582,7 @@ func _conversion_row_of(rows: Array, attr: String) -> Dictionary:
# ---- V7 节点图三新键域校验（架构整改——缺新键行拒/width_max 越域拒/两 pct 越域拒/表值全过）----
func _test_level_gen_new_fields() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var tbl = _db.run.level_gen_params
var mk := func(mod: Dictionary) -> Dictionary:
var row := {"level_index": 1, "layers": 6, "branch_density": 0.3, "battle_ratio": 0.5, "reward_ratio": 0.2,
@@ -619,7 +619,7 @@ func _test_level_gen_new_fields() -> void:
# ---- 变异表头域校验 / feat cap 必填（架构整改——丁案三件的数据面守卫）----
func _test_variation_header_domains() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var inst = load("res://data/schemas/variation_table.gd").new()
inst.percent_of_cells = 5
inst.per_level_bonus = 0
@@ -637,7 +637,7 @@ func _test_variation_header_domains() -> void:
func _test_feat_cap_required() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var inst = load("res://data/schemas/feat_table.gd").new()
# 生产表全行 cap 在场（加载期已验——此处显式复核 37 行）
var all_cap := true
@@ -669,8 +669,8 @@ func _test_feat_cap_required() -> void:
# ---- G2 结算数值钉（迭代 55「QA覆盖余量收口批」T2——equivalence_ref_damage/p_perfect 钉＋p_perfect 读数活性）----
func _check_settlement_pin_values() -> void:
# 判据出处: design/engineering/test-conventions.md:119 （表值钉值——漂移即红）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md:124 （完美第二份兑付读表——接线后该句由声称变属实）
# 判据出处: design/engineering/test-conventions.md「8.3 改动—验收对照表」需求卡片列需求侧对照表 需求卡片列需求侧对照表（表值钉值——漂移即红）
# 判据出处: design/gdd/systems/战斗循环/战斗结算.md「收益对照表：所有收益共用同一把尺子」开安全格给正向 开安全格给正向（完美第二份兑付读表——接线后该句由声称变属实）
var core = _db.combat.settlement.core
var roll = _db.combat.settlement.damage_roll
Kit.check("equivalence_ref_damage 钉 4（离线审计镜像 tools/clear_dominance_audit.py D_REF 同源——表值漂移即审计口径静默失效）〔QA余 V2〕",
@@ -703,7 +703,7 @@ func _check_settlement_pin_values() -> void:
# ---- G10 换算率钉（迭代 55「QA覆盖余量收口批」T2——per_level_shift_pct 三关档 6/9/1）----
func _check_meta_per_level_pins() -> void:
# 判据出处: design/engineering/test-conventions.md:119 （表值钉值——漂移即红；离线 verifier 消费端同源）
# 判据出处: design/engineering/test-conventions.md「8.3 改动—验收对照表」需求卡片列需求侧对照表 需求卡片列需求侧对照表（表值钉值——漂移即红；离线 verifier 消费端同源）
var pins := {"max_hp": 6, "atk": 9, "armor_class": 1}
for attr in pins.keys():
var row: Dictionary = {}
@@ -717,7 +717,7 @@ func _check_meta_per_level_pins() -> void:
# ---- G3 cap 段七槽钉值（迭代 55「QA覆盖余量收口批」T3——与 gp/attack 同款占位形态）----
func _check_curio_cap_segment_pins() -> void:
# 判据出处: design/engineering/test-conventions.md:119 （表值钉值——漂移即红）
# 判据出处: design/engineering/test-conventions.md「8.3 改动—验收对照表」需求卡片列需求侧对照表 需求卡片列需求侧对照表（表值钉值——漂移即红）
for kind in ["ap", "armor", "heal", "max_hp", "rap", "refresh", "time_sand"]:
Kit.check("curio_cap 七槽钉值：%s==99（案②提前退役占位——99=实质无上限，实数归调参批）〔QA余 V3〕" % kind,
int(_db.run.adventure.curio_cap(String(kind))) == 99)
@@ -726,7 +726,7 @@ func _check_curio_cap_segment_pins() -> void:
# ---- G8 reward stacks 行钉（迭代 55「QA覆盖余量收口批」T8——生产行 stacks 值面，合成行键未读生产行的缺口补钉）----
func _check_reward_row_pins() -> void:
# 判据出处: design/engineering/test-conventions.md:119 （表值钉值——漂移即红）
# 判据出处: design/engineering/test-conventions.md「8.3 改动—验收对照表」需求卡片列需求侧对照表 需求卡片列需求侧对照表（表值钉值——漂移即红）
Kit.check("reward 行扫描面非空（18 行在册——防空表静默绿）", (_db.run.reward.rows as Array).size() > 0)
var stacks_drift: Array[String] = []
for row in _db.run.reward.rows:
game/tests/unit/data_config/treasure_target_violation_test.gd
+2 -2
View File
@@ -15,7 +15,7 @@ const BAD_DIR := "user://treasure_fixture_target_violation"
func _inject_violation() -> bool:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:199 校验类别全覆盖：违规夹具逐类注入（真视窄域夹具组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者（真视窄域夹具组）
var path := BAD_DIR + "/treasure_items.tres"
var f := FileAccess.open(path, FileAccess.READ)
if f == null:
@@ -40,7 +40,7 @@ func _inject_violation() -> bool:
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md:200 致命真的会死：违规表被拒绝、进程非 0（违规拒绝组）
# 判据出处: design/gdd/systems/表现与支撑/数据配置.md「调参表」本文是表的管理者 本文是表的管理者、进程非 0（违规拒绝组）
if not Kit.copy_tables(SRC_DIR, BAD_DIR) or not _inject_violation():
push_error("[treasure_target_violation_test] 夹具目录准备失败")
quit(2)
game/tests/unit/example_test.gd
+1 -1
View File
@@ -10,7 +10,7 @@ extends SceneTree
const Kit := preload("res://tests/unit/test_kit.gd") # T6 收口：check/汇总退出样板单点
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:37 （套件协议模板——执行载体与退出码范例组）
# 判据出处: design/engineering/test-conventions.md「2. 场景级探针标配」每新增一个可交互 每新增一个可交互（套件协议模板——执行载体与退出码范例组）
Kit.check("headless SceneTree 协议可用（quit(code) 通道）", _test_headless_protocol())
Kit.check("命名规范可执行：test_[scenario]_[expected]", _test_naming_convention_followed())
quit(Kit.finish("example_test"))
game/tests/unit/node_map_determinism_test.gd
+2 -2
View File
@@ -19,7 +19,7 @@ var _bp_path := "user://smoke_node_map_save.json"
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_db = load("res://core/config_db.gd").new()
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上）
var load_ok: bool = _db.load_tables("res://data/tables", true)
@@ -34,7 +34,7 @@ func _init() -> void:
# ---- 关卡节点图生成·确定性承载断言面 ----
func _smoke_generated_map_determinism() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md:134 （起关/选路/断点重生成同图组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点图生成.md「图的规格：什么算一张合法的图」合法图是一张岔路发散式道路系统 合法图是一张岔路发散式道路系统（起关/选路/断点重生成同图组）
# ① 纯函数复现：图 = f(参数档, 种子)——同档同种子两次产图逐位同图，换种子必变图
var gen = NodeMapGenerator.new(_fresh_rng(910001))
var params2: Dictionary = _db.run.level_gen_params.row_by_level_index(2)
game/tests/unit/presentation/animation_frame_spec_test.gd
+3 -3
View File
@@ -20,7 +20,7 @@ const CURRENT_FORM := {
func _init() -> void:
# 判据出处: design/art/art-bible.md:539 （帧数规格条——样张冻结定值组）
# 判据出处: design/art/art-bible.md「8.2 像素基准与画布」缩放纪律 缩放纪律（帧数规格条——样张冻结定值组）
_test_spec_table()
_test_current_form()
quit(Kit.finish("animation_frame_spec_test"))
@@ -28,7 +28,7 @@ func _init() -> void:
# ① 规格表冻结面（帧数档定值单点=本表）
func _test_spec_table() -> void:
# 判据出处: design/art/art-bible.md:539 （帧数规格表冻结组）
# 判据出处: design/art/art-bible.md「8.2 像素基准与画布」缩放纪律 缩放纪律（帧数规格表冻结组）
Kit.check("待机循环 4 帧在表〔帧规格 V1〕", SPEC.get("idle", 0) == 4)
Kit.check("攻击准备 6 帧单次在表〔帧规格 V2〕", SPEC.get("attack", 0) == 6)
Kit.check("受击 2 帧在表〔帧规格 V3〕", SPEC.get("hit", 0) == 2)
@@ -36,7 +36,7 @@ func _test_spec_table() -> void:
# ② 现役单帧形制锚定（真实加载链——资产被换形制而未走规格表时此处红）
func _test_current_form() -> void:
# 判据出处: design/art/art-bible.md:539 （现役单帧形制组）
# 判据出处: design/art/art-bible.md「8.2 像素基准与画布」缩放纪律 缩放纪律（现役单帧形制组）
for fn: String in CURRENT_FORM:
var tex: Texture2D = load("res://assets/art/character/" + fn)
var want := Vector2(CURRENT_FORM[fn])
game/tests/unit/presentation/battle_log_zero_text_test.gd
+4 -4
View File
@@ -12,18 +12,18 @@ var _problems: Array = []
func check(cond: bool, msg: String) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
if not cond:
_problems.append(msg)
func _init() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
_smoke_settle_zero_rows()
func _smoke_settle_zero_rows() -> void:
# 判据出处: design/gdd/08-Alpha版本标准.md:154 战斗演出链（弹道 / 受击 / 血条 / 灰化）在役；
# 判据出处: design/gdd/08-Alpha版本标准.md「五、表现」事实源 事实源（弹道 / 受击 / 血条 / 灰化）在役；
# 逐行结算排播行已随 v1.29 退役——结算期 B 区零逐行文字、FX 排播链保持
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
@@ -96,7 +96,7 @@ func _count_row(row: Dictionary, arr: Array) -> void:
func _finish() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
for p in ["user://test_log_zero_text_save.json", "user://test_log_zero_text_save.json.tmp"]:
if FileAccess.file_exists(p):
DirAccess.remove_absolute(p)
game/tests/unit/presentation/battle_narrator_test.gd
+7 -7
View File
@@ -18,7 +18,7 @@ class _BossRunner:
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:260 （战斗叙述宿主——装载组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「信号载荷契约：消息带着当场就能用的数据来」核心发给呈现的每份消息都必须 核心发给呈现的每份消息都必须（战斗叙述宿主——装载组）
_test_numeric_lines_carry_values()
_test_end_text_differs_by_result()
_test_phase_text_nonempty()
@@ -29,7 +29,7 @@ func _init() -> void:
func _test_numeric_lines_carry_values() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （结算行数值带入组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（结算行数值带入组）
var rest: String = NarratorScript.rest_line(12, 30, 40)
Kit.check("休整叙述带入回复量与当前血量（实际「%s」）" % rest,
rest.contains("12") and rest.contains("30") and rest.contains("40"))
@@ -40,7 +40,7 @@ func _test_numeric_lines_carry_values() -> void:
func _test_end_text_differs_by_result() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （胜负互异文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（胜负互异文案组）
# 关卡收束（level_end=true）恒为「关卡完成！」——单场胜负文案只在非收束态出现
var level: String = NarratorScript.battle_end_text("lose", true)
Kit.check("关卡收束态恒为「关卡完成！」（实际「%s」）" % level, level == "关卡完成！")
@@ -53,7 +53,7 @@ func _test_end_text_differs_by_result() -> void:
func _test_phase_text_nonempty() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （阶段行非空组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（阶段行非空组）
var t: String = NarratorScript.phase_text(1, "", false, false, "")
Kit.check("相位叙述非空（实际「%s」）" % t, t != "")
var boss: String = NarratorScript.phase_text(2, "", false, true, "灰矮人石君王")
@@ -63,7 +63,7 @@ func _test_phase_text_nonempty() -> void:
# 叙述寻址按行类取 Boss 行集（S 清单 S15 换代）：Boss 节点名必须来自 (关卡, boss, 带) 行集，
# 不能落到同深度的战斗行集——期望名由表行集首行读出，不写死字面量。
func _test_boss_name_uses_boss_rowset() -> void:
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md:295 （Boss 名读行集组）
# 判据出处: design/gdd/systems/战斗循环/敌人系统.md「调参表」Boss Boss（Boss 名读行集组）
var db = load("res://core/config_db.gd").new()
var loaded: bool = db.load_tables("res://data/tables", false)
Kit.check_quiet(loaded, "叙述寻址用例：数值表加载成功")
@@ -92,7 +92,7 @@ func _test_boss_name_uses_boss_rowset() -> void:
# 关卡完成停点文案族措辞钉子（口径换代批）：回血行/满血合法态/渠道句/摘要关数行——
# 旧措辞退役后玩家可见面由本组断言钉在新措辞上（撤销证明：回退 battle_narrator 对应行→断言红→复原复绿）
func _test_level_clear_wording() -> void:
# 判据出处: design/ux/level-clear.md:11 （关卡结算屏文案组）
# 判据出处: design/ux/level-clear.md「Purpose & Player Need」关卡结算屏是关卡收束时刻的清算与 关卡结算屏是关卡收束时刻的清算与（关卡结算屏文案组）
var healed: String = NarratorScript.curio_pick_header({"level_index": 1, "heal_gained": 5, "hp_before": 10, "hp_after": 15})
Kit.check("关卡完成回血行带入回血量与生命区间（实际「%s」）〔口径换代 V1〕" % healed,
healed.contains("关卡完成回血 +5（生命 10 → 15）"))
@@ -112,7 +112,7 @@ func _test_level_clear_wording() -> void:
# 真实入口=呈现状态快照函数 presentation_snapshot：A 有削弱 B 无 → 两卡投影各现各的（零共享引用）
func _test_snapshot_effects_per_unit() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var db = load("res://core/config_db.gd").new()
Kit.check("V8 前置：表加载零 error", db.load_tables("res://data/tables", true) and db.diagnostics_count("error") == 0)
var rng = load("res://core/rng_service.gd").new()
game/tests/unit/presentation/camp_scene_layout_test.gd
+4 -4
View File
@@ -10,19 +10,19 @@ const _EXPECTED_KEYS: Array[StringName] = [&"gate", &"forge", &"dummy", &"chest"
func _initialize() -> void:
# 判据出处: design/ux/camp.md:29 （营地场景布局数据件——纵深与地平线组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（营地场景布局数据件——纵深与地平线组）
call_deferred("_run_all")
func _run_all() -> void:
# 判据出处: design/ux/camp.md:29 （套件统一收尾——双测试函数单进程单 quit）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（套件统一收尾——双测试函数单进程单 quit）
await _test_layout_hotspot_geometry()
await _test_hud_band_contrast_over_bg()
quit(Kit.finish("camp_scene_layout_test", "PASS — 布局几何＋顶栏栏体对比 全过"))
func _test_layout_hotspot_geometry() -> void:
# 判据出处: design/ux/camp.md:16 （七物件命中区几何红线组）
# 判据出处: design/ux/camp.md「场景构成与七物件绑定」半开的门扇 半开的门扇（七物件命中区几何红线组）
var table: CampSceneLayoutTable = load("res://data/tables/camp_scene_layout.tres")
Kit.check("V14 布局表加载且 schema 类在位〔营地图批 V14〕", table is CampSceneLayoutTable and table != null)
if table == null:
@@ -126,7 +126,7 @@ func _test_layout_hotspot_geometry() -> void:
# 按规格句在测试内写死 #6E4526 与 α0.80，与背景贴图顶带实测均色做 α 合成后算 WCAG 对比 ≥3.0。
# 禁把视图件的 color 直接当预期值喂进算式（判据镜像——test-conventions §8.7 判红）。
func _test_hud_band_contrast_over_bg() -> void:
# 判据出处: design/ux/camp.md:41 （顶栏栏体定值——对落位带底色对比 ≥3:1 组）
# 判据出处: design/ux/camp.md「顶栏」钥石余额常驻画面顶部一行小 钥石余额常驻画面顶部一行小（顶栏栏体定值——对落位带底色对比 ≥3:1 组）
var table: CampSceneLayoutTable = load("res://data/tables/camp_scene_layout.tres")
var band_h := 48
if table != null:
game/tests/unit/presentation/confirm_dialog_test.gd
+3 -3
View File
@@ -10,7 +10,7 @@ const ConfirmDialogScript := preload("res://presentation/views/confirm_dialog.gd
func _initialize() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:90 （确认弹窗按钮位次定值——位次与语义同钉组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（确认弹窗按钮位次定值——位次与语义同钉组）
call_deferred("_run")
@@ -27,7 +27,7 @@ func _find_btn_row(node: Node) -> HBoxContainer:
func _test_two_button_row_order() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:90 双钮形态位次=推进在左、维持在右（两钮同钉组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族、维持在右（两钮同钉组）
var ov: Control = ConfirmDialogScript.new()
root.add_child(ov)
ov.open("t", "推进", "维持")
@@ -40,7 +40,7 @@ func _test_two_button_row_order() -> void:
func _test_three_button_row_order() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:90 三钮形态位次=推进/次推/维持（三钮同钉组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「提示与弹层：轻提示随起随消、重弹层排队进出」界面弹出的东西分两族 界面弹出的东西分两族（三钮同钉组）
var ov: Control = ConfirmDialogScript.new()
root.add_child(ov)
ov.open_three("t", "推进", "次推", "维持")
game/tests/unit/presentation/forge_workbench_test.gd
+2 -2
View File
@@ -10,7 +10,7 @@ const _TEST_SAVE := "user://test_forge_workbench.json"
func _initialize() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:219 （工作间两区六路线——装载组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」本节判据全部绑结构与关系 本节判据全部绑结构与关系（工作间两区六路线——装载组）
call_deferred("_run")
@@ -22,7 +22,7 @@ func _row_by_id(ov) -> Dictionary:
func _run() -> void:
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md:219 （六路线 UI 直验组）
# 判据出处: design/gdd/systems/跨局循环/锻造工坊.md「验收标准」本节判据全部绑结构与关系 本节判据全部绑结构与关系（六路线 UI 直验组）
var db = load("res://core/config_db.gd").new()
var load_ok: bool = db.load_tables("res://data/tables", true)
if not load_ok:
game/tests/unit/presentation/hud_presenter_test.gd
+4 -4
View File
@@ -9,7 +9,7 @@ const HudScript := preload("res://presentation/hud_presenter.gd")
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:260 （HUD 投影宿主——装载组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「信号载荷契约：消息带着当场就能用的数据来」核心发给呈现的每份消息都必须 核心发给呈现的每份消息都必须（HUD 投影宿主——装载组）
_test_accepted_text()
_test_reject_text_by_reason()
_test_unknown_reason_fallback()
@@ -17,13 +17,13 @@ func _init() -> void:
func _test_accepted_text() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:212 （受理反馈呈现组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「设计目的」归因得了的界面 归因得了的界面（受理反馈呈现组）
var t: String = HudScript.outcome_text({"accepted": true})
Kit.check("受理态文案固定为「执行完成。」（实际「%s」）" % t, t == "执行完成。")
func _test_reject_text_by_reason() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:212 （拒绝三源可辨文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「设计目的」归因得了的界面 归因得了的界面（拒绝三源可辨文案组）
var cases := {
"not_adjacent": "不能执行：目标与小人不相邻",
"target_revealed": "不能执行：目标已开",
@@ -43,7 +43,7 @@ func _test_reject_text_by_reason() -> void:
func _test_unknown_reason_fallback() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:212 （未知兜底文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「设计目的」归因得了的界面 归因得了的界面（未知兜底文案组）
var t: String = HudScript.outcome_text({"accepted": false, "reject_reason": "brand_new_reason"})
Kit.check("未知拒绝原因兜底为「动作被拒。」而非空串（实际「%s」）" % t, t == "动作被拒。")
var sub: String = HudScript.outcome_text({
game/tests/unit/presentation/level_map_info_fog_test.gd
+8 -8
View File
@@ -11,12 +11,12 @@ const ScreenScript := preload("res://presentation/views/level_map_screen.gd")
func _initialize() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （信息迷雾呈现宿主——装载组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（信息迷雾呈现宿主——装载组）
call_deferred("_run")
func _run() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （迷雾显隐宿主组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（迷雾显隐宿主组）
var db = load("res://core/config_db.gd").new()
var loaded: bool = db.load_tables("res://data/tables", false)
Kit.check_quiet(loaded, "迷雾呈现用例：数值表加载成功")
@@ -48,7 +48,7 @@ func _runner(db, nodes: Array, candidates: Array, n: int = 2):
# ---- ① 范围外只见结构：雾下节点类型图标与文字均不绘制〔fv2〕----
func _test_fog_hides_type() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （雾下类型隐藏组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（雾下类型隐藏组）
var node := {"id": 3, "type": "battle", "depth": 3, "next": []}
var shown: Dictionary = ScreenScript.node_display(node, 2, [2], false, false)
Kit.check("可见集内节点：图标/类型文字均绘制〔fv2〕",
@@ -62,7 +62,7 @@ func _test_fog_hides_type() -> void:
# ---- ② Boss/终点不入雾＋多终点标记〔fv3〕----
func _test_boss_exempt_and_multi_boss() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （Boss 描边豁免与多 Boss 组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」Boss Boss（Boss 描边豁免与多 Boss 组）
var type_vis: Array = [1, 7, 9] # 双 Boss 图：7/9 均在可见集
var boss_a: Dictionary = ScreenScript.node_display({"id": 7, "type": "boss", "depth": 7, "next": []}, 7, type_vis, false, false)
var boss_b: Dictionary = ScreenScript.node_display({"id": 9, "type": "boss", "depth": 9, "next": []}, 9, type_vis, false, false)
@@ -80,7 +80,7 @@ func _test_boss_exempt_and_multi_boss() -> void:
# ---- ③ 节点内详情图上从不显示〔fv5〕----
func _test_details_never_shown() -> void:
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md:178 （详情零显示组）
# 判据出处: design/gdd/systems/冒险循环/关卡节点地图.md「验收标准」行集通过加载校验 行集通过加载校验（详情零显示组）
var plain := {"id": 3, "type": "battle", "depth": 3, "next": [4]}
var loaded := {"id": 3, "type": "battle", "depth": 3, "next": [4], "enemy_id": "goblin_secret", "reward_id": "reward_secret"}
var a: Dictionary = ScreenScript.node_display(plain, 3, [3], false, true)
@@ -97,7 +97,7 @@ func _test_details_never_shown() -> void:
# ---- ④ label_text 三态文案〔fv2〕----
func _test_label_three_states() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var node := {"id": 3, "type": "battle", "depth": 3, "next": [4]}
Kit.check("当前位文案＝「当前位置」〔fv2〕",
String(ScreenScript.node_display(node, 3, [3], true, false)["label_text"]) == "当前位置")
@@ -150,7 +150,7 @@ func _big_graph_nodes() -> Array:
func _test_big_graph_fit(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var nodes := _big_graph_nodes()
var entry: Dictionary = nodes[0]
var runner = _runner(db, nodes, [nodes[1]])
@@ -204,7 +204,7 @@ func _test_big_graph_fit(db) -> void:
# 命中读数 = is_same 同实例判别（重算必产新字典、命中返回缓存原实例）——零生产计数器。
func _test_layout_cache(db) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var nodes := _big_graph_nodes()
var runner = _runner(db, nodes, [nodes[1]])
var screen = ScreenScript.new()
game/tests/unit/presentation/modal_flow_test.gd
+1 -1
View File
@@ -11,7 +11,7 @@ const ModalStackScript := preload("res://presentation/modal_stack.gd")
func _init() -> void:
# 判据出处: design/engineering/code-conventions.md:54 （模态编排纯逻辑——层级与输入锁组）
# 判据出处: design/engineering/code-conventions.md「2.3 模态覆盖层层级规则」打开任何模态覆盖层时 打开任何模态覆盖层时（模态编排纯逻辑——层级与输入锁组）
# 哑层与桩 Callable（纯逻辑类零场景前提的证明面）
var start := Control.new()
var inter := Control.new()
game/tests/unit/presentation/pacing_queue_test.gd
+6 -6
View File
@@ -44,13 +44,13 @@ class FakeFx extends SettlementFxView:
func check(cond: bool, msg: String) -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
if not cond:
_problems.append(msg)
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （排播节奏——排空零分叉/零丢行/延迟双态组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（排播节奏——排空零分叉/零丢行/延迟双态组）
var main: Node = load("res://presentation/main.tscn").instantiate()
root.add_child(main)
await process_frame
@@ -157,8 +157,8 @@ func _count_row(row: Dictionary, arr: Array) -> void:
# FX 排播链断言（逐行文字列表退役后的行落地面——〔退役改 V-退役卡 R2〕）：
# 判据出处: design/ux/battle.md:439 动效：结算逐行兑现为信息载体不可整体跳过，可加倍（减动效只调时长）
# 判据出处: design/gdd/08-Alpha版本标准.md:154 战斗演出链（弹道 / 受击 / 血条 / 灰化）在役
# 判据出处: design/ux/battle.md「Transitions & Animations」进入战斗屏 进入战斗屏，可加倍（减动效只调时长）
# 判据出处: design/gdd/08-Alpha版本标准.md「五、表现」事实源 事实源（弹道 / 受击 / 血条 / 灰化）在役
# 真实行集（夹具采样的 step_row 载荷）驱动独立 RowPacer，断言：
# ① 每行恰好一拍站桩反馈（on_step_row_fx 计数=行数）；② 弹道/标出调用计数与行型分布逐位对上
# （期望从行集独立推导、实际从记参假件读——不镜像实现）；③ 断言前提=行集非空（非空自检）。
@@ -188,7 +188,7 @@ class FakeBoardZone extends BoardZoneView:
func _assert_fx_chain(main: Node, rows_seen: Array) -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （结算逐行实时滚出——行→FX 排播链计数逐位一致）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（结算逐行实时滚出——行→FX 排播链计数逐位一致）
var rp = RowPacerScript.new()
var fstage := FakeStage.new(null, root.get_node("/root/ConfigDB").presentation.battle_layout)
var ffx := FakeFx.new()
@@ -262,7 +262,7 @@ func _assert_fx_chain(main: Node, rows_seen: Array) -> void:
func _finish() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
for p in ["user://test_pacing_queue_save.json", "user://test_pacing_queue_save.json.tmp"]:
if FileAccess.file_exists(p):
DirAccess.remove_absolute(p)
game/tests/unit/presentation/palette_token_pairwise_test.gd
+2 -2
View File
@@ -57,7 +57,7 @@ const EXEMPT_LEDGER := {
func _init() -> void:
# 判据出处: design/art/art-bible.md:220 （色板增量纪律条——存量两两互查组）
# 判据出处: design/art/art-bible.md「4.1 主色板」色板增量纪律条 色板增量纪律条（色板增量纪律条——存量两两互查组）
_test_pairwise()
quit(Kit.finish("palette_token_pairwise_test"))
@@ -78,7 +78,7 @@ func _hex(c: Color) -> String:
# 存量两两互查：豁免账外零近色对（扫描面>0 前置防静默绿）
func _test_pairwise() -> void:
# 判据出处: design/art/art-bible.md:220 （色板增量纪律条——存量两两互查组）
# 判据出处: design/art/art-bible.md「4.1 主色板」色板增量纪律条 色板增量纪律条（色板增量纪律条——存量两两互查组）
var tokens := _token_colors()
Kit.check("token 面非空（扫描面>0）〔token互查 V1〕", tokens.size() >= 40)
var names: Array = tokens.keys()
game/tests/unit/presentation/player_copy_sweep_test.gd
+8 -8
View File
@@ -23,7 +23,7 @@ var _db
func _init() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:281 （玩家面文案清扫宿主——装载组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（玩家面文案清扫宿主——装载组）
_db = ConfigDBScript.new()
var load_ok: bool = _db.load_tables("res://data/tables", true)
if not load_ok:
@@ -43,7 +43,7 @@ func _init() -> void:
# ① C 区两段头（u1/u2——直建 hero 面板，adventure_feats_test ⑦c 族同构）
func _sweep_hero_panel() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:274 （英雄面板文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（英雄面板文案组）
var panel = load("res://presentation/views/hero_info_panel_view.gd").new(_db.presentation.battle_layout)
var feat_head := _first_label(panel._feat_section)
var curio_head := _first_label(panel._curio_section)
@@ -55,7 +55,7 @@ func _sweep_hero_panel() -> void:
# ②③ 奖励节点头部＋专长卡兜底（u3/u11——静态直调）
func _sweep_narrator() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:272 （叙述文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（叙述文案组）
var narrator = load("res://presentation/battle_narrator.gd")
var head := String(narrator.node_curio_header())
Kit.check("奖励点头部含「冒险牌库」（u3 机制事实①同库）〔wa4〕", head.contains("冒险牌库"))
@@ -68,7 +68,7 @@ func _sweep_narrator() -> void:
# ④ 图例封印行（u4——直建 LegendOverlay 读 ENTRIES 常量）
func _sweep_legend() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:267 （图例文案组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「核心规则」本章七节 本章七节（图例文案组）
load("res://presentation/views/legend_overlay.gd").new() # 直建（_init(rap_cost) 现签名）
var seal_row: Array = []
for e in load("res://presentation/views/legend_overlay.gd").ENTRIES:
@@ -87,7 +87,7 @@ func _sweep_legend() -> void:
# ⑤⑥ 来源名双源（u5/u6——状态槽消费半＋表值 ConfigDB 真装载＋battle_log 行消费半）
func _sweep_source_names() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:274 （来源名读表组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（来源名读表组）
var row_view = load("res://presentation/views/status_slot_row.gd").new()
row_view.set_effects([{"effect_id": "alert", "source_class": "mine_hit",
"display_name": "危险格受击", "remaining_settlements": 2, "round_index": 1}])
@@ -119,7 +119,7 @@ func _sweep_source_names() -> void:
# ⑦⑧ 已开危险格字形族（u7/u8/u9——BoardView rebuild 真实刷新路径＋源 token 扫描）
func _sweep_board_glyph() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:264 （危险格字形组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「验收标准」以下判据逐条可测 以下判据逐条可测（危险格字形组）
var board_generator = load("res://core/board_generator.gd").new()
var b = board_generator.generate(1, 0, _mk_stream("board_gen", 4242), _db)
var ae = load("res://core/action_economy.gd").new(_db)
@@ -158,7 +158,7 @@ func _sweep_board_glyph() -> void:
# ⑧⑩ 源 token 扫描（注释剥离=行首 # 判——契约 2 保留面不入域）
func _sweep_token_scans() -> void:
# 判据出处: design/engineering/test-conventions.md:56 （判定上报通道——验证函数组）
# 判据出处: design/engineering/test-conventions.md「5. 测试函数怎么写——验收清单条目的落码规范」需求卡片 需求卡片（判定上报通道——验证函数组）
var board_src := FileAccess.get_file_as_string("res://presentation/views/board_view.gd")
Kit.check("board_view.gd 源零 \"雷\" 字面量（u7/u8/u9 哨兵族统一钉住）〔wa8〕",
board_src.count("\"雷\"") == 0)
@@ -176,7 +176,7 @@ func _sweep_token_scans() -> void:
# 刷新两 toast 文案零数字字面量（架构整改 R4——格式串零数字、插值位与表字段一一对应；
# 静态判据＋评审注记观测面局限：真机文案随表值由实机目检兜——T10 清单两项）
func _sweep_refresh_toast_no_literals() -> void:
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md:260 （刷新提示读表拼接——零字面量组）
# 判据出处: design/gdd/systems/表现与支撑/HUD框架.md「信号载荷契约：消息带着当场就能用的数据来」核心发给呈现的每份消息都必须 核心发给呈现的每份消息都必须（刷新提示读表拼接——零字面量组）
var main_src := FileAccess.get_file_as_string("res://presentation/main.gd")
var rap_toast := ""
var cap_toast := ""
Loaded 100 of 124 files, more files were not shown because too many files have changed in this diff. Show more