res-downloader批量导入导出：JSON配置使用教程

为什么需要批量导入导出？

你还在手动复制粘贴几十个视频链接吗？还在为多设备同步下载任务烦恼吗？res-downloader的JSON批量处理功能让你告别重复劳动，一键搞定上百个资源的导入导出，效率提升10倍！

读完本文你将掌握：

• 3种批量导入场景的操作技巧
• JSON配置文件的结构与参数说明
• 跨设备同步下载任务的完整方案
• 10个实用批量处理案例（附配置模板）

准备工作

环境要求

项目	要求	检测方法
软件版本	≥2.3.0	菜单栏「关于我们」查看版本号
运行权限	管理员权限	Windows右键「以管理员身份运行」
网络状态	正常联网	首页显示"已连接"状态

功能入口定位

flowchart TD
    A[首页] --> B[顶部操作栏]
    B --> C{批量操作按钮}
    C --> D[批量导出]
    C --> E[批量导入]
    E --> F[弹出JSON输入框]

提示：首次使用需在「系统设置」→「基础设置」中启用"高级功能"选项

批量导出功能详解

导出流程

1. 在资源列表勾选需要导出的项目（支持Shift键多选）
2. 点击顶部「批量导出」按钮，选择保存路径
3. 系统生成resd-YYYYMMDD-HHMMSS.json文件

导出文件结构解析

[
  {
    "Id": "vid_123456",
    "Url": "https://example.com/video1.mp4",
    "CoverUrl": "https://example.com/cover1.jpg",
    "Size": "2.4MB",
    "Domain": "video.example.com",
    "Classify": "video",
    "Suffix": "mp4",
    "Status": "ready",
    "Description": "视频平台无水印视频"
  },
  {
    "Id": "aud_7890",
    "Url": "https://example.com/audio.mp3",
    "Size": "3.7MB",
    "Domain": "music.example.com",
    "Classify": "audio",
    "Suffix": "mp3",
    "Status": "done"
  }
]

核心字段说明

字段	类型	必要性	说明
Url	string	必须	资源原始链接，支持HTTP/HTTPS
Classify	string	必须	资源类型：video/audio/image/doc
Domain	string	可选	来源域名，用于分类过滤
Description	string	可选	自定义描述，支持Markdown格式

批量导入完全指南

导入方式对比

方式	适用场景	操作难度	速度	支持格式
JSON文件导入	完整配置迁移	★★☆	快	.json/.resd
文本批量导入	快速添加链接	★☆☆	最快	纯文本（每行一个URL）
剪贴板粘贴	临时任务	★☆☆	中	混合格式

JSON导入步骤

sequenceDiagram
    participant 用户
    participant 软件
    用户->>软件: 点击「批量导入」
    软件->>用户: 显示文本输入框
    用户->>软件: 粘贴JSON数组
    软件->>软件: 格式验证
    alt 验证通过
        软件->>用户: 提示"导入成功(12条)"
    else 验证失败
        软件->>用户: 显示错误位置"第5行缺少Url字段"
    end

最小化导入模板

[
  {"Url": "https://v.example.com/xxxx/", "Classify": "video"},
  {"Url": "https://kg.example.com/node/play?s=xxxx", "Classify": "audio"},
  {"Url": "https://wx.video.example.com/xxxx", "Classify": "video"}
]

导入验证规则

1. 必须包含Url和Classify字段
2. Classify只能是预设类型之一
3. URL必须以http://或https://开头
4. 单次导入上限为100条记录

高级应用场景

跨设备同步方案

1. 在设备A导出JSON文件
2. 通过云盘/U盘传输到设备B
3. 在设备B导入并自动续传

mindmap
    root((配置同步))
        导出
            全量导出
            筛选导出
            定时备份
        传输
            加密传输
            版本控制
            冲突解决
        导入
            增量合并
            覆盖替换
            选择性导入

自动化任务配置

[
  {
    "Url": "https://example.com/live.m3u8",
    "Classify": "live",
    "OtherData": {
      "startTime": "2025-09-01 20:00",
      "duration": 3600,
      "quality": "high"
    }
  }
]

常见问题解决

导入失败排查流程

1. 检查JSON格式：使用JSON在线验证工具验证
2. 简化配置：移除Optional字段，只保留Url和Classify
3. 分批导入：将100+条记录拆分为多个文件
4. 检查网络：确保导入的URL在当前网络环境可访问

错误代码速查表

错误码	含义	解决方案
E001	JSON格式错误	检查括号匹配和逗号位置
E002	缺少必填字段	添加Url和Classify字段
E003	域名不支持	确认该平台是否在支持列表
E004	URL已存在	启用"跳过重复项"选项

实战案例库

案例1：视频创作者备份

[
  {"Url": "https://v.example.com/iJkXXXX/", "Classify": "video", "Description": "产品宣传视频1"},
  {"Url": "https://v.example.com/iJlYYYY/", "Classify": "video", "Description": "客户 testimonial"}
]

案例2：音乐专辑下载

[
  {"Url": "https://kg.example.com/node/play?s=abc123", "Classify": "audio", "Description": "专辑《秋日私语》-01"},
  {"Url": "https://kg.example.com/node/play?s=def456", "Classify": "audio", "Description": "专辑《秋日私语》-02"}
]

总结与展望

批量导入导出功能彻底解决了大量资源管理的痛点，配合JSON配置的灵活性，不仅实现了任务的高效迁移，更为自动化下载、多设备协同等高级场景提供了可能。

下一期我们将带来：

• JSON配置的高级加密技巧
• 结合浏览器脚本实现网页一键导出
• 命令行模式下的批量处理方案

如果觉得本文对你有帮助，请点赞+收藏+关注三连支持！有任何问题欢迎在评论区留言讨论。

提示：所有配置文件建议定期备份，防止意外丢失。重要数据可导出为加密格式（「高级设置」→「加密导出」）