名称： tube-summary
描述： 搜索 YouTube 上任意主题的视频，并通过视频字幕生成智能摘要。适用于以下场景：(1) 查找并预览某主题的 YouTube 视频；(2) 基于视频实际内容获取其详细描述；(3) 无需观看视频即可快速理解其主题。工作流程：搜索 YouTube → 选择视频 → 提取并总结字幕。

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 "视频URL"

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

步骤 4：处理与总结

使用字幕处理器进行分析和总结：

python3 scripts/process-subtitles.py "path/to/字幕文件.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 下载字幕
→ 处理并返回详细摘要