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-usbloaderNS-USBloader 是一款运行在 Windows、macOS、Linux 上的 PC 端图形化工具可以把 NSP、XCI 等文件发送到 Switch支持 Awoo 与 Goldleaf 两款主机端安装程序、向 RCM 模式的主机注入 payload 文件并拆分、合并大文件。下面按你要完成的任务讲解从安装到进阶的完整流程。适合什么样的使用场景主机端已装好 Awoo 或 Goldleaf需要把电脑里的 NSP / XCI 文件经 USB 或网络传到 Switch 上安装。主机已进入 RCM 模式一种通过短接特定引脚或改装芯片进入的恢复模式需要注入 Hekate、Lockpick_RCM 等 payload 文件。单个游戏文件超过 4GBFAT32 格式的存储卡放不下需要拆分成小文件传输后再合并还原。安装与首次运行Windows双击下载好的.jar文件启动系统需已安装 Java。首次打开后点击左侧齿轮图标点击「Download and install drivers」按提示安装 USB 驱动——这是 Windows 下连接 Switch 的必要步骤。macOS双击 JAR 即可运行若系统弹出安全提示到「安全性与隐私」设置中允许运行。Apple SiliconM 系列芯片机器需下载带-m1后缀的版本并先用 Homebrew 安装 libusb# 为 Apple Silicon 安装 libusb brew install libusb官方建议 macOS 用户使用 JDK 19仍有用户在 JDK 14 上报告过问题。macOS Mojave 之前的老系统请下载带-legacy后缀的版本内部 usb4java 库版本不同导致。Linux 与 Raspberry Pi# 安装 JDKDebian/Ubuntu 系 sudo apt install default-jdk# 用 Java 启动应用 sudo java -jar /path/to/NS-USBloader.jarRaspberry Pi 用户还需安装 JavaFXsudo apt install openjfx。为免每次用 root 运行需添加 udev 规则让普通账户能访问 USB 设备# 新建规则文件一条针对 RCM 模式设备(0955:7321)一条针对 Awoo USB 传输设备(057e:3000) sudo vim /etc/udev/rules.d/99-NS.rules文件内容写入两行SUBSYSTEMusb, ATTRS{idVendor}0955, ATTRS{idProduct}7321, MODE0666 SUBSYSTEMusb, ATTRS{idVendor}057e, ATTRS{idProduct}3000, MODE0666# 重新加载 udev 规则使其生效 sudo udevadm control --reload-rules sudo udevadm trigger高分屏上界面偏小时可用java -Dglass.gtk.uiScale150% -jar NS-USBloader.jar按 150% 缩放界面。第一次发送 NSP 文件主界面开始前先在 Switch 上装好 Awoo 或 Goldleaf并在其中开启「USB 安装」或「网络安装」选项。然后顶部下拉框选择目标应用Awoo 或 Goldleaf与协议USB 或 NETGoldleaf 仅支持 USB网络方式下填入主机 IP。通过「Select files」按钮或拖拽把文件加入表格可多次添加、多选空格键勾选/取消Delete 删除选中项右键菜单可清空列表。点击「Upload to NS」开始传输。两个容易误解的细节表格中状态显示「Uploaded」只表示文件已成功发送到主机不代表安装成功——安装结果由主机端应用自行处理NS-USBloader 拿不到安装反馈。使用 Goldleaf v0.6.1 时需在 Goldleaf 里通过「Explore content → Remote PC (via USB)」看到HOME:/与VIRT:/两个盘符从VIRT:/选择要安装的文件。RCM 模式注入 payload 文件将 Switch 进入 RCM 模式并用 USB-C 线连接电脑。切到 RCM 标签页选择或拖入 payload 文件Hekate、Lockpick_RCM 均可应用会做基本的格式校验。点击「Inject payload」等待日志出现「Payload complete」即可断开。拆分与合并大文件进入拆分合并标签页选择 Split拆分或 Merge合并。拖入或选择文件用「Change」指定输出目录。点击「Convert」执行拆出的多个分卷拷入 FAT32 存储卡即可合并时把同一文件的各分卷一起选入即可还原。设置页语言、驱动与网络传输选项常用选项Language切换界面语言内置十余种语言含简体中文。Select folder with ROM files…勾选后「Select files」改为按文件夹整批添加受支持的文件。Allow XCI / NSZ / XCZ files selection for Awoo允许 Awoo 协议传输 XCI/NSZ/XCZ 文件。Goldleaf 区域可设置 Goldleaf 版本下拉框并勾选只显示*.nsp文件以过滤HOME:/盘符内容。Expert mode (NET setup)高级网络配置可关闭 Auto-detect IP、手动指定端口或使用「Dont serve requests」——此时软件不再启动内置 HTTP 服务器而是直接告诉 Awoo「去你指定的地址取文件」需要你自己用 nginx 等服务把文件暴露出来。主界面右上角的灯泡图标用于切换深色/浅色主题。用日志页排查问题三个点图标对应的标签页记录所有传输与注入的详细日志[INFO]是过程信息[PASS]表示关键步骤成功。三个常见问题现象Windows 下连接后识别不到主机。原因USB 驱动未装好。解决到设置页点「Download and install drivers」重装驱动或改用管理员权限运行。现象Linux 下操作 USB 设备报权限错误。原因未加 udev 规则。解决按上文写入规则文件后执行sudo udevadm control --reload-rules sudo udevadm trigger。现象传输或注入中途失败。原因多为 USB 接触不良或主机不在预期模式。解决重新插紧线缆确认主机处于 RCM / 目标安装模式后重试并对照日志里 FAIL 之前的最后一条[PASS]定位卡在哪一步。命令行用法 ⌨️除图形界面外程序提供完整的 CLI。运行java -jar ns-usbloader.jar --help查看全部选项常用命令# 向 RCM 模式主机发送 payload java -jar ns-usbloader.jar -r /path/to/hekate.bin # 网络方式传输指定主机 IP 与文件列表 java -jar ns-usbloader.jar -n nsip192.168.1.100 ~/Games/*.nsp # 拆分文件输出目录为 /tmp/ java -jar ns-usbloader.jar -s /tmp/ ~/Games/*.nsp # 合并拆分文件 java -jar ns-usbloader.jar -m /tmp/ ~/Games/*.nsp # 通过 Goldleaf v0.8 USB 模式安装 java -jar ns-usbloader.jar -g verv0.8 ./game.nsp每个选项后再加help如-n help可看该选项的详细参数例如-n支持hostipip[:port]手动指定本机地址。与官方传输脚本的区别对比项NS-USBloader官方 usb_install_pc.py / remote_install_pc.py支持的安装器AwooUSB网络、GoldleafUSBAwooUSB/网络RCM payload 注入支持不提供文件拆分 / 合并支持不提供使用形态跨平台图形界面 命令行命令行脚本Goldleaf 版本兼容性方面项目支持 v0.5、v0.6.1、v0.7 系列、v0.8–0.9需 NS-USBloader v1.0以及 v0.10–1.0.0 和 v1.2.0需 v6.0v0.6 与 v1.1.0–1.1.1 无对应支持。当前项目版本为 7.3版本号要求以发布说明为准。适用边界它只是 PC 端工具主机端必须预先装好 Awoo 或 Goldleaf软件不负责安装它们。它不报告游戏是否安装成功也不提供存档、系统管理等主机侧功能。遵循 GPLv3 协议开源代码仓库可通过git clone https://gitcode.com/gh_mirrors/ns/ns-usbloader获取可自行编译或提交翻译。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
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-usbloaderNS-USBloader 是一款运行在 Windows、macOS、Linux 上的 PC 端图形化工具可以把 NSP、XCI 等文件发送到 Switch支持 Awoo 与 Goldleaf 两款主机端安装程序、向 RCM 模式的主机注入 payload 文件并拆分、合并大文件。下面按你要完成的任务讲解从安装到进阶的完整流程。适合什么样的使用场景主机端已装好 Awoo 或 Goldleaf需要把电脑里的 NSP / XCI 文件经 USB 或网络传到 Switch 上安装。主机已进入 RCM 模式一种通过短接特定引脚或改装芯片进入的恢复模式需要注入 Hekate、Lockpick_RCM 等 payload 文件。单个游戏文件超过 4GBFAT32 格式的存储卡放不下需要拆分成小文件传输后再合并还原。安装与首次运行Windows双击下载好的.jar文件启动系统需已安装 Java。首次打开后点击左侧齿轮图标点击「Download and install drivers」按提示安装 USB 驱动——这是 Windows 下连接 Switch 的必要步骤。macOS双击 JAR 即可运行若系统弹出安全提示到「安全性与隐私」设置中允许运行。Apple SiliconM 系列芯片机器需下载带-m1后缀的版本并先用 Homebrew 安装 libusb# 为 Apple Silicon 安装 libusb brew install libusb官方建议 macOS 用户使用 JDK 19仍有用户在 JDK 14 上报告过问题。macOS Mojave 之前的老系统请下载带-legacy后缀的版本内部 usb4java 库版本不同导致。Linux 与 Raspberry Pi# 安装 JDKDebian/Ubuntu 系 sudo apt install default-jdk# 用 Java 启动应用 sudo java -jar /path/to/NS-USBloader.jarRaspberry Pi 用户还需安装 JavaFXsudo apt install openjfx。为免每次用 root 运行需添加 udev 规则让普通账户能访问 USB 设备# 新建规则文件一条针对 RCM 模式设备(0955:7321)一条针对 Awoo USB 传输设备(057e:3000) sudo vim /etc/udev/rules.d/99-NS.rules文件内容写入两行SUBSYSTEMusb, ATTRS{idVendor}0955, ATTRS{idProduct}7321, MODE0666 SUBSYSTEMusb, ATTRS{idVendor}057e, ATTRS{idProduct}3000, MODE0666# 重新加载 udev 规则使其生效 sudo udevadm control --reload-rules sudo udevadm trigger高分屏上界面偏小时可用java -Dglass.gtk.uiScale150% -jar NS-USBloader.jar按 150% 缩放界面。第一次发送 NSP 文件主界面开始前先在 Switch 上装好 Awoo 或 Goldleaf并在其中开启「USB 安装」或「网络安装」选项。然后顶部下拉框选择目标应用Awoo 或 Goldleaf与协议USB 或 NETGoldleaf 仅支持 USB网络方式下填入主机 IP。通过「Select files」按钮或拖拽把文件加入表格可多次添加、多选空格键勾选/取消Delete 删除选中项右键菜单可清空列表。点击「Upload to NS」开始传输。两个容易误解的细节表格中状态显示「Uploaded」只表示文件已成功发送到主机不代表安装成功——安装结果由主机端应用自行处理NS-USBloader 拿不到安装反馈。使用 Goldleaf v0.6.1 时需在 Goldleaf 里通过「Explore content → Remote PC (via USB)」看到HOME:/与VIRT:/两个盘符从VIRT:/选择要安装的文件。RCM 模式注入 payload 文件将 Switch 进入 RCM 模式并用 USB-C 线连接电脑。切到 RCM 标签页选择或拖入 payload 文件Hekate、Lockpick_RCM 均可应用会做基本的格式校验。点击「Inject payload」等待日志出现「Payload complete」即可断开。拆分与合并大文件进入拆分合并标签页选择 Split拆分或 Merge合并。拖入或选择文件用「Change」指定输出目录。点击「Convert」执行拆出的多个分卷拷入 FAT32 存储卡即可合并时把同一文件的各分卷一起选入即可还原。设置页语言、驱动与网络传输选项常用选项Language切换界面语言内置十余种语言含简体中文。Select folder with ROM files…勾选后「Select files」改为按文件夹整批添加受支持的文件。Allow XCI / NSZ / XCZ files selection for Awoo允许 Awoo 协议传输 XCI/NSZ/XCZ 文件。Goldleaf 区域可设置 Goldleaf 版本下拉框并勾选只显示*.nsp文件以过滤HOME:/盘符内容。Expert mode (NET setup)高级网络配置可关闭 Auto-detect IP、手动指定端口或使用「Dont serve requests」——此时软件不再启动内置 HTTP 服务器而是直接告诉 Awoo「去你指定的地址取文件」需要你自己用 nginx 等服务把文件暴露出来。主界面右上角的灯泡图标用于切换深色/浅色主题。用日志页排查问题三个点图标对应的标签页记录所有传输与注入的详细日志[INFO]是过程信息[PASS]表示关键步骤成功。三个常见问题现象Windows 下连接后识别不到主机。原因USB 驱动未装好。解决到设置页点「Download and install drivers」重装驱动或改用管理员权限运行。现象Linux 下操作 USB 设备报权限错误。原因未加 udev 规则。解决按上文写入规则文件后执行sudo udevadm control --reload-rules sudo udevadm trigger。现象传输或注入中途失败。原因多为 USB 接触不良或主机不在预期模式。解决重新插紧线缆确认主机处于 RCM / 目标安装模式后重试并对照日志里 FAIL 之前的最后一条[PASS]定位卡在哪一步。命令行用法 ⌨️除图形界面外程序提供完整的 CLI。运行java -jar ns-usbloader.jar --help查看全部选项常用命令# 向 RCM 模式主机发送 payload java -jar ns-usbloader.jar -r /path/to/hekate.bin # 网络方式传输指定主机 IP 与文件列表 java -jar ns-usbloader.jar -n nsip192.168.1.100 ~/Games/*.nsp # 拆分文件输出目录为 /tmp/ java -jar ns-usbloader.jar -s /tmp/ ~/Games/*.nsp # 合并拆分文件 java -jar ns-usbloader.jar -m /tmp/ ~/Games/*.nsp # 通过 Goldleaf v0.8 USB 模式安装 java -jar ns-usbloader.jar -g verv0.8 ./game.nsp每个选项后再加help如-n help可看该选项的详细参数例如-n支持hostipip[:port]手动指定本机地址。与官方传输脚本的区别对比项NS-USBloader官方 usb_install_pc.py / remote_install_pc.py支持的安装器AwooUSB网络、GoldleafUSBAwooUSB/网络RCM payload 注入支持不提供文件拆分 / 合并支持不提供使用形态跨平台图形界面 命令行命令行脚本Goldleaf 版本兼容性方面项目支持 v0.5、v0.6.1、v0.7 系列、v0.8–0.9需 NS-USBloader v1.0以及 v0.10–1.0.0 和 v1.2.0需 v6.0v0.6 与 v1.1.0–1.1.1 无对应支持。当前项目版本为 7.3版本号要求以发布说明为准。适用边界它只是 PC 端工具主机端必须预先装好 Awoo 或 Goldleaf软件不负责安装它们。它不报告游戏是否安装成功也不提供存档、系统管理等主机侧功能。遵循 GPLv3 协议开源代码仓库可通过git clone https://gitcode.com/gh_mirrors/ns/ns-usbloader获取可自行编译或提交翻译。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
