影音与下载

z-video-downloader:在代理中下载媒体文件

  • 0 次阅读
  • 0 条评论
文章摘要

z-video-downloader 把媒体链接识别与下载工具封装成 Skill。适合在代理任务中保存自己的视频资料,实际支持情况取决于底层下载器和平台规则。 技能把链接识别、下载策略和结果检查放到代理任务中,用户可以用自然语言说明保存位置、格式和字幕要求。底层工具负责获取媒体,代理则应报告实际生成了哪些文件以及哪些链接失败。 适合制作自己的学习资料归档流程。单条下载确认可用后,再使用链接清单逐步增加任务,并保留封面、字幕或元数据,便于后续查找;不要默认把整个播放列表都下载到工作目录。

项目介绍

z-video-downloader 把媒体链接识别与下载工具封装成 Skill。适合在代理任务中保存自己的视频资料,实际支持情况取决于底层下载器和平台规则。

技能把链接识别、下载策略和结果检查放到代理任务中,用户可以用自然语言说明保存位置、格式和字幕要求。底层工具负责获取媒体,代理则应报告实际生成了哪些文件以及哪些链接失败。

适合制作自己的学习资料归档流程。单条下载确认可用后,再使用链接清单逐步增加任务,并保留封面、字幕或元数据,便于后续查找;不要默认把整个播放列表都下载到工作目录。

核心功能

功能 作用与使用方式
输入识别 区分直链、流媒体地址与受支持的平台链接。
格式与目录 明确输出文件夹、命名和所需媒体格式。
字幕与元数据 按支持范围保存字幕、封面和来源信息。
续传与历史 使用底层工具提供的续传与去重能力。
任务报告 检查成功文件、失败原因和后续处理方式。

功能示意

z-video-downloader 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 Skill
分类 影音与下载
项目仓库 tjxj/z-skills
整理日期 2026-11-14

安装或使用条件

准备该技能支持的代理宿主与所需运行环境。先阅读 SKILL.md 中的依赖、权限和配置要求,再把技能安装到宿主识别的位置。

安装与使用步骤

  1. 在 z-skills 仓库找到对应技能,阅读 SKILL.md,按说明安装依赖和所需的下载组件。
  2. 指定一个独立输出目录,提供一条获准下载的链接,明确格式、分辨率和是否需要字幕。
  3. 检查生成文件能否播放及命名是否正确,再开启批量任务。

首次使用与操作检查

先让代理检查 Python、下载组件和 ffmpeg 是否可用,指定一个空的输出目录,再提供一条自己有权下载的链接。任务结束后打开文件,核对音画、时长和字幕。

批量处理先用两三条链接,确认文件名不覆盖、历史记录生效,并查看 download-report 等实际产物。平台需要登录时按官方支持方式处理个人凭据,不接受来历不明的公共 Cookie。

配置与常见问题

  • 不要把分享页地址与最终媒体地址混为一谈。
  • 需要登录的内容使用自己的凭据;错误时先查看下载器日志及平台适配更新。
  • 技能没有触发:检查安装路径、技能名称与当前会话是否重新加载,再确认宿主是否具备技能要求的工具。

更新与备份

保存输出文件和必要的任务参数,升级技能前记录依赖版本。

参考资料