命名与目录

QPlay 会根据文件名识别电影或剧集，再按设置中的规则整理到媒体库。默认规则适合大多数用户，建议先不要修改。

使用名称识别测试

点击页面顶部的“名称识别测试”按钮：

输入一个真实文件名或文件夹路径；
点击“开始测试”；
查看识别出的标题、年份、季集、画质和目标路径；
确认结果后，再用少量文件运行自动整理。

TMDB 匹配会优先选择与文件名完整相同的片名。如果中文搜索结果没有显示文件名中的英文片名，系统会再比对英文标题；整理后的名称仍使用“媒体服务”中设置的 TMDB 语言。

如果识别结果不正确，优先在“设置 → 识别与排除”增加精准识别词，不要立即修改整套命名规则。

默认整理结果

电影通常整理为：

text

电影名 (年份)/电影名 (年份) - 画质.mkv

剧集通常整理为：

text

剧名 (年份)/Season 1/剧名 - S01E01.mkv

实际目录和文件名会根据识别结果、文件扩展名和媒体分类变化。当文件名只有数字集号（例如 30.1080p.mp4）时，系统会从所在剧集目录补全剧名。季号优先使用文件名中的明确标记，其次使用最近一级带季号的父目录；两者都没有时才按第一季处理。例如 剧名/Season 02/01.mkv 会整理为第二季第一集。S00 和 Season 00 表示特别篇，整理后保留第零季，不会并入第一季。

默认命名会按原文件写法保留清晰度、来源组合、动态范围、视频编码、音频编码、声道和 Atmos 信息。自定义模板可分别使用 videoFormat、resourceType、dynamicRange、videoCodec 和 audioCodec 变量；名称识别测试会显示各变量的实际值。

文件名中的画质、来源和发布组只是命名信息，不影响“仅保留最新版本”“仅保留最大版本”和“智能洗版”查找同一作品；这三种模式会比较同一作品、同一剪辑版和相同季集范围的已索引文件，即使最终名称不同。“多版本共存”只处理最终基础名相同的冲突，不同名始终保留。

导剪版身份只根据最终重命名文件名判断。“导剪版关键词词表”中的匹配原文可以通过 customization 变量保留到最终名称；只有最终名称仍包含该词，才会统一为导演剪辑版身份。原始发布名包含 Director's Cut，但模板没有输出该词时，不会与其他导剪版归为一组。QPlay 仍会单独保留整理前的发布名，用于质量比较和字幕匹配；original_title、original_name 命名变量表示 TMDB 中的原始片名，不是完整发布文件名。

分类目录

category.yaml 中原有的 movie 和 tv 仍表示二级分类。不开启“一级分类”时，路径保持为：

text

动画电影/电影名/...
国漫/剧名/...

开启“一级分类”后，可以用 primary_folders 自定义电影和剧集的一级目录。下面的完整 YAML 是最新版本配置参考；内置配置默认使用 电影 和 剧集，“动漫”一级规则保持注释，不会默认启用：

yaml

primary_folders:
  movie: 电影
  tv: 剧集

# primary_category_rules:
#   动漫:
#     media_types: tv
#     genre_ids: "16"

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

tv:
  国漫:
    genre_ids: "16"
    origin_country: "CN,TW,HK"
  日番:
    genre_ids: "16"
  纪录片:
    genre_ids: "99"
  综艺:
    genre_ids: "10764,10767"
  国产剧:
    origin_country: "CN,TW,HK"
  日韩剧:
    origin_country: "JP,KP,KR,TH,IN,SG"
  欧美剧:

保持上述默认注释时会生成：

text

电影/动画电影/电影名/...
剧集/国漫/剧名/...

按需取消 primary_category_rules 的注释后，动画剧集会改为：

text

动漫/国漫/剧名/...
动漫/日番/剧名/...

配置规则：

primary_category_rules 从上到下匹配，第一条命中规则生效；
media_types 只接受 movie、tv 或二者组合，省略时同时适用于电影和剧集；“动漫”仍然是一级目录，不是第三种媒体类型；
规则可以使用 genre_ids、origin_country、original_language 和 release_year 等 TMDB 元数据条件；
未命中一级规则时，电影和剧集分别回退到 primary_folders.movie 和 primary_folders.tv；
内置配置的 primary_folders 是 电影 和 剧集；原有仅包含 movie / tv 的旧版 YAML 仍然有效，缺少 primary_folders 时启用一级分类会沿用兼容目录 Movies 和 TV；
一级目录名必须是单个安全文件夹名称，不能包含 /、\ 或其他路径非法字符；
关闭“一级分类”后，primary_folders 和 primary_category_rules 不参与目标路径生成。

系统初始化选择“应用分类策略”时会在 115 媒体库中预建对应目录；同时选择“开始全量同步”时还会预建本地 STRM 分类目录。修改分类只影响后续整理路径，不会自动迁移已有的 115 文件、SQLite 记录或 STRM 文件；保存前应先用“名称识别测试”确认目标路径。

需要修改时

“设置 → 整理规则”提供电影格式和剧集格式。修改前请注意：

最后一段要保留原文件扩展名；
可选信息为空时，不要留下多余的空格、括号或连字符；
先用“名称识别测试”确认目标路径；
只用少量测试文件运行自动整理；
确认 115 中的结果后，再处理完整目录。

词表配置

从主菜单进入“词表”：

精准识别词：将常见别名改成正式名称，例如 旧名称 => 新名称；
自动整理屏蔽词：填写不需要整理的文件夹或关键词；
自定义发布组词：补充文件名中的发布组名称；
自定义占位符词：补充来源或平台名称。

精准识别词和屏蔽词按行填写，一行一条。只添加实际遇到的问题，避免加入过宽的关键词。

命名与目录 ​

使用名称识别测试 ​

默认整理结果 ​

分类目录 ​

需要修改时 ​

词表配置 ​

命名与目录

使用名称识别测试

默认整理结果

分类目录

需要修改时

词表配置