From f409e314d68856384d40e3063ef27825626a0f3e Mon Sep 17 00:00:00 2001 From: "agent.develop" Date: Tue, 22 Sep 2026 11:44:45 +0800 Subject: [PATCH] =?UTF-8?q?docs(pbl=5Fscense=5Fext):=20README=20=E4=B8=80?= =?UTF-8?q?=E8=87=B4=E6=80=A7=E8=87=AA=E6=A3=80=E8=A1=A5=E8=AE=B0=E7=AC=AC?= =?UTF-8?q?=E5=9B=9B=E6=9D=A1=20grep=20=E7=9A=84=E5=8F=A3=E5=BE=84?= =?UTF-8?q?=E8=BE=B9=E7=95=8C=E8=AF=B4=E6=98=8E=EF=BC=88QC=20=E5=A4=8D?= =?UTF-8?q?=E5=AE=A1=20#1=20=E9=97=AD=E7=8E=AF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 43d4c0b..1ebe2de 100644 --- a/README.md +++ b/README.md @@ -29,13 +29,18 @@ PBL 覆盖层前端扩展模块（scense / scense_game 之上的 pbl_scense_ext # 文档口径自检：本模块内不得残留对构建脚本生成步骤的编号化表述（期望 rc=1，零命中） grep -rnE '第 ?9 ?步' . --exclude-dir=.git ; echo "rc=$? (期望 1)" ``` - 说明两点： + 说明三点： 1. 第四条自检**刻意**用 ERE 形式（`第`+可选空格+`9`+可选空格+`步`），一次性覆盖 「数字紧贴汉字」与「数字两侧带空格」两种写法，且该写法本身不会被自己命中——若把某种 字面量抄进本文档，README 自身就会成为 grep 的命中项，使「零命中」声明再次不可复现 （QC 复审 #1 指出的正是这类自验声明与实测不符的问题）。 2. 第三条也可由生成器自检代跑：`python3 scripts/gen_overlay_pages.py --check` 会实测 `apps/pbls/build.sh` 并打印 `OK:` 或 `WARN:`（不改变返回码）。 + 3. 第四条自检的口径边界（QC 复审 #1 要求如实声明，避免后续复检误判）：该 grep 的作用域是 + **本模块仓库目录**（`modules/pbl_scense_ext`，排除 `.git`），实测 rc=1 零命中；而项目 + 交付说明 `projects/pbls/docs/02-develop/dev-notes-m9-gitignore-build-integration.md` + 位于本模块仓库之外，因需原样引述退回意见原文与改动前后对照，仍会出现在该 grep 口径之外 + 的编号化字样。后续复检请以「模块仓径 rc=1」为判定口径，勿把交付说明的引述计入命中项。 - 新增/删除页面壳：改 `gen_overlay_pages.py` 的 `PAGES` 注册表 + `wwwroot/overlay/pbl_overlay_core.js` 的 `PAGES` + `scripts/load_path.py` 的 `OVERLAY_PAGES` 三处同源，再跑 `python3 scripts/gen_overlay_pages.py --check`（rc=0 才算通过）。