技能介绍

解决什么问题

当需要从 YouTube、Bilibili、Twitter/X、TikTok 等站点下载视频或提取音频时，yt-dlp 的命令行参数很多，常见难点包括选择格式、控制分辨率、处理播放列表、下载字幕、嵌入封面，以及在中国大陆访问受限制站点时的代理与 DNS 解析。该技能把这些问题收敛成可复用的命令模板，减少手工拼装参数的试错成本。

技能如何工作

核心能力：支持自动最佳格式、MP3 / M4A / FLAC 音频提取、分辨率限制、MP4 强制封装、播放列表范围下载、字幕下载与嵌入、封面和元数据写入、批量下载。
关键步骤：先检查 yt-dlp 与 ffmpeg 是否可用；根据目标选择 yt-dlp URL、-x --audio-format、-f、-I、--write-subs 等命令；必要时配置 --proxy 或写入 ~/.config/yt-dlp/config。
输出控制：使用 %(title)s、%(channel)s、%(upload_date)s、%(playlist_index)s 等模板字段组织文件名，避免乱码时可加 --restrict-filenames。

适用边界

只适用于 yt-dlp 已支持且可访问的站点，不保证绕过平台限制。
list=RD... 这类自动 Mix 播放列表可能包含大量条目，需要用 --no-playlist 限定当前视频。
使用 socks5h:// 可让代理解析 DNS；遇到 bot 检查时可尝试 --cookies-from-browser chrome 或 --impersonate chrome。