AzurPilot — 碧蓝航线自动化辅助工具
AzurPilot 官网 ｜ 碧蓝航线自动化脚本 · 大世界侵蚀循环 · 多平台支持
项目简介
AzurPilot 是基于 AzurLaneAutoScript 修改而来的碧蓝航线自动化辅助工具，保留原项目的核心能力，并在此基础上整合了多个分支、功能改进和实验性特性。通过 ADB/uiautomator2 控制安卓模拟器，以截图识别、图像匹配与 OCR 自动执行游戏任务，支持 CN/EN/JP/TW 四服。
请注意：本项目代码基本由 AI 代码生成与辅助编写，存在较大的不确定性，欢迎提交 Pull Request 改正。
访问 AzurPilot 官网 了解更多功能详情，或前往 下载页面 获取最新版本。
GUI 预览
快速开始
💡 推荐方式：直接从 AzurPilot 官网下载页 下载对应平台的启动器，内置 Python 环境，开箱即用。
Linux 一键部署
curl -fsSL https://azurpilot.com/install/deploy-image.sh | sudo -E bash
源码运行
本项目使用 uv 和项目根目录 .venv 管理 Python 运行环境（要求 Python >= 3.14）。发布版启动器会自带 uv、Python、ADB、Git，并在 .venv 中同步依赖；源码开发时可安装 uv 后运行：
uv sync --frozen --no-dev
uv run python gui.py
启动后浏览器访问 http://127.0.0.1:25548 进入 WebUI。
开发调试可用 uv run python gui.py -r：监听项目内 .py 变更，稳定后自动重建 WebUI（会中断当前运行的实例，请勿在挂机时使用）。详见 WebUI 启动器文档。
重要说明
- 本项目包含大量自动化逻辑和图像识别相关功能。使用前请确保已完成游戏内设置，否则可能导致识别失败、流程异常或任务无法正常执行。
- 本项目包含部分实验性功能，可能存在未知问题。建议在使用前备份相关配置，并在发现异常时及时反馈。
使用前设置
使用前必须按照以下标准修改游戏内设置。
路径：主界面 → 右下角设置 → 左侧边栏选项。
| 设置名称 |
推荐值 |
| 帧数设置 |
60 帧 |
| 大型作战设置，减少 TB 引导 |
开 |
| 大型作战设置，自律时自动提交道具 |
开 |
| 大型作战设置，安全海域默认开启自律 |
关 |
| 剧情自动播放 |
开启 |
| 剧情自动播放速度调整 |
特快 |
| 待机模式设置，启用待机模式 |
关 |
| 其他设置，重复角色获得提示 |
关 |
| 其他设置，快速更换二次确认界面 |
关 |
| 其他设置，展示结算角色 |
关 |
大型作战设置
路径：大型作战 → 右上角雷达 → 指令模块 → 潜艇支援。
一键退役设置
路径：主界面 → 右下角建造 → 左侧边栏退役 → 左侧齿轮图标 → 一键退役设置。
| 设置名称 |
推荐值 |
| 选择优先级 1 |
R |
| 选择优先级 2 |
SR |
| 选择优先级 3 |
N |
| 拥有满星的同名舰船时，保留几艘符合退役条件的同名舰船 |
不保留 |
| 没有满星的同名舰船时，保留几艘符合退役条件的同名舰船 |
满星所需或不保留 |
图像识别注意事项
请移除以下可能影响识别的内容：
- 角色设备装备
- 角色皮肤
- 可能遮挡界面元素的自定义显示内容
这些内容可能影响图像识别结果，导致自动化流程出现异常。
MCP 服务
AzurPilot 提供 MCP 服务，可供支持 MCP 的客户端或工具调用，方便使用 Agent 管理 AzurPilot。
MCP 服务默认随 WebUI 启动并挂载于 /mcp 路径下（WebUI 默认端口 25548），也可通过 uv run python mcp_server_sse.py 独立运行（独立端口 22268）。
注意：22268 并非 MCP 专用端口，OCR 服务（OcrServerPort）默认也使用该端口。与 WebUI 同机运行独立 MCP 时请留意端口占用冲突。
MCP 复用 WebUI 的密码（--key / config/deploy.yaml 的 Password），未设置密码且监听公网时 WebUI 会自动生成密码，可在根目录 password.txt 查看。调用 MCP 时必须携带该密码，否则返回 401。
本地连接配置
本服务是远程 HTTP 服务（SSE 传输），不是本地启动的 stdio 命令，因此配置里填 url 而不是 command / args；mcpServers 下的键名可自定义。部分客户端会默认优先尝试 HTTP 传输，此时需显式加上 "type": "sse"。
{
"mcpServers": {
"azurpilot": {
"type": "sse",
"url": "http://127.0.0.1:25548/mcp/sse",
"headers": {
"Authorization": "Bearer <WebUI 密码>"
}
}
}
}
云服务器或内网连接配置
{
"mcpServers": {
"azurpilot": {
"type": "sse",
"url": "http://[IP_ADDRESS]:25548/mcp/sse",
"headers": {
"Authorization": "Bearer <WebUI 密码>"
}
}
}
}
请将 [IP_ADDRESS] 替换为实际服务器地址或内网地址；若 WebUI 端口被修改，请同步替换 URL 中的端口。
只能填写 URL、无法自定义请求头的客户端，可以把密码放在查询参数里：http://[IP_ADDRESS]:25548/mcp/sse?key=<WebUI 密码>。此时 URL 本身就是凭据，请勿截图外贴或分享；有条件时优先使用请求头。也可用 X-API-Key: <WebUI 密码> 请求头代替 Authorization。
修改密码后需要重启 WebUI，MCP 才会使用新密码。
MCP 工具列表
默认端点提供 25 个 azurpilot_ 工具；旧工具名只在显式创建的兼容端点中保留。
| 类别 |
工具名称 |
功能 |
| 实例管理 |
azurpilot_list_instances |
列出实例及进程状态、当前任务 |
|
azurpilot_get_context |
一次获取状态、当前任务、调度/资源摘要、最近错误与设备能力 |
|
azurpilot_start_instance / azurpilot_stop_instance |
启动 / 停止实例工作进程 |
| 任务发现 |
azurpilot_search_tasks |
按任务标识、中文名、参数文案查找任务；支持常见口语别名 |
|
azurpilot_get_task_schema |
读取参数定义、默认值、可选值与可写性 |
| 配置与调度 |
azurpilot_get_config |
按任务或路径读取配置，返回 revision |
|
azurpilot_patch_config |
原子批量修改，校验 revision，支持 dry_run |
|
azurpilot_set_task_schedule |
设置任务启用与下次执行时间（只表示已安排） |
| 日志与观测 |
azurpilot_get_logs |
按游标、级别、关键词读取有限日志 |
| 统计数据 |
azurpilot_get_statistics |
读取统计页与概览页的指标、时间线与表格；覆盖概览资源、资源趋势、大世界、委托、舰船经验、掉落、科研、仓库与资源流向 |
|
azurpilot_get_statistics_schema |
统计字段目录：分类、指标键、单位、说明与筛选参数 |
|
azurpilot_observe_device |
采集截图与帧尺寸、方向、时间等元数据 |
| 设备控制 |
azurpilot_acquire_device_control / azurpilot_release_device_control |
调度器停止后接管设备，取得/释放 lease_id（默认 30 分钟，调用续期） |
|
azurpilot_click / azurpilot_swipe / azurpilot_long_press |
坐标点击、滑动、长按；需 lease_id，分别回报命令下发与画面变化 |
|
azurpilot_input_text / azurpilot_press_key |
输入文本（不自动回车）、发送按键；需 lease_id |
|
azurpilot_adb_shell |
执行白名单内的只读 ADB 诊断命令（如 wm size、dumpsys battery） |
| 操作确认 |
azurpilot_get_operation |
按 operation_id 查询写操作终态 |
| 维护工具 |
azurpilot_restart_emulator |
重启实例绑定的模拟器 |
|
azurpilot_restart_adb |
重启全局 ADB 服务 |
|
azurpilot_update_application |
请求应用更新（已接受 ≠ 已完成） |
所有工具都带 inputSchema / outputSchema、结构化结果与稳定错误码；写操作可用 request_id 去重，超时后先用 azurpilot_get_operation 查询，不要重复提交。详见 MCP 服务文档。
多平台启动器
📥 从 AzurPilot 官网 下载 Windows / macOS / Linux 启动器
启动加载界面
Windows 客户端界面
Mac 客户端界面
启动器项目地：GitHub · 源项目 ALAS Launcher: 一种新型的 AzurLaneAutoScript 启动器
更改内容：
- 增加托盘化功能
- Windows 原生推送
- GUI 样式美化
- uv 化
…
贡献者
由于本项目基于 AzurLaneAutoScript 及其社区分支继续开发，贡献者列表不仅包含本仓库的直接贡献者，也包含上游项目与相关分支中的原始贡献者。
*本项目的贡献名单
*启动器项目的贡献名单
*ALAS原项目的功能名单
相关链接
衍生项目与友链
开发与贡献
本项目基本完全是 VibeCoding 产物，不足之处请见谅。欢迎通过 Issue 或 Pull Request 反馈问题、提交修复或改进文档。
开发环境
uv sync --frozen # 创建/同步 .venv（含开发依赖）
# 代码检查（CI 使用 ruff 宽松设置——仅检查致命语法错误和未定义名称）
uv run ruff check . --select E9,F63,F7,F82 --ignore F821,F722
# 测试（约 160 个单元测试）
uv run python -m unittest discover -s tests
# 配置生成（修改配置 YAML 文件后必须执行）
uv run -m module.config.config_updater
使用过的开发工具与模型
本项目开发过程中使用过多种 AI 模型与开发工具进行辅助。
AI 模型：
|
|
|
| Gemini |
GPT |
Claude |
| GLM |
MiMo |
DeepSeek |
| Kimi |
Qwen |
DouBao |
开发工具：
|
|
|
| Claude Code |
Codex |
Cursor |
| TRAE |
ZCode |
OpenCode |
许可证
本项目遵循原项目及相关上游项目的许可证要求。启动器项目遵循 GPL-3.0 协议开源。
本项目依赖的相关项目许可证位于 /licenses
使用、修改或分发本项目时，请同时遵守相关上游项目的许可证要求。
赞助支持
支持本项目（用于支付服务器费用或训练新模型等？）
评论