Bilibili 字幕提取工具

从 Bilibili 视频提取字幕，支持 AI 字幕检测和 ASR 转录回退。

Quick Reference

任务	命令
基本提取	pixi run python -m bilibili_subtitle "BV1234567890"
快速模式	pixi run python -m bilibili_subtitle "URL" --skip-proofread --skip-summary
双语输出	pixi run python -m bilibili_subtitle "URL" --output-lang zh+en
指定目录	pixi run python -m bilibili_subtitle "URL" -o ./subtitles

前置条件

1. 安装

cd ~/.agents/skills/bilibili-subtitle
./install.sh
pixi shell

2. 外部工具

工具	用途	安装
BBDown	视频信息/字幕下载	brew install bbdown
ffmpeg	音频转换	brew install ffmpeg

3. API Keys

Key	Provider	用途
ANTHROPIC_API_KEY	Anthropic	校对/翻译/摘要
DASHSCOPE_API_KEY	阿里云 DashScope	ASR 转录（仅无字幕时需要）

# 添加到 ~/.zshrc
export ANTHROPIC_API_KEY="your-key"
export DASHSCOPE_API_KEY="your-key"  # 可选

4. BBDown 认证

BBDown login  # 扫码登录，Cookie 保存在 BBDown.data

触发方式

• /bilibili-subtitle [URL]
• "提取这个B站视频的字幕 [URL]"
• "把这个视频转成文字 BV1234567890"
• "生成这个视频的摘要 [URL]"

CLI 参数

参数	说明	默认值
url	Bilibili URL 或 BV ID	必填
--output-dir, -o	输出目录	./output
--output-lang	输出语言 zh/en/zh+en	zh
--skip-proofread	跳过校对	false
--skip-summary	跳过摘要	false
--cache-dir	缓存目录	./.cache
--verbose, -v	详细输出	false

输出文件

output/
├── {video_id}.zh.srt          # SRT 字幕
├── {video_id}.zh.vtt          # VTT 字幕
├── {video_id}.transcript.md   # Markdown 逐字稿
├── {video_id}.summary.json    # 结构化摘要
└── {video_id}.summary.md      # 摘要 (Markdown)

处理流程

URL → BBDown 检测 → [有字幕?]
                     ├─ YES → 加载 SRT → 校对 → 输出
                     └─ NO  → 下载音频 → ASR 转录 → 校对 → 输出

Progress Updates

⏳ 检测视频字幕: BV1234567890
✅ 视频ID: BV1234567890
   标题: 视频标题
   有字幕: True
⏳ 加载字幕文件...
✅ 加载 120 个字幕段落
⏳ 校对字幕...
✅ 校对完成，修改 5 处
⏳ 生成输出文件...
✅ SRT: output/BV1234567890.zh.srt
✅ VTT: output/BV1234567890.zh.vtt
✅ MD:  output/BV1234567890.transcript.md
⏳ 生成摘要...
✅ Summary JSON: output/BV1234567890.summary.json
✅ Done! 输出目录: ./output

错误处理

1. BBDown 未安装

• 错误: command not found: BBDown
• 原因: BBDown 未安装或不在 PATH 中
• 解决: brew install bbdown 或从 GitHub 下载

2. BBDown 认证失败

• 错误: 需要登录 或下载失败
• 原因: Cookie 过期或未登录
• 解决: 运行 BBDown login 重新扫码

3. ASR 转录失败

• 错误: Missing DASHSCOPE_API_KEY
• 原因: 视频无字幕且未配置 DashScope
• 解决: 设置 DASHSCOPE_API_KEY 环境变量

4. 校对/摘要失败

• 错误: Missing ANTHROPIC_API_KEY
• 原因: 未配置 Anthropic API
• 解决: 设置 ANTHROPIC_API_KEY 或使用 --skip-proofread --skip-summary

示例

基本用法

pixi run python -m bilibili_subtitle "https://www.bilibili.com/video/BV1234567890/"

快速提取（跳过 AI 处理）

pixi run python -m bilibili_subtitle "BV1234567890" --skip-proofread --skip-summary -v

双语输出

pixi run python -m bilibili_subtitle "BV1234567890" --output-lang zh+en

---

版本: v0.1.0