用途：yt-dlp 是功能丰富的命令行音视频下载器，支持数千个网站，是 youtube-dl 的维护分支，附带大量新功能与修复。本资料以文档指南形式整理其安装、用法与排错入口。
主要能力：下载视频或音频、格式选择（画质与音视频筛选）、音频提取与转换、字幕与自动字幕下载及嵌入、播放列表与频道处理及筛选、文件名输出模板自定义、元数据与缩略图嵌入、认证与 cookies、配置文件的加载、代理与地理限制相关选项、SponsorBlock 集成、作为 Python 库嵌入使用，以及插件机制。
使用方式：安装可用 Homebrew 的 brew install yt-dlp，或 pip install yt-dlp，更新用 yt-dlp -U。基本命令如 yt-dlp URL 下载最佳画质；yt-dlp -x --audio-format mp3 URL 提取音频；yt-dlp -o "%(playlist_index)s-%(title)s.%(ext)s" PLAYLIST_URL 下载播放列表；yt-dlp -F URL 列出可选格式；yt-dlp -f FORMAT_ID URL 下载指定格式。完整选项可运行 yt-dlp --help。
适用场景：需要从支持站点批量或单条下载音视频、抽取音频、获取字幕、按格式或画质筛选、整理播放列表与命名、以及在需要登录或遇到 YouTube 特殊问题时参考对应文档处理。
限制：许多后处理功能依赖已安装 ffmpeg；YouTube 下载可能需要特殊处理，参见相关认证与解密文档；资料未提供具体收费、价格、支持站点完整清单或效果保证，相关细节以官方 README 与 wiki 为准。