dsh-bili-flow 2.0
B站字幕管线 v2:一次调用完成「短链解析 → 取 AI 字幕(缓存)→ 切第X组 → 写原文/口播稿」, 再把整理版转成 PDF/DOCX 并给出下载链接。逐字稿不进入对话上下文。
与 dsh-bili-subtitle 并存,互不取代:那个把字幕读回对话,这个把字幕留在磁盘上。
两个工具
| 工具 | 作用 | 返回 |
|---|---|---|
bili_flow(url, group?, name?, force?) |
提取并切片 | 一行 JSON:bvid/title/range/lines/chars/cached/groups/md/oral/urls |
bili_flow_export(md) |
md → PDF + DOCX + 下载链接 | pdf/docx/served/urls |
产出
<name>_第X组_字幕原文.md——带[分:秒],相邻字幕间隔 >1.0s 分段<name>_第X组_口播稿.md——无时间码,按停顿分段,写整理版时读这一份<name>_第X组_整理版.pdf/.docx——由bili_flow_export生成
组边界
优先用官方章节(view_points 里带「第X组」的章节);没有章节时回退到字幕锚点:
30 秒之后第一次出现「第X组」的位置就是该组起点,下一组起点是终点。
缓存
~/.dsh/bili-flow-cache/<bvid>.json,24 小时有效;force: true 强制重下。
同一视频换组请求不联网(实测 0.5 秒)。
充电专属视频(UPOWER)
extract 在拉字幕之前先看 view 接口的两个字段:is_upower_exclusive 与 is_upower_preview。
命中就直接失败,不写任何产物:
UPOWER_EXCLUSIVE: 充电专属视频,当前账号未充电(只能看 60 秒试看),B 站不会下发完整字幕轨。
请先给 UP 主充电,或改用本地 ASR 转写(需完整音视频)。
原因:这类视频的 playurl 只给一段约 60 秒的试看片段,x/player/wbi/v2 的 subtitles 恒为空,
签名、换 UA、加 buvid 都绕不过去。两个标记同时写进了 bili-flow-cache/<bvid>.json,
排查时直接看缓存即可,不用再抓一遍。
登录
取 AI 字幕需要登录态。cookie 按顺序查找:
BILI_COOKIES 环境变量 → ~/.dsh/bili-cookies.json → 插件目录 cookies.json。
没有 cookie 或失效时,插件自带扫码登录(不再依赖别的插件):
| 工具 | 作用 |
|---|---|
bili_login_qr |
生成二维码(180 秒有效),落一张 bili_login_qr.png 到工作目录,返回 code URL |
bili_login_poll |
轮询等待扫码 → 收 cookie → 写 ~/.dsh/bili-cookies.json(0600)→ 用 nav 验证 |
bili_login_check |
检查现有 cookie 是否还有效,返回昵称/mid |
命令行等价(不重启也能用):
python3 scripts/bili_login.py check # 已有 cookie 是否有效
python3 scripts/bili_login.py login # 生成码 + 等待确认,一步完成
python3 scripts/bili_login.py qr --png qr.png # 只生成码
python3 scripts/bili_login.py poll --timeout 180
python3 scripts/bili_login.py logout
实现要点(都是踩过的坑):登录成功后 cookie 有两处来源——响应体 data.url 的查询参数
和 Set-Cookie 响应头;只解析前者会漏掉 SESSDATA,所以用 http.cookiejar 收头。
buvid3/buvid4 再从 /x/frontend/finger/spi 补齐。二维码 180 秒有效,
86038=失效 / 86090=已扫码待确认 / 86101=未扫码,脚本分别报清楚;
扫完必须在手机点「确认登录」。存盘后立刻用 nav 验证 isLogin,避免「看起来成功其实没有」。
安装(已由 DSH 配置完成,供参考)
cd ~/.dsh/profiles/web
ln -sfn ../plugins/dsh-bili-flow node_modules/dsh-bili-flow
# package.json: "dsh-bili-flow": "file:./plugins/dsh-bili-flow"
# cordis.patch.yml:
# - insert:
# - id: bili-flow
# name: dsh-bili-flow
服务端插件,加载后重启 DSH 生效。
依赖
libs/ 内置 reportlab 与 PIL 桩(PDF 用),DOCX 由纯 OOXML 手写,无需其他第三方包。
No comments yet. Be the first to write one.