功能总览
Mediora 的核心作用，是把“文件放在哪里”“媒体如何整理”“资料如何补全”“如何交给 Emby 或 Jellyfin 播放”串成一条可重复执行的流程。你不需要一次配置全部功能，按自己的使用目标选择即可。
名词和概念关系见常用概念；运行过程和异常处理见任务运行与结果核对。
可以怎样组合功能
存储管理
↓
媒体整理 ──→ 媒体刮削 ──→ 生成 STRM ──→ Emby / Jellyfin 播放
│ │ │
└──────────────┴──────────────┴──→ 工作流自动串联
同步管理：在两个位置之间复制文件
下载助手：把链接下载到已配置的存储
媒体代理：为远端 STRM 提供实际播放入口
影音优化：提前准备远程媒体的播放信息
上图是可组合的功能，不是必须全部走完的步骤。本地影片已能直接播放、只是缺海报和简介时，可以只运行刮削；需要调整文件名和位置时，再加整理。
各模块做什么
| 功能 | 主要作用 | 是否会改真实文件 |
|---|---|---|
| 云盘管理 | 添加本地、OpenList、CloudDrive2 或绿联NAS网络文件夹挂载，浏览、传输文件和调整适用的目录读取策略。 | 会。新建、上传、复制、移动、重命名和删除会作用于实际存储。 |
| 媒体整理 | 把来源目录中的影片和剧集复制、移动或硬链接到目标媒体库，并按规则命名。 | 会。复制、移动、覆盖都会产生真实文件变化。 |
| 媒体刮削 | 从 TMDB 获取片名、海报、简介和资料文件，写回媒体目录。 | 会。主要写入资料文件和图片，不负责移动影片。 |
| 生成 STRM | 为远端媒体生成很小的播放入口文件，让媒体服务器看到远端影片。 | 会。会在输出目录创建或更新 .strm 文件。 |
| 媒体库分析（Pro） | 盘点所选目录、检查音轨和字幕、比较多版本并保存报告；深入读取和 AI 样本发送需要另外确认。 | 分析不会自动清理文件；清理与恢复操作需单独预览和确认。 |
| 同步管理 | 从来源单向复制到目标，支持增量、预演、定时和删除保护。 | 会。启用同步删除时还可能删除目标多余文件。 |
| 下载助手 | 批量添加下载链接，把下载结果保存到指定网盘目录。 | 会。下载器或网盘会创建实际文件。 |
| 工作流 | 按顺序调用已保存的整理、刮削、STRM、缓存和通知步骤。 | 取决于引用的步骤。工作流本身不回滚已完成的文件操作。 |
| 媒体代理 | 让 Emby 或 Jellyfin 通过 Mediora 播放远端 STRM。 | 通常不会；分流规则中的同类型转存可能会向目标存储写入临时文件。 |
| 影音优化 | 提前准备影片的播放信息，并在条件满足时同步给媒体服务器。 | 可能会写入优化结果备份；不会删除原影片。 |
| 控制台 | 汇总任务、计划和媒体代理状态，帮助定位下一步。 | 不会。控制台是查看入口。 |
按目标选择功能
| 你想完成的事情 | 推荐顺序 |
|---|---|
| 把下载好的电影放入媒体库 | 添加存储 → 媒体整理 → 媒体刮削 |
| 让远端网盘中的影片出现在 Emby / Jellyfin | 添加远端存储 → 生成 STRM → 配置媒体代理 → 刷新媒体库 |
| 让新下载的文件自动入库 | 添加存储和下载器 → 建立手动整理/刮削任务 → 工作流添加“下载完成”或“目录监控”条件 |
| 把一个目录备份到另一个目录 | 添加来源和目标存储 → 同步管理 → 先预演，再执行或定时 |
| 一次处理多种媒体操作 | 先分别保存手动整理、刮削或 STRM 任务 → 工作流按顺序引用 |
| 让远程影片少一些首次播放等待 | 先保证 STRM 和媒体代理可播放 → 配置影音优化 → 选择媒体库并预览范围 |
选哪种存储来源： 已有本地影片时，直接接入本地存储；远端影片可按现有环境选择 OpenList、CloudDrive2 或绿联NAS网络文件夹挂载。绿联NAS用户建议使用网络文件夹挂载。115 直连不推荐作为主力，未来可能停止支持；使用时仍需遵守账号验证、限速和冷却提示。通过其他服务接入也仍受网盘规则、连接服务和网络条件影响，不能据此保证不会触发限制。详见云盘管理。
用一个小例子理解整条链路
假设你把一部电影下载到了 NAS 的下载目录，希望它最终出现在 Emby 里：
| 步骤 | 你做什么 | 文件发生了什么 |
|---|---|---|
| 1. 接入存储 | 添加下载目录和媒体库目录对应的本地存储，并各选一个测试子目录 | Mediora 能看到这两处文件；不需要先搬动影片 |
| 2. 整理 | 建手动整理任务，来源和目标分别选择上述测试目录，使用“复制 + 不覆盖已有文件” | 按当前命名和分类规则生成一份结果，原影片保留 |
| 3. 刮削 | 建手动刮削任务，选择整理后的测试目标目录，先用“仅缺失” | 补充 NFO、封面和背景图等资料 |
| 4. 刷新媒体库 | 在 Emby 中点“扫描媒体库” | Emby 读取新文件并显示海报 |
| 5. 自动化 | 把上面两个手动任务放进工作流，先手动验证，再配置“下载完成” | 触发后可自动整理和刮削；媒体服务器扫描仍由它自己的计划或手动操作负责 |
如果影片在远端，可以不复制整部影片：选择真实影片来源，生成 STRM 到单独的输出目录，让媒体服务器扫描这份输出，并通过媒体代理测试播放。远端影片的整理、刮削是否需要执行，按文件名和资料是否已满足需求决定。
三个容易混淆的概念
任务、运行记录和文件不是一回事
保存任务只是保存一套规则，不代表已经处理文件。点击运行后才会产生一次运行记录；删除任务也不会删除已经生成的影片、资料或 STRM 文件。详见任务运行与结果核对。
STRM、媒体代理和影音优化各自解决不同问题
- STRM：把远端影片以小文件的形式放进媒体服务器媒体库。
- 媒体代理：在播放时根据 STRM 和当前存储找到实际内容并提供播放请求。
- 影音优化：提前准备影片的播放信息，并尝试让媒体服务器采用准备好的结果。
影音优化不是媒体代理的替代品。远端 STRM 仍需先能通过媒体代理正常播放；优化助手暂时不可用时，结果可以先保存在 Mediora，待助手恢复后再同步。
“预演”只查看计划，不等于执行
同步预演用于确认将新增、更新、跳过或删除哪些文件，不会改动文件。媒体整理、刮削和 STRM 的任务预览主要用于确认处理范围；真正的文件变化仍发生在点击运行、执行或确认之后。