主题
事件与 Webhook
新版把事件分成两类:ETKN 内置媒体服务事件,以及 MoviePilot 外部事件。它们的入口和作用不同。
内置媒体服务事件
内置媒体服务兼容 Emby/Jellyfin 客户端。媒体服务或兼容客户端发生元数据、图片、评分、用户策略、合集变更或刷新请求时,事件会进入 ETKN 的事件任务链。
兼容入口:
text
POST /api/emby/events
POST /api/media-server/events事件通常只负责排队,真正处理在任务中心执行。刷新请求可能触发元数据刷新、图片替换、缺失信息补齐或片头片尾处理;播放状态则会进入播放记录和统计。
新版不依赖 ETK MediaInfo Bridge 插件才能完成核心流程。标题、简介、图片、媒体信息和事件处理由 ETKN 自己的服务与任务完成。
MoviePilot Webhook
MoviePilot 使用独立入口:
text
POST /webhook它用于接收订阅变化、下载状态和转移完成事件。事件进入资源获取或订阅助手后,ETKN 继续执行识别、整理、元数据处理和入库。MoviePilot 报告“完成”不代表媒体已经出现在 ETKN 媒体库中。
排查事件链
- 先在任务中心按时间找到根任务。
- 打开任务详情,确认事件类型、失败阶段和后续任务号。
- 资源已转存但没有整理时,检查是否生成了后续整理任务,以及 115 目录是否已经同步完成。
- 媒体已整理但客户端看不到时,检查
8097是否可访问、媒体库刷新任务是否成功,以及客户端使用的地址是否是代理后的地址。
不要再按旧版 /webhook/emby 或 Bridge 插件状态判断新版主流程是否正常。