refactor(编号): B 层口径落地——主机侧单测认代码为属主登记处
为什么不是"补 7 篇文档" - 实测这些号在代码目录外**零消费者**（NANDPORT 47 / PROTELEM 13 / PROTSET 11 / FREQ 11 / FTPAUTH 10 / SHA256 8 / SOE 7 / ADCHEALTH 11 / IEC104 23，共 141 号）， 唯一"外部引用"是 scripts/id_aliases.json 自己 → 逐号写文档等于造一份没人读、 还要跟着代码同步改的复述层（违反"同一事实只在一处详述"） 判据与注册表改动 - 新增 9 族 TC-HOST-<模块码>：class 仍为 TC（跨模块同号照旧由校验 4 抓）、 owner_docs_glob = test/host/<目录>/*、每模块游标做号段不越界（含 IEC104 补漏： 它上批改名前是纯数字 TC-104-*，没进当时的悬空普查所以漏建族） - 新旗标 allow_orphans（不补该旗标会让 141 号全变孤儿告警）、 subitem_ok（小写子项后缀母号在册即算已定义，差异仍由双向追溯如实报） - snapshot_only：§4.3 冻结快照族不参与"定义位优先"——先试无差别生效时，已销项的 登记簿 N-21 被审计报告同号接管，校验 6 从 266 暴涨到 1437、可判定比例假崩 68.7%， 且提示会教人补错文档名（正是 §1.2 的 N-31 撞号制造方式），故回退并改为快照族豁免 - excluded_paths 加 scripts/id_aliases.json 与 scripts/id_registry.json： 别名表/注册表自身不得制造引用面 - T-2 / T-3 / T-4 / T-6 入别名表标 void（2026-10-02 复审专项条目，销项只删行没清引用） 修自己的漏配（这条是 bug 修复，不是口径） - N / S-LDG / T-LDG 族漏登记 docs/任务规划/README.md（活登记处，N-21 在其中出现 2 次）， 只登记了 docs/任务规划/登记簿.md（N-21 为 0）→ 74 处真条目被误判 数字与诚实交代 - 错误级 1318 → 711（②398 + ③44 + ⑥269）；可判定比例 82.74%（基线 82.6%） - ⚠ 其中 504 处属**口径修正**、74 处属**修 bug**，**真正变好 0 处**；已在 docs/编号规范.md §8.1 写口径修正记录表，禁止拿 711 与 1318 直接比 - 文档：§4.1 补 TC-HOST 说明、§8.1 口径修正记录、§8.3 批 3 行、变更记录； pre-commit使用说明 §2.25 判定口径与最新实测同步 - 未改任何 C/H，不需 @build；提交钩子即 L0 + L0.5 全量验证
This commit is contained in:
@@ -454,9 +454,9 @@ cppcheck 是开源 C/C++ 静态分析工具，**不运行代码**，通过语法
|
||||
| **处理方式** | **当前 warn-only**（`docs/编号规范.md` §8 上线节奏：先清 backlog → 清零后 `entry` 加 `--strict` 拦提交，与 `doc-links` 章节校验同一条路径）。**唯一例外**：校验 8 的「可判定比例」跌破 `scripts/id_registry.json` 里的基线（82.3%）→ **任何模式都 FAIL**，这根线就是防回退的本体 |
|
||||
| **八项校验**（[示例] 本行引用的是各种非法形态示例，不是真实编号） | ①未登记前缀 ②形态不合规（裸形 `S3` / 空格形 `Trap 07` / 中文形 `陷阱 1` / 补零错 / 档位词带后缀 / 大写后缀 / 缺模块码）③悬空引用 ④重复定义 ⑤冻结前缀越游标 ⑥文档内编号未紧邻文档名 ⑦孤儿条目（告警）⑧可判定比例（只许涨不许跌） |
|
||||
| **配置两份** | `scripts/id_registry.json`：前缀族 → 属主登记处 / 形态正则 / 是否冻结 / 游标，**逐项来自 `docs/编号规范.md` §4 总表**，游标取「规范记载值」与「全库实测最大号」的较大者，偏差写进 `cursor_note`（实测偏差见规范 §8.2）；`scripts/id_aliases.json`：旧号 → 新号 / 作废标记（照搬 `section_aliases.json` 的成功范式） |
|
||||
| **判定口径** | 「定义」= 字面量出现在该族**属主登记处文档**里（不依赖表格行首等易漂移形态）→ §5.5「销项 = 删行 + 清全库引用」只做一半，校验 ③ 立刻报（`N-31`/`N-32` 正是这条）。「重复定义」= 字面量出现在**定义位**（表格首格 / 标题行 / 列表项行首），正文提到不算，否则任何交叉引用都会误判成事故 |
|
||||
| **判定口径** | 「定义」= 字面量出现在该族**属主登记处文档**里（不依赖表格行首等易漂移形态）→ §5.5「销项 = 删行 + 清全库引用」只做一半，校验 ③ 立刻报（`N-31`/`N-32` 正是这条）。「重复定义」= 字面量出现在**定义位**（表格首格 / 标题行 / 列表项行首），正文提到不算，否则任何交叉引用都会误判成事故。多族同形时的定族顺序：所在文档即属主 > 紧邻属主线索 > **定义位优先**（`docs/编号规范.md` §4.3 冻结快照族 `N-RPT`/`D-RPT`/`S-RPT`/`R-RPT`/`F-RPT`/`P-AUDIT`/`A-AUDIT`/`B-AUDIT` **不参与**——否则已销项的登记簿 `N-21` 会被审计报告同号接管，门禁反过来教人补错文档名，实测把校验 6 从 266 撑到 1437、可判定比例假崩到 68.7%）> 判悬空的族 > 全局族；小写子项后缀（`-b`/`-c`）在母号在册时视为已定义（`subitem_ok`），差异仍由双向追溯如实报 |
|
||||
| **顺带收编** | `scripts/check_test_traceability.py`（TC 用例双向追溯）由本钩子一并调用：正则补齐 `TC-[A-Z]{1,4}-\d{3,4}[a-z]?` 与大写后缀 / 无模块码形态（旧 `TC-[A-Za-z0-9]+-\d+` **整条漏扫** `TC-ADCIN-01A`），比对范围从「`test/board/*.c` ↔ `*_Test_Guide.md`」扩到 `test/host/` 一侧 + 7 篇「单元测试说明.md」（差异从 33 处涨到 326 处——**原口径漏的正是主机侧单测这一半**），另加 `--board-only` 回退旧口径 |
|
||||
| **首轮实测（2026-10-20）** | 8271 处编号字面量 / 可判定 **82.3%**（6808/8271）；错误级：②416 ③626 ⑥269，告警级：③239 ⑦88。错误集中在 `TC-PS-*`/`TC-PE-*`/`TC-AH-*`/`TC-SOE-*`（**主机侧单测有码无文档**，正是 §7.2 列的"缺文档 = 追溯断链"）与报告自有编号被裸引（`D-x`/`R-x`/`F-x`/`P0-x`，属 §9 阶段 1-③）。逐项数字与口径见 `docs/编号规范.md` §8.1 |
|
||||
| **最新实测（2026-10-21，B 层口径后）** | 8322 处编号字面量 / 可判定 **82.71%**（6883/8322）；错误级 711 = ②398 + ③44 + ⑥269，告警级 ③223 + ⑦100。⚠ **与 2026-10-20 的 1312 不可直接比**：其中 504 处属**口径修正**（主机侧单测 118 号实测在代码目录外零消费者，改认 `test/host/<目录>/*` 为属主登记处；子项后缀母号在册即算已定义），74 处属我修的**注册表漏配属主**（活登记处在 `docs/任务规划/README.md`，`N-21` 在其中出现 2 次而我只登记了 `登记簿.md`），**真正变好 0 处**——完整对照见 `docs/编号规范.md` §8.1 口径修正记录 |
|
||||
| **有牙实测（牙齿）**（[示例] 下列字面量是注入用的假编号） | 注入打在临时档（`git add -N` 进索引，跑完 `git rm --cached` + 删除，`git status` 干净）：`Z-99`→①、裸形 `S3`→②、`TC-NET-9999`→③、第二篇属主文档重复定义 `DP-01`→④、`E-70`→⑤（`E-xx` 冻结于 `E-63`）、裸引 `D-7`→⑥；六项分别被对应校验点名，`--strict` 退出码 1 |
|
||||
| **显式盲区（不是"检查通过"）** | ① 裸形同字母多义（§1.2：`P1` 五义 / `L1` 四义 / `U1` 四义 / `D7` 三义）与元器件位号同形（§4.4）→ 裸形族**只在属主登记处文档内**判越游标，文档外降告警；② 圈号编号（①②③…）与正常列举无法机械区分，不入判定；③ `docs/芯片手册/`、`docs/硬件平台/` 整体排除（位号 `B1`/`C1`/`L1` 与编号同形，是撞形根源）。前两块收口属 §9 阶段 1-②/1-③ 迁移批次，落地后再扩判定范围——盲区登记在 `id_registry.json` 的 `blind_spots` / `unmanaged_bare` |
|
||||
| **运行器** | `scripts/check_ids.py`（纯标准库；`--strict` 拦提交、`--update-baseline` 抬基线（**只许涨**，跌则拒绝写入）、`--only 1,3,5` 跑部分、`--top N` / `--verbose` 出细节、`--no-trace` 跳过 TC 追溯；退出码 0=通过或仅告警 / 1=错误或比例跌破基线 / 2=环境错误） |
|
||||
|
||||
@@ -412,6 +412,20 @@ git grep -n '<旧字面量>' # 零残留
|
||||
|
||||
**有牙实测**（[示例] 下列字面量是注入用的假编号，不是真实引用）：临时注入 `Z-99` / 裸形 `S3` / `TC-NET-9999`（悬空）/ `E-70`（越 `E-63` 游标）/ 裸引 `D-7` / 在第二篇属主文档重复定义 `DP-01` → 六项分别被校验 1/2/3/5/6/4 点名，`--strict` 退出码 1；临时档删除后 `git status` 干净。
|
||||
|
||||
**口径修正记录（2026-10-21，B 层）**——下列改动**改变了比例的分母/分子含义**，读历史数字必须知道：
|
||||
|
||||
| 改动 | 动机 | 对比例的影响 |
|
||||
|---|---|---|
|
||||
| 主机侧单测建 **9 族 `TC-HOST-<模块码>`**，属主登记处 = `test/host/<目录>/*`（代码即登记处） | 实测这些号在代码目录外**零消费者**（唯一"外部引用"是 `id_aliases.json` 自己），逐号补文档只会造出没人读的复述层 | 悬空错误 −508 中的 430（**口径修正，不是仓库变好**） |
|
||||
| `subitem_ok`：小写子项后缀（`TC-TIMESYNC-003b`）母号在册即算已定义 | §4.1 明允许小写后缀，是合法形态；双向追溯仍按完整字面量报差异，可见性不丢 | 悬空 −74（同上，属口径） |
|
||||
| **`snapshot_only`**：§4.3 冻结历史快照族（`N-RPT`/`D-RPT`/`S-RPT`/`R-RPT`/`F-RPT`/`P-AUDIT`/`A-AUDIT`/`B-AUDIT`）**不参与"定义位优先"** | 曾试过让定义位优先无差别生效：`N-21`（登记簿条目已销项）被审计报告里同号的另一码事"接管"，门禁转而去报 ⑥"请写报告文档名"——**照做就制造 §1.2 的 `N-31` 撞号**；实测该做法使校验 6 从 266 暴涨到 1437、比例假崩到 68.7% | 校验 6 回到 269（与 B 层前持平） |
|
||||
| **补属主**：`docs/任务规划/README.md` 加入 `N`/`S-LDG`/`T-LDG` 族的 `owner_docs` | 这是**我的配置漏项**：活登记处在 README（`N-21` 出现 2 次），我原先只登记了 `登记簿.md`（`N-21` = 0）→ 真条目被误判悬空 74 处 | 悬空 −74（**修 bug，不是口径**） |
|
||||
| `excluded_paths` 加 `scripts/id_aliases.json`、`scripts/id_registry.json` | 别名表/注册表**自身不得制造引用面**——上批别名条目一度成为这些号的唯一"外部引用" | 极小 |
|
||||
| 已销项历史任务号 `T-2`/`T-3`/`T-4`/`T-6` 入别名表（`status: void`） | §5.5「销项 = 删行 + 清引用」只做了一半的欠账；本条只让门禁停止把它当自造号，并如实指路 | 悬空错误 −35 |
|
||||
|
||||
**修正后实测（2026-10-21）**：错误级 **711**（B 层前 1318）＝ ②398 + ③44 + ⑥269；告警级 ③223 + ⑦100；可判定比例 **82.71%**（6883/8322），基线仍 82.6%。
|
||||
⚠ 拿 711 与 1318 直接比是**错的**——其中 504 处是口径修正，只有 74 处是我修的注册表 bug；真正"变好"的部分是 **0**。剩下的 711 处没有一条能靠调判据消掉，只能补文档、改写引用或按 §4.3 登记冻结。
|
||||
|
||||
**显式盲区（不是"检查通过"，是记在案上的判定边界）**：裸形同字母多义（§1.2 的 P1 五义 / L1 四义 / U1 四义 / D7 三义）与元器件位号同形（§4.4）→ 裸形族**只在属主登记处文档内**判越游标，文档外降为告警；圈号编号与正常列举无法机械区分，不入判定。这两块的收口属 §9 阶段 1-②/1-③ 的迁移批次，收口后再扩判定范围。
|
||||
|
||||
### 8.2 落地时发现的规范 ↔ 仓库偏差（registry 按实测收录，规范行待订正）
|
||||
@@ -432,6 +446,7 @@ git grep -n '<旧字面量>' # 零残留
|
||||
| 批 | 日期 | 族 | 旧 → 新 | 处数 / 文件 | 别名 |
|
||||
|---|---|---|---|---|---|
|
||||
| **批 1** | 2026-10-20 | 代码规范条款 | `S1`~`S19` → `CODE-RULE-01`~`19` | 78 处 / 2 文件 | 18 条（scoped：`scripts/check_coding_standard.py`、`docs/代码规范/pre-commit使用说明.md`） |
|
||||
| **批 3（口径）** | 2026-10-21 | 主机侧单测归属 | 建 9 族 `TC-HOST-*`（代码即属主）+ `subitem_ok` + `snapshot_only` + 补 README 属主 + `T-x` 入别名 | 判据与注册表改动，未改任何存量号 | 见 §8.1 口径修正记录 |
|
||||
| **批 2** | 2026-10-20 | 测试用例模块码 | 16 个码 → 单词化（见 §6） | 1,146 处 / 约 30 文件 | 全局别名（字面量已完全限定，无歧义） |
|
||||
| **批 1** | 2026-10-20 | UI 像素回归状态 | `S0`~`S7` → `MENU-STATE-00`~`07` | 61 处 / 3 文件 | 8 条（scoped：`simulator/tests/check_menu_rows.py`、`docs/UI设计/UI_自动化测试流程.md`、`simulator/README.md`） |
|
||||
|
||||
@@ -473,6 +488,7 @@ git grep -n '<旧字面量>' # 零残留
|
||||
|---|---|---|
|
||||
| 2026-10-14 | 新增 P-7 与引用可读性规则 | §2 加 **P-7「编号不语义，引用必语义」**（编号本体保持无语义并冻结，但正文引用必须带语义括注、禁裸 ID 独担信息）→ 六条原则变**七条**；§5.1 加前置步"先问能不能不加号"；新增 **§5.6「编号密集文档的对照节（强制）」**（≥3 个编号族必须加「导读：编号与术语」）；§4.1 补登记 **`E\d+`**（N34 自愈实验编号族，已封闭）并把 `N-\d{2}` 的在册范围订正为「曾用最大 `N-33`，现存至 `N-29`」；§1.2 悬空引用示例补 `N-32`；§7.1 同步订正。起因：`docs/网络/网络自愈架构设计.md` 合并与导读节实践暴露"裸编号引用不可读"，用户裁定以后尽量用语义标识 |
|
||||
| （规划稿） | 建立本文档 | 全库扫描 1,385 个不同编号 / 19,306 处出现后定稿的两层编号体系（全局编号 + 文档内编号）、六条原则、目标前缀总表、三批迁移映射与 `check_ids.py` 门禁设计；用户决策：`E-xx` 冻结保留、严重度档位词 `P0~P3` 不变、文档落 `docs/编号规范.md`、阶段 1 三批全做 |
|
||||
| 2026-10-21 | **B 层口径落地（批 3）** | 主机侧单测 118 号实测在代码目录外零消费者 → 建 9 族 `TC-HOST-*` 认代码为属主登记处（不逐号补文档）；新增 `subitem_ok`（小写子项后缀母号在册即算已定义）、`snapshot_only`（§4.3 冻结快照族不参与定义位优先）、`allow_orphans` 旗标与 `excluded_paths` 补两项；补 `docs/任务规划/README.md` 为 `N`/`S-LDG`/`T-LDG` 属主（**我的配置漏项，曾误判 74 处真条目悬空**）；`T-2`/`T-3`/`T-4`/`T-6` 入别名表标 `void`。错误级 1318 → 711（其中 504 处属口径修正、74 处属修 bug，**真正变好 0 处**）。新增 §8.1 口径修正记录表 |
|
||||
| 2026-10-20 | **编号改名开禁（用户授权）+ 批 1 落地** | 新增 `scripts/rename_ids.py`（§7.3 规划脚本：映射表驱动、显式 scope、干跑/落盘两态、自动写 `id_aliases.json` 的 scoped 条目、跳过 `[示例]`/`[计划]` 行与变更记录表、按原字节读写保 BOM 与行尾）。**批 1**：代码规范条款 `S1~S19` → `CODE-RULE-nn`（78 处/2 文件）、UI 像素回归状态 `S0~S7` → `MENU-STATE-nn`（61 处/3 文件）；`check_ids.py` 支持 **scoped 别名** 并登记两族（66 族）；可判定比例 82.3% → **82.7%**、裸形判错 71 → 50、错误级 1312 → 1291。§4.1 补两行、新增 §8.3 迁移批次记录 |
|
||||
| 2026-10-20 | **§8 门禁落地（warn-only）** | 新增 `scripts/check_ids.py`（八项校验 + 可判定比例基线）、`scripts/id_registry.json`（逐项来自 §4 总表 + 实测游标）、`scripts/id_aliases.json`；挂上 `id-check` 钩子（36→37）；顺带收编 `check_test_traceability.py`（正则补齐大写后缀/无模块码形态，比对范围扩到 7 篇「单元测试说明.md」+ `test/host/` 一侧，另加 `--board-only` 回退原口径）。**新增 §8.1 落地记录**（基线 82.3%、backlog 分布、有牙实测、显式盲区）与 **§8.2 规范↔仓库偏差表**（`E19`、`FR` 未补零、`TC` 模块码含数字、`F-<MOD>-<nn>` 总表缺行、`N` 子项后缀/扩位）；§4.1 相应行按实测订正并补 `F-<MOD>` / `P-<n>` 两行 |
|
||||
| 2026-10-15 | 新增 P-8 与语义标识规范（§3.3 / §5.7） | §2 加 **P-8「语义优先」**（规划 / 待办类条目优先用语义标识，不发字母+数字号）→ 七条原则变**八条**；§3 主轴由"两层编号"扩为**编号 / 语义标识 / 章节引用**三种；新增 **§3.3「语义标识（新条目默认形态）」**（形态规则、适用分界、引用写法）与 **§5.7「语义标识的登记、冻结与别名」**；§4.2 加修订说明（规划类前缀改语义标识，`TC`/`TRAP`/`FR`/`NFR`/`RC` 等保留编号）；§9 加「0.5 语义标识」阶段。起因：用户裁定去除字母数字编号（难理解），先定规范本体 |
|
||||
|
||||
@@ -304,6 +304,19 @@ class Checker(object):
|
||||
for f in fams:
|
||||
if f.get("adjacent_required") and self._has_adjacent_cue(f, line, start):
|
||||
return f
|
||||
# **定义位优先**：号在哪个族的属主登记处真定义了，就按那个族判。
|
||||
# 没有这一条，`TC-NANDPORT-007`（定义在 test/host/nand_port 的 TC-HOST 族）在别处
|
||||
# 被引用时会落回通用 TC 族（属主 = docs/测试说明/），假报一片悬空。
|
||||
for f in fams:
|
||||
# §4.3 **冻结历史快照族不参与定族**：它的号只是当年报告的存档，不是活的属主。
|
||||
# 否则 `N-21`（登记簿条目已销项）会被报告里同号的另一码事"接管"，报出
|
||||
# "请写《项目审查与优化建议报告》的文档名"——照做就把登记簿条目和审计报告
|
||||
# 搅成一条，正是 §1.2 的 N-31/N-32 撞号制造方式（实测这么改，属主不明暴涨 392 条、
|
||||
# 可判定比例假崩到 69.9%）。快照族只在**有紧邻文档名**时才被上面的线索步选中。
|
||||
if f.get("snapshot_only"):
|
||||
continue
|
||||
if literal in self.owner_tokens[f["name"]]:
|
||||
return f
|
||||
for f in fams:
|
||||
if f.get("check_dangling") and f["_owners"]:
|
||||
return f
|
||||
@@ -421,6 +434,14 @@ class Checker(object):
|
||||
if alias_hit(self, literal, rel) or literal in set(fam.get("allow_missing_defs", [])):
|
||||
self.stats["alias_hits"] += 1
|
||||
return
|
||||
if fam.get("subitem_ok"):
|
||||
# 小写子项后缀（`TC-TIMESYNC-003b`）：§4.1 明写「后缀只允许 -<小写字母>」，
|
||||
# 是**合法形态**，母号在册就算语义可判定；逐条登记子项只会把文档写成代码复述。
|
||||
# 可见性不丢——check_test_traceability.py 仍按完整字面量报 码有文档无。
|
||||
base = re.sub(r"[a-z]$", "", literal)
|
||||
if base != literal and base in self.defined_all:
|
||||
self.stats["subitem_hits"] += 1
|
||||
return
|
||||
sev = fam.get("dangling_outside_owner", "error") if rel not in fam["_owners"] else "error"
|
||||
self.add(3, sev, rel, lineno, literal,
|
||||
"悬空引用：%s 在属主登记处（%s）查无定义，也不在别名表里（§8 校验 3）"
|
||||
@@ -504,6 +525,10 @@ class Checker(object):
|
||||
for fam in self.families:
|
||||
if not fam.get("check_dangling") or not fam["_owners"]:
|
||||
continue
|
||||
if fam.get("allow_orphans"):
|
||||
# 属主登记处 = 代码的族（TC-HOST-*）：号定义在测试函数上、本来就只在
|
||||
# 自己文件里出现，按"无人引用"报孤儿是纯噪音（118 条），显式声明不判
|
||||
continue
|
||||
for lit in sorted(self.owner_tokens[fam["name"]]):
|
||||
outside = {r for r in self.refs.get(lit, set()) if r not in fam["_owners"]}
|
||||
if not outside:
|
||||
|
||||
@@ -2668,6 +2668,26 @@
|
||||
"to": "TC-IEC104-023",
|
||||
"status": "renamed",
|
||||
"note": "批 2：数字模块码 104 → IEC104（§6 表里本就写 I104，代码写成纯数字 104；纯数字不是模块码）（scripts/rename_ids.py 批：族 TC-IEC104）｜全库生效（本批字面量已完全限定，无歧义）"
|
||||
},
|
||||
"T-2": {
|
||||
"to": null,
|
||||
"status": "void",
|
||||
"note": "2026-10-02 版复审专项条目号（docs/任务规划/测试与架构专项.md 卷首声明「编号不随条目删除而回收」）。该条目已按「完成即销项」删行，仓内现存 T-1 仍在册；引用本号的 .dsh/skills 脚本与 test/ 文档属**引用未清**（§5.5 只做了一半）。本条只让门禁停止把它当自造号并如实指路：改写成语义标识（§3.3）或写全出处，**不要新发一个 T-2 号**（号不回收）"
|
||||
},
|
||||
"T-3": {
|
||||
"to": null,
|
||||
"status": "void",
|
||||
"note": "2026-10-02 版复审专项条目号（docs/任务规划/测试与架构专项.md 卷首声明「编号不随条目删除而回收」）。该条目已按「完成即销项」删行，仓内现存 T-1 仍在册；引用本号的 .dsh/skills 脚本与 test/ 文档属**引用未清**（§5.5 只做了一半）。本条只让门禁停止把它当自造号并如实指路：改写成语义标识（§3.3）或写全出处，**不要新发一个 T-2 号**（号不回收）"
|
||||
},
|
||||
"T-4": {
|
||||
"to": null,
|
||||
"status": "void",
|
||||
"note": "2026-10-02 版复审专项条目号（docs/任务规划/测试与架构专项.md 卷首声明「编号不随条目删除而回收」）。该条目已按「完成即销项」删行，仓内现存 T-1 仍在册；引用本号的 .dsh/skills 脚本与 test/ 文档属**引用未清**（§5.5 只做了一半）。本条只让门禁停止把它当自造号并如实指路：改写成语义标识（§3.3）或写全出处，**不要新发一个 T-2 号**（号不回收）"
|
||||
},
|
||||
"T-6": {
|
||||
"to": null,
|
||||
"status": "void",
|
||||
"note": "2026-10-02 版复审专项条目号（docs/任务规划/测试与架构专项.md 卷首声明「编号不随条目删除而回收」）。该条目已按「完成即销项」删行，仓内现存 T-1 仍在册；引用本号的 .dsh/skills 脚本与 test/ 文档属**引用未清**（§5.5 只做了一半）。本条只让门禁停止把它当自造号并如实指路：改写成语义标识（§3.3）或写全出处，**不要新发一个 T-2 号**（号不回收）"
|
||||
}
|
||||
},
|
||||
"id_aliases": {}
|
||||
|
||||
+234
-14
@@ -207,7 +207,8 @@
|
||||
"title": "登记簿条目（§4.1 在册保留；S-x/T-x 按 §7.1 并入本族）",
|
||||
"pattern": "\\bN-[0-9]{1,3}[a-z]?\\b",
|
||||
"owner_docs": [
|
||||
"docs/任务规划/登记簿.md"
|
||||
"docs/任务规划/登记簿.md",
|
||||
"docs/任务规划/README.md"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
@@ -224,7 +225,8 @@
|
||||
"title": "登记簿 存储/日志管线 条目（§7.1 续号并入 N，存量冻结）",
|
||||
"pattern": "\\bS-[0-9]{1,2}\\b",
|
||||
"owner_docs": [
|
||||
"docs/任务规划/登记簿.md"
|
||||
"docs/任务规划/登记簿.md",
|
||||
"docs/任务规划/README.md"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": true,
|
||||
@@ -242,7 +244,8 @@
|
||||
"pattern": "\\bT-[0-9]{1,2}\\b",
|
||||
"owner_docs": [
|
||||
"docs/任务规划/登记簿.md",
|
||||
"docs/任务规划/测试与架构专项.md"
|
||||
"docs/任务规划/测试与架构专项.md",
|
||||
"docs/任务规划/README.md"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": true,
|
||||
@@ -397,7 +400,8 @@
|
||||
"指南",
|
||||
"说明"
|
||||
],
|
||||
"module_code_note": "2026-10-20 批 2 模块码单词化后码长可达 9 位（ADCHEALTH/WATCHDOG），{0,4} 放宽到 {0,9}；不放宽会让改名后的号整批从门禁眼里消失（实测漏 950 处）"
|
||||
"module_code_note": "2026-10-20 批 2 模块码单词化后码长可达 9 位（ADCHEALTH/WATCHDOG），{0,4} 放宽到 {0,9}；不放宽会让改名后的号整批从门禁眼里消失（实测漏 950 处）",
|
||||
"subitem_ok": true
|
||||
},
|
||||
{
|
||||
"name": "TC-UPPER",
|
||||
@@ -412,7 +416,8 @@
|
||||
"cursor": null,
|
||||
"check_dangling": false,
|
||||
"malformed": "大写后缀非法：§4.1 规定后缀只允许 -<小写字母>（§7.1 统一为小写）",
|
||||
"module_code_note": "2026-10-20 批 2 模块码单词化后码长可达 9 位（ADCHEALTH/WATCHDOG），{0,4} 放宽到 {0,9}；不放宽会让改名后的号整批从门禁眼里消失（实测漏 950 处）"
|
||||
"module_code_note": "2026-10-20 批 2 模块码单词化后码长可达 9 位（ADCHEALTH/WATCHDOG），{0,4} 放宽到 {0,9}；不放宽会让改名后的号整批从门禁眼里消失（实测漏 950 处）",
|
||||
"subitem_ok": true
|
||||
},
|
||||
{
|
||||
"name": "TC-NOMOD",
|
||||
@@ -427,7 +432,8 @@
|
||||
"frozen": true,
|
||||
"cursor": null,
|
||||
"check_dangling": false,
|
||||
"malformed": "缺模块码：须写 TC-<MOD>-<nnn>（§4.1 / §6 模块码表；§7.2 列为孤儿待补文档）"
|
||||
"malformed": "缺模块码：须写 TC-<MOD>-<nnn>（§4.1 / §6 模块码表；§7.2 列为孤儿待补文档）",
|
||||
"subitem_ok": true
|
||||
},
|
||||
{
|
||||
"name": "TM",
|
||||
@@ -913,7 +919,9 @@
|
||||
"审查"
|
||||
],
|
||||
"collides_with": "N",
|
||||
"cursor_note": "⚠ 与登记簿 N-x 同名不同义（§4.3 / AGENTS.md 模块约定）→ 引用必须紧邻「报告」或报告文档名"
|
||||
"cursor_note": "⚠ 与登记簿 N-x 同名不同义（§4.3 / AGENTS.md 模块约定）→ 引用必须紧邻「报告」或报告文档名",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "D-RPT",
|
||||
@@ -933,7 +941,9 @@
|
||||
"报告",
|
||||
"审查"
|
||||
],
|
||||
"collides_with": "D"
|
||||
"collides_with": "D",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "S-RPT",
|
||||
@@ -952,7 +962,9 @@
|
||||
"报告",
|
||||
"审查"
|
||||
],
|
||||
"collides_with": "N"
|
||||
"collides_with": "N",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "R-RPT",
|
||||
@@ -971,7 +983,9 @@
|
||||
"报告",
|
||||
"审查"
|
||||
],
|
||||
"cursor_note": "实测现存至 R-9（2026-10-15 落地）；§1.2 记「R1=风险、R-2=内存优化项」同字母歧义"
|
||||
"cursor_note": "实测现存至 R-9（2026-10-15 落地）；§1.2 记「R1=风险、R-2=内存优化项」同字母歧义",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "F-RPT",
|
||||
@@ -989,7 +1003,9 @@
|
||||
"adjacent_cues": [
|
||||
"报告",
|
||||
"审查"
|
||||
]
|
||||
],
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "A-AUDIT",
|
||||
@@ -1010,7 +1026,9 @@
|
||||
"审计",
|
||||
"Trap_Records"
|
||||
],
|
||||
"collides_with": "A-REVIEW"
|
||||
"collides_with": "A-REVIEW",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "B-AUDIT",
|
||||
@@ -1031,7 +1049,9 @@
|
||||
"审计",
|
||||
"Trap_Records"
|
||||
],
|
||||
"collides_with": "B"
|
||||
"collides_with": "B",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "S-REVIEW",
|
||||
@@ -1112,7 +1132,9 @@
|
||||
"P1 收尾",
|
||||
"严重度"
|
||||
],
|
||||
"cursor_note": "⚠ 档位词 P0~P3 不带 -<数字> 后缀（§4.4）；本族是历史审计条目，形态按 §4.3 冻结沿用，新发现改语义标识（§3.3）；报告侧 P-x 属历史基线（§4.3），文档外按告警处理"
|
||||
"cursor_note": "⚠ 档位词 P0~P3 不带 -<数字> 后缀（§4.4）；本族是历史审计条目，形态按 §4.3 冻结沿用，新发现改语义标识（§3.3）；报告侧 P-x 属历史基线（§4.3），文档外按告警处理",
|
||||
"snapshot_only": true,
|
||||
"snapshot_note": "§4.3 冻结历史快照：只在引用写了文档名（紧邻线索）时参与定族，不参与「定义位优先」——避免同号把活登记处接管走"
|
||||
},
|
||||
{
|
||||
"name": "O-DOC",
|
||||
@@ -1371,6 +1393,204 @@
|
||||
"cursor_owner_only": true,
|
||||
"owner_note": "属主登记处 = check_menu_rows.py 的 STATES 表（键序 → 状态）；UI_自动化测试流程.md 与 simulator/README.md 是引用方",
|
||||
"cursor_note": "2026-10-20 批 1 从裸形 S0~S7 单词化（原名与登记簿 S-x、代码规范条款、2026-10-02 复审专项条目四义撞形，见 §1.2）。8 态封顶：加状态先改游标"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-NANDPORT",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：dhara NAND 移植层（N-21）（test/host/nand_port）",
|
||||
"pattern": "\\bTC-NANDPORT-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/nand_port/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-NANDPORT-700",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-PROTSET",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：保护定值模型 L3（test/host/prot_set）",
|
||||
"pattern": "\\bTC-PROTSET-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/prot_set/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-PROTSET-011",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-PROTELEM",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：保护元件/判据框架 L3（test/host/prot_elm）",
|
||||
"pattern": "\\bTC-PROTELEM-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/prot_elm/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-PROTELEM-013",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-FREQ",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：L2.5 测频（自适应窗）（test/host/freq）",
|
||||
"pattern": "\\bTC-FREQ-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/freq/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-FREQ-011",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-FTPAUTH",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：FTP 鉴权与锁定策略（test/host/ftp_auth）",
|
||||
"pattern": "\\bTC-FTPAUTH-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/ftp_auth/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-FTPAUTH-010",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-SHA256",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：SHA-256 摘要（口令哈希底座）（test/host/sha256）",
|
||||
"pattern": "\\bTC-SHA256-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/sha256/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-SHA256-008",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-SOE",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：SOE 事件顺序记录编解码（test/host/soe）",
|
||||
"pattern": "\\bTC-SOE-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/soe/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-SOE-007",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-ADCHEALTH",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：L1 采集有效性校验（test/host/adc_health）",
|
||||
"pattern": "\\bTC-ADCHEALTH-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/adc_health/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-ADCHEALTH-011",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径（用户裁定 2026-10-21）：这些号实测在代码目录外零消费者（唯一外部引用是 id_aliases.json 自己），故属主登记处 = 单测代码本身，不逐号补文档；class 仍为 TC → 跨模块同号由校验 4 抓",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）：越界即视为未登记的冒号牌"
|
||||
},
|
||||
{
|
||||
"name": "TC-HOST-IEC104",
|
||||
"class": "TC",
|
||||
"title": "主机侧单测用例号：IEC 60870-5-104 协议栈（test/host/iec104）",
|
||||
"pattern": "\\bTC-IEC104-[0-9]{1,4}[a-z]?\\b",
|
||||
"digit_width": [
|
||||
2,
|
||||
4
|
||||
],
|
||||
"owner_docs_glob": [
|
||||
"test/host/iec104/*"
|
||||
],
|
||||
"scope": "global",
|
||||
"frozen": false,
|
||||
"cursor": "TC-IEC104-023",
|
||||
"cursor_owner_only": true,
|
||||
"check_dangling": true,
|
||||
"allow_orphans": true,
|
||||
"subitem_ok": true,
|
||||
"owner_note": "B 层口径同其余 TC-HOST 族；本族是 2026-10-21 补漏——上批模块码改名前它是纯数字 `TC-104-*`，未进当时的悬空普查，故漏建族",
|
||||
"cursor_note": "游标按实测最大号收录（2026-10-21）"
|
||||
}
|
||||
],
|
||||
"unmanaged_bare": {
|
||||
|
||||
Reference in New Issue
Block a user