Files

T

wandering1 dc214e1426 docs(UI): 内容页黄金参考当前态改报「60 张」，三数按双源实测同步

三数实测真值（每项两个独立来源互证）：
- 张数 60：simulator/tests/ref/ 入库 shot_*.bin 实数 60 ＝
  check_content_pages.py 的 PAGES 条目数 60（id 逐一对齐）。
- 已绑 28 叶 / 未绑 5 叶：ui_page_registry.h 的 UI_PAGE_MAP_COUNT 28 ＝
  ui_menu_tree.txt 剔掉文件头注释示例行后的 #page= 实数（不剔是 29）。
- 字体 218 唯一字 / 313 字形：ui_cn_chars.txt 唯一码点 218（ASCII 区 0
  个，ASCII 0x20~0x7E 由生成器子集参数另计、不算进字数）；
  ui_font_cn_12.c 的 .bitmap_index 条目 314 条含 notdef，剔掉 notdef →
  313 = 218 + ASCII 95。

口径更正（数字一律不动）：当前态计数单位由「页」改报「张」——张数 =
页面个数 + 分页页多拍的第 2 屏（runreport_p2 / sparam_p2 两张），两个数
不许互相冒充。同日先前那行「53 → 59 页」是页面个数口径、与判据本体
不同源，原文冻结不回改，只在各文件变更记录末行追加当日更正。

历史一律冻结：变更记录里的 27 / 40 / 47 / 53→60 / 59 与字库 122/217、
179/274、185/280、183/278 都是当日快照，只追加、不回改。

夹带说明：.pre-commit-config.yaml 一并入本笔——pre-commit 要求配置本身
已 staged 才允许提交；该文件的改动是 ui-golden 显示名（60 页→60 张）与
一条钩子计数口径注释（同日 51 → 52 → 51 净零，属另一类，已在此点名）。

2026-10-28 15:33:42 +08:00

1.7 KiB

Raw Blame History

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 单色打包

使用方式

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

1.7 KiB Raw Blame History Unescape Escape

simulator/tests/ — UI 模拟器无头回归测试

文件一览

使用方式

⚠️ 注意

相关文档

1.7 KiB

Raw Blame History