核心定位
uiflow2-coder 是专为 M5Stack 设备（CoreS3、Core2、StickS3、Cardputer 等）设计的 UIFlow2 MicroPython 编程辅助工具。其核心使命是消除代码生成的猜测性，通过强制查阅官方文档确保 API 调用的准确性。
核心用法
四步编程流程（强制执行）：
1. 需求分析与文档定位：从用户请求中提取硬件/功能关键词，在文件树中锁定目标文档路径
2. 原始 API 读取：使用 read docs/... 命令读取官方文档，提取构造函数签名、方法参数及官方示例
3. 代码生成：遵循严格的编码规范生成代码，包括正确的导入路径、设备初始化、主循环结构等
4. 性能与语法检查：执行显示性能、设备配置、资源管理、算法效率、用户体验五维检查，最后通过语法校验
显著优点
- 权威性保障：所有 API 必须经官方文档验证，杜绝"幻觉代码"
- 性能优先设计：内置 MicroPython ESP32 优化规范（批量解包、预分配缓冲区、memoryview 零拷贝等）
- 设备适配细化：针对不同 M5Stack 设备（Tab5 横屏、CoreS3 摄像头、墨水屏等）提供特定配置指导
- UI 开发规范：强制
parent=page0参数、LVGL 常量文档化选择、触摸坐标旋转转换等完整 GUI 开发流程 - 安全编码清单：18 项禁止行为明确列出，覆盖 API 误用、性能陷阱、用户体验缺陷
潜在局限
- 文档依赖性强：若用户请求涉及未收录的新硬件或 beta 功能，可能无法即时响应
- 摄像头限制：明确限制仅 CoreS3 支持摄像头 API，其他设备请求会被拒绝
- MicroPython 特化：不适用于标准 Python 或 Arduino C++ 开发场景
- 代码生成前置成本：强制文档查阅流程增加了响应延迟，不适合极快速原型验证
适合人群
- M5Stack 硬件开发者（从入门到进阶）
- 教育场景中的物联网/嵌入式编程教学
- 需要可靠、可维护代码的生产环境项目
- 对 MicroPython 性能优化有明确需求的开发者
常规风险
- 文档版本滞后风险：
docs/目录若未及时同步官方更新，可能生成过时 API 调用 - 用户绕过检查风险：开发者若忽略性能优化建议，可能在 ESP32 上遭遇严重性能瓶颈
- 硬件兼容性误判：设备型号识别错误可能导致不存在的 API 调用（如为非摄像头设备生成摄像头代码）
- 坐标系混淆风险：多点触控坐标未手动转换时，触摸位置与显示内容错位