From 8b09b2c952374155418abcc5f142fbfa1aee12c2 Mon Sep 17 00:00:00 2001
From: DKChan <524912269@qq.com>
Date: Fri, 6 Nov 2026 23:47:28 +0800
Subject: [PATCH] =?UTF-8?q?=E8=BF=BD=E7=BA=A2(=E8=BF=9C=E7=AB=AF=20run=209?=
 =?UTF-8?q?5=20=E4=B8=A4=E6=9D=A1=E7=BA=A2=E8=BD=AC=E7=BB=BF=C2=B7?=
 =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=BD=A6=E9=81=93):=20=E7=BA=A2=E5=9B=A01=3D?=
 =?UTF-8?q?=E5=88=A4=E5=AE=9A=E7=BA=A7=E2=80=94=E2=80=94=E8=83=BD=E5=8A=9B?=
 =?UTF-8?q?=E5=AE=A1=E8=AE=A1=20G=20=E9=81=93=E3=80=8Coracle=20=E6=B3=A8?=
 =?UTF-8?q?=E8=AE=B0=E5=87=BD=E6=95=B0=20401=C2=B7=E7=BA=A2=E9=A1=B9=201?=
 =?UTF-8?q?=E3=80=8D,=20=E7=BA=A2=E9=A1=B9=E5=8E=9F=E6=96=87=E3=80=8Cgame/?=
 =?UTF-8?q?probe/probe=5Fcoverage=5Frecorder.gd:201=20=E9=AA=8C=E8=AF=81?=
 =?UTF-8?q?=E5=87=BD=E6=95=B0=20dump=5Fjs=20=E7=BC=BA=20#=20oracle=20?=
 =?UTF-8?q?=E6=B3=A8=E8=AE=B0=E3=80=8D(dump=5Fjs=20=E4=BD=93=E5=86=85?=
 =?UTF-8?q?=E4=B8=89=E5=A4=84=20push=5Ferror(=20=E5=91=BD=E4=B8=AD=20capab?=
 =?UTF-8?q?ility=5Faudit.py:341=20VERDICT=5FRE=20=E2=86=92=20=E5=B1=9E?=
 =?UTF-8?q?=E9=A1=BB=E6=B3=A8=E8=AE=B0=E7=9A=84=E9=AA=8C=E8=AF=81=E5=87=BD?=
 =?UTF-8?q?=E6=95=B0,=20:386=20=E5=88=A4=E7=BA=A2);=20=E4=B8=8A=E4=B8=80?=
 =?UTF-8?q?=E6=89=B9=E3=80=8C=E5=88=A4=E6=8D=AE=E5=87=BA=E5=A4=84=E6=B3=A8?=
 =?UTF-8?q?=E8=AE=B0=20402=20=E5=87=BD=E6=95=B0=E5=85=A8=E5=BA=93=E9=93=BA?=
 =?UTF-8?q?=E5=BC=80=E3=80=8D=E7=9A=84=E8=B7=91=E7=BB=BF=E8=AF=BB=E6=95=B0?=
 =?UTF-8?q?=E9=9D=A0=E4=B8=BB=E5=B7=A5=E4=BD=9C=E5=8C=BA=E4=B8=80=E8=A1=8C?=
 =?UTF-8?q?=E6=9C=AA=E6=8F=90=E4=BA=A4=E6=B3=A8=E8=AE=B0=E6=92=91=E8=BF=87?=
 =?UTF-8?q?,=20=E6=9C=AA=E9=9A=8F=E6=89=B9=20commit,=20=E6=95=85=E6=9C=AC?=
 =?UTF-8?q?=E5=9C=B0=20strict=20=E7=BB=BF=E8=80=8C=E8=BF=9C=E7=AB=AF?=
 =?UTF-8?q?=E5=B9=B2=E5=87=80=E6=A3=80=E5=87=BA=E5=BF=85=E7=BA=A2;=20?=
 =?UTF-8?q?=E6=9C=AC=E6=89=B9=E5=9C=A8=E8=AF=A5=E6=96=87=E4=BB=B6=E8=A1=A5?=
 =?UTF-8?q?=E5=90=8C=E4=B8=80=E8=A1=8C=E6=B3=A8=E8=AE=B0(=E6=94=BE?=
 =?UTF-8?q?=E6=B3=95=E7=85=A7=E4=BB=93=E5=86=85=E6=97=A2=E6=9C=89=E5=BD=A2?=
 =?UTF-8?q?=E6=80=81=E2=80=94=E2=80=94=E5=87=BD=E6=95=B0=E5=AE=9A=E4=B9=89?=
 =?UTF-8?q?=E8=A1=8C=E4=B8=8B=E4=B8=80=E8=A1=8C=E9=A1=B6=E6=A0=BC,=20?=
 =?UTF-8?q?=E6=A0=B7=E6=9C=AC=20camp=5Fscene=5Flayout=5Ftest.gd:13/:18,=20?=
 =?UTF-8?q?=E6=8C=87=E9=92=88=20design/engineering/test-conventions.md:30?=
 =?UTF-8?q?=20=E4=B8=8E=E4=B8=BB=E5=8C=BA=E5=B7=A5=E4=BD=9C=E7=A8=BF?=
 =?UTF-8?q?=E9=80=90=E5=AD=97=E8=8A=82=E5=90=8C,=20cmp=20=E5=B7=B2?=
 =?UTF-8?q?=E6=A0=B8)=E3=80=82=E7=BA=A2=E5=9B=A02=3D=E9=9D=9E=E5=88=A4?=
 =?UTF-8?q?=E5=AE=9A=E7=BA=A7=E4=BD=86=E5=9C=A8=E6=97=A5=E5=BF=97=E9=87=8C?=
 =?UTF-8?q?=E6=88=90=E4=B8=B2=E6=8A=A5=E7=BA=A2=E2=80=94=E2=80=94tools=20?=
 =?UTF-8?q?=E5=9B=9B=E5=A4=84=E4=BA=94=20sites=20=E7=94=A8=20Path.write=5F?=
 =?UTF-8?q?text(...,=20newline=3D"\n"),=20=E8=AF=A5=E5=85=B3=E9=94=AE?=
 =?UTF-8?q?=E5=AD=97=20Python=203.13+=20=E6=89=8D=E6=9C=89(=E6=9C=AC?=
 =?UTF-8?q?=E6=9C=BA=203.13.14=20=E7=BB=BF),=20Mac=20runner=20=E7=9A=84=20?=
 =?UTF-8?q?python3=20=E6=9B=B4=E8=80=81=20=E2=86=92=20TypeError("write=5Ft?=
 =?UTF-8?q?ext()=20got=20an=20unexpected=20keyword=20argument=20'newline'"?=
 =?UTF-8?q?)=20=E2=86=92=20=E5=85=AD=E5=B1=82=E6=98=8E=E7=BB=86=E5=9B=9E?=
 =?UTF-8?q?=E6=89=A7=E5=9C=A8=E8=BF=9C=E7=AB=AF=E4=B8=80=E4=BB=B6=E6=9C=AA?=
 =?UTF-8?q?=E8=90=BD=E7=9B=98,=20run=2093/95=20=E6=97=A5=E5=BF=97=E5=90=8C?=
 =?UTF-8?q?=E6=8A=A5=E6=AD=A4=E9=94=99(=E6=8C=82=E7=82=B9=E6=8C=89?=
 =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E6=98=AF=E8=A7=82=E6=B5=8B=E4=BB=B6=E4=B8=8D?=
 =?UTF-8?q?=E7=BF=BB=E9=97=B8=E5=88=A4,=20=E6=95=85=E5=AE=83=E4=B8=8D?=
 =?UTF-8?q?=E6=98=AF=20run=2095=20=E7=9A=84=E5=A4=B1=E8=B4=A5=E4=B8=BB?=
 =?UTF-8?q?=E5=9B=A0,=20=E4=BD=86=E7=AD=89=E4=BA=8E=E8=A6=86=E7=9B=96?=
 =?UTF-8?q?=E6=80=BB=E8=A7=88=E9=9D=A2=E6=9D=BF=E7=9A=84=E5=85=AD=E5=B1=82?=
 =?UTF-8?q?=E6=98=8E=E7=BB=86=E4=B8=80=E7=9B=B4=E6=98=AF=E7=A9=BA=E7=9A=84?=
 =?UTF-8?q?);=20=E4=BA=94=E5=A4=84=E6=94=B9=20open(str(p),=20"w",=20encodi?=
 =?UTF-8?q?ng=3D"utf-8",=20newline=3D"\n")=20=E5=86=99=E6=B3=95(newline=20?=
 =?UTF-8?q?=E5=BD=A2=E5=8F=82=20builtin=20open=20=E8=87=AA=203.0=20?=
 =?UTF-8?q?=E8=B5=B7=E6=9C=89,=20LF=20=E7=BA=AA=E5=BE=8B=E4=B8=8D=E4=B8=A2?=
 =?UTF-8?q?),=20=E8=A6=86=E7=9B=96=E9=9D=A2=3Dcoverage=5Fenum.py:148?=
 =?UTF-8?q?=EF=BC=8Fcoverage=5Freceipts.py:160/:179=EF=BC=8Fextract=5Fcapa?=
 =?UTF-8?q?bility=5Flist.py:104=EF=BC=8Fextract=5Fchecks.py:588;=20?=
 =?UTF-8?q?=E6=B3=A8:=20tools/t17=5Ffanout2=5Frebuild.py:140=20=E4=B8=8E?=
 =?UTF-8?q?=20t5=5Fbuild=5Ftemplates.py:237=20=E6=9C=AC=E6=9D=A5=E5=B0=B1?=
 =?UTF-8?q?=E6=98=AF=20open(...,=20newline=3D)=20=E5=BD=A2=E6=80=81,=20?=
 =?UTF-8?q?=E4=B8=8D=E5=B1=9E=E5=9D=8F=E4=BB=B6=E6=9C=AA=E5=8A=A8=E3=80=82?=
 =?UTF-8?q?=E6=9C=AC=E6=AD=A5=E5=87=AD=E6=8D=AE(=E5=85=A8=E9=83=A8?=
 =?UTF-8?q?=E5=8C=BA=E5=86=85=E5=AE=9E=E8=B7=91):=20=E2=91=A0=E4=BF=AE?=
 =?UTF-8?q?=E5=A4=8D=E5=89=8D=E5=9C=A8=E5=B9=B2=E5=87=80=E6=A3=80=E5=87=BA?=
 =?UTF-8?q?=E5=A4=8D=E7=8E=B0=E7=BA=A2=E2=80=94=E2=80=94capability=5Faudit?=
 =?UTF-8?q?=20--strict=20=E5=87=BA=E3=80=8C401=20=E6=B3=A8=E8=AE=B0=C2=B7?=
 =?UTF-8?q?=E7=BA=A2=E9=A1=B9=201=E3=80=8D=E5=B9=B6=E6=89=93=E5=87=BA?=
 =?UTF-8?q?=E4=B8=8A=E8=BF=B0=E7=BA=A2=E9=A1=B9=E5=8E=9F=E6=96=87;=20?=
 =?UTF-8?q?=E2=91=A1=E4=BF=AE=E5=A4=8D=E5=90=8E=E5=90=8C=E4=BB=B6=20exit?=
 =?UTF-8?q?=3D0=E3=80=8C402=20=E6=B3=A8=E8=AE=B0=C2=B7=E7=BA=A2=E9=A1=B9?=
 =?UTF-8?q?=200=E3=80=8D;=20=E2=91=A2=E5=9B=9B=E4=BB=B6=20py=5Fcompile=20O?=
 =?UTF-8?q?K=20=E4=B8=94=20grep=20=E5=85=A8=E4=BB=93=20write=5Ftext(.*newl?=
 =?UTF-8?q?ine=3D=20=E9=9B=B6=E6=AE=8B=E7=95=99;=20=E2=91=A3runner=20?=
 =?UTF-8?q?=E8=AF=AD=E4=B9=89=E5=AE=9E=E8=AF=81=E2=80=94=E2=80=94=E6=8A=8A?=
 =?UTF-8?q?=20Path.write=5Ftext=20=E5=9E=AB=E7=89=87=E6=88=90=203.12=20?=
 =?UTF-8?q?=E8=A1=8C=E4=B8=BA(newline=20=E4=B8=80=E5=BE=8B=20TypeError)?=
 =?UTF-8?q?=E5=86=8D=E8=B7=91=20coverage=5Freceipts.main(),=20=E5=85=AD?=
 =?UTF-8?q?=E5=B1=82=E4=B8=8E=20probe=5Fmanifest=20=E5=85=A8=E9=83=A8?=
 =?UTF-8?q?=E6=AD=A3=E5=B8=B8=E8=90=BD=E7=9B=98=E3=80=81=E6=97=A0=E4=B8=80?=
 =?UTF-8?q?=E8=A1=8C=E3=80=8C[receipts]=20=E7=BA=A2=E3=80=8D,=20=E4=BA=A7?=
 =?UTF-8?q?=E7=89=A9=E5=AD=97=E8=8A=82=E6=A0=B8=E5=AF=B9=20gate=5Fprobe/ga?=
 =?UTF-8?q?te=5Frender/gate=5Fsmoke.js=20=E5=9D=87=20CRLF=3D0=20LF=3D14(?=
 =?UTF-8?q?=E8=A1=8C=E5=B0=BE=E7=BA=AA=E5=BE=8B=E6=9C=AA=E7=A0=B4);=20?=
 =?UTF-8?q?=E2=91=A4run=5Fall=5Fgates=20--docs=20=E9=AA=8C=E6=94=B6?=
 =?UTF-8?q?=E9=80=9A=E8=BF=87=E6=97=A0=E6=96=B0=E5=A2=9E=E7=BA=A2(?=
 =?UTF-8?q?=E5=9F=BA=E7=BA=BF=209e81408e)=E3=80=82=E5=BC=95=E6=93=8E?=
 =?UTF-8?q?=E5=B1=82=E6=9C=AC=E5=9C=B0=E6=9C=AA=E8=B7=91:=20=E5=8C=BA?=
 =?UTF-8?q?=E5=86=85=20--premerge=20=E8=A2=AB=E7=B4=A0=E6=9D=90=E9=BD=90?=
 =?UTF-8?q?=E7=9B=98=E9=A2=84=E6=A3=80=E6=8B=A6=E5=9C=A8=E5=86=B7=E6=A3=80?=
 =?UTF-8?q?=E5=87=BA=E6=80=81(=E7=BC=BA=20.godot/uid=5Fcache.bin=20?=
 =?UTF-8?q?=E4=B8=8E=E5=AD=97=E4=BD=93=20.import=20=E8=BE=B9=E8=BD=A6,=20?=
 =?UTF-8?q?=E5=A4=84=E7=BD=AE=E9=9C=80=E4=BB=8E=E4=B8=BB=E5=8C=BA=E6=8B=B7?=
 =?UTF-8?q?=E7=B4=A0=E6=9D=90=E5=86=8D=20--editor=20--quit=20=E5=88=B7?=
 =?UTF-8?q?=E5=AF=BC=E5=85=A5),=20=E6=9C=AC=E6=89=B9=E4=BA=94=E5=A4=84?=
 =?UTF-8?q?=E6=94=B9=E5=8A=A8=E9=9B=B6=E6=B8=B8=E6=88=8F=E8=A1=8C=E4=B8=BA?=
 =?UTF-8?q?=E9=9D=A2,=20=E5=BC=95=E6=93=8E=E5=85=A8=E5=A5=97=E4=BB=B6?=
 =?UTF-8?q?=E7=94=B1=E4=B8=BB=E5=8C=BA=E5=90=88=E5=9B=9E=E6=97=B6=E7=9A=84?=
 =?UTF-8?q?=20pre-merge-commit=20=E5=89=8D=E7=BD=AE=E6=A3=80=E6=9F=A5?=
 =?UTF-8?q?=E8=B7=91,=20=E5=85=A8=E9=87=8F=E6=A1=A3=E5=BD=92=E5=90=88?=
 =?UTF-8?q?=E5=9B=9E=E5=90=8E=E8=BF=9C=E7=AB=AF=20CI?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 game/probe/probe_coverage_recorder.gd | 1 +
 tools/coverage_enum.py                | 3 ++-
 tools/coverage_receipts.py            | 6 ++++--
 tools/extract_capability_list.py      | 3 ++-
 tools/extract_checks.py               | 4 +++-
 5 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/game/probe/probe_coverage_recorder.gd b/game/probe/probe_coverage_recorder.gd
index c7f2f27f..c13abde8 100644
--- a/game/probe/probe_coverage_recorder.gd
+++ b/game/probe/probe_coverage_recorder.gd
@@ -199,6 +199,7 @@ func _seen_into(node: Node, keys: Array[String]) -> void:
 # ---- 落盘（JSONP 式 .js——file:// 页面 <script src> 直载）----
 
 func dump_js() -> void:
+# oracle: design/engineering/test-conventions.md:30 （覆盖登记落盘守卫——判定上报通道组）
 	var dir := DirAccess.open("res://")
 	if dir == null:
 		push_error("[coverage] res:// 打不开，登记未落盘")
diff --git a/tools/coverage_enum.py b/tools/coverage_enum.py
index 882cc6fe..bb8d1e87 100644
--- a/tools/coverage_enum.py
+++ b/tools/coverage_enum.py
@@ -145,7 +145,8 @@ def main() -> int:
     js = "/* 本体对账清单——coverage_enum.py 随跑重生成，人工核销走豁免清单（coverage_exemptions.js），不落本文件。 */\n"
     js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
     js += "window.__QA_COVERAGE__.ontology = %s;\n" % json.dumps(payload, ensure_ascii=False, indent=2)
-    out.write_text(js, encoding="utf-8", newline="\n")
+    with open(str(out), "w", encoding="utf-8", newline="\n") as fh:
+        fh.write(js)
     gap_total = sum(len(c["gaps"]) for c in payload["categories"])
     print("[ontology] 本体实体 %d / 断言文料行 %d / 缺口 %d（%d 类）→ %s" % (
         len(entities), len(_rows), gap_total, len(payload["categories"]), out))
diff --git a/tools/coverage_receipts.py b/tools/coverage_receipts.py
index c6c3333b..f7265cd6 100644
--- a/tools/coverage_receipts.py
+++ b/tools/coverage_receipts.py
@@ -157,7 +157,8 @@ def main() -> int:
             js += "window.__QA_COVERAGE__.gate_receipts = window.__QA_COVERAGE__.gate_receipts || {};\n"
             js += "window.__QA_COVERAGE__.gate_receipts[%s] = %s;\n" % (
                 json.dumps(key), json.dumps(payload, ensure_ascii=False, indent=2))
-            (out_dir / ("gate_%s.js" % key)).write_text(js, encoding="utf-8", newline="\n")
+            with open(str(out_dir / ("gate_%s.js" % key)), "w", encoding="utf-8", newline="\n") as fh:
+                fh.write(js)
             wrote += 1
             print("[receipts] %s（%s）=%s" % (label, log_name, detail.get("result", "?")))
         except Exception as exc:   # noqa: BLE001 —— 观测件逐层容错，红字可见不静默
@@ -175,7 +176,8 @@ def main() -> int:
     mjs = "/* 探针登记清单——coverage_receipts.py 随跑批按现存文件覆写，勿手编。 */\n"
     mjs += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
     mjs += "window.__QA_COVERAGE__.probe_manifest = %s;\n" % json.dumps(manifest, ensure_ascii=False)
-    (out_dir / "probe_manifest.js").write_text(mjs, encoding="utf-8", newline="\n")
+    with open(str(out_dir / "probe_manifest.js"), "w", encoding="utf-8", newline="\n") as fh:
+        fh.write(mjs)
     print("[receipts] 探针登记清单 %d 件 → probe_manifest.js" % len(probe_files))
     return 1 if failed else 0
 
diff --git a/tools/extract_capability_list.py b/tools/extract_capability_list.py
index f1fc445e..ccf82bd3 100644
--- a/tools/extract_capability_list.py
+++ b/tools/extract_capability_list.py
@@ -101,7 +101,8 @@ def dump_js(payload: dict, out: Path) -> None:
     js = "/* 能力清单义务层投影——由 extract_capability_list.py 生成，随 README 变更重跑；人工修订无效（义务源=README 能力清单）。 */\n"
     js += "window.__QA_COVERAGE__ = window.__QA_COVERAGE__ || {};\n"
     js += "window.__QA_COVERAGE__.capability_list = %s;\n" % json.dumps(payload, ensure_ascii=False, indent=2)
-    out.write_text(js, encoding="utf-8", newline="\n")
+    with open(str(out), "w", encoding="utf-8", newline="\n") as fh:
+        fh.write(js)
 
 
 def main() -> int:
diff --git a/tools/extract_checks.py b/tools/extract_checks.py
index c1344161..1b6f0a8a 100644
--- a/tools/extract_checks.py
+++ b/tools/extract_checks.py
@@ -585,7 +585,9 @@ def main() -> int:
             carry = carry_cells(old_rows)
             print("[extract_checks] 旧清单 %d 行 → 承接指纹 %d 个" % (len(old_rows), len(carry)))
         entries, funcs_by_src = extract_all(src_paths)
-        out.write_text(render_list(entries, funcs_by_src, [p.name for p in src_paths], carry), encoding="utf-8", newline="\n")
+        listing = render_list(entries, funcs_by_src, [p.name for p in src_paths], carry)
+        with open(str(out), "w", encoding="utf-8", newline="\n") as fh:
+            fh.write(listing)
         hitn = sum(1 for e in entries
                    if (fold(e["cond"]), e["label_literal"], fold(e["label_suffix"])) in carry)
         print("[extract_checks] 已生成 %s（%d 个源文件、%d 个调用点、承接回填 %d 行）"