开始之前
0401AzurPilot 是什么？和官方有关系吗？
AzurPilot 是基于 AzurLaneAutoScript 改造的《碧蓝航线》第三方自动化工具。它通过 ADB 与截图识别操作安卓模拟器或 Android 设备上的游戏客户端，支持 CN / EN / JP / TW 四服。
02桌面端和 Android 端应该选哪个？
需要长期稳定、多开、MCP 或远程管理时，优先桌面端：它运行在电脑的安卓模拟器上，可管理多个实例。没有常开电脑、希望直接在手机上运行时，选 Android 端。Android 端激活后不需要一直连接电脑，但受电量、发热和厂商后台策略影响更大。
03桌面端可以连接 Android 真机吗？
桌面端官方定位是安卓模拟器，不承诺通过 ADB 连接实体手机。真机场景请使用 Android 端。
04支持哪些区服和模拟器？
支持 CN、EN、JP、TW 四个区服，国服还涉及官服与渠道包。桌面端需要开启 ADB 的安卓模拟器；不同模拟器的截图和输入后端兼容性不同，MuMu 12 在文档中有专门支持说明。请使用与实例配置一致的客户端和包名。
安装与运行
0705需要自己安装 Python 吗？
使用官方安装器或启动器时不需要。启动器会准备 Python、uv、ADB 等依赖。只有从源码运行桌面端时，才需要自行安装 Python 3.14.6+ 与 uv。Android 端的内置运行时已经包含 Python。
06Android 端需要 Root 或电脑吗？
通常不需要 Root。Android 11 及以上可以通过内置的无线调试配对在手机上完成激活；Android 9–10 首次激活仍需要一台电脑执行 adb tcpip 5555。也可以选择 Root 或外部 Shizuku。激活后仍需保持开发者选项与相关授权有效。
07为什么 Android 安装包这么大？
full APK 内置了 Ubuntu 24.04 rootfs、Python 依赖、OCR 模型和 WebUI，因此约 1.16–1.17 GiB。首次启动还会解压，实际占用更大。update 包不包含 Runtime，约 198–276 MiB，只适用于已经部署过对应架构 Runtime 的设备。
08macOS Intel 可以直接安装吗？
官方 Release 只提供 macOS Apple Silicon（arm64）构建，没有 Intel 安装包。较旧 macOS 版本也可能无法安装锁定的运行环境。
09可以多开或多账号吗？
桌面端支持多实例，通常一个实例绑定一台模拟器与一个账号。不要在同一个模拟器上同时运行多个受管实例。Android 端以单设备单实例为主，多账号需要自行评估设备性能与切换成本。
10识别失败先检查什么？
先确认游戏内设置、区服与包名一致，画面尽量保持 16:9 与 1280×720，移除会遮挡界面的皮肤、装备或悬浮内容；然后检查截图通道和模拟器/设备连接。桌面端还可以先跑短任务或 Benchmark，Android 端先确认 ADB 激活与虚拟屏正常。
11如何更新？会保留配置吗？
桌面端通过启动器或 WebUI 内置更新器更新；手动修改过源码时可能无法直接应用。Android 端的 App、Runtime 与上游脚本分别更新，覆盖安装 update APK 会保留已解压的 Runtime 与配置。更新前仍建议停止任务并备份重要配置文件。
账号与安全
0212WebUI、MCP 或远程访问应该注意什么？
远程访问默认关闭。开启时应使用强密码，并优先通过带 TLS 的反向代理访问。分享截图、日志与配置前，先检查是否包含账号或其他敏感信息。
13项目收费吗？使用什么许可证？
项目免费开源。桌面端采用 GPL-3.0；Android 端宿主与运行时采用 AGPL-3.0，并包含 GPL-3.0 的上游引擎。使用、修改和再分发时请遵守对应许可证，并保留版权与许可声明。