刮削不到或刮错的修复清单

更新于 2026 年 8 月 31 日 · 按症状分诊，从改名到手动匹配

识别原理的总纲在电影刮削完全指南里，这篇不重复，只做救援：给症状、给原因、给修法。

先分诊：一张速查表

一、条目根本没出现

整个目录没入库

现象：源加好了，「文件」页里文件都在、也能播，但媒体库是空的，或者少了一大块。

原因：按可能性从高到低排：

1. 根本没点「纳入媒体库」。这是第一名，且甩开第二名很远。加完源不会自动扫描——要点进源、浏览到目标目录、点顶栏的「纳入媒体库」，按目录粒度收录。
2. 目录层级太深。扫描不会无限往下钻，片子埋在四五层子目录里时可能够不着。
3. 视频时长不足六分钟。这是硬下限，短视频不进媒体库（在「文件」页里仍然可见可播）。
4. 被判成了附属内容。判据是：子目录里最长的视频不到同一作品正片时长的四分之一，就当花絮处理。正常的正片不会撞上这一条，但如果你的「正片」本身就是个十几分钟的短片，而同目录里还有长片，就有可能。

修法：先确认第 1 条。撤销收录的入口是长按同一颗按钮 → 「将此目录移出媒体库（不删除文件）」，可以放心用来重来一遍。

条目在，但海报和简介全空

现象：媒体库里有一堆卡片，标题是文件名，全是灰底。

原因：刮削数据源没配或者没通。未配置时扫描只按文件名入库，这是设计如此，不是失败。

修法：到设置 → 元数据与刮削：

• 「优先使用」选 TMDB 或 OMDb。两家都配上、TMDB 做主源是最省心的组合，主源搜不到会自动回落另一家。
• TMDB 填中转地址或 API Key。国内直连 TMDB 可能不通，自建一个中转最省事。
• OMDb 在 omdbapi.com 免费申请。注意它只有英文数据，拿它做主源的话中文简介和译名都会缺；而且免费 key 每天 1000 次请求，全库扫描很容易打满——如果是「刮着刮着后面全空了」，先怀疑这个。
• 每一项旁边都有「测试连接」，配完先点一下，确认通了再去扫描。

数据源修好之后，回到同一页最下方点重新刮削媒体库补齐。

二、条目在，但认错了片

剧集被刮成了同名衍生剧

现象：一部剧里某几集的海报和简介是另一部剧的，通常还是同一个 IP 下的幕后纪录、外传之类。

原因：这几集的文件名里带了年份。剧集文件名里的年份是这一季的播出年，而影视数据库按首播年索引——拿它去精确过滤，正剧本身在服务端那一步就被排除了，剩下的全是「那一年首播的同名衍生剧」。真实案例是《曼达洛人》里唯二带 2020 的两集被刮成了 2020 年首播的幕后纪录剧集。

修法：应用侧已经用「带年份/不带年份两路比分」兜住了这一条，新扫描一般不会再犯。已经刮错的条目手动改回来（见下），或者把这几集文件名里的年份去掉再重扫。电影侧不存在这个问题——电影文件名里的年份就是上映年，该写。展开讲在剧集命名那一篇。

合集目录里的片被刮成了完全不相干的电影

现象：一个「N 部合集」目录里，某几部的海报牛头不对马嘴，而且是一本正经的错——有海报、有简介、有年份，就是不是那部片。

原因：合集目录里的文件名往往是简称，而简称拿去单独搜会搜到东西：英雄归来 命中 2018 年的法国片《英雄归来》，蜘蛛1 命中 1919 年的德国默片《蜘蛛》。这是假阳性而不是搜不到，所以任何「搜不到就降级重试」的兜底逻辑都救不了它。

修法：把目录名写成带系列标记的形式（蜘蛛侠 8部合集/、蜘蛛侠【3部】/），识别时会从目录名取出系列名再拼成完整查询词。详见合集目录整理那一篇。

手动重新匹配：入口在哪、怎么点

所有「认错片」的兜底都是手动指定。入口只有一个，很多人找错地方：

1. 到媒体库页（不是详情页）。
2. 长按那张海报卡片。智慧屏上是遥控器 OK 键长按。
3. 菜单里选「重新匹配元数据…」。
4. 输入正确的片名搜索，在候选列表里选中对的那一条。

同一个菜单里还有「标记为已看/未看」和「加入合集…」。

选中之后，剧集的分集信息（集名、集简介、单集时长）会按你选中的这一条回查补齐，不会再按文件名自动搜一遍——这一点很重要：你之所以要手动改，正是因为按文件名搜出来的不对，如果补齐时又走一遍自动流程，等于把你刚选中的结果原样盖回去，症状是「提示说已更新元数据，界面上什么都没变」。

三、条目多出来了

一部剧裂成两张卡片

现象：媒体库里同一部剧有两张卡片，一张是大部分集，另一张只有零星几集；两张的名字可能一个中文一个英文。

原因：分组认的是刮到的条目 id，不是剧名。剧名是逐个文件独立算出来的——刮到了就用数据库返回的剧名，没刮到就停在文件名解析结果上。所以只要有几集走了不同分支，按名字看就是两部剧。三条常见通道：补下载的那几集文件名不是一套；两次扫描时数据源状态不同（TMDB 没搜到会回落 OMDb 的英文名）；重刮时「没刮到就保留旧元数据」的保护让一部分集改了名、另一部分没改。

修法：对整部剧重新刮削一次。分组键会在扫描、重刮、手动重新匹配之后各跑一次归并，只要多数集刮到了 id，没 id 的那几集会被认回去。

为什么系统宁可让它裂开，也不敢自动合上

这是这套逻辑里最值得讲清楚的一条，也解释了为什么偶尔要你手动介入。

每一行条目都带一个分组键，形如 t:剧集id（来自 TMDB）、i:剧集id（来自 OMDb）或者 n:剧名（没刮到 id 时的退路）。归并时只有一条硬规则：同一行上同时刮到了两家的 id，说明它们指的是同一部剧，两组可以合并——这是两家数据之间唯一可靠的桥。

没刮到 id 的行，靠两条弱线索认回去：先看剧名，再看目录。目录这一条不能省——裂开的两半常常一个中文名一个英文名，一个字都不沾，名字线索根本搭不上，只有「同一个源、同一个目录下」认得出来。

而两条弱线索都只在唯一指向一个 id 组时才生效。同名不同剧（两个版本的《福尔摩斯》）、一个目录里平铺着好几部剧，一律不认。理由很实在：裂开只是多一张卡片，你点两下就看完了；合错是把别人的分集混进这部剧里，而用户根本无从拆开。所以这套判断刻意保守。

同一部片出现两条

现象：一模一样的两张卡片，点进去都能播。

原因：两个源各扫到了一份（比如 NAS 一份、网盘一份），或者同一个源里原盘和压制并存。展示层本来会把它们折叠成一条主版本（取体积最大的那份，不是入库最早的），其余收进详情页的版本菜单。

修法：折叠的判据是「这两条被认成同一部内容吗」——剧集看分组键加季集号，电影看片名加年份。仍然分开显示，说明这两条的片名或年份被解析成了不同的值。把两边的目录名对齐（都写成 片名 (年份)）再重扫，通常就合上了。

顺带一提：已看状态会落到全部版本上，所以从版本菜单里挑另一份看完，回到列表不会还显示未看。

重新刮削安全吗：它改什么、不改什么

入口在设置 → 元数据与刮削最下方的「重新刮削媒体库」。放心用，它有明确的边界：

最关键的一条保护是：这一轮没匹配上、而库里已经有元数据的条目，会跳过并保留原有内容。因为重刮是整组覆盖——一次改掉简介、海报、剧照、评分、类型、时长和 id，而数据源不通时这些字段全是空串。没有这条守卫的话，赶上中转挂了或者 key 过期，点一次重刮就会把整库的海报和简介抹平，而且不可逆。

反过来，库里本来就是空的条目仍然照写——没什么可保的，写进去反而能让这一轮文件名解析的改进落地。所以「海报全空 → 修好数据源 → 重刮」这条路是通的。

常见问题

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

需要。重新对那个目录点一次「纳入媒体库」。观看进度按文件走，改名不影响。

刮削会把我的文件传到网上吗？

不会。离开设备的只有查询词——通常就是片名和年份。文件内容和目录清单都不出设备，刮到的结果缓存在本机。

删掉一个源会连带删掉什么？

会连带删掉该源名下的媒体库条目和观看进度。所以如果只是网盘登录过期了，请用「文件页长按源 → 重新登录」（夸克 / UC / 天翼 / 移动四家显示），不要删了重加。

Emby / Jellyfin / Plex 的源为什么刮不动？

这三类源的元数据归服务端管，客户端不去覆盖，重刮时整段跳过。要改的话去服务端改。相关：鸿蒙上的 Emby 客户端。

都试过了还是不对？

把文件名和目录结构（从你点「纳入媒体库」的那一层开始，到具体文件为止）抄下来，发到支持页上的邮箱。目录结构比文件名更能说明问题，别只发文件名。