FGO-py 架构解密：从安装到配置的零门槛指南

副标题：如何快速掌握项目核心组件与配置逻辑？

FGO-py 是一款针对 Fate/Grand Order 游戏的自动化助手工具，专为对游戏开发和自动化脚本感兴趣的程序员设计。本文将从项目架构、核心模块到环境配置，全方位解析 FGO-py 的使用方法，帮助你快速上手。

一、项目架构解析

FGO-py 采用模块化设计，核心功能集中在几个关键目录，各模块职责明确，协同工作实现自动化游戏操作。

核心目录说明

• FGO-py/：项目主目录，包含核心代码与资源文件。
• fgoImage/：存储游戏图像资源，如角色头像、地图场景等，为图像识别提供支持。
• deploy/：部署相关脚本与配置，支持 Docker 等多种部署方式。

架构设计特点

项目采用分层架构，从设备控制到任务调度，各层职责清晰：

• 设备交互层：通过 fgoDevice.py 实现与移动设备的通信。
• 图像识别层：基于 fgoDetect.py 和图像资源进行游戏画面分析。
• 任务调度层：通过 fgoSchedule.py 管理自动化任务流程。

二、核心模块速览

设备控制模块：功能定位与使用场景

负责与 Android 设备通信，实现屏幕捕获、触控模拟等基础操作。通过 fgoAndroid.py 封装了 ADB 命令，支持有线和无线连接方式。适用于需要控制物理设备或模拟器的场景，是自动化操作的基础。📱

图像识别模块：功能定位与使用场景

基于 OpenCV 和游戏图像资源，识别游戏界面元素如按钮、角色、地图等。核心代码位于 fgoDetect.py，通过模板匹配技术判断当前游戏状态。例如，在战斗中识别敌人位置、技能图标等，为自动化决策提供依据。🔍

任务调度模块：功能定位与使用场景

通过 fgoSchedule.py 定义自动化任务流程，如日常任务、材料 farming 等。支持任务队列管理，可设置任务优先级和执行条件。用户可通过配置文件自定义任务流程，满足个性化需求。⏱️

图：FGO-py 运行时的主界面，展示任务调度与日志输出

三、环境配置指南

依赖安装

第一步→克隆项目仓库：
git clone https://gitcode.com/GitHub_Trending/fg/FGO-py
第二步→安装依赖：
cd FGO-py && pip install -r requirements.txt 🔧

核心配置参数对比

配置项	默认值	自定义建议	应用场景
server.port	8080	8888	避免端口冲突
device.adb_path	系统默认	自定义 ADB 路径	多设备管理
farming.stage	1	根据需求修改	特定关卡 farming
ocr.language	zh	ja/en	多语言游戏界面
schedule.interval	60s	30s	高频任务调度

[!TIP]
配置文件位于 fgoConfig.py，修改后需重启服务生效。建议通过环境变量覆盖敏感配置，如 export FGO_DEVICE_ID=123456。

四、新手常见问题

Q1：设备连接失败怎么办？

A1：检查 ADB 服务是否启动，设备是否开启调试模式。可通过 adb devices 命令确认设备连接状态。

Q2：图像识别准确率低如何解决？

A2：更新 fgoImage/ 目录下的图像资源，确保与游戏版本匹配；调整屏幕分辨率至 1080p 以提高识别精度。

Q3：如何添加自定义任务？

A3：在 fgoScript.txt 中编写任务脚本，遵循 [任务名] + 步骤指令的格式，例如：
[日常任务]
click(100,200)
wait(5)

总结

FGO-py 通过模块化设计实现了游戏自动化的核心功能，从设备控制到任务调度，各模块协同工作。掌握核心配置与常见问题处理，能帮助你快速构建个性化的游戏助手。🚀