インストールの詳細（技術）

通常の利用では不要です。インストール先、バックグラウンドサービスの動き、データの保存場所を 知りたいときにお読みください。

コマンドライン版と同じバックグラウンドサービスを共有

デスクトップ版とコマンドラインでのインストールは同じ自動起動のノードサービスを共有します （macOS launchd com.zqagent.node、Linux systemd zqagent、Windows ログオンタスク）。 そのため 1 台のマシンにノードは常に 1 つだけです。すでに install.sh で入れている場合は デスクトップ版がそれを再利用し、2 つ目を起動しません。

初回起動で行われること

初回起動時に、同梱のエンジンを自動起動のノードサービスとしてインストールし、それに接続します。 アドレスやキーを手入力する必要はありません。すでに install.sh でノードを入れている場合は、 デスクトップ版はそのサービスを再利用します。

閉じるときと終了するとき

• ウィンドウを閉じる = トレイに隠す。タスクは動き続けます。トレイメニューの「ZQAgent を開く」で戻せます。
• 終了：トレイメニューの「終了」はデスクトップのシェルを閉じるだけで、ノードサービスは バックグラウンドで動き続けます（launchd / systemd / ログオンタスクが維持）。
• 単一インスタンス：もう一度アプリを起動しても既存のウィンドウが前面に出るだけで、 2 つ目のノードは起動しません。

データの場所

ノードのデータ（テナント、セッション、モデル設定、admin.json）はシステムサービスの データディレクトリに保存されます：

プラットフォーム	データディレクトリ
macOS	~/Library/Application Support/zqagent/
Linux	~/.zqagent_data/（実行ユーザー所有。初期バージョンは /var/lib/zqagent/）
Windows	%APPDATA%\zqagent\

install.sh で入れたノードと同じディレクトリを共有するため、2 つのインストール方法を 行き来してもセッションはいつでも復元できます。

デスクトップの設定（ワークスペース、keep-awake）は別途 ~/.config/zqagent-desktop/desktop.json に保存されます。

モデルの変更

設定を開き、モデル名、Base URL、API Key を入力して保存します。新しいセッションから反映されます。

システム要件

• Windows 10 / 11（64 ビット。Windows 7、8、8.1 は動作しません）
• macOS 11 以降（Apple シリコンと Intel で同じパッケージ）
• Linux：Ubuntu / Debian は deb、CentOS / Fedora は rpm

よくあるトラブル

• macOS でアプリを開けないと言われる？ 右クリック → 開く、または「システム設定 → プライバシーとセキュリティ」で許可。
• Windows の SmartScreen で止められる？「詳細情報」→「実行」。
• コマンドライン版を使いたい？ プロ向けの使い方を参照。
• その他のインストール・接続の問題？ 技術的な質問（上級）を参照。