> ## 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 application documentation

Zeus Desktop is a native desktop application that provides a smoother AI interaction experience with local feature integration.

## Overview

The Desktop application is built on Electron and supports macOS, Windows, and Linux platforms.

### Advantages

| Feature                  | Description                                         |
| ------------------------ | --------------------------------------------------- |
| **Native Experience**    | System-level integration with smoother interactions |
| **Local File Access**    | Direct read/write access to the local file system   |
| **System Notifications** | Native notification alerts                          |
| **Keyboard Shortcuts**   | Global keyboard shortcut support                    |
| **Offline Features**     | Some features work offline                          |

## System Requirements

| Platform    | Minimum Requirements       |
| ----------- | -------------------------- |
| **macOS**   | 10.15 (Catalina) or higher |
| **Windows** | Windows 10 or higher       |
| **Linux**   | Ubuntu 18.04 or equivalent |

## Installation

### macOS

1. Download the `.dmg` installer
2. Open the DMG file
3. Drag Zeus into the Applications folder
4. On first launch, right-click and select "Open" to bypass Gatekeeper

### Windows

1. Download the `.exe` installer
2. Run the installer
3. Follow the wizard to complete installation
4. Launch Zeus from the Start menu

### Linux

* **Debian/Ubuntu**: Install with `sudo dpkg -i zeus_x.x.x_amd64.deb`
* **Generic**: Download the AppImage, add execute permissions, and run directly

## Architecture

```mermaid theme={null}
flowchart TD
    subgraph ZeusDesktop["Zeus Desktop"]
        A["Electron Main\n- System integration\n- IPC communication\n- File system access\n- Auto-update"]
        B["Electron Renderer\n- React UI\n- Shared components with Web\n- WebSocket communication"]
        A --> B
    end
    B --> C["Zeus Backend\n- Cloud or local deployment\n- WebSocket real-time communication"]
```

## Connection Configuration

The Desktop application needs to connect to a Zeus backend service.

### Cloud Mode

Connect to a hosted Zeus service:

1. Open Settings
2. Enter the server URL (e.g., `https://zeus.your-domain.com`)
3. Log in with your account
4. Start using

### Local Mode

Connect to a locally running Zeus service:

1. Ensure the local backend is running
2. Set the server URL to `http://localhost:3000`
3. Log in or use a local account

## Features

### Local File Access

The Desktop application can directly access the local file system, including reading files, writing files, and listing directory contents.

### System Integration

* **Clipboard** - Read and write the system clipboard
* **Notifications** - Native system notifications
* **Tray Icon** - Quick access from the system tray
* **File Association** - File type association support

### Keyboard Shortcuts

| Shortcut       | Function         |
| -------------- | ---------------- |
| `Cmd/Ctrl + N` | New conversation |
| `Cmd/Ctrl + K` | Command palette  |
| `Cmd/Ctrl + ,` | Settings         |
| `Cmd/Ctrl + Q` | Quit application |

### Offline Features

Some features remain available without a network connection:

* View conversation history (local cache)
* File preview
* Settings modification

## Device Authentication

The Desktop application uses a device authentication mechanism:

```mermaid theme={null}
flowchart TD
    A["First Launch"] -->|"Generate device ID"| B["Scan QR code or enter code to log in"]
    B --> C["Server verifies and binds device"]
    C --> D["Automatic login on subsequent launches"]
```

### Device Management

You can manage authorized devices from the Web platform:

1. Go to Settings → Device Management
2. View all connected devices
3. Revoke authorization for unwanted devices

## Differences from Web

| Feature                   | Web                | Desktop             |
| ------------------------- | ------------------ | ------------------- |
| Local file access         | Limited            | Full                |
| System notifications      | Browser permission | Native support      |
| Global keyboard shortcuts | Not supported      | Supported           |
| Offline usage             | Not supported      | Partially supported |
| Auto-update               | N/A                | Supported           |

## Troubleshooting

### Application Won't Start

1. Check system requirements
2. Delete the configuration directory and retry (macOS: `~/Library/Application Support/Zeus`, Windows: `%APPDATA%\Zeus`)

### Cannot Connect to Backend

1. Check network connectivity
2. Verify the server URL is correct
3. Check firewall settings
4. Try logging in again

### File Access Permissions

macOS users may need to grant file access permissions:

1. Open System Preferences → Security & Privacy → Privacy
2. Allow Zeus access under "Files and Folders"