wiliwili：游戏机 B 站客户端完整上手指南，Switch 追番与 PSVita 看直播一次配齐-开发者社区

wiliwili：游戏机 B 站客户端完整上手指南，Switch 追番与 PSVita 看直播一次配齐

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

wiliwili 是专为手柄设计的第三方 B 站客户端，复刻官方 PC 端的浏览、播放与追番体验。它同时跑在 Nintendo Switch、PSVita、PS4 与 Windows / macOS / Linux 上，支持触屏、鼠标、键盘、手柄四种操控，登录同一账号后观看历史跨设备衔接。

🧭 先搞清楚：它是什么，和常见方案差在哪

一句话：把 B 站官方 PC 客户端的能力整体搬上手柄。官方版没有游戏机版本，电视盒子类客户端又大多没有弹幕，wiliwili 把这两块缺口一次补上，而且深浅两色主题跟随系统自动切换。

上图为 wiliwili 的搜索页与影视筛选页：热搜、视频、番剧、影视四类搜索内容分 tab 呈现，影视筛选支持地区、风格、年代、付费类型等维度，不用翻第二屏就能定位内容。

能力总览：

能力	wiliwili 的表现
覆盖平台	Nintendo Switch、PSVita、PS4、Windows 7+、macOS 10.11+、Linux（含 Steam Deck）
操控方式	手柄、鼠标、键盘、触屏四路并行，键位图标可在 Xbox / PlayStation / 键盘三套间切换
信息流	首页「直播 / 推荐 / 热门 / 追番」四象限铺开，UP 主动态页单独成页
追番追剧	影视分类支持按地区、风格、年代筛选，播放页内展示分集列表与 UP 主最新投稿
弹幕评论	视频、番剧、电影、纪录片、综艺统一进同一个播放页，弹幕与评论全支持
直播	关注主播 + 系统推荐，直播间弹幕侧边栏可调整数量或整体隐藏
账号同步	「我的」页扫码登录 B 站后，观看历史、收藏、追番追剧跨设备衔接
投屏	DLNA 投屏，把播放内容推到局域网内其他设备

代码层面它是一整套自绘 UI：界面用 nanovg 绘制，窗口与按键走 GLFW 或 SDL2，播放用 mpv + FFmpeg，接口层用 cpr + nlohmann/json 请求 B 站。源码分层很清晰，页面在 wiliwili/include/activity/，数据请求在 wiliwili/include/api/bilibili/，可复用控件在 wiliwili/include/view/。

📦 十分钟装机：多平台安装速查

各平台安装包都在项目 release 页下载，装完即可开机：

平台	下载包	前置条件	关键坑
Nintendo Switch	`wiliwili-NintendoSwitch.zip`	大气层与系统固件更新到最新，内存卡保持 FAT32	`wiliwili.nro`放进内存卡`switch`目录，任意游戏主页按住 R 键用 hbmenu 打开；默认 OpenGL 版最高 4K@30，想上 4K@60 要换 deko3d 版
PSVita	`wiliwili-PSVita.vpk`	主机可直接安装	装完去设置开启硬解，否则 720P 会卡
PS4	`wiliwili-PS4.pkg`	USB 拷贝安装	只有软解，4K@60 必须开低画质解码
Windows / macOS	对应系统安装包	Windows 7+、macOS 10.11+	鼠标左键确认、右键返回、中键刷新
Linux / Steam Deck	软件商店（Discover、GNOME Software）搜`wiliwili`	无	无

Switch 用户装完后可以到「设置 / 实用工具 / 使用教程」里安装桌面图标，之后从主界面直接进。桌面图标会依次尝试switch/wiliwili.nro和switch/wiliwili/wiliwili.nro两个位置，都没有就弹出 hbmenu 让你自选路径，放错目录也能自救。

🕹️ 核心能力逐项拆

按功能块拆，每块四件事：在哪、怎么操作、实际效果、容易踩的坑。

首页信息流

四拍	内容
在哪	首页，直播 / 推荐 / 热门 / 追番四个 tab 一屏铺开
怎么操作	方向键导航，A 确认，B 返回；PC 上鼠标中键刷新
实际效果	当天要追的内容一屏找齐，热门榜与关注动态并排展示
容易踩的坑	列表页误触 B 容易退出去，设置里有「首页返回退出保护」可打开

追番与影视

四拍	内容
在哪	首页「追番」tab、影视分类页、「我的」页的追番追剧列表
怎么操作	影视分类按地区、风格、年代、付费类型筛选，点进详情页选任意一集
实际效果	详情页展示评分、简介与分集列表，可设「自动播放分集」「自动播放推荐」，一集接一集不用手动点
容易踩的坑	未登录时默认只给 360P，登录 B 站账号才能上更高画质

播放、弹幕与评论

四拍	内容
在哪	所有视频类型（视频、番剧、电影、纪录片、综艺）进同一个播放页
怎么操作	播放页内切倍速、调弹幕、看评论，重压摇杆可临时快进
实际效果	暂停后再进入自动记回原进度；评论支持图片与大表情，弹幕密度在弹幕设置里调
容易踩的坑	评论「跳转进度」还在开发中，别指望点评论直达对应时间点

直播

四拍	内容
在哪	首页「直播」tab，展示关注的主播与系统推荐
怎么操作	进直播间后侧边栏滚弹幕，设置里可调弹幕数量或整体隐藏
实际效果	部分直播间能直接看 1080P 原画（PSVita 硬解下）
容易踩的坑	弹幕走 WebSocket 实时通道，断网时画面可能还停在缓冲，弹幕先停

账号与跨设备同步

四拍	内容
在哪	「我的」页，扫码登录、历史记录、个人收藏、我的追番、我的追剧集中在此
怎么操作	用 B 站 App 扫二维码登录
实际效果	换台设备登录同一账号，观看进度是接上的，不是从 0 开始
容易踩的坑	介意上传可关闭播放设置里的「上传历史播放记录」

DLNA 投屏

四拍	内容
在哪	设置 / 实用工具 / DLNA 投屏，代码在 wiliwili/include/api/dlna/
怎么操作	发起投屏后等待局域网内设备连接
实际效果	把 wiliwili 的播放内容推到电视或机顶盒上，掌机继续干别的
容易踩的坑	收发双方必须在同一局域网且接收端支持 DLNA，搜不到设备先查路由器隔离设置

🎛️ 画质与性能天花板：按平台对号入座

平台	可达上限	关键开关
Switch（默认 OpenGL 版）	4K@30	硬解 auto
Switch（deko3d 版）	4K@60	支持原生图形 API，官方提示可能偶尔崩溃
PSVita（GXM 版）	硬解下 720P 横屏、480P 竖屏流畅，部分直播 1080P 原画	设置里开启硬解
PS4	软解 4K@60	设置里开「低画质解码」，以画质换帧率
PC 全平台	硬件解码 auto-safe	老电脑可切软解，秒开流畅

一句取舍：掌机先保帧率再谈分辨率，PSVita 不开硬解就别指望 720P 流畅；PS4 的 4K@60 是用画质换的，自己掂量。

🧯 翻车自救：黑屏、卡顿、断网排查

配置与缓存集中在一个目录（Switch 上就是内存卡的config/wiliwili）：

内存卡/ ├── switch/wiliwili.nro # Switch 可执行文件 └── config/wiliwili/ # 配置与缓存

症状	可能原因	动作
启动后长时间黑屏	缓存损坏或占满	删掉`config/wiliwili`重新进入
播放卡顿、掉帧	解码方式没对上平台	对照上一节天花板表：Switch 上 4K@60 换 deko3d；PSVita 开硬解；PS4 开低画质解码
视频打不开、弹幕不显示	系统时间不对、DNS 设置错误、代理未关	先改时间、查 DNS、关代理重测
Switch 黑屏无响应	大气层或固件版本过旧	两者都更新到最新，确认内存卡是 FAT32

反馈前先自查：在「设置 / 实用工具 / 网络诊断」生成诊断截图（能看到 API 连通性、时间差、DNS、IP），把它连同可复现的步骤描述一起提交，问题定位会快很多。

🚀 一起把它做得更好

路线	怎么走	去向
代码	新功能先开个 issue 讨论避免撞车，改动以 PR 形式提交	PR 一律提向`dev`分支（`yoga`分支是已发布的最新代码）；需要 clone 时用`git clone --recursive https://gitcode.com/GitHub_Trending/wi/wiliwili`
翻译	添加语言或订正现有译文	Crowdin 平台
反馈	按上表自查后仍解决不了	项目 Issues / Discussions，附网络诊断截图 + 复现步骤