| name | bilibili-transcript |
| description | Use when the user wants a transcript, 逐字稿, captions, subtitles, 口播文稿, CC字幕, or AI字幕 from a Bilibili/B站 video URL or BV id. |
B站视频转逐字稿
把 B 站视频变成带时间轴的逐字稿。先拿官方/AI 字幕，没有再本地下载音频做语音识别。不要手写爬虫步骤，执行本 skill 的脚本。
何时使用
- 用户丢来
bilibili.com/video/BV… 或 BV 号，要逐字稿/字幕/文稿
- 用户说「转写 B 站」「B站口播」「导出字幕」
执行
在 skill 根目录运行（仓库根或 ~/.cursor/skills/bilibili-transcript）：
python3 scripts/bili_transcript.py "https://www.bilibili.com/video/BVxxxxxx" -o ./transcripts -f all
只接受 URL 或 BV 号。多 P 用 --page N（从 1 起）。
输出 BVxxxxxx.txt / .srt / .json。把逐字稿给用户；默认用带时间轴的可读正文，需要原档再附 SRT 路径。
字幕优先级
- 播放器接口里的 CC / AI 字幕（
zh-CN > zh > ai-zh）
- 否则下载音频，用本机 Whisper（
whisper-cli 优先，其次 whisper）
--subs-only：没有字幕就停，并说明是否缺登录态
need_login_subtitle: true 且字幕列表为空时：AI 字幕要登录。使用环境变量 BILI_SESSDATA 或 --sessdata，不要把 cookie 写入仓库、聊天或日志。禁止把浏览器 cookie 导出成文件再提交。
BILI_SESSDATA='...' python3 scripts/bili_transcript.py BV1xxx -o ./transcripts
依赖
- Python 3.9+（标准库即可）
- 无字幕时：
whisper-cli（whisper.cpp）或 pip install openai-whisper
- 转音频：
ffmpeg，或 macOS 自带 afconvert
- 默认模型：
~/.cache/whisper.cpp/ggml-base.bin（缺失时脚本会从 hf-mirror 拉 ggml-base）
交付
- 标题、UP 主、BV、链接
- 带时间轴的逐字稿（可按句合并，不要改原意）
- 专有名词可对照视频标题/简介轻量校对，并标明来源：官方字幕 / AI 字幕 / Whisper
- Whisper 结果声明可能有识别误差
- 游戏实况等无口播片段保持空白，不要编造
禁止
- 不要为「拿字幕」去提取或保存浏览器 cookie 文件
- 不要把 SESSDATA 写进 README、issue、commit
- 不要把视频下载后的音视频提交进 git
