技能介绍

要解决什么问题

工程师或 Agent 拿到一条视频链接时，往往要面对三件事：站点各不相同（YouTube、B 站、Twitter/X、TikTok 等）、YouTube 常因未带登录态返回 HTTP 403、以及「只要音频」「要字幕」「指定 720p/1080p」等需求会对应完全不同的 yt-dlp 参数。本技能把「先判断平台 → 问清需求 → 拼命令 → Shell 执行 → 按错误表重试」写成固定工作流，避免每次从零查文档。

技能如何工作

收到 URL 后，技能会按平台分支处理：YouTube / YouTube Music 默认使用 --cookies-from-browser chrome（也支持 firefox、safari、edge、brave、opera）；其他站点可先不带 Cookie 尝试。若用户未说明意图，会确认是整段视频、仅提取 MP3、是否带字幕、或固定清晰度。

常见任务对应典型参数组合，例如：默认最佳画质下载、-x --audio-format mp3 抽音频、--write-subs 拉字幕、-f 指定 bestvideo[height<=720]+bestaudio 等格式；不确定时用 -F 列出格式再按 ID 下载；播放列表与缩略图也有对应选项。执行下载时通过 Shell，并需要 network 与 all 权限；中断后 yt-dlp 可断点续传，一般重试即可。

边界与注意点

依赖本机已安装 yt-dlp 与（抽音频时）ffmpeg，未安装会先走安装检查逻辑。
403：优先加浏览器 Cookie；仍失败可能是地区限制或私有视频，需 Cookie/VPN。
请求的格式不存在时，应先 -F 再选可用 ID。
支持站点列表以 yt-dlp supportedsites 为准，技能内列举了 YouTube、B 站、X、TikTok/抖音、Vimeo、Twitch 等常见源。
建议定期 pip install -U yt-dlp 以跟上站点反爬变化。