Media Downloader

核心用法

dl 技能是一个智能化的媒体下载工具，支持从主流视频平台（YouTube、Bilibili、X/Twitter 等）提取音视频内容。用户仅需提供 URL 或自然语言指令（如 "Download this video"），系统即可自动识别内容类型并执行下载。

执行流程：
1. 用户触发 /dl <url> 或自然语言指令
2. 系统自动调用 uv run --script dl.py 执行下载
3. 脚本智能识别：视频（保存为 MP4 到 ~/Movies/ 或 ~/Videos/）或音乐（保存为 M4A 到 ~/Music/）
4. 支持播放列表批量下载，自动创建子目录归档
5. Telegram 场景下音频文件可直接推送给用户

显著优点

• 零配置上手：无需手动指定格式或路径，自动分类存储
• 播放列表原生支持：批量下载自动归集，避免文件散乱
• 家庭影院就绪：默认路径兼容 Universal Media Server、Jellyfin、miniDLNA 等 DLNA 服务器，下载完成后电视端即时可见
• 跨平台：支持 macOS、Linux、Windows
• 依赖精简：仅需 uv 单二进制工具

潜在局限

• 法律与平台政策风险：下载受版权保护的内容可能违反 YouTube/Bilibili 等服务条款及当地法律
• 无内置元数据刮削：依赖外部媒体服务器进行海报、字幕匹配
• 单线程下载：未提及多线程加速，大型播放列表耗时较长
• Telegram 专属功能：文件直发功能仅限 Telegram 平台

适合人群

• 自建 NAS/媒体服务器的家庭用户
• 需要离线归档教学视频、播客内容的创作者
• 追求 "下载即播放" 极简工作流的效率用户

常规风险

| 类型 | 说明 |

|------|------|

| 版权合规 | 用户需自行确保下载内容符合 DMCA 及本地法规 |

| 账号安全 | 高频下载可能触发平台风控，建议避免登录态批量抓取 |

| 文件安全 | 依赖外部 Python 脚本执行，建议审查 `dl.py` 源码 |

| 存储管理 | 自动保存至用户目录，长期运行需关注磁盘空间 |

核心用法

dl 是一款轻量级媒体下载工具，用户通过触发指令 /dl <url> 或自然语言指令（如 "Download this video"）即可调用。Skill 自动识别视频/音乐内容，智能选择最佳格式下载：视频保存为 MP4 至 ~/Movies/ 或 ~/Videos/，音乐保存为 M4A 至 ~/Music/。支持播放列表批量下载，自动创建子目录组织文件。

技术实现上，底层依赖业界知名的 yt-dlp 开源库，该库是 youtube-dl 的活跃分支，具备强大的平台兼容性和持续更新能力。代码结构清晰，约 284 行 Python 脚本，无危险函数调用，文件操作严格限定在用户主目录的标准媒体路径内。

显著优点

• 零配置开箱即用：自动检测内容类型，无需手动选择格式或路径
• 生态集成友好：专为本地媒体服务器（Universal Media Server、Jellyfin、miniDLNA）设计，下载后即时可在 TV/手机端播放
• 平台覆盖广：支持 YouTube、Bilibili、X/Twitter、SoundCloud、Spotify 等主流平台
• Telegram 增强体验：音频文件自动通过消息工具发送，无需用户手动查找

潜在缺点与局限性

• 来源可信度受限：维护者为个人开发者（guoqiao），非知名组织或大型开源基金会，归类为 T3 来源
• 网络依赖性强：需访问外部视频平台，在受限网络环境可能需配置代理
• 无图形界面：纯命令行/Agent 交互，不适合偏好 GUI 的用户
• 版权合规责任：用户需自行确保下载内容符合当地版权法规

适合人群

• 家庭影音爱好者：搭建本地媒体库，在电视/平板离线观看
• 内容创作者：快速获取参考素材（需遵守平台 ToS）
• 网络受限地区用户：提前下载内容后本地播放
• 技术型用户：熟悉命令行和环境变量配置

常规风险

1. 版权风险：下载受版权保护内容可能违反平台服务条款或当地法律
2. 平台反爬：YouTube 等平台可能限制频繁下载行为
3. 依赖更新：视频平台页面结构变化时，需及时更新 yt-dlp 版本
4. 存储管理：自动下载可能快速占用磁盘空间，需定期清理