y83 code / справочник

Уведомления

Экран решает, какие сигналы приложение будет присылать, когда вы свернули телефон. Здесь три переключателя: два агента (Codex, OpenCode) и отдельно — задачи, запущенные по расписанию. Ничего больше экран не делает: он не показывает историю уведомлений и не управляет ими на уровне системы.

раздел
Подсистемы приложения
пунктов возможностей
20
источник
docs/about/notifications.md

В Хабе инструментов карточка лежит в секции «Приложение», а на главном экране её быстрый тайл называется «Сигналы».

Возможности

  • Codex — сигнал, когда агент закончил ход. В тексте уведомления видно конец ответа агента одной строкой, сколько ход длился, сколько токенов ушло и сколько было команд, файлов и вызовов инструментов. Если ход прервали или он сломался, вместо ответа будет написано, что именно случилось.
  • OpenCode — сигнал, когда ассистент ответил в чате. В уведомление попадает конец последнего текстового сообщения.
  • Запуски по расписанию — сигнал о завершении, ошибке или остановке задачи планировщика. Это единственный переключатель в своей секции.
  • Тап по уведомлению открывает нужное место. Для агентов — тот самый чат и та сессия, где агент закончил. Для задачи по расписанию — экран планировщика с этой задачей. Приложение при этом не пересоздаётся, а просто переключает экран, даже если оно уже было открыто в фоне.
  • Два системных канала. «Обновления чата» — для агентов, «Запуски по расписанию» — для задач. Каналы создаются сами при первом уведомлении, обычной важности. Переименовать их или поднять важность можно только в настройках Android.
  • Уведомление о задаче присылает сервер. Планировщик живёт в фоне на сервере и команду показать уведомление отправляет приложению через мост, а агентов о завершении хода уведомляет само приложение.
  • Две секции на экране. Сверху «Уведомления по агентам» с пояснением, что речь про работу в фоне, снизу «Планировщик» с одним переключателем.
  • Состояние видно сразу. Включённый переключатель красит иконку источника в бирюзовый и делает её заметной, выключенный — гасит иконку и название. Само значение пишется в настройки сразу, без кнопки «Сохранить».

Технические данные

ПараметрЗначение
Переключателей на экране3: два агента и планировщик
Каналов уведомлений2: чат и планировщик
Важность каналовобычная, создаётся автоматически
Состояние новых переключателейвключено
Обрезка текста200 символов, до 500 в развёрнутом виде
Уведомлений на одну сессиюодно, а не пачка
Версия Android для запроса разрешения13 и новее
Повторный запрос разрешенияне предусмотрен
Перевод экранатолько английский
Кто показывает уведомлениеагентов — приложение, задачи — сервер через мост
Сейчас на устройствеOpenCode и Codex включены, планировщик включён

Что агент умеет

  • Открыть экран командой моста и посмотреть на него снимок — так агент проверяет, что переключатели стоят в нужном состоянии.
  • Дёрнуть переключатель командами управления интерфейсом: найти карточку источника и нажать её, то есть включить или выключить уведомления агента.
  • Прочитать все настройки приложения и найти среди них записи об уведомлениях плюс отметку, что разрешение уже запрашивали. Это единственный способ узнать реальное состояние, не открывая экран.
  • Отправить своё уведомление в канал планировщика: команда с идентификатором задачи, заголовком и текстом. Оно попадёт в шторку и подчиняется тому же переключателю «Запуски по расписанию».
  • Чего агент не может: выдать системное разрешение на уведомления, включить их в обход переключателей, прочитать историю уведомлений или отключить отдельный источник на уровне Android.

Ограничения

  • Экран не переведён. Все надписи здесь по-английски, даже когда остальное приложение на русском.
  • Переключатели не выдают разрешение. Включённый тумблер при отсутствующем системном разрешении ничего не меняет — уведомлений не будет, а экран будет показывать «включено». Состояние разрешения видно на экране «Установка»: там есть строка про уведомления, а её кнопка открывает настройки уведомлений самой системы.
  • Повторно спросить нельзя. Отметка «разрешение уже запрашивали» выставляется до показа системного диалога, поэтому отказ записывается сразу. Чтобы вернуть запрос, разрешение придётся выдать вручную в настройках системы.
  • На переднем плане уведомления нет. Когда приложение открыто, вместо уведомления у Codex звучит обычный системный сигнал — причём даже при выключенном переключателе. У OpenCode в этом случае просто ничего не происходит. Переключатели управляют только фоновыми сигналами.
  • Экран не показывает состояние разрешения — только свои переключатели, поэтому «всё включено» легко принять за «уведомления приходят».
  • Забытый источник будет писать. Если появится агент, которого нет на этом экране, его уведомления по умолчанию считаются включёнными.
  • Настройка живёт только на этом устройстве. Синхронизации с сервером нет: на другом телефоне переключатели будут в исходном состоянии.

Источник: docs/about/notifications.md. Страница собрана из документации проекта при сборке сайта — без пересказа.