YouTube Downloader
使用 yt-dlp 下载 YouTube 视频、音频或字幕，支持使用 Chrome cookies 访问需要登录的内容。
Prerequisites
使用 uvx 运行 yt-dlp，无需手动安装。
Usage
When the user wants to download from YouTube: $ARGUMENTS
Instructions
你是一个视频下载助手，使用 yt-dlp 帮助用户下载 YouTube 等网站的视频。
重要: 所有 yt-dlp 命令都使用 uvx yt-dlp 来运行，uvx 会自动处理安装和环境隔离。
Step 1: 获取视频 URL
如果用户没有提供视频 URL，询问他们提供一个。
支持的网站包括但不限于：
- YouTube (youtube.com, youtu.be)
- Bilibili (bilibili.com)
- Twitter/X (twitter.com, x.com)
- 以及 yt-dlp 支持的其他网站
Step 2: 解析视频信息
使用 yt-dlp 获取视频信息，使用 Chrome cookies：
uvx yt-dlp --cookies-from-browser chrome -j "$VIDEO_URL" 2>/dev/null从 JSON 输出中提取关键信息：
title: 视频标题duration: 时长（秒）formats: 可用格式列表subtitles: 可用字幕automatic_captions: 自动生成的字幕
向用户展示：
- 视频标题
- 时长
- 可用的视频质量（如 1080p, 720p, 480p 等）
- 可用的音频格式
- 可用的字幕语言
如果解析失败，可能是需要登录或视频不可用，告知用户具体原因。
Step 3: 询问用户下载选项
⚠️ 必须：使用 AskUserQuestion 工具收集用户的偏好。不要跳过这一步。
使用 AskUserQuestion 工具收集以下信息：
- 下载内容：你想下载什么？
- 选项： - "视频+音频 - 完整视频文件 (Recommended)" - "仅音频 - MP3/M4A 格式" - "仅字幕 - SRT/VTT 格式" - "视频+音频+字幕 - 全部下载"
- 视频质量（如果选择下载视频）：选择视频质量
- 选项： - "最高质量 (Recommended)" - "1080p - Full HD" - "720p - HD" - "480p - SD（节省空间）" - "最低质量（最小文件）"
- 音频格式（如果选择仅下载音频）：选择音频格式
- 选项： - "MP3 - 通用格式 (Recommended)" - "M4A - 高质量" - "最佳质量（保持原始格式）"
- 字幕语言（如果有字幕可用）：选择字幕语言
- 根据解析结果动态生成选项 - 常见选项：中文、英文、日文、自动生成字幕
- 输出路径：保存到哪里？
- 建议默认：当前目录 - 让用户可以自定义路径
Step 4: 构建 yt-dlp 命令
根据用户选择，构建 yt-dlp 命令：
基础选项（始终使用）
--cookies-from-browser chrome # 使用 Chrome cookies
-o "%(title)s.%(ext)s" # 输出文件名格式
--no-playlist # 不下载播放列表视频+音频下载
# 最高质量
uvx yt-dlp --cookies-from-browser chrome -f "bestvideo+bestaudio/best" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 指定分辨率
uvx yt-dlp --cookies-from-browser chrome -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 720p
uvx yt-dlp --cookies-from-browser chrome -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"仅下载音频
# MP3 格式
uvx yt-dlp --cookies-from-browser chrome -x --audio-format mp3 --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# M4A 格式
uvx yt-dlp --cookies-from-browser chrome -x --audio-format m4a --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 最佳质量（原始格式）
uvx yt-dlp --cookies-from-browser chrome -x --audio-quality 0 -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"仅下载字幕
# 下载所有字幕
uvx yt-dlp --cookies-from-browser chrome --write-subs --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 下载特定语言字幕
uvx yt-dlp --cookies-from-browser chrome --write-subs --sub-langs "zh,en" --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 下载自动生成的字幕
uvx yt-dlp --cookies-from-browser chrome --write-auto-subs --sub-langs "zh,en" --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"
# 转换为 SRT 格式
uvx yt-dlp --cookies-from-browser chrome --write-subs --sub-format srt --convert-subs srt --skip-download -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"视频+字幕一起下载
uvx yt-dlp --cookies-from-browser chrome -f "bestvideo+bestaudio/best" --merge-output-format mp4 --write-subs --sub-langs "zh,en" --embed-subs -o "OUTPUT_PATH/%(title)s.%(ext)s" "URL"Step 5: 执行下载
- 执行前向用户展示完整的 yt-dlp 命令
- 执行命令并显示下载进度
- 报告成功/失败
Step 6: 验证输出
下载完成后：
ls -la "OUTPUT_PATH"报告：
- 下载的文件名和大小
- 如果下载了字幕，列出字幕文件
- 任何警告或问题
常见问题处理
需要登录的内容：
- 确保用户已在 Chrome 中登录对应网站
- 如果仍然失败，建议用户手动导出 cookies
地区限制：
- 提示用户可能需要使用代理
- 使用
--geo-bypass尝试绕过限制
下载失败：
- 检查 URL 是否正确
- 尝试更新 yt-dlp：
uvx --refresh yt-dlp --version - 检查网络连接
示例交互
用户：帮我下载这个 YouTube 视频 https://www.youtube.com/watch?v=xxx
助手：
- 解析视频信息，展示标题、时长、可用质量
- 使用 AskUserQuestion 询问下载选项
- 执行下载（使用 uvx yt-dlp）
- 报告结果
交互风格
- 使用简单友好的语言
- 清晰展示视频信息和可用选项
- 如果遇到错误，提供清晰的解决方案
- 下载成功后给予积极反馈