tube-summary

根据任意主题搜索 YouTube 视频，并通过字幕提取和总结其内容。

快速开始

步骤 1：搜索视频

当被询问某个主题时，搜索 YouTube 并列出前 10 个结果：

python3 scripts/youtube-search.py "您的搜索关键词"

该命令返回一个编号列表，包含视频标题、频道名称和观看次数。

步骤 2：用户选择视频

用户通过输入编号选择其中一个视频（例如，“3”表示第三个视频）。

步骤 3：下载字幕

使用 yt-dlp 从选定的视频中提取英文字幕：

yt-dlp --write-subs --sub-langs en --skip-download "VIDEO_URL"

此操作会生成一个 .en.vtt 字幕文件，而不会下载视频本身。

步骤 4：处理与总结

使用字幕处理器对内容进行分析并生成摘要：

python3 scripts/process-subtitles.py "路径/到/字幕文件.vtt"

该命令将生成：

• 关键主题：视频涵盖的主要内容
• 摘要：2–3 段简洁的内容概述
• 时间戳：重要片段及其上下文
• 关键引言：发言者的重要语句

工作流程

1. 搜索 → youtube-search.py "<主题>" → 显示前 10 个视频
2. 用户选择 → 例如，“第 5 个视频”
3. 提取链接 → 从搜索结果中获取目标视频 URL
4. 下载字幕 → yt-dlp --write-subs --sub-langs en --skip-download "URL"
5. 处理字幕 → process-subtitles.py "字幕.vtt"
6. 展示结果 → 格式化的摘要，包含关键要点

前置条件

• yt-dlp（安装方式：pip install yt-dlp）
• requests（用于 YouTube 搜索的备用方案）
• Python 3.7+

注意事项

• 若 YouTube 搜索 API 不可用，系统将使用 requests 进行网页爬取作为替代
• 字幕可能是自动生成的，而非人工编写
• 部分视频可能没有可用的英文字幕
• 字幕文件将在运行 yt-dlp 的目录中创建

使用示例

用户： “告诉我关于 Rust 编程语言的信息”

→ 搜索返回 10 个关于 Rust 的视频

用户： “总结第 3 个视频”

→ 下载第 3 个视频的字幕
→ 处理并返回详细摘要