merge: 卡③CI预接线批落籍（2026-10-08 goal——tests.yml 轻闸三探针段解封+[main]→[master]两处死角修正+冷检出导入步前置；远端暂不建=终态待命，静态核验五判据全过；S1 setup-godot action 失效冻结呈报待裁；裁点②守约未入）

.github/workflows/tests.yml

@@ -1,15 +1,19 @@
 name: Automated Tests
 
-# 注意：仓库已初始化 git（尚无远端）——本 workflow 在首次 push 到 GitHub 后自动生效。
+# 注意：仓库已初始化 git（尚无远端）——本 workflow 在首次 push 到 GitHub 后自动生效；远端仓库建好后无需改本文件即自动生效。
 # 载体 = ADR-0004（双载体）：逻辑冒烟 + 场景探针；gdUnit4 deferred（不使用 gdUnit4-action）。
 # 外部 wall-clock 超时（timeout 命令）为 ADR-0004 硬性要求——引擎自身无死锁探测。
 # 路径口径：2026-09-27 三层收敛（7f24b640）后工程在 game/——tests 归 game/tests/、探针在 game/smoke/。
+# 轻闸探针口径（2026-10-08 CI 预接线批/迭代19卡③）：三探针=ui_input/ui_struct/ui_contrast
+#   （tools/probe_gate.sh 默认段同款）；ui_probe/ui_click/ui_tune/t17_defer/fx 归 --full 重闸不入轻 CI；
+#   窗口化四件（shot/fx_shot/board_shot/ui_audit）禁入 headless CI（无渲染面、探针内 fail-fast）；
+#   判定=timeout 外壳+退出码超时判+PASS 串判定，镜像 probe_gate 判定逻辑的 Linux 形态。
 
 on:
   push:
-    branches: [main]
+    branches: [master]
   pull_request:
-    branches: [main]
+    branches: [master]
 
 jobs:
   static-scan:
@@ -34,15 +38,38 @@ jobs:
         with:
           version: 4.7.2
 
+      # 冷检出导入（.godot 不入 git，fresh checkout 首跑一次性付清；probe_gate 本机经验 1-2 分钟）
+      - name: Import assets (cold checkout, one-time)
+        run: timeout 300s godot --headless --path game --import
+
       # 逻辑冒烟（run_all.gd 内登记套件 manifest）
       - name: Run smoke runner (external timeout per ADR-0004)
         run: timeout 120s godot --headless --path game --script res://tests/run_all.gd
 
-      # 场景探针（逐条登记，示例形态）：
+      # 场景探针（轻闸三探针=probe_gate 默认段同款；probe_gate.sh 本体系 Windows 专用
-      # - name: Run UI probes
+      #   〔PowerShell+taskkill〕CI 不可调用，此处为其判定逻辑的 Linux 独立命令形态：
-      #   run: |
+      #   每探针 timeout 外壳 + 退出码超时判〔124/137=挂死〕+ PASS 串判定〔只跑不判=违 ADR-0004〕；
-      #     timeout 60s godot --headless --path game res://smoke/ui_probe.tscn
+      #   三探针全跑不短路，末尾按汇总退出码定段红绿）
-      #     timeout 60s godot --headless --path game res://smoke/ui_click_probe.tscn
+      - name: Run scene probes (light-gate trio, timeout + PASS check per ADR-0004)
+        run: |
+          mkdir -p logs/probe_ci
+          run_probe() {
+            name="$1"; scene="$2"
+            echo "======== $name ========"
+            st=0
+            timeout 120s godot --headless --path game "res://smoke/$scene" >"logs/probe_ci/$name.log" 2>&1 || st=$?
+            tail -n 20 "logs/probe_ci/$name.log"
+            if [ "$st" -eq 124 ] || [ "$st" -eq 137 ]; then
+              echo "[ci-probe] FAIL — $name 超时挂死(exit=$st)"; return 1
+            elif ! grep -q "PASS" "logs/probe_ci/$name.log"; then
+              echo "[ci-probe] FAIL — $name 未见 PASS(exit=$st)"; return 1
+            fi
+          }
+          rc=0
+          run_probe ui_input_probe ui_input_probe.tscn || rc=1
+          run_probe ui_struct_probe ui_struct_probe.tscn || rc=1
+          run_probe ui_contrast_probe ui_contrast_probe.tscn || rc=1
+          exit $rc
 
       - name: Upload Test Results
         if: always()

active.md

@@ -904,4 +904,5 @@
 
 397. **迭代 19 五卡 goal T0 开工（2026-10-08，用户令五卡打包一次跑完——卡⓪主菜单开局缺陷修复批先行+卡①②③并发≤3+卡④收尾，全绿前禁停；本 goal 即 U0）**：定义面落籍单独一笔提交（roadmap 迭代19/20 行+06-待办清单+四任务书〔卡①自动化验收 v1.1/卡②旧界面断言回补 v1.1/卡③CI预接线 v1.2/卡④提灯载体 v1.2〕六文件入库；主区其余脏文件全属在飞遗产禁碰零触碰）；基线复读三闸全绿=冒烟 834/0 三闸过+run_all 17 套件全绿+probe_gate 含 click 全绿（残留 Godot=0）；台账预配号分配=卡⓪398/卡①399-400/卡②401/卡③402/卡④403/总收口404起（各卡记账前逐笔查撞，撞号顺延+出口报告披露）。
 398. **迭代 19 卡⓪主菜单开局缺陷修复批（2026-10-08，裁决依据=roadmap 卡⓪任务面+06-待办清单两缺陷条〔2026-10-07 用户确认成立〕；worktree g-plan2-iter19-card0 分支 iter19-card0-20261008 基点 b0a73df）**：四件全落——①主菜单开新/续玩两入口补传同调三键（main.gd 新增 static build_adventure_params :496-513 两入口共用构造，:471/:530 接线；取值与营地投影同源零新读取逻辑=装配集 save.attunement_equipped/Y 刷新池 meta.attune_refresh_charges/树 rule 键集 meta.tree_rule_keys；runner 侧受理零改动）；②关卡开场行改传当前生效值（main.gd:539-549——int(db.hero.atk/max_hp) 表值→runner.effective_atk/effective_max_hp 与战斗面板同源，「含面板加成」后缀判断追加认 meta.hero_override atk/max_hp 局外 flat，白板局不带）；③冒烟补两入口传参断言 +6 项（smoke_all.gd:4661-4687 直呼 build_adventure_params 单测统一构造面，开新/续玩×三键与来源一致+extra 并入，夹具 smoke_meta_tree 档 luck_coin+Y2 档+fg_posture a 侧，834→840）；④删 adventure_runner.gd 三行重复赋值（原 :132-134 与 :129-131 逐字重复+中间零语句+_seed_attune_charges 纯重置幂等=零行为变化，删后 run_all 直呼参数面套件零漂移佐证）。重闸三件全绿=冒烟 840 项 0 失败三闸过（+6 全系新增断言）+probe_gate 含 click 全绿（click 走查真跑主菜单开局一场冒险问题=0）+run_all 17 套件全绿+残留 Godot=0；MC 零跑静态论证在案（MC 取数面直呼 runner 不经主菜单入口零触及）；范围外三件（X/Y 双源倒置/被动同调呈现/Fork 归因行）零触碰。**披露/移交**——runner 侧 resume_adventure 受理面无 tree_rules 键（:215-217 仅两键，任务书「接收面现成」对 tree_rules 不成立）：两入口三键均已传出、续玩局 tree_rules 暂不被消费与修复前同态无回归，补一行受理即可闭环归用户裁定随后续批落。出口报告=design/qa/iter19-card0-exit-report-2026-10-08.md；提交四笔 1d2894b（①②）/fb845b7（③）/8a654cc（④+出口报告）/本笔（台账记账）。
+402. **迭代 19 卡③CI 预接线批（2026-10-08，裁决依据=任务书 v1.2 全裁〔裁点①远端仓库=暂不建维持待命/裁点② ui_layout 入 CI 候卡①后裁〕；worktree g-plan2-iter19-ciwire 分支 iter19-ciwire-20261008 基点 9160942；B6 出处=自动化验收补齐批 §一明示不收件，随本批闭环销账）**：T0-T3 全履行——tests.yml 单文件改写四件：①原 :41-45 整块注释探针段（示例 ui_probe/ui_click_probe 选型滞后）解封=正式轻闸三探针段（input/struct/contrast=probe_gate 默认段同款；每探针 timeout 120s 外壳+退出码 124/137 超时判+grep PASS 串判定〔T0 本机实跑三探针取 PASS 行样本钉死判据〕，三探针全跑不短路汇总定红绿，probe_gate 判定逻辑 Linux 独立镜像——probe_gate.sh 本体系 Windows 专用〔PowerShell+taskkill〕CI 禁调）；②冷检出导入步 `--import` 300s 前置冒烟之前（job 级基础设施步同覆盖冒烟与探针 .godot 依赖，Q9 甲）；③触发分支 push/pull_request 两处 [main]→[master] 修死角（实际分支 master、main 不存在）；④头注释保留「尚无远端」句+追加「远端仓库建好后无需改本文件即自动生效」；探针日志落 logs/probe_ci/ 顺现有 upload-artifact 段零改并入。验收全静态（本地无远端端到端不可验=红线边界）五判据全过：pyyaml 解析 OK+CI 段 res:// 引用逐一实存+timeout 外壳清单齐（300s 导入/120s 冒烟/120s×3 探针）+头注释自动生效句在位+diff 面仅 tests.yml+roadmap 账务行（游戏代码/探针件/probe_gate.sh/CLAUDE.md 零 diff=契约 1）；轻段选型锁死三件、窗口化四件与重闸五件零入（契约 2）；MC/verifier 零跑。**S1 呈报项（该段冻结未代修，处置待用户裁）=tests.yml setup-godot 步 `nikeee/godot-actions/setup-godot@v2` 指向不存在仓库**（GitHub API 404+nikeee 159 公共仓 grep godot 零命中+marketplace 同名=Vitorgus v1 Godot3 旧件+对照 actions/checkout 查询正常=API 可信；候选替代 chickensoft-games/setup-godot v2.4.3 待裁甲换 action/乙手动下载/丙挂起）——远端建好首跑前必须先裁否则 smoke job 必红；S2 未触发（兄弟卡未先行合并，master 停 9160942）；roadmap 卡③行内登记按 Q13 由主控合并时串行重放。**移交**——首次 push 后人工盯首跑清单（任务书 §七 三条+本批增补 setup-godot 前置门一条）随远端立项之日激活。出口报告=design/qa/iter19-ciwire-exit-report-2026-10-08.md；提交三笔 3799e0c（T1 tests.yml）/7397603（T3 roadmap）/本笔（出口报告+台账记账）。
 

design/qa/iter19-ciwire-exit-report-2026-10-08.md

@@ -0,0 +1,85 @@
+# 出口报告——迭代 19 卡③ CI 预接线批（2026-10-08）
+
+> 任务书=`design/research/任务书-CI预接线批-2026-10-07.md`（v1.2）；worktree=`D:\code\g-plan2-iter19-ciwire`（分支 iter19-ciwire-20261008，基点 9160942=master 顶部含卡⓪落籍）；T0-T3 全履行，S2 未触发，**S1 命中一项（呈报待裁，未代修）**。
+
+## 一、tests.yml 改动对照（T1，逐件）
+
+| # | 位置（改前→改后） | 改动 | 任务书依据 |
+|---|---|---|---|
+| 1 | 头注释（原 :3） | 原句保留，追加「；远端仓库建好后**无需改本文件即自动生效**」 | T1③ |
+| 2 | 头注释新增一段（:7-10） | 轻闸探针口径四句：三探针=input/struct/contrast（probe_gate 默认段同款）；ui_probe/ui_click/ui_tune/t17_defer/fx 归 --full 重闸不入轻 CI；窗口化四件（shot/fx_shot/board_shot/ui_audit）禁入 headless CI；判定=timeout 外壳+退出码超时判+PASS 串判定（镜像 probe_gate 的 Linux 形态） | 契约 2+§二分拣清单 |
+| 3 | `on.push.branches` / `on.pull_request.branches`（原 :10/:12） | 两处 `[main]`→`[master]`（触发分支死角修正） | T1④、Q1/Q11.3 |
+| 4 | smoke job 新增步 `Import assets (cold checkout, one-time)`（setup-godot 之后、冒烟之前） | `timeout 300s godot --headless --path game --import`——冷检出导入步，job 级基础设施步同覆盖冒烟与探针的 .godot 依赖 | T1①、Q9 甲 |
+| 5 | 原 :41-45 整块注释（示例 ui_probe/ui_click_probe）→ 正式步 `Run scene probes (light-gate trio, timeout + PASS check per ADR-0004)` | 三探针逐一登记（ui_input/ui_struct/ui_contrast），原注释位落 smoke job 内（复用同 job setup-godot，未另开 job）；每探针 timeout 120s 外壳+退出码 124/137 超时判+`grep -q "PASS"` 判定；三探针全跑不短路、汇总退出码定段红绿（镜像 probe_gate 判定流）；探针日志落 `logs/probe_ci/` | T1②、契约 5、白名单（timeout 数值/PASS 串/落位/日志并入） |
+| 6 | static-scan 段 / run_all 冒烟步 / upload-artifact 段 | **零改动**（探针日志写 logs/probe_ci/ 落入 artifact 既有 `logs/` 路径，零 diff 并入） | §三不收 |
+
+**白名单代拍记录**：导入步形态=`--import`（Godot 4.2+ 官方 CI 导入形态，弃 probe_gate 的 `--editor --quit` Windows 本机形态；300s 沿用 probe_gate 导入步同款）；timeout 数值=120s/探针（probe_gate 同款）；PASS 判定串=裸 `"PASS"`（T0 本机实跑钉死，见 §三）；探针步骤落位=smoke job 内原注释位；探针日志并入现有 artifact 段（零改实现）。
+
+## 二、T0 开工复核结论
+
+- tests.yml 现行行号复读：注释块 :41-45、头注释 :3、branches :10/:12——与任务书 §二一致，无漂移。
+- 分拣清单 .tscn 逐一存在性重核：三轻闸探针（ui_input/ui_struct/ui_contrast）+重闸四件+窗口化四件全数实存 `game/smoke/`。
+- 兄弟卡避让位：iter19-verify（卡①）、iter19-uibackfill（卡②）均在基点 9160942 干净在飞；本批 diff 面不含其触碰文件（tests.yml 不在卡①清单）；roadmap 行按 Q13 由主控合并时串行重放，本卡只写卡③段内登记。
+- **S2 核查：master 仍停 9160942，兄弟卡未先行合并、三闸术语未在 master 换代——S2 不触发**（文案按任务书 v1.2 三闸口径落笔）。
+
+## 三、PASS 判定串取样（T0 本机实跑，worktree 冷检出含导入步全程）
+
+`bash tools/probe_gate.sh`（默认段）全绿，残留 Godot=0。三探针 PASS 行样本（grep 判据钉死=输出均含大写 `PASS` 串，裸 `grep -q "PASS"` 即判，与 probe_gate 同口径）：
+
+```
+[ui_input_probe] PASS — 悬停金框/禁入信号/路径预览/flag_place/chord/dig/英雄落位/影子构成/朝向/缩格重排/缺位回退/变异角标/视野迷雾/暂停层输入锁 十七断言全绿（…）
+[ui_struct_probe] PASS — 全屏结构断言零红
+[ui_contrast_probe] PASS — 对比度 15 对测点全绿（≥4.5:1 无区域例外）+ 裸色白名单/preload 红线静态段绿
+```
+
+## 四、S1 停机点命中——setup-godot action 失效（呈报待裁，未代修）
+
+**事实链（2026-10-08 实查）**：tests.yml smoke job `Setup Godot 4.7.2` 步引用 `uses: nikeee/godot-actions/setup-godot@v2`——
+
+1. GitHub API `repos/nikeee/godot-actions` → **404**（对照组 `repos/actions/checkout` 同法查询正常返回，API 可信）。
+2. `nikeee` 用户实存（159 公共仓库），其仓库全列表 100+59 条 **grep godot 零命中**——该仓库现不存在（从未公开或已删/转私）。
+3. GitHub Marketplace「Setup Godot」同名页实为 `Vitorgus/Setup-Godot@v1`（Godot 3 时代、Linux only、非本件）。
+4. 现存活跃同功能件=`chickensoft-games/setup-godot`（v2.4.3，支持 Godot 4.x headless，macOS/Windows/Linux）。
+
+**S1 处置**：按任务书 §六 S1「呈报后再动，不顺手代修范围外段」——该步**一字未动**，呈报候裁。对 prompt 停机规则「停机点命中→立即停全案报告」与任务书 S1「呈报后再动（该段）」的解读取舍：按任务书为准（prompt 自身规定冲突时以任务书为准）继续完成 T1-T3 范围内四项（与 setup-godot 裁决完全正交，无白干风险），S1 作头号呈报项披露。
+
+**裁决选项（供用户参考，不代裁）**：甲=换 `chickensoft-games/setup-godot@v2`（一步一行改）；乙=弃 action 改 runner 手动下载 Godot 4.7.2 linux 二进制（无第三方依赖）；丙=维持现状挂起（远端未建，不阻塞本批终态——但**远端建好首跑前必须先裁，否则 smoke job 必红在 setup 步**）。
+
+## 五、T2 静态核验证据（任务书 §七 验收闸逐条）
+
+| 验收判据 | 结果 | 证据 |
+|---|---|---|
+| 1. 无整块注释探针段残留 | ✅ | smoke 段 `ui_probe.tscn`/`ui_click_probe.tscn` 引用零命中（脚本核对 False）；原 41-45 注释区已成正式步 |
+| 2. CI 段引用的每个 res:// 路径实存 | ✅ | `res://tests/run_all.gd` 实存；三探针调用点逐一核对：ui_input_probe.tscn/ui_struct_probe.tscn/ui_contrast_probe.tscn 全 [OK]（脚本逐文件 isfile） |
+| 3. timeout 外壳+PASS 判定齐备；头注释含自动生效句 | ✅ | timeout 清单：300s 导入步/120s 冒烟/120s×3 探针；PASS 判定函数化定义一处三探针各执行；超时判 `-eq 124`/`-eq 137` 在位；「无需改本文件即自动生效」在头注释 |
+| 4. pyyaml 解析通过 | ✅ | `yaml.safe_load` OK；jobs.smoke 步骤序=[Checkout, Setup Godot 4.7.2, Import assets, Run smoke runner, Run scene probes, Upload Test Results]（pyyaml 将 `on:` 读作布尔键系 YAML 1.1 已知怪癖，GitHub Actions 按 YAML 1.2 处理，非问题） |
+| 5. roadmap 邻行登记+B6 闭环注记；diff 面=tests.yml+账务行 | ✅ | roadmap 75 行卡③段内追加「✅ 卡③落籍」块（B6 闭环注记在册）；git status 本批正文 diff 仅 tests.yml+roadmap.md，游戏代码/探针件/probe_gate.sh/CLAUDE.md 零 diff（契约 1 达成） |
+
+术语口径对齐：新增注释用「轻闸」（×2）「--full 重闸」（×1）——与 probe_gate.sh 自称「轻闸探针正主」及任务书 v1.2 三闸口径一致。
+
+## 六、T3 账务
+
+- roadmap 迭代 19 行卡③段内落籍登记（含 B6 闭环注记、S1 呈报项、首跑清单指针）——合并时与兄弟卡换代按 Q13 由主控串行重放。
+- 「首次 push 后人工盯首跑」移交清单：任务书 v1.2 §七 已在册三条（首跑三查/ui_contrast Linux 字体环境差异预判/导入步首跑耗时观察），本批核对闭环、无再改任务书必要。
+- 台账：active.md 追加 **402** 条（397 条预配号卡③=402；记账前 `git show master:active.md` 查撞 400-409 零命中，未顺延）。
+
+## 七、移交清单（首次 push 后人工盯首跑——本批不履行只移交，远端立项之日激活）
+
+1. **首跑三查**：static-scan 绿 / smoke 段绿 / 新探针段绿。
+2. **首跑前置门（本批新增，优先于一切）**：先裁 §四 setup-godot 失效问题（甲/乙/丙三选），否则 smoke job 第一步必红。
+3. **Linux 环境差异预判**：ui_contrast_probe 依赖字体渲染实测值，ubuntu runner 字体环境与 Windows 本机不同，首跑若红属环境差异非回归，逐条呈报处置。
+4. **冷检出导入步首跑耗时观察**（probe_gate 本机经验=一次性 1-2 分钟，CI 上未实测；导入步已前置，冷检出红灯风险预消，首跑仍需实证；probe_gate 用的 `--editor --quit` 而本批 CI 步用 `--import`，形态差异首跑一并实证）。
+
+## 八、遗留
+
+- S1 setup-godot 裁决（§四，唯一阻塞首跑项）。
+- 裁点② ui_layout_probe 入 CI——候卡①断言交付后用户裁（任务书 §八，本批未触碰、契约 2 锁死轻段三件）。
+- 远端仓库=裁点①终态「暂不建、维持待命」，本批交付即待命终态；建否/何时/公私届时另议。
+
+## 九、提交清单
+
+| hash | 内容 |
+|---|---|
+| 3799e0c | 卡③T1——tests.yml 注释探针段解封改写为正式轻闸段（含导入步/分支修正/头注释） |
+| 7397603 | 卡③T3——roadmap 迭代19行卡③段内追加落籍登记 |
+| （本笔） | 卡③出口报告+active.md 台账记账 402 |

roadmap.md

@@ -72,7 +72,7 @@
 | 迭代 18 | **④生涯界面实装批（2026-10-06 用户令入迭代 18）**：按迭代 17 卡④设计提纲（design/gdd/systems/跨局循环/生涯.md v0.1，master 44328b1）实装「生涯」界面——跨局汇总/历史冒险回看/图鉴承接；提纲在册要点=recent_summaries 现役 cap10 扩容+用时埋点/总局数与通关局数（涉存档 schema）/营地最近冒险清单去留（P6 必答项随评审定）；分期建议随提纲。任务书=`design/research/任务书-生涯界面实装批-2026-10-07.md`（v1.0——范围=提纲期一〔汇总页+主菜单入口+终身计数域存档 v6〕，期二/期三零触碰；裁点 P1 通关局数口径/P2 汇总条目集/P3 模态登记序待裁；提纲评审若改期一范围则任务书升版） | **✅ 已落地（2026-10-07 worktree iter18-career：提纲期一追认+裁点全裁〔2026-10-07 用户令代解/全甲；P6 随期二〕后 T0-T5 全落——生涯页六类九项+主菜单入口+终身计数域存档 v6；批末重闸全绿=冒烟 834/0〔基线 814/0，+20〕+run_all 17 套+四探针+ui_contrast 15 对+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔⑲目检条目随 07〕；出口报告=[iter18-career-exit-report](design/qa/iter18-career-exit-report-2026-10-07.md)）** | T0-T5≈2.5d |
 | 迭代 18 | **⑤混编遭遇首批投放批（2026-10-06 用户令入迭代 18；纯内容批——机制前置=迭代 17 卡①敌人表行集多行批）**：07「后续内容批义务」落地——首个混编遭遇行+Boss 多行内容投放（敌种候选与坐标=本批裁点）；首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）；难度带读数义务随批登记 07，MC 取证跑批**顺延 Alpha 收官 M4 数值批统一执行**〔未排期，届时另令——2026-10-06 用户令：数值统一调整殿后；投放本身不阻塞〕。任务书=`design/research/任务书-混编遭遇首批投放批-2026-10-07.md`（v1.0——纯内容批零代码，机制面全由卡①承载，机制缺口=L3 停机；裁点 P1 首批投放方案〔荐甲=L2 单点试水〕/P2 Boss 多行不入首批/P3 教学界保护待裁） | 迭代 17 卡①落籍（✅ 已满足 9cc4b8b）+**✅ 裁点全裁（P1-P4 甲，2026-10-07）**——开工=U0 | T0-T5≈1.75d（MC 取证顺延另计）——**✅ 已全批落表（2026-10-07，worktree g-plan2-iter18-mixenc 分支 iter18-mixenc 基点 adadf56，批内提交 ad36e35(T1 设计稿)/6272fc8(T3 落表)/43b1306(T4 断言)/⑤T5 收口批；出口报告=[iter18-mixenc-exit-report](design/qa/iter18-mixenc-exit-report-2026-10-07.md)）**：(2,5) 双行混编落表〔重击手+巨蜘蛛巢群（行值复制 (2,6)，P4 甲零数值新增），R6 行序=重击手在前〕；d5/d7 候选与行值来源全案留痕（d5 案选定）；断言面随迁（expect_pools 三元键新池模板+行集构成/行序/Σ≤4 断言）；首遇教学位 (2,4)/(3,0)/(3,1) 零触碰；07 ⑱ 目检与读数义务登记+:174 逐行骰措辞订正；闸=冒烟 814/0（基线 811/0，+3）+run_all+doc 三闸/熵增零新增（批末重闸数字见出口报告）；实机目检三项归用户（同场两敌种/行序/总数 ≤4）；MC 零跑（顺延 Alpha 收官 M4 数值批在案） |
 | 迭代 18 | **⑦新冒险种子随机化+调试浮窗升级（2026-10-07 用户令入迭代 18，同日两裁点全裁+浮窗目标态已定）**：**(a) 种子随机化**——现状考证 main.gd:1210 `_seed_value()` 调试种子框为空时硬编码返回 42=每次新冒险同一种子全程可复现；改法=玩家界面入口（主菜单开新冒险）默认分支随机生成；**✅ 裁点全裁（2026-10-07 用户令）：①首次冒险维持固定种子（教学态可复现）/②测试脚本与调试接口维持显式指定种子（冒烟·MC·探针全链显式传种子零影响，锚零作废）/③种子不进玩家 UI**；断点续玩零影响（存档已载 master_seed 回填，main.gd:447 现役）；与⑥收官批零耦合、排序自由。**(b) 调试浮窗升级**（承载「调试浮窗可查当局数据」裁点=种子的唯一查看位；**本项修订迭代 15 卡① P3 甲「仅开始菜单可开·对局不可达」裁决**）——目标态三件：独立于整体界面的**最高层浮窗**（对局中也可开）/DS_DEBUG=1 调试态下**默认打开**/新增**当局数据只读区块**（当前局种子/关卡/节点/HP/GP/钥石等——玩家 UI 不展示、调试浮窗可查）。考证在册（2026-10-07 实查）：现行=开始覆盖层角标入口〔main.gd:292-293，DS_DEBUG=1 点亮〕+main.gd:1189 门禁「仅开始菜单可开」+Dialog 形态走 ModalStack 模态栈登记〔非最高层〕+visible=false 初始非默认开+五区块（胜利演出/种子输入/数值滑条/批量模拟/两层调试）无当局数据面。任务书待裁点：最高层与模态栈登记制的关系〔置顶/登记序末+move_child 或独立层〕/输入吞噬边界〔浮窗矩形外透传游戏输入〕/对局发起「随开随收」逻辑改向/ui_tune_probe 断言面换代/入口形态（角标宿主迁移或热键）。任务书=`design/research/任务书-种子随机化与调试浮窗升级批-2026-10-07.md`（v1.0——实装级裁点 P1 遮挡语义〔荐甲=维持登记制〕/P2 入口形态〔荐甲=角标迁宿主〕/P3 默认打开范围〔荐甲=启动即开〕/P4 当局数据字段集〔荐甲=六项〕/P5 首局种子值〔荐甲=沿用 42〕待裁；估时勘误 1d→2.0d 含探针换代与收口） | **✅ 已落地（2026-10-07 worktree iter18-seed：C1 种子三分+浮窗升级 P1-P6 甲全落；批末重闸全绿=冒烟 811/0+四探针+run_all 17 套+doc 三闸/熵增闸零新增；MC 零跑；实机人闸挂账待用户〔不阻塞落籍与后续卡④〕）** | T0-T5≈2.0d |
-| 迭代 19 | **卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）**：①**主菜单开新冒险+继续上局两入口补传同调三键**（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②**关卡开场行攻血改传当前生效值**（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。**卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）**：三件主内容——①**渲染闸自动化**：新增 `tools/render_gate.sh` 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`（测试资产入库先例，.gitignore 已核只挡 artwork/）；**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②**探针收编**：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate `--full` 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③**账务修正**：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立任务书并入本迭代，本卡改称卡①，新增卡②③④见后〕。任务书=`design/research/任务书-自动化验收补齐批-2026-10-07.md`（v1.1——**待裁点 0 项**，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/在飞避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。**卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）**：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；任务书=`design/research/任务书-旧界面呈现断言回补批-2026-10-07.md`（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）。**卡③CI 预接线批（B6，2026-10-07 用户令立项）**：tests.yml 场景探针段解封——轻 CI 段=input/struct/contrast 三探针（示例引用的 ui_probe/ui_click 归 --full 重闸不进轻 CI）、Linux 独立命令形态（probe_gate.sh 系 Windows 专用）、窗口化四件禁入 headless CI；本地无远端端到端验证不可能=验收全静态核验，「首次 push 后人工盯首跑」入移交清单；远端仓库计划两文档零登记=待裁呈报项；任务书=`design/research/任务书-CI预接线批-2026-10-07.md`（v1.2——**触发分支死角已并入修正范围=tests.yml push/pull_request 两处 [main]→[master]**〔实查：实际分支 master、main 不存在，不修则远端建好后 CI 仍永不触发〕+冷检出导入步前置 smoke 步骤之前；裁点①远端仓库=✅ 2026-10-08 裁暂不建维持待命〔预接线待命=终态〕/裁点② ui_layout 入 CI Line truncated
+| 迭代 19 | **卡⓪主菜单开局缺陷修复批（原迭代 20 头卡A；2026-10-08 用户令并入本迭代、执行序第一）**：①**主菜单开新冒险+继续上局两入口补传同调三键**（attunement/attune_refresh_y/tree_rules——main.gd:510/:470，接收面 adventure_runner.gd:129-138/215-217 现成；静态考证缺陷成立：全仓无补偿路径、真实入口同调/X/Y 恒空、仅冒烟夹具喂值）；②**关卡开场行攻血改传当前生效值**（main.gd:519-521 现传初始表值，与战斗面板不一致=用户确认缺陷；「含面板加成」后缀判断同步改为认局外加成）；③冒烟补主菜单入口传参断言；④顺手删 adventure_runner.gd:129-134 三行重复赋值（零行为变化）。范围外=被动同调件呈现（用户令不动）、Fork 规则归因行（呈现层）、X/Y 刷新双源语义倒置（实现与用户口径镜像互换——X=刷新件源每节点重置不结转/Y=营地源整局持久/先扣 X，见 adventure_runner.gd:658-659/:706-709；用户口径=X 持久·Y 每节点重置·先扣 Y；真实局因①此前恒 0 未暴露——待用户裁定甲改实现/乙认现状，裁定落 GDD）。**卡①自动化验收补齐批（2026-10-07 用户令立项——全迭代两阶段验收盘点〔功能性+展示性，均自动化口径，不含人工目检〕的落地批）**：三件主内容——①**渲染闸自动化**：新增 `tools/render_gate.sh` 窗口化自动闸（shot_probe 四屏→shot_checker.py A-D 语义断言自动判定+fx_shot/board_shot 抓帧取证），棋盘 L1-L3 golden 逐像素基线入库 `game/tests/golden/`（测试资产入库先例，.gitignore 已核只挡 artwork/）；**probe_gate 头注释「渲染闸归真人目检」纪律句删除改写**（用户 2026-10-07 明示授权=历史偷懒标记），迭代 15③ 屏蔽挂账的机器补跑半随批核销〔07⑮ 目检半仍归用户不销号〕；②**探针收编**：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe 四件游离探针（实测 17.4s/49.6s/63.0s/21.9s 全绿）收进 probe_gate `--full` 段挂重闸，轻闸默认段零改；damage_probe 出闸留盘标注诊断件、config_fatal_probe 删除（与 run_all 致命类单测重复）、零断言三件标注分析工具+ui_layout 补 1280/1920 最小断言；③**账务修正**：tests/README 套件数/断言数漂移（十五→17、752+→双口径说明）+integration 空目录处置（代拍板）。〔2026-10-07 范围改道：原「明示不收」的 B4/B5/B6 三缺口经用户令各立任务书并入本迭代，本卡改称卡①，新增卡②③④见后〕。任务书=`design/research/任务书-自动化验收补齐批-2026-10-07.md`（v1.1——**待裁点 0 项**，P1-P5+拷打轮一 Q1-Q8 全裁 2026-10-07〔重闸定义正式扩容 CLAUDE.md/过程截图即弃/shot_probe 扩屏三新屏/1280 单档/素材缺位 SKIP 而基线禁锚回退态/基线换代权限呈现批 agent/取证失败=闸红/integration 删空壳〕；🔴 契约 6 条含运行时代码零 diff/轻闸零删减/在飞避让；停机点 S1 首跑存量 FAIL 全量呈报登记 06+S3 基线生成素材缺位停机；代拍板白名单四项）。**卡②旧界面呈现断言回补批（B5，2026-10-07 用户令立项）**：迭代 16 前落地旧屏追溯补 ui_contrast 测点对+ui_struct 契约——普查结论=对比度测点对旧屏 0 对（15 对现役全属 HUD/锚点/徽章/生涯）、专项契约仅 pause/career、legend/node 两屏从未过结构族；优先级=战斗结算框>商店>营地柜台+天赋树>设置面>三选一>迷雾锚定对；红线=只加断言零改旧屏、违例登记呈报不修（处置权归用户）；任务书=`design/research/任务书-旧界面呈现断言回补批-2026-10-07.md`（v1.1 grilling 三轮全裁——待裁点 0 项，WL 豁免边界/迷雾合成对最坏判据/时长闸 ≤2s/出口报告/06 遗留件登记全钉死；停机点 2〔对比度首跑存量违例/legend-node 结构首跑〕，T0-T4≈1.0d，worktree iter19-uibackfill）。**卡③CI 预接线批（B6，2026-10-07 用户令立项）**：tests.yml 场景探针段解封——轻 CI 段=input/struct/contrast 三探针（示例引用的 ui_probe/ui_click 归 --full 重闸不进轻 CI）、Linux 独立命令形态（probe_gate.sh 系 Windows 专用）、窗口化四件禁入 headless CI；本地无远端端到端验证不可能=验收全静态核验，「首次 push 后人工盯首跑」入移交清单；远端仓库计划两文档零登记=待裁呈报项；任务书=`design/research/任务书-CI预接线批-2026-10-07.md`（v1.2——**触发分支死角已并入修正范围=tests.yml push/pull_request 两处 [main]→[master]**〔实查：实际分支 master、main 不存在，不修则远端建好后 CI 仍永不触发〕+冷检出导入步前置 smoke 步骤之前；裁点①远端仓库=✅ 2026-10-08 裁暂不建维持待命〔预接线待命=终态〕/裁点② ui_layout 入 CI Line truncated
 | 迭代 20 | （**空位待编**——原头卡A 主菜单开局缺陷修复批已并入迭代 19 卡⓪〔2026-10-08 用户令：其为迭代 19 卡④的 T1 前置门且随同 goal 执行，归属随执行落位〕；候选 B-F 留档〔奇物改名/商店刷新收尾/C 三件/D 敌系/E 生涯/F 典检〕编入待用户点名） | —— | —— |
 | 迭代 21+ | **M4 数值批（**Alpha 收官位·未排期**——2026-10-05 用户令编入迭代 17 卡②；2026-10-06 用户令移出独立成批并定序「Alpha 阶段最后——内容补全先行、统一数值调整殿后」〔当日曾被编入迭代 18 为收官卡，2026-10-07 用户令撤回〕；**2026-10-07 用户令二次后移：后续新迭代（迭代 20 起）一律不先做 M4，除非用户明确要求启动 M4 批次**）**：四件数值欠账合一批——①削弱档位终值（weaken 现值 −65/duration 2/refresh 考证在册；叠层改续时语义已定案，差 duration 终值+当量锚复算）②调参批数值点评（06 条目现行登记五条——任务口径「八条」与条目五条不符，任务书 §2.2 已呈报差异以条目为准）③迭代 10 奖励重构联动欠账①②（钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕）④元进度定价剩余面（forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报；Boss 两档终值）。读数义务随批=迭代 14 两件后置复算（T6 MC 四带复算+T7 技能池节奏重测，均挂 07）；顺路修复 damage_probe A1 改前既有红灯（判式换代批出口报告 §四.7 在册）。**硬约束：一切 MC/verifier 跑批发起前须用户批准；调参联动禁独立调参网络（β 带 [1.2,2.5] 逐 u 检算）**。任务书=`design/research/任务书-M4数值批-2026-10-05.md`（**v1.2 2026-10-06 案C 增补+联审修订**：v1.1 三事实与第五推算件照旧；联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d；案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采；T0-T8≈6.25d，天然切分点 T4 末；🔴 契约 5 条含跑批批准制；**✅ 裁点全裁（2026-10-06 用户令：P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内（Q4 二裁）/P4甲 不立直购价）；开工=U0**） | 迭代 18 全部内容卡（③④⑤⑦）出口+全部内容批行为变更落定+**用户发令（未排期）**——重锚窗口须收尽全部内容批行为变更 | T0-T8≈6.25d（超软盒预挂，段一 T0-T4≈4.25d〔v1.2 勘误，原 4.5 系加总错误〕/段二 T5-T8≈2.0d） |