GGEA丨使用文档

简体中文

日本語

简体中文

日本語

外观

完整操作说明

本文整理自桌面程序 v1.3.3.2 的随包使用说明。当前站点仍为本地项目；正式版下载见 下载与安装。

首次设置

  1. 将整个发布包解压到一个可写文件夹。不要只复制 GGEA.exe；它必须与 OpenCvSharpExtern.dll、config、resources 保持同级目录结构。
  2. 启动 Android 模拟器，并确认游戏已安装。若模拟器提供 ADB 调试开关，请先开启。
  3. 首次运行 GGEA.exe 自动从运行进程、安装注册表、常见目录和 PATH 检索 ADB。只有一个候选时自动选择；多个候选时优先选择可读取执行记录中最近运行的 ADB。系统记录缺失或受限时会提示无法判断，请在设置下拉列表确认。后续启动保留已保存的选择，不重复覆盖。
  4. 检索失败时会提示并打开设置，请点击“浏览…”选择模拟器的 adb.exe（BlueStacks 为 HD-Adb.exe），点击“保存”后路径会保留在下拉列表中，重启仍可选择。点击取消则不保存本次编辑。便携版、非标准安装目录或受限目录可能需要手动选择。
  5. 按需选择模拟器主程序并检查启动参数：MuMu 默认使用第一个安卓实例，雷电默认使用 launch --index 0；BlueStacks 会自动配对同一安装目录中的 HD-Adb.exe 与 HD-Player.exe。
  6. BlueStacks 用户还需在模拟器“设置 → 高级”中启用 Android Debug Bridge 并保存；否则 GGEA 会显示针对性提示。
  7. 选择当前游戏的区服与语言后保存设置（包名自动确定），返回主界面点击“刷新”，确认目标设备显示为可用状态。

启动并进入游戏

已运行模拟器时，先在设备列表选择目标设备，再点击“启动模拟器 / 打开游戏”。程序会连接 ADB、等待设备可用并打开游戏。选定 ADB 或刷新后，程序仅保留已确认且启动身份一致的在线目标；首次发现、原目标离线或重启后须手动选择，不会自动换到其他账号。同一实例的 TCP 与 emulator-* 地址仅在 boot_id 一致时视为同一目标。执行任务前请确认选择的是目标账号所在的设备。设备品牌独立识别，MuMu 使用管理器实例信息补充识别，并按启动标识合并重复连接。

业务自动化当前要求模拟器输出 1920×1080 横屏截图；尺寸不符时会停止自动点击，但“截图”功能仍可用于检查和调整设置。“开发&强化一次”默认勾选，使用所选设备的截图与标准 ADB 拖动，不再按品牌禁用。进入路线图时保留游戏当前缩放，通过两张立绘模板及多尺度搜索找到目标；连续两帧稳定命中才点击，找不到、标题消失、达到搜索上限或取消时停止。

进入每日任务前，请先在游戏内手动确认账号、网络和活动弹窗均正常。遇到人机验证、数据同步或下载确认时，程序会停止自动操作；请手动处理后再重新开始。

每日任务

  1. 在“每日任务”列表勾选需要的项目，可拖拽调整执行顺序。
  2. 点击“任务开始”后，程序会按列表顺序执行，并在流程之间返回主界面确认状态。
  3. 需要中止时，点击“中止任务”按钮。中止后请先确认游戏当前页面，再重新发起任务。

推荐先仅勾选一个低风险项目验证设备和模板匹配正常，再逐步启用其余任务。

AP 消耗与关卡导航

  1. 在“AP消耗”页选择或维护作品与 HARD 关卡，再保存需要的方案。
  2. 作品坐标、模板和 stageSwipeCanvasDelta 必须在当前模拟器分辨率下验证；更换模拟器、窗口缩放或游戏版本后，请重新校准。
  3. 导航优先使用整屏滑动；整屏滑动无法将作品落入安全点击区时，程序才会使用一次固定半屏滑动。
  4. 出现点击错位、未解锁、标题识别失败或滑动异常时立即停止，不要连续重试。请保留 logs/ 中的日志以便排查。

模板维护工具

“截图”“保存模板”和“测试模板”用于维护识别素材：先截取当前模拟器画面，框选稳定且有辨识度的区域，保存后在同一页面测试置信度与坐标。游戏 UI 更新后，旧模板可能失效，应重新采集并测试。

主题、日志、更新与问题处理

  • 点击右上角设置旁的灯泡切换日间／夜间模式，偏好立即保存，下次启动自动恢复；首次运行默认夜间模式。

  • 任务结束提醒由“设置 → 启用 Windows 通知”控制，包括每日队列、独立 AP 消耗、自动招募、自动刷本、自动推图与铁球工厂；用户中止或资源不足时会显示停止原因。

  • “设备已连接”仅表示 ADB 连接可用，不代表已检测游戏账号状态。

  • 运行日志位于 logs/，包含操作顺序、识别结果和错误原因。

  • 升级前请备份 config/、自定义 AP 方案、坐标数据和自定义模板。更换版本时不要直接覆盖自己的配置；先备份，再按需迁移。源码发布脚本会覆盖 artifacts/publish/，旧包备份放在 backups/ 下。

  • 若程序无法启动、找不到设备或识别异常，先确认 ADB 路径、设备连接、游戏页面和模板；不要在自动化运行中移动或删除发布包内的文件。

安全提示

GGEA 仅会在模板或页面状态满足条件时继续操作，但游戏界面、网络、账号状态与模拟器环境均可能变化。自动化执行期间请保持观察；涉及钻石、付费、账号验证或任何不确定页面时，立即停止并手动确认。

文件与分发包

统一运行程序根目录的 GGEA.exe。config 保存配置，resources 保存识别资源，logs 保存运行日志。完整解压并保留这些目录。

发布压缩包提供本文件“使用说明.txt”，不包含 Markdown 文档、开发 README、运行日志、调试符号和历史测试版本目录。源码仓库的 README.md 面向开发者，不随压缩包分发。

证据截图保存位置：自动留存的商店确认原始截图与同名诊断说明统一保存到程序目录 logs/shop；主界面识别证据包保存在 logs/recognition。开发扫描与位置验证工具的截图及配套 JSON 统一保存到项目 logs/captures。旧目录中的历史证据不会自动迁移；MuMu 截图进程间传输临时文件仍在读取后删除，识别模板仍保存在 resources/common/templates。

本机插件

  • 关闭程序后将可信插件完整放入 plugins/<id>/，启动后在设置中启用并保存，再次重启生效。
  • 插件具有与程序相同的本机权限，不是安全沙箱。安装、更新和卸载均在退出后进行。
  • 配置保存在 config/plugins/；主程序在线更新保留插件。插件清理失败时停止新设备操作，可在设置中停用并重启。
  • 旧版扩展配置会保留供插件导入。插件未安装或未启用时不执行扩展功能。