从零上手 BiliBili-UWP：开源 B 站桌面客户端的体验与避坑指南
【免费下载链接】BiliBili-UWPBiliBili的UWP客户端，当然，是第三方的了项目地址: https://gitcode.com/gh_mirrors/bi/BiliBili-UWP
一个深夜还在缓冲的视频
凌晨一点，你电脑上开着七八个标签页，其中一个正是 B 站：视频拖到 720P 还在转圈，弹幕卡成一帧一帧，想拖个进度条，页面先白屏三秒。你是不是也经历过这种在 Windows 上看 B 站总觉得不痛快的时刻？后来我找到一款名为BiliBili-UWP的开源桌面客户端（中文名叫"哔哩"），把 B 站从浏览器里搬进了原生 Windows 应用，体验顺畅不少。
它到底是个什么样的应用
一句话概括：BiliBili-UWP 是专门为 Windows 10/11 打造的第三方 B 站客户端，代码完全开源，只为学习交流而生。它适合两类人——想在电脑上更舒服地刷 B 站的普通用户，以及想研究 UWP 应用如何设计的学习者。
它最有辨识度的地方，是内置了桌面模式和平板模式两套界面，这一点稍后会展开。但先说两句实在话：这个项目因为收到官方警告，已从微软商店下架并停止维护，开发者明确表示不承担重度使用。把它当作一个"能用的学习样本"来体验，心态会更稳。
拿到手之后怎么装起来
如果你手头有 Visual Studio 2019，整个安装过程其实很直接：
- 克隆仓库到本地：
git clone https://gitcode.com/gh_mirrors/bi/BiliBili-UWP - 用 Visual Studio 2019 打开
BiliBili-UWP.sln解决方案文件 - 在
BiliBili-UWP项目的Package.appxmanifest里切换到 Package 选项卡，重新生成一个测试证书 - 选择 x64 平台，重新生成并部署
不想自己编译也可以：找现成的 Release 压缩包，解压后右键install.ps1，按提示执行就行。
这里藏着一个最容易卡住的坑：Windows 默认会拦截未签名的应用。你需要先到"设置 → 更新和安全 → 开发者选项"里打开"开发人员模式"，否则部署大概率直接失败。
第一次启动，迎面而来的就是这个经典的粉色小电视。对用户来说，它就是整个应用的第一印象。
第一次启动，先看什么
启动后你会看到登录入口。BiliBili-UWP 不替你保存密码，登录仍走 B 站官方接口，账号数据只在你设备和 B 站之间流通，不经过第三方服务器。
登录后有两件事值得先做：
- 认一认导航栏：桌面模式下，分区入口、搜索框、用户信息都集中在左侧，信息密度比网页版高不少
- 翻一翻快捷键文档：
BiliBili-UWP/Others/Shortcut.txt里列了全部快捷键和鼠标手势，花两分钟扫一遍能省很多事
深入体验：值得玩味的几个细节
桌面模式：左导航、右内容的经典布局
桌面模式采用经典的 Master-Detail 思路——左侧导航，右侧详情，和你平时用邮件客户端、IDE 的习惯一致，基本不用重新学习。
什么时候派上用场：坐在 1080P 以上的大屏前刷视频、翻动态、整理收藏时，一屏能装下更多内容，效率明显高于网页版。
平板模式：为触屏而生的横向卷轴
平板模式借鉴了 Windows 8 时代的卷轴式设计，主滚动方向是横向的，很适合手指滑动。选中视频后，背景会变成虚化的封面图，视觉上挺有辨识度。
什么时候派上用场：在 Surface 这类平板设备上使用，或者不想让风扇狂转时。它对硬件要求更低，开发者自己那台小 surface go 都能跑得动。
把常用操作塞进键盘的播放器
播放器的设计思路很朴素：一切都能用键盘完成。
| 按键 | 功能 |
|---|---|
| Space | 播放/暂停 |
| F11 | 全屏/退出全屏 |
| F10 | 小窗/退出小窗 |
| F2 | 开启/关闭弹幕 |
| Shift+S | 截图，保存到图片库的Bili ScreenShot文件夹 |
| ← / → | 回退 / 前进指定时长 |
什么时候派上用场：写文档写累了想挂个视频，按 F10 切小窗继续码字；看到名场面想留档，Shift+S 一键截图，不用再开截图软件。
弹幕和评论：努力保留"B 站的味道"
虽然是第三方应用，但动态卡片、评论、弹幕这些细分控件，排版都尽量向官方看齐。开发者打了个比方：红烧牛肉面如果换了紫色包装，就算配料不变，那也不是那个味儿了；反过来，只要包装足够熟悉，哪怕 logo 不同，也会觉得"有那味儿了"。
什么时候派上用场：刷动态、看评论区时，你会发现几乎不需要适应成本，交互和手机上差不多。
藏在深处的接口：让其他应用唤起它
应用开放了一个 Uri 协议，标头是richasy-bilibili，其他应用可以借此直接唤起它播放指定视频，例如：
richasy-bilibili://navigate?action=video&aid=170001
什么时候派上用场：如果你会写点小脚本或自动化工具，一行命令就能把"打开某个视频"接进自己的工作流。
幕后：一个"把手机应用搬到桌面"的故事
打开代码目录你会发现，仓库被拆成了四个项目，像一支分工明确的小团队：
- BiliBili-Lib：业务核心。API 请求、数据解析、账号 / 视频 / 番剧 / 频道等核心服务都在这里，相当于应用的"心脏"
- BiliBili-Controls：一组通用自定义控件，比如自适应网格、瀑布流面板
- BiliBili-Notification：后台任务组件，负责动态通知提醒
- BiliBili-UWP：主程序。所有界面、页面逻辑和状态管理都在这里
最巧妙的其实是"副页"设计。开发者面对一个很现实的难题：B 站本是手机应用，界面习惯全是按触屏设计的，直接搬到桌面会很别扭；可全部重画，工作量又大得离谱。他的解法是——把一批功能独立、桌面平板通用的页面做成"共享页面"（也就是副页），两套模式共用同一份实现。用户在主界面看到的是桌面化布局，点进副页又能找到手机端熟悉的手感，迁移成本被压到最低。
播放器方面，核心播放器叫VideoPlayer，在BiliBili-UWP/Components/Controls目录；被魔改过的媒体传输控件（就是控制条那一整套）在BiliBili-UWP/Models/UI/Others，样式定义在BiliBili-UWP/Template/Media.xaml。对 UWP 自定义控件感兴趣的话，这些都是现成的教材。
遇到这些问题，多半是这几个原因
- 如果你部署失败，多半是没开开发者模式：先到"设置 → 开发者选项"打开"开发人员模式"，再重试一次
- 如果提示证书不受信任：双击包内证书，导入到"本地计算机 → 受信任的根证书目录"，然后重新走一遍安装流程
- 如果播放视频卡顿：先在显卡设置里开启垂直同步试试，还不行就到设置里把默认画质调低
- 如果在 Surface Pro X 这类 ARM 设备上打不开：这是已知问题，开发者也没定位到原因，换 x86 设备是唯一出路
- 如果你期待 4K 画质：没有大会员账号的话，选项里能选 4K，但片源并不会是 4K
- 如果你在找直播和视频下载功能：这个应用明确不做这两块，别在上面花时间
收尾：从体验到学习，接下来做什么
到这里，这条体验旅程就走得差不多了。想动手试试的话，行动清单如下：
- 克隆仓库，或下载现成的 Release 包
- 打开开发者模式，编译部署或运行 install.ps1
- 花十分钟把快捷键过一遍，再登录账号刷一刷
- 遇到问题，回到上面的避坑锦囊对号入座
如果对 UWP 开发动了心思，还可以顺着三条线继续挖：看BiliBili-Lib/Service里的核心服务，理解客户端如何组织网络层；看BiliBili-Controls里的自定义控件，学习怎么写可复用组件；看BiliBili-UWP/Components/Controls/VideoPlayer.xaml，体会复杂控件的分层思路。
它虽然已经停止更新，但代码里完整记录了一个开发者"把手机应用搬到桌面"的思考过程。这份思考本身，可能比应用更值得带走。✨
【免费下载链接】BiliBili-UWPBiliBili的UWP客户端，当然，是第三方的了项目地址: https://gitcode.com/gh_mirrors/bi/BiliBili-UWP
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
