跳到内容
Yinjie 的博客
返回

B站视频的下载和合成

编辑此页

本文介绍把 B 站视频下载到本地的两种方法:PC 端用 yt-dlp 下载在线视频,移动端把客户端缓存的离线视频无损还原成 MP4——两条路径最后都登记进同一个视频库总表。整套流程已封装成开源 skill,先看方法框架:

B 站视频下载到本地的两条路径框架图

1. PC 端:yt-dlp 下载在线视频

工具与依赖:yt-dlp(升级用 yt-dlp -U)加 ffmpeg——B 站音视频流是分离的,下载时靠 ffmpeg 自动合并。

登录态(cookies)是清晰度的钥匙,也是这条路唯一麻烦的部分。三条实测认知:

无登录封顶 1080P30(H.264);cookies 解锁 1080P60 / 4K60 / 杜比视界 / FLAC Hi-Res,会员画质还需要账号本身有权限。

关键命令三步:

# 1. 探底:列出所有格式,确认分辨率/编码/大小
yt-dlp --cookies cookies.txt -F "URL"

# 2. 按格式 ID 下载(最佳视频轨 + 最佳音轨,ffmpeg 自动合并)
yt-dlp --cookies cookies.txt -f "<视频ID>+<音频ID>" -o "%(title)s [%(id)s].%(ext)s" "URL"

# 3. 懒人版:默认最优组合
yt-dlp --cookies cookies.txt -f "bv*+ba/b" "URL"

同分辨率常有三种编码,按需选:

编码特点
avc1(H.264)兼容性最好,无登录档即此编码
hvc1(HEVC)体积最小,杜比视界只有 HEVC 轨
av01(AV1)压缩效率居中

注意懒人版 bv* 在同分辨率多编码时默认选 AV1(压缩效率优先,码率偏低但观感同级);要码率最高的 AVC/HEVC 版本,按 -F 表显式指定格式 ID。

分 P 视频的坑:直接下会抓全部分 P(文件名自动带 pNN 标题),只要某一 P 用 URL?p=N。更要小心的是大文件下载会静默失败——命令没报错,但什么都没下完。判断方法:没有输出就是失败,删掉 .fXXXXX.mp4 / .m4a 残片,对失败的分 P 单独重跑。

2. 移动端:还原离线缓存

B 站客户端的离线缓存是分离的流文件,只有客户端自己能播。目录结构:

<缓存目录>/
  <作者ID>/
    entry.json        ← 元信息(标题、作者、BV 号)
    <cid>/
      index.json
      video.m4s       ← 视频流
      audio.m4s       ← 音频流

还原工具与方法:找到同一目录下的两个 m4s,用 ffmpeg 直接封装——-codec copy 不重编码,无损且极快。我把它做成了脚本 restore.js(零第三方依赖,Node 装好就能跑),递归扫描整个缓存目录:

node restore.js "<缓存目录>" --output "<视频库目录>" --index

一个要知道的边界:合并产物只含音视频轨——弹幕和封面不会进 MP4,删缓存前在意这两样的话要单独导出。

3. 入库登记:video_list.json 总表

下载的、还原的,最后都汇进同一个视频库。库根目录维护一份 video_list.json 总表,每次入库后跑一次同步脚本:

node update-list.js "<视频库目录>"

扫描库根层全部 MP4,对未登记的文件用 ffprobe 探测编码、分辨率、时长并登记(文件名带 [BVxxx] 判定为下载来源,否则记为还原/导入);已登记的不会重复,幂等可重复运行。

4. 封装成了 skill

以上全部——两条路径的脚本、cookies 获取步骤、坑位清单——都整理进了开源 skill bilibili-video(双端插件市场里 bilibili-restore 的进化版,v1.2.0):

/plugin marketplace add yj1438/skills
/plugin install bilibili-video@yj-skills

装好之后对 agent 说「下载这个 BV 号」或「还原 B 站缓存」就能干活。

一个安全提醒:cookies 是登录凭证,勿外传、勿提交进仓库,不用时删掉;万一泄露,B 站改密码即失效。


编辑此页
分享这篇文章:

上一篇
从真人到虚拟角色:图解 MediaPipe 的 AI 人体识别

评论