Если что-то пошло не так¶
Эта страница помогает быстро понять типичные сообщения и состояния в Koda Desktop.
Агент не запускается¶
Если в чате появилось сообщение, что запуск не удался, проверьте режим запуска агента в настройках.
- Для режима npx-пакет нужны Node.js, npm и доступ в интернет при первом запуске.
- Для режима глобальный koda команда должна быть установлена и доступна приложению.
После исправления настроек создайте новый чат или отправьте запрос ещё раз.
Если ошибка говорит, что папка проекта не найдена, проверьте саму папку. Для обычного проекта её нужно вернуть на диск или открыть проект заново. Для управляемой временной папки Koda Desktop попробует восстановить директорию перед запуском агента.
Требуется авторизация¶
Откройте Настройки -> Аккаунт и запустите вход. После подтверждения вернитесь в чат и повторите запрос.
Если вход уже выполнен, но сообщение повторяется, выйдите из аккаунта и войдите снова.
Проект показывает «Нет git»¶
Такое состояние означает, что выбранная папка не является git-репозиторием. Агент всё равно может работать с файлами проекта, но переключатель веток будет недоступен.
Если вы ожидали увидеть ветки, проверьте, что открыта корневая папка репозитория или вложенная папка внутри рабочей копии git.
Не переключается ветка¶
Переключение ветки выполняется через git switch.
Причины ошибки обычно такие:
- в проекте есть незакоммиченные изменения, конфликтующие с переключением;
- ветка удалена или не является локальной;
- git-команда недоступна в окружении приложения.
Текст ошибки показывается в чипе ветки или рядом с ним.
Git pull не выполняется¶
Koda Desktop выполняет Git pull только через fast-forward. Это безопаснее для приложения: оно не создаёт merge-коммит и не запускает rebase без вашего решения.
Типовые причины ошибки:
- есть локальные изменения, которые будут перезаписаны;
- у текущей ветки нет upstream;
- локальная и удалённая ветки разошлись.
В таком случае сохраните изменения, сделайте stash или решите merge/rebase вручную, затем повторите действие.
Вложение не добавляется¶
Проверьте формат и размер файла.
Поддерживаются PNG, JPG, WEBP, GIF, PDF, DOCX, TXT, MD, CSV, JSON, XML и LOG. Один файл может быть до 20 МБ, суммарно в одном запросе — до 50 МБ.
Если PDF является сканом без текстового слоя, агент всё равно получит бинарный PDF, но текст может не извлечься автоматически.
Запрос завис на разрешении¶
Если под чатом висит панель Нужно подтверждение, агент ждёт вашего решения.
Выберите один из вариантов разрешения или нажмите Стоп, чтобы отменить текущий ответ. При остановке приложения ожидающие разрешения закрываются.
Если к запросу были приложены файлы, они останутся видимыми в уже отправленном сообщении. Это нормальное поведение: история показывает, какой контекст ушёл агенту.
Логи пустые¶
Логи показываются для активной сессии. Если выбран другой чат или агент ещё не писал stderr, вкладка Логи может быть пустой.
Включите Отладочный лог в настройках и повторите действие, которое нужно диагностировать.
После перезапуска ответ помечен завершённым¶
Если Koda Desktop был закрыт во время ответа, сессия при следующем запуске будет считаться завершённой.
Откройте чат и отправьте новый запрос, если нужно продолжить работу.
Ответ получился не туда¶
Остановите задачу кнопкой Стоп и отправьте уточнение в тот же чат:
Остановимся. Мне нужен другой подход: сначала без правок найди причину, покажи файлы и только потом предложи минимальное изменение.
Если контекст уже сильно смешался, создайте новый чат в том же проекте и перенесите туда только важные факты.