---

🌟 项目简介

Operit AI 是移动端首个功能完备的 AI 智能助手应用，核心客户端、聊天记录和模型配置均运行并保存在您的 Android 设备上。云模型由您选择服务商并自行配置 API Key 和端点后，从设备直接调用；Operit 不提供大语言模型推理服务或聊天请求中转。应用拥有强大的工具调用能力、深度搜索、工作流与自动化、智能记忆库，并支持人设定制与角色卡等高度自定义功能，集成 MNN/llama.cpp 本地模型、MCP/Skill 生态与多语言界面。它不仅仅是聊天界面，更是与Android权限和各种工具深度融合的全能助手，内置Ubuntu 24 环境，提供前所未有的强大功能。

---

⚡ 核心亮点

🖥️ Ubuntu 24 环境 内置完整 Ubuntu 24 系统，支持 vim、MCP、Python等工具，在手机上运行复杂的Linux命令和自动化任务 🧠 智能记忆系统 AI自动分类管理记忆，支持时间查询/导入导出/自动总结，智能搜索历史对话，记住您的偏好和习惯，提供个性化服务 🗣️ 语音交互 连续自然对话，支持本地/云端 TTS + 本地 STT、自定义音色、语音/特定音频唤醒、自动朗读

🤖 本地AI模型 支持 MNN / llama.cpp 本地模型（GGUF），完全离线运行AI，保护隐私数据 🎭 人设与角色卡 自定义AI性格、说话风格，支持角色卡导入导出（酒馆/JSON）/备份/二维码分享，角色卡可互聊并拥有独立对话历史 🔌 丰富工具生态 40+ 内置工具 + MCP/Skill 市场插件 + 工具包/工作流，含自动点击 Agent、绘图/图片搜索、AI 互聊/自我认知、定时任务、提示词市场等，覆盖文件操作、网络请求、系统控制、媒体处理

---

🛠️ 功能速览

📦 内置工具系统（点击展开）

工具类型	功能说明
🐧 Linux环境	完整Ubuntu 24，支持apt包管理、Python/Node.js运行环境、自定义软件源
📁 文件系统	读写文件、搜索、解压缩、格式转换、Git集成
🌐 网络工具	HTTP请求、网页访问、文件上传下载、Web开发与导出
⚙️ 系统操作	安装应用、权限管理、无障碍 / ADB / Root 三通道自动化（含 AutoGLM 自动点击 Agent，支持 adb root 虚拟屏/多显示器）
🎬 媒体处理	视频转换、帧提取、OCR/图像理解、相机拍照、音视频读取
🧑‍💻 开发与终端	工作区/一键打包、代码编辑/语法高亮、终端 SSH/Chroot/vim、Ctrl 组合键
🎨 AI 创作	绘图工具包（OpenAI/Qwen/NanoBanana/Zhipu）、图片搜索/下载
🔍 搜索引擎	深度搜索、DuckDuckGo、Tavily、谷歌学术、Bing、Sogou、Quark、百度地图集成
🧩 工具包 & 工作流	工具包生态/包管理、工作流自动化、定时触发、语音唤醒触发

🎨 界面定制（点击展开）

• ✨ 主题系统：自定义颜色、字体、间距、内边距
• 🌍 多语言支持：中英覆盖，自动随系统语言切换
• 🔤 字体与排版：全局字体大小、聊天边距自定义
• 🎭 桌宠功能：WebP动画支持、自定义表情、悬浮窗显示
• 📱 布局优化：隐藏状态栏、自定义工具栏、平板适配
• 🎨 Markdown渲染：LaTeX公式（支持左右滚动）、代码高亮、表格、Mermaid图表
• 🧾 信息展示：思考链折叠、HTML块预览、代码/思考块高度限制
• 🪟 悬浮窗体验：悬浮窗/气泡模式头像隐藏、圈选识屏、全屏预览
• 🧮 数据统计：Token 用量统计、模型饼图

🔗 集成能力（点击展开）

• 🤖 Tasker集成：触发自定义AI代理事件，深度自动化
• 🌐 MCP/Skill 市场：一键安装插件、远程MCP、自动描述、uvx/npx支持
• 🔌 多模型支持：OpenAI Responses API、Claude、Gemini、xAI、Novita、Ollama、NVIDIA、OpenRouter、LMStudio、百灵等
• 🧪 模型与提示词管理：多配置/参数自定义、提示词市场
• 🔐 权限系统：工具级权限控制与安全提示
• 🔑 密钥池与统计：批量测试/导入、Token 统计（模型饼图）
• 🗂️ 工作区绑定：支持 SAF / SFTP / SSH 工作区绑定与文件访问
• 🖱️ 自动点击 Agent：AutoGLM + UI Tree 双通道，支持自动化操作
• 📊 工具并行：只读工具并行执行，提升响应速度

💬 对话与记忆管理（点击展开）

• 🧠 记忆库：自动分类/搜索、时间查询、导入导出、附件记忆
• 💬 对话管理：自动总结与总结编辑、历史分组/分支/迁移、对话锁定、角色卡独立历史
• ⚡ 对话并行：并行对话处理、工具包 state 决策
• 🤖 角色互动：角色卡互聊、查看历史、思考链折叠
• 📦 聊天记录：多格式导入导出、历史备份与恢复

💾 数据与备份（点击展开）

• 🗂️ 全局/自动备份：数据库定时备份，支持损坏恢复（排除 MCP/Skill/终端/包）
• 🎭 角色卡：备份、导出（酒馆/JSON）、二维码分享
• 🧷 工作区：SAF/SFTP/SSH 绑定、代码编辑/语法高亮、Git ignore
• 🧰 Skill 管理：Skill 开关、仓库解析与缓存下载

---

📸 功能展示

Web开发 在手机上设计网页并导出为独立应用

悬浮窗 & 附件 随时调用，便捷分享

插件市场 丰富的MCP生态

---

🚀 快速开始

项目	说明
📋 系统要求	Android 8.0+ (API 26+)，建议 6GB+ 内存，5GB+ 剩余存储
📥 下载安装	Release页面 下载最新APK
📖 使用指南	官方网站 包含详细教程和示例

安全提示： 为确保您的数据安全，请务必从官方 Release页面 或 官方网站 下载本应用。通过未知渠道下载的安装包可能被恶意修改，从而导致隐私泄露或设备被监听。

安装步骤： 下载APK → 安装启动 → 按引导配置 → 开始使用 ✨

---

🔐 数据、模型与对外部署

• 云模型由用户自行配置： 使用云模型时，请自行选择服务商并配置 API Key、模型和端点。聊天请求从您的设备直接发送至所选服务商，Operit 不提供聊天推理、API 请求中转或聊天记录云端托管。请同时阅读所选服务商的服务条款和隐私政策。
• 本地模型可离线推理： MNN 和 llama.cpp 模型在设备本地执行推理；模型文件准备完成后，可在不连接模型服务商的情况下使用。
• 其他网络功能独立运行： 市场、公告、更新检查、GitHub 登录及您主动启用的 MCP、搜索、语音、绘图等功能会访问相应的第三方或 Operit 网络资源。这些功能不构成聊天模型请求中转。
• 对外提供服务由部署者负责： 外部 HTTP 服务默认关闭；启用后会在设备网络接口上提供网页聊天和 HTTP API。QQ Bot 等示例也可用于自动回复。请仅向获得授权的对象开放，并自行负责访问控制、数据保护和内容管理。面向中国境内公众持续提供拟人化情感互动服务的部署或运营者，还应自行评估并遵守适用的法律法规和监管要求。

---

🔮 TODO / 开发计划

• UI 自动化与截图管线
  • ✅ 已支持无障碍 / ADB / Root 三种权限模式的 UI 自动化
  • ✅ 支持 adb root 场景下的虚拟屏幕/多显示器（display 参数）
  • ✅ UI Tree 支持 AutoGLM + 本地 uiautomator dump 双方案

---

📅 版本更新历程

版本	发布日期	核心更新
v1.12.0 最新	2026-07-01	• 市场与创作生态：统一市场流程，新增 Artifact 市场、项目管理与发布能力，完善市场搜索、GitHub OAuth 登录、示例仓库与侧栏入口 • 工具包与工作区：抽离 ToolPkg IPC / runtime 管理，新增 hook runner、计划模式 runtime IPC、工作区变更追踪/附件/模板、zip include_root_directory 参数 • 多语言、语音与媒体：新增韩语、西班牙语、葡萄牙语本地化，加入 MIMO/Mimo、VITS、ONNX、Doubao TTS、音乐播放队列，并优化图片附件与附件文件名去重 • 稳定性与安全：移除硬编码默认 DeepSeek API Key，新增崩溃修复恢复流程与启动隔离，修复模型提供商显示、按钮文本溢出、云端 embedding 校验、DashScope 音频识别等问题
v1.11.0	2026-05-16	• Web Chat 与 Artifact 市场：新增 Web Chat 与 Artifact 市场，支持网页聊天模型选择、历史导航、项目管理与作品发布，并将问题库迁移到记忆库体系 • 工具包、Hook 与 Compose DSL：新增 ToolPkg AI provider、单轮对话控制、工具 hook 拦截与执行器，扩展 Compose DSL 的 WebView、slot、调试 dump 与重渲染能力 • 记忆、上下文与历史：支持按用户选择消息自动保存记忆、自动保存计划、WorldBook 搜索/刷新、上下文限制器、历史窗口分页与消息定位预览 • 开发与自动化增强：增强浏览器 iframe 快照/点击、GitHub 通知管理、QQ Bot 示例、文件选择 API、Java Bridge 测试、远程/Windows 设置页与桌面小组件
v1.10.1	2026-04-17	• 内置浏览器与网页自动化：大幅增强内置浏览器，支持标签页、历史、书签、权限、多窗口、最小化与视口控制，并补齐浏览器脚本的导入、安装、启停、存储与页面菜单能力 • 虚拟形象与界面定制：支持 FBX 虚拟形象并升级 MMD 预览，新增液态玻璃主题效果，并增强侧边栏、聊天气泡与输入栏的外观自定义 • 插件、工作区与上下文增强：支持通过配置编辑器调试和自动编写 Operit 插件，新增本地 HTTP 对话入口、工作区重命名与规则文件自动读取，并增强历史跳转、双向分页与上下文自动补充能力 • 稳定性与性能优化：修复工具权限、HTTP TTS、SSH/tmux 长输出、历史跳转、GIF/公式/Markdown 渲染、MCP 配置与统计等问题，并持续优化对话链路、深度搜索、记忆系统、浏览器与包管理器
v1.10.0	2026-03-18	• 角色卡群聊与 AI 自配置：支持多个角色卡群聊与 @ 交互，新增 AI 自我设置能力，可辅助配置 MCP、Skill、STT、TTS 与模型参数 • 主题与交互升级：新增分组折叠消息、气泡主题及字体/颜色/背景自定义、更宽气泡、输入框液态玻璃、长按图标直达设置/语音模式，以及助手形象与 MP4 虚拟形象支持 • 工具与平台扩展：新增 Ollama、NVIDIA、OpenAI Response 通用模式，补充独立 SSH 插件工具包、Java Bridge、APKTool 插件、Web 自动化下载、Markdown 音视频渲染、xAI 视频生成、工作流取消、终端自定义按键与消息队列 • 修复与性能优化：修复语音识别、记忆并发、悬浮窗交互、终端显示、Web 自动化全屏、MNN Tool Call 等问题，并优化记忆召回、市场搜索、工作区模板、grep 工具性能与 Agent 重试稳定性
v1.9.1	2026-02-20	• 稳定性修复：集中修复 1.9.0 多项问题，提升整体可用性与流畅性 • 终端与工具调用：增强终端工具，修复交互 UI 卡住、严格工具调用历史工具报错、Windows 控制器 raw 命令执行问题 • MCP 与记忆库：修复远程 MCP 无法关闭，重做记忆库写入逻辑，支持外接向量模型并新增连接修改工具 • 功能补充与界面修复：新增未绑定角色卡聊天记录删除、工作流批量删除与执行日志查看，修复输入法/暗色输入框/主题透明度/工具箱包管理等问题
v1.9.0	2026-02-17	• 移动端网页自动操作：新增网页操作能力，支持工作区 Web 项目 CORS 绕过访问外部网页 • Windows 终端操作：支持 Windows 命令操作，可控制 Codex 等 CLI，新增严格工具调用模式补充兼容性 • 工具与系统扩展：新增 SQL 查看器、Android 工作区模板、OpenAI response 兼容供应商、skill 直接输入添加、统计饼图 • 修复与优化：修复图片读取/上下文总结/特殊符号截断/ffmpeg 等问题，增强模型连通性测试输出与 MCP 加载提示
v1.8.1	2026-02-03	• llama.cpp 本地推理：支持 GGUF 本地模型与相关工具 • 工具与界面：图片搜索/下载、HTML 块预览、代码/思考块高度限制、气泡头像隐藏、Token 饼图、思考链折叠 • 数据与备份：全局备份（排除 MCP/skill/终端/包）+ 角色卡备份/导出/分享、Skill 开关、密钥池导入/批量测试、工作区支持 SAF 绑定 • 修复：AI 朗读回声录制、悬浮窗 Token 统计、角色编辑键盘遮挡、深搜 Token 爆炸、MCP 启动、工作流悬浮窗退出、表格截断、硅基流动语音打断
v1.8.0	2026-01-13	• 工作流系统：支持计算/传入传出/执行等能力，并支持语音唤醒触发 • 语音唤醒：直接进入语音对话模式，支持语音下关键词快速附件附着 • 对话并行：支持对话并行处理，工具包 state 机制可动态决定工具 • 新增与优化：记忆时间查询、自动备份、OpenAI 绘图/语音供应商、MCP 启动优化、终端 chroot、修复多项 BUG
v1.7.1	2025-12-31	• Root 虚拟屏幕自动化：支持 root 启动虚拟屏幕，AutoGLM 并发多窗口任务 • Skill 生态：新增 Skill 协议与 Skill 市场，并支持 BETA 计划追踪 nightly • 交互增强：总结编辑、网页访问改悬浮窗模式、圈选识屏、对话锁定 • 修复与优化：大图崩溃、ToolCall 错误、代码块换行、启动速度与虚拟屏稳定性
v1.7.0	2025-12-19	• GUI 自动化里程碑：Autoglm + 虚拟屏幕（可在设置中开关虚拟屏幕） • 自动化增强：一键 Autoglm 配置与单独执行器，虚拟屏开关逻辑与截图质量自定义 • 体验优化：密钥非聚焦显示为星号，强制不允许 Autoglm 设置为主模型 • 工具扩展：NanoBanana 绘图包、apply file 非覆盖支持、MNN STT 等
v1.6.3	2025-12-08	• 原生ToolCall支持：支持原生模型工具调用、DeepSeek思考工具 • 工作区与终端增强：新建时选择项目类型、SSH文件系统连接、终端无障碍支持 • 模型与消息显示：支持模型配置多选、消息显示模型名称与提供者 • 优化与修复：优化悬浮窗、修复终端卡顿、迁移工作区到内部存储
v1.6.2	2025-11-20	• 对话管理增强：长按开分支、历史记录分类显示、批量迁移 • 模型配置优化：配置重命名、上下文绑定、谷歌原生搜索 • Bug修复：界面切换、粗体换行、气泡模式等问题 • 增加crossref学术论文检索包、升级代码编辑器
v1.6.1	2025-11-05	• 性能大优化：重做UI绘制，大幅提升流畅性 • AI视觉增强：直接识别图片、间接识别能力 • 终端SSH：支持SSH连接和反向挂载手机文件系统 • 自动总结机制、深度搜索、新授权系统
v1.6.0	2025-10-21	• MNN本地模型支持 • 记忆库大更新：AI自动分类、智能搜索、导入导出 • 终端优化：vim支持、进度条、自定义软件源 • Tasker集成、桌宠功能、故事线标签
v1.5.2	2025-10-05	• MCP增强：uvx/npx支持、启动加速 • 工作区 Git ignore • 相机拍照、HTML渲染、正则过滤
v1.5.0	2025-09	• Ubuntu 24终端完整集成 • MCP市场上线 • 桌宠功能、深度搜索模式
v1.4.0	2025-08	• 多工具并行执行 • 人设卡系统、角色选择器 • PNG角色卡导入
v1.3.0	2025-08	• Web开发功能 • 主题选择器、自定义UI • Anthropic Claude支持
v1.2.x	2025-07	• 语音对话系统 • 知识库功能 • DragonBones动画支持
v1.1.x	2025-06	• MCP协议支持 • OCR识别、悬浮窗 • Gemini完整支持
v1.0.0	2025-05	• 首个正式版本 • 基础AI对话、工具调用 • Shizuku/Root集成

📝 完整更新日志：访问 Releases 页面 查看每个版本的详细更新内容

---

👨‍💻 开源共创

欢迎加入 Operit 开源生态！我们欢迎各种贡献：第三方脚本、MCP插件、核心功能开发。

开发者须知：

• 📚 开源共创指南 | 脚本开发指南
• 📦 构建项目需从 Google Drive 下载依赖库压缩包（models.zip、subpack.zip、jniLibs.zip、libs.zip）
• 💬 加入社区讨论：QQ群 | Discord

💖 贡献者

感谢所有为 Operit AI 做出贡献的人！

💖 支持开发

如果 Operit AI 对您有帮助，欢迎自愿支持项目持续开发与基础运营：

• 海外支持可使用 Patreon

• 境内支持可使用 爱发电

• 赞助完全自愿，不与任何功能、额度、更新、答疑或其他权益挂钩

• 即使不赞助，也不影响正常使用、获取更新或访问开源代码

• 您也可以直接使用 GitHub 仓库顶部的 Sponsor 按钮进入赞助页面

---

📄 许可证

本项目采用 GNU LGPLv3 许可证。

简单来说，这意味着：

• 您可以自由地使用、修改和分发本项目的代码。
• 如果您修改了代码并进行分发，您也必须以 LGPLv3 许可证开源您修改过的部分。
• 详细信息请参阅 LICENSE 文件。

---

📝 问题反馈

遇到问题或有建议？欢迎 提交 Issue！

提交指南：

• 📝 清晰描述问题/建议，提供复现步骤
• 📱 附上设备型号、系统版本等信息
• 📸 如有可能，提供截图或录屏

---