专业用法
普通用户请用桌面应用
如果你只是想在电脑上用 AI 处理文件、表格、图片，请到 下载页 装桌面应用。 本页是命令行、脚本与服务器部署方式，需要会用终端，装错了也打不开。
本页提供给开发者、运维与进阶用户。三种方式任选其一即可，功能与桌面版一致。
一、命令行版本（单文件）
单文件可执行程序，自带运行时，目标机器不需要安装 Node。
当前稳定版本：v0.3.25 · 构建时间：2026-11-08 13:06:55（UTC）
未能识别你的系统。 请从下面选择对应平台的安装包。
不确定选哪个？第一个通常就对了。
各平台说明
Windows — 需要 Windows 10 / Server 2016 或更高版本。 Windows 7、8、8.1 与 Server 2008 R2 / 2012 无法运行标准版，装 C++ 运行库也不能解决 （详见 Windows 支持版本）。这类老系统请改用 老系统版（Windows Server 2012）。
产物未做 Authenticode 签名，首次运行可能出现 SmartScreen 提示，选「更多信息 → 仍要运行」。 双击 exe 即可运行；想直接敲 zqagent，把它重命名为 zqagent.exe 并加入 PATH。
macOS — 产物是不带扩展名的可执行文件，首次运行需要解除隔离：
chmod +x zqagent-macos-arm64
xattr -d com.apple.quarantine zqagent-macos-arm64想双击安装、不想碰终端？请改用桌面应用的
.dmg。
Linux — glibc 低于 2.28 的老系统（CentOS 7 / 麒麟 V10 等）请用下面的安装脚本， 它会自动选择 glibc 2.17 兼容构建。
二、一行安装脚本（Linux / macOS）
自动下载、校验、安装，并注册为开机自启服务：
curl -fsSL https://agent.cd-zq.com/install.sh | sh需要自定义端口、数据目录或显式指定验签公钥时，先下载脚本再执行：
curl -fsSLO https://agent.cd-zq.com/install.sh
# Linux：sudo 装成系统服务；数据默认在运行用户的家目录（~/.zqagent_data）
sudo sh install.sh --port 8787
# 需要放到别处时显式指定（日志会自动跟随）
sudo sh install.sh --port 8787 --data-dir /srv/zqagent
# macOS：默认写入当前用户目录（~/Library/Application Support/zqagent），不需要 sudo
sh install.sh --port 8787装好后用 sudo sh -s -- status|logs|restart|rollback|uninstall 管理服务 （macOS 以普通用户安装时去掉 sudo）。详见安装。
三、脚本与 API 集成
| 用途 | 入口 |
|---|---|
| npm 安装 | npm i -g @zqagent/core |
| 嵌入为库 | 架构说明 |
| 多租户节点服务 | REST API |
| 线协议 | wire-protocol |
| MCP 外部工具 | MCP |
| 21 个内置工具 | 内置工具 |
| CLI 命令与审批细节 | CLI 使用指南 |
历史版本
正在加载历史版本…
校验下载
每个版本的 SHA-256 与大小都记录在版本清单里，可用它核对下载到的文件：
# 当前版本的清单（JSON）
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.json
# 纯文本形式（平台 版本 URL SHA-256 大小）
curl -s https://agent.cd-zq.com/downloads/zqagent/stable.txt
# 核对已下载文件
sha256sum zqagent-linux-x64