环境与兼容性
这一页只列会导致直接失败的条件。性能建议放在后面，硬性要求放在前面。
硬性要求
| 维度 | 桌面（启动器 / 源码） | 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）加密，绑定设备；换机器后需要重新录入。