@gorules/zen-engine

中文文档
2.1.11发布于 2026/11/12MITTypeScriptCommonJS近 30 天下载 63万

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

中文使用文档
文档目录14 节
  1. 类似句子的规则
  2. 规则作为图表或文件
  3. 2.0里有什么新鲜事
  4. 安装
  5. 快速启动
  6. 装入器
  7. 其他平台
  8. Go 规则平台
  9. 建立规则的AI, 并且可以审查
  10. 推广像发布,运行像二进制
  11. 在船前证明一下
  12. 支持矩阵
  13. 捐款
  14. 许可证

Node.js 规则引擎

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

License: MIT npm

GoRules ZEN Engine

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

试试免费的 在线编辑器 内置模拟器,或嵌入开源反应 JDM 编辑器 在你自己的产品。 学习更多关于 节点.js 规则引擎 在Go Rules网站上.

类似句子的规则

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

Readable rules

规则作为图表或文件

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

Graphs and documents

更深一点,看看 SDK 文档,则 决策图表指南 编辑 ZEN 表达语言 参考文献.

2.0里有什么新鲜事

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

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

安装

npm i @gorules/zen-engine

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

快速启动

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 决定图的内容作为回报.

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 文档。 。 。 .

其他平台

Go 规则平台

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

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

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

GoRules AI

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

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

Governance

在船前证明一下

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

Testing

支持矩阵

拱门节点.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 许可证

版本与发布记录

@gorules/zen-engine 共发布 128 个版本,首次发布于 2023/04/03;过去 12 个月发布了 42 个版本。

版本发布日期距今
2.1.11latest2026/11/124 天前
2.1.102026/11/106 天前
2.1.92026/10/2226 天前
2.1.82026/10/2127 天前
2.1.72026/10/141 个月前
2.1.62026/10/131 个月前

其他发布通道:beta → 1.0.0-beta.14。

关于 @gorules/zen-engine 的常见问题

@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 和提交记录判断。