docs(测试说明): 按用途分六个子目录并同步全库引用

分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/，
顶层只留新增的目录导航 README.md（归层判据 + 硬约束 + 本次处置记录）。

- 搬迁 28 个路径：测试数据三个目录 58 个文件为纯改名（R100，内容逐字节不变）
- 全库引用同步 124 个文件：AGENTS / docs 索引 / skills / 门禁注释 / scripts
- 门禁面：scripts/check_test_traceability.py 的 glob 改 rglob
  （分层后不递归扫描＝追溯门禁直接瞎掉）
- scripts/rename_ref.py：收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError，
  让进程以退出码 1 收场而改写其实已落盘（RC 与真实结果相反）；改为把
  stdout/stderr reconfigure 成 UTF-8，与 check_doc_links.py 等同法
- docs/文档规范.md §1.1 补「子目录文件过多时再分一层」；§3.6 补 rename_ref
  搬整目录的两个实测坑：① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链
  不补层级（本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原）
- docs/README.md §6 改为与六个子目录一一对应，并补登原先漏登记的
  「启动日志原子性复验流程」一行
- .cubemx_survival_baseline.json：App/util/task_watchdog.c 的注释路径也随分层更新，
  该文件是存活审计的 watchdog-module 漂移锚点，按脚本自己的提示跑 --write 重建基线
  （实测重建后仅 watchdog-module 一条哈希变化）
- 铁律 4 例外（本次在任务树里改了单写者文件）：AGENTS.md 与
  .pre-commit-config.yaml 只被 rename_ref 改写路径字面量（后者全在注释行），
  任务表块与钩子声明一字未动

验证：check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿；
check_test_traceability.py 输出与主树逐行一致；196 个文本文件无 BOM、无新增
CR、无 U+FFFD、无行尾空白；陈旧引用面由主树 25 处降到 6 处（无新增断链）。

docs/问题记录/CH395F_Trap_Records.md

@@ -132,7 +132,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱：现象、定案根因、修
   2. **幽灵态甄别**：补 accept 前回读对端端口（`GET_REMOT_IPP`），**= 上一条连接端口（`last_peer_port`）→ 幽灵，不 accept**；
   3. 对账②同步加幽灵甄别；`last_peer_port` 登记点：`handle_disconnect_event` / `handle_timeout_event` / `net_relisten_try`（清零 remote_port 前转登）/ `net_close_locked`（跨 memset 保留——幽灵属芯片 Socket 级，与 fd 复用无关）。
 - **定案二：closed-with-data accept（425 真根因=accept 竞态自毁缓冲）**：`FUN_PARA` bit3 `SOCKET_CLOSE=1`（§5.52 ②）下产生 DISCONNECT 后芯片**不关 Socket、不清缓冲**，RX 缓冲里 STOR 载荷一个不少（探针实证 `recv_len=1027 re-read st=0x05/0x00`）；那个 DISCONNECT 是**客户端正常 FIN**（ftplib `storbinary` 发完即关，局域网小文件 ~5ms）。旧 `net_accept_locked` 把 CLOSED 一律当"无连接" → `net_relisten_try`（close+open **清空芯片 RX 缓冲**）→ 数据被**我方亲手销毁** → 425。**修复**：CLOSED + auto_relisten + **芯片 RX 有数据**（`GET_RECV_LEN_SN`>0）→ 接受这条"已关但可读"连接（日志 `closed-with-data accept (drain pending)`），应用快路径排空，排空后 EOF 自然触发 relisten——对齐 §5.52 ② 契约。
-- **定案三：LIST 吞包 = 背靠背小段写毒化芯片 TX**：决定性对照——同一目录，LIST #1（行间天然间隔）通过；LIST #4/#7（每行一次 `net_send` ~60B 背靠背小段）必挂。芯片对同一连接的**背靠背多段小写入**会毒化 TX（芯片报 SEND_OK 但对端全部丢弃，无 RST 无 DISCONNECT）；RETR 1KB 满块连发不受影响。**修复**：`send_list`/`send_nlst` 整份目录**一次性批量发送**（static 1536B 缓冲；注意 `lftpd_inet_write` 成功返回**字节数**非 0）。 **2026-10-22 增补（同一处缓冲埋的第二颗雷）**：批量发送把"装满就 `break` + 回 −1"留在了路径上，`cmd_list` 据此回 **550**——目录一旦超过 1536 B，客户端拿到的是**静默截断**的清单**外加一个错误码**，而清单看起来完全像"目录里就这些"。实测台架根目录 30 条目：修复前 1512 B / 24 条目 / 完成回包 550，修复后 1880 B / 30 条目 / 226，**6 个文件凭空消失**。改成**满块续发**（装满一块整块发出、清空再装）：既保住"只发大块"这条实测结论（定案三的本体），又不让清单完整性由一个缓冲区上限决定；单行真装不下时**明确失败**而不是少发条目。同一函数还有个已知偏差：`cmd_list`/`cmd_nlst` 忽略命令参数、恒列 `client->directory`（会话 CWD）——主流客户端都是 `CWD` + 裸 `LIST`，暂未修，登记在案。 **回归**：`test/host/ftp_list_fill_test.py`（自造 26 个 8.3 短名文件把清单撑过一块，判"全列出 + 完成回包 226"，跑完自动删干净；用法见 `../测试说明/FTP_Test_Guide.md` §4.5）——设备目录清空后，只有这种自己造规模的脚本才拦得住这颗雷。
+- **定案三：LIST 吞包 = 背靠背小段写毒化芯片 TX**：决定性对照——同一目录，LIST #1（行间天然间隔）通过；LIST #4/#7（每行一次 `net_send` ~60B 背靠背小段）必挂。芯片对同一连接的**背靠背多段小写入**会毒化 TX（芯片报 SEND_OK 但对端全部丢弃，无 RST 无 DISCONNECT）；RETR 1KB 满块连发不受影响。**修复**：`send_list`/`send_nlst` 整份目录**一次性批量发送**（static 1536B 缓冲；注意 `lftpd_inet_write` 成功返回**字节数**非 0）。 **2026-10-22 增补（同一处缓冲埋的第二颗雷）**：批量发送把"装满就 `break` + 回 −1"留在了路径上，`cmd_list` 据此回 **550**——目录一旦超过 1536 B，客户端拿到的是**静默截断**的清单**外加一个错误码**，而清单看起来完全像"目录里就这些"。实测台架根目录 30 条目：修复前 1512 B / 24 条目 / 完成回包 550，修复后 1880 B / 30 条目 / 226，**6 个文件凭空消失**。改成**满块续发**（装满一块整块发出、清空再装）：既保住"只发大块"这条实测结论（定案三的本体），又不让清单完整性由一个缓冲区上限决定；单行真装不下时**明确失败**而不是少发条目。同一函数还有个已知偏差：`cmd_list`/`cmd_nlst` 忽略命令参数、恒列 `client->directory`（会话 CWD）——主流客户端都是 `CWD` + 裸 `LIST`，暂未修，登记在案。 **回归**：`test/host/ftp_list_fill_test.py`（自造 26 个 8.3 短名文件把清单撑过一块，判"全列出 + 完成回包 226"，跑完自动删干净；用法见 `../测试说明/板级测试/FTP_Test_Guide.md` §4.5）——设备目录清空后，只有这种自己造规模的脚本才拦得住这颗雷。
 - **与 TRAP-NET-17 的关系**：周期对账对常驻监听器有效；FTP 数据通道是"活 1 秒就死"的短命监听器，对账②无幽灵甄别时既救不全又帮凶。本条把"看状态补 accept"内联进 accept 热路径（短去抖、无冷却）+ 端口甄别，对账②保留为兜底网。
 - **教训（总纲）**：**CH395F 的"成功"（中断位/状态码）只代表芯片本地动作完成，不代表对端收到；判定必须回到对端可见证据（主机侧收发）+ 手册语义（FUN_PARA §5.52、状态码 §5.22）**。
 - **对应文件**：`net_events.c`（`net_lost_connect_probe` / `net_reconcile_tick`②；原在 `net_socket.c`，2026-10-14 抽出）、`net_socket.c`（closed-with-data accept）、`net_types.h`（`last_peer_port`）、`lftpd.c`（批量发送）；台架 `test/board/ch395f_reuse_bench.{c,h}` + `test/host/ch395f_reuse_host.py`（主分支存档）。
@@ -260,7 +260,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱：现象、定案根因、修
 - **现象**：`GET_DHCP_STATUS` 已置 0x00 后立即 `GET_IP_INF` 读到的仍是旧静态配置，而芯片实际已按新租约收发——三方数据矛盾构成假阳性。
 - **根因（定案）**：DHCP 状态位仅代表协商完成；IP/MASK/GW 寄存器提交与状态置位**异步**，数百毫秒级窗口（实测 ~1s 内翻转）。
 - **修复**：① 连续 3 次读 `GET_IP_INF`（间隔 300ms，上限 8s）一致且非零才采信；② PC 端把收到的宣告 IP 与租约比对兜底。
-- **对应**：`test/board/ch395f_test_task.c: phase4_run()`；`docs/测试说明/CH395F_Test_Guide.md` 阶段 4 风险表 #4。
+- **对应**：`test/board/ch395f_test_task.c: phase4_run()`；`docs/测试说明/板级测试/CH395F_Test_Guide.md` 阶段 4 风险表 #4。
 
 ---
 
@@ -296,7 +296,7 @@ CH395F 以太网驱动与 NET 层的实证陷阱：现象、定案根因、修
 ## 主机侧测试工具过期
 
 - **`test/host/ftp_abort_probe.py` 已修**：原用匿名登录，FTP 鉴权落地后匿名被 530 拒 → TRAP-NET-18 两条腿**假 0/5**（第 1 轮 `PASV failed`，且半认证会话占死 FTP 唯一会话，后续轮全变 `ConnectionRefused`）。改 `admin/admin` 后 RST 5/5、FIN 5/5。**教训：跑既有回归腿前先确认凭据仍有效，否则会把工具过期读成固件回归。**
-- **同族未修**：`test/host/ftp_up_dl_test.py`、`ftp_speed_test.py`、`ftp_test.py` 仍用匿名登录 → 对当前固件必挂登录步；`docs/测试说明/FTP_Test_Guide.md` 推荐的这几个入口因此已失效（现行可用入口是 `test/host/ftp_regression.py`，默认 `admin/admin`）。
+- **同族未修**：`test/host/ftp_up_dl_test.py`、`ftp_speed_test.py`、`ftp_test.py` 仍用匿名登录 → 对当前固件必挂登录步；`docs/测试说明/板级测试/FTP_Test_Guide.md` 推荐的这几个入口因此已失效（现行可用入口是 `test/host/ftp_regression.py`，默认 `admin/admin`）。
 
 ## 文档侧待修清单