Media Downloader

核心功能

dl 是一款智能媒体下载工具，专注于从主流视频平台（YouTube、Bilibili、X/Twitter 等）提取音视频内容。采用自动检测机制，无需用户手动指定格式：

• 视频：自动保存为 mp4 至 ~/Movies/ 或 ~/Videos/
• 音乐：自动保存为 m4a 至 ~/Music/
• 播放列表：智能创建子目录，按原列表名称归档

显著优点

| 特性 | 说明 |

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

| 零配置启动 | 基于 `uv` 单脚本运行，无需复杂依赖管理 |

| 智能路由 | 自动识别单文件/播放列表、视频/音频类型 |

| 家庭媒体生态 | 原生适配 Universal Media Server、Jellyfin 等 DLNA 服务器，下载即共享 |

| 即时交付 | Telegram 场景下自动推送音频文件给用户 |

| 跨平台 | 支持 macOS、Linux、Windows |

潜在局限

1. 法律合规风险：下载受版权保护内容可能违反平台 ToS 及当地法规
2. 源站依赖：YouTube/Bilibili 等更新反爬策略时可能临时失效
3. 无代理配置：需用户自行确保网络环境可访问目标站点
4. 元数据缺失：不自动抓取封面、歌词等附加信息

适合人群

• 自建 NAS/家庭媒体服务器的用户
• 需要离线备份公开/授权内容的创作者
• 跨平台多端（TV/手机/电脑）媒体消费者

常规风险提醒

⚠️ 本工具仅应用于合法拥有版权或公开授权的内容。下载行为需遵守《中华人民共和国著作权法》及源站服务条款。建议配合本地媒体服务器使用以获得最佳体验，但公开分享下载内容可能构成侵权。

核心用法

/dl <url> 或自然语言触发「下载这个视频/音乐」，支持 YouTube、Bilibili、X（Twitter）、Instagram 等主流平台。Skill 自动识别内容类型：视频保存为 MP4 至 ~/Movies/ 或 ~/Videos/，音乐保存为 M4A 至 ~/Music/，播放列表则创建子目录归类。技术底层基于 yt-dlp，网络请求严格限制于目标视频平台，无数据外传风险。

显著优点

• 零配置开箱即用：自动检测平台、格式、单文件/播放列表，无需手动选择参数
• 媒体服务器原生适配：默认路径设计兼容 Universal Media Server、Jellyfin、miniDLNA 等 DLNA/UPnP 服务器，下载完成后电视/手机即刻可见
• 智能 Telegram 集成：音频文件自动推送至对话，省去手动传输步骤
• 安全沙盒设计：文件写入严格限定于用户媒体目录，无系统级权限越界

潜在局限

• 依赖 yt-dlp 生态：视频平台反爬策略变动时，需等待上游库更新
• 单文件大小上限：默认视频 2GB/音频 30MB，超大内容需手动修改源码常量
• 无内置代理配置：网络受限环境需系统级代理支持
• 版权合规责任：用户需自行确保下载内容符合当地版权法规

适合人群

• 本地媒体库爱好者（Jellyfin/Plex/UMS 用户）
• 需要离线备份公开教学/知识内容的效率用户
• 多设备（TV/手机/电脑）无缝播放需求的跨平台用户

常规风险

1. 版权风险：下载受版权保护内容可能违反平台 ToS 及当地法律
2. 存储覆盖：同名文件可能覆盖历史下载，建议定期整理
3. yt-dlp 时效性：平台接口变更会导致下载失败，需保持依赖更新
4. 网络可追溯：下载行为对视频平台可见，敏感内容建议使用隐私保护工具