媒体下载器

智能地从URL（YouTube、Bilibili、X等）下载媒体文件（视频/音乐）到合适的本地文件夹。

• 视频：保存至~/Movies/或~/Videos/。
• 音乐：保存至~/Music/。
• 播放列表：将项目保存至子目录（例如，~/Music/<播放列表名称>/）。

设计用于与本地媒体服务器（例如，Universal Media Server、Jellyfin）配合使用，以便在电视/设备上即时播放。

代理程序流程

当用户提供URL或要求下载媒体时，你必须严格按照以下顺序操作：

1. 确认：

   • 立即回复用户：“正在使用dl技能下载...”

2. 执行：

   • 运行脚本：

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

3. 捕获路径：

   • 读取脚本输出，最后会向标准输出打印一个路径，指向单个文件或包含播放列表项的文件夹。

4. 上传（仅限Telegram）：

   • 如果用户在Telegram上（检查上下文或会话）且文件是音频（mp3/m4a）：
   • 使用消息工具将文件发送给用户：

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

使用方法

运行dl.py作为一个uv脚本：

# save into default dirs ~/Music or ~/Movies or ~/Videos
uv run --script ${baseDir}/dl.py <url>

# specify your own output dir
uv run --script ${baseDir}/dl.py <url> -o <out_dir>

脚本将输出路径，可能是一个文件或一个文件夹。

可以提供一个可选的cookies文件，使yt-dlp更可靠，使用以下任一首先检测到的文件：

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

设置（用户）

如果你在同一台机器上设置一个媒体服务器，以便在局域网内分享下载的媒体内容，这项技能将变得更加有用：

1. 安装一个DLNA/UPnP媒体服务器（如Universal Media Server、miniDLNA、Jellyfin）。
2. 共享~/音乐和~/电影（或~/视频）文件夹。
3. 下载的媒体内容将自动出现在支持DLNA/UPnP的电视应用上，例如VLC。

参见示例脚本以在Mac上设置Universal Media Server。