整理监控

整理监控用于把下载、转存、STRM 实时事件或手动选择的文件加入整理队列，再按 NanShare 的识别、重命名、分类、元数据和刷新规则输出到媒体库目录。

功能位置

NanShare Web 中的文件整理分为几个页面：

页面	作用
整理监控	配置来源目录、目标目录、监控、移动/复制、元数据和刷新
文件管理	手动选择文件或目录执行预览、整理
整理历史	查看已整理记录，并可重新整理
基础配置	配置重命名模板、通知模板、媒体信息提取触发字段
词表配置	自定义识别词、制作组、捕获词、渲染后处理词
二级分类	配置电影/电视剧的分类规则

通知模板集中见自定义通知模板。

基础字段

字段	说明	示例
配置名称	用于区分不同整理任务，日志和队列会显示	`115电影整理`
源目录	待整理文件所在目录	`/downloads`、`/CloudNAS/115/待整理`
目标目录	整理后的媒体库根目录	`/media`、`/strm/library`
启用监控	开启后按监控模式自动发现源目录变化	开启 / 关闭
扫描间隔	兼容模式下轮询目录的间隔，单位秒	`20`、`60`

示例：

text

配置名称：115 剧集整理
源目录：/CloudNAS/CloudDrive/115/Downloads
目标目录：/media
启用监控：开启
扫描间隔：20 秒

整理方式

方式	配置值	说明	适合场景
移动文件	`move`	本地文件移动到目标目录	下载目录和媒体库在同一文件系统
复制文件	`copy`	保留源文件，复制到目标目录	需要保留原始下载目录
CD2 移动	`cd2_move`	通过 CloudDrive2 API 移动	源目录是 CloudDrive2 挂载
CD2 复制	`cd2_copy`	通过 CloudDrive2 API 复制	挂载盘内复制，降低直接操作风险

CD2 模式会强制使用兼容监控模式，因为文件系统事件不适合直接判断 CloudDrive2 API 操作结果。

监控模式

模式	配置值	说明
兼容模式	`compatibility`	按扫描间隔轮询源目录，适合 Docker 映射、网盘挂载、网络盘
事件模式	`event`	依赖文件系统事件，适合稳定的本地目录

建议：

CloudDrive2、网盘挂载、SMB/NFS 目录优先用兼容模式。
本地 SSD 下载目录可以尝试事件模式。
如果发现新增文件没有触发，改回兼容模式并适当增大扫描间隔。

覆盖设置

字段	说明
启用覆盖	目标文件已存在时是否允许替换
覆盖模式 `always`	总是覆盖
覆盖模式 `size`	按文件大小判断
覆盖模式 `resolution`	按识别到的分辨率判断

示例：

text

覆盖：开启
覆盖模式：resolution

适合多版本升级，例如先入库 1080p，后续用 2160p 替换。

失败移动

字段	说明
整理失败移动	整理失败后把源文件移动到失败目录
失败目录	存放失败文件的目录

示例：

text

整理失败移动：开启
失败目录：/downloads/_整理失败

开启失败移动后必须填写失败目录。复制模式下可以保留源文件；移动模式下建议先确认失败目录也在 Docker 映射范围内。

分类设置

开关	说明
自动分类	启用后按媒体识别结果决定分类目录
按类别分类	在目标目录下增加 `电影`、`电视剧` 等一级目录
按类型分类	使用二级分类规则生成二级目录
删除空文件夹	移动整理后清理源目录残留空目录

目录示例：

text

目标目录：/media
按类别分类：开启
按类型分类：开启

输出：
/media/电影/华语电影/让子弹飞 (2010)/Let.the.Bullets.Fly.2010.mkv
/media/电视剧/国产剧/庆余年 (2019)/Season 2/Joy.of.Life.S02E01.mkv

如果二级分类名本身包含 电影/ 或 电视剧/，NanShare 会尽量避免重复生成 电影/电影 这类路径。

元数据下载

开关	说明
下载元数据	整理时补充 NFO、海报、背景图等
生成 NFO	输出媒体信息 NFO
下载海报封面	下载 poster、backdrop 等图片
覆盖已有元数据	目标目录已有 NFO/图片时是否覆盖

示例：

text

下载元数据：开启
生成 NFO：开启
下载海报封面：开启
覆盖已有元数据：关闭

建议：

不推荐使用项目的元数据下载，推荐使用 emby 自带的元数据刮削加上神医助手的调教

媒体信息提取

媒体信息提取会用 FFprobe 探测视频流，补充文件名缺失的规格字段。触发字段在基础配置里选择。

可触发字段：

字段	说明	示例
`effect`	特效	`HDR`、`DV`、`HDR10+`
`videoFormat`	分辨率	`2160p`、`1080p`
`videoCodec`	视频编码	`H264`、`H265`、`AV1`
`audioCodec`	音频编码	`AAC`、`EAC3`、`TrueHD`
`fps`	帧率	`23.976`、`25`、`60`
`bitDepth`	位深	`8bit`、`10bit`

例子：

text

原文件名：Movie.2024.WEB-DL.mkv
文件名缺少：分辨率、特效、视频编码
媒体信息提取后：videoFormat=2160p, effect=HDR, videoCodec=H265

媒体信息提取复用

媒体信息提取复用用于减少整季资源的探测次数。开启后，同一整理上下文中规格相同的一组文件可以复用已经探测到的媒体参数。

适合这种目录：

text

/downloads/剧名.S02.2160p.WEB-DL/
├── 剧名.S02E01.mkv
├── 剧名.S02E02.mkv
├── 剧名.S02E03.mkv
└── 剧名.S02E04.mkv

如果 E01 探测出：

text

videoFormat=2160p
effect=DV HDR
videoCodec=H265
audioCodec=EAC3
bitDepth=10bit
fps=23.976

同目录后续集数文件名缺少这些字段时，可以复用同组结果，避免每一集都探测。

不建议复用的目录：

text

/downloads/混合资源/
├── Movie.2020.1080p.mkv
├── Movie.2020.2160p.HDR.mkv
├── Movie.2020.720p.mp4
└── sample.mkv

这种目录里规格明显不一致，开启复用可能让低清、高码率、HDR 等信息混淆。此时建议关闭复用，只开启媒体信息提取。

OpenAI 辅助识别

开关	说明
强制 OpenAI 识别	每个文件都优先让 OpenAI 或兼容 API 辅助识别

适合：

文件名非常混乱。
TMDB/豆瓣常规搜索不稳定。
动漫、综艺、特别篇命名不统一。

不适合：

大批量稳定命名资源，可能增加耗时。
API 额度有限的环境。

OpenAI 配置详见 OpenAI 辅助识别。

排除规则

排除规则避免 sample、预告、压缩包、截图目录进入整理队列。

字段	说明
文件扩展名屏蔽	逗号或换行分隔扩展名
文件关键词屏蔽	文件名包含关键词则跳过
文件正则屏蔽	文件名命中正则则跳过
文件夹关键词屏蔽	目录名包含关键词则跳过
文件夹正则屏蔽	目录名命中正则则跳过

扩展名示例：

text

txt,url,html,zip,rar,7z

文件关键词示例：

text

sample
trailer
预告
花絮

文件正则示例：

text

(?i)sample|trailer
.*预告.*
.*花絮.*

文件夹屏蔽示例：

text

@eaDir
.deleted
sample
trailer

组合规则里可用 re: 前缀表示正则：

text

sample
预告
re:(?i)trailer|sample

Emby 刷新

整理完成后可以刷新 Emby 媒体库。

字段	说明
启用 Emby 刷新	整理完成后触发刷新
Emby 配置	要刷新的 Emby 助手配置
路径替换	本地目标路径与 Emby 媒体库路径不一致时转换
刷新延迟	等文件落盘稳定后再刷新，默认至少 1 秒

路径替换示例：

text

/media => /mnt/media
/strm => /volume1/strm

如果一次整理很多集，建议设置合理延迟，避免 Emby 频繁扫库。

队列与手动运行

整理任务都会进入队列。

操作	说明
立即运行	把单个整理监控的源目录加入队列
预览整理	只看识别结果和目标路径，不移动文件
手动整理	从文件管理选择一个或多个路径加入队列
取消任务	从队列中取消指定任务
清空队列	清理等待中的任务

手动整理适合：

text

只整理某个刚下载的文件
修正配置后重新整理失败文件
从整理历史里重新整理到新目录

重新整理历史

整理历史中可以选择单条或多条记录重新整理。重新整理时可临时指定：

临时选项	说明
目标目录	覆盖当前配置目标目录
整理方式	移动、复制、CD2 移动、CD2 复制
媒体类型	指定电影或电视剧
TMDB ID	强制指定识别结果
下载元数据	临时开启或关闭
媒体信息提取	临时开启
按类别分类	临时开启或关闭
按类型分类	临时开启或关闭
删除空目录	临时开启或关闭

完整示例

115 转存后自动整理剧集

text

配置名称：115 剧集整理
源目录：/CloudNAS/115/Downloads
目标目录：/media
整理方式：cd2_move
监控模式：compatibility
按类别分类：开启
按类型分类：开启
下载元数据：开启
媒体信息提取：开启
媒体信息提取复用：开启
Emby 刷新：开启
路径替换：/media => /mnt/media

只做手动整理电影

text

配置名称：电影手动整理
源目录：/downloads/movie
目标目录：/media/电影
启用监控：关闭
整理方式：move
覆盖：开启
覆盖模式：resolution
下载元数据：开启
删除空文件夹：开启

STRM 目录整理

text

配置名称：分享 STRM 整理
源目录：/strm/incoming
目标目录：/strm/library
整理方式：move
下载元数据：关闭
媒体信息提取：关闭
按类别分类：开启
按类型分类：开启

排错

监控没有触发

检查源目录是否映射进 Docker、监控是否开启、模式是否适合当前文件系统。网盘挂载优先用兼容模式。

目标路径不对

检查重命名模板、按类别分类、按类型分类、二级分类规则。重命名模板和通知模板说明见自定义通知模板。

CD2 移动失败

检查 CloudDrive2 助手、CD2 服务地址、挂载名称、源路径是否在 CD2 管理范围内。

媒体信息提取慢

减少触发字段，关闭复用不适合的混合目录，或者只对命名缺失严重的整理配置开启。

整理监控 ​

功能位置 ​

基础字段 ​

整理方式 ​

监控模式 ​

覆盖设置 ​

失败移动 ​

分类设置 ​

元数据下载 ​

媒体信息提取 ​

媒体信息提取复用 ​

OpenAI 辅助识别 ​

排除规则 ​

Emby 刷新 ​

队列与手动运行 ​

重新整理历史 ​

完整示例 ​

115 转存后自动整理剧集 ​

只做手动整理电影 ​

STRM 目录整理 ​

排错 ​

监控没有触发 ​

目标路径不对 ​

CD2 移动失败 ​

媒体信息提取慢 ​

整理监控

功能位置

基础字段

整理方式

监控模式

覆盖设置

失败移动

分类设置

元数据下载

媒体信息提取

媒体信息提取复用

OpenAI 辅助识别

排除规则

Emby 刷新

队列与手动运行

重新整理历史

完整示例

115 转存后自动整理剧集

只做手动整理电影

STRM 目录整理

排错

监控没有触发

目标路径不对

CD2 移动失败

媒体信息提取慢