剧集文件怎么命名才能被正确识别

更新于 2026 年 8 月 31 日 · S01E01、季目录与年份的写法

这篇是电影刮削完全指南的剧集深化篇。那一篇讲的是「目录结构与文件名各管什么」这个总原则，这一篇只谈剧集：它比电影多一层，多出来的那一层正好是最容易出事的地方。

剧集比电影多一层，先定位到层再动手

电影是「一个目录一部片」，两层就够了。剧集是三层，每一层各回答一个问题，写错哪一层，症状完全不同：

标准写法长这样：

剧集/
  龙之家族/                       ← 作品目录：剧名，只写剧名
    Season 01/                    ← 季目录
      龙之家族 - S01E01.mkv       ← 文件名：季集号写全
      龙之家族 - S01E02.mkv
    Season 02/
      ...

有一条容易被忽略：你点「纳入媒体库」的那个目录，它的名字往往就是剧名。识别片名时是从文件往上走的，跳过季目录、跳过附属目录，撞上的第一个「作品目录」才算数——而往上走到你选中的那个根就停了。所以如果你选中的是 龙之家族/，剧名就取自它；如果你选中的是更上层的 剧集/，那么 龙之家族/ 是它的下级、照样能被认出来。真正会出事的是你选中的目录本身叫「新建文件夹」「下载」「movies」 这类名字，而里面直接就是分集文件——这时没有任何一层能提供剧名。

这一条对网盘和 DLNA 源尤其要命：这类源的「路径」其实是一串对象 id，路径里根本没有名字，扫描时带下来的那个目录名是片名的唯一来源。

季集号：S01E01 与它的替代写法

S01E01 是歧义最小的形式，推荐无脑用它。第01集、EP01 这类中文和缩写写法也认，但它们在一堆技术参数中间更容易被误读。三条实用建议：

• 补零。S1E1 能认，但 S01E01 在按名字排序时不会出现「第 10 集排在第 2 集前面」。
• 季集号和前后文之间留个分隔符（空格、点、短横都行）。剧名S01E01内封 挤在一起时，解析要靠猜边界。
• 同一季里的写法要一致。半季 S02E01、半季 第01集 是最常见的「一部剧裂成两张卡片」的起点——见下文。

文件名里把季集号写全（S02E05 而不是只写 E05）还有一个额外好处：万一季目录名不规范，季号在文件名里还留着一条退路。但别指望它兜底——剧名仍然只能由目录层提供，文件名救不了。

季目录名混了技术参数：整季刮不到的头号原因

发布组给季目录起名从来不客气，真实案例长这样：

龙之家族/
  第 1 季 4K HDR&杜比视界 内封简繁英多国字幕/
    S01E01....mkv
    S01E06....mkv

这个目录必须被认出是「季目录」。一旦被判成「作品目录」，往上找片名的过程就停在它身上，于是这一季的剧名变成了「第 1 季 4K HDR&杜比视界 内封简繁英多国字幕」——拿这个去搜，一集都刮不到。真机上曾经整整 28 集一条都没匹配上，就是这么来的。

识别的做法是先剔掉噪声词，再判剩下的是不是一个季标记。上面那串剔完 4K、HDR、杜比视界、内封、语言描述之后，剩下正好是 第 1 季，于是判定为季目录。要求「剩下的正好是个季标记」而不是「包含季标记」，是为了不误伤这两类：

• 第一季的故事——剔完噪声还剩「的故事」，不是纯季标记，判为作品目录。
• Season of the Witch（《女巫季节》，一部电影）——剔完还剩 of the Witch，同理不误判。

为什么「语言描述」必须整体剔掉

这是一条踩出来的细节，别处很难查到。简繁英多国字幕 是一个整体，必须整串剔掉。曾经把「多国」单独收进技术参数表，结果它把这一串从中间切断，剩下的两段谁也匹配不上，整个季目录的噪声剔除就失效了。

症状极具迷惑性：同一部剧，第 3 季的目录名是 内封中英双字，刮到了；第 1、2 季是 内封简繁英多国字幕，没刮到。看上去像是「这部剧的元数据不全」，实际上是两个季目录名走了不同的分支。所以排查整季刮不到时，先把这一季和刮到了的那一季的目录名并排放在一起看，差异往往就在字幕语言那一段上。

你自己能做的最省事的事：季目录名保留 第 1 季 或 Season 01，技术参数往文件名里放。

剧集文件名里的年份，最好别写

这条和电影正好相反，也是最反直觉的一条。电影文件名里的年份是上映年，非常有用，务必写上；而剧集文件名里的年份通常是这一季的播出年，影视数据库却按首播年索引——拿第二季的年份去做精确过滤，正剧本身在服务端那一步就被排除了，返回的全是「那一年首播的同名衍生剧」。

而衍生剧恰恰是最容易撞车的：星战、漫威这类 IP 底下，同名前缀的幕后纪录、外传、动画版成堆。

真实案例：某个片库里《曼达洛人》共 22 集，唯二文件名里带 2020 的 S2E3 和 S2E5，被刮成了《Disney Gallery: Star Wars: The Mandalorian》——一部 2020 年首播的幕后纪录剧集。实测拿 2020 这个年份精确搜索，返回的只有那一条；而不带年份搜索时，正剧稳稳排第一。结果就是这部剧在媒体库里裂成了两张卡片，其中一张只有两集。

好消息是应用侧已经把这一条兜住了：搜索时带年份和不带年份两路各自打分再比高低，不再是「第一路有结果就用」。片名精确匹配的加分压得过年份精确匹配，所以正剧会胜出；而遇到真正同名不同年的两部剧（比如美版和英版《办公室》），片名分打平，胜负仍然由年份决定，行为不变。

不过如果你在用别的刮削工具，或者发现某几集莫名其妙刮成了另一部剧，第一个该查的就是这几集的文件名里是不是带了年份。

分集还是版本：看文件名变化的那一段

同一个目录里摆着好几个视频文件时，只有三种可能，判据是文件名之间变化的那一段是什么：

这里有个坑：不能靠时长来区分分集和版本。直觉上「时长几乎一样的多半是同一集的不同版本」，但纪录片每集都是 58 到 59 分钟，离散度不到百分之一——按时长判，八集会被并成一条。所以判据只能是文件名里变化的那一段，时长在这件事上帮不上忙（它在别处很有用，比如把花絮和正片分开）。

识别为多版本之后，媒体库里只显示一条主版本（取体积最大的那份），其余收进详情页的版本菜单。已看状态会落到全部版本上。

常见问题

一部剧裂成了两张卡片怎么办？

先明白一件事：分组认的是刮到的条目 id，不是剧名。剧名是逐个文件独立算出来的——刮到了就用数据库返回的剧名，没刮到就停在文件名解析的结果上，所以同一部剧只要有几集走了不同分支（补下载的那几集命名不是一套、两次扫描时数据源状态不同、一部分集改了名另一部分没改），按名字分组就会多出一部剧。

修法是对整部剧重新刮削一次，多数情况能合回去。原理和「为什么系统宁可裂开也不敢合错」，在刮削修复清单里有完整的一节。

季目录可以省掉、把所有集平铺吗？

只要文件名里季集号写全（S02E05），季号是拿得到的。但作品目录不能省——那一层负责提供剧名。真要平铺，请保证外面那个目录的名字就是剧名。

剧名写中文还是英文？

都可以，TMDB 有完整的中文数据。要注意的是整部剧统一用一种：半季中文名、半季英文名，是「裂成两张卡片」的另一个常见起点。

改了文件名或目录名之后要重新扫描吗？

要。重新对那个目录点一次「纳入媒体库」即可。已看状态和播放进度不受影响。

某几集刮成了别的剧，能单独手动改吗？

手动纠正的入口在媒体库页长按海报卡片 → 「重新匹配元数据…」，输入正确的剧名搜索，在候选里选中对的那条。注意是媒体库页长按海报，不在详情页里。