核心用法
dl 是一款轻量级媒体下载技能,本质为 yt-dlp 的 Python 包装脚本。用户通过 /dl <url> 或直接发送下载请求触发,系统自动识别 URL 类型并执行下载:
- 视频识别:YouTube 标准视频链接自动下载为 MP4,保存至
~/Movies或~/Videos - 音乐识别:YouTube Music 链接自动下载为 M4A,保存至
~/Music - 播放列表:自动创建子文件夹,按播放列表名称归档
- 执行方式:通过
uv run --script dl.py $url调用,依赖预装uv工具
显著优点
1. 智能分类:无需手动指定格式,自动区分视频/音频及单曲/列表
2. 生态整合:文档明确推荐配合 Universal Media Server、Jellyfin 等 DLNA 服务器,下载后即时局域网共享
3. 跨平台:支持 macOS、Linux、Windows
4. 零配置执行:单脚本 UV 运行,无复杂依赖管理
潜在局限与风险
- 版权合规:下载受版权保护内容可能违反平台 ToS 及当地法律,yt-dlp 本身处于法律灰色地带
- 源站依赖:YouTube/Bilibili 等频繁更新反爬机制,可能导致下载失败
- 无内置转码:仅提供原格式下载,不处理编码兼容性问题
- 路径硬编码:强制使用
~/Movies/~/Music,不支持自定义存储路径 - T3 来源:作者个人维护脚本,非官方/企业级项目,长期维护存在不确定性
适合人群
个人媒体库建设者、局域网家庭影音用户、需要离线备份公开/自有内容的创作者。
常规风险
S+ 级(见安全评估)。