5分钟装好游戏机上的B站客户端：wiliwili 跨平台追番实战指南
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
深夜抱着 Switch，不想打游戏，只想刷会儿 B 站热榜，却发现官方客户端不支持游戏机，主机浏览器又几乎没法用。wiliwili 是一个专为手柄设计的开源第三方 B 站客户端，支持 Nintendo Switch、PSVita、PS4 和 PC 全平台，让你在游戏机上直接刷推荐、追番剧、看直播，体验非常接近官方 PC 客户端。
一、环境准备与安装 📦
四个平台的装法略有差异，按你的设备选对应小节即可。
Nintendo Switch 安装步骤
前提：主机已安装大气层（Atmosphere）并更新固件，内存卡格式化为 FAT32。
- 从项目 releases 页面下载
wiliwili-NintendoSwitch.zip，解压后将wiliwili.nro放入内存卡的switch目录。 - Switch 主界面按住 R 键启动任意游戏，进入 hbmenu 自制菜单。
- 在列表中选择 wiliwili，按 A 启动。
- 【可选】在应用内安装桌面图标，入口：设置 / 实用工具 / 使用教程，之后从主界面直接启动。
注意：默认版本为 OpenGL 渲染，最高播放 4K@30；想要更流畅的 4K@60 可以选用 releases 中的 deko3d 版本（Switch 原生图形接口），但偶尔可能崩溃。
PSVita 安装
下载wiliwili-PSVita.vpk在主机上安装即可。开启硬件解码后能流畅播放 720P 横屏视频、480P 竖屏视频，部分直播可以播 1080P 原画。
PS4 安装
下载wiliwili-PS4.pkg安装即可。PS4 只支持软件解码，播放 4K@60 内容需要在设置中开启低画质解码（见后文进阶配置）。
PC 安装（Windows / macOS / Linux）
下载对应系统的安装包运行即可，支持切换硬件解码，老电脑也能秒开。鼠标操作为左键选中、右键返回、中键刷新。Linux 与 Steam Deck 用户还可以直接在系统软件商店（Discover、GNOME Software 等）搜索wiliwili安装。
安装完成后，直接上手看看实际体验。
二、核心使用场景实测 🎬
场景一：首页推荐追番
操作路径：启动后首页是推荐、热门、番剧、影视四个象限。用方向键在列表间移动，按 A 进入；影视象限可在"我的追番 / 正在热播 / 电影热榜 / 纪录片热榜"间切换。
预期效果：番剧页头部一行是追番列表，点卡片直达选集页；列表里可以直接追番、取消追番、查看进度，整体接近官方 PC 端的手感。
注意事项：首页默认可以按返回键退出，担心误触的话，在设置中开启"首页无法通过返回退出"。
首页推荐刷不到想看的，就用搜索页精确找。
场景二：搜索指定视频、番剧与影视
操作路径：点底部搜索入口（PC 上默认 Ctrl+F）。搜索页提供热搜、视频、番剧、影视四个入口，并记录搜索历史；影视板块支持关键字首字母搜索。
预期效果：视频是横版卡片流，番剧与影视自动切换成竖版海报卡；影视板块带地区、类型、年份、付费类型等筛选条件，用"年份 + 地区 + 类型"能快速定位老番。
注意事项：搜索历史登录后可保存，随时可以清空。
找到内容后进入播放页，这是手柄客户端最有特色的场景。
场景三：播放视频：弹幕、评论与选集
操作路径：播放页按 A 播放/暂停，拖动进度条调整位置，按 Start 打开播放设置（PC 默认 F1），弹幕、画质、倍速都在里面。
预期效果：弹幕实时渲染，可以直接发弹幕、浏览评论；番剧右侧有分集列表可以点选播放，同时展示 UP 主最新投稿。
注意事项：未登录默认 360P 画质，扫码登录后最高可选 1080P60，具体受设备性能限制。
场景四：扫码登录与个人中心管理
操作路径："我的"页签 → 登录，会出现二维码，用手机 B 站 App 扫码完成。
预期效果：登录后画质上限提升、首页推荐变成个性化内容；历史、收藏、我的追番、我的追剧都集中在个人页，收藏可按文件夹管理。
注意事项：扫码是临时登录，长期使用建议把 Cookie 保存到配置文件里（见进阶配置一节）。
按键记不全很正常，下面这张速查表扫一眼就能记住。
三、高频操作速查表 ⌨️
手柄（Xbox 布局）与 PC 键盘默认映射如下：
| 操作 | 手柄 | 键盘（默认） |
|---|---|---|
| 播放 / 暂停 | A | Space |
| 确认 / 选中 | A | Enter |
| 返回 | B | Esc |
| 移动选择 | 方向键 / 左摇杆 | 方向键 |
| 快退 / 快进 | 拖进度条 / 右摇杆 | [ / ] |
| 音量 大 / 小 | — | 0 / 9 |
| 弹幕开关 | — | D |
| 播放设置（画质/倍速/弹幕） | Start / 菜单键 | F1 |
| 切换画质 | — | F2 |
| 切换倍速 | — | F3 |
| 上一集 / 下一集 | — | PgUp / PgDn |
| 上一个 / 下一个分P | — | Shift+PgUp / Shift+PgDn |
| 打开应用设置 | — | F5 |
| 刷新当前页 | — | Ctrl+R（macOS 为 ⌘+R） |
| 跳转搜索 | — | Ctrl+F（macOS 为 ⌘+F） |
另有三个实用功能：重压摇杆临时快进；单手模式用一个手柄完整控制播放器；PC 端上述快捷键均可在设置里改键。
想让体验更顺一点，还有几个值得动的设置。
四、进阶配置与个性化 🎛️
设置入口在"设置"页（或按 F5），只讲影响较大的几项。
- 主题色：提供深/浅两色主题，推荐开启"跟随系统"，环境变化时自动切换，不用手动调。
- 画质增强（Anime4K）：在配置目录放一个
shader.json即可加载 Anime4K 着色器配置。建议只对番剧生效（配置里可以按番剧指定 profile），低配设备不建议全局开启，开销明显。 - 硬件解码：PSVita 用户建议开启硬解，720P 横屏立刻流畅；PS4 软解在 4K@60 上吃力，开启低画质解码即可缓解；PC 老机器选"自动安全"档位即可。
- 网络设置：支持配置代理（示例
http://127.0.0.1:7890）、开关 TLS 证书校验，配合"网络诊断"可以定位 DNS、时间差、IP 等问题。 - 个性化：按键图标可切换 Xbox / PlayStation / 键盘三套样式；在配置目录放入
font.ttf、icon.ttf、danmaku.ttf可以覆盖内置字体。
各平台配置目录：Switch 为/config/wiliwili/，PSVita 为ux0:/data/wiliwili/，PC 分别为~/.config/wiliwili/（Linux）、%LOCALAPPDATA%\xfangfang\wiliwili\（Windows）、~/Library/Application Support/wiliwili/（macOS）。登录态与 Cookie 都存在目录内的wiliwili_config.json中。
设置再对，也可能遇到意外，下面是 5 个最常见问题的处理办法。
五、常见问题快速排查 🩺
1. Switch 启动后黑屏很久进不去现象：打开后卡在黑屏。原因：本地配置损坏，这个报错很常见。解决：删除内存卡上的config/wiliwili目录后重新进入，设置会恢复默认。
2. 内容加载不出、出现网络错误页现象：列表不刷新、图片不出来。原因：多为系统时间、DNS 或代理干扰。解决：先确认系统时间正确（证书校验依赖时间），检查系统 DNS，关闭网络代理后重试；用"设置 / 实用工具 / 网络诊断"截图排查连通性。
3. PS4 播放 4K@60 卡顿现象：4K 高帧率视频掉帧。原因：PS4 仅软解，负载偏高。解决：在设置中开启低画质解码，这是官方推荐做法。
4. PSVita 直播 1080P 卡顿现象：横屏视频流畅，1080P 原画掉帧。原因：OpenGL 版默认画质有限。解决：开启硬解后可流畅播放 720P 横屏，部分直播房间能播 1080P 原画。
5. Switch 进不了应用、hbmenu 里找不到现象：hbmenu 列表中没有 wiliwili。原因：路径不对或大气层/固件过旧。解决：确认wiliwili.nro在内存卡switch目录下，把大气层与系统固件更新到最新，并确认内存卡是 FAT32。
如果自己排查不了，可以去项目社区找答案。
六、社区与参与 🤝
- 反馈与讨论：问题提给 Issues 页面，创意和想法去 Discussions 讨论；网络问题请附带网络诊断截图，并确认系统时间、DNS 设置正常后再反馈。
- 翻译贡献：项目已支持简中、繁中、日、韩、英等多种语言，翻译工作在 Crowdin 平台上进行，发现翻译问题也可以直接提 issue。
- 代码贡献：主分支
yoga是最新稳定代码，所有新 PR 请提交到dev 分支；开发新功能前建议先开一个 issue 讨论，避免和别人撞车。
代码按页面（activity）、API、组件（view）、工具（utils）分层，想深入可以从这几个目录入手：wiliwili/include/activity/、wiliwili/include/api/bilibili/、wiliwili/include/view/；架构说明和关键文件索引在 AGENTS.md，各平台编译方法见 README.md：
git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili回到开头那个深夜的场景：你手里的 Switch 打开 wiliwili，热榜就摆在面前，追番、发弹幕、刷评论都不用手柄之外任何东西。如果你的游戏机一直只是打游戏，今晚就下载对应平台的安装包试试，第一次用方向键刷 B 站的时候，你会明白这个 B 站客户端对游戏机意味着什么。
【免费下载链接】wiliwili第三方B站客户端，目前可以运行在PC全平台、PSVita、PS4 、Xbox 和 Nintendo Switch上项目地址: https://gitcode.com/GitHub_Trending/wi/wiliwili
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
