问题排查
按症状找原因，再进入对应的修复步骤。固件相关的回答基于上游 78/xiaozhi-esp32 v2.5.2 整理；涉及控制台操作以官方控制台实际提示为准。
按症状分类
高频场景直达
排查原则
- 先确认固件版本与板型变体：不同变体的屏幕、联网方式不同，错配是最常见原因。
- 再确认网络与服务端：设备在线状态、OTA 地址与服务器可用性。
- 最后看具体模块：音频、屏幕、外设按对应指南检查。
Issue 与社区经验是线索来源；单次偶然成功不等于通用修复，方案以可复现步骤为准。未解决的问题欢迎邮件 [email protected] 交流。