refactor(iec60870): 解除第三方钉死,104 协议栈按项目自有代码维护

这个目录里的 104 协议栈原先按「第三方导入、逐字节保真」的方式管理:
改动要登记进哈希清单,门禁靠对比上游字节来判断有没有被动过。现在它已经是
团队自己的代码(用户裁定有完整处置权),这套机制就变成了纯粹的阻力——
它会让正常的功能修改看起来像篡改。这一版把它拆掉。

主要动作:

- App/iec60870/IMPORT.md 改名为 README.md。原来的名字本身就在说「这是导入的」,
  而按仓库文档规范,每个自建代码目录都该有 README。
- 删除 App/iec60870/UPSTREAM.sha256(84 条上游哈希)。它唯一的运行时消费者
  是 transport 测试的源文件清单,那个脚本已改成显式列出 27 个 .c。
- 许可证表述改为项目自有。仓库根的 IEC60870-Slave/ 是另一件事:那份仍是原始
  快照、仅作独立验证基线,许可状态未确认,不因本目录收编而改变。
- 四个子目录 README 从 4~6 行扩写到 32~69 行,各自说清职责、边界与改动纪律。
- coding-standard 的排除面收窄:从排除整个 104/ 改为只排除 business/ 与
  大写开头的 IEC104_*。我们自己的适配层 iec104_*.{c,h} 重新进入受检面,
  11 个文件实测 RC=0。

保留的技术知识(没有随保真框架一起删掉):C99 静态断言为何需要 shim 与
43 处断言条件未改、SOE 深度 128 的合规依据、点表元素 12B 降到 8B 以放进
const Flash、无符号上界比较消诊断、FaultEvent 的链接依赖、11 个容量宏的
默认值表、以及能力边界(历史/录波/文件/升级后端未导入)。

验证:

- 全量 pre-commit 12 Passed / 0 Failed
- doc-links 308 篇 / 30 处问题,全部在 IEC60870-Slave/ 内,我方零新增
- transport 测试改前改后编译集逐字节一致(27 个 .c,哈希相同),10 条用例全过
- 8 个改动文件字节体检 BOM=False / CR=0 / U+FFFD=0
This commit is contained in:
2026-11-18 21:31:03 +08:00
parent ce72cdfc41
commit 4784df923e
11 changed files with 395 additions and 241 deletions
+14 -9
View File
@@ -155,14 +155,18 @@ repos:
types: [c]
# 范围与 cppcheck 钩子一致;另排除 CubeMX 生成文件(Src/、Inc/,重新生成即覆盖)、
# dhara/FatFS 接口适配层(nand_ftl,函数名由外部 API 固定)
# `App/iec60870/{common,104,examples}/` 与 `IEC60870-Slave/` 在 2026-11-18 之前是
# 逐字节钉在 UPSTREAM.sha256 上的第三方源码(IEC 60870-5-104 子站库,45k 行)。
# 2026-11-18 起该库转为项目自有代码:不再做字节保真校验,命名/注释/结构按本仓规范
# 逐步收编(`UPSTREAM.sha256` 仅作迁移出处的历史记录,不再作为门禁判据)。
# 本排除项暂留,是因为收编尚未完成(12xx 处 RULE-10 待改);收编完成后必须删除这三行。
# ⚠ 排除面必须逐条写成子树前缀(common/、104/、examples/),**不能**写成祖先
# `App/iec60870/`:那会把协议核心之外的其它子目录一起吞掉(2026-11-18 实测过
# 这种误伤:写成祖先形态后 `104/` 内我们自己的装配文件被判 EXCLUDED)。
# `App/iec60870/` 下的协议栈曾是第三方 IEC 60870-5-104 子站库(约 5 万行),
# 2026-11-18 起收编为项目自有代码:不再做字节保真校验(`UPSTREAM.sha256` 已删除),
# 命名/注释/结构按本仓规范逐步改造。
# 下列排除项只覆盖**尚未改造的那部分代码**,收编完成后必须删除:
# 1,200+ 处标识符仍是驼峰,RULE-10 会全量报错。这批改造属 Phase 3 单独排期,
# 不在收编范围;改完必须删掉这三行,否则等于自建代码永久免检。
# 我们自己写的适配文件不受这条豁免——`104/` 下小写的 `iec104_*.{c,h}`(core /
# net_mcu / source / dtu_table / comm)在受检面内,逐个直调脚本实测 RC=0。
# 大写开头的 `IEC104_*` 才是尚未改造的上游文件,仍被下一条规则排除。
# ⚠ 排除面必须逐条写成可判定的前缀,**不能**写成祖先 `App/iec60870/`:那会把
# 协议核心之外的其它子目录一起吞掉(2026-11-18 实测过这种误伤)。
# `104/` 同样不能整目录排除——那会连我们自己的适配层一起豁免掉。
exclude: |
(?x)^(
Drivers/CMSIS/|
@@ -171,7 +175,8 @@ repos:
Drivers/BSP/GD5F2GQ5UE/nand_ftl\.|
Drivers/BSP/dhara/|
App/iec60870/common/|
App/iec60870/104/|
App/iec60870/104/business/|
App/iec60870/104/IEC104[_.]|
App/iec60870/examples/|
IEC60870-Slave/|
Lib/|