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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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