# 高级视频下载器 ## 概述该技能提供了来自 YouTube、Bilibili、TikTok、Twitter、Instagram 等 1000 多个平台的全面视频下载和转录功能。它结合了： * **yt-dlp** : 强大的视频下载工具 * **SiliconFlow API** ：免费的人工智能驱动的转录，可将视频转换为 Markdown ## 何时使用此技能当用户执行以下操作时激活该技能： * 明确请求下载视频（“下载此视频”、“下载视频”） * 提供任意平台的视频URL * 提到保存视频以供离线观看 * 想要从视频中提取音频 * 需要下载多个视频或播放列表 * 询问视频质量选项 * 请求视频转录（“转录视频”、“提取字幕”、“视频转文字”） * 想要将视频/音频转换为文本或 Markdown * 要求在一个工作流程中下载并转录视频 ## 核心能力 ### 1\.单个视频下载从任何支持的平台下载单个视频，并自动选择质量。 **使用示例：** 用户：“下载此 YouTube 视频：https://youtube.com/watch?v=abc123” 用户：“下载此B站视频：https://bilibili.com/video/BV1xxx” ### 2\.批量和播放列表下载一次下载多个视频或整个播放列表。 **使用示例：** 用户：“下载此播放列表中的所有视频” 用户：“下载这 3 个视频：[URL1]、[URL2]、[URL3]” ### 3\.音频提取仅从视频中提取音频，另存为 MP3 或 M4A。 **使用示例：** 用户：“仅下载该视频的音频” 用户：“将此视频转换为 MP3” ### 4\.品质精选选择特定的视频质量（4K、1080p、720p 等）。 **使用示例：** 用户：“以 4K 画质下载” 用户：“获取 720p 版本以节省空间” ### 5\.视频/音频转录使用 SiliconFlow 的免费 AI 转录 API 将视频或音频文件转换为 Markdown 文本。 **使用示例：** 用户：“将此视频转录为文本”/“转录此视频” 用户：“下载并转录此 YouTube 视频” 用户：“将这个音频转成文字” 用户：“从此 MP4 文件中提取文字记录” **支持的格式：** * 音频：MP3、WAV、M4A、FLAC、AAC、OGG、OPUS、WMA * 视频：MP4、AVI、MOV、MKV、FLV、WMV、WEBM、M4V ## 响应模式当用户请求下载视频时： ### 第 1 步：识别平台和 URL # 从用户消息中提取视频 URL # 识别平台：YouTube、Bilibili、TikTok 等。 ### 第 2 步：检查工具可用性 # 检查 yt-dlp 是否安装 yt-dlp --版本 ### 步骤 3：选择适当的 yt-dlp 命令根据平台和要求： * **YouTube、Twitter、Instagram、TikTok**：基本命令有效 * **Bilibili**：基本命令适用于大多数视频 * **质量选择** : 使用带有高度过滤器的 `-f` * **仅音频** : 使用 `-x --audio-format mp3` * **播放列表** ：使用特定于播放列表的输出模板 ### 第4步：执行下载直接使用 yt-dlp 和适当的选项： # 基本下载（最佳质量 MP4） yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" --merge-output-format mp4 -o "%(title)s.%(ext)s" "VIDEO_URL" # 具体质量 (1080p) yt-dlp -f“bestvideo[高度<=1080]+bestaudio/best[高度<=1080]”--merge-output-format mp4 -o“%(标题)s.%(ext)s”“VIDEO_URL” # 仅音频 (MP3) yt-dlp -x --音频格式 mp3 -o "%(title)s.%(ext)s" "VIDEO_URL" # 使用 cookies 文件（用于受保护的内容） yt-dlp --cookies cookies.txt -o "%(title)s.%(ext)s" "VIDEO_URL" # 播放列表下载 yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL" ### 第 5 步：报告结果下载完成后，报告： * ✅ 视频标题和时长 * ✅ 文件大小和格式 * ✅ 保存位置 * ✅ 下载速度和所需时间 * ⚠️ 任何警告或质量限制 **输出示例：** ✅ 下载：“视频标题在这里” 持续时间：15:30 质量：1080p MP4 大小：234 MB 位置：./视频标题在这里.mp4 时间：45 秒（5.2 MB/秒） ## 转录反应模式当用户请求视频/音频转录时： ### 第 1 步：检查先决条件 # 验证 SiliconFlow API 密钥是否可用回显 $SILICONFLOW_API_KEY # 或者用户必须通过 --api-key 参数提供 **API 密钥设置：** * 获取免费API密钥： * 将 `.env.example` 复制到 `.env` 并添加您的 API 密钥 * 或者设置环境变量：`SILICONFLOW_API_KEY=sk-xxx` ### 第 2 步：验证文件确保文件存在并且是受支持的格式（音频或视频）。 ### 步骤 3：执行转录使用捆绑脚本“scripts/transcribe_siliconflow.py”： # 基本转录 python 脚本/transcribe_siliconflow.py --file video.mp4 --api-key sk-xxx # 自定义输出路径 python脚本/transcribe_siliconflow.py --文件audio.mp3 --输出转录.md --api-key sk-xxx # 使用环境变量作为 API 密钥 python 脚本/transcribe_siliconflow.py --文件 video.mp4 ### 步骤 4：报告转录结果 ✅ 转录完成！文件：视频.mp4 输出：2025-01-15-video.md 大小：12.5 KB 预览： -------------------------------------------------- [转录的前200个字符...] -------------------------------------------------- ## 组合工作流程：下载 + 转录对于“下载并转录此视频”之类的请求： # 第 1 步：下载视频 yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best" --merge-output-format mp4 -o "%(title)s.%(ext)s" "VIDEO_URL" # 第二步：转录下载的文件 python script/transcribe_siliconflow.py --file "下载的视频标题.mp4" --api-key sk-xxx ## 平台特定注释 ### YouTube * yt-dlp 完全支持 * 公开视频无需认证 * 支持所有质量级别，包括 4K/8K ### 哔哩哔哩 * 由 yt-dlp 支持 * 高质量下载可能需要登录cookie * 将 `--cookies` 与 cookies.txt 一起使用以获取仅限会员的内容 ### 其他平台 * 大多数平台与 yt-dlp 配合良好 * 检查 `references/supported_platforms.md` 以获得完整列表 ## 处理受保护内容的 Cookie 对于需要认证的平台（Bilibili VIP、会员专享内容等）： ### 方法一：导出Cookies文件（推荐） # 使用浏览器扩展“本地获取 cookies.txt” # 导出cookies.txt，则： yt-dlp --cookies cookies.txt“VIDEO_URL” ### 方法 2：手动 Cookie 文件 # 创建 Netscape 格式的 cookies.txt # 使用浏览器扩展“本地获取 cookies.txt” # 然后与 yt-dlp 一起使用 yt-dlp --cookies cookies.txt“VIDEO_URL” ## 故障排除 ### 问题：视频质量低于预期 **解决方案：** 1. 检查平台是否需要登录HD 2.使用`--cookies cookies.txt`进行身份验证访问 3. 使用“-f”参数显式指定质量 ### 问题：下载速度非常慢 **解决方案：** 1. 检查互联网连接 2.尝试一天中的不同时间（高峰时段影响速度） 3. 使用 `--concurrent-fragments` 加快下载速度 ### 问题：“视频不可用”或地理限制 **解决方案：** 1. 视频可能被锁区 2. 在法律允许的情况下使用代理/VPN 3. 检查视频在平台上是否仍然可用 ### 问题：转录 API 密钥错误 **解决方案：** 1.验证API密钥以“sk-”开头 2. 获取免费密钥： 3. 设置环境变量：`SILICONFLOW_API_KEY=sk-xxx` ### 问题：转录返回空文本 **解决方案：** 1.检查音频/视频是否语音清晰 2. 验证文件格式是否支持 3. 文件可能太短或仅包含音乐 ## 常用命令 ### 质量预设 # 4K (2160p) yt-dlp -f“bestvideo[高度<=2160]+bestaudio/best[高度<=2160]”--合并输出格式mp4“VIDEO_URL” # 1080p（全高清） yt-dlp -f“bestvideo[高度<=1080]+bestaudio/best[高度<=1080]”--合并输出格式mp4“VIDEO_URL” #720p（高清） yt-dlp -f“bestvideo[高度<=720]+bestaudio/best[高度<=720]”--合并输出格式mp4“VIDEO_URL” # 480p（标清） yt-dlp -f“bestvideo[高度<=480]+bestaudio/best[高度<=480]”--合并输出格式mp4“VIDEO_URL” ### 音频提取 # 提取为 MP3 yt-dlp -x --音频格式 mp3 -o "%(title)s.%(ext)s" "VIDEO_URL" # 提取为 M4A（质量更好） yt-dlp -x --音频格式 m4a -o "%(title)s.%(ext)s" "VIDEO_URL" ### 批量下载 # 从文件中下载多个 URL yt-dlp -a urls.txt # 下载具有自定义命名的播放列表 yt-dlp -o "%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s" "PLAYLIST_URL" # 下载频道的视频 yt-dlp -o "%(上传者)s/%(标题)s.%(ext)s" "CHANNEL_URL" ## 捆绑资源 ### 配置 #### `.env.example` 环境变量模板。复制到“.env”并添加您的 SiliconFlow API 密钥。 ### 脚本 #### `脚本/transcribe_siliconflow.py` 使用 SiliconFlow 的免费 API 的人工智能驱动的转录脚本。 **用途：** python script/transcribe_siliconflow.py --file <音频/视频> [--api-key ] [--output <路径>] **参数：** * `--file, -f`: 输入音频/视频文件（必填） * `--api-key, -k`: SiliconFlow API 密钥（或使用 `SILICONFLOW_API_KEY` 环境变量） * `--output, -o`: 输出 markdown 文件路径 (默认: `YYYY-MM-DD-filename.md`) * `--model, -m`：要使用的模型（默认值：`FunAudioLLM/SenseVoiceSmall`） ### 参考文献 #### `references/supported_platforms.md` 1000 多个受支持平台的综合列表，以及特定于平台的说明和要求。 #### `references/quality_formats.md` 视频格式、编解码器和质量选择策略的详细解释。 ## 获得最佳效果的技巧 1. **如果用户有偏好，则始终指定质量** \- 节省带宽和存储 2. **批量下载节省时间** \- 尽可能使用播放列表 URL 3. **音频提取速度更快** \- 推荐用于播客/音乐内容 4. **下载前检查文件大小** \- 警告用户非常大的文件（>1GB） 5. **转录在清晰的音频下效果最佳** \- 考虑首先提取音频以获得更好的结果 ## 来源 * [yt-dlp 文档]() * [yt-dlp 安装指南]() * [SiliconFlow API文档]() * [SiliconFlow 免费 API 密钥]()

高级视频下载器

包含技能