NullBr剧集下载器

xylplm2023/9/27大约 5 分钟修仙秘籍下载剧集NullBr

📺 NullBr剧集下载器

NullBr剧集下载器 是一个通过NullBr API批量下载指定电视剧指定季数和集数范围的插件，支持离线下载到云存储，提供精确的剧集下载控制。

⚙️ 功能特点

🎯 精确下载

范围下载：指定开始和结束集数进行批量下载
季数控制：精确下载指定季数的剧集
连续控制：可选择是否在某集无资源时停止下载
过滤规则：支持使用自定义过滤规则

📊 云端下载

离线下载：通过NullBr API进行离线下载
云存储集成：直接下载到配置的云存储目录
TMDB集成：基于TMDB ID进行剧集识别
目录自定义：支持自定义下载目录

🚀 配置指南

基础配置

插件配置包含以下参数：

📋 必填参数

TMDB ID (tmdbId)：
- 要下载电视剧的TMDB数据库ID
- 数字格式，例如：12345
季 (season)：
- 要下载的季数
- 数字格式，例如：1、2、3
开始集数 (beginEpisode)：
- 下载范围的起始集数
- 数字格式，例如：1
结束集数 (endEpisode)：
- 下载范围的结束集数
- 数字格式，例如：12

⚙️ 可选参数

过滤规则 (filterRule)：
- 选择要使用的过滤规则
- 不选择则使用资源搜索的默认过滤规则
下载目录 (dir)：
- 自定义下载目录路径
- 不填则使用云存储的默认离线下载目录
连续下载 (continuous)：
- 开启：某一集没有资源时停止下载后续集数
- 关闭：跳过无资源的集数，继续下载其他集数
- 默认关闭

📖 使用说明

前置条件

NullBr API配置

获取API Key：
- 需要有效的NullBr API Key
- 在【系统配置】→【系统配置】→【服务配置】→【NullBr ApiKey】中配置
云存储配置：
- 需要配置云存储服务
- 在【云端存储】→【存储管理】→【基础设置】→【默认离线下载目录】中配置

TMDB ID获取

TMDB网站查找：
- 访问 TMDB官网
- 搜索目标电视剧
- 从URL中获取数字ID

URL示例：

https://www.themoviedb.org/tv/12345-series-name

其中 12345 就是TMDB ID

执行流程

参数验证：
- 检查NullBr API Key是否配置
- 验证云存储默认目录是否设置
- 确认TMDB ID和集数范围参数
资源搜索：
- 使用TMDB ID和季数信息搜索资源
- 按集数范围逐集搜索Ed2k链接
- 应用过滤规则筛选资源
离线下载：
- 调用NullBr API提交离线下载任务
- 将资源下载到指定的云存储目录
- 按连续下载设置处理无资源的集数
结果处理：
- 记录下载成功和失败的集数
- 输出执行结果和统计信息

配置示例

基本配置

TMDB ID: 456789
季: 1
开始集数: 1
结束集数: 10
连续下载: 关闭

高级配置

TMDB ID: 456789
季: 2
开始集数: 5
结束集数: 15
过滤规则: 高质量过滤规则
下载目录: /downloads/tv-series/season2/
连续下载: 开启

操作功能

运行一次

立即执行一次剧集下载任务
按配置的参数下载指定范围的集数
不需要定时任务，仅支持手动执行

⚠️ 注意事项

使用前提

API配置：
- 必须配置有效的NullBr API Key
- 确保API Key有足够的权限和额度
存储配置：
- 必须配置云存储的默认离线下载目录
- 确保云存储有足够的空间
网络要求：
- 确保能正常访问NullBr API服务
- 网络连接稳定，支持大文件下载

重要提醒

TMDB ID准确性：
- 确保使用正确的TMDB ID
- 错误的ID会导致搜索不到资源
集数范围合理性：
- 确认目标剧集确实有指定的集数
- 超出实际集数范围会导致搜索失败
连续下载策略：
- 开启连续下载时，遇到无资源集数会停止
- 关闭时会跳过无资源集数继续下载

故障排除

API未配置错误：
- 检查NullBr API Key是否正确配置
- 确认API Key的有效性和权限
目录未配置错误：
- 检查云存储默认离线下载目录配置
- 确认目录路径的正确性
资源搜索失败：
- 验证TMDB ID是否正确
- 检查季数和集数是否存在
- 确认过滤规则设置
下载失败：
- 检查网络连接状态
- 确认云存储服务正常
- 验证API额度是否充足

📊 使用效果

操作统计

搜索集数：尝试搜索的集数总数
找到资源数：成功找到资源的集数
下载成功数：成功提交下载的集数
跳过/失败数：因各种原因未能下载的集数

实际效果

批量下载：快速下载整季或指定范围的剧集
离线处理：通过云端离线下载，节省本地带宽
精确控制：按需下载指定的集数范围

🔗 相关链接

🎯 提示：使用前请确保已正确配置NullBr API Key和云存储默认目录，插件仅支持手动执行下载任务。