核心用法
uiflow2-coder 是专为 M5Stack 设备设计的 MicroPython 编程助手，基于 UIFlow2 框架提供硬件控制与界面开发支持。使用时需严格遵循"四步流程"：首先分析需求并定位官方文档路径，然后强制读取对应 docs/ 下的 API 文档，接着生成符合规范的代码，最后通过语法校验脚本检查。
关键导入模式（UIFlow2 专用）：
import M5; from M5 import *—— 设备初始化from hardware import *—— 硬件抽象（Pin/I2C/UART/ADC等）from unit/module/base import *—— 硬件模块（覆盖200+设备）import m5ui; import lvgl as lv—— LVGL 图形界面
UI 控件强制规范：所有 m5ui 控件（M5Chart/M5Label 等）创建时必须传入 parent=page0，否则页面切换后控件不可见导致黑屏。
LCD 渲染规范：禁止在 loop() 中调用 Lcd.clear()，应采用局部擦除策略避免闪烁。
显著优点
1. 官方文档驱动：强制先读 docs/ 再生成代码，杜绝经验主义编造 API，确保代码与硬件实际能力匹配
2. 覆盖全面：文档树涵盖 200+ 硬件模块（Unit/Module/HAT/Chain/Base/Advanced）、系统功能（BLE/WiFi/Power）、网络协议（MQTT/TCP/UDP/Modbus）及完整 LVGL UI 控件
3. 规范严格：内置多项强制规范（正确导入方式、版权注释禁止、硬件初始化异常处理、MicroPython 时间函数等），降低新手踩坑概率
4. 硬件兼容性检查：明确禁止为不支持摄像头的设备生成相关代码（仅 CoreS3 支持），避免硬件损坏风险
潜在缺点与局限性
1. 学习曲线陡峭：开发者需熟悉 M5Stack 硬件分类体系（Unit vs Module vs HAT vs Chain）才能快速定位文档
2. 代码生成依赖文档完整性：若官方文档存在遗漏或滞后，可能无法支持最新硬件特性
3. 非通用 MicroPython：API 为 M5Stack 深度定制，代码无法直接迁移至其他 ESP32 开发板
4. 调试工具链受限：需配合 M5Stack 官方烧录工具（M5Burner）和串口调试，无集成仿真环境
适合人群
- M5Stack 硬件开发者：拥有 Core2/CoreS3/Cardputer/Atom 等设备的用户
- 物联网原型工程师：需要快速驱动传感器、执行器并构建本地 UI 的项目
- 教育场景师生：MicroPython 硬件编程教学，可视化 LVGL 界面降低图形编程门槛
- 工业 Modbus/RS485 开发者：内置协议栈支持工业通信场景
常规风险
1. UI 黑屏风险：未传 parent=page0 导致控件挂在默认屏幕，页面加载后不可见
2. 屏幕闪烁/撕裂：loop() 中错误使用 Lcd.clear() 造成视觉体验极差
3. 硬件初始化失败：裸奔式硬件访问（无 try-except）导致设备死机
4. 导入错误：混用 UIFlow1 语法（from m5stack import *）引发兼容性问题
5. 设备损坏风险：为不支持摄像头的设备强制生成摄像头代码可能导致硬件异常