res-downloader批量导入导出：JSON配置使用教程
项目地址: https://gitcode.com/GitHub_Trending/re/res-downloader 为什么需要批量导入导出？
你还在手动复制粘贴几十个视频链接吗？还在为多设备同步下载任务烦恼吗？res-downloader的JSON批量处理功能让你告别重复劳动，一键搞定上百个资源的导入导出，效率提升10倍！
读完本文你将掌握：
- 3种批量导入场景的操作技巧
- JSON配置文件的结构与参数说明
- 跨设备同步下载任务的完整方案
- 10个实用批量处理案例（附配置模板）
准备工作
环境要求
| 项目 | 要求 | 检测方法 |
|---|---|---|
| 软件版本 | ≥2.3.0 | 菜单栏「关于我们」查看版本号 |
| 运行权限 | 管理员权限 | Windows右键「以管理员身份运行」 |
| 网络状态 | 正常联网 | 首页显示"已连接"状态 |
功能入口定位
提示：首次使用需在「系统设置」→「基础设置」中启用"高级功能"选项
批量导出功能详解
导出流程
- 在资源列表勾选需要导出的项目（支持Shift键多选）
- 点击顶部「批量导出」按钮，选择保存路径
- 系统生成
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导入步骤
最小化导入模板
[
{"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"}
]
导入验证规则
- 必须包含
Url和Classify字段 Classify只能是预设类型之一- URL必须以
http://或https://开头 - 单次导入上限为100条记录
高级应用场景
跨设备同步方案
- 在设备A导出JSON文件
- 通过云盘/U盘传输到设备B
- 在设备B导入并自动续传
自动化任务配置
[
{
"Url": "https://example.com/live.m3u8",
"Classify": "live",
"OtherData": {
"startTime": "2025-09-01 20:00",
"duration": 3600,
"quality": "high"
}
}
]
常见问题解决
导入失败排查流程
- 检查JSON格式：使用JSON在线验证工具验证
- 简化配置：移除Optional字段，只保留Url和Classify
- 分批导入：将100+条记录拆分为多个文件
- 检查网络：确保导入的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配置的高级加密技巧
- 结合浏览器脚本实现网页一键导出
- 命令行模式下的批量处理方案
如果觉得本文对你有帮助，请点赞+收藏+关注三连支持！有任何问题欢迎在评论区留言讨论。
提示：所有配置文件建议定期备份，防止意外丢失。重要数据可导出为加密格式（「高级设置」→「加密导出」）
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
