# @iworkflow/temporal 中文文档

规范地址：https://npmcn.com/package/%40iworkflow/temporal/

版本：0\.15\.1
npm 元数据更新时间：2026-11-01T06:36:43.045Z
中文译文更新时间：2026-11-01T13:04:16.225Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：53.5 kB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- peer 依赖：@temporalio/client ^1\.24\.0，@temporalio/common ^1\.24\.0，@temporalio/worker ^1\.24\.0，@temporalio/activity ^1\.24\.0，@temporalio/workflow ^1\.24\.0
- 首次发布：2026-10-21T11:55:19.055Z
- 最新版本发布：2026-11-01T06:36:42.838Z
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

@iworkflow/core的临时适配器

## 安装

```sh
npm install @iworkflow/temporal
```

也可以使用：`pnpm add @iworkflow/temporal`、`yarn add @iworkflow/temporal`、`bun add @iworkflow/temporal`

## README

# @iworkflow /时间

颞для `@iworkflow/core`。同行: `@temporalio/{client,common,worker,workflow,activity}` ^ 1.24。

Модуль объявляет， своих зависимостях **всепять** 对端：даже если <s:2> <e:2>： импортирует не все： сборка серверас `external: ["@temporalio/*"]` их не вкладывает， без `@temporalio/common` подпадает на старте `Cannot find module`.

-   `temporalRuntime(workflowsPath, opts?).start(def)` —воркер на任务队列 `def.app`； `opts.workflowBundlePath` - готовый бандл прод-сборки。
-   `temporalClient(opts?)` - старт， сигнал，查询по id。
-   `temporalActivities(activities)` - шаги порта для своего `Worker.create` (слив старой очереди， тестовый воркер): `Failure` → `ApplicationFailure`,работают `heartbeat` и `stepAttempt`。Шаги без неё своём воркере `heartbeat`/`stepAttempt` невидят——с0.6.0рантаймшагаставитсянавремяшага。
-   `temporalStep(fn)` - тест шага без воркера： `new MockActivityEnvironment().run(() => temporalStep(() => acts.send(x)))`； `acts` - сырые шаги （не результат） `temporalActivities`)， отказ остаётся `Failure`； `@temporalio/testing` ставит модуль。
-   `@iworkflow/temporal/workflow` - только для входа песочницы модуля： `export const outreach = temporalFlow(flows.outreach, ["send-twice"])`。Сигналы \* query - только через порт （`handle.signal`， `handle.query`):сырыеимена颞непринимаются,иначемодульнепереедетнаDBOS。

`opts` （`TemporalOptions`): `address`， `namespace`， `tls`， `apiKey` - источник токена， меняется каждые `apiKeyRenewMs`； `plugins` - плагины SDK воркерам \* клиенту； `temporalClient({ lazy: true })` - соединение при первом вызове。 Без них - переменные `TEMPORAL_URL` (поумолчанию `127.0.0.1:17233`)， `TEMPORAL_NAMESPACE`.

## 常见问题

### @iworkflow/temporal 是什么？

@iworkflow/core的临时适配器

### 如何安装 @iworkflow/temporal？

在项目目录运行 npm install @iworkflow/temporal，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@temporalio/client（^1\.24\.0）、@temporalio/common（^1\.24\.0）、@temporalio/worker（^1\.24\.0）、@temporalio/activity（^1\.24\.0）、@temporalio/workflow（^1\.24\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @iworkflow/temporal 支持 TypeScript 吗？

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

### @iworkflow/temporal 支持 ESM 还是 CommonJS？

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

### @iworkflow/temporal 需要什么版本的 Node\.js？

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

### @iworkflow/temporal 可以商用吗？

@iworkflow/temporal 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @iworkflow/temporal 还在维护吗？

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