本仓库是 Operit 的 Android 版。Operit 2 是独立的第二代实现，以 Rust 共享运行时、Flutter 客户端和 operit2 CLI/TUI 为核心，目前包含 Android、iOS、Windows、macOS、Linux 与 Web 的实现或构建路径，并持续推进 OpenHarmony 适配。想关注跨平台版本，请访问 Operit 2。
Operit AI 是一个运行在 Android 上的开源 AI Agent 平台，支持接入云端或本地模型，并将模型与 Android 系统、终端、浏览器、文件和项目工作区连接起来，通过工具调用、工作流以及 ToolPkg、MCP、Skill 等扩展能力，完成信息检索、文件处理、代码开发和设备自动化等实际任务。
- 面向任务的 Agent 工作台：支持附件、工作区上下文、工具执行过程、文件变更和多轮任务管理
- 自主选择模型与服务：连接主流云模型、自定义兼容端点和密钥池，也可使用 MNN 模型或通过 llama.cpp 运行 GGUF 模型
- 深度集成 Android 与网页环境：在授权后调用系统能力、操作应用界面，或通过内置浏览器读取和操作网页
- 移动开发与终端环境：在手机上管理项目、编辑代码、预览网页，并使用 Ubuntu 24.04 用户空间、SSH 和 SFTP
- 长期记忆与角色体系：管理图谱化记忆、对话历史、角色卡和多角色对话，并为不同角色绑定独立能力
- 可组合的扩展与自动化：通过统一市场、工作流和系统集成组合工具，构建可重复执行的任务流程
AI 对话与模型
- 对话支持图片、音频、视频、文档、工作区文件等上下文
- 支持消息分支、历史分组与迁移、自动总结、上下文限制和并行对话
- 支持 OpenAI Chat/Responses、Anthropic、Gemini 及多种兼容服务，并可通过 ToolPkg 扩展模型提供方
- 支持多套模型配置、参数设置、密钥池和连接测试
- 可分别为聊天、记忆、总结、UI 控制等任务指定模型
- 内置 MNN 本地推理，并支持通过 llama.cpp 运行 GGUF 模型
- 可连接 Ollama、LM Studio 等本地模型服务
工具、设备与浏览器自动化
- 内置文件、网络、搜索、媒体、系统、软件管理和开发工具
- 提供自动允许、每次询问和禁止三档工具权限设置，默认采用询问模式
- UI 自动化支持无障碍、Shizuku 提供的 ADB 级调试权限和 Root 通道
- PhoneAgent/AutoGLM 可结合屏幕视觉执行操作，虚拟显示等能力需要相应权限和设备支持
- 内置浏览器提供多标签、历史、书签、下载、权限、多窗口和用户脚本
- 浏览器 Agent 可读取页面结构并执行点击、输入、滚动、按键和截图等操作
- 支持 OCR、图像理解、相机、FFmpeg、网页访问和文件传输
项目工作区与终端
- 支持 Web、Android、Flutter、Node.js、TypeScript、Python、Java、Go 等项目模板
- 提供文件树、代码编辑、语法高亮、实时预览、变更追踪、备份和导出
- 聊天可以绑定工作区，让 AI 读取项目规则、引用文件并修改代码
- 工作区支持应用内部目录、SAF、SFTP 和 SSH 文件系统
- 内置 Ubuntu 24.04 ARM64 用户空间，默认通过 PRoot 运行，在具备相应条件时也可使用 chroot
- 终端支持多会话、Python、Node.js、vim、SSH、tmux、自定义按键和软件源
- 提供 Logcat、SQLite、Git、APKTool、HTML 打包等开发工具
记忆、角色与对话管理
- 支持多个记忆空间、文档导入与分块、节点关系编辑和混合搜索
- 可从对话和附件中提取信息，并按时间、语义及关系检索长期记忆
- 支持角色卡导入、导出、备份和二维码分享，兼容 Tavern JSON/PNG 等格式
- 每个角色可绑定独立模型、记忆空间、工具包、Skill 和 MCP
- 支持多角色群聊、@ 交互、独立对话历史和角色间协作
- 支持聊天记录导入导出、锁定、分支、批量迁移、备份与恢复
扩展市场与工作流
- 统一市场支持脚本、ToolPkg、Skill 和 MCP 的搜索、安装与管理
- 另有提示词与标签市场，以及项目和 Artifact 的管理与发布流程
- ToolPkg 可提供工具、界面、模型提供方、Hook 和运行时能力
- MCP 支持本地与远程服务，以及 uvx、npx 等启动方式
- 可视化工作流包含触发、执行、条件、逻辑、数据提取等节点
- 工作流支持手动、定时、Tasker、Intent、语音和应用启动等触发方式
- 提供工作流执行日志、统计、取消和批量管理
语音、形象与界面
- STT 支持本地中英文识别以及 OpenAI、Deepgram 等云端接口
- TTS 支持 Android 系统、本地 ONNX VITS、自定义 HTTP 和多种云服务
- 支持连续语音对话、后台唤醒、自定义唤醒模板、自动朗读和音乐播放队列
- 可通过悬浮窗、气泡、桌面组件和 Android 默认助理入口调用 Operit
- 虚拟形象支持 DragonBones、WebP、MP4、MMD、glTF/GLB 和 FBX 等格式
- 支持主题、字体、聊天气泡、背景、工具栏、Markdown 渲染和布局定制
- 界面支持中文、英语、韩语、西班牙语、马来语、印尼语、巴西葡萄牙语和罗马尼亚语，可跟随系统或手动切换
- 可选的局域网 Web Chat 和 HTTP API 默认关闭，启用时需要配置 Bearer Token 并评估局域网暴露风险
| 项目 | 说明 |
|---|---|
| 系统要求 | Android 8.0（API 26）或更高版本，仅支持 ARM64（arm64-v8a）设备 |
| 资源需求 | 内存和存储占用取决于终端环境、已安装工具包及本地模型；下载模型前请按模型说明预留空间 |
| 下载安装 | 从 Releases 页面 下载最新 APK |
| 使用指南 | 访问 Operit 官方网站 查看教程和示例 |
安全提示： 请仅从官方 Releases 页面 或 Operit 官方网站 下载安装包。未知渠道的安装包可能被修改，造成数据和设备安全风险。
安装流程：下载 APK → 安装并启动 → 按引导配置模型与权限 → 开始使用
数据与网络边界： 聊天、角色、记忆和模型配置由应用保存在本地；使用云模型时，请求从设备发送到您配置的服务商，Operit 不托管聊天推理。市场、MCP、Skill、语音和绘图等功能可能连接第三方服务；Web Chat/HTTP API 默认关闭，启用前请确认网络暴露与 Bearer Token 设置，Android Intent/广播集成也只应交给受信应用。
- 2025 年 4 月至 8 月 · 从 AI 对话到工具执行：逐步加入工具调用、MCP、语音、悬浮窗、Web 开发和角色卡
- 2025 年 9 月至 12 月 · 深入设备与开发环境：完成 Ubuntu 终端、记忆系统、MNN、SSH 工作区、GUI 自动化和 Skill 生态
- 2026 年至今 · 形成移动 Agent 平台：扩展工作流、GGUF 本地推理、浏览器 Agent、角色群聊、Web Chat、ToolPkg 和统一市场
查看主要版本更新摘要
- v1.12.0 · 2026-07-01：统一市场与 Artifact 流程，增强项目工作区和 ToolPkg 运行时，扩展多语言、语音与媒体能力，并提升崩溃恢复能力
- v1.11.0 · 2026-05-16：加入 Web Chat、Artifact 市场、ToolPkg AI Provider 与 Hook，并增强记忆、上下文和浏览器自动化
- v1.10.1 · 2026-04-17：升级内置浏览器与网页自动化，加入 FBX 形象、液态玻璃主题和本地 HTTP 对话入口
- v1.10.0 · 2026-03-18：加入角色群聊、AI 自配置、Ollama/NVIDIA/OpenAI Responses 模式和更多开发工具
- v1.9.1 · 2026-02-20：集中修复终端、严格工具调用、远程 MCP、记忆库和工作流问题
- v1.9.0 · 2026-02-17：加入移动网页自动操作、Windows 终端控制、SQLite 查看器和 Android 工作区模板
- v1.8.1 · 2026-02-03：加入 llama.cpp GGUF 本地推理，并增强界面、备份、Skill 和工作区能力
- v1.8.0 · 2026-01-13：推出工作流、语音唤醒触发、并行对话和自动备份
- v1.7.1 · 2025-12-31：加入 Root 虚拟显示、Skill 协议与市场、圈选识屏和对话锁定
- v1.7.0 · 2025-12-19：推出 AutoGLM GUI 自动化和虚拟显示
- v1.6.4 · 2025-12-12：接入 AutoGLM，优化自动化状态展示、工具包环境变量和调试日志
- v1.6.3 · 2025-12-07：支持原生 Tool Call、多模型配置、SSH 文件系统和工作区项目模板
- v1.6.2 · 2025-11-22：增强对话分支与迁移、上下文绑定和学术检索
- v1.6.1 · 2025-11-16：重构 UI 渲染，加入视觉理解、SSH 终端、自动总结和深度搜索
- v1.6.0 · 2025-10-21：加入 MNN 本地模型、智能记忆库、Tasker 集成和桌宠
- v1.5.2 · 2025-10-05：增强 MCP、工作区
.gitignore支持、相机、HTML 渲染和正则过滤 - v1.5.1 · 2025-09-25：加入 MCP 市场、密钥池、对话重发时的工作区回档和记忆库手动刷新
- v1.5.0 · 2025-09-20：集成 Ubuntu 24.04 终端和深度搜索模式
- v1.4.0 · 2025-09-01：加入多工具并行、角色卡系统和 PNG 角色卡导入
- v1.3.0 · 2025-08-04：加入 Web 开发、主题选择器和 Anthropic Claude
- v1.2.x · 2025-07：加入语音对话、知识库和 DragonBones 动画
- v1.1.x · 2025-05 至 06：加入 MCP、OCR、悬浮窗和 Gemini 支持
- v1.0.0 · 2025-04-11：发布基础 AI 对话、工具调用及 Shizuku/Root 集成
完整更新内容请查看 Releases 页面。
欢迎参与 Operit 的脚本、扩展、文档和核心功能开发。
- 贡献指南
- 构建指南
- 脚本开发指南
- ToolPkg 格式指南
- 构建项目需准备
subpack.zip、jniLibs.zip和libs.zip三份外部依赖归档，并初始化terminal子模块；默认本地 STT 模型会按照app/config/stt-model-assets.properties自动获取并校验 - 社区讨论：QQ群 | Discord
如果 Operit 对您有帮助，可以自愿支持项目持续开发与基础运营：
仓库主体代码采用 GNU LGPL v3（LGPL-3.0-only）。仓库中的工具、示例、模板和第三方依赖可能采用其他许可证，具体条款以 LICENSE、对应目录中的许可证文件和包元数据为准。
Made with ❤️ by the Operit Team