B 站视频字幕 Skill

此 skill 完全自包含，所有脚本均在 scripts/ 目录内，无需额外项目依赖。

依赖安装

脚本只需要一个第三方库，在运行前确保已安装：

pip install requests

可选安装（用于终端显示扫码二维码）：

pip install qrcode

核心能力

工作流

第一步：解析 BVID

从用户输入中提取 BVID（格式：BVxxxxxxxxxx）。

• 支持纯 BVID：BV1ZL411o7LZ
• 支持完整链接：https://www.bilibili.com/video/BV1ZL411o7LZ
• 短链（https://b23.tv/xxx）需先让用户提供完整链接或 BVID

第二步：检查字幕缓存

检查 subtitles_output/\x3CBVID>/\x3CBVID>.txt 是否已存在：

• 存在：直接使用，跳过第三步。告知"已找到本地缓存字幕"。
• 不存在：进入第三步获取字幕。

第三步：获取字幕

运行获取脚本（路径相对于 skill 目录）：

python \x3Cskill-dir>/scripts/fetch_subtitle.py \x3CBVID> --cookie cookie.txt --output-dir subtitles_output

\x3Cskill-dir> 是此 SKILL.md 所在的目录路径。脚本会自动：

1. 按优先级查找 Cookie（指定路径 → 当前目录 → 脚本目录）
2. 优先获取 AI 字幕，无 AI 字幕时自动回退到 CC 字幕
3. 同时输出 .txt、.srt、.vtt 三种格式

常见错误处理：

扫码登录（仅在需要时执行）

当 cookie.txt 不存在或已失效时，引导用户登录。

根据当前环境选择合适方式：

方式 A：AI 可运行终端命令（如 Antigravity/Claude Code）

1. 告知用户需要登录 B 站以获取 AI 字幕
2. 运行登录脚本：

   python \x3Cskill-dir>/scripts/cookie_login.py --output cookie.txt
   

3. 脚本会在终端打印 ASCII 二维码和登录链接
4. 如果 ASCII 二维码显示不清晰，可以用以下方式生成图片二维码给用户：

   import qrcode
   img = qrcode.make("\x3C扫码链接URL>")
   img.save("qr_login.png")
   

5. 用户在手机 B 站 App 扫码并确认后，Cookie 自动保存
6. 继续执行第三步

方式 B：AI 无法运行命令（如 OpenClaw/Claude.ai）

1. 引导用户自己在终端执行：

   pip install requests qrcode
   python \x3Cpath-to-installed-skill>/scripts/cookie_login.py
   

2. 或者让用户手动获取 Cookie：
   • 登录 B 站 → F12 → Application → Cookies
   • 复制 SESSDATA 和 bili_jct 的值
   • 写入 cookie.txt，格式：SESSDATA=xxx; bili_jct=xxx

第四步：生成摘要

读取 subtitles_output/\x3CBVID>/\x3CBVID>.txt 的纯文本字幕，生成结构化摘要：

## 视频摘要：[BVID]

### 核心主题
（一句话概括视频主要讲了什么）

### 主要内容
1. [要点一]
2. [要点二]
3. [要点三]
...

### 关键结论
（视频最后强调或总结的观点）

字幕文本很长时：

• 按内容逻辑分段，不要平均切割
• 识别明显的"话题切换"作为章节分隔点
• 摘要长度以覆盖主要观点为准

第五步：时间戳查询

当用户问"xxx 在哪个时间段"或"视频里什么时候讲到了 xxx"时：

1. 确认已有 SRT 文件（subtitles_output/\x3CBVID>/\x3CBVID>.srt）
2. 运行时间戳搜索脚本：

   python \x3Cskill-dir>/scripts/search_timestamp.py \
     subtitles_output/\x3CBVID>/\x3CBVID>.srt "\x3C关键词>" --context 2
   

3. 将结果整理成友好格式：
   • "视频在 01:23 左右提到了这个内容"
   • 多处匹配时列出所有时间点
   • 关键词找不到时，尝试近义词或分拆词搜索

SRT 时间格式为 HH:MM:SS,mmm，向用户展示时简化为 MM:SS。

目录结构

bilibili-subtitle/             ← skill 根目录（本目录）
├── SKILL.md                   ← 本文件
└── scripts/
    ├── fetch_subtitle.py      ← 字幕获取（自包含，无外部依赖）
    ├── search_timestamp.py    ← 时间戳搜索
    └── cookie_login.py        ← 扫码登录获取 Cookie

用户工作目录下生成：
├── cookie.txt                 ← 登录 Cookie（自动生成）
└── subtitles_output/
    └── \x3CBVID>/
        ├── \x3CBVID>.txt         ← 纯文本字幕（用于摘要）
        ├── \x3CBVID>.srt         ← 带时间戳字幕（用于时间定位）
        └── \x3CBVID>.vtt         ← VTT 格式字幕

注意事项

• AI 字幕需要登录：未登录只能获取 UP 主手动上传的 CC 字幕，大多数视频的 AI 字幕必须登录。
• Cookie 有效期：通常有效数月，但账号异常登出会导致失效。
• 字幕条数少：如果获取到的字幕极少（\x3C 10 条），可能是 CC 字幕而非完整 AI 字幕，提示用户。
• 硬字幕：烧录在画面中的字幕（如综艺、电影）无法获取，需 OCR 工具处理。