STM32F4-Base/simulator/tests

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	重建黄金参考：UI 有意变更后，重新生成基准图
ref/	黄金参考图（基准 PNG）

使用方式

# 跑回归（按 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 固化成"基准"
• UI 改动一律走 ui-verify skill 五步门禁（regression 是其中一步）
• 依赖模拟器已构建（simulator/build_sim.bat）

相关文档

• docs/UI设计/UI_自动化测试流程.md — ui-verify 五步门禁
• docs/UI设计/LVGL模拟器部署与使用说明.md