SuperAPI AI 工具集

z-video-downloader

设计与创作

查看项目

更新于 10-16 08:01

技能介绍

用途:把用户给的视频链接下载成本地视频文件。网页素材采集只记录链接,真正下载交给本技能。

主要能力:直链视频支持 .part 文件与 HTTP Range 续传;平台视频和 m3u8 使用 yt-dlp 的续传、分片并发与重试;平台风控时可用导出的 cookies.txt 重试;微信视频号分享链接通过在线解析服务获取地址,无需本地额外工具,默认保存 H.264 与 H.265 两个版本。默认输出到 Video/Downloads/YYYY-MM-DD-主题/,含视频文件、.info.json、download-report.md 与 download-report.json。

依赖:Python(优先 /Users/zz/miniconda3/bin/python3)、yt-dlp(/Users/zz/miniconda3/bin/yt-dlp)、ffmpeg(通常在 /opt/homebrew/bin/ffmpeg)。

用法:单个或多个链接直接传 URL;读取 z-web-pack 清单用 --inventory;从文本批量用 --url-file;风控时加 --cookies-file cookies/cookies.txt;视频号链接自动识别。默认 1080p、单视频模式,默认 --no-playlist、--max-video-mb 2000、--write-info-json。下载播放列表需用户明确要整组再加 --playlist;更高清用 --quality best;字幕用 --subtitles --sub-langs "zh.,en." --embed-thumbnail;中断续传用 --run-dir;去重用 --download-archive。YouTube 无 cookie 被拦截时默认尝试 Invidious local=true 代理 fallback,可用 --no-invidious-fallback 关闭。

适用场景:下载 YouTube、B站、Vimeo、X/Twitter、TikTok、抖音、m3u8 及直链视频,或按 z-web-pack 媒体清单批量下载。

限制:输入须为有效 HTTP/HTTPS 地址;空清单、无效地址、缺失 cookie 文件会在创建目录前停止;默认限制 1080p 与 2000MB;播放列表需显式确认;命令行临时调试支持 --browser-cookies chrome,网页服务应使用 --cookies-file。完成后可查看 download-report.md 获取成功/失败数量、跳过数量、文件名与大小、失败原因及续传提示。