安裝細節（技術）
一般使用不需要看這一頁。想看安裝位置、背景服務怎麼運作、資料存在哪，再往下讀。
與命令列版共用同一個背景服務
桌面端與命令列安裝共用同一個開機自啟的節點服務（macOS launchd com.zqagent.node、 Linux systemd zqagent、Windows 登入工作），因此一台機器永遠只有一個節點：已經用 install.sh 裝過時桌面端直接沿用，不會再起第二個。
首次啟動做了什麼
首次啟動會把內建引擎安裝成開機自啟的節點服務並連上它，無需手動填寫位址或金鑰。 若本機已用 install.sh 裝過節點，桌面端直接沿用那個服務。
關閉與結束
- 關閉視窗 = 隱藏到系統匣，任務繼續執行；從系統匣選單「開啟志前AI助手」恢復視窗。
- 結束：系統匣選單「結束」只關閉桌面外殼，節點服務仍在背景執行（由 launchd / systemd / 登入工作保活）。
- 單一實例：重複開啟應用程式只會喚起既有視窗，不會啟動第二個節點。
資料位置
節點資料（租戶、工作階段、模型設定、admin.json）保存在系統服務的資料目錄：
| 平台 | 資料目錄 |
|---|---|
| macOS | ~/Library/Application Support/zqagent/ |
| Linux | ~/.zqagent_data/（歸執行使用者所有；早期版本為 /var/lib/zqagent/） |
| Windows | %APPDATA%\zqagent\ |
與 install.sh 安裝的節點共用同一目錄，兩種安裝方式可以無縫切換，工作階段可隨時恢復。
桌面偏好（工作區、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