Bilibili Subtitle Downloader

核心用法

Bilibili 字幕下载器是一个自动化工具链，通过 Python 脚本与 AI 子智能体协作，实现从 Bilibili 视频到结构化内容总结的全流程处理。系统支持两种内容形态：普通视频（BV 号）与 Bilibili 课程（SS/EP 号），用户仅需提供视频标识符即可触发完整工作流。

技术实现路径

1. 字幕提取层：通过 download_and_chunk.py 或 cheese_downloader.py 脚本调用 Bilibili 公开 API，获取 CC 字幕数据并执行 Token 感知分块（Token-aware chunking），确保每个文本块符合 LLM 上下文窗口限制。

2. 身份认证：采用二维码扫码登录机制，Cookie 持久化存储于 ~/.openclaw/workspace/bilibili_cookie.txt，避免重复认证。

3. 智能总结层：通过子智能体并行处理分块文件，使用结构化 Prompt 提取技术细节、数据点与逻辑脉络，最终聚合为完整摘要。

显著优点

• 全流程自动化：从 URL 到结构化总结无需人工干预，大幅降低视频内容处理的时间成本
• 分块策略科学：基于 Token 而非字符数分块，适配不同 LLM 的上下文限制
• 多形态兼容：同时支持普通视频与付费课程的字幕获取
• 可扩展架构：子智能体模式便于定制不同风格的总结输出（学术/通俗/技术导向）

潜在局限与风险

技术局限

• 依赖 Bilibili 官方 CC 字幕，无字幕视频无法处理
• 字幕时间戳信息被剥离，无法还原精确的时间轴引用
• 分块边界可能造成语义割裂，影响跨段落逻辑的理解

合规与版权风险

• 下载行为需遵守 Bilibili 用户协议，批量获取可能触发风控
• 课程类内容（Cheese）涉及付费版权，商业使用存在法律边界
• 字幕内容的二次分发需考虑原作者权益

适合人群

• 研究人员：快速扫描大量知识类视频，建立文献笔记
• 内容创作者：追踪竞品分析、行业趋势视频的核心论点
• 学习者：将长视频课程转化为可检索的文本知识库
• AI 工作流开发者：作为 RAG 系统的视频内容数据源

安全与可信度评估

• 来源可信度：T2（依赖 Bilibili 官方 API，脚本经代码审查但未经渗透测试）
• 安全等级：B（涉及本地文件系统操作与 Cookie 持久化，需信任脚本来源）
• 主要风险点：Cookie 存储的本地安全性、Bilibili API 的 rate limit 与封号风险、付费内容的版权合规性

核心功能

Bilibili Subtitle Downloader 是一款专注于中文视频内容处理的自动化工具，通过 Python 脚本与 Bilibili 官方 API 交互，实现字幕下载、智能分块与 LLM 友好型总结生成。支持两种典型场景：普通视频（BV 号） 与 课程剧集（SS/EP 号），并内置扫码登录机制解决 B 站反爬限制。

显著优点

1. 自动化工作流：从 URL/BV 号输入到结构化总结输出全链路自动化，无需手动处理字幕文件格式转换或分块切割
2. 双模式支持：兼容普通 UGC 视频与 Bilibili Cheese 付费课程，覆盖用户主流学习场景
3. 安全合规设计：Cookie 仅存储于本地 workspace，网络请求限定于 Bilibili 官方域名，通过 HTTPS/TLS 1.2+ 传输
4. LLM 优化输出：预设专业级子智能体提示词模板，确保技术细节、数据点与逻辑步骤的完整捕获

潜在局限

• 认证依赖：需用户手动扫码登录，且 Cookie 有效期受 B 站策略影响，可能中断工作流
• 字幕可用性：部分 UGC 视频无官方字幕或仅支持 AI 生成字幕，质量参差不齐
• T3 来源风险：社区/个人开发者维护，长期更新与漏洞响应存在不确定性
• 地域限制：部分课程与视频存在区域版权限制，海外 IP 可能无法访问

适合人群

• 知识工作者：需要将长视频（技术讲座、行业分析、课程）快速转化为结构化笔记
• 内容创作者：进行竞品分析、选题调研或二次创作前的素材整理
• 学习者：通过文字摘要高效筛选视频内容，建立个人知识库

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 账号封控 | 高频 API 调用可能触发 B 站风控 | 内置请求间隔与单用户 Cookie 绑定 |

| 数据残留 | 字幕文件临时存储于本地 | 定期清理 `bili_temp/` 目录 |

| 版权合规 | 下载行为需符合平台用户协议 | 仅限个人学习用途，禁止批量分发 |