| 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 的安装
- 仅下载单个视频（默认跳过播放列表）
- 更高质量的视频可能需要更长时间下载并使用更多磁盘空间
