> ## 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 Android 应用

Zeus Android 将 AI Agent 能力带到你的 Android 手机和平板上，基于 React Native 和 Expo 构建。

## 概述

Android 应用提供原生移动端体验，包含四个主要标签页：

| 标签页     | 说明                |
| ------- | ----------------- |
| **会话**  | 查看和管理 AI 对话会话     |
| **技能**  | 浏览和激活可用的 Agent 技能 |
| **自动化** | 管理定时任务和自动化工作流     |
| **我的**  | 账号设置、偏好和个人资料      |

## 技术栈

| 层级       | 技术                                      |
| -------- | --------------------------------------- |
| **框架**   | React Native + Expo Router (\~52.0)     |
| **样式**   | NativeWind（React Native 版 Tailwind CSS） |
| **状态管理** | Zustand                                 |
| **认证存储** | Expo SecureStore                        |
| **流式传输** | SSE（Server-Sent Events）实时聊天             |

## 架构

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

## 功能特性

### 聊天

* SSE 实时流式传输 Agent 响应
* 基于会话的对话历史
* 工具调用结果结构化展示

### 认证

* 基于 Web 的登录流程
* 通过 SecureStore 实现 Refresh Token 机制
* 过期前自动刷新 Token

### 技能

* 浏览可用的 Agent 技能
* 查看技能详情和描述

### 自动化

* 查看定时任务
* 监控任务执行状态
* 创建和管理自动化 Agent 工作流

## 目录结构

```
apps/android/
├── app/
│   ├── _layout.tsx               # 根布局（含认证守卫）
│   ├── index.tsx                  # 入口重定向
│   ├── (auth)/login.tsx           # 登录页
│   ├── (tabs)/                    # 主标签页导航
│   │   ├── index.tsx              # 会话标签页
│   │   ├── skills.tsx             # 技能标签页
│   │   ├── automation.tsx         # 自动化标签页
│   │   └── me.tsx                 # 个人资料标签页
│   └── chat/[sessionId].tsx       # 聊天详情页
├── src/
│   ├── app/api/                   # API 客户端
│   │   ├── agent.ts               # Agent SSE 流式传输
│   │   ├── auth.ts                # 认证
│   │   ├── client.ts              # HTTP 客户端（含 Token 自动刷新）
│   │   ├── sessions.ts            # 会话管理
│   │   ├── skills.ts              # 技能 API
│   │   └── scheduled-tasks.ts     # 定时任务 API
│   ├── components/                # UI 组件
│   ├── store/                     # Zustand 状态管理
│   ├── lib/                       # 工具函数
│   └── types/                     # TypeScript 类型定义
```

## 系统要求

* Android 10（API level 29）或更高版本
* ARM64 或 x86\_64 架构

## 安装

Android 应用通过 APK 或内部测试渠道分发。可从 [下载页面](https://zeus.agentspro.cn/zh/downloads) 获取最新版本。
