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

v1.1.0

Koda Desktop может отправлять системные уведомления, когда окно приложения не в фокусе. Это помогает не пропустить завершение задачи или запрос разрешения, даже если вы работаете в другом окне.

Когда приложение показывает уведомление¶

Системные уведомления появляются в трёх случаях:

• агент закончил задачу в чате — вы получаете оповещение, что ответ готов;
• агент ждёт разрешение на действие — под чатом появилась панель Koda просит разрешение;
• задача из расписания завершилась — если вы используете отложенные или фоновые задачи.

Уведомления показываются, только когда окно Koda Desktop свёрнуто или находится не на активном рабочем столе. Если окно активно и в фокусе, уведомления не дублируются.

Что считается событием¶

Приложение следит за состоянием чатов и различает четыре события:

• Нужно решение — чат ждёт ответа на запрос разрешения;
• Ошибка — в чате произошла ошибка или процесс агента завершился с ненулевым кодом;
• Ход прерван — ход закончился без ответа: например, из-за лимита токенов или отказа модели;
• Ответ готов — основной ход завершён.

Чат, открытый в сфокусированном окне, считается прочитанным сразу и не объявляется. Отмена хода кнопкой Стоп событием не считается.

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

Каналы внимания¶

v1.3.0

Об одном событии приложение сообщает одним способом:

• Питомец — пузырь над питомцем, если он включён и виден;
• Системное уведомление — когда питомца нет на экране;
• Счётчик на иконке — число чатов, которые ждут внимания.

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

Особые случаи¶

• Telegram-чаты отслеживаются тихо: ответы и кнопки подтверждения приходят в мессенджер, а пузырей и системных уведомлений нет.
• Запуски по расписанию объявляет планировщик по режиму уведомлений задачи: Только важное, После каждого запуска или Не уведомлять.
• Запрос разрешения из запуска по расписанию объявляется как обычно: без решения запуск стоит.

Как включить или выключить¶

Переключатель Системные уведомления находится в общих настройках.

1. Откройте Настройки кнопкой в нижней части боковой панели.
2. Найдите переключатель Системные уведомления.
3. Включите, если хотите получать оповещения вне окна приложения.
4. Выключите, если уведомления не нужны.

После выключения приложение перестаёт отправлять любые системные уведомления, включая уведомления от задач в расписании.

Уведомления и задачи в расписании¶

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

Подробнее о частоте оповещений для задач — на странице задач по расписанию.

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

v1.2.0

Если настроен Telegram-доступ, владелец может получать в мессенджер уведомления о завершении задач и запросах подтверждения. Эта настройка независима: Telegram-уведомления приходят независимо от переключателя Системные уведомления и настроек ОС.

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

v1.2.0

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

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

Объявления Koda¶

v1.2.7

Кроме системных уведомлений, приложение показывает объявления команды Koda: после входа в аккаунт они появляются карточками справа внизу. Если объявлений несколько, область прокручивается, а новые карточки не вытесняют предыдущие. Карточка остаётся, пока вы не нажмёте Закрыть объявление. Кнопка действия, если она есть, открывает ссылку только по вашему нажатию.

Объявления не попадают в переписку и контекст модели, не отправляются в Telegram и не создают системных уведомлений. Выдача одноразовая для аккаунта, поэтому после перезапуска приложения уже показанные объявления не восстанавливаются.

Поведение на разных платформах¶

Системные уведомления работают через штатный механизм операционной системы:

• macOS — уведомления появляются в Центре уведомлений и на экране, если не включён режим «Не беспокоить».
• Windows — уведомления показываются в системном трее и в центре уведомлений.
• Linux — уведомления отправляются через D-Bus и отображаются в зависимости от окружения рабочего стола (GNOME, KDE и т.д.).

Если уведомления не приходят на вашей платформе, проверьте системные разрешения для Koda Desktop и режим «Не беспокоить» в настройках операционной системы.