Руководство по использованию

📖 Руководство по использованию

Добро пожаловать в раздел руководств по использованию прошивки XiaoZhi! Здесь вы найдете все необходимое для успешной установки, настройки и использования AI возможностей на вашем ESP32-S3 устройстве.

🚀 Быстрый старт

📋 Пошаговое руководство

1️⃣ Подготовка оборудования

Прежде чем начать, убедитесь, что у вас есть:

• ✅ ESP32-S3 совместимая плата разработки
• ✅ USB кабель для подключения к компьютеру
• ✅ Микрофон и динамик (или наушники)
• ✅ Стабильное Wi-Fi подключение

2️⃣ Установка прошивки

3️⃣ Первоначальная настройка

После установки прошивки выполните базовую настройку:

1. Подключение к Wi-Fi

   • Найдите точку доступа “XiaoZhi-Setup” в списке Wi-Fi сетей
   • Подключитесь и откройте веб-браузер
   • Перейдите по адресу 192.168.4.1 для настройки

2. Настройка сети

   • Введите данные вашей домашней Wi-Fi сети
   • Сохраните настройки и дождитесь перезагрузки

3. Тестирование голосового пробуждения

   • Произнесите “你好小智” (нǐ хǎо xiǎo zhì)
   • Светодиод должен загореться, подтверждая распознавание

🤖 Настройка AI функций

Интеграция с AI сервисами

Для использования продвинутых AI возможностей настройте интеграцию с облачными сервисами:

DeepSeek интеграция

1. Зарегистрируйтесь на https://platform.deepseek.com
2. Получите API ключ
3. В веб-интерфейсе XiaoZhi введите ключ в разделе “AI Services”
4. Протестируйте подключение

Другие поддерживаемые сервисы

• OpenAI GPT: Для высококачественных диалогов
• Qwen от Alibaba: Для лучшего понимания китайского языка
• Google Speech API: Для точного распознавания речи

🏠 Интеграция с умным домом

Home Assistant

XiaoZhi отлично интегрируется с Home Assistant через MQTT:

# configuration.yaml
mqtt:
  broker: localhost
  port: 1883
  discovery: true

# Автоматическое обнаружение XiaoZhi устройств
xiaozhi:
  - platform: mqtt
    name: "XiaoZhi Voice Assistant"
    command_topic: "xiaozhi/command"
    state_topic: "xiaozhi/state"

Протокол MCP

Для продвинутой интеграции используйте протокол MCP (Model Context Protocol):

• Управление устройствами: Прямое управление совместимыми устройствами
• Сценарии автоматизации: Сложные цепочки действий по голосовым командам
• Статус мониторинг: Отслеживание состояния всех подключенных устройств

📊 Мониторинг и диагностика

Веб-интерфейс

Доступ к веб-интерфейсу для мониторинга:

• Статус системы и подключений
• Логи голосовых команд и ответов
• Статистика использования AI сервисов
• Настройки производительности

Диагностические команды

Используйте голосовые команды для диагностики:

• “状态检查” (проверка статуса) - общий статус системы
• “网络测试” (тест сети) - проверка подключения
• “音频测试” (аудио тест) - тестирование микрофона и динамика

🔧 Устранение проблем

Частые проблемы и решения

Проблема: Устройство не реагирует на голосовое пробуждение

Решения:

• Проверьте правильность произношения “你好小智”
• Убедитесь, что микрофон правильно подключен
• Проверьте уровень громкости и расстояние до устройства
• Перекалибруйте голосовое пробуждение в настройках

Проблема: Медленные ответы AI

Решения:

• Проверьте стабильность интернет-соединения
• Убедитесь в корректности API ключей
• Рассмотрите переключение на более быстрый AI сервис
• Активируйте локальную обработку для простых команд

Проблема: Прерывистая работа Wi-Fi

Решения:

• Проверьте мощность сигнала Wi-Fi
• Убедитесь в правильности пароля сети
• Попробуйте переключиться на 2.4ГГц сеть
• Перезагрузите устройство и роутер

📚 Дополнительные ресурсы

Обучающие материалы

• Видео-уроки по настройке
• Примеры голосовых команд
• Интеграция с популярными сервисами

Техническая поддержка

• Email: [email protected]
• GitHub Issues: https://github.com/xiaozhidev/xiaozhi-firmware/issues
• Сообщество: Telegram чат @xiaozhi_dev