README

Operit AI



  中文 | English
  
  
  
  
  
  
  
  



  
  
  
  
  



  


 🚀 Operit 2：Operit 的跨平台后续版本

本仓库是 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 不托管聊

Top issues

Discussions

Latest release

本次更新重点围绕模型兼容性、工具调用、聊天稳定性和数据管理展开，同时补充 ToolPkg、统计、恢复与性能监控能力。

 增加

- 新增 Token 用量账本、统计看板、活动视图、价格覆盖、缓存命中率、生成速度和安全删除能力
- 新增独立 TTS/STT 服务档案，支持创建、复制、切换、删除和旧配置迁移
- 新增按窗口或指定日期范围重建聊天记忆
- Compose DSL 文件选择器新增文档、图片、视频、媒体、目录和相机模式
- 新增 AiChat、AdaptiveSidePanel、Compose DSL 对话框和聊天消息长按菜单
- 新增 DeepSeek Harness 运行时侧栏和完整 ToolPkg 运行时支持
- 新增 MiniMax、OpenCode Zen/Go、xAI Grok 和 OpenAI Codex OAuth 提供商，并支持 Codex 配额查询和 PDF 输入
- 新增按提供商和模型动态配置思考深度，补充 DeepSeek Responses、Qwen、Gemini 等端点规则
- 新增 DeepSeek Responses Web Search、服务端工具记录和 reasoning 回放
- ToolPkg 新增版本化 API、包依赖、加载顺序、运行态 Hook、消息持久化 Hook 和聊天消息菜单
- 新增数据库、DataStore 配置健康检查