↑

yt-dlp 视频下载转码工具v1.3.9

yt-dlp-toolkit14 KB

基于 yt-dlp 的命令行媒体获取工具，支持从千余个站点下载视频、提取音频、抓取播放列表及批量处理。当用户提到视频下载、音频提取、格式转换、批量下载或播放列表抓取时触发，可自动组合分辨率筛选、字幕下载、元数据写入、限速断点续传等参数，输出可直接执行的命令行方案。

0 0 0 0 更新于 2026-10-28 14:13

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向需要从视频平台获取媒体资源的创作者、学习者及运营人员，围绕 yt-dlp 命令行工具提供完整的下载与转码工作流。实际可完成单视频/播放列表/批量 URL 的下载任务，支持按分辨率、编码、文件大小筛选格式，提取 m4a/mp3/flac 音轨，下载多语言字幕，并将标题、封面、描述等元数据写入输出文件。内置环境自检（--selftest）、多编码容错（utf-8/gbk/gb18030）、dry-run 预览及异常降级保护，确保命令生成可靠、执行可验证、出错不崩溃。

技能包含

  • SKILL.md（本文件）：技能主说明，含能力边界、触发词、标准操作流程、错误码体系及合规提示
  • run.py：完整 CLI 入口，支持 argparse 参数化控制与核心功能调度
  • scripts/main.py：核心功能实现模块，承载视频下载、格式转换、批处理等逻辑
  • selftest.py：自检契约模块，验证 yt-dlp 与 FFmpeg 环境及核心函数可用性
  • _meta.json / _skillhub_meta.json：技能包元数据与平台索引配置

核心能力

  • 千站视频下载：基于 yt-dlp 解析并下载全球千余站点公开视频，自动处理格式选择与命名转义
  • 音频提取与转码：分离音轨输出 m4a/mp3/flac，依赖 FFmpeg 完成编码转换，支持音质等级指定
  • 播放列表与批量处理：递归抓取完整播放列表，支持范围限制、并发加速及断点续传，也可从文本文件批量读取 URL
  • 字幕与元数据获取：下载站点自带字幕（含多语言筛选），将视频标题、封面、描述写入文件或导出 JSON 元数据
  • 环境自检与容错：--selftest 验证 yt-dlp/FFmpeg/网络连通性；多编码三级 fallback 与异常降级保护，避免流程中断
  • Dry-run 预览：写盘前可视化预览命令与输出路径，防止误操作

应用场景

用户怎么说本技能做什么
"把这个视频存下来，要 1080p 的"检查环境后生成 yt-dlp -f "bv*[height<=1080]+ba" [URL]，指定输出模板与路径
"只要声音，转成 mp3"确认 FFmpeg 可用，生成 yt-dlp -x --audio-format mp3 --audio-quality 0 [URL] 提取高音质音频
"这个歌单里所有视频都要，但只下前 10 个"生成播放列表抓取命令并限制范围：yt-dlp --playlist-items 1-10 [URL]
"链接都在文件里，批量下，顺便把中文字幕也带上"生成 yt-dlp -a urls.txt --sub-langs zh-Hans --write-subs，支持并发与断点续传
"运行报错，提示 ffmpeg not found"定位错误码，输出对应安装命令（brew/apt/手动 PATH 配置）并提示重试