前言¶
技术分享、课程回放、访谈往往长达几十分钟。若只想确认「讲了什么」或摘几条要点，整段看完成本高；只靠平台自带字幕，又常遇到没有字幕、机器翻译质量差，或 B 站、YouTube 抓取策略变化导致脚本失效。
下面介绍 SkillHub 上的社区 Skill B站油管视频总结器（坐标 @user_06b53f10/bilibili-youtube-video-summarizer）。它在 Agent 对话里按固定流程拉取 B 站或 YouTube 内容，用 faster-whisper 或字幕 API 得到文字，再由模型翻译（非中文）并生成结构化总结。SkillHub 分类为 knowledge-management，标签标明 requires_api_key=false；页面当前版本为 v1.0.0（技能包内 SKILL.md 自述版本为 3.2.1，作者 pomisun）。
这是什么¶
B站油管视频总结器是面向 Agent 的视频音频抓取与转录 Skill：从 bilibili、YouTube 获取音频或字幕，转写成文字，并引导模型输出摘要与笔记。
- 来源：SkillHub 社区，发布者
user_06b53f10 - 协议：MIT（见技能包
SKILL.md） - 运行环境：Python >= 3.10；核心依赖包括 ffmpeg、faster-whisper，以及按平台区分的 bilibili-api-python、yt-dlp、deno、youtube-transcript-api 等（见环境检查脚本说明）
整条链路可概括为：视频 → 音频/字幕 → 转文字 → 翻译（如非中文）→ 结构化总结。
核心功能¶
以下能力均来自官方简介与技能包 SKILL.md：
- 双平台 URL 识别：支持
bilibili.com、b23.tv（短链需 Agent 用web_fetch解析真实 BV 链接）、youtube.com、youtu.be。 - B 站音频下载：通过
scripts/download.py走 bilibili-api，默认低码率音频并自动转 mp3；可选--page多 P、--quality high、--sessdata登录态。 - YouTube 优先字幕：有字幕时用
scripts/fetch_subtitle.py（youtube-transcript-api），无字幕再download.py（通常需浏览器 cookie，文档示例为--browser edge）。 - 转写：
scripts/transcribe.py默认 faster-whisper，内置 VAD 静音过滤，文档称比原版 Whisper 快约 3–4 倍；可选--engine openai回退；输出 txt/md/srt/vtt。 - 非中文内容：由 Agent 将字幕或转写译为简体中文（文档明确不推荐依赖 YouTube 内置简中翻译）。
- 总结模板：按基本信息、分章要点、关键数据、可执行建议、术语对照等结构组织输出。
- 自然语言触发：如「视频总结」「转录视频」「这个视频讲了什么」「B站抓取」「YouTube 字幕」等（完整列表见 SkillHub 简介）。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装说明 执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 实际读取的目录，否则默认落在 ./skills/ 可能无法被识别。常用路径示例（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装命令：
skillhub install @user_06b53f10/bilibili-youtube-video-summarizer --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你当前客户端对应目录即可。也可把下面提示交给 AI，让其按安装文档完成：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_06b53f10/bilibili-youtube-video-summarizer`。
3、首次环境检查¶
安装后，在技能目录下对 scripts/check_env.py 做自检；缺失依赖时可带 --fix 尝试自动安装 Python 包：
python <skill-path>/scripts/check_env.py
python <skill-path>/scripts/check_env.py --fix
<skill-path> 为安装后的技能根目录，例如 ~/.cursor/skills/@user_06b53f10/bilibili-youtube-video-summarizer。
典型用法¶
在 Agent 已加载该 Skill 的前提下，用触发词加链接即可走完整流程；Agent 会按 SKILL.md 调用脚本。下面是与文档一致的可复现命令示例（路径请替换为本地 <skill-path>）。
环境自检
python <skill-path>/scripts/check_env.py --fix
B 站：下载音频并转写
python <skill-path>/scripts/download.py --url "https://www.bilibili.com/video/BVxxx" --output "./output/video1"
python <skill-path>/scripts/transcribe.py --input "./output/video1.mp3" --output "text.md" --format md --language zh
YouTube：先尝试字幕（推荐）
python <skill-path>/scripts/fetch_subtitle.py --url "https://www.youtube.com/watch?v=xxx" --list
python <skill-path>/scripts/fetch_subtitle.py --url "https://www.youtube.com/watch?v=xxx" --output "sub.md" --lang en --format md
YouTube：无字幕时下载音频
python <skill-path>/scripts/download.py --url "https://www.youtube.com/watch?v=xxx" --output "./output/yt1" --browser edge
python <skill-path>/scripts/transcribe.py --input "./output/yt1.mp3" --output "text.md" --format md --language zh
对话侧示例（无需记参数，由 Agent 编排）：
- 「帮我总结这个 B 站视频：https://www.bilibili.com/video/BVxxx」
- 「这个 YouTube 视频讲了什么？https://www.youtube.com/watch?v=xxx」
- 「把这段英文视频转成中文字幕并写视频笔记」
经过上面的步骤，模型会在转写或字幕基础上完成翻译（如需要）并按 Skill 约定的结构输出摘要。
适用场景与注意¶
适合谁
- 需要把 B 站、YouTube 长视频快速变成文字稿、笔记或要点列表的开发者、学习者。
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作，希望用统一脚本处理反爬与转写细节的用户。
限制与坑（见技能包 references/pitfalls.md）
- B 站：不要用 yt-dlp 直连；
b23.tv短链需先用web_fetch解析，不要指望脚本直接处理短链。 - YouTube 下载：无 cookie 时音频下载常被拦截；有字幕时优先
fetch_subtitle.py，避免不必要的 yt-dlp 下载。 - 限流：字幕 API 文档提到约 300 次/小时 IP 限流，过高频需等待恢复。
- 算力与时间：faster-whisper 首次会下载模型（medium 约 1.5GB）；长音频转写耗时明显，有 NVIDIA GPU 时 faster 引擎可自动走 CUDA。
- 质量权衡：中文建议
--language zh；faster 偶发漏词时可试--engine openai（需另行pip install openai-whisper）。
结尾¶
B站油管视频总结器把平台差异、下载路线、双引擎转写和总结结构写进 Skill，让 Agent 用对话触发即可完成「看视频 → 要结论」的常见需求，且无需额外 API Key。
- SkillHub 页面：https://www.skillhub.cn/skills/user_06b53f10/bilibili-youtube-video-summarizer
- 安装坐标：
@user_06b53f10/bilibili-youtube-video-summarizer
