常用概念
这一页把散落在各功能页里的名词集中说明。遇到看不懂的说法时，先回这里查。
名称速查
| 名称 | 简单理解 |
|---|---|
| 存储实例 | 一份具体的文件访问配置，例如本地目录、OpenList、CD2 服务或网络文件夹挂载；同名不代表同一身份。 |
| 业务根 | 某个存储允许访问的起点，任务选择的文件必须位于该存储允许的范围内。 |
| 宿主机路径 / 容器路径 | Docker 挂载左右两侧的目录。本地存储使用右侧的容器路径；远端存储使用各自目录选择器中的路径。 |
| 来源目录 | 要读取文件的目录。 |
| 目标目录 | 处理后保存文件的目录。 |
| 任务 | 你保存的一套处理规则。保存≠运行。 |
| 本轮运行 | 某次触发后真实执行的一轮，与长期任务和单文件历史分开记录。 |
| 一次性运行 | 手动处理或历史重试等产生的运行，不一定保存长期任务。 |
| 历史记录 | 某一次任务运行后的结果。 |
| 整理 | 按规则复制、移动或归类媒体文件。 |
| 刮削 | 为影片和剧集补充海报、简介和资料文件。 |
| STRM | 指向真实影片的文本播放入口，不含视频本身，本地和远端来源都可使用。 |
| 同步 | 把来源目录中的内容单向复制到目标目录。 |
| 工作流 | 把多个处理步骤按顺序自动执行。 |
| 预演 | 先查看同步会做什么，不会改动文件。 |
| 整理预演方案 | 智能体按已授权规则生成的目标计划，确认有效范围后才可执行。 |
| 就绪即处理 | 文件满足来源、作品与规则核实条件后允许先处理，不保证发现一项就立即写入。 |
| 扫描完成后处理 | 同步任务可选的处理方式，本轮完整读取成功后才开始处理，仍不提供自动回滚；媒体整理、刮削和 STRM 已统一采用就绪即处理。 |
| 目录缓存 | 复用近期读取结果以减少网盘请求；不等于备份，也不能修复断挂。 |
| 等待共享资料 | 单文件仍依赖剧、季或目录共用资料的最终结果。 |
| 结果待核对 | 外部写入可能发生，但证据还不足以证明结果；不等于未执行。 |
| 结束并保留文件 | 结束已核对的记录，保留现有文件，不补传、不删来源、不自动重跑。 |
| 仅缺失 | 保留已有同名结果；上传等具体入口可能停止而非跳过，按确认框解释操作。 |
| 覆盖 | 目标已有同名文件时，用新结果替换旧内容。 |
| 同步删除 | 在目标删除来源没有的内容，执行前应预演并核对删除保护。 |
| 完整数据目录备份 | 停机保存数据库、身份、密钥和配套材料，不能用单个 .db 完全替代。 |
| Agent 凭证 | 智能体的独立授权凭据，具有权限和有效期，不是常规 API 令牌。 |
两个代理、媒体服务器和影音优化
下面四项分别解决网络访问、媒体连接和播放问题。先看用途，再填写地址：
| 名称 | 入口 | 作用 | 什么时候配置 |
|---|---|---|---|
| 外网代理服务器 | 系统 → 系统设置 → 常规设置 | 让 Mediora 出站访问 TMDB、AI 等外部服务。 | 服务器访问外网受限时；网络正常可留空。 |
| 媒体代理 | 播放服务 → 媒体代理 | 给 Emby / Jellyfin 客户端提供播放入口，支持 Mediora 生成的 STRM。 | 准备用 STRM 播放时。 |
| 媒体服务器 | 系统 → 系统设置 → 服务设置 | Mediora 连接真实 Emby / Jellyfin 的地址与 API 密钥。 | 添加 Emby / Jellyfin 时。 |
| 影音优化 | 播放服务 → 影音优化 | 提前准备播放信息并同步给媒体服务器。 | STRM 播放链路已经可用之后。 |
记忆方法：
- 外网代理管出去，媒体代理管进来。
- 媒体服务器的“服务地址”填 真实 Emby / Jellyfin，不能填媒体代理端口，否则会自己转发给自己。
- 影音优化不是媒体代理的替代品，远端 STRM 仍需先能通过媒体代理播放。
覆盖和同步删除的区别
| 说法 | 出现在哪 | 含义 |
|---|---|---|
| 不覆盖已有文件 / 始终覆盖 | 媒体整理的覆盖规则 | 决定目标有同名影片时保留旧文件，还是按规则替换；也可按分辨率或大小比较。 |
| 仅缺失 / 全部覆盖 | 媒体刮削 | 只补缺少的资料，或重新写入所选资料；作品确认和写入权限仍需满足。 |
| 存在则跳过（默认）/ 差异时覆盖 | 生成 STRM | 已有文件可跳过；覆盖模式只在正文有差异时重写，并可选择备份旧文件，不会复制视频正文。 |
| 同步删除 | 同步管理 | 在目标删除来源里已经不存在的文件。高风险。 |
这些选项作用于不同文件，不能只看到“覆盖”两个字就沿用其他页面的理解。第一次使用整理选“不覆盖已有文件”，刮削选“仅缺失”，STRM 选“存在则跳过（默认）”，分别检查结果。
状态不是结果
下面这些词看着像“做完了”，其实只是过程状态：
| 看到 | 真实含义 |
|---|---|
| 已接收 / 排队中 | 请求已登记或受理，不代表已经完成；是否已写入，以原操作记录和实际文件为准。 |
| 已优化 | Mediora 准备好了结果，但媒体服务器还没采用。 |
| 服务器已采用 | 媒体服务器已采用准备结果，仍需用实际客户端试播，不能据此保证所有格式都正常。 |
| 已连接 / 测试通过 | 验证了本次连接，不代表每个目录都有读写权限，或所有客户端都能播放。 |
| 预演通过 | 显示当时扫描得到的计划，预演本身不写文件；外部文件仍可能变化，执行前要核对来源和目标。 |
逐文件结果和控制方式见任务运行与结果核对。
不同来源依赖什么
不同接入方式改变了文件请求经过的服务，也会增加不同的前置条件。不能只凭接入名称判断一定更快、更稳定或没有风控：
| 接入方式 | 账号授权在哪里 | 需要检查 | 适合 |
|---|---|---|---|
| 本地存储 | 设备目录权限 | 磁盘、挂载和应用运行身份 | 本机已有媒体 |
| CloudDrive2 / OpenList | 对应服务 | 服务连接、令牌、允许目录和网盘状态 | 聚合已接入的来源 |
| 绿联NAS网络文件夹挂载 | NAS 客户端 | 真实挂载、传播、权限和网盘状态 | 绿联NAS用户接入媒体 |
| 115 直连 | Mediora 内扫码 | 账号验证、限频和接口变化，后续不保证长期支持 | 不推荐主力使用，仅作临时补充 |
115 请求有频率和额度保护，但任务变慢也可能来自网络、扫描或账号异常，应先看等待原因，不能一概当作正常限速。详见云盘管理。
三组“容易当成一件事”的东西
- 任务、运行记录和文件不是一回事：保存任务只是保存规则；点击运行才产生运行记录；删除任务不会删除已生成的文件。
- STRM、媒体代理和影音优化各解决不同问题：STRM 让媒体服务器“看到”，媒体代理让播放器“播得动”，影音优化用于提前准备播放信息。
- 备份
data目录不等于备份媒体：媒体文件仍需单独备份；完整安装包、旧数据库快照和影音优化结果备份的范围不同，见备份与恢复。