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:
+2
-2
@@ -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);
|
||||
|
||||
|
||||
@@ -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 里的
|
||||
* 条目也一并被删掉(用户按下的就是"把现在这些记录清掉"),
|
||||
* 只有删除之后新投递的记录才会留下。
|
||||
|
||||
Reference in New Issue
Block a user