命名与目录

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

使用名称识别测试

进入“设置 → 命名与分类 → 名称识别测试”：

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

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

默认整理结果

电影通常整理为：

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

剧集通常整理为：

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

实际目录和文件名会根据识别结果、文件扩展名和媒体分类变化。

分类目录

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

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

开启“一级分类”后，可以用 primary_folders 自定义电影和剧集的一级目录。下面的完整 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"
  欧美剧:

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

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

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

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

配置规则：

• 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 中的结果后，再处理完整目录。

词表配置

进入“设置 → 词表”：

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

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