FGO-py项目架构与使用指南：从入门到精通

📁 核心架构解密：如何快速理解FGO-py的内部构造

FGO-py作为一款Fate/Grand Order游戏助手工具，其架构设计围绕自动化游戏操作为核心，采用模块化设计实现功能解耦。项目结构解析对于开发者快速定位功能模块至关重要，以下是基于实际项目文件的架构分析：

核心目录结构

FGO-py/
├── fgoImage/        # 图像资源库，包含游戏场景、素材等图片
├── fgoWebUI/        # Web界面相关文件
├── deploy/          # 部署配置目录，含Docker和AidLux环境脚本
├── doc/             # 项目文档与截图
├── fgo.py           # 主程序入口
├── fgoConfig.py     # 配置管理模块
└── requirements.txt # 依赖包清单

图1：FGO-py项目中的游戏场景地图资源，用于自动化战斗定位

关键模块解析

• 核心功能层：通过fgoKernel.py实现游戏逻辑控制，fgoDevice.py处理设备连接
• 图像识别层：fgoDetect.py负责游戏画面分析，依赖fgoImage/目录下的素材资源
• 配置管理层：fgoConfig.py统一处理用户设置，支持多环境配置切换
• 用户界面层：提供fgoGui.py图形界面和fgoCli.py命令行两种操作方式

[!TIP] 开发环境建议关注fgoWebUI/目录下的前端资源，部署环境则重点配置deploy/目录中的脚本文件。

🚀 快速通关：5分钟上手FGO-py的实操流程

环境准备

📌 步骤1：获取项目代码

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

📌 步骤2：安装依赖

pip install -r requirements.txt

📌 步骤3：启动程序

• 图形界面模式（推荐新手）：

  python fgoGui.py
  

• 命令行模式（适合服务器部署）：

  python fgoCli.py
  

图2：FGO-py图形界面运行状态，显示任务调度与日志输出

基础操作流程

1. 设备连接：通过USB或ADB无线连接安卓设备
2. 队伍配置：在fgoTeamup.ini中设置作战队伍
3. 任务启动：在界面选择"清空体力"或"每日任务"
4. 监控运行：通过日志面板查看实时执行状态

[!TIP] 首次使用建议先运行python fgoRunOnce.py进行环境检测，确保所有依赖正常加载。

⚙️ 进阶配置指南：从默认设置到个性化定制

核心配置参数优化

参数类别	配置项	默认值	建议值	应用场景
战斗设置	terminateLater	0	1	允许战斗结束后延迟退出
设备设置	adbConnectTimeout	5	10	解决低网速环境连接问题
任务调度	stopWhenFever	False	True	fever模式时暂停任务

配置文件修改方法

📌 修改步骤：

1. 复制模板配置：cp fgoConfig.py.example fgoConfig.py
2. 使用文本编辑器打开：nano fgoConfig.py
3. 修改对应参数后保存
4. 重启程序使配置生效

图3：FGO-py命令行模式下的配置与任务执行过程

多环境部署方案

• 本地开发环境：直接运行fgo.py，适合功能调试
• Docker部署：使用deploy/Docker/Dockerfile构建镜像，实现隔离运行
• 移动设备：通过deploy/AidLux/AidLux.sh脚本在AidLux系统部署

[!TIP] 配置冲突解决：当自定义配置不生效时，检查fgoTemp/目录下是否存在缓存配置，删除后重启程序即可。

❓ 常见问题解答

Q1：程序无法识别游戏画面怎么办？
A1：确保游戏分辨率设置为1920x1080，且未启用画面缩放。可运行python fgoImageListener.py测试图像识别功能。

Q2：如何添加自定义战斗脚本？
A2：在fgoScript.txt中按指定格式编写脚本，通过script load命令加载。详细语法参考doc/versions.md文档。

Q3：Docker部署时设备连接失败？
A3：需使用--network=host参数启动容器，或通过adb connect命令手动连接设备IP。

通过以上指南，您已掌握FGO-py的核心架构与使用方法。项目持续更新中，建议定期查看doc/versions.md获取最新功能说明。