门禁扩容：新增 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）

simulator/sim/net_socket_sim.c

@@ -53,8 +53,7 @@ static int        s_generation  = 0;        /* 网络代次（模拟器恒为 0
  * 限定条件：无
  * 函数说明：任何 Socket 操作前先调用；已初始化则直接返回
  */
-static int ensure_wsa(void)
-{
+static int ensure_wsa(void) {
     static int s_done = 0;
 
     if (s_done == 0) {
@@ -75,8 +74,7 @@ static int ensure_wsa(void)
  * 限定条件：s_socks 已定义
  * 函数说明：线性扫描，返回首个 in_use == 0 的控制块索引
  */
-static int alloc_fd(void)
-{
+static int alloc_fd(void) {
     int i;
 
     for (i = 0; i < NET_MAX_SOCKETS; i++) {
@@ -96,8 +94,7 @@ static int alloc_fd(void)
  * 限定条件：两结构体布局一致（均 16 字节，字段偏移相同）
  * 函数说明：字段偏移一致，按 sizeof 直接拷贝
  */
-static void to_ws_addr(const struct net_sockaddr *addr, struct sockaddr_in *out)
-{
+static void to_ws_addr(const struct net_sockaddr *addr, struct sockaddr_in *out) {
     memcpy(out, addr, sizeof(struct sockaddr_in));
 }
 
@@ -110,8 +107,7 @@ static void to_ws_addr(const struct net_sockaddr *addr, struct sockaddr_in *out)
  * 限定条件：两结构体布局一致（均 16 字节，字段偏移相同）
  * 函数说明：字段偏移一致，按 sizeof 直接拷贝
  */
-static void from_ws_addr(const struct sockaddr_in *in, struct net_sockaddr *out)
-{
+static void from_ws_addr(const struct sockaddr_in *in, struct net_sockaddr *out) {
     memcpy(out, in, sizeof(struct sockaddr_in));
 }
 
@@ -123,8 +119,7 @@ static void from_ws_addr(const struct sockaddr_in *in, struct net_sockaddr *out)
  * 限定条件：无
  * 函数说明：与 MCU 端 net_init 语义对齐，供上层统一调用
  */
-int net_init(const char *ip, const char *mask, const char *gateway, const uint8_t *mac)
-{
+int net_init(const char *ip, const char *mask, const char *gateway, const uint8_t *mac) {
     (void)ip;
     (void)mask;
     (void)gateway;
@@ -145,8 +140,7 @@ int net_init(const char *ip, const char *mask, const char *gateway, const uint8_
  * 限定条件：无
  * 函数说明：模拟器无网络重建，代次恒 0，使上层代次自愈逻辑空转
  */
-uint32_t net_get_generation(void)
-{
+uint32_t net_get_generation(void) {
     return (uint32_t)s_generation;
 }
 
@@ -157,8 +151,7 @@ uint32_t net_get_generation(void)
  * 限定条件：无
  * 函数说明：模拟器不会触发，保留接口以对齐 API
  */
-void net_generation_inc(void)
-{
+void net_generation_inc(void) {
     s_generation++;
 }
 
@@ -169,8 +162,7 @@ void net_generation_inc(void)
  * 限定条件：无
  * 函数说明：模拟器无 CH395F 中断，空操作
  */
-int net_poll(void)
-{
+int net_poll(void) {
     return 0;
 }
 
@@ -183,8 +175,7 @@ int net_poll(void)
  * 限定条件：Winsock 已就绪
  * 函数说明：分配空闲控制块，创建 Winsock SOCKET 并置非阻塞
  */
-int net_socket(int domain, int type)
-{
+int net_socket(int domain, int type) {
     int idx;
     int is_udp;
     SOCKET ws;
@@ -238,8 +229,7 @@ int net_socket(int domain, int type)
  * 限定条件：socket 已创建
  * 函数说明：设置 SO_REUSEADDR 后 bind，便于断线后重监听复用端口
  */
-int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen)
-{
+int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen) {
     struct sockaddr_in wsaddr;
     int yes = 1;
 
@@ -273,8 +263,7 @@ int net_bind(int sockfd, const struct net_sockaddr *addr, int addrlen)
  * 限定条件：socket 已绑定
  * 函数说明：backlog 为 1（单客户端），监听 Socket 保持非阻塞
  */
-int net_listen(int sockfd)
-{
+int net_listen(int sockfd) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
         s_net_errno = NET_ERR_BADF;
         return -1;
@@ -301,8 +290,7 @@ int net_listen(int sockfd)
  * 函数说明：非阻塞监听下无新连接时返回 -1 并置 NET_ERR_WOULDBLOCK；
  *          与 MCU 端不同，Winsock 的 accept 返回独立于监听 Socket 的新 fd
  */
-int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen)
-{
+int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen) {
     struct sockaddr_in wscli;
     int wslen;
     SOCKET cws;
@@ -356,8 +344,7 @@ int net_accept(int sockfd, struct net_sockaddr *addr, int *addrlen)
  *          而 accept 本就是非阻塞的、**没有 MCU 端的 RPC 成本** → 恒返回 1，
  *          使上层门控在模拟器上等价于"改前行为"（逐位一致，不引入新语义）
  */
-int net_can_accept(int sockfd)
-{
+int net_can_accept(int sockfd) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
         return 0;
     }
@@ -372,8 +359,7 @@ int net_can_accept(int sockfd)
  * 函数说明：同 net_can_accept——Winsock recv 非阻塞、无 RPC 成本 → 恒返回 1，
  *          上层门控在模拟器上不改变既有行为（含"每轮都 recv"的自愈特性）
  */
-int net_can_read(int sockfd)
-{
+int net_can_read(int sockfd) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
         return 0;
     }
@@ -390,8 +376,7 @@ int net_can_read(int sockfd)
  * 限定条件：socket 已创建
  * 函数说明：非阻塞 Socket 上连接未完成时返回 -1 + NET_ERR_WOULDBLOCK
  */
-int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen)
-{
+int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen) {
     struct sockaddr_in wsaddr;
 
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
@@ -430,8 +415,7 @@ int net_connect(int sockfd, const struct net_sockaddr *addr, int addrlen)
  * 函数说明：非阻塞单次发送（保持 UI 主循环不阻塞）；协议帧小且对端主动
  *          读取，实践中一次即发完
  */
-int net_send(int sockfd, const void *buf, int len, int flags)
-{
+int net_send(int sockfd, const void *buf, int len, int flags) {
     int r;
 
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
@@ -473,8 +457,7 @@ int net_send(int sockfd, const void *buf, int len, int flags)
  * 函数说明：与 MCU 端语义一致——>0 有数据，0 对端关闭，<0 且 errno 区分
  *          "暂无数据"与"真错误"
  */
-int net_recv(int sockfd, void *buf, int len, int flags)
-{
+int net_recv(int sockfd, void *buf, int len, int flags) {
     int r;
 
     (void)flags;
@@ -519,8 +502,7 @@ int net_recv(int sockfd, void *buf, int len, int flags)
  * 限定条件：socket 已创建，buf/dest_addr 非空
  */
 int net_sendto(int sockfd, const void *buf, int len, int flags,
-              const struct net_sockaddr *dest_addr, int addrlen)
-{
+              const struct net_sockaddr *dest_addr, int addrlen) {
     struct sockaddr_in wsaddr;
     int r;
 
@@ -563,8 +545,7 @@ int net_sendto(int sockfd, const void *buf, int len, int flags,
  * 限定条件：socket 已创建，buf 非空
  */
 int net_recvfrom(int sockfd, void *buf, int len, int flags,
-                struct net_sockaddr *src_addr, int *addrlen)
-{
+                struct net_sockaddr *src_addr, int *addrlen) {
     struct sockaddr_in wsaddr;
     int wslen;
     int r;
@@ -606,8 +587,7 @@ int net_recvfrom(int sockfd, void *buf, int len, int flags,
  * 限定条件：socket 已打开（in_use == 1）
  * 函数说明：关闭 Winsock 句柄并释放控制块（in_use 清零，net_get_sock 转返回 NULL）
  */
-int net_close(int sockfd)
-{
+int net_close(int sockfd) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
         s_net_errno = NET_ERR_BADF;
         return -1;
@@ -636,8 +616,7 @@ int net_close(int sockfd)
  * 限定条件：socket 已创建
  * 函数说明：模拟器以非阻塞 I/O 直接感知事件，回调仅存储不主动触发
  */
-int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg)
-{
+int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS || s_socks[sockfd].in_use == 0) {
         s_net_errno = NET_ERR_BADF;
         return -1;
@@ -656,8 +635,7 @@ int net_set_event_cb(int sockfd, net_event_cb_t cb, void *arg)
  * 返回值：最近一次 net_* 操作设置的错误码（NET_OK / NET_ERR_xxx）
  * 限定条件：无
  */
-int net_get_errno(void)
-{
+int net_get_errno(void) {
     return s_net_errno;
 }
 
@@ -669,8 +647,7 @@ int net_get_errno(void)
  * 限定条件：无
  * 函数说明：逐段解析后按 NET_HTONL 转网络字节序（与 MCU 端实现一致）
  */
-uint32_t net_inet_addr(const char *cp)
-{
+uint32_t net_inet_addr(const char *cp) {
     uint32_t addr = 0;
     int i;
 
@@ -701,8 +678,7 @@ uint32_t net_inet_addr(const char *cp)
  * 返回值：buf 指针（buf 为 NULL 时返回 NULL）
  * 限定条件：buf 非空且长度足够
  */
-char *net_inet_ntoa(uint32_t addr, char *buf)
-{
+char *net_inet_ntoa(uint32_t addr, char *buf) {
     uint32_t naddr = NET_NTOHL(addr);
 
     if (buf == NULL) {
@@ -724,8 +700,7 @@ char *net_inet_ntoa(uint32_t addr, char *buf)
  * 返回值：网络序端口
  * 限定条件：无
  */
-uint16_t net_htons(uint16_t hostshort)
-{
+uint16_t net_htons(uint16_t hostshort) {
     return NET_HTONS(hostshort);
 }
 
@@ -735,8 +710,7 @@ uint16_t net_htons(uint16_t hostshort)
  * 返回值：主机序端口
  * 限定条件：无
  */
-uint16_t net_ntohs(uint16_t netshort)
-{
+uint16_t net_ntohs(uint16_t netshort) {
     return NET_NTOHS(netshort);
 }
 
@@ -746,8 +720,7 @@ uint16_t net_ntohs(uint16_t netshort)
  * 返回值：网络序 IP
  * 限定条件：无
  */
-uint32_t net_htonl(uint32_t hostlong)
-{
+uint32_t net_htonl(uint32_t hostlong) {
     return NET_HTONL(hostlong);
 }
 
@@ -757,8 +730,7 @@ uint32_t net_htonl(uint32_t hostlong)
  * 返回值：主机序 IP
  * 限定条件：无
  */
-uint32_t net_ntohl(uint32_t netlong)
-{
+uint32_t net_ntohl(uint32_t netlong) {
     return NET_NTOHL(netlong);
 }
 
@@ -769,8 +741,7 @@ uint32_t net_ntohl(uint32_t netlong)
  * 限定条件：无
  * 函数说明：上层据此判断"监听 Socket 是否随客户端一同失效"（单连接模型）
  */
-net_sock_t *net_get_sock(int sockfd)
-{
+net_sock_t *net_get_sock(int sockfd) {
     if (sockfd < 0 || sockfd >= NET_MAX_SOCKETS) {
         return NULL;
     }
@@ -790,8 +761,7 @@ net_sock_t *net_get_sock(int sockfd)
  * 限定条件：socket 已创建
  * 函数说明：经 Winsock getsockname 读取实际绑定地址
  */
-int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen)
-{
+int net_getsockname(int sockfd, struct net_sockaddr *addr, int *addrlen) {
     struct sockaddr_in wsaddr;
     int wslen;
 

simulator/sim/sim_port.c

@@ -25,8 +25,7 @@ static lv_indev_t *g_kbd_indev = NULL;
  *           2. 创建键盘输入设备及默认输入组
  *           3. 不创建鼠标/触摸设备（模拟器仅用键盘导航）
  */
-int sim_port_init(int32_t hor_res, int32_t ver_res)
-{
+int sim_port_init(int32_t hor_res, int32_t ver_res) {
     /* 创建默认输入组 */
     lv_group_t *g = lv_group_create();
     if (g == NULL) {
@@ -65,8 +64,7 @@ int sim_port_init(int32_t hor_res, int32_t ver_res)
  * 返回值：显示设备指针  lv_display_t *  可能为 NULL
  * 限定条件：sim_port_init() 已成功调用
  */
-void *sim_port_get_display(void)
-{
+void *sim_port_get_display(void) {
     return (void *)lv_display_get_default();
 }
 
@@ -83,8 +81,7 @@ void *sim_port_get_display(void)
  *           转换，直接读 get_buf_active 不可靠；读回屏幕呈现像素最稳，
  *           且完全避开快照离屏重渲染（SDL 驱动下会卡派发循环）
  */
-int sim_port_get_screen_mono(uint8_t *buf, uint32_t buf_size)
-{
+int sim_port_get_screen_mono(uint8_t *buf, uint32_t buf_size) {
     if (buf == NULL) {
         return -1;
     }

simulator/sim/sim_port.h

@@ -4,8 +4,8 @@
  * 适用平台：Windows / Linux / macOS (SDL2)
  * 说明：替代 MCU 端的 ui_port.c，用于 PC 上 UI 开发与调试
  */
-#ifndef __SIM_PORT_H
-#define __SIM_PORT_H
+#ifndef SIM_PORT_H
+#define SIM_PORT_H
 
 #include <stdint.h>
 
@@ -47,4 +47,4 @@ int sim_port_get_screen_mono(uint8_t *buf, uint32_t buf_size);
 }
 #endif
 
-#endif /* __SIM_PORT_H */
+#endif /* SIM_PORT_H */

simulator/sim/sim_syslog.c

@@ -32,16 +32,16 @@ static const uint32_t s_caps[SYSLOG_COUNT] = { SYSLOG_RUN_MAX, SYSLOG_SELFTEST_M
  */
 static void s_now(char *p_ts, uint32_t *p_epoch) {
     time_t t = time(NULL);
-    struct tm tmv;
+    struct tm tmv = {0};   /* 显式清零：localtime_s/r 是"输出型"参数，静态分析按未初始化报 */
 
 #if defined(_WIN32)
     localtime_s(&tmv, &t);
 #else
     localtime_r(&t, &tmv);
 #endif
-    (void)sprintf(p_ts, "%04d-%02d-%02d %02d:%02d:%02d",
-                  tmv.tm_year + 1900, tmv.tm_mon + 1, tmv.tm_mday,
-                  tmv.tm_hour, tmv.tm_min, tmv.tm_sec);
+    (void)snprintf(p_ts, SYSLOG_TS_LEN + 1u, "%04d-%02d-%02d %02d:%02d:%02d",
+                   tmv.tm_year + 1900, tmv.tm_mon + 1, tmv.tm_mday,
+                   tmv.tm_hour, tmv.tm_min, tmv.tm_sec);
     *p_epoch = (uint32_t)t;
 }
 
@@ -68,7 +68,9 @@ static int s_append(syslog_id_t id, const char *desc) {
     s_now(ts, &epoch);
     memcpy(rec, ts, SYSLOG_TS_LEN);
     rec[SYSLOG_TS_LEN] = ' ';
-    (void)sprintf((char *)(rec + SYSLOG_EPOCH_OFFS), "%010u", (unsigned int)epoch);
+    /* +1 = 容纳 NUL；字段本身固定 10 位数字，与旧 sprintf 写入字节数完全一致 */
+    (void)snprintf((char *)(rec + SYSLOG_EPOCH_OFFS), SYSLOG_EPOCH_LEN + 1u,
+                   "%010u", (unsigned int)epoch);
     rec[SYSLOG_DESC_OFFS - 1u] = ' ';
     dl = strlen(desc);
     if (dl > SYSLOG_DESC_MAX) {
@@ -185,7 +187,12 @@ int syslog_last_epoch(syslog_id_t id, uint32_t *p_epoch) {
     uint32_t v = 0u;
     uint32_t i;
 
-    if (p_epoch == NULL || syslog_count(id) == 0u) {
+    /* 先判空再写：旧写法 `if (p_epoch == NULL || ...)` 之后立刻 *p_epoch = 0，
+     * 一旦调用方真传 NULL 就是空指针解引用（cppcheck nullPointerRedundantCheck 实报） */
+    if (p_epoch == NULL) {
+        return -1;
+    }
+    if (syslog_count(id) == 0u) {
         *p_epoch = 0u;
         return -1;
     }

simulator/sim/ui_net_sink_backend_sim.c

@@ -21,8 +21,7 @@
  * 限定条件：无
  * 函数说明：远端按键码与 LVGL 按键码一一对应
  */
-static uint32_t sim_map_key(uint8_t remo_key)
-{
+static uint32_t sim_map_key(uint8_t remo_key) {
     switch (remo_key) {
         case UI_KEY_UP:    return LV_KEY_UP;
         case UI_KEY_DOWN:  return LV_KEY_DOWN;
@@ -43,8 +42,7 @@ static uint32_t sim_map_key(uint8_t remo_key)
  * 函数说明：窗口模式显示缓冲经 I1→ARGB8888 转换，不能直读，
  *          故读回屏幕像素再按红通道阈值打包 1bpp（布局与 MCU 端一致）
  */
-int ui_net_sink_get_lcdmem(uint8_t *out, uint32_t out_size)
-{
+int ui_net_sink_get_lcdmem(uint8_t *out, uint32_t out_size) {
     if (out == NULL || out_size < UI_NET_SINK_MONO_SIZE) {
         return -1;
     }
@@ -58,8 +56,7 @@ int ui_net_sink_get_lcdmem(uint8_t *out, uint32_t out_size)
  * 限定条件：默认输入组已建立
  * 函数说明：映射为 LV_KEY_* 后经 lv_group_send_data 发向焦点对象
  */
-void ui_net_sink_inject_key(uint8_t remo_key)
-{
+void ui_net_sink_inject_key(uint8_t remo_key) {
     lv_group_t *g;
     uint32_t key;