更新与排查
常见问题可先查看 下载与更新 FAQ 或 启动与连接 FAQ。
软件更新
正式版启动时会后台检查更新。进入“设置 → 软件更新”查看说明并主动下载。默认在校验成功后自动重启安装，也可关闭这一选项；安装失败时会尝试恢复旧版。
1.3.4.0 已正式发布，新客户端从 GGEA 源码仓库检查更新。旧客户端继续访问 GGEA-Release，可通过兼容过渡包升级；安装后自动切换到主仓库入口。两个仓库的过渡包字节一致，旧版本仍可继续使用。网络不可用时稍后重试；手动下载请以 正式发布页 的实际发布为准。
无法启动
检查是否完整解压、目录是否可写，以及 VC++ v14 x64 运行库是否正确安装。不要只复制 EXE。
找不到设备
检查 ADB 路径、模拟器调试开关、区服与目标实例，参考 连接模拟器。
反馈问题
通过 GitHub Issues 提供：
- 模拟器名称、版本和截图尺寸。
- 执行的单项任务、预期行为与实际表现。
- 问题附近的脱敏日志。
不要提交账号凭证或完整私人配置。
备份与识别排查
升级前备份 config/、自定义 AP 方案、坐标和模板。不要用新包直接覆盖自己的配置；保留原始 ZIP 用于核验。
账号区域的“设备已连接”仅表示 ADB 在线，并不表示已完成游戏账号状态检测。
图像识别依赖随发布包提供的 OpenCvSharp 原生库；不要单独移动或删除
OpenCvSharpExtern.dll。若出现
Microsoft.ML.OnnxRuntime.NativeMethods初始化异常，先安装或修复上述 VC++ x64 运行库并重启程序。仍失败时重新完整解压匹配版本的发布包，保留onnxruntime.dll与resources/common/ocr/；新诊断会记录底层异常和错误码，不能仅凭外层错误认定缺少运行库。领取每日使命奖励依赖网络与账号同步状态，遇到人机验证、数据同步确认或下载确认时会中止启动。
ADB 与游戏界面需要用户本机正确配置；游戏更新、账号状态差异或模板过期均可能导致自动化停止。
证据截图保存位置：自动留存的商店确认原始截图与同名诊断说明统一保存到程序目录 logs/shop；主界面识别证据包保存在 logs/recognition。开发扫描与位置验证工具的截图及配套 JSON 统一保存到项目 logs/captures。旧目录中的历史证据不会自动迁移；MuMu 截图进程间传输临时文件仍在读取后删除，识别模板仍保存在 resources/common/templates。