Skip to content

安装细节(技术) ​

普通使用不需要看这一页。想看安装位置、后台服务怎么运行、数据存在哪,再往下读。

与命令行版共用同一个后台服务 ​

桌面端与命令行安装共用同一个开机自启的节点服务(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

常见排查 ​

  • macOS 提示无法打开应用? 右键 → 打开;或在「系统设置 → 隐私与安全性」中允许。
  • Windows 被 SmartScreen 拦截? 点「更多信息」→「仍要运行」。
  • 想用命令行版本? 见专业用法。
  • 其它安装与连接问题? 见技术问题(高级)。