PinchFlat项目实现媒体文件状态变更的Webhook通知机制

2025-06-27 00:39:59作者：霍妲思

在媒体服务器管理领域，PinchFlat项目近期实现了一个重要的功能增强——通过生命周期脚本(Lifecycle Scripts)机制来支持媒体文件状态变更时的Webhook通知。这一功能特别适合与自动扫描工具(如autoscan/autopulse)配合使用，能够显著提升媒体库更新效率。

功能背景

传统媒体服务器如Plex在检测到文件系统变更时，通常需要扫描整个媒体库目录，这不仅消耗大量I/O资源，还会导致不必要的CPU负载。更高效的解决方案是仅扫描实际发生变化的目录，这正是autoscan/autopulse等工具的设计初衷。

PinchFlat通过引入生命周期脚本机制，能够在关键文件状态变更时(如下载完成、删除等)触发外部通知，为这类优化方案提供了完美的集成点。

技术实现细节

PinchFlat的生命周期脚本功能允许用户配置自定义脚本，这些脚本会在特定事件发生时被调用。主要支持的事件类型包括：

媒体文件下载完成(media_downloaded)
媒体文件删除(media_deleted)
频道更新完成(channel_updated)

每个事件触发时，PinchFlat会向配置的脚本传递两个参数：

事件类型(上述类型之一)
包含详细信息的JSON数据(如文件路径等)

实际应用示例

一个典型的使用场景是与autoscan/autopulse集成。用户可以通过编写简单的shell脚本，将PinchFlat的事件转换为autoscan能够理解的API调用。以下是一个经过优化的示例脚本：

#!/bin/bash

EVENT_TYPE=$1
EVENT_DATA=$2

# 提取媒体文件路径
media_path=$(echo "$EVENT_DATA" | jq -r '.media_filepath')
[ -z "$media_path" ] && exit 0

# 只处理下载和删除事件
case "$EVENT_TYPE" in
    "media_downloaded"|"media_deleted")
        media_dir=$(dirname "${media_path}")
        # 调用autoscan API，仅扫描变更目录
        curl -sS "http://autoscan:3030/triggers/manual" \
             --data-urlencode "dir=${media_dir}" \
             --get -X POST
        ;;
    *)
        exit 0
        ;;
esac

进阶配置建议

对于使用autopulse的用户，调用方式略有不同。autopulse需要基本认证并支持自定义触发器名称。以下是对应的脚本调整建议：

#!/bin/bash

EVENT_TYPE=$1
EVENT_DATA=$2

media_path=$(echo "$EVENT_DATA" | jq -r '.media_filepath')
[ -z "$media_path" ] && exit 0

case "$EVENT_TYPE" in
    "media_downloaded"|"media_deleted")
        media_dir=$(dirname "${media_path}")
        # autopulse需要认证并支持自定义触发器
        curl -u 'username:password' \
             "http://autopulse:2875/triggers/pinchflat?path=${media_dir}"
        ;;
esac