Media Downloader

核心用法

dl skill 是一个专为媒体下载设计的智能工具，支持从主流视频平台（YouTube、Bilibili、X/Twitter 等）下载音视频内容。用户通过简单的触发指令 /dl <url> 或自然语言"下载这个视频/音乐"即可调用。

执行流程高度自动化：
1. 系统立即响应确认下载
2. 后台调用 uv run --script 执行 dl.py 脚本
3. 智能识别内容类型，视频保存为 mp4 至 ~/Movies/ 或 ~/Videos/，音乐保存为 m4a 至 ~/Music/
4. 支持完整播放列表下载，自动创建子目录归类
5. Telegram 场景下可自动推送音频文件给用户

进阶配置：技能原生设计用于与本地媒体服务器（Universal Media Server、Jellyfin、miniDLNA 等）协同，下载内容即刻通过 DLNA/UPnP 协议在局域网内共享，电视、手机可直接播放。

显著优点

• 极简交互：一句话或 /dl 指令即可完成复杂下载流程
• 智能分类：自动区分音视频类型并归档至系统标准目录
• 播放列表支持：批量下载时自动按专辑/列表名创建文件夹
• 媒体生态整合：与家庭 NAS/媒体服务器无缝衔接，下载即上屏
• 跨平台：支持 macOS、Linux、Windows 三大桌面系统

潜在局限

• 依赖 uv 运行时环境，需预先安装
• 未明确披露底层下载引擎（推测为 yt-dlp 或其衍生方案），对站点支持的稳定性取决于第三方库更新
• 无内置代理/VPN 配置说明，部分地区网络可能受限
• 安全报告中标注"未执行安全扫描"，代码审计状态未知
• Telegram 文件上传功能仅限音频，视频需用户自行访问服务器

适合人群

• 家庭媒体中心用户（配合 Jellyfin/UMS 使用）
• 需要离线备份教学视频、播客的内容消费者
• 习惯命令行高效操作的技术用户
• 多设备（TV/手机/电脑）本地流媒体需求者

常规风险

• 版权合规：下载受版权保护内容需遵守当地法律法规
• 网络来源：从第三方平台下载文件存在潜在的恶意内容注入风险
• 数据隐私：URL 信息可能被日志记录
• 存储管理：自动下载可能快速占用本地磁盘空间，无内置配额限制

核心用法

dl 是一个基于 yt-dlp 的媒体下载 Skill，通过自然语言指令或 /dl <url> 命令触发。支持从 YouTube、Bilibili、X 等平台下载视频（保存为 mp4 至 ~/Movies/ 或 ~/Videos/）和音乐（保存为 m4a 至 ~/Music/），播放列表内容会自动创建子目录存放。

显著优点

1. 无缝集成家庭媒体生态：设计初衷即配合 Universal Media Server、Jellyfin 等 DLNA/UPnP 媒体服务器，下载内容可立即在电视、手机等设备上播放
2. 智能分类存储：自动识别视频/音频类型并按标准目录结构存放，播放列表自动建文件夹管理
3. Telegram 专属优化：音频文件自动通过消息发送给用户，提升移动端体验
4. 依赖成熟可靠：核心使用 yt-dlp（yt-dlp 是 youtube-dl 的活跃维护分支，社区广泛使用）

潜在局限

• 来源可信度限制：T3 级个人开发者作品，虽当前代码安全，但长期维护稳定性需关注
• 功能边界明确：纯下载工具，不提供格式转换、元数据编辑、下载后处理等高级功能
• 平台依赖风险：依赖 yt-dlp 维护，若视频平台反爬升级可能影响可用性
• 无图形界面：纯命令行交互，对非技术用户有一定门槛

适合人群

• 已部署或计划部署家庭媒体服务器的用户
• 希望通过自然语言快速保存网络视频/音乐的用户
• Telegram 重度使用者（享受自动文件发送便利）
• 熟悉命令行、愿意接受 T3 来源工具的技术用户

常规风险

1. 版权问题：下载受版权保护的内容可能违反当地法律或平台 ToS，用户需自行承担责任
2. Cookie 安全：支持读取 Cookie 文件下载会员内容，需注意 Cookie 文件权限设置
3. URL 注入：虽代码对路径有严格限制，但建议避免粘贴来源不明的 URL
4. 依赖更新：yt-dlp 需要定期更新以应对平台变化，建议关注版本管理