Решение общих проблем с плагином¶

Это руководство поможет решить распространённые проблемы при использовании Koda в VS Code и IntelliJ.

Дополнительно изучите соседнюю страницу по вопросам, специфичным для IntelliJ.

Если здесь готового решения нет -- сообщите нам: XCode-NLP/KodaCode. Возможно, вы встретили настоящий баг, о котором мы ещё не знаем, либо такой функционал ещё не разрабатывался.

Проблемы установки¶

Ошибка при установке плагина IntelliJ¶

Симптомы: Сообщение об ошибке при установке из файла ZIP

Решение:

1. Убедитесь, что файл ZIP не повреждён
2. Скачайте файл заново для вашей операционной системы
3. Проверьте совместимость версии плагина и IDE

Проблемы с чатом¶

Чат не открывается¶

Сообщения не отправляются¶

Причины:

• Нет подключения к интернету
• Проблема с сервером моделей
• Превышены лимиты

Решение:

1. Проверьте интернет-соединение
2. Проверьте статус сервера моделей
3. Проверьте лимиты использования в настройках

Сессия не сохраняется¶

Причины:

• Ошибка записи на диск
• Переполнено хранилище
• Проблема с правами доступа

Решение:

1. Проверьте место на диске:

   df -h ~/.koda
   

2. Очистите старые сессии
3. Проверьте права доступа:

   ls -la ~/.koda/sessions/
   

Ошибка: "Model not found"¶

Решение: Проверьте название модели в конфигурации и убедитесь, что она доступна у провайдера.

Ошибка: "Context length exceeded"¶

Решение: Используйте команду /summarize или начните новый чат.

Ошибка: "Failed to connect to server"¶

Решение: Проверьте интернет-соединение и настройки прокси (если используется).

Ошибка: "Permission denied" (терминал)¶

Решение: Проверьте права доступа к терминалу и рабочей директории.

Ошибка: "Index corrupted"¶

Решение: Удалите директорию индекса ~/.koda/index и переиндексируйте проект.

Сетевые проблемы¶

Возникает ошибка: "Internal Server Error from https://api.kodacode.ru/..."¶

Если появляется окно, которое может содержать подобную ошибку:

тогда см. содержимое ошибки ниже:

• No chat model selected Не выбрана модель. Вероятнее всего, в конфиге не указаны модели или он некорректен. Читай здесь: Проблемы конфигурации

  Также это может быть связано с внутренней ошибкой плагина. Нажмите View logs.

• 413 Request Entity Too Large Слишком большой файл. Попробуйте снизить нагрузку на модель, уменьшив количество передаваемых данных в запросе. Например, не включать файл сразу в контекст через @, а попросить модель прочесть некоторый диапазон строк из него.

• This endpoint's maximum context length is 204800 tokens... В контексте скопилось слишком много данных. Его размер можно увидеть под полем ввода:

  

  Используйте команду /summarize, чтобы сжать контекст, или начните новый чат.

• unable to verify the first certificate Такое возникает в закрытых корпоративных контурах, где происходит подмена SSL-сертификатов или работают антивирусы/фаерволлы.

  Для VSCode можно попробовать в настройках отключить параметры http.proxyStrictSSL, http.proxySupport (off) и перезапустить.

  Также можно поискать корневой сертификат в вашей цепочке и добавить в системное хранилище доверенных сертификатов.

  Ещё один вариант: установить значение системной переменной окружения NODE_TLS_REJECT_UNAUTHORIZED равным нулю.

• Invalid JSON in tool call arguments При работе одного из инструментов на стороне плагина возникла ошибка, которую бэкенд не может обработать.

  Если ошибка редкая, то попробуйте отправить ваше последнее сообщение заново: не скопировать и отправить в окошке ввода снизу, а переотправить именно то, которое видно в истории чата, до ошибки.

  Если не поможет, начните новый чат.

• Input is a zero-length, empty document: line 1 column 1 (char 0) Вероятно, в контекст попало что-то, что не проходит валидацию на бэкенде, например, пустой файл. Это не пофиксить ужиманием контекста, только создать новый чат.

Получение помощи¶

Если проблема не решена:

1. Проверьте соответствующий раздел документации
2. Поищите в Telegram-канале
3. Задайте вопрос в чате поддержки: https://t.me/+r-7z_JzQJc0yYjEy
4. Приложите логи и описание проблемы