Skip to content

OSC-7501-Programmstatus-Benachrichtigungen in NeoServer für iOS und macOS

Erhalten Sie in NeoServer auf iOS und macOS Benachrichtigungen über Abschluss, Fehlschlag und Freigabe von Terminal-Aufgaben. Erfahren Sie, wie Sie OSC-7501-Hinweise aktivieren und über SSH testen.

4 Min. LesezeitNeoServer

Ein Remote-Build wird abgeschlossen, während Sie einen anderen Server prüfen. Ein Coding-Agent hält in einem anderen Terminal an und wartet auf eine Freigabe. NeoServer unterstützt jetzt OSC-7501-Programmstatus-Benachrichtigungen auf iOS und macOS, sodass eine Aufgabe Ihnen mitteilen kann, wann sie abgeschlossen ist, fehlschlägt oder eine Freigabe benötigt – ohne dass Sie ihr Terminal immer wieder prüfen müssen.

Tippen Sie auf eine Benachrichtigung, um zur bestehenden Terminal-Sitzung zurückzukehren. Auf macOS kann NeoServer zudem das Split-Pane-Fenster der Sitzung auffinden.

Was ist OSC 7501?

OSC 7501 ist eine Terminal-Escapesequenz, mit der ein laufendes Programm seinen Zustand meldet. Sie kann laufende Arbeit, eine abgeschlossene Aufgabe, einen Fehlschlag oder eine Pause beschreiben, die eine Benutzereingabe erfordert. Das Programm sendet strukturierte Statusinformationen über die Terminal-Ausgabe; das Terminal entscheidet, wie es sie darstellt. Das Übertragungsformat finden Sie in der Program-Status-Protokollspezifikation.

Das laufende Programm muss OSC-7501-Berichte senden. Das Aktivieren von Benachrichtigungen bewirkt nicht, dass jeder Shell-Befehl seinen Status meldet. Ein kompatibles Kommandozeilen-Tool kann selbst Berichte senden, und Ihre eigenen Skripte können sie mit printf senden.

Welche Zustände erzeugen eine Benachrichtigung?

NeoServer verwendet diese Regeln sowohl auf iOS als auch auf macOS:

BerichtSystembenachrichtigung
state=doneAufgabe abgeschlossen
state=errorAufgabe fehlgeschlagen
state=blocked:kind=permissionFreigabe erforderlich
state=idle oder state=workingKeine Benachrichtigung
state=blocked:kind=question oder kind=authKeine Benachrichtigung

NeoServer unterdrückt Benachrichtigungen für ein Terminal, das Sie gerade betrachten, während die App aktiv ist. Berichte aus anderen Sitzungen können Sie benachrichtigen. Ist die App nicht aktiv, können Benachrichtigungen erscheinen, solange NeoServer weiterhin Terminal-Ausgaben empfängt.

Wiederholte Nachrichten- oder Fortschrittsaktualisierungen erzeugen keine wiederholten Hinweise. NeoServer fasst schnelle Änderungen zusammen, hält Benachrichtigungen derselben Sitzung mindestens fünf Sekunden auseinander und ersetzt die vorherige Benachrichtigung dieser Sitzung durch die neueste.

Programmstatus-Benachrichtigungen aktivieren

  1. Öffnen Sie die Einstellungen von NeoServer und suchen Sie Terminal Settings.
  2. Suchen Sie Program Status Notifications am unteren Ende der Seite mit den Terminal-Einstellungen. Die Funktion ist auf iOS und macOS standardmäßig aktiviert.
  3. Führen Sie ein Programm aus, das OSC-7501-Berichte sendet. NeoServer fordert die Systemberechtigung für Benachrichtigungen an, nachdem es den ersten nicht leeren Statusbericht empfangen hat – nicht bereits beim Öffnen eines Terminals oder beim Umschalten der Einstellung.
  4. Erlauben Sie Benachrichtigungen im System-Berechtigungsdialog. Wurde die Berechtigung zuvor verweigert, aktivieren Sie Benachrichtigungen für NeoServer in den Benachrichtigungseinstellungen des Betriebssystems.

Bleiben Sie für einen ersten Test im Terminal, bis Sie den Berechtigungsdialog beantwortet haben. Führen Sie dann das verzögerte Beispiel unten aus und wechseln Sie in NeoServer zu einem anderen Terminal.

Eine Abschluss-Benachrichtigung über SSH ausprobieren

Verbinden Sie sich mit einem gewöhnlichen SSH-Terminal mit einem Server und fügen Sie Folgendes ein:

printf '\033]7501;state=working:id=demo:app=demo\033\\'
sleep 10
printf '\033]7501;state=done:id=demo:app=demo\033\\'

Wechseln Sie während der zehnsekündigen Verzögerung zu einer anderen Terminal-Sitzung in NeoServer. Wenn Sie NeoServer geöffnet lassen, ergibt sich ein unkomplizierter Test des Benachrichtigungsablaufs. Eine Abschluss-Benachrichtigung sollte eintreffen, nachdem der letzte Bericht verarbeitet wurde – abhängig von den System-Benachrichtigungseinstellungen.

Um Fehlschlag- oder Freigabe-Benachrichtigungen zu testen, führen Sie eines der Beispiele aus und wechseln Sie während der Verzögerung zu einer anderen Sitzung:

# 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

Die abschließende Verzögerung im Freigabe-Beispiel hält den blockierten Bericht an Ort und Stelle, bevor die Shell zu ihrer Eingabeaufforderung zurückkehrt. Lassen Sie der Benachrichtigung Zeit anzukommen, bevor Sie zum Quell-Terminal zurückkehren. Das sofortige Löschen oder Ersetzen eines Berichts kann einen ausstehenden Hinweis annullieren.

Diese Befehle melden nur einen Status. Das Freigabe-Beispiel führt keinen Vorgang aus und erteilt keine Berechtigung. Ein Tipp auf seine Benachrichtigung öffnet das Terminal, wo Sie die Anfrage des eigentlichen Programms prüfen können.

Statusberichte zu eigenen Skripten hinzufügen

Umschließen Sie einen Befehl, sodass sein Exit-Ergebnis zu einem expliziten Abschluss- oder Fehlerbericht wird:

#!/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"

Führen Sie das Skript im verbundenen Terminal aus, damit NeoServer seine Ausgabe empfängt. Dieses Beispiel bewahrt den Exit-Code des Befehls. Für eigenen Benachrichtigungstext nehmen die Felder title und msg des Protokolls Base64-kodierten, einzeiligen UTF-8-Text auf; app ist eine kurze Programm-Kennung.

iOS-Hintergrundverhalten und fehlende Hinweise

Es handelt sich um lokale Systembenachrichtigungen, die aus empfangenen Terminal-Ausgaben erzeugt werden. NeoServer muss weiterhin in der Lage sein, diese Ausgaben zu empfangen und zu parsen. Setzt iOS die App aus oder beendet sie, kann sie keine neuen Benachrichtigungen aus Remote-Statusänderungen erzeugen. Ein Remote-Job läuft möglicherweise weiter, ohne dass ein neuer Hinweis Ihr iPhone erreicht.

Erscheint kein Hinweis, prüfen Sie diese Punkte:

  • Beginnen Sie mit direktem SSH. Funktionieren die Beispiele dort, aber nicht innerhalb von tmux oder screen, prüfen Sie, ob diese Ebene die OSC-Sequenz an NeoServer weiterleitet.
  • Wechseln Sie vom Quell-Terminal weg. Ein aktives, sichtbares Terminal bleibt bewusst still.
  • Prüfen Sie sowohl die Berechtigung als auch den App-Schalter. System-Benachrichtigungseinstellungen und Fokus-Einstellungen können beeinflussen, ob ein Banner erscheint.
  • Halten Sie den Bericht lange genug aufrecht. Das schnelle Löschen eines Berichts oder das Ändern seines Zustands kann die ausstehende Benachrichtigung annullieren oder ersetzen.
  • Prüfen Sie den gemeldeten Zustand. Eine Frage- oder Authentifizierungspause löst nicht die Freigabe-Benachrichtigung aus; sie erfordert blocked mit kind=permission.

Ein Tipp auf eine Benachrichtigung wählt eine bestehende Sitzung aus. Ist diese Sitzung bereits geschlossen, meldet NeoServer dies; die App verbindet sich nicht neu und führt keine Befehle automatisch aus. Ist die App gesperrt, wartet die Navigation, bis Sie sie entsperren.

Zum Einrichten der Verbindung lesen Sie die NeoServer-Kurzanleitung. Für die übrigen Terminal-Einstellungen siehe Terminal Settings.

NeoServer

SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

App Store

Bereit zum Ausprobieren?

NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

Kostenlos im App Store