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 与 PC 全平台。沙发追番看弹幕、摇杆刷 UP 主动态、大屏多维筛选影视片单，是它最典型的三个场景。
🚀 最快上手：从下载到启动只需 4 步
这一节给你一条最短可行路径，先让 wiliwili 在 Switch 上跑起来，环境核对与故障处理放在后面。
- 从项目 releases 页下载
wiliwili-NintendoSwitch.zip并解压，取出wiliwili.nro。 - 把
wiliwili.nro复制到 SD 卡的switch/目录，即switch/wiliwili.nro；放成switch/wiliwili/wiliwili.nro也可以。 - 在 Switch 主页对任意游戏按住 R 键进入，通过 hbmenu（大气层的 SD 卡启动菜单）调出
sdmmc/switch列表。 - 在列表里选中 wiliwili，按 A 启动。首次进入会先播放一段手柄操作教程，翻完即到达主界面。
📋 环境核对与源码构建
装之前先对照下表把环境过一遍——后文提到的黑屏、登录失败，多数都能在这里提前避开。
| 检查项 | 达标标准 | 确认方式 |
|---|---|---|
| 大气层（Atmosphere） | 1.5.0 及以上，建议保持最新 | 设置 → 系统 → 系统版本 |
| 签名补丁 sigpatches | 最新版 | 查看 SD 卡atmosphere/patches目录 |
| 系统固件 | 与大气层版本同步 | 按大气层配套流程更新 |
| SD 卡格式 | FAT32 | 电脑上查看 SD 卡属性 |
| 剩余空间 | 100MB 以上 | 设置 → 数据管理 |
| 系统时间 | 与真实时间一致 | 系统设置中的时钟 |
其中大气层/固件落后和 SD 卡非 FAT32 最容易被漏掉；系统时间不准时，网络通也登录不了 B 站。
开发者源码构建 nro
想追最新功能或改参数再编译，走源码路线一共四步：
- 拉取仓库（含全部第三方库子模块）：
git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili- 在 devkitPro 容器里运行构建脚本，它会自动安装 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 启动后先出现教程页，演示手柄操作方式；翻页结束后自动进入主界面，此时看到首页推荐流即为成功。
- 确认联网：看界面顶部的 Wi-Fi 图标。未连接时先回系统设置连网——登录失败时优先排查网络，而不是账号问题。
- 账号登录：进入"我的"，选择账号登录，用手机 B 站 App 扫码并确认授权。登录成功后，收藏、历史记录、追番追剧列表会随账号同步下来。
- 进入播放页：回到首页，从热门推荐里任选一个视频点入。
- 验证播放：播放页直接支持弹幕、评论与分集切换；底部栏会显示当前按键提示（搜索/返回/确定），对照提示操作可少误触。听到声音、看到弹幕滚动，就说明链路全通了。
🕹️ 手柄按键操作速查表
屏幕底部的按键提示会跟随焦点变化，记住下表就能覆盖绝大多数操作。
| 按键 | 功能 |
|---|---|
| A | 确认、点击播放、提交 |
| B | 返回上一级、关闭当前面板 |
| X | 打开搜索框 |
| Y | 刷新当前页面 |
| 左摇杆 / 十字键 | 移动焦点、滚动列表 |
| 上 / 下（播放页） | 调整音量 |
| 左 / 右（播放页） | 快退 / 快进 |
| L / R | 切换顶层标签页 |
高频组合与长按操作只有三个：
- 长按 A：快速播放/暂停
- L + A：收藏当前视频
- 长按右摇杆：播放页临时快进
🩹 常见问题故障排查表
遇到异常先按下表"现象 → 原因 → 动作 → 验证"自查，高频问题基本都能自己解决。
| 现象 | 最可能原因 | 处理动作 | 如何验证 |
|---|---|---|---|
| 启动后长时间黑屏或直接退出 | 配置缓存损坏或过期 | 删除 SD 卡config/wiliwili目录后重新进入 | 能正常进入首页并加载内容 |
| 页面不加载、登录失败 | 系统时间不准、DNS 设置不当、代理未关闭 | 校正系统时间，DNS 改为 8.8.8.8 / 1.1.1.1，关闭代理 | 设置 → 实用工具 → 网络诊断截图正常 |
| 播放卡顿、缓冲频繁 | 画质过高或走了软解 | 默认画质设为自动或 720P，开启硬件解码 | 重播同一视频不再频繁转圈 |
| 手柄按键无响应 | 手柄未识别或应用卡死 | 重新配对/重连手柄，重启应用并恢复默认按键显示 | 底部按键提示能跟随焦点移动 |
⚙️ 进阶优化：装完最值得做的三件事
跑通之后，下面三项配置能显著提升日常体验。
一键安装 Switch 桌面图标
做什么：把 wiliwili 变成主屏幕图标，省去每次绕道 hbmenu 启动。为什么值得：日常高频启动，一键直达比翻列表省事得多。怎么操作：进入 设置 → 实用工具 → 使用教程，确认后应用会把内置的 NSP 直接写入 SD 卡。图标启动时按顺序查找switch/wiliwili.nro与switch/wiliwili/wiliwili.nro，都找不到则会打开 hbmenu 让你手动选。想自行打包图标的，源码与说明在 scripts/switch-forwarder/。
按网络状况选渲染版本与画质
默认发布的 OpenGL 版本最高支持 4K@30 播放；追求 4K@60 可构建 deko3d 版本（使用 Switch 原生图形 API），播放更顺滑但偶发崩溃。网络一般时，把默认画质设为自动或 720P 并开启硬件解码，比硬扛高画质稳定得多。
多设备同步账号数据
多台设备登录同一个 B 站账号即可：收藏、观看历史、追番追剧列表自动同步，历史记录支持跨设备续播，无需任何额外配置。
写在最后
建议下一步先装好桌面图标，再完整走一遍"追番 + 弹幕播放"流程，确认同步符合预期。更多 Anime4K、自定义字体等技巧见项目 wiki；遇到无法解决的 bug，欢迎到项目 issues 区提交反馈。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
 详解)
