自动联动
Tasks · Automation
把整理、STRM、刮削、Emby 串成一条流水线
后台 → 任务管理 → 自动联动。先选「何时触发」,再按顺序加动作。典型链路:刷新目录 → 整理 → STRM → 生成本地元数据 →(延迟)→ Emby 刷库。
快速步骤
新手
搭一条「夜里自动更新」
- 点「新增联动」→ 触发选每天定时,设好时间
- 第一步加整理任务(或先加「刷新目录」再整理)
- 联动执行里再加 STRM →(可选)生成本地 STRM 元数据 → Emby 刷库
下载完成
用第三方 Webhook 触发
- 系统设置 → API 秘钥 创建普通 API Key(
lpk_api_开头) - 联动触发选第三方通知,填通知名称(如
download_completed) - 外部程序
POST /api/open/automation/events,Header 带Authorization: Bearer …
易踩坑
STRM 会被联动「接管」
- 联动里引用某 STRM 任务后,该任务执行计划会变成仅手动 / 联动
- 此时不能在 STRM 页直接改回「全天 / 时间段」
- 要恢复定时:先从相关联动里移除该 STRM 动作,再改执行计划
我该怎么选
| 触发 | 含义 | 适合 |
|---|---|---|
| 每天定时 | 每天到固定时刻跑一次 | 夜间整库维护 |
| 本次触发时间 + 间隔 | 从首次时间起,按间隔小时循环 | 要比「每天一次」更密的周期任务 |
| 第三方通知 | 外部 Webhook 推送匹配的 event(可再限 source) | 下载器 / 转存完成后立刻整理 |
动作参数里容易懵的点
刷新目录只刷新本联动后面整理 / STRM 任务涉及的目录,让后续步骤看到最新列表;不是清空全站缓存。
允许异常比例整理动作里可填。界面说明:异常比例 =(失败数 + 异常跳过数)/ 需处理项;已整理、已是目标名等正常跳过不计入。默认约 30%。
刮削写入策略仅补缺:缺 nfo/海报才写;覆盖:已有也重写。日常推荐仅补缺。
刮削中断条件控制单个影片刮削失败时是否继续联动。配置错误、任务取消或服务异常仍会中断。
相关设置
自动联动本身没有独立设置抽屉。相关项分布在系统设置与各任务页。点左侧查看说明。
普通 API 秘钥
在 系统设置 → API 秘钥 创建任务执行型 Key,前缀一般为
只读 Key、STRM 媒体访问 Key 都不能调 Webhook。创建后请立刻复制完整明文,之后无法再查看。
lpk_api_。只读 Key、STRM 媒体访问 Key 都不能调 Webhook。创建后请立刻复制完整明文,之后无法再查看。
常见问题
Webhook 请求长什么样?
POST http://你的LitePan地址:5211/api/open/automation/events
Authorization: Bearer lpk_api_你的密钥
{
"event": "download_completed",
"message": "download_completed,请执行联动",
"source": "CloudSaver"
}event必须与联动里填的「通知名称」一致。source可选:联动里填了来源则必须匹配;留空表示任意来源。- 秘钥在 系统设置 → API 秘钥 创建任务执行型普通 Key(
lpk_api_),不是 STRM 媒体访问 Key,也不是只读 Key。
为什么「刷新目录」单独放会失败?
刷新目录需要根据后面的整理 / STRM 动作推断要刷哪些账号目录。若它是最后一步、或后面没有这两类动作,会提示「刷新目录后面需要有整理任务或 STRM 任务」。
STRM 执行计划被锁住了怎么办?
只有联动里的 STRM 任务动作会接管(「生成本地 STRM 元数据」不会改调度)。接管后变成「仅手动 / 联动」。
- 仅停用联动:仍然锁定,不会解锁。
- 从联动移除该 STRM 动作或删除规则后:锁定解除,但不会自动恢复原来的全天 / 时间段,需要你自己改回。
Emby 刷库灰掉 / 选不了?
到系统设置配置 Emby 地址(及 API Key)。联动配置里 Emby 一行是只读展示,不在这里改地址。
整理失败了,后面的 STRM 还会跑吗?
默认不会。后续步骤是「上一步成功后」才继续;整理失败后,后面的 STRM / 刮削 / Emby 通常会跳过。
和目录整理页的「预览」有何不同?
联动里的整理会直接生成计划并执行,没有人工预览。上线前请先在「目录整理」页手工预览跑通。同一联动里整理与 STRM 需同账号,且整理目标路径要落在 STRM 扫描路径下,否则可能无法保存。
停用的联动还能跑吗?
定时与 Webhook 不会跑已停用规则;列表里仍可「立即执行」。若规则里还挂着 STRM 动作(含已停用),STRM 执行计划仍可能被锁定。
刮削部分失败,后面还会继续吗?
默认「全部失败才中断」:个别影片失败、但并非全部失败时,后续联动通常仍会继续。若要更严,改成「任一失败即中断」。