Agent 跑挂了，第一反应往往是”重跑一次”。但只要任务超过 60 秒，你就得开始和超时、队列丢失、刷新页面就断流这些东西搏斗了。2026 年专门来解决这个问题的开源项目里，Trigger.dev 是绕不开的一个：16,458 星、1,479 fork、Apache-2.0 协议，TypeScript 占代码库的 99.2%，10 月 2 日还在推代码。npm 上 @trigger.dev/sdk 上月下载 412.8 万次。
这是它的第五千多天。今天就从定位聊到自托管，再聊聊我在本机踩到的那个坑。
它到底是什么
一句话：Trigger.dev 是给 TypeScript 工程师的持久化执行层（durable execution）。你照常写 async 函数，它负责把这段代码”钉”在集群里跑完——不管网页被刷新、服务器被重启，还是任务跑了两个小时。
架构拆开只有两块，而且能独立横向扩：
- Webapp：控制台 + Redis + Postgres
- Worker：supervisor + 真正执行任务的 runner
关键卖点就两条：没有超时，以及按实际执行时间计费。官方主推的 chat.agent() 长驻聊天 Agent 里，支持工具调用、人工审批（needsApproval: true 会挂起任务等人点确认，而不是超时失败）、中途打断和流式推送到前端——不用自己写 API 路由。
为什么它跟 n8n、Windmill 不一样
前面我在 Windmill 那篇 提过同一类东西，但差别很实在：
n8n、Zapier、Make 是你画流程、它照着跑。Trigger.dev 是你写代码、它替你扛住运行时。前者适合业务人员拖拽，后者适合你真的要调 LLM、跑重逻辑的工程师。它甚至支持 Bun runtime 和 MCP server 安装。
上手：3 分钟和一个真实的坑
文档承诺 3 分钟跑通，命令是：
npx trigger.dev@latest init
npx trigger.dev@latest dev
我在本机（Node v22.22.2 / npm 10.9.7）实跑，直接卡死在第一步：
npm error code ETARGET
npm error notarget No matching version found for @trigger.dev/[email protected].
注意 @trigger.dev/core 在官方 registry 里确实存在 4.7.2——我直接查了 registry JSON，769 个版本，4.7.2 的发布时间是 2026-10-02 14:07。问题出在 npm 源：我这台机器配的是 registry.npmmirror.com，而它同步到 4.6.4 就卡住了。
换官方源立刻好：
npm install @trigger.dev/[email protected] --registry=https://registry.npmjs.org
# added 56 packages in 3m
所以在国内用 Trigger.dev，第一件事是把 registry 指回官方源，或者锁定到 4.6.4。这不是项目本身的 bug，是镜像同步延迟——但新人第一反应一定是”这项目坏了”，挺坑的。
另外 v3 已经 EOL，官方明确说 4.5.0 是最后支持 v3 任务的版本，4.5.1 之后会直接拒绝 v3 的 trigger。新项目直接上 v4。
实话：谁该用，谁别碰
该用：你在写 TypeScript/Next.js，任务耗时经常超过 30 秒（跑 Agent、批量处理文档、深度研究），受够了 API 超时和”刷新一下任务就丢了”。自托管有 Docker compose 和 K8s 两套官方方案，数据要落地在自己机器上，这个对做内网 Agent 的场景很关键。
别碰：你不想碰 Node.js，或者你压根不需要超过 60 秒的任务——那用 cron 加个队列就够了，装 Trigger.dev 是杀鸡用牛刀。另外官方自己也很坦诚：自托管版本”功能上和 Cloud 基本一样，但我们不管理你的实例，性能、可用性、数据完整性你自负全责“。想省心就用 Cloud（有免费额度）。
最后提一句，星数只是注意力指标，别当成生产可靠性的证明。Trigger.dev 星数不算最高（比不过 Langflow 的 15.5 万），但 npm 每周 400 万下载量说明真在生产环境跑着东西——这比星数实在。
by 数码罗记 · godsun.pro
数据核实时间：2026-10-04 01:35 CST。星数、fork 数、许可协议、最近提交时间来自 GitHub API 实测；npm 下载量取自 npm registry downloads API（统计周期 2026-09-02 至 2026-10-01）；安装报错、镜像版本落后为本文作者本机 Node v22.22.2 / npm 10.9.7 真实运行结果，可复现。
