用途：把 YouTube 视频字幕整理成可引用的、与章节对齐的笔记或回答。脚本只负责机械工作：抓字幕、对齐章节、合并零碎字幕块；综合判断由使用者完成。
主要能力：脚本为单个 TypeScript 文件，由 Node 直接运行，无需构建。它调用 uvx 获取 youtube-transcript-api（字幕）与 yt-dlp（元数据、章节），按需运行，不全局安装。缺少 uvx 时退出码 2，并提示 brew install uv。首次抓取按视频 id 缓存，之后免费，可用于避免限流。模式包括 triage（章节概览）、full（完整）、transcript（逐字稿），还可用 --chapters 选章节、--out 写文件、--refresh 强制重取、--no-cache 跳过缓存。
使用方式：查看帮助：node ${CLAUDE_PLUGIN_ROOT}/skills/youtube-notes/scripts/fetch_video.ts --help。按意图选模式：判断是否值得看用 triage；总结、做笔记用 full；内容问答先 triage 再 full 或 --chapters；要逐字稿用 transcript。例：node ${CLAUDE_PLUGIN_ROOT}/skills/youtube-notes/scripts/fetch_video.ts "<url>" --mode triage。长视频按章节取，输出过大时写 --out 再读文件。引用需用块内 s 值构造深链 <url>&t=<s>，不得编造时间戳。
限制：字幕端点可能按 IP 限流（退出码 4），或该视频未发布字幕（退出码 3）；两者可用 --whisper-fallback 本地转写，但首次使用前需征得同意（约 1.6 GB 模型下载）。生成或 whisper 字幕会误识别专有名词和数字，引用应说明近似并标出可疑处。不要建议用浏览器 cookie 绕过。未观看视频，不得描述画面、幻灯片或演示；不要使用来源不明的第三方逐字稿。仅在用户要求时写笔记文件。