diff --git a/docs/DEV-TOOLING.md b/docs/DEV-TOOLING.md index 925be6b..8ba992f 100644 --- a/docs/DEV-TOOLING.md +++ b/docs/DEV-TOOLING.md @@ -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` 注释 | ⚠️ 同名判别器的**两个不同机制**(别混): ```