NSC_BUILDER v1.01 文件处理与格式转换技术操作手册

NSC_BUILDER v1.01 文件处理与格式转换技术操作手册

【免费下载链接】NSC_BUILDERNintendo Switch Cleaner and Builder. A batchfile, python and html script based in hacbuild and Nut's python libraries. Designed initially to erase titlerights encryption from nsp files and make multicontent nsp/xci files, nowadays is a multicontent tool specialized in batch processing and file information, someone called it a Switch's knife and he may be right.项目地址: https://gitcode.com/gh_mirrors/ns/NSC_BUILDER

1. 工具概述

NSC_BUILDER是基于hacbuild和Nut Python库开发的Nintendo Switch文件管理工具，主要用于NSP/XCI文件的批量处理、格式转换及元数据管理。工具支持多线程处理和智能缓存机制，适用于自制游戏备份、多区域游戏管理及开发测试场景。

2. 环境部署

2.1 依赖安装

py/install_dependencies.bat

执行上述命令自动完成所有依赖组件的安装配置，包括Python库和系统工具。

2.2 配置文件生成

工具在py/zconfig/目录下自动生成以下配置文件：

• NSCB_options.cmd：主配置文件
• NUT_DB_URL.txt：数据库地址配置
• Server_options.cmd：服务器参数设置

[!NOTE] 首次运行前需检查配置文件中的区域参数和游戏库路径设置是否正确

3. 功能模块

3.1 文件格式处理模块

3.1.1 核心价值

提供NSP/XCI格式相互转换及NSZ压缩功能，支持多内容文件创建。

3.1.2 操作步骤

# XCI转NSP格式 py/ztools/XCI.bat [输入文件路径] [输出目录] # NSP压缩为NSZ py/ztools/ZSTD.bat -c [输入NSP文件] [输出NSZ文件]

3.1.3 注意事项

• 转换过程中需保证源文件完整性
• 大型文件转换建议使用ADV.bat启用多线程模式
• NSZ压缩率可通过配置文件调整，默认压缩级别为6

3.2 批量操作模块

3.2.1 核心价值

支持多文件并行处理，结合智能缓存机制提升重复操作效率。

3.2.2 操作步骤

# 自动模式：拖放文件到批处理脚本 py/ztools/JOINER.bat [文件/文件夹路径] # 手动模式：指定文件列表处理 py/ztools/MNG.bat -f filelist.txt -o output_dir

3.2.3 注意事项

• 文件列表需使用UTF-8编码
• 缓存目录默认为py/ztools/cache，定期清理可释放磁盘空间
• 批量处理建议单次不超过50个文件

3.3 元数据管理模块

3.3.1 核心价值

提取并解析NSP/XCI文件的元数据信息，包括CNMT、NACP和NPDM文件内容。

3.3.2 操作步骤

# 提取文件元数据 py/ztools/info.bat [文件路径] -o metadata.json # 批量导出标题信息 py/ztools/manager/mass_verification.py -d [目录] -f titles.csv

3.3.3 注意事项

• 元数据提取需要完整的密钥文件支持
• NACP文件包含游戏标题、作者和版本信息
• CNMT文件提供内容组成和依赖关系数据

4. 操作流程

4.1 图形界面操作流程

4.1.1 启动Web界面

py/NSCB.exe

执行后自动打开默认浏览器，访问本地Web界面。

4.1.2 基本操作步骤

1. 在左侧导航栏选择操作模式
2. 通过文件选择器添加目标文件
3. 配置处理参数并点击"执行"
4. 在结果面板查看处理进度和日志

4.2 命令行操作流程

4.2.1 单文件处理流程

# 1. 检查文件信息 py/ztools/info.bat game.nsp # 2. 转换文件格式 py/ztools/XCI.bat game.nsp game.xci # 3. 验证输出文件 py/ztools/info.bat game.xci --verify

4.2.2 批量处理流程

# 1. 创建文件列表 dir /b *.nsp > filelist.txt # 2. 执行批量转换 py/ztools/MNG.bat -f filelist.txt -o converted_files # 3. 生成处理报告 py/ztools/manager/mass_verification.py -d converted_files -r report.html

5. 场景应用

5.1 游戏备份管理

5.1.1 适用场景

需要将多个NSP游戏文件合并为单个XCI文件，方便存储和传输。

5.1.2 操作步骤

# 创建多内容XCI文件 py/ztools/JOINER.bat "D:\games\*" -o "D:\backup\collection.xci"

5.1.3 优势分析

5.2 开发测试环境

5.2.1 适用场景

开发过程中需要快速提取NCA文件进行分析或修改。

5.2.2 操作步骤

# 提取NSP中的NCA文件 py/ztools/ADV.bat -x game.nsp -o extract_dir --nca-only

5.2.3 注意事项

• 提取操作需要解密密钥支持
• 建议使用--log-level debug参数获取详细处理信息
• 提取的NCA文件可使用专用工具进一步分析

6. 常见问题排查

6.1 依赖安装失败

错误表现：运行install_dependencies.bat后提示"Python未找到"

解决方案：

1. 确认Python已安装且添加到系统PATH
2. 手动安装依赖：

cd py pip install -r requirements.txt

6.2 文件转换失败

错误表现：转换过程中提示"密钥文件缺失"

解决方案：

1. 将有效的密钥文件放置于py/ztools/keys.txt
2. 确保密钥文件格式正确，每行一个密钥对

6.3 Web界面无法启动

错误表现：执行NSCB.exe后浏览器未自动打开

解决方案：

1. 检查8080端口是否被占用
2. 手动访问http://localhost:8080
3. 清理py/ztools/web/cache目录后重试

6.4 批量处理效率低下

错误表现：处理大量文件时速度缓慢

解决方案：

1. 使用ADV.bat启用多线程模式
2. 调整配置文件中THREAD_COUNT参数
3. 增加系统虚拟内存分配

7. 技术规格

7.1 支持格式

• 输入格式：NSP, XCI, NSZ, XCZ
• 输出格式：NSP, XCI, NSZ
• 元数据格式：JSON, CSV, HTML

7.2 系统要求

• 操作系统：Windows 10/11 (64位)
• Python版本：3.7+
• 最低内存：4GB RAM
• 可用磁盘空间：至少20GB

7.3 性能指标

• 单线程转换速度：约80-120MB/s
• 多线程加速比：最高4.5x（8线程）
• 缓存命中率：约65-75%（重复文件处理）

8. 命令参考

[!NOTE] 使用[命令文件] --help查看完整参数说明

【免费下载链接】NSC_BUILDERNintendo Switch Cleaner and Builder. A batchfile, python and html script based in hacbuild and Nut's python libraries. Designed initially to erase titlerights encryption from nsp files and make multicontent nsp/xci files, nowadays is a multicontent tool specialized in batch processing and file information, someone called it a Switch's knife and he may be right.项目地址: https://gitcode.com/gh_mirrors/ns/NSC_BUILDER