feat(UI): W6 第一波——设计令牌层、页面注册表生成器与 UI 门禁补强
启动 docs/任务规划/README.md 的 W6 UI 扩展簇（用户裁定，覆盖 2026-10-11
的"本轮不排期"）。四个工作包，全部验证通过。
## U1 设计令牌层（零行为变化）
新建 Drivers/BSP/UI/ui_tokens.h（20 个宏），框架 + 7 个页面 + App/task/
ui_task.c 全部接入。屏幕几何**复用 ui_port.h 既有 UI_SCREEN_W/H**，不重复
定义；令牌头自身只 include ui_port.h，不把 LVGL 拖进全部消费者。
补收了报告没列但代码里真重复的量：UI_TEXT_BAND_H 15（7 次）、列表左右边界
与每页行数（各 4 个页面逐字复制）、推流协议几何与显示几何同源（此前硬编码
3200 且注释写着"须与 UI_FB_SIZE 一致"——典型漂移隐患）、UI_TASK_TICK_MS
（ui_port_step 与 osDelay 必须同值，原先靠注释维系）。
故意不收页面私有几何与"同形不同义"的值（device_info 的 pitch=15 与列表
UI_ROW_PITCH=14 合并即改像素）。
## U3 页面注册表与生成器（删手工分发）
ui_page_registry.{c,h} 由生成器产出，**手工 menu_content_page_for() 已删
除**（仓库内仅存 2 处历史说明注释）。密码页按代码实况**单独出口**
（ui_page_registry_password()）——它非节点绑定，任何 #P 叶子进同一页。
顺带落地此前判定"U1 阶段做不了"的共享 flat 样式 ui_style.{c,h}。
生成器除产注册表外**自动把新 .c 写进 uvprojx 与 CMakeLists.txt**，且
**双向对账**：加页打印 registered、删页打印 pruned，不留死条目；并双向
校验（#page 找不到实例报错、实例未被任何 #page 引用也报错）。
## U4 门禁补强（35 个钩子）
新增 font-charset 钩子（scripts/check_font_charset.py）：复用
tools/font_gen 的同一套提取与 cmap 解析规则（importlib 直载，零第二套
规则），A 段查源码在用 vs 字符集、B 段查字符集 vs 字体 cmap。
registration-check 补第 ④ 类：实测原规则对"进了两端构建但没接描述符表"
的页面**全绿**——desc 被链接器剥离、编译链接全过、菜单永远打不开的死代码。
仍照不出的两项已如实写进文档（枚举漏加归 @build、菜单树漏挂归 golden）。
## 字体子集瘦身（D 案，4 留 3 删）
ui_cn_chars.txt 122→119 字（恰删 上/电/重，零新增）。异/常/片/芯 进
KEEP_EXTRA 带理由白名单：它们曾在 9eb1bd63 被写进中文自检描述落盘
/log/selftest.log（定长 64B 记录跨固件持久），删字形会使历史故障记录
渲染空白且不可逆。保留字按**必需**处理，反向有牙——谁只跑 extract_cn
把它们静默洗掉，钩子直接 FAIL 并逐字打印理由。
--strict 口径为"未知冗余 = 0"而非"冗余 = 0"。
## 验证
@build 0 错 0 警；ER_IROM1 232,052 B（较 HEAD −228 B）、RW_IRAM1
75,232 B **零增量**、RW_CCM 87.9% 未变。golden：菜单 8 状态全像素一致 +
内容页 11 页逐字节一致，**参考图 sha256 差异 0 条**（未用 --update 刷
基线）；池水位菜单基线 5368 B、开页-关页往返 5448 B 与 U1 时相同。
38 个在途修改文件逐个核对 BOM/CRLF/U+FFFD 全部与 HEAD 一致。
L0 33 钩子 + L0.5 16 runner / 1104 断言全绿；check_doc_links --all
142 篇、无法判定 0；mem-budget / mem-numbers 已回填。
## 单位成本实测（U5 排期依据）
临时页 zzprobe 绑到"遥信量"叶子 → 只跑生成器 → 带页 @build 0/0 →
注册表出现 {5u, &ui_page_zzprobe_desc} → 回滚后 6 个产出文件 zzprobe
残留计数均 0、重编回基线。
**结论：新增一页 = 3 处人工（新 .c + 新 .h + 菜单树那一行加
#page=<名>）+ 1 条生成器命令，手工编辑注册文件 0 处。**
据此修正报告原口径"8 处降到 1 处"——那个 1 只在"1 处对既有文件的修改"
意义下成立，页面自身 2 个文件本就要写，真实处数是 3。
## 文档同步与两处自我修正
§0.1 UI 行 B → B+；§6.1「内容页」「设计令牌」两行按实况回填；§6.5 U1/U3
状态更新；§6 顶部加"建议栏不可照抄"总警示（本轮四次证伪：ui_port.h 已有
同名宏、LV_COLOR_BLACK/WHITE 不存在且极性反了、27 页实为目标页数现存 7
个、生成器草图漏密码页非节点绑定）。
两处改口：① §6.5 U4 从我上一版**误写的 3/3 改回 2/3**——"golden 脚本早已
存在"不等于"已进自动门禁"，两个 golden 脚本至今未挂 pre-commit，该缺口
单列为待办；② 原计划"分三笔提交"**作废**，U1 与 U3 改同一批文件、文件内
交叠，硬切会产生不可编译的中间态，故整波一笔。
This commit is contained in:
@@ -10,12 +10,20 @@
|
||||
历史上 `App/task/rs485_task.c`、`Drivers/BSP/NET/lftpd/lftpd_log.c` **两处都没注册**
|
||||
= 写了却从不参与任何一端编译的**死代码**，误导读者以为功能已生效。
|
||||
|
||||
本脚本做什么（三类缺口）:
|
||||
本脚本做什么（四类缺口）:
|
||||
扫描 `App/`、`Drivers/BSP/`、`Src/` 下全部 `.c`（排除第三方），对照两份注册表：
|
||||
① 存在但未进 uvprojx -> 固件不编译（死代码 / 漏注册）
|
||||
② 存在但未进 CMakeLists -> 模拟器不编译（**仅当该文件本应进模拟器时**才是缺口；
|
||||
MCU-only 文件不进模拟器是**正确**的，见下方豁免）
|
||||
③ 注册了但文件不存在（反向）-> 幽灵注册（改名/删除后残留的注册条目）
|
||||
另对 UI 页面模块（U4 门禁补强，2026-10-15，报告 §6.5）：
|
||||
④ `Drivers/BSP/UI/ui_page_*.c` 定义了 `ui_page_<name>_desc`，但该符号在 UI 目录内
|
||||
除自身 .c/.h 外无任何引用 -> 页面未接入
|
||||
`ui_content_page.c` 的 `s_defs[]` 描述符表：两端**编译
|
||||
链接全过**（desc 无人引用，链接器整段剥离），菜单永远
|
||||
打不开这一页 = 又一形态的"写了却从不生效"死代码。
|
||||
①②③ 对此完全照不出（2026-10-15 实测），故补本类；
|
||||
即"新增 UI 页面必须过 registration-check"的机械口径。
|
||||
|
||||
豁免机制（关键）:
|
||||
模拟器只建模 **UI + 网络配置共享核心**；其余模块（MCU 驱动 / 固件任务 / 纯算法 /
|
||||
@@ -237,6 +245,66 @@ def parse_cmake():
|
||||
return sources
|
||||
|
||||
|
||||
# --- UI 页面模块 → 描述符表接线（④，U4 门禁补强）---
|
||||
UI_DIR_REL = "Drivers/BSP/UI"
|
||||
|
||||
|
||||
def check_ui_page_wiring():
|
||||
"""每个定义 `ui_page_<name>_desc` 的 `ui_page_*.c`，其 desc 必须被 UI 目录内其他文件引用。
|
||||
|
||||
UI 页面的"注册"有**两层**：构建注册（uvprojx + CMakeLists，①② 类）与框架注册
|
||||
（`ui_content_page.h` 枚举 + `ui_content_page.c` 的 `s_defs[]` 表）。漏了后者的页面
|
||||
两端照常编译链接（desc 无引用 → 链接器剥离），①②③ 全绿但菜单打不开这一页。
|
||||
判定：页面模块 = `ui_page_*.c` 中定义 `<stem>_desc =` 的文件（不定义 desc 的
|
||||
`ui_page_*.c` 不是页面模块——未来 U3 生成的 `ui_page_registry.c` 承载表引用，
|
||||
本规则依旧成立且不会把它误判为页面）；引用面 = `Drivers/BSP/UI/` 下全部 .c/.h，
|
||||
排除该页自身 .c/.h（自身头文件里的 extern 声明不算接线）。
|
||||
"""
|
||||
ui_dir = os.path.join(REPO_ROOT, UI_DIR_REL.replace("/", os.sep))
|
||||
if not os.path.isdir(ui_dir):
|
||||
return [], 0
|
||||
|
||||
# 1) 页面模块清单：ui_page_*.c 中定义 `<stem>_desc =` 的
|
||||
pages = {} # sym -> repo-rel .c
|
||||
for fn in sorted(os.listdir(ui_dir)):
|
||||
if not (fn.startswith("ui_page_") and fn.endswith(".c")):
|
||||
continue
|
||||
try:
|
||||
text = open(os.path.join(ui_dir, fn), encoding="utf-8-sig", errors="replace").read()
|
||||
except OSError:
|
||||
continue
|
||||
sym = fn[:-2] + "_desc"
|
||||
if re.search(r"\b%s\b\s*=" % re.escape(sym), text):
|
||||
pages[sym] = "%s/%s" % (UI_DIR_REL, fn)
|
||||
if not pages:
|
||||
return [], 0
|
||||
|
||||
# 2) 引用面扫描：UI 目录全部 .c/.h，排除各页自身 .c/.h
|
||||
referenced = {sym: False for sym in pages}
|
||||
for dirpath, _dirnames, filenames in os.walk(ui_dir):
|
||||
for fname in filenames:
|
||||
if not fname.endswith((".c", ".h")):
|
||||
continue
|
||||
rel_p = to_repo_rel(os.path.join(dirpath, fname))
|
||||
try:
|
||||
text = open(os.path.join(dirpath, fname), encoding="utf-8-sig", errors="replace").read()
|
||||
except OSError:
|
||||
continue
|
||||
for sym, own_c in pages.items():
|
||||
if rel_p in (own_c, own_c[:-2] + ".h"):
|
||||
continue
|
||||
if re.search(r"\b%s\b" % re.escape(sym), text):
|
||||
referenced[sym] = True
|
||||
|
||||
gaps = []
|
||||
for sym, rel_c in sorted(pages.items()):
|
||||
if not referenced[sym]:
|
||||
gaps.append("[GAP] %s | 页面未接入描述符表（%s 在 %s/ 内除自身外无引用 -> "
|
||||
"编译得过但菜单打不开，死代码；新增 UI 页面必须过本项）"
|
||||
% (rel_c, sym, UI_DIR_REL))
|
||||
return gaps, len(pages)
|
||||
|
||||
|
||||
def main():
|
||||
ap = argparse.ArgumentParser(description="双端注册反向校验（uvprojx + CMakeLists）")
|
||||
ap.add_argument("--strict", action="store_true",
|
||||
@@ -290,17 +358,21 @@ def main():
|
||||
if not os.path.isfile(os.path.join(REPO_ROOT, f.replace("/", os.sep))):
|
||||
gaps.append("[GAP] %s | 幽灵注册（CMakeLists）" % f)
|
||||
|
||||
# ④ UI 页面模块未接入描述符表（框架注册，U4；①②③ 照不出的盲区）
|
||||
ui_gaps, ui_pages = check_ui_page_wiring()
|
||||
gaps.extend(ui_gaps)
|
||||
|
||||
# 输出
|
||||
print("== 双端注册反向校验 ==")
|
||||
print("扫描 .c: %d | uvprojx(扫描范围): %d | CMakeLists(扫描范围): %d"
|
||||
% (len(scanned), len(uv_c), len(cmake_c)))
|
||||
print("扫描 .c: %d | uvprojx(扫描范围): %d | CMakeLists(扫描范围): %d | UI 页面模块: %d"
|
||||
% (len(scanned), len(uv_c), len(cmake_c), ui_pages))
|
||||
for w in warns:
|
||||
print(w)
|
||||
for g in gaps:
|
||||
print(g)
|
||||
|
||||
if gaps:
|
||||
print("结果: FAIL（%d 个新缺口/幽灵注册，%d 个存量 WARN）" % (len(gaps), len(warns)))
|
||||
print("结果: FAIL（%d 个新缺口/幽灵注册/页面未接线，%d 个存量 WARN）" % (len(gaps), len(warns)))
|
||||
return 1
|
||||
if warns:
|
||||
print("结果: PASS（无新缺口；%d 个存量缺口已白名单 WARN，N-23 Lead 处置中）" % len(warns))
|
||||
|
||||
Reference in New Issue
Block a user