文件与文件夹命名

名称取得好，服务器才能正确识别你的作品。这一页说明电影、剧集、特典、字幕和图片该怎么命名与摆放。想知道哪些摆放方式也行，见放文件很自由。

总原则：文件夹名 = 作品名 + 年份，视频与附属文件放在同一个文件夹里。年份能帮助刮削配对到正确的作品；没有年份也能用，只是同名作品更容易配错。

把 ID 写进名称#

文件夹或文件名里带上来源 ID，刮削会直接使用它，不再靠名称猜测，这是最准的做法。

Movies/
  Inception (2010) [tmdbid-27205]/
  The Matrix (1999) {imdb-tt0133093}/
TV Shows/
  Breaking Bad (2008) [tmdbid-1396]/
    Season 1/

可用的写法：[tmdbid-123]、{tmdb-123}、[imdbid-tt1234567]、{imdb-tt1234567}、[tvdbid-123]（大小写不拘）。ID 不会出现在显示名称里。季文件夹上的标记是这一季自己的 ID。

电影#

标准版面：一部电影一个文件夹。

Movies/
  全面启动 (2010)/
    全面启动 (2010).mkv
    全面启动 (2010).nfo               （可选）
    poster.jpg                        （可选）
    fanart.jpg                        （可选）
    全面启动 (2010).zh-Hans.srt       （可选的外挂字幕）

• 片名与年份可以写成 片名 (2010)、片名 [2010] 或 Name.2017.1080p。出现多个年份时，取最后一个被分隔符包住的年份。文件名里的 1080p、BluRay、x265 等发行标记会被忽略。
• 电影文件也可以直接放在媒体库根目录（Loose Movie (2019).mp4），但这时 poster.jpg、movie.nfo 这类文件夹层级的文件不会分给它，要用「文件名 + 后缀」的写法：Loose Movie (2019)-poster.jpg、Loose Movie (2019).nfo。建议一部电影一个文件夹。
• 多部电影放在同一个文件夹也可以，各自成片；但文件夹层级的 poster.jpg、movie.nfo 不会分给其中任何一部，图片请命名为 <文件名>-poster.jpg。

同一部电影的多个版本#

同一个文件夹里，文件名为「文件夹名 - 版本名」的多个视频会合并成一部电影、多个版本，播放时可以选择版本。

Blade Runner 2049 (2017)/
  Blade Runner 2049 (2017) - 1080p.mkv
  Blade Runner 2049 (2017) - 4K.mkv

• 版本名是 - 后面的文字（1080p、4K、导演剪辑版、Director's Cut 等都行）。
• 最多合并 8 个版本。超过 8 个，或文件名之间没有共同的片名，就各自成片。
• [tmdbid-…] 标签不影响合并，带不带都算同一部。
• 放在不同文件夹里的同一部电影（例如 1080p 在一处、4K 在另一处）不按这条规则合并。

分段视频（CD1 / CD2）#

一部电影被切成多个文件时，文件名用 cd1、cd2（或 part1、disc2、pt2）结尾，它们会叠成一部电影，依序连续播放。

CAT-1001/
  CAT-1001-cd1.mp4
  CAT-1001-cd2.mp4

段号只能是一个字符（1 到 9 或 a 到 d）；分隔符可以是空格、.、_、-；大小写不拘。

特典（预告片、花絮等）#

有两种放法：

1. 放进专用子文件夹，名称用以下之一：trailers、extras、featurettes、behind the scenes、deleted scenes、interviews、scenes、shorts、clips、other、预告片、花絮、特典。
2. 与正片放在同一个文件夹，文件名加后缀：-trailer、-featurette、-deleted 等（例如 XXX-trailer.mp4）。

特典会挂在那部电影（或那部剧集、那一季）下面，不会被当成独立电影。

带编号的影片#

• 文件夹与文件名用编号，例如 CAT-1001/CAT-1001.mp4。分段与多版本的规则同上。
• 编号字段（可以按编号搜索）来自 NFO 的 <num>。服务器不会从文件名猜编号，因为误判风险高。请用刮削工具或插件产生 NFO，或用刮削插件补上。
• 多部作品放在同一个文件夹时，请使用 <文件名>-poster.jpg 与 <文件名>.nfo，否则图片和 NFO 不会被分配。

光盘映像与光盘文件夹#

• 支持 .iso 蓝光映像。 一个映像就是一个播放单位，会自动找出正片、取得片长与章节。多张盘请用 -disc1、-disc2 规则。
• 不支持光盘文件夹（拆开的 BDMV/、VIDEO_TS/ 结构）。里面的 .m2ts、.vob 会被略过，避免一张盘变成几十部「电影」。请把光盘封装成 .iso，或用 MakeMKV 转成 .mkv。
• DVD 的 .iso、.img、.nrg 目前不支持，会入库但没有媒体信息。

剧集#

标准版面：剧集文件夹 → 季文件夹 → 单集文件。

TV Shows/
  Breaking Bad (2008)/
    tvshow.nfo                       （可选）
    poster.jpg                       （可选）
    Season 01/
      season.nfo                     （可选）
      Breaking Bad - S01E01 - Pilot.mkv
      Breaking Bad - S01E01 - Pilot.nfo
      Breaking Bad - S01E01 - Pilot-thumb.jpg
      Breaking Bad - S01E02.mkv
    Season 02/
      Breaking Bad - S02E01-E02.mkv  （一个文件包含两集）
    Specials/
      Breaking Bad - S00E01.mkv

季文件夹可以叫 Season 1、Season 01、S01、第2季、第二季。Specials、特别篇 是第 0 季（特别篇）。没有视频的季文件夹不会建立季。

单集文件名认得这些写法：

• 单集标题优先用 NFO 的标题；没有 NFO 时，取文件名里季集标记之后的文字（遇到 1080p、WEB-DL 这类技术标记就截掉）；都没有就显示「第 N 集」。
• 季数优先看 NFO，其次看文件名，最后看所在的季文件夹。
• 季文件夹不是必须的。 单集可以直接放在剧集文件夹里，文件名写 S01E02 即可。动画常见的「只有集数、没有季」也可以放在剧集文件夹里，用绝对集数命名；刮削时会尝试把绝对集数对应到正确的季与集，对不上的会列为待识别，可以手动修正。- 剧集的季文件夹请用 Season N 这类带季号的名称。
• 特典：在剧集或季文件夹下放 extras 等特典文件夹，和电影一样。

分类文件夹#

不必把每部剧都放在媒体库根目录。

剧集/
  大陆/
    某某剧/
      Season 1/
  日本/
    动画/
      某某动画/
        Season 1/
        Season 2/

「大陆」「日本」「动画」是分类文件夹，不会变成剧集，层数不限。服务器把第一层「直接放着视频、有季文件夹、或有 tvshow.nfo」的文件夹当作剧集，所以分类文件夹里不要直接放视频，放了就会被当成剧集。

上部／下部、第一部／第二部、Part 1／Part 2 这类分段文件夹，会被当成同一部剧的两个季。

每集一个文件夹的写法（下载发行版常见）也能用，但只适用于剧集媒体库，而且外面要有一层剧名文件夹，例如 剧名/[组] 剧名 - 01 [1080p]/、剧名/[组] 剧名 - 02 [1080p]/。这一层要有至少 2 个文件夹，每个只放 1 个视频，并且认得出不同的集数。

限制与建议#

• 剧场版动画（每部一个文件夹、各一个文件）请放在电影媒体库；放在剧集媒体库里，会变成集数很少的剧。
• 一个文件夹里放了好几部剧的单集（没有剧名文件夹）无法区分，请每部剧一个文件夹。
• 文件名只有纯数字（01.mkv）也能识别集数，但剧名要靠文件夹名，请确认文件夹名正确。

外挂字幕与外挂音轨#

放在视频旁边，文件名是视频文件名 + 语言标记 + 扩展名。

全面启动 (2010).mkv
全面启动 (2010).zh-Hant.srt
全面启动 (2010).en.ass
全面启动 (2010).chs.forced.srt

• 字幕格式：srt、ass、ssa、vtt、sup（蓝光图形字幕），以及 idx + sub（DVD 图形字幕）。单独的 .smi、.sub（MicroDVD）不支持。
• 语言标记：zh、zh-Hans、chs、zh-CN（简体）；zh-Hant、cht、zh-TW、big5（繁体）；en、eng、ja、jpn 等。加上 forced 或 default 可标记强制与默认字幕。
• 多版本电影可以用文件夹名当字幕的主文件名，这样会套用到所有版本。
• 新增或删除字幕文件后，实时监控或下一次扫描就会更新，不需要重建媒体库。

图片文件#

放在作品所在的文件夹，或用「文件名 + 后缀」放在视频旁边。

本地图片优先于网络来源，所以你手动放的图不会被刮削覆盖。支持 jpg、png、webp。