-- 开放平台 v1 的状态推送订阅(见 control-server/src/openplatform_webhooks.ts)。 -- -- 和管理台那份全局 webhookUrls(settings KV,推全部单子、只发一次)是两套东西: -- 那份留给存量接收端原样用;这里是给接入方的标准方案 —— 订阅挂在一把 API Key -- 下,只推这把 Key 建的任务(tasks.created_via_key_id),每条带 HMAC 签名,失败 -- 按退避重试。Key 本身仍在 settings KV 里,这里的 key_id 指向它的稳定 id。 -- -- 投递单独一张表而不是发完即弃:重试、「最近投递」自查、以及「同一事件对同一 -- 订阅只投一次」的去重(唯一索引)都要落地的状态。纯新增,不需要回填。 CREATE TABLE IF NOT EXISTS "openplatform_webhooks" ( "id" text PRIMARY KEY, "key_id" text NOT NULL, "url" text NOT NULL, -- 只推这些状态(JSON 数组存 TEXT);NULL = 全部状态。 "events" text, -- 签名密钥明文。HMAC 需要服务端持有原文,所以不能像 API Key 那样只存哈希; -- 只在创建时返回一次,列表接口永不返回。 "secret" text NOT NULL, "created_at" bigint NOT NULL, -- 非空 = 已停用(接入方 / 管理员手动停用,或连续投递失败被自动停用)。 "disabled_at" bigint, "disabled_reason" text, "consecutive_failures" bigint NOT NULL DEFAULT 0, "last_success_at" bigint, "last_failure_at" bigint ); CREATE INDEX IF NOT EXISTS "openplatform_webhooks_key" ON "openplatform_webhooks" ("key_id"); CREATE TABLE IF NOT EXISTS "openplatform_webhook_deliveries" ( "id" text PRIMARY KEY, "webhook_id" text NOT NULL, -- 与 task_transitions.id 同一个值(kind:targetId:toStatus:ts),接收端据此去重。 "event_id" text NOT NULL, -- 入队那一刻冻结的请求体;签名在每次发送时按当时的时间戳重算。 "payload" text NOT NULL, -- pending | succeeded | failed(重试用尽)| cancelled(订阅停用 / Key 吊销) "state" text NOT NULL, "attempts" bigint NOT NULL DEFAULT 0, "next_attempt_at" bigint, "last_status" bigint, "last_error" text, "created_at" bigint NOT NULL, "updated_at" bigint NOT NULL ); CREATE UNIQUE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_event" ON "openplatform_webhook_deliveries" ("webhook_id", "event_id"); CREATE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_due" ON "openplatform_webhook_deliveries" ("state", "next_attempt_at"); CREATE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_recent" ON "openplatform_webhook_deliveries" ("webhook_id", "created_at");