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、不污染系统环境。

启动器内嵌 uv 包管理器，首次启动自动创建可重定位的 .venv（Python 3.14.6），经 git 拉取最新代码并同步依赖后，启动 Python WebUI 后端，并以原生 WebView 壳承载——内置启动画面、系统托盘、桌面通知与自定义标题栏。界面支持简体中文、繁体中文、日语、英语四种语言，按系统环境自动选择。

---

关联生态工程

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

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

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

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

---

核心特性

零配置环境搭建 启动器内嵌 uv，首次运行自动下载 Python 3.14.6 并创建可重定位 .venv，同时将 uv、git、adb 一并部署进虚拟环境。用户机器无需预装 Python、uv 或 Git，开箱即跑。	原生桌面壳层体验 基于 Tauri 2 的原生 WebView 壳：玻璃质感启动画面与自定义标题栏、系统托盘、Windows Toast / macOS / Linux 原生通知、单实例运行，重复启动自动聚焦已有窗口。
自动化更新体系 启动时经 git 自动拉取最新代码（最多重试 20 次），再用 uv sync --frozen 按 uv.lock 精确同步依赖；启动器本体经 mTLS 安全通道自更新，支持多镜像回退。	四语言国际化界面 内置简体中文、繁体中文、日本語、English 四种界面语言，按系统 locale 自动选择，亦可通过 --lang 启动参数强制指定。WebUI 与 Web 通知按所选语言本地化呈现。
双镜像与直连策略 提供国际版与 -cn 国内镜像版两种部署配置；Python standalone 下载默认走 npmmirror 加速。更新代码、内置 Python、uv 与依赖安装，以及 WebView 与本地 WebUI 的连接均绕过系统代理，减少环境干扰。	稳健的进程与窗口管理 启动后端前自动清理端口占用进程；经环境变量标记子进程归属，退出时全进程表扫描回收，杜绝 gui.py 泄漏；启动 WebUI 免密直达（一次性令牌预置登录态），窗口打开即已登录。

---

系统架构全景

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

graph TD
    subgraph Shell ["启动器壳层 (Tauri 2 · Rust)"]
        Splash["启动画面 alas-splash://<br/>(玻璃质感进度条 / 错误页 alas-error://)"]
        Setup["环境搭建 setup.rs<br/>(Python / uv / adb / git 安装与迁移)"]
        Tray["系统集成<br/>(系统托盘 / 原生通知 / 自定义标题栏)"]
        Backend["后端托管 backend.rs<br/>(端口清理 / 进程回收)"]
    end

    subgraph Venv [".venv 运行时 (uv 管理 · 可重定位)"]
        PYTHON["CPython 3.14.6 解释器"]
        TOOLS["uv / git / adb 内置工具链"]
        SYNC["uv sync --frozen 依赖同步 (uv.lock 锁定)"]
    end

    subgraph Repo ["AzurLaneAutoScript 仓库"]
        GIT["Git 自动更新 (deploy.git.GitManager · 重试 20 次)"]
        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 承载 · SSE 通知流" .-> WEB
    Tray -. "桌面通知 / 托盘控制" .-> Shell

Loading

---

环境要求

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

---

快速开始

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

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

等待环境初始化 启动画面实时展示进度：创建 .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	更新策略重构	只更新 git 仓库，并用 .venv 内置的 uv 同步依赖；重复启动仅重新聚焦已有窗口，不做破坏性清理
3	依赖版本锁定	Python 包版本由 pyproject.toml 与 uv.lock 锁定，自动同步默认启用，杜绝环境漂移
4	adb 策略	不再重启和替换 adb
5	目录结构调整	Python / uv / git / adb 全部收纳进 .venv，详见下方目录结构
6	Node.js 自动化 (Windows)	检测系统级 Node.js；未检测到时可在确认后自动下载并安装

---

目录结构

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

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

Python / uv
* 所有系统: .venv

Git
* Unix:    .venv/bin/git
* Windows: .venv/Scripts/git/cmd/git.exe

Adb
* Unix:    .venv/bin/adb
* Windows: .venv/Scripts/adb.exe

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

---

研发活跃度

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

---

Star 增长趋势

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

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

---

技术栈与依赖致谢

启动器技术栈

依赖组件	许可证标识	职责定位
Tauri 2		跨平台桌面壳、WebView 承载与系统集成
Rust		系统编程语言，启动器全部原生逻辑
uv		内嵌的 Python 包管理器，构建可重定位 .venv
CPython 3.14.6		自动化引擎的 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。}