用途:从受支持的公开站点下载视频或音频资源,也可提取音频、字幕和元数据,将媒体保存到本地。适用于用户提供具体 URL 的下载需求。
主要能力:支持 YouTube、Bilibili、Twitter/X、TikTok 等 1000 多个站点;可选择视频或音频、目标画质与格式;可获取字幕和元数据;可指定输出目录。
使用方式:先确认参数中是否提供 URL,若为空则向用户询问视频 URL;明确需求(视频或音频、画质/格式、字幕或元数据、输出目录)。运行 ffmpeg -version 检查 FFmpeg 是否安装,若缺失则停止并给出安装指引,不启动不完整的下载流程。参考 $SKILL_DIR/references/COMMANDS.md 获取格式选择语法与命令模板,参考 $SKILL_DIR/references/TROUBLESHOOTING.md 获取站点特定规则(如 cookies、速率限制、代理要求)。输出位置优先使用用户提供的路径,否则默认下载文件夹(~/Downloads 或 %USERPROFILE%/Downloads)。使用清晰的输出模板执行 yt-dlp 命令,下载后验证文件确实存在于本地。若命令失败,对照 TROUBLESHOOTING.md 匹配错误,进行一次针对性重试,仍失败则停止。
输出内容:执行的命令、所用参数的简要说明、下载文件的位置。
限制:不适用于无法合法或技术上访问的 DRM 保护流;不适用于需要用户未提供凭据的私密内容;不适用于需要站点交互的浏览器自动化任务。若站点需要 cookies 或登录,会明确说明并指向故障排查参考;若字幕不可用会如实报告;若仅请求音频,会说明生成的容器/编解码格式;若重试仍失败,会给出错误类别和下一步可能的修复方向。