门禁扩容：新增 lv-conf-sync、simulator/ 纳入全部钩子；含 L3 定值/元件框架落地

本轮把"自研代码落在门禁之外"的口子收掉，同时落地 LVGL 特性裁剪与 L3 保护定值/元件框架。门禁（.pre-commit-config.yaml，26 个钩子） - 新增 scripts/check_lv_conf_sync.py + 钩子 lv-conf-sync：比对两份 lv_conf.h 的**生效值**（未定义则取 lv_conf_internal.h 兜底默认），抓 MISMATCH / LVGL 不认的宏名 / 同文件重复定义 - 顶层 exclude 删掉 simulator/：其下 21 个 tracked 文件全是本项目自研代码，生成物（build/、SDL2/、tests/ref/、shot*）已在 .gitignore； doc-links 的 exclude 同步删除 - lv-conf-sync 的 files: 覆盖两端配置 → 只改 simulator/lv_conf.h 也触发（pre-commit 4.x 已移除 always: true，实测只告警并跳过，无兜底开关） - 新增 prot-set-unit-test / prot-elm-unit-test 两个主机侧单测钩子 - S11(2.3.5) 判定细化：禁的是"用路径找文件"，尖括号系统头带子目录（如 <sys/stat.h>）不再误报；全仓库复核仅 2 处项目代码判定变化模拟器代码整改（纳入钩子后暴露，全部修代码而非豁免） - cppcheck 4 处：sim_syslog.c 判空分支内解引用 p_epoch（真实 bug）、 2 处 struct tm 未初始化、1 处指针可加 const - coding-standard 61 处：44 处函数左大括号并到右括号同行、8 处补函数注释、3 处补文件头注释块、2 处 __ 前缀保护宏改 XXX_H、2 处 sprintf 改 snprintf（写入字节数与原来完全一致） LVGL 特性裁剪（F-1/F-2/F-3） - 两端 lv_conf.h 对齐同一特性子集：删 26 个 LVGL 9.3 不存在的选项名、 3 处重复定义，10 项靠默认值隐式生效的改为显式固化 - 实测对镜像体积中性；价值在防漂移，且模拟器 golden 回归跑的正是固件实际编译的配置 L3 软件侧 - App/algo/prot_set.* Q10 定值模型（范围校验 / 整表 all-or-nothing / 校验和封存-自检-闭锁）+ prot_elm.* 通用"滞回+定时限"元件框架 7 实例 - test/host/prot_set、test/host/prot_elm 主机侧单测；uvprojx 挂载两处文档同步 - pre-commit使用说明：§2.8 S11 口径、§2.15 lv-conf-sync 详解、新增 §5.5 复盘（教训：exclude 只写真正不该进钩子的路径） - AGENTS.md、UI_设计架构 §1.4 第 10 条、RAM 分析、审查报告刷新与销项验证 - @build BUILD_OK 0/0（Code=194276 RO=15872 RW=876 ZI=139892） - 模拟器重建：菜单 8 状态像素逐字节一致（池 5368 B）、11 内容页黄金参考全过（往返 5448 B）、remo sink 0/25600 位差异、--logtest/--cfgtest PASS - 全仓库 cppcheck / coding-standard / no-mojibake --all-files 全过 - check_doc_links --all 129/0；check_mem_numbers --check 内存数字一致 - 端到端：往 simulator/lv_conf.h 注入一行漂移 → 钩子 FAIL（exit 1）
2026-10-11 08:48:49 +08:00
parent 13a4e61c27
commit c936441c83
36 changed files with 2220 additions and 565 deletions
@@ -2,11 +2,18 @@
 # 详见 docs/代码规范/pre-commit使用说明.md
 default_install_hook_types: [pre-commit, commit-msg]

+# 顶层 exclude 只挡**第三方与生成物**。
+# ⚠ 2026-10-11 修正：原先在这里整目录挡 `simulator/` 是错的——`simulator/` 下 21 个
+#   tracked 文件**全是本项目自研代码**（模拟器入口 main.c、平台后端 sim/*.c、回归脚本
+#   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 索引 → 无需在此重复豁免，故直接删掉该条。
 exclude: |
  (?x)^(
    \.opencode/node_modules/|
    Lib/lvgl/|
-    simulator/|
    MDK-ARM/RTE/
  )

@@ -153,11 +160,11 @@ repos:
        language: system
        files: \.md$
        # 外部资料（芯片手册转录）链接形态不受控；第三方目录整体排除
+        # （`simulator/` 已不再排除：其下 3 个 README 是本项目文档，2026-10-11）
        exclude: |
          (?x)^(
            \.opencode/node_modules/|
            Lib/lvgl/|
-            simulator/|
            MDK-ARM/RTE/|
            docs/芯片手册/
          )
@@ -177,6 +184,27 @@ repos:
        files: ^(docs/内存管理/.*\.md|scripts/check_mem_numbers\.py|App/.*\.c|App/.*\.h|Src/.*\.c|Inc/.*\.h)$
        pass_filenames: false

+      # 5d) 两份 lv_conf.h 特性子集一致性（2026-10-11 加，随 F-1/F-2/F-3 落地）
+      #     背景：`Lib/lv_conf.h`（MCU）与 `simulator/lv_conf.h`（PC）是两份独立文件，
+      #     此前长期漂移——模拟器早已 I1-only，MCU 端却让 11 个 `LV_DRAW_SW_SUPPORT_*`、
+      #     5 个未用控件类、`LV_USE_THEME_SIMPLE`、`LV_USE_FLEX/GRID` 靠 lv_conf_internal
+      #     默认值隐式生效 → 固件白链 **64,576 B 死代码**，且模拟器 golden 回归跑的是
+      #     另一套特性子集（等于验证不到固件实际编译的配置）。
+      #     口径：比对**生效值**（文件未定义则取 lv_conf_internal.h 的兜底默认），
+      #     并抓"写了 LVGL 不认的宏名"（`LV_USE_THEME_BASIC` 同类，实测两端共 26 处）
+      #     与同文件重复定义。规则正文见 docs/UI设计/UI_设计架构.md §1.4 第 10 条。
+      #     ⚠ 触发范围（2026-10-11 两次修正）：本钩子由**两端任一配置**或脚本自身触发。
+      #       原先顶层 exclude 整目录挡掉 `simulator/`，导致"只改 simulator/lv_conf.h"
+      #       的提交拦不到；已删该条（见文件顶部 exclude 注释），故这里可直接匹配
+      #       `simulator/lv_conf.h`。（pre-commit 4.x 已移除 `always: true`，
+      #       实测对 local 钩子只告警并跳过——不能靠它兜底。）
+      - id: lv-conf-sync
+        name: 两份 lv_conf.h 特性子集一致性
+        entry: python scripts/check_lv_conf_sync.py
+        language: system
+        files: ^(Lib/lv_conf\.h|simulator/lv_conf\.h|scripts/check_lv_conf_sync\.py)$
+        pass_filenames: false
+
      # 6) CubeMX 重生成存活审计（2026-09-29 加）
      #    背景：.ioc 的 KeepUserCode 只保护 USER CODE 标记区；标记之外的手工改动
      #    重生成即被覆盖，且多数不报编译错（崩溃采集被打回空 while(1)、加固宏被删）。
@@ -304,6 +332,28 @@ repos:
        files: ^(App/algo/adc_health\.(c|h)|App/task/adc_task\.c|test/host/adc_health/.*|test/host/common/unit_test_harness\.py)$
        pass_filenames: false

+      # 7i) 保护定值模型（P1 / L5-1 载体）主机侧单元测试（2026-10-11 加）
+      #     定值是保护动作的"输入宪法"：范围校验、整表装载 all-or-nothing、
+      #     校验和封存-自检-闭锁（参考 tagPRS dwTagSum/dwTagSumN 模式）必须在
+      #     任何元件接线之前钉死——板端无法穷举越界定值注入，主机侧毫秒级全跑。
+      - id: prot-set-unit-test
+        name: 保护定值模型单测（主机侧）
+        entry: python test/host/prot_set/run_unit_test.py
+        language: system
+        files: ^(App/algo/prot_set\.(c|h)|test/host/prot_set/.*|test/host/common/unit_test_harness\.py)$
+        pass_filenames: false
+
+      # 7j) 保护元件框架（L3 P1 子集）主机侧单元测试（2026-10-11 加）
+      #     判据核（滞回/定时限/欠量方向/闭锁联动/时基回绕）是纯逻辑，
+      #     板端复现需要标准源 + 故障注入，主机侧用合成测量序列即可穷举
+      #     1.2×/0.9× 验收口径（规划 §8）。
+      - id: prot-elm-unit-test
+        name: 保护元件框架单测（主机侧）
+        entry: python test/host/prot_elm/run_unit_test.py
+        language: system
+        files: ^(App/algo/prot_elm\.(c|h)|App/algo/prot_set\.(c|h)|App/algo/phasor\.(c|h)|test/host/prot_elm/.*|test/host/common/unit_test_harness\.py)$
+        pass_filenames: false
+
      # 8) 测试套件开关门禁（2026-10-01 加）
      #    背景：test_config.h 的 TEST_SUITE_* 决定固件里编入哪个测试套件，
      #    全部注释 = 产品构建。但此前**无任何门禁检查**——实测已提交的 HEAD 里