核心用法
bilibili-ai-subtitle 是一款专注于提取 Bilibili 平台 AI 自动生成字幕的 Shell 脚本工具。用户只需提供视频链接（BV号或完整URL），即可快速下载结构化字幕文件。工具支持多语言优先级自定义（如优先英文、 fallback 中文），输出文件采用标准化命名格式 VideoTitle_Author_Date_Duration_BVid.txt，并自动组织为三部分结构：视频信息、内容摘要、完整原文。
典型使用场景
- 快速获取字幕：无需手动复制粘贴，一键下载完整字幕文本
- 多语言学习：支持中英日等9种语言的优先级设置，便于外语学习者获取目标语言字幕
- 内容整理：自动生成的结构化文档便于笔记整理、内容归档和二次创作
运行依赖
- 必需：yt-dlp（开源视频下载工具）
- 可选：已登录的 Chromium/Edge 浏览器（用于访问会员专属视频）
显著优点
1. 专注高效：相比完整的转录工作流，仅抓取现有 AI 字幕，速度极快（秒级完成）
2. 多语言智能：支持9种语言的优先级队列设置，满足国际化内容消费需求
3. 输出结构化：自动生成的三段式文档（信息/摘要/全文）可直接用于知识管理
4. Cookie 自动探测：智能检测 WSL Chromium 和 Windows Edge 的登录状态，简化会员视频访问
5. 文件名规范化：UTF-8 安全处理，避免特殊字符导致的文件系统问题
潜在缺点与局限性
1. AI 字幕质量依赖：字幕准确性取决于 Bilibili 官方 AI 系统（约85-95%），无人工校对
2. 覆盖率限制：并非所有视频都有 AI 字幕，部分创作者可能关闭该功能
3. 会员内容门槛：部分视频的 AI 字幕需要大会员身份，虽可自动读取 Cookie 但仍受平台权限限制
4. 无语音转录能力：对于没有 AI 字幕的视频，本工具无法生成字幕（需配合 bilibili-transcript 使用 Whisper）
5. 平台绑定：完全依赖 Bilibili 平台的 API 稳定性，政策变更可能导致功能失效
适合的目标群体
- 知识工作者：需要快速获取视频内容文本进行笔记整理、知识萃取
- 语言学习者：利用多语言字幕进行听力训练、词汇学习
- 内容创作者：收集素材、整理引用、制作内容合集
- 研究人员：获取视频讲座、课程内容的文本记录
- 无障碍需求用户：偏好阅读而非观看视频的视力辅助场景
常规风险提示
性能与稳定性
- 网络请求依赖 yt-dlp 和 Bilibili API，受平台限速或接口变更影响
- 大规模批量下载可能触发平台反爬机制
依赖项安全
- 依赖外部工具 yt-dlp，需保持更新以获得安全补丁
- 建议通过官方渠道（pip/brew）安装，避免使用来路不明的预编译版本
隐私与数据安全
- Cookie 读取风险：自动读取浏览器 Cookie 涉及敏感会话数据，建议在专用环境或隔离浏览器配置下使用
- 临时文件未显式设置权限，多用户环境可能存在信息泄露风险（低风险）
合规注意
- 下载的字幕文件仅限个人学习使用，请勿用于商业传播或侵犯版权的内容再分发
- 遵守 Bilibili 平台用户协议，合理使用自动化工具