合并(场景探针单一形态·旗标退役): probe_gate --click/--full 两旗标退役——十件恒跑单一形态,参数面只剩[game目录],各段调用行与原同传形态逐字节同形=零行为变化; run_all_gates 03去旗标+iter27提法换代; render_gate/README/architecture 三处文档面随批; 历史叙述两处(process-conventions:52/体验验证清单核销注记)保留在案; 验证=bash -n×3+probe_gate无旗标十段(9绿+ui_probe补边车后复跑绿)+--docs零新增红+grep收口零残留

design/engineering/architecture/architecture.md

@@ -249,7 +249,7 @@
 | **run_smoke**（冒烟测试运行器） | `tools/run_smoke.py` | 冒烟测试总入口与判定权：headless 以项目运行目标拉起 `res://tests/smoke_boot.tscn`（极小启动场景——autoload 在位、配置表全载、主屏实例化，零逻辑判定）+ 三闸判定 | 进程退出码（0=PASS / 1=FAIL） | 三闸齐备、判定无洞：①退出码 = 0；②摘要行「[smoke] 摘要：N 项检查，0 项失败」在案且失败数为 0；③输出扫 `SCRIPT ERROR` / `Parse Error` 标记行。外部 wall-clock 超时在位（超时 = FAIL） |
 | **run_system_test**（系统测试运行器） | `tools/run_system_test.py` | 系统测试总入口：headless 跑真实玩法路径断言面（宿主=`res://tests/system_test.gd`）+ 三闸判定（口径同 run_smoke，摘要行兼容两种宿主格式） | 进程退出码（0=PASS / 1=FAIL） | 三闸齐备（同 run_smoke：退出码／摘要失败数／脚本错误扫描；wall-clock 超时在位） |
 | **run_all**（单元与集成测试） | `game/tests/run_all.gd` | 64 套统一入口（61 单元＋3 集成，2026-10-28 实数）：套件 manifest 逐条「套件 → 期望退出码」，致命类 expect=1 独立子进程实跑；`negative` 字段标负面套件（仅豁免错误扫描一闸）；选跑态 `--only=<词[,词…]>`（直跑形态对套件路径子串匹配只跑命中套件，零命中＝用法错 quit(2)，仅供开发期最窄确认——不产闸回执、不作验收凭据，批末全量闸不经选跑分支） | 逐套件结果 + 汇总退出码（任一套件失败 quit(1)） | 套件级退出码协议在位；三硬闸齐备（入口内扫子套件输出 + 编排层扫 `unit.log`；`Kit.finish` 零断言返回专用码 2）。子进程输出须经系统命令解释器重定向落盘再读——`OS.execute` 的输出管道在本机恒空 |
-| **probe_gate**（场景探针） | `tools/probe_gate.sh` | headless 场景探针段编排：默认段 ui_input_probe / ui_struct_probe / layout_probe / ui_contrast_probe / **screen_flow_probe**（屏壳切换），`--click` 加跑 ui_click_probe，`--full` 加跑 ui_probe / ui_tune_probe / t17_defer_probe / fx_probe；孤儿 Godot 预清 + 批末残留清点（必须 0） | 段级 FAIL 输出 + 汇总退出码 | 每段 timeout 守卫在位（挂死 124/137 = FAIL，不静默）；判定统一走 `verdict` 函数——退出码为唯一权威判据，PASS 串降级为附加判据，逐段跑 `tools/error_scan.py` |
+| **probe_gate**（场景探针） | `tools/probe_gate.sh` | headless 场景探针段编排（单一形态十件恒跑）：ui_input_probe / ui_struct_probe / layout_probe / ui_contrast_probe / **screen_flow_probe**（屏壳切换）/ ui_click_probe（行为走查）/ ui_probe / ui_tune_probe / t17_defer_probe / fx_probe；孤儿 Godot 预清 + 批末残留清点（必须 0） | 段级 FAIL 输出 + 汇总退出码 | 每段 timeout 守卫在位（挂死 124/137 = FAIL，不静默）；判定统一走 `verdict` 函数——退出码为唯一权威判据，PASS 串降级为附加判据，逐段跑 `tools/error_scan.py` |
 | **render_gate**（视觉 golden） | `tools/render_gate.sh` | 窗口化渲染闸：①shot_probe 七屏截图 → shot_checker A-D 语义断言；②fx_shot_probe / board_shot_probe 取证（超时/零字节/文件缺失任一 = FAIL）；③棋盘 golden 逐像素容差比对（差 ≤16 / changed ≤2%，provisional）+ 菜单 golden；④批末孤儿残留清零；⑤三段探针日志逐段脚本错误扫描 | 段级 FAIL 输出 + 汇总退出码 | 查退出码在位（每段 timeout 守卫 + 退出码/取证文件双检）；SCRIPT ERROR 扫描在位（逐段 `tools/error_scan.py`，标记与 run_smoke 同源）；断言数下限不适用（判定主体 = golden 容差与取证文件存在性，非断言计数） |
 | **static_scan**（静态扫描域） | `game/tests/static_scan.sh` | 静态扫描域 S1–S10 可执行载体（grep 规则 + `tools/audit_type_hints.py`〔S9〕+ `tools/audit_file_headers.py`〔S10〕） | fail 聚合退出码（任一硬失败规则命中即 exit 1） | 查退出码在位；SCRIPT ERROR 扫描与断言数下限不适用（逐规则命中即红，无运行时错误面与断言计数）；S3 现为 warning 级、不参与 fail 判定（见下表） |
 
@@ -257,7 +257,7 @@
 
 | 域 | 闸 | 本批改动落在这些路径即属该域 |
 |---|---|---|
-| **代码域** | run_smoke、run_system_test、run_all、probe_gate `--click`、probe_gate `--full`、render_gate、static_scan | **唯一触发＝`game/` 下非 `.md` 的行为载体**（代码、测试脚本、探针、场景、数据表、素材）。`game/` 内的 `.md`（README、生成清单）归文档域——2026-10-26 用户裁：判据按文件性质，不按路径前缀。2026-10-18 用户裁「跨领域执法禁绝」（提交 `7bdf53e3`）后，原 `tools/`、`artwork/` 两前缀不再把改动拉进代码域 |
+| **代码域** | run_smoke、run_system_test、run_all、probe_gate、render_gate、static_scan | **唯一触发＝`game/` 下非 `.md` 的行为载体**（代码、测试脚本、探针、场景、数据表、素材）。`game/` 内的 `.md`（README、生成清单）归文档域——2026-10-26 用户裁：判据按文件性质，不按路径前缀。2026-10-18 用户裁「跨领域执法禁绝」（提交 `7bdf53e3`）后，原 `tools/`、`artwork/` 两前缀不再把改动拉进代码域 |
 | **文档域** | gdd_lint、doc_link_audit、doc_term_audit、流水线闸 | `game/` 内的 `.md` 与 `game/` 外的一切路径：`design/`、根规则文件（`AGENTS.md`/`roadmap.md`/`待办清单.md`/`体验验证清单.md`）、`tools/` 工具脚本、`.zcode/` 配置、`sim-data/`、`reports/` |
 | **两域都含** | repo_structure_audit（熵增闸：顶层目录/根文件/图像白名单/退役路径/design 子目录五查——文档批新增或挪动 `.md` 同样会绊它；纯文本扫描秒级） | — |
 

game/tests/README.md

@@ -233,7 +233,7 @@ tests/
 | `tools/run_smoke.py`（冒烟测试） | 这版能否启动、能否加载表、能否进主屏——零逻辑判定 | 退出码＋脚本错误扫描 | 开机路径／表加载改动后的快速自检；收口由闸编排 |
 | `tools/run_system_test.py`（系统测试） | 真实玩法路径的行为断言面（推理→战斗→结算→进度推进） | 退出码＋脚本错误扫描 | 玩法链路改动的调试期确认 |
 | `tests/run_all.gd`（单元与集成） | 公式／状态机／契约／跨系统闭环（65 套件 manifest） | 退出码＋三硬闸（见下）；每套件子进程带截止时间守护——超时先 taskkill /T 整树回收再判该套件 FAIL、批继续（默认 120s，环境变量 `RUN_ALL_SUITE_TIMEOUT_SEC` 可覆盖）；连续 3 个套件超时＝红树整批挂死，第 3 个即中止整轮、汇总已见失败与超时清单后非 0 退出（阈值＝可调常量，不连续的超时照旧逐个回收） | 新套件单跑调试；逻辑改动的最小单元复跑；开发期选跑——追加 `-- --only=<词[,词…]>` 只跑路径命中词的套件（零命中＝用法错 exit 2；此形态仅供开发期最窄确认，不产闸回执、不作验收凭据）；闸机关联档选跑——同一过滤机制加 `-- --only-source=gates`，由 `tools/run_all_gates.sh` 在 02 闸传入（回执 scope=related，是验收跑批本体） |
-| `tools/probe_gate.sh`（场景探针，`--click`／`--full` 两模式） | UI 可达性、可见性、状态——真实实例化场景＋真实输入路径 | 探针自检＋退出码 | 新增 UI 区域的配套探针直跑与断言复核 |
+| `tools/probe_gate.sh`（场景探针，单一形态十件恒跑） | UI 可达性、可见性、状态——真实实例化场景＋真实输入路径 | 探针自检＋退出码 | 新增 UI 区域的配套探针直跑与断言复核 |
 | `tools/render_gate.sh`（渲染 golden） | 画面基线——截图与基线图逐像素容差比对 | golden 比对脚本（依赖 PIL）＋退出码／取证双检／三段探针日志脚本错误扫描（`error_scan.py`） | 主题／素材／排版类改动；窗口化运行，需开显示器 |
 | `game/tests/static_scan.sh`（S 域） | 项目纪律＋第三方质量规则：RNG 单点／core 纯度／类型标注／文件头／注释禁词／旧符号残留；S13＝gdstyle 质量规则（重复 load、循环内 await、循环内分配、不可达代码等真缺陷类；基线键＝文件|规则|函数名（类/文件级＝文件|规则，无数字条目带消息），数字漂移不假红，同键指标恶化超基线登记值即红） | 退出码（逐规则 FAIL 行） | 改产品码前后的快速自检；新增纪律先补扫描规则再修码 |
 | 测量件（`game/sim/`，逐件见下「游离脚本台账」） | 期望／分布读数——只给读数，不判对错 | 人工读 stdout 或配套工具脚本 | 调参与归因；MC 类一律用户发起（档位表见 `sim-data/README.md`「MC 采集档位表」） |

tools/probe_gate.sh

@@ -3,31 +3,29 @@
 # 三闸：①每段 timeout 守卫＋超时整树回收（挂死=FAIL 不静默；taskkill /T 连引擎子进程一起杀，
 #   不再只杀 wrapper 留孤儿）②段前预清+段后清本 game 目录孤儿 Godot
 #   （按命令行精确匹配本 game 路径，不误杀其他 worktree 会话的合法进程）③末尾残留清点=批末闸（必须 0）。
-# 段：ui_input_probe=默认必跑；ui_struct_probe=默认必跑（
-#   全 UI 屏结构断言：按钮互压/等宽/出屏/零尺寸/标题屏双列）；ui_contrast_probe=默认必跑（
-#   UI 文字对比度机检 ≥4.5:1 无区域例外，测点表随改动维护）；--click=加跑 ui_click_probe 行为走查
-#   （自退出+退出码闸；超时多半=探针未适配新停点层，需做探针适配）。
-# layout_probe=默认必跑（分辨率几何断言，档位表是数据/断言是一份函数，
+# 段（单一形态，十件恒跑）：
+#   默认段五件：ui_input_probe／ui_struct_probe（
+#   全 UI 屏结构断言：按钮互压/等宽/出屏/零尺寸/标题屏双列）／ui_contrast_probe（
+#   UI 文字对比度机检 ≥4.5:1 无区域例外，测点表随改动维护）／screen_flow_probe（L3 屏壳切换）。
+#   行为走查段：ui_click_probe（自退出+退出码闸；超时多半=探针未适配新停点层，需做探针适配）。
+# layout_probe=默认段五件之一（分辨率几何断言，档位表是数据/断言是一份函数，
 #   增删档位只改表内一行；用 content_scale_size 改逻辑视口，headless 下真生效——
 #   get_window().size 在 headless 下不改变视口，其「1920 档恒定」类断言是
 #   永远为真的假断言，禁用）。
 # 判定口径（三硬闸）：每段走 verdict 函数——①退出码为唯一权威判据（PASS 串降级为日志）
 #   ②脚本错误扫描命中即红（tools/error_scan.py，标记与 run_smoke.py 同源）③PASS 串保留为附加判据。
-# --full 段（扩展段）：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe
-#   四件带断言探针；默认段断言面零删减零改动（--full 只增不改）。
+# 扩展段（带断言探针四件）：ui_probe/ui_tune_probe/t17_defer_probe/fx_probe。
 # 渲染面归 render_gate.sh 正主（窗口化：shot_probe 七屏+fx_shot/board_shot 取证+棋盘 golden 逐像素）。
-# 用法: tools/probe_gate.sh [game目录] [--click] [--full]   缺省 game 目录=脚本所在仓库的 game/（worktree 内自动指向该 worktree）
+# 用法: tools/probe_gate.sh [game目录]   缺省 game 目录=脚本所在仓库的 game/（worktree 内自动指向该 worktree）
 # 依赖: Git Bash(coreutils timeout/taskkill) + PowerShell（Windows 侧）；macOS/Linux 走 tools/gate_platform.sh
 #   共享跨平台件（Godot 路径两平台都可用 GODOT_BIN 环境变量覆盖）。
 set -u
 G="${GODOT_BIN:-/d/code/godot/Godot_v4.7.2-stable_win64_console.exe}"
 REPO="$(cd "$(dirname "$0")/.." && pwd)"
 . "$REPO/tools/gate_platform.sh"   # 跨平台件（平台探测/路径形式/带超时执行/孤儿清杀）
-GAME=""; WITH_CLICK=0; WITH_FULL=0
+GAME=""
 for a in "$@"; do
 	case "$a" in
-		--click) WITH_CLICK=1 ;;
-		--full) WITH_FULL=1 ;;
 		*) GAME="$a" ;;
 	esac
 done
@@ -160,41 +158,37 @@ st=$?
 grep -E "screen_flow_probe" "$TMP/sfp.log" | tail -3
 verdict "screen_flow_probe" "$TMP/sfp.log" "$st" "screen_flow_probe" || _rc=1
 
-if [ "$WITH_CLICK" -eq 1 ]; then
-	echo "======== ui_click_probe 行为走查 ========"
-	run_suite 240 "$TMP/clk.log" res://probe/ui_click_probe.tscn
-	st=$?
-	grep -E "click_probe" "$TMP/clk.log" | tail -4
-	verdict "ui_click_probe" "$TMP/clk.log" "$st" "click_probe" || _rc=1
-fi
+echo "======== ui_click_probe 行为走查 ========"
+run_suite 240 "$TMP/clk.log" res://probe/ui_click_probe.tscn
+st=$?
+grep -E "click_probe" "$TMP/clk.log" | tail -4
+verdict "ui_click_probe" "$TMP/clk.log" "$st" "click_probe" || _rc=1
 
-# ── --full 段（四件带断言探针入闸；实测时长 ui_probe 17.4s/
+# ── 扩展段（四件带断言探针；实测时长 ui_probe 17.4s/
 #    ui_tune_probe 49.6s/t17_defer_probe 63.0s/fx_probe 21.9s，timeout 120=2-7×余量） ──
-if [ "$WITH_FULL" -eq 1 ]; then
-	echo "======== ui_probe（--full 收编） ========"
-	run_suite 120 "$TMP/flp.log" res://probe/ui_probe.tscn
-	st=$?
-	grep -E "\[ui_probe\]" "$TMP/flp.log" | tail -2
-	verdict "ui_probe" "$TMP/flp.log" "$st" || _rc=1
+echo "======== ui_probe（扩展段） ========"
+run_suite 120 "$TMP/flp.log" res://probe/ui_probe.tscn
+st=$?
+grep -E "\[ui_probe\]" "$TMP/flp.log" | tail -2
+verdict "ui_probe" "$TMP/flp.log" "$st" || _rc=1
 
-	echo "======== ui_tune_probe（--full 收编） ========"
-	run_suite 120 "$TMP/flt.log" res://probe/ui_tune_probe.tscn
-	st=$?
-	grep -E "\[tune_probe\]" "$TMP/flt.log" | tail -2
-	verdict "ui_tune_probe" "$TMP/flt.log" "$st" || _rc=1
+echo "======== ui_tune_probe（扩展段） ========"
+run_suite 120 "$TMP/flt.log" res://probe/ui_tune_probe.tscn
+st=$?
+grep -E "\[tune_probe\]" "$TMP/flt.log" | tail -2
+verdict "ui_tune_probe" "$TMP/flt.log" "$st" || _rc=1
 
-	echo "======== t17_defer_probe（--full 收编） ========"
-	run_suite 120 "$TMP/fld.log" res://probe/t17_defer_probe.tscn
-	st=$?
-	grep -E "\[t17_defer\]" "$TMP/fld.log" | tail -2
-	verdict "t17_defer_probe" "$TMP/fld.log" "$st" || _rc=1
+echo "======== t17_defer_probe（扩展段） ========"
+run_suite 120 "$TMP/fld.log" res://probe/t17_defer_probe.tscn
+st=$?
+grep -E "\[t17_defer\]" "$TMP/fld.log" | tail -2
+verdict "t17_defer_probe" "$TMP/fld.log" "$st" || _rc=1
 
-	echo "======== fx_probe（--full 收编） ========"
-	run_suite 120 "$TMP/flx.log" res://probe/fx_probe.tscn
-	st=$?
-	grep -E "\[fx_probe\]" "$TMP/flx.log" | tail -2
-	verdict "fx_probe" "$TMP/flx.log" "$st" || _rc=1
-fi
+echo "======== fx_probe（扩展段） ========"
+run_suite 120 "$TMP/flx.log" res://probe/fx_probe.tscn
+st=$?
+grep -E "\[fx_probe\]" "$TMP/flx.log" | tail -2
+verdict "fx_probe" "$TMP/flx.log" "$st" || _rc=1
 
 echo "======== 残留检查（批末闸） ========"
 left="$(orphans | wc -l | tr -d ' ')"

tools/render_gate.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # 渲染闸正主——窗口化自动闸。
 # 范围（渲染五闸的机器面：shot_probe/golden_compare/board_shot 三件入闸；
-# fx_probe 逻辑层归 probe_gate --full；1920 档布局机检面待补）。
+# fx_probe 逻辑层归 03 场景探针闸；1920 档布局机检面待补）。
 # 骨架复用 probe_gate：①每段 timeout 守卫（挂死=FAIL 不静默）②段前预清+段后清本 game 目录孤儿
 # Godot（按命令行精确匹配本 game 路径，不误杀其他 worktree 会话）③末尾残留清点=批末闸（必须 0）。
 # 段：

tools/run_all_gates.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # 验证闸唯一入口（全部验证闸的清单与域划分）——
 # 闸清单的唯一定义处。文档只写「验证跑本脚本」，禁在文档里另列闸件清单（那正是 iter27
-# 漏跑 probe_gate --full 的成因：清单散落三份文档、彼此不一致、且无机器校验）。
+# 漏跑场景探针扩展段的成因：清单散落三份文档、彼此不一致、且无机器校验）。
 #
 # 跑完写回执 game/tests/.gates/receipt.json（commit＋内容树哈希＋各闸退出码＋存量基线比对＋时间戳）；
 # 强制验证点＝合回 master 后 post-merge 钩子推送触发的远端跑批；远端结果用 tools/ci_check.sh 现查（只呈报、
@@ -26,7 +26,7 @@
 #   与闸壳）自身的改动不占合回全量——其质量义务＝落批时人工确认闸可跑通且判据口径未变；
 #   闸真崩溃时合回闸 fail-closed（跑不出回执即拦），不以全量为兜底。
 #   **域划分只在本脚本里定义一处**——文档只写「按改动域跑本脚本」，禁另列闸清单（清单散落多处
-#   正是既往漏跑 probe_gate --full 的成因）。
+#   正是既往漏跑场景探针扩展段的成因）。
 #
 # 判定口径：每道闸与 game/tests/.gates/baseline.json 里的存量基线比对——
 #   基线绿 + 现绿        → 绿
@@ -410,7 +410,7 @@ if [ $NONBEHAVIOR -eq 1 ]; then
 	NAMES+=("03 场景探针"); EXITS+=("SKIP"); LOGS+=("")
 	echo ""; echo "[gates] 03 场景探针 → SKIP（影响面选闸：测量面改动不触场景树与探针断言面）"
 else
-	gate "03 场景探针" "probe.log" bash "$REPO/tools/probe_gate.sh" "$GAME" --click --full
+	gate "03 场景探针" "probe.log" bash "$REPO/tools/probe_gate.sh" "$GAME"
 fi
 # ── 5. 渲染面（窗口化，依赖 PIL）──
 if [ $QUICK -eq 1 ] || [ $NONBEHAVIOR -eq 1 ]; then