NS-USBLoader：一台工具搞定 Switch NSP 传输、RCM 注入与文件分割合并

NS-USBLoader：一台工具搞定 Switch NSP 传输、RCM 注入与文件分割合并

【免费下载链接】ns-usbloaderAwoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files.项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader

NS-USBLoader 是一款跨平台的 Switch NSP 传输工具，写给需要在电脑上给 Switch 装游戏的你。它把批量上传 NSP、RCM payload 注入、大文件分割合并三件事塞进同一个界面：电脑端通过 USB 或网络连上 Switch 里的 Awoo 或 Goldleaf，Windows、macOS、Linux 都用同一套操作，不用再在 Python 脚本和一堆只支持 Windows 的小工具之间来回切换。

能力速览

• NSP 批量传输：一次拖入多个 NSP/NSZ/XCI 文件，选好接收端（Awoo 或 Goldleaf）和协议（USB 或网络），点一下全部发出去。
• RCM payload 一键注入：Switch 进 RCM 模式后，拖入 hekate.bin 这类 payload 点按钮即注入，程序会自动识别设备并校验 payload 格式。
• 分割与合并：把超过 4GB 的大文件切成能写入 FAT32 的若干段，也能把多段文件合并回一个。
• 跨平台带 CLI：同一个程序跑在 Windows、macOS、Linux，甚至树莓派上，命令行模式适合批量处理。

最小上手路径：4 步把 NSP 传上 Switch

1. 拿到程序：从项目发布页下载最新的 JAR，双击运行即可；想自己编译源码的话，先克隆仓库：

git clone https://gitcode.com/gh_mirrors/ns/ns-usbloader

2. Switch 端先装好接收程序：在 Switch 上安装 Awoo 或 Goldleaf，并开启它的 USB 或网络传输功能，这是 NSP 传输的前置条件。
3. 启动并连接：双击 JAR 启动；Windows 首次使用点齿轮图标里的 "Download and install drivers" 装好 USB 驱动。
4. 上传：把 NSP 文件拖进主界面，顶部选好 Awoo 和协议，填上 Switch 的 IP，点 "Upload to NS"。

点完后表格会显示每个文件的状态。注意：状态为 "Uploaded" 表示文件已发到 Switch，装没装上是 Awoo/Goldleaf 的事。

跟着场景走：三个高频任务

RCM payload 一键注入

Switch 变砖需要救砖、或者还没砖想砖，短接后进 RCM 模式，USB-C 连上电脑，用这个标签页完成注入。

1. 切到 RCM 标签，拖入 hekate.bin 或 Lockpick_RCM.bin，程序会当场校验 payload 格式。
2. 点 "Inject payload"。
3. 等日志走到结束。

日志出现 Payload complete，就说明注入完成，Switch 会从注入的 payload 直接启动。

把超大 NSP 灌进 FAT32 SD 卡

FAT32 格式的 SD 卡只能放 4GB 以下的文件，一个超大 NSP 直接拷不进去，得先切开、拷上卡，再到 Switch 上拼回来。

1. 切到 "Split & merge files" 标签，选择 Split。
2. 把超大 NSP 拖进来，确认保存位置，点 "Convert"。
3. 把生成的分段拷进 SD 卡，Switch 上用任意工具合并后再安装。

7GB 的 NSP 切完变成好几个 4GB 以内的小段，直接就能写进 FAT32 卡。

配好一条稳定的网络传输链路

USB 不方便，或者你想从另一台电脑传文件，就打开齿轮标签把网络配一次，以后长期可用。

1. 保持 "Auto-detect IP" 和 "Randomly get port" 勾选，大多数情况不用改别的。
2. 专家模式里可以手动指定主机 IP 和端口，或指向你自己搭的 HTTP 服务器路径。
3. 回主界面填好 Switch 的 IP，网络 NSP 传输即可用。

配完之后，网络传文件就是"填个 IP 就连上"的体验。

平台差异：三行说完

• Windows：首次启动在界面里点齿轮图标自动下载并安装 USB 驱动，不用另配环境。
• macOS：Intel 芯片直接跑标准 JAR；Apple Silicon 下载带 -m1 后缀的版本，并先执行brew install libusb。
• Linux：装 JDK 17 即可运行，非 root 使用 USB 需要加一条 udev 规则后重载；树莓派额外装 openjfx。

进阶与排错

批量操作直接用命令行。这条命令把一批 NSP 通过网络发出去：

java -jar ns-usbloader.jar -n nsip=192.168.1.100 ~/Games/*.nsp

这条命令注入 RCM payload：

java -jar ns-usbloader.jar -r ~/bin/hekate.bin

高频问题最简答案：

• Windows 驱动装不上：右键以管理员身份运行；仍不行就手动安装 libusb 驱动。
• Linux 认不到设备：加一条 udev 规则（或把用户加进 dialout 组），再重新登录。
• 传输总是断：换根稳的 USB 线、关掉电脑 USB 节能，网络方式可适当调大超时。

💡 出问题先看日志页：[PASS] Found device 表示设备识别成功，Payload complete 表示注入完成，其余 INFO 行能帮你定位卡在哪一步。

看一眼项目内部：功能代码都在哪

src/main/java/nsusbloader/ ├── Controllers/ # 各标签页的界面控制器 ├── cli/ # 命令行模式实现 ├── Utilities/ │ ├── splitmerge/ # 分割/合并引擎 │ ├── patches/ # 补丁系统 │ └── Rcm.java # RCM 注入核心逻辑 ├── com/usb/ # USB 与网络通信 └── Main.java # 程序入口

想搞懂文件是怎么发出去的，从 核心传输模块 读起；命令行参数怎么解析，看 命令行接口实现 就明白了。

它适合常给 Switch 装游戏、不想在一堆小工具之间切换的你：先从上面的批量传输场景试起，遇到问题可以直接把日志页的内容反馈给项目维护者。

【免费下载链接】ns-usbloaderAwoo Installer and GoldLeaf uploader of the NSPs (and other files), RCM payload injector, application for split/merge files.项目地址: https://gitcode.com/gh_mirrors/ns/ns-usbloader