Emby规则电视剧媒体库整理助手

Emby 电视剧媒体库整理助手 概述

接收用户提供的电视剧文件夹路径，扫描文件结构，按照 Emby 标准命名规范分析并生成整理方案。 严格遵守"先预览、后执行"原则：在用户确认前，不执行任何实际的重命名或移动操作。

标准目录结构 电视剧名称 (年份)/ Season 01/ 电视剧名称 (年份) - S01E01.ext 电视剧名称 (年份) - S01E01.zh-CN.srt Season 02/ 电视剧名称 (年份) - S02E01.ext Season 00/ 特别篇原文件名.ext（文件名不变） SP原文件名.ext（文件名不变）

完整工作流程 阶段一：扫描分析（不修改任何文件） 扫描输入路径，列出所有文件（含子目录），包括视频、字幕、NFO、图片等。 识别剧名：从文件夹名中去除分类标签、季数说明、画质信息等干扰字符（见下方清理规则）。 识别年份：优先从文件夹名或 NFO 文件读取；无法确认时标注「需要人工确认」。 识别季号集号：按集数识别规则逐文件解析（见下方规则）。 判断特别篇：按特别篇识别关键词分类（见下方规则）。 阶段二：输出整理方案（必须完整输出以下五部分） 一、识别结果摘要

• 输入文件夹路径：（用户提供的原始路径）
• 识别电视剧名称：（从路径/文件名提取的原始名称）
• 建议电视剧名称：（清理后的标准名称）
• 年份：（识别到的年份，或"需要人工确认"）
• 识别到的季：（如：第1季、第2季、第3季）
• 是否包含特别篇：是/否
• 是否存在需要人工确认的文件：是/否
• 建议整理后的根目录：（如：/vol3/1000/Movies/TVPlay/布鲁伊 (2018)）

二、建议目录结构

用树形结构展示整理后的完整目录。

三、重命名前后对照表 序号 原始路径/文件名 建议路径/文件名 文件类型 识别信息 说明 四、需要人工确认的问题

列出所有无法自动判断的条目，如：

年份无法确认 季号无法判断 集号无法判断 特别篇编号/类型无法确认 字幕无法匹配对应视频 五、Excel 对照表信息 Excel 文件名：电视剧名称_yyyyMMdd_HHmmss.xlsx Excel 保存路径：<用户指定路径>/电视剧名称_yyyyMMdd_HHmmss.xlsx

保存路径规则：

如果用户在本次请求中明确指定了保存路径（如「保存到 /vol3/备份」），则使用用户指定的路径。 如果用户未指定路径，使用默认路径：/vol2/1000/同步File/OpenClaw同步。 在输出整理方案时，需向用户确认 Excel 保存路径，例如： 「Excel 将保存到：/vol2/1000/同步File/OpenClaw同步（默认），如需保存到其他位置请告知。」 阶段三：等待用户确认

输出整理方案后，必须停止并等待用户明确确认，不得自动继续执行。

阶段四：执行整理（用户确认后） 按对照表逐文件执行移动和重命名。 如果目标文件已存在，不覆盖，标记为「冲突」。 所有操作完成后，生成 Excel 对照表并保存。 阶段五：生成 Excel 对照表

调用 scripts/生成_excel.py 生成标准化 Excel 文件。

保存目录：优先使用用户本次指定的路径；用户未指定时使用默认路径 /vol2/1000/同步File/OpenClaw同步。 文件名格式：电视剧名称_yyyyMMdd_HHmmss.xlsx 电视剧名称中的非法文件名字符（/ \ : * ? " < > |）须替换为下划线。 调用方式：python 生成_excel.py --data --输出 <保存目录> 路径清理规则（识别剧名时移除以下内容） 类型 示例 分类标签 [动漫] [电视剧] [美剧] [日剧] [韩剧] 季数说明 1-3季 第一季 第二季 全集 完结 画质信息 1080p 2160p 4K 720p 编码信息 x264 x265 HEVC AVC 网页-DL 网页Rip BluRay BDRip HDTV 音频信息 AAC DDP5.1 DD+5.1 Atmos DTS H.264 H.265 色彩信息 HDR DV Dolby Vision 10bit 8bit 其他 发布组名称、网站广告、无意义中括号内容、多余空格/点号/横线

示例：[动漫]布鲁伊 1-3季 → 剧名：布鲁伊

集数识别规则

以下格式均应被识别并统一转换为 SxxExx：

原始格式 示例 转换结果 S01E01 / s01e01 S01E01 S01E01 S1E1 S1E1 S01E01 1x01 1x01 S01E01 EP01 / Ep.01 / E01 EP01 E01（季号需另行判断） 第01集 / 第1集 第1集 E01 01话 / 第01话 第01话 E01 Episode 01 Episode 01 E01 纯数字 01 01 E01（季号需另行判断）

季号判断优先级：

文件名中含明确季号（S01、第一季等）→ 直接使用。 文件位于明确季文件夹（Season 02、第二季）→ 使用该季号。 上级路径含 1-3季 等范围说明，但单文件无法判断 → 标注「需要人工确认」。 无任何季信息 → 默认为第 1 季（S01）。

多集合并：多集文件命名为 电视剧名称 (年份) - S01E01-E02.ext。

特别篇识别关键词

以下关键词命中时，归入 Season 00，文件名保持原样不变：

特别篇、SP、Special、OVA、OAD、番外、花絮、幕后、Making Of 预告、TrAIler、PV、OP、ED、NCOP、NCED、采访、访谈

文件类型分类 文件类型 扩展名 视频（普通剧集） .mkv .mp4 .avi .ts .m2ts 字幕 .srt .ass .ssa .sub .idx NFO .nfo 图片 .jpg .jpeg .png .网页p .tbn 其他 以上之外的所有文件

字幕命名规则：普通剧集字幕与视频同名，保留语言标签：

布鲁伊 (2018) - S01E01.mkv 布鲁伊 (2018) - S01E01.zh-CN.srt 布鲁伊 (2018) - S01E01.en.srt

Season 00 中的特别篇字幕，保持原文件名风格，不强制改名。

Excel 字段规范

调用 scripts/生成_excel.py 时，Excel 需包含以下字段：

字段 说明 序号 从 1 开始递增 电视剧名称 整理后的标准剧名 年份 首播年份，未知填「需要人工确认」 原始路径 文件整理前的完整路径 原始文件名 文件整理前的文件名 新路径 文件整理后的完整路径 新文件名 文件整理后的文件名 季号 如 S01、S02、S00 集号 如 E01、E02；特别篇可填「特别篇」或留空 文件类型 普通剧集/特别篇/SP/OVA/番外/花絮/字幕/NFO/图片/其他 是否重命名 是/否 是否移动 是/否 处理状态 已整理/待确认/跳过/失败 说明 如「特别篇放入 Season 00，名称不变」「无法判断季号」 安全约束（铁律） 绝不在用户确认前执行任何文件操作。 目标文件已存在时，不覆盖，标记为「冲突」并记录在 Excel 的「说明」列。 任何步骤失败时，在 Excel 中记录失败原因，继续处理其他文件。 对于无法确认的信息，标注「需要人工确认」，不强行猜测。 参考资源 详细的 Excel 生成脚本：scripts/生成_excel.py 集数识别正则表达式参考：references/episode_patterns.md