从 YouTube/Bilibili/X 等下载视频/音乐
媒体下载器 : 智能下载媒体( 视频/ 音乐) 从 URL( YouTube, Bilibili, X 等) 下载到适当的本地文件夹. : 视频: 保存到 ~/
功能概述
媒体下载器 : 智能下载媒体( 视频/ 音乐) 从 URL( YouTube, Bilibili, X 等) 下载到适当的本地文件夹. : 视频: 保存到 ~/是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
媒体下载器
智能地从 URL（YouTube、Bilibili、X 等）下载媒体内容（视频/音乐），并保存至本地对应文件夹。
- 视频：保存至
~/Movies/或~/Videos/。 - 音乐：保存至
~/Music/。 - 播放列表：将各项内容保存至子目录中（例如：
~/Music/）。/
专为配合本地媒体服务器（如 Universal Media Server、Jellyfin）使用而设计，便于在电视或其它设备上即时播放。
Agent 执行流程
当用户提供 URL 或请求下载媒体时，你必须严格按以下顺序执行：
确认响应：
- 立即向用户回复：“Downloading with dl skill...”
执行下载：
- 运行脚本：
uv run --script ${baseDir}/dl.py ""
- 运行脚本：
捕获输出路径：
- 读取脚本输出；脚本最终会在 stdout 打印一个路径，该路径指向单个文件，或包含播放列表全部条目的文件夹。
上传（仅限 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
用户端配置
若在同一台机器上部署媒体服务器，以在局域网内共享已下载的媒体内容，本技能将更加强大实用：
- 安装 DLNA/UPnP 媒体服务器（例如 Universal Media Server、miniDLNA、Jellyfin）。
- 共享
~/Music和~/Movies（或~/Videos）文件夹。 - 已下载的媒体内容将自动出现在支持 DLNA/UPnP 的电视应用中（例如 VLC）。
参见 macOS 上部署 Universal Media Server 的示例脚本。
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.6万人学习
共6课时 | 54.7万人学习
最新文章
