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
+2 -2
View File
@@ -8,7 +8,7 @@
* 修改记录:
* v1.0 2026-09-14 王建锋 创建初始版本(设计见 docs/子系统设计/运行与自检记录设计说明.md §4)
* v1.2 2026-10-26 王建锋 新增「记录删除」API(UI 装置维护「清除记录」的前置,
* 道F task-4;判据 docs/任务规划/UI补齐.md §2 第 3 行
* 道F task-4;判据 docs/UI设计/内容页架构.md §7.1
* 「不允许只做一个没有实际效果的按钮」):
* 共享层 syslog_request_clear() / syslog_clear_state()
* (双端都实现,UI 侧只准用这两个)+ MCU 后端专属
@@ -217,7 +217,7 @@ int syslog_last_epoch(syslog_id_t id, uint32_t *p_epoch);
* "WAIT 也正常"写判断,别把 WAIT 当失败。
* 刻意**不**在删除成功后补一条 "records cleared" 留痕:判据要求
* syslog_count() 归零,写了立刻变 1;要留痕归操作记录/SOE
* (docs/任务规划/UI补齐.md 第 6 项的写入方),不是本 API 的职责。
* (docs/UI设计/内容页架构.md §7.1 第 2 条的写入方),不是本 API 的职责。
*/
int syslog_request_clear(syslog_id_t id);
+2 -2
View File
@@ -608,7 +608,7 @@ static int s_read_raw(syslog_id_t id, uint32_t idx, uint8_t *p_rec) {
* 不去做无谓的失效(与 s_append_rec"失败也一律失效"不同——那边失败
* 伴随过 unlink/重建,本函数失败时盘上什么都没动)。
* 刻意不在删除成功后补一条 "records cleared":判据要求 syslog_count()
* 归零,写了立刻变 1;要留痕归操作记录/SOE(UI补齐.md 第 6 项)。
* 归零,写了立刻变 1;要留痕归操作记录/SOE(docs/UI设计/内容页架构.md §7.1 第 2 条)。
*/
static int s_clear_try(syslog_id_t id) {
FRESULT fr;
@@ -650,7 +650,7 @@ static int s_clear_try(syslog_id_t id) {
* 1) 排在条目排空**之后**(调用位置见 syslog_drain):删除必须是本轮对
* run.log/selftest.log 的最后一次盘上动作,否则本轮刚排空的旧记录
* 会在删除之后又落回去,count 不归零,"清除"就成了没实际效果的按钮
* (判据出处 docs/任务规划/UI补齐.md §2 第 3 行)。
* (判据出处 docs/UI设计/内容页架构.md §7.1 第 2 条)。
* 副作用照实登记:**先排空再删** = 请求受理时仍在队列/preboot 里的
* 条目也一并被删掉(用户按下的就是"把现在这些记录清掉"),
* 只有删除之后新投递的记录才会留下。