FGO-py 快速上手：从架构解析到环境配置的全流程指南

FGO-py 是一款针对 Fate/Grand Order 游戏的自动化助手工具，专为对游戏开发和自动化脚本感兴趣的程序员设计。本文将通过项目架构解析、核心模块使用和环境配置指南三大篇章，帮助你快速掌握项目的核心逻辑与实操方法，轻松实现游戏自动化操作。

一、FGO-py 架构解析指南

1.1 核心目录树与功能定位

如何快速理解项目的组织方式？FGO-py 采用模块化设计，主要目录结构如下：

FGO-py/
├── fgoImage/        # 图像资源库，含地图、素材等游戏图像
├── fgoWebUI/        # Web 界面相关文件
├── deploy/          # 部署脚本与配置模板
├── doc/             # 项目文档与示例截图
└── 核心脚本文件     # 如 fgo.py、fgoDevice.py 等功能实现

其中，fgoImage/map/atlas/ 目录存储游戏地图资源，例如 2-1.png 是游戏内区域地图，包含任务点与路径标识，为自动化导航提供视觉参考：

1.2 模块关系与数据流向

项目各模块如何协同工作？核心流程如下：

1. 设备连接层（fgoDevice.py）：通过 ADB 或模拟器接口连接游戏设备
2. 图像识别层（fgoDetect.py）：解析 fgoImage/ 中的图像模板，识别游戏界面元素
3. 任务执行层（fgoFarming.py）：根据配置文件自动执行战斗、素材收集等任务
4. 日志与调度（fgoLogging.py、fgoSchedule.py）：记录操作日志并管理任务队列

数据流向为：设备输入 → 图像识别 → 任务逻辑处理 → 设备输出，形成完整的自动化闭环。

1.3 核心文件功能速览

哪些文件是项目的"大脑"？关键脚本及其作用：

• fgo.py：主程序入口，整合各模块并启动自动化流程
• fgoConfig.py：配置管理中心，存储用户偏好与运行参数
• fgoOcr.py：文字识别工具，解析游戏内文本信息（如体力值、任务名称）

二、核心模块调用方法

2.1 设备连接与初始化

如何让工具识别你的游戏设备？通过 fgoDevice.py 模块实现：

from fgoDevice import DeviceManager

# 初始化设备管理器
device = DeviceManager()
# 连接安卓设备（支持 USB/模拟器）
device.connect(adb_path="/usr/bin/adb", device_id="emulator-5554")
# 验证连接状态
if device.is_connected():
    print("设备连接成功！")

🛠️ 场景应用：当使用模拟器时，需确保 ADB 路径正确，可通过 adb devices 命令获取设备 ID。

2.2 战斗自动化模块使用

如何实现自动战斗？调用 fgoFarming.py 中的战斗逻辑：

from fgoFarming import BattleHandler

# 加载队伍配置（预设阵容）
battle = BattleHandler(team_config="Kizuna")
# 启动战斗循环（指定关卡与次数）
battle.start_farming(stage="1-1", repeats=10)

🔧 参数说明：team_config 对应 fgoTeamup.ini 中的队伍配置，stage 需与 fgoImage/map/ 中的地图标识匹配。

2.3 日志与监控功能

如何追踪自动化过程？通过 Web UI 或命令行查看实时日志：

Web UI 提供任务调度、日志查看和配置修改功能，可通过 fgoWebServer.py 启动本地服务访问。

三、环境配置参数详解

3.1 基础环境搭建

开始前需要准备什么？

1. 依赖安装：通过 requirements.txt 安装必要库

   pip install -r requirements.txt
   

2. 设备配置：
   • 安卓设备开启 USB 调试
   • 模拟器设置端口转发（如夜神模拟器默认端口 62001）

3.2 配置文件分类与优先级

配置参数保存在哪里？按优先级从高到低为：

1. 环境变量：覆盖配置文件的临时参数（如 FGO_DEVICE_ID=emulator-5554）
2. 用户配置：fgoConfig.py 中的自定义设置
3. 默认配置：项目内置的 fgoConst.py 常量

📌 示例配置（fgoConfig.py）：

class Config:
    # 基础设置
    AUTO_HEAL = True  # 自动使用圣晶石恢复体力
    BATTLE_TIMEOUT = 300  # 战斗超时时间（秒）
    # 高级设置
    OCR_THRESHOLD = 0.8  # 文字识别置信度

3.3 命令行启动与参数示例

如何通过命令行启动工具？

# 基础启动（使用默认配置）
python fgo.py

# 指定队伍配置与设备
python fgo.py --team Kizuna --device emulator-5554

# 后台运行模式
nohup python fgo.py > fgo.log 2>&1 &

通过以上步骤，你已掌握 FGO-py 的核心架构、模块使用与环境配置方法。根据实际需求调整配置参数，即可实现高效的游戏自动化操作。更多高级功能可参考 doc/ 目录下的详细文档。