專業用法
普通使用者請用桌面應用
如果你只是想在電腦上用 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 支援版本。
產物未做 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