wandering1
c936441c83
本轮把"自研代码落在门禁之外"的口子收掉，同时落地 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）
simulator/sim/ — 模拟器平台层
PC 端 LVGL 模拟器的平台适配层：把 MCU 侧的硬件/RTOS 接口替换成 PC 实现， 使 UI 源码（
Drivers/BSP/UI/）与固件共用同一套代码。
文件一览
| 文件 | 替换的 MCU 侧实现 | 作用 |
|---|---|---|
sim_port.c/h |
ui_port.c |
显示/输入移植层：SDL 窗口 → LVGL 显示驱动 + 键鼠/触摸输入 |
net_socket_sim.c |
net_socket.c |
网络 Socket 的 PC 实现（宿主 BSD socket） |
cfg_file_store_sim.c |
cfg_file_store_mcu.c |
配置存储的 PC 后端（宿主堆） |
sim_syslog.c |
sys_log_mcu.c |
日志的 PC 实现（写文件而非 NAND） |
ui_net_sink_backend_sim.c |
ui_net_sink_backend_mcu.c |
推流后端的 PC 实现 |
sim_latency_stub.c |
— | 时延打桩（模拟链路延迟，供测试） |
设计模式
MCU 与模拟器共用核心逻辑，仅后端不同：
共享核心（无分配符号）
├── cfg_file.c（配置引擎）
└── ui_*（LVGL UI）
↓ 后端抽象接口
┌─────────┴─────────┐
MCU 后端（本工程 *_mcu.c） PC 后端（本目录 *_sim.c）
配置引擎后端：MCU = FreeRTOS 堆、模拟器 = 宿主堆，共享核心零分配符号。
相关文档
- 模拟器总说明：
../README.md - UI 架构与移植要点：
docs/UI设计/UI_设计架构.md - 模拟器部署：
docs/UI设计/LVGL模拟器部署与使用说明.md