用途:为 Blink 项目提供后台任务队列与 cron 定时调度能力,用于异步执行发邮件、生成报表等耗时任务。
主要能力:入队任务并按具名 FIFO 队列并行处理;创建、暂停、恢复、删除 cron 定时计划;查看任务列表与统计;取消待处理任务;列出并重试死信队列;失败自动重试。MCP 工具包括 blink_queue_enqueue、blink_queue_schedule、blink_queue_list、blink_queue_stats、blink_queue_cancel、blink_queue_get、blink_queue_dlq_retry、blink_queue_create_queue。
使用方式:先部署后端(blink backend status 检查,blink backend deploy 部署),再在 backend/index.ts 添加 POST /api/queue 处理器,用 blink.queue.verify 校验 upstash-signature 后才解析原始 body,按 taskName 分发。处理器需在入队前写好,改动后重新部署。定时计划的 name 即 taskName。可用 CLI 入队:blink queue enqueue send-welcome-email --payload '{"to":"user@example.com"}';创建计划:blink queue schedule create daily-digest "0 9 * * *" --payload '{"reportType":"daily"}'。SDK 支持 enqueue 的 queue、delay、retries 选项,schedule 的 timezone 选项,以及 pause/resume/deleteSchedule、createQueue 并行度、list、cancel、listDead、retryDead、stats。最低 SDK 版本 @blinkdotnew/sdk >= 2.9.0。
限制:必须部署后端,否则投递失败;队列 URL 公开,需校验签名;返回非 2xx 会触发重试继而进入死信队列;cancel 仅对 pending 任务有效,否则返回 409;BLINK_QUEUE_SIGNING_KEY 由平台自动注入。计费 1 credit = 1000 次任务,重试与读取免费,仅 Pro+ 套餐可用。