核心用法
dl 是一个媒体下载技能，支持从 YouTube、Bilibili、X（Twitter）等主流平台自动识别并下载视频或音乐。用户只需提供 URL 或自然语言指令（如 "Download this video"），系统即可调用脚本完成下载。
智能分类机制：
- 视频：自动保存为
mp4格式，存放于~/Movies/或~/Videos/目录 - 音乐：自动保存为
m4a格式，存放于~/Music/目录 - 播放列表：自动创建子目录（如
~/Music/<playlist_name>/）分类存放
家庭媒体生态集成：
设计目标是与本地 DLNA/UPnP 媒体服务器（Universal Media Server、Jellyfin、miniDLNA）无缝对接。下载完成后，文件即刻出现在电视、手机等设备的媒体库中，实现"下载即播放"的闭环体验。
显著优点
1. 零配置开箱即用：脚本自动检测内容类型（视频/音乐）和结构（单文件/播放列表），无需用户手动指定参数
2. 跨平台兼容：支持 macOS、Linux、Windows 三大操作系统
3. Telegram 深度集成：音频文件自动通过消息工具回传，移动端体验流畅
4. 生态扩展性：基于 uv 现代 Python 包管理器，依赖管理简洁可靠
潜在局限与风险
版权合规风险：下载受版权保护的内容（音乐 MV、付费课程、独家节目）可能违反平台 ToS 及当地法律。工具本身中立，但用户需自行承担合规责任。
平台对抗性：YouTube 等平台持续更新反爬机制，脚本可能因平台变更而临时失效，需维护者持续跟进。
路径硬编码限制：输出目录固定为 ~/Music 和 ~/Movies，不支持自定义路径，多用户或特殊目录结构场景下灵活性不足。
网络依赖性：无离线功能，完全依赖外部网络连接和平台可用性。
适合人群
- 自建家庭影音 NAS/媒体服务器的数码爱好者
- 需要离线备份公开教育资源、创作者自有内容的研究者
- Telegram 重度用户，追求移动端即时获取音频内容
- 反感流媒体平台算法推荐、希望建立本地内容库的长期主义者
常规风险提示
- 定期核查本地法律对"个人备份"的界定边界
- 敏感内容下载建议配合 VPN 使用
- 播放列表批量下载注意存储空间预估