FGO-py 自动化助手工具：架构解析与配置指南

FGO-py 项目架构概览 📊

FGO-py 作为 Fate/Grand Order 自动化操作解决方案，采用模块化设计（Modular Design）实现游戏流程的智能管控。项目核心目录结构如下：

FGO-py/
├── fgoImage/      # 图像资源库（游戏场景/UI元素）
├── fgoWebUI/      # Web管理界面
├── deploy/        # 部署配置脚本
└── 核心模块文件   # .py实现自动化逻辑

核心功能价值矩阵

• 设备控制：跨平台游戏进程管理
• 图像识别：场景与UI元素智能解析
• 任务调度：自动化战斗与资源收集
• 配置管理：多环境参数动态适配

图1：FGO-py地图资源示例（用于场景定位与路径规划）

---

核心模块解析指南 🔍

1. 设备交互层（fgoDevice.py）

实现ADB协议（Android Debug Bridge）通信，建立PC与移动设备的连接通道：

def connect_device(self, host):
    # 初始化ADB连接
    self.adb = AdbClient(host=host)
    # 验证设备状态
    return self.adb.is_connected()

2. 图像识别引擎（fgoDetect.py）

通过模板匹配技术识别游戏界面元素：

def find_template(self, screen, template):
    # 多尺度匹配算法
    result = cv2.matchTemplate(screen, template, cv2.TM_CCOEFF_NORMED)
    return np.where(result >= 0.8)  # 置信度过滤

3. 战斗自动化模块（fgoFarming.py）

实现回合制战斗流程的全自动执行，支持自定义队伍配置与技能释放策略。

---

环境配置实操指南 ⚙️

基础环境搭建

1. 克隆项目仓库：

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

2. 安装依赖包：

   pip install -r requirements.txt
   

配置文件参数调试

核心配置文件 fgoConfig.py 关键参数说明：

• DEVICE_RESOLUTION：设备分辨率适配（建议1080x1920）
• BATTLE_TIMEOUT：战斗超时阈值（默认300秒）
• OCR_THRESHOLD：文字识别置信度（建议0.75）

调试建议：

1. 使用 config validate 命令校验配置完整性
2. 通过 --dry-run 参数进行无操作模拟测试
3. 逐步调整图像识别阈值优化识别准确率

图2：FGO-py命令行界面（展示设备连接与战斗控制流程）

Docker部署方案

通过容器化部署实现环境隔离：

docker-compose -f deploy/Docker/docker-compose.yml up -d

---

进阶使用技巧 💡

1. 脚本录制功能：使用 fgoScript.txt 记录手动操作生成自动化脚本
2. 多账号管理：通过 fgoTeamup.ini 配置多队伍轮换策略
3. 日志分析：查看 fgoLog/ 目录下的运行日志定位异常问题

项目采用环境变量注入（Environment Variable Injection）机制，支持运行时动态调整配置参数，满足不同场景的自动化需求。