youtube-transcript 用于把 YouTube 视频或字幕转换成带时间戳的 Obsidian 笔记。
用途 当用户提供一个 YouTube URL 或已准备好的字幕文本时，该技能将其整理为结构化的 Obsidian 笔记，便于归档、检索和后续引用。
工作流程
- 若既没有提供 URL 也没有提供字幕文本，先询问一次缺失的来源。
- 对于 URL，运行 scripts/extract_subtitle.py <url>，并从其 JSON 输出中读取选定的 .vtt 或 .srt 路径。
- 若因缺少 yt-dlp 或字幕不可用而导致提取失败，说明该情况并接受手动提供的字幕。
- 使用 TEMPLATE.md 转换字幕；在开始写笔记之前先加载该模板。
- 只有在用户未提供保存位置时才询问保存位置。文件名使用 YYYY-MM-DD - [Video Title].md。
内容规则 不编造事实；对含糊的说法标记为 [uncertain: reason]。 为每个重要章节保留时间戳。 将方法、框架和流程解释为清晰的步骤或段落。 使用 Obsidian callout 表示引用、技巧、警告、注释和注意事项。
脚本 scripts/extract_subtitle.py "https://www.youtube.com/watch?v=..." 该脚本打印包含 subtitle_paths、best_subtitle 以及捕获的 yt-dlp 输出的 JSON。优先使用 best_subtitle；在总结之前先检查原始文件。
适用场景 适合将 YouTube 上的讲座、教程、访谈、会议演讲等视频内容整理为 Obsidian 知识库笔记，保留时间戳与分节结构，方便回顾和引用。
限制 依赖 yt-dlp 提取字幕；当 yt-dlp 缺失或视频没有可用字幕时无法自动提取，只能改用手动提供的字幕。其他限制资料暂未提供。