YouTube Summary（youtube2md）是一个专为开发者设计的命令行工具，用于将 YouTube 视频内容自动转换为结构化的 Markdown 摘要。该工具通过解析视频的字幕或转录文本，生成包含章节划分、时间戳链接和关键要点提取的格式化文档，极大提升了从视频内容中快速获取信息的效率。它支持两种运行模式：完整摘要模式和仅提取模式，分别适用于拥有 OpenAI API 密钥的用户和需要本地处理敏感内容的场景。整个流程由 Shell 脚本封装，确保操作简洁且可重复。 工具的核心优势在于其自动化程度高、输出规范统一，并严格遵循安全实践。用户只需提供有效的 YouTube 链接（支持 youtube.com 和 youtu.be 格式），即可一键生成高质量笔记。系统会自动验证输入合法性，并根据环境变量 `OPENAI_API_KEY` 的存在与否智能切换至合适的处理路径。若 API 密钥缺失，则默认回退到提取原始转录数据，避免因外部调用失败而中断体验。此外，所有生成的中间文件（如 JSON 和 TXT）均存放于独立目录中，便于管理且不污染技能主仓库。 值得注意的是，该工具强调运行环境的安全性与可控性。要求 Node.js 18+ 和 Python3 作为运行时依赖，推荐使用固定版本（如 npm install -g youtube2md@1.0.1）以确保行为一致。禁止直接使用 npx 执行，也拒绝接受 `YOUTUBE2MD_BIN` 等环境变量覆盖指令，从而防止不可预测的执行路径。对于涉及隐私或合规限制的内容，建议关闭 API 访问，仅依赖本地转录文本进行摘要，既满足功能需求又保障数据安全。
核心功能特点
- 支持 YouTube 视频 URL 自动识别与批量处理，兼容标准网页链接与短链格式
- 提供全量摘要与纯转录提取双模式，根据 OPENAI_API_KEY 存在与否自动切换
- 生成带时间戳跳转链接的分章节 Markdown 文档，提升内容回溯效率
- 内置错误检测机制，失败时优先返回已成功处理的结果并提供修复建议
- 严格隔离输出文件路径，避免技能目录被临时数据污染
- 强制要求本地安装指定版本 CLI 工具，禁用动态 npm 执行以增强稳定性
适用场景
YouTube Summary 特别适合需要高效整理在线课程、技术讲座或播客内容的知识工作者和学生群体。例如，当用户观看长达数小时的编程教学视频时，可通过此工具快速获得按主题划分的代码讲解段落、重点概念总结及对应时间点，显著减少手动做笔记的时间成本。教育场景中，教师也可利用其批量处理系列讲座视频，自动生成讲义初稿供学生预习复习。 在团队协作开发中，该工具同样具有实用价值。假设某团队定期参加行业大会并录制会议回放，成员们可以借助 youtube2md 将多个演讲视频转化为结构化文档，形成共享的知识库。由于输出为标准化 Markdown，易于集成进 Wiki 系统或静态站点生成器，实现内容沉淀与协同编辑。 对于注重数据隐私的企业或研究机构而言，Extract 模式尤为重要。这类组织通常不允许将字幕或对话内容上传至第三方云服务，此时可通过本地运行 prepare.py 脚本直接处理转录文本，在不触发任何外部请求的前提下完成信息提炼，兼顾功能性与合规性。同时，工具对本地文件系统的精细控制也降低了误操作风险，确保敏感资料始终处于受控范围内。