Zorv AI

运行在 Android 上的设备端 AI Agent · 智能体助手

On-device AI Agent for Android — tools, personas, memory, and a shared runtime, all on your phone.

包名：com.ai.assistance.quro ｜ 技术栈：Kotlin + Jetpack Compose ｜ compileSdk 36 / minSdk 26 / targetSdk 34

Zorv AI 把「对话助手」做成一个真正能操作手机的 Agent：它在设备上运行，能用无障碍 / Shizuku / ROOT 等通道操控系统，调用内置工具，运行 Node / Python / SSH / Java / Rust / Go 共享运行时，并通过飞书、QQ、微信与你保持在线。

🌐 开源地址 · Open Source

本项目完全开源，双平台托管 · GitHub：github.com/Quor-a/ZorvAI ｜ Gitee：gitee.com/ZorvAI/ZorvAI

🔌 受控端浏览器（ZorvAI 浏览器）已独立开源 · GitHub：github.com/Quor-a/ZorvBrowser ｜ Gitee：gitee.com/ZorvAI/ZorvBrowser（独立仓库，含 v1.0.12 源码与 APK）

• 📦 最新 Release（免登录下载）：github.com/Quor-a/ZorvAI/releases
• 🔗 主程序 APK 直链（v1.0.6）：ZorvAI-debug-v1.0.6.apk
• 🔗 主程序 APK（v1.0.12）：ZorvAI-debug-v1.0.12.apk
• 🔗 受控端浏览器 APK（ZorvAI 浏览器 v1.0.12 · 独立仓）：ZorvBrowser-aci-debug-v1.0.12.apk
• 🧩 ACI 核心库 AAR：aci-core-release.aar
• 📖 ACI 开发者手册：docs/ACI_DEVELOPER_GUIDE.md
• 🐛 问题反馈：github.com/Quor-a/ZorvAI/issues

关键词：Zorv AI 开源 / 安卓 AI 助手 开源 / Android AI agent open source / 本地 AI 智能体 / 设备端 AI Agent / Kotlin Compose LLM 助手 / ACI 跨应用调用

✨ Features · 功能亮点

🏗️ Functional Architecture · 功能构架

flowchart TB
    subgraph UI["UI 层 · Jetpack Compose"]
        direction TB
        A1["ChatScreen 对话框"]
        A2["PersonaBar 人格卡"]
        A3["PermissionModeBar · 权限胶囊"]
        A4["Markdown / 代码块渲染 · 全屏预览"]
    end
    subgraph CORE["Agent 核心 · QuroChatViewModel"]
        B1["多会话隔离 liveBuffers"]
        B2["种子快照 convBase"]
        B3["显示刷新闸门 canUpdateDisplay"]
        B4["工具注册表 QuroToolRegistry"]
        B5["技能系统 skill__{name}"]
    end
    subgraph TOOLS["工具 / 能力层 · core/tools"]
        C1["launch_app"]
        C2["无障碍 input_text / tap_screen / read_screen"]
        C3["cms_* 模块调用"]
        C4["cms_engine_status"]
        C5["Agent 键盘 ai_type_text / press_enter / press_send"]
        C6["scheduler 定时任务"]
        C7["memory_* 记忆工具"]
    end
    subgraph PRIV["特权 / 权限层 · L1–L5"]
        D1["L1 无障碍 AccessibilityService"]
        D2["L2 Shizuku uid 0/2000"]
        D3["L3 设备管理员 DeviceAdmin"]
        D4["L4 ROOT su"]
        D5["L5 应用内 Linux proot + Alpine"]
    end
    subgraph ENGINE["引擎 / 运行时层"]
        E1["CMS 引擎 共享运行时 NODE / PYTHON / SSH / JAVA / RUST / GO"]
        E2["CMS v2 模块 QuroCmsRepository"]
        E3["GeckoView 浏览器 MPL-2.0"]
        E4["本地语音 sherpa-onnx STT / TTS"]
    end
    subgraph IM["IM 通道层 · 手机端均无公网端点"]
        F1["飞书 WebSocket"]
        F2["QQBot 官方 WS"]
        F3["微信 iLink HTTP 长轮询 35s"]
    end
    subgraph DATA["数据 / 持久化"]
        G1["QuroConversationStore 磁盘会话仓库"]
        G2["启动自愈 DATA_REPAIR 去重"]
        G3["诊断日志 Download/QuroAI_logs/"]
    end

    UI --> CORE
    CORE --> TOOLS
    TOOLS --> PRIV
    TOOLS --> ENGINE
    PRIV --> ENGINE
    CORE --> IM
    CORE --> DATA

⚙️ Engine · 引擎详解

CMS 引擎（系统资源包）

CMS 引擎是一套共享运行时供给机制，按需在设备上提供 NODE / PYTHON / SSH / JAVA / RUST / GO 等环境（DepKind.ENV + CmsEnvProvisioner 按需供给）。你可以用 cms_engine_status 查询：

• 各运行时就绪态；
• 当前共享服务；
• 部署进度（provisioning 进行到哪一步）。

🔑 引擎 ≠ 模块

• CMS 引擎是底层「运行时骨架」——它负责把 NODE/PYTHON/SSH/JAVA/RUST/GO 这些环境供给到设备上，是能力运行的基础设施。
• CMS v2 模块（QuroCmsRepository）是用户自建的、可复用的上层能力单元，通过 serializeModule / parseModule 导入导出，运行在引擎提供的运行时之上。

二者是「地基」与「楼栋」的关系：引擎提供环境，模块消费环境。

GeckoView 浏览器引擎（MPL-2.0）

内置 GeckoView 作为系统 WebView 的替代，用于渲染网页与 HTML 预览。GeckoView 以 MPL-2.0（file-level copyleft）分发，其对应源代码随构建提供（见 NOTICE）。

本地语音

• 本地 STT：sherpa-onnx-whisper-tiny 本地语音识别（约 85MB onnx 模型，离线可用）。
• TTS：单例 QuroTtsHolder，支持多服务商（如小米 MiMo 真情感合成），情绪标签跟随文本。

🔌 ACI · 智能体能力接口（开放调用）

Zorv AI 内置 ACI（Agent Capability Interface） —— 一套同设备、无 Root、基于 AIDL Binder 的本地跨应用调用框架。任何 Android App 都能通过 aci-core 库把自己暴露成「可被 AI 调用的能力」，由 Zorv AI 的 LLM 自动编排。

• 📖 开发者手册：docs/ACI_DEVELOPER_GUIDE.md —— 受控端 5 步接入、能力定义、权限模型、真实踩坑。
• 📦 aci-core AAR：随 v1.0.6+ Release 提供 aci-core-release.aar；开源独立分支 aci-core 提供完整可构建源码。
• 🌿 开源分支：git checkout aci-core 即可拿到一个可独立 ./gradlew assembleRelease 的 Android 库工程。

受控端最小接入（Kotlin）：

class MyAciService : BaseACIService() {
    override fun onCreateCapabilities(caps: MutableList<Capability>) {
        caps.add(Capability.create("open_url", "在浏览器打开指定网址")
            .addParam("url", "string", true, "目标网址")
            .addFlag(Capability.FLAG_BACKGROUND))
    }
    override fun onCall(req: ACIRequest): ACIResponse =
        ACIResponse.success().putResult("ok", true)
}

⚠️ Capability.create(id, description) 的第 2 参是给 LLM 的自然语言描述，不是版本号（方法内部固定 version="1.0"）。受控端还需在 Manifest 写 <queries> 声明 ACTION_BIND/ACTION_WAKE，否则 Android 11+ 控制端发现不到。

ZorvAI 浏览器（官方受控端）已暴露的能力：

作为官方参考实现，ZorvAI 浏览器向控制端（主程序 LLM）暴露以下 7 个能力，可直接被 AI 编排调用：

💡 browser_crawl / browser_search 让 AI 能做「网页检索 / 信息抽取 / 爬虫」类任务；browser_script 提供页面内任意 JS 执行（高危能力，仅在受信任会话中使用）。完整契约见 ACI 开发者手册 §13。

🔐 Privilege Tiers · 特权 / 权限层（L1–L5）

更高层级的系统级执行通道均需用户显式授权后才会启用；未授权时返回引导提示，不会静默越权。

🧰 Requirements & Quick Start · 系统要求与快速开始

系统要求

• Android 8.0+（API 26+）
• 建议 4GB+ 内存，存储空间 200MB+（本地语音模型另需约 85MB）

从源码构建

# 克隆仓库
git clone https://github.com/Quor-a/ZorvAI
cd QuroAI

# 准备环境
# - JDK 17
# - Android SDK（compileSdk 36 / minSdk 26 / targetSdk 34）
# - 在 local.properties 中配置 sdk.dir

# 构建 debug 包
./gradlew clean assembleDebug

构建产物：app/build/outputs/apk/debug/app-debug.apk

🔎 Troubleshooting · 排查与故障排查

📦 Download · 下载 / APK

直接从 Release 页面下载最新 APK：

• v1.0.12（debug，主程序，最新）：ZorvAI-debug-v1.0.12.apk
• v1.0.12（debug，受控端浏览器 ACI · ZorvAI 浏览器 · 独立仓）：ZorvBrowser-aci-debug-v1.0.12.apk
• v1.0.12（debug，主程序 · ACI 控制台 UI 版）：ZorvAI-debug-v1.0.12-console.apk
• v1.0.12（debug，受控端浏览器 ACI · 控制台 UI 版 · 独立仓）：ZorvBrowser-aci-debug-v1.0.12-console.apk
• 🧩 受控端浏览器·独立仓库（源码 + v1.0.12 APK）：github.com/Quor-a/ZorvBrowser ｜ gitee.com/ZorvAI/ZorvBrowser
• v1.0.6（debug，主程序）：ZorvAI-debug-v1.0.6.apk
• v1.0.6 附带的 ACI 核心库 AAR：aci-core-release.aar
• v1.0.5（debug）：ZorvAI-debug-v1.0.5.apk
• v1.0.2（debug）：QuroAI-v1.0.2-debug.apk

💡 v1.0.6 起开放 ACI（Agent Capability Interface）：主程序作为控制端，可调用任意接入 aci-core 的受控端 App（官方参考实现「ZorvAI 浏览器」已独立开源，见上方独立仓库链接）；aci-core-release.aar 随本仓库 Release 提供。详见 ACI 开发者手册。

⚠️ 请务必从官方 Release 页面下载本应用。通过未知渠道获取的安装包可能被篡改，存在隐私泄露风险。

📜 License · 许可证

Zorv AI 本应用源码以 Apache-2.0 许可证发布（见 LICENSE）。

• 主许可：Apache-2.0（应用全部源码）。
• GeckoView（Mozilla）：以 MPL-2.0 分发（file-level copyleft）。其对应源代码随构建提供，符合该许可证义务。
• 其余第三方依赖（AndroidX / Jetpack Compose、Kotlin、OkHttp、Shizuku、QuickJS、Sherpa-NCNN 等）各自保留其原有许可证，完整清单见 NOTICE。

本仓库仅就实际随包分发的组件声明其许可证义务；未随包分发的组件不产生额外的 Copyleft 义务。

🗓️ Changelog · 版本历程

🤝 Contributing · 贡献

欢迎各种贡献：核心功能开发、内置工具、CMS 模块、文档与翻译。

1. Fork 本仓库
2. 创建特性分支（git checkout -b feature/xxx）
3. 提交变更（git commit -m 'feat: xxx'）
4. 推送分支（git push origin feature/xxx）
5. 提交 Pull Request

💬 Feedback · 问题反馈

遇到问题或有建议？欢迎 提交 Issue。
请尽量提供：清晰描述、复现步骤、设备型号与系统版本、相关截图。

如果觉得项目不错，欢迎点个 ⭐ Star 支持我们！

🔎 关键词 · 便于搜索（SEO）

为了让大家在 GitHub 探索、Google、Bing、百度等搜索引擎更容易找到本项目，这里列出常用检索词：

• 中文：Zorv AI 开源、安卓 AI 助手 开源、Android AI 智能体、本地 AI 助手、设备端 AI Agent、手机 AI 助手、Kotlin Compose AI 聊天机器人、离线 AI 助手、语音 AI 助手、安卓自动化助手、AI 工具调用、飞书 QQ 微信 AI 机器人
• English：Zorv AI open source, Android AI assistant open source, on-device AI agent, local AI chatbot, Kotlin Jetpack Compose LLM, Android automation agent, voice AI assistant, TTS STT assistant, AI tool use, Feishu QQ WeChat AI bot

仓库主页：GitHub github.com/Quor-a/ZorvAI ｜ Gitee gitee.com/ZorvAI/ZorvAI ｜ 最新下载：Releases

🤖 AI 友好入口：根目录 llms.txt 与 llms-full.txt 供 LLM 检索接口（ChatGPT / Perplexity / 元宝联网搜 / Claude 等）直接读取项目上下文；robots.txt 已放行 AI 爬虫。