> ## 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.

# 概览

> Zeus iOS 应用

Zeus iOS 将 AI Agent 能力带到你的 iPhone 和 iPad 上，使用 SwiftUI 原生构建。

## 概述

iOS 应用提供功能完整的移动端体验，包含五个主要标签页：

| 标签页     | 说明                   |
| ------- | -------------------- |
| **会话**  | 查看和管理 AI 对话会话        |
| **聊天**  | 实时 AI 对话，支持 SSE 流式传输 |
| **技能**  | 浏览可用的 Agent 技能       |
| **自动化** | 管理定时任务和自动化工作流        |
| **我的**  | 账号设置、偏好和个人资料         |

## 技术栈

| 层级       | 技术                                 |
| -------- | ---------------------------------- |
| **框架**   | SwiftUI（iOS 16+）                   |
| **认证**   | 基于 WebView 的登录 + Keychain Token 存储 |
| **流式传输** | SSE（Server-Sent Events）实时 Agent 响应 |
| **状态管理** | ObservableObject + @StateObject 模式 |

## 架构

```mermaid theme={null}
flowchart TD
    A["iOS 应用\nSwiftUI\nKeychain · SSE"]
    B["Zeus Web API\nNext.js API Routes\n认证 · 会话 · 技能"]
    C["AI Backend\nFastAPI\nAgent · SSE 流式传输"]
    A -->|"HTTPS"| B
    A -->|"SSE Stream"| C
```

## 功能特性

### 认证

* 通过 WKWebView 的 Web 登录流程（邮箱密码、OAuth）
* 通过 iOS Keychain 管理 Token（安全存储）
* 双 Token 机制：accessToken（1 小时）+ refreshToken（30 天）
* 过期前自动刷新 Token
* 导航拦截实现 WebView 到原生的无缝认证切换

### 会话

* 查看对话历史（会话列表）
* 创建新会话
* 恢复之前的对话
* 与 Web 和桌面端跨平台会话同步

### 聊天

* SSE 实时流式传输 Agent 响应
* 工具调用结果结构化展示
* 语音输入支持

### 技能

* 浏览所有可用的 Agent 技能
* 查看技能详情、描述和标签

### 自动化

* 查看和管理定时任务
* 监控任务执行状态和历史
* 任务完成后推送通知

### 设置

* 账号管理（资料、邮箱）
* 服务器配置
* 法律页面（服务条款、隐私政策）

## 目录结构

```
apps/ios/src/
├── app/
│   ├── api/                      # API 客户端
│   │   ├── MainAPI.swift          # API 基础设施
│   │   ├── AuthAPI.swift          # 认证
│   │   ├── AgentAPI.swift         # Agent SSE 流式传输
│   │   ├── SandboxAPI.swift       # 沙盒管理
│   │   ├── SessionAPI.swift       # 会话管理
│   │   ├── ScheduledTaskAPI.swift # 定时任务
│   │   └── SkillAPI.swift         # 技能
│   └── pages/                    # 页面视图
│       ├── MainView.swift         # 入口 + Tab 导航
│       ├── AuthView.swift         # 登录（WebView）
│       ├── SessionView.swift      # 会话列表
│       ├── ChatView.swift         # 聊天对话
│       ├── AutomationView.swift   # 定时任务
│       ├── SkillsView.swift       # 技能列表
│       └── MeView.swift           # 个人资料与设置
├── components/                   # 可复用 SwiftUI 组件
├── db/
│   ├── schema/                   # 数据结构（映射后端 API）
│   └── model/                    # CRUD 操作（Keychain）
├── i18n/                         # 国际化
│   └── Localizable.xcstrings     # 本地化字符串
├── lib/
│   ├── message-handler/          # SSE 消息处理
│   │   ├── MessageHandler.swift
│   │   ├── MessageHandler+Text.swift
│   │   ├── MessageHandler+ToolCall.swift
│   │   └── MessageHandler+ToolResult.swift
│   └── types/                    # 本地类型与枚举
│       ├── AuthTypes.swift
│       ├── ChatTypes.swift
│       └── ToolIconTypes.swift
└── store/                        # 状态管理
    ├── WorkspaceState.swift
    └── SpeechRecorder.swift
```

## 系统要求

* iOS 16.0 或更高版本
* iPhone 或 iPad