核心用法
YouTube Summary 是一款专为知识工作者、学生和内容研究者设计的视频摘要工具，通过 youtube2md CLI 将 YouTube 视频内容转化为结构化 Markdown 文档。用户只需提供视频 URL，即可获取带时间戳链接的章节笔记、关键要点提取及可选的多语言摘要。
工具提供两种运行模式：Full 模式（需配置 OPENAI_API_KEY）启用 AI 增强摘要，将视频内容发送至 OpenAI 进行深度分析与结构化输出；Extract 模式则在本地完成转录文本提取，无需外部 API 调用，适合敏感内容处理。工作流程自动检测 API 密钥可用性，无缝降级至本地模式，避免中断用户体验。
显著优点
- 结构化输出：自动生成章节标题、时间戳锚点与关键要点，便于快速导航与复习
- 双模式灵活：AI 增强与纯本地提取并行，兼顾智能化与隐私安全
- 多语言支持：支持指定目标语言生成摘要，突破语言 barrier
- 机器可读输出：可选 JSON 格式便于下游自动化处理
- 批量处理：支持多视频顺序处理，统一返回结果
潜在局限
- 依赖预装环境：需 Node.js 18+ 及全局安装的
youtube2md@1.0.1，首次配置成本较高 - 无视频解析：仅限含字幕/转录的视频，无音频识别能力
- API 成本：Full 模式下 OpenAI 调用产生额外费用
- 版本锁定：明确拒绝
npx运行时安装与YOUTUBE2MD_BIN覆盖，灵活性受限
适合人群
- 需要快速消化长视频课程的学习者
- 制作研究资料库的内容策展人
- 构建视频知识管理系统的开发者
- 对数据隐私敏感、偏好本地处理的机构用户
常规风险
- 数据外泄：Full 模式下视频内容经 OpenAI 处理，需评估内容敏感度
- 供应链安全：
youtube2md为第三方 npm 包，敏感环境需审计依赖 - 转录质量依赖：输出质量受限于 YouTube 自动字幕准确性
- 路径暴露：需遵循"不主动暴露本地文件路径"原则，防止信息泄露
安全建议：生产环境优先使用 Extract 模式，定期审计 youtube2md 版本与依赖树。