FGO-py 助手工具完全使用指南

核心组件解析

FGO-py 作为 Fate/Grand Order 的自动化助手工具，采用模块化架构设计，主要分为三大功能区域，让我们逐一了解每个模块的核心作用和源码位置。

核心功能区

这部分是项目的灵魂所在，包含实现自动化游戏操作的核心逻辑。

• 游戏自动化模块 [FGO-py/fgo.py] 负责处理游戏内的各种自动化操作，如战斗流程控制、角色选择等核心功能。

• 设备连接模块 [FGO-py/fgoDevice.py] 管理与移动设备的连接，支持多种连接方式，确保指令能够准确发送到设备。

• 图像识别模块 [FGO-py/fgoDetect.py] 通过图像识别技术，识别游戏界面元素，为自动化操作提供视觉依据。

• 任务调度模块 [FGO-py/fgoSchedule.py] 允许用户设置定时任务，实现如定时清体力、定时抽卡等自动化操作。

辅助工具区

这些工具为核心功能提供支持，同时也为用户提供了更多便捷操作。

• 日志系统 [FGO-py/fgoLogging.py] 记录系统运行过程中的关键信息，方便问题排查和功能优化。

• Web 界面 [FGO-py/fgoWebUI/] 提供直观的网页操作界面，让用户可以通过浏览器轻松配置和控制自动化任务。

图：FGO-py 运行时的 Web 界面，展示了任务调度和日志信息

• 命令行工具 [FGO-py/fgoCli.py] 提供命令行操作方式，适合高级用户进行快速配置和调试。

配置存储区

该区域负责存储项目的配置文件和资源，确保系统能够灵活适应不同用户的需求。

• 配置文件 [FGO-py/fgoConfig.py] 集中管理项目的各项配置参数，允许用户根据自己的游戏习惯进行个性化设置。

• 图像资源 [FGO-py/fgoImage/] 存储游戏图像识别所需的各类资源图片，如地图、角色肖像等。

图：FGO-py 中的游戏地图资源示例，用于场景识别和定位

• 临时文件 [FGO-py/fgoTemp/] 用于存储运行过程中产生的临时数据，确保主目录的整洁。

---

快速上手流程

零基础也能轻松上手 FGO-py，只需按照以下三个步骤操作，即可快速启动项目。

环境检测

在开始之前，我们需要确保你的环境满足项目运行要求。

🔧 操作步骤：

1. 检查 Python 版本：确保已安装 Python 3.8 或更高版本

   python --version
   

2. 检查 adb 工具：确保已安装 Android 调试桥（ADB）工具

   adb --version
   

3. 检查 Git：确保已安装 Git 版本控制工具

   git --version
   

⚠️ 注意事项：如果以上命令有任何一个提示"命令未找到"，请先安装相应的软件。

依赖安装

接下来，我们需要获取项目代码并安装所需依赖。

🔧 操作步骤：

1. 克隆项目仓库

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

2. 安装 Python 依赖

   pip install -r requirements.txt
   

⚠️ 注意事项：如果安装过程中出现权限问题，可以尝试在命令前添加 sudo（Linux/Mac）或使用管理员权限运行命令提示符（Windows）。

启动验证

完成上述步骤后，我们可以启动项目并进行简单验证。

🔧 操作步骤：

1. 连接移动设备：确保手机已开启 USB 调试模式并连接到电脑
2. 启动 FGO-py

   python fgo.py
   

3. 在命令行中输入 help 查看可用命令
4. 尝试加载预设队伍配置

   teamup load Kizuna
   

图：FGO-py 命令行界面示例，展示了队伍加载和任务执行过程

---

配置实战指南

FGO-py 提供了丰富的配置选项，让我们从基础到高级逐步了解如何配置项目以满足个人需求。

基础配置

基础配置涵盖了项目运行的基本参数，是使用 FGO-py 的第一步。

参数名称	默认值	允许范围	使用建议
device	自动检测	设备ID字符串	通常保持默认即可，多设备时需指定
language	zh	zh, ja, en	根据游戏语言设置
resolution	1920x1080	常见手机分辨率	设置为你设备的实际分辨率
interval	0.5	0.1-2.0	操作间隔，低配置设备可适当增大

🔧 配置方法： 修改 fgoConfig.py 文件中的相应参数，或在命令行中使用 config 命令动态设置。

高级参数

高级参数允许你更精细地控制自动化行为，适合有一定经验的用户。

参数名称	默认值	允许范围	使用建议
terminateAfter	0	0-100	设置自动停止前的战斗次数，0表示无限
stopOnSpecialDrop	0	0-5	遇到特殊掉落时停止，0表示不停止
stageRetry	3	1-10	关卡失败后的重试次数
priority	normal	low, normal, high	任务优先级，影响执行顺序

⚠️ 注意事项：高级参数设置不当可能导致自动化行为异常，请谨慎调整。

环境变量

环境变量提供了一种不修改代码即可配置项目的方式，特别适合在不同环境中部署。

常用环境变量：

• FGO_DEVICE：指定设备ID
• FGO_LANGUAGE：设置语言
• FGO_DEBUG：设置为"true"启用调试模式
• FGO_CONFIG：指定自定义配置文件路径

🔧 设置方法： 在启动前设置环境变量，例如：

export FGO_DEBUG=true
python fgo.py

---

常见启动问题排查

即使按照步骤操作，有时也可能遇到启动问题。以下是几个常见错误及解决方法。

错误1：设备未找到

错误信息：No device found 可能原因：

• 手机未开启 USB 调试
• USB 数据线连接不良
• ADB 驱动未正确安装

解决方法：

1. 确认手机已开启 USB 调试（设置 > 开发者选项 > USB 调试）
2. 尝试更换 USB 数据线或 USB 端口
3. 重新安装手机驱动或 ADB 工具

错误2：依赖包缺失

错误信息：ModuleNotFoundError: No module named 'xxx' 可能原因：

• 依赖包未完全安装
• 虚拟环境未激活

解决方法：

1. 重新安装依赖

   pip install -r requirements.txt
   

2. 检查是否在正确的虚拟环境中运行

错误3：图像识别失败

错误信息：Image recognition failed 可能原因：

• 游戏分辨率与配置不符
• 图像资源文件缺失或损坏
• 游戏界面未处于初始状态

解决方法：

1. 确保配置的分辨率与游戏实际分辨率一致
2. 检查 fgoImage/ 目录下的资源文件是否完整
3. 启动前确保游戏已处于主界面

错误4：权限不足

错误信息：Permission denied 可能原因：

• 没有足够的文件系统权限
• ADB 权限不足

解决方法：

1. 尝试使用管理员权限运行命令
2. 重启 ADB 服务

   adb kill-server
   adb start-server
   

错误5：配置文件损坏

错误信息：Config file corrupted 可能原因：

• 配置文件被意外修改
• 配置文件格式错误

解决方法：

1. 删除损坏的配置文件，系统会自动生成默认配置
2. 从项目备份中恢复配置文件

cp fgoConfig.py.bak fgoConfig.py

通过以上指南，你应该已经能够顺利安装、配置和运行 FGO-py 助手工具了。如果遇到其他问题，可以查看项目文档或在社区寻求帮助。祝你的 FGO 之旅更加轻松愉快！