# eve-fit-engine 中文文档

规范地址：https://npmcn.com/package/eve-fit-engine/

版本：0\.2\.20
npm 元数据更新时间：2026-11-03T12:43:59.246Z
中文译文更新时间：2026-11-03T15:14:52.209Z
软件包许可：GPL-3\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/eve-fit-engine
原文对照：https://npmcn.com/package/eve-fit-engine/?lang=original
项目主页：https://github.com/capsuleers-app/capsuleers.fitting-engine
源码仓库：https://github.com/capsuleers-app/capsuleers.fitting-engine

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

- 包体积（解压后）：9.8 MB，37 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-06-01T20:27:55.369Z
- 最新版本发布：2026-11-03T12:43:59.075Z
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

Pyfa-parity EVE Online船舶与结构装配计算引擎。注入一个SDE数据集+一个匹配，获得完整的派生属性块（进攻，防御，电容，导航，瞄准，匹配，投影，结构）。

## 安装

```sh
npm install eve-fit-engine
```

也可以使用：`pnpm add eve-fit-engine`、`yarn add eve-fit-engine`、`bun add eve-fit-engine`

## README

![Capsuleers emblem](https://raw.githubusercontent.com/capsuleers-app/capsuleers.fitting-engine/master/docs/brand/emblem.svg)

# eve-fit-engine

一个 **Pyfa-parity** EVE在线船舶&上井结构装配计算引擎 提取 [capsuleers.app](https://capsuleers.app/)。打了个盹，上了SDE 数据集，它返回您在拟合工具中看到的完整派生的统计块： 进攻（DPS / alpha /应用），防御（EHP /抵抗/坦克），电容器 （稳定/ sim），导航，瞄准，拟合（CPU / PG /校准）， 预计效果和结构燃料/服务统计。

> **执照:gpl - 3.0 -或-。** 这台热机是…的导数 [pyfa-org Pyfa](https://github.com/pyfa-org/Pyfa) 分布在 相同的条款。看到 [`NOTICE`](https://npmcn.com/package/eve-fit-engine/NOTICE) 和 [`LICENSE`](https://npmcn.com/package/eve-fit-engine/LICENSE)。完整的 相应的源是这个存储库。

## 设计

-   **Framework-free核心。** 基本项没有 `fetch`,没有 `fs`,没有 `window`， 没有NPM运行时深度。运行在浏览器、Node、worker中——任何地方。
-   **两个条目。** 基地(`.`)：注射自己的 `FittingDataset`。节点(`./node`）： 包括电池在内，捆绑了EVE SDE的快照(在CCP的许可下，由 （聚合）+ fs加载器，因此它可以在服务器上开箱即用。
-   **通过两种方式验证Pyfa。**
    -   **夹具套件** - - - - - - `npm run test:pyfa`： 662个手工策划的断言 Pyfa截图，全v技能，零容忍覆盖。这是 释放闸门和发动机的正确性接地真相。
    -   **微分利用** - - - - - - `npm run diff`：生成4适合 _每一个_ 出版了一艘船，并将每一项数据与无头船进行比较 **pyfa-org Pyfa** oracle。1662/1676匹配度（99.2%）完全匹配；残差是一个文档 一组pyfa浮动/建模/每艘船的怪癖(见 [`test/diff/known-diffs.mjs`](https://npmcn.com/package/eve-fit-engine/test/diff/known-diffs.mjs)）. 否时退出0 _意想不到的_ 差别; `--strict` 将接受的集合重新列为失败。

## 安装

```bash
npm install eve-fit-engine
```

## 使用-零配置（Node，包括电池）

这个 `/node` 带有EVE SDE捆绑包的入口船(`data/`（约8mb）和一个内置的 加载程序。给它一个EFT字符串，获得完整的统计数据-没有其他设置：

```ts
import { computeFromEft } from 'eve-fit-engine/node'

const { fit, warnings, computed } = await computeFromEft(`
[Rifter, My Fit]
200mm AutoCannon II, Republic Fleet EMP S
200mm AutoCannon II, Republic Fleet EMP S
1MN Afterburner II
Gyrostabilizer II
`)

console.log(computed.derived.offense.totalDps)              // 197.6
console.log(computed.derived.defense.ehpTotalAgainstProfile)
console.log(computed.derived.navigation.maxVelocity)
```

默认为All-V技能；通过 `{ skillProfile, damageProfile, targetProfile, … }` 作为第二个要推翻的参数。 `loadBundledDataset()` 是不是也出口了 直接需要数据集。

> 捆绑的SDE是CCP的，根据CCP的《EVE Online》开发者许可 [`data/SDE-LICENSE.md`](https://npmcn.com/package/eve-fit-engine/data/SDE-LICENSE.md)) -仅通过汇总， 不在本包的GPL下。

## 使用-自带数据集（浏览器/自定义/ always-fresh SDE）

基本条目与环境无关(没有 `fs`，没有捆绑数据)。注入 `FittingDataset` 你可以随心所欲地建造：

```ts
import { computeFit, parseEft, type FittingDataset } from 'eve-fit-engine'

const dataset: FittingDataset = await buildYourDataset()   // your SDE bundle
const { fit } = parseEft(eftText, dataset)
const computed = computeFit(fit, dataset, { skillProfile /* … */ })
```

这就是胶囊。应用程序使用服务器端：它构建自己的always-fresh 绑定并注入它，所以它永远不会依赖于（快照）绑定的数据。

## 这个包裹里没有什么

-   3D船舶模型、UI组件——这些都存在于消费应用程序中。
-   捆绑的SDE是一个 **快照**;对于总是新鲜的数据，注入你自己的通道 基本条目（见上文）。

## 来源/如何维持平价

这款引擎模仿了Pyfa的引擎 `eos` 计算模型：由EVE键控的效果处理器 教条效应id，堆叠惩罚池，运行后阻力适应 通过，一个离散电容模拟（忠实端口的） `eos/capSim.py` - - - - - - 整数周期时间，炮塔齐射vs交错排水，帽助推器注入)， 和卷轴处理。当CCP发布一个新的SDE时，数据驱动的 `modifierInfo` 效果自动工作；Pyfa的新硬编码机制 `effects.py` 是 跟踪和移植，然后重新检查 **两个** 夹具套件 （`npm run test:pyfa`)和单船差分线束(`npm run diff`） 之前释放。看到 [`MAINTENANCE.md`](https://npmcn.com/package/eve-fit-engine/MAINTENANCE.md) 用于更新流。

发布遵循两条CI路径，都是基于奇偶校验+覆盖：每日 **SDE-bundle刷新** 当CCP的数据发生变化和奇偶校验时自动发布补丁 保持绿色(`sde-refresh` 工作流),而 **\-代码修复** 通过手册发货 `workflow_dispatch` 释放（引擎改变不碰） `data/`，所以他们从不 触发数据路径)。看到 [`RELEASE.md`](https://npmcn.com/package/eve-fit-engine/RELEASE.md)。

## 贡献

看到 [`CONTRIBUTING.md`](https://npmcn.com/package/eve-fit-engine/CONTRIBUTING.md) -安装的分步指南； 每个内部命令，两个验证套件(`npm run test:pyfa` + `npm run diff`)，如何添加夹具/端口效果，pyfa-pin重新校准 心流，以及项目的硬性规则。

## 执照

gpl - 3.0 -或-。版权所有：2026 Capsuleers.app这是自由软件；看到 [`LICENSE`](https://npmcn.com/package/eve-fit-engine/LICENSE) 获取详细信息。

## 常见问题

### eve-fit-engine 是什么？

Pyfa-parity EVE Online船舶与结构装配计算引擎。注入一个SDE数据集\+一个匹配，获得完整的派生属性块（进攻，防御，电容，导航，瞄准，匹配，投影，结构）。

### 如何安装 eve-fit-engine？

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

### eve-fit-engine 支持 TypeScript 吗？

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

### eve-fit-engine 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### eve-fit-engine 需要什么版本的 Node\.js？

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

### eve-fit-engine 可以商用吗？

eve-fit-engine 使用 GPL-3\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### eve-fit-engine 还在维护吗？

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