B 站视频转录与总结#

当用户给出 B 站视频链接，并希望了解视频内容、获取转录文字或让 AI 做总结时，使用这个 skill。

触发条件#

满足以下两点时触发：

• 用户输入的是 B 站标准链接、 BV... 号，或者 https://b23.tv/... 短链接。
• 用户意图是转录、提取字幕、总结、分析视频内容。

工作流程#

1. 先检查 node --version，要求 Node.js 18 及以上。
2. 如果大概率需要语音转写，再检查 SILICONFLOW_API_KEY 是否存在。
3. 运行 scripts/bilibili_pipeline.mjs。
4. 优先使用官方字幕。
5. 如果没有字幕，则从页面播放信息中提取匿名音频地址。
6. 下载得到 .m4s 文件后，直接改名为 .mp3，不做转码。
7. 如果存在 API key，则调用硅基流动 TeleAI/TeleSpeechASR 进行转写。
8. 获取文字后，按用户要求进行总结；如果用户没有说明，就默认输出重点总结。

首次成功后的标记文件#

脚本在第一次成功执行 probe 或 run 后，会在输出目录写入 .skill-ready.json。

如果这个文件已经存在，就默认环境已经准备过了，后续再次使用时不必重复做依赖和 API key 的提示说明，直接执行即可。只有当脚本真正失败时，再回退到安装或配置引导。

依赖与环境检查#

首次成功运行前先检查：

• node --version 是否可用。
• 如果要做 ASR， SILICONFLOW_API_KEY 是否已注入。
• 如果环境限制联网，需要先申请网络权限。

如果输出目录里已经存在 .skill-ready.json，则默认跳过重复检查。

如果缺少 Node.js，请先引导用户安装 Node.js 18+，再继续执行。

如果缺少 API key，请提示用户前往以下页面创建：

• https://cloud.siliconflow.cn/me/account/ak

然后再设置环境变量并重试，例如：

powershell

$env:SILICONFLOW_API_KEY="你的_key"

bash

export SILICONFLOW_API_KEY="你的_key"

更完整的安装与重试说明，请阅读 setup.md。

常用命令#

只探测，不下载音频：

bash

node scripts/bilibili_pipeline.mjs probe "https://www.bilibili.com/video/BV1R6PzzAE9k" --output-dir ./output

完整执行：

bash

node scripts/bilibili_pipeline.mjs run "https://www.bilibili.com/video/BV1R6PzzAE9k" --output-dir ./output

短链接也可直接使用：

bash

node scripts/bilibili_pipeline.mjs run "https://b23.tv/lsocHNd" --output-dir ./output

输出文件#

脚本会在输出目录写入：

• probe_result.json：页面解析结果、字幕信息、候选音视频地址
• audio.mp3：匿名音频流下载后改名得到的文件
• transcription_result.json：硅基流动转写返回结果
• transcript.txt：最终可直接阅读的文字稿
• .skill-ready.json：表示这个输出目录至少成功跑通过一次

如果成功拿到文字稿，脚本结束时也会把 transcript 直接打印到 stdout，调用方不必再额外读取 transcript.txt。

回复规则#

拿到文字之后：

• 如果用户要求完整转录，就输出完整文字或引用 transcript.txt。
• 如果用户要求重点分析某一部分，就只围绕该部分总结。
• 如果用户没有特别要求，默认给出重点总结。
• 需要说明文字来源是官方字幕还是 ASR。
• 如果字幕和 ASR 都不可用，就明确说明阻塞原因并停止。

说明#

• 这个 skill 已验证可处理标准 B 站链接和 b23.tv 短链接。
• 在当前验证流程里，匿名下载得到的 .m4s 音频文件，直接改名为 .mp3 后即可用于硅基流动转写，无需转码。
• 匿名获取能力不是绝对稳定，部分视频仍可能因为 B 站限制而失败。