docs(计数): 录波落地后的全仓计数同步（套数/钩子/黄金/菜单/字库）
机器面先定真值，再逐处对齐文档；带日期戳的取数行只加「当时」不改数。 六个数（每条两个以上独立机器源互证） - 主机单测套数 41 → 44（find test/host -name run_unit_test.py / 覆盖率总闸 --list / 基线 modules 条目三源一致；目录数 46 = 44 + common + __pycache__，两个数分开写） - 有专属钩子 22 根（YAML 解析 -unit-test 后缀）⇒ 无专属钩子 19 → 22 套，并把 wave_ring / wave_store / wave_trig 逐名列进门禁台账 §6 第 4 条，18 / 19 / 22 三个数 改标「裁定当时 / 2026-10-28 / 2026-10-29 现值」 - 内容页黄金参考 60 → 66 张（simulator/tests/ref/shot_*.bin 实数 / PAGES 条目 66， 其中 2 个分页 → 页面 64）；钩子显示名与门禁索引表成对改 - 菜单 42 → 43 行（9 菜单 + 34 叶）、已绑 28 → 30、未绑 4（ui_menu_tab.h 宏 + g_menu_tab[] 末行 / ui_page_registry.h 的 UI_PAGE_MAP_COUNT + #page= 计数剔示例行） - 中文字库 218 → 224 唯一字、313 → 319 字形（清单唯一码点 / .bitmap_index 条目数 含 notdef；224 + 95 = 319 成立） - 钩子口径 52 声明 / 49 提交期实跑：只核不改，核对 AGENTS 与 YAML 解析一致 Lead 追加四处（wave-algo 按「AGENTS 只核不改」的指令交回我裁的部分） - AGENTS.md 提交门禁节：41 套 → 44 套（两处）、19 套 → 22 套（两处，并把「与录波 三套」写进括注）、ui-golden 条目 60 张 → 66 张；52 / 49 的口径叙述与历史括号原样 - scripts/board_ui_nav.py 的自述 docstring：60 张 → 66 张 - test/host/sys_log_mcu/sys_log_mcu_test.c 注释：全量门禁 41 套 → 44 套（纯注释） - 产品需求 FR-UI-2：需求原文「42 节点」保留不动，在实现行注「2026-10-29 实到 43 节点，42 是 V0.1 立项数」——需求基线不由实现方回改 刻意不动的（冻结面） - 带日期戳的实测行（自动化测试流程、字库差集门禁、覆盖率口径里的 67 s / 25 s / 45 s / ~105 s 四个耗时）、保留变更记录的文档历史行、页面补齐规划里自写「完成即 冻结」的立项快照表、2026-10-28 那份分工说明、级联框总览.svg（42 节点时代所画， 无生成器，重画另开一笔）、三处伪命中（字体数据行、芯片手册、m2/m3 数据目录） 自查（真实退出码）：check_doc_links.py --all RC=0（215 个文档、章节引用可判定 80 %， 合并后第一次全库零红）；check_generated_fresh.py RC=0（22 张图 17 一致 / 5 条既有 BASELINE 豁免，生成物零改动）；编号门禁 add 后复扫 RC=0；17 + 4 个改动文件字节体检 全绿（无 BOM / LF / 无 U+FFFD / 无尾随空白 / 单个尾换行）。
This commit is contained in:
@@ -34,5 +34,5 @@ python tools/font_gen/extract_cn.py # 扫描 UI 源码字符串 →
|
||||
- `requirements.txt` 必须**纯 ASCII**（Windows 下 pip 按 GBK 解码，中文注释 → UnicodeDecodeError）
|
||||
- 生僻字（宋体可能无字形）→ **写码前先手动验证字形**，避免"代码写完才发现是空白"
|
||||
- 生成成功后跑 `ui-verify` skill 全回归；黄金参考因字形变化而 FAIL 属预期 → `check_content_pages.py --update` 刷新
|
||||
- 字数变化时同步更新文档中的字符集计数（当前 218 汉字/符号 + ASCII 0x20-0x7E，共 313 字形；2026-10-28 实测。历史上 119/214 → 179/274 → 185/280 均为当时快照）：`UI_中文字体生成与配置.md`、`UI_界面制作流程.md` C3、`UI_设计架构.md`、`simulator/README.md` 已知坑 #4
|
||||
- 字数变化时同步更新文档中的字符集计数（当前 **224** 汉字/符号 + ASCII 0x20-0x7E，共 **319** 字形；2026-10-29 实测：`ui_cn_chars.txt` 唯一码点 224、`ui_font_cn_12.c` 的 `.bitmap_index` 320 条含 notdef → 319 字形。历史上 119/214 → 179/274 → 185/280 → 218/313 均为当时快照）：`UI_中文字体生成与配置.md`、`UI_界面制作流程.md` C3、`UI_设计架构.md`、`simulator/README.md` 已知坑 #4
|
||||
- **新增字低于既有最小码位**（如 Ⅰ U+2160）会下探稀疏 cmap 起点并吞掉单码位补回条目（实测 ▶ 箭头全变方框而旧版 coverage 全绿）——`make_font.py`（2026-10-25 起）按 LVGL 首命中语义插入/守卫/校验，扩字后模拟器像素回归**必跑**
|
||||
|
||||
@@ -33,7 +33,7 @@ PC 上编译运行与 MCU **同一份** UI 源码（CMake + MSVC + SDL2，x64，
|
||||
|
||||
## UI 改动回归 → 用 `ui-verify` skill（勿在此零散手跑）
|
||||
|
||||
5 步门禁 = 构建 → `check_menu_rows.py`（菜单 8 状态像素 + 池基线）→ `check_content_pages.py`（文本断言 + 60 张黄金参考 + 往返池）→ `@build` → `coding-standard`。
|
||||
5 步门禁 = 构建 → `check_menu_rows.py`（菜单 8 状态像素 + 池基线）→ `check_content_pages.py`（文本断言 + 66 张黄金参考 + 往返池）→ `@build` → `coding-standard`。
|
||||
RemoDispBus 推流回归单独跑：`.venv\Scripts\python.exe simulator/tests/check_remo_sink.py`。
|
||||
黄金参考 `tests/ref/*.bin` **随仓库入库**（`.gitignore` 在全仓 *.bin 兜底之后又显式反选，2026-10-22 起；缺基准 = 新克隆跑 `ui-golden` 必 FAIL）：不入库的只是派生目检图 `ref/*.png`，换机后先 `check_content_pages.py --update` 生成，再 `regen_ref_png.py` 出目检 PNG。
|
||||
|
||||
|
||||
@@ -6,20 +6,20 @@ whenToUse: 某个计数/数字变了要跨 md/yaml/py/txt 同步、用户说「
|
||||
|
||||
# 陈旧计数全仓同步
|
||||
|
||||
适用：**一个事实数变了**（黄金参考 27→40→47→53→60、已绑叶数 22→28、字库 185/280→218/313、钩子 51→52→51…），仓库里多处引用它的当前态表述要跟着变，而历史记录、同数异义、带日期戳的测量**不能**跟着变。
|
||||
适用：**一个事实数变了**（黄金参考 27→40→47→53→60→66、已绑叶数 22→28→30、主机单测套数 28→33→41→44、无专属钩子套数 18→19→22、字库 185/280→218/313→224/319、菜单节点行数 42→43、钩子 51→52→51→52…），仓库里多处引用它的当前态表述要跟着变，而历史记录、同数异义、带日期戳的测量**不能**跟着变。
|
||||
|
||||
本仓已跑过四轮，照序列复跑、别临场重新发明分类：`b24b2b5f`（27→40，13 文件）、`31ca4a1f`（40→47，11 文件）、UI 补齐批（`94b0d790` 落地 → `cbb4fdb8` 产品需求同步 → `11d60057` 架构总览补漏 → `6daa01ae` 字体**口径**更正）、钩子一增一减（`1668842d`，52→51）。
|
||||
本仓已跑过四轮，照序列复跑、别临场重新发明分类：`b24b2b5f`（27→40，13 文件）、`31ca4a1f`（40→47，11 文件）、UI 补齐批（`94b0d790` 落地 → `cbb4fdb8` 产品需求同步 → `11d60057` 架构总览补漏 → `6daa01ae` 字体**口径**更正）、钩子一增一减（`1668842d`，52→51）、**第五轮 2026-10-29 录波落地**（套数 41→44、无专属钩子 19→22、黄金 60→66、菜单 42→43 节点 / 33→34 叶、已绑 28→30、字库 218/313→224/319；改动面含 `.pre-commit-config.yaml` 显示名与 `docs/门禁说明/README.md` 成对、三个 skill 正文）。
|
||||
|
||||
## 各计数的权威口径速查（本仓实测值，动手前先对表）
|
||||
|
||||
| 计数 | 真值来源（**至少两处互证**） | 已知伪命中 / 换算 |
|
||||
|---|---|---|
|
||||
| 内容页黄金参考**张数** | `simulator/tests/ref/` 下 `shot_*.bin` 实数（实测 60）＝ `simulator/tests/check_content_pages.py` 的 `PAGES` 条目数（实测 60） | 分页页要**单独再拍一张**（id 加 `_p2`，如 `runreport_p2`）→ **张数 = 页面个数 + 分页多出的张数**；两个数分开报，不许互相冒充（53 张时代的一个 12 行分页页会让 55 页变 56 张这类差 1） |
|
||||
| 已绑内容页**叶数** | `Drivers/BSP/UI/ui_page_registry.h` 的 `#define UI_PAGE_MAP_COUNT 28u`（由 `tools/menu_gen/gen_menu.py` 生成） | `grep -c '#page=' ui_menu_tree.txt` 得 **29**：第 5 行是菜单文件**头部注释里的示例行** → 剔掉注释/模板行后的 28 才是真值 |
|
||||
| 内容页黄金参考**张数** | `simulator/tests/ref/` 下 `shot_*.bin` 实数（2026-10-29 实测 **66**）＝ `simulator/tests/check_content_pages.py` 的 `PAGES` 条目数（实测 **66**，其中 2 个 `_p2` 分页 → 页面 64） | 分页页要**单独再拍一张**（id 加 `_p2`，如 `runreport_p2`）→ **张数 = 页面个数 + 分页多出的张数**；两个数分开报，不许互相冒充（53 张时代的一个 12 行分页页会让 55 页变 56 张这类差 1） |
|
||||
| 已绑内容页**叶数** | `Drivers/BSP/UI/ui_page_registry.h` 的 `#define UI_PAGE_MAP_COUNT 30u`（由 `tools/menu_gen/gen_menu.py` 生成；2026-10-29 录波道绑两叶后 28→30） | `grep -c '#page=' ui_menu_tree.txt` 得 **31**：第 5 行是菜单文件**头部注释里的示例行** → 剔掉注释/模板行后的 30 才是真值 |
|
||||
| 提交**钩子数** | YAML 解析后的条目数（实测 **51**）：自查命令见 `docs/门禁说明/README.md` §2 首条；与 AGENTS.md「共 N 个钩子」、该目录 §2 标题**三数同源** | `grep -c` 配置里的声明行 = 52（多算一条**被注释掉的** clang-format 候选）；在配置**注释里复述那个 grep 字面量**会让文本计数再虚高 1 |
|
||||
| 字库**唯一字数** | `ui_cn_chars.txt` 唯一码点数（实测 218，其中 ASCII 区 **0** 个） | `make_font.py` 的 `-r 0x20-0x7E` 是 ASCII 子集参数，**不算进字数** |
|
||||
| **字形数** | `Drivers/BSP/UI/ui_font_cn_12.c` 里 `.bitmap_index` 出现次数 **314 条含 notdef → 313 字形**；换算式 = 218 汉字/符号 + ASCII 95 = 313 | 直接报 314 就是把 notdef 当字形；文档必须写出「不含 ASCII」「含 notdef 共 314 条」这类口径句 |
|
||||
| 菜单**节点数 / 叶子数** | `ui_menu_tree.txt` 头部规则：缩进即层级（每级 2 空格）、`#` 开头为注释、空行忽略；叶子 = **不存在更深缩进后继行**的行 | 42 是节点行数、33 才是叶子；`未绑 = 待做 + 不做` 要与分类表逐项闭合 |
|
||||
| 字库**唯一字数** | `ui_cn_chars.txt` 唯一码点数（2026-10-29 实测 **224**，其中 ASCII 区 **0** 个） | `make_font.py` 的 `-r 0x20-0x7E` 是 ASCII 子集参数，**不算进字数** |
|
||||
| **字形数** | `Drivers/BSP/UI/ui_font_cn_12.c` 里 `.bitmap_index` 出现次数 **320 条含 notdef → 319 字形**；换算式 = 224 汉字/符号 + ASCII 95 = 319 | 直接报 314 就是把 notdef 当字形；文档必须写出「不含 ASCII」「含 notdef 共 314 条」这类口径句 |
|
||||
| 菜单**节点数 / 叶子数** | `ui_menu_tree.txt` 头部规则：缩进即层级（每级 2 空格）、`#` 开头为注释、空行忽略；叶子 = **不存在更深缩进后继行**的行 | 43 是节点行数、34 才是叶子（2026-10-29 现值；42 / 33 是此前时点）；`未绑 = 待做 + 不做` 要与分类表逐项闭合 |
|
||||
|
||||
## Steps
|
||||
|
||||
@@ -61,7 +61,7 @@ whenToUse: 某个计数/数字变了要跨 md/yaml/py/txt 同步、用户说「
|
||||
提交前逐条打勾；回报时**逐处列文件 + 命中数断言**，不要笼统说「已全部更新」。
|
||||
|
||||
- [ ] 每个数都写了**两个独立来源**且数值一致（`ref/shot_*.bin` 实数 ＝ `PAGES` 条目数；`UI_PAGE_MAP_COUNT` ＝ 剔伪命中后的 `#page=` 计数），并在结论里贴出该数字与伪命中取舍理由
|
||||
- [ ] 字形数说明**是否剔除 notdef**并给出条目数→字形数的换算（314 − 1 = 313）；字数说明**是否含 ASCII**，且该口径句与实测一致
|
||||
- [ ] 字形数说明**是否剔除 notdef**并给出条目数→字形数的换算（条目数 − 1 = 字形数，2026-10-29 现值 320 − 1 = 319）；字数说明**是否含 ASCII**，且该口径句与实测一致
|
||||
- [ ] 分类表逐条列出：改了哪些当前态、哪些历史行保留、哪些误报不动（附理由）、哪些只加「当时」、哪些属**口径错**并已另起一笔
|
||||
- [ ] 替换脚本打印了每处 `old -> new xN` 且每处 `assert` 通过（无半落地；报错时已 `git diff --stat` 确认零写入）
|
||||
- [ ] 命中面覆盖 `.pre-commit-config.yaml` 钩子 `name:`、AGENTS.md、`docs/**`、`scripts/**`、`.dsh/skills/*/SKILL.md`，逐条在改动清单里出现
|
||||
|
||||
Reference in New Issue
Block a user