Skip to content
wess09Public

About

AzurPilot CN 碧蓝航线脚本 | 无缝委托科研,全自动大世界 | AzurLaneAutoScript 的修改版 AzurPilot

Topics

Resources

Stars

348 stars

Watchers

4 watching

Forks

Repository files navigation

AzurPilot — 碧蓝航线自动化辅助工具

简体中文 繁體中文 English 日本語 한국어

AzurPilot Logo

AzurPilot 官网 | 碧蓝航线自动化脚本 · 大世界侵蚀循环 · 多平台支持

Ask DeepWiki

Python License Stars Forks Issues

Last Commit Commit Activity Repo Size Top Language

Contributors Pull Requests Closed Pull Requests

    

项目简介

AzurPilot 是基于 AzurLaneAutoScript 修改而来的碧蓝航线自动化辅助工具,保留原项目的核心能力,并在此基础上整合了多个分支、功能改进和实验性特性。通过 ADB/uiautomator2 控制安卓模拟器,以截图识别、图像匹配与 OCR 自动执行游戏任务,支持 CN/EN/JP/TW 四服。

请注意:本项目代码基本由 AI 代码生成与辅助编写,存在较大的不确定性,欢迎提交 Pull Request 改正。

访问 AzurPilot 官网 了解更多功能详情,或前往 下载页面 获取最新版本。

GUI 预览

GUI Preview

快速开始

💡 推荐方式:直接从 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 引导 开
大型作战设置,自律时自动提交道具 开
大型作战设置,安全海域默认开启自律 关
剧情自动播放 开启
剧情自动播放速度调整 特快
待机模式设置,启用待机模式 关
其他设置,重复角色获得提示 关
其他设置,快速更换二次确认界面 关
其他设置,展示结算角色 关

大型作战设置

路径:大型作战 → 右上角雷达 → 指令模块 → 潜艇支援。

设置名称 推荐值
X 消耗时潜艇出击 取消勾选

一键退役设置

路径:主界面 → 右下角建造 → 左侧边栏退役 → 左侧齿轮图标 → 一键退役设置。

设置名称 推荐值
选择优先级 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 启动器

loading

启动加载界面

新版
新版
旧版
旧版
简约
简约

Windows 客户端界面

macGUI

Mac 客户端界面

启动器项目地:GitHub · 源项目 ALAS Launcher: 一种新型的 AzurLaneAutoScript 启动器

更改内容:

  1. 增加托盘化功能
  2. Windows 原生推送
  3. GUI 样式美化
  4. uv 化 ...

贡献者

由于本项目基于 AzurLaneAutoScript 及其社区分支继续开发,贡献者列表不仅包含本仓库的直接贡献者,也包含上游项目与相关分支中的原始贡献者。

*本项目的贡献名单

AzurPilot Contributors

*启动器项目的贡献名单

Launcher Contributors

*ALAS原项目的功能名单

AzurLaneAutoScript Contributors

相关链接

衍生项目与友链

  • AzurPilot 树莓派版 — 面向树莓派 / Termux 真机的 AzurPilot CN 部署版
  • AzurPilot-private-Ru — 个人俄语版本,提供可控更新、透明启动并精简外部网络依赖
  • PerseusAutoScript — 面向 AzurPilot 的综合运维工具库(后台静默控制、闭环自愈与多端推送)
  • AzurRem — AzurPilot 原生安卓客户端(Kotlin + Jetpack Compose 重写,附带 PC 网关)

开发与贡献

本项目基本完全是 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

使用、修改或分发本项目时,请同时遵守相关上游项目的许可证要求。

赞助支持

爱发电
支持本项目(用于支付服务器费用或训练新模型等?)

About

AzurPilot CN 碧蓝航线脚本 | 无缝委托科研,全自动大世界 | AzurLaneAutoScript 的修改版 AzurPilot

Topics

Resources

Stars

348 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages