Неполадки
Первое, что смотреть, — журнал колонки tmp\speaker.log на компьютере с колонкой. В нём каждая услышанная фраза, ответ и время.
| Что видно | Что проверить |
|---|---|
| Колонка не отзывается совсем | Работает ли задача колонки в планировщике. Последняя строка журнала «слушаю; скажи…»? Если «микрофон 5 с не даёт звука — выхожу», у задачи нет повторного триггера |
| «speaches недоступен — резерв» | Запущены ли Docker Desktop и контейнер speaches, совпадает ли адрес в настройках. Кнопка «Проверить» в карточке речи |
| Колонка путает слова | Модель распознавания: faster-whisper-large-v3-turbo заметно точнее маленьких. Микрофон ближе |
| Колонка не слышит при включённом телевизоре | Говорите имя и просьбу одной фразой, ближе к микрофону. Фильм идёт с этого компьютера — «Вычитать звук компьютера» в «Микрофонах колонки». Телевизор со своим приложением так не вычесть: с ReSpeaker поставьте режим «Шумная — телевизор, разговоры». В журнале под фоном — «рядом фоновая речь (телевизор?) — пока только по имени» |
| Слушает не тот микрофон | «Микрофоны колонки» → «Какой микрофон слушать»: список микрофонов машины у каждого экземпляра, «По умолчанию» — заданный при установке. Меняется за несколько секунд без перезапуска. Запасной путь — ключ input в settings.json в каталоге мозгов |
| Хомер никого не узнаёт по голосу или всех считает гостями | Есть ли модели в speaker-home\voiceid — без них в журнале нет строк «голос: …». Ограничения гостя действуют, только когда в «Голосах дома» подтверждён хотя бы один свой; заявка становится своим голосом после «Подтвердить» |
| «Голова не отвечает» | Вход в Claude Code на компьютере с колонкой: claude в терминале под тем же пользователем. Лимиты подписки. Если claude завис, сторож убивает его через 60 с («голова молчит 60 с — перезапускаю» в журнале), и следующая реплика поднимает новый. Ответ всё равно будет, если работает запасная голова: облако с ключом или LM Studio |
| В журнале «ответила запасная голова: LocalBrain» | Основная не ответила, отвечает локальная модель без инструментов. Чинить основную, как строкой выше. Не отвечает и она — запущен ли сервер LM Studio на :18234 |
| Smartbox в гостиной молчит | К кому она подключена: строка «сетевая колонка подключилась» в tmp\speaker-smartbox.log на компьютере или на GPD. Нет её нигде — работает ли задача homer-speaker-smartbox. Без имени тихие реплики (ниже 28 дБ) отсекаются нарочно |
| Колонки на GPD остановились сами | Перегрев: в C:\Users\mail\homer-events.log строка «ПЕРЕГРЕВ: колонка остановлена до 65 °C». Сторож homer-thermlog вернёт их сам после остывания. Включён ли вентилятор GPD |
| «С музыкой не вышло: нет входа» | Подключена ли интеграция Яндекс Станции в Home Assistant, есть ли Плюс |
| Музыку не слышно | Устройство вывода Windows по умолчанию, громкость (music_control volume) |
| «За 120 с никто не подключился» | Сброшено ли устройство, далеко ли от координатора, жив ли мост (diag) |
| «Ещё занята прошлым» | Идёт другое поручение Opus; дождитесь итога или посмотрите журнал |
| «Не уложилась в 15 минут» | Журнал покажет, на каком шаге Opus застрял. Разбейте поручение на части |
| Журнал не приходит в Telegram | Привязана ли группа к дому (Настройки → Уведомления → Telegram) |
| «Подключить к Claude Code» отвечает ошибкой | Колонка должна работать от того же пользователя, что и Claude Code. Проверка: claude mcp get homer |
| Инструмент «не разрешён» | Выключен на этом уровне в Настройки → Колонка → Мозги Хомера |
Где что лежит
| Путь | Что это |
|---|---|
tools/speaker/speaker.py | Колонка: микрофон, имя, распознавание, мозги, голос, HTTP-вход :8790 |
tools/speaker/agent.py | Музыка, таймеры, поручения Opus, журнал, подключение к Claude Code |
tools/speaker/homer_mcp.py | MCP-сервер homer с инструментами |
tools/speaker/homer_voiceid.py | Отпечаток голоса: кто говорит, альбом на сервере Хомера |
settings.json в каталоге мозгов | Микрофон (input) и устройство вывода (output) колонки без приложения |
tools/respeaker/ | ReSpeaker на компьютере через WSL: мост udp:8799, режимы, кольцо |
tmp/speaker.log | Журнал колонки |
tmp/speaker-smartbox.log | Журнал Smartbox, на компьютере и на GPD |
secrets/local-llm-key.txt | Токен LM Studio для запасной головы |
tools/gpd/thermlog.ps1 | Сторож перегрева GPD (задача homer-thermlog) |
secrets/ha-credentials.txt | Токен Home Assistant для инструментов (token=…) |
secrets/alice-skill-key.txt | Ключ колонки к серверу дома: настройки, журнал, токен музыки |
secrets/yandex-music-token.txt | Необязательный свой токен Яндекс Музыки |
~/.claude/skills/homer-* | Навыки в Claude Code после подключения |
Каталог мозгов (C:\Apps\HomerSpeaker) | Рабочая папка claude колонки и поручений, файлы mcp-voice.json и opus/mcp-opus.json |