AzurPilot for Android

无需电脑与常驻服务器 · 原生轻量化运行 · 后台虚拟屏无感挂机

全功能《碧蓝航线》自动化助手 AzurPilot 专用的 Android 移动端一体化运行环境

本仓库 fork 自 ALAS-AOS，继承其宿主架构、PRoot 容器化路线与免 Root 提权设计，以及 AGPL-3.0 许可。

简体中文 | English | 日本語 | 繁體中文

---

工程总览 • 智能问答 • 项目概述 • 关联生态 • 核心特性 • 系统架构 • 环境规格 • 快速开始 • 应用预览 • 功能界面 • 双轨更新 • 研发活跃 • 增长趋势 • 社区支持

---

工程总览与指标

工程核心运行与研发指标
最新正式版	累计下载量	开源许可证	主分支状态
代码库体积	代码语言	提权执行方式	目标系统
快速操作快捷入口：

---

代码知识库与 AI 问答

Ask DeepWiki 代码库智能问答 对项目的内部模块、PRoot 沙盒机制、虚拟屏渲染逻辑或定时任务调度规则有任何疑问？直接向已索引本仓库全量上下文的 DeepWiki 发起提问，快速获取针对性的架构解析与代码导引。

---

如果 AzurPilot for Android 为你带来了便利 给项目点亮一颗 Star 是对维护者持续更新与技术攻关最大的肯定。只需点击右侧按钮即可加入关注者列表！

---

项目概述

AzurPilot for Android 致力于将桌面端功能成熟的《碧蓝航线》自动化助手完整移植至 Android 移动端原生运行。

通过在 APK 安装包内预置完整的 Linux 运行时容器（Ubuntu 24.04，按设备架构提供 arm64-v8a 与 x86_64 两种 Runtime），结合轻量级 PRoot 容器隔离技术，实现了在 完全免 Root 条件下稳定运行 CPython、硬件加速 OCR 算法模型及本地 Web 控制台服务。借助后台虚拟屏幕、匿名共享内存帧通道与辅助交互服务，用户可以在设备主屏正常聊天、游戏或办公的同时，无感完成各项自动化巡航任务。

---

关联生态工程

本工程与相关联的核心项目紧密联动，关键依赖与来源项目如下：

宿主运行环境 (当前项目) 面向 Android 移动端的一体化运行基座，打通 PRoot 免 Root 容器、后台虚拟屏、全域悬浮窗与生命周期管理。

核心自动化引擎本体 《碧蓝航线》自动化助手核心，包含完备的计算机视觉图像识别、出击调度算法与本地 Web 控制台服务。

来源项目（本仓 fork 自此处） 移动端 Linux 运行时与免 Root 提权方案的先行实现，本仓的宿主架构与容器化路线由此演化而来。

---

核心亮点

零配置一键部署 完整运行环境（Ubuntu Base、Python 3.14、科学计算与视觉依赖、预置 OCR 模型权重及前端资产）全内置于安装包中。安装后自动释放至私有沙盒，无需配置交叉编译环境或在线下载运行时大包。	后台虚拟屏无感挂机 基于 Android 虚拟屏幕（Virtual Display）机制，游戏实例与图像捕获完全在独立的虚拟显示层运行。内置渠道 SDK 弹窗自动抓回机制（SdkTaskRepatriator），防范厂商弹窗逃逸；主屏操作与日常应用互不干扰。
多维悬浮窗交互面板 内置轻量级全局浮窗控制器，在任意第三方 App 或桌面层级均可一键唤起。支持快速启停任务、检查调度队列、切换目标实例并实时滚动浏览运行态日志输出。	完整内置 WebUI 体验 设备端直接承载原生 React + Vite 控制台前端，提供完整的实例细分配置、出击模式编排、定时调度规则与实时数据看板，无需额外借助电脑浏览器访问。
分离式日志与诊断回溯 Android 宿主日志与 AzurPilot 业务日志双通道独立归档。异常时自动捕获并持久化当前画面快照；内置一键打包导出功能与 7 天自动轮转过期机制，兼顾排障与存储空间。	双轨独立热升级体系 宿主 App、底层 Linux Runtime 与上游脚本具备完全解耦的分发与升级机制。支持事务级热更新无损替换脚本，更新应用本体仅需轻量增量包；内置四连接分段加速与国内 CNB 镜像分发。
免外部管理器内置激活 内置移植自 shizuku-m 的本地 ADB 连接与无线配对能力。Android 11+ 用户无需另装 Shizuku 管理器，输入配对码即可激活；支持开机内断网重连，并针对联发科设备进行 Context-only 防崩溃处理。	匿名共享内存极速截屏 基于 Unix 抽象域套接字与匿名 SharedMemory（ashmem/memfd）的帧通道，通过 SCM_RIGHTS 传递句柄。平均延迟从 TCP 的 47.2ms 骤降至 15.6ms；数据纯 RAM 流转，严禁 Flash 写入，杜绝闪存磨损。
独立进程硬件加速 OCR 模型推理托管于独立的 :ocr 工作进程，主界面与特权服务隔离崩溃风险。全面接入 LiteRT 与 MNN，支持高通 QNN HTP、联发科 NeuroPilot APU 与海思 HiAI NPU 硬件加速，异常时自动回退 LiteRT CPU。	OLED 息屏防烧屏动效 后台模式下可手动开启黑色低亮度屏保，也可设置在任务启动时自动进入。屏幕保持点亮，屏保内无操作 30 秒后开始每 10 秒上下移动 16dp，减少烧屏风险；向右拖动解锁条至末端并松手退出。

---

系统架构全景

项目采用清晰的分层解耦设计，各层间职责清晰、通讯边界规范：

graph TD
    subgraph AndroidHost ["Android 宿主层 (Kotlin / Jetpack Compose M3)"]
        UI["Compose UI 界面矩阵\n(首页 / 任务编排 / 定时管理 / 全局设置)"]
        Overlay["FloatingX 全局悬浮控制面板"]
        Lifecycle["进程守护与 Runtime 生命周期管理器"]
        Bridge["Embedded ADB / Shizuku / Root su 权限接入中继"]
        OCRWorker["独立 OCR 工作进程 (:ocr)\n(LiteRT NPU / MNN HiAI / CPU 推理服务)"]
    end

    subgraph Container ["PRoot 容器隔离层 (Ubuntu 24.04 · arm64 / x86_64)"]
        PROOT["PRoot 虚拟化引擎 (免 Root 系统调用映射)"]
        ENV["CPython 3.14 运行环境\n(OpenCV / RapidOCR / NumPy / uv)"]
        CORE["AzurPilot 自动化调度引擎本体"]
        WEB["React + Vite 静态控制台\n(FastAPI / Uvicorn 监听 127.0.0.1)"]
    end

    subgraph DeviceTarget ["系统能力与受控目标"]
        VDisplay["后台虚拟显示屏 (Virtual Display)"]
        Repatriator["SdkTaskRepatriator (渠道 SDK 弹窗搬回)"]
        InputService["MaaTouch / DroidCast / ADB 控制流"]
        ShmChannel["SharedMemory 匿名共享内存帧通道"]
        GameApp["《碧蓝航线》游戏实例 (全区服支持)"]
    end

    UI --> Lifecycle
    Overlay --> Lifecycle
    Lifecycle --> PROOT
    PROOT --> ENV
    ENV --> CORE
    CORE --> WEB
    UI -. "WebView / 本地回环通讯" .-> WEB
    Bridge --> InputService
    Bridge --> VDisplay
    InputService --> GameApp
    VDisplay --> GameApp
    Repatriator -. "盯防搬回" .-> GameApp
    CORE --> InputService
    VDisplay --> ShmChannel
    ShmChannel -. "SCM_RIGHTS 极速取帧" .-> CORE
    CORE -. "127.0.0.1:22302 张量 RPC" .-> OCRWorker

Loading

---

环境规格与兼容性

维度	准入指标	推荐配置	说明
操作系统			需满足现代 Android 权限隔离与私有存储机制
处理器架构			依赖 64 位 Linux 二进制包，不支持 32 位设备
机身存储空间			容纳完整 Ubuntu 根文件系统、依赖库及日志快照
系统运行内存			保证 Python 算法进程与游戏多任务并行稳定
权限支持			用于系统级触控模拟与虚拟屏幕投影授权；已内置无线调试配对与离线重连，亦支持外部 Shizuku 与 Root
区服支持			全区服自动化完整覆盖，应用内可直接切换目标服务器实例

---

快速开始

GitHub 构建的正式产物会同步到 国内下载（CNB）；首次安装请选择对应架构的完整包。发布配置说明。

获取安装包 前往 Releases 最新版本 下载与设备架构匹配的完整版 APK（arm64-v8a / x86_64，安装包包含对应架构的预置 Runtime）。

初始化解包 安装完成后启动应用，等待底层 Linux 根文件系统自动释放至沙盒，初次解压需要 1 至 3 分钟。

接入提权服务 按界面提示激活内置 Shizuku：首次完成系统无线调试配对，之后本次开机内可离线重连，无需另装管理器或再次授权。也可在设置中选择 Root。

配置巡航实例 在「挂机」页校验画面推流，进入内嵌「AzurPilot」WebUI 页面定制专属自动化出击规则。

Tip

已内置 Shizuku-m 的本机 ADB 配对和离线重连能力。首次仍需系统配对及 USB 调试确认，重启设备后需重新激活。参见 内置启动说明。

Note

内置路径用 Context-only 方式启动特权服务，避开联发科 Application 初始化问题。继续使用外部 Shizuku 时，联发科设备可选择 Shizuku-m 修复版。

Important

完整版 APK 内置 Runtime，首次启动直接本地解压，无需联网；轻量增量 APK 不含 Runtime，首次启动会自动从 GitHub 下载与设备架构对应的约 1GB Runtime（建议在 Wi-Fi 下进行；下载支持多镜像与多线程分段，可在设置中选择下载源）。后续若仅有 Android 宿主代码更新，下载轻量增量 APK 直接覆盖安装即可，无需重新解压 Runtime。

---

应用预览

简体中文

	主页	AzurPilot 总览	设置	虚拟屏
暗色
亮色

繁體中文

	主页	AzurPilot 总览	设置	虚拟屏
暗色
亮色

English

	主页	AzurPilot 总览	设置	虚拟屏
暗色
亮色

日本語

	主页	AzurPilot 总览	设置	虚拟屏
暗色
亮色

---

功能界面一览

界面模块	核心职责与承载能力	交互特色	状态标志
首页看板	呈现系统健康概况、PRoot 容器状态、CPU/内存负荷、运行诊断日志快速通道。	卡片式看板、一键诊断
任务编排	实时预览后台虚拟屏游戏画面、作业队列调度编排、全屏手动触控接管模式。	低延迟画面推流、实时介入
定时管理	编排计划任务日历、定时触发执行条件、到点自动唤起与离线队列管理。	规则弹性匹配、周期循环
AzurPilot 控制台	应用内原生控制台：任务配置、实例管理、实时日志、统计看板与运行时更新，界面按上游 schema 自动生成。	原生渲染、免跳转直连
系统设置	管理双轨更新通道、运行时资源配额、显示分辨率参数、日志归档与导出中心。	偏好持久化、安全校验
全局悬浮窗	穿透显示在任何 App 之上，实时呈现调度进度、提供即时暂停/启动与日志速览。	最小化胶囊、拖拽自适应
OLED 动效屏保	后台模式可手动开启低亮度屏保，或设置随任务启动进入；屏保内无操作 30 秒后，每 10 秒上下移动 16dp，向右滑动解锁退出。	防烧屏漂移、极简低功耗

---

多轨解耦更新与热更机制

为确保环境的极致稳定与升级灵活性，系统采用宿主层、容器运行时与上游调度脚本完全解耦的多轨管理策略：

轻量宿主覆盖更新 触发依据：检测 Android 内部版本号（VersionCode）。 升级载荷：仅包含原生业务层的轻量 APK（约 25MB），四连接分段加速下载。 更新过程：调用系统标准 PackageInstaller 覆盖安装。 数据保障：完全复用设备已解压的 Linux Runtime 与全部已有配置。

解耦式镜像热替换 触发依据：读取 release 中的 latest.json 签名与架构哈希。 完整性验证：下载后进行严格的 SHA-256 哈希比对与文件大小校验。 热替换机制：停止服务后安全替换容器根目录，保留 /config 及数据卷。 分发加速：支持国内 CNB 与 GitHub 镜像源，四连接分段高速拉取。

事务级源码热更 触发依据：通过 /android/update 查询上游新提交，支持优先从国内 CNB 拉取。 环境守卫：候选与当前 uv.lock 比对；涉及底层依赖变更时自动转为整包升级。 本地构建：内置 Node.js/npm 本地构建前端 dist，无需重新下载数百兆容器镜像。 原子回滚：写事务记录并自动重载；若构建或切换失败自动回滚旧源码与配置。

---

研发活跃度

仓库研发活跃度与响应态势
代码提交频度 月度提交活跃状态	合并请求处理 已归档合并请求总计	问题反馈解决 已成功解决 Issue 统计
研发分支 主干持续交付流	自动化构建 原生 Runner 矩阵持续验证	最新提交记录 追踪最新代码演进

---

Star 增长趋势

采用自适应深浅模式的 Star-History 矢量历史图谱，直观反映项目发展脉络：

_{数据源基于 Star-History 实时更新 · 点击可查看交互式完整走势}

---

工程构建全景

.
|-- app/                      # Android 宿主工程源码 (Kotlin + Jetpack Compose)
|   |-- app/                  # 核心应用模块、Compose UI 实现与状态流
|   |-- annotation-api/       # 注解与接口契约模块
|   |-- ksp-processor/        # 编译期 KSP 代码生成处理器
|   `-- gradle/               # 统一依赖版本目录 (libs.versions.toml)
|-- rootfs/                   # Linux 运行环境打包脚本与预置依赖定义
|   `-- build/                # build-azurpilot.sh 镜像裁剪与集成脚本
|-- .github/workflows/        # CI/CD 自动化流水线 (rootfs.yml)
`-- tools/                    # 构建辅助工具与本地调试脚本

• 编译环境规范：Android Gradle Plugin 9.x、Kotlin 2.x、Jetpack Compose Material 3。
• 自动化构建流：基于 GitHub Actions 原生 Runner 矩阵（arm64 / x86_64）执行 Ubuntu 24.04 镜像裁剪、uv 依赖预装、前端打包与 xz 高压缩归档，按架构分别出包并发布。
• 发布签名安全：正式签名存储于仓库 Actions Secrets 中，杜绝签名泄漏与非法窜改。

---

技术栈与依赖致谢

核心运行时与系统底座

依赖组件	许可证标识	职责定位
Ubuntu Base 24.04		按架构构建的 Linux 容器基础底座（arm64 / amd64）
PRoot		免 Root 用户空间系统调用仿真引擎
uv		现代高性能 Python 包管理工具
CPython 3.14		核心解释器运行时
shizuku-m		内置本地 ADB 运行时实现来源，提供免外部管理器的无线配对与离线重连机制
LiteRT		Google 移动端端侧机器学习运行时，提供 QNN HTP / APU NPU 硬件加速与 CPU 推理
MNN		阿里轻量级深度学习引擎，驱动海思 HiAI NPU 离线模型加速与 GPU Softmax 卸载
AzurPilot		核心自动化决策逻辑与任务引擎
ALAS-AOS		本项目的来源仓库；本仓 fork 自此处，宿主架构与容器化路线直接继承
MaaFwApp		Android 宿主架构与工程框架模板

Android 宿主技术栈

依赖库	许可证标识	用途说明
AndroidX Suite		Jetpack Compose、Lifecycle、DataStore 等现代化组件
Jetpack Glance		现代声明式 Material 3 小部件（AppWidget）体系
Lottie Compose		动态 useAnimations 图标与运行状态矢量动画渲染
Koin		轻量级依赖注入框架
OkHttp		稳定高效的 HTTP 网络通讯客户端
Shizuku API		免 Root 进程间授权与交互通信接口
libsu		Root 模式下稳健的 Shell 提权调用框架
FloatingX		优雅易用的 Android 全局悬浮窗框架
XXPermissions		动态权限申请与状态管理方案
Apache Commons Compress		运行时归档解压与文件流处理
XZ for Java		高压缩比 rootfs 归档格式解析支持

---

社区生态与支持

开源共建与参与 感谢所有参与代码提交、架构改进、问题排查与功能验证的开发者。欢迎随时提交 Issue 与 PR 参与共建！

项目成长与支持 如果 AzurPilot for Android 为你的游戏挂机体验提供了便利，欢迎前往仓库主页点亮 Star 支持项目演进。

---

许可证说明

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0) 协议开源。

随项目一同分发的许可证文件：

• LICENSE-ALAS-AOS — AGPL-3.0
• LICENSE-MaaFwApp — AGPL-3.0
• LICENSE-AzurPilot — GPL-3.0

各 Python 依赖项及传递依赖的原许可证文本（共 152 项），均已随运行时镜像归档于设备端 /opt/azurpilot/licenses。

---

_{AzurPilot for Android 遵守开源协议并由社区驱动维护。如遇问题欢迎提交 Issue 或 Pull Request。}