核心用法
dl skill 是一款智能媒体下载工具,基于 yt-dlp 实现,支持从 YouTube、Bilibili、X/Twitter 等主流平台下载视频与音频内容。用户通过 /dl <url> 或自然语言指令触发,工具会自动识别媒体类型并分类存储——视频存入 ~/Movies/ 或 ~/Videos/,音乐存入 ~/Music/,播放列表则创建子目录保存。
执行流程标准化:Agent 首先确认请求,随后通过 uv run --script 调用本地 Python 脚本完成下载,捕获输出路径后可选择性地向 Telegram 用户直接发送音频文件。工具支持自定义输出目录,并可通过多种方式配置 cookies 文件以提升下载成功率。
显著优点
- 多平台兼容:覆盖 YouTube、Bilibili、X 等热门站点,单工具解决多元需求
- 智能分类:自动识别音视频类型并归档至标准系统目录,无需手动整理
- 播放列表支持:完整下载整个列表并按名称建立子目录,适合批量归档
- 媒体服务器集成:设计上适配 Universal Media Server、Jellyfin 等 DLNA/UPnP 服务,下载内容可即时在电视、手机等设备播放
- Telegram 原生支持:音频文件可直接通过消息工具发送,移动端体验流畅
潜在缺点与局限性
- 依赖外部工具:需要预装
uv和 Python 环境,对非技术用户有门槛 - 版权风险:下载受版权保护的内容可能违反平台 ToS 及当地法律
- 平台对抗:视频网站持续更新反爬机制,依赖 yt-dlp 的更新频率
- 无内置播放功能:需额外配置媒体服务器才能实现跨设备播放
- cookies 配置繁琐:登录态内容需手动准备 cookies 文件
适合人群
- 自建家庭媒体库的技术用户
- 需要离线备份公开教学/演讲内容的用户
- 拥有 NAS 或常驻服务器、追求本地可控媒体管理的用户
- Telegram 重度用户,希望快速获取音频内容
常规风险
| 风险类型 | 说明 |
|---------|------|
| 版权合规 | 下载版权内容可能面临 DMCA 通知或账号封禁 |
| 账号安全 | cookies 文件若泄露可导致平台账号被盗用 |
| 恶意 payload | 虽基于知名开源工具 yt-dlp,但需警惕非官方渠道的技能篡改 |
| 存储占用 | 高清视频易快速占满本地磁盘 |
建议仅用于下载创作者明确允许存档的内容,并定期更新 yt-dlp 以维持兼容性。