# @cortex-js/compute-engine 中文文档

规范地址：https://npmcn.com/package/%40cortex-js/compute-engine/

版本：0\.186\.0
npm 元数据更新时间：2026-11-10T17:04:48.985Z
中文译文更新时间：2026-11-10T19:51:22.318Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：28.5 MB，741 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26\.13\.0
- 运行依赖：2 个
- 首次发布：2021-06-21T16:25:12.571Z
- 最新版本发布：2026-11-10T17:04:48.755Z
- 近 30 天下载量：1336680（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：281（近 12 个月 230 个）

## 中文简介

JavaScript 和 Node.js 的符号计算和数字评价

## 安装

```sh
npm install @cortex-js/compute-engine
```

也可以使用：`pnpm add @cortex-js/compute-engine`、`yarn add @cortex-js/compute-engine`、`bun add @cortex-js/compute-engine`

## README

![math live](https://npmcn.com/package/%40cortex-js/compute-engine/assets/compute-engine.jpg?raw=true)

### **计算引擎**

# MathJSON 表达式的符号操纵和数值评价

[数学杰森](https://cortexjs.io/math-json/) 是一个轻量级数学 基于JSON的标记交换格式.

计算引擎可以将 LaTeX 解析为 MathJSON, 序列化 MathJSON 为 LaTeX或MathASCII,格式化,简化并评价了MathJSON表达式.

参考文件和指南 [皮层活性/计算引擎](https://cortexjs.io/compute-engine/)。 。 。 .

[![](https://dcbadge.vercel.app/api/server/yhmvVeJ4Hd)](https://discord.gg/yhmvVeJ4Hd)

## 安装

```bash
$ npm install --save @cortex-js/compute-engine
```

## 快速启动

### 基本分析和评价

不需要设置 :

```js
import { simplify, evaluate, N, assign } from "@cortex-js/compute-engine";

simplify("x + x + 1").print();
// ➔ 2x + 1

evaluate("2^{11} - 1").print();
// ➔ 2047

N("\\sqrt{2}").print();
// ➔ 1.414213562...

assign("x", 3);
evaluate("x + 2").print();
// ➔ 5
```

这些函数使用共享 `ComputeEngine` 第一次使用时创建的实例。 使用 `getDefaultEngine()` 来配置它,或者为孤立创建自己的实例 配置.

### 数字工作( Type- Safe)

使用类型守护器安全访问专门属性 :

```js
import { evaluate, isNumber } from "@cortex-js/compute-engine";

const expr = evaluate("\\frac{5}{2}");

if (isNumber(expr)) {
  console.log(expr.numericValue);  // 2.5 (type-safe access)
  console.log(expr.isInteger);     // false
}
```

### 使用符号工作

```js
import { parse, isSymbol, sym } from "@cortex-js/compute-engine";

const expr = parse("x + 1");

// Check if expression is a specific symbol
if (sym(expr) === "x") {
  console.log("This is the variable x");
}

// Or use full type guard for more access
const variable = parse("y");
if (isSymbol(variable)) {
  console.log(variable.symbol);  // "y"
}
```

### 从事职能

```js
import { parse, isFunction } from "@cortex-js/compute-engine";

const expr = parse("2x + 3y");

// Access function structure safely
if (isFunction(expr)) {
  console.log(expr.operator);    // "Add"
  console.log(expr.ops.length);  // 2

  // Iterate over operands
  for (const op of expr.ops) {
    console.log(op.toString());
  }
}
```

### 简化和操纵

```js
import { parse, simplify, expand } from "@cortex-js/compute-engine";

// Simplify expressions
simplify("x + x").print();
// ➔ 2x

// Expand from LaTeX or Expression
expand("(x + 1)^2").print();
// ➔ x^2 + 2x + 1

// Substitute values
const expr = parse("x^2 + 2x + 1");
expr.subs({ x: 3 }).evaluate().print();
// ➔ 16
```

### 解决方程式

```js
import { solve, parse } from "@cortex-js/compute-engine";

// Solve from LaTeX
solve("x^2 - 5x + 6 = 0", "x");
// ➔ [2, 3]

// Solve a linear system
const system = parse("\\begin{cases}x+y=5\\\\x-y=1\\end{cases}");
const solution = system.solve(["x", "y"]);

console.log(solution.x.json);  // 3
console.log(solution.y.json);  // 2
```

### Epsil 语言( 实验)

Epsil是科学计算的一种文本语法编程语言 中间代表为由计算引擎评估的MathJSON. 这个 以船舶为独立者, **实验** 切入点(语法和语义可能 释放之间的变化:

```js
import { ComputeEngine, executeEpsil } from "@cortex-js/compute-engine/epsil";

const ce = new ComputeEngine();
const { value } = executeEpsil(ce, `
  let x = 1/2
  if (x < 1) { x + 1 } else { 0 }
`);
// value.toString() ➔ "3/2"
```

见 [Epsil 语言文件](https://cortexjs.io/epsil/)。 。 。 .

#### Epsil CLI 和 REPL 软件

该软件包还安装了 `epsil` 命令 :

```sh
# Start an interactive session
npx epsil

# Evaluate source text or a file
npx epsil -e 'Simplify(2 + 2x)'
npx epsil program.epsil

# Epsil programs can also be piped over stdin
printf '1/2 + 1' | npx epsil
```

互动会话保留投入与支持之间的声明 持续历史,多行输入, `.load`, (中文(简体) ), `.clear`, (中文(简体) ), `.ast`,以及 `.time`运行 `epsil --help` 用于输出格式和执行限制选项.

#### MCP AI 助理服务器

这个 `epsil` 命令包括 a [示范背景协议](https://modelcontextprotocol.io/) 服务器,所以是AI 助手可以评价 Epsil 程序——精确的算术和符号 作为工具调用进行计算。 例如,与克洛德代码:

```sh
claude mcp add epsil -- npx -y @cortex-js/compute-engine mcp
```

服务器曝光 `evaluate`, (中文(简体) ), `check`, (中文(简体) ), `doc`, (中文(简体) ), `parse`,以及 `serialize` 工具, 并服务机器验证卡 这样助理可以学习Epsil,和 自行计算引擎JavaScript API. 它还有本地流式HTTP运输,用于ChatGPT和其他 基于 URL 客户端 :

```sh
npx -y @cortex-js/compute-engine mcp --transport streamable-http
```

见 [MCP 服务器指南](https://cortexjs.io/epsil/mcp/) 用于 ChatGPT 设置 和 HTTPS 部署选项.

**\* 最佳做法:**

-   总是使用类型守护( N)`isNumber`, (中文(简体) ), `isSymbol`, (中文(简体) ), `isFunction`在访问之前 专门属性
-   使用 `sym()` 快速符号名称检查的助手

**更多学习:** [完整文件和指南](https://cortexjs.io/compute-engine/)

## 财务问题

**Q 问** 我怎么建项目?

[构建](https://npmcn.com/package/%40cortex-js/compute-engine/BUILD.md) 指令

**Q 问** 项目的结构如何?

见 [四、建 议](https://npmcn.com/package/%40cortex-js/compute-engine/ARCHITECTURE.md) 对于代码库的概览.

## 相关项目

[数学杰森](https://cortexjs.io/math-json/)

轻量级数学标记交换格式

[数学生活](https://cortexjs.io/mathlive) 联 合 国 [GitHub 图像](https://github.com/arnog/mathlive)(中文(简体) )

用于数学输入的 Web 组件 .

## 支持项目

-   🌟 Star the GitHub repo (这真的有帮助)
-   💬 问问题和反馈我们 [讨论论坛](https://cortexjs.io/forum/)
-   📨 丢出一行到 [阿尔诺@arno.org](mailto:arno@arno.org)

## 许可证

本项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40cortex-js/compute-engine/LICENSE)。 。 。 .

## 常见问题

### @cortex-js/compute-engine 是什么？

JavaScript 和 Node\.js 的符号计算和数字评价

### 如何安装 @cortex-js/compute-engine？

在项目目录运行 npm install @cortex-js/compute-engine，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 epsil，可以用 npx epsil 直接运行。

### @cortex-js/compute-engine 支持 TypeScript 吗？

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

### @cortex-js/compute-engine 支持 ESM 还是 CommonJS？

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

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

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

### @cortex-js/compute-engine 可以商用吗？

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

### @cortex-js/compute-engine 的下载量有多少？

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

### @cortex-js/compute-engine 还在维护吗？

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