目录

数据匹配

月光放映机如何从文件名解析片名与季集信息，以及实测有效的文件命名规范。

本页目录
  1. 匹配流程
  2. 电影命名规范
  3. 剧集命名规范
  4. 剧名目录的兜底
  5. 集数与季号的边界
  6. 动漫
  7. 用 ID 精确匹配
  8. 会被忽略的噪声
  9. 提高匹配率的几个习惯
  10. 还是不对怎么办？

媒体库里的海报、简介、演员信息都来自 TMDB。应用要做的事情，就是把你的文件名准确地对上 TMDB 里的条目。

理解匹配规则，能帮你把准确率从「大部分对」提到「几乎全对」。

匹配流程

添加文件源后，应用对每个视频文件依次做四件事：

  1. 扫描 —— 遍历目录，识别出视频文件，过滤掉样本、预告等干扰项
  2. 命名解析 —— 从文件名（以及所在的目录名）中剥离画质、编码、压制组等噪声，提取出片名、年份、季号、集号
  3. 搜索匹配 —— 用解析结果去 TMDB 搜索，结合年份与类型（电影 / 剧集）选出最佳候选
  4. 落库 —— 拉取海报、背景图、简介、演员、季集列表并写入本地媒体库

如果找不到足够确信的结果，该条目会保持「未匹配」状态，等着你手动校正。解析引擎带版本号，升级后未匹配的文件会自动重试一次。

电影命名规范

推荐格式：影片名 (年份).扩展名

/Movies/星际穿越 (2014).mkv
/Movies/盗梦空间 (2010).mp4
/Movies/让子弹飞 2010.mkv

年份不是必须的，但强烈建议保留 —— 它是区分翻拍片的关键（比如三个版本的《倩女幽魂》）。中英文名都支持。

英文名同样有效，常见的发布组命名也能识别：

Inception.2010.1080p.BluRay.x264.mkv
Interstellar (2014) [2160p].mkv
The.Matrix.1999.REMUX.mkv

剧集命名规范

以下写法都能被正确识别（分隔符 . _ - 和空格可以互换，大小写不敏感）：

剧名.S01E02.mkv
剧名.S01.E02.mkv
剧名.S1E2.mkv
剧名.S01 E02.mkv
剧名.Season 1 Episode 2.mkv
剧名.1x02.mkv          （Infuse 风格）
剧名.SE1.EP2.mkv
剧名.SE1EP2.mkv

推荐放进按季划分的目录，识别成功率最高 —— 目录名本身也是解析依据：

/TV Shows/琅琊榜/Season 1/琅琊榜.S01E01.mkv
/TV Shows/The Office/Season 3/The.Office.S03E05.mkv

季目录支持这些写法：

Season 1 / S01 / 第1季 / 第一部 / Season 1 (2014)

对轻微的拼写错误也有容错（如 Srason 2、Seasons 2），但建议还是写标准。

剧名目录的兜底

当文件名里只有集号、没有剧名时（例如 01.mkv、EP02.mp4），应用会逐级向上查找目录名，用剧名目录作为片名来源。因此这样的结构也能正确入库：

/剧集/琅琊榜/Season 1/01.mkv
/剧集/琅琊榜/Season 1/02.mkv

集数与季号的边界

解析器对季号与集号有防御性限制，避免把年份误当成季号：

  • 季号必须在 1 ~ 50 之间
  • 集号必须在 1 ~ 999 之间
  • 因此 Movie.2020x02.mkv 这类文件名不会被误解析为「第 2020 季第 2 集」

注意：季号从 1 开始，不支持 S00 表示特别篇。特别篇建议单独放一个目录并命名为 第1季 之类，或用手动匹配单独处理。

动漫

动漫在 TMDB 里被归类为剧集，因此需要带上季号：

火影忍者/Season 1/火影忍者.S01E001.mkv
Boruto Naruto Next Generations.S01E210.mp4

即使整部作品只有一个「季」，也建议写上 S01。

用 ID 精确匹配

文件名里带上 TMDB 或 IMDb ID，可以跳过模糊搜索，直接锁定条目：

盗梦空间 {tmdb-27205}.mkv
盗梦空间 {imdb-tt1375666}.mkv

格式是 {tmdb-数字} 或 {imdb-tt数字}，大小写不敏感。

当你遇到同名影片（翻拍、动画版与真人版、同名剧集）反复匹配错时，这是最可靠的手段。

会被忽略的噪声

解析器内置了噪声词表，会自动跳过这些常见片段，因此下面这种典型发布组命名不会干扰片名识别：

  • 画质与来源：1080p、2160p、4K、BluRay、WEB-DL、REMUX、HDTV
  • 编码：x264、x265、H264、HEVC、AV1
  • 音频：DTS、AC3、AAC、DDP5.1、TrueHD
  • 流媒体平台标签：NF、AMZN、ATVP、HMAX 等
  • 字幕组 / 压制组标签：CHDWEB、FRDS、NGB 等
  • 尾部下载计数：(1)、[2]

提高匹配率的几个习惯

  1. 保留年份 —— 尤其是有翻拍版本的影片
  2. 剧集一定带 SxxExx —— 并放进 Season N 目录
  3. 一部影片一个目录 —— 尤其当同一目录混放电影和剧集时
  4. 用标准季目录名 —— Season 1 比 第一季高清 更可靠
  5. 不要在文件名里塞太多中文修饰词 —— 例如「高清修复版」「国粤双语中字」这类描述

还是不对怎么办？

自动匹配不可能 100% 准确。匹配错了看修复不匹配的影片，几步就能改回来。