docs(tooling): 判据口径收紧后同步本节 —— "可定位的非自身引用",并修正 reset-demo.sh 那行**指错了来源**
`b16c38a` 把判据从"这个名字出现过吗"收紧成"引用必须带路径"。本节当时写的还是旧口径
("至少一处非自身引用")⇒ 文档与判据不同步,读的人会以为裸名也算。
★ 并修正一行**本来就错的**引用:
```
reset-demo.sh 原写: 发现路径 = `client/electron/README` 与演示脚本族
实测(收紧后逐工具列来源):
reset-demo.sh 的路径限定来源 = docs/DEV-TOOLING.md(本节表格)+ deploy/prune-deploy-artifacts.sh 注释
⇒ `client/electron/README` **根本不在判据的 SCAN 范围内**(SCAN_DIRS 无 client/electron)
所以它作为"发现路径"是**无效引用** —— 原文把它写成了依据,而判据从不看那里。
```
⇒ 改成实测的两个来源。
验证: 收紧后 5/5 非门禁工具**全部**仍有路径限定来源,且**没有一个**依赖我的分析日志
(`docs/API.md` 对 5 个工具的路径限定命中 = 0/5);criteria-hygiene 9/9。
This commit is contained in:
@ -133,16 +133,24 @@ bash deploy/prune-deploy-artifacts.sh --self-check # 判据自检(16 项,
|
||||
不强制接线,但必须**有发现路径** —— 否则它存在,而没人会知道它存在。
|
||||
|
||||
判据在 `criteria-hygiene` 的「非门禁工具必须有发现路径」:每个非门禁 `deploy/*.sh`
|
||||
至少要有**一处非自身引用**(文档 / 入口 / 别的工具)。实测它建起来时抓到的第一个孤儿
|
||||
至少要有**一处可定位的非自身引用**(文档 / 入口 / 别的工具)。实测它建起来时抓到的第一个孤儿
|
||||
就是 `archive-stale-sessions.sh`(全仓零引用)。
|
||||
|
||||
★ **"可定位"= 引用必须带路径(`deploy/<工具名>`),裸名不算** ——
|
||||
判据从"这个名字出现过吗"收紧成"读者能照着走到它吗"(`c155560`)。
|
||||
理由是一个实测的**假绿**:只在分析日志里提一句裸名,就能让真孤儿判绿 ——
|
||||
判据分不清「我在讨论里提到它」与「有人会照着这条信息找到它」,而本仓的分析日志全是前者。
|
||||
⚠️ 它**不是**按文件名豁免(那是给逃逸指路);判据落在**引用的形态**上:
|
||||
任何文件里的路径限定引用都算数,任何文件里的裸名都不算。
|
||||
⇒ 所以下表每一行的发现路径,写法上都是**路径限定**的(标题/表格/注释里的全路径)。
|
||||
|
||||
| 按需工具 | 发现路径 |
|
||||
|---|---|
|
||||
| `deploy/prune-deploy-artifacts.sh` | 本节上方专节 |
|
||||
| `deploy/recount-relay-counts.sh` | 本节(口径复算;被 `docs/DEBTS.json` 引用) |
|
||||
| `deploy/archive-stale-sessions.sh` | 本节 —— 归档陈旧会话(`--dry-run` 先看) |
|
||||
| `deploy/prune-test-sessions.sh` | `docs/DEV-TOOLING.md` 的清理表、`redeploy-gateway.sh` 注释 |
|
||||
| `deploy/reset-demo.sh` | `client/electron/README` 与演示脚本族 |
|
||||
| `deploy/reset-demo.sh` | `docs/DEV-TOOLING.md` 的清理表、`deploy/prune-deploy-artifacts.sh` 注释 |
|
||||
|
||||
⚠️ 同名判别器的**两个不同机制**(别混):
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user