用途:给定一个 YouTube URL,按顺序执行一套完整摄取流程,把视频信息整理成 Obsidian 库中的一条笔记,并用 git 提交。过程不逐步询问用户,除非某一步失败。
主要能力与用法:先用 uvx yt-dlp --get-title "<youtube_url>" 获取视频标题,并用 WebFetch 访问标准 YouTube 观看链接,取得频道名和一句话主题摘要。缩略图不经过图床上传,直接由视频 ID 拼接稳定地址 https://i.ytimg.com/vi/<VIDEO_ID>/maxresdefault.jpg,同时用于笔记的 pic: 和 hero 图片。
文件名从标题派生:全小写,单词以空格分隔(不用连字符或下划线),去掉管道、冒号、斜杠等特殊字符,并在结果仍具描述性时去掉无意义的填充词(如 how to、a、the)。示例中 "How To Make Dumpling Wrappers From Scratch | KitchenAid Pasta Attachment" 会变成 dumpling wrappers from scratch kitchenaid pasta attachment.md。
笔记写入 /Users/mtm/Documents/Obsidian Vault/<filename>.md,结构包含 YouTube 链接和 hero 图片;除非用户要求,否则不加 frontmatter。随后分别执行 git add "<filename>.md" 和 git commit -m "Add <short topic> note with YouTube link and hero image",两条 git 命令各自作为独立 Bash 调用,不用 && 串联。完成后报告笔记文件名、i.ytimg.com 缩略图 URL 和原始 YouTube URL。
适用场景:把 YouTube 视频快速归档到 Obsidian 并纳入 git 版本管理。限制:路径 /Users/mtm/Documents/Obsidian Vault 为固定值,文件名规则可能改动原意;对 Instagram 等 CDN 链接会过期的平台仍需上传图床,YouTube 则不需要;未提供关于错误重试、并发或额外配置的说明。