From bf441c82585703d0da9b0cc5138729f227a1bf43 Mon Sep 17 00:00:00 2001 From: wehub-resource-sync Date: Mon, 13 Jul 2026 10:43:09 +0000 Subject: [PATCH] docs: make Chinese README the default --- README.md | 124 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 65 insertions(+), 59 deletions(-) diff --git a/README.md b/README.md index 0d7f1ca..8c82d96 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,14 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/triggerdotdev/trigger.dev) · [上游 README](https://github.com/triggerdotdev/trigger.dev/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 +
![Trigger.dev logo](https://content.trigger.dev/github-header-banner.jpg) -### Build and deploy fully‑managed AI agents and workflows +### 构建并部署全托管 AI 智能体与工作流 [Website](https://trigger.dev) | [Docs](https://trigger.dev/docs) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Example projects](https://github.com/triggerdotdev/examples) | [Feature requests](https://triggerdev.featurebase.app/) | [Public roadmap](https://triggerdev.featurebase.app/roadmap) | [Self-hosting](https://trigger.dev/docs/self-hosting/overview) @@ -18,56 +24,56 @@
-## About Trigger.dev +## 关于 Trigger.dev -Trigger.dev is the open-source platform for building AI workflows in TypeScript. Long-running tasks with retries, queues, observability, and elastic scaling. +Trigger.dev 是用于在 TypeScript 中构建 AI 工作流的开源平台。支持长时间运行的任务，并提供重试、队列、可观测性（observability）和弹性扩缩容。 -## The platform designed for building AI agents +## 专为构建 AI 智能体而设计的平台 -Build [AI agents](https://trigger.dev/product/ai-agents) using all the frameworks, services and LLMs you're used to, deploy them to Trigger.dev and get durable, long-running tasks with retries, queues, observability, and elastic scaling out of the box. +使用你熟悉的各类框架、服务和 LLM 构建 [AI 智能体](https://trigger.dev/product/ai-agents)，部署到 Trigger.dev 后，即可开箱即用地获得持久化、长时间运行的任务，以及重试、队列、可观测性和弹性扩缩容能力。 -- **Long-running without timeouts**: Execute your tasks with absolutely no timeouts, unlike AWS Lambda, Vercel, and other serverless platforms. +- **长时间运行、无超时限制**：与 AWS Lambda、Vercel 及其他 serverless 平台不同，你的任务可以完全没有超时限制地执行。 -- **Durability, retries & queues**: Build rock solid agents and AI applications using our durable tasks, retries, queues and idempotency. +- **持久化、重试与队列**：借助持久化任务、重试、队列和幂等性（idempotency），构建稳定可靠的智能体与 AI 应用。 -- **True runtime freedom**: Customize your deployed tasks with system packages – run browsers, Python scripts, FFmpeg and more. +- **真正的运行时自由**：通过系统包自定义已部署的任务——可运行浏览器、Python 脚本、FFmpeg 等。 -- **Human-in-the-loop**: Programmatically pause your tasks until a human can approve, reject or give feedback. +- **人机协同（Human-in-the-loop）**：以编程方式暂停任务，等待人工批准、拒绝或提供反馈。 -- **Realtime apps & streaming**: Move your background jobs to the foreground by subscribing to runs or streaming AI responses to your app. +- **实时应用与流式传输**：通过订阅运行（runs）或将 AI 响应流式推送到应用，把后台作业带到前台。 -- **Observability & monitoring**: Each run has full tracing and logs. Configure error alerts to catch bugs fast. +- **可观测性与监控**：每次运行都有完整的追踪与日志。配置错误告警，快速发现 bug。 -## Key features: +## 核心功能： -- **[JavaScript and TypeScript SDK](https://trigger.dev/docs/tasks/overview)** - Build background tasks using familiar programming models -- **[Long-running tasks](https://trigger.dev/docs/runs/max-duration)** - Handle resource-heavy tasks without timeouts -- **[Durable cron schedules](https://trigger.dev/docs/tasks/scheduled#scheduled-tasks-cron)** - Create and attach recurring schedules of up to a year -- **[Trigger.dev Realtime](https://trigger.dev/docs/realtime/overview)** - Trigger, subscribe to, and get real-time updates for runs, with LLM streaming support -- **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - Hook directly into the build system and customize the build process. Run Python scripts, FFmpeg, browsers, and more. -- **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - Interact with the Trigger.dev API on your frontend using our React hooks package -- **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - Use batchTrigger() to initiate multiple runs of a task with custom payloads and options -- **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - Define precise data schemas for your tasks with runtime payload validation -- **[Waits](https://trigger.dev/docs/wait)** - Add waits to your tasks to pause execution for a specified duration -- **[Preview branches](https://trigger.dev/docs/deployment/preview-branches)** - Create isolated environments for testing and development. Integrates with Vercel and git workflows -- **[Waitpoints](https://trigger.dev/docs/wait-for-token#wait-for-token)** - Add human-in-the-loop judgment at critical decision points without disrupting workflow -- **[Concurrency & queues](https://trigger.dev/docs/queue-concurrency#concurrency-and-queues)** - Set concurrency rules to manage how multiple tasks execute -- **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - Support for DEV, PREVIEW, STAGING, and PROD environments -- **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - Auto-scaling infrastructure that eliminates timeouts and server management -- **[Automatic retries](https://trigger.dev/docs/errors-retrying)** - If your task encounters an uncaught error, we automatically attempt to run it again -- **[Checkpointing](https://trigger.dev/docs/how-it-works#the-checkpoint-resume-system)** - Tasks are inherently durable, thanks to our checkpointing feature -- **[Versioning](https://trigger.dev/docs/versioning)** - Atomic versioning allows you to deploy new versions without affecting running tasks -- **[Machines](https://trigger.dev/docs/machines)** - Configure the number of vCPUs and GBs of RAM you want the task to use -- **[Observability & monitoring](https://trigger.dev/product/observability-and-monitoring)** - Monitor every aspect of your tasks' performance with comprehensive logging and visualization tools -- **[Logging & tracing](https://trigger.dev/docs/logging)** - Comprehensive logging and tracing for all your tasks -- **[Tags](https://trigger.dev/docs/tags#tags)** - Attach up to ten tags to each run, allowing you to filter via the dashboard, realtime, and the SDK -- **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - Attach metadata to runs which updates as the run progresses and is available to use in your frontend for live updates -- **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - Perform actions on multiple runs simultaneously, including replaying and cancelling -- **[Real-time alerts](https://trigger.dev/docs/troubleshooting-alerts#alerts)** - Choose your preferred notification method for run failures and deployments +- **[JavaScript and TypeScript SDK](https://trigger.dev/docs/tasks/overview)** - 使用熟悉的编程模型构建后台任务 +- **[Long-running tasks](https://trigger.dev/docs/runs/max-duration)** - 处理资源密集型任务，无超时限制 +- **[Durable cron schedules](https://trigger.dev/docs/tasks/scheduled#scheduled-tasks-cron)** - 创建并附加最长可达一年的周期性调度 +- **[Trigger.dev Realtime](https://trigger.dev/docs/realtime/overview)** - 触发、订阅运行并获取实时更新，支持 LLM 流式传输 +- **[Build extensions](https://trigger.dev/docs/config/extensions/overview#build-extensions)** - 直接接入构建系统并自定义构建流程。可运行 Python 脚本、FFmpeg、浏览器等。 +- **[React hooks](https://trigger.dev/docs/frontend/react-hooks#react-hooks)** - 在前端通过 React hooks 包与 Trigger.dev API 交互 +- **[Batch triggering](https://trigger.dev/docs/triggering#tasks-batchtrigger)** - 使用 batchTrigger() 以自定义 payload 和选项发起同一任务的多次运行 +- **[Structured inputs / outputs](https://trigger.dev/docs/tasks/schemaTask#schematask)** - 为任务定义精确的数据 schema，并在运行时校验 payload +- **[Waits](https://trigger.dev/docs/wait)** - 在任务中添加等待，按指定时长暂停执行 +- **[Preview branches](https://trigger.dev/docs/deployment/preview-branches)** - 创建隔离的测试与开发环境。可与 Vercel 和 git 工作流集成 +- **[Waitpoints](https://trigger.dev/docs/wait-for-token#wait-for-token)** - 在关键决策点加入人机协同判断，而不中断工作流 +- **[Concurrency & queues](https://trigger.dev/docs/queue-concurrency#concurrency-and-queues)** - 设置并发规则，管理多个任务的执行方式 +- **[Multiple environments](https://trigger.dev/docs/how-it-works#dev-mode)** - 支持 DEV、PREVIEW、STAGING 和 PROD 环境 +- **[No infrastructure to manage](https://trigger.dev/docs/how-it-works#trigger-dev-architecture)** - 自动扩缩容的基础设施，消除超时与服务器管理负担 +- **[Automatic retries](https://trigger.dev/docs/errors-retrying)** - 若任务遇到未捕获错误，将自动尝试重新运行 +- **[Checkpointing](https://trigger.dev/docs/how-it-works#the-checkpoint-resume-system)** - 借助检查点（checkpointing）功能，任务天然具备持久化能力 +- **[Versioning](https://trigger.dev/docs/versioning)** - 原子化版本控制，可在不影响正在运行任务的情况下部署新版本 +- **[Machines](https://trigger.dev/docs/machines)** - 配置任务使用的 vCPU 数量和 RAM（GB） +- **[Observability & monitoring](https://trigger.dev/product/observability-and-monitoring)** - 通过全面的日志与可视化工具监控任务性能的各个方面 +- **[Logging & tracing](https://trigger.dev/docs/logging)** - 为所有任务提供全面的日志与追踪 +- **[Tags](https://trigger.dev/docs/tags#tags)** - 为每次运行附加最多十个标签，可在 dashboard、realtime 和 SDK 中筛选 +- **[Run metadata](https://trigger.dev/docs/runs/metadata#run-metadata)** - 为运行附加元数据，随运行进展更新，并可在前端用于实时更新 +- **[Bulk actions](https://trigger.dev/docs/bulk-actions)** - 同时对多次运行执行操作，包括重放和取消 +- **[Real-time alerts](https://trigger.dev/docs/troubleshooting-alerts#alerts)** - 为运行失败和部署选择你偏好的通知方式 -## Write tasks in your codebase +## 在代码库中编写任务 -Create tasks where they belong: in your codebase. Version control, localhost, test and review like you're already used to. +在任务所属之处创建它们：你的代码库中。像往常一样进行版本控制、本地开发、测试和评审。 ```ts import { task } from "@trigger.dev/sdk"; @@ -84,46 +90,46 @@ export const helloWorld = task({ }); ``` -## Deployment +## 部署 -Use our SDK to write tasks in your codebase. There's no infrastructure to manage, your tasks automatically scale and connect to our cloud. Or you can always self-host. +使用我们的 SDK 在代码库中编写任务。无需管理基础设施，任务会自动扩缩容并连接到我们的云端。你也可以随时选择自托管。 -## Environments +## 环境 -We support `Development`, `Staging`, `Preview`, and `Production` environments, allowing you to test your tasks before deploying them to production. +我们支持 `Development`、`Staging`、`Preview` 和 `Production` 环境，让你在部署到生产环境之前测试任务。 -## Full visibility of every job run +## 全面掌握每次作业运行 -View every task in every run so you can tell exactly what happened. We provide a full trace view of every task run so you can see what happened at every step. +查看每次运行中的每个任务，准确了解发生了什么。我们为每次任务运行提供完整的追踪视图，让你看清每一步的情况。 ![Trace view image](https://content.trigger.dev/trace-view.png) -# Getting started +# 快速开始 -The quickest way to get started is to create an account and project in our [web app](https://cloud.trigger.dev), and follow the instructions in the onboarding. Build and deploy your first task in minutes. +最快的入门方式是在我们的 [web app](https://cloud.trigger.dev), 中创建账户和项目，并按照入门引导中的说明操作。几分钟内即可构建并部署你的第一个任务。 -### Useful links: +### 实用链接： -- [Quick start](https://trigger.dev/docs/quick-start) - get up and running in minutes -- [How it works](https://trigger.dev/docs/how-it-works) - understand how Trigger.dev works under the hood -- [Guides and examples](https://trigger.dev/docs/guides/introduction) - walk-through guides and code examples for popular frameworks and use cases +- [Quick start](https://trigger.dev/docs/quick-start) - 几分钟内即可上手 +- [How it works](https://trigger.dev/docs/how-it-works) - 了解 Trigger.dev 的底层工作原理 +- [Guides and examples](https://trigger.dev/docs/guides/introduction) - 针对流行框架和用例的逐步指南与代码示例 -## Self-hosting +## 自托管（Self-hosting） -If you prefer to self-host Trigger.dev, you can follow our [self-hosting guides](https://trigger.dev/docs/self-hosting/overview): +如果你希望自行托管 Trigger.dev，可以按照我们的 [自托管指南](https://trigger.dev/docs/self-hosting/overview): -- [Docker self-hosting guide](https://trigger.dev/docs/self-hosting/docker) - use Docker Compose to spin up a Trigger.dev instance -- [Kubernetes self-hosting guide](https://trigger.dev/docs/self-hosting/kubernetes) - use our official Helm chart to deploy Trigger.dev to your Kubernetes cluster +- [Docker 自托管指南](https://trigger.dev/docs/self-hosting/docker) - 使用 Docker Compose 快速启动 Trigger.dev 实例 +- [Kubernetes 自托管指南](https://trigger.dev/docs/self-hosting/kubernetes) - 使用官方 Helm chart 将 Trigger.dev 部署到你的 Kubernetes 集群 -## Support and community +## 支持与社区 -We have a large active community in our official [Discord server](https://trigger.dev/discord) for support, including a dedicated channel for self-hosting. +我们在官方 [Discord 服务器](https://trigger.dev/discord) 拥有活跃的大型社区，可提供支持，其中包含专用于自托管的频道。 -## Development +## 开发 -To setup and develop locally or contribute to the open source project, follow our [development guide](./CONTRIBUTING.md). +如需在本地搭建开发环境或为开源项目贡献代码，请参阅我们的 [开发指南](./CONTRIBUTING.md)。 -## Meet the Amazing People Behind This Project: +## 认识项目背后的杰出贡献者：