chore(id-check): 退役全库编号语料审计（钩子 52 → 51）

第三步（用户裁定跳过观察期直接做）。第一步 bf2a5c21 把两根护栏转报告制，第二步 a5832788 立起只查新增行的新门禁，本笔把旧的全库语料审计整体退役：语义标识已是默认形态，这套 99 族语料不再有人需要维护。移动（保留可复现性，不再进提交门禁）： - scripts/check_ids.py → scripts/archive/id_gate/check_ids.py - id_registry.json（87.6 KB，99 族）/ id_aliases.json（187 KB）/ id_known_backlog.json 一并归档；新写 archive README：为什么退役、现在用什么、怎么手工跑、归档纪律。 - 归档脚本改了自定位（仓库根往上 4 层、语料与脚本同目录）与一行退役横幅；从新路径实跑：811 文件 / 8,051 字面量，--strict rc=0。钩子：删 id-check（52 → 51）。现役编号门禁只剩 id-check-new（只查新增行、零语料）。声明数 51 = commit 阶段 50 + gitlint 1，三数已对齐（AGENTS / 门禁索引 / YAML）。连带改动： - rename_ids.py 的别名表路径指向归档（改名工具本身没退役）； - check_ids_new.py 排除面加 scripts/archive/（语料里全是编号字面量，天经地义）； - doc-links 跳过 .mnemon/ 与 ci-artifacts/（本地记忆状态与草稿，非项目文档）—— 语料搬家后这些目录里的旧路径引用会假红，它们本来就不该参与文档门禁； - 全库 .md 里的旧路径引用改指 scripts/archive/id_gate/（含两份 skill 手册）； - id-check.md 加退役横幅并保留原文作留档；门禁索引把该行标成已退役； - 编号规范 §8 改成「现行只有一道门禁」+ §8.1~§8.4 标为退役留档 + §8.5 ③ 置已完成；各加一条 2026-10-28 变更记录行。验证（实测）：YAML 口径 51 个钩子、id-check 不在其中；doc-links --all --sections-strict 通过（194 文档）；mojibake / bom-guard / coding-standard / git diff --check 全 rc=0；新门禁自检 5 正例 + 29 反例仍全过。
2026-10-28 12:38:38 +08:00
parent a5832788e9
commit 1668842d61
20 changed files with 152 additions and 107 deletions
@@ -94,7 +94,7 @@ git commit
 | **stash 覆盖面：只覆盖已跟踪文件的未暂存改动**（2026-10-26 读源码定案，**对所有钩子通用**） | 机制在 pre-commit 的 `staged_files_only._unstaged_changes_cleared()`：`git diff-index <tree>` 取补丁 → `git checkout -- .` → 跑完 `git apply` 还原。所以「钩子实跑 = 只看到 HEAD + 本笔 staged」这句**对已跟踪文件成立、对未跟踪文件不成立**：未跟踪文件压根不在 `diff-index` 里，**不会被藏**；`git add -N`（intent-to-add）也救不了——pre-commit 只 `git rm --cached` 把它撤下索引（`_intent_to_add_cleared()`），**文件本体仍在盘上**。后果：别人写了尚未入库的文件（新页面实例 / 新单测目录 / 新文档）躺在树里时，**任何一笔碰到该文件所属钩子 `files:` 的提交都会被这份半成品拖红**——红的内容没错，但账不该记在这笔提交上。实测：`ui_page_clock.c`、`ui_page_reset.c` 处于未跟踪且未绑 `#page` 期间，`generated-fresh` 对**所有人**的 UI 提交都会 FAIL（现场日志 `docs/门禁说明/generated-fresh.md` §6 第 8 条）。三条结论：① 提交排序——会让全树变红的半成品要么先落地（绑引用 + 重跑生成器）要么先挪出工作树；② 凡「判定基准取工作区」的钩子（重跑比对类、全库统计类）在多人同树下必须配**静默窗口**；③ 真要 `--no-verify` 抢跑，正文必须点名是哪几个**未跟踪**文件拖的红，别让它被读成「钩子不可信」 |
 | **`always: true` 已废** | pre-commit 4.x 对 `local` 钩子里这个键**只告警 `Unexpected key(s)` 然后忽略** → "想总是跑"只能把 `files:` 写全（教训 → §5.5） |
 | **改写型与只读型的豁免不对称** | YAML 锚点 `&cubemx-generated` 只豁免 `trailing-whitespace` 与 `end-of-file-fixer`；`cppcheck` / `no-mojibake` / `cubemx-survival` / `task-table` / `mem-numbers` **仍覆盖** `Src/`、`Inc/` |
-| **增量拦截三段式** | 规则恒生效 + 存量钉在基线/台账 + `--prune` 点名"已还清、请删行"；**脚本刻意没有 `--write`**（不提供"一条命令把现状洗成合法"的入口）。使用者（2026-10-26 实跑核对）：`layer-deps`（**基线内 3** + ALLOW 永久豁免 3，共见 6 处）、`bsp-err`（38 条）、`id-check`（工作区台账已还清 = **0 条指纹 / 0 处**；HEAD 那版是 303 条指纹 / 651 处）。原写「layer-deps(6)」「id-check 台账 640 处」都是没跟着还账更新的旧数 |
+| **增量拦截三段式** | 规则恒生效 + 存量钉在基线/台账 + `--prune` 点名"已还清、请删行"；**脚本刻意没有 `--write`**（不提供"一条命令把现状洗成合法"的入口）。使用者（2026-10-26 实跑核对）：`layer-deps`（**基线内 3** + ALLOW 永久豁免 3，共见 6 处）、`bsp-err`（38 条）、~~已退役的 `id-check`~（工作区台账已还清 = **0 条指纹 / 0 处**；HEAD 那版是 303 条指纹 / 651 处）。原写「layer-deps(6)」「id-check 台账 640 处」都是没跟着还账更新的旧数 |
 | **没有 `.map` 即跳过** | `mem-numbers` / `mem-budget` 在无 Keil 构建的机器（含远端 CI）上是**跳过**，不是"通过"——别把跳过读成有余量 |
 | **配置自己坏 = 全部静默不跑** | 改完 `.pre-commit-config.yaml` 的验收不是过 `check-yaml`，而是实跑 `-m pre_commit run --all-files`，确认目标钩子**出现在输出里**且状态不是 `Skipped` |
 | **范围策略** | 第三方与生成物只靠 `.gitignore` 与顶层 `exclude`（不在各钩子里重复写目录名）；权威口径 → `AGENTS.md` 提交门禁一节 + §5.5 |
@@ -134,7 +134,7 @@ git commit
 | **字节卫生 = 改写型钩子的只读等价** | 下面的一行式 + `git diff --check` | 一次查完**待提交清单（含未跟踪新文件）**的 CR / 缺尾换行 / U+FFFD / 行尾空格，全程不写盘 |
 | 受影响模块的主机单测 | `& '.venv\Scripts\python.exe' test/host/<模块>/run_unit_test.py` | 只跑你碰的那几套；**改过骨架** `test/host/common/unit_test_harness.py` 就要跑全套（等价 22 根钩子同时触发） |
 | 全量单测 + 覆盖率 | `& '.venv\Scripts\python.exe' scripts/check_test_coverage.py` | 0=全过且覆盖率未回退 / 1=有失败或回退 / 2=环境（缺 `cl.exe` / mscoverage） |
-| 编号 | `& '.venv\Scripts\python.exe' scripts/check_ids.py --strict` | 增量拦截：台账之外新错即 1；顺带核「可判定比例」与「不可判定绝对数」两行（2026-10-26 余量只剩 12 处） |
+| 编号 | `& '.venv\Scripts\python.exe' scripts/archive/id_gate/check_ids.py --strict` | 增量拦截：台账之外新错即 1；顺带核「可判定比例」与「不可判定绝对数」两行（2026-10-26 余量只剩 12 处） |
 | 文档链接与章节 | `& '.venv\Scripts\python.exe' scripts/check_doc_links.py --all` | 0 通过 / 1 有问题（钩子还多带 `--sections-strict`） |
 | 生成器幂等 | `& '.venv\Scripts\python.exe' scripts/check_generated_fresh.py` | 重跑到临时目录逐字节比对；**必须 `.venv` 解释器**，否则字库链假红 → `docs/门禁说明/generated-fresh.md` §4 |
 | 一把梭（上面多数静态项 + 主机单测） | `& '.venv\Scripts\python.exe' scripts/ci_local.py` | 非 0 就别抢跑（但它**不含** `stack_report` / `ram_baseline`，数字与安全边界要另跑） |
@@ -36,7 +36,7 @@
 |---|---|---|
 | A | RS485 两条 ❌ 清零，`rs485_task` 的技术门禁解除（**是否接线仍由用户裁定**） | `test/host/rs485` 全绿 + `MDK-ARM/build_log.txt` **0 错误 0 警告** |
 | B | 声明 / 文档 / 实跑 **三数一致** | 解析计数输出 + `docs/门禁说明/README.md` 差集为空 |
-| A+B | `registration-check`、`bsp-err`、`nested-comment`、`id-check` 基线 **只减不增** | `scripts/ci_local.py` 输出 + `scripts/id_known_backlog.json` 台账 |
+| A+B | `registration-check`、`bsp-err`、`nested-comment`、`id-check` 基线 **只减不增** | `scripts/ci_local.py` 输出 + `scripts/archive/id_gate/id_known_backlog.json` 台账 |

 ## 交接

@@ -696,7 +696,7 @@ uint16_t ch395f_link_change_count(void);
 - **顺手照出的隐患**：待发条目只存 `const char *`，复用栈缓冲投递时整批别名到最后一次写入（实测落盘「1~5 + 12 七份」）。已改为条目内嵌 `desc[SYSLOG_DESC_MAX + 1u]` 并在投递时截断拷贝，头文件参数契约同步改写；代价 `+352 B ZI / +60 B Code`。理由与实测细节 → `docs/子系统设计/运行与自检记录设计说明.md` §4.4。
 - **两次测法自误（教训，别重复）**：① 先按 700 ms 快投递测，测到的 34 条丢失其实是投递侧队列满（设计如此），根本没走到被整改的支路——**测错了对象**；② 钩子投完后 `return` 使 testTask 退出，约 10 s 后被看门狗复位，把还压在 RAM 队列里的条目一起带走——**污染了自己的计数**。两者都不是固件问题，根因都是没有先验证测量手段本身有效。
 - **假件护栏的一次正向记录**：条目由 8 B 变 32 B 后，`test/host/sys_log_mcu` 的假消息队列因 `MQ_MAXMSG`（原 24）拒收一切 `osMessageQueuePut`，从既有用例起整片失败——这种「尺寸变了就响」的断言比任何评审都可靠；该宏已抬到 40 并把现象写进注释。
- 本轮改动面：`App/log/sys_log_mcu.c`（条目结构 + 投递拷贝）、`App/log/sys_log.h`（参数契约）、`test/host/sys_log_mcu/sys_log_mcu_test.c`（新增 2 条断言 + `MQ_MAXMSG`）、`scripts/id_registry.json`（游标 `TC-SYSLOG-108`）。
+- 本轮改动面：`App/log/sys_log_mcu.c`（条目结构 + 投递拷贝）、`App/log/sys_log.h`（参数契约）、`test/host/sys_log_mcu/sys_log_mcu_test.c`（新增 2 条断言 + `MQ_MAXMSG`）、`scripts/archive/id_gate/id_registry.json`（游标 `TC-SYSLOG-108`）。
 - **台架与临时改动已全部还原**：钩子、负向对照、套件宏逐一反向删除（`git status` 归零），设备上 `BENCH.STS` / `BENCH2.STS` / `B5FILL.STS` 与含钩子记录的 `SELFTEST.LOG` 已删除，产品固件重建后重烧并回读校验通过。

 ### P3｜**明确不做**（把理由写死，免得下次又被列回待办：29 个 `.c` = 4,814 行）
@@ -9,8 +9,8 @@
 > 2026-10-26 起两批清理把编号字面量从 **10,956 压到 8,230 处**，2026-10-27 复测为 **7,828 处**（§8.1 有口径说明）；
 > 而清掉的号里绝大多数从来没被任何脚本读过一次。沿革与教训留在 §8.3 与 git log，正文不复述。
 >
-> **机器面才是事实源**：族注册表 `scripts/id_registry.json`、旧号别名 `scripts/id_aliases.json`、
-> 门禁 `scripts/check_ids.py`（八项校验，详解 `docs/门禁说明/id-check.md`）。本文与机器面冲突时
+> **机器面才是事实源**：族注册表 `scripts/archive/id_gate/id_registry.json`、旧号别名 `scripts/archive/id_gate/id_aliases.json`、
+> 门禁 `scripts/archive/id_gate/check_ids.py`（八项校验，详解 `docs/门禁说明/id-check.md`）。本文与机器面冲突时
 > **以机器面为准，并回来改本文**。

 ---
@@ -99,7 +99,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语
 >
 > - ❌「不做 = 维持原状 = 还能发」——**错**。新用例一律用**语义化测试函数名 + 文档用例表的行名**（§3.3），
 >   不再配 TC 号；指认**既有**用例仍可引用现存号（旧号只读，不是许可新配）。
-> - ❌「停发 = 这族要废了，顺手清掉、把号腾出来复用」——**也错**。现存号与它在 `scripts/id_registry.json`
+> - ❌「停发 = 这族要废了，顺手清掉、把号腾出来复用」——**也错**。现存号与它在 `scripts/archive/id_gate/id_registry.json`
 >   里的登记，是 `check_test_traceability.py` 与 40 套 `run_unit_test.py` **按字面量读的追溯把手**，
 >   清它等于换机制（§9.1）；号不回收、不复用是 §1 的硬规矩。
 > - ❌「registry 里 TC 族还带着活游标，所以门禁允许我发」——**不成立：这条缺口已于 2026-10-27 同日关掉**。
@@ -142,13 +142,13 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语

 | 停发族 | 现在怎么写 | 旧号去哪查 |
 |---|---|---|
-| 登记簿 `N-x` / `S-x` / `T-x`、专项 `A-x`、已删报告的 UI 簇 `U1~U5`（2026-10-26 方案 B） | 语义短语——**登记簿表首格本身就是短语**，如「双转换器无共同采样触发」「CI 远端闭环未验证」 | `scripts/id_aliases.json` 标 `retired-to-phrase` |
-| 网络设计条目 `F-NET/F-DRV/F-MS-<nn>`（12 个，2026-10-27 批次一） | 「§7 + 条目名」短语，如 `（§7「全局读即清搁浅事件」）`；条目名的权威清单 = `docs/网络/网络自愈架构设计.md` §7「条目名」列；那个 DRV 段孤儿号按本节末句**删号留事实**、未补定义 | `scripts/id_aliases.json` 标 `retired-to-phrase`（13 条）＋属主文档 §7 编号列仅作历史对照 |
-| 「数据可信」任务卡号（中文前缀「卡」+ 数字，形态见 §9.3；2026-10-27 批次五） | §5 表的**标识列直接写任务名**（「端子/子板变比确认」「两点标定与精度验收」），代码注释与文档写语义短语（「标定折算落地」「未标定闭锁」「遥测快照发布」…）；**逐号换算表见本文 §9.3** | ⚠ **机器面空白**：中文前缀不进 `scripts/check_ids.py` 语料（族 pattern 全是拉丁形态）→ 门禁咬不到，今天只有本表 + §9.3 + 评审三条兜；`id_aliases.json` 刻意不登记（登记了机器也看不见，只多一张没人核的表） |
+| 登记簿 `N-x` / `S-x` / `T-x`、专项 `A-x`、已删报告的 UI 簇 `U1~U5`（2026-10-26 方案 B） | 语义短语——**登记簿表首格本身就是短语**，如「双转换器无共同采样触发」「CI 远端闭环未验证」 | `scripts/archive/id_gate/id_aliases.json` 标 `retired-to-phrase` |
+| 网络设计条目 `F-NET/F-DRV/F-MS-<nn>`（12 个，2026-10-27 批次一） | 「§7 + 条目名」短语，如 `（§7「全局读即清搁浅事件」）`；条目名的权威清单 = `docs/网络/网络自愈架构设计.md` §7「条目名」列；那个 DRV 段孤儿号按本节末句**删号留事实**、未补定义 | `scripts/archive/id_gate/id_aliases.json` 标 `retired-to-phrase`（13 条）＋属主文档 §7 编号列仅作历史对照 |
+| 「数据可信」任务卡号（中文前缀「卡」+ 数字，形态见 §9.3；2026-10-27 批次五） | §5 表的**标识列直接写任务名**（「端子/子板变比确认」「两点标定与精度验收」），代码注释与文档写语义短语（「标定折算落地」「未标定闭锁」「遥测快照发布」…）；**逐号换算表见本文 §9.3** | ⚠ **机器面空白**：中文前缀不进 `scripts/archive/id_gate/check_ids.py` 语料（族 pattern 全是拉丁形态）→ 门禁咬不到，今天只有本表 + §9.3 + 评审三条兜；`id_aliases.json` 刻意不登记（登记了机器也看不见，只多一张没人核的表） |
 | `E-xx` 审计发现、`P0-x`~`P3-x` 审计条目、报告六族 `D/R/F/N/U/S`、复审残号 `S1~S14`/`A-x`/`B1~B10`/`T-x`、模拟器差距 `H-x`/`L-x`、`TM-*` 阶段号、`DP-*`、`gen`/`round`/会话临时号 | 写条目本身（"原子快照取数"、"队头阻塞"、"台架日志代次 288"、"第 3 轮台架"） | 别名表标 `void`；**部分死号故意不进别名表**，好让门禁继续咬残留引用 |
 | 规范曾规划却从未启用的前缀族（`DEF`/`WI`/`DR`/`OQ`/`RSK`/`GAP`/`SC`/`GEN`/`MS`/`UL`/`LAT`/`CS` 等） | 同上，写事实 | 无定义，本就不该存在 |

-> 想知道某个号还活着吗：跑 `scripts/check_ids.py --top 0`，或直接查 `id_aliases.json`——命中 `void` /
+> 想知道某个号还活着吗：跑 `scripts/archive/id_gate/check_ids.py --top 0`，或直接查 `id_aliases.json`——命中 `void` /
 > `retired-to-phrase` 就是死号。**看到查不到的号，正确动作是删号留事实，不是补一个定义。**

 ### 4.2 目标前缀（作废）
@@ -199,7 +199,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语
 ---

 ## 6. 模块码表
-`TC` 与 `TRAP` 共用模块码。唯一事实源是 `scripts/id_registry.json` 的族 pattern 与属主文档标题行；
+`TC` 与 `TRAP` 共用模块码。唯一事实源是 `scripts/archive/id_gate/id_registry.json` 的族 pattern 与属主文档标题行；
 **本文故意不再抄一份**——抄一份就多一处会过期的地方（历史上这张表就长期与代码不同步）。
 要加模块码：先改 registry，再在属主文档出现，最后才在别处引用。

@@ -223,11 +223,16 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语

 ---

-## 8. 门禁：`id-check`（八项校验）
+## 8. 门禁（2026-10-28 起：只有一道）

-查什么、报错怎么读、盲区在哪——**全在 `docs/门禁说明/id-check.md`**，本文只留口径与基线。
-八项校验一句话版：① 未登记前缀 ② 形态不合规（裸形 / 空格 / 中文 / 补零）③ 悬空引用 ④ 重复定义
-⑤ 冻结族越游标 ⑥ 编号未紧邻文档名 ⑦ 孤儿条目（告警）⑧ 可判定比例 + 两根护栏（**自 2026-10-28 起只报告，不拦提交**，路线见 §8.5）。
+**现行门禁 = `id-check-new`**（钩子同名）：只查 `git diff` 的**新增行**里有没有未登记形态的
+「字母+数字」标识；零语料、零维护。判据、白名单与盲区 → `docs/门禁说明/id-check-new.md`。
+
+本节以下（§8.1~§8.4）是**已退役**的全库语料审计（`id-check`，八项校验）的留档：
+脚本与两份语料已整体移入 `scripts/archive/id_gate/`，不再进提交门禁，
+只在你手工复查「存量编号现状」时才跑。退役理由与判据替换见 §8.5；
+八项校验一句话版（历史口径）：① 未登记前缀 ② 形态不合规 ③ 悬空引用 ④ 重复定义
+⑤ 冻结族越游标 ⑥ 编号未紧邻文档名 ⑦ 孤儿条目（告警）⑧ 可判定比例 + 两根护栏。

 ### 8.1 当前基线（2026-10-26 编号迁移批次后重打）

@@ -253,7 +258,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语
 ——两处都在 2026-10-26 修掉了，别再往回改。

 ### 8.4 台账与 `--strict`
-错误级问题按「文件 + 校验项 + 字面量 + 次数」记指纹进 `scripts/id_known_backlog.json`，`--strict` 只拦
+错误级问题按「文件 + 校验项 + 字面量 + 次数」记指纹进 `scripts/archive/id_gate/id_known_backlog.json`，`--strict` 只拦
 **台账之外**的新账，台账只减不增。本批台账已还清到 **0 条**——从现在起任何一条新错误级问题都会当场
 拦提交，**别指望还有豁免面**可钻。

@@ -265,7 +270,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语
 |---|---|---|
 | ① | 两根护栏（比例基线 / 不可判定绝对数上限）**转报告制**：照打数字，不再影响退出码 | **已完成 2026-10-28** |
 | ② | 用 **diff 级新号拦截**替换语料审计：只看新增行里命中"字母+数字"形态、且不在白名单里的字面量，FAIL 并提示改成语义短语；白名单 = 前缀级两张表（活族 11 + 器件/协议/点号约 90），基本不增长 | **已完成 2026-10-28**（`scripts/check_ids_new.py` + 钩子 `id-check-new`，与 `id-check` **双跑观察期**；详解 `docs/门禁说明/id-check-new.md`） |
-| ③ | 退役语料：99 族盘点成"活族清单"，冻结族段与 `id_aliases.json` 移入归档；`check_ids.py` 降为手工报告工具，退出钩子 | 待做（② 落地观察一周再动） |
+| ③ | 退役语料：99 族语料＋脚本整体移入 `scripts/archive/id_gate/`（保留可复现性，不再进提交门禁）；`check_ids.py` 降为手工报告工具，钩子摘除（口径 52 → 51） | **已完成 2026-10-28**（用户裁定跳过观察期直接做；`docs/门禁说明/id-check-new.md` 是唯一现役编号门禁） |

 **在 ② 落地之前，校验 1~6 仍是唯一的机械牙**：别因为"两根线不拦了"就顺手写号——
 新增的未登记前缀照样当场 FAIL（实测：在一个新文件里写一个自造前缀 + 数字，校验 1 与增量拦截双拦）。
@@ -328,7 +333,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语

 1. **关掉已清退族的发号口**：`L<n>-<nn>` 与 `F-<MOD>-<nn>` 从 §4.1『允许继续发号』**整行移出**（7 行 → 5 行），在『已停发、存量待清』各补一行硬口径——留着那两行，扫表的人照样照着发号（同 `TC-*` 那次的教训）。**机器面已探针复核**：`_check_dangling` 对「L 段号形态的新号」与「F 条目号形态的新号」各写一个，全部命中 §8 校验 3 **错误级**（台账 0 指纹 → 等于拦提交），所以不需要再冻结数值游标（各段最高号不同，单一数字游标反而放行低号）。
 2. **本文自述形态化**：把本文里 4 处「字母 T 紧跟数字」与 2 处 DRV 段孤儿号的**字面量写法**改成形态描述（lesson 不丢），使这四个族的门禁命中数真正归零，而不是停在「只有规范自己在引用」。
-3. **登记机器面还空着的那一面**：`scripts/id_registry.json` 给 `L-PROT`/`FEAT` 补 `retired` 字段；给 `T-TEST` 补 `cursor_note` 写明——它的 pattern 最高只到数字 3，**即使 `frozen: true` 校验 5 也碰不到任何新写法**（探针实测写 4 不响），所以该族停发今天只有 §3.3 禁令 + 评审两道兜底，**别把「存量已清零」读成「机器已关闭」**。
+3. **登记机器面还空着的那一面**：`scripts/archive/id_gate/id_registry.json` 给 `L-PROT`/`FEAT` 补 `retired` 字段；给 `T-TEST` 补 `cursor_note` 写明——它的 pattern 最高只到数字 3，**即使 `frozen: true` 校验 5 也碰不到任何新写法**（探针实测写 4 不响），所以该族停发今天只有 §3.3 禁令 + 评审两道兜底，**别把「存量已清零」读成「机器已关闭」**。

 > ⚠ 本轮执行期间另有一道并行改动落地：`docs/测试说明/boot_log_data/README.md`（登记簿旧号「启动日志固化流程」）与 `docs/测试说明/m2_data/README.md`（审计发现 E 族一处死号）已由该道改为语义短语——**本笔不重复改这两处、也不替它收口**；复测两处死号引用均为 0。

@@ -337,7 +342,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语

 **批次一 · 现在就能清（约 62 个站点 / 20 个字面量，不碰任何门禁）**：`N-*`、`TM-*`、`T-TEST`、`F-*`。

-> `F-*` 已于 2026-10-27 收口：映射 `scripts/rename_maps/batch7-f-net-semantic.json`（10 条**带上下文**的定点改写），`docs/网络/网络自愈架构设计.md` §7 加「条目名」列作权威对照，13 个旧号进 `scripts/id_aliases.json` 标 `retired-to-phrase`。
+> `F-*` 已于 2026-10-27 收口：映射 `scripts/rename_maps/batch7-f-net-semantic.json`（10 条**带上下文**的定点改写），`docs/网络/网络自愈架构设计.md` §7 加「条目名」列作权威对照，13 个旧号进 `scripts/archive/id_gate/id_aliases.json` 标 `retired-to-phrase`。
 > 作用域刻意只列 2 个文件、且 `old` 全部带上下文——同树里 `docs/硬件平台/` 的 **变压器位号（字母 T 紧跟数字）**（网表 ~4200 处 R/C/D/J/X/U/T 位号，本就不在门禁语料内）、`docs/芯片手册/` 的时序记号，以及各文档 Mermaid 图的**单字母节点名**（`F -->`、`EV`、`LN`…）都会被宽松正则顺伤；变更记录行（`BSD_Socket_API_使用指南.md` 的 `| 2026-10-13 |`）按 §8.1 豁免不改写。
 这四族**没有任何脚本按字面量匹配**，纯人读，正是「语义标识最好」的适用面；台架阶段族还是裸形（字母 T 紧跟一位数字），
 最容易与别的字母撞义。改法：号 → 短语（「台架阶段一」「网络自愈：监听生命周期」），残留引用同步清，
@@ -370,7 +375,7 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语
 （新旧并行核对通过，再谈切换），**不许先改文档再改代码**（会凭空造出悬空号，§8 校验 3 会当场拦）。

 **这条裁定的机器口径已落地（2026-10-27 同日补；上一版这里写「停发今天只有规范效力」，那是当日的实测记录，不是笔误，留作历史）**：
-`scripts/id_registry.json` 的 **37 个 TC 类族已全部 `frozen: true`**，其中 **34 个 `TC-HOST-*` 子族带游标**，冻结在
+`scripts/archive/id_gate/id_registry.json` 的 **37 个 TC 类族已全部 `frozen: true`**，其中 **34 个 `TC-HOST-*` 子族带游标**，冻结在
 裁定日该套件存量最高号；5 个游标低于存量的已抬到水位（`TC-PROTELEM-013→015`、`TC-SYSLOG-108→137`、
 `TC-ADCHEALTH-011→023`、`TC-ADCCAL-017→023`、`TC-I104SRV-041→053`），裁定理由记在 registry 顶层
 `tc_freeze_2026_10_27`。落地的直接诱因是本族在裁定当天还在长大：另一道在飞的 `time_sync` 改动新增了
@@ -453,14 +458,15 @@ P-6 号必须能反查到定义（属主登记处得存在）· P-7 编号不语

 | 日期 | 变更 | 说明 |
 |---|---|---|
+| 2026-10-28 | **编号门禁第三步收口：全库语料审计退役（钩子 52 → 51）** | 用户裁定跳过观察期直接做。`check_ids.py` 与两份语料（`id_registry.json` 87.6 KB / `id_aliases.json` 187 KB）+ 债务台账整体移入 `scripts/archive/id_gate/`（附归档 README，含"为什么退役 / 现在用什么 / 怎么手工跑"）；`id-check` 钩子摘除，现役编号门禁只剩 `id-check-new`（只查新增行）。连带改：`rename_ids.py` 的别名表路径指向归档、新门禁排除面加 `scripts/archive/`、`doc-links` 跳过 `.mnemon/` 与 `ci-artifacts/`（本地状态与草稿，非项目文档）、`id-check.md` 加退役横幅、`门禁说明/README` 与 `AGENTS` 的钩子数三数对齐（声明 51 / commit 阶段 50 + gitlint 1）。归档脚本从新路径实跑：811 文件 / 8,051 字面量、`--strict` rc=0。 |
 | 2026-10-28 | **编号门禁第二步落地：新增行拦截（零语料）** | `scripts/check_ids_new.py` + 钩子 `id-check-new`：只看新增行，破折形态未知前缀 FAIL、已停发族只 WARN、单字母+数字放行（元件位号同形，见该门禁 §6 盲区）。白名单是**前缀级**两张表（活族 11 条 / 器件与协议约 90 条），不是字面量账本——后者会退化成 `id_aliases.json` 的老路。调参依据：最近 80 笔真实提交回放，未知形态 15 种（12 种是设备与协议名、3 种是停发族），调好后误报 0；自检 5 正例 + 29 反例。与 `id-check` **双跑**一个观察期后再按 §8.5 ③ 退役旧语料。 |
 | 2026-10-28 | **编号门禁减负第一步：两根护栏转报告制** | 用户裁定「编号门禁每次浪费很多时间」→ 先摘掉语料审计的强制面。护栏 1（可判定比例基线）与护栏 2（不可判定绝对数上限）自此**只打印、不拦提交**；实测把基线调到 99.9%、上限调到 1 处，退出码仍为 0。硬拦只剩校验 1~6 的台账外新账（同一实测：新文件里写一个自造前缀 + 数字，校验 1 与增量拦截照旧 FAIL）。退役路线 ①②③ 写进 §8.5；减负依据 = 近 80 笔提交有 61 笔被编号体系牵连、语料共 99 族（78 族已冻结）。 |
 | 2026-10-28 | **变更记录行里已停发/作废族的示例编号改形态描述；并用门禁自身计数器把「这一笔能不能压下不可判定绝对数」钉死为零** | 用户指令：把变更记录行里已停发族的那几枚示例编号改成语义形态描述，并确认它让不可判定引用绝对数净减、不是只算自己这一笔。**实测裁定：净减 = 0**。门禁把「表格首格是日期」的行整行豁免于编号判定（registry 侧的变更记录豁免，本笔前全库已豁免 198 处站点），本表的示例编号从来不进引用总数分母，改它必然不动绝对数——改前改后同一个计数器均为 **1003**（上限 1166；可判定 87.43%，三项都是 2026-10-28 本回合实测）。唯一移动的是那行豁免计数本身（本文件少 1 处站点），把它当清退成果就是把自记账成全局减量，正是本笔要排除的错法。本文对该计数器的全部贡献 **6** 处，逐文件集合差实测：全是「非编号」判定栏里既定的噪声名与裸形盲区（哈希算法名、总线名、严重度档位、硬件位号），不是编号，不清。本笔动的 3 处只是写法：作废的网络条目孤儿号（F 前缀 + 模块码段 + 数字序号三段）与已删报告的 UI 簇（字母 U 紧跟一位数字，区间两端即该簇首尾两枚）；事实本体仍在别名表、registry 游标备注与 git 历史，一处没丢。刻意不动：硬件位号形态的举例（判非编号）、保留现存号族的冻结游标数字（冻结水位的证据本体）、其它文档与注册表里的同名字段（各自写域）。§5.5 同步写死该例外的硬口径。零代码、零编号增删、两根护栏基线均未调整。 |
 | 2026-10-27 | **批次五：「数据可信」任务卡号整族清退 + 注入验证卡销项删行** | 用户指令「数据可信.md 已经完成的内容请进行销项删除，去除相关编号」。实测 **288 站点 / 56 文件**（代码与测试 191 / 文档 56 / 门禁配置与本文 41）全改语义短语；§5 表首列由「序」改「标识（任务名）」、14 个旧号进 §9.3 换算表；顺带按属主文档判语义清掉同形态的悬空引用 4 处（「UI 补齐」波次的 `[comm]` 段前置项）。门禁面：编号字面量与不可判定绝对数**零变化**（中文前缀不在语料），收口复跑 `check_ids.py --strict` 与 `check_doc_links.py --all --sections-strict` |
 | 2026-10-27 | **批次四：`L-PROT` / `FEAT` 发号口关闭（§4.1 七行→五行）+ 本文自述形态化 + 登记 `T-TEST` 机器面空白** | 用户指令「语义标识已定为默认形态，看看还有哪些编号族仍被引用、各自还剩多少，把能清的族清掉一批」。按门禁 `Checker` 实测三口径重打 §9 存量表：**真编号活引用只剩 `TC-*`（保留、水位 497/81 未涨）、`TRAP-*`、`CODE-RULE-*`、`MENU-STATE-*` 四族**，批次一/二涉及的 `N-*`/`TM-*`/`T-TEST`/`L-PROT`/`FEAT` 活引用均已归零。本笔：① §4.1 把 `L<n>-<nn>`、`F-<MOD>-<nn>` 从『允许继续发号』整行移出并在『已停发』栏各写一行（含探针证据：新形态号 → 校验 3 错误级）；② 本文 6 处形态自述改「字母+数字」描述，使四个族门禁命中归零、lesson 不丢；③ registry 给 `L-PROT`/`FEAT` 补 `retired`、给 `T-TEST` 补 cursor_note（pattern 上限即 3 → 冻结游标是空操作，停发今天只有规范效力）；④ 分类登记 §4.4 误判面（版本记号 / 活表代号 / 状态组合 / 位号）与 §4.3 冻结波次号两类**不清**的理由。未改门禁判定逻辑、未动冻结历史与原始串口日志、未新增任何号。 |
-| 2026-10-27 | **批次一 `F-*` 收口：网络设计 12 个条目号转「条目名」语义短语，§7 表加「条目名」列为权威对照** | 用户指令「把网络设计里的 `F-*` 条目号换成语义短语，别改坏硬件资料的 T1/T2/T3 位号和 Mermaid 节点名」。走 `scripts/rename_ids.py`（映射 `scripts/rename_maps/batch7-f-net-semantic.json`，`--no-alias` 后手工写别名），10 处定点改写＝属主文档正文 9 处（含 1 处孤儿号删号留事实）+ `test/host/net_socket/net_socket_test.c` 注释 1 处；孤儿号（F 前缀 + 模块码段 + 数字序号的三段形态；§7 从无定义行）删号留事实、不补定义；13 个旧号标 `retired-to-phrase`。刻意不动：§7 编号列（历史对照）、`BSD_Socket_API_使用指南.md` 变更记录行、`docs/硬件平台/` 位号、Mermaid 节点名。`scripts/id_registry.json` FEAT `cursor_note` 改记停发口径（三模块各有最高号 → 不冻结游标的理由写在里面）。零代码语义变更。 |
-| 2026-10-27 | **停发机械化落地：34 个 `TC-HOST-*` 子族游标冻结，§8 校验 5 开始咬新配的 TC 号** | 上一笔把缺口登记为「停发今天只有规范效力」并写明机械化怎么做；本笔照它落地、把话兑现：`scripts/id_registry.json` 37 个 TC 类族全部 `frozen: true`，34 个子族的 `cursor` 冻结在裁定日存量最高号（字符串形态——整型比较静默不生效；5 个低于存量的已抬：`TC-PROTELEM-013→015`、`TC-SYSLOG-108→137`、`TC-ADCHEALTH-011→023`、`TC-ADCCAL-017→023`、`TC-I104SRV-041→053`），理由记在顶层 `tc_freeze_2026_10_27`。探针（Checker `_check_frozen`）：在 `TC-PROTSET-` 段存量最高号之上再加一号 → 命中 1 条校验 5，写存量最高号本身 → 零误伤；`check_ids.py --only 5` = 0 处；plain 与 `--strict` 的错误级 findings 与本笔前逐条相同（**12 条 `TC-TIMESYNC-0xx` 悬空引用属另一道在飞的 time_sync 改动，不在本笔写域，也没替它改**）；台账 0 条、可判定 87.67%、不可判定 979 / 上限 1,166，不动 §8.1。**没有把主族 `TC` 说成已冻结**：它 `cursor` 仍为 `null`，§4.1 框内第三条与 §9.1 末段把这块空白及其兜底（校验 3 + 冻结水位 564/474/79 只减不增 + 评审）写明，并规定「给这些模块补号即使在文档里补了定义行也算违令」。§9.1 末段由「效力边界」改写为「机器口径已落地」，当日实测留作历史不抹。零代码、零编号增删。 |
+| 2026-10-27 | **批次一 `F-*` 收口：网络设计 12 个条目号转「条目名」语义短语，§7 表加「条目名」列为权威对照** | 用户指令「把网络设计里的 `F-*` 条目号换成语义短语，别改坏硬件资料的 T1/T2/T3 位号和 Mermaid 节点名」。走 `scripts/rename_ids.py`（映射 `scripts/rename_maps/batch7-f-net-semantic.json`，`--no-alias` 后手工写别名），10 处定点改写＝属主文档正文 9 处（含 1 处孤儿号删号留事实）+ `test/host/net_socket/net_socket_test.c` 注释 1 处；孤儿号（F 前缀 + 模块码段 + 数字序号的三段形态；§7 从无定义行）删号留事实、不补定义；13 个旧号标 `retired-to-phrase`。刻意不动：§7 编号列（历史对照）、`BSD_Socket_API_使用指南.md` 变更记录行、`docs/硬件平台/` 位号、Mermaid 节点名。`scripts/archive/id_gate/id_registry.json` FEAT `cursor_note` 改记停发口径（三模块各有最高号 → 不冻结游标的理由写在里面）。零代码语义变更。 |
+| 2026-10-27 | **停发机械化落地：34 个 `TC-HOST-*` 子族游标冻结，§8 校验 5 开始咬新配的 TC 号** | 上一笔把缺口登记为「停发今天只有规范效力」并写明机械化怎么做；本笔照它落地、把话兑现：`scripts/archive/id_gate/id_registry.json` 37 个 TC 类族全部 `frozen: true`，34 个子族的 `cursor` 冻结在裁定日存量最高号（字符串形态——整型比较静默不生效；5 个低于存量的已抬：`TC-PROTELEM-013→015`、`TC-SYSLOG-108→137`、`TC-ADCHEALTH-011→023`、`TC-ADCCAL-017→023`、`TC-I104SRV-041→053`），理由记在顶层 `tc_freeze_2026_10_27`。探针（Checker `_check_frozen`）：在 `TC-PROTSET-` 段存量最高号之上再加一号 → 命中 1 条校验 5，写存量最高号本身 → 零误伤；`check_ids.py --only 5` = 0 处；plain 与 `--strict` 的错误级 findings 与本笔前逐条相同（**12 条 `TC-TIMESYNC-0xx` 悬空引用属另一道在飞的 time_sync 改动，不在本笔写域，也没替它改**）；台账 0 条、可判定 87.67%、不可判定 979 / 上限 1,166，不动 §8.1。**没有把主族 `TC` 说成已冻结**：它 `cursor` 仍为 `null`，§4.1 框内第三条与 §9.1 末段把这块空白及其兜底（校验 3 + 冻结水位 564/474/79 只减不增 + 评审）写明，并规定「给这些模块补号即使在文档里补了定义行也算违令」。§9.1 末段由「效力边界」改写为「机器口径已落地」，当日实测留作历史不抹。零代码、零编号增删。 |
 | 2026-10-27 | **停发口径收口：`TC-*` 从『允许继续发号』表整行移出，并登记「机器面还没冻结」这个缺口** | 裁定上一笔已入档，但效力写在了会被扫表读过的地方：`TC-*` 仍占着「允许继续发号」表第一行、用途列还写着「要进 C 断言标签」，那句"注意它已停发"只是表前的脚注；而那张表连表头行都在早先瘦身时丢了（GFM 里表格不能紧跟段落，整张塌成正文）。本笔：① 移出该行、补回表头与空行，『允许继续发号』写成**恰好 7 行**；② 表下加防误读框，把「不做了」的两条误读各钉一次——「维持原状所以还能发」与「停发所以顺手清掉/复用号」，并写明唯一重启入口 = 先裁定再回本节改表；③ 实测登记效力边界：registry 37 个 TC 类族仍有 35 个 `frozen: false` 带活游标，§8 第 5 项碰不到它们（且 `cursor` 为空时该校验直接跳过），所以停发今天只有规范效力，机械化单独开卡走 §7.3；④ §5.1 补「不在 7 行内第 ① 步就走不通」、§9.1 两条硬口径扩成三条（新增「停发 ≠ 待清」）并补效力边界段、§9.2 计数 8 → 7。同步：`AGENTS.md` 索引行、`docs/测试说明/测试文档模板规范.md` §6.3、`docs/门禁说明/host-unit-tests.md` §7 号段行（那里原文写着「新增用例要带号」，是最直接的误读源头）。零代码、零编号增删。 |
 | 2026-10-27 | **批次三裁定「不做」：`TC-*` 保留现状但即日停发** | 用户原话「批次三，不坐」（即不做）。裁定写进 §9.1 批次三（含理由与两条硬口径）、§4.1『已停发』栏加一行、§9 结果表同步。停发的硬口径：游标冻结、现存号只减不增、**新用例一律用语义化测试函数名 + 文档表格行名，不再配 `TC-` 号**；真要清则先让追溯器同时认新旧两种形态、核对通过后单独开卡，不许先改文档再改代码（会造悬空号）。留着的判据依据：`TC-*` 是 §4.1 那条判据（有脚本按字面量匹配）唯一真满足的族，字母号的痛在「人读」侧，解法是不再造给人读的号，而不是拆掉机器面的把手。 |
 | 2026-10-27 | **语义标识定为唯一默认形态；编号收窄为「机器按字面量匹配」的例外，并首次给出现量清点与三批计划** | 用户原话：「不要用字母加数字的编号，简直太难以理解了，语义标识是最好的」。本笔：① 标题下的一句话从「允许用号的族只有 8 个」改成「语义标识是唯一默认、编号是例外」，并把 §4.1 拆成『允许继续发号』8 族与『已停发、存量待清』4 族（`N-*` / `TM-*` / 台架阶段裸形 / `F-*`）——原表自称穷举，实际漏登记了这三类在用族，属真缺陷。② 新增 §9 存量清点（用门禁自身接口实测：26 族仍有引用、565 个字面量、1,108 个引用站点）与三批计划：批次一 62 站点不碰门禁即可清、批次二保护功能号 184 站点转功能名、批次三 `TC-*` 561 站点需先换追溯机制（等用户裁定）。③ §8.1 基线按 2026-10-27 复测重打：784 文件 / 7,828 字面量、护栏 2 实跑 1,161 / 上限 1,166。 |
-| 2026-10-26 | **编号治理收口：清死号 → 停发活号 → 本文重写为短版（用户三次裁定）** | 全仓字母+数字编号 10,956 → 8,230 处。① **清死号**：属主登记处已删或从未启用的号一律就地删号留事实、禁补号（文本实删约 1,557 处）。② **停发活号**：登记簿 `N-x`/`S-x`/`T-x`、专项（A 前缀 + 数字）、已删报告的 UI 簇（字母 U 紧跟一位数字，区间两端即该簇首尾两枚）共 20 个号转成语义短语（约 418 处）——登记簿表首格就是短语，旧号进 `scripts/id_aliases.json` 标 `retired-to-phrase`；已销项的死号**故意不进别名表**，让门禁继续咬残留引用。③ **本文瘦身**：619 行 → 229 行，删掉八原则长表、迁移映射表、模块码表与门禁细节（那些各有事实源：registry / 别名表 / `docs/门禁说明/id-check.md`），改成「先问三句再决定要不要发号」+ §4.1 允许用号的族**穷举 = 8 个**。④ **门禁配套**：`check_ids.py` 加变更记录行豁免与第二根护栏 `undecidable_total_ceiling`（比值会被清号动作稀释，绝对数不会），债务台账还清到 0 条 → `--strict` 实为全量拦截，比例基线重打为 86.0%。**本表按用户 2026-10-26 的明确指示只保留最近一条**，更早沿革看 `git log` 与 `docs/门禁说明/id-check.md` §7.5（含其后的方案 B 一节）；这是**本文档的例外**，不改变 §5.5对其他文档「冻结历史不回改」的约束。 |
+| 2026-10-26 | **编号治理收口：清死号 → 停发活号 → 本文重写为短版（用户三次裁定）** | 全仓字母+数字编号 10,956 → 8,230 处。① **清死号**：属主登记处已删或从未启用的号一律就地删号留事实、禁补号（文本实删约 1,557 处）。② **停发活号**：登记簿 `N-x`/`S-x`/`T-x`、专项（A 前缀 + 数字）、已删报告的 UI 簇（字母 U 紧跟一位数字，区间两端即该簇首尾两枚）共 20 个号转成语义短语（约 418 处）——登记簿表首格就是短语，旧号进 `scripts/archive/id_gate/id_aliases.json` 标 `retired-to-phrase`；已销项的死号**故意不进别名表**，让门禁继续咬残留引用。③ **本文瘦身**：619 行 → 229 行，删掉八原则长表、迁移映射表、模块码表与门禁细节（那些各有事实源：registry / 别名表 / `docs/门禁说明/id-check.md`），改成「先问三句再决定要不要发号」+ §4.1 允许用号的族**穷举 = 8 个**。④ **门禁配套**：`check_ids.py` 加变更记录行豁免与第二根护栏 `undecidable_total_ceiling`（比值会被清号动作稀释，绝对数不会），债务台账还清到 0 条 → `--strict` 实为全量拦截，比例基线重打为 86.0%。**本表按用户 2026-10-26 的明确指示只保留最近一条**，更早沿革看 `git log` 与 `docs/门禁说明/id-check.md` §7.5（含其后的方案 B 一节）；这是**本文档的例外**，不改变 §5.5对其他文档「冻结历史不回改」的约束。 |
@@ -1,6 +1,6 @@
 # 门禁逐项说明（每种门禁一篇）

-> 这一目录回答一个问题：**提交时那 52 个钩子到底在干什么、拦谁、放谁、什么时候会骗人。**
+> 这一目录回答一个问题：**提交时那 51 个钩子到底在干什么、拦谁、放谁、什么时候会骗人。**
 > 每个门禁一篇，八段固定结构：查什么 / 为什么要它 / 触发面 / 报错怎么读 / 好处 /
 > **限制与盲区** / 豁免与基线 / 改门禁本身要注意什么。**最后一节是这套文档存在的理由**——
 > 一份只看"拦了什么"的门禁文档，会让人以为绿就是对的。
@@ -8,16 +8,16 @@
 - 配置事实源：`.pre-commit-config.yaml`。**钩子数的唯一口径 = YAML 解析后的 hook 条目数**，不是文件里的文本行数。
  自查（打印声明数；加/删一条钩子后，这个数要与 **AGENTS.md 的「共 N 个钩子」**、**本目录 §2 标题**同时对齐）：
  `& '.venv\Scripts\python.exe' -c "import yaml; d=yaml.safe_load(open('.pre-commit-config.yaml', encoding='utf-8')); print(sum(len(r['hooks']) for r in d['repos']))"`
-  → **52**（2026-10-26：49 → 50 加 `generated-fresh`；2026-10-27：50 → 51 加 `nested-comment`；
-  2026-10-28：51 → 52 加 `id-check-new`——编号门禁第二步，与 `id-check` 双跑观察）。
+  → **51**（2026-10-26：49 → 50 加 `generated-fresh`；2026-10-27：50 → 51 加 `nested-comment`；
+  2026-10-28：51 → 52 加 `id-check-new`、随即 52 → 51 摘掉 `id-check`（退役全库语料审计））。
  ⚠ **别用 `grep -c` 去数配置里的声明行**：该文件里有一条**注释掉的**候选钩子（clang-format，第 65 行），
-  文本 grep 会多算 1 = 53——「声明 53 / 文档 52 / 实跑 52」这种三个数不同源的争执就是这么来的。真要 grep，
+  文本 grep 会多算 1 = 52——「声明 52 / 文档 51 / 实跑 51」这种三个数不同源的争执就是这么来的。真要 grep，
  用只认行首缩进的模式直接数是 52（含那一条注释掉的候选，故与 YAML 口径差 1）。
  ⚠ 反过来的坑也真踩过（2026-10-27）：在配置**注释里复述那个 grep 字面量**，会让文本 grep 再虚高 1——
  数数只认 YAML 解析，注释与文档里都别写出那个字面量（`docs/门禁说明/nested-comment.md` §8 记了现场）。
  实跑侧口径：`scripts/ci_local.py` 的 `[SUMMARY] L0: pre-commit hooks -- passed=A failed=B skipped=C`，
-  `A+B+C` = **commit 阶段**的钩子数（51），再加 `gitlint` 1 条（它的 commit-msg 阶段声明写在**上游**仓库自带的
-  钩子清单里，本配置文件里查不到，见 `scripts/ci_local.py` 文件头）→ 51 + 1 = 52 = 声明数，三数同源。
+  `A+B+C` = **commit 阶段**的钩子数（50），再加 `gitlint` 1 条（它的 commit-msg 阶段声明写在**上游**仓库自带的
+  钩子清单里，本配置文件里查不到，见 `scripts/ci_local.py` 文件头）→ 50 + 1 = 51 = 声明数，三数同源。
 - 通用机制（两阶段、stash 陷阱、`always` 已废、增量拦截三段式、旧 §2.x 查号表）：
  `docs/代码规范/pre-commit使用说明.md` §2。
 - 快速自查（不等提交）：`& '.venv\Scripts\python.exe' scripts/ci_local.py`（L0 + L0b + L0.5）。
@@ -28,19 +28,19 @@
 |---|---|---|---|
 | **改写型** | 不报错，直接改你的文件 | `trailing-whitespace`、`end-of-file-fixer` | 重新 `git add` 被改的文件再提交（它改的是工作区，不是索引） |
 | **硬拦截** | 违反即失败，没有存量豁免 | `cppcheck`、`coding-standard`、`doc-links`、`no-mojibake`、`mem-budget`、`ui-golden`、`font-charset`、`lv-conf-sync`、`task-table`、`mem-numbers`、`registration-check`、`cubemx-survival`、`test-suite-switch`、16 个主机单测、官方 5 个、`gitlint` | 只能改代码或改文档；**不要**找豁免开关 |
-| **增量拦截** | 规则恒生效，但存量钉在基线/台账里，只许减不许增 | `layer-deps`（3 条，2026-10-25 还清 UI 记录 3 条）、`bsp-err`（38 条）、`id-check`（`scripts/id_known_backlog.json` 台账）、`generated-fresh`（5 处 `docs/images/` 配图存量，脚本内 `BASELINE`） |
-| **只查新增** | 只看本次改动的增量，没有存量基线，也没有台账 | `id-check-new` | 改成语义短语，或把设备名/协议名登记进脚本白名单（行内 `[编号豁免]` 是最后手段） |、`nested-comment`（2 处主机侧假件头，`test/host/common/`，脚本内 `BASELINE`） | 报错先分清是**新增**还是**存量搬家**：`--verbose` 看归类，`--prune` 看已还清 |
+| **增量拦截** | 规则恒生效，但存量钉在基线/台账里，只许减不许增 | `layer-deps`（3 条，2026-10-25 还清 UI 记录 3 条）、`bsp-err`（38 条）、`generated-fresh`（5 处 `docs/images/` 配图存量，脚本内 `BASELINE`）、`nested-comment`（2 处主机侧假件头，`test/host/common/`，脚本内 `BASELINE`） | 报错先分清是**新增**还是**存量搬家**：`--verbose` 看归类，`--prune` 看已还清 |
+| **只查新增** | 只看本次改动的增量，没有存量基线，也没有台账 | `id-check-new` | 改成语义短语，或把设备名/协议名登记进脚本白名单（行内 `[编号豁免]` 是最后手段） |

 ⚠ 增量拦截最容易误会的一点：**绿灯不等于没问题**，只等于"没有比上次更差"。
 每个增量拦截门禁的基线数字都写进它自己的文档，读那篇时第一眼看的就是"现在在册多少条"。

-## 2. 索引（52 个 hook → 28 篇 + 1 根只有本表指针（专篇待补）+ 1 根详解在 docs/测试说明/）
+## 2. 索引（51 个 hook → 28 篇，其中 1 篇是已退役门禁的留档 + 1 根只有本表指针（专篇待补）+ 1 根详解在 docs/测试说明/）

 | 门禁文档 | 覆盖的 hook id | 一句话它在查什么 | 改了哪类文件才会跑 | 文档 |
 |---|---|---|---|---|
 | [`bsp-err.md`](bsp-err.md) | `bsp-err` | BSP 的对外 API 面：错误通道类型、超时宏命名、必须写返回值、返回值不得裸丢弃 | `Drivers/BSP/**` 或门禁自身 | 已写 |
 | [`layer-deps.md`](layer-deps.md) | `layer-deps` | 分层方向：`Drivers/BSP/**` 不得 include `App/**` | `Drivers/BSP/**` | 已写 |
-| [`id-check.md`](id-check.md) | `id-check` | 实体编号的八项校验（未登记前缀、裸形、重复定义、孤儿、悬空引用…） | 几乎所有文本文件 | 已写 |
+| [`id-check.md`](id-check.md) | ~~`id-check`~ | **已退役（2026-10-28）**：全库语料的八项校验，留档备查；现行编号门禁见下一行 | 在时有：几乎所有文本文件 | 已写（退役留档） |
 | [`id-check-new.md`](id-check-new.md) | `id-check-new` | **只查新增行**有没有新造编号（零语料前缀白名单，已停发族只告警） | 任意 md/c/h/py/yaml/txt | 已写 |
 | [`doc-links.md`](doc-links.md) | `doc-links` | 文档里的路径引用是否存在；`--sections-strict` 另查章节号是否还存在 | 任意 `.md` | 已写 |
 | [`cppcheck.md`](cppcheck.md) | `cppcheck`、`test-cppcheck` | 静态分析（真机侧与 `test/` 侧两套范围与抑制项） | C/H 源文件 | 已写 |
@@ -127,7 +127,7 @@
 - 用例号段：`TC-HOST-<模块码>` 以 `test/host/<目录>/*` 为属主登记处（`docs/编号规范.md` §4.1）；
  **该号段 2026-10-27 起停发新号**（用户裁定「批次三，不坐」）：新增用例**不配号**，写语义化测试函数名，
  现存号只读、不清、不复用。追溯器只双向比对已有集合，**不会**因为新用例没号而报错——别把它当"要带号"。
-  **机器口径同日已落地**：`scripts/id_registry.json` 37 个 TC 类族全部 `frozen: true`，34 个子族游标冻结在 2026-10-27 存量最高号，
+  **机器口径同日已落地**：`scripts/archive/id_gate/id_registry.json` 37 个 TC 类族全部 `frozen: true`，34 个子族游标冻结在 2026-10-27 存量最高号，
  在号段上再加新号 = `id-check` 校验 5 错误级；无专属子族的模块码落在主族 `TC`（游标仍为空），那一面由校验 3 + 冻结水位 + 评审兜住
  → `docs/编号规范.md` §4.1 末框与 §9.1 末段。

@@ -1,13 +1,20 @@
-# `id-check` — 编号门禁（实体编号的八项校验）
+# `id-check` — 编号门禁（实体编号的八项校验）——**已退役（2026-10-28）**
+
+> ⚠ **本文是退役留档，不要照着它去改门禁。**
+> 2026-10-28 用户裁定：编号体系本身不再产生价值，全库语料审计的维护成本高过收益
+> → 钩子摘除（52 → 51），脚本与两份语料整体移入 `scripts/archive/id_gate/`；
+> **现行编号门禁 = `id-check-new`**（只查新增行、零语料）→ `docs/门禁说明/id-check-new.md`。
+> 退役路线与判据替换 → `docs/编号规范.md` §8.5。下面保留退役前的原样描述与实测基线，
+> 只在手工复查「存量编号现状」时还用得上。

 > 一句话：它管**"号"这个东西不许野生**——每个编号必须属于一个已登记的族、形态合法、
 > 有定义处、有人引用、引用它的时候说清是哪篇文档的号。
 > 规范正文 = `docs/编号规范.md`（§1 先问三句、§4.1 允许用号的族〔穷举〕、§8 门禁与实测基线），本门禁是那八项的机械执行。

- 配置：`entry: python scripts/check_ids.py --strict`，`pass_filenames: false`，
+- 配置：`entry: python scripts/archive/id_gate/check_ids.py --strict`，`pass_filenames: false`，
  `files:` 覆盖 `.md/.c/.h/.py/.yaml/.json/.txt` 与配置文件本身。
- 两份数据源（不是脚本里写死的）：`scripts/id_registry.json`（族 → 形态正则 / 属主登记处 /
-  是否冻结 / 游标 / 作用域 / 级别）、`scripts/id_aliases.json`（旧字面量 → 现行字面量）。
+- 两份数据源（不是脚本里写死的）：`scripts/archive/id_gate/id_registry.json`（族 → 形态正则 / 属主登记处 /
+  是否冻结 / 游标 / 作用域 / 级别）、`scripts/archive/id_gate/id_aliases.json`（旧字面量 → 现行字面量）。

 ## 1. 它在查什么

@@ -58,10 +65,10 @@
    → 改引用/补登记处；确属该欠的债要在台账写 reason（默认禁止顺手加）
 ```

- 单独跑：`& '.venv\Scripts\python.exe' scripts/check_ids.py --strict --verbose`（`--verbose` 带修法，`--top 30` 多打，`--only 1,3,5` 只跑指定校验）。
+- 单独跑：`& '.venv\Scripts\python.exe' scripts/archive/id_gate/check_ids.py --strict --verbose`（`--verbose` 带修法，`--top 30` 多打，`--only 1,3,5` 只跑指定校验）。
 - 常用旗标：`--strict`（钩子用的档位）、`--verbose`、`--write-backlog` / `--prune-backlog`
  （重建 / 收紧台账）、`--update-baseline`（把当前可判定比例写回 `id_registry.json`，只许涨）、`--no-trace`。
- 存量在 `scripts/id_known_backlog.json`（按指纹豁免，实跑 **0 处 / 0 类指纹**在册；HEAD 台账 303 条指纹 / 651 处）。
+- 存量在 `scripts/archive/id_gate/id_known_backlog.json`（按指纹豁免，实跑 **0 处 / 0 类指纹**在册；HEAD 台账 303 条指纹 / 651 处）。

 ## 5. 好处

@@ -112,8 +119,8 @@

 ## 7. 豁免与台账口径

- 存量：`scripts/id_known_backlog.json`（指纹级）；**只减不增**，收紧用 `--prune-backlog`。
- 别名：`scripts/id_aliases.json`（旧字面量 → 现行字面量）——号改名走 `scripts/rename_ids.py`，
+- 存量：`scripts/archive/id_gate/id_known_backlog.json`（指纹级）；**只减不增**，收紧用 `--prune-backlog`。
+- 别名：`scripts/archive/id_gate/id_aliases.json`（旧字面量 → 现行字面量）——号改名走 `scripts/rename_ids.py`，
  它会显式写别名条目，**绝不全局查找替换**。
 - 比例基线：`id_registry.json` 的 `decidable_ratio_baseline`（实跑当前 86.01%，基线 86.0%、容差 0.1pp）。

@@ -202,7 +209,7 @@

 **每批自证没吃余量（可复制的做法，五项式）**：

-1. 改之前先跑一次 `./.venv/Scripts/python.exe scripts/check_ids.py`，记下三个数：字面量总数、可判定、
+1. 改之前先跑一次 `./.venv/Scripts/python.exe scripts/archive/id_gate/check_ids.py`，记下三个数：字面量总数、可判定、
   不可判定绝对数。⚠ `--strict` 只回答「有没有新错误级」，**不回答可判定占比动了没有**——别拿它当替身。
 2. 改完再跑一次，逐数比对。
 3. 若绝对数涨了，先确认是不是本批吃的账。**不要用 `git stash` / `git checkout` 去回退**（那会把别人在飞的
@@ -214,7 +221,7 @@
   **手工把上限调高等于自废这道闸，任何时候都不许做。**
 ## 8. 改这个门禁本身

- 改族定义 = 改 `scripts/id_registry.json`，改完必须看**编号字面量总数有没有变小**：
+- 改族定义 = 改 `scripts/archive/id_gate/id_registry.json`，改完必须看**编号字面量总数有没有变小**：
  历史上两次批量改名后，识别正则的上界没跟着放宽，**整批号不再被匹配**（等于静默放行）。
 - 不要为了绿而往台账加 reason；确实该欠的债要写清楚原因（默认禁止顺手加）。
 - 台账文件自身不是语料（见 §6 第 6 条），改动它之后要单跑一次确认没有自循环新账。