universal-video-downloader

核心用法

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 需持续更新以应对平台反爬机制变化
• 资源消耗：高分辨率视频下载可能触发平台限流或导致本地存储不足

核心用法：一站式下载任意平台视频

Universal Video Downloader 的核心功能是帮助用户从 YouTube、Instagram、TikTok、Twitter/X 等上千个视频平台下载视频。它基于业界广泛使用的开源工具 yt-dlp，首先通过 info 命令智能抓取视频的所有可用画质和格式信息供用户选择，然后根据用户选定的分辨率精准下载，并利用 ffmpeg 自动合并最高画质的视频流和音频流为一个标准的 MP4 文件。完成任务后，Agent 会立即从服务器上删除原始文件，实现“用完即焚”的数据最小化处理流程。

显著优点：极简操作与可靠架构

这款技能的操作逻辑经过精心简化，用户只需分享一个视频链接，全程由 AI 代理完成信息抓取、画质引导、下载和交付，极大降低了技术门槛。其底层代码设计遵循安全最佳实践：采用列表方式构建 subprocess 调用，从根源上规避了 shell 注入风险；没有引入任何第三方 Python 依赖包，完全依赖系统级的 yt-dlp 和 ffmpeg，极大压缩了供应链攻击面；同时，代码中没有硬编码的密钥、令牌或可疑网络端点，做到了行为透明与功能声明的一致。

潜在缺点与局限性

然而，该技能并非完美无缺。最引人关注的风险在于其缺乏输入验证。用户提供的视频 URL 会被直接传递给 yt-dlp 处理，并未进行格式、协议白名单或长度的校验。虽然列表式的 subprocess 调用本身可以防止传统的命令注入，但一个恶意精心构造的极长或畸形 URL 仍有可能触发 yt-dlp 解析器自身的潜在漏洞。此外，该技能对 yt-dlp 和 ffmpeg 工具依赖严重，但代码并未检查这些工具的可用性和版本，如果运行环境中的工具版本过旧或缺失，将导致功能静默失败。

适合的目标群体

这款技能非常适合普通互联网用户、社交媒体内容管理者、视频创作者以及需要频繁从各类平台保存素材的研究人员。对于那些不想在电脑上安装复杂命令行工具或受困于各类在线下载服务广告和跳转的用户，此技能提供了一个极简的替代方案。同时，注重隐私、希望视频文件不在本地长久驻留的用户也会青睐其自动清理机制。

使用风险与注意事项

从常规风险角度看，用户需要注意以下几点：第一，下载功能依赖于 yt-dlp 对第三方平台的逆向工程，如果目标平台（如 YouTube、Instagram）更新了反爬或鉴权机制，技能可能会暂时失效，这是一种固有的功能性风险。第二，其来源可信度（T3）来自个人开发者社区，虽然代码公开可审计，但对于企业环境下有严格安全策略的场景，需进行内部代码审查。第三，自动删除机制虽然保护隐私，但也意味着下载过程必须一次性成功，如果交付中断，用户可能无法再次获取文件，缺少重试和本地缓存机制。总的来说，对于日常的非商业视频采集需求，这是一款安全可靠且高效的工具。