Jellyfin如何正确命名多季剧集目录？

Question

在使用 Jellyfin 管理多季电视剧时，用户常因文件夹命名不规范导致剧集无法正确识别和分类。一个典型问题是：如何按照 Jellyfin 的媒体库扫描规则，正确命名多季剧集的目录结构？例如，应否使用“Season 01”还是“Season 1”？是否支持自定义文件夹名称？若命名不符合预期格式，Jellyfin 可能无法匹配季度内容，导致剧集显示错乱或缺失。掌握正确的命名约定（如 TVDB 推荐结构）对实现自动识别至关重要。

Answer 1

1. Jellyfin 媒体库扫描机制概述

Jellyfin 作为一款开源媒体服务器，其核心功能之一是通过智能文件扫描与元数据匹配来组织影视内容。当用户添加电视剧目录时，Jellyfin 会依据内置的命名解析规则（基于 TVDB、TheMovieDB 等元数据源）自动识别剧集信息。若文件夹结构或命名不符合规范，则可能导致剧集无法正确归类。

扫描过程主要依赖以下路径层级：

1. 剧集根目录（如：Breaking Bad/）
2. 季度子目录（如：Season 01/ 或 Season 1/）
3. 视频文件（如：Breaking Bad - S01E01 - Pilot.mkv）

系统通过正则表达式匹配文件路径中的关键词进行解析，因此命名一致性至关重要。

2. 标准命名约定：Season 01 还是 Season 1？

根据 Jellyfin 官方文档及社区实践，推荐使用带前导零的格式：Season 01。虽然两者在技术上均被支持，但“Season 01”更符合 TVDB 推荐结构，能提高元数据匹配成功率。

命名方式	兼容性	推荐度	说明
Season 01	高	★★★★★	最稳定，广泛支持，推荐首选
Season 1	中	★★★☆☆	部分插件可能识别失败
S01	高	★★★★☆	简洁，常用于文件内部命名
第1季	低	★☆☆☆☆	需手动配置语言偏好，易出错

3. 支持自定义文件夹名称吗？

Jellyfin 默认支持一定程度的自定义命名，但需满足特定模式。例如：

• Season 01, Season 1, s01, Series 1
• 特殊别名如 Specials 用于特别篇

然而，完全非标准命名（如 My Awesome Season One）将导致扫描失败。可通过修改 custom naming rules 插件或调整元数据提供者设置实现扩展支持。

4. 典型错误案例分析

常见问题包括：

1. 混合使用 Season 1 和 Season 02 导致排序异常
2. 缺失季度目录，直接将所有剧集放在根目录下
3. 使用中文命名如 第一季 而未配置对应语言元数据源
4. 文件名不含 SxxExx 格式，仅靠顺序编号

这些问题会导致 Jellyfin 显示为多个独立剧集或无法加载封面和简介。

5. 推荐目录结构示例

TV Shows/
├── Breaking Bad/
│   ├── Season 01/
│   │   └── Breaking Bad - S01E01 - Pilot.mkv
│   ├── Season 02/
│   │   └── Breaking Bad - S02E01 - Seven Thirty-Seven.mkv
│   └── Specials/
│       └── Breaking Bad - S00E01 - The Making of Breaking Bad.mkv
├── Stranger Things/
│   ├── Season 01/
│   │   └── Stranger Things - S01E01 - Chapter One.mkv

该结构遵循 TVDB 推荐标准，确保最大兼容性。

6. 高级配置与自动化方案

对于大规模媒体库管理，建议结合工具链实现规范化：

1. 使用 FileBot 自动重命名并整理文件
2. 部署 MediaElch 验证本地元数据完整性
3. 编写脚本监控新增内容并触发 Jellyfin 库刷新 API

7. 扫描流程图解

graph TD A[用户添加媒体库路径] --> B{Jellyfin 扫描目录} B --> C[识别剧集根目录] C --> D[查找季度子目录] D --> E[解析 SxxExx 文件名] E --> F[查询 TVDB/TheMovieDB 匹配元数据] F --> G[生成海报、简介、字幕等] G --> H[前端展示结构化内容]

8. 多语言与区域适配策略

在非英语环境中，可通过以下方式增强识别能力：

• 在 Jellyfin 设置中指定首选元数据语言
• 保留英文文件夹名，仅在元数据显示层切换语言
• 避免混用多语言命名（如同时存在 "Season 01" 和 "第1季"）

此举可兼顾本地化体验与系统稳定性。