免 root，把《碧蓝航线》自动化脚本 ALAS 装进你的 Android 手机——游戏跑在后台虚拟屏里挂机，前台刷视频、回消息、打游戏，互不干扰。🎉
名字由来：
AOS= ALAS on Android OS——ALAS 的 Android 系统版。
⚠️ 兼容性说明：各家手机渲染方案不一致，极个别场景可能识别失败，可借助 AI 针对自己的机型自行适配。本仓库只做基本可行性测试。
- 🔓 免 root：提权只靠 Shizuku，不解 BL、不刷机、不折腾。
- 🌙 后台挂机：游戏运行在独立的后台虚拟屏（1280×720），主屏该干嘛干嘛。
- 📦 一键安装：一个 APK 全搞定——内置 Ubuntu 运行环境（Python 3.12 + ALAS 官方版 + OCR 模型），首次打开自动部署，装完即用。
- 🔄 开屏热更新：每次启动自动检查 ALAS 上游更新，秒级快进；断网/超时自动跳过，绝不卡启动。
- 🎮 本机直控：截图与触控走手机本机的特权桥（延迟中位数约 30ms），不用电脑、不插线、不开 adb。
- 🫧 悬浮窗面板：App 不在前台也能随时启停挂机、盯实时日志。
- 👆 全屏手动模式：想自己点两下？预览画面一键全屏，手指直接操作游戏，退出后画面无缝回卡。
- 🧰 内置小工具：半自动点击、活动剧情等 ALAS 工具任务可独立运行，与挂机自动互斥，不抢设备。
- 🌐 中英双语 + 深浅色主题：界面语言跟随系统或手动切换（切换会重载项目）；主题支持浅色/深色/跟随系统。
┌─ App 进程（Kotlin）────────────────────────────┐
│ 挂机页（虚拟屏实时画面 + 运行配置 + 控制面板） │
│ ALAS 控制台（WebUI :22267，内嵌 WebView） │
│ 挂机页/悬浮窗面板 ──HTTP──> wrapper(:22400) │
├─ 特权进程（Shizuku 拉起）───────────────────────┤
│ 后台虚拟屏 + 截屏/触控注入 │
│ 桥服务 :22300（ping/screencap/click/swipe/shell）│
├─ proot Ubuntu 环境（App 私有目录，免 root）──────┤
│ wrapper.py 监管 → runner（ALAS 调度器） │
│ → gui.py（WebUI） │
│ ALAS ──桥──> 虚拟屏里的游戏 │
└─────────────────────────────────────────────────┘
- 📱 一台 arm64 Android 手机（root 与否皆可）
- 🔑 已安装并激活 Shizuku（第 1 步有详细指引）
- ⚓ 已安装《碧蓝航线》国服（包名
com.bilibili.azurlane）
Shizuku 是开源的特权桥接工具，让普通 App 也能使用系统级能力（本项目用它创建后台虚拟屏、截屏和模拟触控），全程无需 root。
- 前往官方仓库下载安装 👉 RikkaApps/Shizuku。
- 按 Shizuku 官方使用指南 激活，三种方式任选：
- 📶 Android 11 及以上（推荐）：开启「无线调试」配对激活，全程在手机上完成，不用电脑；
- 💻 Android 10 及以下：连接电脑执行一条 adb 命令激活；
- 🔓 已 root 设备：打开 Shizuku 直接点「启动」即可。
💡 嫌每次启动 Shizuku 都要连 WiFi 走无线调试？ 可以试试社区 fork 👉 Shinarin/shizuku-m：在官方版基础上加了端口重新挂载，重启 Shizuku 不必再走无线调试，没连 WLAN 也能启动（手机重启后的第一次激活仍需按官方方式完成一次）。
- 到 Release 页 下载
ALAS-AOS-v<版本号>-android-arm64.apk（约 330MB，运行环境已内置，所以这么大）。 - 安装并打开，按引导完成 Shizuku 授权。
- 耐心等待首启部署（解压运行环境 + 热更新检查），完成后自动进入挂机页。🎊
| 界面 | 在哪里 | 干什么用 |
|---|---|---|
| 🎛 挂机页 | App 内主页 | 看虚拟屏实时画面、选运行配置、开始/停止挂机、看日志、跑小工具 |
| 🫧 悬浮窗 | 任意界面之上 | 挂机页的随身迷你版：状态、启停、日志板——App 切后台后全靠它 |
| 🖥 ALAS 控制台 | App 内 WebView | ALAS 官方 WebUI：任务配置、计划任务、截图回看……所有详细设置都在这 |
分工一句话：挂机页/悬浮窗管「跑不跑、跑哪个配置」，控制台管「任务怎么跑」。
- 打开 ALAS 控制台，按 ALAS 官方用法配置你的任务（出击、委托、科研……配置方法见 ALAS 官方 Wiki）。
- 回到 挂机页，在「运行配置」下拉框选中你刚配好的实例。
- 点击
▶️ 开始挂机——App 会自动在后台虚拟屏拉起游戏、处理登录弹窗，然后开始执行调度。🎉 - 此刻起可以把 App 切到后台，用悬浮窗盯状态就行。
▶️ 开始 / ⏹ 停止挂机：挂机页或悬浮窗一键搞定。停止后环境保留，下次启动秒级恢复。- 📜 实时日志板：挂机页与悬浮窗都有，调度器在干什么一目了然。
- 👆 全屏手动模式：点击预览画面进入全屏（自动横屏、隐藏系统栏），单指点击、拖拽直接操作游戏；点右上角 ❌ 退出，画面无缝回到预览卡。
- 🧰 小工具：「半自动点击」「活动剧情」可独立开启（挂机页工具区与悬浮窗同款按钮）。工具与挂机自动互斥：开工具会自动停挂机，开始挂机也会自动停工具，永不抢设备。
- 🔄 热更新：每次打开 App 自动检查 ALAS 上游更新；断网/超时自动降级跳过，不阻塞启动。
⚠️ 控制台里的启动/停止按钮已被锁定：为防止 WebUI 与挂机页双跑抢设备，ALAS 原生启停通道已关闭（点了只会在日志里留一条警告）。启停请一律走挂机页或悬浮窗。- 🔁 手机重启之后：需要按官方方式重新启动 Shizuku（已 root：App 内点「启动」；未 root：重新走一次无线调试或电脑激活），再打开 ALAS-AOS 即可自动恢复环境。这是免 root 方案物理上不可省略的一步，请知悉。🙏
| 机型 | ROM | Android | 状态 |
|---|---|---|---|
| HONOR PPG-AN00 | MagicOS | 16 (API 36) | ✅ 全链路实测（开发基线） |
多 ROM 实测矩阵持续补充 👉 docs/rom-matrix.md。你的机型跑通了？欢迎到 Issues 报喜！🎊
Q：需要电脑吗？ A：不需要。安装、激活（Android 11+）、更新、挂机，全在手机上完成。💪
Q：挂机费电吗？ A：游戏跑在后台虚拟屏，主屏不用渲染游戏画面，比前台亮屏打游戏省不少；但挂机毕竟是持续负载，长时间挂机建议插着电。🔌
Q：会被游戏检测吗？
A：本项目不修改游戏本体，截图与触控均为系统级能力。但使用自动化脚本违反游戏用户协议，相关风险请自行评估、自行承担。
Q：支持渠道服 / 外服吗？
A：目前实测国服（com.bilibili.azurlane），其他服务器欢迎实测后反馈。
Q：断网能用吗？ A：热更新检查会自动跳过；挂机本身不依赖外网（游戏自己的联网需求除外）。
Q：卸载 App 会怎么样？ A：App 私有目录里的运行环境和 ALAS 配置会一并清空，卸载前请留意。🗑
想自己编译或参与开发？
- 📘 development.md：构建命令、仓库结构、阶段账本
- 🧭 docs/roadmap-v3.md：开发宪法（13 项已确认决策）
ALAS-AOS 站在这些优秀开源项目的肩膀上，由衷感谢：💖
- LmeSzinc/AzurLaneAutoScript（ALAS）——《碧蓝航线》自动化的核心大脑 🧠
- Aliothmoon/MaaFwApp——本 App 的上游基座（虚拟屏 + Shizuku 特权进程框架）📱
- RikkaApps/Shizuku——优雅强大的免 root 特权桥 🔓
- termux/proot——免 root 运行 Linux 用户空间的魔法 🪄
- PaddlePaddle/PaddleOCR——手机端文字识别（PP-OCR 模型）👀
- Ubuntu（Canonical）——挂机运行环境的 Linux 地基 🐧
AGPL-3.0。本仓库包含对 ALAS（GPL-3.0）的补丁与 MaaFwApp（AGPL-3.0）的 fork 修改，均按各自许可证义务公开源码。