NSCB如何将NSZ格式转换为XCI？

Question

使用NSCB（Nintendo Switch Clean & Build）工具时，一个常见问题是：如何将压缩的NSZ格式文件转换为可装载或烧录的XCI格式？用户在处理Switch游戏备份时，常遇到NSZ因其高压缩率节省空间，但部分设备或工具不支持该格式。虽然NSCB主要设计用于NSP/NSX与XCI/XCX之间的转换与清理，但目前版本并不原生支持直接将NSZ解压并转换为XCI。解决方案通常是先使用专门工具（如nsz或Krzr的压缩工具）将NSZ解压为NSP或NCA文件，再通过NSCB将其构建成XCI格式。此过程中常出现文件路径错误、密钥缺失或构建失败等问题，需确保配置正确的prod.keys和title.keys，并更新NSCB至最新版本以支持最新固件游戏。因此，核心难点在于多步骤转换中的兼容性与密钥管理。

Answer 1

1. 问题背景与技术演进

在Nintendo Switch游戏备份管理领域，NSZ格式因其采用LZ4或Zstandard高压缩算法，在存储效率上显著优于原始NSP或XCI格式。然而，尽管压缩率高，NSZ并非所有烧录卡（如SX OS、Atmosphere等）或模拟器直接支持的可执行镜像格式。因此，用户常需将NSZ转换为XCI——一种适用于物理卡带烧录和部分引导环境的标准容器格式。

NSCB（Nintendo Switch Clean & Build）作为一款广泛使用的自动化构建工具，主要功能集中在NSP/NSX与XCI/XCX之间的清洗、分割与重构。但截至目前版本（v1.0+），NSCB并未内置对NSZ的原生解压支持，这导致必须引入外部工具链完成前置转换步骤。

2. 转换流程的技术层级分解

1. 第一阶段：NSZ → NSP/NCA — 使用独立解压工具如nsz或Krzr开发的GUI版压缩套件进行解包。
2. 第二阶段：NSP → XCI — 将输出的NSP文件导入NSCB，选择“Create XCI”模式，并配置构建参数。
3. 第三阶段：密钥验证与完整性校验 — 确保prod.keys和title.keys正确加载，避免签名失败或构建中断。

3. 常见错误类型与诊断路径

错误代码/现象	可能原因	解决方案
"Missing keys: master_key_00"	未配置正确的prod.keys	更新keys文件并放置于keys.txt或密钥目录
"Could not open input file"	路径含中文或特殊字符	使用纯英文路径，禁用空格与Unicode
"Invalid NCA signature"	title.keys缺失或游戏已加密升级	获取对应title密钥并更新至配置文件
XCI生成后无法加载	固件版本不兼容	检查游戏所需最低系统版本并与运行环境匹配
构建过程卡死在“Reading Meta…”	NCA元数据损坏	重新解压NSZ，启用完整性校验选项

4. 核心依赖项管理策略

成功构建的关键在于密钥系统的完整性和工具链的协同工作能力。以下为关键组件清单：

• prod.keys：包含AES密钥用于解密各代Switch硬件的加密层。
• title.keys：每款游戏唯一的权利ID对应密钥，通常由dump过程获得或社区共享。
• keys.txt：NSCB默认读取的密钥文件，需整合上述两类密钥内容。
• config.ini：自定义输入/输出路径、自动清理、语言过滤等高级设置。

5. 自动化脚本示例（Python + subprocess集成）

import subprocess
import os

# 定义路径变量
NSZ_TOOL = r"C:\tools\nsz.exe"
NSCB_PATH = r"C:\nsbc\NSCB.bat"
INPUT_NSZ = r"D:\games\zelda.nsz"
TEMP_NSP = r"D:\temp\zelda.nsp"
OUTPUT_DIR = r"D:\output"

# 步骤一：NSZ解压为NSP
def decompress_nsz():
    cmd = [
        NSZ_TOOL, "-d", INPUT_NSZ,
        "--output", TEMP_NSP
    ]
    result = subprocess.run(cmd, capture_output=True, text=True)
    if result.returncode != 0:
        raise Exception(f"Decompression failed: {result.stderr}")
    print("✅ NSZ successfully decompressed to NSP")

# 步骤二：调用NSCB构建XCI
def build_xci():
    cmd = [
        NSCB_PATH,
        "--input", TEMP_NSP,
        "--buildxci",
        "--outdir", OUTPUT_DIR
    ]
    subprocess.run(cmd)

if __name__ == "__main__":
    try:
        decompress_nsz()
        build_xci()
        print("🎉 Full conversion pipeline completed.")
    except Exception as e:
        print(f"❌ Pipeline interrupted: {e}")

6. 构建流程可视化（Mermaid流程图）

graph TD A[开始] --> B{NSZ文件存在?} B -- 是 --> C[使用nsz工具解压为NSP] B -- 否 --> H[报错退出] C --> D{解压成功?} D -- 是 --> E[启动NSCB加载NSP] D -- 否 --> H E --> F{密钥齐全且有效?} F -- 是 --> G[构建XCI输出] F -- 否 --> I[提示缺失密钥] I --> J[手动补充prod.keys/title.keys] J --> E G --> K[完成]