用途：把单个 YouTube 视频的字幕导入 Markdown 笔记库，生成可被下游技能（知识图谱抽取、写作风格训练、内容再利用、行动项提取）处理的结构化条目。与 ingest-slack、ingest-notion 等属于同一系列，新增 YouTube 只是新增一个规范化器。
主要能力：校验并解析单个 YouTube 视频 URL；用 yt-dlp 枚举可用字幕，优先人工字幕、其次自动字幕；下载优先级最高的 VTT，去除时间码并合并成干净段落，去重重复行，保留说话人标签；抓取标题、频道、上传日期、时长、video_id、URL 等元数据；按频道与标题生成 slug 写入 External Inputs/YouTube/<channel-slug>/<YYYY-MM-DD>-<video-slug>.md；扫描字幕中的触发词并生成写作种子存根；打印文件路径、字数、语言与种子数。默认语言偏好 en,es。
使用方式：运行 python3 ingest.py <youtube-url> [--vault <path>] [--lang <code>]。--vault 默认取 $VAULT_ROOT 或当前目录。依赖 yt-dlp，需先安装：brew install yt-dlp 或 pip3 install --user yt-dlp。重复导入同一 URL 会覆盖同一文件，种子文件名基于 video_id 哈希，重跑只刷新不重复。
适用场景：用户粘贴 YouTube 链接要求字幕或摘要；用户输入 /ingest-youtube <url>；将演讲、播客、主题演讲捕获进笔记库。
限制：每次仅处理一个视频 URL，不支持频道、播放列表或 --days 时间窗；不下载视频文件；本版本不内置 Whisper 转录，--whisper 仅为未来保留标志；无字幕时只写入元数据占位笔记；直播字幕不稳定不建议使用；不适用于 Vimeo、Twitch、Twitter Spaces 等非 YouTube 来源。