merge: 合入网络 fd 失效值契约(含 104 目录重构解冲突)

把 dsh-204f318c-38b4 的网络 fd 契约工作流合入主树:NET_FD_INVALID
单一契约 + 静态门禁 + 回归测试 + 全仓审计 + 最小加固。

解冲突与集成修复:
- 5 个数值快照(RAM 文档/tsv/size_attestation/report.json)两侧各自
  过时,取主线重构后结构,合并后用权威 Keil 构建(0/0)重新回填:
  Code=365896 RO=48336 RW=2736 ZI=173104,IRAM1 90.3% / CCM 87.9%。
- iec104_net_mcu.c 的 net_fd 改动随主树 104 目录重构
  App/protocol/ → App/iec60870/ 自动迁移,路径正确。
- net-handle 豁免面从旧路径 App/protocol/iec60870/ 对齐到主树重构后的
  App/iec60870/(大写 IEC104_* 上游代码暂免检,小写 iec104_* 自研
  适配层仍受检),消除 read_socket 布尔标志的误报。

验证:net-handle 0 违规/493 文件 + selftest 42 PASS;size-gate 同码
PASS;mem 双区 <92%;本次 6 文档链接 PASS;主机套件全绿。
预存红项(ioboard_di.c / IEC60870-Slave 第三方文档)不在本次提交。
This commit is contained in:
2026-11-18 22:28:49 +08:00
52 changed files with 1964 additions and 313 deletions
+30 -5
View File
@@ -205,7 +205,8 @@ repos:
docs/芯片手册/
)
# mermaid 图:围栏内确定性语法预检(2026-10-30 加;当日口径 51 → 52、提交期实跑 48 → 49,
# 2026-11-17/18 摘 `iec104-unit-test` + 加 `iec104-tcp` 后收敛为 52 / 47 / 48)。
# 2026-11-17/18 摘 `iec104-unit-test` + 加 `iec104-tcp` 后为 52 / 47 / 48,
# 同日再加 `net-handle` 后当前为 **53 / 48 / 49**)。
# 为什么要有:屏板链路设计.md §1 的 flowchart 里 `-.|"文字"|`(`-.` 直接跟管道,不是任何合法
# 箭头 token)让 mermaid 渲染 `Syntax error in text`——该图 2026-10-29 落库、期间 doc-links 等
# 全绿:文档门禁查链接与章节,**从不查围栏内图表语法**,这是它们的共同盲区。
@@ -523,10 +524,11 @@ repos:
# 新板端网络后端的等价验证是 test/host/iec104_netmcu/(fake net 层 + 自定义
# runner,不是 run_unit_test.py 形态,硬套进这里只会得到一个跑不起来的钩子),
# 由 scripts/ci_local.py 与人工运行,不进提交门禁。
# ⚠ 计数口径(2026-11-18 两笔合并后实测):本条摘除使 YAML 解析条目 52 → 51、
# ⚠ 计数口径(2026-11-18 三笔合并后实测):本条摘除使 YAML 解析条目 52 → 51、
# 提交期实跑 49 → 48;同日新增的 `iec104-tcp`(下面 12b 条,manual 阶段)再把
# 声明数加回 **52**、manual 根数 3 → **4**、manual 阶段枚举行数 50 → **51**。
# ⇒ 终态:**声明 52 / pre-commit 阶段 47 / 一次 git commit 实跑 48 / manual 4**。
# 声明数加回 52、manual 根数 3 → 4、manual 阶段枚举行数 50 → 51;同日再加
# `net-handle`(下面 13 条,pre-commit 阶段)。
# ⇒ 当前:**声明 53 / pre-commit 阶段 48 / 一次 git commit 实跑 49 / manual 4**。
# 须与 AGENTS.md 的「共 N 个钩子」、docs/门禁说明/README.md §2 标题、
# docs/代码规范/pre-commit使用说明.md 三处同批改(勿在别处另立字面量)。
@@ -888,7 +890,30 @@ repos:
language: system
types: [c]
# ─── SKILL.md 体积与 reference/ 指针门禁(第 52 条,2026-10-29 加)─────────────────────
# ─── 网络句柄失效值契约门禁(第 52 条,2026-11-18 加,声明数 52 → 53)──────────────────
# 为什么要有:板端 104 连不上的真因不是"漏了一个 -1",而是"未打开的 fd"由 C 零初始化
# 成 0,而本项目 net 层 fd 域是 0~7(0 是**合法**描述符)——失效值恰好落在合法值域,
# 再被 `fd >= 0` 这类数值形态判据当成"持有 fd";网络代际切换后它去关 fd 0,把别的
# 服务的监听槽(FTP)关掉,最终 104 建链拿到 FTP 的 220 banner。修好一处只是治标,
# 本闸把契约(Drivers/BSP/NET/net_fd.h 的 NET_FD_INVALID)搬到提交期机械判定:
# R1 fd 形标识符与整数字面量比较;R2 文件作用域 static fd 无初始化/`{0}`/缺 fd 成员;
# R3 memset 含 fd 成员的结构体后 5 行内不回填;R4 `if (fd)` / `if (!fd)`;
# R5 契约头文件存在且被 net_socket.h include。
# 白名单不是漏判:`Drivers/BSP/NET/` 是契约的层内实现者(C4 允许 `0 <= fd < 上界`
# 区间校验,fd 槽数组清零即"释放",套 R1~R4 会把正经实现判红);`test/host/` 的假
# 对象按 C7 从 0 基分配,断言语域不同。两者的契约合规性由 R5 + 独立验收复核。
# 自证:`--selftest` 42 条断言(每个 R 都有"故意写错必须抓到"与"正确写法不误报",
# 含注释里的反面教材不误报、白名单不误伤、整数组清零不误报)。
# 全树扫不只看变更文件(files 只当触发):R5 要判契约文件本身,且"当前树 0 违规"
# 才是可复核的口径。判据、盲区与豁免写法 → docs/门禁说明/net-handle.md。
- id: net-handle
name: "网络 fd 失效值契约(NET_FD_INVALID:数值判据 / 零初始化 / memset 后不回填)"
entry: scripts/gate_python.py scripts/check_net_handle.py
language: system
files: ^(.*\.(c|h)|scripts/check_net_handle\.py|\.pre-commit-config\.yaml)$
pass_filenames: false
# ─── SKILL.md 体积与 reference/ 指针门禁(第 53 条,2026-10-29 加)─────────────────────
# 为什么要有:dsh-mnemon 插件对技能正文有 65536 字节的**写侧**硬上限(validateSkillContent),
# 但**加载侧不查**——超限的 SKILL.md 照常可读、照常进技能目录,只有一件事会坏:自进化每次
# 「生成草案」都在落盘那一步被拒,那一行永久卡在「生成中」、界面只剩转圈、连「忽略」都不出现