FGO-py 自动化工具开发指南：从架构解析到实战部署

一、功能模块架构解析

1.1 核心功能模块

FGO-py 采用模块化设计理念，主要功能模块包括设备控制层、任务调度层和图像识别层，各模块通过松耦合方式协同工作。设备控制层负责与安卓设备建立通信（基于 ADB 协议），任务调度层管理自动化流程的状态转换，图像识别层则通过模板匹配技术实现游戏界面元素的定位与解析。

图 1：FGO-py 运行时监控界面，展示任务调度与日志系统的实时状态

1.2 目录结构与模块依赖

FGO-py/
├── fgoImage/          # 图像资源库（模板图像、地图数据）
├── fgoWebUI/          # Web 管理界面（基于 Flask 实现）
├── deploy/            # 部署配置（Docker/云服务器适配）
└── 核心脚本集         # 功能实现代码（设备控制/任务逻辑）

模块依赖关系：

• 图像识别模块（fgoDetect.py）依赖 fgoImage 目录下的模板资源
• Web 服务（fgoWebServer.py）需调用任务调度模块（fgoSchedule.py）
• 设备连接模块（fgoDevice.py）为所有功能提供底层硬件访问能力

典型应用场景：自动战斗功能需依次调用设备控制模块（屏幕点击）、图像识别模块（战斗状态判断）和任务调度模块（流程控制）。

二、环境配置与参数调校

2.1 开发环境搭建

基础依赖安装：

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

# 安装 Python 依赖
pip install -r requirements.txt

操作建议：推荐使用 Python 3.8+ 环境，依赖安装前可执行 pip freeze > requirements.lock 生成版本锁定文件。

2.2 核心配置参数详解

配置文件路径：fgoConfig.py（支持运行时动态调整）

# fgoConfig.py 关键配置示例
class BattleConfig:
    # 战斗超时设置（默认值：300秒）
    # 调整建议：根据网络状况可缩短至180秒或延长至600秒
    battle_timeout = 300
    
    # 暴击星阈值（默认值：5）
    # 安全最佳实践：避免设置为0，防止误判导致战斗失败
    critical_threshold = 5

YAML 配置文件验证建议：使用 yamllint 工具进行格式校验，避免因缩进错误导致配置加载失败。

三、快速启动与实战操作

3.1 命令行模式启动

# fgoCli.py 核心启动代码
def main():
    # 加载设备配置（必须先执行）
    device = DeviceManager().connect()  # 建立ADB连接
    # 加载队伍配置（JSON格式）
    team = TeamConfig.load("team_config.json")
    
    # 启动主任务流程
    scheduler = TaskScheduler(device, team)
    scheduler.start()  # 开始自动战斗循环

if __name__ == "__main__":
    main()

启动命令：

python fgoCli.py --team=Kizuna --stage=1-7

3.2 图形界面操作

通过 fgoGui.py 启动可视化界面，主要功能区域包括：

• 任务队列管理（顶部状态栏）
• 实时战斗监控（中央视图区）
• 配置参数面板（右侧边栏）

图 2：多终端命令行操作界面，展示设备连接与任务执行过程

3.3 常见问题排查

设备连接失败：

1. 检查 ADB 服务状态：adb devices
2. 验证设备授权：开发者选项中开启"USB调试"
3. 网络连接模式需选择"文件传输"而非"仅充电"

图像识别错误：

• 清理 fgoTemp/ 目录缓存文件
• 检查游戏分辨率是否为 1920×1080（推荐配置）
• 重新校准模板图像：python fgoImageListener.py --calibrate

四、高级功能与扩展开发

4.1 地图导航系统

FGO-py 内置基于图像识别的地图导航模块，通过比对场景特征点实现自动路径规划。地图数据存储于 fgoImage/map/atlas/ 目录，包含不同章节的场景模板。

图 3：游戏内地图场景，展示区域节点与路径规划标记

4.2 自定义任务脚本

通过 fgoScript.txt 文件可编写自定义任务流程，支持条件判断与循环控制：

# 示例：每日任务执行脚本
loop 7:  # 每周循环
    execute "daily_login"  # 执行登录任务
    if AP > 100:
        execute "farm_quest", quest_id=103  # 体力充足时执行 farming
    wait 86400  # 等待24小时

五、部署与运维最佳实践

5.1 Docker 容器化部署

# deploy/Docker/docker-compose.yml 核心配置
version: '3'
services:
  fgo-py:
    build: .
    devices:
      - /dev/bus/usb:/dev/bus/usb  # 映射USB设备
    volumes:
      - ./config:/app/config  # 配置文件持久化
    restart: unless-stopped  # 异常退出自动重启

5.2 性能优化建议

• 降低图像识别频率：非战斗场景可设置为 2 秒/次
• 启用任务优先级队列：config.set_priority("main", 10)
• 定期清理日志文件：fgoLog/ 目录保留最近7天记录

通过合理配置与模块组合，FGO-py 可实现从简单日常任务到复杂活动攻略的全流程自动化，为 Fate/Grand Order 玩家提供高效的游戏辅助解决方案。