核心用法
uiflow2-coder 是专为 M5Stack UIFlow2 平台设计的 MicroPython 编程辅助工具，严格遵循「文档优先」原则。使用时需按四步流程执行：
1. 需求分析与文档定位：从硬件/功能关键词出发，在预定义的 docs/ 文件树中锁定目标模块路径（如 unit/env.md 对应 ENV 传感器单元）
2. 强制读取官方 API：通过 read 命令获取原始文档，提取构造函数、方法签名及官方示例
3. 规范代码生成：采用 UIFlow2 标准导入模式——import M5; from M5 import * 初始化设备，按需从 hardware/unit/module/m5ui 等命名空间导入，严禁使用 UIFlow1 遗留的 from m5stack import *
4. 语法校验交付：通过 scripts/check_syntax.py 验证后输出
文档覆盖全面，包含 200+ 硬件模块：从基础的 GPIO、I2C、UART，到复杂 Unit（传感器/执行器）、Module（通信/驱动）、Hat（功能扩展板），以及基于 LVGL 的 UI 控件（m5ui）和网络协议栈（MQTT/TCP/Modbus 等）。
显著优点
- 权威性极强：所有 API 强制来源于官方文档树，彻底杜绝 LLM 幻觉导致的错误代码
- 结构化工作流：4 步标准化流程降低开发心智负担，特别适合嵌入式硬件的精确编程场景
- 生态完整：涵盖 M5Stack 全系列产品线——Core、Stick、Atom、Stamp 控制器及数百种外设模块
- 版本正确：明确区分 UIFlow1/UIFlow2 语法差异，避免 legacy 代码污染新项目
- 安全合规：内置语法检查脚本，拦截基础错误
潜在局限
- 实时性依赖：若官方文档未同步最新硬件修订，生成代码可能滞后
- 文档覆盖盲区：极端冷门或用户自定义硬件无官方文档支持时将无法生成代码
- 交互成本：强制文档查阅步骤增加了简单查询场景的操作步数
- 生态锁定：深度绑定 M5Stack 硬件体系，无法迁移至其他 ESP32 开发板
适合人群
- M5Stack 硬件开发者（尤其使用 UIFlow2/MicroPython 方案）
- 教育场景中的物联网/嵌入式教学师生
- 需快速验证硬件原型的创客与工程师
- 对代码准确性要求极高的生产环境开发者
常规风险
- 硬件损坏风险：错误配置 GPIO/PWM 可能烧毁传感器或执行器
- 固件兼容性：UIFlow2 持续迭代，需确认设备固件版本与文档版本匹配
- 电源管理疏忽：电池供电场景下忽略
power模块管理可能导致异常断电 - I2C 地址冲突：多设备总线连接时需严格核对地址，文档未覆盖冲突排查逻辑