用途：作为基于 CubeMX 的 STM32 项目的开发工作手册，指导在 HAL 工程中编写外设配置、BSP 驱动与中断安全代码。
主要能力：提供核心准则、外设驱动指南、HAL API 速查、故障排查指南与实现模式示例等参考文档，并附带 BSP 模板文件 assets/bsp-template.c 与 assets/bsp-template.h 供新建 BSP 模块时复用。
使用方式：先阅读 references/core-guidelines.md；在 CubeMX 中配置外设并重新生成代码，再添加应用或 BSP 逻辑；按需查阅 references/peripheral-driver-guide.md（传感器与总线驱动）、references/hal-quick-reference.md（API 查询）、references/troubleshooting-guide.md（故障分析）、references/usage-examples.md（实现模式）。自定义代码应放在 USER CODE 区域内，除非项目有明确的非 CubeMX 扩展点。
限制与注意：优先考虑硬件约束、中断安全与代码再生成安全，而非局部编码便利；当某项修改属于 .ioc 配置时，不要直接改动 CubeMX 生成的初始化文件。资料未提供具体支持的芯片型号、工具版本、安装命令或收费信息。