概述
Desktop 应用基于 Electron 构建，支持 macOS、Windows 和 Linux 平台。优势
| 特性 | 描述 |
|---|---|
| 原生体验 | 系统级集成，更流畅的交互 |
| 本地文件访问 | 直接读写本地文件系统 |
| 系统通知 | 原生通知提醒 |
| 快捷键 | 全局快捷键支持 |
| 离线功能 | 部分功能可离线使用 |
系统要求
| 平台 | 最低要求 |
|---|---|
| macOS | 10.15 (Catalina) 或更高 |
| Windows | Windows 10 或更高 |
| Linux | Ubuntu 18.04 或同等 |
安装
macOS
- 下载
.dmg安装包 - 打开 DMG 文件
- 将 Zeus 拖入 Applications 文件夹
- 首次打开时，右键选择”打开”以绕过 Gatekeeper
Windows
- 下载
.exe安装程序 - 运行安装程序
- 按照向导完成安装
- 从开始菜单启动 Zeus
Linux
- Debian/Ubuntu: 使用
sudo dpkg -i zeus_x.x.x_amd64.deb安装 - 通用: 下载 AppImage，添加执行权限后直接运行
架构
连接配置
Desktop 应用需要连接到 Zeus 后端服务。云端模式
连接到托管的 Zeus 服务：- 打开设置
- 输入服务器 URL（如
https://zeus.your-domain.com） - 使用账号登录
- 开始使用
本地模式
连接到本地运行的 Zeus 服务：- 确保本地后端已启动
- 设置服务器 URL 为
http://localhost:3000 - 登录或使用本地账号
功能特性
本地文件访问
Desktop 应用可以直接访问本地文件系统，包括读取文件、写入文件和列出目录内容。系统集成
- 剪贴板 - 读写系统剪贴板
- 通知 - 原生系统通知
- 托盘图标 - 系统托盘快速访问
- 文件关联 - 支持文件类型关联
快捷键
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl + N | 新建对话 |
Cmd/Ctrl + K | 命令面板 |
Cmd/Ctrl + , | 设置 |
Cmd/Ctrl + Q | 退出应用 |
离线功能
部分功能在无网络时仍可使用：- 查看历史对话（本地缓存）
- 文件预览
- 设置修改
设备认证
Desktop 应用使用设备认证机制：设备管理
在 Web 端可以管理已授权的设备：- 进入设置 → 设备管理
- 查看所有已连接设备
- 撤销不需要的设备授权
与 Web 的区别
| 功能 | Web | Desktop |
|---|---|---|
| 本地文件访问 | 受限 | 完整 |
| 系统通知 | 浏览器权限 | 原生支持 |
| 全局快捷键 | 不支持 | 支持 |
| 离线使用 | 不支持 | 部分支持 |
| 自动更新 | N/A | 支持 |
故障排除
应用无法启动
- 检查系统要求
- 删除配置目录重试（macOS:
~/Library/Application Support/Zeus，Windows:%APPDATA%\Zeus）
无法连接后端
- 检查网络连接
- 验证服务器 URL 正确
- 检查防火墙设置
- 尝试重新登录
文件访问权限
macOS 用户可能需要授予文件访问权限：- 打开系统偏好设置 → 安全性与隐私 → 隐私
- 在”文件和文件夹”中允许 Zeus 访问