docs: 删任务规划两份已完成文档,数据可信内容迁入算法层/硬件平台/登记簿

任务规划目录从 5 个文件收敛到 3 个:只留导航(README)、待办(登记簿)、
暂缓专项(暂缓-RS485)。

删除的两个文件都不再有现行读者:
- UI补齐.md 执行清单 2026-10-28 清空、上板判据 2026-11-06 台架轮已复核;
  叶数口径迁 docs/UI设计/菜单页面设计.md §3.9,三条内容页硬规矩迁
  docs/UI设计/内容页架构.md §7.1,两条未闭环待办迁登记簿 §7/§8。
- 数据可信.md 不是完成记录,而是被约 130 处代码头注释引用的设计约束,
  因此按内容分三处落位后删除,不整篇丢弃。

数据可信内容的新归属(旧节号 → 新家):
- §2/§4 设计口径 → docs/算法/采集与算法层设计说明.md 新增 §13(13 小节),
  §7 前置决策表 → §13.12 已定案的前置决策。
- §3 台阶与波次退出判据 → docs/硬件平台/ADC通道映射说明.md 新增 §9。
- §5 任务卡 → docs/任务规划/登记簿.md §7(拆成变比确认 / 两点标定两行)。

引用改写 34 文件 77 处路径引用 + 14 文件 24 处昵称引用 + 双重节号 35 处,
覆盖代码头注释、测试、生成器与文档;归档区历史路径改纯文本提及。
四个 SVG 生成器文案同步并重跑,产物随脚本同批提交。

同批处理两件事:
- 9 个 UTF-16 LE 证据文件转 UTF-8。end-of-file-fixer 按字节判末尾换行,
  UTF-16 的换行是 0A 00、末字节 00,钩子会追加裸 0x0a 使文件变奇数长度,
  8 个已实际损坏。转码后逐文件比对 HEAD 原文验证正文零丢失。
- 修回 App/cfg/cfg_file.c 被剥掉的 UTF-8 BOM(补 3 字节,未整文件重写)。

验证:/keil-build 0 错误 0 警告(Code=255160);check_doc_links --all
--sections-strict 221 篇全通过、无法判定 0;pre-commit 全量全 Passed。
This commit is contained in:
2026-11-09 16:10:55 +08:00
parent 7027718dcd
commit ae09c5737a
87 changed files with 613 additions and 746 deletions
+1 -1
View File
@@ -6,7 +6,7 @@
* 虚拟盘,同 cfg_file 套件先例)、syslog_post(计数)、
* adc_input_desc()(按 ADC通道映射说明.md 权威表给 V0.1 来源映射)。
*
* 为什么必须主机侧(数据可信 §2.6):板端无标准源,「读数 = 系数 × 码值」
* 为什么必须主机侧(docs/算法/采集与算法层设计说明.md §13.5):板端无标准源,「读数 = 系数 × 码值」
* 这一根本判据在台架上不可验;Q16 舍入、系数翻倍口径、负零点落盘、合法带
* 哨兵漏放,只有离线端能用独立推导的期望值 + 坏文件注入一次性钉死。
*
+2 -2
View File
@@ -10,7 +10,7 @@
工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。
为什么要主机侧单测(而不是只用板端套件):
标定折算的判据是"读数 = 系数 × 码值"——板端**无标准源**(数据可信 §2.6),
标定折算的判据是"读数 = 系数 × 码值"——板端**无标准源**(docs/算法/采集与算法层设计说明.md §13.5),
系数错、Q16 舍入错、哨兵漏放、负零点落盘错,在台架上全都看不出来;
主机侧用独立推导的期望值 + 坏文件注入把它们一次性钉死。
@@ -18,7 +18,7 @@
python test/host/adc_cal/run_unit_test.py
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/任务规划/数据可信.md 标定折算与落盘整定(道A);
设计依据:docs/算法/采集与算法层设计说明.md §13 标定折算与落盘整定(道A);
创建日期:2026-10-25
"""
import os
+1 -1
View File
@@ -12,7 +12,7 @@
*
* 覆盖点(TC-MEAS-xxx;属主登记处 = 本目录,族 TC-HOST-MEAS):
* TC-MEAS-001 init 语义:seq=0 / get=-2 且清零填充 / 发布后可见 / init 幂等复位
* TC-MEAS-002 布局钉死(docs/任务规划/数据可信.md §4.5):sizeof=72 + 八字段偏移
* TC-MEAS-002 布局钉死(docs/算法/采集与算法层设计说明.md §13.9):sizeof=72 + 八字段偏移
* TC-MEAS-003 窗不足发布:seq=1 照常发布,电气 8 路 + TEMP 全 IV|NT,valid=0
* TC-MEAS-004 基波有效值透传:50 Hz 整周波窗 yc = A/√2(≤0.1 %),零幅路=0 且品质 0
* TC-MEAS-005 同拍同值(§4.5"从相量使用区取"口径钉死):yc[UA/UN/IA] 与
+2 -2
View File
@@ -11,7 +11,7 @@
工具链探测 / 编译运行全部委托 test/host/common/unit_test_harness.py。
为什么要主机侧单测(而不是只等台架):
遥测快照发布(docs/任务规划/数据可信.md)判据一半是并发与结构类——双区撕裂窗在
遥测快照发布(docs/算法/采集与算法层设计说明.md §13)判据一半是并发与结构类——双区撕裂窗在
台架上不可观测,削顶品质要等两点标定才真实出现;读数与注入源比对类
判据仍归台架(实测采样类,本套件不覆盖)。
@@ -21,7 +21,7 @@
python test/host/meas/run_unit_test.py
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/任务规划/数据可信.md 遥测快照发布(道D,§4.5 快照布局);
设计依据:docs/算法/采集与算法层设计说明.md §13 遥测快照发布(道D,§4.5 快照布局);
创建日期:2026-10-25
"""
import os
+1 -1
View File
@@ -6,7 +6,7 @@
* 平台依赖桩:dbg_log.h(stub/)、cfg_file_register(捕获计数)、
* adc_input_desc(V0.1 权威来源表,同 adc_cal 套件)。
*
* 本套件的存在理由(短板评测 + 「数据可信」§2.2):台架此前"通过"是因为没有
* 本套件的存在理由(短板评测 + docs/算法/采集与算法层设计说明.md §13.6):台架此前"通过"是因为没有
* 一条判据检查**不该动作时不动作**——"码值当工程量"的错配曾让 OC 拿 ~11000
* 码值比 10 A 定值恒假动作。本套件把这条固化成回归:用例从 **ADC 码值** 出发、
* **显式写出码值↔二次值换算**,走真实 折算→采样环→全周傅氏→元件判据 链;
+2 -2
View File
@@ -8,7 +8,7 @@
用"码值→二次值显式换算"的全链路合成波驱动七类保护元件,钉死
「不该动作时不动作」。工具链细节委托 unit_test_harness.py。
为什么要这个套件(数据可信 §2.2 / 量纲回归用例):
为什么要这个套件(docs/算法/采集与算法层设计说明.md §13.6 / 量纲回归用例):
台架此前"通过"是因为没有一条判据检查不该动作时不动作——"码值当工程量"
的错配曾让 OC 恒假动作。本套件把换算写进用例:折算点被旁路或量纲再错位,
断言立刻翻转;纯合成数据,零硬件零台架。
@@ -17,7 +17,7 @@
python test/host/prot_dim/run_unit_test.py
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/任务规划/数据可信.md 量纲回归用例(M4 退出判据⑥);
设计依据:docs/算法/采集与算法层设计说明.md §13 量纲回归用例(M4 退出判据⑥);
创建日期:2026-10-25
"""
import os
+1 -1
View File
@@ -12,7 +12,7 @@
退出码:0=PASS / 1=测试失败 / 2=环境错误。
设计依据:docs/任务规划/数据可信.md(运行参数段)+ docs/子系统设计/IEC104上行设计说明.md §3.4。
设计依据:docs/算法/采集与算法层设计说明.md §13(运行参数段)+ docs/子系统设计/IEC104上行设计说明.md §3.4。
创建日期:2026-10-25(道D 运行参数段)
"""
import os