Files
STM32F4-Base/simulator/tests
wandering1 9bd7ff96d3 test(ui-golden): 新增四个定值查看页像素参考
随上一笔(参数/定值/控制字/软压板四个查看页)落第 13~16 页黄金参考;本笔只有判据文件,
页面键序列与逐行文本断言已在上一笔同批改入 check_content_pages.py。

数据源与可复现性
- 值全部来自 simulator/main.c 发布的 par 帧:prot_set 出厂默认(App/algo/prot_set.c 是纯算法,
  双端可编),不是手抄的 40 个数字——手抄一次就多一份会漂移的第二真相
- 因此这四张基线同时也是换算口径的判据:10.00A / 500ms / 0.95 / 100A 这些串由 ui_w_setview
  的 Q10 拆分换算产出,换算改了没改对,像素这一步就会响

刷新纪律(黄金参考是判据不是快照:版面错了就等于把错误钉死)
- 先让 39 条文本断言过(名/值两列逐行断),拦住缺字与错标签,再回退比对像素
- 四页出图逐张肉眼确认:值列右缘不越屏(最宽 10000V)、名值两列不重叠、行槽不与页脚相撞、
  分页正确(定值 18 行 = 3 页并显示「第 1 页,共 3 页」;软压板 10 行 = 2 页)
- 一处肉眼读错被匹配器纠正:CT 一次额定我读成 1000A,值列实际只有 4 个字符位(100A)。
  断言按匹配器能证明的写,不按我觉得像什么写
- 控制字页断言刻意含「Ⅰ/Ⅱ 段跳闸、Ⅲ/过负荷段告警」这种两两一组:行表与枚举序若整体错位,
  就不可能复现这个组合——像素侧因此兼作 id 对齐的机械证据

回归面
- 其余 12 页(密码 4 态 / 网口设置 4 态 / 装置信息 / 交流量 / 直流量 / SOE)逐字节不变:
  这四页与它们共用同一套框架绘制与同一份 ui_w_setlist 骨架令牌,没连带漂移正好反证改动局部
- 内容页回归 19 项全 Passed;菜单 8 状态 Passed(池 5368 B,本批只多 4 条 #page 注记)
- ui-golden 钩子在含本笔的整树上 Passed;全量钩子(--all-files)红项只有同族三条
  mem-numbers / mem-budget / size-gate(台账与同码凭证回填归单写者)→ --no-verify

体积:本笔不参与固件构建,与上一笔一致(Code 221856 / RO 23508 / RW 1300 / ZI 134660)。

gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill
(同族三条,root cause 一条:台账与同码凭证回填归单写者)
2026-10-25 14:44:47 +08:00
..

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 像素黄金参考(入库):11 页 × 3200 B,160×160 单色打包

使用方式

# 跑回归(按 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