媒体下载器

智能地从 URL（YouTube、Bilibili、X 等）下载媒体内容（视频/音乐），并保存至本地对应文件夹。

• 视频：保存至 ~/Movies/ 或 ~/Videos/。
• 音乐：保存至 ~/Music/。
• 播放列表：将各项内容保存至子目录中（例如：~/Music//）。

专为配合本地媒体服务器（如 Universal Media Server、Jellyfin）使用而设计，便于在电视或其它设备上即时播放。

Agent 执行流程

当用户提供 URL 或请求下载媒体时，你必须严格按以下顺序执行：

1. 确认响应：

   • 立即向用户回复：“Downloading with dl skill...”

2. 执行下载：

   • 运行脚本：

     uv run --script ${baseDir}/dl.py ""
     

3. 捕获输出路径：

   • 读取脚本输出；脚本最终会在 stdout 打印一个路径，该路径指向单个文件，或包含播放列表全部条目的文件夹。

4. 上传（仅限 Telegram）：

   • 若用户当前使用 Telegram（通过上下文或会话判断），且待发送文件为音频格式（mp3/m4a）：
   • 使用 message 工具将文件发送给用户：

     {
       "action": "send",
       "filePath": "",
       "caption": "Here is your music."
     }
     

使用方法

以 uv 脚本方式运行 dl.py：

# 保存至默认目录：~/Music、~/Movies 或 ~/Videos
uv run --script ${baseDir}/dl.py 

# 指定自定义输出目录
uv run --script ${baseDir}/dl.py  -o 

脚本将打印输出路径，该路径可能是一个文件，也可能是一个文件夹。

可选提供 cookies 文件以提升 yt-dlp 的可靠性；脚本将按以下顺序检测并使用首个存在的 cookies 文件：

• ${baseDir}/.cookies.txt
• $DL_COOKIES_FILE
• $COOKIES_FILE
• ~/.cookies.txt

用户端配置

若在同一台机器上部署媒体服务器，以在局域网内共享已下载的媒体内容，本技能将更加强大实用：

1. 安装 DLNA/UPnP 媒体服务器（例如 Universal Media Server、miniDLNA、Jellyfin）。
2. 共享 ~/Music 和 ~/Movies（或 ~/Videos）文件夹。
3. 已下载的媒体内容将自动出现在支持 DLNA/UPnP 的电视应用中（例如 VLC）。

参见 macOS 上部署 Universal Media Server 的示例脚本。