面向 STM32 开发的 Windows 工具，提供桌面程序和 VS Code 本地扩展两个使用入口，集中完成 STM32CubeMX 工程的 Keil MDK-ARM ↔ CMake 转换、ARM GCC 构建环境检测与自动安装、VS Code 一键编译与 DAPLink 烧录任务配置，以及 C/C++、头文件和汇编源文件管理。
STM32 Project Helper provides a Windows desktop application and a local VS Code extension for STM32CubeMX project conversion between Keil MDK5 (.uvprojx) and ARM GCC CMake, embedded toolchain setup, build/flash tasks, CMSIS-DAP/DAPLink and source-file management. Project conversion does not invoke STM32CubeMX.
以下十项已包含在插件 v1.3.0 中，安装包为 artifacts/vsix/stm32-project-helper-1.3.0-win32-x64.vsix，已随 vscode-v1.3.0 发布。桌面 v1.6.0 在“开发与分析”入口提供其余九项，桌面端不包含 PostHog；桌面生成的 Cortex-Debug 配置在 VS Code 中使用。桌面发布目录为 artifacts/publish/portable（自带运行时）和 artifacts/publish/lite（依赖 .NET 9 Desktop Runtime），对应 v1.6.0。旧安装包保留。插件覆盖安装新版 VSIX 后重载窗口即可。
| 功能 | 入口与使用方法 |
|---|---|
| clangd 自动配置 | 开发配置 → 配置并生成编译数据库，再确认写入 .clangd 与 .vscode/settings.json。使用实际 CMake 编译命令获取宏和包含路径，合并查询编译器参数，关闭 C/C++ IntelliSense 引擎以避免冲突；保留已有注释和其他参数。需要安装 clangd 扩展，可通过“查看 clangd 扩展”打开安装入口。 |
| Cortex-Debug 配置 | 先编译并选择当前实际 ELF，再写入调试配置或启动调试。保留用户 launch.json 配置，使用所选 GDB、OpenOCD、探针、SWD 速度和复位方式。需要 Cortex-Debug 扩展；生成配置使用 attach，连接与加载符号，不自动下载固件。 |
| CubeMX 重新生成后的同步 | 监视 .ioc、MDK、CMake 和链接配置变化，在页面提示；预览后确认写入。有 CubeMX MDK 来源时重新计算 CMake 转换；CMake 来源已重新生成时恢复助手管理的源文件块。不运行 CubeMX、不重新生成外设源码、不猜测复杂用户构建逻辑。管理块保存于本机 VS Code 工作区状态，用于重启后的恢复，不保存最近工程列表。 |
| 硬件连接检测 | 开发配置 → 连接并检查硬件，分别显示脚本、探针和芯片状态。直接烧录默认先检查，可取消勾选。仅明确执行后连接硬件，可能暂停或复位目标；不在检测中烧录固件。 |
| 增强 ELF/MAP 分析 | 固件与故障分析 → 选择 ELF 和可选 GNU MAP，查看函数/变量大小排行、目标文件贡献及内存区域。符号排行不直接相加当作总用量；未知布局保持未知，MAP 不替代完整 ELF 装载映像统计。 |
| 一键故障报告 | 从分析页导出，自动整理工具版本、构建/烧录结果和最近输出，替换常见本地路径、IP、邮箱和令牌。先在本地编辑器预览，检查后选择保存位置，不自动上传；自定义敏感信息仍需人工核对。 |
| 串口调试助手 | 设备与诊断 → 刷新 COM 列表、选择波特率、手动连接；支持 ASCII/HEX、可选 LF/CRLF、收发时间戳和本地日志导出。当前为 8N1，DTR/RTS 默认关闭。显示与保留日志有容量上限，关闭工作台或切换工程会释放端口。 |
| HardFault 分析 | 输入捕获的寄存器 JSON 或 CFSR=0x... 文本，按核心解释有效故障位，使用所选 GCC 旁的 addr2line 和 ELF 定位 PC/LR。M0/M0+ 不虚构 CFSR/HFSR；EXC_RETURN、不精确故障与缺失调试信息明确提示。没有运行时自动栈回溯。 |
| FreeRTOS 任务监控 | 输入已运行的本机 GDB Server 地址，手动连接刷新任务快照。使用 ELF 调试符号读取真实 TCB 名称、状态及优先级；能核实栈边界、增长方向与填充条件时显示剩余高水位（StackType_t 单位），否则显示未知。需要支持 Python 的 GDB、匹配 ELF 与目标固件；只读快照可能暂停目标，读取后尝试分离，不自动轮询。 |
| PostHog 匿名使用统计 | 默认关闭。设备与诊断中填写自己的 HTTPS 项目地址和项目令牌，令牌存入 VS Code 凭据存储；原生弹窗明确同意后才发送。仅允许随机匿名标识、版本、语言、功能与成功状态，尊重 VS Code 总遥测开关；不发送路径、代码、日志、串口数据或芯片序列号。服务仍可看到网络来源 IP；关闭后停止发送并清除本机匿名标识。 |
编译数据库的一键导出作用于当前 CMake 构建目录；另填的数据库目录用于选择已有数据库。不要同时启动多个会争用同一目标的调试/检查会话。新功能已做针对性软件样例检查，所有功能均已在实机上完成验证。
- 补齐仅含 CMake 文件工程的插件激活条件；自动打开工作台仍需通过 STM32 特征识别。
- 操作优先复用用户明确选择且仍有效的工具路径，避免重复扫描；版本清单保留完整发现，所选路径缺失时重新检测。
- 内置脚本缓存采用有限并发校验，在单次校验中共享祖先目录检查；继续逐文件校验哈希、恢复损坏或缺失文件、拒绝链接并清除多余文件。工具清单复用本次发现结果，避免同一请求重复扫描。
- 后台取消回执及启动前取消保留统一的取消标志。
本地安装包：artifacts/vsix/stm32-project-helper-1.2.1-win32-x64.vsix。该修复版未单独发布，其改动已包含在 v1.3.0 中。
| 使用需求 | 功能入口 | 输出内容 |
|---|---|---|
| 把 CubeMX 生成的 Keil 工程放到 VS Code 中编译 | 工程转换 → MDK-ARM → CMake | CMakeLists、Debug/Release 预设、GCC 启动和链接配置 |
| 把 CubeMX CMake 工程转回 Keil MDK5 | 工程转换 → CMake → MDK-ARM | 按所选实际目标生成 .uvprojx、启动文件和 scatter |
| 解决 CMake、Ninja、ARM GCC 或 OpenOCD 缺失 | 工程配置 → 自动修复；工具管理 | 下载校验、安装验证、工具路径与版本切换 |
| 配置 VS Code 一键编译和 DAPLink 一键烧录 | 工程配置；桌面端“配置并验证”，扩展“确认写入” | 保留原有任务的 .vscode/tasks.json |
| 把 BSP、驱动或业务模块加入 CMake 编译 | 添加源文件 | 勾选文件和目标，预览后维护源文件与包含目录 |
| 创建工程目录并复制文件 | 加入文件 | 文件夹创建、同名处理及后续参与构建的选择 |
所有配置写入前均可预览；受支持的修改会记录备份，可在应用中恢复。软件验证会区分“配置已生成”和“实际编译通过”。
- 选择或拖入 CMake 工程，显示 STM32 型号的识别依据及冲突，选择构建预设与构建配置；插件 v1.2.0 支持从工程读取或填写自定义配置，多个 ELF 时自行选择固件。
- 检查 CMake、Ninja、ARM GCC、OpenOCD、CMSIS-DAP 脚本，提示待补全项，可展开具体处理说明。
- 桌面程序和 VS Code 扩展均内置完整 OpenOCD Target 及配套脚本，识别 STM32 后自动选择配置并验证，无需查找或下载 Target；保留手动指定的 Target。
- 自动下载缺失工具，校验 SHA-256 后安装；支持自选安装目录、镜像源、离线 ZIP、版本切换和旧版本清理。
- 写入
.vscode/tasks.json或CMakeLists.txt时保存可恢复的修改记录，保留用户任务和 JSONC 注释。桌面端通过差异预览确认；扩展提供直接“确认写入”按钮和可选差异预览。 - 显示 CMake、编译和链接问题的位置与处理建议，可复制或导出完整日志。
- 通过目录树、搜索和过滤逐项选择 C/C++、汇编及头文件，添加到指定 CMake 目标。
- 创建工程文件夹并复制选定文件，同名文件夹询问是否追加，同名文件自动改名。
- 对 STM32CubeMX 生成的 STM32 工程进行 MDK5 与 ARM GCC CMake 双向转换，不调用本机 CubeMX；转换前预览、记录修改，生成后检查并按可用工具执行编译验证。
- 按钮显示悬停、按下、键盘焦点及运行状态，操作期间防止重复执行，禁用时说明原因。
- 显示当前操作步骤和用时，详细日志默认收起；完成后保留结果卡，展示实际固件路径、大小、时间和下一步入口。
- 文件列表显示已引用、待加入和未选择状态，统计过滤后隐藏的勾选项；复制完成后可直接预选新增文件参与构建。
以下功能已写入插件前端、后台及本次发布的 VSIX，不是待实现清单。桌面 EXE 未重新发布，不能据此认为桌面版同步增加了这些功能。
| 更新项目 | 插件中的入口与行为 |
|---|---|
| 直接编译与烧录 | 工程配置页显示配置、构建目录、实际 ELF、进度和结果；也可通过命令面板执行。缺少任务时先确认写入，编译失败仍保留任务；多个 ELF 需要明确选择，烧录前再次确认。 |
| 下载器与高级设置 | 可选 DAPLink/CMSIS-DAP、ST-Link、J-Link；高级设置提供 SWD 速度（1–50000 kHz）和默认复位、Connect Under Reset、SYSRESETREQ。不支持的组合明确提示，不自动探测硬件连接。 |
| 首次配置向导 | 按工程、工具、芯片与下载器、任务四步配置，可退出手动操作或重新打开。只有 MDK 的工程先转换为 CMake。 |
| 自定义构建配置 | 从 CMake Presets、缓存和匹配的 File API 信息读取建议，允许 Profile、CustomDebug、RelWithDebInfo、MinSizeRel 等安全配置名；固定预设优先，不再只接受 Debug/Release。 |
| 错误分析 | 为 GCC、CMake、Ninja 和 OpenOCD 日志提供原因及处理建议，保留原始报错，并显示在问题面板与输出频道；建议不会自动修改业务源码。 |
| Flash/RAM 静态分析 | 对当前实际 ELF 与链接脚本分析区域占用、容量、剩余及段分布；初始化数据同时考虑 RAM 运行地址和 Flash 装载映像。无法确认的容量显示未知，不把 ELF 文件大小当成内存占用。 |
| 只读操作不强制保存 | 重新检测、预览等基于磁盘已保存内容；实际写入、编译等仍检查未保存文件，保留冲突确认。 |
| STM32 工程识别 | 自动打开需要 STM32 特征，支持嵌套工程、多候选选择与当前源文件关联，避免普通 CMake 工程误触发。 |
| 大工程交互 | 页面只接收当前所需摘要，不传输 Base64 文件快照及完整构建日志；源文件列表使用虚拟滚动和局部勾选更新，保留搜索、选择与滚动位置。 |
| 差异与进程清理 | 按文件选择差异，限制并释放差异缓存；取消、超时与关闭时通过 Windows Job 和进程树终止清理后台及子进程。 |
| 工具路径兼容 | 失效的已保存工具路径重新检测，保留有效的明确选择；构建沿用选定工具的绝对路径和缓存迁移处理。 |
| 中英文界面 | 六个页面、向导、按钮、原生确认、进度与新增诊断提示均提供双语；路径、用户代码与原始工具输出保留原文。 |
- 上表功能已集成进本次插件安装包；原有源文件管理、加入文件、双向转换、工具管理和修改恢复继续保留。
- v1.2.0 面向本地 Windows x64 / VS Code 1.95+，不支持 WSL、Remote SSH 或虚拟工作区。转换仍限定文档支持的 STM32CubeMX 单核工程；MDK 转换默认生成 Debug/Release，不等于工作台只能使用这两种配置。
- 静态 Flash/RAM 分析不测量运行时堆栈；复杂或未解析的链接布局不会推测容量。Connect Under Reset 等设置取决于探针、复位接线、芯片及 OpenOCD，HLA 与 SYSRESETREQ 等不支持组合会被拒绝。
- 本批未包含 clangd 自动配置、Cortex-Debug 调试集成、串口、HardFault、FreeRTOS 在线调试、硬件连通性检测、最近工程记忆或使用统计。
- 发布状态：已构建打包，并查看过中英文界面；未运行本批功能回归、硬件烧录或跨电脑兼容性测试。此次文档与发布同步不追加检查，实际验证由使用者完成。“已集成”不代表所有工程和设备组合均已验证。
- 安装本页链接的 v1.2.0 VSIX 并重新加载窗口，打开可信任的本地 STM32 工程。
- 首次使用按向导核对工程、工具、芯片、下载器及任务；已配置工程可直接展开“工程配置详情”调整。
- 选择预设或输入自定义配置，确认任务写入后点击编译；不需要先打开差异预览。只编译不要求 OpenOCD 或探针。
- 编译完成后核对实际 ELF，查看 Flash/RAM 分析；多个固件时先选择目标。
- 需要下载时选择下载器及高级参数，再点击烧录并确认。失败时查看问题面板和输出频道的原始日志与建议。
English details and release scope: VS Code extension guide.
前往 桌面程序最新版本 下载：
- 轻量版：STM32ProjectHelper-portable-win-x64.exe，下载后直接运行，自带 .NET。
- 极致轻量版：STM32ProjectHelper-lite-win-x64.exe，需要电脑已安装 .NET 9 Desktop Runtime。
| 版本 | 本地发布路径 | 大小 | 运行要求 |
|---|---|---|---|
| 轻量版 | artifacts/publish/portable/STM32ProjectHelper.exe |
约 49 MB | Windows x64，自带 .NET |
| 极致轻量版 | artifacts/publish/lite/STM32ProjectHelper.exe |
约 1.6 MB | Windows x64，.NET 9 Desktop Runtime |
两个版本功能相同，Release 附件直接提供 EXE。应用原名“CMake · DAPLink 配置助手”；新版本继续读取已有工具设置和修改记录，并识别旧版生成的 VS Code 任务。仓库名保留 auto-CMake，Git 仓库保存源码和文档，克隆后可以自行构建。GitHub Actions 构建成功后会生成两个版本的下载产物。
本地扩展提供工程配置、添加源文件、加入文件、工程转换、工具管理和修改记录，直接操作当前工作区，无需启动桌面程序。扩展适用于本地 Windows x64、VS Code 1.95 及以上版本，自带经过裁剪的后台运行时，无需另装 .NET。
- 插件安装包 v1.3.0：stm32-project-helper-1.3.0-win32-x64.vsix。安装包约 8.3 MB，自带后台运行时及 OpenOCD 脚本，无需另装 .NET。
- 版本说明：VS Code 扩展 v1.3.0。
- 完整操作指南：安装、更新、使用流程与常见问题。
双语插件 v1.3.0：安装包位于 artifacts/vsix/stm32-project-helper-1.3.0-win32-x64.vsix。提供直接编译/烧录、下载器选择与高级设置、首次配置向导、错误说明和 Flash/RAM 静态分析；支持自定义配置、嵌套 STM32 工程及大文件列表。默认跟随 VS Code 显示语言，工作台右上角可切换中文 / English；也可设置 stm32ProjectHelper.language。双语覆盖六个页面、确认弹窗、进度、检测说明和结果建议；语言切换保留配置与文件选择。新写入的托管任务使用当前语言，用户任务、路径、代码和原始编译输出保持原文。使用方法参见 中文指南 / English guide。
- 下载 VSIX，按
Ctrl+Shift+X打开 VS Code 扩展面板，在右上角的…菜单选择“从 VSIX 安装…”，选择下载的stm32-project-helper-1.3.0-win32-x64.vsix；从源码打包的文件位于artifacts/vsix。 - 打开并信任包含
CMakeLists.txt、.ioc或.uvprojx的工程文件夹，工作台自动打开；也可点击活动栏的芯片图标，或执行“STM32 工程助手：打开”。 - 首次配置可使用四步向导；核对检测结果及下载器设置后确认写入任务。也可先点“预览改动”查看原生文件差异。工程配置页直接提供编译与烧录按钮；缺少任务时先确认写入，再编译。烧录会再次要求明确确认，软件检查不连接硬件。
多个工程使用侧栏的“选择工作区”按钮切换；编辑另一工作区的源文件时自动切换当前工程。设置 stm32ProjectHelper.autoOpen 可关闭自动打开。扩展不上传工程，不保存最近工程列表。
更新方法：再次“从 VSIX 安装…”选择新版文件，覆盖已有扩展后重新加载窗口，无需先卸载。若未出现重新加载提示，可执行命令“Developer: Reload Window”，或关闭并重新打开 VS Code。桌面版本与扩展版本使用各自的版本号，发布页分别提供下载。
- 工程转换：保留
.ioc和生成源码的 STM32CubeMX 单核 STM32 MDK5 / ARM GCC CMake 工程；标准启动代码及实际使用一个 FLASH、一个 RAM 的布局。 - CMake 工作台：检测、配置和编译工程已有的构建目标，使用当前 CMake 配置声明的固件，避免选中旧 ELF。
- 软件要求：配置/编译需要对应 CMake、Ninja、ARM GCC；生成 MDK 工程不要求安装 Keil，实际 MDK 编译验证需要 Keil、对应芯片 Pack 和编译器。
- 烧录任务：桌面端保持原有 DAPLink / CMSIS-DAP 流程；插件 v1.2.0 增加 DAPLink/CMSIS-DAP、ST-Link、J-Link，使用 OpenOCD/SWD。软件检查只检查软件和脚本，用户明确执行烧录时才连接硬件。探针、芯片与 OpenOCD 的实际组合仍需使用者确认。
适用需求包括：STM32 Keil 转 CMake、MDK-ARM 转 VS Code、CubeMX CMake 转 Keil、CMake 自动安装配置、DAPLink 一键烧录、CMake 添加源文件，以及 STM32 VS Code 本地插件。
Related terms: STM32CubeMX · Keil uVision / MDK-ARM / MDK5 · uvprojx · CMakeLists.txt · CMakePresets.json · ARM GCC / arm-none-eabi · VS Code · OpenOCD · CMSIS-DAP · DAPLink · embedded firmware · project converter · toolchain setup.
- 打开程序，在“工程配置”选择含
CMakeLists.txt的工程根目录，也可以拖入文件夹。 - 查看检测摘要。识别到支持的芯片后直接使用 EXE 内置 Target 及依赖脚本。构建工具或 OpenOCD 可执行程序缺失时点击“自动修复”；已有安装可使用“手动指定路径”。“镜像源”可以修改工具包的备用下载地址，“展开配置详情”可核对工具路径、内置脚本位置和 Target。
- 查看“识别详情”，确认芯片型号及 Target，选择配置预设及对应编译预设；预设未固定构建类型时可另选 Debug/Release，也可选择直接构建目录。点击“配置并验证”，先核对差异并确认写入 VS Code 任务，再执行 CMake 配置、编译和 OpenOCD 脚本检查。编译或脚本检查未通过时任务保留，可根据问题提示修正源码后直接在 VS Code 重试。
- 在 VS Code 的“终端 → 运行任务”中选择“一键编译”或“一键烧录(DAPLINK)”。烧录任务先编译，再通过 CMSIS-DAP/SWD 下载 ELF、校验和复位。
配置验证阶段只检查软件，不确认探针或芯片连接，不烧录硬件，也不生成 .ps1 文件。重新配置仅更新本工具管理的任务；同名用户任务保留，新任务加后缀区分。JSONC 注释及编码保留。
固件候选来自 CMake 当前构建配置中可执行目标声明的 ELF，不包含构建目录里旧目标遗留的文件。ELF 名称由工程的 CMake 目标及输出名称决定，可能与文件夹名称不同；无变化编译时文件时间保持不变，仍可作为有效固件。
任务先写入 .vscode/tasks.json 和必要的 .vscode/stm32-daplink.cmake 辅助文件，首次尚无 ELF 也可以生成。辅助文件由 CMake 执行，负责准备产物查询和读取当前构建目标；不调用 PowerShell，也不按文件夹名猜测 ELF。已有同名用户脚本时使用另一个文件名，不覆盖用户内容。多个 ELF 时，编译完成后选择固件并预览烧录任务的绑定修改；取消选择时保留已写入的任务，烧录任务不会自动选择目标。任务和辅助文件均可通过修改记录恢复。
写入前查看各文件修改前后的内容，取消即可放弃写入。“恢复修改”显示该工程的修改记录，恢复前再次预览。文件已被手动改动时会列出冲突，需要明确确认覆盖；恢复操作也会留存记录。备份保存在用户数据目录，不添加到工程内。
编译输出中的错误和警告会整理到“问题与日志”，按 CMake 配置、编译、链接显示文件及行号、可能原因。双击有本地位置的问题可定位文件；处理建议需要结合工程核对，不会自动删改源码。
在左侧“添加源文件”选择当前工程内的文件夹和 CMake 目标，用目录树逐项或整组选取 .c、.cpp、.cc、.cxx、.s/.S、.h、.hpp、.hh、.hxx。可搜索路径、过滤已勾选/未勾选/已引用文件，过滤不丢失隐藏文件的选择。勾选头文件时自动添加所在目录，C++/汇编按需启用语言。
确认差异后修改根目录 CMakeLists.txt 中对应目标的维护块，保留手工配置并实际编译；再次扫描保留先前排除的选择。仅明确解析的直接引用用于避免重复添加；条件、函数、循环、include 或复杂表达式不能确定时会提示，文件仍可选，需要核对差异。
在左侧“加入文件”输入工程根目录下的文件夹名称，选择或拖入文件，再点击“创建文件夹并加入”。同名文件夹弹出“是/否”确认，同名文件改为 名称 (1).扩展名，保留来源文件。完成后可前往“添加源文件”，选择需要参与构建的文件。
点击“自动修复”仅补齐缺失或无法运行的工具，保留已有可用工具。默认安装到 D:\CMake_Tools，可在“工具管理”更换目录。安装使用 Windows x64 ZIP 完整包，下载前查询最新稳定发行版，下载后核对摘要，解压、检查版本，再编译临时 ARM ELF 并解析 DAP 配置。工具验证工程在安装目录内创建并清理，不写入用户工程。
内置 Target：EXE 包含完整的 OpenOCD target 目录（含子目录共 361 个文件），以及 interface 和共享 Tcl 等依赖。识别芯片后直接选用对应配置，不查找本机脚本，也不为 Target 下载工具包。首次使用时自动解压到 %LOCALAPPDATA%\CMakeDapLink\OpenOcdScripts 下按内容版本区分的缓存，后续检查缓存完整性。VS Code 任务直接使用该路径，不往用户工程中复制脚本。“内置脚本 → 打开”可以查看这些文件。
常见 STM32 C0、F0/F1/F2/F3/F4/F7、G0/G4、H7、L0/L1/L4/L5、U0/U3/U5、WB/WL 具有系列映射，WBA5 使用内置的 stm32wbax.cfg。H7R/S、WBA2/6 所需专用脚本不在本次内置库中，会显示具体原因；不会套用其他系列，也不会为了缺少 cfg 自动下载。用户手动填写的 Target 不会在重新检测、切换预设或确认芯片时被自动覆盖。
安装目录选择、工具路径和镜像设置保存在 %LOCALAPPDATA%\CMakeDapLink；旧版安装目录中的配置会兼容读取。下载中显示大小和速度，可点击“停止下载”；已完成的安装保留。芯片型号、缺失源码和错误构建预设需要按弹窗说明处理。
在左侧“工程转换”选择含 .ioc 的 STM32CubeMX 工程根目录。仅支持 CubeMX 生成的 STM32 MDK5（.uvprojx）和 ARM GCC CMake 工程；不启动、不安装、不调用 CubeMX，也不重新生成外设初始化代码。
- MDK-ARM → CMake：选择 MDK 工程文件和构建目标，读取已启用源文件、宏、包含路径、启动文件及内存布局，预览后生成 CMake 配置。已有 CMake、Ninja、ARM GCC 时实际配置并编译，完成后可“转到工程配置”生成 VS Code 编译与 DAPLink 烧录任务。
- CMake → MDK-ARM：选择配置预设和构建类型，先“解析 CMake 构建目标”，再选择需要导出的实际可执行目标。预览后生成 MDK5 工程；检测到本机 Keil 时自动以隐藏命令行进行编译，缺少 Keil 时显示工程文件检查结果及待编译状态。
转换保留原有源文件和原格式工程。已有同名配置会显示替换差异，确认后保存到恢复记录，可通过“恢复转换修改”撤销。输出位置、编译状态和固件信息显示在结果卡中，日志默认收起。
转换兼容性：
- 遗留包含路径：未使用模块留下的目录不存在时，保留原路径并提示，同一路径只提示一次；实际缺少头文件时由编译报告位置，不创建空目录或删除配置。
- CMSIS DSP 库：按 CPU/FPU 匹配工程内同名的
ARM/arm_cortexM*_math.lib与GCC/libarm_cortexM*_math.a，检查 ARM ELF 库容器，并显式链接；支持工程内路径及跨盘符的外部库路径。自动匹配限于已知 M0/M3/M4/M7 小端、soft 或 hard 浮点变体，两个编译器的库需来自相同 CMSIS DSP 版本，ABI/符号仍以实际编译结果为准；其他专用库会列出补全说明。 - FreeRTOS 移植层：检查
port.c、portmacro.h的 GNU 语法和task.h内核版本。目录名为 RVDS 但内容已是 GNU 的文件可保留；需要替换时仅使用工程内同版本、同移植目录名称的 GCC 文件，并同步全局、组和文件级包含路径。不会下载其他内核版本替代，也不验证 RTOS 在硬件上的调度。 - 组/文件级设置：保留各文件包含路径、宏、语言和支持的编译参数，路径生成兼容目录末尾斜杠及跨盘符位置。
- 转换说明：分别显示“必须补全”和“提示”；转换页提供“编译问题与建议”，显示实际编译问题的文件、行号及处理方法。标准整数类型重复声明、浮点 ABI、短 wchar_t/枚举与预编译库不一致会提供具体建议，程序不会自动改写业务源码。
启动文件和链接脚本只转换能够可靠解析的标准结构，自动内存映射限于实际使用一个 FLASH、一个 RAM 的布局。复杂分区、多 RAM 分配、双核配置、无法匹配的专用库、自定义命令及缺少可确认语法/版本的 FreeRTOS 移植层会列出具体补全方法。生成工程成功和实际编译通过会分别显示；编译通过后仍需核对链接警告，整个流程只检查软件，不连接硬件。
左侧“工具管理”列出已安装版本、路径和大小，可导入官方完整 ZIP 或指定外部工具。导入版本后通过“启用所选版本”验证并切换，其他版本保留，便于回退。“检查更新”先显示候选版本，由用户决定是否安装。清理页面仅允许删除本程序记录的缓存或未启用版本；外部手动工具不能删除。离线包来自用户选择，程序计算 SHA-256、检查内容和可执行性，不能凭本地摘要确认发行者身份。
官方入口：
备用来源包括可修改的 GitHub 加速镜像和 SourceForge 发布镜像；必要时使用 xPack 备用发行版，日志会显示实际版本。备用发行版索引可切换国内 npmmirror，镜像可用性取决于网络和服务状态。
需要 Windows 和 .NET 9 SDK。Visual Studio 可直接打开 CMakeDapLink.sln，命令行在仓库根目录执行：
dotnet build CMakeDapLink.sln -c Release
dotnet run --project src/CMakeDapLink.App发布两个版本：
dotnet publish src/CMakeDapLink.App -p:PublishProfile=Portable
dotnet publish src/CMakeDapLink.App -p:PublishProfile=Lite发布目录包含 EXE 和 MIT 许可证。Portable 保留完整运行时并启用单文件压缩；Lite 依赖电脑已有的 .NET 9 Desktop Runtime。构建程序本身不需要安装 CMake 或 ARM 工具链。
可选检查项目位于 tests。正常软件流程：dotnet run --project tests/CMakeDapLink.Tests -c Release -- --software-flow；普通窗口流程：dotnet run --project tests/CMakeDapLink.UiTests -c Release -- --software-ui。这些流程需要已安装的嵌入式工具；界面检查需要交互式 Windows 桌面。临时工程不连接硬件。
转换正常流程：dotnet run --project tests/CMakeDapLink.Tests -c Release -- --conversion-flow；转换普通窗口流程：dotnet run --project tests/CMakeDapLink.UiTests -c Release -- --conversion-ui。
内置 Target 资源完整性、解压缓存、依赖检查与脚本解析：dotnet run --project tests/CMakeDapLink.Tests -c Release -- --target-scripts-flow。可选工具下载检查可追加 --download-official，安装在临时目录且不切换用户当前工具；日常使用内置 Target 无需下载。
打包 VS Code 本地扩展需要 Windows x64、.NET 9 SDK 和 Node.js 22 及以上版本：
cd src/STM32ProjectHelper.VSCode
npm ci
npm run package产物写入 artifacts/vsix。打包只构建独立后台和扩展，不重新发布桌面 EXE，也不上传 Marketplace 或 GitHub。npm test 检查正常软件流程；npm run smoke 在隔离配置的本机 VS Code 中检查扩展，可用 VSCODE_EXECUTABLE_PATH 指定 VS Code 路径。
auto-CMake/
├── .github/ # 构建工作流、Issue 和 PR 模板
├── src/
│ ├── CMakeDapLink.App/ # Views、Controls、Infrastructure、Resources
│ ├── CMakeDapLink.Core/ # 检测、构建、配置、文件管理及工具安装
│ ├── CMakeDapLink.ExtensionHost/ # VS Code 独立后台接口
│ └── STM32ProjectHelper.VSCode/ # 本地扩展、界面与 VSIX 打包
├── tests/ # 核心、界面及工具安装检查
├── docs/images/ # 文档静态图片
├── artifacts/publish/ # 两个本地发布版本，不提交 Git
├── artifacts/vsix/ # 本地 VS Code 安装包，不提交 Git
├── CMakeDapLink.sln # 解决方案入口
├── Directory.Build.props # 共享构建属性
├── global.json # SDK 版本选择
├── CONTRIBUTING.md # 贡献说明
└── LICENSE # MIT 许可证
项目的 bin/obj、本地发布文件和个人 IDE 设置已加入 .gitignore。GitHub 工作流只构建并打包，不连接硬件或下载嵌入式工具。
欢迎通过 Issue 反馈问题或提交 Pull Request，见 贡献说明。应用源码使用 MIT License。内置 OpenOCD 脚本保留原始版权与 SPDX 声明，原始 OpenOCD 许可证随脚本资源保留；该第三方资源和运行时下载的工具遵循各自的许可证。