工作流
路径：媒体管理 → 工作流。
工作流把多个已配置的操作按顺序串起来。例如“下载完成 → 整理 → 刮削 → 生成 STRM → 通知”。它不会替代各功能页面的任务设置：整理、刮削和 STRM 步骤都要先在各自页面保存一个手动执行的任务，再在工作流中引用它。
新建工作流
点击“新建工作流”，先填写运行设置：
| 字段 | 怎么填写 | 影响 |
|---|---|---|
| 工作流名称 | 例如“电影下载自动入库”。 | 只用于区分工作流和执行记录。 |
| 启用 | 完成设置前可先关闭，测试运行前再启用。 | 禁用时也不能“立即执行”；已经处理过的文件不会还原。 |
| 触发条件 | 启用前至少添加一个条件。 | 满足任意一个条件就会启动一次工作流。 |
| 执行步骤 | 按实际处理顺序添加。 | 上一步结束后，按它的结果和失败策略决定是否继续。 |
触发条件怎么选
| 触发条件 | 需要填写的字段 | 什么时候用 |
|---|---|---|
| 手动执行 | 无。 | 在工作流列表点击“立即执行”时启动；首次测试推荐使用。 |
| 定时执行 | Cron 表达式，例如 0 2 * * * 表示每天 02:00。 | 固定时间执行。已有一次运行尚未结束时，会跳过下一次计划。 |
| 下载完成 | 选择下载助手中已保存的下载目录；可选择是否包含子目录。 | 该目录的一批下载完成并确认刷新后启动。 |
| 目录监控 | 选择本地存储或 CloudDrive2，以及要监控的目录；可选择是否包含子目录。 | 发现并核实新增媒体后启动。CloudDrive2 首次启用时先记录现有文件，之后再观察变化。 |
| 私聊指令 | 填写专属指令名称，并选择已绑定的企业微信或 Telegram 入口和允许的发送者。 | 从指定私聊入口发送指令时启动；指令名称在整个 Mediora 中不能重复。 |
“包含子目录”开启后，子文件夹里的新文件也能触发；关闭后只关注当前目录。私聊指令前需要先在下载助手的“使用设置”中绑定通知入口。
条件之间是“满足任意一个就运行”，并非全部满足才运行。例如同时添加“每天 02:00”和“下载完成”，下载完成后就可能执行，不会一直等到 02:00。第一次测试只保留“手动执行”，确认后再加入需要的自动条件。
步骤怎么添加
| 步骤 | 需要设置什么 | 会发生什么 |
|---|---|---|
| 媒体整理 | 选择一个已保存的手动整理任务。 | 按该任务的来源、目标、命名和覆盖设置整理文件。 |
| 媒体刮削 | 选择一个已保存的手动刮削任务。 | 为对应媒体补资料和海报。 |
| STRM 生成 | 选择一个已保存的手动 STRM 任务。 | 生成远端媒体的播放入口。 |
| 刷新网盘缓存 | 选择前步骤源目录、目标目录、全部目录，或“手动填写目录”。 | 重新读取前面文件步骤改动过的目录，或手动指定的存储目录。 |
| 延时等待 | 选择固定时长、随机区间或指定时刻。 | 在两步之间等待，例如等媒体服务器或网盘完成更新。 |
| 通知 | 选择是否附加执行摘要。 | 执行到这一步时发送通知；放在最后可用于查看前面各步的结果。需要先有可用的通知配置。 |
每个步骤都有“失败时”的选择：
- 停止整个工作流：适合前后依赖很强的操作，例如整理失败时不要继续刮削。
- 记录失败并继续：适合通知、刷新等不影响后续主要操作的步骤。
按需要组合“整理 → 刮削 → STRM → 刷新目录 → 通知”，不必每次添加全部步骤。本地影片已经能被媒体服务器直接读取时，通常只需整理、刮削；需要以 STRM 接入播放时，再添加生成步骤。步骤可以上移、下移、复制或删除；改顺序会影响下一次运行，不会改变已经完成的历史记录。
刷新目录缓存
选择“前步骤源目录”“前步骤目标目录”或“前步骤全部目录”时，系统使用最近实际执行的文件任务所变更的目录；中间的等待和通知不会改变来源，没有目录变更时会跳过。前面必须有实际运行的整理、刮削或 STRM 步骤。
选择“手动填写目录”时，再选择存储和需要刷新的目录，无须依赖前序文件任务。相关存储关闭目录缓存时会跳过；本地等直接读取文件系统的存储也无需刷新缓存。
文件范围怎样传给下一步
下载完成或文件监控触发时，工作流会保留这次已确认的文件范围。后续媒体步骤仍需符合所引用任务的目录与权限，不会因为一个文件成功就授权处理旁边的整个目录。
因此要同时核对两件事：触发目录是否对应真实下载位置，整理后的目标目录是否位于下一步刮削或 STRM 任务允许的范围。先分别手动验证每一步，再用一小批文件测试完整工作流。
文件清单、来源身份或步骤资料丢失、发生变化时，会明确失败，不回退成扫描整个目录。不要用改名存储或扩大任务目录来绕过提示，应检查原执行记录，按实际文件状态重新发起。
手动执行、定时执行和私聊指令会按引用任务配置的目录范围运行。 它们没有某次下载的文件清单，不能拿生产目录里的长期任务直接做“小批量试用”。请先将引用任务的来源和目标都限制在测试目录中。
文件事件不会把 BDMV / VIDEO_TS 内部片段当成独立作品触发。
测试和查看结果
第一次创建时，先添加“手动执行”条件，启用并保存后点击“立即执行”。打开执行记录可以看到当前进行到哪一步、每一步的结果和失败提示。
- 暂停会在安全位置暂停当前执行；之后可继续。
- 取消会停止后续步骤，已经完成的文件操作不会自动撤回。
- 从头重跑会重新开始整套步骤，应先确认整理和覆盖规则不会造成不希望的改动。下载或目录监控产生的执行，按页面提示到触发记录处理本次文件，不会自动改成扫描整个目录。
子任务显示“已接收”或部分文件成功时，工作流仍会等待该步骤本轮的最终结果。扫描失败、共享资料失败或待核实写入可能影响步骤是否成功，不能只看通知已送达就认定全部文件处理完成。
“刷新目录缓存”用于重新读取对应存储目录，不等于刷新 Emby / Jellyfin 媒体库，也不能让尚未完成 NAS 后台上传的文件立即可用。
| 常见情况 | 先检查什么 |
|---|---|
| 下载完成却没触发 | 下载目录是否已保存、工作流是否启用、下载批次是否已完成文件核对。 |
| 某一步没有处理文件 | 原清单、所引用任务及该步骤的允许目录是否对应。 |
| 暂停后仍有文件写入 | 在途写入需先安全结束，查看本轮和文件记录。 |
| 取消后下次仍触发 | 取消只影响当前执行；需要停用工作流才能停止后续自动触发。 |
| 通知失败 | 查看通知渠道和投递记录，按具体事件重试；不要为了补通知重跑所有文件步骤。 |
停用或删除工作流只影响以后是否再启动，不会删除媒体文件、资料文件或已生成的 STRM。
容易搞错的地方
| 容易搞错 | 实际情况 |
|---|---|
| 直接在工作流里引用一个“定时执行”的整理任务 | 工作流步骤要引用手动执行的任务；自动任务由它自己的调度管。 |
| 以为工作流会自己扫描整个目录 | 下载完成或目录监控触发时，工作流只带这次确认过的文件范围，不会顺便授权旁边的整个目录。 |
| 整理后的目标目录不在刮削任务范围内 | 刮削步骤会因为范围不符而处理不到文件。两步的目录要事先对上。 |
| 以为“刷新目录缓存”会刷新 Emby 媒体库 | 它只重新读取 Mediora 里的存储目录，和媒体服务器扫描是两件事。 |
| 不看前后依赖，给每个步骤套同一失败策略 | 整理失败后通常应停止；通知失败可以记录后继续。刷新缓存是否关键，要看后一步是否依赖它。 |
| 取消后以为不会再自动触发 | 取消只影响当前这一次；要停后续触发得停用工作流。 |
| 通知没收到就重跑整个工作流 | 重跑会再执行整理和刮削一遍。通知失败只重试通知。 |
| 编辑好的工作流没启用就等它跑 | 启用开关关闭时不会接受新的执行，“立即执行”也不可用。 |
最佳实践
本地电影入库的首次验证： 先准备两个互不重叠的测试目录，来源只放 1–3 个文件。下表引用的整理和刮削任务都应选择“手动执行”。
| 顺序 | 步骤 | 失败时 |
|---|---|---|
| 1 | 媒体整理（复制 + 不覆盖已有文件 + 按规则重命名） | 停止整个工作流 |
| 2 | 媒体刮削（仅缺失） | 停止整个工作流 |
| 3 | 刷新网盘缓存（按需添加；纯本地来源无需此步） | 按后续步骤是否依赖刷新结果决定 |
| 4 | 通知（附加执行摘要） | 记录失败并继续 |
需要远端播放时，在刮削后插入 STRM 生成，再刷新目录、通知。
上线节奏：
- 先单独手动跑通整理和刮削；
- 建工作流，只加“手动执行”条件，启用并保存，点“立即执行”验证一次；
- 确认无误后再加上“下载完成”或“目录监控”条件，并另用一次测试下载或新增文件验证自动触发；
- 前几次运行都打开执行记录看一眼，确认每一步的处理文件数合理。
跑之前的自检清单： 触发目录是否对应真实文件位置？整理目标是否在刮削任务范围内？整理是否选“不覆盖已有文件”、刮削是否选“仅缺失”？确认后再扩大范围。工作流的刷新缓存步骤不会替你扫描 Emby / Jellyfin 媒体库。