chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号） 一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、 采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。 门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏 undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8 reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF； id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。 test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字， 是本批唯一改变构建产物的文件集合。 为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged 部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、 不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。 实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01% （基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 / 告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。 基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处 引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使 识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。 ⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二 根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有）， 今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。 固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0； App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889 断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿； check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带 BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。 .cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法： Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。 同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%， RW_CCM 57,376 B / 87.9%，阈值 92%。
This commit is contained in:
@@ -2,7 +2,7 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""check_registration.py - 双端注册反向校验门禁（纯标准库）。
|
||||
|
||||
背景（登记簿 N-23，出处审查报告 N-06 残余）:
|
||||
背景（登记簿条目「rs485_task 白名单缺口」）:
|
||||
本工程 Keil 工程与 PC 模拟器都用**显式文件列表**（无通配扫描）。新 `.c`
|
||||
必须手动注册两处才会被编译：
|
||||
① `MDK-ARM/STM32F407-Demo.uvprojx` 的 `<FilePath>` 条目（MCU 固件构建）
|
||||
@@ -16,7 +16,7 @@
|
||||
② 存在但未进 CMakeLists -> 模拟器不编译（**仅当该文件本应进模拟器时**才是缺口；
|
||||
MCU-only 文件不进模拟器是**正确**的，见下方豁免）
|
||||
③ 注册了但文件不存在（反向）-> 幽灵注册（改名/删除后残留的注册条目）
|
||||
另对 UI 页面模块（U4 门禁补强，2026-10-15，报告 §6.5）：
|
||||
另对 UI 页面模块（UI 字符集与像素回归门禁补强，2026-10-15，报告 §6.5）：
|
||||
④ `Drivers/BSP/UI/ui_page_*.c` 定义了 `ui_page_<name>_desc`，但该符号在 UI 目录内
|
||||
除自身 .c/.h 外无任何引用 -> 页面未接入
|
||||
`ui_content_page.c` 的 `s_defs[]` 描述符表：两端**编译
|
||||
@@ -29,12 +29,12 @@
|
||||
模拟器只建模 **UI + 网络配置共享核心**；其余模块（MCU 驱动 / 固件任务 / 纯算法 /
|
||||
CubeMX 生成层）**不进模拟器是设计事实**，模拟器另有 `_sim` 替身或根本无对应。
|
||||
豁免用**显式清单 + 每行理由注释**（命名模式 `*_mcu.c` + 个别点名），
|
||||
**不做整目录一刀切**（N-23 教训正是"目录级盲区"）。唯一例外是 `Src/`：
|
||||
**不做整目录一刀切**（这一项的教训正是"目录级盲区"）。唯一例外是 `Src/`：
|
||||
CubeMX 生成的外设初始化/中断/main，按构造即 MCU 专属、不可能有模拟器替身，
|
||||
故整目录豁免（任务口径明确认可"Src/ 全部"）。
|
||||
|
||||
已知缺口过渡（存量不拦、只对新缺口 FAIL）:
|
||||
`KNOWN_GAPS` 登记存量缺口（N-23 存量，Lead 处置中）：命中 -> 打印 `[WARN]` 不拦；
|
||||
`KNOWN_GAPS` 登记存量缺口（白名单存量，Lead 处置中）：命中 -> 打印 `[WARN]` 不拦；
|
||||
新出现的缺口 -> 打印 `[GAP]` 并 FAIL。`--strict` 关闭白名单（存量也 FAIL），供审计。
|
||||
|
||||
退出码:
|
||||
@@ -46,7 +46,7 @@
|
||||
& '.venv\\Scripts\\python.exe' scripts/check_registration.py
|
||||
& '.venv\\Scripts\\python.exe' scripts/check_registration.py --strict
|
||||
|
||||
设计依据：docs/任务规划/登记簿.md N-23；.dsh/skills/new-source-file
|
||||
设计依据：docs/任务规划/登记簿.md 条目「rs485_task 白名单缺口」；.dsh/skills/new-source-file
|
||||
创建日期：2026-10-12
|
||||
"""
|
||||
|
||||
@@ -138,10 +138,10 @@ SIM_EXEMPT = [
|
||||
("Drivers/BSP/UI/ui_port.c", "MCU UI 端口层（显示/触摸硬件），模拟器另有 sim/sim_port.c"),
|
||||
]
|
||||
|
||||
# --- 已知缺口白名单（存量，N-23，Lead 已处置）---
|
||||
# --- 已知缺口白名单（存量，Lead 已处置）---
|
||||
# 命中 -> WARN 不拦；新缺口 -> GAP FAIL。仅针对"存在但未注册"方向。
|
||||
KNOWN_GAPS = {
|
||||
"App/task/rs485_task.c": "E-59 门禁刻意未接线（B2 消费者就绪时随任务立项注册）",
|
||||
"App/task/rs485_task.c": "RS-485 接线门禁（驱动契约未修完，随 B2 暂缓）",
|
||||
}
|
||||
|
||||
|
||||
@@ -250,7 +250,7 @@ def parse_cmake():
|
||||
return sources
|
||||
|
||||
|
||||
# --- UI 页面模块 → 描述符表接线（④，U4 门禁补强）---
|
||||
# --- UI 页面模块 → 描述符表接线（④，UI 字符集与像素回归门禁补强）---
|
||||
UI_DIR_REL = "Drivers/BSP/UI"
|
||||
|
||||
|
||||
@@ -261,7 +261,7 @@ def check_ui_page_wiring():
|
||||
（`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` 承载表引用，
|
||||
`ui_page_*.c` 不是页面模块——未来 UI 页面原型化生成的 `ui_page_registry.c` 承载表引用，
|
||||
本规则依旧成立且不会把它误判为页面）；引用面 = `Drivers/BSP/UI/` 下全部 .c/.h，
|
||||
排除该页自身 .c/.h（自身头文件里的 extern 声明不算接线）。
|
||||
"""
|
||||
@@ -363,7 +363,7 @@ 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 页面模块未接入描述符表（框架注册，UI 字符集与像素回归门禁；①②③ 照不出的盲区）
|
||||
ui_gaps, ui_pages = check_ui_page_wiring()
|
||||
gaps.extend(ui_gaps)
|
||||
|
||||
@@ -380,7 +380,7 @@ def main():
|
||||
print("结果: FAIL（%d 个新缺口/幽灵注册/页面未接线，%d 个存量 WARN）" % (len(gaps), len(warns)))
|
||||
return 1
|
||||
if warns:
|
||||
print("结果: PASS（无新缺口；%d 个存量缺口已白名单 WARN，N-23 Lead 处置中）" % len(warns))
|
||||
print("结果: PASS（无新缺口；%d 个存量缺口已白名单 WARN，白名单缺口由 Lead 处置中）" % len(warns))
|
||||
return 0
|
||||
print("结果: PASS（双端注册一致）")
|
||||
return 0
|
||||
|
||||
Reference in New Issue
Block a user