元数据与 NFO

元数据是作品显示的各种信息：名称、简介、演职员、评分和图片。这一页说明这些信息从哪里来、NFO 文件如何配合，以及配错时怎么修正。

资料从哪里来#

一个条目的信息（标题、简介、演职员、评分等）有四个来源，优先级由高到低：

1. 你在管理后台手动编辑并锁定的字段。
2. 文件夹里的 NFO 文件。
3. 提供者（由插件提供的网络元数据，例如 TMDB）。
4. 服务器从文件夹与文件名推断的内容（标题、年份、季与集号）。

也就是说：放了 NFO 就以 NFO 为准；NFO 没有的字段由提供者补齐（对有 NFO 的新条目，要在媒体库设置里打开「补全缺少的数据」才会这样，它只补空字段和缺少的图片，不会覆盖 NFO 的值）；什么都没有时，至少还有从文件名推断出的名称。每个媒体库可以分别决定要不要读取 NFO、使用哪些提供者及其顺序，以及使用哪种语言。

提供者#

打开「媒体库」，进入该媒体库的设置，切换到「元数据」分页。

• 选择「刮削语言」。默认跟随服务器设置。
• 在「提供者」里添加要用的提供者，会依次尝试。没有选任何提供者（「不刮削」）的媒体库只靠文件名与 NFO。如果还没有安装提供者，请到「插件中心」安装。
• 每个条目会先使用名称里的 ID（见文件与文件夹命名）或已有的 ID；没有 ID 才用片名加年份搜索。只有分数够高、且明显领先第二名时才会自动套用；不确定的条目会标为「待识别」，等你处理。服务器不会乱配。
• 新入库的条目在后台刮削，不影响扫描与播放。正在播放的条目和它们的下一集会优先刮削。
• 图片可以由多个来源补齐，并按你的语言偏好挑选。
• 刮削失败（网络问题、提供者暂时不可用）会自动重试；确定不可能成功的请求（例如地址被拒绝）不会一直重复。

更换语言后，已刮削的条目不会自动更新，保存后请重新刮削。

图片来源 FREE#

在媒体库设置的「高级」分页，「图片来源」可以添加额外的图片来源，会依次尝试。刮削时，这些来源的海报、背景会一并收进候选，再按语言偏好与评分挑出最合适的当作主图。没有选任何来源时，只使用元数据提供者自带的图片。

名称识别 PRO · MAX#

名称特别乱（发行组命名、动画字幕组）而搜索不到时，可以在「元数据」分页的「名称识别」添加名称识别器。它会参考路径与同一文件夹里的其他文件名，推断出更准确的片名与集数（包括动画的绝对集数），再交给提供者搜索。第一次没配上时，会用上次未配上的信息再试第二轮。

读取 NFO#

NFO 是放在视频旁边的 XML 文件。Kodi、Emby、Jellyfin、tinyMediaManager、MoviePilot、MetaTube 等工具产生的格式都能读。开关是「使用本地 NFO」（「高级」分页）。

放在哪里：

读取的主要内容：标题、原名、排序名、简介、标语、年份与首映日期、评分（含影评人评分）、分级、类型、标签、制片公司、国家或地区、演员（含角色、顺序、头像、演员 ID）、导演、编剧、合集、编号、各来源 ID（TMDB、IMDb、TVDB 等）、预告片以及锁定信息。

注意事项：

• 类型与标签。 一个 <genre> 或 <tag> 元素里要放多个值时，请用「空格 / 空格」分隔（动作 / 科幻）。用逗号，或不加空格的斜线，都视为同一个词，不会被拆开。
• 合集。 <set> 只有名称不够，要带 TMDB 合集编号（<set tmdbcolid="…">，或根层的 <uniqueid type="tmdbset">）才会建立合集。
• 加入日期。 <dateadded> 会当作条目的加入日期。
• 损坏的 NFO 不会中断扫描：可用的部分会尽量读取；完全读不了就改用文件名推断，并在管理后台记录。
• 图片地址。 NFO 里的 <thumb>、<fanart> 地址会当作图片来源；本地图片文件优先。
• 强制刷新。 修改 NFO 后，快速扫描可能侦测不到（文件夹时间没变）。请执行「完整扫描」，或在条目上选择「刷新…」。

写入 NFO（可选）#

在媒体库设置里打开「写回 NFO 与图片」（「高级」分页，默认关闭）。打开后，服务器会把数据库里的内容写成标准 NFO，放在视频旁边。这样以后换服务器，或用 Kodi、Emby 打开同一个媒体库时，数据可以跟着走。

• 只补缺：已有的 NFO 不会被覆盖。只有明确使用「重新刮削并覆盖」时，才会更新服务器自己写的文件。
• 覆盖其他工具产生的 NFO 之前，会先备份为 <文件名>.nfo.orig（只备份第一次）。你自己的备注与其他工具的字段（<fileinfo>、<thumb>、<fanart> 等）会原样保留。
• 也会写入海报、背景、单集缩略图，以及写入 .actors/ 的演员头像。只有在选项打开、且文件夹可写时才会写。
• 媒体库以只读方式挂载时，会提示一次「无法写入」，不会反复尝试。
• 删掉数据库、依 NFO 重新建立媒体库，会得到相同的内容。观看记录与成员数据不在 NFO 里。

要用服务器的数据覆盖整个媒体库的 NFO，请在媒体库设置里选择「NFO 同步」→「覆写全库 NFO」。它需要先打开「写回 NFO 与图片」。这是后台任务，条目多的媒体库要花一段时间。每个 NFO 在第一次被覆盖前会备份为 .orig，服务器不认得的内容会保留。

锁定字段#

在条目的编辑页面手动修改字段后，可以将它「锁定」（锁定整个条目，或个别字段）。被锁定的字段不会被之后的刮削与刷新覆盖。

• 锁定信息会写进 NFO（<lockdata>、<lockedfields>），日后从 NFO 重建时会还原。
• 手动编辑不会自动写回 NFO。

修正配错的条目（识别）#

自动配对错了，或条目显示「待识别」时使用。

1. 在条目上选择「识别」。
2. 用名称加年份搜索，或直接输入来源 ID（例如 TMDB 或 IMDb 的 ID）。
3. 选中正确的结果并套用。服务器会重新获取元数据与图片，并记住这个 ID，之后刷新不会再配错。

想一劳永逸：把 ID 写进文件夹名（见文件与文件夹命名），或写进 NFO 的 <uniqueid>。

「解除识别」会清除配对，并让条目回到「待识别」。提供者已经写入的字段会保持原值，直到你重新识别或重新刮削。

为什么某个来源没找到（来源状态）#

资料或图片缺了时，打开条目看来源状态（在识别对话框和刷新演员时也会显示）。它按插件列出上一次的结果：正常、找不到、被拦截、需要登录、需要验证、超时、出错或尚未完成，附一句原因和该插件设置的链接。图片在内网、而插件还没被允许访问局域网时，也会这样写；到插件设置里开启局域网访问即可。

尚未完成表示某个慢的来源没来得及回答。条目先保留已有的内容，服务器稍后会再问一次那个插件，只补还空着的字段和图片，不会覆盖你手动改过的内容。

来自文件名的标签#

条目的标签来自 NFO、导入、元数据来源、你自己的编辑，以及（用了名称识别（PRO）时）文件名：扫描量不出来的东西，比如内嵌硬字幕的标记，会存成标签。在条目编辑里它们列在来自文件名下，不能在那里删除，重新识别时会更新。清晰度、HDR 和字幕轨不会取自文件名，服务器直接从文件里量。标签可以用来筛选，也可以当作海报角标的规则。

刷新元数据#

条目、季、整部剧或整个媒体库都可以刷新，使用「刷新元数据」（条目上是「刷新…」）。

• 「搜索缺少的元数据」只会排入还没刮削、刮削失败或待识别的条目，已经配对的条目不会处理。对排入的条目，提供者给出的内容会覆盖它先前写入的值，不是只补空字段。
• 「替换所有元数据」会重新读取文件夹与 NFO，并把所有可刮削的条目重新排入刮削。
• 手动编辑与锁定的字段不会被改动，条目 ID 与观看记录都会保留。
• 超出「系统设置 → 设置 → 元数据」里数量上限的来源图片会被删掉（见「图片」）。

来源给出的资料变旧（默认 150 天）后，也会自动重新获取。这是「任务中心 → 排程」里的计划任务「重新整理过期资料」，每周在夜间时段运行一次，可以改时间，也可以立即运行。

媒体库的「扫描」按钮（快速或完整）只重新读取文件，不会重新刮削。要重新刮削，请用媒体库页的「刷新元数据」。