RikkaHub (RikkaHub)

一个运行在 Android 上的 AI 大模型聊天客户端，支持多家供应商切换、MCP 工具调用、 语音、Markdown 渲染等。本项目在 RikkaHub 基础上二次开发， 增加了逆向工作台、内置技能、悬浮球、消息保活等功能。

本项目是基于 RikkaHub 二次开发的衍生作品。

RikkaHub 使用 AGPL-3.0 许可证发布，因此本项目（RikkaHub）同样遵循 AGPL-3.0 开源， 完整源码在本仓库/网盘公开，任何人可自由查看、修改、再分发。

• 原项目：RikkaHub —— https://github.com/rikkahub/rikkahub
• 原项目许可证：AGPL-3.0

特别感谢 RikkaHub 原作者打下的完整 AI 聊天客户端基础。RikkaHub在其之上做了功能扩展与界面调整， 但核心框架、绝大部分聊天/供应商/MCP/TTS 代码源自 RikkaHub，版权与署名归原作者所有。

若原作者对本二开有任何异议，请联系我，我会积极配合处理。

• 逆向工作台：预置连接本机逆向 MCP 后端（MT 管理器 / SOMCP / ProxyPin）， 一键探测端口，配套逆向技能与 system prompt。
• 内置技能库：打包了一批安卓逆向/安全分析技能文档。
• 高级功能：AI 生成悬浮球、消息保活前台服务。
• 自定义更新源：更新检测指向本仓库 GitHub Releases（JcEvoX/RikkaHuB），不再监听官方 updates.rikka-ai.com，避免拉到官方包（签名不同）导致覆盖安装失败。
• 品牌信息（应用名、图标、包名 applicationId）改为RikkaHub。

其余的核心能力（多供应商、模型管理、MCP 客户端、TTS/ASR、Markdown、备份同步等） 均来自 RikkaHub，遵循其原有实现与许可证。

# 需要 JDK 21 + Android SDK
./gradlew assembleRelease

web-ui 前端模块需先安装依赖（pnpm，见 web-ui/README 与 AGENTS.md）。

应用内更新检查读取本仓库 GitHub Releases（https://api.github.com/repos/JcEvoX/RikkaHuB/releases/latest）。 发布新版本时，在仓库 Releases 页面创建一个 Release：Tag 用 v{版本号}（如 v2.4.13），并在附件中上传 release APK（app-universal-release.apk 或 app-arm64-v8a-release.apk 等，以 .apk 结尾即会被识别）。 App 检测到该 Release 后即会提示更新并提供下载。

本项目依据 GNU Affero General Public License v3.0 发布（继承自 RikkaHub）。 你可以自由使用、修改、再分发本项目，但衍生作品必须同样以 AGPL-3.0 开源并保留署名。

第三方依赖、submodule 等仍分别遵循各自上游许可证，AGPL-3.0 声明不替代其原有条款。