docs(ui): 页面补齐规划改为现状文档,按当前菜单树校准

docs/UI设计/页面补齐规划.md 280 行 -> 157 行,标题改为「UI 页面补齐现状」。

原文档是 2026-10-23 的立项规划(27 个空叶子、四批铺设、三套前置能力、
六个待拍板问题),这些都已落地,只剩三叶无数据源。改为逐页现状描述:

现状规模(实测核对 ui_menu_tree.txt 与 ui_page_registry.h):43 节点
(7 一级菜单 + 27 二级 + 8 三级)/ 30 叶 / 已绑 27 / 未绑 3(遥信类型、
遥信防抖、双点遥信)/ ui_page_*.c 30 个 / 像素黄金 74 张。

逐页现状按 6 组列出数据来源与代码落点:装置信息与实时数据(交流量
已由 Flash 字面量改为 ui_data_rt 快照 7 行、直流量 2 行、装置信息 8 行
全真值)、参数定值查看/整定两态共一份描述符、三遥设置、装置维护、
通讯参数、记录查询(七类 syslog + SOE + 运行报告 + 录波回放)。

未绑三叶写明唯一原因是缺开入数据源(硬件能力边界 H3),重开条件 =
RS-485 开入通道落地后按 ui_w_setlist 既有形态加描述符,非架构级工作。

厂家设置支逐项给结论(版本信息并入装置信息、元件配置不做、虚拟注入
未做且若做必须旁路真实采样)。

删除:版本快照表、2026-10-25/28/29/11-04 四轮复核叠加叙述、六个待拍板
问题、分批实施历史进度。字库现值同步为 218 字 / 324 字形。

同步更新引用:docs/README.md 索引描述、页面扩充详细方案.md 3 处
(定位语与归并叙述改为过去时)、UI_数据供给设计说明.md 3 处
(原引 §1/§3.1/§7 与「批 1」改指新节号)。

验证:check_doc_links --sections-strict 通过;pre-commit 48 钩子全 Passed。
This commit is contained in:
2026-11-15 23:03:43 +08:00
parent 0c76be0fe8
commit 384ad5a80d
4 changed files with 111 additions and 234 deletions
+1 -1
View File
@@ -236,7 +236,7 @@ docs/
| [`UI_自动化测试流程.md`](UI设计/UI_自动化测试流程.md) | UI 模拟器像素回归(ui-verify 五步) | | [`UI_自动化测试流程.md`](UI设计/UI_自动化测试流程.md) | UI 模拟器像素回归(ui-verify 五步) |
| [`LVGL模拟器部署与使用说明.md`](UI设计/LVGL模拟器部署与使用说明.md) | PC 端 LVGL 模拟器部署与使用 | | [`LVGL模拟器部署与使用说明.md`](UI设计/LVGL模拟器部署与使用说明.md) | PC 端 LVGL 模拟器部署与使用 |
| [`RemoDispBus协议与接收设计说明.md`](UI设计/RemoDispBus协议与接收设计说明.md) | 远端显示总线协议与接收设计 | | [`RemoDispBus协议与接收设计说明.md`](UI设计/RemoDispBus协议与接收设计说明.md) | 远端显示总线协议与接收设计 |
| [`页面补齐规划.md`](UI设计/页面补齐规划.md) | 27 个空叶子页面的归并、前置能力(数据快照层/数值编辑)与分批顺序(2026-10-23) | | [`页面补齐规划.md`](UI设计/页面补齐规划.md) | 内容页现状:43 节点 / 30 叶 / 已绑 27,逐页形态与数据来源,未绑三叶的原因 |
| [`UI_数据供给设计说明.md`](UI设计/UI_数据供给设计说明.md) | 页面实时数据的高内聚低耦合方案:快照推送(rt/par 双通道)、写路径、记录 reader 注入(2026-10-23) | | [`UI_数据供给设计说明.md`](UI设计/UI_数据供给设计说明.md) | 页面实时数据的高内聚低耦合方案:快照推送(rt/par 双通道)、写路径、记录 reader 注入(2026-10-23) |
| [`页面扩充详细方案.md`](UI设计/页面扩充详细方案.md) | 27 个空叶子 + 3 页回炉的逐页方案:行表、数据源、组件、分批与预算(2026-10-23) | | [`页面扩充详细方案.md`](UI设计/页面扩充详细方案.md) | 27 个空叶子 + 3 页回炉的逐页方案:行表、数据源、组件、分批与预算(2026-10-23) |
| `mockups/` | 各页面参考图与说明 | | `mockups/` | 各页面参考图与说明 |
+3 -3
View File
@@ -1,7 +1,7 @@
# UI 数据供给设计说明(高内聚低耦合) # UI 数据供给设计说明(高内聚低耦合)
> **定位**:解决"内容页拿不到实时数据"的架构问题——给出数据从 App 层到 UI 层的**唯一通道**、数据契约、并发模型、写路径与测试策略。 > **定位**:解决"内容页拿不到实时数据"的架构问题——给出数据从 App 层到 UI 层的**唯一通道**、数据契约、并发模型、写路径与测试策略。
> **问题来源**:`docs/UI设计/页面补齐规划.md` §1 与 §3.1(现状:交流量第 2/3 页、直流量全部为硬编码占位值)。 > **问题来源**:`docs/UI设计/页面补齐规划.md` §1/§2.1(本层落地前,交流量/直流量全部为硬编码占位值)。
> **门禁口径**:`scripts/check_layer_deps.py` 的文件头已写明三种合法做法(注入 / 上层取好传进来 / 叶子工具进 ALLOW)。本文选择并细化前两种。 > **门禁口径**:`scripts/check_layer_deps.py` 的文件头已写明三种合法做法(注入 / 上层取好传进来 / 叶子工具进 ALLOW)。本文选择并细化前两种。
> **前置阅读**:`docs/UI设计/内容页架构.md`(页面描述符与 4 个钩子)、`docs/架构设计/项目架构总览.md`(六层单向依赖)。 > **前置阅读**:`docs/UI设计/内容页架构.md`(页面描述符与 4 个钩子)、`docs/架构设计/项目架构总览.md`(六层单向依赖)。
@@ -585,7 +585,7 @@ typedef struct {
### 9.3 与"虚拟注入"的关系 ### 9.3 与"虚拟注入"的关系
`docs/UI设计/页面补齐规划.md` §7 提的厂家调试"虚拟注入",**天然落在 `ui_data_feed` 上**:注入值只要在 feed 组装时覆盖对应字段即可,**页面完全不知情**。 `docs/UI设计/页面补齐规划.md` §5 记的厂家调试"虚拟注入"(未做),**天然落在 `ui_data_feed` 上**:注入值只要在 feed 组装时覆盖对应字段即可,**页面完全不知情**。
约束(必须写进代码注释):虚拟注入**只能在 feed 层覆盖快照字段**,绝不能改 `prot_set` / `phasor` 的输入——否则会污染保护判据路径。 约束(必须写进代码注释):虚拟注入**只能在 feed 层覆盖快照字段**,绝不能改 `prot_set` / `phasor` 的输入——否则会污染保护判据路径。
@@ -739,5 +739,5 @@ typedef struct {
- **门禁**:`scripts/check_layer_deps.py` 的三种合法做法本文全部用上(快照推送=②,写路径与记录 reader=①),**不新增任何 `ALLOW` 或 `BASELINE` 条目**;计划的 3 条削减**已于 2026-10-25 兑现**(task/UI-rec-reader 落地 §7.2 契约,基线 6 → 3,详见 `docs/门禁说明/layer-deps.md` §1)。 - **门禁**:`scripts/check_layer_deps.py` 的三种合法做法本文全部用上(快照推送=②,写路径与记录 reader=①),**不新增任何 `ALLOW` 或 `BASELINE` 条目**;计划的 3 条削减**已于 2026-10-25 兑现**(task/UI-rec-reader 落地 §7.2 契约,基线 6 → 3,详见 `docs/门禁说明/layer-deps.md` §1)。
- **页面框架**:`docs/UI设计/内容页架构.md` 的 `refresh` / `count_cb` 钩子**签名不变**,页面只是改为从 `ui_data` 取数。 - **页面框架**:`docs/UI设计/内容页架构.md` 的 `refresh` / `count_cb` 钩子**签名不变**,页面只是改为从 `ui_data` 取数。
- **页面清单**:`docs/UI设计/页面补齐规划.md` 的"批 1"第一项即本文 步骤1~步骤3。 - **页面清单**:`docs/UI设计/页面补齐规划.md` §2.1 的交流量/直流量两页即本文的消费端。
- **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md` 的标定(§4.1)与遥测链(§4.2)落地后,只需改 `ui_data_feed` 的取数来源与 `eng` 取值,页面零改动。 - **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md` 的标定(§4.1)与遥测链(§4.2)落地后,只需改 `ui_data_feed` 的取数来源与 `eng` 取值,页面零改动。
+3 -3
View File
@@ -1,6 +1,6 @@
# 页面扩充详细方案(27 个空叶子 + 3 页回炉) # 页面扩充详细方案(27 个空叶子 + 3 页回炉)
> **定位**:`docs/UI设计/页面补齐规划.md` 回答"怎么归并、分几批";本文回答**每一页显示什么、数据从哪来、要改哪些代码**——可直接照着开工的粒度。 > **定位**:`docs/UI设计/页面补齐规划.md` 回答"现在有哪些页、每页是什么形态";本文回答**每一页显示什么、数据从哪来、要改哪些代码**——可直接照着开工的粒度。
> **数据通道**:`docs/UI设计/UI_数据供给设计说明.md`(快照推送 + 写路径 + 记录 reader 注入)。 > **数据通道**:`docs/UI设计/UI_数据供给设计说明.md`(快照推送 + 写路径 + 记录 reader 注入)。
> **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md`(标定、遥测链、运行参数段的缺口)。 > **数据真实性**:`docs/问题记录/采集与数据处理短板评测.md`(标定、遥测链、运行参数段的缺口)。
> **统计口径**:本文所有节点/叶子数字均由 `ui_menu_tree.txt` 脚本统计 + `Drivers/BSP/UI/ui_page_registry.c` 交叉核对,不引用旧文档结论。 > **统计口径**:本文所有节点/叶子数字均由 `ui_menu_tree.txt` 脚本统计 + `Drivers/BSP/UI/ui_page_registry.c` 交叉核对,不引用旧文档结论。
@@ -52,7 +52,7 @@
### 1.4 与既有规划的关系 ### 1.4 与既有规划的关系
`docs/UI设计/页面补齐规划.md` 已把 27 个空叶子归并为 **7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据层**。本文沿用该归并,但**新增三项**(核对后才发现必需): 落地的 27 页按 **7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据层** 归并。本文沿用该归并,但**新增三项**(核对后才发现必需):
| 新增项 | 为什么规划里没有 | | 新增项 | 为什么规划里没有 |
|---|---| |---|---|
@@ -648,7 +648,7 @@ SNTP 客户端 ──────→ 批4 SNTP设置
| 文档 | 回答什么 | | 文档 | 回答什么 |
|---|---| |---|---|
| `docs/UI设计/页面补齐规划.md` | 27 页怎么归并、分几批、内存预算 | | `docs/UI设计/页面补齐规划.md` | 现状规模、逐页形态与数据来源、未绑三叶的原因 |
| **本文** | 每一页显示哪些行、数据从哪来、要改哪些代码 | | **本文** | 每一页显示哪些行、数据从哪来、要改哪些代码 |
| `docs/UI设计/UI_数据供给设计说明.md` | 数据怎么从 App 到 UI(通道/契约/并发/写路径) | | `docs/UI设计/UI_数据供给设计说明.md` | 数据怎么从 App 到 UI(通道/契约/并发/写路径) |
| `docs/UI设计/内容页架构.md` | 页面框架本身(描述符/钩子/权限) | | `docs/UI设计/内容页架构.md` | 页面框架本身(描述符/钩子/权限) |
+104 -227
View File
@@ -1,231 +1,119 @@
# UI 页面补齐规划(2026-10-23) # UI 页面补齐现状
> **定位**:盘清当时 42 节点菜单里**还没有内容页的 27 个叶子**(节点数现值 43 = 9 菜单 + 34 叶, > **定位**:菜单树 43 节点 / 30 叶里,**27 叶已绑内容页、3 叶未绑**。本文按分组逐页说明当前形态与数据来源,
> 2026-10-29 录波道加「录波回放」叶后升级;本文其余数字是 2026-10-23 立项快照,按 §1 的「完成即冻结」不回改),按"数据是否就绪 + 页面形态"归并成可施工的包,给出分批顺序与每页规格。 > 并把剩下三叶为什么没做、什么条件下才做写清楚。历史上的分批排队与估算已全部落地,不再保留。
> **前置阅读**:`docs/UI设计/内容页架构.md`(框架机制与新增页面六步)、`docs/UI设计/菜单页面设计.md`(菜单树与几何)、`docs/UI设计/UI_自动化测试流程.md`(像素回归门禁)。 > **前置阅读**:`docs/UI设计/内容页架构.md`(框架机制与新增页面六步)、`docs/UI设计/菜单页面设计.md`(菜单树与几何)、
> **不重复登记**:页面级规格写进本文与 `docs/UI设计/内容页架构.md`;顺序归 `docs/任务规划/README.md` §2。 > `docs/UI设计/UI_数据供给设计.md`(注入通道契约)、`docs/UI设计/UI_自动化测试流程.md`(像素回归门禁)。
> **逐页细化**:每页显示哪些行、数据从哪来、要改哪些代码,见 `docs/UI设计/页面扩充详细方案.md`(本文的落地细化版)。 > 逐页行表与代码级明细见 `docs/UI设计/页面扩充详细方案.md`。
--- ---
## 1. 一页结论 ## 1. 现状规模
**"27 个空页面"不是 27 份工作,是 7 个页面模块 + 1 个共享组件 + 2 项框架能力 + 1 个数据供应层。** | 项 | 现值 | 出处 |
真正卡住进度的不是"画页面",是两件事:
| 卡点 | 实质 | 后果 |
|---|---|---| |---|---|---|
| **UI 拿不到实时数据** | 分层门禁禁止 `Drivers/BSP/**` include `App/**` 头(`scripts/check_layer_deps.py`),而相量/定值/遥信全在 `App/` | 已建的 3 个数据页(装置信息/交流量/直流量)**整页都是 Flash 字面量**(`"3.01"` 这类),新建页也只能照抄假数据 | | 菜单节点 | **43**:7 个一级菜单(装置信息/实时数据/参数定值/三遥设置/装置维护/通讯参数/记录查询)+ 27 个二级条目 + 8 个三级条目,其中叶子 **30** | `ui_menu_tree.txt` |
| **没有数值编辑器** | 现有编辑能力只有"逐字节改 IP"(`ui_page_net_cfg.c`),定值要改浮点/整数并校验范围 | 4 个"整定"页无法开工 | | 叶子 | **30** | 同上 |
| 已绑内容页叶子 | **27**;注册表 `UI_PAGE_MAP_COUNT` = 31,差额 4 为「查看/整定」两组叶子的两态复用带来的映射条目 | `Drivers/BSP/UI/ui_page_registry.h` |
| 未绑叶子 | **3**(遥信类型 / 遥信防抖 / 双点遥信) | `ui_menu_tree.txt` |
| `ui_page_*.c` 源文件 | **30**(含 registry 与密码页两个非节点页) | `Drivers/BSP/UI/` |
| 像素黄金参考 | **74 张**(`simulator/tests/ref/shot_*.bin`) | 同目录实数 |
**建议先做数据供应层与数值编辑这两项前置能力,再按"数据就绪度"分四批铺页**——顺序按数据走,不按菜单走。 > 口径:叶子判定 = 无更深缩进后继者;已绑判定 = 该行带 `#page=`。复核方法与 `docs/UI设计/菜单页面设计.md` §3.9 一致。
--- ---
## 2. 现状 ## 2. 逐页现状
### 2.1 规模 ### 2.1 装置信息与实时数据
> ⚠ **本表是 2026-10-23 立项当天快照**(节点 42 / 有内容页叶子 6 / 空叶子 27 / 黄金参考 11 份均为当日实数,按"完成即冻结"不回改)。 | 页 | 叶子 | 数据来源 | 备注 |
> 页面扩充落地后现值已变——黄金参考现为 66 份(`simulator/tests/ref/` 入库的 `shot_*.bin` 实数,2026-10-28 记录 5 页与运行报告页落地 +7 张;2026-10-29 录波 UI 道 +6 张),现状口径见
> `docs/UI设计/页面扩充详细方案.md` 与 `docs/UI设计/UI_数据供给设计说明.md`。
| 项 | 数 |
|---|---|
| 菜单节点总数 | **42**(9 菜单 + 33 叶子) |
| 有内容页的叶子 | **6**(装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录) |
| 无内容页的叶子 | **27** |
| 独立内容页(非节点绑定) | 1(用户密钥/密码页) |
| 已入库像素黄金参考 | 11 份(`simulator/tests/ref/shot_*.bin`) |
### 2.2 已有 7 页的真实完成度
| 页 | 节点 | 数据来源 | 真实度 |
|---|---|---|---| |---|---|---|---|
| 装置信息 | 1 | Flash 静态表 | ⚠ **6 行全是字面量**(含参考项目遗留的校验码 `4454`、日期 `2024.08.27`),不随构建变化 | | 装置信息 | 装置信息 | 全部运行时取真值(型号 / 软硬件版本 / 校验码 / 程序日期 / MAC / IP / 运行时长,共 8 行) | 不再有 Flash 字面量 |
| 交流量 | 3 | Flash 静态表 | ❌ **24 行全是 Flash 字面量,不会变**(第 1 页数值取自参考图实测,看着像真值);且 24 行是参考机全套(含 P/Q/S/PF 与两段母线),**本机 V0.1 只有 8 路电气量 + 温度**,行表需按实际通道裁剪 | | 交流量 | 交流量 | `ui_data_rt()` 快照(`ui_data_rt_seq()` 变化才整帧拷贝) | **7 行**(UA/UB/UC/UN/IA/IB/IC),非参考机 24 行全套 |
| 直流量 | 4 | Flash 静态表 | ❌ **3 行全是占位**(`3.01/3.15/3.288`);**且 V0.1 硬件没有直流采样通道**(`ADC_SEM` 只有 8 路电气量 + 温度)→ 这页当前**无数据源** | | 直流量 | 直流量 | `ui_data_rt()` 快照 | **2 行**,V0.1 无直流采样通道,行集按实际可用量收窄 |
| 网口设置 | 30 | `net_cfg` RAM 副本 | ✅ 真(可编辑 + 保存交接) | | 遥信量 | 遥信量 | `ui_data_rt()` 快照,33 位 + 有效位 | 无效位置灰语义 |
| 自检记录 | 39 | `sys_log`(`/log/selftest.log`) | ✅ 真(经 `ui_w_records`) |
| 运行记录 | 40 | `sys_log`(`/log/run.log`) | ✅ 真(同上) |
| 用户密钥 | — | 编译期密码 | ✅ 真 |
**结论**:7 页里有 **3 页是静态字面量**(装置信息、交流量、直流量),其余 4 页为真。这 3 页**必须回炉**,它们是"有页但不可信",比空叶子更容易误判为已完成。 ### 2.2 参数定值(查看 + 整定两态)
> 逐页的行表、数据源与代码改动量见 `docs/UI设计/页面扩充详细方案.md`。 八个叶子共用**一份描述符**(`ui_page_view_param/set/word/plate.c` → `ui_w_setview` 四张视图表),
同一份行表/取数/反显,不存在"查看一套边界、整定另一套边界"。差异只在进入时是否带编辑叠层:
### 2.3 27 个空叶子逐项清单 | 视图 | 行数 | 内容 | 整定态额外行为 |
> 形态:**信息页**(静态行)/ **列表页**(静态或动态行)/ **表单页**(自绘 + 自有键)/ **操作页**(确认 → 执行 → 回报)。
> 就绪度:✅ 数据现成 / 🔶 需新数据层 / ❌ 数据源不存在。
| 节点 | 叶子 | 建议形态 | 数据源 | 就绪度 |
|---|---|---|---|---|
| 5 | 遥信量 | 动态列表(33 行 / 5 页) | `iec104_pts` 遥信位图 + 有效位图 | ✅(需快照层) |
| 8 | 参数(整定) | 可编辑列表(8 项) | `prot_set` 参数类 | ✅(需编辑器) |
| 9 | 定值(整定) | 可编辑列表(18 项 / 3 页) | `prot_set` 数值类 | ✅(需编辑器) |
| 10 | 控制字(整定) | 可编辑列表(4 项) | `prot_set` 跳闸投退类 | ✅(需编辑器) |
| 11 | 软压板(整定) | 可编辑列表(10 项) | `prot_set` 投退类 + 全局 | ✅(需编辑器) |
| 13 | 参数(查看) | 列表(8 项 1 页) | 同 8 | ✅(需快照层) |
| 14 | 定值(查看) | 列表(18 项 / 3 页) | 同 9 | ✅(需快照层) |
| 15 | 控制字(查看) | 列表(4 项) | 同 10 | ✅(需快照层) |
| 16 | 软压板(查看) | 列表(10 项 / 2 页) | 同 11 | ✅(需快照层) |
| 18 | 遥测死区 | 可编辑列表(4 项) | `[run_par]` 9 键死区 | ✅ 已落地(ui_page_deadband.c,2026-10-27) |
| 19 | 遥测系数 | 可编辑列表(9 项) | `[adc_cal]` 的 k / b | ✅ 已落地(ui_page_calib.c,2026-10-27) |
| 20 | 遥信类型 | 可编辑列表 | 开入量 | ❌ 开入未实现 |
| 21 | 遥信防抖 | 可编辑列表(1 项) | 运行参数 0x8030 | ❌ 同上 |
| 22 | 双点遥信 | 可编辑列表 | 开入量 | ❌ 同上 |
| 24 | 时钟设置 | 表单(6 字段) | `sys_clock_get_time/set` | ✅ |
| 25 | 强制复归 | 操作页(确认) | `prot_elm_request_reset()` | ✅ |
| 26 | 手动录波 | 操作页(确认) | `wave_ring_request` 手动触发经 `ui_data_wave_ops_t` 注入 | ✅ 已落地(`ui_page_wave_manual.c`,2026-10-29 录波 UI 道;配套新增「录波回放」叶 node 43 = `ui_page_wave_play.c`,不在本表 27 叶之列) |
| 27 | 清除记录 | 操作页(选类型 + 确认) | `sys_log`(**缺删除 API**) | 🔶 需补 API |
| 29 | 通讯设置 | 可编辑列表(4~6 项) | 104 公共地址/端口/主站(当前固定) | 🔶 需 `comm_cfg` |
| 31 | SNTP设置 | 可编辑列表(3 项) | SNTP 客户端 | ✅ 已落地(`ui_page_sntp.c`,2026-11-04 板端 SNTP 接入立项;形态较原规划多 1 行 = 启用/主服务器/备服务器/周期(分) + 保存行,编辑语义复刻网口设置页) |
| 33 | SOE记录 | 动态列表(每记录 2 行) | `/log/soe.log` 二进制 64B | ✅ 已落地(`ui_page_soe.c`) |
| 34 | 事故记录 | 动态列表 | /log/accid.log(SYSLOG_ACCIDENT,写入点 protect_task.c) | ✅ 已落地(ui_page_accident.c,2026-10-28) |
| 35 | 操作记录 | 动态列表 | /log/oper.log(SYSLOG_OPER,写入点 4 处:定值保存 / 复归 / 对时 / 清除记录) | ✅ 已落地(ui_page_oper.c,2026-10-28) |
| 36 | 保护告警 | 动态列表 | /log/alarm.log(SYSLOG_ALARM,asserted 且跳闸投退=0) | ✅ 已落地(ui_page_alarm.c,2026-10-28) |
| 37 | 保护启动 | 动态列表 | /log/start.log(SYSLOG_START,picked 上升沿) | ✅ 已落地(ui_page_start.c,2026-10-28) |
| 38 | 遥控记录 | 动态列表 | /log/yk.log(SYSLOG_YK,写入点 iec104_pts.c 遥控段) | ✅ 已落地(ui_page_yk.c,2026-10-28) |
| 41 | 运行报告 | 列表页(12 行 / 2 页,四数逐个挂范围标签) | boot_stats(上电次数 + 复位原因)+ 四个 104 观测计数 + uptime_s,经 ui_data info 帧下发 | ✅ 已落地(ui_page_runreport.c,2026-10-28;跨开机累计按裁定不做) |
**统计(2026-10-25 复核)**:本表 27 叶中 **6 叶已落地**(遥信量 / 查看 4 页 / SOE),剩 21 叶 = 数据现成 **8** 项(整定 4 + 时钟 + 复归 + 死区 + 系数)· 需新数据层 **2** 项(清除记录 / 通讯设置)· 数据源不存在 **11** 项(遥信 3 + 手动录波 + SNTP + 记录 5 + 运行报告)。**逐页形态与数据源只看本表,排期不进本文**——当时的执行清单文件已于 2026-11-09 随 UI 补齐整体销项删除,页面口径现归 `docs/UI设计/内容页架构.md` §7.1。
**2026-10-28 复核**:本表 27 叶中 **22 叶已落地**(本批 +6:记录 5 页与运行报告);未落地的 5 叶 = 遥信类型 / 遥信防抖 / 双点遥信(无开入硬件)+ 手动录波(无录波模块)+ SNTP设置(产品口径未定),重开条件见 `docs/架构设计/硬件规格与能力边界.md` H3 与各模块文档。口径闭合:本表 22 叶 + 立项前就已绑定、不在本表内的 6 叶(装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录)= 现值已绑 28 叶(= UI_PAGE_MAP_COUNT);本表未落地 5 叶 = 菜单树未绑 5 叶(33 − 28)。复核方法:按缩进判叶子(有更深缩进后继者即非叶子),再按行内 #page= 数已绑(完整命令见 `docs/UI设计/菜单页面设计.md` §3.9)。**2026-10-29 补充**:「手动录波」已随故障录波独立立项(docs/子系统设计/故障录波设计说明.md;原卡片登记簿 2026-10-30 销项并入该文 §10),上面那行数字仍是 2026-10-28 当日复核值,未随立项改动。
**2026-10-29 二补(录波 UI 道落地)**:本表「手动录波」转已落地(23 叶);菜单树另新增「录波回放」叶(node 43,不在本表立项快照内)——现值 43 节点 / 34 叶 / 已绑 30 / 未绑 4(= 遥信 3 + SNTP 1,UI_PAGE_MAP_COUNT = 30),口径复核方法与上一段相同
**2026-11-04 复核(板端 SNTP 接入立项,#57 调研结论)**:本表「SNTP设置」转已落地(24 叶)——`ui_page_sntp.c` 绑 `#page=sntp`,[sntp] 段经 `net_cfg_load` 注册、SNTP 客户端在 timeSyncTask 轮询(`App/sync/time_sntp.c`);现值 43 节点 / 34 叶 / 已绑 31 / 未绑 3(= 遥信 3,UI_PAGE_MAP_COUNT = 31),口径复核方法与上一段相同
---
## 3. 三个前置能力(不先做,页面只能显示假数据)
### 3.1 UI 数据快照层(最关键)
**问题**:分层门禁规定 `Drivers/BSP/**` 不得 include `App/**` 头(`scripts/check_layer_deps.py`),现有 6 条基线只减不增。相量、定值、遥信全在 `App/`,所以页面**无法合法地直接取数**——这正是交流量/直流量只能写死占位值的根因。
**方案**:沿用门禁注释里已经写明的意图——"记录读取应由上层递进来"。即 **App 推、BSP 存、页面只读**:
```
App/app/ui_data_feed.c(App 层,可同时 include 两侧)
每 N ms 组装一帧 → ui_data_publish_rt(&frame) / ui_data_publish_par(&frame)
│
▼
Drivers/BSP/UI/ui_data.c(BSP 层,持有最新一帧)
│ ui_data_rt(&snap) / ui_data_par(&snap) —— 页面钩子只读
▼
ui_page_ac / ui_page_yx / ui_page_setlist ...
```
> 契约、并发模型、写路径、记录 reader 注入与测试策略见 `docs/UI设计/UI_数据供给设计说明.md`,本节只保留规划粒度。
- 快照内容:9 路遥测值 + 品质、33 位遥信 + 有效位、40 项定值(Q10)+ 封存态、频率、时钟。
- 发布节奏:遥测/遥信 **200 ms**(与遥测链同源);定值**仅变化时**发布(`prot_set_checksum()` 变化触发,避免每拍 160 B 拷贝)。
- 方向正确:App → BSP 是"上层依赖下层",门禁允许;BSP 侧不认识 `App/` 任何符号。
- **并发:单写者同上下文,不需要锁**——`ui_data_feed_tick()` 与页面钩子都跑在 uiTask;序号只用于页面侧缓存失效判断(`ui_data_rt_seq()`),不是同步原语。
- 规模:**M**(`ui_data` + `ui_data_feed` 约 150 行 + 单测 + `ui_task.c` 接线)。
> ⚠ 没有这一层,后面 11 个"数据现成"的页面全部是假的。**它是本规划的第一优先项**,优先于任何单页。
### 3.2 数值编辑能力
**问题**:现有编辑只有 `ui_page_net_cfg.c` 的"逐字节改 IP"(↑↓ 调字节、←→ 移光标)。定值要改的是**浮点工程量**(10.0 A、120.0 V、500 ms),需要:位数移动、步进(含 0.01/0.1/1/10 分级)、范围校验、越界提示、保存失败提示。
**方案**:把编辑逻辑从 `ui_page_net_cfg.c` 抽成共享组件 `ui_w_editor`(或扩展 `ui_w_*` 家族),提供:
| 能力 | 说明 |
|---|---|
| 进入/退出编辑 | ENTER 进入(需 `edit_capable` 且 `UI_PERM_MODIFY`)、ESC 取消并回滚 |
| 数值步进 | ↑↓ 按当前光标位加减;光标位决定步长(个位/十分位/百分位) |
| 范围校验 | 取 `prot_set_meta_t` 的 `min/max`,越界拒绝并提示 |
| 提交 | 行内 ENTER 暂存 → 末行"保存"统一提交(一次封存、一次校验和) |
**关键设计**:定值保存必须**整表提交**而不是逐项写盘——`prot_set_set()` 批量写后必须 `prot_set_seal()`(见 `docs/算法/采集与算法层设计说明.md` §8)。逐项写会把校验和打成中间态,被自检判为损坏。
- 规模:**M**(组件 + 与 `prot_set` 的写回交接)。
### 3.3 记录类型表(记录页共用)
已有 `ui_w_records` 组件把"读日志 → 行渲染"收成一份代码,`ui_page_selftest` / `ui_page_runlog` 只是薄跳板。**新增文本类记录页 = 一行实例 + 一个 `syslog_id_t`**。
但 `sys_log` 目前只有 2 个 ID(运行、自检),且 **`/log/soe.log` 是二进制 64 B 结构**,不是文本 64 B——不能直接复用 `ui_w_records`。两条路:
| 记录 | 方案 | 成本 |
|---|---|---|
| 文本类(事故/操作/告警/启动/遥控) | 扩 `syslog_id_t` + 各记录写入方 | 页面 S,**写入方 M~L** |
| SOE(二进制) | 新 `ui_w_soe`:按 `soe_rec_parse()` 解码成"时间 + 类型 + 元件 + 值"两行 | **M** |
数据怎么进页面已定:**注入 reader**(`ui_rec_reader_t`),页面不再 include `sys_log.h`——顺带退掉 3 条分层基线(6 → 3)。契约见 `docs/UI设计/UI_数据供给设计说明.md` §7。
---
## 4. 页面归并:27 页 → 7 模块
| 包 | 模块 | 覆盖叶子 | 复用 |
|---|---|---|---| |---|---|---|---|
| **A 实时数据** | `ui_page_yx` | 5 | 动态列表 + 快照层 | | 参数 | 8 | PT/CT 一次二次额定 + 4 个返回系数 | 可编辑 + 保存行 + 未标定徽标 |
| **B 定值查看** | `ui_w_setlist` + `ui_page_set_ro` ×4 描述符 | 13/14/15/16 | 一份组件,4 张视图表 | | 定值 | 18 | 三段过流、过负荷、过压/低压、零序过压、过频/低频的定值与延时 | 同上 |
| **C 定值整定** | 同 B + `ui_w_editor` | 8/9/10/11 | 同上 + 编辑 | | 控制字 | 4 | OC1~OC3、OL 的跳闸/告警选择 | 同上 |
| **D 三遥设置** | `ui_page_three_remote`(5 描述符) | 18/19/20/21/22 | 同 B 组件 | | 软压板 | 10 | 全局软压板 + 9 个元件投退 | 同上 |
| **E 装置维护** | `ui_page_clock`(表单)+ `ui_page_action`(操作页) | 24/25/26/27 | 操作页可复用(复归/录波/清除三处) |
| **F 通讯参数** | `ui_page_comm`(2 描述符) | 29/31 | 同 B 组件 |
| **G 记录查询** | `ui_page_soe` + `ui_w_records` 扩 ID | 33/34/35/36/37/38 | 记录组件 |
| (H 厂家设置) | 见 §7 | 0(菜单树需扩) | — |
**定值 40 项的视图划分**(`prot_set` 现有 40 项,按语义分四组,不改校验和覆盖序): - **数值编辑**由 `ui_w_editor` 承担:进入/退出、逐位步进(个位/十分位/百分位)、`min/max` 范围校验、行内暂存 + 末行统一提交。
- **保存必须整表提交**:`prot_set_set()` 批量写后必须 `prot_set_seal()`,逐项写会把校验和打成中间态、被自检判为损坏。
- 行表用 2~4 字缩写("Ⅰ段电流"而非"过流Ⅰ段定值"),受字体子集约束。
| 视图 | 项数 | 内容 | ### 2.3 三遥设置
| 叶子 | 数据来源 | 状态 |
|---|---|---| |---|---|---|
| 参数 | 8 | PT/CT 一次二次额定、四个返回系数 | | 遥测死区 | `[run_par]` 段(`ui_page_deadband.c`) | ✅ 已落地 |
| 定值 | 18 | 三段过流、过负荷、过压/欠压、零序过压、过频/低频的定值与延时 | | 遥测系数 | `[adc_cal]` 段 k / b(`ui_page_calib.c`) | ✅ 已落地 |
| 控制字 | 4 | OC1~OC3、OL 的"跳闸/告警"选择(`*_TRIP`) | | 遥信类型 | 开入量 | ❌ **未绑**,见 §3 |
| 软压板 | 10 | 全局软压板 + 9 个元件投退(`*_EN`) | | 遥信防抖 | 运行参数 `0x8030` | ❌ **未绑**,见 §3 |
| 双点遥信 | 开入量 | ❌ **未绑**,见 §3 |
> 现状 `prot_set_meta_t` **没有名称字段、没有分类字段**。需要补:① 40 条中文名(受字体子集约束,见 §6);② 一个 `cat` 字段(ROM 表,不参与校验和,加字段安全)。 ### 2.4 装置维护
| 叶子 | 形态 | 数据来源 / 执行侧 |
|---|---|---|
| 时钟设置 | 表单 | `sys_clock_get_time/set` + `[sntp]` 段,SNTP 为唯一网络对时来源 |
| 强制复归 | 操作页(确认) | `prot_elm_request_reset()` |
| 手动录波 | 操作页(确认) | `wave_ring_request`,经 `ui_data_wave_ops_t` 注入 |
| 清除记录 | 七行清单 + 逐行两段式确认 | 条数走 `ui_w_records_count_of()`;删除只发请求(`syslog_request_clear`),真反馈 = 状态机 + 下一帧条数归零 |
### 2.5 通讯参数
| 叶子 | 行数 | 数据来源 |
|---|---|---|
| 通讯设置 | 2(公共地址 / 监听端口)+ 保存行 | `[comm]` 段 RAM 副本,经 `ui_data.h` 通道六注入 |
| 网口设置 | 6 | `[network]` 段 RAM 副本(可编辑 + 保存交接) |
| SNTP 设置 | 4 + 保存行(启用 / 主服务器 / 备服务器 / 周期(分)) | `[sntp]` 段 RAM 副本 |
### 2.6 记录查询
七类记录统一走 `ui_w_records` 组件(一行 `syslog_id_t` 即一个页面),SOE 走专用的 `ui_w_soe`(二进制 64 B 解码)。
| 叶子 | 记录类 | 数据文件 |
|---|---|---|
| SOE 记录 | 二进制 64 B 结构 | `/log/soe.log` |
| 自检记录 | `SYSLOG_SELFTEST` | `/log/selftest.log` |
| 运行记录 | `SYSLOG_RUN` | `/log/run.log` |
| 事故记录 | `SYSLOG_ACCIDENT` | `/log/accid.log` |
| 操作记录 | `SYSLOG_OPER` | `/log/oper.log` |
| 保护告警 | `SYSLOG_ALARM` | `/log/alarm.log` |
| 保护启动 | `SYSLOG_START` | `/log/start.log` |
| 遥控记录 | `SYSLOG_YK` | `/log/yk.log` |
| 运行报告 | boot_stats + 104 计数 + uptime(13 行 / 2 页) | `ui_data` info 帧 |
| 录波回放 | 单通道波形自绘(8 路切换、阶梯线、削徽标) | 故障录波模块 |
--- ---
## 5. 分批实施 ## 3. 未绑的三叶:遥信类型 / 遥信防抖 / 双点遥信
> 排序原则:**前置能力 > 数据现成 > 需补数据层 > 数据源不存在**。不按菜单顺序铺页。 三叶在菜单树里保留(显示为空白终点框,不伪造数据),未绑的**唯一原因是没有数据源**,不是待排期:
### 批 1:打通数据 + 清掉"假页面"(9 个叶子 + 2 个回炉) | 叶子 | 需要什么 | 现状 |
|---|---|---|
| 遥信类型(常开/常闭) | 可配置的开入量点表 | 开入未实现(`docs/架构设计/硬件规格与能力边界.md` H3 能力边界) |
| 遥信防抖 | 开入量的防抖时间参数 | 同上;运行参数 `0x8030` 只在开入存在时才有意义 |
| 双点遥信 | 成对开入量的双点编码 | 同上 |
1. **`ui_data` 快照层**(§3.1)——所有后续页面的地基。 **重开条件**:RS-485 采集接线与开入通道落地后,这三叶按 `ui_w_setlist` 的既有形态(可编辑列表)即可开工,
2. **交流量 / 直流量回炉**:接快照层,删掉占位值;直流量改成真实 3 路(直流通道 2 路 + 温度 1 路,或按 V0.1 实际可用量重定行)。 无需新框架——它们是描述符级别的增量,不是架构级工作。
3. **遥信量**(node 5):33 行,无效位显示 `--` 并置灰语义(单色屏用前缀 `*` 或后缀 `?` 表示无效)。
4. **定值查看 4 页**(13/14/15/16):一份组件 + 4 张视图表 + 名称表。
5. **时钟设置**(24):6 字段表单,写 `sys_clock_set` 后回读校验。
6. **强制复归**(25):确认 → `prot_elm_request_reset()` → 回报(操作页首个实例)。
7. **清除记录**(27):需先给 `sys_log` 补删除 API(按 ID 删文件 + 重建 + 计数归零)。
8. **SOE 记录**(33):`ui_w_soe` 二进制解码列表。
**退出判据**:主站改一条定值 → 就地页面 200 ms 内显示新值;SOE 记录页能翻到最近 20 条。
### 第二轮:整定与通讯(6 个叶子)
9. **`ui_w_editor`**(§3.2)→ **定值整定 4 页**(8/9/10/11)。
10. **通讯设置**(29):需先建 `comm_cfg`(`[comm]` 段:104 公共地址/端口/主站地址),照 `net_cfg` 的"RAM 副本 + 保存请求交接"范式。
11. **SNTP设置**(31)——已落地(2026-11-04):页面读写 `[sntp]` 段 RAM 副本(`ui_page_sntp.c`,PR 链 #73/#77);原「当前对时走 8888 端口私有协议」口径作废——8888 已退役(#78),SNTP 即对时唯一网络来源。
**退出判据**:就地改一条定值 → 保存 → 掉电重启 → 值保持且校验和自检通过;主站 C_RD 读到同一值。
### 批 3:等数据层(12 个叶子)
12. **三遥设置 5 页**(18~22)——等运行参数段与开入量。
13. **事故/操作/告警/启动/遥控 5 页**(34~38)——等记录写入方(每类记录 = 一个写入点 + 一个 `syslog_id_t`)。
14. **手动录波**(26):操作页(`ui_page_action` 确认链,受理后回「已请求录波」)——已落地(2026-10-29);同批新增「录波回放」单页(上下键切通道、左右键切段、阶梯线 3px/点、0 线虚线、峰值 mV 经 `wave_store_code_to_milli` 唯一口径、削徽标、空态/坏段显式文案,规格见 docs/子系统设计/故障录波设计说明.md §8.1)。
15. **运行报告**(41)——等计数器(上电次数/运行时长/复位原因/104 统计)。
### 批 4(可选):厂家设置
见 §7。
--- ---
## 6. 每页成本与门禁 ## 4. 每页成本与门禁
**标准动作**(已由生成器收敛,实测 3 处人工 + 1 条命令): **标准动作**(已由生成器收敛):
| # | 动作 | 落点 | | # | 动作 | 落点 |
|---|---|---| |---|---|---|
@@ -236,45 +124,34 @@ ui_page_ac / ui_page_yx / ui_page_setlist ...
**三条硬约束**: **三条硬约束**:
1. **汉字子集**:任何新文案的汉字必须先过 `tools/font_gen/extract_cn.py` → `make_font.py`,否则显示空白方块(`font-charset` 门禁会拦)。40 条定值名 + 33 条遥信名会显著扩字库——**建议定值名沿用 2~4 字缩写**(如"过流Ⅰ段定值"→"Ⅰ段定值"),控制新增字数。 1. **汉字子集**:任何新文案的汉字必须先过 `tools/font_gen/extract_cn.py` → `make_font.py`,否则显示空白方块(`font-charset` 门禁会拦)。当前子集 **218 字 / 324 字形**。
2. **像素黄金**:新页入 `ui-golden`,此后任何几何/字体改动都会触发全量比对;参考图一旦入库就只能"改代码对齐",禁止刷参考掩盖。 2. **像素黄金**:新页入 `ui-golden`,此后任何几何/字体改动都会触发全量比对;参考图一旦入库就只能"改代码对齐",禁止刷参考掩盖。
3. **RAM**:描述符 + 行表是 Flash const,**不占 LVGL 池**;开页峰值 +776 B(池 16 KB,实测峰值占 40%)→ 页数增加不影响池水位,但 `ui-golden` 的池基线常量要按新页复核。 3. **RAM**:描述符 + 行表是 Flash const,不占 LVGL 池;开页峰值 +776 B(池 16 KB)。页数增加不影响池水位,但 `ui-golden` 的池基线常量要按新页复核。
--- ---
## 7. 厂家设置:菜单树缺的一整支 ## 5. 厂家设置支:现状是"不做"
参考项目的菜单有 **厂家设置**(`CN_COP_PWD` 厂家密码)一支,本项目菜单树**完全没有**: 参考项目的"厂家设置"菜单一支,本项目**菜单树里没有**。逐项结论:
| 参考项 | 本项目 | 价值判断 | | 参考项 | 本项目 | 结论 |
|---|---|---| |---|---|---|
| 版本信息(板件版本) | 无 | **建议合并进"装置信息"**——单板设备,装置信息已有型号/软硬件版本/校验和/日期,再开一页是重复 | | 版本信息(板件版本) | 已并入"装置信息"页 | 不另开页——单板设备,装置信息已有型号/软硬件版本/校验和/日期 |
| 恢复默认(全部/参数/定值/软压板) | 无 | **建议做**:生产返修与现场救急必备;依赖定值/参数模型(第二轮 之后) | | 恢复默认(全部/参数/定值/软压板) | 无 | 未做 |
| 元件配置 | 无 | 不做:本项目元件表是编译期数据驱动,运行期改元件等于改点表,超出 V0.1 范围 | | 元件配置 | 无 | 不做:元件表是编译期数据驱动,运行期改元件等于改点表,超出 V0.1 范围 |
| 交流显示(一次/二次值切换) | 无 | 建议做(1 项配置):依赖标定,随批 3 | | 交流显示(一次/二次值切换) | 交流量页内固定为二次值 | 未做 |
| 装置调试:虚拟遥信/交流虚遥测/动作虚事件/动作出口 | 无 | **建议做"虚拟注入"**:无标准源也能验证 UI/104/记录全链,正好补 第三方送检验收 的前置条件(详见下) | | 装置调试(虚拟注入) | 无 | 未做;若做必须旁路真实采样,**绝不能进保护链** |
> **虚拟注入的价值**:当前送检等标准源(第三方送检验收),而虚拟注入能让"改一个假值 → 看 UI 是否变 → 看 104 是否上送 → 看 SOE 是否记录"这条链在没有硬件激励的情况下闭环。它是**测试基础设施**,不是产品功能,建议放在厂家菜单并加明显标识(标题后缀"调试")。 **虚拟注入的价值**(如将来要做):没有标准源也能把"改一个假值 → UI 是否变 → 104 是否上送 → SOE 是否记录"
> 这条链闭环,属测试基础设施而非产品功能,天然落在 `ui_data_feed` 上。
> **代价**:菜单树从当时 42 节点扩到约 48~50 节点(节点数现值 43,2026-10-29 录波道加「录波回放」叶),`ui_menu_tree.txt` 改动会触发菜单 8 状态像素回归与 `task-table` 式索引文档同步。**这是需要拍板的项**——见 §8。
--- ---
## 8. 需要拍板的 5 个问题 ## 6. 与其他文档的关系
| # | 问题 | 影响 | - **框架与新增页面六步** → `docs/UI设计/内容页架构.md`
|---|---|---| - **注入通道契约、并发模型、记录 reader 注入** → `docs/UI设计/UI_数据供给设计.md`
| 1 | 菜单是否扩到 48~50 节点(加厂家设置支)? | 节点数以 `产品需求设计文档.md` §8.2 为准(2026-10-29 现值 43,此前 42);扩了要改该节与菜单像素回归 | - **逐页行表与代码改动明细** → `docs/UI设计/页面扩充详细方案.md`
| 2 | **直流量页怎么办?**(V0.1 没有直流采样通道)三选一:改成"温度 + 备用"页 / 从菜单删掉 / 保留空页显示 `--` | 决定行表与菜单节点数 | - **菜单树与几何** → `docs/UI设计/菜单页面设计.md`
| 3 | 定值名用全称还是缩写?(字体子集大小 vs 可读性) | 40 条名 × 平均字数,直接影响字库与 `font-charset` | - **能力边界(开入为何没有)** → `docs/架构设计/硬件规格与能力边界.md` H3
| 4 | 事故/操作/告警/启动/遥控 5 类记录,是否本轮就要? | 每类 = 一个写入方 + 一个 `syslog_id_t` + 一个页面,是本规划里最大的一块后端工作 | - **推进顺序** → `docs/任务规划/README.md`
| 5 | 虚拟注入是否要做?做在哪一层(旁路真实采样 vs 覆盖快照)? | 决定它是否会影响保护判据路径(**必须旁路,绝不能进保护链**) |
| 6 | 交流量行表裁到几行?(24 行参考全套 vs 本机 9 路实有) | 决定页数与黄金参考数量 |
---
## 9. 与既有规划的关系
- 本文替代"剩余页面尚未规划"的状态(原 `docs/任务规划/README.md` §2.0 中「UI 扩展」的剩余 21 叶页面落地项按"暂缓、未规划"记载)。
- 页面工作**不应独立于数据层推进**:批 1 的第 1 项(快照层)与采集/遥测链共享同一批数据,建议与"测量子系统"同波次排期。
- 与 `docs/问题记录/采集与数据处理短板评测.md` 的对应:该文的标定(`docs/问题记录/采集与数据处理短板评测.md` §4.1)与遥测链(同文 §4.2)落地后,交流量/直流量/遥测系数三页才有真实数据可显示。