工作流

路径：媒体管理 → 工作流。

工作流把多个已配置的操作按顺序串起来。例如“下载完成 → 整理 → 刮削 → 生成 STRM → 通知”。它不会替代各功能页面的任务设置：整理、刮削和 STRM 步骤都要先在各自页面保存一个手动执行的任务，再在工作流中引用它。

新建工作流

点击“新建工作流”，先填写运行设置：

字段	怎么填写	影响
工作流名称	例如“电影下载自动入库”。	只用于区分工作流和执行记录。
启用	完成设置前可先关闭。	关闭后不会接受新的自动触发；已经处理过的文件不会还原。
触发条件	至少添加一个条件。	满足任意一个条件就会启动一次工作流。
执行步骤	按实际处理顺序添加。	上一步完成后才会进入下一步。

触发条件	需要填写的字段	什么时候用
手动执行	无。	在工作流列表点击“立即执行”时启动；首次测试推荐使用。
定时执行	Cron 表达式，例如 `0 2 * * *` 表示每天 02:00。	固定时间执行。已有一次运行尚未结束时，会跳过下一次计划。
下载完成	选择下载助手中已保存的下载目录；可选择是否包含子目录。	该目录的一批下载完成并确认刷新后启动。
本地目录监控	选择本地存储和要监控的目录；可选择是否包含子目录。	本地目录有新文件时启动。
私聊指令	填写专属指令名称，并选择已绑定的企业微信或 Telegram 入口和允许的发送者。	从指定私聊入口发送指令时启动；指令名称在整个 Mediora 中不能重复。

“包含子目录”开启后，子文件夹里的新文件也能触发；关闭后只关注当前目录。私聊指令前需要先在下载助手的“使用设置”中绑定通知入口。

步骤	需要设置什么	会发生什么
媒体整理	选择一个已保存的手动整理任务。	按该任务的来源、目标、命名和覆盖设置整理文件。
媒体刮削	选择一个已保存的手动刮削任务。	为对应媒体补资料和海报。
STRM 生成	选择一个已保存的手动 STRM 任务。	生成远端媒体的播放入口。
刷新网盘缓存	选择源目录、目标目录或全部目录。	让前面文件步骤改动过的目录重新读取；没有改动时会跳过。
延时等待	选择固定时长、随机区间或指定时刻。	在两步之间等待，例如等媒体服务器或网盘完成更新。
通知	选择是否附加执行摘要。	工作流结束时发送执行结果；需要先有可用的通知配置。

每个步骤都有“失败时”的选择：

通常可按“整理 → 刮削 → STRM → 刷新目录 → 通知”的顺序配置。步骤可以上移、下移、复制或删除；改顺序会影响下一次运行，不会改变已经完成的历史记录。

下载完成或文件监控触发时，工作流会保留这次已确认的文件范围。后续媒体步骤仍需符合所引用任务的目录与权限，不会因为一个文件成功就授权处理旁边的整个目录。

因此要同时核对两件事：触发目录是否对应真实下载位置，整理后的目标目录是否位于下一步刮削或 STRM 任务允许的范围。先分别手动验证每一步，再用一小批文件测试完整工作流。

文件清单、来源身份或步骤资料丢失、发生变化时，会明确失败，不回退成扫描整个目录。不要用改名存储或扩大任务目录来绕过提示，应检查原执行记录，按实际文件状态重新发起。

文件事件不会把 BDMV / VIDEO_TS 内部片段当成独立作品触发。

第一次创建时，先添加“手动执行”条件，保存后点击“立即执行”。打开执行记录可以看到当前进行到哪一步、每一步的结果和失败提示。

子任务显示“已接收”或部分文件成功时，工作流仍会等待该步骤本轮的最终结果。扫描失败、共享资料失败或待核实写入可能影响步骤是否成功，不能只看通知已送达就认定全部文件处理完成。

“刷新网盘缓存”用于重新读取对应存储目录，不等于刷新 Emby / Jellyfin 媒体库，也不能让尚未完成 NAS 后台上传的文件立即可用。

常见情况	先检查什么
下载完成却没触发	下载目录是否已保存、工作流是否启用、下载批次是否已完成文件核对。
某一步没有处理文件	原清单、所引用任务及该步骤的允许目录是否对应。
暂停后仍有文件写入	在途写入需先安全结束，查看本轮和文件记录。
取消后下次仍触发	取消只影响当前执行；需要停用工作流才能停止后续自动触发。
通知失败	查看通知渠道和投递记录，按具体事件重试；不要为了补通知重跑所有文件步骤。

停用或删除工作流只影响以后是否再启动，不会删除媒体文件、资料文件或已生成的 STRM。