wiliwili 怎么装在 Switch 上？B 站客户端安装与首次启动完整指南-酒店常州论坛

wiliwili 怎么装在 Switch 上？B 站客户端安装与首次启动完整指南

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

wiliwili 是一款为手柄用户设计的第三方 B 站客户端，浏览、搜索、弹幕、评论全部走手柄按键，可运行在 Nintendo Switch、PS Vita、PS4、Xbox 以及 Windows、macOS、Linux 上。本文以 Switch 为例带你完成安装与首次上手：装之前要核对什么、两条安装路径、第一次怎么跑通、按键速查，以及出问题时的故障对照。

先搞懂：wiliwili 能帮你做什么

它是"用手柄看 B 站"的解决方案，和普通手机、PC 端比，差异集中在三件事上：

沙发上追番看弹幕：番剧横屏播放，弹幕、评论、分集切换全在手柄上，不用拿起手机。
刷 UP 主动态：动态页汇总关注 UP 主的最新投稿，摇杆上下翻页，和手机端竖着刷的动线不同，更适合大屏浏览。
大屏选片：影视频道按地区、风格、年份、评分多维筛选，手机屏幕放不下这些筛选项，Switch 当客厅选片器刚好。

环境核对：装之前先看四项

检查项	要求	怎么确认
大气层（Atmosphere，运行第三方应用所依赖的自制系统）	保持最新	系统设置 → 关于，查看系统版本
系统固件	与大气层同步更新	按大气层配套流程更新
SD 卡格式	FAT32	电脑上查看 SD 卡属性
系统时间	与真实时间一致	系统设置中的时钟
网络	Wi-Fi 可用，DNS 正确，未开代理	系统设置中查看连接状态

最容易被漏掉的两项：系统时间不准，以及 SD 卡不是 FAT32。时间一旦不准，网络通着也登录不了 B 站。

安装：预编译 nro 与源码构建

最短路径：放一个预编译文件

从项目 releases 页下载并解压wiliwili-NintendoSwitch.zip。
把wiliwili.nro（Switch 上的自制程序文件）拷进 SD 卡switch/目录，放成switch/wiliwili/wiliwili.nro也可以。
在 Switch 主页按住 R 键进入任意游戏，调出 hbmenu（一个用于启动 SD 卡文件的自制启动器）。
在sdmmc/switch列表里选中 wiliwili，按 A。

这一步最容易卡住：hbmenu 必须从游戏内调出。做对了的标志是列表里出现 wiliwili 卡片（粉色图标）。

进阶路径：源码构建最新版

适合想编译最新功能或改参数再打包的用户，一共四步：

拉取仓库：

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

在 docker 容器里跑构建脚本，ffmpeg、libmpv 等依赖会自动安装，脚本位于 scripts/build_switch.sh：

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

完成后cmake-build-switch目录里生成wiliwili.nro，替换 SD 卡里的文件。
想手动编译 ffmpeg/mpv 依赖，见 scripts/README.md。

首次启动：从黑屏到第一个视频播起来

启动：从 hbmenu 进入 nro，首次会先看到操作教程页，翻完进主界面。信号：首页热搜列表加载出来。
确认联网：看顶部 Wi-Fi 图标，没连上先回系统设置连网，否则后面每步都会失败。
登录账号：进"我的"选择账号登录，用手机 B 站 App 扫码确认。信号：我的页出现用户头像，收藏、历史随账号同步。
播一个视频：首页热门推荐里任选一个进入。信号：视频开始播放，弹幕开始滚动，评论和分集切换都在当前页面。

任何一步卡住，先看下一节的对照表。

症状对照：跑不通先查这张表

你看到什么	最可能的原因	做什么	怎么算修好
启动后长时间黑屏或直接退出	配置缓存损坏或过期	删除 SD 卡`config/wiliwili`目录后重新进入	首页正常加载内容
页面不加载、登录失败	系统时间不准、DNS 设置不当、代理没关	校正系统时间，DNS 改 8.8.8.8 或 1.1.1.1，关闭代理	设置 → 实用工具 → 网络诊断显示正常
播放卡顿、频繁缓冲	画质过高，或走了软解	默认画质改为自动或 720P，开启硬件解码	重播同一视频不再频繁转圈
手柄按键无响应	手柄未识别或应用卡死	重新配对手柄，重启应用	底部按键提示能跟随焦点移动
桌面图标点不开	nro 不在两个查找路径里	把文件放到`switch/wiliwili.nro`或`switch/wiliwili/wiliwili.nro`	点图标直接进应用

提交问题前，先在设置 → 实用工具 → 网络诊断里截个图，并确认代理已关闭再复测。

手柄按键：九个键覆盖九成操作

屏幕底部有按键提示，会跟随焦点变化，下表是主体部分：

按键	作用
A	确认、开始播放、暂停
B	返回上一级、关闭当前面板
X	打开搜索框（主界面）；切换弹幕（播放页）
Y	切换播放信息叠加层 OSD（播放页）
左摇杆 / 十字键	移动焦点、滚动列表
L / R	切换到上一个 / 下一个标签页
上 / 下（播放页）	调整音量
左 / 右（播放页）	快退 / 快进
Start	进设置（主界面）；打开清晰度菜单（播放页）
Select	进设置（主界面）

高频组合：

长按 A：快速播放/暂停
长按右摇杆：播放页临时快进
Start（播放页）：直接打开清晰度菜单

装完值得做的三件事

装一个桌面图标

默认每次都要绕道 hbmenu 启动。想从主页直接进，走设置 → 实用工具 → 使用教程，应用会把内置 NSP（Switch 安装包格式）写进 SD 卡。图标启动时按顺序查找switch/wiliwili.nro和switch/wiliwili/wiliwili.nro，都找不到就打开 hbmenu 让你手动选。想自行打包图标，见 scripts/switch-forwarder/README.md。

按屏幕选渲染版本

默认发布的是 OpenGL 版本，最高 4K@30。要 4K@60 就构建 deko3d 版本（走 Switch 原生图形 API，脚本在 scripts/build_switch_deko3d.sh），播放更顺但偶发崩溃。只有想在电视上跑 4K 高帧率时才需要换。

降一档默认画质

默认自动选画质。网络一般时，把默认画质改为自动或 720P 并开启硬件解码，比硬扛高画质稳定得多。出现频繁缓冲、转圈时再动手。

更多 Anime4K、自定义字体之类的深层配置见项目 wiki；遇到无法自行解决的 bug，先到项目 issues 区搜一下，再附上网络诊断截图提交反馈。装完建议顺手把桌面图标装上，多台设备登录同一 B 站账号后确认收藏、历史和追番都能同步。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析