媒体目录规划与命名规范

部署完成、转码可用，接下来是决定刮削成败的一步：目录结构与文件命名。刮削器不认识“好片子”，它只认识文件名里的片名、年份与编号。本篇给出可以直接照抄的规范，以及每条规范背后的原因。

一、顶层结构：一个根目录，三个类型

媒体目录的组织原则是“根目录唯一，类型分层”。一个典型的结构如下：

/media
  /Movies
  /TV Shows
  /Music
  /家庭录像

一级目录名建议与 Jellyfin 建库时选择的“内容类型”一一对应，库与目录之间是一对一绑定关系。混在一起的目录（电影和剧集放在同一层）不仅识别率低，也会给日后按库备份与迁移添麻烦。

这一层还有几个实用约定。目录名可以中英文混写，但整套库保持一致：要么全用英文（与社区教程一致，出问题搜起来方便），要么全用中文（家人看着亲切）。每个类型库各自独立还有一个隐藏好处：各库的扫描与刮削互不阻塞，电影库扫描时剧集库的海报墙依然能正常浏览，故障影响范围被天然隔离。最后一层是预留位：给家庭录像、自录视频这类不刮削的内容留一个“手工库”，它只按目录浏览不参与元数据匹配，命名自由度最高。

把目录结构与权限合起来看，还有一条经验：媒体根目录越浅越好。宿主机上 /srv/media 挂进容器就是 /media，一层到位；若宿主机路径层层套叠，容器里依然只是 /media，但宿主机侧的权限链、备份脚本、硬盘挂载点都要跟着绕路。浅而规整的根目录让存储扩展、库拆分、权限调整都变成简单操作，这是第一章存储规划的延续，《NAS 自建指南》 里对目录与阵列的展开可以对照阅读。

二、电影：片名加年份是万能公式

电影的规范写法是“片名（年份）”，每一位刮削器都认这个格式：

/Movies/流浪地球 2 (2023)/流浪地球 2 (2023) [2160p].mkv
/Movies/黑客帝国 (1999)/黑客帝国 (1999).mkv

用电影自己的文件夹包住单个文件不是必须，但好处明显：同一部片的多版本、外挂字幕、海报图都能集中在一起，还能直接往里扔一张海报图被 Jellyfin 优先使用。文件名里的方括号标记分辨率与编码属于锦上添花，刮削器会自动忽略不认识的标记部分。

年份的另一个作用是处理同名作品：同样是“猩球崛起”系列前传与正传，年份是区分它们的唯一可靠依据。国产片与翻拍片同理，同名不同年，一个数字就能让识别准确率从“碰运气”变成“必中”。方括号与圆括号混用时注意一个细节：刮削器解析年份只认紧贴片名的圆括号，其他括号内容一律视为忽略标记。

三、剧集：季目录与 SxxExx 编号

剧集的规范层级更多，一套标准写法是“剧名/季/剧名 SxxExx”：

/TV Shows/绝命毒师 (2008)/Season 01/绝命毒师 S01E01.mkv
/TV Shows/绝命毒师 (2008)/Season 02/绝命毒师 S02E05.mkv

SxxExx 是剧集识别的核心，季编号两位、集编号两位，刮削器优先把它交给 TheTVDb 查询。特别篇（SP、OVA）放在 Season 00 目录下，用 S00Exx 编号；要点是编号一旦自洽，整季的顺序就不会乱。中文剧名放心用，数据源对中文剧名的支持以拼音与译名混合识别，遇到识别不准时手动指定编号是最快的解法。

季目录名有没有统一格式？社区流行两种：Season 01 与 Saison 01 或直接写“第 1 季”，三者都能被识别。选择标准还是那句话：全库统一。不一致的季目录偶尔会让刮削器犯晕，把两季并成一季或多出一个空季，修起来要逐个改名重扫，得不偿失。此外剧集的“年前缀”加不加都可以，但长寿剧集建议加上年份区分翻拍版。

四、音乐：艺人、专辑、曲目三层

音乐库走“艺人/专辑/曲目”的层级，配合 MusicBrainz 数据源：

/Music/周杰伦/范特西/01 双截棍.flac
/Music/周杰伦/范特西/02 简单爱.flac

音乐刮削比影视更依赖标签：APE 与 FLAC 的内嵌标签质量直接决定专辑封面与曲目顺序。文件名前的两位曲目编号帮助排序，缺失时以标签内 track 字段为准。把同一首曲子的多种格式混在同一专辑目录是无妨的，但不同混音版本请分目录，否则容易扫出重复条目。

音乐库还有一个特点：它对“整理完好”的要求最低。周杰伦的专辑里有几首标签缺失，刮不动也不影响听，先放着以后慢慢补。把主要精力放在影视库，音乐库佛系维护，是家庭玩家的常态。

五、命名之外的细节

直放图与 NFO：任何一个媒体文件夹里都可以手工放一张 poster.jpg 或 Movie.nfo。手动文件优先级高于在线刮削，等于给条目钉上一个“我说是啥就是啥”的锚，特别适合自录视频和冷门作品。

多版本文件：同一部片的 1080p 与 4K 版本可以同名放在同一目录里，Jellyfin 会把它们作为多版本聚合显示。实际使用中更常见的做法是分两个目录建两个库，海报墙会重复但互不干扰。

六、已有库的改造：从乱到治

多数人的库不是从零开始的，而是好几年散落下载积累出来的。一次性全部重命名工作量巨大，可行的策略是分层推进：先整理剧集（因为顺序错乱最影响观看），再整理电影，音乐库最后佛系处理。命名工具支持批量改名，配合“原名加年份”的规则，几百个文件的处理量在一个周末之内可以完成。

改造期间 Jellyfin 不用停。改好一个目录就触发该库的扫描，改坏了一处看海报墙立刻能发现。比起先改完再扫描，边改边验证更容易保持节奏，也避免最后面对一个完全陌生的海报墙无从下手。

改造完成后做一次全库扫描，并趁机统一一次海报与合集：把多年的库推倒重建不可能，但“命名规范加海报整齐”是完全可以达到的状态。这一步做完之后，媒体库就真正进入了“低维护运转”的阶段。

给总量不小的库再补一个省力技巧：Jellyfin 支持配置“库排除目录”，把暂时不想整理的旧目录整体排除，扫描器就不会为它们浪费时间。等哪年有心情了，再把某个目录纳入扫描，一次清理一个目录，逐步把旧库消化掉。

从更高一层看，命名规范是自建影音与“云盘存片”流派的分水岭。云盘用户靠搜索找片，文件名再乱也能搜到；Jellyfin 的海报墙靠刮削工作，命名越规范，浏览体验越接近真正的影视 App。规范一旦深入人心，家人也会形成“下好片子先改名再入库”的默契，整个系统就从你一个人的爱好升级成全家的习惯。

把规范落到执行层面，还可以准备一份简单的共享说明：在家庭群里放一张命名示例图，说明电影放哪、剧集放哪、音乐放哪。这张图就是家庭媒体库的“入库手册”，家人照着做，你维护起来就轻松。自建系统的终极形态不是配置多精妙，而是运转起来不需要你——命名规范是离这个目标最远的一步，也是最值得先迈的一步。

规范文档之外，媒体库的“准入规则”也值得立两条：未命名的文件先进下载暂存目录而非媒体库；整理确认后再移动入库。这两个动作可以用下载工具的自动移动与脚本来衔接，下载与整理的自动化是本书最后一章联动的主题之一。

规范做完还有一种长期红利：与其他玩家的交流变得轻松。当你的目录结构与社区主流一致，遇到任何问题去搜，别人的回答你能直接照搬；反之，目录结构特殊时，每个建议都要先翻译成你的结构才用得上。社区默契是看不见但很贵的资产，早对齐早享受。

不要做的几件事：文件名里用特殊符号、把剧集和电影混放、用“新建文件夹”当目录名、在媒体目录里放下载工具的临时文件。这些不会立刻出问题，但会在某次扫描后突然发作。命名规范推广到全家也值得花点心思：给家人一个“片名加年份”的模板，他们自己下载的片子规规矩矩放进对应目录，整个库就不需要你一个人维护。

命名规范是“一次性投入终身受益”的典型：第一个月辛苦整理，后面新增文件按模板照抄，海报墙永远干净。存储层面的目录规划与硬件平台无关，群晖与自组主机都是同一套规则，《群晖 DSM 指南》 与 《NAS 自建指南》 的共享目录章节可以对照搭建。

延伸阅读

• 刮削的具体过程与修正见本篇刮削一篇；
• 海报墙的整理与修订技巧见第四章海报墙整理一篇；
• 媒体存放位置与备份见第一章与 NAS 衔接一篇。