wiliwili在Switch大气层上的完整安装与上手指南：B站客户端一步到位
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
wiliwili是一款为手柄操控优化的B站客户端，除了PC也支持掌机与主机。读完本文，你能自己构建 NRO 并装进大气层，完成扫码登录、按键适配与外观自定义。
✅ 前置检查：固件、签名补丁与构建环境
动手前先过一遍清单，后面九成问题都出在这里：
- 大气层固件建议 1.5.0 及以上，且能正常进入自制程序菜单
- sigpatches（签名补丁，让系统允许运行未签名自制程序的补丁集）已更新到最新版
- 存储卡预留至少 100MB 空闲空间
- 电脑上准备一张卡读卡器，用于往卡里写文件
- 一台 Linux 构建机，装好 curl、cmake、make 和 dkp-pacman（构建脚本靠它安装面向 Switch 的依赖包）
📦 构建 wiliwili.nro 并安装到存储卡
NRO 是大气层的标准自制程序格式，放进卡的 switch/ 目录即可在菜单启动。整个构建不用手动编译，一个脚本搞定。
克隆仓库并执行构建：
git clone https://gitcode.com/GitHub_Trending/wi/wiliwili cd wiliwili ./scripts/build_switch.sh脚本会先用 dkp-pacman 装好 ffmpeg、libmpv 等四个 Switch 依赖包再开始编译，成功后在构建目录cmake-build-switch/下生成wiliwili.nro。
把产物拷进存储卡的 switch 目录：
cp cmake-build-switch/wiliwili.nro <卡的挂载路径>/switch/尖括号替换成实际的挂载点。重启 Switch 后，自制程序菜单里就能看到 wiliwili。
首次启动：连 Wi-Fi、扫码登录、调播放器
首次启动要干三件事：连网、登录、把播放器调到顺手。
- 连接 Wi-Fi：按首次启动提示选择网络并输入密码，连不上时后续可在设置页手动切换 DNS 服务器。
- 扫码登录 B 站账号：进入「我的」打开登录二维码，用手机端 B 站 App 扫码并确认，客户端自动完成登录，无需输入账号密码。
- 调整播放设置：进入设置页选择默认画质、弹幕开关与音量，按自己习惯来。
- 开播验证：从首页热门里随便点开一条视频，确认声音、弹幕、缓冲都正常。
登录后个人动态与关注更新会显示在个人主页：
首页热门榜、追番与影视分区一目了然：
🎮 手柄映射速查
每个页面底部都有实时按键提示，不用死记，下面这些覆盖日常操作：
| 按键 | 功能 |
|---|---|
| 左摇杆 | 菜单与列表导航 |
| A | 确认 / 进入 |
| B | 返回 / 关闭 |
| X / Y | 播放中快捷操作 |
| L / R | 翻页与 Tab 切换 |
想改快捷键行为，定义集中在 shortcut_helper.hpp，涵盖刷新、搜索、快进快退、清晰度与倍速等组合。
🧩 生成带自定义图标的 NSP 并安装到系统菜单
想从系统主菜单直接启动、而不是每次走自制程序菜单，就把 NRO 打成 NSP（Switch 可安装软件包格式，可用 Goldleaf 或 Tinfoil 安装）。
- 准备本机 Switch 导出的设备密钥
prod.keys放到工作目录，打包工具 hacbrewpack 靠它签名。 - 运行打包脚本：
cd scripts/switch-forwarder ./pack.sh脚本内部调用 hacbrewpack，进程参数（标题 ID 0x010ff000ffff0001、名称等）由 wiliwili.json 定义，最终产出 NSP，传到卡里安装即可。
换图标只需准备一张 128x128 的 PNG，替换脚本拷入icon_AmericanEnglish.dat的图标源文件后重跑 pack.sh，系统菜单里的图标就换掉了。
故障排查：最常见的三类问题
现象对号入座，按要点逐条处理。
启动即黑屏
现象：点图标黑屏，或直接退回主菜单。
- 确认 sigpatches 已更新，且大气层与固件版本匹配
- 重新拷贝 wiliwili.nro 到卡上，排除文件损坏
- 核对文件位于 switch/ 根目录且文件名未改动
手柄无响应
现象：按键没反应，或导航行为错乱。
- 检查手柄配对状态与剩余电量
- 重启 Switch，让手柄重新同步
- 对照 shortcut_helper.hpp 里的按键映射定义核对功能
播放频繁缓冲
现象：视频播放中反复卡住。
- 先把默认画质降一档
- 检查 Wi-Fi 信号，在设置页尝试切换 DNS
- 关掉其他后台运行的自制程序，降低占用
装完即上手：Switch 从此随时打开完整功能的 B站，从首页刷到直播弹幕都靠一个客户端。更多细节见 README.md 与各平台打包说明 scripts/README.md。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
