## File: README.md

Operit AI

## 🚀 Operit 2：Operit 的跨平台后续版本 本仓库是 Operit 的 Android 版。Operit 2 是独立的第二代实现，以 Rust 共享运行时、Flutter 客户端和 `operit2` CLI/TUI 为核心，目前包含 Android、iOS、Windows、macOS、Linux 与 Web 的实现或构建路径，并持续推进 OpenHarmony 适配。想关注跨平台版本，请访问 [Operit 2](https://github.com/AAswordman/Operit2)。 ## 项目简介 **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 页面](https://github.com/AAswordman/Operit/releases) 下载最新 APK | | **使用指南** | 访问 [Operit 官方网站](https://operit.app/) 查看教程和示例 | > **安全提示：** 请仅从官方 [Releases 页面](https://github.com/AAswordman/Operit/releases) 或 [Operit 官方网站](https://operit.app/) 下载安装包。未知渠道的安装包可能被修改，造成数据和设备安全风险。 安装流程：下载 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 页面](https://github.com/AAswordman/Operit/releases)。 ## 开源共创 欢迎参与 Operit 的脚本、扩展、文档和核心功能开发。 - [贡献指南](docs/doc-src/dev-core/CONTRIBUTING.md) - [构建指南](docs/doc-src/dev-core/BUILDING.md) - [脚本开发指南](docs/SCRIPT_DEV_GUIDE.md) - [ToolPkg 格式指南](docs/TOOLPKG_FORMAT_GUIDE.md) - 构建项目需准备 `subpack.zip`、`jniLibs.zip` 和 `libs.zip` 三份外部依赖归档，并初始化 `terminal` 子模块；默认本地 STT 模型会按照 `app/config/stt-model-assets.properties` 自动获取并校验 - 社区讨论：[QQ群](https://qm.qq.com/q/Sa4fKEH7sO) | [Discord](https://discord.gg/YnV9MWurRF) ### 贡献者 ## 支持开发 如果 Operit 对您有帮助，可以自愿支持项目持续开发与基础运营： - 海外支持：[Patreon](https://www.patreon.com/c/aaswordsman) - 境内支持：[爱发电](https://afdian.com/a/aaswordsman) - 赞助完全自愿，不与任何功能、额度、更新、答疑或其他权益挂钩 - 不赞助不会影响正常使用、获取更新或访问开源代码 ## 许可证 仓库主体代码采用 [GNU LGPL v3（LGPL-3.0-only）](https://spdx.org/licenses/LGPL-3.0-only.html)。仓库中的工具、示例、模板和第三方依赖可能采用其他许可证，具体条款以 [LICENSE](LICENSE)、对应目录中的许可证文件和包元数据为准。 ## Star History --- --- ## File: docs/README.md - `.META`: 元数据，目前用来当垃圾箱 - `assets`: 文档使用的图片等资源文件 - `doc-src`: 长期维护的文档单一事实源 - `TODO`: 这是留给开发者协作用的，[好的计划是协作成功的80%](TODO/README.md)