Ayuilos/Miffan

Miffan
一款原生 Android AI 客户端，将模型、助手、工具以及本地或远程工作区汇聚在一起。

English · 简体中文 · 繁體中文

Miffan 是一款专为 Android 设计的开源 AI 工作区。连接你已在使用的模型服务，为不同的助手赋予各自的提示词、记忆、工具和个性，并将对话与文件整理在同一个原生应用中。

使用 API 密钥接入 OpenAI 兼容、Gemini 或 Claude 服务，或使用符合条件的 ChatGPT 订阅登录以访问 Codex。Miffan 不内置模型，也不替代服务商账户；可用性和费用取决于你所配置的服务。

Miffan 的独特之处

- 不同模型的统一归宿。 混合使用官方 API、兼容网关、自托管端点和 Codex 订阅，无需围绕单一服务商重建你的工作流程。
- 助手即真实工作区。 每个助手都可以拥有独立的提示词、模型参数、记忆、工具、MCP 服务器、Skills、视觉形象和对话历史。
- 手机不止于展示聊天。 Miffan 可以搜索网页、处理文件、运行本地 Linux 工作区、通过 SSH 连接远程服务器、使用设备能力，并通过浏览器访问同样的对话。
- 有目的的字符系统。 可选择可自定义的 Miffan 碗形角色或蓝鲸女孩，其表情会随对话状态和一天中的时间而变化。

远程工作区 · 3.4 版本新增

通过 SSH 连接你自己的服务器，让助手在选定的项目目录中工作。将本地项目和远程机器保留在同一个应用中，并具有清晰的身份标识和连接状态。

- 多主机与多项目。 管理 SSH 主机、凭据和项目目录，包括你的设备已加入的 Tailscale 网络中的机器。
- 文件与交互式终端。 浏览、预览、编辑、导入和导出远程文件，或打开持久终端自行运行命令。从文件预览返回时会保留当前目录。
- AI 在你的文件所在之处工作。 将工作区绑定到助手，并在其中使用文件和 shell 工具。AI shell 权限和执行确认会针对本地和远程目标分别管理。
- SSH 密钥管理。 生成或导入密钥、复制公钥、查看或导出私钥，并可选使用密码短语加密进行备份。

打开 工作区 → 新建 → 远程 以选择主机和项目目录，然后在助手设置中绑定工作区。一次性介绍也会直接链接到工作区管理。

本地和远程项目
SSH 主机管理
探索新工作区

截图使用演示主机和项目；显示的 UI 语言为简体中文。

远程工作区目前支持 Linux/Unix SSH/SFTP 主机。Miffan 使用现有网络连接，不会设置 Tailscale，也不会在手机离线时让任务自主运行。有关设置和当前限制，请参阅远程工作区指南。

认识蓝鲸女孩

Miffan 与蓝鲸女孩 · 角色插画

蓝色大肥鱼 是原版 Miffan 饭碗角色身边一位开朗、热爱米饭的伙伴。打开 设置 → 外观 以预览该系列，并用专属助手试用它。

- 她自己的助手。 首次试用会创建一个单独的鲸鱼女孩助手并打开新聊天。之后的试用会复用它并保留你的编辑。她的名称、个性提示、模型和工具仍可编辑；现有助手和对话保持不变。
- 跟随对话的表情。 她会微笑、享受抚摸、显得自豪、对更新作出反应、在等待时吃东西、在文本输出时咀嚼、在实际推理时旋转着眼睛摇摆，还会打着呼吸鼻泡打瞌睡。原生绘制保持背景透明，并支持减少动态效果。
- 协调一致的外观。 鲜艳的蓝色头发、鳍和蝴蝶结配有浅色和深色调色板、引导预览和启动画面。饭碗和鲸鱼启动器图标可以独立选择。恢复之前的调色板会保留专属助手。
- 易于发现。 新安装可以在引导过程中选择该合集；现有用户会在聊天主屏幕上收到一次性介绍。你也可以为单个助手选择鲸鱼头像。

截图

生动的吉祥物
角色风格
支持工具的聊天

选中文本翻译

在任意 Android 应用中选择文本，然后从文本操作菜单中选择 Miffan-Translate（标签会跟随应用语言）。Miffan 会在一个紧凑的浮动窗口中显示翻译，而不会让你离开当前页面。

1. 选择文本并选择 Miffan-Translate
2. 查看或复制翻译

功能

模型和提供商

- OpenAI Chat Completions 和 Responses 兼容服务、Google Gemini 和 Vertex AI，以及 Anthropic Claude 兼容服务
- 基于浏览器的 OpenAI Codex 登录，使用符合条件的 ChatGPT 订阅所包含的访问权限
- 为热门官方服务和网关提供内置预设，以及完全自定义的提供商、基础 URL、模型、请求路径、标头和请求体参数
- 模型发现，以及可配置的模态、推理、工具使用、上下文窗口和生成设置
- 支持认证的 HTTP/SOCKS5 代理、自定义 User-Agent、连接测试，以及可选的提供商余额查询
- 根据所选模型的能力进行聊天、推理、工具调用、图像生成和多模态输入

对话体验

- 流式响应、消息编辑和重新生成、响应分支、收藏、文件夹和本地全文搜索
- 每个对话的系统提示、历史压缩、自动标题、后续建议、token 使用量和生成统计
- 图像和文档附件；需要时对 PDF、DOCX、PPTX 和 EPUB 进行本地文本提取
- 丰富的 Markdown 和 HTML 渲染，支持语法高亮、LaTeX、表格、Mermaid 图表、图像和差异对比
- 将对话导出为 Markdown 或图像，将内容分享到 Miffan，并将共享文本交给选定的助手

助手和 Miffan 角色
- 针对模型、提示词、采样参数、上下文限制、请求自定义和聊天背景的独立助手配置
- 记忆、最近聊天引用、预设消息、快捷消息、正则表达式转换、模式注入和设定集
- 导入 JSON 或 PNG 格式的 Tavern 角色卡
- 四种 Miffan 角色类型、六套精选配色、三种动作配置，以及可选的应用主题颜色同步
- 用于空闲、思考、成功、错误、输入、提交、注意和一天中不同时段场景的语义动画，并支持减少动态效果

工具与扩展

- 通过 SSE 或 Streamable HTTP 使用 MCP，包括 OAuth 流程和按助手选择服务器
- 从文件、GitHub 仓库和 Skill.sh 目录安装和管理 Skills，并带有受保护的安装目标
- 通过 Bing、Tavily、Exa、SearXNG、Brave、Perplexity、Firecrawl、Jina、Grok 及其他服务进行网络搜索，并支持自定义 JavaScript 搜索适配器
- 用于时间、剪贴板、JavaScript、文本转语音、用户提问、屏幕使用时间和日历事件的可选本地工具
- 本地 Linux 和远程 SSH 工作区，支持文件管理、编辑器、交互式终端、工作目录上下文，以及 AI 文件/shell 工具

语音、翻译和浏览器访问

- 通过 OpenAI Realtime、DashScope、Volcengine、MiMo 和 Step 进行可配置的语音识别
- Android 系统语音，以及包括 OpenAI、OpenRouter、Gemini、MiniMax、Qwen、Groq、xAI、MiMo、ElevenLabs、Fish Audio 和 Step 在内的可配置 TTS 服务
- 应用内 AI 翻译，以及 Android 选中文本翻译，在紧凑的浮动窗口中显示
- 可选的本地 Web 服务器，用于在设备或局域网内进行浏览器访问，支持密码认证、仅限 localhost 模式和 mDNS 发现

数据和可移植性

- 对话和设置存储在应用的本地数据库中
- 选择性本地备份和恢复、备份提醒、WebDAV 和兼容 S3 的存储
- 从 Chatbox 导入提供商设置和对话，从 Cherry Studio 导入提供商设置，以及从 RikkaHub 导入兼容备份
- 独立的应用 ID、签名身份、发布渠道和深度链接；Miffan 可以与 RikkaHub 共存于同一设备

请参阅功能兼容性矩阵，了解完整的提供商、搜索、语音、工具和可移植性覆盖范围。

下载和首次设置

Miffan 目前通过 GitHub Releases 分发已签名的 APK。官方版本面向运行 Android 8.0 或更高版本的 arm64-v8a 设备。

1. 安装最新的 Miffan APK。
2. 打开 设置 → 提供商 并配置服务，或使用受支持的订阅登录 OpenAI Codex。
3. 添加或发现模型，然后在全局或为特定助手选择它。
4. 仅在需要时启用搜索、MCP、Skills、本地工具或工作区。
Miffan 使用应用 ID me.ayuilos.miffan.app 和 miffan:// 深链接方案。现有的 RikkaHub 数据不会自动共享；如果你想迁移，请从旧应用导出备份并将其导入 Miffan。

从 3.0.0-rc.1 开始，Miffan 使用独立的 SemVer 发布线，不再编码 RikkaHub 版本。官方 APK 保留现有的包名和生产签名身份，因此 2.4.11-miffan.1 可以原地升级，而无需更改应用的数据或数据库兼容性策略。Nightly 工作流产物使用 me.ayuilos.miffan.app.nightly 和临时 CI 调试签名器；它们单独安装，无法替换官方构建。Nightly 是一次性测试产物，签名器可能在每次运行之间发生变化，因此不保证 Nightly 之间的原地升级。

安全和隐私说明

Miffan 是一个客户端：提示词、附件和工具数据会发送到你选择的模型、搜索、语音、MCP、同步或其他端点。请查看你配置的每项服务的隐私政策和定价。仓库的数据流披露见 PRIVACY.md。

Skills、MCP 服务器、本地工具和工作区可以在其授予的范围内访问外部服务或设备数据。请安装可信的 Skills，检查工具请求，并仅启用助手所需的能力。

在启用局域网访问、运行工作区命令或处理敏感凭据之前，请阅读 SECURITY.md。

从源码构建

该项目使用 Kotlin、Jetpack Compose、Material 3、Gradle 和 Java 17。

git clone https://github.com/Ayuilos/Miffan.git
cd Miffan
./gradlew assembleDebug

有用的验证命令：

./gradlew test
./gradlew lint

app/google-services.json 是可选的。没有授权配置的构建会保持 Firebase 分析和崩溃报告禁用。生产签名和发布步骤记录在 docs/releasing.md 中。

角色动画实验室

打开 设置 → 关于，长按版本条目，然后在调试页面中选择 蓝色大肥鱼。预览全部八种表情，暂停或重放它们，切换浅色/深色配色和减少动态效果，测试 28–280 dp 尺寸，或拖动浏览动作时间线。这些控件仅影响预览。

鲸鱼使用原生 Compose 路径和前台动画时钟。未使用的旧版 WebP 动画图集已从 APK 中移除。实现和测试证据见角色架构和视觉验证说明。

仓库模块

| 模块 | 职责 |
| --- | --- |
| app | Compose UI、数据、助手、对话、工具和应用服务 |
| ai | 提供商抽象以及 OpenAI、Gemini 和 Claude 协议实现 |
| search | 网页搜索和页面内容服务集成 |
| speech | 语音识别、合成和播放 |
| document | PDF、DOCX、PPTX 和 EPUB 文本提取 |
| workspace | 本地文件系统/Linux 环境和原生 SSH/SFTP 远程工作区 |
| web / web-ui | 嵌入式服务器和浏览器客户端 |
| highlight、material3、common | 渲染和共享基础设施 |

项目历史与归属

Miffan 最初是 RikkaHub 的社区分支，并持续纳入选定的上游改进。它现在作为一个独立应用程序进行维护，拥有自己的产品标识、角色系统、包名、签名证书、发布线和功能开发。RikkaHub 被视为选择性的代码输入源，而非产品版本来源；审查和来源规则记录在上游同步策略中。

上游版权和归属按许可证要求予以保留。Miffan 不是 RikkaHub 的官方发布版本。

贡献

欢迎提交 issue 和 pull request。对于重大更改，请先开一个 issue，以便讨论产品方向和实现范围。报告 bug 时，请包含 Miffan 版本、Android 版本、提供商类型和可复现步骤，但请移除 API 密钥和私人对话内容。

在开 issue 之前，请阅读 Issue 指南。在提交 pull request 之前，请阅读贡献指南。

许可证

Miffan 在 GNU Affero 通用公共许可证 v3.0 下发布。