# 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） |

## 使用方式

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

## 相关文档

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