# @aglyn/plugins-workflows 中文文档

规范地址：https://npmcn.com/package/%40aglyn/plugins-workflows/

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T13:59:59.058Z
中文译文更新时间：2026-11-05T23:31:44.326Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：2.2 MB，228 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：12 个
- peer 依赖：next ^16\.3\.3，react ^19\.2\.8，firebase ^13\.0\.0，@mui/material ^9\.3\.1，firebase-admin ^14\.3\.0，@mui/x-data-grid ^9\.12\.0
- 首次发布：2026-09-20T23:53:50.291Z
- 最新版本发布：2026-11-07T13:59:58.701Z
- 近 30 天下载量：9463（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：161（近 12 个月 161 个）

## 中文简介

自动化插件: 控制台 **自动化** 部分——工作流,动作和Webhooks,以及运行在那里构建的引擎.

## 安装

```sh
npm install @aglyn/plugins-workflows
```

也可以使用：`pnpm add @aglyn/plugins-workflows`、`yarn add @aglyn/plugins-workflows`、`bun add @aglyn/plugins-workflows`

## README

# @aglyn/ plugins- 工作流程

自动化插件: 控制台 **自动化** 第1款—— 工作流程、动作和Webhooks——以及运行在那里建造的引擎.

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```bash
npm install @aglyn/plugins-workflows
```

通过 Aglyn 的插件管理器装入插件( A)`@aglyn/aglyn`由控制台和租户运行时间组成;它不是一个独立的图书馆.

## 发动机

`src/lib/engine/` 持有自动化引擎, 此插件外没有其它 运行自动化 :

-   `workflow-steps.ts` 一个步骤模范。 存储步骤是函数 调用或动作步骤,由 `type`没有移动。 还有 持有一个工作流程可运行的动作步骤(每个服务器侧一) 其余的拒绝, 验证两个编辑使用。 纯和 客户端安全:控制台的阶下编辑器也读取.
-   `run-event-workflows.ts` 财务报告和审定财务报表 `run-event-actions.ts` - 跑者们 一个主机 活动运行它所触发的工作流程和倾听它的行动; 现场活动发送运行一个动作 一个已发布的页面被发射.
-   `run-event-actions.ts` 还持有步骤执行者——电子邮件、网络呼号、, 列表、运动、警告、自定义事件——以及流程步骤 `runServerStep`,一步一步,这就是让一个工作流程运行 a 动作步骤,没有其中任何一个的第二副本。 写一个步骤 另一个插件的记录——一个数据集行,一个联系人的阶段——被交给了 在服务器步骤接合上注册的插件执行器 (单位:千美元)`plugin-server-steps`) (中文(简体) ). 内容 `executeWorkflow` 是工作流程的一半 : 函数通过纯评价器调用 执行者,在一个范围.
-   `flow-enrollments.ts` ——一个人在流动的一步之间等待和 下一个,由 `resume-flow-waits` 任务。 一个工作流程的入学编号 和动作分开 所以两种类型永远不能共享.

跑步是一次被承认的.. `workflowRunsPerMonth` (单位:千美元) 工作流程, `actionRunsPerMonth` 行动——无论采取什么步骤. 行动层的门 一步一步地在它里面.

引擎通过租户运行时的宿主-活动接合听到事件 (单位:千美元)`@aglyn/tenant-runtime/host-event-listeners`) (中文(简体) ). 听者注册于 `registerWorkflowsServerDeclarations` (单位:千美元)`declarations.server.ts`)),两者兼有 应用程序从生成的服务器声明列表中启动调用,并再次 由插件的 API 寄存器函数。 宣言是轻:引擎 本身在第一个事件到达时或插件的 API 时导入 表面负载.

同一声明公布了网站的记录索引 `workflow`, (中文(简体) ), `webhook` 财务报告和审定财务报表 `action` 记录`server/automation-record-index.ts`因此 AI 插件读取时未达到此插件的收藏, a 依赖源( e)`server/workflow-dependents.ts`回答控制台的 "被"扫描 与工作流程调用函数。 阅读器装入 初读. 取决于工作流程——它计算出来的变量——是: 逻辑插件的回答;自动化页面询问相同的扫描.

指定工作流程的站点变量在页面时会占用该工作流程的结果 组成(AGL-129)。 相同的声明注册此插件的变量 电脑在核心 `computed-variables` 接缝( 接缝)`server/workflow-variables.ts`: 编曲管道开始 在另一页读取,读取 站点的工作流程在站点渲染缓存标签下,它用 工作流程构建器模型 `model/workflows.ts`。工作流程为 丢失或失败保存其存储值.

动作是站点互动( :`@aglyn/aglyn/app-utils/site-interactions`, (中文(简体) ), 平台的:触发器、条件、客户端步骤、验证) 添加此插件的服务器步骤 。 这个 `runWorkflow` 步骤在 `interactionSteps` 内 `plugins.config.json`因此,签名人的互动 构建者提供它,并列出网站的工作流程而不命名此插件. 触发的事件是平台的(`app-utils/host-events`: 页面视图是核心本身的,所有其他事件都在下面声明 `hostEvents` 以门把它升起的插件盟誓, 只有引擎读的 是这个插件的: 运行历史的过去语句 (单位:千美元)`model/step-outcomes.ts`),一个被存储的 Webhook 形状及其 URL 守护 (单位:千美元)`model/webhooks.ts`)和事件链深度(`model/workflows.ts`) (中文(简体) ). 这个 自动化词汇表——服务器步骤的形状,流量的界限和每个 服务器步骤的检查——这个插件也是( )`model/host-actions.ts`) (中文(简体) ). 这个 不装入此件而写入自动化的插件通过核心满足 接合:每个步骤的名称、控件和打入的字段在 `interactionSteps` 内 `plugins.config.json`; 支票从 这个插件 `declarations` 条目(`interaction-step-checks`因此,一个食谱 CRM 安装或AI 等级草稿被拒绝, 因为编辑会拒绝 它;存储的形状和访客页面收到的切片是核心的 (单位:千美元)`site-interactions`)),并且通过 `automation` 资源草稿`server-automation-drafts.ts`) (中文(简体) ).

## 入境点

-   `.` ——控制台扩展(导航,自动化页面,活性部件).
-   `./server` ——租户和操纵台API浮出水面:入住的Webhook 流程恢复工作、自动化草稿、org自动化门和 动作卡测试运行( O)`automations/actions/test-run`,仅控制台 -- 页面运行时间 `events/dispatch` 租户路线.
-   `./declarations` 服务器步骤的检查,在应用程序和 在任何表面负载之前,控制台的浏览器.
-   `./declarations.server` 上面的靴子注册.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/plugins/workflows 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/aglyn/aglyn/tree/main/libs/plugins/workflows)

## 常见问题

### @aglyn/plugins-workflows 是什么？

自动化插件: 控制台 自动化 部分——工作流,动作和Webhooks,以及运行在那里构建的引擎\.

### 如何安装 @aglyn/plugins-workflows？

在项目目录运行 npm install @aglyn/plugins-workflows，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（^16\.3\.3）、react（^19\.2\.8）、firebase（^13\.0\.0）、@mui/material（^9\.3\.1）、firebase-admin（^14\.3\.0）、@mui/x-data-grid（^9\.12\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/plugins-workflows 支持 TypeScript 吗？

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

### @aglyn/plugins-workflows 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-workflows 可以商用吗？

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

### @aglyn/plugins-workflows 的下载量有多少？

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

### @aglyn/plugins-workflows 还在维护吗？

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