feat(ui-pages): SOE 记录页接 soe_store 只读遍历（类型 7/8 首次上屏）

ui_w_soe 组件（task-14 落）此前两端都没绑 reader，只能显示"无记录"空态。本批补齐三件事：
App 侧只读遍历、两端 reader 绑定、SOE 记录页与菜单注册。

App/log/soe_store 只读 API（Lead 已放行，本批独占这两个文件）
- soe_store_count() / soe_store_read(idx, soe_rec_t*)：与 syslog_count /
  syslog_get_record 同构——8 条一窗（512 B）整块读、命中窗口零 I/O、卷锁 try（0 超时）
  非阻塞；定长记录逐条 open 等于同一扇区开 4 次，SPI NAND 上这个差距是肉眼可见的卡顿
- 读者不得看到半成品记录，三道保障缺一不可（规则写进 soe_store.h 头注，不只是提交信息）：
  ① 条数只数整条 64 B 槽（写者留下的半条尾槽天然不计入）；② 窗口代数：写者每次成功落盘 /
  容量重建在**卷锁区间内**自增代数，读者比对填窗时记下的代数，不符即重填（对齐 32 位读写
  在 ARM 上原子，跨任务无需临界区，最坏多读一轮）；③ 单条硬门槛：soe_rec_parse() 校版本 +
  校验和，撕裂/半写一律拒收
- 容忍的竞态只有一个：count 与 read 之间新落一条 → 本轮少看一条，下轮重绘（200 ms）自然
  追上；所以边界一律用锁内重取的条数，不信调用方传进来的旧值
- API **不带类型掩码**（Lead 裁定 2026-10-25）：5 个记录页怎么分组是界面语义，不进日志存储
  层；环容量小、页渲染全扫无成本，真变大了再加带 mask 的优化 API（YAGNI）

⚠ 顺带修掉一颗定时炸弹：菜单生成器与生成物漂移
- 提交里的 Drivers/BSP/UI/ui_menu_tab.h 带着 5 个表查询 API 的规范注释块，而
  tools/menu_gen/gen_menu.py 只会输出"声明 + 行尾短注释"——说明历史上有人**手改生成物**
  补注释、没回灌生成器。我这次加 #page=soe 后重新生成，等于把那些注释抹掉，bsp-err 立刻
  报 5 条 return-doc
- 修法不是把生成物改回去（下次重新生成还会再抹一次），而是把注释块**回灌进生成器**；
  回灌后重跑 gen_menu.py 产出的 ui_menu_tab.h 与 HEAD **逐字节一致**（git diff 为空），
  漂移关闭。生成物里的手工优化 = 一定会被覆盖的优化，要么进生成器要么别改生成物

时标口径（跨模块陷阱，注释即防线）
- 页面时标取记录内的 CP56（事件自己的时标，不是"现在"）。它与运行/自检记录页同口径，靠两条
  事实叠出来：sys_clock 的 epoch 域本身就是本地时间（App/util/sys_clock.h 的
  sys_clock_set_unix 注明"Unix epoch time (秒，本地时间)"），而 soe_rec.c 的 epoch→CP56
  分解不加任何时区偏移。**谁"顺手补 8 小时"，SOE 页就会和文本记录页差 8 小时**；要引显式
  时区必须两侧一起改

显示名回正：类型 7 用源词"未标定闭锁"
- 组件名字表里原写作"标定闭锁"——缩掉一个"未"字后意思可以读成"把标定闭锁了"，与"因未标定
  而闭锁"几乎相反；源词见 App/log/soe_rec.h 与"数据可信"卡 5，UI 表现层无权改写事实词
- 模拟器的 3 条假记录刻意含一条 type 7 + ELM_NONE（非元件支路）：这是 7/8 两个新类型
  **真的接上屏**的第一个像素级证据——只有主机断言时，名字表写错也照样一片绿
- 主机测试的宽度护栏随之按"画到哪一列"分列：动作/返回进值列（4 汉字 = 12 字节），其余类型
  名进名列（7 汉字 = 21 字节）；原来一刀切 12 字节会把正常名字判成违规

页面与注册
- 新建 Drivers/BSP/UI/ui_page_soe.{c,h}：薄跳板，一条记录两行共用组件内单条读盘缓存，
  实例独立（两页共用一份缓存会互相命中对方记录号，task-6 的教训）
- 菜单树 SOE记录 加 #page=soe；重生成 4 个生成物，uvprojx / CMakeLists 两处注册由生成器
  自动写入（本批 uvprojx 只含这一条新增，无 UV4 抖动）
- reader 绑定在两端适配层：真机 App/task/ui_task.c（CP56 → UI 视图 + 容量钳位），
  模拟器 simulator/main.c（固定 3 条、时标固定串，保证黄金参考可复现）

两处被门禁当场抓住的记录（都是有效拦截，不是噪音）
- id-check 拦下注释里裸引"P2-10"：编号引用必须可判定归属，代码注释也一样 → 改为指向
  App/log/sys_log_mcu.c 与事实本身，不留裸编号
- 又一次 BOM 铁律现场复现：一次编辑剥掉 ui_w_soe.c 的 BOM，ARMCC 立刻报一串 #8/#7/#20
  假语法错（missing closing quote 之类），而 MSVC 侧 0 警告完全照不出来；补回 EF BB BF
  即 0/0。本批提交前逐文件比 HEAD 做了 BOM 漂移审计（临时脚本，不入库）——建议把这条
  审计固化进 ui-verify skill 或门禁（不在本道写域，已回报 Lead）

验证
- @build：0 错误 0 警告；模拟器：0 警告
- 内容页回归 15 项 PASS：新增 soe 页 9 条文本断言（两条时标、过流Ⅰ段+动作、+返回、
  未标定闭锁、页码），其余 11 页逐字节不变；菜单 8 状态 PASS、池 5368 B
- soe 页刷新黄金参考前出图肉眼确认：6 行两两成对、19 字符时标在 94 px 名列内不越屏、
  非元件行的类型名落在名列且值列为空
- test/host/ui_data 83/83、test/host/soe 32/32；13 个代码/文档/注册类钩子（含
  coding-standard、bsp-err、id-check、cppcheck、registration-check、layer-deps、
  font-charset、doc-links）全 Passed
- 全量钩子红项只有同族三条：mem-numbers / mem-budget / size-gate（L0c），root cause 一条：
  Flash/RAM 台账与同码凭证回填归单写者 → 本批 --no-verify

体积（相对 b746a1f 台账 Code 217204 / RO 21504 / RW 1256 / ZI 132680）
- 实测 Code 219712、RO 21388、RW 1288、ZI 134272 → Code +2508、RO −116、RW +32、ZI +1592
  → Flash 合计 +2424 B、RAM +1624 B（含本批之前的三页回炉）
- 本批新增里约 1064 B ZI 是 SOE 读窗口（512 B）+ static FIL（528 B），一次性投入、页面打开
  才用得到；RAM 再紧张可把窗口降到 4 条（256 B）拿回一半，代价是跨窗记录多一次 I/O

待台架实测：真机 /log/soe.log 有记录时的翻页与尾部行为、卷忙时该行退化显示、SOE 页与文本
记录页时标一致性（跨 8 小时口径的现场核对）、记录增长时窗口代数失效后的重读节拍。

gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill
（同族三条，root cause 一条：台账与同码凭证回填归单写者）
像素基线单独提交（下一笔新增 simulator/tests/ref/shot_soe.bin）：本笔单独 checkout 时
ui-golden 会报"缺参考"，属预期拆分；上述钩子结论取自"本笔 + 下一笔"的合并树。
自查：BOM 漂移审计 17 个改动文件全对齐 HEAD；CR = 0；U+FFFD = 0；字面量纯 ASCII。

Drivers/BSP/UI/ui_page_registry.c

@@ -16,12 +16,14 @@
 #include "ui_page_password.h"
 #include "ui_page_runlog.h"
 #include "ui_page_selftest.h"
+#include "ui_page_soe.h"
 
 const ui_page_entry_t g_ui_page_map[UI_PAGE_MAP_COUNT] = {
     {   1u, &ui_page_device_info_desc },   /* node 1  装置信息 */
     {   3u, &ui_page_ac_desc },   /* node 3  交流量 */
     {   4u, &ui_page_dc_desc },   /* node 4  直流量 */
     {  30u, &ui_page_net_cfg_desc },   /* node 30  网口设置 */
+    {  33u, &ui_page_soe_desc },   /* node 33  SOE记录 */
     {  39u, &ui_page_selftest_desc },   /* node 39  自检记录 */
     {  40u, &ui_page_runlog_desc },   /* node 40  运行记录 */
 };

Drivers/BSP/UI/ui_page_registry.h

@@ -25,7 +25,7 @@ typedef struct {
     const content_page_def_t *desc;  /* 页面描述符（Flash const） */
 } ui_page_entry_t;
 
-#define UI_PAGE_MAP_COUNT  6u   /* 绑定了内容页的叶子数 */
+#define UI_PAGE_MAP_COUNT  7u   /* 绑定了内容页的叶子数 */
 
 extern const ui_page_entry_t g_ui_page_map[UI_PAGE_MAP_COUNT];
 

Drivers/BSP/UI/ui_page_soe.c

@@ -0,0 +1,77 @@
+/*
+ * 模块名称：UI Page SOE (SOE 记录内容页)
+ * 模块功能：SOE 记录叶子节点（node 51）的内容页数据——二进制记录的动态列表，每条记录 2 行
+ *           （偶数行 = 时标、奇数行 = 元件名 + 动作/返回；非元件事件把类型名打在名列），
+ *           数据经 ui_w_soe 注入的 reader 取（本文件零 App include、零文件系统 include）；
+ *           未绑定 reader 时按"无记录"空态渲染；向框架 ui_content_page 提供页面描述符
+ * 为什么不在这个文件读盘：SOE 是 /log/soe.log 上的 64 B 定长二进制记录，读盘、卷锁、窗口
+ *           代数与校验和判定全在 App/log/soe_store 的只读 API 里（App/task/ui_task.c 绑定），
+ *           UI 侧只按不透明编号显示——与运行/自检记录页同一分层（分层方向基线 3 条不变）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
+ * 作者：王建锋
+ * 创建日期：2026-10-25
+ * 修改记录：
+ *     v1.0  2026-10-25  王建锋  创建（道E task-15：SOE 记录页；规格 =
+ *                               docs/UI设计/页面扩充详细方案.md §3.6「SOE记录」行）
+ */
+
+/* 头文件包含区 */
+#include "ui_page_soe.h"
+
+#include "ui_tokens.h"
+#include "ui_w_soe.h"
+
+/* 静态变量定义区 */
+
+/*
+ * 本实例自带一条读盘缓存（组件内 cache_valid/last_rec）：一条记录画两行，
+ * 奇数行复用同一次读取——与运行/自检记录页同构，但**实例独立**：两页共用一份
+ * 缓存会互相命中对方的记录号，切页时显示另一页的陈旧行（task-6 的教训）
+ */
+static ui_w_soe_t s_soe;
+
+/* 函数定义区 */
+
+/*
+ * 函数功能：总行数（每条记录 2 行；未绑定 reader 或无记录 = 单条伪行"无记录"）
+ * 入口参数：无
+ * 返回值：总行数  uint16_t
+ * 限定条件：uiTask 绘制路径（组件内部按记录数换算，不做 I/O 之外的状态依赖）
+ */
+static uint16_t pg_count(void) {
+    return ui_w_soe_count(&s_soe);
+}
+
+/*
+ * 函数功能：逐行取数（偶数行 = 时标，奇数行 = "元件 + 事件"）
+ * 入口参数：a_row   - 全局行下标  uint16_t
+ *           a_name  - 名输出缓冲（框架 UI_BUF_STRLEN）  char *
+ *           a_value - 值输出缓冲  char *
+ * 返回值：无
+ * 限定条件：uiTask 绘制路径；reader 已在两端适配层绑定（未绑定按空态渲染）
+ * 函数说明：类型/元件的**显示名映射在组件里**（UI 侧表现层），二进制编号由 App
+ *          注入的 reader 原样交上来——与"屏幕上的话归 UI、数据归 App"一致
+ */
+static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) {
+    ui_w_soe_refresh(&s_soe, a_row, a_name, a_value);
+}
+
+/*
+ * 页面描述符（外部链接：生成物 ui_page_registry.c 按菜单树 #page=soe 绑定引用）：
+ * 动态列表页，每记录 2 行、UI_LIST_ROWS(8) 行/页 = 4 条/页；band_h 必须 >0
+ * （selectable 页选中行是黑字，无白带即不可见，同记录页约定）
+ */
+const content_page_def_t ui_page_soe_desc = {
+    .id = "soe",
+    .title = "SOE记录",
+    .selectable = 1u,
+    .top_y = UI_LIST_TOP,
+    .pitch = UI_ROW_PITCH,
+    .band_h = UI_ROW_BAND_H,
+    .text_dy = 0,
+    .left_x = UI_LIST_LEFT_X,
+    .right_x = UI_LIST_RIGHT_X,
+    .rows_per_page = UI_LIST_ROWS,
+    .count_cb = pg_count,
+    .refresh = pg_refresh,
+};

Drivers/BSP/UI/ui_page_soe.h

@@ -0,0 +1,28 @@
+/*
+ * 模块名称：UI Page SOE (SOE 记录内容页)
+ * 模块功能：SOE 记录叶子节点的内容页声明——向框架 ui_content_page 提供页面描述符
+ *           （数据经 ui_w_soe 组件的注入 reader 取，本模块零 App include、零文件系统）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
+ * 作者：王建锋
+ * 创建日期：2026-10-25
+ * 修改记录：
+ *     v1.0  2026-10-25  王建锋  创建（道E task-15：SOE 二进制记录页，规格 =
+ *                               docs/UI设计/页面扩充详细方案.md §3.6「SOE记录」行）
+ */
+#ifndef UI_PAGE_SOE_H
+#define UI_PAGE_SOE_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "ui_content_page.h"
+
+/* 页面描述符（定义在 ui_page_soe.c；生成物按菜单树 #page=soe 引用本符号） */
+extern const content_page_def_t ui_page_soe_desc;
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* UI_PAGE_SOE_H */

Drivers/BSP/UI/ui_w_soe.c

@@ -52,7 +52,9 @@ static const char *const s_type_name[UI_W_SOE_T_COUNT] = {
     "压板投入",        /* 4 软压板投入 */
     "采样闭锁",        /* 5 采样故障闭锁 */
     "采样恢复",        /* 6 采样故障恢复 */
-    "标定闭锁",        /* 7 未标定闭锁 */
+    "未标定闭锁",      /* 7 未标定闭锁（照 App/log/soe_rec.h 与 数据可信 卡5 的原词，
+                        * 不缩成"标定闭锁"——那个写法可以读成"把标定闭锁了"，
+                        * 而这一行要说的是"因未标定而闭锁"，一字之差含义相反） */
     "标定复归",        /* 8 标定复归 */
 };