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 处(无新增断链)。
This commit is contained in:
2026-10-30 07:06:38 +08:00
parent fea4cc7502
commit f754d59218
209 changed files with 644 additions and 528 deletions
+48 -48
View File
@@ -6,8 +6,8 @@
"new": "周期 CONVST 重触发",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -30,8 +30,8 @@
"new": "TPAFE 快照消费",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -54,8 +54,8 @@
"new": "STM32 ADC1 启动与扫描",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -78,8 +78,8 @@
"new": "通道语义映射",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -102,8 +102,8 @@
"new": "通道标定(一次系数 + 零漂)",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -126,8 +126,8 @@
"new": "采样有效性校验",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -150,8 +150,8 @@
"new": "等周波采样(软件测频 + 调频闭环)",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -174,8 +174,8 @@
"new": "二次谐波/五次谐波提取入口",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -198,8 +198,8 @@
"new": "全周傅氏系数表",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -222,8 +222,8 @@
"new": "基波相量实例",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -246,8 +246,8 @@
"new": "相量有效值输出",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -270,8 +270,8 @@
"new": "相位输出",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -294,8 +294,8 @@
"new": "线/负序/零序合成",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -318,8 +318,8 @@
"new": "每 1 ms 滑动窗刷新",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -342,8 +342,8 @@
"new": "双区指针原子交换",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -366,8 +366,8 @@
"new": "三段式相间过流",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -390,8 +390,8 @@
"new": "三段式零序过流",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -414,8 +414,8 @@
"new": "过频 / 低频",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -438,8 +438,8 @@
"new": "跳闸出口(KO)",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -462,8 +462,8 @@
"new": "出口自检",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -486,8 +486,8 @@
"new": "SOE 记录",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -510,8 +510,8 @@
"new": "动作记录",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -534,8 +534,8 @@
"new": "定值校验和",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",
@@ -558,8 +558,8 @@
"new": "自检失败闭锁",
"files": [
"docs/算法/继电保护功能复现规划.md",
"docs/测试说明/boot_log_data/README.md",
"docs/测试说明/相量层单元测试说明.md",
"docs/测试说明/测试数据/boot_log_data/README.md",
"docs/测试说明/单元测试/相量层单元测试说明.md",
"docs/硬件平台/ADC通道映射说明.md",
"App/algo/*.c",
"App/algo/*.h",