youtube-downloader

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

完整示例

1. 以 1080p 下载视频为 MP4：

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p

2. 仅下载音频为 MP3：

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a

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