W5波+N-19收口：FTP鉴权落地、Trap25三连定案修复(N-30)、N-20/N-23/N-26

N-19 FTP 鉴权：
- lftpd_auth（USER/PASS 状态机 + 连续5次失败锁60s）+ SHA-256
  (user||pwd) 口令哈希；config.ini [ftp] 段 user/pwd_hash/write，
  出厂 admin/admin 在用有启动告警；lftpd_log.c 删除并入 lftpd_auth
- ftp_cfg 配置读写；台架 ftp_auth_bench.py 13/13

N-30 / Trap 25（CH395F_Trap_Records.md 四次定案全记录）：
- 修复1 closed-with-data accept：客户端发完正常 FIN 后芯片按
  FUN_PARA(0x09) §5.52② 保留 Socket+RX 缓冲，旧代码把 CLOSED 一律
  relisten 自毁缓冲 → STOR 必挂 425；改为接受"已关但可读"连接排空
- 修复2 丢 CONNECT 中断探针 net_lost_connect_probe + last_peer_port
  幽灵甄别（拆链窗口握手完成但中断丢失，双信源去抖补 accept）
- 修复3 send_list/send_nlst 批量单发：背靠背 ~60B 小段毒化芯片 TX
  （芯片报 SEND_OK 但对端全丢），整份目录一次性写入
- 证伪存档：固定沉降/Socket 轮换冷却/listen 门控（台架 v7 矩阵）
- 台架工具 test/board/ch395f_reuse_bench.{c,h} + host 脚本存档
  （不注册编译；实验分支 n30-chip-bench 保留）

N-20：Error_Handler 死循环降级（记录+复位路径）
N-23：scripts/check_registration.py 双端注册反向校验（pre-commit）
N-26：GD5F NAND 直 DMA 调用方缓冲窗口断言

验证：BUILD_OK 0/0；ftp_regression 连跑 4 轮 11/11（修复前
LIST#4/#7 100% 挂、STOR#2 曾 100% 425）；ftp_auth_bench 13/13；
@test 启动标记 PASS；ci_local L0+L0.5 全过；doc-links 通过。
登记簿 N-30 已销项。

.pre-commit-config.yaml

@@ -154,9 +154,10 @@ repos:
 
       # 5) 文档一致性门禁（D-7）
       #    存在性：md 互链 / 反引号路径是否指向真实文件（防迁移/删除后残留死链）
+      #    章节：`§N.M` 必须能在目标文档的编号标题里找到（--sections-strict：自引用失效也拦）
       - id: doc-links
         name: 文档链接存在性 (D-3/D-7)
-        entry: python scripts/check_doc_links.py
+        entry: python scripts/check_doc_links.py --sections-strict
         language: system
         files: \.md$
         # 外部资料（芯片手册转录）链接形态不受控；第三方目录整体排除
@@ -354,6 +355,29 @@ repos:
         files: ^(App/algo/prot_elm\.(c|h)|App/algo/prot_set\.(c|h)|App/algo/phasor\.(c|h)|test/host/prot_elm/.*|test/host/common/unit_test_harness\.py)$
         pass_filenames: false
 
+      # 7k) SHA-256 主机侧单元测试（2026-10-11 加，N-19 FTP 鉴权）
+      #     sha256 是 FTP pwd_hash 校验的地基——哈希算错是"正确口令被拒 /
+      #     错误口令放行"的静默语义错误，板端只见 530/230 看不出根因；
+      #     FIPS 180-4 标准向量（空串/abc/56B 补位跨界/1MB）+ hex_eq 非法输入
+      #     在主机侧毫秒级钉死。零平台依赖，无桩。
+      - id: sha256-unit-test
+        name: SHA-256 单测（主机侧）
+        entry: python test/host/sha256/run_unit_test.py
+        language: system
+        files: ^(App/util/sha256\.(c|h)|test/host/sha256/.*|test/host/common/unit_test_harness\.py)$
+        pass_filenames: false
+
+      # 7l) FTP 鉴权状态机主机侧单元测试（2026-10-11 加，N-19）
+      #     锁定 60s/解锁/成功清零/tick 32 位回绕是"防口令爆破"契约核心，
+      #     板端每验一条要真等 60s、回绕要跑满 49.7 天；lftpd_auth 纯函数
+      #     设计（tick 参数注入）就是为了让这些分支主机侧毫秒级穷举。
+      - id: ftp-auth-unit-test
+        name: FTP 鉴权状态机单测（主机侧）
+        entry: python test/host/ftp_auth/run_unit_test.py
+        language: system
+        files: ^(Drivers/BSP/NET/lftpd/lftpd_auth\.(c|h)|App/util/sha256\.(c|h)|test/host/ftp_auth/.*|test/host/common/unit_test_harness\.py)$
+        pass_filenames: false
+
       # 8) 测试套件开关门禁（2026-10-01 加）
       #    背景：test_config.h 的 TEST_SUITE_* 决定固件里编入哪个测试套件，
       #    全部注释 = 产品构建。但此前**无任何门禁检查**——实测已提交的 HEAD 里
@@ -367,3 +391,21 @@ repos:
         language: system
         files: ^test/board/test_config\.h$
         pass_filenames: false
+
+      # 9) 双端注册反向校验（2026-10-12 加，登记簿 N-23 / 审查报告 N-06 残余）
+      #    背景：新 .c 必须手动注册两处（`MDK-ARM/*.uvprojx` + `simulator/CMakeLists.txt`）
+      #    才会被编译；历史上 `App/task/rs485_task.c`、`Drivers/BSP/NET/lftpd/lftpd_log.c`
+      #    **两处都没注册** = 写了却从不参与任何一端编译的**死代码**，误导读者以为功能已生效。
+      #    本钩子反向核对两份注册表：①存在但未进 uvprojx ②存在但未进 CMakeLists
+      #    （MCU-only 豁免见脚本 SIM_EXEMPT，显式清单+每行理由，不整目录一刀切）
+      #    ③注册了但文件不存在（幽灵注册）。
+      #    存量缺口（rs485_task/lftpd_log）已进脚本 KNOWN_GAPS 白名单 → WARN 不拦，
+      #    只对新缺口 FAIL，故钩子可立即上线不拦现有提交（`--strict` 供审计关白名单）。
+      #    ⚠ pre-commit 4.x 已移除 `always: true` → files 必须覆盖所有触发面：
+      #      任意 .c + uvprojx + CMakeLists.txt + 脚本自身（脚本自身改动也值得复跑）。
+      - id: registration-check
+        name: 双端注册反向校验 (uvprojx + CMakeLists)
+        entry: python scripts/check_registration.py
+        language: system
+        files: (\.c$|\.uvprojx$|CMakeLists\.txt$|^scripts/check_registration\.py$)
+        pass_filenames: false