yt-dlp-downloader

name	yt-dlp-downloader
description	使用 yt-dlp 下载视频。当用户发送视频链接（YouTube、Bilibili、Twitter、抖音等）或请求下载视频时触发。支持单个/批量下载，默认优先 4K（2160p），fallback 到 1080p。支持三种编码模式：H.264（默认，最广泛兼容）、HEVC/H.265（4K 高效编码，文件更小）、原始格式（不转码，保留 webm/mkv 等）。自动嵌入中文字幕（优先中文，英文兜底）。触发词：下载视频、yt-dlp、视频链接、HEVC、H.265。

yt-dlp 视频下载

前置条件

• yt-dlp 已安装 (brew install yt-dlp)
• ffmpeg 已安装 (brew install ffmpeg)

下载目录

所有视频保存到：/Users/ivan/Downloads/yt-dlp-download/

下载命令

单个视频

yt-dlp \
  -f "bv*[vcodec^=avc]+ba/bv*+ba/best" \
  -S "res:2160" \
  --merge-output-format mp4 \
  --remux-video mp4 \
  --windows-filenames \
  --no-overwrites \
  -o "/Users/ivan/Downloads/yt-dlp-download/%(title)s.%(ext)s" \
  "VIDEO_URL"

批量下载（多个 URL）

yt-dlp \
  -f "bv*[vcodec^=avc]+ba/bv*+ba/best" \
  -S "res:2160" \
  --merge-output-format mp4 \
  --remux-video mp4 \
  --windows-filenames \
  --no-overwrites \
  -o "/Users/ivan/Downloads/yt-dlp-download/%(title)s.%(ext)s" \
  "URL1" "URL2" "URL3"

参数说明

参数	作用
-f "bv*[vcodec^=avc]+ba/bv*+ba/best"	优先 H.264 编码（QuickTime 兼容），否则选最佳
-S "res:2160"	优先 4K (2160p)，逐级 fallback 到 1080p → 720p
--merge-output-format mp4	合并时输出 MP4 格式
--remux-video mp4	非 MP4 容器自动转换为 MP4
--windows-filenames	处理文件名中的特殊字符
--no-overwrites	不覆盖已存在的文件
-o "...%(title)s.%(ext)s"	使用视频标题作为文件名

常见问题

下载速度慢

添加代理：

yt-dlp --proxy "socks5://127.0.0.1:1080" ...

需要登录的视频

使用 cookies：

yt-dlp --cookies-from-browser chrome ...

查看可用格式

yt-dlp -F "VIDEO_URL"

需要登录时：

yt-dlp --cookies-from-browser chrome -F "VIDEO_URL"

指定清晰度

# 仅 1080p
yt-dlp -S "res:1080" ...

# 仅 720p
yt-dlp -S "res:720" ...

4K 只有 VP9/AV1（避免下载后再慢速转码）

先看 2160p 是否有 mp4（常见是 av01 的 401 格式）：

yt-dlp --cookies-from-browser chrome -F "VIDEO_URL"

如果有 2160p 的 mp4，直接下（避免转码）：

yt-dlp --cookies-from-browser chrome \
  -f "401+140" \
  --merge-output-format mp4 \
  --remux-video mp4 \
  --windows-filenames \
  --no-overwrites \
  -o "/Users/ivan/Downloads/yt-dlp-download/%(title)s [%(height)sp].%(ext)s" \
  "VIDEO_URL"

如果只有 VP9 的 2160p（webm），先下载并合并为 mkv：

yt-dlp --cookies-from-browser chrome \
  -f "313+140" \
  --merge-output-format mkv \
  --remux-video mkv \
  --windows-filenames \
  --no-overwrites \
  -o "/Users/ivan/Downloads/yt-dlp-download/%(title)s [%(height)sp].%(ext)s" \
  "VIDEO_URL"

统一为 MP4（HEVC）更快方案

优先用硬件编码（快，体积适中）：

ffmpeg -y -i "INPUT.mkv" \
  -c:v hevc_videotoolbox -b:v 12000k -maxrate 16000k -bufsize 24000k \
  -c:a aac -b:a 192k \
  "OUTPUT.hevc.mp4"

高质量但慢（软件编码）：

ffmpeg -y -i "INPUT.mkv" \
  -c:v libx265 -crf 22 -preset medium \
  -c:a aac -b:a 192k \
  "OUTPUT.hevc.mp4"