diff --git a/.gitignore b/.gitignore
index d87cd37a..7aae62f0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -120,9 +120,14 @@ simulator/SDL2/
 *.exe
 *.pdb
 *.ilk
-# 内容页黄金参考（ref/*.bin）与目检 PNG 均为本地生成物，不入库：
-# 首次/换机后先跑 check_content_pages.py --update 生成 ref/*.bin，再跑 regen_ref_png.py 出 PNG
-simulator/tests/ref/
+# 内容页像素黄金参考 ref/*.bin **已入库**（2026-10-22）：整目录不入库时，任何新克隆 /
+# 新工作树跑 ui-golden 都必然 FAIL（缺基准），这条像素回归就只在老机器上真实存在。
+# 交叉验证：两份各自独立构建的 lvgl_sim（不同构建目录、相隔 11 天的代码）对同一批 ref
+# 逐字节一致 → 渲染可复现，基线可入库。派生的目检 PNG 仍是本地产物，继续忽略：
+simulator/tests/ref/*.png
+# ⚠ 上面第 115 行的全仓 `*.bin` 兜底（挡模拟器的 sim_netcfg.bin 之类运行产物）会连入库的
+# 黄金参考一起挡掉 → 必须显式反选；反选只有排在 `*.bin` **之后**才生效（.gitignore 后者覆盖前者）
+!simulator/tests/ref/*.bin
 # 架构图 PNG 预览（源为 docs/images/*.svg，PNG 本地渲染生成，不入库）
 docs/images/*.png
 *.pyc
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index eddf27fa..c185f2e8 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -8,8 +8,15 @@ default_install_hook_types: [pre-commit, commit-msg]
 #   tests/*.py、两份配置与 README）。整目录豁免 = 自研代码落在所有钩子之外（连
 #   lv-conf-sync 都拦不到）；实测把 simulator/ 纳入 cppcheck 后，立刻揪出
 #   sim_syslog.c 一处真实的空指针解引用。真正的生成物/第三方（`simulator/build/`、
-#   `simulator/SDL2/`、`simulator/tests/ref/`、`simulator/shot*.{bin,png}`、`__pycache__/`）
-#   **已在 .gitignore 里**，永远不会进 git 索引 → 无需在此重复豁免，故直接删掉该条。
+#   `simulator/SDL2/`、`simulator/shot*.{bin,png}`、`__pycache__/`）**已在 .gitignore 里**，
+#   不会进 git 索引 → 无需在此重复豁免，故直接删掉该条。
+# ⚠ 例外（2026-10-22）：`simulator/tests/ref/*.bin`（ui-golden 的像素黄金参考）已从
+#   「整目录 gitignore」改为**入库**——基线不入库时任何新克隆 / 新工作树都必然报
+#   「缺黄金参考」，这条门禁就只在有老副本的机器上真实存在。入库前提是实测可复现：
+#   两份各自独立构建的 lvgl_sim（不同构建目录、相隔 11 天的代码）对同一批 11 个 .bin
+#   SHA-256 全部一致。改写型钩子（trailing-whitespace / end-of-file-fixer）声明
+#   `types: [text]`，位图含 NUL → 被判二进制自动 Skipped（实测「索引 blob == 磁盘 ==
+#   参照」三方一致），无需为它另加 exclude。
 exclude: |
   (?x)^(
     \.opencode/node_modules/|
@@ -509,7 +516,8 @@ repos:
       #     golden FAIL 且点名 `[dc] FAIL 与参考页不一致（1366 px 差异）`、退出码 1；还原后 diff 干净。
       #     ⚠ 两条 golden 按"整棵菜单树 + 全量参考图"工作、不接受文件参数，故包装器有意忽略
       #       argv 并 pass_filenames: false（pre-commit 传的变更名对它无意义）。
-      #     ⚠ 参考图 simulator/tests/ref/*.bin 是判据本身，改动它等于改判据——评审时必须盯紧，
+      #     ⚠ 参考图 simulator/tests/ref/*.bin 是判据本身，改动它等于改判据——它已入库，
+      #       评审时看 `git diff -- simulator/tests/ref` 必须逐页过目并在提交正文说明；
       #       任何时候都不得用 --update 刷基线来"让钩子变绿"。
       #     ⚠ pre-commit 4.x 无 `always: true` → files 必须覆盖所有能改变像素的触发面。
       #     ⚠ 已知瞬时现象：首次实测时在"连续注入/还原的紧邻重建"之间偶发失败一次，
diff --git a/docs/UI设计/UI_自动化测试流程.md b/docs/UI设计/UI_自动化测试流程.md
index a98320ae..ff876961 100644
--- a/docs/UI设计/UI_自动化测试流程.md
+++ b/docs/UI设计/UI_自动化测试流程.md
@@ -55,10 +55,15 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 `菜单页面设计.md` §9.5），再更新脚本常量并在本文变更记录登记。**禁止为过门禁盲目改常量**——
 无法解释的漂移 = 内存回归 bug。
 
-## 四、黄金参考与目检 PNG（均为本地生成物，不入库）
+## 四、黄金参考（入库）与目检 PNG（本地产物）
 
-`simulator/tests/ref/` 下的 `.bin`（像素黄金参考）与 `.png`（目检图）**都不入库**（`.gitignore`）——
-首次/换机后必须先生成一次：
+`simulator/tests/ref/*.bin`（像素黄金参考，11 页 × 3200 B）**随仓库入库**；派生的 `.png`
+目检图仍是本地产物（`.gitignore`）。入库的理由：比对是**逐字节**的，基线不入库时任何新克隆
+或新工作树跑 `ui-golden` 都必然 FAIL（缺基准），这条门禁就只在"有老副本的机器"上真实存在。
+可复现性实测（2026-10-22）：两份各自独立构建的 `lvgl_sim`（不同构建目录、相隔 11 天的代码）
+对同一批 11 个 `.bin` **SHA-256 全部一致** → 渲染是 CPU 侧确定性输出，基线可以进仓库。
+
+换机后**不需要**再生成基准；只有有意改视觉时才 `--update`（改动会进 `git diff`）：
 
 ```powershell
 .venv\Scripts\python.exe simulator/tests/check_content_pages.py --update   # 生成 ref/*.bin
@@ -73,7 +78,7 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 3. **重生成目检 PNG**：`.venv\Scripts\python.exe simulator/tests/regen_ref_png.py`。
    `.png` 是本地调试产物、**不会**随 `.bin` 自动更新——不重跑则 PNG 仍是旧渲染（缺字/错位，看似"乱码"）。
    默认 `--scale 6 --invert`（深字白底便于目检）；`--no-invert` = 白字黑底（与设备一致）；
-4. 无需提交 `ref/`（已 gitignore）。
+4. **提交 `ref/*.bin` 的改动**（它已入库，等于改基准）：`git diff --stat simulator/tests/ref` 必须
 
 **误刷保护**：`--update` 会**先跑文本级断言**，断言失败即中止，避免把缺字/错标签的渲染"刷成"新基准。
 
@@ -109,3 +114,4 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 | 2026-09-13 | 管线同步：`UI_界面制作流程.md` 移除 HTML 样机阶段（五阶段 → 四阶段 P0~P4），本文定位改为"P2/P3 门禁的可执行版本"；§六 关系描述更新为 P0 规格 → P1 编码 → P2 本文回归 → P3 上机目检 → P4 归档；移除 `tools/ui_mock/` 引用 |
 | 2026-10-11 | **裁剪 LVGL 死代码（F-1/F-2/F-3）时的门禁记录**：先用**未裁剪**配置 `--update` 生成 11 页黄金参考，再切到裁剪配置重编重跑 → **逐字节全部一致**（菜单 8 状态像素一致），证明裁剪零视觉影响。池水位门禁随之 5440/5520 → **5368/5448**（−72 B；一次性残留仍 80 B，故非泄漏变化，见 §三 水位历史）。顺带揪出并修掉 `Lib/lv_conf.h` 与 `simulator/lv_conf.h` 的**长期漂移**（模拟器早已 I1-only、MCU 端未裁）→ 规则见 `UI_设计架构.md` §1.4 第 10 条，量化见 `../内存管理/RAM使用分析与优化方案.md` §2.6.4 |
 | 2026-10-15 | **回归改为自洽运行（修 `netcfg_save` 假失败）**：`check_menu_rows.py` / `check_content_pages.py` 一律以**空临时目录当工作目录**跑 `lvgl_sim`（模拟器按 CWD 读写 `sim_config.ini`，残留档会改变页面内容）；`simulator/main.c` 的 `--cfgtest` 加外壳，**无论成败一律删除伪造的 4000 B 配置档**——旧行为连 PASS 路径也会留雷，之后每次 UI 回归的保存行都从 `OK` 变 `ERR`（引擎拒写超长文档，属正确行为）。脚本里"删 `sim_netcfg.bin` 残留"的旧兼容清理随之作废（旧档迁移 2026-10-10 已删），改为**只提示不删除**。修后 11 页 + 往返池水位 5,448 B 全过，**未刷任何黄金参考**；排查口径见 §五 |
+| 2026-10-22 | **`ref/*.bin` 像素黄金参考改为入库**（撤销 2026-09-10 的"整目录不入库"）：`.gitignore` 由忽略整目录收窄为只忽略 `ref/*.png`。动因是这条门禁不可移植——新克隆/新工作树里基准必然缺失，`ui-golden` 报「缺黄金参考」而不是回归结论；本仓实测两次同类踩坑（并行工作树里第一次跑必失败，只能现场 `--update` 造基准，而"现场造的基准"恰好失去意义）。入库前做了可复现性验证：主树（`ref/` 生成于 2026-10-11）与新工作树各自独立构建 `lvgl_sim`，11 个 `.bin` SHA-256 全部一致。§四 与"何时不该更新"随之改写：`--update` = 改基准，会进 `git diff`，须逐页过目并在提交正文说明 |
diff --git a/docs/UI设计/内容页架构.md b/docs/UI设计/内容页架构.md
index b6b4ef9d..bb00b409 100644
--- a/docs/UI设计/内容页架构.md
+++ b/docs/UI设计/内容页架构.md
@@ -457,7 +457,7 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
    （网口设置 4 态 + 密码页 4 态等）+ 开页-关页往返水位 → 3) Keil 构建 0 错 0 警 → 4) 代码规范检查
 - **门禁常量**（脚本头部）：`MENU_POOL_BASELINE = 4784 B`、`POOL_AFTER_ROUNDTRIP = 4864 B`
 - **失败处置**：像素不一致 = 代码 bug（修代码，**禁止**刷参考掩盖）；**有意**改视觉 →
-  先肉眼确认新效果正确，再 `check_content_pages.py --update` 刷参考（`ref/` 为本地生成物、不入库）
+  先肉眼确认新效果正确，再 `check_content_pages.py --update` 刷参考（`ref/*.bin` 已入库，刷了会进 diff，必须一并提交并说明）
 - 新增页面后同步在 `check_content_pages.py` 增加该页的按键序列、文本断言与参考图
 
 ## 九、变更记录
@@ -479,3 +479,4 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
 | 2026-09-10 | 网口设置页 MAC 值改常识格式 **`A4:94:B6:12:34:56`**（冒号分隔，17 字符 = 102px）；布局调整 名 x=6→4、值 x=60→54（MAC ink 止于 155，仍在白带 2..157 内）；编辑光标段偏移 MAC 2i→3i |
 | 2026-09-14 | 运行记录/自检记录动态列表页（`ui_page_runlog` / `ui_page_selftest`）：描述符新增 `count_cb` + `refresh`（开页/翻页时重读条数与内容，每条 2 行 = 时间戳/描述），数据源为 `App/log/sys_log` 引擎的 `/log/run.log`、`/log/selftest.log`；**框架不变量 selectable ⇒ band_h>0**——band_h=0 时选中行恒黑字无白带 → 黑底不可见（首版两页均踩中，改 band_h=13 对齐 AC/DC 约定）；新坑：本 LVGL 版本 `lv_text_get_width` length≠0 时无 NUL 检查，传 -1 越串尾死循环，必须传 strlen（密码页错误提示首版触发，已修并全库排查） |
 | 2026-09-15 | 网口设置页保存行改**异步交接**（P1-3 跨任务竞态修复，配置引擎属主 = defaultTask）：保存行 ENTER → `net_cfg_save_request()`（置"待保存"标志 + `SYS_EVT_CFG_SAVE` 唤醒属主任务，UI 不再直接触碰 cfg_file 引擎）；写盘与"立即应用"由 defaultTask 的 `net_cfg_save_run()` 执行（成功 → OK 并触发 `SYS_EVT_NET_RECONFIG` 免重启重建；失败 → ERR 不触发应用）；行值改随交接状态 `net_cfg_save_state()` 显示 ENTER/WAIT/OK/ERR（原为页面局部 `s_saved` 同步结果，删除）；无头自检（`--keys`）在注键后同步完成交接保持终态一致；五门禁全绿（像素/文本与改前一致，池水位不变） |
+| 2026-10-22 | §八 失败处置口径更新：`ref/*.bin` 黄金参考已入库，刷参考会进 `git diff`、必须随改动一并提交并说明理由（详见 `UI_自动化测试流程.md` §四） |
diff --git a/docs/架构设计/图形绘制流程.md b/docs/架构设计/图形绘制流程.md
index 4e286ec5..e86da4e0 100644
--- a/docs/架构设计/图形绘制流程.md
+++ b/docs/架构设计/图形绘制流程.md
@@ -119,7 +119,8 @@ sequenceDiagram
    & '.venv\Scripts\python.exe' -c "import cairosvg; cairosvg.svg2png(url='docs/images/RemoDispBus帧格式.svg', write_to='remo.png', scale=2)"
    ```
 
-> PNG 属**本地派生物、不入库**（与 `simulator/tests/ref/` 的参考图一致，`.gitignore` 已含 `*.png`）。
+> PNG 属**本地派生物、不入库**（与 `simulator/tests/ref/*.png` 目检图一致，`.gitignore` 已含
+> `*.png`；注意该目录下作为像素黄金参考的 `.bin` **是入库的**，别顺手一起忽略掉）。
 
 ---
 
@@ -140,3 +141,4 @@ sequenceDiagram
 | 2026-09-11 | 创建：统一图形绘制流程（选型 / SVG 生成器 / Mermaid / 约定 / 检查清单）；新增 `tools/arch_diagram/gen_frame_svg.py`（通用协议帧图）+ `docs/images/RemoDispBus帧格式.svg` |
 | 2026-09-11 | 新增专门配图目录 `docs/images/`：收拢 `docs/` 根与 `docs/UI设计/images/` 下 5 张 SVG；同步更新 3 个生成器 OUT 路径、4 处文档图片引用、`AGENTS.md` 与 `.gitignore`（PNG 预览规则）；流程沉淀为 `draw-diagram` skill |
 | 2026-09-11 | 存量 ASCII 框图清理：`STM32F4-Base存储架构说明.md` 两图（存储栈分层 / 物理分区布局）重绘为 SVG（生成器家族新增 `gen_storage_stack_svg.py` / `gen_partition_svg.py`）；`RemoDispBus协议与接收设计说明.md` 删 ASCII 帧图（SVG 帧格式图已在，信息无损失）；`测试说明/CH395F_Test_Guide.md` 4 图（2 组件架构 + 2 会话时序）转 Mermaid |
+| 2026-10-22 | 澄清 §派生物一句：`simulator/tests/ref/` 下作为像素黄金参考的 `.bin` 已入库，只有派生的 `.png` 目检图仍不入库（原表述把两者混为"参考图不入库"，会诱导后来者把整个目录继续忽略掉） |
diff --git a/docs/测试说明/测试开发标准流程.md b/docs/测试说明/测试开发标准流程.md
index fca9c53b..ba934c56 100644
--- a/docs/测试说明/测试开发标准流程.md
+++ b/docs/测试说明/测试开发标准流程.md
@@ -378,8 +378,8 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 
 ### 5.3 黄金参考与字体纪律
 
-- `simulator/tests/ref/`（`.bin` 参考 + `.png` 目检图）**不入库**：首次 / 换机先 `check_content_pages.py --update` 生成；
-- `--update` 有**误刷保护**（先跑文本层断言，失败即中止）——**未有意改视觉而 FAIL = bug，修代码，禁止刷参考掩盖**；
+- `simulator/tests/ref/*.bin`（像素黄金参考）**入库**（2026-10-22 起，新克隆即可跑回归；跨独立构建目录逐字节可复现已实测）；派生的 `.png` 目检图仍不入库；
+- `--update` 有**误刷保护**（先跑文本层断言，失败即中止）——**未有意改视觉而 FAIL = bug，修代码，禁止刷参考掩盖**；基线入库后刷参考会在 `git diff` 里显形，必须逐页过目并在提交正文说明；
 - 刷新参考后必须重跑 `regen_ref_png.py` 重生成目检 PNG（否则旧 PNG 看似乱码）；
 - 门禁常量漂移：先确认新值合理（残留分解见 `菜单页面设计.md` §9.5）→ 更新常量 + 在 `UI_自动化测试流程.md` 变更记录登记；
 - **UI 新增中文文案提交前必须先跑 font-regen**（extract_cn → make_font → diff 检查）：字符集 `ui_cn_chars.txt` 缺字则上机显示空白——**2026-10-15 起该约定已入门禁**（`font-charset` 钩子：源码在用字符 ∉ txt 或 txt ∉ 字体 cmap → 提交 FAIL，详见 `../代码规范/pre-commit使用说明.md` §2.24）。
@@ -640,3 +640,4 @@ CI 就静默停摆（2026-10-11 实测 run 16~21 共 12 个 job 零日志）。
 | 2026-10-01 | §4.2 补 **L0.5 环境要求表**（MSVC `cl.exe` = 装了 VS 即有、与模拟器共用；Windows SDK；纯标准库 Python；缺失时退出码 2 且 pre-commit 钩子拦截）+ "不调 `vcvars64.bat`（`reg.exe` 受限）"原因说明；§4.1 工具清单标注该运行器需 VS。同步更新 `../环境与部署/项目部署环境要求.md`（§2.3 / §2.7 / 第 3、10 步 / 清单 / 下载表 / 速查表） |
 | 2026-09-15 | §3.4 更新：P1-6 修复落地（基础线程策略）——USER CODE 区冗余 netTask 创建删除 + `net_task_func` 入口 `ENABLE_HW_LAYER_TESTS` 自挂起守卫；"代码事实/设计约束"按修复后现状重写（硬件层模式中断断言恢复安全、NET 层/产品仍按"netTask 恒在轮询"设计）；彻底方案（`.ioc` 移除）经评估未采用。同日构建验证发现两处**存量**测试固件缺陷（与 P1-6 无关，A/B 对照确证）：① `net_test_task.c` `s_rx_buf` 使用先于声明 → NET 层配置自 2026-08（88160a5）起不可编译；② 128KB 静态 RAM 预算溢出（产品镜像 123.6KB，HW 全阶段固件超 8.7KB、NET 固件超 ~28KB）——已立 P1-9/P1-10 跟踪 |
 | 2026-09-13 | 重写：对齐现测试架构——统一 `test_config.h` 套件（旧版仅描述 CH395F 单套件与 `ch395fTestTask` 旧入口）；新增 @test 自动化闭环、pre-commit 门禁、UI 模拟器五步门禁、主机侧工具约定；新增"测试构建下 netTask"已知问题（旧版"硬件层模式 netTask 不创建"表述与代码不符，改为设计约束并给出重构路径）；修正附录路径（旧版 `docs/测试说明/CH395F_Test_Guide.md` 等已移入 `docs/测试说明/`）；新增双端注册、内存预算、陷阱沉淀要求 |
+| 2026-10-22 | §5.3 黄金参考纪律更新：`ref/*.bin` 入库（新克隆即可跑 UI 像素回归）、`.png` 仍不入库；补充"刷参考会在 `git diff` 显形，须逐页过目并在提交正文说明" |
diff --git a/docs/环境与部署/项目部署环境要求.md b/docs/环境与部署/项目部署环境要求.md
index a744e3ba..b9d3c551 100644
--- a/docs/环境与部署/项目部署环境要求.md
+++ b/docs/环境与部署/项目部署环境要求.md
@@ -356,8 +356,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
@@ -613,7 +612,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 后重新下载 |
@@ -666,3 +665,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` 造基准） |
diff --git a/simulator/tests/README.md b/simulator/tests/README.md
index b49739fd..8757f24c 100644
--- a/simulator/tests/README.md
+++ b/simulator/tests/README.md
@@ -10,8 +10,8 @@
 | `check_menu_rows.py` | **菜单像素回归**：渲染菜单行 → 与黄金参考比对 |
 | `check_content_pages.py` | **内容页回归**：各内容页渲染比对 |
 | `check_remo_sink.py` | **推流（RemoDispBus）回归**：接收端渲染比对 |
-| `regen_ref_png.py` | **重建黄金参考**：UI 有意变更后，重新生成基准图 |
-| `ref/` | 黄金参考图（基准 PNG） |
+| `regen_ref_png.py` | 由 `ref/*.bin` 批量出**目检 PNG**（不产生基准；基准由 `check_content_pages.py --update` 刷） |
+| `ref/*.bin` | **像素黄金参考（入库）**：11 页 × 3200 B，160×160 单色打包 |
 
 ## 使用方式
 
@@ -27,6 +27,8 @@
 ## ⚠️ 注意
 
 - **重建黄金参考前必须确认变更是有意的**——否则会把 bug 固化成"基准"
+- `ref/*.bin` 已入库：刷参考 = 改基准，`git diff` 里会显形，提交正文必须写明为什么变
+- `ref/*.png` 只是给人看的派生物（已忽略），刷完 `.bin` 要重跑 `regen_ref_png.py` 才对得上
 - UI 改动一律走 **`ui-verify` skill 五步门禁**（regression 是其中一步）
 - 依赖模拟器已构建（`simulator/build_sim.bat`）
 
diff --git a/simulator/tests/check_content_pages.py b/simulator/tests/check_content_pages.py
index 8fe3b872..4952433f 100644
--- a/simulator/tests/check_content_pages.py
+++ b/simulator/tests/check_content_pages.py
@@ -5,9 +5,10 @@ check_content_pages.py — 叶子内容页像素黄金参考回归 + 文本级
 
 用法：
     python simulator/tests/check_content_pages.py            # 文本断言 + 与本地黄金参考逐字节比对
-    python simulator/tests/check_content_pages.py --update   # 有意改视觉后刷新本地黄金参考
+    python simulator/tests/check_content_pages.py --update   # 有意改视觉后刷新黄金参考（改动会进 diff）
 前置：simulator 已构建（build/Debug/lvgl_sim.exe 存在）；纯标准库，任意 python3。
-      ref/*.bin 为**本地生成物、不入库**（.gitignore）：首次/换机后须先 `--update` 生成一次。
+      ref/*.bin 是**入库的像素黄金参考**（2026-10-22 起）：新克隆直接可跑，无需先生成。
+缺失 = 工作树不完整（`git checkout -- simulator/tests/ref/`），不是"首次运行"。
 
 原理：① 文本级断言——解析 ui_font_cn_12.c 字形，把期望字符串（标题/标签/值/页脚）在截图
       对应 y 带内做精确匹配；不依赖 ref/，先于像素比对运行，失败即中止（防误刷参考）。
@@ -17,6 +18,7 @@ check_content_pages.py — 叶子内容页像素黄金参考回归 + 文本级
 2 个菜单框回根框，完全还原初始态）后 used 须等于 POOL_AFTER_ROUNDTRIP。
 
 黄金参考更新流程（有意改视觉时）：先肉眼看图确认新效果正确，再 --update 刷新，
+刷新即改基准 → `git diff --stat simulator/tests/ref` 必须逐页过目并在提交正文说明；
 最后 regen_ref_png.py 重生成目检 PNG；误报排查见 docs/UI设计/UI_自动化测试流程.md。
 
 退出码：0 全 PASS；1 文本断言失败/有页不一致/池水位漂移；2 运行/环境错误（exe 缺失、参考缺失）。
@@ -310,7 +312,8 @@ def main():
             continue
 
         if not ref.exists():
-            print("FAIL: 缺黄金参考 %s（首次/换机后请加 --update 生成；ref/ 不入库）" % ref)
+            print("FAIL: 缺黄金参考 %s（ref/*.bin 已入库：缺失说明工作树不完整，"
+          "跑 git checkout -- simulator/tests/ref/ 取回，不要用 --update 造基准）" % ref)
             shutil.rmtree(tmp, ignore_errors=True)
             return 2
         refdata = ref.read_bytes()
diff --git a/simulator/tests/ref/shot_ac.bin b/simulator/tests/ref/shot_ac.bin
new file mode 100644
index 00000000..ba2953f9
Binary files /dev/null and b/simulator/tests/ref/shot_ac.bin differ
diff --git a/simulator/tests/ref/shot_dc.bin b/simulator/tests/ref/shot_dc.bin
new file mode 100644
index 00000000..33d8060c
Binary files /dev/null and b/simulator/tests/ref/shot_dc.bin differ
diff --git a/simulator/tests/ref/shot_info.bin b/simulator/tests/ref/shot_info.bin
new file mode 100644
index 00000000..e5a2263c
Binary files /dev/null and b/simulator/tests/ref/shot_info.bin differ
diff --git a/simulator/tests/ref/shot_netcfg.bin b/simulator/tests/ref/shot_netcfg.bin
new file mode 100644
index 00000000..3a01afea
Binary files /dev/null and b/simulator/tests/ref/shot_netcfg.bin differ
diff --git a/simulator/tests/ref/shot_netcfg_edit.bin b/simulator/tests/ref/shot_netcfg_edit.bin
new file mode 100644
index 00000000..6a11dd31
Binary files /dev/null and b/simulator/tests/ref/shot_netcfg_edit.bin differ
diff --git a/simulator/tests/ref/shot_netcfg_ro.bin b/simulator/tests/ref/shot_netcfg_ro.bin
new file mode 100644
index 00000000..3a01afea
Binary files /dev/null and b/simulator/tests/ref/shot_netcfg_ro.bin differ
diff --git a/simulator/tests/ref/shot_netcfg_save.bin b/simulator/tests/ref/shot_netcfg_save.bin
new file mode 100644
index 00000000..1ab99021
Binary files /dev/null and b/simulator/tests/ref/shot_netcfg_save.bin differ
diff --git a/simulator/tests/ref/shot_pwc.bin b/simulator/tests/ref/shot_pwc.bin
new file mode 100644
index 00000000..554fd06a
Binary files /dev/null and b/simulator/tests/ref/shot_pwc.bin differ
diff --git a/simulator/tests/ref/shot_pwd.bin b/simulator/tests/ref/shot_pwd.bin
new file mode 100644
index 00000000..4f9d222b
Binary files /dev/null and b/simulator/tests/ref/shot_pwd.bin differ
diff --git a/simulator/tests/ref/shot_pwe.bin b/simulator/tests/ref/shot_pwe.bin
new file mode 100644
index 00000000..4ddec694
Binary files /dev/null and b/simulator/tests/ref/shot_pwe.bin differ
diff --git a/simulator/tests/ref/shot_pwk.bin b/simulator/tests/ref/shot_pwk.bin
new file mode 100644
index 00000000..8e34eaa3
Binary files /dev/null and b/simulator/tests/ref/shot_pwk.bin differ
diff --git a/simulator/tests/regen_ref_png.py b/simulator/tests/regen_ref_png.py
index 475775fe..35754b6b 100644
--- a/simulator/tests/regen_ref_png.py
+++ b/simulator/tests/regen_ref_png.py
@@ -3,7 +3,8 @@
 """
 regen_ref_png.py — 由黄金参考 .bin 批量重生成目检用 PNG（simulator/tests/ref/*.png）。
 
-背景：ref/*.png 是本地目检调试产物（.gitignore 忽略），**不会**随 .bin 参考自动更新。
+背景：ref/*.png 是本地目检调试产物（.gitignore 忽略；入库的基准是同名 .bin），
+**不会**随 .bin 参考自动更新。
 刷过 `check_content_pages.py --update` 或改了字体/视觉后，必须重跑本脚本，否则 PNG
 仍是旧渲染（缺字/错位，看似"乱码"）。