桌面端运行

安装与首次启动

1. 从 下载页或 GitHub Releases 选择平台安装包。Windows 使用安装器；macOS 与 Linux 使用压缩包。
2. 启动安装器或解压后运行启动器。首次启动会准备 uv、Python、ADB 与 Git 等依赖，并同步 Python 环境；这一步需要网络。
3. 启动后直接在应用窗口打开本地界面，默认端口 25548；端口被占用时， 可在部署设置中修改。
4. 按照 游戏内设置调整模拟器和游戏，创建实例并做一次短任务验证。

连接安卓模拟器

AzurPilot 通过 ADB 或 uiautomator2 控制模拟器。启动模拟器前请开启 ADB 调试，并确认 WebUI 能识别到设备 serial。推荐的识别输入是 16:9、 1280×720；其他尺寸会被缩放到 720p，不同模拟器的缩放与截图通道可能影响稳定性。

• 模拟器需要保持前台运行，并关闭可能遮挡界面的弹窗或悬浮球。
• 每台模拟器只运行一个受管实例，避免两个 worker 同时操作。
• MuMu 12 可使用 nemu_ipc 截图与 MaaTouch；其他模拟器按 WebUI 支持的截图方式配置。
• 实际游戏帧数建议 60 帧；卡顿时先在模拟器与 WebUI 两端排查。

本地 WebUI

WebUI 是 AzurPilot 的主要操作界面。默认运行在本机回环地址，不需要云端账号。 打开后可以看到实例、资源卡、调度器、任务计划和日志：

页面数据来自当前实例；截图中的演示数据不要用来判断自己的实例是否连接正常。

创建实例与任务调度

1. 打开实例管理，创建新实例，填写模拟器 serial、游戏包名与区服。
2. 进入任务配置，按任务组选择需要执行的项目。不同任务有各自的配置项与默认值。
3. 在调度器中设定下一次运行时间，然后启动调度器。
4. 任务开始后查看运行状态与日志，确认识别、点击和任务跳转正常。

多实例时，每个实例使用独立配置和模拟器。某个实例异常不会自动修复另一个实例； 定期检查任务计划、模拟器状态与存储空间。

日志、截图与统计

运行日志会显示任务当前所在的阶段。需要确认游戏画面时，切换到截图标签即可查看模拟器 当前画面。错误现场会保留相关日志与截图，便于定位。

统计页面提供资源趋势、委托收益、出击与活动数据，并可查看明细或导出 CSV。 历史数据保存在本地配置与数据库中；重装前请自行备份需要保留的部分。

配置、主题与数据

实例配置、日志、统计与截图保存在本地目录中，不上传到由项目运营的云端账号。 程序在运行时仍会访问官方 API 或项目服务以获取公告、日志与遥测信息。 WebUI 提供主题与多种界面语言，但部分固定文案仍为简体中文。

MCP 与远程访问

MCP 服务默认随 WebUI 启动，提供实例、任务、日志、截图与配置等 18 个工具。使用方式与鉴权细节见 MCP 服务。

远程访问默认关闭。开启后 WebUI 或 MCP 可被局域网或公网访问，必须设置强密码， 并优先使用 TLS。

从源码运行

安装官方启动器时不需要自己安装 Python。源码运行则需要 Python 3.14.6+ 与 uv：

uv sync --frozen --no-dev
uv run python gui.py

启动后打开本地界面（默认端口 25548）。源码方式的依赖和运行说明以仓库 README 与 pyproject.toml 为准。

常见问题

• WebUI 打不开：确认启动器与 WebUI 进程仍在运行；检查端口是否被占用。
• 识别一直失败：检查模拟器分辨率与游戏设置，确认截图通道正常， 并移除遮挡物。先用一个简单任务验证。
• 更新失败：停止实例，检查网络与本地改动；从 Releases 下载完整包可恢复干净的运行环境。