video-dl

核心用法

Video Downloader 是一款基于 yt-dlp 构建的视频下载技能，支持从 YouTube、Reddit、Twitter/X、TikTok、Instagram、Vimeo、Facebook、Twitch 等 1000 多个网站下载视频内容。用户只需提供视频链接，即可通过简单的命令行调用完成下载。基础用法为 {baseDir}/scripts/download.sh "URL"，默认以最佳质量下载到 ~/Downloads/videos// 目录。技能还提供丰富的可选参数，包括 --audio-only 提取音频为 MP3、、--720p//--1080p 限制分辨率、、--output 指定输出目录、、--filename` 自定义文件名等。

针对 Telegram 等平台的 16MB 文件限制，技能特别设计了压缩发送功能，通过 compress-and-send.sh 脚本在后台处理长视频，避免聊天窗口被进度信息刷屏。高级用户还可直接调用 ~/.local/bin/yt-dlp 使用 yt-dlp 的全部功能。

显著优点

1. 覆盖范围极广：依托 yt-dlp 的强大生态，支持 1000+ 视频网站，几乎涵盖所有主流平台
2. 功能灵活多样：不仅支持视频下载，还能提取音频、限制分辨率、自定义输出路径，满足多种场景需求
3. 自动化处理完善：Reddit 视频的音视频自动合并、Telegram 压缩的异步后台处理等细节设计提升用户体验
4. 代码质量可靠：脚本采用 Bash 数组传递参数，有效防止命令注入；使用 set -e 确保错误及时暴露
5. 隐私保护良好：纯本地操作，无数据上传行为，下载内容仅存储在用户指定目录

潜在缺点与局限性

1. 依赖外部工具：必须预先安装 yt-dlp 和 ffmpeg，且需用户自行确保来源可信、版本更新
2. URL 安全验证不足：未对输入链接进行恶意网站过滤或格式校验，存在潜在安全风险
3. 年龄限制内容支持有限：YouTube 年龄限制视频需要 cookies 配置，当前未提供该功能
4. 长视频处理耗时：大文件下载和压缩需要较长时间，虽有后台处理方案但用户体验仍受影响
5. 版权合规责任在用户：技能本身不提供版权检查，批量下载或商业使用可能违反平台服务条款

适合的目标群体

• 内容创作者：需要收集参考素材、保存灵感视频的设计师、视频博主、自媒体运营者
• 研究人员与教育工作者：下载教学视频、学术讲座等用于离线学习或课堂展示
• 普通用户：希望在没有网络的环境下观看喜欢的视频内容
• Telegram 社群运营者：需要分享视频内容但受限于平台文件大小限制的用户

使用风险

1. 依赖项安全风险：yt-dlp 和 ffmpeg 若从非官方渠道安装，可能引入恶意代码
2. URL 注入风险：尽管脚本本身做了参数防护，但用户若输入恶意构造的链接仍可能导致非预期行为
3. 存储空间压力：高清视频文件体积庞大，可能快速耗尽磁盘空间
4. 法律合规风险：下载受版权保护的内容用于商业用途或公开传播可能面临法律问题
5. 元数据泄露：下载的视频文件可能包含地理位置、设备信息等敏感元数据