核心用法
Universal Video Downloader 是一款基于 yt-dlp 的视频下载技能,支持从 YouTube、Instagram、TikTok、Twitter/X、Facebook 等 1000 多个平台下载视频。用户只需提供视频链接,Agent 会自动获取可用画质列表(从 144p 到 4K/8K),让用户选择后执行下载,并将文件通过聊天发送给用户。
工作流程分为四步:首先使用 scripts/download.py info 获取视频信息和可用格式;然后向用户展示分辨率选项;用户确认后使用 scripts/download.py download 执行下载;最后通过 message 工具发送文件,并立即使用 rm 命令清理服务器上的临时文件。
显著优点
1. 平台覆盖极广:依托 yt-dlp 的强大能力,支持绝大多数主流视频平台,无需为不同站点寻找专用工具。
2. 画质灵活可选:提供从低清到 8K 的完整分辨率选择,满足不同场景需求。
3. 自动化程度高:自动合并音视频流、自动清理临时文件,减少用户和 Agent 的操作负担。
4. 零配置依赖:仅需系统预装 yt-dlp 和 ffmpeg 即可运行,无需 API Key 或复杂认证。
潜在缺点与局限性
1. 安全风险突出:用户输入的 URL 直接传递给 subprocess,存在命令注入风险;缺乏 URL 白名单验证,可能访问内部网络或恶意站点。
2. 依赖外部二进制:核心功能依赖 yt-dlp 和 ffmpeg,若未安装或版本不兼容则完全无法使用。
3. 无内容过滤机制:无法自动识别或阻止下载版权受限、恶意软件伪装或不当内容。
4. 单文件处理:未支持批量下载或播放列表下载(--no-playlist 强制启用),效率受限。
5. 存储与性能瓶颈:大文件(4K/8K)下载可能占用大量磁盘空间和带宽,虽承诺自动清理,但异常中断时可能残留文件。
适合的目标群体
- 内容创作者:需要快速获取参考素材或备份自己发布的内容
- 研究人员:收集社交媒体视频数据进行学术分析
- 普通用户:希望离线观看或保存特定平台视频
- 运营人员:下载竞品视频进行内容分析
使用风险
- 安全漏洞:URL 注入可能导致意外命令执行或信息泄露
- 法律合规:下载受版权保护内容可能违反平台服务条款或当地法律
- 依赖维护:yt-dlp 需持续更新以应对平台反爬机制变化
- 资源消耗:高分辨率视频下载可能触发平台限流或导致本地存储不足