Troubleshooting
FgoGotran 故障排查
先找到你看到的現象，再按順序檢查。手機使用者通常只需要檢查權限、API 和語音設定；模擬器問題更多，請優先匯出錯誤紀錄 TXT。
先匯出錯誤紀錄
路徑：設定頁 → 錯誤紀錄 → 匯出 TXT。模擬器使用者尤其建議先發這個檔案。
先讓問題出現一次，再匯出 TXT。否則錯誤紀錄可能是空的，或者沒有記錄到真正的問題。
先讓問題出現一次
例如啟動服務失敗、點 GO 不翻譯、沒有語音、測試 API 失敗，或模擬器沒有截圖。
開啟錯誤紀錄
回到 FgoGotran，進入設定頁，點選錯誤紀錄。
看最上面的紀錄
最新問題會在上方。重點看標題、code、detail、server、mode、speaker。
匯出 TXT
點選匯出 TXT，然後把這個檔案發給作者。不要只發一張截圖。
一起說明使用環境
告訴作者你用的是手機還是模擬器、FGO 伺服器、翻譯模式，以及 FgoGotran 版本。
手機使用者
真機問題通常比較少，優先檢查權限、API、語音和 OCR 時機。
啟動服務前要檢查什麼？
大多數真機問題來自懸浮窗、無障礙、API Key 或語音 Key。
- 確認懸浮窗權限已開啟。
- 確認 FgoGotran 無障礙服務已開啟。
- 按鈕不出現時，先在系統裡關閉再重新開啟無障礙服務，這通常是最關鍵的修復。
- 首頁如果顯示未啟用，先處理對應權限再啟動服務。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
點了 GO 但不翻譯
日服才需要翻譯 API；簡中服、繁中服主要是讀取中文文本並朗讀。
- 先到 API 設定頁點“測試 API”。
- 確認 API Key、模型名和介面地址正確。
- 簡中服、繁中服改檢查語音設定，而不是翻譯 API。
確認恢復：“測試 API”成功，回到遊戲點 GO 能出現譯文。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
沒有語音
AI 語音未開啟、Speech Key 未填寫或區域不正確。
- 進入語音設定，確認 AI 語音開啟。
- 確認 Speech Key 已填寫、區域正確。
- 點“測試語音”確認能返回音訊。
確認恢復：測試語音成功，遊戲內朗讀正常。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
OCR 不準或漏翻
文字未完全顯示，或裁剪範圍包含了太多無關 UI。
- 等文字完全顯示後再點 GO。
- 裁剪模式請框住完整文字區域。
- 避免把太多無關 UI 放進去。
確認恢復：重新點 GO 後譯文覆蓋在正確文字附近。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
模擬器使用者
模擬器更容易出問題，重點看 64 位例項、Android 版本、截圖、圖形渲染、懸浮窗和包名。
用哪個模擬器或例項？
舊版、32 位或測試版核心更容易遇到截圖、OCR、原生庫和無障礙相容問題。
- 優先新建 64 位例項。
- 確認 Android 版本是 11 或以上。
- MuMu、雷電、BlueStacks 都優先使用 64 位例項。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
點了 GO 但不翻譯
要先區分是 API/OCR 問題，還是模擬器畫面事件問題。
- 先用手動 GO 測一次。
- 手動 GO 能用，再測試半自動和全自動。
- 手動 GO 也不能用，就先看截圖、OCR、API 或語音設定。
確認恢復：手動 GO 能翻譯，說明 API 和 OCR 基本可用。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
沒有返回截圖 / 當前顯示器無效 / bitmap_null
多半是模擬器圖形層問題，Android 沒有給應用可用的遊戲截圖。
- 優先切換 OpenGL、DirectX、Vulkan 渲染器。
- 重啟模擬器。
- 重新重現一次問題，再檢視錯誤紀錄。
確認恢復：切換渲染器並重啟後，手動 GO 能返回截圖。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
按鈕不顯示或不能點
模擬器可能顯示權限已允許，但實際攔截懸浮窗或無障礙。
- 重新開啟懸浮窗權限。
- 在系統無障礙設定裡關閉 FgoGotran，再重新開啟——這通常是最關鍵的一步。
- 啟動服務，確認 GO / 半 / 全 是否出現。
確認恢復：啟動服務後 GO / 半 / 全 按鈕正常顯示。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
半自動 / 全自動不動
手動 GO 正常但自動模式不動，通常不是 API 問題，而是模擬器畫面事件、截圖重新整理或遊戲視窗狀態不穩定。
- 確認手動 GO 正常。
- 檢查遊戲視窗是否穩定、未被遮擋。
- 觀察畫面變化檢測是否觸發。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
渠道服或特殊包名
B 服、臺服、渠道服或模擬器改包名可能不在支援列表裡。
- 匯出錯誤紀錄 TXT。
- 確認 TXT 裡包含 package、class、app label。
確認恢復：把 TXT 發給作者，方便加入支援。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
投屏到電腦
電腦能看到遊戲畫面，不代表 FgoGotran 一定能讀取畫面；關鍵是手機本機畫面是否仍然真實顯示。
為什麼電腦有畫面但 App 不能翻譯？
投屏軟體只是把手機畫面顯示到電腦。FgoGotran 仍然執行在手機裡，只能通過 Android 截圖讀取手機當前顯示內容。
- 確認手機螢幕仍然真實亮起顯示遊戲。
- 不要使用會讓手機螢幕黑屏的投屏模式。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
為什麼手機黑屏會失敗？
手機螢幕關閉、變黑或進入省電投屏模式時，Android 可能不給應用真實遊戲截圖，所以 OCR 沒文字。
- 保持手機螢幕亮起。
- 關閉息屏、黑屏或省電投屏模式。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
推薦用什麼方式投屏？
有線投屏比無線更穩定，也能保持螢幕常亮。
- 優先 USB 有線投屏。
- 保持手機螢幕亮起。
- scrcpy 可以使用 stay-awake / keep-active 選項。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
亮度影響大嗎？
普通螢幕亮度通常不影響 Android 截影像素。
- 真正影響的是息屏、黑屏、隱私屏或特殊顯示層，優先排查這些。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
常見錯誤含義
錯誤紀錄裡看到這些標題時，可以先按對應方法處理。
懸浮窗權限未授權
App 沒有顯示在其他應用上層的權限，所以按鈕無法顯示在 FGO 上。
- 去系統設定允許 FgoGotran 顯示在其他應用上層。
- 回到首頁啟動服務。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
無障礙服務未啟用
Android 沒有把遊戲畫面事件交給 FgoGotran。
- 進入系統無障礙設定。
- 即使顯示已開啟，也先關閉 FgoGotran 再重新開啟一次。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
沒有返回截圖 / 當前顯示器無效 / bitmap_null
Android 或模擬器沒有給 App 可用的遊戲截圖。
- 手機保持亮屏。
- 模擬器切換圖形渲染模式。
- 投屏時不要使用黑屏模式。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
API 請求失敗
翻譯介面沒有正常返回。
- 在 API 設定頁重新測試。
- 確認 Key、模型名、介面地址、餘額和網路。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
Azure TTS 請求失敗
語音服務沒有正常返回音訊。
- 在語音設定頁測試語音。
- 確認 Speech Key 與區域匹配。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。
未支援的 FGO 包名
App 看到一個疑似 FGO 的包名，但還沒有加入支援列表。
- 匯出錯誤紀錄 TXT，裡面會包含 package、class 和 app label。
仍失敗？先匯出錯誤紀錄 TXT，並說明 FgoGotran 版本、裝置、FGO 伺服器和使用模式，一起發給作者。