UI 生成文件按工程约定产出：生成器补文件头、K&R 大括号与版本守卫压平

- gen_menu.py：ui_menu_tab.h/.c 输出工程标准文件头，5 个函数定义改 K&R 大括号
- make_font.py：新增 normalize_project_conventions 后处理——工程文件头
  （替换内嵌绝对路径的 lv_font_conv 头注释）、包含收敛为 #include "lvgl.h"、
  LVGL 9.3.0 版本守卫静态压平（含守卫宏定义清理）
- 重生成 ui_font_cn_12.c / ui_menu_tab.c / ui_menu_tab.h：仅头部/大括号/守卫
  行变化，字形数据与菜单表逐字节不变
- 两文件随之满足规范检查，pre-commit 中无需再排除（配合上一提交生效）

验证：pre-commit 全钩子通过、模拟器 0 警、菜单/内容页像素回归 PASS、Keil 0 错 0 警

Drivers/BSP/UI/ui_font_cn_12.c

@@ -1,20 +1,19 @@
-/*******************************************************************************
- * Size: 12 px
- * Bpp: 1
- * Opts: --font C:\Users\ADMINI~1\AppData\Local\Temp\simsun_regular.ttf --size 12 --bpp 1 -r 0x20-0x7E --symbols ▶三主事交件作保信值共关制前动化区压参双口号启告地址型复子字存定实密序式强归当录息户手抖护报据控掩操故数整无日时期本板查校检模死波流测清点版用界直看码硬程端第类系线终维网置自行装警认讯记设询软运通遥量钟钥防除面页馈验默，： --no-compress --format lvgl --lv-font-name ui_font_cn_12 -o D:\Code\DTU Code\STM32F4-Base\Drivers\BSP\UI\ui_font_cn_12.c
- ******************************************************************************/
+/*
+ * 模块名称：UI 中文位图字体（ui_font_cn_12，自动生成）
+ * 模块功能：中文子集 12px 位图字体（宋体；含 ▶ 箭头与全角逗号补回字形）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
+ * 作者：王建锋
+ * 创建日期：2026-08-30
+ * 修改记录：
+ *     2026-09-13  王建锋  工程约定规范化（文件头/包含路径/版本守卫压平），生成器同步更新
+ * 自动生成：本文件由 tools/font_gen/make_font.py（lv_font_conv --format lvgl）自动生成，请勿手改。
+ *           字符集：ui_cn_chars.txt（extract_cn.py）；改字符集或字体参数后重跑 make_font.py。
+ * 生成参数：宋体 (simsun.ttc face0), size=12, bpp=1, --no-compress。
+ */
 
-#ifdef LV_LVGL_H_INCLUDE_SIMPLE
 #include "lvgl.h"
-#else
-#include "lvgl/lvgl.h"
-#endif
 
-#ifndef UI_FONT_CN_12
-#define UI_FONT_CN_12 1
-#endif
 
-#if UI_FONT_CN_12
 
 /*-----------------
  *    BITMAPS
@@ -1110,16 +1109,8 @@ static const lv_font_fmt_txt_cmap_t cmaps[] =
  *  ALL CUSTOM DATA
  *--------------------*/
 
-#if LVGL_VERSION_MAJOR == 8
-/*Store all the custom data of the font*/
-static  lv_font_fmt_txt_glyph_cache_t cache;
-#endif
 
-#if LVGL_VERSION_MAJOR >= 8
 static const lv_font_fmt_txt_dsc_t font_dsc = {
-#else
-static lv_font_fmt_txt_dsc_t font_dsc = {
-#endif
     .glyph_bitmap = glyph_bitmap,
     .glyph_dsc = glyph_dsc,
     .cmaps = cmaps,
@@ -1129,9 +1120,6 @@ static lv_font_fmt_txt_dsc_t font_dsc = {
     .bpp = 1,
     .kern_classes = 0,
     .bitmap_format = 0,
-#if LVGL_VERSION_MAJOR == 8
-    .cache = &cache
-#endif
 };
 
 
@@ -1141,29 +1129,15 @@ static lv_font_fmt_txt_dsc_t font_dsc = {
  *----------------*/
 
 /*Initialize a public general font descriptor*/
-#if LVGL_VERSION_MAJOR >= 8
 const lv_font_t ui_font_cn_12 = {
-#else
-lv_font_t ui_font_cn_12 = {
-#endif
     .get_glyph_dsc = lv_font_get_glyph_dsc_fmt_txt,    /*Function pointer to get glyph's data*/
     .get_glyph_bitmap = lv_font_get_bitmap_fmt_txt,    /*Function pointer to get glyph's bitmap*/
     .line_height = 13,          /*The maximum line height required by the font*/
     .base_line = 2,             /*Baseline measured from the bottom of the line*/
-#if !(LVGL_VERSION_MAJOR == 6 && LVGL_VERSION_MINOR == 0)
     .subpx = LV_FONT_SUBPX_NONE,
-#endif
-#if LV_VERSION_CHECK(7, 4, 0) || LVGL_VERSION_MAJOR >= 8
     .underline_position = -1,
     .underline_thickness = 1,
-#endif
     .dsc = &font_dsc,          /*The custom font data. Will be accessed by `get_glyph_bitmap/dsc` */
-#if LV_VERSION_CHECK(8, 2, 0) || LVGL_VERSION_MAJOR >= 9
     .fallback = NULL,
-#endif
     .user_data = NULL,
 };
-
-
-
-#endif /*#if UI_FONT_CN_12*/

Drivers/BSP/UI/ui_menu_tab.c

@@ -1,5 +1,13 @@
-/* 本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成，请勿手改。
- * 修改菜单：编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
+/*
+ * 模块名称：UI 菜单节点表（自动生成）
+ * 模块功能：菜单节点扁平父子索引表 + 5 个表查询 API（导航逻辑层与显示层共用）
+ * 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
+ * 作者：王建锋
+ * 创建日期：2026-09-07
+ * 修改记录：
+ *     2026-09-13  王建锋  工程约定规范化（文件头 / K&R 大括号），内容由生成器自动更新
+ * 自动生成：本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成，请勿手改。
+ *           修改菜单：编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
  */
 #include "ui_menu_tab.h"
 
@@ -57,8 +65,7 @@ const ui_menu_node_t g_menu_tab[UI_MENU_TAB_COUNT] = {
  * 限定条件：node < UI_MENU_TAB_COUNT
  * 函数说明：子项 = 表中所有 parent == 本下标的行（表序即显示序）；建页核心查询
  */
-uint8_t ui_menu_tab_children(uint8_t node, uint8_t out[], uint8_t max)
-{
+uint8_t ui_menu_tab_children(uint8_t node, uint8_t out[], uint8_t max) {
     uint8_t n = 0u;
     for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT && n < max; i++) {
         if (g_menu_tab[i].parent == node) {
@@ -75,8 +82,7 @@ uint8_t ui_menu_tab_children(uint8_t node, uint8_t out[], uint8_t max)
  * 限定条件：node < UI_MENU_TAB_COUNT
  * 函数说明：菜单/叶子由"是否有子项"自动推导，无单独类型字段
  */
-bool ui_menu_tab_has_children(uint8_t node)
-{
+bool ui_menu_tab_has_children(uint8_t node) {
     for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT; i++) {
         if (g_menu_tab[i].parent == node) {
             return true;
@@ -92,8 +98,7 @@ bool ui_menu_tab_has_children(uint8_t node)
  * 限定条件：node < UI_MENU_TAB_COUNT
  * 函数说明：行文本一律经此取静态字符串，不 strdup
  */
-const char *ui_menu_tab_name(uint8_t node)
-{
+const char *ui_menu_tab_name(uint8_t node) {
     return g_menu_tab[node].name;
 }
 
@@ -104,8 +109,7 @@ const char *ui_menu_tab_name(uint8_t node)
  * 限定条件：无
  * 说明：表 pwd 列取自源 ui_menu_tree.txt 行尾 #P 注记；导航逻辑层据此决定是否先经密码页
  */
-bool ui_menu_tab_has_pwd(uint8_t node)
-{
+bool ui_menu_tab_has_pwd(uint8_t node) {
     return (g_menu_tab[node].pwd != 0u);
 }
 
@@ -116,8 +120,7 @@ bool ui_menu_tab_has_pwd(uint8_t node)
  * 限定条件：无
  * 函数说明：每个非根节点的 parent 必须为 MENU_ROOT 或有效下标；在 ui_menu_init 调用
  */
-bool ui_menu_tab_valid(void)
-{
+bool ui_menu_tab_valid(void) {
     for (uint8_t i = 0u; i < UI_MENU_TAB_COUNT; i++) {
         if (i == 0u) {
             continue;   /* 根 */

Drivers/BSP/UI/ui_menu_tab.h

@@ -1,5 +1,13 @@
-/* 本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成，请勿手改。
- * 修改菜单：编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
+/*
+ * 模块名称：UI 菜单节点表头文件（自动生成）
+ * 模块功能：菜单节点结构、表规模护栏与表查询 API 声明
+ * 适用平台：STM32F407ZGTx / PC 模拟器（共用源码）
+ * 作者：王建锋
+ * 创建日期：2026-09-07
+ * 修改记录：
+ *     2026-09-13  王建锋  工程约定规范化（文件头），内容由生成器自动更新
+ * 自动生成：本文件由 tools/menu_gen/gen_menu.py 从 ui_menu_tree.txt 自动生成，请勿手改。
+ *           修改菜单：编辑 ui_menu_tree.txt 后重跑 `python tools/menu_gen/gen_menu.py`。
  */
 #ifndef UI_MENU_TAB_H
 #define UI_MENU_TAB_H