本文介绍把 B 站视频下载到本地的两种方法:PC 端用 yt-dlp 下载在线视频,移动端把客户端缓存的离线视频无损还原成 MP4——两条路径最后都登记进同一个视频库总表。整套流程已封装成开源 skill,先看方法框架:
1. PC 端:yt-dlp 下载在线视频
工具与依赖:yt-dlp(升级用 yt-dlp -U)加 ffmpeg——B 站音视频流是分离的,下载时靠 ffmpeg 自动合并。
登录态(cookies)是清晰度的钥匙,也是这条路唯一麻烦的部分。三条实测认知:
--cookies-from-browser chrome/edge已死。Chrome 127 起对 cookie 做 app-bound 加密,yt-dlp 解不出内容,必然报Failed to decrypt with DPAPI(yt-dlp #10927,设计使然,别浪费尝试)- 两条活路:①手动导出 Netscape 格式 txt——登录 B 站后 F12 → Network 任选一个
api.bilibili.com请求,把整条Cookie:头逐行整理成 cookies 文件(SESSDATA和bili_jct必须在);②浏览器自动化导出,让 agent 附加本机已登录会话直接取 - 「能用」不等于「权益最新」。我实测踩过:旧 cookies 下载完全正常,档位却只有 480P——文件是当年非会员态导出的。探底结果远低于账号应有水平时,第一动作是重新导出 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
- 文件名从
entry.json取,形如[作者]标题.mp4;同名自动追加序号,不会覆盖 --output归集到视频库,客户端缓存原文件不受影响--index顺手生成清单(文件名、作者、标题、大小、BV 号)- 新旧两代缓存结构都兼容(新一代的
entry.json在c_<cid>/里面一层)
一个要知道的边界:合并产物只含音视频轨——弹幕和封面不会进 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 站改密码即失效。
评论