Troubleshooting
FgoGotran 故障排查
手机用户通常只需要检查权限、API 和语音设置。模拟器问题更多，请优先导出错误纪录 TXT。
先判断你是哪种情况
不要从所有问题逐个看。先按自己的使用环境走对应部分。
手机用户先看权限
大多数真机问题来自悬浮窗、无障碍、API Key 或语音 Key。按下面手机检查走一遍通常就够了。
模拟器用户先导出错误纪录
模拟器问题更常见，尤其是截图、图形渲染、32 位实例、Android 版本和渠道包名。请优先导出 TXT。
投屏用户保持手机亮屏
FgoGotran 读取的是手机 Android 当前画面，不是电脑窗口。手机黑屏时通常无法翻译。
先重现，再导出
让问题出现一次后再打开错误纪录，这样 TXT 里才有真正有用的错误。
先导出错误纪录
路径：设置页 → 错误纪录 → 导出 TXT。模拟器用户尤其建议先发这个文件。
先让问题出现一次，再导出 TXT。否则错误纪录可能是空的，或者没有记录到真正的问题。
先让问题出现一次
例如启动服务失败、点 GO 不翻译、没有语音、测试 API 失败，或模拟器没有截图。
打开错误纪录
回到 FgoGotran，进入设置页，点击错误纪录。
看最上面的记录
最新问题会在上方。重点看标题、code、detail、server、mode、speaker。
导出 TXT
点击导出 TXT，然后把这个文件发给作者。不要只发一张截图。
一起说明使用环境
告诉作者你用的是手机还是模拟器、FGO 服务器、翻译模式，以及 FgoGotran 版本。
手机用户
真机问题通常比较少，优先检查权限、API、语音和 OCR 时机。
启动服务前
确认悬浮窗权限、FgoGotran 无障碍服务都已开启。首页如果显示未启用，先处理权限。
不翻译时
日服才需要翻译 API。先到 API 设置页点测试 API；简中服、繁中服主要是读取中文文本并朗读。
没有语音时
进入语音设置，确认 AI 语音开启、Speech Key 已填写、区域正确，然后点测试语音。
OCR 不准时
等文字完全显示后再点 GO。裁剪模式请框住完整文字区域，避免把太多无关 UI 放进去。
模拟器不能用先看这里
模拟器更容易出问题，重点看 64 位实例、Android 版本、截图、图形渲染、悬浮窗和包名。
模拟器不是一台真正手机。不同模拟器的截图、悬浮窗、无障碍实现可能不同，所以手机正常但某些模拟器失败是可能的。
推荐 64 位 + Android 11 以上
旧版、32 位或测试版内核更容易遇到截图、OCR、原生库和无障碍兼容问题。MuMu、雷电、BlueStacks 都优先新建 64 位实例。
先测手动 GO
手动 GO 能翻译，说明 API 和 OCR 基本可用；问题多半在半自动/全自动的画面变化检测或模拟器事件。
没有返回截图
如果错误纪录出现没有返回截图、当前显示器无效或 bitmap_null，优先切换 OpenGL、DirectX、Vulkan，并重启模拟器。
按钮不显示或不能点
模拟器可能显示权限已允许，但实际拦截悬浮窗或无障碍。重新开启悬浮窗、无障碍，再启动服务确认 GO / 半 / 全 是否出现。
半自动/全自动不动
手动 GO 正常但自动模式不动时，通常不是 API 问题，而是模拟器画面事件、截图刷新或游戏窗口状态不稳定。
渠道服或特殊包名
如果使用 B 服、台服、渠道服或模拟器改包名，错误纪录 TXT 会包含 package、class、app label，方便加入支持。
确认模拟器环境
优先使用新版 64 位实例，并确认 Android 版本是 11 或以上。旧版 MuMu X、测试版内核或 32 位实例不建议作为首选。
启动服务后看按钮
如果 GO / 半 / 全 没出现，先处理悬浮窗和无障碍。模拟器里权限显示已允许，不一定代表系统真的放行。
先用手动 GO 测一次
手动 GO 能用，再测试半自动和全自动；手动 GO 也不能用，就先看截图、OCR、API 或语音设置。
看到截图错误就换渲染器
没有返回截图、当前显示器无效、bitmap_null 多半是模拟器图形层问题。切换渲染器后重启模拟器，再重现一次。
导出错误纪录 TXT
如果还是失败，把 TXT、模拟器名称和版本、Android 版本、32/64 位、图形渲染模式、FGO 服务器一起发给作者。
手机投屏到电脑
电脑能看到游戏画面，不代表 FgoGotran 一定能读取画面；关键是手机本机画面是否仍然真实显示。
不建议使用会让手机屏幕黑屏的投屏模式。FgoGotran 需要手机上的 Android 截图，黑屏时通常无法翻译。
为什么电脑有画面但 App 不能翻译
投屏软件只是把手机画面显示到电脑。FgoGotran 仍然运行在手机里，只能通过 Android 截图读取手机当前显示内容。
为什么手机黑屏会失败
手机屏幕关闭、变黑或进入省电投屏模式时，Android 可能不给应用真实游戏截图，所以 OCR 没文字。
推荐方式
优先 USB 有线投屏，并保持手机屏幕亮起。scrcpy 这类工具可以使用 stay-awake / keep-active 选项。
亮度影响不大
普通屏幕亮度通常不影响 Android 截图像素；真正影响的是息屏、黑屏、隐私屏或特殊显示层。
常见错误含义
错误纪录里看到这些标题时，可以先按对应方法处理。
悬浮窗权限未授权
App 没有显示在其他应用上层的权限，所以按钮无法显示在 FGO 上。
去系统设置允许 FgoGotran 显示在其他应用上层，再回到首页启动服务。
无障碍服务未启用
Android 没有把游戏画面事件交给 FgoGotran。
进入系统无障碍设置，关闭后重新开启 FgoGotran。
没有返回截图 / 当前显示器无效 / bitmap_null
Android 或模拟器没有给 App 可用的游戏截图。
手机保持亮屏；模拟器切换图形渲染模式；投屏时不要使用黑屏模式。
API 请求失败
翻译接口没有正常返回。
在 API 设置页重新测试，确认 Key、模型名、接口地址、余额和网络。
Azure TTS 请求失败
语音服务没有正常返回音频。
在语音设置页测试语音，确认 Speech Key 与区域匹配。
未支持的 FGO 包名
App 看到一个疑似 FGO 的包名，但还没有加入支持列表。
导出错误纪录 TXT，里面会包含 package、class 和 app label。
反馈模板
照这个格式回复，可以更快判断是权限、模拟器、API、语音还是包名问题。
FgoGotran 版本： 设备：手机 / 模拟器 手机或模拟器型号： 模拟器架构：32 位 / 64 位 / 不知道 图形渲染：OpenGL / DirectX / Vulkan / 不知道 Android 版本： FGO 服务器：日服 / 简中服 / 繁中服 使用模式：手动 / 半自动 / 全自动 / 裁剪 问题现象： 错误纪录 TXT：已附上 问题画面截图：已附上 / 暂无