在 Android RetroArch 手動掃描街機 ROM 並建立播放清單
只有在正確核心能直接載入一個合法測試檔後，才使用「手動掃描」。設定內容目錄、明確的系統或清單名稱、已驗證的預設核心，以及該核心真正支援的副檔名。除非核心與檔案結構確實需要，否則不要掃描壓縮檔內部；完成後先測一個項目並保留舊清單備份。
六步驟匯入流程
- 01
記錄 RetroArch 組建、核心的精確名稱與版本、合法來源、內容目錄、壓縮結構，以及目前播放清單的備份。
- 02
直接載入核心與一個檔案；若失敗就停止，因為播放清單無法修正核心、BIOS、相依項或 romset 不符。
- 03
開啟「匯入內容 → 手動掃描」，只選預定目錄；只有所有子目錄都屬於同一清單時才啟用遞迴。
- 04
選定具體系統或清楚的自訂名稱，指定已驗證核心，並只填入核心確實接受的副檔名。
- 05
除非核心會載入該格式且每個壓縮檔就是一個集合，否則關閉壓縮檔內掃描；Arcade DAT 也必須取得授權且版本相符。
- 06
開始掃描後啟動一個已知項目，確認核心與版本，再把產生的清單和庫存比對，之後才取代舊清單。
選擇正確方式
| 觀察到的條件 | 最佳選擇 | 能證明什麼 |
|---|---|---|
| 校驗值符合 RetroArch 資料庫 | 嚴格掃描 | 只證明資料庫身分 |
| 直接載入成功但掃描略過 | 手動掃描 | 建立啟動中繼資料 |
| 所選核心直接載入失敗 | 先不要掃描 | 先診斷核心與內容 |
| 壓縮檔含多個無關檔案 | 先檢查結構 | 避免錯誤項目 |
手動掃描略過的是辨識，不是相容性
Libretro 將一般掃描定義為嚴格模式：CRC 或光碟序號必須符合資料庫。手動模式則依目錄、副檔名、系統與核心建立項目，適合資料庫未收錄的合法內容。
產生的播放清單不是稽核結果。核心錯誤、BIOS 缺少、MAME 世代不符或 Android URI 無法讀取，啟動時仍會失敗。
把每個欄位當成邊界
範圍狹窄的目錄與副檔名可避免筆記、存檔或無關檔案變成啟動項目。自訂名稱應說明系統與版本，不應假裝已符合資料庫。
掃描壓縮檔內部是另一個決策：街機 ZIP 常是一個集合，但其他套件可能包含多檔或不支援的巢狀結構。先用副本測試一個。
保留可還原性與證據
保存既有清單與來源庫存，在覆寫前先測一個項目。若標籤或核心關聯錯誤，還原 JSON 並修正掃描設定，不要改內容名稱。
縮圖配對依賴清單與項目名稱，但外觀不應驅動 ROM 改名。技術身分、合法來源與核心精確版本優先。
手動掃描不提供遊戲，也不授予使用權。只能匯入自行合法傾印或明確授權的版本；不要把 DAT 名稱、縮圖或預期檔名當成尋找未審核 ROM、BIOS、CHD、圖像或音樂的線索。