Operit AI 是移动端首个功能完备的 AI 智能助手应用，它完全独立运行（除了外部api调用）于您的 Android 设备上，拥有强大的工具调用能力。它不仅仅是一个聊天界面，更是一个和安卓权限和各种工具深度融合的全能助手。
通过 Operit AI，您可以文字对话完成以往需要多次点击才能实现的复杂任务。它可以帮您管理文件、搜索网页、自动操作屏幕，甚至执行系统级命令。这是真正意义上的移动端 AI 助手革命，将您的手机变成一个智能、自动化的工作平台。
软件同时具备低门槛和高上限：你可以开局后上手直接使用，也可以研究如何获取更高的权限来获取更高的体验感受（TODO v1.2.0下个版本）
作为第一款支持 Model Context Protocol 的 移动应用，提供 完整的 MCP 服务一键部署、启动和监控功能。考虑到mcp生态的复杂性，我们同时开发了一套更适合安卓体质的包管理和原生工具插件系统。
我们同样拥有向量索引的持久化数据库，专注于解决问题能力的积累，也拥有增强上下文记忆能力，实现更精细的任务处理。同时还有可以自动修正的根据用户偏好系统。
与其同时，高度的自由度使得用户可以自行查看、修改、配置问题库、偏好配置，甚至可以建立多个提示词和多个配置来达成用户想要的高度自定义场合和问答。
我们对权限进行了很好的兼容，用户可以根据自己情况选择多个不同层级的权限，从apk集成能力到shizuku，再到root。（TODO v1.2.0下个版本）同时，对于工具的执行，我们还有另外一套权限控制，正如其他电脑端agent的那样。
考虑到我们的工具比较强大，我们单独推出了一套工具箱可以快速进行工具操作。
- Android 8.0+ (API 级别 26+)
- 内存 4GB+（推荐 6GB 以上）
- 存储空间 200MB+
- 从 Release 页面下载最新构建的 APK
- 根据需要配置用户偏好和工具权限
- 可选：安装 Termux 应用以启用 MCP 功能
- 可选：搭建 Shizuku 环境以启用高级特权功能
欢迎加入 Operit 开源生态！我们欢迎两种类型的贡献者：
如果你希望为 Operit AI 开发第三方脚本和拓展包，我们已经为你准备好了开发环境：
- 项目的
.vscode文件夹已配置好相关开发设置 - 已预先配置好
package.json和tsconfig.json - 提供了
index.d.ts类型定义文件，方便开发时获得类型提示
快速开始开发脚本：
- 确保你的电脑上安装了 VSCode 和 ADB 环境
- 克隆本仓库
- 使用 VSCode 打开项目
- 通过 ADB 连接你的 Android 设备
- 在设备上打开 Operit AI 应用
- 运行并调试你的 TypeScript 脚本，它将直接在手机上执行
可以参考 examples 目录下的 tester 示例了解如何开发脚本。我们计划将脚本开发框架单独拉出一个仓库，专门用于快速开始脚本开发。
Operit AI 现已支持 MCP (Model Context Protocol) 插件系统，你可以开发自己的 MCP 插件：
- 使用 TypeScript 创建你的 MCP 插件项目
- 在 Operit AI 中导入你的插件仓库或直接上传 zip 文件
- 自定义部署参数和环境变量
- 一键部署并启动你的 MCP 服务
MCP 插件可以大幅扩展 AI 助手的能力，例如添加网页浏览、图像处理、数据分析等功能。
想参与 Operit AI 本体开发？很简单，提个 PR 就行了！（不是，其实还有点别的）
项目结构也很简单（乱七八糟）：
app/src/main/java/com/ai/assistance/operit/- 主要代码都在这core/- 核心功能（工具、配置什么的都在这）data/- 数据层（DB啊，Bean啊）ui/- 界面相关（好看的 UI 都在这）services/- 各种服务（后台运行的那些）util/- 工具类（各种骚操作都在这）api/- API接口（和外部世界交流的地方）
关于代码风格，嗯...怎么说呢...（尴尬笑）
- commit 信息非常"创意丰富"
（完全不规范） - 注释语言混搭风，中英文随心切换
（想到啥写啥） - 代码风格多元化
（各写各的）
如果你是代码洁癖，可能需要做一下心理准备（或者直接帮我们重构？）。但好处是提交代码超简单，改好了提交 PR 就行，没那么多条条框框！
我们相信代码是写给人看的，只是偶尔让计算机执行一下。（所以...能跑就行？）
我们期待您的贡献，无论是提交 Issue、PR，还是参与讨论。请遵循项目的贡献指南（其实也没啥指南），共同打造更智能的 AI 助手。
关于项目维护: 由于时间和精力有限，项目的活跃度和更新频率将很大程度上取决于社区的关注和参与。如果你觉得这个项目有价值，你的每一份贡献都会让它变得更好。无论是代码贡献、问题反馈还是使用推广，都能帮助项目持续发展。没有社区，就没有开源的未来。
- 项目主页：[Github Repository]
- 问题反馈：[Issue Tracker]
- 开发者社区：[Slack Channel]
特别说明： 任何基于本项目的衍生作品也必须开源并采用相同许可证，从而使社区可以审查代码，确保没有恶意行为，为用户提供更高的安全保障。
请查看 LICENSE 文件了解当前的版权详情。
以下是我们正在计划的功能：
- 加入tts和语音识别模型。同时进一步实现对话系统。
- 实现更友好的交互界面。
- issue里面有很多不错的建议，把他们全部解决。
- 推广！推广！推广！
- 兼容更多的api
- 支持多语言
计划在V1.2.0，把目前的全部问题，全部解决！ 这包括了shizuku的授权问题，和外置termux引发的问题。
如果你发现了其他 bug，欢迎提交 issue 告诉我们！我们会尽快修复...除非我们太忙或者太懒或者实在改不动（开个玩笑，我们真的会尽力的）。