BiliFlow 0.8.9:把 B 站下载和直播录制,做成一个顺手的桌面工作台

BiliFlow 0.8.9:把 B 站下载和直播录制,做成一个顺手的桌面工作台

折腾了大半年,我的开源项目 BiliFlow 更新到 0.8.9 了。这个版本之后,功能基本全面、稳定,我觉得是时候正式介绍一下它。

先说它是什么:BiliFlow 是一个开源的 B 站视频下载、直播录制与本地归档工具,同时提供桌面 GUI 和 CLI,支持 Windows、macOS 和 Linux,代码基于 MIT 协议开源。

仓库地址:https://github.com/itsVicOC/bilibili-downloader
官网与下载:https://1008.si/

为什么要做这个项目

B 站上有很多我有权保存的内容:自己投稿的稿件、已获授权的素材、喜欢的 UP 主合集、还有不想错过的大型直播。但官方的缓存机制是"app 内有效",换设备、换平台就没了;想长期归档,只能靠各路第三方工具。

而这些工具的体验,用过的都懂:命令行工具功能强但要记一堆参数,GUI 工具要么界面停留在十年前,要么夹带私货、满屏广告。直播录制更是重灾区——录制中断没人管、文件散落在临时目录、根本不知道录没录上。

我想要的其实很简单:一个像正经软件一样对待我的桌面工作台——能解析、能批量、能断点续传、能录制直播、能把字幕弹幕封面元数据一起归档好,界面还得像 2026 年的应用。找不到,就自己写一个。

0.8.9 更新了什么

0.8.9 在 10 月 24 日发布,汇总了四个 beta 阶段的打磨。这个版本没有堆砌新功能,而是回答了一个问题:"全面"之后,怎么做到"顺手"?

全界面 Fluent Design 精修。 下载、批量、直播、任务中心、五类设置和弹窗统一了层级、材质、圆角和交互状态,主要按钮参考 B 站官网色阶做了粉底白字,导航和操作加入了轻量过渡动效。下载页改成横向作品摘要加响应式规格,矮窗口自动切紧凑密度——1120×760 的窗口里,所有信息依然完整呈现。

剪贴板来源识别。 复制了 B 站链接再打开软件,它会识别剪贴板里的来源——BV/AV 号、番剧、短链、合集、系列、收藏夹甚至分享文案都行,多个来源还能批量解析。确认前不联网、不替换输入,软件在后台、隐藏或最小化时完全不碰剪贴板。这个功能默认开启,可以在「设置 → 下载 → 来源识别」关掉。

窗口记忆。 主窗口的大小、位置、最大化状态自动记录到独立的 ui-state.json,重启后原样恢复。拔掉显示器、换了工作区,窗口位置也会自动校正。

录制历史管理。 录制历史可以按整场移除和撤销了,只清数据库记录,片段、MP4、manifest 和订阅都保留;录制、重连、收尾期间则禁止移除,避免手滑删掉正在进行的任务。

Windows 窗口按钮重做。 三枚窗口按钮改为 46×32 连续热区的自绘方案,配合 Win32 非客户区适配,修掉了底色色差、悬停区域不齐、暗色图标不清晰和最大化/还原不同步的老毛病。macOS 保留原生按钮。

Markdown 更新说明。 应用内的更新说明换成了原生 Markdown 阅读区,标题、列表、表格、代码都能正确渲染,可以选择、复制、滚动,跟随深浅主题切换。

这个版本本地完整回归 1124 项测试通过,双平台 CI 全部通过,Windows 和 macOS 都做过实机验证。

核心能力一览

能力 说明
多来源解析 BV、AV、ep/ss/md、完整 URL、b23.tv 短链、UP 主合集/系列与收藏夹
完整媒体规格 240P 到 8K、HDR、Dolby Vision,AVC/HEVC/AV1,自动匹配音轨
本地归档 MP4、M4A 或 Hi-Res FLAC,可同时保存 ASS 弹幕、SRT 字幕、封面与 JSON 元数据
任务中心 下载队列、当前录制、录制历史集中管理;暂停/继续、断点续传、异常退出恢复
直播录制 应用内监控、自动/手动录制、分段与重连、单场合并 MP4、目录跟随
批量与多 P 单选/全选、批量预览筛选、失败重试、精确去重、1–8 路并发
安全登录 默认扫码登录,凭据优先写入系统凭据库,侧栏直接管理账号
跨平台界面 PySide6,900×640 响应式布局,日间/夜间/跟随系统三种主题

一些细节控的部分

这个项目里有几个我自己很坚持的设计,也说说为什么:

安全登录。 扫码登录是默认路径,SESSDATA 优先写进系统凭据库(macOS Keychain / Windows Credential Manager),凭据库不可用时才回退到受限权限文件。退出登录会清理凭据,文档里也明确禁止在 Issue 和截图里公开 Cookie。账号相关的脏活都跑在后台线程,不阻塞启动。

任务可靠性。 下载中断不用从头再来——任务数据库持久化,异常退出后重新打开可以接着下。临时文件用 Range 续传,目标文件原子写入,取消任务时同步终止 FFmpeg 合并进程。任务数据库有版本化迁移,升级前自动备份,损坏时隔离重建而不是反复崩溃。

合规边界。 BiliFlow 只显示接口实际返回的规格,不会解锁账号未获得授权的内容;首次创建下载任务时会展示版权提示并需要确认。项目专门维护了版权与合规文档,划清授权边界和禁止用途。

发布工程。 每个 Release 都有完整的 CI 流水线:macOS/Windows 的 full/lite 包、DMG/EXE 安装器、SHA-256 校验清单、CycloneDX SBOM 和原生安装验证报告。full 包内置从固定源码构建的最小 LGPL FFmpeg,开箱即用。

小流。 软件里养了一只像素风吉祥物"小流",十二套随本地时段变化的像素动画——清晨挥手、午后翻书、深夜抱膝打盹。前台待机时每 15 到 30 秒随机播放一套。这个没什么用,但工具有点温度,挺好的。

谁适合用

  • 内容创作者:备份自己的投稿和素材,多 P 批量归档一口气搞定。
  • 直播观众:关注的主播开播自动录制,断线自动重连,整场自动合并成 MP4。
  • 资料收藏者:合集、系列、收藏夹整体下载,字幕弹幕元数据一起落盘,整整齐齐。
  • 命令行玩家:CLI 与 GUI 复用同一条下载流水线,脚本化、定时任务都方便。

快速开始

最快的上手方式:

  1. 到 GitHub Releases 或官网下载对应平台的安装包,首次使用推荐 full 包。
  2. 启动后在首页粘贴 BV 号、视频链接或 b23.tv 短链,点击"开始解析"。
  3. 选择分 P、画质、编码和归档附加项,加入下载队列。
  4. 合集或收藏夹用"批量导入",先解析预览再筛选。

喜欢命令行的话,装好后可以直接:

# 下载 1080P 视频,同时保存弹幕与字幕
python -m bilibili_downloader download BV1GJ411x7h7 \
  --quality 80 --danmaku --subtitle

# 仅保存音频
python -m bilibili_downloader download BV1GJ411x7h7 --audio-only

最后

从 2026 年 5 月写下第一行代码到现在,BiliFlow 已经走到了 0.8.9:137 个提交、一千多项回归测试、双平台实机验证。功能上我觉得可以说"全面且稳定"了,剩下的就是继续打磨。

如果你也在找一个顺手的 B 站下载和直播录制工具,欢迎试试。觉得好用,点个 Star 就是最大的支持;遇到问题,开 Issue 我会认真看;想参与贡献,CONTRIBUTING 里有完整的约定。

GitHub:https://github.com/itsVicOC/bilibili-downloader
官网:https://1008.si/