Media Downloader

核心用法

dl 是一款轻量级媒体下载工具，通过封装 yt-dlp 提供一键式下载体验。用户只需执行 /dl <url> 即可触发 Python 脚本，自动识别 URL 来源（YouTube、Bilibili、X 等）及内容类型（视频/音乐、单曲/播放列表），并智能路由到对应存储路径：视频保存至 ~/Movies/，音乐保存至 ~/Music/，播放列表自动创建子文件夹。

显著优点

• 零配置即用：基于 uv 的 Python 脚本运行，无需手动安装 yt-dlp
• 智能分类：自动区分视频/音乐类型，遵循操作系统标准媒体目录结构
• 播放列表原生支持：批量下载时自动创建有序文件夹结构
• TV 直连体验：通过集成 DLNA/UPnP 媒体服务器（如 Universal Media Server、Jellyfin），下载内容可即时在局域网内电视播放

潜在局限

• 依赖 yt-dlp 的可用性，受平台反爬虫策略影响
• 需额外配置媒体服务器才能发挥核心差异化价值
• 暂不支持下载后自动转码或格式统一
• 无内置代理配置，部分地区访问受限

适合人群

家庭影音爱好者、NAS/自托管用户、希望通过 TV 直接观看网络内容的轻度技术用户。

常规风险

• 下载版权内容可能涉及法律风险
• yt-dlp 执行需访问外部网络，存在被来源网站限制或封禁 IP 的可能
• 媒体服务器开放 LAN 端口需注意内网安全边界

核心功能

dl 是一款围绕 yt-dlp 构建的智能媒体下载工具，核心定位是「下载+家庭媒体中心整合」。用户只需提供 URL（YouTube、Bilibili、YouTube Music 等），工具即可自动识别视频/音乐类型以及单曲/播放列表，并按规范目录结构保存至 ~/Movies 或 ~/Music。配合 DLNA/UPnP 媒体服务器（如 Universal Media Server、Jellyfin）可实现「下载→自动共享→电视播放」的完整闭环。

显著优点

1. 极简交互：单命令 /dl <url> 或自然语言触发，无需记忆 yt-dlp 的复杂参数
2. 智能分类：自动识别媒体类型（Video/Music）和结构（Single/Playlist），路径规则清晰
3. 生态整合：设计上预留了与家庭 NAS/媒体服务器的对接能力，区别于纯下载工具
4. 跨平台：基于 Python uv 脚本，支持 macOS、Linux、Windows

潜在局限

• 依赖单一：核心功能完全依赖 yt-dlp，若上游接口变更或被封禁，功能可能受影响
• 网络依赖重：需稳定访问 YouTube/Bilibili 等平台，部分区域需配合代理
• 无内置播放器：仅负责下载和整理，播放依赖外部 DLNA 服务器或本地播放器
• URL 验证宽松：当前未限制输入域名，存在 SSRF 或恶意 URL 风险（建议用户自行确保来源可信）

适合人群

• 家庭媒体中心用户（已有 NAS 或运行 Jellyfin/Plex）
• 需要批量归档 YouTube 频道/播放列表的内容收藏者
• 希望简化 yt-dlp 使用、不愿记忆复杂命令的普通用户

常规风险提示

1. 版权合规：下载受版权保护的内容需遵守当地法规，工具本身不提供内容筛选
2. 平台 ToS：YouTube/Bilibili 等服务条款通常禁止未经授权的下载
3. 路径安全：虽可通过环境变量自定义下载目录，但建议保持默认路径，避免误写系统目录
4. 依赖更新：建议定期更新 yt-dlp 以修复潜在 CVE，关注上游安全公告