Удалённая сборка завершается, пока вы проверяете другой сервер. Агент для кодинга останавливается в ожидании подтверждения в другом терминале. NeoServer теперь поддерживает уведомления о статусе программ OSC 7501 на iOS и macOS, поэтому задача может сообщить вам о завершении, сбое или необходимости подтверждения — и вам не нужно постоянно проверять её терминал.
Нажмите на уведомление, чтобы вернуться к существующей сессии терминала. На macOS NeoServer может также найти разделённую панель с этой сессией.
Что такое OSC 7501?
OSC 7501 — это escape-последовательность терминала, с помощью которой работающая программа сообщает своё состояние. Она может описывать выполняемую работу, завершённую задачу, сбой или паузу, требующую ввода пользователя. Программа отправляет структурированную информацию о статусе через вывод терминала; терминал решает, как её представить. Формат передачи описан в спецификации Program Status Protocol.
Работающая программа сама должна отправлять отчёты OSC 7501. Включение уведомлений не заставит каждую команду оболочки сообщать свой статус. Совместимый инструмент командной строки может отправлять отчёты самостоятельно, а ваши собственные скрипты могут делать это с помощью printf.
Какие состояния вызывают уведомление?
NeoServer применяет эти правила и на iOS, и на macOS:
| Отчёт | Системное уведомление |
|---|---|
state=done | Задача завершена |
state=error | Задача завершилась с ошибкой |
state=blocked:kind=permission | Требуется подтверждение |
state=idle или state=working | Без уведомления |
state=blocked:kind=question или kind=auth | Без уведомления |
NeoServer подавляет уведомления для терминала, который вы уже просматриваете, пока приложение активно. Отчёты из других сессий могут уведомить вас. Когда приложение не активно, уведомления могут приходить, пока NeoServer продолжает получать вывод терминала.
Повторяющиеся обновления сообщений или прогресса не создают повторных оповещений. NeoServer объединяет быстрые изменения, разделяет уведомления из одной сессии минимум на пять секунд и заменяет предыдущее уведомление сессии самым свежим.
Включение уведомлений о статусе программ
- Откройте настройки NeoServer и найдите пункт Terminal Settings.
- Найдите пункт Program Status Notifications внизу страницы настроек терминала. На iOS и macOS он включён по умолчанию.
- Запустите программу, которая отправляет отчёты OSC 7501. NeoServer запрашивает системное разрешение на уведомления после получения первого непустого отчёта о статусе, а не при открытии терминала или переключении настройки.
- Разрешите уведомления в системном диалоге. Если разрешение ранее было отклонено, включите уведомления для NeoServer в настройках уведомлений операционной системы.
Для первой проверки оставайтесь в терминале, пока не ответите на диалог о разрешении. Затем выполните пример с задержкой ниже и переключитесь на другой терминал в NeoServer.
Проверка уведомления о завершении по SSH
Подключитесь к серверу через обычный SSH-терминал и вставьте:
printf '\033]7501;state=working:id=demo:app=demo\033\\'
sleep 10
printf '\033]7501;state=done:id=demo:app=demo\033\\'
Во время десятисекундной задержки переключитесь на другую сессию терминала в NeoServer. Если NeoServer остаётся открытым, это простая проверка всего потока уведомлений о статусе. Уведомление о завершении должно прийти после обработки последнего отчёта — с учётом системных настроек уведомлений.
Чтобы проверить уведомления о сбое или подтверждении, выполните любой из примеров и переключитесь на другую сессию во время задержки:
# Report a failed task.
sleep 10
printf '\033]7501;state=error:id=demo:app=demo\033\\'
# Report a task waiting for approval.
sleep 10
printf '\033]7501;state=blocked:id=demo:kind=permission:app=demo\033\\'
sleep 10
Финальная задержка в примере с подтверждением удерживает отчёт о блокировке до возвращения оболочки к приглашению ввода. Оставьте время, чтобы уведомление пришло, прежде чем возвращаться к исходному терминалу. Немедленная очистка или замена отчёта может отменить ожидающее оповещение.
Эти команды лишь сообщают статус. Пример с подтверждением не выполняет операцию и не выдаёт разрешение. Нажатие на его уведомление открывает терминал, где можно изучить запрос реальной программы.
Добавление отчётов о статусе в собственные скрипты
Оберните команду так, чтобы результат её завершения превращался в явный отчёт об успехе или сбое:
#!/bin/sh
printf '\033]7501;state=working:id=job:app=script\033\\'
# Replace this command with your build or other task.
if sh -c 'sleep 10'; then
result=0
state=done
else
result=$?
state=error
fi
printf '\033]7501;state=%s:id=job:app=script\033\\' "$state"
exit "$result"
Запустите скрипт в подключённом терминале, чтобы NeoServer получал его вывод. Этот пример сохраняет код завершения команды. Для собственного текста уведомления поля title и msg протокола принимают однострочный текст UTF-8 в кодировке Base64; app — короткий идентификатор программы.
Поведение iOS в фоне и пропавшие уведомления
Это локальные системные уведомления, создаваемые из получаемого вывода терминала. NeoServer должен сохранять возможность получать и разбирать этот вывод. Если iOS приостанавливает или завершает приложение, оно не сможет создавать новые уведомления об изменениях удалённого статуса. Удалённая задача может продолжать работать, пока новое оповещение так и не достигнет вашего iPhone.
Если оповещение не появляется, проверьте следующее:
- Начните с прямого SSH. Если примеры работают там, но не работают внутри tmux или screen, проверьте, передаёт ли этот слой OSC-последовательность в NeoServer.
- Переключитесь с исходного терминала. Активный видимый терминал намеренно молчит.
- Проверьте и разрешение, и переключатель в приложении. Системные настройки уведомлений и режим фокусировки могут влиять на появление баннера.
- Сохраняйте отчёт достаточно долго. Быстрая очистка отчёта или смена его состояния может отменить или заменить ожидающее уведомление.
- Проверьте сообщаемое состояние. Пауза для вопроса или аутентификации не вызывает уведомление о подтверждении; для него нужно
blockedсkind=permission.
Нажатие на уведомление выбирает существующую сессию. Если эта сессия уже закрыта, NeoServer сообщит вам об этом; он не переподключается и не выполняет команды автоматически. Если приложение заблокировано, переход выполняется только после разблокировки.
О настройке подключения читайте в кратком руководстве NeoServer. Об остальных настройках терминала см. Terminal Settings.
Готовы попробовать?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Бесплатно в App Store