name: youtube-downloader description: 下载YouTube视频,支持自定义画质和格式选项。当用户要求下载、保存或获取YouTube视频时使用此技能。支持多种画质设置(最佳、1080p、720p、480p、360p)、多种格式(mp4、webm、mkv)以及仅下载音频为MP3。
YouTube视频下载器
下载YouTube视频,完全控制画质和格式设置。
快速开始
最简单的下载视频方式:
python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"
这将以最佳可用画质将视频下载为MP4格式到/mnt/user-data/outputs/目录。
选项
画质设置
使用-q或--quality指定视频画质:
best(默认):最高可用画质1080p:全高清720p:高清480p:标清360p:较低画质worst:最低可用画质
示例:
python scripts/download_video.py "URL" -q 720p
格式选项
使用-f或--format指定输出格式(仅视频下载):
mp4(默认):兼容性最好webm:现代格式mkv:Matroska容器
示例:
python scripts/download_video.py "URL" -f webm
仅音频
使用-a或--audio-only仅下载音频为MP3:
python scripts/download_video.py "URL" -a
自定义输出目录
使用-o或--output指定不同的输出目录:
python scripts/download_video.py "URL" -o /path/to/directory
完整示例
- 以1080p画质下载视频为MP4格式:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p
- 仅下载音频为MP3:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a
- 以720p画质下载为WebM格式到自定义目录:
python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path
工作原理
该技能使用yt-dlp,一个强大的YouTube下载器,它:
- 如果不存在则自动安装自身
- 在下载前获取视频信息
- 选择符合您标准的最佳可用流
- 需要时合并视频和音频流
- 支持广泛的YouTube视频格式
重要说明
- 默认情况下下载内容保存到
/mnt/user-data/outputs/ - 视频文件名根据视频标题自动生成
- 脚本自动处理yt-dlp的安装
- 仅下载单个视频(默认跳过播放列表)
- 更高画质的视频可能需要更长的下载时间并占用更多磁盘空间