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