STM32F4-Base/.opencode/skills/ui-verify/SKILL.md

name, description

name	description
ui-verify	UI 改动后的回归验证：5 步门禁（模拟器构建、菜单像素回归、内容页黄金参考、Keil 构建、代码规范）。Use whenever code under Drivers/BSP/UI, 字体 ui_font_cn_12.c / ui_cn_chars.txt、菜单/内容页被修改，或用户要求"验证 UI / 跑 UI 回归 / UI 改动检查"。

UI 回归验证

UI 相关改动完成后必须跑完 5 个门禁再提交。完整说明见 docs/UI设计/UI_自动化测试流程.md。

步骤（仓库根目录执行，python 一律用 .venv）

cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警告）
.venv\Scripts\python.exe simulator/tests/check_menu_rows.py      # 1) 菜单 8 状态像素回归 + 池基线门禁
.venv\Scripts\python.exe simulator/tests/check_content_pages.py  # 2) 内容页黄金参考回归 + 往返池门禁
& "MDK-ARM\build.bat"                          # 3) Keil 构建（BUILD_OK，0 错 0 警）
.venv\Scripts\python.exe scripts/check_coding_standard.py        # 4) 代码规范检查（PASS）

退出码：0=PASS / 1=断言失败 / 2=环境错误（exe 缺失等，先按 AGENTS.md 重建对应环境再重跑）。

失败处置决策

现象	判定	处置
内容页 FAIL，且有意改了该页视觉	预期变化	先肉眼确认新效果正确（窗口模式或 i1_to_png.py 出图对照 mockup），再 .venv\Scripts\python.exe simulator/tests/check_content_pages.py --update 刷参考，git diff 检查 ref/ 变化后随代码提交
内容页 FAIL，但未有意改视觉	bug（缺字/几何漂移/样式回归）	修代码；禁止刷参考掩盖
池水位门禁失败但像素一致	结构/样式变更（常量样式转换、增删框体等）	确认新值合理（残留分解见 菜单页面设计.md §9.5）→ 更新脚本常量 + 在流程文档变更记录登记
菜单回归失败	结构断言（白带占比/边框/往返一致）	按脚本打印的未过断言清单逐项修代码，无参考文件可刷

池水位门禁常量（在脚本头部）

常量	脚本	当前值	含义
MENU_POOL_BASELINE	check_menu_rows.py	4784 B	菜单根框建完的 LVGL 池 used（x64 模拟器）
POOL_AFTER_ROUNDTRIP	check_content_pages.py	4864 B	开页-关页往返后 = 基线 + 80 B 一次性残留

禁止为过门禁盲目改常量——无法解释的漂移 = 内存回归 bug。

关联注意

• .venv 缺失/换机：& <本机任一 python ≥3.10> -m venv .venv; & '.venv\Scripts\python.exe' -m pip install -r requirements.txt（requirements.txt 已含 pre-commit，重建后 L0 门禁直接可跑）
• 新增 UI .c 文件先走 new-source-file skill 双端注册，否则一端静默缺文件
• 字体重生成后全页大面积像素差异属预期：确认字形正确后 --update 刷参考
• 涉及新界面/大改时本 skill 是 P3 门禁，完整管线（P0~P5）见 docs/UI设计/UI_界面制作流程.md