Перейти к содержанию

Логи и диагностика

Koda Desktop предоставляет несколько каналов диагностики для поиска и устранения проблем.

Вкладка Лог окна настроек

Вкладка Лог окна настроек

Отладочный лог

Переключатель Отладочный лог в общих настройках включает дополнительные служебные сообщения. Это полезно, когда:

  • агент не стартует
  • модель не появляется в списке
  • агент завершился с ошибкой
  • запрос остановился неожиданно

Вкладка «Логи» в настройках

Во вкладке Логи окна настроек отображаются служебные сообщения текущей сессии.

Логи состоят из двух частей:

  1. Диагностика агента — сообщения от запусков, которые не относятся к конкретному чату (например, проверка доступности моделей)
  2. Логи сессии — stderr текущего активного чата

Если лог пуст, убедитесь, что:

  • выбран активный чат
  • агент запускался в текущей сессии
  • включён Отладочный лог

Отчёт об ошибке

Когда появляется уведомление об ошибке, на его карточке есть кнопка Скопировать отчёт. Она кладёт в буфер обмена готовый текст: версию приложения, операционную систему, режим запуска агента, выбранную модель и хвост лога.

Отчёт собирается в тот момент, когда ошибка возникла. Нажать кнопку можно и позже: в буфер попадёт состояние момента сбоя, а не текущий лог. Кнопка не закрывает уведомление, поэтому основное действие рядом с ней остаётся доступным.

Если сбой не показал уведомления, откройте Настройки → Логи и нажмите Скопировать отчёт там. Кнопка работает даже при пустой вкладке: приложение ведёт собственный лог отдельно от stderr агента.

Копия каждого отчёта сохраняется на диск рядом с логом приложения:

  • macOS: ~/Library/Application Support/Koda Desktop/logs
  • Windows: %APPDATA%\Koda Desktop\logs
  • Linux: ~/.config/Koda Desktop/logs

В папке лежат:

  • koda-desktop.log — общий лог приложения с ротацией (5 МБ, 3 файла)
  • incident-<дата>.log — по одному файлу на каждую ошибку

Хранятся последние 20 инцидентов, поэтому отчёт можно забрать и после перезапуска приложения.

Проверьте отчёт перед отправкой

Из отчёта убираются токены и путь к домашней папке, но перед отправкой его всё равно стоит просмотреть.

Логи в разных режимах CLI

  • Встроенный режим — логи включают все сообщения от встроенного CLI
  • npx-пакет — логи включают вывод npx и CLI
  • Глобальный koda — логи включают вывод глобальной команды koda

Диагностика до первого чата

Некоторые проблемы возникают до того, как создан первый чат: например, сбой при проверке моделей проекта. Такие сообщения отображаются в секции диагностики над логами сессии.

Что искать в логах

Типичные маркеры проблем:

  • Error: — общая ошибка выполнения
  • ENOENT — файл или команда не найдены
  • EACCES — недостаточно прав
  • timeout — превышение времени ожидания
  • ECONNREFUSED — соединение отклонено (часто для MCP)