快速开始

本页帮助你把 Zorv AI 跑起来：先确认设备满足要求，再选择「直接下载 APK」或「从源码构建」，最后完成首次启动的权限引导。

系统要求

Android 8.0+（API 26+）
建议 4GB+ 内存，存储空间 200MB+
本地语音模型另需约 85MB（首次使用下载 / 放置 onnx 文件）

方式一：下载 APK（推荐）

最新版通过 GitHub Release 的 latest 稳定链接分发：

主程序：ZorvAI-debug.apk
受控端浏览器：ZorvBrowser-debug.apk

在 Android 设备上允许「未知来源」安装后直接安装即可。

方式二：从源码构建

bash

# 克隆仓库
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

受控端浏览器（独立仓）单独构建：

bash

git clone https://github.com/Quor-a/ZorvBrowser
cd ZorvBrowser
./gradlew :aci-browser:clean :aci-browser:assembleDebug

首次启动：权限引导

Zorv AI 的能力按「特权层 L1–L5」分级，更高层级的系统级通道需你显式授权才会启用；未授权时返回引导提示，不会静默越权。

层级	是什么	用途	前置条件
L1 无障碍	`AccessibilityService`	点击 / 输入 / 读屏（节点树，非截图）	在系统设置中开启 Zorv AI 的无障碍服务
L2 Shizuku	uid 0/2000，AIDL `UserService`	高权限 shell 命令	安装并运行 Shizuku，完成配对授权
L3 设备管理员	`DeviceAdmin`	设备策略级能力	在设置中激活设备管理员
L4 ROOT	`su`	完整 root 权限	设备已 root
L5 应用内 Linux	`proot` + Alpine	真 Linux 用户态执行	自备 `proot` 与 Alpine rootfs

💡 Shizuku 必须先在系统中启动其服务并完成配对，Zorv AI 才能授权使用 L2 通道；Shizuku 未运行时 L2 不会启用。

排查与故障排查

现象	说明 / 处理
Shizuku 相关能力不可用	先打开 Shizuku App 并启动服务 / 完成配对，再在 Zorv AI 中授权
ROOT 模式命令不执行	命令走 `sh -c` 执行，需确认设备已 root 且已授予 su 权限
应用内 Linux（L5）无法运行	依赖自备的 `proot` 二进制与 Alpine rootfs
网页 / HTML 预览不显示	确认已随包集成 GeckoView（MPL-2.0）运行时
本地语音识别不可用	本地 STT 模型约 85MB onnx，首次使用需下载 / 放置到指定目录
会话出现重复或异常	启动自愈 `DATA_REPAIR` 会去重清洗，重启 App 即可
需要诊断日志	日志写到手机公共目录 `Download/QuroAI_logs/`，无需 adb 即可取出

下一步

了解整体结构：架构总览
让其他 App 被 AI 调用：ACI 2.0 与 SDK 路线图
查看具体功能：见左侧「核心功能」分组

快速开始 ​

系统要求 ​

方式一：下载 APK（推荐） ​

方式二：从源码构建 ​

首次启动：权限引导 ​

排查与故障排查 ​

下一步 ​