Media Downloader

核心用法

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+ 级（见安全评估）。

核心用法

/dl <url> 即可一键下载 YouTube、Bilibili、X 等平台内容。系统自动解析 URL 特征：普通视频存为 MP4 至 ~/Movies，音乐存为 M4A 至 ~/Music，歌单自动创建子文件夹。采用 uv 运行环境，零依赖安装。

显著优点

1. 智能分类：无需手动指定格式，自动区分视频/音频、单曲/歌单，按平台类型归档到标准媒体目录
2. 家庭媒体中心：配合 Universal Media Server 等 DLNA 服务器，下载完成后即刻在 TV、手机等设备播放
3. Telegram 集成：音乐文件自动推送至聊天，省去手动传输步骤
4. 代码简洁：338 行 Python，无冗余依赖，审计友好

潜在局限

• 依赖外部平台稳定性，API 变更可能导致功能中断
• 个人开发者维护（T3），长期更新存在不确定性
• 需自行确保下载行为符合目标平台服务条款及当地法规
• 无内置代理配置，网络受限环境需额外设置

适合人群

• 需要离线备份个人收藏的音乐/视频爱好者
• 已部署家庭 NAS 或 DLNA 服务器的智能家居用户
• 追求命令行效率、厌烦 GUI 操作的技术用户
• 希望通过 Telegram Bot 远程触发下载的进阶玩家

常规风险

• 合规风险：YouTube/Bilibili 等平台通常禁止未经授权下载，用户需自行承担法律责任
• 网络依赖：目标平台连接失败时功能不可用
• 版本漂移：yt-dlp 未锁定版本，上游更新可能引入破坏性变更