用途：对一个或多个 YouTube 频道进行 LLM 驱动的研究。脚本负责确定性 I/O（列目录、取字幕、转录），综合与写作由 Claude 阅读脚本输出完成。
主要能力：列出频道视频目录并缓存；按标题与描述筛选主题相关视频；对筛选集转录（优先人工字幕，其次自动字幕，最后 Whisper）；生成 markdown 或 PDF 研究文档，含 TL;DR、关键论断、反复主题、张力与来源视频，引用带 [HH:MM:SS] 时间戳深链。多频道运行时自动做跨频道对比与观点分歧呈现，并统计“省下观看时长”。
使用方式：先收集输入（频道、主题、可选特定视频、输出格式、每频道视频数上限，默认最新 50，可选研究问题）。检查依赖：python3 scripts/check_deps.py。列目录：python3 scripts/list_channel.py --channel "@veritasium" --kb ./.youtube-research --limit 50（多频道重复 --channel 或用逗号分隔）。转录筛选集：python3 scripts/fetch_transcripts.py --channel "@veritasium" --ids "id1,id2,id3" --kb ./.youtube-research（多频道可并行调用）。若选 PDF：python3 scripts/render_pdf.py ./<topic-slug>.md。
适用场景：快速消化一个或多个频道的视频内容，做主题综述、跨频道对比或回答具体问题。
限制：需要 yt-dlp 与 ffmpeg，缺 yt-dlp 需先安装；无 Whisper 时纯语音视频会被跳过。--limit 按频道计，成本随频道数倍增。工作区在 ./.youtube-research/，最终文档在 cwd 顶层。清理工作区需用户确认，默认保留缓存。转录来源可能是自动字幕或 Whisper，存在错误风险。具体收费与平台支持信息暂未提供。