Общие настройки¶

Окно настроек открывается кнопкой Настройки в нижней части боковой панели.

Тема¶

Доступны три режима оформления:

светлая тема;
тёмная тема;
системная тема.

При выборе системной темы Koda Desktop следует настройкам ОС.

Аккаунт¶

Во вкладке Аккаунт видно состояние входа, email, тариф и доступные лимиты.

Подробно о входе, тарифах и лимитах — на странице Аккаунт.

Запуск CLI¶

Блок Запуск CLI выбирает, как Koda Desktop запускает локального агента: встроенный CLI, npx-пакет или глобальную команду koda. Приложение проверяет доступность вариантов при открытии настроек и помечает недоступные предупреждением.

Подробно о режимах запуска — на странице Запуск CLI.

Автоматическое сжатие контекста¶

Переключатель Автоматически сжимать контекст (включён по умолчанию) разрешает агенту сжимать контекст самому. Сжатие запускается после того, как модель подтвердит размер контекста: за 40 000 токенов до лимита, а для окон меньше 40 000 токенов — при заполненности 75 %.

Если выключить его, контекст можно сжать вручную — кнопкой в меню индикатора заполненности. Превышение лимита контекста при этом по-прежнему остановит отправку запроса.

Подробно о сжатии — на странице управления контекстом.

Ограничение числа шагов агента¶

Переключатель Ограничивать число шагов агента (включён по умолчанию) задаёт, сколько обращений к модели агент может сделать за один ход, прежде чем остановится. По умолчанию — 100 обращений.

При включённом переключателе рядом появляется поле Запросов к модели за один ход — целое число от 1 до 10 000. Выключите переключатель, чтобы снять ограничение: агент будет работать, пока не завершит задачу или не остановится по другой причине.

О поведении при остановке — в разделе почему задача остановилась.

Системные уведомления¶

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

Подробно о поведении уведомлений — на странице Системные уведомления.

Звук завершения ответа¶

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

Сигнал не зависит от переключателя Системные уведомления и не проигрывается для задач по расписанию и чатов из Telegram.

Подробно о поведении — на странице Системные уведомления.

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

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

Проверка обновлений¶

Переключатель Проверять обновления при запуске (включён по умолчанию) разрешает приложению один раз при запуске проверять, доступна ли новая версия. Если новая версия есть, справа внизу появляется карточка Доступна новая версия Koda Desktop с номером версии и кнопкой Скачать. Карточка остаётся до закрытия, а при следующем запуске проверка повторяется.

Кнопка Проверить обновления проверяет версию по вашему запросу и показывает результат рядом с кнопкой.

Подробнее об установке и обновлении — на странице обновления.

Где сохраняются настройки¶

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