用途:当用户贴出 Arduino IDE 或嵌入式工具链的报错时,识别错误类型,用简单语言解释含义,给出具体修复代码示例,并说明错误产生的原因。适用于编译错误、上传失败、启动异常、供电故障和运行时错误。
主要能力:内置 scripts/parse_errors.py,支持 20 多种错误模式,可分析错误日志文件、单条错误消息、交互模式,或通过管道读取编译器输出。常见覆盖包括未声明标识符、缺少分号、括号不匹配、const char* 转换、函数参数不匹配、重复定义、类型未识别、avrdude 上传失败、ESP32 连接超时、程序过大、库缺失等。
使用方式:分析文件用 uv run --no-project scripts/parse_errors.py --file error_log.txt;分析单条错误用 --message;交互模式用 --interactive;从编译器管道输入用 arduino-cli compile 2>&1 | uv run --no-project scripts/parse_errors.py --stdin。若目标为 Uno R4 且涉及 WiFi、OTA、USB 或板卡识别,需查阅 ../../docs/board-support/uno-r4-family.md。
限制与边界:在建议复位、擦除、修复引导程序或重新烧录前,必须先记录确切的板卡型号与版本、工具和库版本、端口、供电路径以及最后可用的固件镜像。编译修复不等于硬件或系统修复。资料未提供具体收费、平台支持范围或效果保证。