Uso avanzado

Los usuarios normales deben usar la app de escritorio

Si solo quieres usar la IA en tu ordenador para archivos, hojas de cálculo e imágenes, instala la app de escritorio desde la página de descargas. Esta página trata de línea de comandos, scripts y despliegue en servidor: requiere saber usar una terminal, y si instalas lo incorrecto no se abrirá.

Esta página es para desarrolladores, operaciones y usuarios avanzados. Basta con elegir una de las tres vías; las funciones son las mismas que en la versión de escritorio.

1. Versión de línea de comandos (archivo único)

Ejecutable único con runtime integrado: la máquina de destino no necesita Node.

Versión estable actual: v0.3.25　·　Fecha de compilación: 2026-11-08 13:06:55 (UTC)

未能识别你的系统。 请从下面选择对应平台的安装包。

Windows64 位macOSApple 芯片macOSIntel 芯片Linuxx64LinuxARM64

不确定选哪个？第一个通常就对了。

查看支持的系统版本

Notas por plataforma

Windows — requiere Windows 10 / Server 2016 o superior. Windows 7, 8, 8.1 y Server 2008 R2 / 2012 no pueden ejecutarlo; instalar el runtime de C++ no lo resuelve. Consulta Versiones compatibles de Windows.

El artefacto no tiene firma Authenticode, así que la primera ejecución puede mostrar SmartScreen; elige «Más información → Ejecutar de todas formas». Haz doble clic en el exe para ejecutarlo; si quieres escribir zqagent directamente, renómbralo a zqagent.exe y añádelo al PATH.

macOS — el artefacto es un ejecutable sin extensión; la primera ejecución requiere quitar la cuarentena:

chmod +x zqagent-macos-arm64
xattr -d com.apple.quarantine zqagent-macos-arm64

Si prefieres instalar con doble clic sin tocar la terminal, usa el .dmg de la app de escritorio.

Linux — en sistemas antiguos con glibc inferior a 2.28 (CentOS 7 / Kylin V10, etc.) usa el script de instalación de abajo; elige automáticamente la compilación compatible con glibc 2.17.

2. Script de instalación en una línea (Linux / macOS)

Descarga, verifica e instala automáticamente, y registra el servicio de inicio automático:

curl -fsSL https://agent.cd-zq.com/install.sh | sh

Si necesitas un puerto o directorio de datos concreto, o indicar explícitamente la clave pública de verificación, descarga primero el script:

curl -fsSLO https://agent.cd-zq.com/install.sh

# Linux: sudo lo instala como servicio del sistema; los datos van por defecto al home del usuario que ejecuta (~/.zqagent_data)
sudo sh install.sh --port 8787
# Para otra ubicación, indícalo explícitamente (los registros la siguen)
sudo sh install.sh --port 8787 --data-dir /srv/zqagent

# macOS: por defecto escribe en el directorio del usuario actual (~/Library/Application Support/zqagent), sin sudo
sh install.sh --port 8787

Tras instalar, gestiona el servicio con sudo sh -s -- status|logs|restart|rollback|uninstall (en macOS instalado como usuario normal, quita sudo). Consulta Instalación.

3. Scripts e integración por API

Uso	Entrada
Instalación por npm	npm i -g @zqagent/core
Embebido como biblioteca	Descripción de arquitectura
Servicio de nodo multiinquilino	REST API
Protocolo de cable	wire-protocol
Herramientas externas MCP	MCP
21 herramientas integradas	Herramientas integradas
Comandos CLI y detalles de aprobación	Guía de uso de la CLI

Versiones anteriores

正在加载历史版本…

Verificar la descarga

El SHA-256 y el tamaño de cada versión se registran en el manifiesto, que puedes usar para comprobar el archivo descargado:

# Manifiesto de la versión actual (JSON)
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.json

# Formato de texto plano (plataforma versión URL SHA-256 tamaño)
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.txt

# Comprobar el archivo descargado
sha256sum zqagent-linux-x64