匯入遊戲

Sakura 可直接在您的裝置上匯入 NScripter 與 ONScripter 遊戲（包含像 Umineko 這樣的 ONScripter-RU 遊戲）——不需要電腦。本頁涵蓋完整的應用程式內匯入流程。若您想改從電腦的瀏覽器匯入，請改看網頁傳輸。

• 在資料庫中點一下匯入遊戲卡片（.zip, .7z, .rar, .tar, .gz, .bz2, .exe）。
• 若您的資料庫是空的，找不到遊戲畫面上也有自己的匯入按鈕。

這會開啟 ONScripter 遊戲匯入彈出視窗，列出支援的檔案類型，並說明系統會自動偵測 ONScripter 遊戲的根目錄檔案夾。點一下選擇壓縮檔以開啟系統檔案選擇器並選取單一封存檔。

• zip — 以 ZIPFoundation 解壓縮（若有密碼保護則使用 SSZipArchive）
• 7z — 以 PLzmaSDK 解壓縮
• rar — 以 UnrarKit 解壓縮
• tar / gz / bz2 / tgz — 內建的串流式 tar/gzip/bzip2 讀取器
• lzh / lha — 原生 LHA 解壓縮器
• exe（僅限安裝程式／自解壓縮檔）— 依序偵測：NSIS 安裝程式、Inno Setup 安裝程式，接着掃描前 16 MB 尋找內嵌的 7z/zip 自解壓縮內容，最後是 LHA-SFX

1. 暫存。 若封存檔位於 iCloud 雲碟，Sakura 會先將其下載到本機。接着會檢查可用空間——若需要暫存複本，大約需要封存檔大小的 3 倍空間；若檔案已在本機，則需要 2 倍空間。若空間不足，會顯示**「磁碟空間不足」**：「沒有足夠的可用空間來解壓縮此封存檔。請騰出儲存空間後再試一次。」

2. 密碼檢查。 若封存檔已加密（僅限 zip/rar/7z），系統會提示您：「此封存檔受密碼保護。請輸入密碼以繼續。」密碼錯誤會顯示「密碼錯誤，請再試一次。」**

3. 預先掃描。 在解壓縮之前，Sakura 會掃描項目名稱以尋找可辨識的 NScripter/ONScripter 標記——像是啟動腳本 0.txt、00.txt、nscript.dat、nscr_sec.dat、nscript.___、0.utf、00.utf、pscript.dat，或 script.file（ONScripter-RU 遊戲如 Umineko 所使用的封裝腳本格式），以及像 arc*.nsa、*.ns2 或 *.sar 這類封裝封存檔。無法預先掃描的 tar 及其他格式則會在解壓縮後立即檢查。

   若沒有任何項目相符，會顯示：「此封存檔看起來不像 ONScripter 遊戲。請尋找內含 0.txt、nscript.dat 或 arc.nsa 封裝檔的封存檔。」

4. 解壓縮。 開始解壓縮前會先跑一段簡短的倒數（「開始…」），之後會顯示即時百分比並提供取消選項。以下是一些格式相關的細節：

   • Zip 檔名會先以 UTF-8 解碼，失敗則回退到 Shift-JIS——這能修正日文封存檔中的亂碼問題。
   • RAR 解壓縮後會對啟動所需的關鍵檔案進行完整性檢查；若有檔案遺失或被截斷，會顯示：「RAR 解壓縮不完整：有 N 個必要檔案遺失或被截斷（例如 {sample}）。請將遊戲重新封裝為 ZIP 或 7z 後再匯入。」
   • __MACOSX 檔案夾會自動刪除。

5. 遊戲根目錄偵測。 Sakura 會執行有界限的搜尋（最深 6 層檔案夾），尋找內含上述任一 NScripter 標記、層級最淺的檔案夾——因此像 Title 1.0/Title 1.0/遊戲檔案… 這種巢狀結構的封存檔仍能正確解析。

6. 安裝。 遊戲會安裝到您資料庫中專屬的檔案夾，並附帶一個空的 Patches 檔案夾供模組或翻譯補丁使用。若已匯入過同名封存檔，會加上數字後綴。

若解壓縮被取消，會顯示已取消，並提供關閉／重新啟動。若發生問題，嚴重錯誤彈出視窗會提供關閉或要再匯入一個嗎？。

成功匯入後，自訂步驟讓您設定遊戲名稱（預先填入偵測到的名稱）並選擇圖示——圖示候選項目的尋找方式請參閱遊戲圖示。點一下儲存以保留您的選擇，或點一下跳過以保留預設值。

最後畫面會確認**「已匯入 ONScripter 遊戲」並顯示遊戲名稱，並提供關閉或要跳至遊戲嗎？**以立即開啟遊戲。

• 看到**「不支援的格式」或「不支援的壓縮檔格式」**？請參閱上方的格式說明——尤其是 CAB .exe 安裝程式，需要先在電腦上解壓縮並重新封裝。
• 看到**「此封存檔看起來不像 ONScripter 遊戲」**？請再次確認封存檔確實包含遊戲的腳本檔案（而不僅是安裝程式外殼或一堆不相關檔案的檔案夾）。
• 更多一般性的匯入問題，請參閱匯入問題。