Emby Tv Organizer

Emby 电视剧媒体库整理助手。当用户提供一个电视剧文件夹路径，需要按照 Emby 标准命名规范整理文件结构、识别季号集号、处理特别篇/SP/OVA、生成重命名对照表并输出 Excel 时，使用此 Skill。典型触发场景：「帮我整理这个电视剧文件夹」「按 Emby 规范重命名」「扫描 /vol3/... 文件夹并生成整理方案」。

Audits

Pending

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install emby-tv-organizer

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/backup」），则使用用户指定的路径。

如果用户未指定路径，使用默认路径：/vol2/1000/SyncFile/OpenClawSync。

在输出整理方案时，需向用户确认 Excel 保存路径，例如：「Excel 将保存到：/vol2/1000/SyncFile/OpenClawSync（默认），如需保存到其他位置请告知。」

阶段三：等待用户确认

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

阶段四：执行整理（用户确认后）

按对照表逐文件执行移动和重命名。
如果目标文件已存在，不覆盖，标记为「冲突」。
所有操作完成后，生成 Excel 对照表并保存。

阶段五：生成 Excel 对照表

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

保存目录：优先使用用户本次指定的路径；用户未指定时使用默认路径 /vol2/1000/SyncFile/OpenClawSync。
文件名格式：电视剧名称_yyyyMMdd_HHmmss.xlsx
电视剧名称中的非法文件名字符（/ \ : * ? " < > |）须替换为下划线。
调用方式：python generate_excel.py --data <json_file> --output <保存目录>

路径清理规则（识别剧名时移除以下内容）

类型	示例
分类标签	`[动漫]` `[电视剧]` `[美剧]` `[日剧]` `[韩剧]`
季数说明	`1-3季` `第一季` `第二季` `全集` `完结`
画质信息	`1080p` `2160p` `4K` `720p`
编码信息	`x264` `x265` `HEVC` `AVC` `WEB-DL` `WEBRip` `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` `.webp` `.tbn`
其他	以上之外的所有文件

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

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

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

Excel 字段规范

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

字段	说明
序号	从 1 开始递增
电视剧名称	整理后的标准剧名
年份	首播年份，未知填「需要人工确认」
原始路径	文件整理前的完整路径
原始文件名	文件整理前的文件名
新路径	文件整理后的完整路径
新文件名	文件整理后的文件名
季号	如 S01、S02、S00
集号	如 E01、E02；特别篇可填「特别篇」或留空
文件类型	普通剧集/特别篇/SP/OVA/番外/花絮/字幕/NFO/图片/其他
是否重命名	是/否
是否移动	是/否
处理状态	已整理/待确认/跳过/失败
说明	如「特别篇放入 Season 00，名称不变」「无法判断季号」

安全约束（铁律）

绝不在用户确认前执行任何文件操作。
目标文件已存在时，不覆盖，标记为「冲突」并记录在 Excel 的「说明」列。
任何步骤失败时，在 Excel 中记录失败原因，继续处理其他文件。
对于无法确认的信息，标注「需要人工确认」，不强行猜测。

参考资源

详细的 Excel 生成脚本：scripts/generate_excel.py
集数识别正则表达式参考：references/episode_patterns.md