merge: task/ui-golden-ui-golden-ref 合入 v2-on-ui

任务 ui-golden（1 个提交）经 task-worktree 回收：
- chore(ui-golden): 像素黄金参考 ref/*.bin 入库（把门禁改成可移植）

docs/环境与部署/项目部署环境要求.md

@@ -360,8 +360,7 @@ pre-commit run --all-files          # 首次全库基线扫描
 & "simulator\build_sim.bat"                                      # 模拟器一键构建（自动探测 VS 版本），0 警告
 .\simulator\build\Debug\lvgl_sim.exe                             # 出 160×160 单色菜单画面
 & '.venv\Scripts\python.exe' simulator\tests\check_menu_rows.py           # PASS
-& '.venv\Scripts\python.exe' simulator\tests\check_content_pages.py --update  # 首次生成参考图
-& '.venv\Scripts\python.exe' simulator\tests\check_content_pages.py       # 再跑 → PASS
+& '.venv\Scripts\python.exe' simulator\tests\check_content_pages.py       # PASS（基准 ref/*.bin 已入库，无需先生成）
 & '.venv\Scripts\python.exe' .dsh\skills\serial-assistant\scripts\serial_tool.py selftest     # → SELFTEST PASS
 & '.venv\Scripts\python.exe' test\host\watchdog\run_unit_test.py            # 主机侧单测 → 39/39 PASSED（退出码 0）
 pre-commit run --all-files
@@ -615,7 +614,7 @@ $env:DTU_KEIL_UV4 = 'D:\NotExist\UV4.exe'   # 仅当前会话，不动用户级
 | `.venv` 不存在 / 脚本 ModuleNotFound | venv 未建（不入库） | 按 §2.4 重建 + `pip install -r requirements.txt` |
 | pip 装依赖报 UnicodeDecodeError | `requirements.txt` 含中文注释 | 保持该文件**纯 ASCII**（pip 按 GBK 代码页解码） |
 | 字体生成 / 转 PNG 报缺模块 | 误用 PATH 里的 msys64 python | 一律用 `.venv\Scripts\python.exe` |
-| 内容页回归 exit 2（参考缺失） | `tests/ref/` 是本地生成物、不入库 | 先 `check_content_pages.py --update` 生成参考，再跑回归 |
+| 内容页回归 FAIL「缺黄金参考」 | `ref/*.bin` 已入库 → 缺失 = 检出不完整（被手工删过 / 不完整的 worktree 副本），**不是**"首次运行" | `git checkout -- simulator/tests/ref/` 取回基准；**不要**用 `--update` 就地造基准（那等于把当前渲染固化成基准） |
 | 串口采集不到 / 端口占用 | COM 号变化 / 上一进程未释放 | 改 `.serialtest/config.json`；`serial_tool.py ports` 查实际端口，`open` 占用 ≤1s 报 `port busy` |
 | 烧录失败 | 下载器未选 / USB 驱动缺失 | Keil `Options for Target → Debug` 选对驱动；安装下载器 USB 驱动 |
 | 下载报 Flash 算法 / FLM 文件找不到 | 未安装 `Keil::STM32F4xx_DFP` pack（FLM 来自 pack 目录，不在仓库） | Pack Installer 安装该 pack 后重新下载 |
@@ -669,3 +668,4 @@ $env:DTU_KEIL_UV4 = 'D:\NotExist\UV4.exe'   # 仅当前会话，不动用户级
 | 2026-09-13 | 补 STM32CubeMX 6.17.0 + STM32Cube FW_F4 V1.28.3（与 .ioc 一致）：拓扑图 / §2.2 / 第 2 步 / §2.9 / 搭建清单，常见问题速查增加再生成版本不匹配条目 |
 | 2026-09-13 | 新增"Keil 初始化配置（机器侧项，非项目自带）"：license / Device Pack（含 FLM 来源解析路径）/ 下载器驱动，并列出项目自带免配置项；§六 速查补 FLM 缺失、license 过期两条 |
 | 2026-09-13 | 补 RAM/Flash 链接布局说明：手动 scatter 文件 `STM32F407-Demo.sct`（在仓库）为链接依据（128KB = SRAM1+SRAM2，SRAM3/CCM 未映射），新机器无需重设、勿改 GUI Target 页 |
+| 2026-10-22 | 换机自检去掉「首次须 `--update` 生成参考图」一步（`simulator/tests/ref/*.bin` 已入库，检出即带基准）；排障表「内容页回归参考缺失」一行改为按"检出不完整"处置（`git checkout -- simulator/tests/ref/`，禁止就地 `--update` 造基准） |