核心功能与用法
video-dl 是一款基于成熟开源项目 yt-dlp 的视频下载技能，覆盖 YouTube、Reddit、Twitter/X、TikTok、Instagram、Vimeo、Facebook、Twitch 等 1000+ 视频网站。用户只需提供视频链接即可一键下载，默认输出至 ~/Downloads/videos/ 目录，文件名自动包含标题与视频 ID。
主要用法
- 快速下载：
{baseDir}/scripts/download.sh "URL"—— 自动选择最佳画质 - 画质限制：
--720p/--1080p参数控制最大分辨率 - 纯音频提取：
--audio-only直接输出 MP3 - 自定义输出：
--output指定目录，--filename自定义文件名（不含扩展名）
高级特性
- Reddit 视频自动合并音视频流
- 提供后台压缩脚本
compress-and-send.sh，解决 Telegram 16MB 文件限制 - 支持直接调用
yt-dlp二进制进行进阶配置
显著优点
1. 生态成熟：yt-dlp 是 youtube-dl 的活跃分支，社区维护积极，修复响应快
2. 站点覆盖广：官方维护列表超 1000 个站点，涵盖主流平台
3. 灵活输出：支持视频质量分级、纯音频、自定义命名等场景
4. 自动化处理：内置 Reddit 音视频合并、Telegram 压缩发送等实用工作流
局限性与风险提示
- 年龄限制内容：YouTube 年龄限制视频需额外配置 cookies，当前未预设
- 私有/删除内容：无法下载已删除或需要登录的私有视频
- 长视频耗时：大文件下载与压缩需要等待，后台任务需手动检查进度
- 平台政策风险：部分网站（尤其 YouTube）的 TOS 禁止未经授权下载，存在账号受限或法律合规风险
- Telegram 压缩：压缩比约 1:4，画质损失不可避免，适合预览而非归档
适合人群
- 内容创作者需要离线备份或素材采集
- 研究人员采集公开视频数据（需确认版权合规）
- 网络条件不稳定地区用户希望预下载观看
- 需要提取音频制作播客或笔记的用户
安全评估
工具本身仅执行下载操作，不主动上传用户数据；但需注意下载来源的版权合规性及大文件存储的磁盘占用风险。