用途:该技能为在 Windmill 中新增原生触发器服务提供实现指南。原生触发器让外部服务(如 Nextcloud、Google Drive)通过 webhook 或推送通知触发 Windmill 脚本与流程。
主要能力:说明整体架构,包括 PostgreSQL 数据库表与枚举、windmill-native-triggers crate 中的 Rust 核心 trait 与处理器、以及前端 Svelte 配置表单。列出关键文件路径,如 lib.rs(External trait)、handler.rs(通用 CRUD)、sync.rs(后台同步)、workspace_integrations.rs(OAuth 集成)、triggers.rs 与 jobs.rs 中的枚举、前端 utils.ts 与 TriggersBadge.svelte 等。
核心概念:每个服务实现 External trait,含关联类型 ServiceConfig、TriggerData、OAuthData、CreateResponse 及常量 SUPPORT_WEBHOOK、SERVICE_NAME 等,并实现 create、update、get、delete、exists、maintain_triggers 等方法。创建流程分短路径(Google 模式,service_config_from_create_response 返回 Some)与长路径(Nextcloud 模式,返回 None 后调用 update 修正 webhook URL)。OAuth 令牌采用三表模式存储于 workspace_integrations、variable、account,由 decrypt_oauth_data() 组装。
使用方式:按步骤实施——新增数据库迁移(向 native_trigger_service、TRIGGER_KIND、job_trigger_kind 枚举添加值)、更新 windmill-common 枚举、创建后端服务模块(mod.rs 定义类型、external.rs 实现 trait)、注册 ServiceName 各匹配分支、补充前端组件与 OpenAPI 规范。
适用场景:为 Windmill 集成新的外部触发源。限制:资料未提供完整实现细节与测试步骤,部分内容在原文中被截断。