ARTICLE · 1289811

8 千星的 rikkahub:安卓上最完整的开源 AI 客户端长什么样

发布时间：2026-11-01 09:12:36 最近访问：2026-11-01 09:12:37

在手机上用大模型，多数人被绑在一排官方 App 里：用 ChatGPT 开一个，用 Gemini 开一个，想换 DeepSeek 再下一个。rikkahub（rikkahub/rikkahub）做的事是把这一排 App 合成一个：一个原生安卓客户端，任意 OpenAI、Google、Anthropic 兼容 API 都能接，Key 自己带。截至 2026 年 10 月 25 日，它拿到 8400 多个 Star，最新版本 3.1.1 在一天前刚发布。这篇文章拆一拆，一个"完整"的开源 AI 客户端，到底要做到哪些事。

先看几个可核实的事实：项目 2025 年 3 月创建，一年半拿到 8400 多 Star、817 个 Fork、58 位贡献者；最新 Release 3.1.1 于 2026 年 10 月 24 日发布，主分支同日仍有推送，目前挂着 280 个 open issues，属于活跃维护期。仓库以 Kotlin 为主（约 680 万行），另有约 55 万行 TypeScript 对应 Web 端能力。官网、Google Play 上架、Discord 社区、赞助商一应俱全——这说明它已经过了"玩具阶段"，是一个被真实用户养起来的项目。

另一个值得注意的信号：README 明确写着"本项目不接受 PR"。一个有 58 位贡献者的项目关闭 PR 通道，说明架构决策高度集中，功能演进节奏取决于核心维护者本人——这是双刃剑，后面局限里再谈。

项目是什么

一句话定义：RikkaHub 是一个原生安卓 LLM 聊天客户端，官方的定位写在海报上——"A native Android LLM client. Every provider, one app"：模型不管是谁家的，进这个 App 都能聊。

它本身不管模型：应用里没有任何内置模型，所有推理能力都来自你自己配置的供应商。你可以在设置里添加任意多个 Provider，每个填 API 地址、Key 和模型列表，聊天界面里随时切换。它还提供 Web 访问能力，方便在非安卓设备上接着用同一套配置。围绕这个核心，它把聊天客户端该有的东西补齐了：Material 3 Expressive 设计加深色模式、多模态输入（图片、PDF、Docx）、搜索增强、MCP 工具调用，甚至有一个基于 proot 的 Linux 工作区。

适合谁：手里已有至少一个 API Key、想在手机上统一管理多家模型的用户。不适合希望开箱即用的人——它没有免费额度，不送 token，一切成本自理。

核心能力拆解

能力一：多供应商接入，"自定义"做到了请求体级别。 它支持所有 OpenAI、Google、Anthropic 兼容 API，也可以自定义 API 地址和模型。开放到什么程度，决定你能接什么——它连自定义 HTTP 请求头和请求体都开放了，这意味着各类兼容网关、中转服务、本地部署的 OpenAI 兼容后端都能接进来。Provider 配置支持二维码导出导入，换手机不用重新填一遍 Key。

能力二：MCP 与 Skills 支持。 MCP（Model Context Protocol）和 Skills 让它从"聊天壳"变成"Agent 壳"：模型可以调用外部工具，配合 Agent 自定义和提示词变量（模型名、时间等），可以把某个对话配置成固定的自动化工作流。边界在于：README 只说明支持，没有给出 MCP 服务市场的细节，工具要自己找、自己配。

能力三：Workspace——手机里的 Linux Agent 环境。 这是它在同类客户端里最少见的能力：一个基于 proot 的 Linux 环境，Agent 可以在里面执行任务。proot 不需要 root 权限，在用户态模拟出 Linux 文件系统和工具链。这意味着"让 AI 在手机上跑一段脚本、处理一批文件"不再是 PC 专属。

能力四：完整的功能边界。 搜索接了 Exa、Tavily、智谱、LinkUp、Brave、Perplexity 等一排服务；渲染支持代码高亮、LaTeX 公式、表格和 Mermaid 图表；再加上媒体生成（图片和视频）、文件式记忆、AI 翻译，甚至支持 Silly Tavern 角色卡导入。文件式记忆让跨会话的偏好被记住，不用每次对话都重新自我介绍。这份清单的价值不在单项多强，而在"不用再装"：不用为搜索再下一个 App，也不用为公式渲染忍受乱码。

工程拆解：用 Compose 写 LLM UI

README 给出了完整技术栈：Kotlin、Jetpack Compose、Material 3 Expressive、Koin（依赖注入）、Room（数据库）、DataStore（配置存储）、Coil（图片加载）、Navigation 3（导航）、Okhttp（HTTP 客户端）、kotlinx.serialization（JSON 序列化）。

这套选型里最值得展开的是 Compose 与 LLM UI 的契合度。LLM 客户端的核心 UI 挑战是流式输出：token 一段段到达，界面要逐字刷新，传统 View 体系里手动刷新局部 UI 很容易出 bug。Compose 是声明式 UI，状态一变整块重组，天然适合"消息内容不断追加"的场景。渲染侧，Markdown 里的代码高亮、LaTeX、Mermaid 都要在 Compose 体系里实现，这也是它代码量的大头——约 680 万行 Kotlin，作为对比，很多同规模的服务端项目整个仓库也就这个量级。

存储分层也是标准做法：会话记录进 Room（SQLite），偏好和 Provider 配置进 DataStore，网络层用 Okhttp 处理流式响应，序列化交给 kotlinx.serialization。其余组件各司其职：Koin 做依赖注入，比编译期生成的方案更轻；Navigation 3 是 Google 新一代导航库，配合单 Activity 加多页面的 Compose 架构使用；Material 3 Expressive 则是 Google 较新的设计体系，一个第三方客户端率先完整采用，在安卓社区里属于相当超前的选择。还有一个小细节：README 说明自己编译时需要在 app 目录放一个 google-services.json——它接了 Firebase 相关服务，从源码构建的人要自己准备这个文件。

快速开始

rikkahub 不需要编译，装 APK 就能用。前置条件：一台安卓设备，加至少一个模型的 API Key（OpenAI、Gemini、DeepSeek、OpenRouter 等任一来源）。

1. 从官网 rikka-ai.com/download 或 Google Play（包名 me.rerere.rikkahub）安装；
2. 打开设置中的 Providers，添加供应商，填入 API 地址和 Key；
3. 在模型列表里选一个模型，回到对话页即可开聊；
4. 需要工具能力时，再配置 MCP 服务和搜索服务。

三个常见坑：第一，应用不内置模型、不送额度，没有 Key 会完全无法使用；第二，README 明确警告 GitHub 上存在大量 fork，fork 版本可能出现隐私泄露或过度索权，务必认准官网和 Google Play 官方渠道；第三，从源码编译需要先准备 google-services.json，否则构建不通过。

如果不想逐家申请 Key，聚合平台是一条捷径：README 推荐的 Aihubmix 一站式聚合了 OpenAI、Claude、Gemini、DeepSeek、Qwen 等主流模型；NaAPI 这类 OpenAI 兼容网关则是一个 Key 调 300 多个模型，按量付费，适合先低成本试水。

真实场景

场景一：多模型日常机。 在一个 App 里配好 DeepSeek、Gemini 和一个 OpenRouter 账号，同一个问题切模型对比回答，谁好用用谁。二维码导入让换机迁移只扫一次码。

场景二：手机上的轻量 Agent。 配好 MCP 工具和搜索服务后，让它查资料、调工具、给出带来源的回答；更进一步，在 Workspace 的 Linux 环境里让它写脚本、处理文件，手机上完成原本要开电脑才能做的活。

场景三：文档速读。 出差路上把 PDF 或 Docx 丢进对话，直接问条款、问结论，公式和表格正常渲染，不用在"文件预览"和"提问"两个 App 之间来回切换。

对比与局限

和谁比：ChatGPT、Gemini 的官方客户端体验打磨更好，但被锁死在单一供应商；rikkahub 换来的是模型自由，代价是 Key、计费、稳定性全部自理。同类多供应商客户端不少，但大多集中在桌面端，把 MCP、Skills、proot Linux 工作区全部装进一个安卓原生 App 的，目前不多见——这是"8 千星"背后真正的稀缺性。从部署成本看，它也是同类里最低的一档：不用服务器、不用数据库、不用 Docker，装一个 APK 加一个 Key 就能跑起来，这是它和自托管方案最大的差别。

局限至少说三条：第一，License 是 AGPL-3.0，比 MIT 严格得多——个人使用没问题，但基于它做二次开发并提供网络服务时，修改部分必须开源，商用集成前要过法务；第二，不接受 PR，功能演进绑定核心维护者的节奏，280 个 open issues 的消化速度取决于核心团队；第三，它是安卓专属，iOS 和桌面端没有原生客户端，仅有 Web 访问作为补充；第四，项目 2025 年 3 月才创建，还年轻，重度依赖前要有心理预期。

结论：如果你手里有 API Key，想在手机上统一管理多家模型，还需要 Agent 工具能力，rikkahub 是目前功能边界最完整的开源选择之一，装上就能用。反过来，如果你只固定用一个模型、且重度依赖官方生态的语音和多模态能力，官方 App 仍然更稳；想在 iOS 上找同样的东西，这个项目暂时帮不了你。