用途:当用户要求下载、提取音频、剪辑、获取字幕或归档来自 yt-dlp 支持站点的媒体 URL 时,使用该技能。目标是在磁盘上产出符合请求的文件并按路径、大小、身份进行报告,或遇到明确阻塞(缺二进制、需认证、权利不明、播放列表过大、YouTube 机器人墙)时停止。
主要能力:默认单视频下载命令为 yt-dlp --no-playlist -P "<dir>" -o "%(title).200B [%(id)s].%(ext)s" --merge-output-format mp4 --print after_move:filepath "<url>",以 --print 输出路径作为交付路径,并验证文件存在且非空;视频用 ffprobe 校验时长与分辨率。高度上限、仅音频、字幕、输出布局、SponsorBlock 等通过小幅修改命令实现。播放列表或频道归档需先确认范围,并使用 --download-archive 避免重复下载;剪辑使用 --download-sections 并核对时长。
使用方式:所有 URL 在 shell 命令中需加引号;观看 URL 默认视为单视频并保留 --no-playlist。合并音视频、提取音频、嵌入字幕、剪辑或 SponsorBlock 后处理前,先检查 ffmpeg -version,缺失即为阻塞。失败时按顺序保留命令、退出状态与 stderr,更新 yt-dlp 后低成本复查;涉及 YouTube 403、机器人验证、nsig、PO-token 或 HLS 失败时需阅读 references/youtube-auth.md。
适用场景:单视频下载、指定高度上限、仅音频、字幕、剪辑、播放列表/频道归档。
限制:不授权下载无界播放列表/频道、读取浏览器 cookie 或认证文件、绕过权利不明内容或提供仅用户可给的输入;权利、范围、认证不明确或缺少二进制时应停止并报告。资料未提供收费、价格与平台支持细节。