Уведомления¶

Интерактивный Koda CLI показывает короткие уведомления над областью чата. Так приходят объявления аккаунта и сообщение о новой версии CLI.

Как показываются уведомления¶

Уведомление появляется одной карточкой на 15 секунд. Карточка не записывается в историю разговора, контрольные точки и контекст модели: модель её не видит.

Пока в истории сессии есть уведомления, над полем ввода виден индикатор Уведомления: N · /notifications. Число показывает, сколько сообщений сохранено в истории текущей сессии.

Карточки не перехватывают клавиатуру. Пока открыт диалог, идёт авторизация или просмотр истории, таймер показа приостанавливается. Просроченные сообщения отбрасываются до начала показа. Уже показанные сообщения остаются в истории с отметкой «Срок действия истёк».

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

История и команда /notifications¶

Команда /notifications открывает историю уведомлений текущей сессии:

• ↑ и ↓ выбирают сообщение;
• Enter открывает ссылку из сообщения в браузере;
• Delete удаляет сообщение;
• Esc возвращает к вводу.

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

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

Уведомления аккаунта¶

Объявления аккаунта получает только самостоятельный интерактивный CLI с выполненным входом. В ACP-сессии, встроенном CLI Koda Desktop, headless-режиме и без привязки аккаунта такие уведомления не запрашиваются. Выбранная модель и провайдер на доставку не влияют.

CLI получает уведомления автоматически и повторяет запрос при временных сетевых ошибках. Если сервер не поддерживает уведомления, ошибка пользователю не показывается. Сервер не отправляет уже выданное сообщение повторно, поэтому аварийное завершение процесса сразу после получения может привести к потере показа.

Выход из аккаунта и переход к другой учётной записи очищают объявления аккаунта. Сообщение о новой версии CLI при этом остаётся в истории текущей сессии.

Проверка новой версии¶

При каждом запуске самостоятельный интерактивный CLI один раз проверяет, не вышла ли новая версия. Для проверки не нужен вход, ошибки проверки не мешают запуску, а запрос прекращается через 10 секунд. В ACP-режиме и неинтерактивном режиме проверки нет.

Настройка «Проверять обновления при запуске» в /settings — ключ checkForUpdatesAtStartup — по умолчанию включена. Значение false полностью отключает запрос при следующем запуске.

Новая версия показывается карточкой «Уведомление Koda» на 15 секунд и сохраняется в истории текущей сессии. В истории Enter открывает ссылку на скачивание обновления. Удаление сообщения действует до завершения процесса: при следующем запуске версия проверяется снова.

Настройки disableAutoUpdate и disableUpdateNag продолжают управлять автоматической установкой и показом сообщения. Отключённая проверка также исключает автоматическую установку по её результату.