youtube-download

用途：从在线视频站点下载视频、音频或字幕文件，支持 YouTube（youtube.com、youtu.be）、Bilibili、Twitter/X 以及 yt-dlp 所支持的其他站点。用户提出下载在线视频或提取音频的请求时使用。\n\n主要能力：下载完整视频文件（视频+音频并合并为 mp4）、仅下载音频（MP3/M4A/原始格式）、仅下载字幕（SRT/VTT，含自动生成字幕），以及视频与字幕同时下载并嵌入。可解析视频标题、时长、可用画质、音频格式和字幕语言。\n\n使用方式：无需手动安装，全部命令通过 uvx 运行 yt-dlp，由 uvx 负责安装与环境隔离。流程为：先获取视频 URL（未提供时向用户索取），然后解析视频信息，命令为 uvx yt-dlp --cookies-from-browser chrome -j "$VIDEO_URL" 2>/dev/null；解析出标题、时长、formats、subtitles、automatic_captions 等信息后展示给用户。接着收集下载偏好（内容类型、画质、音频格式、字幕语言、输出路径），再据此构建命令。常用基础选项为 --cookies-from-browser chrome、-o "%(title)s.%(ext)s"、--no-playlist。画质通过 -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" 这类格式选择表达并配合 --merge-output-format mp4；音频用 -x --audio-format mp3 --audio-quality 0；字幕用 --write-subs 或 --write-auto-subs，配合 --sub-langs 与 --sub-format srt --convert-subs srt，可用 --embed-subs 嵌入视频。执行前先向用户展示完整命令，执行中显示进度，完成后用 ls -la "OUTPUT_PATH" 校验，报告文件名、大小与字幕文件及任何警告。\n\n限制：资料未提供收费、价格与平台信息。需要登录的内容依赖 Chrome 已登录状态，必要时可建议手动导出 cookies；受限地区的内容可能需要代理，或尝试 --geo-bypass；下载失败可检查 URL、更新 yt-dlp（uvx --refresh yt-dlp --version）或检查网络。解析失败可能因需要登录或视频不可用。