wiliwili Switch 安装指南一个手柄玩 B 站从 SD 卡到看弹幕【免费下载链接】wiliwili第三方B站客户端目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwiliwiliwili 是一款专为手柄用户设计的第三方 B 站客户端。把它装在 Nintendo Switch 的大气层Atmosphere一个能让你在 Switch 上运行非官方软件的替代系统上一个 Joy-Con 就能刷热搜、看番剧弹幕、刷 UP 主动态、按条件筛影视收藏和追番还能跟着账号走。动手前检查大气层、SD 卡格式和系统时间Switch 上装不起来的案例多半问题不在 wiliwili而在 SD 卡和系统时间这两处。按下面几项过一遍每项花不了半分钟大气层版本设置 → 系统 → 系统版本里看要求 1.5.0 以上能更新就更新到最新。签名补丁 sigpatches大气层用来加载非官方软件的补丁确认 SD 卡atmosphere/patches目录里是最新版。SD 卡格式电脑上查看 SD 卡属性必须是FAT32。这是最容易翻车的一项exFAT 直接打不开文件。剩余空间数据管理里确认有 100MB 以上空闲。系统时间与真实时间一致。这一条最容易被忽略——时间不准的话网络明明通着登录 B 站也照样失败。SD 卡目录怎么放怎么从 hbmenu 启动 wiliwili文件放对位置A 键一按就进整个安装就这么短但位置最容易放错。预编译包路线大多数人走这条从项目仓库的 releases 页面下载对应版本的wiliwili-NintendoSwitch.zip并解压。把解压出的wiliwili.nroSwitch 可执行文件格式复制到 SD 卡的switch/目录放成switch/wiliwili/wiliwili.nro也可以。Switch 主页按住 R 键进入任意游戏调出hbmenu自制软件启动菜单Switch 上跑 nro 的入口。在 hbmenu 的sdmmc/switch列表里找到 wiliwili按 A 启动。想跑最新代码从源码编译 nro想要仓库里还没发版的最新功能或者想改参数再编译整个流程两条命令。先拉取仓库git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili在 docker 容器里跑 构建脚本它会自动装好 ffmpeg、libmpv 等依赖并编译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收藏当前视频长按右摇杆在播放页临时快进。其余功能都可以先在设置里切回默认按键显示再对着底部提示逐个认。桌面图标一键安装渲染版本怎么选不装桌面图标每次启动都得绕道 hbmenu装上就省得每次绕一圈。桌面图标应用内置一键安装入口路径是 设置 → 实用工具 → 使用教程确认后应用会把内置的 NSP 直接写入 SD 卡Switch 主页就能像系统应用一样点开 wiliwili。图标启动时按顺序查找switch/wiliwili.nro和switch/wiliwili/wiliwili.nro两个路径都找不到时会打开 hbmenu 让你手动选所以前文放哪条路径都能启动。想自己打包图标的话源码与打包说明在 scripts/switch-forwarder/README.md。渲染版本默认发布的是 OpenGL 版最高支持 4K30想要 4K60 可以构建使用 Switch 原生图形 API 的 deko3d 版构建方式见 scripts/build_switch_deko3d.sh播放更顺但偶发崩溃。网络一般的话别硬扛高画质把默认画质设为自动或 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考