下载助手
路径：存储管理 → 下载助手。
下载助手把支持的链接交给网盘离线下载或本地下载器，并集中查看每批下载的进度和结果。先在“使用设置”保存下载目录，之后才能添加链接。
下载助手只负责下载。要让本次下载的文件继续整理、刮削或生成 STRM，需要为这个目录配置工作流。当前本地下载器、115 和 CloudDrive2 目录支持按本次下载结果继续处理，但仍需要有已启用的工作流监听该目录。115 的分享转存不自动触发；CloudDrive2 分享转存需按页面提示确认完成结果。其他来源以任务详情的实际提示为准。
使用 CloudDrive2 时，目录卡片的“下载后处理”提示当前可能仍显示“此存储暂不支持自动处理”。请用一次小下载，结合下载详情和工作流执行记录核对真实处理结果，不要仅凭该提示反复提交下载。
115 可能遇到账号验证、限频或接口兼容变化，未来可能停止支持。优先使用本地下载器，下载完再整理入库；115 离线下载适合临时补片，不适合做日常主链路。判断依据见云盘管理。
使用设置：定义下载保存到哪里
在“使用设置 → 可选下载目录”点击“添加目录”。一条目录规则包含：
| 字段 | 怎么填写 | 影响 |
|---|---|---|
| 默认 | 选中其中一个目录。 | 没有写目录别名的链接会保存到这里；删除默认项后必须重新选择。 |
| 目录别名 | 填写简短、不重复的名称，例如“电影”“国产剧”。 | 添加链接时用 #别名 指定保存位置。 |
| 下载方式 | 选择“网盘离线下载”或“本地下载器”。 | 决定由谁执行下载。 |
| 网盘或本地存储 | 选择已添加并可用的存储。 | 网盘下载使用其账号；本地下载使用该存储的挂载目录。 |
| 下载器 | 本地下载时选择 qBittorrent 或 Transmission。 | Mediora 会按目标目录把磁力提交给它。 |
| 保存目录 | 从目录树选择真实目录。 | 决定该别名最终对应的保存位置。 |
保存空目录列表后，“添加下载”会被禁用。修改默认目录只影响之后未写别名的新链接，不会移动已创建任务中的文件。
建议至少配置一个默认目录，再按需添加别名。别名是下载链接所在行末尾的路由标记，不是文件夹名称。删除存储或下载器后，引用它的目录会显示“不可用”，需要在设置里重选或删除；它也不会继续充当默认目录。
本地下载目录只接受带 btih 的磁力链接，不接受 HTTP(S) 种子地址。Mediora 和下载器必须看到同一套容器内路径；设置保存时会比较下载器默认目录与本地存储挂载路径，不相交时提示警告，具体文件仍以完成后的清单核对为准。
使用 qBittorrent 或 Transmission 时，选择本地存储目录。通过 CloudDrive2 离线下载时，需使用实际支持该功能的目录和令牌权限；115 离线下载作为临时补充时，选择对应 API 存储，并留意验证、额度和冷却提示。绿联NAS网络文件夹挂载不提供网盘离线下载。
添加下载链接
-
打开“下载任务”，点击“添加下载”。
-
一行粘贴一条链接，一次最多 50 条。
-
需要指定目录时，在该行链接后加空格和
#目录别名。下面仅示意格式，省略号和示例域名需换成实际可用链接：magnet:?xt=urn:btih:... #国产剧https://example.com/movie.mkv #电影 -
查看“解析结果”：每条会显示保存目录，以及“可受理”“已存在”或未受理原因。
-
至少有一条可受理且没有格式错误时，点击“添加下载”。被拒的行不会阻止其他行提交。
链接格式错误、目录别名不存在或输入超限仍会阻止整批提交。目录失效、链接类型不支持，或本地下载器中已有冲突种子时，只拒绝对应的一条。
上面的 HTTPS 示例只适用于支持此链接类型的网盘目录。下载到本地下载器时，使用带 btih 的磁力链接；同一批中每条链接都按它自己的目标目录判断，不会自动切换到另一种下载方式。
| 页面提示 | 表示什么 |
|---|---|
| 默认 | 该链接没有写别名，将保存到默认目录。 |
| 已存在 | 同一链接已经在同一保存目录下载过或正在下载；可打开原任务查看进度。 |
| 仍要重新下载 | 已完成的重复项可勾选；进行中任务不能再建一份。 |
| 未受理 | 该行目录、类型或下载器种子有冲突；其他可受理的行仍可提交。 |
查看和处理任务
在“下载任务”页可按状态筛选，打开某批任务可查看执行端、保存目录、进度、后续处理和失败提示。链接在列表与推送中会打码。
- 取消按执行端处理。本地下载器中的任务会被移除，已有文件会保留；CloudDrive2 的停止操作可能只结束 Mediora 对本次远端任务的跟踪，远端任务和文件仍保留；其他网盘按页面回执确认。
- 重新刷新用于重新获取任务状态，不会重复提交链接。
- 没有工作流监听时，详情显示“已下载，未自动处理”；可以点击“为这个目录创建工作流”预填下载目录条件。
- 取消下载不等于删除已产生的文件；先到对应网盘目录确认实际结果，再决定是否清理。
下载完成与后续处理分开看
“已下载”不等于已经完成整理或刮削。详情还会显示完成后的文件核对、刷新和工作流处理状态；来源目录或下载器连接变更后，旧批次可能无法沿原范围继续处理。
需要“重新处理”或通知重试时，先打开原批次查看具体失败阶段，确认是继续处理现有文件还是重新下载。没有确认前不要反复勾选“仍要重新下载”；该选项会明确创建新的下载意图。
从企业微信或 Telegram 私聊添加
这项功能是可选的。先在“系统 → 系统设置 → 通知管理”添加并启用企业微信或 Telegram，然后回到“使用设置 → 交互入口”：
- 点击“添加入口”，选择一个已启用的通知配置。
- 保存“使用设置”。
- 页面会显示该入口的回调地址；按通知渠道页面提示完成渠道侧设置。
完成后，可通过已绑定的私聊入口发送下载链接。更换或删除交互入口前，先确认不会影响正在使用的回调地址。
私聊消息里加 !重下，会对该消息中的已完成重复项明确要求重新下载；每行回执会分别说明受理、已存在或未受理。重新下载本地种子时，Mediora 会让下载器重新校验并继续，不会删除旧种子和已有文件。
容易搞错的地方
| 容易搞错 | 实际情况 |
|---|---|
把 #别名 写成文件夹名 | 别名只是路由标记。真正的保存目录由“使用设置”里那条目录规则决定。 |
| 本地下载器也贴 HTTP 种子地址 | 本地下载器只接受带 btih 的磁力链接；HTTP(S) 链接只有支持的网盘目录才能受理。 |
| 以为下载完成就会自动入库 | 下载助手只负责下载。整理、刮削要另外用工作流绑定这个目录。 |
| 下载器和 Mediora 挂载路径不一致也能读到文件 | 两边必须把同一宿主目录挂到同一个容器内路径，否则 Mediora 找不到文件。 |
| 取消下载后文件一定没了 | 本地下载器通常移除任务并保留文件；CloudDrive2 可能仅停止本次跟踪。应到对应执行端和目录检查实际结果。 |
| 重复提交同一链接 | 已存在或进行中的链接只拒绝对应一行，去原任务看进度即可，不要反复新建。 |
| 用 PushPlus 私聊发链接 | PushPlus 只发通知，不接收指令；私聊入口只能用企业微信或 Telegram。 |
| 把 115 离线下载做成默认目录 | 不推荐用 115 直连承担日常主链路，未来可能停止支持。可把本地下载器设为默认，115 仅按需用别名指定。 |
最佳实践
目录规则建议：
| 默认 | 别名 | 下载方式 | 本地存储的业务根 | 在存储内选择的目录 | 下载器最终保存路径 |
|---|---|---|---|---|---|
| ✓ | movie | 本地下载器 | /downloads | /movie | /downloads/movie |
tv | 本地下载器 | /downloads | /tv | /downloads/tv |
链接写法：
<你的完整磁力链接> #movie
把 <你的完整磁力链接> 换成实际链接，保留链接和 #movie 之间的空格；不写别名时使用默认目录。别把已经包含业务根的 /downloads/movie 再拼到业务根后，避免实际变成 /downloads/downloads/movie。
只有确实需要临时补片时，才额外加一条 115 离线下载的别名。不要把它设为默认，否则未写别名的链接会默认提交给 115，而不是本地下载器：
| 别名 | 下载方式 | 存储 | 保存目录 |
|---|---|---|---|
115tmp | 网盘离线下载 | 115 存储 | /我的资源/离线下载 |
https://example.com/movie.mkv #115tmp
本地下载器的共同挂载（两个容器看到同一路径）： 下面只说明目录对应关系，分别加到各自已有配置中，保留原有镜像、数据目录和端口。
services:
mediora:
volumes:
- '/mnt/volume1/docker/mediora/downloads:/downloads'
qbittorrent:
volumes:
- '/mnt/volume1/docker/mediora/downloads:/downloads'
接上自动处理： 下载任务详情显示“已下载，未自动处理”时，直接点“为这个目录创建工作流”，检查预填的下载目录条件，再核对整理、刮削步骤和来源目标。保存并启用工作流后，用一条新下载验证；已有的下载不会因为新建工作流就自动重新处理。