環境與兼容性
這一頁只列會導致直接失敗的條件。性能建議放在後面，硬性要求放在前面。
硬性要求
| 維度 | 桌面（啟動器 / 源碼） | Android 宿主 |
|---|---|---|
| 操作系統 | Windows 10+、macOS、Linux（較新 glibc） | Android 9.0+（API 28） |
| 架構 | x64 / ARM64 | ARM64-v8a 或 x86_64，不支援 32 位 |
| 運行時 | 啟動器自帶 Python 3.14.6；源碼需要 Python 3.14 + uv | 內置 Ubuntu 24.04 + Python 3.14 |
| 記憶體 | 建議 8 GB 以上（模擬器 + 後端） | 最低 4 GB，建議 6 GB 以上 |
| 存儲 | 約 5 GB（依賴 + 資源 + 日誌） | 最低 2.5 GB，建議 5 GB |
| 顯示 | WebUI 需要現代瀏覽器 | — |
| 遊戲解像度 | 1280×720（識別資源基準，不可更改） | |
Linux 上的啟動器依賴
啟動器需要 libwebkit2gtk-4.1 與較新的 glibc（CI 使用 Ubuntu 22.04 構建）。如果發行版太舊導致啟動器無法運行，核心程序通常仍可以用命令行方式運行。
模擬器
核心程序通過 ADB 連接模擬器。以下是配置中內置的預設 Serial，可直接填入「模擬器 Serial」：
| 模擬器 | 預設 Serial | 備註 |
|---|---|---|
| MuMu 模擬器 12 | 127.0.0.1:16384 | 多開依次遞增 |
| MuMu 模擬器 / MuMu X | 127.0.0.1:7555 | — |
| MuMu Pro（macOS） | 127.0.0.1:16384 | 多開為 16416、16448… |
| 雷電模擬器 | emulator-5554 或 127.0.0.1:5555 | 另有 ldopengl 專用截圖方案 |
| 夜神模擬器 | 127.0.0.1:62001 | 64 位為 127.0.0.1:59865 |
| 藍疊模擬器 | 127.0.0.1:5555 | Hyper-V 版填 bluestacks5-hyperv |
| 逍遙模擬器 | 127.0.0.1:21503 | — |
不知道 Serial 時，可以在模擬器安裝目錄的 adb 中執行 adb devices 查詢；也可以在設定裏填 auto 自動檢測，但多個模擬器同時運行時不適用。
截圖與控制方案
預設「自動選擇」會跑一次性能測試挑選最快的截圖方案。常見速度排序：DroidCast_raw > aScreenCap_nc > ADB_nc > aScreenCap ≈ uiautomator2。MuMu 與雷電有專用方案（nemu_ipc、ldopengl）。控制方案推薦 MaaTouch。
網絡
| 場景 | 需要能訪問 |
|---|---|
| 啟動器首次啟動 | GitHub（拉取核心倉庫）、PyPI 或鏡像、npmmirror（Python standalone） |
| Android 完整包 | 無需聯網即可解壓縮 Runtime；更新需要 GitHub / CNB |
| Android 輕量包 | GitHub Release 或 CNB（下載約 1 GB Runtime） |
| 運行時 | 遊戲伺服器、更新檢查、可選的遠程訪問服務 |
國內網絡可使用啟動器的 -cn 鏡像版部署配置，或 Android 設定中的 CNB 下載源。啟動器在更新代碼、安裝依賴與連接本地 WebUI 時會繞過系統代理，避免代理干擾本地迴環。
遊戲內設定
以下設定直接影響識別與流程推進，必須在開始任務前完成。
路徑：主介面 → 右下角設定 → 左側邊欄。
| 設定項 | 推薦值 | 影響 |
|---|---|---|
| 幀數設定 | 60 幀 | 幀率過低會導致動畫未結束就截圖 |
| 大型作戰 · 減少 TB 引導 | 開 | 減少大世界進入時的引導彈出視窗 |
| 大型作戰 · 自律時自動提交道具 | 開 | 避免背包滿導致自律中斷 |
| 大型作戰 · 安全海域預設開啟自律 | 關 | 腳本需要自行決定是否自律 |
| 劇情自動播放 | 開啟 | 否則劇情會卡住 |
| 劇情自動播放速度 | 特快 | 縮短等待 |
| 待機模式 | 關 | 待機畫面會干擾識別 |
| 重複角色獲得提示 | 關 | 彈出視窗會打斷流程 |
| 快速更換二次確認 | 關 | 減少一次點擊 |
| 展示結算角色 | 關 | 結算畫面遮擋 |
大型作戰：潛艇支援
路徑：大型作戰 → 右上角雷達 → 指令模組 → 潛艇支援。取消勾選「X 消耗時潛艇出擊」。
一鍵退役
路徑：主介面 → 建造 → 退役 → 齒輪 → 一鍵退役設定。
| 設定項 | 推薦值 |
|---|---|
| 選擇優先級 1 / 2 / 3 | R / SR / N |
| 有滿星同名艦船時保留 | 不保留 |
| 無滿星同名艦船時保留 | 滿星所需或不保留 |
圖像識別注意事項
以下內容會讓模板匹配失準，建議在掛機帳號上去除：
- 角色設備裝備（會改變立繪區域）
- 角色皮膚
- 任何遮擋介面元素的自定義顯示內容
如果識別持續失敗，先恢復預設皮膚與裝備，再疑難排解解像度與縮放。
帳號與安全
- WebUI 預設只監聽本機。開放到區域網絡或公網前必須設定密碼，否則任何人拿到地址都能操作你的帳號。
- 遠程訪問使用獨立配對憑據，不暴露 WebUI 主密碼；撤銷配對不會影響主密碼。
- 不要把
config/remote-access.json、config/deploy.yaml、password.txt提交到 Git 或發給他人。 - 帳號保險庫使用系統級密鑰（Windows DPAPI / TPM）加密，綁定設備；換機器後需要重新錄入。