# @evelandhq/workflow-world 中文文档

规范地址：https://npmcn.com/package/%40evelandhq/workflow-world/

版本：0\.31\.1
npm 元数据更新时间：2026-11-06T05:42:43.602Z
中文译文更新时间：2026-11-14T03:04:26.639Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40evelandhq/workflow-world
原文对照：https://npmcn.com/package/%40evelandhq/workflow-world/?lang=original
项目主页：https://github.com/evelandhq/workflow-world#readme
源码仓库：https://github.com/evelandhq/workflow-world

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：676 kB，118 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：10 个
- 首次发布：2026-08-04T15:28:38.811Z
- 最新版本发布：2026-11-06T05:42:43.186Z
- 近 30 天下载量：2438（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

本地多租户工作流程世界为Vercel Work流程 SDK, 加上驱动其退出进程的调度器

## 安装

```sh
npm install @evelandhq/workflow-world
```

也可以使用：`pnpm add @evelandhq/workflow-world`、`yarn add @evelandhq/workflow-world`、`bun add @evelandhq/workflow-world`

## README

# @evelandhq/工作流-世界

多租户 [工作流程 SDK](https://github.com/vercel/workflow) 得到世界支持 PostgreSQL,带有一个执行器的调度器,其执行器的大小为零.

> **实验, `0.x`。 。 。 .** 这批货还没有运出生产流量.

## 快开始

需要节点.js 24+和 PostgreSQL. 安装在已有的 Workflow SDK app中 :

```bash
npm install @evelandhq/workflow-world
```

跟着 [融合指南](https://npmcn.com/package/%40evelandhq/workflow-world/docs/guides/getting-started.md) 来配置 提供数据库和租户.

要尝试工作应用程序,请使用独立程序 [Next.j 实例](https://npmcn.com/package/%40evelandhq/workflow-world/examples/nextjs/README.md)。 。 。 . 它使用公布的软件包和一个嵌入式跑道,没有Eve或激活 需要服务。 示例将它自己的被验证的软件包和SDK版本标出.

```bash
git clone https://github.com/evelandhq/workflow-world.git
cd workflow-world/examples/nextjs
npm ci
cp .env.example .env.local
```

设定 `WORKFLOW_WORLD_URL` 内 `.env.local` 改为专用开发数据库 (示例包括: [嵌入设置](https://npmcn.com/package/%40evelandhq/workflow-world/examples/nextjs/README.md#run)) (中文(简体) ). 然后说:

```bash
npm run setup
npm run dev
```

设置应用了迁移,初始化了图解,并规定了租户 分区。 在另一个终端,运行 `npm run smoke` 从 `examples/nextjs` 改为 验证完成的工作流程 `Hello, World!`。 。 。 .

对于缩放为零的执行者,请遵循 [外部运行器设置](https://npmcn.com/package/%40evelandhq/workflow-world/docs/guides/getting-started.md#external-runner)。 。 。 . 见 [文档索引](https://npmcn.com/package/%40evelandhq/workflow-world/docs/README.md) 用于配置、操作、, 和建筑.

## 发展

需要Node.js 24+,被绑住的 pnpm 版本,以及一次性 PostgreSQL 用于集成测试的数据库。 从新取出 :

```bash
git clone https://github.com/evelandhq/workflow-world.git
cd workflow-world
npm install --global pnpm@11.7.0
pnpm install --frozen-lockfile
pnpm run build
```

对于本地测试数据库( 需要多克) :

```bash
docker run --rm --name workflow-world-dev \
  -e POSTGRES_USER=wfw -e POSTGRES_PASSWORD=wfw -e POSTGRES_DB=wfw_test \
  -p 127.0.0.1:5433:5432 -d postgres:17-alpine
docker exec workflow-world-dev pg_isready -U wfw -d wfw_test
```

一旦 PostgreSQL 报告正在接受连接, 请运行 :

```bash
pnpm run typecheck
EVELAND_WORKFLOW_WORLD_TEST_URL=postgres://wfw:wfw@127.0.0.1:5433/wfw_test pnpm test
```

考试采用移民方式,提供自己的租户。 现有 测试数据库,替换其 URL。 停止一次性数据库 `docker stop workflow-world-dev`;这可以删除其测试数据.

见 [促进发展和贡献](https://npmcn.com/package/%40evelandhq/workflow-world/docs/maintainers/development.md) 受抚养人 管理和检查,以及 [测试](https://npmcn.com/package/%40evelandhq/workflow-world/docs/maintainers/testing.md) 以遵守者发誓, 夏娃E2E, 和远步租借检查.

## 捐款

打开一个问题或拉动请求,说明问题、拟议的修改,以及 是怎样核实的 跟着 [捐款指南](https://npmcn.com/package/%40evelandhq/workflow-world/docs/maintainers/development.md#before-opening-a-pull-request) 并使用常规承诺信息。 释放程序记录如下: [释放](https://npmcn.com/package/%40evelandhq/workflow-world/docs/maintainers/releasing.md)。 。 。 .

## 许可证和归属

版权2026 Eveland. 许可证根据 [阿帕奇 - 2.0](https://npmcn.com/package/%40evelandhq/workflow-world/LICENSE)。 。 。 .

存储器、流子、队列和 Drizzle 计划模块来自Vercel 的 `@workflow/world-postgres`。 。 。 . [通知](https://npmcn.com/package/%40evelandhq/workflow-world/NOTICE) 上游归属记录 基础修订和修改 [兼容合同](https://npmcn.com/package/%40evelandhq/workflow-world/docs/world-postgres-beta34-compatibility.md) 定义行为边界.

## 常见问题

### @evelandhq/workflow-world 是什么？

本地多租户工作流程世界为Vercel Work流程 SDK, 加上驱动其退出进程的调度器

### 如何安装 @evelandhq/workflow-world？

在项目目录运行 npm install @evelandhq/workflow-world，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 workflow-dispatcher、workflow-world-setup，可以用 npx workflow-dispatcher 直接运行。

### @evelandhq/workflow-world 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @evelandhq/workflow-world 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @evelandhq/workflow-world 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @evelandhq/workflow-world 可以商用吗？

@evelandhq/workflow-world 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @evelandhq/workflow-world 的下载量有多少？

根据 npm 官方下载统计，@evelandhq/workflow-world 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,438 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @evelandhq/workflow-world 还在维护吗？

最新版本 0\.31\.1 发布于 2026/11/06（7 天前）；至今共发布 41 个版本，其中过去 12 个月发布了 41 个；首次发布于 2026/08/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。