KODI媒体库整理指南：文件命名、NFO元数据与刮削器配置

1. 从混乱到秩序：为什么你的KODI媒体库总是一团糟？

如果你用过KODI，大概率经历过这种抓狂时刻：辛辛苦苦下载了几百部电影和剧集，一股脑儿扔进硬盘，然后满怀期待地在KODI里添加媒体源，结果看到的却是满屏的乱码文件名、错乱的剧集顺序、缺失的海报和简介，甚至把《肖申克的救赎》识别成了《小鬼当家》。这根本不是家庭影院，这是文件名的垃圾场。

问题根源不在于KODI不够强大，而在于我们对待媒体文件的方式太“原始”。KODI本质上是一个极其依赖“元数据”（Metadata）的媒体中心。它不像普通播放器那样只认文件名，它渴望知道每一部影片的片名、年份、导演、演员、剧情简介、评分，以及最重要的——漂亮的海报和背景墙。这些信息从哪来？就来自于你硬盘里那些看似不起眼的视频文件，以及伴随它们的一系列“准备动作”。

很多人把“准备KODI媒体文件”简单理解为“改个文件名”，这远远不够。这是一套从文件命名、目录结构，到元数据文件（如NFO）、缩略图管理的系统工程。做对了，KODI就是你的私人流媒体服务器，赏心悦目，检索如飞；做错了，它就是一场持续不断的修修补补和手动刮削的噩梦。今天，我们就来彻底拆解这个过程，让你掌握正确准备媒体文件的“道”与“术”，一劳永逸地搭建一个整洁、美观、信息完整的KODI媒体库。

2. 基石工程：文件命名与目录结构的黄金法则

在KODI的世界里，混乱的源头十有八九是混乱的目录和文件名。KODI的刮削器（Scraper）就像一位有点固执的图书管理员，它只认特定的“编目规则”。你的工作，就是按照它熟悉的规则摆放书籍（媒体文件）。

2.1 电影文件的标准化命名

对于电影，规则相对简单，但必须严格遵守。一个理想的电影文件命名格式如下：电影名 (发行年份).扩展名

例如：

• The Shawshank Redemption (1994).mkv
• 阿甘正传 (1994).mp4
• Spider-Man No Way Home (2021).mkv

核心要点与避坑指南：

1. 年份是灵魂：括号里的四位数年份至关重要。这是刮削器区分同名电影、确定具体版本（如1982版和2011版的《机械战警》）的最关键依据。年份信息务必准确，可以从TMDB等网站查询。
2. 去除冗余信息：文件名中不要包含分辨率（如1080p）、编码格式（x264）、音轨（DTS）或发布组信息。这些信息可以通过KODI的界面或文件信息查看，放在文件名里只会干扰刮削器识别核心的“片名+年份”。一个典型的错误命名是：[ABC小组]肖申克的救赎.1994.1080p.BluRay.x264.DTS-CHD.mkv，这会让刮削器非常困惑。
3. 使用英文括号：即()，避免使用中文括号（）或其他符号，部分刮削器对符号敏感。
4. 特殊字符处理：尽量避免在文件名中使用: / \ * ? “ < > |这些操作系统或刮削器可能保留的字符。用空格或点号分隔单词是安全的。

2.2 电视剧集目录结构的构建艺术

电视剧的整理比电影复杂一个数量级，因为它涉及季（Season）和集（Episode）的多层结构。一个标准的电视剧目录树应该像这样：

TV Shows/ (电视剧根目录) ├── Breaking Bad/ (剧集文件夹，名称为官方剧集名) │ ├── Season 01/ (季文件夹，必须为 `Season XX` 或 `SXX` 格式) │ │ ├── Breaking Bad S01E01.mkv (单集文件，格式为 `剧集名 SXXEYY`) │ │ ├── Breaking Bad S01E02.mkv │ │ └── ... │ ├── Season 02/ │ │ ├── Breaking Bad S02E01.mkv │ │ └── ... │ └── season.nfo (可选，剧集级的NFO文件，包含整部剧的信息) ├── Game of Thrones/ │ ├── Season 01/ │ │ ├── Game of Thrones S01E01.mkv │ │ └── ... │ └── ... └── 权力的游戏/ (中文剧集同样适用此结构) ├── Season 01/ │ ├── 权力的游戏 S01E01.mkv │ └── ... └── ...

为什么必须这样组织？这种结构被TMDB、TVDB等几乎所有主流元数据网站和KODI刮削器所支持。S01E01这种格式明确无误地告诉系统：“这是《绝命毒师》第一季第一集”。刮削器会基于剧集文件夹名（Breaking Bad）去搜索整部剧的信息，再根据季和集编号，精准匹配每一集的标题、简介、播出日期甚至单集海报。

实操中极易出错的细节：

• 季文件夹命名：Season 1、S1、Season01都是可接受的，但保持全局一致最好。我强烈推荐Season 01（两位数）这种格式，视觉上更整齐，也避免了个位数和十位数排序时的错乱（如Season 10会排在Season 2前面）。
• 单集文件命名：剧集名 SXXEYY是核心。即使你把单集文件命名为S01E01.mkv，KODI通常也能通过上层目录识别剧集，但加上剧集名是万无一失的做法。对于多集合并文件，可以使用S01E01-E02或S01E01E02的格式。
• 特殊剧集处理：对于特别篇、OVA等，常见的做法是放在Season 00文件夹下，并按S00E01格式命名。

2.3 音乐与家庭视频的整理思路

音乐库的整理核心是标准的艺术家/专辑/曲目目录结构，并确保音乐文件内嵌了正确的ID3标签（如歌手、专辑、曲目号、流派）。KODI的音乐刮削器会优先读取这些标签。

家庭视频（如自己拍的录像、婚礼视频）通常没有在线元数据。对于这类文件，我建议建立一个独立的媒体源，并关闭刮削器。你可以通过手动编辑NFO文件或使用KODI的“信息提供者”设置为“本地信息仅”来管理，完全依赖本地的NFO和缩略图文件。

3. 元数据的灵魂：深入理解NFO文件与本地刮削

当你完成了文件和目录的“形体”整理，接下来就要注入“灵魂”——元数据。虽然KODI的在线刮削器很强大，但在网络不稳定、影片冷门或需要高度定制时，本地NFO文件就是终极解决方案。

3.1 NFO文件是什么？为什么需要它？

NFO（Info）文件是一个纯文本的XML文件，它包含了媒体文件的所有元数据信息。你可以把它理解为放在视频文件旁边的“身份证”。当KODI扫描到某个视频文件时，如果发现同目录下存在同名的.nfo文件（如The Matrix (1999).nfo），它会优先读取这个文件的内容，而跳过在线刮削的步骤。

使用NFO文件的三大优势：

1. 离线可用：媒体库搭建完成后，即使完全断网，所有影片信息、海报均正常显示。
2. 100%准确：你可以完全控制显示的内容，避免在线刮削因版本、翻译问题导致的错误匹配。
3. 高度定制：可以添加在线数据库没有的信息，或者为家庭视频创建完整的元数据。

3.2 如何创建与编辑NFO文件？

你不需要手写复杂的XML。通常有两种高效的方法：

方法一：利用KODI“导出库”功能（最推荐）这是构建本地NFO库最快捷的方式。首先，确保你的媒体库已经通过在线刮削器整理得比较完美。然后，进入KODI的“视频” -> “文件”视图，找到你的电影或电视剧源目录。

1. 右键点击媒体源（如“电影”或“电视剧”文件夹），选择“扫描到库”。
2. 等待在线刮削完成，库内容变得美观。
3. 再次右键点击该媒体源，选择“导出”。
4. 在导出设置中，关键步骤来了：务必勾选“将影片信息导出为独立NFO文件”和“演员缩略图”、“缩略图”等选项。同时，选择“覆盖现有图片和NFO”（如果你确定要更新）。
5. 点击确定。KODI会自动遍历你的媒体库，为每一个视频文件生成一个同名的.nfo文件，并将所有海报（poster）、背景墙（fanart）、剧集缩略图等下载到本地，存放在与视频文件相同的目录或相邻的extrathumbs等文件夹中。

完成此操作后，你的媒体文件夹会多出很多文件。下次，当你（或在新设备上）重新添加这个媒体源时，在设置刮削器步骤，选择“信息提供者”为“本地信息仅”，KODI就会瞬间从本地NFO和图片文件构建出完整的媒体库，速度快到惊人。

方法二：使用第三方工具生成对于大量尚未入库的新文件，或者想批量编辑，可以使用像TinyMediaManager、MediaElch这样的专业媒体信息管理工具。这些工具可以批量从TMDB、TVDB抓取信息，并生成标准化的NFO文件和下载图片，效率极高。它们生成的NFO格式与KODI完全兼容。

3.3 NFO文件的核心结构解析

了解NFO文件的基本结构，有助于你手动微调或排查问题。一个典型的电影NFO文件内容如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <movie> <title>黑客帝国</title> <originaltitle>The Matrix</originaltitle> <sorttitle>Matrix</sorttitle> <year>1999</year> <mpaa>R</mpaa> <uniqueid type="tmdb" default="true">603</uniqueid> <uniqueid type="imdb">tt0133093</uniqueid> <plot>一名年轻的网络黑客尼奥发现，看似正常的现实世界实际上是由一个名为“矩阵”的计算机人工智能系统控制的……</plot> <tagline>欢迎来到真实的荒漠</tagline> <studio>华纳兄弟影片公司</studio> <genre>动作</genre> <genre>科幻</genre> <actor> <name>基努·里维斯</name> <role>尼奥</role> <thumb>https://image.tmdb.org/t/p/original/...jpg</thumb> </actor> <!-- 更多演员... --> <art> <poster>folder.jpg</poster> <fanart>fanart.jpg</fanart> <banner>banner.jpg</banner> <clearart>clearart.png</clearart> <landscape>landscape.jpg</landscape> </art> <thumb aspect="poster">poster.jpg</thumb> </movie>

关键字段解读：

• <uniqueid>：这是最重要的字段之一，特别是type="tmdb"。它存储了该影片在TheMovieDB.org网站上的唯一ID。有了这个ID，KODI或任何其他工具都能在未来精准无误地定位和更新这部影片的元数据，即使你重命名了文件。
• <art>和<thumb>：定义了各种艺术图片的本地文件名。KODI会优先在视频文件同级目录寻找这些文件。
• 对于电视剧，根标签是<tvshow>或<episodedetails>，结构类似，但包含<season>和<episode>等标签。

重要经验：在导出或生成NFO时，务必确保包含了<uniqueid>，尤其是TMDB ID。这是保证你媒体库未来可维护、可迁移的“数据锚点”。

4. 刮削器配置：连接在线世界的桥梁

尽管我们推崇本地NFO，但在线刮削器仍然是初次构建库或获取最新信息的利器。正确配置刮削器是避免“刮不到”或“刮错”的关键。

4.1 电影刮削器选择与配置

KODI默认的电影刮削器是“The Movie Database”和“IMDb”。TMDB是目前最活跃、中文支持较好的选择。

1. 进入“设置” -> “媒体” -> “视频”，确保“启用视频信息扫描”已打开。
2. 进入你的电影媒体源，选择“设置”。
3. 在“选择信息提供者”中，选择“The Movie Database”。
4. 点击“设置”，这里有几个关键选项：
   • 首选语言：设置为“zh-CN”可以优先获取中文信息。但有时中文翻译质量不佳，你也可以设为“en-US”获取英文信息，KODI界面仍可显示为中文（取决于皮肤）。
   • 使用原始标题：如果勾选，刮削后会显示影片的原始语言标题（如英文名），否则显示翻译后的标题。
   • 评分来源：可以选择TMDB评分、IMDb评分等。

4.2 电视剧刮削器的特殊之处

电视剧刮削器首选“The TVDB”。TVDB是剧集信息的传统权威，但近年来API不稳定。“The Movie Database (TV Shows)”是另一个很好的选择，数据源自TMDB的电视剧部分。 配置电视剧源时，选择信息提供者为“The TVDB”。其设置中有一个非常重要的选项：“季集排序方式”。这决定了刮削器如何匹配你的剧集文件。

• DVD排序：按照DVD发行的碟片顺序。
• 绝对排序：将所有剧集按一个顺序排列，无视季的划分（适用于某些动画或英剧）。
• 默认排序：即TVDB的官方“ aired order”（播出顺序）。绝大多数情况下，你应该选择“默认”。除非你非常清楚你的文件是DVD顺序，否则选错会导致整个剧集的季和集全部错乱。

4.3 刮削失败排查与手动修正

即使一切配置正确，刮削失败也时有发生。以下是排查步骤：

1. 检查命名与结构：回头仔细对照第2章，确保命名和目录结构100%符合规范。这是最常见的原因。
2. 检查网络连接：TMDB、TVDB的API服务器在海外，需要稳定的网络连接。可以尝试在刮削器设置中更换API密钥（如果有）。
3. 使用“刷新”功能手动指定：在KODI库中，找到识别错误的影片，调出上下文菜单（通常按键盘“C”键或遥控器菜单键），选择“影片信息” -> “刷新”。这时KODI会弹出搜索框，列出可能的匹配结果。你可以手动选择正确的一项。如果列表里没有，你可以直接输入影片在TMDB上的ID（URL中的数字，如/movie/603的ID就是603），这是最精准的方式。
4. 查看日志：在KODI的设置中开启“调试日志”，然后尝试刮削。日志文件会记录刮削器发出的具体请求和返回的错误信息，是高级用户排查问题的终极武器。

5. 艺术资料的优化：让海报墙完美呈现

一个漂亮的媒体库，一半功劳在于元数据文字，另一半在于精美的视觉艺术资料：海报、背景墙、标志、横幅等。KODI支持多种艺术图类型，合理利用能让界面效果飞跃。

5.1 核心艺术文件类型及其作用

• poster（海报）：最常见的方形海报，用于列表视图和详情页封面。
• fanart（背景墙/横幅）：宽屏背景图，通常在进入影片详情时全屏显示，营造氛围。
• banner（横幅）：长条形的横幅图，在一些皮肤（如Arctic Horizon 2）的横幅视图模式中使用。
• clearart（透明标志）：去除背景的影片LOGO，通常叠加在fanart上，非常炫酷。
• landscape（风景图）：类似fanart但比例不同，常用于某些皮肤的主页推荐视图。
• discart（碟片图）：蓝光或DVD碟片的封面图。
• character art（角色图）：演员的角色定妆照。

5.2 如何获取和管理本地艺术文件？

1. 通过“导出库”自动下载：如前所述，这是最省事的方法。KODI会根据刮削到的信息，自动从TMDB等网站下载对应的poster、fanart等，并保存为本地文件（如movie.tbn,fanart.jpg）。
2. 手动下载与命名：你可以从TMDB、Fanart.tv等网站手动下载喜欢的图片。关键是正确的文件名。KODI会按以下优先级查找图片：
   • 与视频文件同名（如The Matrix (1999)-poster.jpg）
   • 固定的文件名：poster.jpg、fanart.jpg、banner.jpg、clearart.png等。
   • 通用的movie.tbn（对于电影）或tvshow.tbn（对于剧集）。 我建议采用固定文件名的方式，清晰直观。例如，在《黑客帝国》的电影文件夹里，直接放入poster.jpg和fanart.jpg。

5.3 使用Jellyfin的CSS主题优化KODI显示？

网络热词中提到了“kodi jellyfin的css主题”。这里有一个常见的误解和高级玩法。Jellyfin是一个类似Plex的媒体服务器软件。所谓“Jellyfin的CSS主题”，通常是指：

• Jellyfin作为媒体服务器，KODI作为客户端：在Jellyfin服务器端整理好所有元数据和图片，然后通过KODI的“Jellyfin for Kodi”插件来访问。此时，KODI只是一个播放前端，所有界面元素（包括可能由CSS定义的部分样式）由插件从Jellyfin服务器获取。这种方式将刮削和管理的工作完全交给了Jellyfin服务器，KODI端几乎无需配置，非常适合多设备同步。
• 在KODI皮肤中自定义CSS：一些高度可定制的KODI皮肤（如Estuary MOD）允许通过修改CSS或XML文件来改变界面样式。有用户可能制作了模仿Jellyfin Web客户端风格的皮肤样式文件。但这需要较高的动手能力，涉及皮肤文件的修改。

对于绝大多数用户，我更推荐第一种方式：搭建Jellyfin服务器负责媒体管理和刮削，然后在所有电视、盒子上的KODI里安装Jellyfin插件并连接服务器。这实现了“一次刮削，处处可用”，是比纯本地NFO更进阶的集中化管理方案。

6. 进阶实战：音乐视频（M3U列表）与网络源优化

6.1 解决M3U列表播放卡顿问题

“kodi m3u 卡”是一个高频问题。M3U文件是一个播放列表文件，常用于存放直播源或网络流媒体链接。在KODI中播放M3U列表卡顿，通常不是KODI本身的问题，而是由以下原因导致：

1. 网络源质量与稳定性：这是最主要的原因。免费的IPTV直播源常常带宽不足、服务器不稳定或同时观看人数过多。使用前，建议先用电脑上的VLC播放器测试一下该流地址的稳定性。
2. KODI的缓存设置不足：对于网络流媒体，适当的缓存可以平滑播放。你可以通过安装像“IPTV Simple Client”这样的插件来播放M3U，部分插件有缓存设置。更通用的方法是修改KODI的高级设置文件（advancedsettings.xml）。 创建一个名为advancedsettings.xml的文本文件，放入KODI的用户数据文件夹（通常位于%APPDATA%\Kodi\userdata\或~/.kodi/userdata/）。内容如下：

   <advancedsettings> <cache> <memorysize>139460608</memorysize> <!-- 缓存大小，单位字节，这里约133MB --> <buffermode>1</buffermode> <!-- 缓冲模式，1为全部缓冲 --> <readfactor>20</readfactor> <!-- 读取因子，值越大缓存越快 --> </cache> </advancedsettings>

   警告：修改高级设置文件需谨慎，错误的配置可能导致KODI无法启动。建议先备份原文件（如果存在）。增加缓存会占用更多内存，但能有效缓解因网络波动造成的卡顿。
3. 硬件解码能力：如果播放的是高清（如1080p以上）或高码率流，确保你的播放设备（电视盒子、电脑）支持该视频格式的硬解。可以在KODI的“设置->系统->显示”中查看和调整硬件加速选项。

6.2 处理“artist.nfo”等音乐元数据

“kodi nfo格式 artist”指向了音乐库的艺术家NFO。对于音乐，除了专辑和歌曲的元数据，你还可以为艺术家创建独立的artist.nfo文件，来丰富艺术家信息。 这个文件应放在艺术家文件夹的根目录下。其内容可以包含艺术家的传记、风格、成立日期等。同样，你可以先用在线刮削器扫描音乐库，然后使用“导出音乐库”功能来生成包含artist.nfo在内的所有NFO文件。对于音乐爱好者，维护好ID3标签是第一步，配合本地NFO能让音乐库的管理水平达到专业级别。

7. 长期维护与迁移：打造可持续的媒体资产

正确地准备媒体文件，不仅是为了当下好看，更是为了将来省心。一个规划良好的媒体库，应该易于备份、迁移和更新。

1. 集中存储与路径无关性：尽量使用相对路径或网络路径（如SMB、NFS）来添加媒体源，而不是绝对路径（如D:\Movies）。例如，使用\\NAS\Media\Movies这样的网络共享路径。这样，即使你更换了播放设备，只要它能访问同一个网络位置，媒体库就能无缝衔接。
2. 定期备份“用户数据”文件夹：KODI所有的设置、插件、数据库和缩略图缓存都存放在其“用户数据”目录。定期备份这个文件夹（尤其是其中的Database和Thumbnails子文件夹），可以在系统重装后快速恢复你的整个媒体库状态，包括观看进度、收藏夹等。
3. 版本控制与工具化：对于NFO文件，你可以考虑使用Git等版本控制系统进行管理（虽然听起来有些极客），这能让你追踪对元数据的手动修改。更实际的是，将TinyMediaManager这样的工具纳入你的工作流。每加入一批新电影，先用工具批量重命名、刮削、生成NFO和下载图片，然后再放入媒体文件夹并由KODI扫描。这能将后期手动修正的工作量降到最低。
4. “本地信息优先”原则：一旦你通过导出功能建立了完整的本地NFO和图片库，以后添加媒体源时，始终坚持选择“本地信息仅”作为刮削器。这能保证你的库展示完全一致，不受在线数据库变动的影响，并且扫描速度极快。

整理媒体文件像打理一个数字花园，初期的规划和投入确实需要一些耐心，但一旦体系建立起来，后续的维护成本极低，而获得的观赏和管理体验提升是巨大的。从今天开始，用这套方法重新审视你的媒体文件夹，你会发现，一个井然有序、美观强大的家庭影院核心，其实就藏在这些看似繁琐的命名规则和XML文件里。