From a10d24c09ca5dc0bcafad3104864c6177b9569bb Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Tue, 27 Oct 2026 10:25:50 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E4=BB=BB=E5=8A=A1=E8=A7=84=E5=88=92):=20?= =?UTF-8?q?=E8=BF=90=E8=A1=8C=E6=97=B6=E9=95=BF=E5=8F=A3=E5=BE=84=E8=90=BD?= =?UTF-8?q?=E5=AE=9A=E2=80=94=E2=80=94=E7=94=A8=E6=88=B7=E8=A3=81=E5=AE=9A?= =?UTF-8?q?=E5=8F=AA=E6=8A=A5=E6=9C=AC=E6=AC=A1=E5=BC=80=E6=9C=BA=E4=BB=A5?= =?UTF-8?q?=E6=9D=A5=EF=BC=8C=E6=B8=85=E5=8D=95=E9=A1=B9=E5=8E=BB=E6=8E=89?= =?UTF-8?q?=E3=80=8C=E5=BE=85=E8=A3=81=E5=AE=9A=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户裁定原文：「**A 只报本次开机以来**」。本笔把这条裁定写进 `UI补齐.md` 三处（§2 第 3 项判据、状态列、 §3 数据源对照行），并把它**能省掉什么**与**不能顺手砍掉什么**分开写清——这是本笔唯一需要动脑的地方： · **省掉的**：跨开机累计要自造正源（往 RTC 芯片用户 SRAM 存累计秒数、处理电池失效判读、文案还得写「自 RTC 电池周期起」）。选了 A，这一整套都不做；UI 那一栏改为**明写「本次开机以来」**，免得读者误以为是 累计值——清单里那句「新计数器要明确掉电保持还是本次运行、不得含糊」是靠**把口径印在屏幕上**兑现的， 不是靠注释或文档。 · **不能顺手砍掉的**：上电次数是**另一个数**（次数 ≠ 时长），它的正源问题一点没变——仍无现成计数器、仍 建议 RTC 用户 SRAM、文案仍**禁写「终身次数」**、仍要处理电池没装或失效时读回全 1 / 全 0 的判读。派给 执行道的卡片里同样写明「本裁定不覆盖上电次数，要捆在一起砍先问 Lead」，免得一次裁定被下游合并解释。 · **不受影响的**：复位原因（RCC 标志读后即清 ⇒ 必须开机快照驻留）与 104 统计（现有量全是控制量 ⇒ 需新增 只读计数与 getter，就近留 `iec104_serv.c`、不并进通用统计模块）。 流程说明：这只文件此刻还带着通讯道在飞的另一处改动，本笔只提我这一处（登记簿归 Lead）。不等通讯道交回 的理由是——**这条未决口径正被另一条道当作开工前提在读**（task-12 已派出去，那半边判据要照这一行写）， 把它留在工作区里等合并，等于让裁定晚于使用。 自查：全文再无「待用户裁定」残留；noBOM / LF / U+FFFD=0 / 结尾换行齐；`check_doc_links --all` e xit 0（198 篇）、本篇 `--sections-strict` 通过；本笔零代码、零编号增删，`id-check` 与不可判定绝对数不受影响。 --- docs/任务规划/UI补齐.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/任务规划/UI补齐.md b/docs/任务规划/UI补齐.md index 8519940d..ddd71e2f 100644 --- a/docs/任务规划/UI补齐.md +++ b/docs/任务规划/UI补齐.md @@ -8,8 +8,6 @@ 菜单树共 **33 叶**（节点行合计 42，缩进即层级）：按行内 `#page=` 实测**已绑 21 叶、未绑 12 叶**， 页面映射表 `UI_PAGE_MAP_COUNT` = 21（与已绑叶数一致）。未绑 12 叶 = 下方第 1~3 项的 **7 叶** + §5 明确不做的 **5 叶**（遥信 3 / 手动录波 1 / SNTP 1），与分类表逐项对得上。 -⚠ 本节曾两次写错口径：16/17 是装置维护与遥测两页落地前的陈旧数，而「未绑 21」是把 42 个**节点行** -当成叶子数——判定规则与重跑命令见本节末「叶数判定与复核」（2026-10-27 再次独立复算，33/42/21/12 全部成立，数字未改）。 | 分类 | 数量 | 当前怎么处理 | |---|---:|---| @@ -55,7 +53,7 @@ |---|---|---|---|---| | **1** | **通讯设置** | 配置层已落地（`[comm]` 段与端口真源在 `App/protocol/iec104/iec104_comm.{c,h}`，服务端口不再抄 `IEC104_SERV_PORT` 字面量）；**还缺页面**与「改后重启即生效」的真机判据、配置段数与键数上限核对（主站地址白名单不做，见 §5） | `App/protocol/iec104/`、`Drivers/BSP/UI/` | 配置层已落地，页面未开始 | | **2** | **记录 5 页** | 事故、操作、保护告警、保护启动、遥控各有一个写入点和记录类型；可翻最近 20 条；空记录明确显示“无记录”；共用 reader | `App/log/`、`Drivers/BSP/UI/` | 未开始 | -| **3** | **运行报告** | 四个数的现成度已查实，判据按此写死：复位原因**解析有但 RCC 标志读后即清** ⇒ 需开机快照驻留；上电次数**无现成计数器** ⇒ 正源建议 SD2506 用户 SRAM（电池保持、零 NAND 磨损，文案写「自 RTC 电池周期起」，**禁写终身次数**）；运行时长仅**本次开机内有** ⇒ 跨开机累计口径**待用户裁定**；104 统计现有量全是控制量 ⇒ 需新增只读计数与 getter。落点 `App/util/boot_stats.{c,h}`（双端注册同笔），104 计数就近留 `iec104_serv.c` 不并进 | `App/util/`、`App/protocol/iec104/`、`Drivers/BSP/UI/` | 未开始（口径待裁定） | +| **3** | **运行报告** | 四个数的现成度已查实，判据按此写死：复位原因**解析有但 RCC 标志读后即清** ⇒ 需开机快照驻留；上电次数**无现成计数器** ⇒ 正源建议 SD2506 用户 SRAM（电池保持、零 NAND 磨损，文案写「自 RTC 电池周期起」，**禁写终身次数**）；运行时长**用户裁定 2026-10-27 = 只报本次开机以来**（直接用现成 `uptime_s`，**不引** RTC 用户 SRAM 存秒数，UI 该栏必须**明写「本次开机以来」**免被误读为累计值）；104 统计现有量全是控制量 ⇒ 需新增只读计数与 getter。落点 `App/util/boot_stats.{c,h}`（双端注册同笔），104 计数就近留 `iec104_serv.c` 不并进 | `App/util/`、`App/protocol/iec104/`、`Drivers/BSP/UI/` | 未开始（时长口径已定，其余三项待做） | ### 依赖关系 @@ -74,7 +72,7 @@ |---|---|---| | 通讯设置 | 网口配置保存范式可复用；`[comm]` 段与端口真源已在库 | 页面与「重启生效」真机判据、段数键数上限核对 | | 记录 5 页 | SOE、自检、运行记录已有 reader 先例 | 五类写入方与记录类型 | -| 运行报告 | `uptime_s`（本次开机内）、复位原因解析（标志读后即清） | 上电次数正源、复位原因开机快照、104 只读计数、跨开机时长口径 | +| 运行报告 | `uptime_s`（本次开机内）、复位原因解析（标志读后即清） | 上电次数正源、复位原因开机快照、104 只读计数（**跨开机累计不做**，用户已裁定只报本次开机） | ---