Решение проблем

Найдите причину по симптому и перейдите к соответствующему решению. Ответы о прошивке сверены с апстримом 78/xiaozhi-esp32 v2.5.2; операции в консоли — по фактическим подсказкам официальной консоли.

По симптомам

Сбои подключения устройства
загрузка → настройка → Wi-Fi → активация → сервер → диалог, по уровням
FAQ
Начало работы, прошивка, настройка, аудио, консоль и другие частые вопросы
Разработка и отладка
Проблемы сборки, подключения и времени выполнения

Частые сценарии

Прошивка не выходит / не загружается
Проверьте плату, вариант, адрес прошивки и COM-порт
Не подключается к Wi-Fi
Режим настройки, диапазоны и сигнал
Активация не удалась / офлайн
Код активации и таблица поиска проблем привязки
Нет звука / нет отклика
Проверка громкости, микрофона и динамика

Принципы поиска

  1. Сначала подтвердите версию прошивки и вариант платы: варианты различаются дисплеем и связью, несоответствие — самая частая причина.
  2. Затем проверьте сеть и сервер: состояние устройства, URL OTA и доступность сервера.
  3. В конце смотрите конкретный модуль: аудио, дисплей или периферию — по соответствующим руководствам.

Issues и сообщения сообщества — это источники зацепок; разовый успех не является общим решением — решениям нужны воспроизводимые шаги. Нерешённые вопросы присылайте на [email protected].