用途:该技能用于下载 YouTube 视频,适合用户要求下载、保存或获取 YouTube 视频的场景,可控制画质与输出格式。
主要能力:支持画质选项 best(默认)、1080p、720p、480p、360p、worst;视频格式支持 mp4(默认)、webm、mkv;可用 -a 或 --audio-only 仅下载音频为 MP3;可用 -o 或 --output 指定输出目录。默认保存到 /mnt/user-data/outputs/,文件名根据视频标题自动生成。
使用方式:基本命令为 python scripts/download_video.py "URL"。示例:加 -q 720p 指定画质,加 -f webm 指定格式,加 -a 仅下载音频,加 -o /path/to/directory 指定目录。
依赖与限制:脚本使用 yt-dlp。若 yt-dlp 在 PATH 中则直接使用,否则在 video-downloader/.venv 创建本地虚拟环境并安装,不向系统 Python 安装包。若虚拟环境创建或安装失败,可按提示全局安装,如 pipx install yt-dlp、brew install yt-dlp 或使用系统包管理器。仅支持 HTTPS,拒绝 http:// 链接;仅支持 YouTube 域名,包括 youtube.com 及其子域(www、m、music)、youtu.be、youtube-nocookie.com(含 www),其他站点被拒绝。默认仅下载单个视频,跳过播放列表。更高画质可能耗时更长并占用更多磁盘空间。