2053f6d913
四篇讲「本项目怎么接 104」的文档原来散在子系统设计与网络两个目录, 和随库迁入的 36 篇协议库设计混在一起。现集中到 docs/iec60870/板端落地/: - IEC104上行设计说明.md(原 docs/子系统设计/) - IEC104_Net适配契约.md(原 docs/网络/) - IEC104_MCU落地规划.md(原 docs/子系统设计/) - IEC104_MCU最小可行性验证.md(原 docs/子系统设计/) 改动: - 四篇 git mv 保留历史,全库引用经 rename_ref.py 逐篇改写(27 个文件 54 处引用行),旧路径残留扫描为 0。 - docs/README.md:§5.3 改为「IEC 60870-5-104 文档(40 篇)」,拆成 「板端落地 4 篇」与「协议库设计与接口 36 篇」两张表,说明两条轴的分工; 从 §5.1 功能子系统表里移除这三篇的重复条目。 - docs/iec60870/README.md:新增两条轴入口与板端落地表,原阅读顺序 改标注为「协议库部分」。 验证: - check_doc_links.py --all --sections-strict:310 篇 0 问题。 - 三份索引 markdown 链接可达性逐个 exists() 校验,断链 0;索引表覆盖 36 篇协议库文档,与实际磁盘文件双向差集为空。 - 板端落地目录 4 篇 BOM / CR / U+FFFD 均为 0。 - 工作树 Keil 权威构建 0 errors 0 warnings(Code=365896 RO=48336 RW=2736 ZI=173104),此后预提交 21 Passed / 0 Failed。
编号门禁归档(两道都已退役:全库语料审计 2026-10-28、新增行检查 2026-10-29)
本目录是 2026-10-20 ~ 2026-10-29 期间在 pre-commit 里跑过的两套编号门禁,连同它们的
语料与白名单一起搬进来,都不再进提交门禁。2026-10-29 的裁定见每篇文末与其留档文档。
| 文件 | 是什么 |
|---|---|
check_ids.py |
八项校验脚本(规范 §8)。手工复查存量编号现状时才跑 |
check_ids_new.py |
只查新增行的那道(2026-10-28 ~ 2026-10-29 在钩子里跑),2026-10-29 用户裁定退役后降为手工形态普查;--self-test 保留,REPO_ROOT 因归档位置深两级改取 parents[3] |
id_registry.json |
99 族的注册表:形态正则 / 属主登记处 / 冻结 / 游标 / 两条护栏的数值 |
id_aliases.json |
旧号 → 新号 / 作废(retired-to-phrase、void)的别名表,187 KB |
id_known_backlog.json |
债务台账(收口时已还清到 0 条) |
为什么退役
实测拆账:单次运行只有 1.8 s,但近 80 笔提交里 61 笔改了语料 / 门禁 / 规范; 99 族里 78 族已冻结。真正值得机械守的只剩一件事——别新写一个自造编号, 而那件事不需要语料(判据只要「这个前缀我没见过」)。
现在用什么
- 没有现行门禁:接班的
id-check-new(只查新增行、零语料)也在 2026-10-29 被用户裁定退役, 脚本进本目录。编号形态此后无机器面,现行判据 =docs/文档规范.md§7.1(2026-10-29 起一律停发)+ 评审; 留档docs/门禁说明/id-check-new.md(拦下过什么、为什么退、手工怎么再跑)。 - 退役流水与手工普查记录:
编号治理历史.md(原编号规范的全部正文已于 2026-11-06 删除, 仍生效的两条规则与存量族表并进了docs/文档规范.md§7.1)。
怎么手工跑一次
& '.venv\Scripts\python.exe' scripts/archive/id_gate/check_ids.py # 全库报告
& '.venv\Scripts\python.exe' scripts/archive/id_gate/check_ids.py --top 30 # 多看几条
退出码:0 = 无错误级 / 仅告警;1 = 有错误级(--strict 语义);2 = 环境错误。
注意:它扫的是 git ls-files,所以未跟踪文件不在扫描面(退役前的实测盲区)。
归档纪律
- 这两份语料不再维护:不要为了让报告变绿去改
id_registry.json/id_aliases.json。 scripts/rename_ids.py仍会往归档的id_aliases.json写条目(改名工具没退役)—— 那是它自己的账,与本目录的"冻结快照"性质不同,改名前先想清楚是否还要记这笔。- 真要恢复全库校验,先读
编号治理历史.md再决定,别直接把它塞回钩子。