Consola del nodo

La consola del nodo es la interfaz gráfica de zqagent: gestionar nodos, crear proyectos, conversar con la IA, aprobar operaciones y consultar uso y costes, todo desde aquí, sin escribir comandos.

Cómo abrirla

Escenario	Entrada	Notas
Escritorio	App de escritorio	Nodo local integrado, listo para usar
Navegador	Centro de usuario → Gestión de nodos → elegir nodo	Gestionar remotamente nodos conectados
Móvil	Abrir el centro de usuario en el navegador del móvil	Diseño adaptable + PWA; se puede «Añadir a pantalla de inicio»

Para la gestión remota, el nodo debe estar conectado al centro de usuario; consulta Iniciar el nodo.

Nodos y proyectos

• Gestión de nodos: se crea en el centro de usuario; una gestión de nodo admite varios dispositivos. La lista muestra el estado en línea y al hacer clic se entra en la consola del nodo.
• Gestión de proyectos: un proyecto corresponde a un directorio de trabajo del nodo, el ámbito de lectura y escritura de la IA. Al crear uno puedes explorar los directorios del nodo para elegirlo y evitar errores al escribir la ruta.
• Selección de modelo: se puede definir un modelo predeterminado a nivel de nodo y especificar otro por conversación.

La barra superior permite cambiar rápidamente entre nodos y proyectos y abrir el diálogo de gestión de proyectos para mantenerlos todos.

Área de trabajo de conversaciones

• Lista de conversaciones: admite fijar y buscar para localizar conversaciones antiguas.
• Pestañas: abre varias conversaciones a la vez; el estado de las pestañas persiste (sigue tras recargar) y admite menú contextual y plegado.
• Línea de tiempo: muestra la conversación y las llamadas a herramientas en orden cronológico; las conversaciones largas se pueden repasar completas.
• Borrador de entrada: lo no enviado se guarda automáticamente y se restaura al cambiar de conversación o recargar.
• Edición de archivos: el editor integrado admite deshacer/rehacer, resaltado de Markdown y sincronización de desplazamiento.

Aprobaciones y preguntas

Cuando la IA pide una operación con efectos secundarios (escribir archivos, ejecutar comandos, etc.) o necesita información adicional, aparece una tarjeta en la conversación:

• Aprobación con cuatro decisiones: permitir una vez / permitir siempre esta herramienta / permitir siempre este comando / rechazar. «Permitir siempre este comando» solo aparece con run_shell y autoriza por comando concreto, más seguro que autorizar toda la herramienta.
• Preguntas con opciones integradas y entrada libre.

Las tarjetas pendientes se conservan y se pueden atender después. La semántica de aprobación es la misma que en la CLI; consulta Uso de la CLI.

Uso y coste

zqagent registra cada llamada al modelo y la agrega en dos niveles: nodo y cuenta:

• Ver uso: desde la tarjeta de tokens de la página del proyecto o en el detalle del nodo, «Monitorización → Ver uso»; el panel admite filtro por periodo, gráfico de barras por día, estadísticas por modelo y lista de detalle, con exportación a CSV.
• Tabla de precios: incluye precios predeterminados de modelos habituales (OpenAI / DeepSeek / Qwen / Zhipu / Moonshot, etc.), modificables en «Tabla de precios»; el coste se convierte según tu precio.
• Uso a nivel de cuenta: al iniciar sesión en el centro de usuario, la página de cuenta muestra el uso de todos los nodos.

Tiempo real y estabilidad

• Las conversaciones se envían por un flujo de eventos en tiempo real, con reconexión automática y recuperación incremental por cursor: al volver del segundo plano o tras recuperarse la red, el contenido no se pierde ni se duplica.
• El servidor envía latidos periódicos, así que una larga inactividad no se confunde con «inactivo» y no provoca reconexiones constantes.
• Se notifican en tiempo real la conexión/desconexión de nodos y los avisos de tareas (aprobación/pregunta/error).

Móvil

• En pantallas estrechas (≤ 720 px) pasa a una sola columna: se alterna entre «Resumen / Consola» y entre la lista y la conversación.
• Admite «Añadir a pantalla de inicio» y se ejecuta en una ventana independiente.

Siguiente paso

• Iniciar el nodo: instalarlo y conectarlo al centro de usuario
• Descripción del control remoto: encargar tareas desde el móvil y QQ
• Interfaz REST: referencia para integraciones