跳转到主要内容
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 模式

架构

功能特性

认证

  • 通过 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