FGO-Automata自动化脚本零基础上手：3大核心步骤+5个避坑指南
项目地址: https://gitcode.com/gh_mirrors/fg/FGO-Automata 准备篇：15分钟环境搭建
Python与依赖库安装
首先确保你的电脑已安装Python环境，推荐使用Python 3.8及以上版本。打开终端执行以下命令安装项目所需依赖：
pip install -r requirements.txt # 安装所有必要的Python库
💡 小贴士：如果出现权限错误，Windows用户可尝试在命令前添加python -m，macOS/Linux用户添加sudo。
跨平台工具配置对比表
| 工具 | Windows安装方法 | macOS安装方法 |
|---|---|---|
| ADB | 从官网下载平台工具包并添加到环境变量 | brew install android-platform-tools |
| Tesseract OCR | 从GitHub下载安装包并勾选添加到PATH | brew install tesseract |
设备连接与调试开启
- 在手机上开启开发者选项（通常连续点击版本号7次）
- 启用USB调试模式（位于开发者选项中）
- 连接电脑后在终端验证：
adb devices # 查看已连接设备列表
💡 小贴士：如果设备未显示，尝试更换USB线缆或重新安装手机驱动。
操作篇：从启动到运行的实战教程
项目获取与示例运行
首先获取项目代码：
git clone https://gitcode.com/gh_mirrors/fg/FGO-Automata
cd FGO-Automata
运行示例脚本测试基础功能：
python example.py # 执行示例自动化流程
三步解决图像识别异常
-
模板图片检查
确认/assets/cn或/assets/jp目录下的模板图片与游戏实际UI匹配，重点检查：- attack.png（攻击按钮）
- cards.png（指令卡区域）
- start.png（开始战斗按钮）
-
分辨率适配调整
脚本默认优化于特定分辨率，如你的设备分辨率不同，需：- 修改核心识别代码中的坐标参数
- 或调整手机显示设置中的分辨率
-
阈值参数优化
在图像比对代码中适当调整阈值（通常在0.7-0.9之间）：# 示例：调整匹配阈值 result = cv2.matchTemplate(screen, template, cv2.TM_CCOEFF_NORMED) locations = np.where(result >= 0.85) # 将0.85调整为适合的值
🔍 常见误区：直接使用他人提供的模板图片而不考虑自己的设备分辨率和游戏版本。
脚本配置与自定义
项目提供了多种启动方式：
daemon.py：基础守护进程模式daemoncn.py：针对国服优化版本REPL.py：交互式命令行模式
根据你的游戏服务器选择合适的启动脚本，例如国服用户：
python daemoncn.py
进阶篇：解决复杂场景问题
模板图片制作完全指南
当默认模板不适用时，可自行制作模板图片：
- 截取游戏界面关键元素（建议使用截图工具精确裁剪）
- 保存为PNG格式并命名为对应功能（如"friend.png"）
- 放置到对应服务器目录（国服放/assets/cn，日服放/assets/jp）
图：模板图片制作示例（战斗结算界面识别模板）
五大常见错误及解决方案
错误1：ADB设备未找到
解决步骤：
- 重新插拔USB连接
- 在手机上确认USB调试授权弹窗
- 重启adb服务：
adb kill-server && adb start-server
🔍 常见误区：忽略手机上的USB调试授权请求，导致电脑无法识别设备。
错误2：OCR文字识别失败
解决步骤：
- 确认Tesseract已正确安装并添加到环境变量
- 检查游戏画面是否清晰无遮挡
- 尝试调整截图区域提高识别率
🔍 常见误区：在光线不足或画面模糊的情况下运行脚本，导致文字识别率下降。
错误3：战斗流程卡住
解决步骤：
- 查看日志确定卡在哪个界面
- 检查对应模板图片是否匹配
- 调整代码中的等待时间参数
🔍 常见误区：未根据网络状况调整等待时间，导致页面未加载完成就执行下一步操作。
错误4：支持角色选择失败
解决步骤：
- 更新support.png模板图片
- 确保好友列表已刷新完成
- 调整支持角色选择的坐标范围
🔍 常见误区：在游戏更新后未及时更新模板图片，导致界面元素识别失败。
错误5：指令卡点击偏差
解决步骤：
- 校准cards.png模板位置
- 调整代码中的点击坐标偏移量
- 确保游戏画面无缩放
🔍 常见误区：使用自定义分辨率或画面缩放，导致预设坐标失效。
社区支持与资源
项目文档与Wiki
项目提供了详细的使用文档和API说明，建议重点阅读：
- README.md（项目概述）
- README_CN.md（中文说明）
- assets/README.md（模板图片说明）
问题反馈与交流
如遇到无法解决的问题，可以：
- 检查项目Issues页面查看是否有类似问题
- 加入相关技术交流群组（需通过项目文档获取最新群组信息）
- 提交详细的错误报告，包括：错误信息、操作步骤、设备型号和游戏版本
💡 小贴士：提问时请附带运行日志和截图，以便更快定位问题。
结语
FGO-Automata自动化脚本为玩家提供了便捷的游戏辅助功能，但请始终遵守游戏规则，合理使用自动化工具。随着使用深入，你可以尝试自定义脚本逻辑，实现更复杂的自动化流程。祝你的御主之路更加顺畅！
图：FGO-Automata自动化战斗流程展示
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
