SuperAPI AI 工具集

download-media

设计与创作

查看项目

更新于 10-15 20:28

技能介绍

用途:通过 yt-dlp CLI 从任何 yt-dlp 支持的站点下载视频或音频。该技能负责校验输入、按意图组合参数、把文件下载到 ~/.agents/output/<project>/download-media/<slug>/(或用 -d 指定目录),并报告最终文件路径(完整展开,无波浪号)。

主要能力:参数包括 -a(仅音频 mp3,需 ffmpeg,与 -r/-b 冲突)、-b(最佳原生质量,跳过 mp4 兼容预设)、-p(整张播放列表到子文件夹)、-i(仅查看格式,不下载)、-c A-B(裁剪时间段,需 ffmpeg)、-u <langs>(字幕边车文件)、-r <height>(限制分辨率)、-d <dir>(目标目录)。默认使用 -t mp4 预设(h264/aac,重封装为 mp4)。URL 之后的参数原样传给 yt-dlp。

使用方式:先确定媒体 URL,再运行 bash "$SKILL_DIR"/scripts/download-media.sh -a 'URL'。参数作为数据解析,URL、路径和标志值分别加引号,不要拼接原始 $ARGUMENTS 或使用 eval。脚本输出 RESULT: key=value 行(files、dest、slug,顺序不定,按 key 解析);-i 时打印格式表。示例:/download-media -a <url>、-r 1080 <url>、-p <playlist-url>、-c 10:15-12:30 <url>、-u "en.*" <url>、-d ~/Downloads <url>。

适用场景:公开内容、用户自己的上传、知识共享和授权素材的个人及授权使用。

限制:yt-dlp 无法绕过 DRM,本技能从不尝试绕过;拒绝翻录付费流媒体目录或规避付费墙的请求。下载可能仍受站点服务条款和当地版权法限制;涉及盗版的请求应指出并停止。未安装 yt-dlp(退出码 127)或 -a/-c 缺 ffmpeg(退出码 3)时应打印对应安装命令并停止,不得自动安装。其他错误原样转达。提取失败先建议更新 yt-dlp。播放列表部分失败仍报告已下载文件并传播退出码。未提供的信息暂未提供。