导入游戏

Sakura 可以直接在你的设备上导入 NScripter 和 ONScripter 游戏（包括 Umineko 等 ONScripter-RU 游戏）——无需电脑。本页介绍完整的应用内导入流程。如果你想从电脑的浏览器导入，请改看网页传输。

• 在资料库中，点按 Import Games 卡片（.zip, .7z, .rar, .tar, .gz, .bz2, .exe）。
• 如果资料库为空，No Games Found 界面上也有自己的 Import 按钮。

这会打开 ONScripter Game Import 弹窗，其中列出支持的文件类型，并说明系统会自动检测 ONScripter 游戏的根目录。点按 Select Archive 打开系统文件选择器并选择一个压缩包。

• 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 Drive 中，Sakura 会先将其下载到本地。随后检查可用空间——如果需要暂存副本，大约需要压缩包大小的 3 倍空间；如果文件已在本地，则需要 2 倍。如果空间不足，你会看到 “Insufficient Disk Space”：“Not enough free space to extract this archive. Please free up storage and try again.”

2. 密码检查。 如果压缩包已加密（仅限 zip/rar/7z），系统会提示：“This archive is password-protected. Please enter the password to continue.” 密码错误会显示 “Incorrect password. Please try again.”

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 及其他格式会改为在解压后立即检查。

   如果没有匹配项，你会看到：“This archive doesn’t look like an ONScripter game. Look for archives containing 0.txt, nscript.dat, or an arc.nsa pack.”

4. 解压。 解压开始前会有短暂倒计时（“Starting…”），之后显示实时百分比并提供取消选项。以下是一些针对特定格式的细节：

   • Zip 文件名会先尝试以 UTF-8 解码，失败后回退到 Shift-JIS——这修复了日文压缩包中的乱码问题。
   • RAR 解压会在解压后对启动所需的关键文件进行完整性检查；如果有文件缺失或损坏，你会看到：“RAR extraction incomplete: N essential files missing or truncated (e.g. {sample}). Re-pack the game as ZIP or 7z and import that.”
   • __MACOSX 文件夹会被自动删除。

5. 游戏根目录检测。 Sakura 会执行有限深度（最多 6 层）的搜索，寻找包含上述 NScripter 标记之一的最浅层文件夹——因此像 Title 1.0/Title 1.0/game files… 这样嵌套的压缩包依然能正确解析。

6. 安装。 游戏会被安装到资料库中属于它自己的文件夹，并附带一个空的 Patches 文件夹供模组或翻译补丁使用。如果已导入过同名压缩包，会追加一个数字后缀。

如果解压被取消，你会看到 Cancelled，并提供 Close / Restart。如果出现问题，Fatal Error 弹窗会提供 Close 或 Import Another?。

成功导入后，Customize 步骤让你设置 Game Name（预填检测到的名称）并选择 Icon——图标候选项的查找方式参见游戏图标。点按 Save 保存你的选择，或点按 Skip 保留默认值。

最后一屏会以游戏名称确认 “Imported ONScripter Game”，并提供 Close 或 Jump to Game? 以立即打开游戏。

• 看到 “Unsupported Format” 或 “Unsupported archive format”？参见上文的格式说明——尤其是 CAB .exe 安装程序，需要先在电脑上解压并重新打包。
• 看到 “This archive doesn’t look like an ONScripter game”？请仔细确认压缩包确实包含游戏的脚本文件（而不只是一个安装程序包装层，或一堆无关文件）。
• 更多常见导入问题，参见导入问题。