YouTube字幕章节生成工具

要解决的问题

YouTube 视频的章节（chapters）是观众在内容间跳转的主要入口，但手工设置时要先听完整个视频、记录每个主题的起始时间，再把时间戳按 MM:SS 格式逐条写进简介。长视频动辄几十分钟，人工标注既耗时又容易出错，章节边界也常常和实际的话题切换对不上。

工作方式

这个技能把整条流程拆成三步：

• 拉取字幕：通过 youtube-transcript-api 提取视频字幕文本。
• 语义切分：用 sentence-transformers 把字幕编码成向量，检测话题切换点，将连续文本切分成语义相对完整的段落。
• 格式化输出：为每个段落计算起始时间戳，生成符合 YouTube 简介元数据规范的章节列表。

适用边界

• 依赖 YouTube Data API v3，需要已启用该 API 的 Google Cloud 项目，以及 OAuth 2.0 凭据或 API Key。
• 视频本身必须有字幕才能提取，字幕质量会直接影响切分结果。
• 配额按请求次数计算，批量处理长视频时需要留意 quota 消耗。