文档(测试判据升级): 单元层写法判据落文——「测试直接调用被测函数」升为「从领域类对外方法进、断言钉对外可观测面(返回值/信号/查询接口/落盘内容)」,内部字段直查降受控例外(无公开可观测面可钉才允许、对照表注明理由;存量不回头清扫、被批次触碰时顺带换代);§8.7 审计三件事→四件事(增核受控例外申报);README 层级表单元行判什么对齐+集成节立集成旅程清单(现状五行:存档⇄RNG往返/旧档迁移续玩/断点附随件与事件日志/关卡图断点重生成同图/回放确定性parity闸11,登记批按git考据:两件出身断言迁移批2026-10-23);architecture v1.21 测试域三层承载表单元行同步;待办清单登记「测试判据升级」条目(批1落文+批2试点归位,2026-10-28 plan批准+草案过目后落笔)

design/engineering/architecture/architecture.md

@@ -2,8 +2,8 @@
 
 ## 文档状态
 
-- 版本：1.20
+- 版本：1.21
-- 最近更新：2026-10-28（迭代 39 反哺落文——冒险域拆件三新件转已实装登记＋RunLedger 退役注记＋拆分定稿节转现状＋unit_container 补 check_trigger_unlocks）
+- 最近更新：2026-10-28（测试判据升级——测试与质量域三层承载表单元行判什么对齐新写法判据：从对外方法进、钉对外可观测面，判据正文归 test-conventions §8.2）
 - 引擎：Godot 4.7.2-stable（GDScript 单语言；2026-09-07 锁定）
 - 评审模式：solo（`review-mode.txt`，2026-09-12 用户拍板——TD/LP 门禁按 solo 跳过，用户授权架构产出自主推进、迭代期回调）
 - 覆盖 GDD：现行全集（根索引＝`design/gdd/02-系统清单.md`，文档树构成以根索引为准）
@@ -285,7 +285,7 @@
 | 层 | 判什么 | 承载 | 入闸 |
 |---|---|---|---|
 | 冒烟测试 | 这版活着吗（零逻辑判定） | `game/tests/smoke_boot.tscn/.gd` | `run_smoke.py`（闸 00） |
-| 单元测试 | 最单元的逻辑代码对不对 | `game/tests/unit/` | `run_all.gd`（闸 02） |
+| 单元测试 | 领域类的原子行为对不对（从对外方法进、钉对外可观测面——写法判据归 test-conventions §8.2） | `game/tests/unit/` | `run_all.gd`（闸 02） |
 | 集成测试 | 跨系统闭环对不对 | `game/tests/integration/` | 同上（同一入口同一协议） |
 | 系统测试 | 真实玩法路径断言面 | `game/tests/system_test.gd` | `run_system_test.py`（闸 01） |
 | UI 探针＋渲染 golden | 场景切换与观感 | `game/probe/*.tscn` 探针 | `probe_gate.sh`（闸 03/04）、`render_gate.sh`（闸 05） |

design/engineering/test-conventions.md

@@ -76,8 +76,8 @@
 
 ### 8.2 四层与真实入口
 
-- **单元**：不依赖场景树和真实宿主的纯逻辑；测试直接调用被测函数。
+- **单元**：不依赖场景树和真实宿主的纯逻辑；测试从领域类的对外方法进出，断言钉对外可观测面（返回值／信号／查询接口／落盘内容）。内部字段直查＝受控例外：仅当该行为没有公开可观测面可钉时允许，对照表该行注明理由；存量不回头清扫，被批次触碰时顺带换代。
-- **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。
+- **接口**：模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口；测试从公开入口进出。接口级断言随单元套件落（`unit/contracts/`），不另设承载目录。
 - **集成**：跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩；测试必须实例化真实宿主链，禁止用裸 EffectEngine 代替。
 - **探针/golden**：玩家可达性与观感；真实实例化场景、驱动真实输入。
 
@@ -117,11 +117,12 @@
 
 ### 8.7 独立验收审计
 
-合并前由没有参与实现的会话或子代理做一次审计。审计只读需求卡片、实际对照表、diff、测试文件和实现报告，自己跑最窄测试抽查，不采信报告里的「已全绿」。审计至少做三件事：
+合并前由没有参与实现的会话或子代理做一次审计。审计只读需求卡片、实际对照表、diff、测试文件和实现报告，自己跑最窄测试抽查，不采信报告里的「已全绿」。审计至少做四件事：
 
 1. 逐行核对对照表：测试存在、真的执行、尾缀能 grep 到、真实入口没有绕过改动点；
 2. 抽查撤销证明：每张任务卡至少一条，按记录复现红/绿；
 3. 检查测试削弱：删除断言、放宽阈值、缩小扫描面、换下层直调，逐处要卡片申报或用户批准。
+4. 核对内部字段直查的受控例外：直查行是否已在对照表注明理由（该行为无公开可观测面可钉）。
 
 审计报告落 `reports/iter<N>-验收审计-<日期>.md`，逐行写「通过／缺漏／例外及依据」。未通过不得合并。测试执行两入口铁规不变：审计在迭代 loop 内启动的子代理算 loop；另开会话须用户点名。
 

game/tests/README.md

@@ -30,7 +30,7 @@ tests/
 | 层 | 判什么 | 承载 | 入闸方式 |
 |---|---|---|---|
 | **冒烟测试** | 这版活着吗——能否启动、能否加载表、能否进主屏。零逻辑判定 | `tests/smoke_boot.tscn/.gd`（以项目运行目标拉起＝真实开机路径） | `run_smoke.py`（闸 00） |
-| **单元测试** | 最单元的逻辑代码对不对（公式/状态机/纯逻辑） | `tests/unit/` | `run_all.gd` manifest（闸 02） |
+| **单元测试** | 领域类的原子行为对不对（公式/状态机/纯逻辑）——从对外方法进、断言钉对外可观测面（写法判据见 test-conventions §8.2） | `tests/unit/` | `run_all.gd` manifest（闸 02） |
 | **集成测试** | 跨系统的闭环对不对 | `tests/integration/` | 同上（与单元测试同一入口、同一协议） |
 | **系统测试** | 启动真实工程走真实玩法路径 | 过渡期 `game/probe/smoke_all.gd`（断言迁移批后＝`tests/system_test.gd`） | `run_system_test.py`（闸 01） |
 | **UI 探针＋渲染 golden** | 跑起来之后 UI 与场景切换对不对；画面基线 | `game/probe/*.tscn` 探针 | `probe_gate.sh`（闸 03/04）、`render_gate.sh`（闸 05） |
@@ -43,6 +43,18 @@ tests/
 > **分层判据**：能不能在 `--script` 模式下不加载 autoload 就验完？能 = 单元测试；
 > 需要两个以上真实系统协同并走落盘/落库 = 集成测试；需要完整项目引导与场景树 = 冒烟／系统／UI 探针。
 
+**集成旅程清单**（2026-10-28 立——跨域旅程用例的登记处：一个行为穿过多个领域的对外方法＝旅程，验收落本层；缺口旅程由属主批/工程债批按批落用例后回填本表）：
+
+| 旅程 | 涉及边界 | 现行覆盖 | 缺口 | 登记批 |
+|---|---|---|---|---|
+| 存档⇄RNG 快照往返保真 | SaveManager×AdventureRunner×RngService | `save_rng_roundtrip_test.gd` 用例一（闸 02） | — | 迭代 29 T3 |
+| 旧档迁移后断点续玩零跳号 | SaveManager 迁移链×AdventureRunner×BoardGenerator | `save_rng_roundtrip_test.gd` 用例二（闸 02） | — | 迭代 29 T3 |
+| 断点附随件与事件日志会话 | AdventureRunner×SaveManager×日志面 | `cross_system_flow_test.gd`（闸 02） | 盘点候选 | 断言迁移批（2026-10-23） |
+| 关卡图断点重生成同图/生成图确定性 | LevelRunner×节点图生成器×AdventureRunner | `node_map_determinism_test.gd`（闸 02） | — | 断言迁移批（2026-10-23，迭代 35 卡②随动换代） |
+| 回放确定性（同种子逐位） | 全玩法链 | `parity_anchor.py`（闸 11 条件闸） | — | 迭代 29 T3 收编为条件闸件 |
+
+候选旅程盘点方法：源＝architecture「API 边界」表逐行＋「数据流」存档/读档路径＋各 GDD 登记的 deferral 集成用例；新旅程先登记「缺口」列，用例按批落地后回填「现行覆盖」。
+
 ## 断言计数双口径（2026-10-08 迭代 19 卡① T4 订正）
 
 历史 README 写死「752+ 断言/十五套件」必然漂移，改为两种口径并注明语义：

reports/iter40-验收审计-2026-10-28-卡①卡②.md

@@ -75,6 +75,8 @@
 
 **收口补记（2026-10-28，审计对象树→合并树）**：master 在交接单快照（a8025945）后又推进至 6326b083——EV 重锚批（round_flow goblin 带宽 [1.00,1.20]→[0.82,1.02]＋enemy.tres 表注＋baseline 02 存量红归绿，ba5105aa）与术语批尾（三件测试夹具哥布林→地精）。iter40 已在 worktree 并入当前 master（合并提交 0166df26；验证集清单.md 双侧同表行冲突＝在合并树重跑 extract_checks 机器重生成解，68 源/1604 调用点；两件 .gd 夹具术语行与拆件改址异段自动合并；F1 修复 8a319369 在合并前已入库）。合并树与本报告审计树（be1498ac）的差异全部为 master 侧字串/注记/基线记账面——断言语义零变化，本报告各项判定不受影响。02 存量红已在 master 侧清偿；验收闸的「在册存量红」预期＝08d 引用可核（docs 域）＋09 指纹（记账落位前）。
 
+**合回核验实况（2026-10-28 收口落账）**：①闸 09 指纹记账已落位（iter40 `33a45339`：91d45583cf6d→8467b4588a20，按闸壳同款算法对用户探跑日志实算，红项 2 条收敛为 1 条＝只降不升；与合并后 master 树实测红集一致——battle_orchestrator 行数红项随拆件还债消失，level_map_screen 22＞21 存量归迭代41 卡③）。②master 在收口期三次前移（6326b083 EV 重锚＋术语批尾／21cd0f2e 挂死防护·probe_gate 件／6139d2de 迭代39 批后收尾，另有 c5382032 bp 对拍载体退役），iter40 已在 worktree 全数并入（0166df26／185bf815／95a86cee，仅验证集清单.md 一次冲突＝机器重生成解），各 master 侧批均自带在册代码域回执。③**全量域验收回执未取得＝用户 2026-10-28 特许免闸直合**（用户原话「不用跑了；我特许的」）——合回由用户本人执行（合并提交 `514457d1`，`--no-ff` 带消息，守卫对用户手工合并不设防）；本报告审计判定不受影响，但「合回前独立审计通过＋所选域全绿」的标准链在回执环节断于用户特许，如实记档不作绿报。
+
 ## 结论
 
-**通过**——附 F1（非阻塞缺漏，建议验收闸前一行修正，交用户裁）、F2/F3（记录性例外）。未过项零。
+**通过**——F1 已按用户裁修复入库（iter40 `8a319369`）；F2/F3 记录性例外；未过项零。合回实况见「合回核验实况」（全量回执环节＝用户特许免闸，非审计判通过）。

待办清单.md

@@ -2,6 +2,18 @@
 
 本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
 
+#### 测试判据升级——单元层对外方法判据落文与试点归位（2026-10-28 登记，来源=会话提及）
+
+**实况**：2026-10-28 会话「单元/接口测试分层讨论」结论落文＋试点。证据＝design/engineering/test-conventions.md §8.2 单元层现行条文（「测试直接调用被测函数」，函数高度低于对外方法）＋unit/integration 存量内部直查实测量（407 行私有成员命中，对照 1947 个 `Kit.check` 调用点，2026-10-28 本会话 grep 实测）。判据=单元层写法从「测试直接调用被测函数」升为「从领域类对外方法进、断言钉对外可观测面」，内部字段直查降为受控例外（存量不回头清扫、被批次触碰时顺带换代）；跨域旅程验收落位集成层，game/tests/README.md 集成节建集成旅程清单（首版登记现状四行＋盘点方法，缺口旅程按批落用例）；随后立试点 worktree 批（选一个内部直查典型且无需动产品码的单元套件按新判据归位）完成新判据首次真实评估。实施计划已于 2026-10-28 过 plan 模式批准；判据条文草案在落文前呈用户过目。改动文件面：
+- design/engineering/test-conventions.md（§8.2 单元/接口层定义、§8.7 审计核对项）
+- game/tests/README.md（测试层级表单元行判什么、集成节新增集成旅程清单）
+- design/engineering/architecture/architecture.md（测试与质量域三层承载表单元行同步）
+- game/tests/unit/ 试点套件一件（批 2 选件呈报后定）
+
+**改动面**：文档＋游戏代码
+
+**状态**：待执行
+
 #### gdstyle 存量债全量清偿——216 键按病根分波整改（2026-10-26 登记，来源=会话提及，优先级＝P0）
 
 **实况**：S13 闸实测存量债 216 键／60 文件（2026-10-26，master f3b148ce，gdstyle v0.4.0 默认阈值；基线登记 234 键＝实存 216＋陈旧 18）。全量清单、波次方案与纪律见清点报告（本条目裁决源）。2026-10-26 用户裁：撤销「一条总账」与「按病根拆多条」两案，并为本条单账（存量债全部清除，紧急优先级）；原「gdstyle 基线陈旧键待人工清理」条目并入波 0（基线对账刷新），原「结构审查未立项小件候审」条目并入波 7（卡已写；iter38 施工停卡后经用户裁于 2026-10-26 修订定稿 v1.3，待编排）。**2026-10-26 设计段闭合（逐波裁定全数落定）**：①段组织＝逐波开设计段，纯代码波（波 0/2/3/4/5/6/8）写卡前确认零设计改动＋按当时 master 重测读数即可写卡；②波 2 各文件内部拆、波 6 视图内部拆私有函数、波 8 config_db 纯代码收敛（三处零设计改动）；③波 1 拆件定稿＝轴甲两件——battle_orchestrator 拆出 BattleFxHost（效果引擎宿主域）＋RewardGrant（奖励授予域），宿主保留状态机/facts 缓冲/订阅/段驱动/行发射基建/呈现投影，attune 族原位保留（迭代 39 副卡语义领地），emit 经 bind 注入 Callable，行数恶化债（c4c69701 挂账）本波还债归绿，残留债「改善非清零」口径预计 8–10 键；定稿落文 architecture.md v1.18（功能层两新件行＋「战斗编排域拆件定稿」节）；**同日独立审查折入**（grilling＋godot-master 双子代理并行、双判回炉补裁级——骨架成立、接线未闭合）：阻断 8 条去重 6 组＋建议 5 条全数折入 v1.18——跨件单向接线裁死（RewardGrant 持 fx 件引用/fx 兑付走注入 Callable，禁 RefCounted 环）、settlement/ 段类随动（直持三引用封转发壳）、12 随迁键卡内收敛义务（禁波 0 refresh 吸收）、两新件消费依赖列补全＋引用束注入、treasure_interact_controller 三触点分家（现值回调双取值面）、_fx_revealing 再入闸归 fx 件（裁定全文见清点报告 §六第 6 条）；④全部波不改游戏规则与玩家可见行为，design/gdd/systems/ 零修订预期；波 5 已实查落定纯代码（open_ticket 12 参＝单据声明形态）。波 7 的 wr5/wr6 验收载体重裁为写卡段用户裁点（卡 v1.2 在册，写卡补呈报）。裁定全文见清点报告 §六。**2026-10-28 交接注记（迭代 39 收尾批迁入——实现报告 §六第 6 条未决项出账）**：迭代 40 卡① 卡面接口块仍引用已退役的 RunLedger——该批 T0 须按现态改写（RunLedger 已随迭代 39 拆件批整类退役，encounter 注入面换代为桶字典＋实体账＋配装件多路）。