# @agentplat/workflows 中文文档

规范地址：https://npmcn.com/package/%40agentplat/workflows/

版本：1\.5\.1
npm 元数据更新时间：2026-11-03T19:57:55.409Z
中文译文更新时间：2026-11-06T16:52:14.834Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：338 kB，35 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-07-14T22:41:17.831Z
- 最新版本发布：2026-11-03T19:57:55.066Z
- 近 30 天下载量：2690（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

工作流程合同和AgentPlat的模拟工作流程商店.

## 安装

```sh
npm install @agentplat/workflows
```

也可以使用：`pnpm add @agentplat/workflows`、`yarn add @agentplat/workflows`、`bun add @agentplat/workflows`

## README

# @ agentplat/ 工作流程

长期代理公司的工作流程合同和定型V1跑车 进程.

## 安装( 开发者预览)

明确安装协调预览 :

```sh
npm install @agentplat/workflows@next
```

全部留着 `@agentplat/*` 软件包在同一版本中。 npm 的默认 `latest` 标记可以指向更古老的预览。 见 [释放通道](https://github.com/Agentplat/agentplat/blob/main/docs/release-channels.md) 用于发行状态和版本选择.

这个软件包定义了任务,任务运行,流程定义,阶段,文物和工作流程存储. 它为代理产品提供了可持久使用的词汇来进行管弦乐,回转,交接,状态跟踪和输出捕捉.

现有合同和 `InMemoryWorkflowStore` 继续提供。 这个 添加剂V1表面提供经验证的任务、等待、信号和通用门DAG, 单体定义/状态摘要、单体进程操作和 `InMemoryProcessRunnerV1` 用于当地构成和面向符合性的测试. 每一次任务尝试都作为订正 `TaskRunV1` 及其准确性 处理器/即时/模型/政策/工具捆绑、输入文摘、稳定的一能钥匙, 使用和结果参考。 固定租赁支持心跳续展和 世代收购。 老主人接受合作流产,不能 替换后结算。 模糊的防护效果 `indeterminate` 直至他们实现明显的和解;他们不被默默地重审.

```ts
import {
  createProcessDefinitionV1,
  InMemoryProcessRunnerV1,
} from "@agentplat/workflows";

const definition = createProcessDefinitionV1({
  processId: "process:review",
  version: "1",
  name: "Review process",
  stages: [
    {
      schemaVersion: 1,
      stageId: "prepare",
      name: "Prepare",
      kind: "task",
      taskDefinitionId: "task:prepare",
      taskDefinitionVersion: "1",
      dependsOn: [],
    },
    {
      schemaVersion: 1,
      stageId: "decision",
      name: "Decision",
      kind: "await_signal",
      signalType: "decision.recorded",
      dependsOn: [{ stageId: "prepare", outcomes: ["succeeded"] }],
    },
  ],
});
```

`InMemoryProcessRunnerV1` 保护浏览器安全,并故意不重新启动, 多程序、耐用定时器或即时外部效应索赔。 有效 执行者必须尊重稳定的“一能”特性和保护效果 仍然需要现有的 AgentPlat 动作边界 。 可持续融合可通过以下方式提供: `@agentplat/workflows-postgres`, (中文(简体) ), `@agentplat/workflows-rooms` 财务报告和审定财务报表 `@agentplat/workflows-temporal`见 [组件到期矩阵](https://npmcn.com/package/docs/component-maturity.md) 证据和证据 融合义务;内幕导师本身仍然不可持久.

`@agentplat/workflows/outcomes` 添加延迟结果归属, 有版本约束 分发摘要和覆盖监测器区分健康、, 证据不足、陈旧和没有证据。 成果类型、原因、主题 和源是不透明的调用词汇;软件包没有定义通用 精确度衡量或将缺失结果视为成功.

## 常见问题

### @agentplat/workflows 是什么？

工作流程合同和AgentPlat的模拟工作流程商店\.

### 如何安装 @agentplat/workflows？

在项目目录运行 npm install @agentplat/workflows，或使用 pnpm add / yarn add / bun add。

### @agentplat/workflows 支持 TypeScript 吗？

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

### @agentplat/workflows 支持 ESM 还是 CommonJS？

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

### @agentplat/workflows 可以商用吗？

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

### @agentplat/workflows 的下载量有多少？

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

### @agentplat/workflows 还在维护吗？

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