> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Zeus Desktop 桌面应用文档

Zeus Desktop 是一个原生桌面应用，提供更流畅的 AI 交互体验和本地功能集成。

## 概述

Desktop 应用基于 Electron 构建，支持 macOS、Windows 和 Linux 平台。

### 优势

| 特性         | 描述           |
| ---------- | ------------ |
| **原生体验**   | 系统级集成，更流畅的交互 |
| **本地文件访问** | 直接读写本地文件系统   |
| **系统通知**   | 原生通知提醒       |
| **快捷键**    | 全局快捷键支持      |
| **离线功能**   | 部分功能可离线使用    |

## 系统要求

| 平台          | 最低要求                 |
| ----------- | -------------------- |
| **macOS**   | 10.15 (Catalina) 或更高 |
| **Windows** | Windows 10 或更高       |
| **Linux**   | Ubuntu 18.04 或同等     |

## 安装

### macOS

1. 下载 `.dmg` 安装包
2. 打开 DMG 文件
3. 将 Zeus 拖入 Applications 文件夹
4. 首次打开时，右键选择"打开"以绕过 Gatekeeper

### Windows

1. 下载 `.exe` 安装程序
2. 运行安装程序
3. 按照向导完成安装
4. 从开始菜单启动 Zeus

### Linux

* **Debian/Ubuntu**: 使用 `sudo dpkg -i zeus_x.x.x_amd64.deb` 安装
* **通用**: 下载 AppImage，添加执行权限后直接运行

## 架构

```mermaid theme={null}
flowchart TD
    subgraph ZeusDesktop["Zeus Desktop"]
        A["Electron Main\n- 系统集成\n- IPC 通信\n- 文件系统访问\n- 自动更新"]
        B["Electron Renderer\n- React UI\n- 与 Web 共享组件\n- WebSocket 通信"]
        A --> B
    end
    B --> C["Zeus Backend\n- 可以是云端或本地部署\n- WebSocket 实时通信"]
```

## 连接配置

Desktop 应用需要连接到 Zeus 后端服务。

### 云端模式

连接到托管的 Zeus 服务：

1. 打开设置
2. 输入服务器 URL（如 `https://zeus.your-domain.com`）
3. 使用账号登录
4. 开始使用

### 本地模式

连接到本地运行的 Zeus 服务：

1. 确保本地后端已启动
2. 设置服务器 URL 为 `http://localhost:3000`
3. 登录或使用本地账号

## 功能特性

### 本地文件访问

Desktop 应用可以直接访问本地文件系统，包括读取文件、写入文件和列出目录内容。

### 系统集成

* **剪贴板** - 读写系统剪贴板
* **通知** - 原生系统通知
* **托盘图标** - 系统托盘快速访问
* **文件关联** - 支持文件类型关联

### 快捷键

| 快捷键            | 功能   |
| -------------- | ---- |
| `Cmd/Ctrl + N` | 新建对话 |
| `Cmd/Ctrl + K` | 命令面板 |
| `Cmd/Ctrl + ,` | 设置   |
| `Cmd/Ctrl + Q` | 退出应用 |

### 离线功能

部分功能在无网络时仍可使用：

* 查看历史对话（本地缓存）
* 文件预览
* 设置修改

## 设备认证

Desktop 应用使用设备认证机制：

```mermaid theme={null}
flowchart TD
    A["首次启动"] -->|"生成设备 ID"| B["扫码或输入代码登录"]
    B --> C["服务器验证并绑定设备"]
    C --> D["后续自动登录"]
```

### 设备管理

在 Web 端可以管理已授权的设备：

1. 进入设置 → 设备管理
2. 查看所有已连接设备
3. 撤销不需要的设备授权

## 与 Web 的区别

| 功能     | Web   | Desktop |
| ------ | ----- | ------- |
| 本地文件访问 | 受限    | 完整      |
| 系统通知   | 浏览器权限 | 原生支持    |
| 全局快捷键  | 不支持   | 支持      |
| 离线使用   | 不支持   | 部分支持    |
| 自动更新   | N/A   | 支持      |

## 故障排除

### 应用无法启动

1. 检查系统要求
2. 删除配置目录重试（macOS: `~/Library/Application Support/Zeus`，Windows: `%APPDATA%\Zeus`）

### 无法连接后端

1. 检查网络连接
2. 验证服务器 URL 正确
3. 检查防火墙设置
4. 尝试重新登录

### 文件访问权限

macOS 用户可能需要授予文件访问权限：

1. 打开系统偏好设置 → 安全性与隐私 → 隐私
2. 在"文件和文件夹"中允许 Zeus 访问