---
url: /launcher.md
description: 基于 Tauri 2 + Rust 的跨平台桌面启动器：内置 uv 与 Python、自动拉取核心代码、托管后端进程。
---

# AzurPilot Launcher

启动器解决的是「装 Python、配依赖、拉代码、起服务」这四件事。它不包含游戏逻辑，只负责把核心程序跑起来，并把它包装成一个正常的桌面应用。

![启动器正在更新 AzurPilot](/img/launcher-update.jpg)

##  它到底做了什么

```text
解压 → 启动器进程 → 启动画面 → 环境自举（uv/Python/git/adb）
     → git 更新核心仓库 → uv sync --frozen
       → 启动 gui.py → 打开 WebUI（免密直达）→ 托盘常驻
```

| 能力 | 实现 |
| --- | --- |
| 环境自举 | 内嵌 uv，下载 Python 3.14.6，创建可重定位 `.venv` |
| 工具链 | git、adb 一并装进 `.venv`，不污染系统 |
| 代码更新 | `git pull`，失败重试至多 20 次 |
| 依赖同步 | `uv sync --frozen`，按 `uv.lock` 锁定 |
| 后端托管 | 清理端口占用、注入环境标记、退出时全进程表回收 |
| 自更新 | mTLS 校验 + 多镜像回退 |
| 系统集成 | 托盘、原生通知、单实例、开机自启 |
| 国际化 | 简中 / 繁中 / 日语 / 英语，按系统 locale |

##  与核心程序的关系

| | 启动器 | 核心程序 |
| --- | --- | --- |
| 仓库 | AzurPilotLauncher | AzurPilot |
| 语言 | Rust / Tauri | Python / React |
| 版本线 | 独立版本号 | 跟随 `master` 滚动 |
| 更新 | 自更新（mTLS） | `git pull` + `uv sync` |
| 包含游戏逻辑 | 否 | 是 |

::: tip 两个版本号不是一回事
启动器 1.x 可以配任意核心提交。更新启动器不会回退核心代码，更新核心也不会改启动器。
:::

##  环境要求

| 维度 | 要求 |
| --- | --- |
| 系统 | Windows 10+、macOS、Linux（较新 glibc） |
| WebView | Windows 需 WebView2；macOS 用系统 WKWebView；Linux 需 `libwebkit2gtk-4.1` |
| 权限 | Windows 需要管理员（安装 ADB、写系统目录） |
| 网络 | 首次启动需联网下载 Python 与依赖 |
| 磁盘 | 约 3–5 GB（含 .venv 与仓库） |

##  目录结构

```text
AzurLaneAutoScript/                 # Windows / Linux 根目录
AzurPilot.app/Contents/AzurLaneAutoScript/   # macOS

├── alas-launcher.exe / alas-launcher
├── .venv/                          # Python + uv + git + adb
├── config/                         # 实例配置与 deploy.yaml
├── frontend/                       # 核心仓库的前端
├── log/                            # 运行日志
└── AzurPilot_Data_Backup/          # 每日备份
```

启动器会向子进程追加环境变量：

| 平台 | PATH 追加 |
| --- | --- |
| Unix | `.venv/bin` |
| Windows | `.venv/Scripts`、`.venv/Scripts/git/cmd` |

##  与原版启动器的差异

| 项 | 本启动器 |
| --- | --- |
| 平台 | Windows / macOS / Linux |
| 更新策略 | 只更新 git 仓库，依赖用 `.venv` 内的 uv 同步 |
| 依赖锁定 | `uv.lock` 精确锁定，默认自动同步 |
| adb | 不重启、不替换 |
| 工具位置 | 全部收进 `.venv` |
| Node.js | 仅 Windows：检测系统 Node，缺失时可自动安装（SHA-256 校验） |

##  继续阅读