Detalles de instalación (técnico)
No hace falta para el uso normal. Lee esto si te interesa la ubicación de instalación, cómo funciona el servicio en segundo plano o dónde se guardan los datos.
Comparte el servicio en segundo plano con la CLI
La app de escritorio y la instalación por línea de comandos comparten un único servicio de nodo de arranque automático (macOS launchd com.zqagent.node, Linux systemd zqagent, tarea de inicio de sesión en Windows). Por eso un equipo solo tiene siempre un nodo: si ya instalaste con install.sh, la app lo reutiliza en lugar de arrancar un segundo.
Qué hace el primer arranque
El primer arranque instala el motor incluido como servicio de nodo de arranque automático y se conecta a él: no hay que introducir dirección ni clave. Si ya había un nodo instalado con install.sh, la app reutiliza ese servicio.
Cerrar y salir
- Cerrar la ventana = ocultar en la bandeja; las tareas siguen. Usa "Abrir ZQAgent" en el menú de la bandeja para recuperarla.
- Salir: "Salir" en la bandeja solo cierra la interfaz de escritorio. El servicio de nodo sigue en segundo plano (mantenido por launchd / systemd / la tarea de inicio de sesión).
- Instancia única: abrir la app otra vez solo trae al frente la ventana existente; nunca arranca un segundo nodo.
Dónde viven los datos
Los datos del nodo (inquilinos, sesiones, configuración de modelos, admin.json) se guardan en el directorio de datos del servicio del sistema:
| Plataforma | Directorio de datos |
|---|---|
| macOS | ~/Library/Application Support/zqagent/ |
| Linux | ~/.zqagent_data/ (propiedad del usuario que ejecuta; en versiones antiguas /var/lib/zqagent/) |
| Windows | %APPDATA%\zqagent\ |
Se comparte con el nodo instalado por install.sh, así que puedes alternar entre los dos métodos de instalación y recuperar las sesiones en cualquier momento.
Las preferencias de escritorio (espacio de trabajo, keep-awake) se guardan aparte en ~/.config/zqagent-desktop/desktop.json.
Cambiar de modelo
Abre Ajustes, rellena el nombre del modelo, la Base URL y la API Key, y guarda. Se aplica a las sesiones nuevas.
Requisitos del sistema
- Windows 10 / 11 (64 bits; Windows 7, 8 y 8.1 no funcionan)
- macOS 11 o superior (Apple silicon e Intel comparten paquete)
- Linux: deb para Ubuntu / Debian, rpm para CentOS / Fedora
Problemas habituales
- macOS dice que no se puede abrir la app. Clic derecho → Abrir, o permite en Ajustes del Sistema → Privacidad y seguridad.
- SmartScreen de Windows lo bloquea. "Más información" → "Ejecutar de todas formas".
- ¿Quieres la versión de línea de comandos? Consulta Uso avanzado.
- Otros problemas de instalación o conexión. Consulta Preguntas técnicas.