FGO-py 自动化工具从入门到精通：架构解析与实战指南

项目架构概览：如何快速掌握FGO-py的模块设计？

FGO-py作为Fate/Grand Order的自动化助手工具，采用模块化架构设计，各目录间形成清晰的功能协作关系。核心模块按"数据-逻辑-交互"三层划分，整体结构如下：

📂 核心功能模块图谱

基础支撑层

• FGO-py/fgoImage/：存储游戏场景识别所需的图像资源，包括地图素材、角色头像等，是图像识别模块的视觉数据库。
• FGO-py/fgoLog/：运行日志记录目录，自动保存操作轨迹和错误信息，建议定期清理以避免磁盘占用过大。
• FGO-py/fgoTemp/：临时文件缓存区，存放运行时生成的截图和中间数据，程序退出后自动清空。

业务逻辑层

• FGO-py/fgoFarming.py：核心战斗脚本，实现自动刷本、技能释放等战斗逻辑，支持自定义队伍配置。
• FGO-py/fgoDevice.py：设备连接管理模块，负责与安卓设备建立ADB通信，支持有线和无线连接方式。
• FGO-py/fgoDetect.py：图像识别引擎，通过模板匹配技术识别游戏界面元素，如战斗按钮、敌人血条等。

交互界面层

• FGO-py/fgoWebUI/：Web管理界面，提供可视化操作面板，适合非技术用户快速上手。
• FGO-py/fgoCli.py：命令行交互工具，支持高级用户通过指令精确控制脚本行为。
• FGO-py/fgoGui.py：桌面图形界面，整合常用功能为可视化按钮，降低操作门槛。

图1：游戏地图资源示例（FGO-py/fgoImage/map/atlas/2-1.png），展示自动化脚本依赖的场景识别素材

核心模块解析：三个关键文件带你理解运行机制

🔧 启动流程核心代码解析

主程序入口：FGO-py/fgo.py 该文件作为程序总入口，实现了"配置加载-设备连接-任务调度"的完整启动流程：

1. 环境初始化：通过load_config()函数读取配置文件，优先加载用户自定义配置，若无则使用默认参数
2. 设备检测：调用DeviceManager.connect()建立与移动设备的通信，支持多设备同时连接
3. 任务调度：Scheduler类根据配置文件中的任务列表，按优先级顺序执行自动化操作

关键函数解析：main_loop()采用异步非阻塞设计，在执行战斗任务的同时仍能响应外部指令，建议通过config.thread_pool_size参数调整并发数（推荐值：2-4线程）

💻 界面交互双模式解析

Web界面：FGO-py/fgoWebUI/index.html 基于Flask框架构建的管理界面，提供：

• 实时任务监控面板
• 队伍配置可视化编辑器
• 运行日志在线查看

图2：Web管理界面（doc/alas.png），显示任务调度状态和实时日志

命令行工具：FGO-py/fgoCli.py 适合高级用户的终端交互模式，支持：

# 常用指令示例
teamup load Kizuna      # 加载队伍配置
connect host:port       # 连接远程设备
config terminateLater 1 # 设置战斗结束延迟
main                    # 启动主任务

图3：命令行交互界面（doc/cli.png），展示设备连接和任务执行过程

环境配置指南：从安装到运行的3个关键步骤

1. 开发环境搭建

依赖安装

# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/fg/FGO-py
cd FGO-py

# 安装依赖包（建议使用虚拟环境）
pip install -r requirements.txt

注意：Windows用户需额外安装Microsoft Visual C++ 14.0，Linux用户需安装python3-tk包

2. 配置文件优化方案

主配置文件：FGO-py/fgoConfig.py 核心参数推荐配置：

• device_type: 设备类型（android/ios，默认android）
• adb_path: ADB工具路径（建议使用绝对路径避免环境变量问题）
• screenshot_method: 截图方式（推荐"ADB"，兼容性最好）

环境变量替代方案 对于多环境部署，可通过环境变量覆盖配置：

# Linux/Mac
export FGO_DEVICE_IP=192.168.1.100:5555
export FGO_TEAM_INDEX=0

# Windows
set FGO_DEVICE_IP=192.168.1.100:5555
set FGO_TEAM_INDEX=0

3. 常见问题排查

设备连接失败

• 检查ADB是否正常运行：adb devices
• 确保设备开启USB调试模式
• 无线连接需先执行：adb tcpip 5555

图像识别错误

• 确保游戏分辨率为1080x1920（脚本最佳适配分辨率）
• 清理缓存：rm -rf FGO-py/fgoTemp/*
• 更新图像资源：git pull origin main（同步最新识别模板）

通过以上架构解析和配置指南，您已掌握FGO-py的核心工作原理和部署方法。建议从简单的"清空体力"任务开始实践，逐步熟悉高级功能如自定义战斗策略和多账号管理。