Getting started
快速开始
先决定运行方式，再准备设备、游戏和网络。第一次运行不要直接挂长任务： 先用一个短任务确认截图识别与点击都正常。
文档更新：2026-10-18 · 版本以 GitHub Release 为准
先选择运行方式
两端共用同一套引擎，但运行位置不同。按手头的设备选一端，不需要同时安装。
共同前置条件
两端都需要已安装并登录对应区服的《碧蓝航线》客户端；桌面端通过模拟器运行， Android 端通过虚拟屏运行。工具不提供游戏账号或游戏本体。
- 区服正确：CN / EN / JP / TW 都受支持。创建实例时需要选择和客户端一致的区服与包名。
- 画面稳定：推荐 16:9、1280×720 与 60 帧。识别资源按 720p 标定；非该尺寸会被缩放，效果取决于设备和模拟器。
- 界面干净：移除可能遮挡识别元素的角色皮肤、装备显示或自定义内容。
- 网络可用：首次安装、解压或更新需要联网。运行期间程序也可能访问公告、日志与遥测接口。
- 存储与权限：Android 端至少预留 2.5 GB，推荐 5 GB；桌面端需要安装器、Python 依赖和模拟器空间。
游戏内设置
以下为仓库 README 标注的使用前推荐设置。路径：主界面 → 右下角设置 → 左侧边栏选项。第一次运行前请逐项确认。
| 设置项 | 推荐值 |
|---|---|
| 帧数设置 | 60 帧 |
| 大型作战 · 减少 TB 引导 | 开 |
| 大型作战 · 自律时自动提交道具 | 开 |
| 大型作战 · 安全海域默认开启自律 | 关 |
| 剧情自动播放 | 开启 |
| 剧情自动播放速度 | 特快 |
| 待机模式 | 关 |
| 重复角色获得提示 | 关 |
| 快速更换二次确认界面 | 关 |
| 展示结算角色 | 关 |
任务相关设置
- 大型作战：进入大型作战界面的右上角菜单 → 指令模块 → 潜艇支援， 取消勾选“X 消耗时潜艇出击”。
- 一键退役：主界面 → 建造 → 左侧退役 → 齿轮 → 一键退役设置， 按 README 的优先级与保留数量配置。
更完整的操作细节见 桌面端 README。不同区服的文案可能略有差异。
第一次运行
- 按所选方式完成安装或激活，具体步骤见对应文档。
- 在 WebUI 中创建一个实例，填写区服、模拟器 serial 或 Android 运行环境， 并选择任务。
- 只勾选一个短任务，启动调度器，观察截图、识别和第一次点击是否正常。 如果识别失败，先检查游戏设置、画面比例、遮挡物和截图通道。
- 验证成功后，再逐步加入每日任务、活动、大型作战等长期任务。 建议定期备份配置目录。
识别失败时先检查这些
- 游戏客户端与实例区服是否一致，是否停在可识别的页面。
- 模拟器或虚拟屏输出是否为 16:9；是否被缩放到了异常分辨率。
- 是否启用了会影响界面元素的皮肤、装备显示或额外遮罩。
- 截图通道是否正常。桌面端 MuMu 12 可以使用 nemu_ipc；Android 端先确认激活和虚拟屏状态。
- 游戏内设置是否仍保持推荐值，尤其是剧情播放与大型作战选项。