技能概述
UIFlow2 Coder 是专为 M5Stack UIFlow2 生态打造的 MicroPython 编程助手，核心定位是填补通用AI编程助手在嵌入式硬件领域的知识盲区——UIFlow2 固件具有高度定制化的API体系，与标准MicroPython或CircuitPython存在显著差异，未经文档验证的代码极易导致运行时错误。
核心用法
1. 文档优先编码：强制先查阅 docs/ 目录下的官方文档（335个Markdown文件），再生成代码。支持通过文件树定位或搜索脚本（find_doc.ps1/find_doc.sh）快速检索API。
2. 设备感知编程：需明确目标板卡（Core2/CoreS3/Cardputer等）、外设类型（Unit/Module/HAT/Base）及通信总线（I2C/SPI/UART等），避免资源冲突。
3. 多UI体系区分：
m5ui：LVGL高级控件体系（需parent=page0）M5.Widgets：简易控件体系M5.Lcd：底层绘图接口
4. 代码模板规范：标准结构为 import M5 → M5.begin() → M5.update() 主循环，禁用UIFlow1遗留写法 from m5stack import *。
显著优点
- 权威性：直接绑定M5Stack官方文档树，API参数、返回值、构造顺序均经官方验证
- 硬件真实性：代码生成考虑具体板卡资源限制（如摄像头仅支持特定型号）
- 可验证性：每个代码示例附带最小验证步骤（串口输出、I2C扫描、屏幕现象等）
- 性能导向：强制高频循环使用
time.sleep_ms()，禁止无延时空转；推荐memoryview和批量struct.unpack()优化二进制处理
潜在局限性
- 文档依赖：若用户未提供具体硬件型号，需基于假设生成代码，存在适配风险
- 生态封闭性：专精于M5Stack UIFlow2，不兼容标准MicroPython或Arduino框架
- 实时性：文档树为离线快照，可能滞后于官方最新固件更新
- 调试门槛：硬件问题需实际设备验证，纯软件模拟无法覆盖总线时序、电源管理等物理层问题
适合人群
- M5Stack设备开发者（从入门到进阶）
- 嵌入式教育/创客场景的教师与学员
- 需要快速验证硬件可行性的原型设计者
- 遭遇
ETIMEDOUT、I2C.scan()为空等总线异常的调试者
常规风险
| 风险场景 | 规避建议 |
|---------|---------|
| 未读文档生成复杂API | 强制先查`_overview.md`再读具体API文件 |
| 循环中重复初始化硬件 | 严格区分`setup()`与`loop()`边界 |
| 混淆三套UI体系 | 明确`m5ui`/`Widgets`/`Lcd`的互斥性 |
| 字体/资源不存在 | 使用`hasattr`检查可选字体 |
| 跨板卡代码硬编码 | 优先使用通用字体或条件判断 |
安全认证说明
系统报告提示"未执行安全扫描"，建议在实际生产环境中补充：
- 代码注入检测（eval/exec过滤）
- 敏感硬件操作确认（如
power.setCharge()等电源管理API） - 网络通信模块（
wlan/lte/nbiot）的证书与加密审查