AzurPilot Launcher

全平台原生运行 · 内置 Python 环境零配置 · 一键更新启动 AzurPilot

全功能《碧蓝航线》自动化助手 AzurPilot（基于 AzurLaneAutoScript）的跨平台桌面启动器，基于 Tauri 2 + Rust 构建，支持 Windows / macOS / Linux。

简体中文 | English | 日本語 | 繁體中文

---

项目总览 • 项目概述 • 关联生态 • 核心特性 • 系统架构 • 环境要求 • 快速开始 • 应用预览 • 版本区别 • 目录结构 • 研发活跃 • 增长趋势 • 社区支持

---

项目总览与指标

工程核心运行与研发指标
最新正式版	累计下载量	开源许可证	自动化构建
代码库体积	代码语言	运行时	界面语言
快速操作快捷入口：

---

项目概述

AzurPilot Launcher 致力于让全功能《碧蓝航线》自动化助手 AzurPilot 在 Windows、macOS 与 Linux 上以原生方式一键运行——无论是 Apple Silicon 的 Mac Mini，还是传统 x86 主机，都无需转译、无需 Docker、不污染系统环境。

启动器从同一份 stable.json 按需下载 Git/ADB 二进制、deploy 脚本和配置模板，再由内嵌 uv 在本机安装最新稳定 Python 3.14.x 与 Python 依赖，通过 deploy 脚本更新仓库和构建 WebUI。缺少部署引导文件时首页显示“部署”；系统简体中文且为北京时间时优先 CNB，其他情况优先 GitHub，也可手动切换组件、Python 和 PyPI 镜像。用户无需预装 Git、uv 或 Python。详见部署引导组件。

---

关联生态工程

本工程与相关联的核心项目紧密联动，关键依赖与来源项目如下：

跨平台启动器 (当前项目) 面向 Windows / macOS / Linux 的一体化桌面启动器，打通环境搭建、代码更新、依赖同步与 WebUI 生命周期管理。

核心自动化引擎本体 《碧蓝航线》自动化助手核心，包含完备的计算机视觉图像识别、出击调度算法与本地 Web 控制台服务。

上游自动化脚本 (AzurLaneAutoScript) AzurLaneAutoScript 上游项目，碧蓝航线自动化的奠基之作，本生态链的全部自动化能力由此演化而来。

---

核心特性

零配置环境搭建 CI 仅打包 Git/ADB 等部署工具。启动器补齐引导文件，由内嵌 uv 安装最新稳定 Python 3.14 补丁版与依赖，并复用已完成的安装和下载缓存。	原生桌面壳层体验 基于 Tauri 2 的原生 WebView 壳：玻璃质感启动画面与自定义标题栏、系统托盘、Windows Toast / macOS / Linux 原生通知、单实例运行，重复启动自动聚焦已有窗口。
自动化更新体系 引导组件和启动器更新信息统一保存在 stable.json，源码由 Git 更新，Python 依赖由 uv 同步；启动器本体提供 CNB 与 GitHub 下载地址。	四语言国际化界面 内置简体中文、繁体中文、日本語、English 四种界面语言，按系统 locale 自动选择，亦可通过 --lang 启动参数强制指定。WebUI 与 Web 通知按所选语言本地化呈现。
双镜像与直连策略 系统简体中文且使用北京时间时自动优先 CNB，其余优先 GitHub。设置中可选择组件、Python 和 PyPI 镜像，全部显示镜像名。	稳健的进程与窗口管理 启动后端前自动清理端口占用进程；经环境变量标记子进程归属，退出时全进程表扫描回收，杜绝 gui.py 泄漏；启动 WebUI 免密直达（一次性令牌预置登录态），窗口打开即已登录。

---

系统架构全景

项目采用清晰的分层解耦设计，各层间职责清晰、通讯边界规范：

graph TD
    subgraph Shell ["启动器壳层 (Tauri 2 · Rust)"]
        Splash["启动画面 React launcher<br/>(玻璃质感进度条 / 错误页 React connection error)"]
        Setup["组件部署 components.rs<br/>(下载 / 校验 / 事务恢复)"]
        Tray["系统集成<br/>(系统托盘 / 原生通知 / 自定义标题栏)"]
        Backend["后端托管 backend.rs<br/>(端口清理 / 进程回收)"]
    end

    subgraph Venv ["本机运行环境 (uv 管理)"]
        PYTHON["CPython 3.14.x 解释器"]
        TOOLS[".azurpilot/tools Git / ADB"]
        SYNC["uv sync 依赖同步 (uv.lock)"]
    end

    subgraph Repo ["AzurLaneAutoScript 仓库"]
        GIT["deploy.git 仓库更新"]
        GUI["gui.py WebUI 后端"]
        WEB["WebUI 控制台 (127.0.0.1:22267)"]
    end

    Splash --> Setup
    Setup --> TOOLS
    TOOLS --> PYTHON
    Setup --> GIT
    GIT --> SYNC
    SYNC --> GUI
    Backend --> GUI
    GUI --> WEB
    Shell -. "WebView 承载 · WebSocket 通道" .-> WEB
    Tray -. "桌面通知 / 托盘控制" .-> Shell

Loading

---

环境要求

维度	准入指标	说明
操作系统		CI 以 Ubuntu 22.04 / macOS / Windows 最新版矩阵构建
WebView 运行时		Windows 7/8/10 需先安装 WebView2；Linux 需较新 glibc
Python / uv / Git / adb		启动器内嵌 uv 并自动创建 .venv，按需下载经过校验的 Python、依赖与 ADB
网络连接		下载 Python、同步依赖与更新仓库；CN 版走国内镜像加速
Node.js (仅 Windows)		未检测到系统级 Node.js 时，确认后自动下载安装（SHA-256 校验）

---

快速开始

获取压缩包 前往 Releases 最新版本 下载对应系统与 CPU 的压缩包（国际版或 CN 镜像版）。

解压并启动 Windows 运行 AzurPilot.exe（需管理员权限）；macOS 打开 AzurPilot.app；Linux 运行 AzurPilot。

等待环境初始化 启动画面实时展示进度：创建 .venv、更新仓库、同步依赖。首次启动需联网，之后重复启动只会聚焦已有窗口。

进入 WebUI 窗口打开即已登录 AzurPilot WebUI，直接配置出击任务与调度规则，开始自动化巡航。

Tip

启动器支持 --lang 参数强制指定界面语言（zh-CN / zh-TW / ja / en），以及 --skip-update 跳过仓库更新、--preview-crash 预览错误页面等调试参数。

Warning

macOS 用户：程序未经开发者签名，首次打开若报错，请先在终端运行 xattr -dr com.apple.quarantine AzurPilot.app 再启动。

Important

Linux 用户：程序依赖 libwebkit2gtk-4.1 和较新的 glibc（CI 使用 Ubuntu 22.04 构建）。若系统缺失相关库导致启动器无法运行，AzurPilot 本体通常仍可通过命令行正常使用。

---

应用预览

平台	简体中文	English
Windows
macOS

---

与原版启动器的区别

相较于 AzurLaneAutoScript 自带的 Electron 启动器：

#	差异点	说明
1	全平台支持	不再局限于 Windows，macOS（含 Apple Silicon 原生）与 Linux 均可运行
2	更新策略重构	按统一清单更新独立组件，校验成功后成组提交；重复启动仅重新聚焦已有窗口
3	依赖版本锁定	Python 包由启动器在本机调用 uv，按项目锁文件同步
4	adb 策略	不再重启和替换 adb
5	目录结构调整	Python 环境位于 .venv，Git/ADB 位于 .azurpilot/tools，两者独立维护
6	本机构建前端	Python 依赖就绪后由 deploy 脚本调用 Node.js/npm 构建 WebUI

---

目录结构

AzurPilot 根目录
* Windows: AzurLaneAutoScript
* macOS:   AzurPilot.app/Contents/AzurLaneAutoScript
* Linux:   AzurLaneAutoScript

AzurPilot 启动器
* Windows: AzurLaneAutoScript/AzurPilot.exe
* macOS:   AzurPilot.app/Contents/MacOS/AzurPilot
* Linux:   AzurLaneAutoScript/AzurPilot

Python
* Windows: .venv/Scripts/python.exe
* Unix: .venv/bin/python

Components
* .azurpilot/installed.json
* .azurpilot/cache/

Adb
* Unix:    .azurpilot/tools/adb/adb
* Windows: .azurpilot/tools/adb/adb.exe

启动器会附加的环境变量
* Unix:    .venv/bin
* Windows: .venv/Scripts

---

研发活跃度

仓库研发活跃度与响应态势
代码提交频度 月度提交活跃状态	合并请求处理 已归档合并请求总计	问题反馈解决 已成功解决 Issue 统计
研发分支 主干持续交付流	自动化构建 三平台矩阵持续验证	最新提交记录 追踪最新代码演进

---

Star 增长趋势

采用自适应深浅模式的 Star-History 矢量历史图谱，直观反映项目发展脉络：

_{数据源基于 Star-History 实时更新 · 点击可查看交互式完整走势}

---

技术栈与依赖致谢

启动器技术栈

依赖组件	许可证标识	职责定位
Tauri 2		跨平台桌面壳、WebView 承载与系统集成
Rust		系统编程语言，启动器全部原生逻辑
uv		内嵌的 Python 包管理器，构建可重定位 .venv
CPython 3.14.x		自动化引擎的 Python 运行时
Git		仓库代码更新（Unix 源码编译 / Windows MinGit）
Android platform-tools		adb 调试桥，模拟器与设备通信

生态上游

依赖组件	许可证标识	职责定位
AzurPilot		核心自动化引擎本体（本启动器的服务对象）
AzurLaneAutoScript		碧蓝航线自动化的上游奠基项目

---

社区生态与支持

开源共建与参与 感谢所有参与代码提交、架构改进、问题排查与功能验证的开发者。欢迎随时提交 Issue 与 PR 参与共建！

项目成长与支持 如果本启动器为你的挂机体验带来了便利，欢迎前往仓库主页点亮 Star 支持项目演进。

---

许可证说明

本项目采用 GNU General Public License v3.0 (GPL-3.0) 协议开源——因为 AzurPilot 采用 GPLv3，本启动器与其保持一致。

---

_{AzurPilot Launcher 遵守开源协议并由社区驱动维护。如遇问题欢迎提交 Issue 或 Pull Request。}

启动与开发

打开启动器后先进入首页；点击“启动”才准备环境和启动 WebUI。首页提供“停止服务”和“修复环境”；修复会重建 .venv，保留配置和日志。启动器更新需点击确认。

开发需要 Node.js 24。

npm --prefix frontend ci
cargo tauri dev
npm --prefix frontend test
npm --prefix frontend run build
cargo build --locked --release --features custom-protocol

React launcher architecture and IPC