MoviePilot高级筛选规则：精准匹配你想要的影视资源
【免费下载链接】MoviePilot NAS媒体库自动化管理工具 
项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot
你是否还在为海量影视资源筛选烦恼？是否常常下载到不符合预期的低质量视频？MoviePilot的高级筛选功能通过灵活的规则配置，让你精准定位理想资源。本文将系统讲解筛选规则体系、核心语法与实战案例，助你构建个性化资源筛选系统。
筛选规则工作原理
MoviePilot的筛选系统基于规则引擎实现，通过解析用户定义的逻辑表达式，对媒体资源元数据进行匹配判断。系统架构包含三个核心模块：
元数据来源：通过TMDB、豆瓣等API获取影片基础信息，结合种子标题解析出分辨率、编码格式、字幕信息等关键特征。
规则执行流程：资源进入系统后，先进行元数据提取，再通过RuleParser解析用户定义的逻辑表达式，最终根据匹配结果决定资源去留。
核心筛选条件详解
系统支持多维度筛选条件，覆盖资源质量、内容特征、语言字幕等核心要素，主要分为以下类别：
1. 视频质量参数
| 参数标识 | 含义说明 | 示例值 |
|---|---|---|
| 4K | 分辨率≥3840×2160 | 4K |
| 2160P | 同4K标准 | 2160P |
| 1080P | 分辨率1920×1080 | 1080P |
| 720P | 分辨率1280×720 | 720P |
| HDR | 高动态范围 | HDR、HDR10、Dolby Vision |
| SDR | 标准动态范围 | SDR |
| 60FPS | 帧率≥60fps | 60FPS |
2. 编码格式标识
| 参数标识 | 含义说明 | 应用场景 |
|---|---|---|
| H265 | HEVC编码，高压缩比 | 节省存储空间 |
| H264 | AVC编码，兼容性好 | 老旧设备播放 |
| AV1 | 新一代开源编码 | 未来格式兼容 |
| x265 | H265的另一种标识 | 规则兼容处理 |
3. 来源与封装格式
| 参数标识 | 含义说明 | 优先级建议 |
|---|---|---|
| BLURAY | 蓝光原盘/REMUX | 高画质优先 |
| WEBDL | 流媒体下载版 | 平衡画质与体积 |
| WEB | 普通网络版 | 低带宽场景 |
| REMUX | 无损蓝光提取 | 极致画质追求 |
| HDTV | 电视录制版 | 稀有资源获取 |
4. 语言与字幕参数
| 参数标识 | 含义说明 | 组合使用 |
|---|---|---|
| CNVOI | 中文配音 | CNVOI & CNSUB |
| CNSUB | 中文字幕 | !CNSUB（排除无中字） |
| CHS | 简体中文 | CHS & !CHT |
| CHT | 繁体中文 | CHT & !CHS |
| SPECSUB | 特效字幕 | 动漫资源优先 |
规则表达式语法
基础逻辑运算符
系统采用类布尔代数的表达式语法，支持三种基本逻辑运算：
-
与运算(&)：需同时满足多个条件
示例：4K & HDR & CNSUB（4K分辨率且HDR且中文字幕） -
或运算(|)：满足任一条件即可
示例：H265 | AV1（H265或AVC编码） -
非运算(!)：排除指定条件
示例：!3D & !SDR（排除3D和SDR资源）
优先级规则
当表达式包含多种运算符时，遵循以下优先级：
- 括号内表达式
- 非运算(!)
- 与运算(&)
- 或运算(|)
复杂示例解析：
4K & (HDR | DolbyVision) & !(BLURAY | REMUX)
含义：4K分辨率且（HDR或杜比视界）且（非蓝光原盘且非REMUX）
规则组合与优先级
通过>符号定义规则优先级，系统按顺序匹配，命中即停止：
SPECSUB & CNVOI & 4K > CNSUB & 4K > 1080P & H265
优先级解析：
- 优先匹配带特效字幕的中文配音4K资源
- 其次匹配普通中字4K资源
- 最后匹配1080P H265编码资源
实战场景配置案例
1. 4K电影收藏方案
需求：追求高画质但控制体积，需中文字幕，排除低帧率内容
4K & HDR & CNSUB & !SDR & !24FPS & (H265 | AV1) & !BLURAY
解析：
- 核心条件：4K分辨率+HDR动态范围+中文字幕
- 排除条件：SDR内容、24fps低帧率、蓝光原盘（体积过大）
- 编码偏好：H265或AV1高效编码
2. 动漫资源专项规则
需求：特效字幕优先，偏好高帧率，排除生肉资源
ANIME & (SPECSUB | CNSUB) & !RAW & (1080P | 720P) & (60FPS | 30FPS)
解析：
- 类型限定：ANIME（系统内置类型标识）
- 字幕要求：特效字幕或普通中字
- 画质控制：1080P/720P分辨率，30/60fps帧率
- 排除生肉：!RAW确保有字幕
3. 空间优化配置
需求：在有限存储空间下最大化内容数量
(H265 & 1080P) | (AV1 & 720P) & !BLURAY & !REMUX & SIZE<5GB
解析：
- 编码优先：H265 1080P或AV1 720P
- 体积控制：排除蓝光原盘，限制单文件<5GB
- 平衡策略：通过高效编码在有限空间存储更多内容
高级配置技巧
1. 动态阈值设定
结合系统配置文件config/app.env中的高级参数，实现动态筛选：
# 配置文件中设置
MAX_SIZE_4K=20 # 4K资源最大20GB
MAX_SIZE_1080P=8 # 1080P资源最大8GB
# 规则中引用
4K & SIZE<${MAX_SIZE_4K} & HDR
2. 季节性规则调整
利用系统定时任务，根据季度自动切换规则：
3. 多规则组合策略
针对不同内容类型应用差异化规则，在category.yaml中配置：
movie:
华语电影:
original_language: zh,cn
filter_rule: 1080P & CNSUB & !WEBDL
外语电影:
original_language: !zh,!cn
filter_rule: 4K & HDR & (CNSUB | CHSUB)
常见问题解决方案
规则不生效排查流程
性能优化建议
- 减少规则复杂度：拆分过长表达式，避免嵌套过深
- 利用缓存机制：配置
META_CACHE_EXPIRE=24减少重复解析 - 批量测试规则：通过
tools/rule_tester.py验证规则效率
规则冲突解决
当全局规则与分类规则冲突时，遵循以下优先级：
- 订阅特定规则（最高）
- 分类规则（category.yaml）
- 全局默认规则（最低）
冲突示例解决：在category.yaml中为动漫分类单独配置规则，覆盖全局设置。
规则模板库
入门级模板
均衡观影模板：
(1080P & H265) | (4K & HDR) & CNSUB & !3D & !RAW
低带宽模板：
720P & H265 & SIZE<2GB & CNSUB
进阶级模板
动漫爱好者：
ANIME & (1080P | 720P) & (SPECSUB | CNSUB) & !WEB & !RAW
影视收藏级：
(BLURAY | REMUX) & (4K | 1080P) & HDR & !SDR & CNSUB
专家级模板
杜比视界专项：
DolbyVision & 4K & !HDR10 & BLURAY & SIZE>30GB
空间效率优化：
H265 & (1080P & SIZE<8GB | 720P & SIZE<4GB) & CNSUB & !INTERLACED
配置部署指南
规则文件位置
根据部署方式不同，规则配置文件位置：
- Docker部署：
/config/filter_rules.yaml - 本地部署：
./config/filter_rules.yaml - 源码运行：
./config/filter_rules.yaml
应用规则步骤
- 编辑规则文件：
# filter_rules.yaml示例
default:
movie: "4K & HDR & CNSUB & !BLURAY"
tv: "1080P & H265 & CNSUB"
anime:
filter: "ANIME & SPECSUB & (1080P | 720P) & !RAW"
priority: "SPECSUB > CNSUB > CHSUB"
- 重启生效：
# Docker重启命令
docker restart moviepilot
# 本地部署重启
python main.py restart
- 验证规则： 通过系统日志
logs/filter.log查看规则应用情况，或在WebUI的"筛选测试"工具中验证。
最佳实践与注意事项
规则设计原则
- 明确需求：先定义清晰的画质/体积/语言需求
- 逐步优化：从简单规则开始，逐步添加条件
- 定期审查：根据存储变化和观看习惯调整规则
- 测试优先：新规则先在测试环境验证效果
资源特征权衡
| 需求维度 | 优先级策略 | 妥协方案 |
|---|---|---|
| 画质优先 | BLURAY > WEBDL > WEB | 接受稍大体积 |
| 空间优先 | H265 > AV1 > H264 | 降低分辨率要求 |
| 速度优先 | WEB > WEBDL > BLURAY | 牺牲部分画质 |
| 兼容性优先 | H264 > H265 > AV1 | 避免特殊编码 |
避免常见陷阱
- 过度筛选：条件过多导致无匹配结果，建议最多5-7个条件组合
- 矛盾条件：如
BLURAY & SIZE<2GB通常无法满足 - 忽略更新：定期检查TMDB类型ID变化，确保分类准确
- 资源浪费：盲目追求高画质导致存储空间利用率低
【免费下载链接】MoviePilot NAS媒体库自动化管理工具 项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
