Media Downloader

核心用法

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 以维持兼容性。

📥 智能媒体下载工具

这是一款基于 yt-dlp 引擎开发的高效本地媒体下载工具，旨在帮助用户从各大视频/音频平台（如 YouTube、Bilibili、X/Twitter 等）一键下载媒体内容，并智能分类保存到本地指定文件夹中。

🧠 核心用法

用户只需提供目标网页的 URL（或直接触发 /dl <url> 指令），系统便会自动识别平台并调用 yt-dlp 库发起下载。脚本会根据内容类型（视频 or 音频）将文件存入 ~/Movies、~/Videos 或 ~/Music 文件夹；如果是播放列表，还会自动创建同名子文件夹进行归集。整套流程完全本地化运行，不依赖第三方云存储，保护用户隐私。

该技能最强大的场景是与 家庭媒体服务器（如 Jellyfin、Universal Media Server、miniDLNA） 配合使用。只需将上述文件夹设为共享，下载后的媒体便会立刻出现在电视、手机、平板等支持 DNLA/UPnP 协议的设备上，实现“下载即点播”的无缝体验。

✅ 显著优点

1. 全平台支持：依托 yt-dlp 的强大解析能力，覆盖 YouTube、Bilibili、Twitter/X、TikTok、Instagram 等上千个网站。
2. 智能分类：自动判断视频与音频并存入对应系统标准文件夹，无需手动整理。
3. 家庭影院无缝衔接：与媒体服务器深度适配，下载内容即时可播。
4. 代码精简透明：核心脚本仅约 375 行 Python 代码，用户可轻松审查，无混淆、无后门。
5. 依赖安全可信：全部依赖（yt-dlp、loguru、python-slugify）均为知名开源库，拥有庞大的社区声望且无已知 CVE 漏洞。
6. 环境灵活：通过 uv 脚本运行，Python 依赖自动管理，无需全局安装污染系统。

⚠️ 潜在缺点与局限性

1. 依赖网络环境：下载速度受限于目标平台的反爬策略和用户本地网络，部分平台可能需要额外配置代理。
2. Cookie 依赖敏感：为了使下载更稳定，脚本会自动检测 Cookie 文件。虽然属功能合理性范畴，但自动读取行为增加了用户凭据被访问的风险边界。
3. 缺乏版本锁定：依赖包 yt-dlp 未固定具体版本，理论上存在自动升级后引入未知问题的可能。
4. 无 GUI 界面：所有操作依赖命令行或 Agent 调用，对技术小白不友好。
5. 社区支持有限：作为个人开发者项目，Bug 修复和功能更新完全依赖维护者个人精力，没有商业支持保障。

👥 适合的目标群体

• 家庭媒体中心党：拥有 NAS 或常开电脑 + 电视的组合，希望通过下载替代流媒体订阅、构建私有影音库的用户。
• 内容存档/研究者：需要长期存档网页视频、音频素材的研究人员、记者、教育工作者。
• 带宽受限地区用户：可先下载到本地再利用局域网播放，避免多人重复在线观看消耗流量。
• 技术爱好者：不排斥命令行操作、愿意通过查看源代码保障安全性的进阶用户。

⚡ 使用风险提示

• 命令注入风险（低危）：SKILL.md 指示 Agent 在 Shell 中执行 uv run ... "<url>"，如果 Agent 未正确转义 URL 中的特殊字符（如 ;、|、$()），恶意构造的链接可能导致意外命令执行。建议 Agent 在执行前做 URL 格式校验。
• Cookie 凭据暴露（低危）：脚本会按优先级检测多个路径下的 Cookie 文件并用于平台认证，若 Cookie 文件被盗或误分享，可能造成部分平台账号的安全隐患。建议用户通过 DL_COOKIES_FILE 环境变量显式指定文件路径。
• 供应链风险（信息级）：作者为社区个人开发者，代码发布在 clawhub.ai 平台，缺少 GitHub 等开源社区的 Star/Fork 验证和组织背书。这一因素限制了其最高安全等级为 A 级（T3 来源）。
• 法律合规风险：下载受版权保护的内容可能会在部分国家/地区面临法律纠纷，用户需遵守当地版权法及目标平台的服务条款。

---
本技能安全评级为 A 级（标准安全级），所有核心安全检测项均已通过。建议结合 CocoLoop Safe 安全客户端使用，以进一步降级运行时风险。