用途:在 Lucid 官方文档定义的数据连接器模型内,实现并运维 Webhook 辅助的数据源同步。仅适用于数据连接器场景,不适用于通用 Lucid 文档、图形或协作事件 Webhook。
前提:需有合理的 Lucid 数据连接器、受支持的源系统 Webhook 契约、稳定的源记录/事件标识与对账 API,以及端点、身份、留存、可观测性、重放和回滚的负责人。
主要能力:验证事件信封、稳定 ID、新鲜度/重放窗口、去重、乱序容忍与对账;接收端快速确认并入队有界工作,隔离毒事件并施加背压;将 Webhook 数据视为变更提示,在源契约允许时先获取/对账权威状态再修改连接器数据。
使用方式:用 Read、Glob、Grep 检查连接器与处理程序代码,用 WebFetch 获取最新 Lucid 与源契约,仅用 Write/Edit 做本地实现、合成夹具和脱敏回执。各边界独立鉴权(Lucid 连接器、Webhook 源、上游对账 API),密钥保留在服务端,验证源文档化的真实性机制,不要臆造 LUCID_WEBHOOK_SECRET 约定。
测试与审批:用合成夹具覆盖有效、无效鉴权、畸形、重复、乱序、延迟、缺失记录、部分同步和重放场景。未经批准不得暴露/注册端点、创建密钥、重放生产事件、修改连接器数据或启用投递。批准后启用有界灰度,记录注册 ID、计数、拒绝、重复、延迟、对账与回滚。
限制:交付鉴权、签名、事件名、顺序、重试和留存可能属于源系统职责,须在源处核实,不能当作 Lucid 的通用保证。若请求涉及通用文档事件,应报告本技能无已验证契约,不得编造;交付真实性未文档化时保持端点禁用;重复或乱序事件导致状态分歧时暂停消费并从权威源对账。具体 SDK 接口以当前官方文档为准。