RikkaHub

RikkaHub官方正版是一款简洁强大的安卓AI聊天客户端。接上自己的API Key，OpenAI、Google、Anthropic以及任意兼容接口都能用，顶部切一下就换模型，对话记录不丢。同一个问题懒得重发？直接开消息分支，一条往左试、一条往右试，哪种回答更对味一眼看清。

RikkaHub基于proot在手机里跑起一个轻量Linux，不用root。AI能自己敲命令、读文件、整理文档，甚至帮你搭个PPT草稿，想手动干预，终端随时打开自己上。接上外部工具后，模型不只是说话，能真去查、去跑、去联动。有需要的用户赶紧下载试试吧。

RikkaHub适合谁

• 手里攒了好几家 Key、受够了切 App 的

• 想在手机上跑 Agent / MCP 折腾自动化的

• 以及就是想要一个干净、开源、不被绑死在某一家的聊天前端的人

RikkaHub如何接入DeepSeek V4 Pro API

1.下载安装 RikkaHub

2.API 密钥导入及模型创建

设置-->提供商-->选择DeepSeek-->API密钥填写并保存-->右下角模型-->添加新模型-->模型ID：deepseek-v4-pro-->添加模型并保存；

3.模型设置

设置-->默认模型与提示词-->将所有模型替换为deepseek-v4-pro模型选择；

4.创建助手（智能体）

设置-->助手-->右上角添加助手并命名-->点击新创建的助手-->对助手进行设置：

1. 提示词：

1）系统提示词：不要迎合用户，你的回答要始终保持客观。

2）开启独立对话系统提示与提示词注入；

2. 记忆：

开启记忆、参考历史聊天记录、时间提醒这三个选项；

3. 本地工具：

建议开启123457这6个选项；

4. 基础设定：

1）聊天模型选择deepseek-v4-pro；

2）思考预算推理拉到最大、上下文消息无限制、最大Token数无限制；

RikkaHub快速上手教程

1.下载并安装 Rikka

安装完成后，从主屏幕或应用抽屉打开 Rikka。

2.打开设置并添加服务商

Rikka 需要至少一个 AI 服务商才能开始聊天，现在前往服务商设置。

• 点击侧边栏底部中的设置图标（齿轮）。

• 在设置菜单中选择提供商设置。

• 这里预设了很多提供商，如果有你想要的，直接进入后填写api key即可，如果没有，点击右上角新建一个提供商。

3.输入你的 API 密钥

将 API 密钥粘贴到所选服务商的 API Key 字段中。

如果你用的是非官方的中转，并且RikkaHub没有内置这个提供商，你新建提供商的时候还需要配置提供商的Base Url。

请像对待密码一样保护你的 API 密钥。不要分享，也不要粘贴到不受信任的应用中。Rikka 将密钥存储在你的设备本地，绝不会发送到 Rikka 的服务器——密钥直接传送给你选择的服务商。

粘贴密钥后，点击保存或确认以存储服务商配置。

4.添加模型

配置提供商后，提供商配置节目底部还有个模型栏，点击进入，添加你希望使用的模型。

大部分提供商支持获取模型列表，你只需要点击展开模型列表，然后从列表选择你要用的模型即可。

如果不需要这个模型，侧滑即可删除。

你可以随时在对话中通过聊天工具栏中的模型选择器更换模型。默认模型只是新对话的起点。

5.配置默认模型

现在你还需要配置各个功能的默认模型，回到设置页面，选择默认模型和提示词，配置下各个功能模块默认用的模型即可。

除了对话模型，其他功能用的模型可以按需配置，通常可以配置一些速度更快价格更低的模型。

6.开始第一次对话

一切就绪，返回主界面开启新对话。

• 点击底部左侧的模型选择按钮，选择你希望使用的模型。

• 在底部文本框中输入第一条消息，然后发送

Rikka 会实时流式输出回复。大功告成，你已经可以正常使用了！

试试用「介绍一下你能帮我做什么」作为开场白，感受模型的能力，再开始更具体的任务。

请不要询问它是什么模型，模型并没有准确的自我认知，这不是模型或者RikkaHub的问题，这是大模型的原理导致的。

官方的App或者其他App可以准确回答是因为它们内置了系统提示词，指导了模型身份，RikkaHub默认情况下不会内置这些提示词，当然 你也可以设置这些提示词。

RikkaHub如何设置MCP服务器

添加 MCP 服务器

1.打开 MCP 设置

导航到设置 → MCP。你会看到所有已配置服务器的列表及其当前连接状态（空闲、连接中、已连接、重连中或错误）。

2.点击添加服务器

点击右上角的 + 按钮。选择与你的服务器匹配的传输类型。

3.配置服务器

填写服务器详情（参见下方的传输类型和服务器选项），然后保存。

4.等待连接

Rikka 会自动连接并同步服务器暴露的工具列表。绿色的已连接指示器确认握手成功。如果连接断开，Rikka 会以指数退避的方式自动重试，直到将服务器标记为错误状态。

MCP 服务器必须在互联网上公开可达，或与你的 Android 设备处于同一局域网中。位于防火墙或企业 VPN 后面的服务器需要在设备上先连接 VPN，Rikka 才能访问。

传输类型

Rikka 支持两种 MCP 传输机制。两者都只需要一个 URL 端点——选择你的服务器所支持的类型即可。

SSE（Server-Sent Events）

最初的 MCP 传输方式。客户端打开一个持久 HTTP 连接，服务器通过该连接推送事件。提供完整的 SSE 端点 URL，例如 https://mcp.example.com/sse。

Streamable HTTP

MCP 规范中定义的较新的推荐传输方式。使用标准 HTTP 请求配合分块流传输。提供服务器的基础 URL，例如 https://mcp.example.com/mcp。

服务器选项

每个服务器都有一组通用选项，你可以在添加或编辑时进行配置。

name string 必填

该服务器的可读显示名称。显示在 MCP 服务器列表和助手设置选择器中。

enable boolean 默认值:"true"

在不删除服务器的情况下开启或关闭它。禁用后，Rikka 会关闭连接，并且不会将该服务器的工具暴露给任何助手。

url string 必填

MCP 端点的完整 URL。对于 SSE 服务器，通常是以 /sse 结尾的路径；对于 Streamable HTTP 服务器，则是 MCP 基础路径。

headers list of key-value pairs

随每个请求发送到该服务器的自定义 HTTP 头。用于传递身份验证令牌、API 密钥或服务器要求的任何其他请求元数据。以名称-值对的形式添加每个头，例如 Authorization: Bearer。

单个工具选项

Rikka 连接并同步后，会列出服务器暴露的每个工具。你可以单独控制每个工具。

enable boolean 默认值:"true"

启用或禁用该服务器的特定工具。被禁用的工具会从助手的工具列表中隐藏，即使服务器已连接也不会被调用。

needsApproval boolean 默认值:"false"

开启后，Rikka 会在执行该工具前显示确认对话框。对于任何执行不可逆操作的工具——文件写入、发送邮件、购买——使用此选项，以便你始终掌控 AI 的实际行为。

对任何会修改数据或触发外部副作用的工具启用需要审批。你可以快速审批通过，同时防止模型以你不希望的方式自主行动。

将 MCP 服务器附加到助手

将服务器添加到 Rikka 的全局列表并不会自动将其暴露给你的助手。你必须为每个助手单独启用。

1.打开助手设置

在主屏幕上长按一个助手，或点击助手名称然后点击编辑（铅笔图标）来打开其设置。

2.找到 MCP 服务器部分

向下滚动到 MCP 服务器。你会看到全局 MCP 列表中当前已启用的所有服务器。

3.切换你需要的服务器

启用该助手应该有权访问的服务器。只有在此处勾选的服务器的工具才会出现在助手的工具调用中。

通过 JSON 导入服务器配置

如果某个服务提供了现成的 MCP 配置文件，你可以直接导入，而无需手动输入所有详情。

1.复制或下载 JSON 配置

配置应该是一个 JSON 对象，按照 Rikka 的配置模式描述一个或多个 MCP 服务器。

2.打开 MCP 设置并点击导入

在设置 → MCP 中，点击导入图标并粘贴或加载 JSON。Rikka 会验证并将服务器合并到你的现有列表中。

一个最简的单服务器 SSE 配置示例如下：

连接状态参考

RikkaHub如何通过文本提示生成图片

选择图片生成模型

在生成第一张图片之前，告诉 Rikka 要使用哪个模型。

1.打开模型设置

前往设置 → 模型，找到图片生成模型选择器。

2.选择模型

选择器会列出所有已配置提供商中支持图片生成的模型。选择你想要的模型——例如，来自 OpenAI 提供商的 dall-e-3，或来自 Google 的 imagen-3.0-generate-002。

3.保存

你的选择会自动保存。你也可以随时在图片生成界面中使用输入栏的模型选择器来更换模型。

打开图片生成界面

点击应用抽屉（主屏幕上的网格图标）中的图片生成入口，打开专用工作区。界面底部有两个标签页：

生成

输入提示词、调整设置并创建新图片。最近生成的图片会显示在此标签页的顶部。

相册

浏览所有会话中生成的图片，每张卡片上显示提示词和模型名称。

通过文本提示生成图片

1.编写提示词

在生成标签页底部的输入框中输入描述性文本提示词。你提供的细节越多——主题、风格、光线、构图——输出就越接近你的设想。

2.调整生成设置（可选）

点击设置（扳手）图标打开设置面板。你可以配置：

• 模型——无需离开当前界面即可切换到其他图片模型。

• 图片数量——单次请求生成 1 到 4 张图片。

• 宽高比——选择正方形、横向或纵向。

3.点击发送按钮

点击圆形箭头按钮。Rikka 将你的提示词发送到所选模型，并在等待结果时显示加载指示器。

4.查看输出

生成的图片会出现在输入栏上方。点击任意图片可打开全屏预览。

点击右上角的 + 图标开始新会话，可以清除当前提示词和已生成的图片，重新开始。每个会话保持独立的上下文，与相册历史记录分开。

编辑已有图片

部分模型——例如 dall-e-2 和某些 Imagen 变体——支持图片编辑，你可以提供参考图片并用提示词描述你想要的更改。

1.添加参考图片

点击输入栏中的添加图片（+）图标，从设备相册中选择一张或多张图片。缩略图会出现在文本框上方；点击缩略图上的 × 可移除。

2.描述编辑内容

编写提示词说明要应用的更改，例如：“将背景更换为海上日落”。

3.点击发送按钮

当存在参考图片时，Rikka 会调用提供商的图片编辑端点，而非标准生成端点。

并非所有图片模型都支持编辑。如果你选择的模型仅支持生成，当你尝试附带参考图片提交时，Rikka 会返回错误。请切换到支持编辑的模型（查看你的提供商文档），或移除参考图片以执行标准生成。

使用相册

你生成的每张图片都会自动保存到 Rikka 的应用内相册。打开相册标签页浏览历史记录。

每张相册卡片显示：

• 图片缩略图

• 使用的模型

• 提示词的截断版本

在卡片的操作栏中，你可以：

点击缩略图可打开支持双指缩放的全屏预览。

图片存储在 Rikka 的私有内部存储中，直到你明确点击保存将其导出到设备的媒体库。卸载 Rikka 将永久删除所有未外部保存的图片。

获得更好效果的技巧

1.编写有效的提示词

• 具体描述主题：“一只红色狐狸坐在黄昏时分的雪地森林中” 比 “一只狐狸” 效果好得多。

• 指明艺术风格或媒介：“油画”、“照片级真实感”、“水彩素描”。

• 描述氛围或气氛：“戏剧性光线”、“柔和的粉彩色调”、“电影级构图”。

• 如果模型支持负面提示词，请使用设置面板排除不需要的元素。

2.选择合适的宽高比

• 正方形——社交媒体帖子、头像、产品展示。

• 横向（16:9）——桌面壁纸、场景插图、横幅。

• 纵向（9:16）——手机壁纸、海报、角色立绘。

3.控制 API 费用

图片生成 API 通常按生成的图片数量收费。在迭代提示词时，将图片数量设置保持为 1，等你满意风格和构图后再增加数量。

更新日志

v3.0.0版本

全新界面设计：聊天、设置、助手、服务商、扩展、备份、翻译等几乎所有页面都换了新风格，应用图标和通知图标也一并更新

新增媒体创作：在同一处生成图片和视频，接入多家厂商的最新模型，生成结果可以多选后批量保存或删除

记忆升级为按文件整理的记忆库，对话结束后自动归纳

压缩上下文改为插入总结，不再删除历史消息；输入框旁显示上下文用量，模型可以设置上下文长度

对话开始后，模型、思考深度、搜索等设置固定在这个对话上，不再跟着助手变化

对话列表可以按创建时间排序，新对话会放进当前打开的文件夹，自动生成标题可以关闭

搜索新增 DeepSeek 搜索服务，Claude 服务商可以使用模型自带的搜索

翻译页新增翻译历史

可以高亮显示引号里的文字

编辑消息时可以修改思考内容

工作区支持 Alpine 系统，并可复制文件路径

MCP 服务器配置改为独立页面，改进登录授权的兼容性

修复多处崩溃和显示问题，包括快速修改设置时丢失改动、多轮工具调用时用量统计不准、深色模式下引用角标看不清等，启动和滑动也更流畅