模拟器构建入口改VS版本自适应（新增build_sim，兼容VS2019/2022/2026）；文档同步并补SDL2 SDK下载步骤

simulator/README.md

@@ -12,6 +12,7 @@
 ```
 simulator/
 ├── CMakeLists.txt          # 构建脚本（CMake + MSVC，x64）
+├── build_sim.bat / .ps1    # 一键构建入口（自动探测 VS2019/2022/2026 生成器，x64；.bat 绕过执行策略）
 ├── main.c                  # 入口：SDL 初始化 → LVGL → 菜单 → 主循环
 ├── sim/                    # 平台层（PC 专用实现；MCU 端对应实现在各 BSP 目录）
 │   ├── sim_port.c / .h     # 显示/输入端口（SDL 窗口 + 键盘 + mono 主题），替代 MCU 端 ui_port.c
@@ -49,6 +50,7 @@ simulator/
 | `sim/cfg_file_store_sim.c` | 通用配置文件存储后端：本地文件 `sim_config.ini`（`fopen`/`rename` 原子写），替代 MCU 端 `App/cfg_file_store_mcu.c`（FatFS）；旧档 `sim_netcfg.bin` 首启自动迁移进 `sim_config.ini` |
 | `lv_conf.h` | 模拟器专用 LVGL 配置。与 MCU 端 `Lib/lv_conf.h` 的关键差异见 §3.3 |
 | `dbg_log.h` | MCU 版 `dbg_log.h` 依赖 `sys_clock.h`（RTC 时间戳），PC 无法编译。此 stub 把 `DBG_INFO/ERROR/DEBUG` 映射到 `printf`；因 `simulator/` 在 include 路径最前，**优先生效**覆盖 MCU 版 |
+| `build_sim.bat` / `build_sim.ps1` | 一键构建入口：vswhere 探测本机 VS 大版本（16=2019 / 17=2022 / 18=2026，取已装最高）→ 映射 CMake 生成器；`build/` 缓存生成器与本机不符（换机/升级 VS）时自动删除重建（带重试，抗文件锁）。**构建入口一律走它，文档/命令中勿写死生成器版本**；`.bat` 仅负责绕过 PowerShell 执行策略并转交 `.ps1` |
 | `CMakeLists.txt` | 收集 LVGL 源码（`../Lib/lvgl`）+ 共享 UI 源码（`../Drivers/BSP/UI`）+ 通用配置文件引擎（`../App/cfg_file.c`、`../Drivers/BSP/NETCFG` 的 net_cfg/net_cfg_legacy）+ `sim/` 平台层，链接预编译 SDL2，产出 `lvgl_sim.exe` |
 | `i1_to_png.py` | 把 `--screenshot` 产出的 I1(1bpp) 原始位图转成 PNG，便于离线比对设计稿。详见 §3.5 |
 | `tests/` | 无头回归脚本（菜单 8 状态像素回归、内容页文本断言 + 黄金参考回归）；`ref/` 为**本地生成物、不入库**（首次 `--update` 生成）。详见 §3.6 |
@@ -118,7 +120,7 @@ LVGL 场景（同一份 ui_menu.c）
 ### 2.4 关键设计决策
 
 1. **SDL2**：LVGL 官方 PC 端口同款显示方案；使用仓库内预编译 SDK（`SDL2/SDL2-2.32.10/`），无需系统安装
-2. **CMake + MSVC**：`Visual Studio 16 2019` 生成器，`-A x64`；MSVC 下加 `/utf-8` 消除中文注释的 C4819 警告
+2. **CMake + MSVC**：`build_sim.ps1` 按本机 VS 版本自动选生成器（16=2019 / 17=2022 / 18=2026；不同机器版本不同，**勿写死**），`-A x64`；MSVC 下加 `/utf-8` 消除中文注释的 C4819 警告
 3. **共享 UI 源码**：`ui_menu.c` / `ui_font_cn_12.c` 直接编译 `Drivers/BSP/UI/` 原件，改一处两端同时生效
 4. **纯键盘导航**：不创建鼠标/触摸设备，与 MCU 端 keypad 操作语义一致（↑↓←→ / Enter / Esc）
 5. **UI 为主**：不含 CH395F 网络 / NAND 存储 / ADC 等硬件业务；通用配置文件引擎（`cfg_file`）与 `net_cfg` 核心为纯软件，配置加载/保存/旧档迁移可在模拟器离线验证（`sim_config.ini` / `sim_netcfg.bin`）
@@ -132,27 +134,27 @@ LVGL 场景（同一份 ui_menu.c）
 | 依赖 | 版本 | 说明 |
 |------|------|------|
 | CMake | ≥ 3.15 | 本机验证 4.3.0-rc1 |
-| MSVC | VS2019 BuildTools | `Visual Studio 16 2019` 生成器，Hostx64/x64 |
+| MSVC | VS2019 / 2022 / 2026 任一 | `build_sim.ps1` 自动探测生成器（16=2019 / 17=2022 / 18=2026，取已装最高），Hostx64/x64 |
 | SDL2 | 2.32.10 | 已内置于 `SDL2/`，无需安装 |
 | 操作系统 | Windows | 已验证 win32 |
 
 ### 3.2 构建命令
 
 ```powershell
-# 首次（配置 + 构建）
-cd simulator
-cmake -B build -G "Visual Studio 16 2019" -A x64
-cmake --build build --config Debug
-
-# 日常（仅改 .c/.h 时增量编译）
-cmake --build build --config Debug
+# 一键构建（仓库根目录执行；自动探测本机 VS2019/2022/2026 生成器，
+# build/ 缓存生成器与本机不符时自动删除重建）
+& "simulator\build_sim.bat"
 
 # 运行
-.\build\Debug\lvgl_sim.exe
-# 或：cmake --build build --config Debug --target run
+.\simulator\build\Debug\lvgl_sim.exe
+# 或：cmake --build simulator\build --config Debug --target run
+
+# 全量重建
+& "simulator\build_sim.bat" -Clean
 ```
 
-> 改 `CMakeLists.txt` 后需重新 `cmake -B build`；遇到奇怪问题先删 `build/` 全量重建。
+> 改 `CMakeLists.txt` 后再跑一次 `build_sim.bat` 即可（缓存不匹配会自动重建）；遇到奇怪问题加 `-Clean` 全量重建。
+> 手动 CMake 等效：`cd simulator; cmake -B build -G "Visual Studio <NN> <YYYY>" -A x64; cmake --build build --config Debug`，生成器号须与本机 VS 大版本一致（16=2019 / 17=2022 / 18=2026）。
 
 ### 3.3 `lv_conf.h` 与 MCU 端的关键差异