MoviePilot 媒体库分类完整指南一个配置文件自动切分你的影视目录【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilotMoviePilot 跑了一段时间后电影和剧集很容易堆在同一个目录里找起来全靠猜。其实系统内置了自动分类能力只要编辑一份 YAML 配置资源在整理入库时就会被自动归入「国产剧」「日番」「动画电影」这类子目录而且分类名就是目录名。这篇文章带你把这套规则配好、验证生效再学会几条进阶玩法。先说结果配完长什么样配置生效后电影和电视剧会按你声明的分类落到独立目录中例如/媒体库/ ├─ 电影/ │ ├─ 动画电影/ │ ├─ 华语电影/ │ └─ 外语电影/ └─ 剧集/ ├─ 国漫/ ├─ 日番/ ├─ 国产剧/ └─ 未分类/三条基础规则要先记住后面所有操作都建立在它们之上movie和tv两个一级节点是固定名称不能改二级分类按声明顺序匹配首个命中的规则生效后面的不会再参与判断分类名比如「国产剧」会直接作为目录名写入媒体库。动手前找到配置文件看懂匹配规则规则写在 config/category.yaml 中。打开它文件头部有完整的字段说明底部还内置了三个字典内容类型编码、语种编码、国家地区编码后面写规则时随时可以查。每条规则支持以下条件同一条件下多个可选值用逗号分隔条件字段适用对象含义genre_ids电影、电视剧内容类型如 16 动画、99 纪录original_language电影、电视剧原产语种如 zh 中文、ja 日语origin_country电视剧制片国家或地区如 CN、JPproduction_countries电影制片国家或地区release_year电影、电视剧发行年份支持YYYY或YYYY-YYYY范围匹配逻辑上同一条件的多个值是或多个条件之间是与。想排除某个值在值前面加!。最后留一个不写任何条件的空节点作为兜底分类。核心配置三步搭好电影与电视剧规则第一步电影先切动画再切语种电影分类建议只留两到三个大类。先把动画抽出来剩下按语种分其余全部进兜底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 未分类:注意两处设计一是「国漫」同时写类型和地区两个条件避免日本动画混进国漫二是类型类规则纪录片、儿童、综艺排在地区类规则之前因为它们更具体——顺序一乱一部国产综艺就会先被划进「国产剧」。最后的空节点未分类是兜底元数据不全的资源不会丢失只是集中放在一个目录里事后处理。第三步常用编码速查不需要死记配置里注释就有全表。这里列最常用的类别值含义genre_ids16/99/10762动画 / 纪录 / 儿童genre_ids10764,10767综艺original_languagezh,cn中文original_languageen/ja/ko英语 / 日语 / 韩语国家编码CN,TW,HK中国内地 / 台湾 / 香港国家编码US,GB/JP,KR美国、英国 / 日本、韩国如何确认分类生效以及它管到哪儿规则保存后由系统自动加载不需要重启服务。验证很直接等一个新媒体资源完成整理看目标路径上是否多了一层分类目录。也可以搜一下日志里的 category 关键字查看分类判定记录。分类不是只影响文件夹。它贯穿几条链路下载入库新资源下载完转存时分类决定最终落盘目录本地整理与扫描把已有文件导入媒体库、重新整理历史资源时同样按当前规则重新计算目录存储与媒体服务器Emby、Plex、Jellyfin 等媒体服务器同步的是这套目录结构分类清晰服务器里的浏览结构也就清晰。分类结果以library_category形式记录在媒体信息里所以你在整理预览、转存历史中看到的目录名就是规则算出来的结果。进阶三个可直接抄的规则配方以下配方都是在兜底节点之前插入一条规则位置越靠前优先级越高。配方一按年份圈住经典片经典电影: release_year: 1900-1990release_year支持单个年份YYYY和区间YYYY-YYYY。电影取上映日期剧集取首播日期。配方二用排除条件做减法非韩动画: genre_ids: 16 original_language: !ko!表示不等于这里把韩语动画从动画大类里剔出去单独管理。配方三多条件组合精确圈定欧美喜剧: genre_ids: 35 origin_country: US,GB,FR original_language: en,fr类型、地区、语种同时满足才会命中适合把高优先级小目录做得很细。建议整个库的分类层级控制在三级以内规则宁少勿多——规则越多排查某部剧为什么落错目录的成本越高。常见坑与下一步三个高频问题的排查思路改了配置却没变化多半是 YAML 缩进错了或值漏了引号。分类值统一写成带引号的字符串用任意 YAML 校验工具过一遍格式。资源全落进未分类通常是元数据缺失——TMDB 详情里origin_country、genre_ids等字段为空时条件不满足。先看资源识别是否正常再考虑调整规则顺序。一部片落错了分类记住首个命中即止。往上找更早声明、条件更宽泛的规则把更具体的规则挪到它前面。下一步建议把 config/category.yaml 底部的字典注释当成速查手册用如果你在用较新的版本分类策略还支持通过版本化策略接口做可视化管理与迁移细节可参考 docs/v2-to-v3-overview.md。一张速查表收尾要做的事改哪里关键点加一个新分类在兜底节点前插入越具体越靠前改目录名直接改分类名分类名即目录名排除某类内容条件值前加!排除的是该值不是整条规则留兜底空条件节点必须有放最后【免费下载链接】MoviePilotNAS媒体库自动化管理工具项目地址: https://gitcode.com/gh_mirrors/mo/MoviePilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
