三個項目的關係

三個倉庫經常被誤認為「三個版本」，實際是一個引擎 + 兩個宿主。選錯倉庫會導致你把啟動器當成腳本本體，或者以為 Android 版有獨立的功能實現。

實線：啟動與代碼分發；虛線：設備控制鏈路。核心程序不關心自己被誰拉起。

職責對照

倉庫	預設分支	語言 / 框架	許可證	負責	不負責
wess09/AzurPilot	master	Python 3.14 · React · Vite	GPL-3.0	調度、識別、遊戲邏輯、WebUI、API、MCP	準備 Python 環境、託管進程、手機適配
wess09/AzurPilotLauncher	main	Rust · Tauri 2	GPL-3.0	桌面環境自舉、代碼更新、後端進程託管、托盤與通知	任何遊戲行為
wess09/AzurPilot-for-Android	main	Kotlin · Compose · C++ · Python Runtime	AGPL-3.0	PRoot 運行時、虛擬熒幕、特權服務、OCR 加速、遠程客戶端	遊戲邏輯（複用上游核心）

預設分支不是 master

核心倉庫用 master，另外兩個用 main。從舊文章複製連結時經常在這裏 404。

依賴方向

Launcher ──git pull──▶ AzurPilot（核心仓库）
   │                      ▲
   └──uv sync──▶ .venv     │
                           │ 同一份源码被打包进 rootfs
Android ──PRoot──▶ Ubuntu 24.04 ──▶ AzurPilot

• 啟動器不包含核心代碼。它在首次啟動時 git clone 核心倉庫，之後每次啟動 git pull 並 uv sync。所以「啟動器版本」和「核心版本」是兩條獨立的版本線。
• Android 宿主內置核心代碼。Runtime 鏡像裏已經包含一份 AzurPilot 源碼與前端構建產物，因此斷網也能啟動；上游更新通過單獨的腳本熱更新通道完成。
• 三者共享同一套 WebSocket 協議。Android 的 AzurPilotGateway 與瀏覽器 WebUI 訂閲的是同一個 /api/v1/ws。

我應該下載哪個

你的情況	選擇	入口
有 Windows / macOS / Linux 電腦，用模擬器	Launcher	安裝啟動器
沒有電腦，或想讓舊手機專職掛機	Android APK	安裝 Android 版
已經在用其他機器上的實例，只想用手機看	Android APK 的遠程客戶端模式	遠程客戶端
要改代碼、寫新任務、調 API	源碼	源碼運行
伺服器 / NAS / 樹莓派	Docker 或源碼	Docker 部署

版本與更新節奏

三個倉庫獨立發佈，版本號不互相對應：

• 核心：跟隨 master 滾動更新，沒有嚴格的語義化版本；WebUI 的「更新」頁可以查看提交列表並按需應用。
• 啟動器：帶版本號的 Release（壓縮包），通過 mTLS 通道自更新，支援多鏡像回退。
• Android：雙軌發佈——輕量 APK（宿主代碼）+ Runtime（rootfs 鏡像）。兩者都按 ABI 分發。

升級其中一個組件後會發生什麼，見更新、備份與遷移。

Docker 部署

核心倉庫自帶 Dockerfile 與 docker-compose.yml，適合無桌面環境：

git clone https://github.com/wess09/AzurPilot.git
cd AzurPilot
docker compose up -d --build

鏡像分「構建前端 → Python 運行時」兩個階段，容器內以 .venv/bin/python gui.py 啟動。倉庫另有 deploy/docker/Dockerfile.cn 供國內網絡使用。

容器內沒有模擬器

容器只提供 WebUI 與調度器。模擬器仍在宿主機上運行，需要把 ADB 連接埠映射進容器，或用 network_mode: host。具體做法取決於你的模擬器與網絡拓撲。

許可證

許可證具有傳染性：分發修改版時必須同時遵守 GPL-3.0 / AGPL-3.0。Android 宿主因為通過網絡提供服務，AGPL 要求向網絡用戶提供對應源碼。