wandering1
a5142c6d9d
- ui_content_page：描述符尾部追加 auto_ms/auto_seq 可选字段（缺省=0/NULL= 旧行为逐位不变）；页打开期间框架持一只 lv_timer，仅当发布序号变过才整页 失效（零空转失效），关页即销；新 API ui_content_page_auto_poll - ui_page_ac.c：.auto_ms=300（≥200ms 发布节拍、避 400=2×200 锁相、300= 15×20ms LVGL 整刷周期；最坏屏上滞后 500ms；完整取值账目在代码注释） - simulator：rt 帧装配收口 sim_fill_rt_frame（n=0 冻结帧保 74 张黄金逐字节 一致，n≥1 确定性斜坡）；新增 --rtlive 两态自检 + 窗口模式 200ms 节拍发布； check_content_pages.py 增 [rtlive] 零按键 A≠B 落屏断言 - docs/UI设计：供给说明新增 §5.5 自动刷新口径；内容页架构 §3.1/§四/§九 同步 （并修正 s_open 判定旧描述） - 台账：Keil 构建后按固定顺序回填（Code=256,588 / RW_IRAM1 +8B / UI +8B） 验证：模拟器 0错0警；菜单 8 状态 + 内容页 74 张 + rtlive（A≠B 30 字节）PASS （lead 独立复跑 RC=0）；Keil 0错0警；mem-budget --gate / mem-numbers --scan 绿。
simulator/tests/ — UI 模拟器无头回归测试
PC 端无头（headless）UI 像素回归测试：在模拟器中渲染各页面，与黄金参考图比对， 检测 UI 改动是否引入像素级回归。属于
ui-verifyskill 五步门禁的一部分。
文件一览
| 文件 | 作用 |
|---|---|
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 |
像素黄金参考（入库）：74 张 × 3200 B，160×160 单色打包（2026-10-29 录波 UI 道 +6 张；2026-11-04 SNTP 设置页 +8 张） |
使用方式
# 跑回归（按 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-verifyskill 五步门禁（regression 是其中一步） - 依赖模拟器已构建（
simulator/build_sim.bat）
相关文档
docs/UI设计/UI_自动化测试流程.md— ui-verify 五步门禁docs/UI设计/LVGL模拟器部署与使用说明.md