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 才算通过)。