快速开始¶
本指南将带你完成安装 Agora、添加第一个 API 密钥并发送第一条消息。
安装¶
通过 F-Droid（推荐）¶
Agora 已上架 F-Droid 开源应用商店。
- 在设备上安装 F-Droid
- 打开 F-Droid，搜索 Agora
- 点按 安装
通过 GitHub Releases¶
- 访问 Releases 页面
- 下载最新的
.apk文件 - 在设备上打开文件，按提示确认安装
从源码构建¶
如果你更喜欢自己构建：
- 克隆仓库：
git clone https://github.com/newo-ether/Agora.git - 在 Android Studio（Ladybug 或更新版本）中打开项目
- 同步 Gradle 并构建
要求：Android SDK 34+、JDK 17+。
首次启动¶
首次打开 Agora 时，你会看到一个带有文本输入框的欢迎界面。在开始聊天之前，需要先配置提供商和 API 密钥。
第一步：添加 API 密钥¶
- 点按导航栏中的 设置 图标（右下角齿轮）
- 在 服务 下，点按 提供商
- 从列表中选择一个提供商（如 OpenAI、Anthropic、Google）
- 点按 添加新密钥
- 输入密钥名称（如 "个人"）并粘贴 API 密钥
- 点按 添加
从哪里获取 API 密钥？
- Google Gemini：Google AI Studio — 有免费额度
- OpenAI：Platform API Keys
- Anthropic：Console API Keys
- DeepSeek：Platform
- OpenRouter：Keys page
各提供商的详细信息见 API 提供商 页面。
第二步：同步模型¶
- 返回设置，点按 模型（在 服务 下）
- 点按 从所有提供商同步
- Agora 获取所有已配置提供商的最新模型列表
- 同步完成后，点按某个模型将其设为 默认模型
第三步：发送第一条消息¶
- 点按 返回箭头 回到聊天界面
- 在底部的输入框中输入消息
- 点按 发送（纸飞机图标）
模型将实时流式输出响应。
应用布局¶
Agora 以聊天界面为中心，布局简洁：
顶部栏¶
- 对话标题 — 显示当前对话名称（点按可重命名）
- 汉堡菜单 (:material-menu:) — 打开对话抽屉
- 更多菜单 (:material-dots-vertical:) — 单对话设置（模型、系统提示词、生成参数）
对话抽屉¶
点按 汉堡菜单 或从左侧边缘右滑打开：
- 搜索栏 — 通过关键词或语义搜索查找历史对话
- 对话列表 — 所有对话，按时间排序
- 设置 (:material-cog:) — 配置提供商、模型、提示词等
- 新对话 — 开始全新对话
聊天界面¶
- 消息区域 — 可滚动的对话历史，支持 Markdown 渲染
- 底部栏 — 文本输入、模型选择器、附件按钮 (+) 和发送按钮