docs(pbl_scense_ext): README 一致性自检补记第四条 grep 的口径边界说明(QC 复审 #1 闭环)
This commit is contained in:
parent
937b4a41bf
commit
f409e314d6
@ -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 才算通过)。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user