图片和文档输入
点击聊天输入框的加号，从相册或文件中添加图片、PDF、DOCX、PPTX、EPUB。发送前确认附件，随后就可以围绕内容提问。
图片理解需要视觉模型。当前聊天模型不支持视觉时，需先配置可用的 OCR 模型。文档以提取文本的方式进入上下文，过长文档可拆分发送。
RIKKAHUB / DOCUMENTATION
RikkaHub
使用教程
从下载安装到配置第一个 AI 模型，带你快速完成 RikkaHub 的初次使用。
约 5 分钟完成首次配置实际耗时取决于 API 密钥准备情况
一台 Android 设备可用的 API Key对应服务商的接口信息
01
DOWNLOAD & INSTALL
第一步，下载并安装应用
获取 Android 安装包，然后按照系统提示完成安装。
- 点击下载按钮，获取 RikkaHub Android 安装包。
- 下载完成后，在手机文件管理器中找到 APK。
- 根据 Android 系统提示，允许当前安装来源安装应用。
- 完成安装后，打开 RikkaHub。
1. 获取 APK
2. 打开安装包
3. 按提示安装
4. 打开应用
02
PREPARE YOUR KEY
第二步，准备 AI 服务商的 API Key
RikkaHub 本身不提供模型调用额度，需要先准备至少一个支持的 AI 服务商 API Key。
- API Key 用于身份验证和模型调用。
- 不同服务商的 Base URL 和接口格式可能不同。
- API Key 应妥善保管，不要公开分享。
- 模型调用费用由对应服务商决定。
03
CONNECT A PROVIDER
第三步，配置你的第一个 AI 服务商
- 打开 RikkaHub。
- 点击侧边栏底部的设置图标。
- 进入提供商设置。
- 选择已有服务商，或者点击右上角新增。
- 根据实际服务商填写配置。
这些配置项分别是什么？
- 服务商名称
- 自定义显示名称，方便区分不同服务。
- API Base URL
- 服务商提供的 API 基础地址。
- API Key
- 在服务商控制台创建的调用密钥。
- 接口类型
- 选择对应的 OpenAI、Google 或 Anthropic 接口格式。
- 其他请求参数
- 按服务商要求配置请求头等必要参数。
12应用真实截图，标记用于定位入口。
04
AUTHENTICATE
第四步，填写 API Key 并保存
- 找到所选服务商的 API Key 输入框。
- 粘贴从服务商获取的密钥，核对是否完整、有无首尾空格。
- 核对接口地址，确保它属于当前服务商。
- 点击保存或确认。
保存前，做一次核对
服务商正确 → 接口格式一致 → Base URL 正确 → 密钥完整
05
ADD YOUR MODELS
第五步，添加需要使用的模型
- 进入刚才配置的服务商。
- 找到页面底部的模型配置区域。
- 如果支持获取模型列表，可以从列表中选择。
- 如果没有自动获取，可以根据服务商提供的模型 ID 手动添加。
- 保存模型配置。
添加完成后，可从聊天工具栏左下角的模型选择入口切换模型。
不同服务商提供的模型名称、模型 ID 和接口能力可能不同，需要以实际服务商提供的信息为准。显示名称与模型 ID 可能不同，手动添加时应使用准确的模型 ID。
06
SET YOUR DEFAULTS
第六步，设置默认模型
返回设置页面，进入默认模型和提示词相关设置，为聊天以及其他功能模块选择合适的默认模型。
可根据实际需求配置不同功能使用的模型。聊天、OCR 或其他辅助任务可以按需选择不同模型，并核对相应能力与调用费用。
在设置中的「模型与服务」区域，进入「默认模型和提示词」。
YOU'RE READY
完成配置，开始第一次对话
- 返回聊天主界面。
- 点击模型选择按钮。
- 选择刚刚添加的 AI 模型。
- 在输入框中输入问题。
- 点击发送，等待模型回复。
试试发送这句话
你好，请介绍一下你能帮助我完成哪些任务。
收到回复后，就可以继续追问，或者切换其他已配置的模型，比较不同的回答。
恭喜，你已经完成 RikkaHub 的首次配置。
接下来，试试把图片、文档和工具带进对话。
GO A LITTLE FURTHER
常用功能，接着探索
联网搜索
进入设置中的搜索服务，添加所需服务并填写密钥或实例地址，选择当前使用的服务。返回聊天，开启输入工具栏的搜索开关，再发送问题。
支持工具调用的模型会按问题需要调用搜索。未出现结果时，检查开关、服务配置、网络及配额。
Markdown 渲染
模型返回 Markdown 内容后，应用会呈现代码高亮、LaTeX 数学公式、表格与 Mermaid 流程图。可以在提问时直接要求模型按相应格式组织回答。
Agent 工作区
- 进入设置 → 扩展管理 → 工作区，点击加号，用英文名称创建工作区。
- 进入工作区管理页面，点击「安装 Rootfs」准备 Linux 环境。
- 通过右上角图标打开终端，或在文件标签页导入、导出文件。
- 回到聊天，点击加号，绑定工作区后向 AI 下达任务。
工作区工具可配置执行审批。先确认任务内容，再按需要运行命令与文件操作。
MCP 工具扩展
打开设置中的 MCP，添加服务器，按服务端要求选择 SSE 或 Streamable HTTP，填写地址和必要请求头。连接成功后，在助手设置中启用相应服务器。
请核对服务器的连接状态与工具列表，按需要配置工具执行审批。
智能记忆
进入设置 → 助手，选择助手并打开记忆标签页，按需启用记忆。可以查看、编辑和删除已保存的信息，帮助后续对话延续上下文。
记忆提取使用已配置的快速模型，请同时检查模型设置与调用费用。
对话分支
在想继续探索的消息处，长按消息或点击更多菜单，选择 Fork 创建分支。从分叉点继续提问，也可以换一个模型，比较不同思路。
自定义智能体
进入设置 → 助手，新建或编辑助手，设置提示词、默认模型和行为。按需绑定工具与工作区，让不同助手承担不同任务。
HELP & TROUBLESHOOTING
常见问题与故障排查
API Key 错误，无法发送消息怎么办？
重新复制完整密钥，去掉首尾空格，确认密钥属于当前服务商。到服务商控制台检查密钥状态、账户余额和模型访问权限。若返回 401 或 403，结合服务商错误信息核对认证方式和权限，保存后再试。
添加服务商后没有模型怎么办？
打开该服务商的模型配置，尝试获取模型列表。若接口不提供列表，按服务商文档手动填写模型 ID。确认模型已启用并保存，再返回聊天界面的模型选择器查看。
Base URL 应该填写什么？
填写当前服务商文档给出的 API 基础地址，核对协议、域名和版本路径。不要填写官网登录页面或单个聊天请求的完整地址。是否包含 /v1 等路径取决于服务商要求与当前应用的接口设置，避免重复追加路径。
为什么模型提示接口不兼容？
检查提供商类型是否与 OpenAI、Google 或 Anthropic 实际接口一致，再核对模型 ID 和接口能力。对于 OpenAI 兼容服务，确认使用的是 Chat Completions 还是 Responses API。可先关闭图片、工具与联网搜索，用纯文本消息测试，再逐项恢复功能。
联网搜索没有结果怎么办？
进入设置中的搜索服务，检查服务是否启用、密钥或实例地址是否正确、配额是否充足。返回聊天界面开启搜索，并确认模型支持工具调用。用具体、简短的查询重试，同时检查网络连接与服务商返回的错误信息。
为什么使用模型会产生额外费用？
RikkaHub 客户端免费，API 调用由你配置的服务商计费。聊天、OCR、记忆提取和部分搜索服务可能产生调用费用。请在对应服务商控制台查看用量、价格与额度设置。