Media Downloader

核心用法

dl 是一款本地化媒体下载工具，通过 Python 脚本调用 yt-dlp 等底层引擎，支持从 YouTube、Bilibili、X（Twitter）等主流平台下载视频或音频。用户可通过自然语言指令（如"Download this video"）或命令行触发，URL 自动识别媒体类型：视频保存为 MP4 至 ~/Movies/ 或 ~/Videos/，音频保存为 M4A 至 ~/Music/，播放列表则创建子目录归档。

显著优点

• 零配置开箱即用：依赖 uv 运行时自动管理，无需手动安装 Python 包
• 智能分类归档：根据媒体类型自动选择存储路径，播放列表保持结构完整
• 家庭媒体生态集成：原生设计配合 Universal Media Server、Jellyfin 等 DLNA 服务器，下载内容即时同步至电视、手机等设备
• Telegram 增强体验：音频文件支持直接回传至聊天窗口，省去手动查找步骤

潜在局限与风险

• 版权合规依赖用户自律：工具本身不验证下载内容的版权状态，需用户自行确保合法使用
• 平台反爬对抗：YouTube 等站点频繁更新反爬策略，可能导致间歇性下载失败，需跟进 yt-dlp 更新
• 无内置代理/加速：大陆用户访问 YouTube 需自行配置网络环境，工具层不提供绕过方案
• 单线程设计：未提及多路下载或批量队列管理，大规模归档效率受限

适合人群

• 自建 NAS/家庭媒体服务器的影音爱好者
• 需要离线备份教学视频、播客内容的重度学习者
• 追求"下载-电视播放"无缝体验的非流媒体依赖用户

常规风险提示

• 下载受版权保护内容可能违反服务条款及当地法律
• 第三方脚本执行需信任作者（guoqiao）及 uv 供应链安全
• 建议定期检查 dl.py 源码变更，防止恶意代码注入

核心功能

dl 是一款专注于媒体下载的实用型 Skill，基于成熟的 yt-dlp 开源库构建，支持从 YouTube、Bilibili、X（Twitter）、SoundCloud、Spotify 等平台下载视频与音频。核心流程简洁高效：识别 URL → 智能分类（视频存 ~/Movies/~/Videos，音乐存 ~/Music/）→ 执行下载 → 返回本地路径。对于播放列表，自动创建子目录归类保存。

显著优点

• 生态成熟：yt-dlp 作为 youtube-dl 的活跃分支，维护及时、站点支持广泛
• 智能归档：自动按媒体类型分流，支持自定义输出目录，适配媒体服务器（Jellyfin、Universal Media Server 等）的目录结构
• Telegram 集成：音频文件可直接通过消息工具发送，提升移动端体验
• 配置灵活：通过环境变量（DL_VIDEO_DIR、DL_MUSIC_DIR、COOKIE_FILE）实现无侵入式配置

局限性与风险

• 版权合规：工具本身合法，但用户需自行确保下载内容的授权状态，规避版权侵权风险
• 平台依赖：yt-dlp 需持续更新以应对各站点反爬策略变更，存在偶发性解析失败可能
• 网络环境：部分区域访问 YouTube/X 需配合代理，Skill 未内置代理配置引导
• 无格式选择：当前实现自动选择默认格式，不提供分辨率/码率手动指定

适用人群

• 本地媒体库建设者（搭配 NAS/媒体服务器使用）
• 需要离线备份收藏内容的用户
• Telegram 重度用户（可直接接收音频文件）
• 对命令行操作有基本熟悉的进阶用户

常规风险提示

1. 版权风险：仅下载自有版权或明确授权内容，禁止商业传播
2. 存储管理：播放列表批量下载可能占用大量磁盘空间，建议提前确认容量
3. 依赖更新：定期执行 uv run --script dl.py --upgrade yt-dlp 保持兼容性