wandering1
94b0d79026
本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里， 拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）： 一、UI 补齐（清单清空） - 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk 复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存）， 记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面； ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签 （自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。 - 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用 boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据 （差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。 - 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28； 字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。 - 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言 425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录 （模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。 二、数据可信销项 + 「数据可信」任务卡号整族清退 - 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在 docs/硬件平台/ADC通道映射说明.md §8.1 与 docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。 - 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语， 代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。 这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。 验证（实测） - @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084； RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%， 体积同码凭证与 RAM 台账已回填。 - check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）； check_content_pages 60 页 rc=0；check_font_charset / registration / coding-standard / bom-drift / mojibake / doc-links --all / layer-deps / nested-comment 全 rc=0；check_ids --strict 无错误；主机单测 ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。 未做（不是遗漏） - 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、 拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1） 已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。 - docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含； 其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。
39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# simulator/tests/ — UI 模拟器无头回归测试
|
||
|
||
> PC 端**无头**（headless）UI 像素回归测试：在模拟器中渲染各页面，与**黄金参考图**比对，
|
||
> 检测 UI 改动是否引入像素级回归。属于 `ui-verify` skill 五步门禁的一部分。
|
||
|
||
## 文件一览
|
||
|
||
| 文件 | 作用 |
|
||
|---|---|
|
||
| `check_menu_rows.py` | **菜单像素回归**：渲染菜单行 → 与黄金参考比对 |
|
||
| `check_content_pages.py` | **内容页回归**：各内容页渲染比对 |
|
||
| `check_remo_sink.py` | **推流（RemoDispBus）回归**：接收端渲染比对 |
|
||
| `regen_ref_png.py` | 由 `ref/*.bin` 批量出**目检 PNG**（不产生基准；基准由 `check_content_pages.py --update` 刷） |
|
||
| `ref/*.bin` | **像素黄金参考（入库）**：60 页 × 3200 B，160×160 单色打包 |
|
||
|
||
## 使用方式
|
||
|
||
```bash
|
||
# 跑回归（按 ui-verify skill 流程）
|
||
& '.venv\Scripts\python.exe' simulator/tests/check_menu_rows.py
|
||
& '.venv\Scripts\python.exe' simulator/tests/check_content_pages.py
|
||
|
||
# UI 有意变更、确认无误后重建基准
|
||
& '.venv\Scripts\python.exe' simulator/tests/regen_ref_png.py
|
||
```
|
||
|
||
## ⚠️ 注意
|
||
|
||
- **重建黄金参考前必须确认变更是有意的**——否则会把 bug 固化成"基准"
|
||
- `ref/*.bin` 已入库：刷参考 = 改基准，`git diff` 里会显形，提交正文必须写明为什么变
|
||
- `ref/*.png` 只是给人看的派生物（已忽略），刷完 `.bin` 要重跑 `regen_ref_png.py` 才对得上
|
||
- UI 改动一律走 **`ui-verify` skill 五步门禁**（regression 是其中一步）
|
||
- 依赖模拟器已构建（`simulator/build_sim.bat`）
|
||
|
||
## 相关文档
|
||
|
||
- `docs/UI设计/UI_自动化测试流程.md` — ui-verify 五步门禁
|
||
- `docs/UI设计/LVGL模拟器部署与使用说明.md`
|