Agent Skills
返回列表
yt-dlp 直连下载

yt-dlp 直连下载

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f86284a2/yt-dlp-direct。

技能介绍

要解决什么问题

很多人一想下载在线视频或音频,就让助手先写 Python 脚本或猜 API,结果绕了一圈才发现本机已经装了 yt-dlp。这个技能把默认路径收紧成一件事:直接用已安装的 yt-dlp CLI 处理链接探测、格式选择、单文件下载、提音频、拉字幕和播放列表批量任务,并在回复里交代跑了什么命令、是否只是探测、文件落在哪。

技能如何工作

工作流按 SKILL 里约定的顺序走,而不是一上来就全量下载:

  • 先只读探测:用 --simulate 或等价方式确认 extractor 能否识别链接,再决定要不要真下。
  • 格式不明先列清单:需要指定清晰度或音轨时先 -F,没指定时按常见偏好选视频+audio 组合。
  • 安全落盘:用户没给规则时给带占位符的输出模板(如 %(title)s.%(ext)s),避免误覆盖大量文件。
  • 音频与字幕:提音频用 -x 等;只下字幕用 --write-subs / --sub-lang,与「不下视频」场景分开处理。
  • 列表与频道:播放列表先提醒条目数和体积,可用 --flat-playlist 先看规模再决定是否全下。
  • 登录态:优先 --cookies-from-browser,再考虑 --cookies 或 netrc;回复里不抄写敏感 cookie 内容。

合并音视频、嵌缩略图、高级转码通常仍依赖本机 ffmpeg;技能不会替你重装 yt-dlp,也不会讲一遍版权课或帮绕 DRM。

适用边界

只适合「链接能交给 yt-dlp、且本机环境已就绪」的工程化下载任务。纯科普 yt-dlp 是什么、破解受保护流、用浏览器录屏替代下载、或复杂时间线剪辑(应走 ffmpeg 剪辑流)都不在本技能职责内。站点改版或版本过旧时,会先建议查版本、加 -v 日志再定位是认证、格式还是网络问题。

使用场景

  • 用户丢来一个 B 站或 YouTube 链接,要求先确认能否用 yt-dlp 解析再决定是否下载
  • 直播回放或访谈需要只要 mp3/m4a,让助手用 `-x` 并说明输出文件名与路径
  • 外语课程视频需要内嵌或外挂字幕,只拉字幕或指定 `--sub-lang` 而不下整段视频
  • 频道或播放列表几十条起步,要先 `--flat-playlist` 看条数再选全量或区间下载

适合人员

  • 自己维护 homelab 或 NAS,经常把教程、发布会归档到本地磁盘的自建用户
  • 剪辑前需要稳定抓取音轨与外挂字幕、再交给 ffmpeg 时间线的短视频后期
  • 内网只能走本机代理与浏览器登录态,要用 `--cookies-from-browser` 下会员或区域限定内容的研究员
  • 运维或 SRE 在跑批迁移公开讲座存档,需要可复现的 yt-dlp 命令与失败分类说明的同事