项目介绍
z-video-downloader 把媒体链接识别与下载工具封装成 Skill。适合在代理任务中保存自己的视频资料,实际支持情况取决于底层下载器和平台规则。
技能把链接识别、下载策略和结果检查放到代理任务中,用户可以用自然语言说明保存位置、格式和字幕要求。底层工具负责获取媒体,代理则应报告实际生成了哪些文件以及哪些链接失败。
适合制作自己的学习资料归档流程。单条下载确认可用后,再使用链接清单逐步增加任务,并保留封面、字幕或元数据,便于后续查找;不要默认把整个播放列表都下载到工作目录。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 输入识别 | 区分直链、流媒体地址与受支持的平台链接。 |
| 格式与目录 | 明确输出文件夹、命名和所需媒体格式。 |
| 字幕与元数据 | 按支持范围保存字幕、封面和来源信息。 |
| 续传与历史 | 使用底层工具提供的续传与去重能力。 |
| 任务报告 | 检查成功文件、失败原因和后续处理方式。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Skill |
| 分类 | 影音与下载 |
| 项目仓库 | tjxj/z-skills |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备该技能支持的代理宿主与所需运行环境。先阅读 SKILL.md 中的依赖、权限和配置要求,再把技能安装到宿主识别的位置。
安装与使用步骤
- 在 z-skills 仓库找到对应技能,阅读 SKILL.md,按说明安装依赖和所需的下载组件。
- 指定一个独立输出目录,提供一条获准下载的链接,明确格式、分辨率和是否需要字幕。
- 检查生成文件能否播放及命名是否正确,再开启批量任务。
首次使用与操作检查
先让代理检查 Python、下载组件和 ffmpeg 是否可用,指定一个空的输出目录,再提供一条自己有权下载的链接。任务结束后打开文件,核对音画、时长和字幕。
批量处理先用两三条链接,确认文件名不覆盖、历史记录生效,并查看 download-report 等实际产物。平台需要登录时按官方支持方式处理个人凭据,不接受来历不明的公共 Cookie。
配置与常见问题
- 不要把分享页地址与最终媒体地址混为一谈。
- 需要登录的内容使用自己的凭据;错误时先查看下载器日志及平台适配更新。
- 技能没有触发:检查安装路径、技能名称与当前会话是否重新加载,再确认宿主是否具备技能要求的工具。
更新与备份
保存输出文件和必要的任务参数,升级技能前记录依赖版本。