上級者向け
通常のユーザーはデスクトップアプリを
パソコンで AI にファイル、表、画像を処理させたいだけなら、ダウンロードページ からデスクトップアプリをインストールしてください。 このページはコマンドライン、スクリプト、サーバーデプロイの方法で、ターミナルが使える必要があります。間違えてインストールすると開けません。
このページは開発者、運用担当者、上級者向けです。3 つの方法から 1 つ選べばよく、機能はデスクトップ版と同じです。
1. コマンドライン版（単体ファイル）
単体の実行ファイルで、ランタイムを内蔵しているため対象マシンに 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 / Kylin V10 など）は、下のインストールスクリプトを使ってください。 glibc 2.17 互換ビルドを自動で選択します。
2. 1 行インストールスクリプト（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 を外す）。詳しくはインストールをご覧ください。
3. スクリプトと 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