自用技能 技能
yt-dlp-toolkit
基于 yt-dlp 的全能媒体下载技能包，覆盖视频下载、音频提取、画质选择、字幕、认证、播放列表、直播、代理和排障，支持 YouTube、Bilibili 等 1800+ 平台。
自用技能技能包yt-dlpvideo-downloadaudio-extractionffmpegyoutubebilibilisubtitlescookies
yt-dlp Toolkit
基于 yt-dlp 的全能媒体下载技能包。直接通过 yt-dlp CLI 命令覆盖下载、转码、认证、排障等全流程，无需额外封装脚本。
来源
- Skill 目录：
skills/yt-dlp-toolkit - 上游仓库：https://github.com/yt-dlp/yt-dlp
依赖
安装 yt-dlp 完整版（含可选依赖）：
pip install "yt-dlp[default]"
适合什么时候用
- "帮我把这个视频下载下来" / "保存这个链接" / "抓取这个"
- "提取音频" / "转成 MP3" / "只要声音"
- "下载播放列表" / "把这个频道的视频全下了"
- "下载字幕" / "要中英双语字幕"
- "视频有年龄限制" / "需要登录才能看"
- "yt-dlp 报错了" / "403 Forbidden 怎么办"
- "有什么画质可选？" / "帮我选个最小的格式"
- "走代理下载" / "绕过地区限制"
核心能力
| 能力 | 说明 | 代表命令 |
|---|---|---|
| 下载视频 | 单视频、播放列表、整个频道 | yt-dlp "URL" |
| 提取音频 | MP3、M4A、FLAC、Opus 等，可嵌入封面和元数据 | yt-dlp -x --audio-format mp3 "URL" |
| 画质选择 | 指定分辨率、编解码器、文件大小 | -S "res:720" / -S "codec:avc" |
| 字幕 | 手动/自动生成字幕，可嵌入视频 | --write-subs --sub-langs "en,zh-Hans" |
| 认证 | 用浏览器 Cookie 访问年龄限制/会员内容 | --cookies-from-browser chrome |
| 播放列表 | 下载前 N 个、按日期过滤、避免重复下载 | -I ":10" / --download-archive |
| 直播 | 录制直播流，支持从头开始录 | --live-from-start |
| 分段下载 | 按时间范围或章节下载 | --download-sections "*1:00-5:00" |
| 网络控制 | 代理、地理绕过、浏览器模拟 | --proxy / --xff "JP" / --impersonate chrome |
| 排障 | 诊断 403、限速、格式不匹配等问题 | --impersonate chrome / --cookies-from-browser |
| 文件组织 | 基于元数据的自定义文件名和目录结构 | -o "%(title)s.%(ext)s" / -P "D:/Downloads" |
支持平台
yt-dlp 支持 1800+ 网站，以下是用户最常问的：
| 平台 | 备注 |
|---|---|
| YouTube | 完整支持：视频、播放列表、频道、Shorts、直播、会员（需 Cookie）、SponsorBlock |
| Bilibili | 完整支持；部分视频需 --cookies-from-browser |
| Twitter / X | 推文、Spaces；可能需要 Cookie |
| Twitch | VOD、剪辑、直播（支持 --live-from-start） |
| Vimeo | 视频、频道；密码保护可能需 Cookie |
| Niconico | 完整支持；大量视频需登录 |
| Reels、Stories、帖子；需 Cookie | |
| TikTok / 抖音 | 有水印/无水印视频 |
| 视频、Reels；多数内容需 Cookie | |
| 视频（自动合并音视频）、GIF | |
| SoundCloud | 音轨、歌单 |
| Spotify | 播客节目（音乐不可下载） |
| Google Drive / Dropbox / OneDrive | 公开或共享链接 |
| Udemy / Coursera / Skillshare | 课程视频；需登录 |
| Crunchyroll / Funimation | 动画；需登录 |
| 知乎 / 微博 / 西瓜视频 / AcFun | 国内视频平台 |
| M3U8 / 直接 MP4 链接 | 任何直接流媒体 URL |
未列出的平台可以直接试 URL，yt-dlp 的通用提取器会自动尝试处理。
不支持什么
- ffmpeg 通用转码/编辑（裁剪、加水印等）
- 本地文件格式转换（MP4→GIF、MP3→WAV）
- 视频制作或流媒体搭建
- 与媒体下载无关的网页爬虫
参考文档
技能包含 4 份详细参考文档，按需加载：
| 文件 | 内容 |
|---|---|
references/common-tasks.md | 16 种常见任务的完整命令示例 |
references/format-selection.md | -f 和 -S 格式选择语法与示例 |
references/output-template.md | -o 输出模板语法与所有可用字段 |
references/troubleshooting.md | 按症状分类的排障指南 |