Operit AI：Android AI Agent 平台

项目简介

Operit AI 是一个面向 Android 的开源 AI Agent 平台，支持云端模型与本地模型，并将模型与 Android 系统能力、终端、浏览器、文件、项目工作区连接起来，通过工具调用、工作流以及 ToolPkg、MCP、Skills 等扩展，完成信息检索、文件处理、代码开发、设备自动化等真实任务。

项目使用 Kotlin 编写，主页为 operit.app。

主要功能

AI 对话与模型

• 在对话上下文中加入图片、音频、视频、文档和工作区文件
• 支持消息分支、聊天记录分组与迁移、自动摘要、上下文限制、并行对话
• 可连接 OpenAI Chat/Responses、Anthropic、Gemini 及大量兼容服务，另有通过 ToolPkg 提供的模型提供商
• 管理多套模型配置、参数、密钥池与连接测试；可为对话、记忆、摘要、UI 控制等任务分别指定模型
• 通过内置 MNN 做本地推理，或用 llama.cpp 运行 GGUF 模型；也可连接 Ollama、LM Studio 等本地模型服务

工具、设备自动化与浏览器 Agent

• 内置文件、网络、搜索、媒体、系统操作、软件管理与开发类工具
• 每个工具可选择「自动允许」「每次询问」「拒绝」，默认每次询问
• 通过无障碍、Shizuku 提供的 ADB 级调试权限或 Root 实现 Android 界面自动化
• 内置浏览器支持标签页、历史、书签、下载、权限、多窗口与用户脚本；浏览器 Agent 可解析页面结构、点击、输入、滚动、发送按键与截图
• 提供 OCR、图像理解、摄像头、FFmpeg、网页访问与文件传输工具

项目工作区与终端

• 从 Web、Android、Flutter、Node.js、TypeScript、Python、Java、Go 等模板创建项目
• 文件树、代码编辑器、语法高亮、实时预览、变更追踪、备份与导出
• 可将工作区绑定到对话，让 AI 读取项目规则、引用文件并修改代码
• 可将应用内部目录、SAF、SFTP、SSH 文件系统作为工作区
• 默认通过 PRoot 运行 Ubuntu 24.04 ARM64 用户空间，受支持的设备上可用 chroot
• 多终端会话，支持 Python、Node.js、vim、SSH、tmux、自定义按键与自定义软件源
• 集成 Logcat、SQLite、Git、APKTool、HTML 打包等开发工具

记忆、角色与聊天管理

• 多记忆空间、文档导入与分块、可编辑节点关系、混合检索
• 从对话与附件中抽取信息，结合时间、语义与关系检索做长期记忆
• 角色卡导入导出、备份与二维码分享，支持 Tavern JSON/PNG 格式
• 为每个角色绑定单独的模型、记忆空间、工具包、Skills 与 MCP 服务
• 多角色群聊，支持提及、独立历史与角色协作

扩展市场与工作流

• 在统一市场中搜索、安装和管理脚本、ToolPkg、Skills 与 MCP 服务
• 通过 ToolPkg 扩展工具、界面、模型提供商、Hook 与运行时行为
• 运行本地或远程 MCP 服务，支持 uvx、npx 等启动方式
• 用触发器、执行、条件、逻辑与数据提取节点搭建可视化工作流
• 可手动、定时、通过 Tasker、Intent、语音或应用启动触发工作流

语音、虚拟形象与界面

• 本地中英文语音识别，或 OpenAI、Deepgram 等云端 STT 接口
• 支持 Android 系统 TTS、本地 ONNX VITS、自定义 HTTP 服务及多种云端 TTS
• 连续语音对话、后台唤醒、自定义唤醒模板、自动朗读与音乐队列
• 可通过悬浮窗、聊天气泡、桌面小组件或 Android 默认助手入口打开
• 支持 DragonBones、WebP、MP4、MMD、glTF/GLB、FBX 格式的虚拟形象
• 可自定义主题、字体、聊天气泡、背景、工具栏、Markdown 渲染与布局
• 支持中文、英文、韩文、西班牙文、马来文、印尼文、巴西葡萄牙文、罗马尼亚文，也可跟随系统语言

安装与使用

项目	说明
系统要求	Android 8.0（API 26）或更高，仅支持 ARM64（arm64-v8a）设备
资源占用	内存与存储占用取决于终端环境、已安装工具包和本地模型，请按各模型文档预留空间
下载	从 Releases 页面 获取最新 APK
使用文档	访问 Operit 官网 查看教程与示例

安装流程：下载 APK → 安装并启动 → 按引导配置模型与权限 → 开始使用。

注意事项

• 仅从官方 Releases 页面 或 Operit 官网 下载安装包，来源不明的包可能被修改，存在数据或设备风险。
• 局域网 Web Chat 与 HTTP API 默认关闭，如需启用手动开启，并配置 bearer token、评估局域网暴露风险。
• 部分能力（如虚拟显示）需要相应权限与设备支持。
• 本仓库为 Operit 的 Android 版本；跨平台的第二代实现 Operit 2 见 AAswordman/Operit2。

---

本作品整理自 GitHub 开源项目 AAswordman/Operit，原作者 @AAswordman，许可证 LGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。