油管视频内容总结

要解决什么问题

工程师或学习者经常收到 YouTube 链接：演讲、教程、访谈。完整看完耗时，更需要可检索的结构化笔记、简短摘要，或可直接发布的 Thread / 博客稿。难点在于链接形态多样（youtu.be、Shorts、embed、纯 video ID），且不少视频没有可靠字幕，只能走音频转录。

技能如何工作

核心策略是字幕优先路由：先用 youtube-transcript-api 拉字幕（即时、中文自动字幕往往比 Whisper 更稳），只有无字幕或禁用时才用 yt-dlp + Whisper。

按你的目标选输出格式，默认是结构化笔记（分层大纲、要点、表格）；也可选 Summary、带时间戳的 Chapters、逐章摘要、Twitter/X Thread 等。单视频走 fetch_transcript.py；长转录（例如 1000+ 行）可用子代理分段读转录再生成笔记，避免撑爆主上下文。

批量场景会先做代理检测（yt-dlp 需显式 --proxy，端口不固定），并禁止并行 Whisper——多进程会抢满 CPU，反而更慢；3 个以上无字幕视频宜用 batch_whisper.py 单次加载模型顺序处理。队列状态可用紧凑或表格格式同步进度。

边界与注意点

• 私有、不可用或 Members-only 视频无法绕过，需你自行核对 URL 与会员权限。
• 遇 bot 校验类错误需更新 yt-dlp 并配合 --remote-components 等方案；Whisper 空文件或覆盖率不足时应删除重跑。
• 部分中文标题党可在笔记里标 ⚠️；大批量结果可对接飞书知识库（需额外 skill 与授权）。