媒体整理
路径：媒体管理 → 媒体整理。
媒体整理把来源目录里的影片或剧集，按你的命名和分类规则放到目标目录。它适合处理下载完成的文件，也适合把已有媒体库慢慢整理成统一的目录结构。
先把少量文件用“手动整理”试一遍。确认目录、文件名和分类都符合习惯后，再保存长期任务或开启自动运行。
媒体整理只负责“识别文件并放到目标位置”。它不会自动补海报和简介；如果要让 Emby 或 Jellyfin 显示完整资料，还要再运行媒体刮削。
新建整理任务
点击“新建任务”后，按下面填写。来源是文件现在所在的位置；目标是整理后要放到的位置。两处都需要选择存储和其中的目录。
| 字段 | 怎么填写 | 保存或运行后的影响 |
|---|---|---|
| 任务名称 | 用容易看懂的名称，例如“下载电影入库”。 | 只用于在任务列表和历史中辨认，不会改文件名。 |
| 来源存储、来源文件/目录 | 选择已连接的存储，再选择其中的文件或目录。 | 决定读取范围；选定某个文件只处理这个文件，不会连同整个父目录一起处理。115 直连可能遇到限速、冷却或账号验证，按页面提示处理。 |
| 目标存储、目标目录 | 选择整理结果的保存位置。 | 决定新文件出现在哪里；不要与来源选成同一个位置。 |
| 媒体类型 | 选电影、剧集，或“自动识别”。 | 明确类型时识别更稳定；选择自动识别时由文件名判断。 |
| 二级分类 | 选择“不分类”“自动匹配”，或指定一个已有分类。 | 不分类时直接放进媒体类型目录；自动匹配时按分类策略生成分类目录；指定分类时固定放进该目录。 |
| 整理方式 | 首次建议选“复制”。 | 见下表。 |
| 覆盖规则 | 首次建议选“不覆盖已有文件”。 | 决定目标已有同名结果时是否保留原内容。 |
| 按规则重命名 | 首次建议选“是”，确认规则后再扩大范围。 | 开启后按规则生成文件名；关闭后保留来源文件名。媒体类型、二级分类和目录层级仍按任务配置处理。 |
整理方式和覆盖规则
“不分类”适合只按电影、剧集分目录；“自动匹配”会使用“自动化设置 → 二级分类策略”的规则；指定分类适合来源始终属于同一类的任务。被任务引用的分类不能删除或改名，先修改引用它的任务再调整分类。
| 选项 | 会发生什么 | 适合什么时候使用 |
|---|---|---|
| 复制 | 原文件保留，在目标目录新建一份。 | 第一次试用、需要保留下载目录时。 |
| 移动 | 文件从来源目录移到目标目录。 | 已确认整理规则，且不再需要来源文件时。 |
| 硬链接 | 两个目录项指向同一份内容，不额外复制文件数据；修改其中一处内容会影响另一处。 | 仅同一本地存储实例、同一文件系统且目录支持时使用，不支持跨存储。 |
| 不覆盖已有文件 | 目标已有同名文件时跳过。 | 默认推荐，可避免重跑时覆盖已有内容。 |
| 始终覆盖 | 用本次结果替换目标中的同名文件。 | 已确认来源文件和规则正确，并确实需要更新时。 |
| 按大小（新文件更大） | 只有新文件更大时才替换，否则跳过。 | 想用更完整的版本换掉残缺或压过头的文件时。 |
| 按分辨率（新文件分辨率更高） | 只有新文件分辨率档位更高时才替换，否则跳过。 | 想把 720p 升级成 1080p / 2160p 时。同档位（例如都是 2160p）不会互相覆盖。 |
按分辨率依赖可确认的画质信息，例如文件名标记和 Mediora 记录的目标画质。同档位不会互相覆盖；无法确认来源或目标分辨率时保守跳过，历史详情会说明原因。文件更大不等于分辨率更高，“按大小”也不判断音轨、字幕或剪辑版本是否更合适。
覆盖仍会替换真实文件。当前传输流程在可安全暂存旧目标时先保留旧文件，核实新结果后再清理；无法安全暂存或核实归属时会停止并保留保护。不能把这层保护当作独立备份，也不能认定报错就没有写入。
“按大小”“按分辨率”判定应替换后同样涉及覆盖。遇到旧文件备份位置或结果不明提示时，先保留文件和记录，再按核对流程处理。
移动后的来源目录
文件实际移动成功后，会从文件的父目录向上检查并尝试删除空目录，最多到本次选定的来源目录，不会删除存储根目录。选定的来源目录本身也可能被删除，如果它已变空且在允许范围内。
有字幕、NFO、隐藏文件或其他内容时不会当作空目录；无法确认、读取出错或运行被取消时会保留。复制、硬链接、跳过及失败不会触发这项清理。目录清理失败不会撤回已经完成的文件移动。
什么时候运行
“保存任务”只保存规则，不会立刻整理文件。通过“调度方式”决定之后如何启动：
| 调度方式 | 怎么用 | 影响 |
|---|---|---|
| 手动执行 | 保存后，在任务列表点击运行。 | 最适合首次使用，结果可控。 |
| 定时执行 | 填写执行时间；例如 0 2 * * * 表示每天 02:00。页面会检查格式并显示下次执行时间。 | 到点自动扫描来源目录并处理。 |
| 下载器监控 | 仅来源为本地存储时可选。 | 下载目录有新文件时自动启动该任务。 |
| 目录监控 | 来源为本地存储或 CloudDrive2 时可选。 | 本地使用文件监听；CloudDrive2 观察目录变化，核实当前文件后再处理。 |
手动、定时任务会一边发现文件，一边整理已经确认可以处理的文件，这叫“就绪即处理”。需要比较同一作品的多个版本时，仍可能先等待扫描完成。后续扫描失败不会撤回已经整理好的文件，原任务和历史重试也沿用这项处理方式。
页面还会显示来源存储的目录读取设置。手动运行会重新读取目录；定时运行可能在短时间内复用上一次完整读取结果，以减少网盘请求。
目录读取策略只适用于使用网盘 API 的来源。监控任务先核对本轮范围，处理策略不会放宽范围。
三种常见配置组合
| 使用场景 | 整理方式 | 覆盖规则 | 按规则重命名 | 说明 |
|---|---|---|---|---|
| 第一次试用 | 复制 | 不覆盖已有文件 | 是 | 保留来源文件，最容易回退和对照。 |
| 已确认规则的日常入库 | 移动 | 不覆盖已有文件 | 是 | 整理完成后来源目录会减少文件，适合确认过的下载目录。 |
| 只统一目录、不改文件名 | 复制或移动 | 不覆盖已有文件 | 否 | 保留来源文件名，但仍按媒体类型和分类放入目标目录。 |
如果来源和目标属于不同存储实例，页面不会提供硬链接；硬链接只适用于同一个本地存储实例。跨网盘整理不要把硬链接当成节省空间的方案。
蓝光原盘不会拆开整理
遇到蓝光原盘及 BDMV/STREAM 内部片段，当前整理器会跳过并保留原目录和内部文件，不会把 00001.m2ts 等当作独立影片搬走。即使只选中内部片段，也不会自动扩大范围到原盘父目录。需要原盘播放入口时，另看 STRM 的 BDMV 选项。
手动整理一部或一批媒体
点击“手动整理”可以不保存长期任务，直接处理少量文件或目录。基础字段与上面的任务相同，另外还有这些可选项：
| 字段 | 什么时候填 | 影响 |
|---|---|---|
| TMDB ID | 已明确知道目标影片或剧集的 TMDB 编号时填写。 | 直接指定媒体信息，减少同名作品识别错误；填写后媒体类型不能选“自动识别”。 |
| 季、集 | 处理剧集且文件名无法正确识别季集时填写。 | 用于确定季和集的归属。 |
| 偏移 | 剧集编号需要整体前移或后移时填写。 | 只改变本次手动整理的集数判断。 |
| 分片 | 一集被拆成多个部分时填写。 | 用于在文件名中保留分片信息。 |
历史失败行提供“重试”：按当时的设置再执行一次。行内“重新整理”和批量“重新整理”会打开表单，可调整设置后再执行；来源和目标沿用历史快照，即使原任务已修改或删除也是如此。已取消的行可以重新整理，不能直接快速重试。
调整命名和分类
打开“系统 → 自动化设置”：
- 在“重命名规则”中决定电影、剧集的目录名和文件名；改动只对之后开启“按规则重命名”的整理生效，不会批量改掉已经整理好的文件。
- 在“二级分类策略”中决定分类名称和匹配顺序；改动后，新整理的文件会进入新的分类目录，旧文件不会自动移动。
看结果和处理异常
任务列表用于管理长期规则；历史记录用于查看每一次实际运行。可按关键字和状态筛选，打开记录可查看处理过的文件和失败原因。
任务列表上方的“最近的一次性运行”显示手动操作与历史重试的本轮进度。扫描尚未结束时，文件总数还会增加；进行中的一轮可以暂停、恢复或取消。历史行会标出定时、监控、手动、工作流或重试等来源。工作流发起的一轮应在工作流执行页控制。
- 结果不符合预期时，先暂停定时或监控任务，再改规则和重新试一小批文件。
- 取消运行只会停止尚未完成的工作，已经复制、移动或覆盖的文件不会自动撤回。
- 删除任务只删除这套规则和任务入口，不会删除已经整理出来的媒体文件。
- 看到“跳过”不一定是失败，通常表示目标已有文件、文件命中排除条件或本次没有需要处理的内容；先打开历史详情确认具体原因。
历史出现待确认作品时，可查看候选、证据及分页文件范围，再确认并重跑整组；本轮进度、文件传输字节、取消和历史删除的区别见任务运行与结果核对。
容易搞错的地方
| 容易搞错 | 实际情况 |
|---|---|
| 保存任务后以为文件就开始整理了 | 保存只是记住规则，要点击运行，或把调度设为定时、监控。 |
| 目标目录选好后，结果又多了一层电影、剧集或分类目录 | 目标是输出目录的起点，媒体类型、分类和作品子目录还会按规则追加。先用一部作品核对最终层级，不要固定照抄 /medias。 |
| 以为“硬链接”能省下一半空间但跨盘也能用 | 硬链接必须是同一本地存储实例、同一文件系统；跨存储、网盘都不提供。 |
| 以为“按大小”会挑画质更好的版本 | 它只比文件字节数。分辨率更高不等于文件更大，“按分辨率”才看画质档位。 |
| “按分辨率”同档位也覆盖 | 同档位不会互相覆盖，无法确认分辨率时也会保守跳过。 |
| 以为“移动”之后来源目录一定还在 | 移动成功后会在选定来源范围内尝试清理空目录，选定的来源目录本身也可能被删。 |
| 以为选了“不覆盖已有文件”就绝对不动文件 | 它不覆盖已有同名结果，但新文件仍会写进去；覆盖类模式才会替换旧内容。 |
| 把蓝光原盘目录当普通影片整理 | 原盘和 BDMV/STREAM 内部片段会被跳过并原样保留，不会被拆开搬走。 |
| 以为失败报错就没写入 | 部分文件可能已经复制或移动，先看历史详情和实际文件。 |
| 只核对当前页，就点击确认整组作品 | 确认后会重跑整组，包括其他分页中的文件；要先核对全部适用范围。 |
最佳实践
第一次试用： 以下目录是所选存储里的路径，请用目录选择器选取。
| 字段 | 取值 |
|---|---|
| 整理方式 | 复制 |
| 覆盖规则 | 不覆盖已有文件 |
| 按规则重命名 | 是 |
| 二级分类 | 不分类 |
| 调度方式 | 手动执行 |
| 来源 | 只放 1–3 个文件的测试目录 |
| 目标 | 与来源互不重叠的测试目录，例如 /整理试用 |
跑完后，在文件列表核对目录结构和文件名，并实际打开影片。再运行一次，确认已有同名结果按预期跳过。满意后再改为正式目标；修改目标只影响以后执行，不会自动搬走测试结果。
命名规则或目标路径改过后，可能生成另一份结果。“不覆盖已有文件”只保护同名目标，不会替你判断整个媒体库中是否已有同一部影片。
确认规则后的日常入库：
| 字段 | 取值 |
|---|---|
| 整理方式 | 移动 |
| 覆盖规则 | 不覆盖已有文件 |
| 按规则重命名 | 是 |
| 二级分类 | 自动匹配 |
| 调度方式 | 手动执行并交给工作流触发；或使用独立的定时任务 |
来源目录由下载器反复使用时，还要核对移动后的空目录清理是否符合预期。不希望来源目录被清理时，可继续采用复制入库，并单独安排来源清理。
需要升级画质的场景： 覆盖规则用“按分辨率”，“按大小”只在明确想用更大的文件替换残缺文件时使用。
小技巧： 想先看命名效果，不必跑任务——在“系统 → 自动化设置 → 重命名规则”里，输入框下方的实时预览就能看到目录名和文件名。