docs(计数): 内容页黄金参考 27 → 40 全仓同源改写，含钩子显示名这最后一处不同码

UI 三页落地后机器真值变了，文档却还写着 27 页——这不是笔误，是会骗人的现在时。作者（batch-auditor）先自己从机器面取数再动笔：git ls-files 里 ref/*.bin = 40、 PAGES 40 项、TEXTS 37 页 310 条、ABSENT 16 页 29 条、池 5448 B 与常驻堆 5368 B 未变、字库 183 字未扩。**它还纠了我一个数**：我报 ABSENT +19，实测 11 → 29 = +18；作者按实测写文档，并且不在文档里写 ABSENT 总数，免得把我这个差 1 的数固化成第二真源。改写面（现在时陈述，共 12 + 3 处）：AGENTS.md 的 ui-golden 半句、门禁说明 ui-golden.md （标题与「拦不住什么」段）与索引行、simulator/tests/README.md、simulator/README.md 两处、 UI_自动化测试流程.md（310 条 / 40 页 / PASS 文案 / 覆盖面）、内容页架构.md、页面补齐规划.md、主机单测覆盖率口径.md、自动化测试流程.md、测试开发标准流程.md，外加 .pre-commit-config.yaml 里 ui-golden 的显示名——那是「声明 / 文档 / 实跑」三数同源的最后一处不同码：AGENTS 与门禁说明都已 40，配置里还写着 27。两条纪律作者都自证了，不是口头： · **历史数字一律保留**：8 处变更记录行里的 27 / 242 / 24 / 11 原样未改；两处带日期的验证记录只加限定语（「该下限此后已扩至 40 页，双次逐字节一致需按同口径重跑回填」），没有把 27 改成 40 去造连续性。 · **同名不同义的数字不许全局替换**：页面补齐规划.md:12 与 :157、页面扩充详细方案.md:649 里的「27」是**空叶子口径**，与黄金参考数无关——三处故意没动。这条比改对更值钱。 · 余量自证（回退名下 12 文件复跑同一扫描器）：refs +0 / dec +0 / und +0 / 比值 +0.00pp / 错误 +0，本笔零消耗，也未新增任何编号引用；simulator/tests/ref/ 下 40 个 .bin 零改动。闸线现状照实挂着：id-check 不可判定 1,162 / 上限 1,166，**余量只剩 4**（吃进者是今天 UI 那笔的注释引用，账在 Lead）。清账之前任何人新增编号都可能直接撞闸。
2026-10-27 00:16:07 +08:00
parent ac9ca33f0f
commit b24b2b5f31
13 changed files with 28 additions and 22 deletions
@@ -91,7 +91,7 @@

 ## 提交门禁（pre-commit）

- 任一失败即拦截，共 **50 个钩子**（**口径 = YAML 解析后的 hook 条目数**：自查命令与「声明 / 文档 / 实跑」三数同源核对见 `docs/门禁说明/README.md` §2 首条——⚠ 直接 grep 配置里的声明行会多算一条**注释掉的**候选钩子（= 51），不是口径；加一条钩子就同批改 AGENTS 与门禁索引两处计数。2026-10-25 道E 连加 `bom-guard` / `setview-check` / `uinav-selftest` 三条，2026-10-26 加 `generated-fresh` 一条；**每种门禁一篇详解（查什么 / 拦下过什么真事 / 限制与盲区 / 基线口径）→ `docs/门禁说明/README.md` 索引**；通用机制与整体口径 → `docs/代码规范/pre-commit使用说明.md`）：通用 5 + `gitlint` + `cppcheck` / `test-cppcheck` + `no-mojibake` + `coding-standard` + 文档三件套 `doc-links` / `task-table` / `mem-numbers` + `id-check`（**编号门禁**，`docs/编号规范.md` §8 八项校验；**已关闸为【增量拦截】**：只拦 `scripts/id_known_backlog.json` 台账之外的新错误级问题，存量按指纹豁免、台账只减不增；另有一根恒生效的线——可判定比例跌破 `id_registry.json` 基线即失败；**2026-10-26 方案 B 同批加了第二根**：不可判定引用**绝对数**超过 `undecidable_total_ceiling` 即失败，因为比值会被"把可判定的引用改成散文"稀释（详见 `docs/门禁说明/id-check.md` §7.6））+ `lv-conf-sync`（两份 `lv_conf.h` 特性子集一致）+ `cubemx-survival` + 主机侧单测 **22 根专属钩子**（`-unit-test` 后缀 = 有独立 `files:` 触发面、需要秒级归因的那个子集；2026-10-25 增补 adc-cal / prot-dim / vol-idle-sync / ui-data / meas / run-par 六根）——**这是口径不是缺口**：`test/host/` 实测 40 套带 `run_unit_test.py`，其余 **18 套**（含 `test/host/ui_sink`）没有专属钩子，但每次提交都被 `test-coverage` 总闸全量真跑并守基线回退，**失败照样拦**，只是归因落在总闸输出上；**没有专属钩子 ≠ 没被跑**，18 套台账与补钩子的判据 → `docs/门禁说明/host-unit-tests.md` §6 第 4 条（原写「23 个 / 含 ui-sink 七个」是双重错：既把 22 说成 23，又宣称 ui-sink 有钩子——配置历史里 `ui-sink-unit-test` 从未存在）+ `test-coverage`（**覆盖率总闸**：跑全部 40 套并守基线回退；缺 mscoverage 组件时按用户裁定 **FAIL**、不 skip，2026-10-24）+ `test-suite-switch` + `registration-check`（双端注册反向校验 + UI 页面描述符表接线，登记簿条目「rs485_task 白名单缺口」）+ `generated-fresh`（**生成器幂等性**：把 `tools/menu_gen/gen_menu.py`、中文字库链、`tools/arch_diagram/gen_*.py` 拷进**系统临时目录**重跑，与工作区**逐字节**必须一致——钩子只读、不写仓库也不 stash 别人在飞的改动；实证 `0f7b5a87` 改了模板文字没重跑生成物，接线前实测另有 5 张 `docs/images/` 配图已漂 → 钉成只减不增基线，**业务生成物零豁免面** → `docs/门禁说明/generated-fresh.md`）+ `mem-budget`（RAM 92% 预算门禁，登记簿条目「缩堆迁 CCM 后半（暂缓）」）+ `font-charset`（UI 字符集差集检查，防缺字白框）+ `ui-golden`（UI 像素回归，菜单 8 状态 + 内容页 27 页黄金参考）+ `layer-deps`（**分层方向**：`Drivers/BSP/**` 不得 include `App/**` 的头；存量 3 条基线只减不增（2026-10-25 记录 reader 注入削掉 UI 记录 3 条边，6→3））+ `bsp-err`（**BSP 错误码与超时命名约定**：公开 API 不得拿 `HAL_StatusTypeDef`/`bool` 当错误通道、`*_TIMEOUT` 宏不得取负值、非 void 须写「返回值：」、**返回错误码的函数不得裸丢弃返回值**（须接住或显式 `(void)`；实测编译器与 cppcheck 都不报这类，只有这条会响）；约定正文 `Drivers/BSP/bsp_err.h`，存量基线只减不增（2026-10-23 首清点 19 条 → 已还 18；`consume-result` 上线又暴露 37 条存量丢弃 → **现 38 条**））
+- 任一失败即拦截，共 **50 个钩子**（**口径 = YAML 解析后的 hook 条目数**：自查命令与「声明 / 文档 / 实跑」三数同源核对见 `docs/门禁说明/README.md` §2 首条——⚠ 直接 grep 配置里的声明行会多算一条**注释掉的**候选钩子（= 51），不是口径；加一条钩子就同批改 AGENTS 与门禁索引两处计数。2026-10-25 道E 连加 `bom-guard` / `setview-check` / `uinav-selftest` 三条，2026-10-26 加 `generated-fresh` 一条；**每种门禁一篇详解（查什么 / 拦下过什么真事 / 限制与盲区 / 基线口径）→ `docs/门禁说明/README.md` 索引**；通用机制与整体口径 → `docs/代码规范/pre-commit使用说明.md`）：通用 5 + `gitlint` + `cppcheck` / `test-cppcheck` + `no-mojibake` + `coding-standard` + 文档三件套 `doc-links` / `task-table` / `mem-numbers` + `id-check`（**编号门禁**，`docs/编号规范.md` §8 八项校验；**已关闸为【增量拦截】**：只拦 `scripts/id_known_backlog.json` 台账之外的新错误级问题，存量按指纹豁免、台账只减不增；另有一根恒生效的线——可判定比例跌破 `id_registry.json` 基线即失败；**2026-10-26 方案 B 同批加了第二根**：不可判定引用**绝对数**超过 `undecidable_total_ceiling` 即失败，因为比值会被"把可判定的引用改成散文"稀释（详见 `docs/门禁说明/id-check.md` §7.6））+ `lv-conf-sync`（两份 `lv_conf.h` 特性子集一致）+ `cubemx-survival` + 主机侧单测 **22 根专属钩子**（`-unit-test` 后缀 = 有独立 `files:` 触发面、需要秒级归因的那个子集；2026-10-25 增补 adc-cal / prot-dim / vol-idle-sync / ui-data / meas / run-par 六根）——**这是口径不是缺口**：`test/host/` 实测 40 套带 `run_unit_test.py`，其余 **18 套**（含 `test/host/ui_sink`）没有专属钩子，但每次提交都被 `test-coverage` 总闸全量真跑并守基线回退，**失败照样拦**，只是归因落在总闸输出上；**没有专属钩子 ≠ 没被跑**，18 套台账与补钩子的判据 → `docs/门禁说明/host-unit-tests.md` §6 第 4 条（原写「23 个 / 含 ui-sink 七个」是双重错：既把 22 说成 23，又宣称 ui-sink 有钩子——配置历史里 `ui-sink-unit-test` 从未存在）+ `test-coverage`（**覆盖率总闸**：跑全部 40 套并守基线回退；缺 mscoverage 组件时按用户裁定 **FAIL**、不 skip，2026-10-24）+ `test-suite-switch` + `registration-check`（双端注册反向校验 + UI 页面描述符表接线，登记簿条目「rs485_task 白名单缺口」）+ `generated-fresh`（**生成器幂等性**：把 `tools/menu_gen/gen_menu.py`、中文字库链、`tools/arch_diagram/gen_*.py` 拷进**系统临时目录**重跑，与工作区**逐字节**必须一致——钩子只读、不写仓库也不 stash 别人在飞的改动；实证 `0f7b5a87` 改了模板文字没重跑生成物，接线前实测另有 5 张 `docs/images/` 配图已漂 → 钉成只减不增基线，**业务生成物零豁免面** → `docs/门禁说明/generated-fresh.md`）+ `mem-budget`（RAM 92% 预算门禁，登记簿条目「缩堆迁 CCM 后半（暂缓）」）+ `font-charset`（UI 字符集差集检查，防缺字白框）+ `ui-golden`（UI 像素回归，菜单 8 状态 + 内容页 40 页黄金参考）+ `layer-deps`（**分层方向**：`Drivers/BSP/**` 不得 include `App/**` 的头；存量 3 条基线只减不增（2026-10-25 记录 reader 注入削掉 UI 记录 3 条边，6→3））+ `bsp-err`（**BSP 错误码与超时命名约定**：公开 API 不得拿 `HAL_StatusTypeDef`/`bool` 当错误通道、`*_TIMEOUT` 宏不得取负值、非 void 须写「返回值：」、**返回错误码的函数不得裸丢弃返回值**（须接住或显式 `(void)`；实测编译器与 cppcheck 都不报这类，只有这条会响）；约定正文 `Drivers/BSP/bsp_err.h`，存量基线只减不增（2026-10-23 首清点 19 条 → 已还 18；`consume-result` 上线又暴露 37 条存量丢弃 → **现 38 条**））
 - **范围 = 项目代码**：第三方（`Lib/`、`Middlewares/`、CMSIS、HAL、`lftpd`、`dhara`、`MDK-ARM`）排除；`cppcheck`/`coding-standard` 另排除 `test/`，规范检查再排除 CubeMX 生成的 `Src/`/`Inc/`。**`simulator/` 已纳入全部钩子**（2026-10-11）——生成物只靠 `.gitignore` 挡，**不在 `exclude` 里写目录名**（教训见 `docs/代码规范/pre-commit使用说明.md` §5.5）
 - ⚠ **pre-commit 4.x 已移除 `always: true`**（实测对 `local` 钩子只告警 `Unexpected key(s)` 并跳过）→ 想"总是跑"的钩子**必须让 `files:` 覆盖到所有会触发它的文件**，没有兜底开关
 - **改写型钩子（`trailing-whitespace` + `end-of-file-fixer`）豁免 CubeMX/Keil 生成文件**（配置里 YAML 锚点 `&cubemx-generated`）；⚠ **只读检查不受影响**：`cppcheck` / 乱码 / `cubemx-survival` / `task-table` / `mem-numbers` 仍覆盖 `Src/`、`Inc/`
@@ -669,7 +669,7 @@ typedef struct {
 | 4 | 未标定时页面明确标识（不把码值当伏特） | 目检 + 文本断言（`eng=0` 时带标记） |
 | 5 | 首帧前显示 `--` 而非 `0.000` | 模拟器：不 publish 直接开页，断言文本 |
 | 6 | 定值整定全链闭环 | 就地改 → 保存 → 重启 → 值保持 + 校验和自检通过 + 主站 C_RD 一致。**半收口（2026-10-26）**：模拟器侧「改 → 保存 → OK → 回首屏新值已在帧里」已由像素 + 文本断言覆盖（黄金用例 `sparam_save` / `sparam_landed`，越界侧 `sparam_oob`）；**重启保持与主站 C_RD 一致只能上板**——模拟器没有 NAND，`apply()` 到 `prot_set_set_sealed()` 就是终点，这条差距已登记在 `docs/测试说明/模拟器差距清单.md`；另注意 40 项里有 13 项 `comm_addr=0`（纯本地项），主站侧根本读不到，不能拿 C_RD 当它们的判据 |
-| 7 | 像素回归稳定 | `ui-golden` 连续两次运行零差异。**已验（2026-10-26）**：27 页连跑两次逐字节一致（含整定 9 态）；轮询定时器不影响——无头模式不调 `lv_timer_handler()`（§9.2 注 6） |
+| 7 | 像素回归稳定 | `ui-golden` 连续两次运行零差异。**已验（2026-10-26，当时下限为 27 页）**：27 页连跑两次逐字节一致（含整定 9 态）——**集合现已扩至 40 页**，双次一致需按同口径重跑回填；轮询定时器不影响——无头模式不调 `lv_timer_handler()`（§9.2 注 6） |
 | 9 | 「写不进去」与「改了不动作」两条事实互不冒充 | 反向文本断言（`check_content_pages.py` 的 `ABSENT`：查看页与只读态不得出现「未标定」徽标与「保存」行）+ 台架：未制造该态——要它必须改坏 /prot_set.bin（破坏产品配置存储，用户裁定 2026-10-26 不做），故 LOCK 态目前只有代码级证据与三重反证（ENTER 被正常消费、遥信 YX31=OFF、开机 CORRUPT=0），**没有像素证据** |
 | 8 | 主机单测覆盖数据模块 | `test/host/ui_data` 全绿并挂 pre-commit 钩子 |

@@ -26,7 +26,7 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 | 步 | 脚本/命令 | 门禁内容 | 预期输出 |
 |---|---|---|---|
 | 1 | `simulator/tests/check_menu_rows.py` | 菜单 8 状态：选中行白带 / 非选行黑底白字 / 框体 1px 边框 / 往返像素一致（MENU-STATE-03==MENU-STATE-01、MENU-STATE-06==MENU-STATE-01、MENU-STATE-07==MENU-STATE-02）+ MENU-STATE-00 池基线 | `PASS: 8 状态全部断言通过（8 图，池基线 5368 B）` |
-| 2 | `simulator/tests/check_content_pages.py` | ① 文本级断言（字形模板匹配，242 条，独立于 `ref/`）→ ② 27 页截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 | `PASS: 27 内容页 + 往返池水位全部通过`（文本断言先于像素比对，失败即中止） |
+| 2 | `simulator/tests/check_content_pages.py` | ① 文本级断言（字形模板匹配，310 条，独立于 `ref/`）→ ② 40 页截图与 `ref/` 黄金参考**逐字节**比对 + 开页-关页往返池水位 | `PASS: 40 内容页 + 往返池水位全部通过`（文本断言先于像素比对，失败即中止） |
 | 3 | `keil-build` skill（`keil_build.py`） | MCU 端编译（UI 源码双端共用，改一端必须过另一端） | 退出码 0 = BUILD_OK |
 | 4 | `scripts/check_coding_standard.py` | 代码规范 V1.0 机械检查 | PASS |

@@ -35,8 +35,8 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 > 渲染成墨点集合，在截图对应 y 带内做精确匹配（LVGL 基线对齐）。价值：**缺字显示空白 / 标签写错**
 > 这类回归不再只靠像素位图（那需要刷参考，且无视觉后端时难以判读）；文本断言不依赖 `ref/`，且
 > **先于**像素比对运行，失败即中止（不误刷参考）。文本断言覆盖确定文案，像素参考仍负责几何/样式/
-> 光标反显等其余视觉。规模与覆盖面（2026-10-26 实跑 `check_content_pages.py` 取数）：文本断言 **242 条**、覆盖 27 页中的
-> **24 页**——`pwd` / `pwe` / `pwc` 三张密码态只进像素比对、未登记文本断言，改这几页的文案没有文本层兜底。
+> 光标反显等其余视觉。规模与覆盖面（2026-10-26 实跑 `check_content_pages.py` 取数）：文本断言 **310 条**、覆盖 40 页中的
+> **37 页**——`pwd` / `pwe` / `pwc` 三张密码态只进像素比对、未登记文本断言，改这几页的文案没有文本层兜底。

 **退出码约定**：两个脚本均为 0=PASS / 1=断言失败 / 2=环境错误（exe 缺失、参考缺失）。
 失败时脚本打印差异明细（文本断言未命中项 / ink runs 对照 / 像素差数），内容页脚本保留现场截图于临时目录并提示路径。
@@ -49,7 +49,7 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 | `POOL_AFTER_ROUNDTRIP` | check_content_pages.py | **5448 B** | 开页-关页往返后水位 = 基线 + 一次性残留 80 B |

 > 水位历史：4784 →（2026-09-14 待机模块常驻 +656）5440 / 5520 →（2026-10-11 裁剪 LVGL 控件类 −72）5368 / 5448。
-> 后一次漂移已核实为**有意且更优**：像素逐字节未变（**裁剪当时黄金参考只有 11 页**，在裁剪**前**生成、裁剪后全部一致；该集合现已扩至 27 页），
+> 后一次漂移已核实为**有意且更优**：像素逐字节未变（**裁剪当时黄金参考只有 11 页**，在裁剪**前**生成、裁剪后全部一致；该集合现已扩至 40 页），
 > 且一次性残留仍是 80 B（5448 − 5368）→ 泄漏特征未变，只是 `lv_theme_apply` 不再为已不存在的控件类登记样式条目。

 **漂移处理**：菜单/页面结构或样式变更导致门禁失败时，先确认新值合理（残留分解见
@@ -58,7 +58,7 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警

 ## 四、黄金参考（入库）与目检 PNG（本地产物）

-`simulator/tests/ref/*.bin`（像素黄金参考，27 页 × 3200 B）**随仓库入库**；派生的 `.png`
+`simulator/tests/ref/*.bin`（像素黄金参考，40 页 × 3200 B）**随仓库入库**；派生的 `.png`
 目检图仍是本地产物（`.gitignore`）。入库的理由：比对是**逐字节**的，基线不入库时任何新克隆
 或新工作树跑 `ui-golden` 都必然 FAIL（缺基准），这条门禁就只在"有老副本的机器"上真实存在。
 可复现性实测（2026-10-22）：两份各自独立构建的 `lvgl_sim`（不同构建目录、相隔 11 天的代码）
@@ -145,7 +145,7 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 ### 7.3 用法与门禁档位

 ```powershell
-# 认屏快检：27 张黄金参考（+ 若有台架留档帧），秒级，不需要构建产物
+# 认屏快检：40 张黄金参考（+ 若有台架留档帧），秒级，不需要构建产物
 & '.venv\Scripts\python.exe' scripts/board_ui_nav.py --selftest-quick
 # 完整自检：再加全绑定页闭环导航（需模拟器可执行文件，约 30 s）
 & '.venv\Scripts\python.exe' scripts/board_ui_nav.py --selftest
@@ -220,3 +220,4 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警
 | 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`，须逐页过目并在提交正文说明 |
 | 2026-10-26 | **内容页页数口径统一为 27**：正文里残留的「11 页 / 其余 10 页 / 18 张」按现状改正（判据本体 = `simulator/tests/ref/shot_*.bin` 入库实数 27 个、`check_content_pages.py` 的 `PAGES` 27 项，含整定 9 态）；下方变更记录里的「11 页」是当时事实，按历史冻结不动。同类陈述同步在 `测试开发标准流程.md`、`自动化测试流程.md`、`主机单测覆盖率口径.md`、`内容页架构.md`、`simulator/tests/README.md`、`scripts/board_ui_nav.py` 改正 |
 | 2026-10-26 | **文本级断言规模口径修正**：门禁表里的「50 条」是 2026-09-10 首版数字，现值 **242 条 / 覆盖 27 页中的 24 页**（`pwd` `pwe` `pwc` 三张密码态只进像素比对、未登记文本断言）；正文的文本层说明补写了覆盖面与这条盲区。下方变更记录里的 50 条属历史，不动 |
+| 2026-10-26 | **内容页黄金参考下限 27 → 40 页**（UI 三页落地，机器实测：`simulator/tests/ref/` 入库 `shot_*.bin` 40 个、`check_content_pages.py` 的 `PAGES` 40 项）；文本断言随之 **242 → 310 条**、覆盖 **40 页中的 37 页**（`pwd` `pwe` `pwc` 三张密码态仍只进像素比对、无文本断言）；27 张旧参考逐字节未变，往返池 5448 B 与菜单常驻堆 5368 B 均未变，字库仍 183 字。本文其余各处与 `AGENTS.md`、`docs/门禁说明/`、`simulator/tests/README.md`、`docs/测试说明/` 三篇同批改齐；**历史行里的 27 / 11 一律保留**（当时下限就是那个数，不改数造连续性）|
@@ -453,7 +453,7 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
 ## 八、验证与回归

 - **门禁**（`ui-verify` skill / `UI_自动化测试流程.md`）：
-   0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 内容页文本断言 + 27 页黄金参考逐字节比对
+   0) 模拟器构建 0 警告 → 1) 菜单 8 状态像素回归 + 池基线 → 2) 内容页文本断言 + 40 页黄金参考逐字节比对
   （网口设置 4 态 + 密码页 4 态等）+ 开页-关页往返水位 → 3) Keil 构建 0 错 0 警 → 4) 代码规范检查
 - **门禁常量**（脚本头部）：`MENU_POOL_BASELINE = 5368 B`、`POOL_AFTER_ROUNDTRIP = 5448 B`
 - **失败处置**：像素不一致 = 代码 bug（修代码，**禁止**刷参考掩盖）；**有意**改视觉 →
@@ -482,3 +482,4 @@ extern const content_page_def_t ui_page_device_info_desc;   /* 描述符（Flash
 | 2026-10-22 | §八 失败处置口径更新：`ref/*.bin` 黄金参考已入库，刷参考会进 `git diff`、必须随改动一并提交并说明理由（详见 `UI_自动化测试流程.md` §四） |
 | 2026-10-26 | 验证与回归段的页数口径修正为 **27 页**黄金参考（`simulator/tests/ref/` 入库 27 个 `shot_*.bin`，含整定 9 态）；上方变更记录里的「11 页」是当时事实不动 |
 | 2026-10-26 | 门禁常量修正为 5368 B / 5448 B（= 两个回归脚本头部现值）；本文件正文表早已是 5368/5448，只这一处残留 2026-10-11 裁剪 LVGL 控件类之前的 4784/4864 |
+| 2026-10-26 | 验证与回归段的黄金参考页数 **27 → 40 页**（UI 三页落地后 `simulator/tests/ref/` 实数 40 张）；上方变更记录里的 11 / 27 是各当时下限，保留 |
@@ -624,7 +624,7 @@ SNTP 客户端 ──────→ 批4 SNTP设置
 | 4 | 无源点显示 `--` | 遥信量无效点、直流量直流通道 |
 | 5 | 定值整定闭环 | 改 → 保存 → 重启 → 值保持 + 校验和自检通过 + 主站 C_RD 一致。**2026-10-26 半收口**：模拟器侧「改 → 保存 → `OK` → 回首屏新值已在帧里」与「越界被拒、值不落盘」已由像素 + 文本断言覆盖（`sparam_save` / `sparam_landed` / `sparam_oob`）；**重启保持与 C_RD 一致只能上板**（模拟器无 NAND）。另注意 40 项里 **13 项 `comm_addr = 0`**（投退、返回系数、过频/低频段、全局软压板）主站不可寻址，不能拿 C_RD 当它们的判据 |
 | 6 | 分层门禁无新增 | `check_layer_deps.py` 退出码 0，基线 6 → 3。**现状：3**（记录 reader 已削 3 条；写路径走注入式 ops 函数表，未新增 include，见 `docs/UI设计/UI_数据供给设计说明.md` §6.2） |
-| 7 | 像素回归稳定 | `ui-golden` 连续两次零差异。**已验（2026-10-26）**：27 页连跑两次逐字节一致 |
+| 7 | 像素回归稳定 | `ui-golden` 连续两次零差异。**已验（2026-10-26）**：27 页连跑两次逐字节一致——**该下限此后已扩至 40 页**（新增 clock / reset / clear 系列 13 张），40 页上的双次逐字节一致需按同口径重跑一次再回填本行 |
 | 8 | 每个新页有 golden 参考 | `simulator/tests/ref/` 新增对应 `.bin`。**整定 4 页已有 9 张**（含保存/越界/落定/回绕各态）；参考图入库，改它 = 改判据，须逐页过目 |

 ---
@@ -27,7 +27,7 @@
 ### 2.1 规模

 > ⚠ **本表是 2026-10-23 立项当天快照**（节点 42 / 有内容页叶子 6 / 空叶子 27 / 黄金参考 11 份均为当日实数，按"完成即冻结"不回改）。
-> 页面扩充落地后现值已变——黄金参考现为 27 份（`simulator/tests/ref/` 入库的 `shot_*.bin` 实数），现状口径见
+> 页面扩充落地后现值已变——黄金参考现为 40 份（`simulator/tests/ref/` 入库的 `shot_*.bin` 实数），现状口径见
 > `docs/UI设计/页面扩充详细方案.md` 与 `docs/UI设计/UI_数据供给设计说明.md`。

 | 项 | 数 |
@@ -704,7 +704,7 @@ uint16_t ch395f_link_change_count(void);
 | 类别 | 体量 | 为什么不做 | 那它靠什么把关 |
 |---|---|---|---|
 | 芯片驱动（寄存器/时序） | `ch395f.c`(801)、`gd5f2gq5ue.c`(689)、`sd2506.c`(264)、`tpafe5160.c`(157)、`rs485.c`(79) = **1,990 行** | 把 HAL 与寄存器假到底 ≈ **重写一遍驱动**，测的是自己的桩而不是硬件行为（SPI 分频必须 8、DMA 流、I2C 时序在桩里怎么编都"对"） | 板级套件（`board-test-suite` skill）+ `@test` 真机日志 + 4 个 Fault 现场；陷阱逐条登记在 `docs/问题记录/CH395F_Trap_Records.md`、`docs/问题记录/GD5F2GQ5UE_Trap_Records.md`、`docs/问题记录/SD2506_Trap_Records.md` |
-| UI 侧 | 17 个 `.c` = **1,942 行** | 与 PC 模拟器是**同一份源码**，行为回归已由 `ui-golden`（菜单 8 状态 + 内容页 27 页像素黄金参考）覆盖；再写单测是第三份重复投资 | `ui-verify` skill 五步 + `docs/UI设计/UI_自动化测试流程.md` |
+| UI 侧 | 17 个 `.c` = **1,942 行** | 与 PC 模拟器是**同一份源码**，行为回归已由 `ui-golden`（菜单 8 状态 + 内容页 40 页像素黄金参考）覆盖；再写单测是第三份重复投资 | `ui-verify` skill 五步 + `docs/UI设计/UI_自动化测试流程.md` |
 | 任务编排 | `default_task.c`(281)、`adc_task.c`(171)、`net_task.c`(123)、`protect_task.c`(90)、`ui_task.c`(71)、`rs485_task.c`(11) = **747 行** | 每个只有 4~5 个函数，主体是"按顺序调别人"；真逻辑在被调模块里（那些已测或在 P1/P2）。给编排层写单测最容易写成"断言我调了几次"的自证 | 真机启动锚点计数 + IWDG `required_mask`（`@test`）+ `docs/架构设计/项目启动顺序管理.md` |
 | 内核前装配 | `app_main.c`(135) | 被测对象本身就是"`osKernelStart` 之前不许调内核 API"的时序，主机侧无法忠实复现（PC 上没有那个约束） | 同上 + `cubemx-survival` 审计 |

@@ -772,3 +772,4 @@ P2 5 个 2,226 行、P3 29 个 4,814 行明确不做**（四条对得上：13+5+
  详见 §9「第 3 轮」与 `docs/子系统设计/运行与自检记录设计说明.md` §4.4；合回主干后以 `4288658`
  回填内存台账，主干 `pre-commit run --all-files` 39 项全绿。 |
 | 2026-10-26 | UI 侧「不做」理由里的页数口径修正为 **内容页 27 页**（原写 18，与 `simulator/tests/ref/` 入库的 27 个 `shot_*.bin` 不符）|
+| 2026-10-26 | UI 侧「不做」理由里的黄金参考页数 **27 → 40 页**（与 `simulator/tests/ref/` 入库 40 个 `shot_*.bin` 对齐）；历史行保留 |
@@ -372,8 +372,8 @@ cmake --build simulator/build --config Debug   # 0) 构建模拟器（须 0 警

 | 层 | 载体 | 抓住什么 |
 |---|---|---|
-| 文本层 | `check_content_pages.py` 字形模板匹配（242 条、覆盖 24 页，解析字体 cmap / glyph_dsc / bitmap） | 缺字显示空白 / 标签写错等**静默失败**（不依赖 `ref/`，先于像素比对运行、失败即中止防误刷参考） |
-| 像素层 | 27 内容页 + 菜单 8 状态，与黄金参考逐字节比对 | 几何 / 样式 / 光标反显 / 整体外观 |
+| 文本层 | `check_content_pages.py` 字形模板匹配（310 条、覆盖 37 页，解析字体 cmap / glyph_dsc / bitmap） | 缺字显示空白 / 标签写错等**静默失败**（不依赖 `ref/`，先于像素比对运行、失败即中止防误刷参考） |
+| 像素层 | 40 内容页 + 菜单 8 状态，与黄金参考逐字节比对 | 几何 / 样式 / 光标反显 / 整体外观 |
 | 池水位层 | `MENU_POOL_BASELINE=5368 B` / `POOL_AFTER_ROUNDTRIP=5448 B` | LVGL 内存池泄漏 / 结构性漂移（量的是 `used`，与 `LV_MEM_SIZE` 总大小无关） |

 ### 5.3 黄金参考与字体纪律
@@ -643,3 +643,4 @@ CI 就静默停摆（2026-10-11 实测 run 16~21 共 12 个 job 零日志）。
 | 2026-10-22 | §5.3 黄金参考纪律更新：`ref/*.bin` 入库（新克隆即可跑 UI 像素回归）、`.png` 仍不入库；补充"刷参考会在 `git diff` 显形，须逐页过目并在提交正文说明" |
 | 2026-10-26 | 像素层页数口径修正为 **27 内容页**（判据 = `simulator/tests/ref/` 入库的 27 个 `shot_*.bin`；旧写「11」是页面扩充前的数字）。同类陈述同步在 `UI_自动化测试流程.md` 等六处改正 |
 | 2026-10-26 | 三层断言表的文本层规模由「50 条」修正为 **242 条、覆盖 24 页**（现值取自 `simulator/tests/check_content_pages.py` 的 TEXTS 实跑计数；三张密码态无文本断言）|
+| 2026-10-26 | 三层断言表同步 UI 三页落地后的真值：像素层 **27 → 40 内容页**、文本层 **242 → 310 条（覆盖 37 页）**；上方变更记录里的 27 / 242 属当日事实，保留不动 |
@@ -119,7 +119,7 @@

 - **初始化回归**：`App/task/ui_task.c` 已有 `UI port init: OK` / `UI menu init: OK` / `UI net sink: started`
  打印（见 `@test` 命令示例）；将其加入 `-Required` 即可经串口自动回归 UI 初始化。
- **屏幕内容回归**：由 LVGL 模拟器像素回归覆盖（文本级断言 + 27 页黄金参考 + 池水位门禁，
+- **屏幕内容回归**：由 LVGL 模拟器像素回归覆盖（文本级断言 + 40 页黄金参考 + 池水位门禁，
  见 `docs/UI设计/UI_自动化测试流程.md`）；上机屏幕仍需人工目检（L3 层，见 `测试开发标准流程.md` §1）。

 ## 扩展用法
@@ -150,3 +150,4 @@
 | 2026-10-11 | **身份戳覆盖测试宏**（N-31 复测时发现）：切 `test/board/test_config.h` 的套件宏后 `app_main.c` 未被重编，测试镜像与产品镜像顶着同一个 `fw build:` 戳 → 戳校验对"两种构建互换"失明（当时只有 `-CmpFile` 回读发现镜像不同）。修复：`app_main.c` `#include "test_config.h"`（头依赖 → 改宏必重编、戳必刷新）+ 戳串追加 ` suite=<TEST_SUITE_NAME> dstr=<on|off>`（`FW_BUILD_VARIANT`，戳内容本身区分构建）。实测：`20:36:11 suite=NONE dstr=off` ↔ `20:36:40 suite=CH395F dstr=on`；`@test` 闭环对新格式 PASS（脚本无需改动，戳按"标记后连续可打印 ASCII"抠取）。失败模式表补一行：戳命中但 `suite=` 与要跑的套件不符 = 烧了产品镜像 |
 | 2026-10-22 | **自检台账判据改为「只看本次启动新增」**（修两处叠出来的假绿）：① 抓取用的 FTP 登录还写着匿名，而设备自鉴权落地起就没有匿名通道 → 抓取**必然** 530 失败，旧实现又把"抓取失败"和"设备侧无此文件"都返回空、一律按"无记录 → PASS"处理 → `--require-selftest-pass` 从写下那天起没真正看过文件；② 就算抓到了，`/log/selftest.log` 是 512 条环形累计历史，"非空即 FAIL"在任何做过故障注入/长跑的设备上永远不可能 PASS（本仓台架实测 29 条记录全是 2026-10-10 ~ 10-14 留下的）。现在：烧录前取基线、启动后只判新增；抓取失败 / 无数据源 / 基线被环覆盖 **一律 FAIL**；`--selftest-scope all` 保留累计口径用于审计与首次建基线；FTP 凭据 `--ftp-user/--ftp-pass`（默认出厂 admin/admin）。凭据与判据两处都过真机：`this-run` → PASS（无新增）、`all` → FAIL（累计 29 条）、无 `device_ip` → FAIL（无数据源）。 |
 | 2026-10-26 | UI 屏幕自动化段的页数口径修正为 **27 页**黄金参考（与 `simulator/tests/ref/` 入库的 27 个 `shot_*.bin` 对齐；旧写 11）|
+| 2026-10-26 | UI 屏幕自动化段的黄金参考页数 **27 → 40 页**（`simulator/tests/ref/` 入库 `shot_*.bin` 实测 40 个）；历史行保留 |
@@ -50,7 +50,7 @@
 | [`cubemx-survival.md`](cubemx-survival.md) | `cubemx-survival` | CubeMX 重生成会不会把定制静默抹掉（L3 审计兜底） | `.ioc`、`Src/`、`Inc/` | 已写 |
 | [`test-suite-switch.md`](test-suite-switch.md) | `test-suite-switch` | 板级套件开关必须互斥；全注释 = 产品构建 | `test/board/test_config.h` | 已写 |
 | [`font-charset.md`](font-charset.md) | `font-charset` | UI 用到的汉字是否都在子集字体里（缺字 = 白框） | `Drivers/BSP/UI/**`、字体脚本 | 已写 |
-| [`ui-golden.md`](ui-golden.md) | `ui-golden` | UI 像素回归：菜单 8 状态 + 内容页 27 页黄金参考图比对 | UI 源码、模拟器 | 已写 |
+| [`ui-golden.md`](ui-golden.md) | `ui-golden` | UI 像素回归：菜单 8 状态 + 内容页 40 页黄金参考图比对 | UI 源码、模拟器 | 已写 |
 | [`bom-guard.md`](bom-guard.md) | `bom-guard` | 带 BOM 的文件被编辑工具剥掉 BOM（ARMCC 换解码 → 假语法错） | `Drivers/BSP/UI/**` 等名单内文件 | 已写 |
 | [`setview-check.md`](setview-check.md) | `setview-check` | 定值查看行表与 `prot_set` 枚举序 / `g_prot_set_meta` 上下限是否同一份口径 | `tools/setview_check/**`、`ui_w_setview.*` | 已写 |
 | （专篇待补，档位与限度正文在 [`../UI设计/UI_自动化测试流程.md`](../UI设计/UI_自动化测试流程.md) §7.3） | `uinav-selftest` | 板端 UI 导航器认屏快检（黄金参考帧分类；完整闭环档=合入前/上板前手工跑，快检不互替） | `scripts/board_ui_nav.py`、`simulator/tests/ref/*.bin` | 指针 |
@@ -1,4 +1,4 @@
-# `ui-golden` — UI 像素回归（菜单 8 状态 + 内容页 27 页黄金参考）
+# `ui-golden` — UI 像素回归（菜单 8 状态 + 内容页 40 页黄金参考）

 > 一句话：改 UI 源码时，把模拟器增量重编 + 两条 golden 回归串成一次提交门禁，**像素对不上就拦**。
 > 它是包装器：真正的判据在被包装的两条脚本与参考图里。
@@ -11,7 +11,7 @@
 ## 1. 它在查什么

 - 菜单侧：整棵菜单树的行渲染结果（8 个状态）与参考图逐像素比对；
- 内容页侧：27 个内容页的渲染结果与参考图比对；
+- 内容页侧：40 个内容页的渲染结果与参考图比对；
 - 参考图 `simulator/tests/ref/*.bin` **就是判据本身**。

 ## 2. 为什么要它（有牙的实测）
@@ -57,7 +57,7 @@

 1. **参考图即判据**：刷新参考图 = 修改判据。评审时必须盯 `simulator/tests/ref/` 的 diff；
   一旦"顺手更新"，此后所有回归都只在和错的基线比。**门禁无法阻止这件事**，只能靠评审。
-2. 只覆盖 8 个菜单状态 + 27 个内容页：未列入的状态（密码错误态、超长文本、缺字渲染、
+2. 只覆盖 8 个菜单状态 + 40 个内容页：未列入的状态（密码错误态、超长文本、缺字渲染、
   无 SD 卡 / 挂载失败的降级显示）**不会有任何回归**。
 3. 跑的是**模拟器那份配置**，不是固件那份 —— 两份 `lv_conf.h` 漂移时，回归结论不能外推到固件
   （所以 `lv-conf-sync` 是本门有效性的前提）。
@@ -82,3 +82,4 @@
 | 日期 | 变更 |
 |---|---|
 | 2026-10-23 | 首篇逐项文档（含 +3 像素注入实验与"有基线 ≠ 有门禁"的缺口来源） |
+| 2026-10-26 | 内容页黄金参考下限 **27 → 40 页**（UI 三页落地；`simulator/tests/ref/` 入库 `shot_*.bin` 实测 40 个、`check_content_pages.py` 的 `PAGES` 40 项 / 文本断言 310 条覆盖 37 页 / 反向断言 29 条 16 页），标题与「拦不住什么」段同步；未列入状态那一段的覆盖面口径不变 |
@@ -53,7 +53,7 @@ simulator/
 | `build_sim.bat` / `build_sim.ps1` | 一键构建入口：vswhere 探测本机 VS 大版本（16=2019 / 17=2022 / 18=2026，取已装最高）→ 映射 CMake 生成器；`build/` 缓存生成器与本机不符（换机/升级 VS）时自动删除重建（带重试，抗文件锁）。**构建入口一律走它，文档/命令中勿写死生成器版本**；`.bat` 仅负责绕过 PowerShell 执行策略并转交 `.ps1` |
 | `CMakeLists.txt` | 收集 LVGL 源码（`../Lib/lvgl`）+ 共享 UI 源码（`../Drivers/BSP/UI`）+ 通用配置文件引擎（`../App/cfg_file.c`、`../Drivers/BSP/NETCFG` 的 net_cfg；`net_cfg_legacy` 已于 2026-10-10 删除）+ `sim/` 平台层，链接预编译 SDL2，产出 `lvgl_sim.exe` |
 | `i1_to_png.py` | 把 `--screenshot` 产出的 I1(1bpp) 原始位图转成 PNG，便于离线比对设计稿。详见 §3.5 |
-| `tests/` | 无头回归脚本（菜单 8 状态像素回归 + 内容页 27 页：文本断言 / 反向断言 / 黄金参考逐字节比对）；`ref/shot_*.bin` **随仓库入库**（判据本体，改动等于改判据，评审须逐页过目），`ref/*.png` 是本地派生的目检图（`.gitignore` 挡掉）。详见 §3.6 |
+| `tests/` | 无头回归脚本（菜单 8 状态像素回归 + 内容页 40 页：文本断言 / 反向断言 / 黄金参考逐字节比对）；`ref/shot_*.bin` **随仓库入库**（判据本体，改动等于改判据，评审须逐页过目），`ref/*.png` 是本地派生的目检图（`.gitignore` 挡掉）。详见 §3.6 |

 > **共享代码不复制**：`ui_menu.c` / `ui_font_cn_12.c` / `ui_net_sink.c` 直接引用 `Drivers/BSP/UI/` 下的原件，
 > MCU 与 PC 两端永远同步。**不要**在本目录内复制 UI 源码。
@@ -222,7 +222,7 @@ UI 改动的自动化门禁脚本（完整流程见 `docs/UI设计/UI_自动化
 | 脚本 | 原理 | 失败输出 |
 |------|------|----------|
 | `check_menu_rows.py` | 键序注入（u/d/e/s）跑 8 个菜单状态，断言选中行白带、非选行黑底白字、框体边框、往返状态逐像素一致；MENU-STATE-00 池水位须等于脚本内 `MENU_POOL_BASELINE` | 未过断言清单 + 保留临时截图 |
-| `check_content_pages.py` | ① 文本断言（解析字体字形，在截图 y 带内精确匹配期望串，不依赖 `ref/`）② **反向断言**（`ABSENT` 表：某串**不该**出现，如查看页/只读态不得出现「未标定」徽标与「保存」行——像素参考会被 `--update` 刷成"自证正确"，反向断言不依赖参考图）③ **27 页**无头截图与 `tests/ref/shot_*.bin` **逐字节**比对（含 2026-10-26 新增的整定 9 态：进页 / 保存行 / 只读态 / 编辑态 / 越界 / 保存 OK / 落定后可读 / 二态回绕）；另校验开页-关页往返池水位 = `POOL_AFTER_ROUNDTRIP` | 文本未命中项 / 反向断言被命中 / 差异像素数 + 双方 ink runs 对照 |
+| `check_content_pages.py` | ① 文本断言（解析字体字形，在截图 y 带内精确匹配期望串，不依赖 `ref/`）② **反向断言**（`ABSENT` 表：某串**不该**出现，如查看页/只读态不得出现「未标定」徽标与「保存」行——像素参考会被 `--update` 刷成"自证正确"，反向断言不依赖参考图）③ **40 页**无头截图与 `tests/ref/shot_*.bin` **逐字节**比对（含 2026-10-26 新增的整定 9 态：进页 / 保存行 / 只读态 / 编辑态 / 越界 / 保存 OK / 落定后可读 / 二态回绕）；另校验开页-关页往返池水位 = `POOL_AFTER_ROUNDTRIP` | 文本未命中项 / 反向断言被命中 / 差异像素数 + 双方 ink runs 对照 |
 | `check_remo_sink.py` | 启动**窗口**模拟器（非无头，`CREATE_NEW_PROCESS_GROUP` 防管道阻塞），经 TCP 7003 发 LCDMEM 取 1bpp 帧；断言首帧=LCDMEM（无 INIT 污染）/位图 3200 字节/非平凡；复用 `i1_to_png` 出目检 PNG；与无头参考（`lvgl_sim --screenshot`）逐位比对 <2% 判 MATCH。守护"INIT 污染 / 快照卡死"两个历史缺陷 | 各判据失败原因 + `sim_err.txt` 尾部 + 保留 PNG（默认不删，`--clean` 才删） |

 - **黄金参考与目检 PNG**（`ref/*.bin` **入库**、`ref/*.png` 本地派生不入库）：换机或想目检时——
@@ -11,7 +11,7 @@
 | `check_content_pages.py` | **内容页回归**：各内容页渲染比对 |
 | `check_remo_sink.py` | **推流（RemoDispBus）回归**：接收端渲染比对 |
 | `regen_ref_png.py` | 由 `ref/*.bin` 批量出**目检 PNG**（不产生基准；基准由 `check_content_pages.py --update` 刷） |
-| `ref/*.bin` | **像素黄金参考（入库）**：11 页 × 3200 B，160×160 单色打包 |
+| `ref/*.bin` | **像素黄金参考（入库）**：40 页 × 3200 B，160×160 单色打包 |

 ## 使用方式