安装细节(技术)
普通使用不需要看这一页。想看安装位置、后台服务怎么运行、数据存在哪,再往下读。
与命令行版共用同一个后台服务
桌面端与命令行安装共用同一个开机自启的节点服务(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
