# @gorules/zen-engine 中文文档

规范地址：https://npmcn.com/package/%40gorules/zen-engine/

版本：2\.1\.11
npm 元数据更新时间：2026-11-12T07:22:54.552Z
中文译文更新时间：2026-11-16T20:19:35.585Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：81.2 kB，8 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 14
- 运行依赖：8 个
- 首次发布：2023-04-03T05:54:15.171Z
- 最新版本发布：2026-11-12T07:22:54.336Z
- 近 30 天下载量：630226（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：128（近 12 个月 42 个）

## 中文简介

由 Rust 提供动力的 Node.js 开源商业规则引擎

## 安装

```sh
npm install @gorules/zen-engine
```

也可以使用：`pnpm add @gorules/zen-engine`、`yarn add @gorules/zen-engine`、`bun add @gorules/zen-engine`

## README

# Node.js 规则引擎

**商业逻辑 人类可以阅读,机器可以运行.** 一份你的规则: 主人读它, 每个系统运行它.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![npm](https://img.shields.io/npm/v/@gorules/zen-engine.svg)](https://www.npmjs.com/package/@gorules/zen-engine)

![GoRules ZEN Engine](https://raw.githubusercontent.com/gorules/zen/master/.github/images/hero.png)

ZEN引擎是一个跨平台的开源 [商业规则引擎(BRE)](https://gorules.io/) 写入 **锈** 有本地语言 **节点.js** 绑定,与Python,Go,Java,克特林和.NET并列. 决定以微秒计评,在每个平台上运行相同,并被存储为便携式JSON. 装入JSON取决于您:文件系统,数据库或服务呼叫.

试试免费的 [在线编辑器](https://editor.gorules.io/) 内置模拟器,或嵌入开源反应 [JDM 编辑器](https://github.com/gorules/jdm-editor) 在你自己的产品。 学习更多关于 [节点.js 规则引擎](https://gorules.io/open-source/javascript-rules-engine) 在Go Rules网站上.

## 类似句子的规则

在ZEN表达语言中, 开发者视图是一取而去的,两者永远无法分道扬镳:只有一取出真相的来源,而这个引擎运行它.

![Readable rules](https://raw.githubusercontent.com/gorules/zen/master/.github/images/tables.png)

## 规则作为图表或文件

模拟关于决定表、开关、表达式、功能和可重复使用的子决定的可视画布的决定。 或将它写成政策文件,并附有散文,打出的数据模型和表格. 两者都编译到同一引擎并返回相同的答案.

![Graphs and documents](https://raw.githubusercontent.com/gorules/zen/master/.github/images/graphs-docs.png)

更深一点,看看 [SDK 文档](https://docs.gorules.io/developers/sdks/nodejs),则 [决策图表指南](https://docs.gorules.io/learn/authoring/decision-graphs) 编辑 [ZEN 表达语言](https://docs.gorules.io/learn/zen-language/syntax) 参考文献.

## 2.0里有什么新鲜事

2.0版本是新引擎行的首次稳定发布:

-   **政策文件**: 示范决定作为可读文件,有打出的数据模型,表达式,决定表,匹配块和断言. 政策汇编到与图表相同的引擎并返回相同的答案.
-   **工作空间分析**:在政策和图表之间进行静态类型检查。 类型流出,详尽无遗的检查,写出-冲突检测和精确的诊断,在任何东西运行之前都可用.
-   **每栏收集**:决定表输出列可以在所有匹配行中收集(`tags[]`),而其余的表会保持一对.
-   **预编译引擎**:一经装入就解析和汇编决定;评价是分配轻而易举和可避免重复的.
-   **硬化运行时间**:超出范围的数字,算术外溢和输入错误返回错误或无效,而不是崩溃进程.
-   **统一约束**:可配置装填器,批量评价和贯穿Node.js,Python,Go和FFI消费者的一致出错信封.

## 安装

```bash
npm i @gorules/zen-engine
```

Linux (gnu and musl), macOS, Windows and WASM (WASI) 的预建二进制船; 不需要 Rust工具链 .

## 快速启动

```typescript
import { ZenEngine } from '@gorules/zen-engine';
import fs from 'fs/promises';

const content = await fs.readFile('./jdm_graph.json');
const engine = new ZenEngine();

const decision = engine.createDecision(content);
const result = await decision.evaluate({ input: 15 });
console.log(result);
```

### 装入器

对于更先进的使用案例,如果您想要加载多个决定并在整个评价中重复使用,您可以构建加载器. 何时 `engine.evaluate` 它被引用为带有密钥的加载器,以等待 JDM 决定图的内容作为回报.

```typescript
import { ZenEngine } from '@gorules/zen-engine';
import fs from 'fs/promises';
import path from 'path';

const loader = async (key: string) => fs.readFile(path.join(import.meta.dirname, 'jdm_directory', key));

const engine = new ZenEngine({ loader });
const result = await engine.evaluate('jdm_graph1.json', { input: 5 });
console.log(result);
```

同样的图案从一个REST API,S3,一个数据库或其他任何地方加载都有效. 完整的指南,包括多决定图和批量评价,都载于 [SDK 文档](https://docs.gorules.io/developers/sdks/nodejs)。 。 。 .

## 其他平台

-   **节点.js** - 说吧 [GitHub 图像](https://github.com/gorules/zen/tree/master/bindings/nodejs) | [文档](https://docs.gorules.io/developers/sdks/nodejs) | [无](https://www.npmjs.com/package/@gorules/zen-engine)
-   **蟒** - 说吧 [GitHub 图像](https://github.com/gorules/zen/tree/master/bindings/python) | [文档](https://docs.gorules.io/developers/sdks/python) | [PyPI 密码](https://pypi.org/project/zen-engine/)
-   **走开** - 说吧 [GitHub 图像](https://github.com/gorules/zen-go) | [文档](https://docs.gorules.io/developers/sdks/go)
-   **爪哇语 / Kotlin** - 说吧 [GitHub 图像](https://github.com/gorules/zen/tree/master/bindings/uniffi) | [文档](https://docs.gorules.io/developers/sdks/java) | [马文中心](https://mvnrepository.com/artifact/io.gorules/zen-engine)
-   **. NET 网络** - 说吧 [GitHub 图像](https://github.com/gorules/zen/tree/master/bindings/uniffi) | [文档](https://docs.gorules.io/developers/sdks/csharp) | [新建](https://www.nuget.org/packages/GoRules.ZenEngine)
-   **锈( 核心)** - 说吧 [GitHub 图像](https://github.com/gorules/zen) | [文档](https://docs.gorules.io/developers/sdks/rust) | [货箱.io](https://crates.io/crates/zen-engine)

## Go 规则平台

发动机在核心位置打开; [前进规则](https://gorules.io/) 是周围的平台。 管理云,自我托管,或嵌入 没有网络跳。 SOC 2 二类.

### 建立规则的AI, 并且可以审查

一个AI副驾驶和MCP服务器,用于编辑规则,运行测试并解释决定. 它从来没有部署。 释放与你的审查者.

![GoRules AI](https://raw.githubusercontent.com/gorules/zen/master/.github/images/ai.png)

### 推广像发布,运行像二进制

释放从测试到中转到生产。 批准,即时回滚,以及每变一出的文件线索.

![Governance](https://raw.githubusercontent.com/gorules/zen/master/.github/images/governance.png)

### 在船前证明一下

假设套件在每一个变化上运行,覆盖度根据决定路径来衡量,每个答案都带有可回放的痕迹.

![Testing](https://raw.githubusercontent.com/gorules/zen/master/.github/images/tests.png)

## 支持矩阵

| 拱门 | 节点.js |
| :-- | :-- |
| linux-x64-克努 | : 重度 检查 标记 : |
| linux- arm64- gnu 系统 | : 重度 检查 标记 : |
| 达尔文-x64 | : 重度 检查 标记 : |
| darwin-arm64 (英语) | : 重度 检查 标记 : |
| win32-x64-msvc (韩语) | : 重度 检查 标记 : |
| linux- x64- musl (韩语) | : 重度 检查 标记 : |
| linux- arm64- musl (英语) | : 重度 检查 标记 : |
| 原32 (WASI) | : 重度 检查 标记 : |

## 捐款

JDM标准不断提高,我们需要严格控制其开发和路线图,因为一些公司使用Go Rules ZEN引擎和Go Rules BRMS. 由于这个原因,我们目前不能接受代码贡献,除了帮助文档和额外的测试.

## 许可证

[MIT 许可证](https://opensource.org/licenses/MIT)

## 常见问题

### @gorules/zen-engine 是什么？

由 Rust 提供动力的 Node\.js 开源商业规则引擎

### 如何安装 @gorules/zen-engine？

在项目目录运行 npm install @gorules/zen-engine，或使用 pnpm add / yarn add / bun add。

### @gorules/zen-engine 支持 TypeScript 吗？

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

### @gorules/zen-engine 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @gorules/zen-engine 需要什么版本的 Node\.js？

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

### @gorules/zen-engine 可以商用吗？

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

### @gorules/zen-engine 的下载量有多少？

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

### @gorules/zen-engine 还在维护吗？

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

