在 MoviePilot V3 的资源搜索、订阅和自动筛选场景中，合理配置优先级规则，可以让系统按照自己的需求选择电影、电视剧和音乐资源。
例如，我希望电影和电视剧按照以下顺序筛选：
4K 特效字幕
4K 中文字幕
1080P 特效字幕
1080P 中文字幕
同时排除杜比视界和蓝光原盘类资源，避免部分资源因为特殊封装、多文件目录结构或播放兼容性问题影响 NAS 媒体库的整理。
音乐则优先选择高解析度无损音频，其次是普通无损音频，最后才考虑有损格式。
MoviePilot V3 中有两种容易混淆的配置：自定义优先级规则项和优先级规则组。它们虽然都与资源筛选有关，但 JSON 结构和使用目的并不相同。
一、两种规则的核心区别
需要特别注意： 表格中的“自定义规则项”是根据你提供的 JSON 字段结构进行解释的。字段是否由当前 MoviePilot V3 版本实际读取、include 中的分隔符究竟表示 AND 还是 OR，以及规则项 ID 是否参与排序，都需要以对应版本的实现或实际测试为准，不能只凭字段名称推断。
二、自定义优先级规则项
1. 规则结构
本地测试的自定义规则项格式如下：
[
{
"id": "RULE1",
"name": "特效字幕4K",
"include": "特效字幕|4K",
"exclude": "杜比视界|蓝光原盘|蓝光光盘"
},
{
"id": "RULE2",
"name": "中文字幕4K",
"include": "中文字幕|4K",
"exclude": "杜比视界|蓝光原盘|蓝光光盘"
},
{
"id": "RULE3",
"name": "特效字幕1080P",
"include": "特效字幕|1080P",
"exclude": "杜比视界|蓝光原盘|蓝光光盘"
},
{
"id": "RULE4",
"name": "中文字幕1080P",
"include": "中文字幕|1080P",
"exclude": "杜比视界|蓝光原盘|蓝光光盘"
}
]各字段的设计意图如下。
id：规则标识符，例如RULE1，用于区分规则项。它不一定代表实际执行顺序。name：规则的可读名称，方便在配置界面或其他逻辑中识别。include：描述希望匹配的关键词或条件。exclude：描述希望排除的关键词或条件。
其中，| 是测试所使用格式中的分隔符。它在实际程序中究竟表示“满足任意一项”还是其他匹配逻辑，需要检查该版本的解析实现。不能直接把 特效字幕|4K 等同于已验证的“同时满足特效字幕和 4K”。
2. 这种规则有什么价值？
自定义规则项更适合把常用条件整理成独立的规则。例如：
特效字幕4K：描述对 4K 特效字幕资源的偏好。
中文字幕4K：描述对 4K 中文字幕资源的偏好。
特效字幕1080P：描述对 1080P 特效字幕资源的偏好。
中文字幕1080P：描述对 1080P 中文字幕资源的偏好。
将这些条件独立命名，便于维护、调整和复用。
但是，定义了四个规则项，不等于系统一定会按照 RULE1、RULE2、RULE3、RULE4 的顺序执行。 是否存在独立排序机制、是否根据 ID 或数组顺序执行，需要由实际实现确定。
三、优先级规则组
1. 规则结构
MoviePilot V3 的优先级规则组使用另一种结构：
[
{
"name": "电影",
"media_type": "电影",
"rule_string": "SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY > SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY"
},
{
"name": "电视剧",
"media_type": "电视剧",
"rule_string": "SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY > SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY"
},
{
"name": "音乐",
"media_type": "音乐",
"rule_string": "HIRES & FLAC > HIRES & ALAC > HIRES & WAV > HIRES & APE > HIRES & DSD > FLAC > ALAC > WAV > APE > DSD > MP3 > AAC > OPUS"
}
]与自定义规则项不同，优先级规则组直接把多个条件组合成一个完整的规则表达式。
2. name、media_type 和 rule_string
name：规则组名称，例如电影、电视剧、音乐。media_type：指定规则组对应的媒体类型。rule_string：由多个条件和优先级层级组成的规则表达式。
这里的 media_type 用于区分不同类型的媒体规则。电影和电视剧可以采用相似的筛选策略，但仍然可以分别维护；音乐则使用独立的音频规则。
3. &、! 和 > 的作用
根据当前提供的规则表达式，其设计意图可以理解为：
&：连接同一层级内的多个条件，通常用于表达同时满足多个条件。!：表示排除或否定对应条件。>：分隔不同优先级层级，左侧的层级优先于右侧的层级。
例如：
SPECSUB & 4K & !DOLBY & !BLU & !BLURAY
>
CNSUB & 4K & !DOLBY & !BLU & !BLURAY它表达的设计意图是：优先选择满足特效字幕、4K 且不满足指定排除条件的资源；如果没有合适的高优先级资源，再考虑下一层的 4K 中文字幕资源。
上述解释基于表达式的使用方式。实际匹配仍以当前 V3 版本的规则解析器和标签定义为准。
四、电影和电视剧规则为什么这样设置？
1. 第一优先级：4K 特效字幕
SPECSUB & 4K & !DOLBY & !BLU & !BLURAY将 4K 和特效字幕组合在第一层，是为了兼顾画面分辨率与字幕体验。
这里的 SPECSUB、4K 是规则表达式中使用的标识符，不是中文关键词本身。应确认当前版本的规则词表中，它们分别对应什么标签。
2. 第二优先级：4K 中文字幕
CNSUB & 4K & !DOLBY & !BLU & !BLURAY如果没有符合第一层的资源，就继续考虑 4K 中文字幕资源。
这体现了一个明确的取舍：在本规则中，4K 分辨率优先于 1080P，而特效字幕优先于普通中文字幕。
这并不代表所有人都应该采用相同顺序。如果更重视字幕可读性、文件体积或播放兼容性，可以根据实际需求调整。
3. 第三优先级：1080P 特效字幕
SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY当没有符合前两层的资源时，再考虑 1080P 特效字幕。
这样可以在高分辨率资源不符合要求时保留一个可接受的替代方案。
4. 第四优先级：1080P 中文字幕
CNSUB & 1080P & !DOLBY & !BLU & !BLURAY这是最后一层常规候选资源，用于在前三层均无法满足时提供进一步选择。
5. 为什么排除杜比视界？
规则使用了：
!DOLBY这样设计的目的，是尽量避开当前家庭播放环境中可能存在兼容性问题的杜比相关视频资源。
但必须区分：规则标签 DOLBY 是否专指杜比视界，取决于当前 MoviePilot V3 的标签定义。如果该标签也匹配其他杜比相关信息，就可能产生额外排除。因此，不应仅凭名称断定它一定只排除杜比视界，也不能据此认定它会排除杜比全景声音轨。
6. 为什么排除蓝光相关资源？
规则中包含：
!BLU & !BLURAY目的是排除被规则引擎识别为蓝光相关的资源，尤其是希望避免管理起来比较复杂的蓝光原盘目录结构。
不过，蓝光原盘、蓝光光盘、蓝光压制版并不是完全相同的概念。BLU 和 BLURAY 是否会匹配这些类别，必须以当前版本的标签定义为准。它们不一定能够精准地排除所有 BDMV 或 DCP 目录，也不一定能在排除原盘的同时保留所有蓝光压制版。
五、音乐规则为什么这样设置？
当前音乐规则是：
HIRES & FLAC
>
HIRES & ALAC
>
HIRES & WAV
>
HIRES & APE
>
HIRES & DSD
>
FLAC
>
ALAC
>
WAV
>
APE
>
DSD
>
MP3
>
AAC
>
OPUS这套规则的设计思路是：优先考虑高解析度音频，其次考虑普通无损格式，最后考虑有损格式。
1. 第一层：高解析度无损音频
这里把 HIRES 与具体格式组合起来，是为了表达“高解析度标签与指定格式同时匹配”的意图。是否能够识别这些组合，取决于实际规则词表。
2. 第二层：普通无损音频
FLAC > ALAC > WAV > APE > DSD当没有符合前面高解析度条件的资源时，再考虑常规无损格式。
FLAC、ALAC、WAV、APE 和 DSD 的封装方式、解码需求以及客户端兼容性有所不同。这里的顺序属于个人偏好，不代表它们在音质上存在绝对排名。
3. 第三层：有损音频
MP3 > AAC > OPUS这部分用于在无损资源不可用时保留其他音频选择。
需要注意，音频格式的实际播放能力取决于 NAS 上的媒体服务、播放客户端、封装和转码链路。不能仅凭格式名称就认定所有客户端都能直接播放。
六、从测试聊天整理出的过滤参数
下面只整理测试聊天中实际出现过的标识符，并区分“出现在规则表达式中”和“已经确认受当前版本支持”这两个概念。
1. 电影和电视剧相关
2. 音乐相关
3. 其他曾在测试聊天出现的标识符
此前还出现过以下内容：
LOSSLESS
BITRATE192
UHD
SDR
HDR
DOLBY这些标识符曾出现在之前的规则示例或讨论中，但仅凭聊天记录，不能证明它们全部是当前 MoviePilot V3 规则引擎支持的有效参数。
同样，SPECSUB、CNSUB、4K、1080P、HIRES 等虽然已经出现在当前规则组中，也仍应通过当前版本的规则列表、源码或实际测试确认。
因此，本文整理的是测试聊天中出现过的参数，而不是官方完整参数清单。
七、70GB 文件大小限制应该在哪里设置？
电影规则的筛选条件目前没有包含文件体积限制。
例如，下面的表达式：
SPECSUB & 4K & !DOLBY & !BLU & !BLURAY只能表达对应的标签筛选意图，并没有直接表示“文件不超过 70GB”。
如果需要电影单文件不超过 70GB，应在 MoviePilot V3 对应的资源体积、订阅或下载限制设置中单独配置。具体入口和支持的限制方式，需要以当前部署版本为准。
另外，资源体积限制是否能够按电影、电视剧分别设置，也需要结合实际配置能力确认。
八、让其他 AI 工具生成 MoviePilot V3 规则时，应该怎么写？
如果希望其他 AI 编程工具继续生成、修改或检查规则，建议明确以下约束，避免工具自行发明字段或参数。
请为当前部署版本的 MoviePilot V3 生成优先级规则。
一、先识别规则类型
1. 自定义规则项使用当前系统实际支持的字段结构。
2. 优先级规则组使用当前系统实际支持的字段结构。
3. 不要混用两种 JSON 格式。
4. 不要自行添加未经源码或实际配置确认的字段。
二、优先级规则组
1. 规则组名称为：电影、电视剧、音乐。
2. 使用系统支持的 media_type 和 rule_string 字段。
3. 使用当前版本实际支持的规则标识符。
4. 按需求使用 > 表达优先级层级。
5. 在生成前确认 &、!、> 的实际解析语义。
6. 不要将自定义规则项中的中文关键词直接当成 rule_string 的有效标识符，除非已确认支持。
三、电影和电视剧的目标优先级
1. 4K 特效字幕。
2. 4K 中文字幕。
3. 1080P 特效字幕。
4. 1080P 中文字幕。
目标排除项：
- 杜比视界相关资源。
- 蓝光原盘或蓝光光盘类资源。
排除项必须映射到当前版本实际支持的标签。不要假定一个标签一定只匹配单一资源类别。
四、音乐的目标优先级
1. 高解析度 FLAC。
2. 高解析度 ALAC。
3. 高解析度 WAV。
4. 高解析度 APE。
5. 高解析度 DSD。
6. 普通 FLAC。
7. 普通 ALAC。
8. 普通 WAV。
9. 普通 APE。
10. 普通 DSD。
11. MP3。
12. AAC。
13. OPUS。
以上顺序是用户偏好，不代表音质的绝对排名。
生成规则前应确认 HIRES 及各格式标签的实际匹配能力。
五、验证要求
1. 优先参考当前部署版本的官方文档、规则列表、源码或实际导出配置。
2. 明确区分已验证参数和仅从历史规则中发现的参数。
3. 不得凭空编造参数、字段或标签。
4. 检查 JSON 语法、字段名称、媒体类型和规则表达式。
5. 提供完整可复制的 JSON。
6. 明确说明 70GB 文件体积限制是否需要在其他设置中单独配置。
7. 如果无法确认某个参数的含义，先标注待验证，不要声称已经验证通过。九、总结
两种规则的区别，可以概括为：
自定义规则项：用于定义一条条具体的匹配规则，当前示例采用
id、name、include、exclude字段。优先级规则组：用于把多个匹配条件组织成一套有先后顺序的筛选策略，当前示例采用
name、media_type、rule_string字段。>：在当前规则组中用于表达不同优先级层级。电影和电视剧：按 4K 特效字幕、4K 中文字幕、1080P 特效字幕、1080P 中文字幕的顺序筛选。
音乐：优先高解析度无损音频，再考虑普通无损格式，最后考虑有损格式。
70GB 限制：当前规则表达式没有体现，应检查并配置对应的体积限制功能。
过滤参数：本文列出的是当前聊天中出现过的标识符，不是已经完整核验的官方参数列表。
实际使用时，建议先从当前 MoviePilot V3 实例导出规则，再通过少量测试资源验证每个标签的匹配结果。确认字段结构、分隔符语义和标签范围后，再批量用于搜索与订阅，避免因为规则理解偏差导致漏选或误选资源。
一、照抄使用案例
优先级规则组
预设优先级规则组，以便在搜索和订阅中使用。
4K中字优先
[ { "name": "电影", "media_type": "电影", "rule_string": "SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY > SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY" }, { "name": "电视剧", "media_type": "电视剧", "rule_string": "SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY > SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY" }, { "name": "音乐", "media_type": "音乐", "rule_string": "HIRES & FLAC > HIRES & ALAC > HIRES & WAV > HIRES & APE > HIRES & DSD > FLAC > ALAC > WAV > APE > DSD > MP3 > AAC > OPUS" } ]1080P中字优先
[ { "name": "电影", "media_type": "电影", "rule_string": "SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY > SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY" }, { "name": "电视剧", "media_type": "电视剧", "rule_string": "SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY > CNSUB & 1080P & !DOLBY & !BLU & !BLURAY > SPECSUB & 4K & !DOLBY & !BLU & !BLURAY > CNSUB & 4K & !DOLBY & !BLU & !BLURAY" }, { "name": "音乐", "media_type": "音乐", "rule_string": "HIRES & FLAC > HIRES & ALAC > HIRES & WAV > HIRES & APE > HIRES & DSD > FLAC > ALAC > WAV > APE > DSD > MP3 > AAC > OPUS" } ]
MoviePilot V3 媒体资源优先级规则说明
一、规则设计目标
本规则组主要面向使用群晖 DSM、飞牛 NAS 等系统的家庭媒体库用户，结合当前主流 Intel 核显平台的硬件解码能力，以及 Emby、Jellyfin 等媒体服务的使用场景，对电影、电视剧和音乐资源进行分级筛选。
规则设计遵循以下原则：
画质优先： 影视资源优先选择 4K，其次选择 1080P。
字幕优先： 在相同分辨率下，优先选择特效字幕，其次选择中文字幕。
兼容性优先： 默认排除杜比视界和蓝光原盘相关资源，减少播放兼容性、媒体识别及整理方面的问题。
资源管理优先： 尽量选择适合 NAS 单文件管理、刮削和播放的资源，减少复杂目录结构带来的维护成本。
音乐兼顾品质与实用性： 优先考虑高解析度无损音乐，其次考虑常规无损音乐，最后兼顾常见有损音频格式。
二、电影优先级规则
优先级 1：4K 特效字幕
规则：
SPECSUB & 4K & !DOLBY & !BLU & !BLURAY
优先选择同时满足 4K 和特效字幕条件的资源，并排除杜比视界及蓝光原盘相关标识。
选择理由：
4K 分辨率能够提供更高的画面细节。
特效字幕通常更适合包含字体、位置、颜色及特效处理的影视内容。
排除指定类型有助于减少不符合当前媒体库管理策略的资源。
优先级 2：4K 中文字幕
规则：
CNSUB & 4K & !DOLBY & !BLU & !BLURAY
当没有符合优先级 1 的资源时，优先选择带有中文字幕的 4K 资源。
选择理由：
保留 4K 画质优先的原则。
兼顾中文用户的观看需求。
即使没有特效字幕，也不必直接降低到 1080P。
优先级 3：1080P 特效字幕
规则：
SPECSUB & 1080P & !DOLBY & !BLU & !BLURAY
当没有符合前两个层级的资源时，选择 1080P 特效字幕资源。
选择理由：
1080P 对多数家庭电视和移动设备仍然具有较好的观看体验。
相比部分高码率 4K 资源，1080P 资源通常占用更少的存储空间和网络带宽。
保留特效字幕偏好，满足对字幕呈现效果有要求的用户。
优先级 4：1080P 中文字幕
规则：
CNSUB & 1080P & !DOLBY & !BLU & !BLURAY
这是影视规则中的第四优先级，在更高层级都没有合适资源时使用。
选择理由：
确保资源选择具有一定的灵活性。
在画质与字幕类型之间取得平衡。
避免因没有特效字幕而完全错过可用的 1080P 资源。
三、电视剧优先级规则
电视剧采用与电影相同的四级优先顺序：
4K 特效字幕
4K 中文字幕
1080P 特效字幕
1080P 中文字幕
这样可以使电影和电视剧保持一致的资源筛选策略，便于统一维护媒体库。
电视剧往往包含多个季和大量剧集，采用相对统一的分辨率及字幕规则，也有助于保持同一剧集的观看体验一致。
需要注意，实际下载时还应考虑整季完整性、剧集编号、字幕匹配及版本一致性；本规则组本身并不保证这些条件。
四、为什么排除杜比视界
排除标识：!DOLBY
杜比视界（Dolby Vision）是一种 HDR 视频技术，并非 NAS 无法存储或识别的格式。排除它主要是出于家庭媒体播放兼容性的考虑。
不同电视、播放设备、媒体客户端及转码链路对杜比视界的支持程度存在差异。某些组合可能出现 HDR 效果丢失、色彩异常或无法直接播放的情况。
对于希望尽可能实现跨设备播放的家庭媒体库，优先选择兼容性较好的常规 4K 或 1080P 资源，是一种较为稳妥的策略。
需要注意：
排除杜比视界不等于排除 HDR10。
!DOLBY是否能准确匹配所有杜比视界资源，取决于 MoviePilot 当前版本的规则识别方式。该条件不应被理解为排除杜比全景声等所有 Dolby 音频格式。
五、为什么排除蓝光原盘
排除标识：!BLU & !BLURAY
这里的目标主要是避免下载采用复杂目录结构的原盘资源，例如包含大量文件和目录的 BDMV 结构，以及不适合常规家庭媒体库管理的 DCP 资源。
排除这些资源的主要原因包括：
减少识别错误： 多文件目录可能被部分媒体整理流程识别为多个独立影片，造成重复条目或杂乱的媒体库。
降低管理成本： 原盘目录通常包含多个播放列表、音视频片段及其他附属文件，整理和排查问题更加复杂。
提高资源使用效率： 选择常见的单文件压制版本，通常更便于下载、校验、移动、备份和媒体刮削。
需要特别说明，!BLU 和 !BLURAY 是否足以排除所有 BDMV 或 DCP 资源，需要根据实际资源名称和 MoviePilot 的规则词表进行验证。它们也可能排除部分采用 BluRay 标签、但实际上是单文件压制的资源。
因此，这项规则的实际效果取决于资源命名及规则匹配结果，而不是仅凭标签就能保证所有原盘目录均被过滤。
六、音乐优先级规则
音乐规则采用从高到低的排序：
Hi-Res + FLAC
Hi-Res + ALAC
Hi-Res + WAV
Hi-Res + APE
Hi-Res + DSD
FLAC
ALAC
WAV
APE
DSD
MP3
AAC
OPUS
第一层：高解析度无损音乐
优先考虑带有 Hi-Res 标识的 FLAC、ALAC、WAV、APE 和 DSD 资源。
这类资源适合希望保留较高音频品质、使用高品质耳机或音响系统的用户。但 Hi-Res 标签本身不能保证资源一定具有更好的实际音质，仍需考虑原始母带、采样率、位深及编码来源。
第二层：常规无损音乐
包括 FLAC、ALAC、WAV、APE 和 DSD。
这一级别兼顾音质与日常音乐收藏需求。FLAC 具有较好的无损压缩效率和广泛的应用支持，因此对于普通 NAS 音乐库尤其具有实用价值。
ALAC 更适合 Apple 生态，WAV 具有较高的兼容性但通常占用更多空间，APE 和 DSD 则需要根据实际播放器的解码能力进行选择。
第三层：常见有损音乐
包括 MP3、AAC 和 OPUS。
这些格式适合日常收听、移动设备播放以及节省存储空间的场景。
MP3 兼容性广泛；AAC 常见于 Apple 设备和流媒体内容；OPUS 在较低码率下具有较好的压缩效率，但部分硬件播放器或客户端可能需要转码。
音乐规则的适用范围
音乐资源的实际兼容性取决于飞牛音乐、Audio Station、Navidrome、Emby、Jellyfin 等应用及其客户端的支持情况。即使 NAS 能够存储某种格式，也不意味着所有客户端都可以直接播放。
另外，当前规则只包含上述音频标识。如果 MoviePilot 的规则匹配采用严格的 AND 逻辑，那么 HIRES & FLAC 表示资源需要同时匹配这两个条件；而不同层级的格式支持情况仍需以实际规则词表为准。
七、规则的适用边界
本规则组主要负责资源的优先级筛选，并不替代其他下载和媒体管理设置。
以下项目需要单独配置或验证：
电影单文件最大 70GB： 应在 MoviePilot 的资源体积限制中单独设置；当前规则组 JSON 不包含体积参数。
分辨率严格限制： 目前只明确列出 4K 和 1080P。若资源名称没有对应标签，或者规则识别未覆盖相应写法，可能无法按预期匹配。
原盘过滤： 需要验证 BDMV、DCP 等实际资源是否会被排除。
字幕类型识别：
SPECSUB和CNSUB的实际识别结果取决于 MoviePilot 的规则词表。编码及播放兼容性： 本规则没有明确限制 H.264、H.265、音频编码、封装格式或字幕封装，因此不能保证所有命中资源都能在每个客户端直接播放。
八、总结
这套规则的核心目标是建立一个便于长期维护的家庭媒体库：
影视资源坚持 4K 优先、1080P 兜底。
同一分辨率下优先特效字幕，其次中文字幕。
默认排除杜比视界和蓝光原盘相关资源，以降低部分播放兼容性及复杂目录整理问题。
音乐优先考虑高解析度无损与常规无损格式，同时保留常见有损格式。
体积、资源完整性、实际解码能力和媒体识别准确性由独立设置及实际测试进一步保障。
需要明确的是，Intel 第 12 代及以上核显并不意味着所有视频格式、HDR 类型和音频编码都能直接硬件解码。合理的资源筛选应以整个播放链路的兼容性为目标，而不是只依据处理器代际判断。
评论