Skip to content

Notificaciones de estado de programas OSC 7501 en NeoServer para iOS y macOS

Recibe en NeoServer, en iOS y macOS, notificaciones de finalización, fallo y aprobación de tareas del terminal. Aprende a activar las alertas OSC 7501 y a probarlas por SSH.

5 min de lecturaNeoServer

Una compilación remota termina mientras revisas otro servidor. Un agente de programación se detiene a esperar aprobación en un terminal distinto. NeoServer ahora admite las notificaciones de estado de programas OSC 7501 en iOS y macOS, de modo que una tarea puede avisarte cuando termina, falla o necesita aprobación sin que compruebes su terminal una y otra vez.

Toca una notificación para volver a la sesión de terminal existente. En macOS, NeoServer también puede localizar el panel dividido de la sesión.

¿Qué es OSC 7501?

OSC 7501 es una secuencia de escape de terminal que un programa en ejecución usa para informar de su estado. Puede describir trabajo en curso, una tarea completada, un fallo o una pausa que requiere la intervención del usuario. El programa envía información de estado estructurada a través de la salida del terminal; el terminal decide cómo presentarla. Consulta la especificación del Program Status Protocol para conocer el formato del protocolo.

El programa en ejecución debe emitir informes OSC 7501. Activar las notificaciones no hace que todos los comandos del shell informen de su estado. Una herramienta de línea de comandos compatible puede enviar informes por sí misma, y tus propios scripts pueden enviarlos con printf.

¿Qué estados generan una notificación?

NeoServer aplica estas reglas tanto en iOS como en macOS:

InformeNotificación del sistema
state=doneTarea completada
state=errorTarea fallida
state=blocked:kind=permissionSe requiere aprobación
state=idle o state=workingSin notificación
state=blocked:kind=question o kind=authSin notificación

NeoServer suprime las notificaciones de un terminal que ya estás viendo mientras la app está activa. Los informes de otras sesiones sí pueden avisarte. Cuando la app no está activa, las notificaciones pueden aparecer siempre que NeoServer siga recibiendo salida del terminal.

Las actualizaciones repetidas de mensajes o de progreso no generan alertas repetidas. NeoServer combina los cambios rápidos, separa las notificaciones de una misma sesión al menos cinco segundos entre sí y sustituye la notificación anterior de esa sesión por la más reciente.

Activa las notificaciones de estado de programas

  1. Abre los ajustes de NeoServer y busca Terminal Settings.
  2. Busca Program Status Notifications al final de la página de ajustes del terminal. Viene activada de forma predeterminada en iOS y macOS.
  3. Ejecuta un programa que envíe informes OSC 7501. NeoServer solicita el permiso de notificaciones del sistema después de recibir su primer informe de estado no vacío, no cuando abres un terminal o activas el ajuste.
  4. Permite las notificaciones en el diálogo de permisos del sistema. Si el permiso se denegó anteriormente, activa las notificaciones para NeoServer en los ajustes de notificaciones del sistema operativo.

Para una primera prueba, quédate en el terminal hasta haber respondido al diálogo de permisos. Después ejecuta el ejemplo con retardo de más abajo y cámbiate a otro terminal en NeoServer.

Prueba una notificación de finalización por SSH

Conéctate a un servidor mediante un terminal SSH normal y pega:

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

Durante el retardo de diez segundos, cámbiate a una sesión de terminal distinta en NeoServer. Mantener NeoServer abierto convierte esto en una prueba sencilla del flujo de notificaciones de estado. Una notificación de finalización debería llegar después de procesarse el informe final, siempre según los ajustes de notificaciones del sistema.

Para probar notificaciones de fallo o de aprobación, ejecuta cualquiera de los ejemplos y cámbiate a otra sesión durante el retardo:

# 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

El retardo final del ejemplo de aprobación mantiene el informe de bloqueo activo antes de que el shell vuelva a su símbolo del sistema. Deja tiempo a que llegue la notificación antes de regresar al terminal de origen. Borrar o sustituir un informe de inmediato puede cancelar una alerta pendiente.

Estos comandos solo informan de un estado. El ejemplo de aprobación no ejecuta ninguna operación ni concede permisos. Al tocar su notificación se abre el terminal, donde puedes revisar la solicitud del programa real.

Añade informes de estado a tus propios scripts

Envuelve un comando para que su resultado de salida se convierta en un informe explícito de finalización o de fallo:

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

Ejecuta el script en el terminal conectado para que NeoServer reciba su salida. Este ejemplo conserva el código de salida del comando. Para un texto de notificación personalizado, los campos title y msg del protocolo aceptan texto UTF-8 de una sola línea codificado en Base64; app es un identificador breve del programa.

Comportamiento en segundo plano en iOS y alertas que no llegan

Estas son notificaciones locales del sistema generadas a partir de la salida del terminal recibida. NeoServer debe seguir pudiendo recibir y analizar esa salida. Si iOS suspende o termina la app, no puede generar notificaciones nuevas a partir de cambios de estado remotos. Un trabajo remoto puede seguir ejecutándose sin que una nueva alerta llegue a tu iPhone.

Si una alerta no aparece, comprueba estos puntos:

  • Empieza con SSH directo. Si los ejemplos funcionan allí pero fallan dentro de tmux o screen, comprueba si esa capa reenvía la secuencia OSC a NeoServer.
  • Aléjate del terminal de origen. Un terminal activo y visible permanece en silencio de forma intencionada.
  • Comprueba tanto el permiso como el interruptor de la app. Los ajustes de notificaciones del sistema y del modo Concentración pueden afectar a que aparezca el banner.
  • Mantén el informe activo el tiempo suficiente. Borrar rápidamente un informe o cambiar su estado puede cancelar o sustituir la notificación pendiente.
  • Comprueba el estado informado. Una pausa de pregunta o de autenticación no activa la notificación de aprobación; esta requiere blocked con kind=permission.

Al tocar una notificación se selecciona una sesión existente. Si esa sesión ya se ha cerrado, NeoServer te lo indica; no se reconecta ni ejecuta comandos automáticamente. Si la app está bloqueada, la navegación espera hasta que la desbloquees.

Para configurar la conexión, lee la guía de inicio rápido de NeoServer. Para el resto de preferencias del terminal, consulta Terminal Settings.

NeoServer

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

App Store

¿Listo para probarlo?

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

Gratis en el App Store