MoviePilot 媒体库分类完整指南：一个配置文件，自动切分你的影视目录

MoviePilot 媒体库分类完整指南：一个配置文件，自动切分你的影视目录

【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot

MoviePilot 跑了一段时间后，电影和剧集很容易堆在同一个目录里，找起来全靠猜。其实系统内置了自动分类能力：只要编辑一份 YAML 配置，资源在整理入库时就会被自动归入「国产剧」「日番」「动画电影」这类子目录，而且分类名就是目录名。这篇文章带你把这套规则配好、验证生效，再学会几条进阶玩法。

先说结果：配完长什么样

配置生效后，电影和电视剧会按你声明的分类落到独立目录中，例如：

/媒体库/ ├─ 电影/ │ ├─ 动画电影/ │ ├─ 华语电影/ │ └─ 外语电影/ └─ 剧集/ ├─ 国漫/ ├─ 日番/ ├─ 国产剧/ └─ 未分类/

三条基础规则要先记住，后面所有操作都建立在它们之上：

1. movie和tv两个一级节点是固定名称，不能改；
2. 二级分类按声明顺序匹配，首个命中的规则生效，后面的不会再参与判断；
3. 分类名（比如「国产剧」）会直接作为目录名写入媒体库。

动手前：找到配置文件，看懂匹配规则

规则写在 config/category.yaml 中。打开它，文件头部有完整的字段说明，底部还内置了三个字典：内容类型编码、语种编码、国家地区编码，后面写规则时随时可以查。

每条规则支持以下条件，同一条件下多个可选值用逗号分隔：

匹配逻辑上，同一条件的多个值是"或"，多个条件之间是"与"。想排除某个值，在值前面加!。最后留一个不写任何条件的空节点，作为兜底分类。

核心配置：三步搭好电影与电视剧规则

第一步：电影先切动画，再切语种

电影分类建议只留两到三个大类。先把动画抽出来，剩下按语种分，其余全部进兜底：

movie: 动画电影: genre_ids: '16' 华语电影: original_language: 'zh,cn,bo,za' 外语电影:

为什么这样排？动画的识别最可靠（类型编码 16 很明确），放最前能优先命中；华语电影用四个中文相关语种编码兜住绝大多数国产片；外语电影不写任何条件，所有没被前面规则接住的电影都会进来，保证不留空档。

第二步：电视剧按"内容类型 + 地区"细分

电视剧的目录价值更高，可以细分。文件里的默认结构就是好范本：

tv: 国漫: genre_ids: '16' origin_country: 'CN,TW,HK' 日番: genre_ids: '16' origin_country: 'JP' 纪录片: genre_ids: '99' 儿童: genre_ids: '10762' 综艺: genre_ids: '10764,10767' 国产剧: origin_country: 'CN,TW,HK' 欧美剧: origin_country: 'US,FR,GB,DE,ES,IT,NL,PT,RU,UK' 日韩剧: origin_country: 'JP,KP,KR,TH,IN,SG' 未分类:

注意两处设计：一是「国漫」同时写类型和地区两个条件，避免日本动画混进国漫；二是类型类规则（纪录片、儿童、综艺）排在地区类规则之前，因为它们更具体——顺序一乱，一部国产综艺就会先被划进「国产剧」。最后的空节点未分类是兜底，元数据不全的资源不会丢失，只是集中放在一个目录里事后处理。

第三步：常用编码速查

不需要死记，配置里注释就有全表。这里列最常用的：

如何确认分类生效，以及它管到哪儿

规则保存后由系统自动加载，不需要重启服务。验证很直接：等一个新媒体资源完成整理，看目标路径上是否多了一层分类目录。也可以搜一下日志里的 category 关键字，查看分类判定记录。

分类不是只影响文件夹。它贯穿几条链路：

• 下载入库：新资源下载完转存时，分类决定最终落盘目录；
• 本地整理与扫描：把已有文件导入媒体库、重新整理历史资源时，同样按当前规则重新计算目录；
• 存储与媒体服务器：Emby、Plex、Jellyfin 等媒体服务器同步的是这套目录结构，分类清晰，服务器里的浏览结构也就清晰。

分类结果以library_category形式记录在媒体信息里，所以你在整理预览、转存历史中看到的目录名，就是规则算出来的结果。

进阶：三个可直接抄的规则"配方"

以下配方都是"在兜底节点之前插入一条规则"，位置越靠前优先级越高。

配方一：按年份圈住经典片

经典电影: release_year: '1900-1990'

release_year支持单个年份（YYYY）和区间（YYYY-YYYY）。电影取上映日期，剧集取首播日期。

配方二：用排除条件做减法

非韩动画: genre_ids: '16' original_language: '!ko'

!表示"不等于"，这里把韩语动画从动画大类里剔出去，单独管理。

配方三：多条件组合精确圈定

欧美喜剧: genre_ids: '35' origin_country: 'US,GB,FR' original_language: 'en,fr'

类型、地区、语种同时满足才会命中，适合把"高优先级小目录"做得很细。建议整个库的分类层级控制在三级以内，规则宁少勿多——规则越多，排查"某部剧为什么落错目录"的成本越高。

常见坑与下一步

三个高频问题的排查思路：

1. 改了配置却没变化：多半是 YAML 缩进错了或值漏了引号。分类值统一写成带引号的字符串，用任意 YAML 校验工具过一遍格式。
2. 资源全落进"未分类"：通常是元数据缺失——TMDB 详情里origin_country、genre_ids等字段为空时条件不满足。先看资源识别是否正常，再考虑调整规则顺序。
3. 一部片落错了分类：记住"首个命中即止"。往上找更早声明、条件更宽泛的规则，把更具体的规则挪到它前面。

下一步建议：把 config/category.yaml 底部的字典注释当成速查手册用；如果你在用较新的版本，分类策略还支持通过版本化策略接口做可视化管理与迁移，细节可参考 docs/v2-to-v3-overview.md。

一张速查表收尾：

【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot