修正 Android 上 RetroArch 更換影像驅動後的黑畫面
先冷啟動並使用原本可正常運作的合法授權遊戲，移除 shader 與個別 override，再從記錄取得目前影像驅動和第一個錯誤。若更換驅動後連選單也立即變黑，應還原先前已記錄的驅動或設定備份，而不是重裝內容。每次重啟只改一項影像設定：驅動失敗、shader 不相容、核心繪圖路徑，以及 ROM、BIOS 或 CHD 稽核不完整，都需要不同修復。
依序操作
- 01
記錄 RetroArch 套件來源與版本、Android 版本、GPU、核心名稱與版本、內容識別，以及最後一次影像、shader 或 override 變更。
- 02
不載入內容並冷啟動 RetroArch；若選單可顯示，關閉 shader 與遊戲／資料夾 override，再載入一個已知正常的合法授權遊戲。
- 03
針對第一次失敗產生詳細記錄，保留目前驅動、繪圖 context 錯誤、核心訊息，以及任何內容或 firmware 缺失行。
- 04
若問題始於驅動變更，選單可見時還原先前驅動；若選單全黑，保留原檔並從備份或只從文件記載的驅動鍵值復原。
- 05
每次更改後重啟，依序測試基本驅動、核心、shader／濾鏡，最後才是縮放或多執行緒影像；不要同時改音訊、延遲與內容路徑。
- 06
把最小可用設定存於最窄範圍，一次恢復一項視覺功能，並保留記錄與回復副本供日後應用程式、OS 或 GPU 更新使用。
診斷表
| 症狀範圍 | 第一項證據 | 下一個安全動作 |
|---|---|---|
| 選單與所有核心皆黑 | 目前驅動或繪圖 context 錯誤 | 還原先前驅動／設定 |
| 選單正常、單一核心黑畫面 | 核心版本與繪圖記錄 | 以預設影像設定測試核心 |
| 只有一款遊戲黑畫面 | 內容、BIOS、CHD 與驅動稽核 | 解決第一個被點名的相依項 |
| 關閉 shader 後恢復 | shader 格式與目前驅動 | 使用相容 preset 或維持基本設定 |
先證明前端能否繪圖
選單可見只證明 RetroArch 至少能建立一個繪圖 context，不代表每個核心、硬體繪圖路徑、shader 格式或內容相依項都有效。
若更換驅動後連選單都黑，改試更多 ROM 不會增加有效證據。先復原驅動或設定，並保留失敗檔案供比較。
Shader 與驅動共用相容性邊界
Libretro 記載了依驅動而異的 shader 格式，也建議在診斷影像或效能時先關閉 shader。某個驅動可用的 preset 可能不適用另一個驅動。
從遊戲、資料夾或核心中最窄的範圍移除 preset。等同一核心與合法內容能以基本設定顯示後，再重新啟用。
只有遊戲黑畫面仍可能是內容故障
若選單和其他合法遊戲都能顯示，先讀取第一個核心或內容錯誤再懷疑 GPU。缺少 BIOS、parent、裝置 ROM 或 CHD 都可能讓機器停止。
把影像復原和內容稽核分開。更換驅動無法修復錯誤 bytes，下載來源不明的整包檔案也不能證明診斷。
影像疑難排解不構成從未審核來源下載 ROM、BIOS、CHD、shader 套件、圖像或專有 GPU 檔案的理由。請只用自己合法傾印或明確授權的內容，以及官方更新管道。