Awoo Installer 安装使用指南：3 种通道把 NSP、NSZ、XCI、XCZ 一次装进 Switch

Awoo Installer 安装使用指南：3 种通道把 NSP、NSZ、XCI、XCZ 一次装进 Switch

【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-Installer

游戏文件明明下载好了，却因为签名失效、格式不支持或者传输失败卡在 Switch 上装不进去——这种挫败感，玩自制系统的玩家都经历过。Awoo Installer就是为这个场景做的开源安装器：NSP、NSZ、XCI、XCZ 全格式通吃，SD 卡、USB、局域网与网络三条通道任选，装完游戏稳稳进主菜单。

一分钟速览：它能干什么、干得怎么样

一句话定位：运行在 Switch 自制系统上的游戏文件安装器，基于 Adubbz Tinfoil 开发，用 XorTroll 的 Plutonium 框架做出图形界面。作者自己的评价很直接——"Just werks"，就是能装上，不折腾。

最小部署步骤：从源码编译到启动

手头没有现成的 .nro 文件也没关系，编译只有三条命令（前提是电脑已配好 DEVKITPRO 的 Switch 工具链，Makefile 会检测它并强制要求）：

git clone https://gitcode.com/gh_mirrors/aw/Awoo-Installer cd Awoo-Installer make

编译结束后，把生成的 .nro 复制到 SD 卡的switch/Awoo-Installer/目录——工具的运行配置config.json也会自动写在这里。插回 Switch，从 hbmenu 启动即可看到主菜单：通过 SD 卡安装、通过局域网或网络安装、通过 USB 安装、管理签名补丁、设置、退出。

一个容易踩的坑：如果你在 Applet 模式（比如从相册、通知栏这类轻应用入口）启动，工具会提示"Applet Mode not supported"并可能运行不稳定。遇到界面异常，退回主界面，按住 R 键从任意已安装游戏启动 hbmenu，再用完整模式进入 Awoo Installer。

三条通道实战：文件怎么从电脑进 Switch

场景一 · SD 卡直装，最稳的入门路线

1. 把NSP/NSZ/XCI/XCZ文件拷进 SD 卡任意目录。先分清这四种格式：NSP 是标准"安装包"；XCI 是主机版"光盘镜像"；NSZ 和 XCZ 是前两者的 zstd 压缩版，体积更小、传得更快——工具全都认，分割版文件保持原样放即可；
2. 启动 Awoo Installer，选择"通过 SD 卡安装"，进入浏览界面，只能看到上述四种扩展名的文件，按方向键进目录浏览；
3. 按A 键勾选单个文件（图标从空心框变成打勾），按Y 键可全选当前目录的文件；
4. 按+ 键开始安装，弹出对话框询问装到哪里：选SD 卡或内部存储；
5. 进度条走完后，工具会问要不要删除 SD 卡上的源文件——装完文件就派不上用场了，空间紧张就删，想留备份就选否（这个询问本身可以在设置里关掉，见后文）。

场景二 · 网络安装，免拔卡的远程方案

1. 确保 Switch 连着 Wi-Fi 且飞行模式已关，否则选菜单时工具会直接提示"Network connection not available"；
2. 选择"通过局域网或网络安装"，屏幕会显示Switch 的 IP 地址并进入等待状态；
3. 在电脑或手机上打开 NS-USBloader 这类工具，选Tinfoil 模式，填入这个 IP，选中文件上传即可；上传完成后在 Switch 的文件清单里勾选、按 + 安装。网络安装不限制文件扩展名，如果发送工具只认特定后缀，改一下文件名就能过；
4. 如果文件本来就在网上，可以直接选"网络链接"粘贴文件直链，或选"Google 网盘"填公开分享文件的 File ID，让 Switch 自己下载。

场景三 · USB 安装，速度党与批量党的选择

1. 电脑端装好 NS-USBloader，用支持数据传输的 USB-C 线连接 Switch 与电脑（纯充电线不行）；
2. 选择"通过 USB 安装"。首次进入会弹一个警告：USB 通道在某些设备上不一定稳定，建议优先用 NS-USBloader，实在不行走网络通道——看完勾选"不再提示"即可；
3. 电脑端选好文件（可多选批量发送），Switch 上会显示"USB connection successful"并列出文件清单；
4. 在清单里按 A 勾选、按 + 安装，等进度条走完。

三条通道怎么选：一张决策表

我的建议：第一次用先走 SD 卡，把流程跑通；日常补一两个游戏走网络省得拔卡；一次要塞几十个文件，或者电脑有网口、Switch 挂了以太网适配器时，再上 USB。

装完别忘的两道保险：NCA 验证与签名补丁

第一道：NCA 头部签名验证。安装前，工具会校验每个 NCA 文件的头部签名（相当于文件的"防伪章"），发现异常会弹警告让你确认。这个开关默认是开着的，想关掉会在设置里二次确认。看到警告但文件来源不确定时，先停下来想想再决定装不装。

第二道：签名补丁管理。主菜单选"管理签名补丁"，可一键安装、更新或卸载。工具会读取当前已装补丁的版本号（来自atmosphere/exefs_patches/es_patches/patches.txt）决定按钮显示"安装"还是"更新"；更新前会自动备份 Hekate 的 patches.ini，装完提示重启主机即可生效。系统升级后游戏装得上却打不开，第一反应就该来这里更新补丁。

值得动手的设置开关：5 个选项

设置菜单（代码实现见 设置页源码）里这几项最值得按习惯调整，改完自动写入config.json：

• 增强模式（Boost Mode）：安装时给 CPU 超频缩短耗时。SD 卡读写够快可以开，老旧卡建议保持关闭；
• 忽略游戏最低固件版本要求：想装高于当前系统固件的游戏时开启，代价是可能影响兼容性，谨慎使用；
• NCA 签名验证：默认开启，关掉前工具会先弹警告确认，不建议关；
• 安装后询问删除：默认开启，装完问一遍要不要删源文件；明确不想留备份的可以关掉，省得每次点确认；
• 自动检查更新：默认开启，工具会自动跟进新版本并弹窗询问是否更新。

翻车急救：4 个高频问题与补救顺序

• 安装中断 / 部分装完→ 先看目标存储（SD 卡或内部存储）空间够不够，再验证源文件完整性，最后换一条通道重试。装了一半的内容可以在系统设置 Applet 里删掉；
• 装完打不开游戏→ 优先去"管理签名补丁"更新补丁，其次确认 Atmosphere 是否为最新版，然后重启主机；
• 网络传输失败→ 确认 Switch 和电脑在同一网络、飞行模式已关；大文件建议改用 USB 或干脆拷回 SD 卡直装；
• USB 没反应→ 换支持数据传输的原装线、换 USB 口、重启双方后重试；工具自己的建议也是：实在不行就用网络或 SD 卡通道。

现在先做这三步

1. 把 .nro 放进switch/Awoo-Installer/，从 hbmenu 以完整模式启动，确认主菜单能正常打开；
2. 挑一个已下载的 NSP，走一遍SD 卡直装，感受勾选 → 选目标存储 → 进度条 → 询问删除的完整流程；
3. 顺手进"管理签名补丁"看一眼当前版本，旧了就更新一次，给后面装游戏铺路。

温馨提示：请只安装你拥有合法权利的游戏文件，尊重开发者劳动成果；操作涉及自制系统，重要存档记得提前备份。

【免费下载链接】Awoo-InstallerA No-Bullshit NSP, NSZ, XCI, and XCZ Installer for Nintendo Switch项目地址: https://gitcode.com/gh_mirrors/aw/Awoo-Installer