电影刮削完全指南

更新于 2026 年 8 月 31 日 · 识别原理、命名规范与排错

先说结论：刮削靠两层判断——目录结构决定「哪些文件该入库、谁是正片」，文件名决定「它叫什么、第几季第几集」。理解这个分工，就知道该整理目录还是该改文件名了。多数「刮不出来」的情况，问题出在结构那一层，改文件名是白费力气。

刮削是怎么认片子的

「刮削」（scraping）指的是：扫描你的片库，从文件名和目录结构里解析出片名、年份、季集，拿去影视数据库（TMDB、OMDb）匹配，把海报、简介、演员表、分集信息取回来。一堆文件名因此变成一面能逛的海报墙。

过程分两步，各管各的：

看结构看名字
负责回答这个目录该入库吗？谁是正片？哪几个文件互为版本？它叫什么？哪一年？第几季第几集？
依据目录层级、文件时长（拿不到时用体积）文件名与目录名里的文字
你能做的把片子按作品分目录让片名和季集看得出来

为什么「谁是正片」不能靠名字判断

这是刮削工具最容易做错的地方。一个典型的下载目录里，正片旁边常有 Sample、Screens、Box Cover、Subtitle、External AC3、甚至中文的「奥斯卡获奖动画长片」这类附属目录。想靠一张目录名黑名单排除它们，永远追不上发布组起名的花样。

可靠的判据是结构性的：如果一个子目录里最长的视频还不到同一部作品正片时长的四分之一，那它就是附属内容——花絮、样片、片头、菜单片段全在这一刀之下，一次认全，不用维护任何名单。时长优先（DLNA 之类的源直接就给），文件系统源拿不到时退回体积比。

另外还有一条绝对下限：时长不足六分钟的视频不进媒体库。它们在「文件」页里仍然能看到和播放，只是不占海报墙的位置。

命名规范：可以照抄的写法

先强调一句：不必为了刮削去重命名整个片库。结构判定那一层已经挡掉了大部分噪声，杂乱的下载目录也不至于扫出一堆垃圾。下面这些是「想让识别率更高」时的建议，不是硬性要求。

电影

电影/
  盗梦空间 (2010)/
    盗梦空间 (2010).mkv
  Interstellar (2014)/
    Interstellar.2014.2160p.BluRay.x265.mkv

核心只有两件事：片名清楚、年份带上。年份对电影极其有用——同名电影太多了（《无间道》有港版有翻拍，《狮子王》有动画有真人），有年份就能一次命中。中英文都可以，不必强求。

剧集

剧集/
  怪奇物语 (2016)/
    Season 01/
      怪奇物语 - S01E01.mkv
      怪奇物语 - S01E02.mkv
    Season 02/
      ...

季集号写成 S01E01 是最保险的形式。第01集、EP01 这类也认，但 S01E01 歧义最小。

这里有个反直觉的坑，值得单独讲：剧集文件名里的年份，最好别写。

原因是：剧集文件名里的年份通常是这一季的播出年，而影视数据库按首播年索引。拿第二季的年份去精确搜索，正剧本身会被服务端直接排除，剩下的全是「那一年首播的同名衍生剧」——而星战、漫威这类 IP 下同名前缀的衍生剧成堆。

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

好消息是这一条现在由应用侧兜住了：搜索会同时试「带年份」和「不带年份」两路再比分数，所以你文件名里有年份也不至于出事。但如果你在用别的刮削工具遇到剧集刮错，这是第一个该查的方向。

同一部片的多个版本

想同时留 4K 和 1080p、留原盘和压制？放同一个目录里，只让技术参数不同：

银翼杀手 2049 (2017)/
  银翼杀手 2049 (2017) - 2160p HDR.mkv
  银翼杀手 2049 (2017) - 1080p.mp4

判据是「同目录文件名之间**变化的那一段**是什么」：变的是集号 → 分集；变的是技术参数 → 版本；变的是片名 → 那是不同的片。

最后那一条不是废话。有人把「蜘蛛侠 8 部合集」里的 平行宇宙、英雄归来、英雄远征 平铺在一个目录里，若只判「它们都不是分集，那就都是版本」，9 个文件会被合成 4 条——静默丢片，没有任何报错。所以片名不同时必须当成不同的片。

识别为多版本之后，媒体库里只显示一条主版本（取体积最大的那份），其余收进详情页的「N 个版本」菜单，随时可切。已看状态会落到全部版本上，不会出现「从版本菜单挑另一份看完、回列表还是未看」。

系列合集目录

合集目录里的文件名往往是简称，单独拿去搜会出事：

蜘蛛侠 8部合集/
  英雄归来.mkv      ← 单独搜会命中 2018 年的法国片《英雄归来》
  蜘蛛1.mkv         ← 单独搜会命中 1919 年的德国默片《蜘蛛》

注意这是假阳性而不是搜不到——所以任何「搜不到就降级」的兜底逻辑都救不了它。正确做法是先从目录名里认出「N 部曲 / N 部合集 /【N 部】」这类标记，取出系列名，再拼成「系列名 + 序号」或「系列名 + 简称」去搜。所以合集目录名里要带上系列名和「N部」标记，别只写个「合集」。

季目录与作品目录

季目录名里混技术参数是很常见的，比如 第 1 季 4K HDR&杜比视界 内封。这类目录要能被认出是「季目录」而不是「作品目录」，否则片名会停在它上面，整季刮不到。

还有一条容易被忽略：你选择「纳入媒体库」的那个目录，它的名字往往就是作品名。比如你选中 龙之家族/ 然后里面是 第 1 季 .../S01E06.mkv——片名就该取自 龙之家族。对于对象存储型的源（网盘、DLNA），路径里根本没有名字，这个目录名是唯一的片名来源。

蓝光原盘

原盘保持原样即可，不要拆：

阿凡达 (2009)/
  BDMV/
    STREAM/
      00024.m2ts    ← 正片
      00025.m2ts    ← 花絮

碟根之下的挑选由专门的逻辑负责——00024 这种文件名谁也解析不出集号，套用通用的版本合并规则会把一张碟的三集并成一条。详见 蓝光原盘与 ISO 播放那篇。

配置刮削数据源

扫描前要先配好数据源，否则只按文件名入库——有条目，但没有海报和简介。位置在设置 → 元数据与刮削：

两家都配上、TMDB 做主源，是最省心的组合。配好后点「测试连接」确认通了再去扫描。

出问题了怎么修

刮成了别的片

到媒体库页长按那张海报，选「重新匹配元数据…」，输入正确的片名搜索，在候选里挑对的那条。这是手动纠正的唯一入口——注意是在媒体库页长按海报，不是在详情页里找。

整个目录没入库

按顺序查三件事：目录深度是不是超过了四层；视频时长是不是不足六分钟（会被当花絮剔除）；以及你是不是根本没点「纳入媒体库」——加完源不会自动扫描，要进到那个目录手动收录。

海报全空

多半是数据源没通。TMDB 在国内可能连不上，去设置里点「测试连接」确认；或者配上 OMDb 作为第二数据源。

同一部片出现两条

通常是两个源各扫到了一份（测试源一份、网盘一份），或者同一个源里原盘与压制并存。展示层本该折叠成一条，若仍分开显示，检查这两条的片名是否被解析成了不同的名字——片名不同，系统就认为是两部片。

一部剧裂成两张卡片

这是剧集特有的问题，成因是部分分集刮到了 id、部分没刮到：补下载的那几集文件名不是一套、两次扫描时的刮削状态不同、或者重刮时部分集改了名而另一部分没改。

修法：对整部剧执行一次重新刮削，通常能合回去。分组认的是刮到的条目 id 而不是剧名，所以只要多数集刮对了，没 id 的那几集会被认回去。

重新刮削会不会把已有的海报弄丢

不会。「设置 → 元数据与刮削 → 重新刮削媒体库」有一条保护：这一轮没匹配上、而库里已经有元数据的条目，会跳过并保留原有内容。这条守卫很重要——否则赶上中转挂了或 key 过期，点一次重刮就会把整库的海报和简介抹平，且不可逆。已看状态与播放进度也一并保留。

另外，Emby / Jellyfin / Plex 源会被重刮跳过：它们的元数据归服务端管，客户端不该去覆盖。

常见问题

刮削会上传我的文件吗？

不会。只发送查询词（通常就是片名和年份）去元数据接口，文件内容与目录清单都不出设备。刮到的结果缓存在本机，同一部片不会反复去问。

中文片名能刮到吗？

能，TMDB 有完整的中文数据。用 OMDb 做主源时只有英文，这也是建议把 TMDB 放主源的原因。

合集/系列会自动归类吗？

会。TMDB 的官方电影系列信息（比如「哈利·波特系列」）在刮削时一并取回，媒体库的合集页里能看到自动归组的系列。这和你手动建的合集是分开的两套，重刮时自动系列会更新，手动合集不受影响。

我改了文件名，需要重新扫描吗？

需要。重新「纳入媒体库」那个目录即可。

相关阅读：蓝光原盘与 ISO 直接播放、群晖 NAS 手机观影。刮削还是不对的话，带上文件名和目录结构发到支持页上的邮箱。