Orbis 是一个原生 Android AI 客户端。除了聊天，它把本地后花园、藏书阁、海龟汤、快捷聊天和可选的手机工具放在同一个应用里。
可以先把它当作一个普通聊天客户端使用，再按需要开启其他功能。无需先购买 VPS，也无需加入任何公共服务。
当前仍是持续开发中的版本。已有功能不代表所有手机、模型和后台环境都经过完整验证；请先用不重要的数据试用，并做好备份。
- 下载 Orbis 2.6.3 安装包：普通用户直接下载 APK，不需要自行编译。
- 本版说明：本次更新、安装选择、验收范围及当前限制。
- 上手指南：配置模型、选择本地或自建云端、导书和开始游戏。
- 隐私与权限：什么保存在手机，什么可能发给外部服务，以及备份的范围。
- 更新记录：当前功能与仍未开放的部分。
- 源码构建：开发环境、构建方式与签名说明。
- 来源与许可：上游与第三方声明，以及来源核对范围。
- 原生 AI 聊天：配置自己的模型提供商和助手，使用消息分支、Markdown、附件、搜索、朗读及按需工具。具体能力取决于模型和服务配置。
- 本地后花园：在手机保存日记、锚点、信件、心愿等文字，设置自己的展示称呼；不需要账号或 VPS。
- 本地藏书阁：导入 TXT、Markdown 文字书籍，保存阅读进度、书签和批注；可让当前 AI 按章节片段共读。
- 本地海龟汤：与自己的 AI 伙伴一起推理，由另行选择的 DM 模型主持。主持接口与主聊天上下文分开。
- 快捷聊天：在后花园里点“聊聊”，选择当前 AI 的已有窗口。消息存回原窗口，不自动附带书页或汤底。
- 多 AI 群聊与小游戏：为不同成员选择身份和模型，顺序交流或点名；也可使用本地规则游戏和隔离的小游戏页面。模型参与时可能产生费用。
- 外观与阅读：主题、背景、字体、气泡和消息阅读方式可按偏好调整。
- 聊天迁移与本地日程：支持多种来源的聊天预览、选择和追加导入；提供本地课表、日程和颜文字管理。不同导入格式的保留范围不同，见本版说明。
- 可选工具与陪伴：本地记忆、日历、通知、语音、工作区、MCP，以及按规则唤醒等能力各有配置和权限边界。不用的功能可以不打开。
手机与陪伴能力已经内置，不需要另装配套的手机工具应用，也不需要为内置工具额外搭建 MCP 服务。模型、系统权限和你主动选择的外部服务仍需各自配置。
这些是功能入口，不是“已经连接成功”的证明。未配置的服务、被撤回的权限或不可用的模型，都可能让相关功能无法使用。
| 路线 | 需要准备 | 数据在哪里 |
|---|---|---|
| 本地使用 | 手机；使用 AI 时另配模型 | 本机保存的花园、书库及对局 |
| 连接自建云端 | 你自己的 Orbis 网站，以及与它配套的 Supabase 等服务 | 由该网站及其后端管理 |
两条路线不是自动同步关系。切换不会自动搬运、上传、合并或删除任一边的数据。本地花园、书库和云端站点需要分别考虑备份。
自建云端是可选项。应用不会替你创建 Supabase 项目，也不附带可直接使用的公共站点、账号或数据库管理密钥。
Orbis 不附送模型账号、API Key 或调用额度。请自行配置可信的提供商、接口地址和模型，并查看其计费与隐私说明。
聊天、共读、翻译、模型对弈、语音服务和海龟汤主持等操作，可能分别调用你配置的服务。一个操作也可能包含多轮模型请求。不开启 AI 的本地记事与阅读不需要模型调用；“无需 VPS”不等于“远端模型免费或离线”。
开源版的咨询室关闭，北斗导航中不显示咨询室入口。系统设置保留“正在开发，暂未开放”的提示。相关源代码保留供开发与审查，但不提供配置、待命、加入或调用入口，也不能通过旧配置继续使用。请不要把代码存在理解为功能已开放。
咨询室不影响普通聊天、本地后花园、共读和海龟汤等其他入口的使用。是否开放将在后续明确说明，不承诺时间。
请从 GitHub 发布页 下载签名 APK。最低需要 Android 8.0；通常选择 arm64-v8a，不确定设备架构时选择 universal。通用包包含 arm64-v8a 和 x86_64，不包含 32 位 ARM；x86_64 主要用于对应架构设备或模拟器。发布页中的源码压缩包不是安装包。上游 RikkaHub 的安装包也不是 Orbis。
正式版包名为 org.orbis.agent。Orbis Dev 使用 org.orbis.agent.dev，与正式版是两个独立应用，不会自动共享或迁移聊天、书库及设置。不要为安装正式版先卸载仍需保留数据的开发版。
旧版更新遇到“签名不一致”时，请先不要卸载。 2.6.1／2.6.2 的更新器在 Android 9／10 上可能读不到下载 APK 的证书而误报，2.6.3 已修正。受影响用户请从官方发布页手动下载 2.6.3 APK，直接覆盖安装一次，不清除数据；2.6.0 也可直接这样升级，无需逐版安装。若 Android 系统安装器仍报签名冲突，请停止并核对来源，不要绕过校验。
修复版的“系统设置 → 版本更新与回退”仍会检查官方新版本、展示说明，并在用户确认备份后下载校验 APK，再交给 Android 确认安装；不会静默下载或安装。自动检查最多每 24 小时一次，不是持续后台推送。Android 10 的证书读取修复已实机复现验证；从修复版到下一更高正式版的应用内完整升级仍待后续验收，详见更新与回退说明。
同包名、相同签名且版本允许时可覆盖升级；若安装器提示冲突，请先核对来源，不要直接卸载或清除数据。Dev 版不会把正式 APK 当作自身覆盖更新。
升级、卸载或清除数据前，先阅读备份说明。普通聊天 ZIP 不覆盖所有 Orbis 本地数据，也不要把它直接上传到公开问题区。
Orbis 基于上游 RikkaHub 的源码开发，是独立衍生项目，不代表上游官方版本。
保留上游 AGPL-3.0 的 LICENSE、版权声明及相应第三方许可文件；具体内容以仓库中的原文件为准。书籍、图片、音乐和其他导入内容的来源说明应单独保留。
请说明应用版本、Android 版本、操作步骤、预期结果和实际结果。不要附上 API Key、完整请求日志、聊天备份、私人正文或带授权信息的链接。能用无敏感内容的小例子复现，通常更容易定位问题。