FGO-py：Fate/Grand Order自动化助手工具使用指南

解析项目架构与核心功能

FGO-py作为一款面向Fate/Grand Order游戏的自动化助手工具，其架构设计围绕游戏操作自动化需求展开。项目采用模块化设计，将核心功能与辅助组件清晰分离，形成了易于扩展和维护的代码结构。通过深入理解项目的目录组织，开发者可以快速定位所需功能模块，高效进行二次开发或功能定制。

核心目录功能解析

项目根目录下的关键文件夹各自承担着不同职责：

• FGO-py/：主程序目录，包含所有核心功能实现

  • fgoImage/：存储游戏图像资源，包括地图、角色、素材等各类视觉元素
  • fgoWebUI/：提供Web界面支持，实现可视化操作与监控
  • 核心脚本文件：如fgo.py（主程序入口）、fgoFarming.py（自动刷本逻辑）等

• deploy/：部署相关资源，包含Docker配置和启动脚本，可类比为"项目的启动控制台"，简化不同环境下的部署流程

• doc/：项目文档与资源，包含使用说明、界面截图等辅助材料

图1：FGO-py项目中的游戏地图资源示例，用于场景识别与自动导航

快速上手：环境搭建与启动流程

准备工作

在开始使用FGO-py前，需完成以下准备步骤：

1. 获取项目代码

   git clone https://gitcode.com/GitHub_Trending/fg/FGO-py
   cd FGO-py
   

2. 安装依赖环境

   pip install -r requirements.txt
   

启动项目的两种方式

1. 命令行界面启动（适合开发者）

# 基础启动
python fgo.py

# 指定配置文件启动
python fgo.py --config config/custom.yaml

图2：FGO-py命令行界面运行效果，展示任务执行日志与状态反馈

2. Web界面启动（适合普通用户）

# 启动Web服务器
python fgoWebServer.py
# 访问 http://localhost:8080 打开Web控制台

功能模块详解与应用场景

核心功能模块

FGO-py的核心功能通过多个模块协同实现，每个模块专注于特定领域的自动化任务：

1. 游戏操作自动化模块（fgoFarming.py）

使用场景：适用于重复刷取特定关卡、日常任务等场景，解放双手，提高游戏资源获取效率。

核心功能包括：

• 自动战斗流程控制
• 体力管理与恢复
• 战利品识别与收集

2. 图像识别模块（fgoDetect.py）

使用场景：处理游戏界面元素识别，如角色、道具、菜单等，是实现自动化的基础。

关键技术点：

• 场景识别与匹配
• 图像预处理与增强
• 多语言界面支持

3. 配置管理模块（fgoConfig.py）

使用场景：个性化调整自动化策略，适应不同游戏版本、用户偏好和设备环境。

配置参数详解

配置文件采用YAML格式，主要参数如下表所示：

参数类别	关键参数	说明	默认值
设备设置	device_type	连接设备类型	"android"
战斗设置	battle_timeout	战斗超时时间(秒)	300
资源管理	ap_recover	是否自动恢复体力	True
界面设置	language	游戏界面语言	"zh"

高级应用：定制自动化策略

队伍配置文件

通过修改fgoTeamup.ini文件定制战斗队伍：

[Team1]
name=Kizuna
servant1=1001  # 从者ID
servant2=2002  # 从者ID
servant3=3003  # 从者ID
ce1=101        # 概念礼装ID
ce2=102        # 概念礼装ID
ce3=103        # 概念礼装ID

任务调度设置

在Web界面中配置任务队列，实现多任务自动执行：

图3：FGO-py Web界面任务调度面板，支持可视化配置与监控

常见问题解答

技术架构类

Q: 为什么配置文件不在src目录下？
A: 这种设计符合"关注点分离"原则，将配置文件与源代码分离，便于不同环境下的配置管理，同时避免敏感信息混入代码仓库。

Q: 项目中大量图片资源的作用是什么？
A: 这些图片作为模板用于游戏界面元素识别，是实现自动化操作的视觉基础，包括地图、角色头像、道具图标等多种类型。

使用操作类

Q: 如何解决设备连接问题？
A: 确保ADB驱动已正确安装，设备开启调试模式，可通过adb devices命令检查连接状态。对于Docker部署，需配置正确的网络映射。

Q: 如何定制自动战斗策略？
A: 可通过修改队伍配置文件、调整战斗参数或编写自定义战斗脚本实现，高级用户可扩展fgoFarming.py中的战斗逻辑类。

总结

FGO-py通过模块化设计和灵活配置，为Fate/Grand Order玩家提供了强大的自动化辅助功能。无论是希望简化日常游戏操作的普通玩家，还是对游戏自动化技术感兴趣的开发者，都能从项目中找到实用价值。通过本文介绍的目录结构解析、启动流程和配置方法，您可以快速掌握项目的核心使用方式，并根据个人需求进行定制扩展。