Acceso remoto
Usa tu zqagent en remoto desde el móvil u otros dispositivos: la tarea se ejecuta en el nodo y el progreso, las solicitudes de aprobación y los resultados vuelven en tiempo real.
Un enlace, dos identidades
El acceso remoto usa pasarela Rust + WSS binario:
móvil / navegador ──wss──▶ pasarela Rust ◀──wss── nodo (máquina que ejecuta las tareas)
▲
emite credenciales (HTTPS)
│
plano de control del Hub- Nodo: posee una clave de firma (
FLEET_SECRET) y, al conectar, demuestra su identidad a la pasarela con ella. - Terminal (móvil / navegador): no toca la clave del nodo. Inicia sesión en el Hub con la cuenta, la cambia por un token de corta duración que solo autoriza el nodo indicado y lo usa para conectar a la pasarela. Cuando caduca, basta con pedir otro sin volver a iniciar sesión.
Ventaja: el móvil no guarda a largo plazo una clave capaz de controlar el nodo, y si el token se pierde solo afecta al nodo autorizado.
Uso en el móvil
- Completa la conexión en la máquina del nodo (ver «Conexión a la nube» en Configuración del servidor) y activa el acceso remoto en los ajustes del nodo.
- Abre el centro de usuario (dirección del Hub) en el navegador del móvil e inicia sesión con la misma cuenta.
- En la página «Nodos» verás los nodos conectados; haz clic para entrar en la consola.
La app nativa reutiliza actualmente las mismas páginas de consola. Si desarrollas un cliente propio, el contrato del protocolo está en
docs/wire-protocol.mddel repositorio (formato de tramas, envoltura, definición de mensajes y algoritmo de firma).
Qué puedes hacer
| Operación | Descripción |
|---|---|
| Enviar tareas | Envía un mensaje y el nodo empieza a ejecutar |
| Información adicional | Añade indicaciones durante la ejecución y se inyectan en la tarea actual |
| Aprobar | Ante operaciones que requieren autorización: aceptar / aceptar todo / rechazar |
| Responder preguntas | Responde a las preguntas de la IA o a la confirmación de planes |
| Interrumpir tareas | Detén la tarea actual en cualquier momento |
| Gestión de conversaciones | Crear, cambiar y ver la lista de conversaciones |
| Explorar archivos | Ver el directorio del proyecto y el contenido de los archivos |
Notificaciones y progreso
- Los hitos clave de la tarea (requiere aprobación, requiere respuesta, completada, error) se envían a tu cuenta y se ven en cualquier dispositivo.
- El progreso (qué herramienta se está llamando, qué se ha emitido) se envía en tiempo real.
- Varios dispositivos de la misma cuenta reciben la notificación a la vez.
Disponibilidad
- El nodo solo necesita una conexión saliente a la pasarela (
wss://, normalmente 443); no requiere entrada pública ni abrir puertos. - Si la pasarela no es accesible, el nodo reconecta con retroceso exponencial y las funciones locales no se ven afectadas en absoluto.
