> For the complete documentation index, see [llms.txt](https://puregamma-ai.gitbook.io/puregamma-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://puregamma-ai.gitbook.io/puregamma-ai/yi-dong-ying-yong.md).

# 移动应用

## Android

### 安装

当前通过 APK 侧载分发(未上应用商店):

1. 下载最新 APK(如 `PureGamma-AI-1.4.0-release.apk`)。
2. 允许「安装未知来源应用」后安装;debug 证书版本可直接覆盖旧版升级。
3. 应用默认连接生产环境 `https://api.puregamma.ai`,无需配置。

### 登录

* **Google 登录**:跳转系统浏览器完成 OAuth,自动返回应用(推荐)。
* **邮箱登录/注册**:输入邮箱密码;新用户注册后自动登录。
* 连续失败会触发限流(登录 5 次 / 注册 3 次每 15 分钟),应用会显示中文/英文友好提示;稍等再试。

### 特点

* 登录后打开完整 Web 产品(计费、技能、组合、秘书语音与网页版一致)。
* 秘书语音:首次使用会请求麦克风权限,授权后网页语音功能全可用;应用内自动播放不受浏览器策略限制。
* 外部支付/券商授权跳转系统浏览器;会话 Cookie 为 HttpOnly,不注入脚本。

## iOS

### 安装

通过 Xcode 部署(开发期)或 TestFlight(后续)。需要 iOS 17+。

### 登录

* **Sign in with Apple**(推荐)与 **Google 登录**,均走系统安全会话。
* 令牌存于 Keychain;401 自动清除本地会话并回到登录页。

### 特点

* 原生 SwiftUI 五 Tab:Today / Agent / Research / Portfolio / Account。
* 支持 APNs 推送(授权后自动注册设备,日报可推送到通知中心)。
* 行情/报告/组合离线有只读缓存,并明确标注保存时间,不会冒充实时数据。

## 常见问题

* **登录显示 "Not found"**:说明后端版本过旧,已修复;请将服务端升级到最新版本并重试。
* **提示 "Too many attempts"**:触发限流,15 分钟后再试。
* **Android 无法拉起 Google 登录**:需安装或启用 Chrome 浏览器。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://puregamma-ai.gitbook.io/puregamma-ai/yi-dong-ying-yong.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.