Subcommands

子命令使用指南 (Subcommands)

除了常规的单个与批量视频下载，BBDown 还内置了一系列强大的子命令，涵盖直播流录制、专栏文章保存、稍后再看队列同步以及 UP 主新视频订阅等功能。

---

1. 直播录制 (live)

BBDown 支持对 B 站直播间进行实时流媒体录制。

命令语法

BBDown live <room_id> [选项]

选项说明

• <room_id>：直播间真实房间号或短号（如 12345）。
• -o, --output <path>：指定最终输出文件路径（默认：直播间标题_直播录制_时间.flv 或 .mp4）。
• -c, --cookie <cookie>：指定 Cookie（若省略则自动读取同目录下 BBDown.data 中的登录凭据）。
• --access-token <token>：指定 TV/APP Access Token。

核心特性与工作机制

1. 自动登录与高画质：未登录录制只返回 720P 游客画质；BBDown 会自动加载本地凭据，解析账号有权获取的原画、4K 或杜比直播流。
2. 断流自动重连与分段写入：录制过程中若网络中断或主播重开播，程序会自动重试并建立新分段，分段临时文件存放于 .segs/session-* 目录。
3. 自动合成与安全恢复：录制结束（用户按 Ctrl+C 或主播下播）后，程序会自动调用 FFmpeg 执行 concat 合成最终文件；若合成前异常断电，原始分段完整保存在 .segs 目录中，不会丢失。

示例

BBDown live 6

---

2. 专栏文章下载 (article)

将 B 站专栏 / 动态图文（Opus）下载并转换为本地 Markdown 文件。

命令语法

BBDown article <cv_id或链接> [选项]

选项说明

• <cv_id>：专栏 ID（如 cv12345）或完整专栏 URL（如 https://www.bilibili.com/read/cv12345）。
• -o, --output <path>：输出 Markdown 文件路径（默认按文章标题命名）。

示例

BBDown article https://www.bilibili.com/read/cv123456

---

3. 稍后再看批量下载 (watchlater)

批量下载当前登录账号的「稍后再看」列表中的所有视频。

命令语法

BBDown watchlater [选项]

选项说明

• --limit <N>：最多仅下载列表前 N 个视频（默认 0 为下载全部）。
• -w, --work-dir <dir>：设置下载文件保存的工作目录。
• -q, --dfn-priority：画质优先级。
• -e, --encoding-priority：编码优先级。
• -t / -a：使用 TV 端或 APP 端解析模式。

示例

# 批量下载稍后再看中的前 10 个视频并存入 D:\Videos
BBDown watchlater --limit 10 -w "D:\Videos"

---

4. 订阅增量管理 (sub)

BBDown 支持对指定的 UP 主、合集或播单进行订阅追踪，并在后续一键检查并增量下载新发布的稿件。

子命令一览

命令	说明	示例
BBDown sub add <target> [--name <name>]	添加新订阅目标	BBDown sub add "mid:163637592" --name "何同学"
BBDown sub list	列出当前所有已添加的订阅	BBDown sub list
BBDown sub remove <target>	移除指定的订阅条目	BBDown sub remove "mid:163637592"
BBDown sub check [选项]	检查所有订阅更新并增量下载新视频	BBDown sub check -q "1080P 高码率"

支持的订阅目标类型

• UP 主 UID：mid:123456
• 空间主页链接：https://space.bilibili.com/123456
• 播单 / 收藏夹链接：https://space.bilibili.com/123456/channel/seriesdetail?sid=...
• 番剧季度：ss:33073

---

5. 登录子命令 (login / logintv)

用于生成终端扫码凭据，详见 账号登录与鉴权。

• BBDown login：扫码登录网页版（生成 BBDown.data）
• BBDown logintv：扫码登录云视听小电视（生成 BBDownTV.data）

---

6. API 服务子命令 (serve)

以后台 HTTP 服务器模式运行 BBDown，对外提供 REST API 接口，详见 API 服务器与 Docker 部署。