Trigger.dev 技能面向使用 TypeScript 构建生产级后台任务、工作流和自动化的开发者,基于 Trigger.dev v4 提供代码模式与工程约束指导。
用途:帮助编写代码优先(code-first)的后台作业,包括任务定义与触发、定时调度、重试与错误处理、并发与队列控制、幂等与等待、可观测性及部署配置。资料说明,如需可视化工作流应使用 n8n。
主要能力:
- 基础任务:使用 task 定义任务,包含唯一 id 与异步 run 函数。
- Schema 校验任务:使用 schemaTask 配合 zod 对 payload 进行类型化与校验。
- 定时任务:使用 schedules.task 配置 cron 表达式,回调中可获取 timestamp、lastTimestamp、timezone。
- 触发方式:可从后端用 tasks.trigger 触发任务(配合 type-only 导入任务类型),也可在任务内用 triggerAndWait 调用其他任务并等待结果。
- 稳定性控制:提供并发、重试、错误、幂等、wait 函数、AbortTaskRunError 等机制。
- 运行观测:涉及 runs、tags、metadata、logger、streams、query 等 SDK 能力。
- 机器规格:micro(0.25 vCPU / 0.25 GB)、small-1x 默认(0.5 / 0.5 GB)、small-2x(1 / 1 GB)、medium-1x(1 / 2 GB)、medium-2x(2 / 4 GB)、large-1x(4 / 8 GB)、large-2x(8 / 16 GB)。
使用方式(资料给出的核心步骤):
- 安装依赖:npm add @trigger.dev/sdk@latest 与 npm add -D @trigger.dev/build@latest。
- 在项目根目录创建 trigger.config.ts,使用 defineConfig({ project: "<ref>", dirs: ["./src/trigger"] }),配置文件不能嵌套。
- 在 .env 中添加 TRIGGER_SECRET_KEY。
- 在配置的目录中创建任务文件并导出任务。
- 本地开发运行 npx trigger.dev@latest dev,部署运行 npx trigger.dev@latest deploy。
适用场景:TypeScript 项目中的后台作业、定时清理、后端触发的异步流程、任务间的编排与等待、需要并发与重试控制的自动化,以及涉及 AI 集成、流式传输与实时能力的任务。
限制与关键规则:任务 ID 全项目唯一;payload 与返回值必须可 JSON 序列化,不能包含类、函数或循环引用;任务需导出,未导出会变为隐藏/仅内部可用;从后端触发时使用 type-only 导入;永久性错误使用 AbortTaskRunError 以避免重试;等待期间任务会 checkpoint,不计计算费用;并发限制只统计正在执行的运行;每次运行最多 10 个 tag、256KB metadata,批量最多 1000 项;重试时可在任务内用 idempotencyKeys.create() 防止重复触发子任务。
质量要求:代码需编译并通过测试与类型检查且无新增警告;显式处理边界条件与错误状态;不引入硬编码密钥;不削弱或跳过失败测试,不静默吞掉错误,破坏性 API 变更需版本升级与迁移路径。资料的官方文本未提供,收费、价格与具体平台支持等信息暂未提供。