在 Switch 大气层装 wiliwili 的完整指南：B站客户端从安装到看片

在 Switch 大气层装 wiliwili 的完整指南：B站客户端从安装到看片

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili

想把 B 站搬上电视？wiliwili 是为手柄用户写的 B 站客户端，主平台是 Switch 大气层，PS Vita、PS4 和 Windows、macOS、Linux 也都支持。跟着这篇走，你能从零装好它，一直走到播完第一支视频。

🎬 你会上手用的三个场景

先对一下需求，确认 wiliwili 合不合你的用法。

• 你把 Switch 当客厅选片器，按地区、年份、评分筛片单
• 碎片时间里，你用摇杆刷完关注 UP 主的最新动态
• 沙发横屏追番，弹幕和分集切换全程不用离沙发

🔍 动手前先过一遍环境自检

安装失败大多栽在环境上，先把这张表对完再动手。

最容易被忽略的两项：大气层和固件没跟到最新，SD 卡不是 FAT32。另外系统时间一旦不准，网络通着也登录不了 B 站。

📦 安装 wiliwili：现成包或自己编译

不想折腾走预编译，想拿最新功能走源码。

预编译包：4 步装好

1. 从项目 releases 页下载对应版本的 wiliwili-NintendoSwitch.zip 并解压。
2. 把解压出的 wiliwili.nro 复制到 SD 卡 switch/ 目录，写成 switch/wiliwili/wiliwili.nro 同样生效。
3. 插回 SD 卡，在 Switch 主页按住 R 键，从任意游戏调出 hbmenu。
4. 在 hbmenu 的 sdmmc/switch 列表里找到 wiliwili，按 A 启动。

源码路线：自己编译最新 nro

1. 拉取仓库：

git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili

2. 在 docker 容器里跑构建脚本，它会自动装好 ffmpeg、libmpv 等依赖再编译，脚本见 scripts/build_switch.sh：

docker run --rm -v $(pwd):/data devkitpro/devkita64:20251117 \ bash -c "/data/scripts/build_switch.sh"

3. 构建完成后在 cmake-build-switch 目录拿到 wiliwili.nro，替换 SD 卡里的文件即可。
4. 需要手动编译 ffmpeg/mpv 依赖，参考 scripts/README.md。

🚀 首次启动：一条直线走到播放页

第一次启动不用改任何设置，按顺序走就行。

1. 教程页：从 hbmenu 启动 nro 会先播一段教程页，演示手柄操作方式，翻完进入主界面。
2. 账号登录：进"我的"选账号登录，用手机 B 站 App 扫码并确认授权，收藏、历史记录、追番追剧列表随账号同步。登录失败先盯顶部 Wi-Fi 图标，没连网就回系统设置处理。
3. 进入播放页：回首页，从热门推荐任选一个视频点进去。
4. 验证播放：播放页直接支持弹幕、评论和分集切换；底部栏会给出 搜索/返回/确定 的按键提示，照着提示按，误触少很多。

🕹️ wiliwili 手柄操作：按键表与高频组合

屏幕底部的按键提示会跟随焦点走，把这张表记牢就覆盖绝大多数操作。

高频组合与长按只有三个，口述一遍就记住：

• 长按 A：快速播放/暂停
• L + A：收藏当前视频
• 长按右摇杆：播放页临时快进

⚙️ 进阶设置：图标、渲染版本与账号同步

这三项决定你每天用得顺不顺，每一项都不难。

装一个桌面图标不装图标，每次都得绕道 hbmenu。应用内置了一键入口：设置 → 实用工具 → 使用教程，确认后应用会把内置 NSP 直接写进 SD 卡。图标启动时按顺序查找 switch/wiliwili.nro 和 switch/wiliwili/wiliwili.nro，两个都没有就打开 hbmenu 让你手动选。想自己打包图标，源码和说明在 scripts/switch-forwarder/。

按网络选渲染版本默认发布的 OpenGL 版最高 4K@30；想要 4K@60 就构建 deko3d 版，它用 Switch 原生图形 API，播放更顺但偶发崩溃。网络一般时，把默认画质设为自动或 720P 并开启硬件解码，比硬扛高画质稳定得多。

多设备账号同步多台设备登录同一个 B 站账号就行，收藏、观看历史、追番追剧列表自动同步。历史记录支持跨设备续播，无需额外配置。

🩹 故障排查：四个高频问题对号入座

用着用着卡住了，按现象、原因、动作、验证四个要素对一下。

启动后长时间黑屏或直接退出？多半是配置缓存损坏或过期。删掉 SD 卡里的 config/wiliwili 目录后重新进入，能正常进首页并加载内容就说明修好了。

页面不加载、登录失败？三个嫌疑：系统时间不准、DNS 设置不当、代理没关。校正系统时间，DNS 改成 8.8.8.8 或 1.1.1.1，关闭代理，再到 设置 → 实用工具 用网络诊断截图核对。

播放卡顿、缓冲频繁？大概率是画质开太高或走了软解。把默认画质设为自动或 720P、开启硬件解码，重播同一支视频不再频繁转圈即通过验证。

手柄按键无响应？手柄没被识别或应用卡死。重新配对或重连手柄，重启应用并恢复默认按键显示，底部按键提示能跟随焦点移动就好了。

下一步建议：先把桌面图标装好，再完整走一遍"追番 + 弹幕播放"，确认同步符合预期。更多 Anime4K、自定义字体等技巧见项目 wiki，解决不了的 bug 直接去 issues 区提。

【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili