wiliwili Switch B站客户端指南：5分钟跑起来，手柄追番还能跨设备续播

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

wiliwili 是面向游戏机的 B站客户端，跑在 Switch、PSVita、PS4 与 PC 全平台，把追番、弹幕、直播搬上手柄，播放进度跨设备续上。本文按装机、日常使用、常见故障的顺序讲一遍。

§ 一、5 分钟装进 Switch、PSVita、PS4 与 PC

装 Switch 版 B站客户端

从项目 release 页下载 Switch 包解压，把里面的wiliwili.nro放进内存卡switch目录，内存卡保持 FAT32 格式。主页按住 R 键打开 hbmenu，选中 wiliwili 按 A 即可启动。之后去「设置 / 实用工具 / 使用教程」装个桌面图标，主页直接点开就能进。

装 PSVita 版

下载wiliwili-PSVita.vpk在主机里直接安装，装完启动就是首页。硬解开关留到后面画质一节再开。

装 PS4 版

把wiliwili-PS4.pkg用 USB 拷进主机安装。PS4 只支持软解，4K@60 要靠后文的画质开关解决。

装 PC 版

Windows 7+ 与 macOS 10.11+ 直接运行下载的安装包。Linux 与 Steam Deck 用户可以在系统软件商店（Discover、GNOME Software）里搜wiliwili安装。启动后鼠标左键确认、右键返回、中键刷新。

§ 二、追番、看直播、跨设备续播三个场景

把一部番从头刷到尾

首页是四象限布局：视频信息流、热门榜、追番追剧、影视分类一屏铺开，不用翻第二页。从信息流点进视频，详情页给出评分、简介与分集列表，任意一集按 A 开播。播放页右侧挂着分集列表，切集直接按，中途退出再进来会自动回到原进度。弹幕、评论、倍速、字幕都在这一页，X / Y 能调出高级设置。

熬夜看直播

直播页列出关注的主播与系统推荐，进房后直播弹幕在右侧滚动。左摇杆调音量，右摇杆拖进度，重压摇杆临时快进；单手模式能一个手柄完成全部播放操作。

通勤刷了一半，回家接着看

「我的」页面扫码登录 B站账号，观看历史自动同步；换设备登录同一账号，进度是接上的，不是从 0 开始。正在追的番剧与剧集也在这里集中管理。影视分类支持按地区、风格、年代筛选，搜索页覆盖热搜、视频、番剧、影视四类内容。

§ 三、各平台画质上限与解码关键开关

低画质解码会剔除部分解码步骤来省 CPU，代价是画质略降；deko3d 帧率更高但可能偶发崩溃，取舍看你的接受度。PSVita 不开硬解就别指望 720P 流畅，装完机把它开起来是优先级最高的一步。

§ 四、黑屏、卡顿、断网速修

黑屏起不来

现象是开机后长时间停在黑屏。删掉内存卡里的config/wiliwili目录再重进，多数是配置缓存作祟。仍起不来就确认大气层与固件已是最新，然后带着截图去反馈。

播放卡顿掉帧

现象是掉帧、音画不同步，九成和解码方案有关。PS4 跑 4K@60 要开低画质解码，PSVita 要开硬解，Switch 上 4K@60 换 deko3d 版。按上表把画质档位调到位，还不行就再降一档。

加载不出视频

现象是转圈很久或刷不出内容。确认系统时间与 DNS 设置正确，挂了代理的先关掉重测。最后去「设置 / 实用工具 / 网络诊断」生成诊断截图，反馈时附上它和可复现的步骤描述。

📷 此处建议插入：应用内网络诊断结果截图

§ 五、给项目递块砖

源码按层拆分：活动控制器 负责页面与转场，API 层 处理请求与数据解析，界面组件 收录卡片、滑块等可复用控件。代码改动以 PR 提交到 dev 分支，新功能先开 issue 讨论；翻译走 Crowdin 平台。路线图已排上长按一键三连与评论跳转进度。

去 release 页拿安装包开刷，想帮忙就找讨论区或 Crowdin。

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