FGO-py 助手工具使用指南

如何快速了解 FGO-py 项目结构

FGO-py 是一款专为 Fate/Grand Order 游戏设计的自动化助手工具，通过合理的目录组织实现了功能模块化。就像一间井井有条的工作室，每个区域都有明确分工，让你轻松找到所需功能。

核心目录功能速览

• FGO-py/：项目主目录，包含所有核心代码和资源
• deploy/：部署相关文件，就像工具的"安装说明书"，提供不同环境的启动方案
• doc/：项目文档库，存放使用教程和功能说明
• fgoImage/：图像资源中心，包含游戏地图、角色头像等视觉素材

术语解析：模块化指将软件分解为独立的功能单元，就像乐高积木，每个模块负责特定功能，组合起来形成完整系统。

💡 提示：初次接触项目时，建议先浏览 doc 目录下的说明文档，快速了解工具 capabilities。

实践场景示例

• 想修改自动化策略？查看 FGO-py 目录下的核心脚本
• 需部署到服务器？ deploy 目录提供了 Docker 配置方案
• 要替换游戏内图片资源？ fgoImage 目录包含所有视觉素材

进阶探索：尝试通过修改 fgoImage/map/atlas 目录下的地图文件，自定义游戏内场景识别模板，提升自动化适配性。

如何启动 FGO-py 项目

启动 FGO-py 就像驾驶汽车，需要先了解控制面板和操作流程。项目提供了图形界面和命令行两种启动方式，满足不同用户习惯。

启动方式对比

方式	适用人群	特点
图形界面	新手用户	直观可视化，操作简单
命令行	高级用户	灵活可控，适合脚本集成

图：FGO-py 图形界面控制台，显示任务调度和运行日志

💡 提示：首次使用推荐图形界面启动，通过直观的按钮操作快速上手；熟悉后可尝试命令行方式，实现更复杂的自动化流程。

基本启动步骤

1. 安装依赖：确保已安装 requirements.txt 中的所有依赖包
2. 配置设备：通过设置连接手机或模拟器
3. 选择模式：根据需求启动 GUI 或 CLI 模式
4. 开始运行：加载队伍配置并启动自动化任务

进阶探索：尝试使用 deploy/Docker 目录下的容器配置，实现项目的快速部署和环境隔离，避免依赖冲突。

如何配置 FGO-py 实现个性化自动化

配置文件就像工具的"遥控器"，通过调节参数可以精确控制自动化行为。FGO-py 提供了灵活的配置选项，让你根据游戏策略自定义各种参数。

核心配置项说明

• 队伍配置：设置出战从者和御主礼装，决定战斗阵容
• 战斗策略：调整技能释放顺序、宝具使用时机等战斗逻辑
• 任务调度：规划日常任务执行顺序，如素材 farming、QP 获取等

图：命令行模式下的配置与任务执行界面

💡 提示：配置前建议备份原始配置文件，以便在修改出错时快速恢复。对于复杂配置，可先在测试环境验证效果。

常见配置问题解决

• 参数设置错误：检查日志文件中的错误提示，定位问题配置项
• 自动化效率低：优化技能释放顺序和目标选择逻辑
• 适配性问题：更新图像识别模板，确保与游戏版本匹配

进阶探索：深入研究 fgoConfig.py 文件，了解配置参数的底层实现逻辑，创建符合个人游戏习惯的定制化配置方案。

如何利用地图资源提升自动化体验

FGO-py 的地图资源不仅是游戏场景的视觉呈现，更是自动化导航的关键依据。这些精心设计的地图文件帮助工具准确识别游戏内位置，实现精准操作。

图：游戏场景地图，标记有各类任务地点和资源点

地图资源应用场景

• 场景识别：帮助工具判断当前所在关卡和位置
• 路径规划：优化任务执行路线，减少无效操作
• 目标定位：快速找到素材掉落点和任务目标

💡 提示：如果游戏更新导致场景变化，可通过替换对应地图文件来保持自动化的准确性。

进阶探索：尝试使用图像编辑工具自定义地图标记，突出个人常用的 farming 地点，进一步提升自动化效率。

通过以上指南，你已经掌握了 FGO-py 的基本使用方法。这款工具不仅能帮助你自动完成重复的游戏任务，更是学习 Python 自动化和图像识别技术的绝佳实践项目。随着使用深入，你会发现更多定制化的可能性，让工具真正成为你的游戏助手。