---

功能概览

⚔️ 关卡与战斗

🧩 编队与羁绊优化

羁绊补齐默认使用实时扫描。先运行“构建个人从者礼装库”，再分别开启“使用本地从者库”和“使用本地礼装库”，可显著减少仓库扫描时间。库存文件缺失、损坏或扫描未完成时会自动回退到实时模式；召唤、出售或礼装状态变化后建议重新构建。

“当前编队羁绊最大化”只允许从编队确认页启动；“修改所有礼装”默认关闭，因此已有礼装默认会被保留。助战及其礼装始终不会被编辑。

🛠 基础流程与日常养成

此外支持自定义队伍、助战从者与礼装、战斗次数，以及金 / 银 / 铜 / 蓝苹果补充策略。

---

支持范围

资源包

登录和关闭游戏目前提供 B 服、4399 服、vivo 服、享游服、应用宝服、日服和小米服包名选项。不同渠道仍需选择与游戏画面对应的资源包。

运行要求

• Windows 操作系统
• 雷电或 MuMu 安卓模拟器，也可手动填写 ADB 端口
• 模拟器分辨率必须为 1280 × 720
• Windows 系统区域必须为中文（简体，中国）

⚠️ 雷电 14 上部分功能可能不可用，例如自动启动游戏、任务结束后自动关闭游戏。建议使用雷电 9 或 MuMu 获得完整体验。

---

快速开始

1. 下载并解压

前往 Releases 下载最新版 MXU.zip，完整解压后运行。MXU 是桌面客户端，无需浏览器。

2. 安装 BBchannel

1. 将 BBC 文件夹放入 MaaFgo 根目录。
2. 将 bbcdll 文件夹内的文件复制到 BBchannel\dist\BBchannel64，替换同名文件。

视频教程：

• 完整使用教程
• BBchannel 安装方法

3. 配置模拟器

1. 将模拟器分辨率固定为 1280 × 720。
2. 启动游戏并保持画面无遮挡。
3. 在 MaaFgo 中选择对应资源包和渠道包名。
4. 使用雷电 / MuMu 自动检测，或手动填写 ADB 端口后连接。

4. 选择任务并启动

普通刷本可依次配置章节 / 关卡、队伍、战斗次数、助战和苹果策略。需要 Chaldea 编队时，将分享链接、队伍 ID、关卡 ID、本地 JSON 文件或缓存名称填入“Chaldea 队伍导入”。

部分任务对起始页面有要求，请以界面中的任务说明为准。自动化运行期间不要手动点击或滚动画面。

5. 可选：启用快速羁绊编队

1. 从游戏主界面运行“构建个人从者礼装库”。
2. 选择扫描“从者和礼装”“仅从者”或“仅礼装”；礼装可扫描全部 4/5 星或仅羁绊礼装。
3. 等待任务完整扫描到列表底部。结果保存在 config/Inventory/player_servants.json 和 config/Inventory/player_equips.json。
4. 在羁绊补齐任务中开启对应的本地库选项。

扫描采用完成后原子替换；任务中止、超时或识别失败时，会保留已有的有效库存文件。

---

维护文档

• 个人从者与礼装库构建
• Chaldea 羁绊补齐自动编队
• 当前编队羁绊最大化补齐
• 羁绊补齐测试验证清单
• 羁绊数据维护工具
• 识图美术资源目录约定

---

开发相关

项目结构

MaaFgo/
├── agent/          # Python Agent 与 Custom Action
├── assets/         # 图片、Pipeline、任务及选项配置
├── config/         # 用户本地配置与运行时生成的数据（默认不提交）
├── docs/           # 功能设计、验证记录与维护说明
├── BBchannel/      # BBchannel 战斗核心
├── bbcdll/         # BBC 接口补丁
├── deps/           # MaaFramework 依赖
└── tools/          # 数据维护和开发工具

技术栈

• 核心框架：MaaFramework — 图像识别与自动化流程
• 桌面客户端：MXU — 基于 Tauri 2 + React 的通用 GUI
• 战斗核心：BBchannel
• 地图导航：基于 YOLO / ONNX 的地图目标检测与轮巡导航

提交资源或数据改动前，请先阅读对应的维护文档，并运行相关 JSON 校验与 git diff --check。

---

鸣谢

---

免责声明

本项目仅供学习交流使用，不得用于商业用途。使用本项目造成的任何后果由使用者自行承担。

FGO 版权归 TYPE-MOON / FGO PROJECT 所有，本项目与官方无关。

许可证

本项目基于 AGPL-3.0 License 开源。