核心用法
dl 技能是一个智能化的媒体下载工具，支持从主流视频平台（YouTube、Bilibili、X/Twitter 等）提取音视频内容。用户仅需提供 URL 或自然语言指令（如 "Download this video"），系统即可自动识别内容类型并执行下载。
执行流程：
1. 用户触发 /dl <url> 或自然语言指令
2. 系统自动调用 uv run --script dl.py 执行下载
3. 脚本智能识别：视频（保存为 MP4 到 ~/Movies/ 或 ~/Videos/）或音乐（保存为 M4A 到 ~/Music/）
4. 支持播放列表批量下载，自动创建子目录归档
5. Telegram 场景下音频文件可直接推送给用户
显著优点
- 零配置上手：无需手动指定格式或路径，自动分类存储
- 播放列表原生支持：批量下载自动归集，避免文件散乱
- 家庭影院就绪：默认路径兼容 Universal Media Server、Jellyfin、miniDLNA 等 DLNA 服务器，下载完成后电视端即时可见
- 跨平台：支持 macOS、Linux、Windows
- 依赖精简：仅需
uv单二进制工具
潜在局限
- 法律与平台政策风险：下载受版权保护的内容可能违反 YouTube/Bilibili 等服务条款及当地法律
- 无内置元数据刮削：依赖外部媒体服务器进行海报、字幕匹配
- 单线程下载：未提及多线程加速，大型播放列表耗时较长
- Telegram 专属功能：文件直发功能仅限 Telegram 平台
适合人群
- 自建 NAS/媒体服务器的家庭用户
- 需要离线归档教学视频、播客内容的创作者
- 追求 "下载即播放" 极简工作流的效率用户
常规风险
| 类型 | 说明 |
|------|------|
| 版权合规 | 用户需自行确保下载内容符合 DMCA 及本地法规 |
| 账号安全 | 高频下载可能触发平台风控，建议避免登录态批量抓取 |
| 文件安全 | 依赖外部 Python 脚本执行，建议审查 `dl.py` 源码 |
| 存储管理 | 自动保存至用户目录，长期运行需关注磁盘空间 |