# @evomap/gep-sdk 中文文档

规范地址：https://npmcn.com/package/%40evomap/gep-sdk/

版本：1\.14\.0
npm 元数据更新时间：2026-09-11T02:39:22.252Z
中文译文更新时间：2026-11-14T02:38:39.246Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40evomap/gep-sdk
原文对照：https://npmcn.com/package/%40evomap/gep-sdk/?lang=original
项目主页：https://github.com/EvoMap/gep-sdk-js#readme
源码仓库：https://github.com/EvoMap/gep-sdk-js

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

- 包体积（解压后）：109 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-03-13T06:14:25.005Z
- 最新版本发布：2026-09-11T02:39:22.015Z
- 近 30 天下载量：30457（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

基因组进化协议(GEP)的单一真理源:JSON Schemas,规格,和协议级的帮助者(cannication / computeAssetId / 校验AssetId).

## 安装

```sh
npm install @evomap/gep-sdk
```

也可以使用：`pnpm add @evomap/gep-sdk`、`yarn add @evomap/gep-sdk`、`bun add @evomap/gep-sdk`

## README

# @evomap/gep-sdk (英语)

唯一的真相来源 **基因组进化协议(GEP)**贾森 Schemas, 人可读的规格, 和协议级的助手 下游执行需要商定 `asset_id` 数值 运行时间.

这个包裹是故意的 **无算法代码**选择, 信号提取、基因评分和其余演化行为 以具体实施方式生活`@evomap/evolver`, (中文(简体) ), `@evomap/gep-mcp-server`牛皮地铁箱。 他们消耗 计程车和帮手运过来 撞出一块田地 `schemas/gene.schema.json` 宣传《公约》的每项执行 锁起脚步——而不是悄悄地走在四个手持地上 副本.

## 包裹里有什么

| 路径 | 目录 |
| --- | --- |
| `schemas/gene.schema.json` | 基因资产计划(JSON Schema草案) |
| `schemas/capsule.schema.json` | Capsule 资产计划 |
| `schemas/evolution-event.schema.json` | 进化事件资产计划 |
| `schemas/mutation.schema.json` | 变异资产计划a |
| `schemas/task.schema.json` | 任务资产计划a(内部工作项目) |
| `spec/gep-spec-v1.md` | 协议的完整规格 |
| `src/contentHash.js` | `SCHEMA_VERSION`, (中文(简体) ), `canonicalize`, (中文(简体) ), `computeAssetId`, (中文(简体) ), `verifyAssetId` |
| `src/protocolConstants.js` | 共享协议条目,例如 `GEP_GENE_CATEGORIES`, (中文(简体) ), `GEP_OUTCOME_STATUSES`,以及 `GEP_EVIDENCE_MODES` |
| `src/capsuleEvidence.js` | 纯遗留/ 仅引用 Capsule 分类器和证据散列验证器 |

## 安装

```bash
npm install @evomap/gep-sdk
```

## 用作计划来源

```javascript
import geneSchema from '@evomap/gep-sdk/schemas/gene.schema.json' with { type: 'json' };
import { SCHEMA_VERSION, GEP_GENE_CATEGORIES } from '@evomap/gep-sdk';
// or: import { canonicalize, computeAssetId } from '@evomap/gep-sdk/content-hash';
```

Rust / 非 JS 消费者可以通过包解析相同的文件 磁盘(例如). `node_modules/@evomap/gep-sdk/schemas/gene.schema.json`(中文(简体) ) 并把它们输入一个代码生成器,比如: `typify`。 。 。 .

## 使用资产标识助手

```javascript
import { SCHEMA_VERSION, computeAssetId, verifyAssetId } from '@evomap/gep-sdk';

const gene = {
  type: 'Gene',
  schema_version: SCHEMA_VERSION,
  id: 'gene_repair_from_errors',
  category: 'repair',
  signals_match: ['log_error'],
  strategy: ['Inspect logs', 'Apply fix', 'Re-run validation'],
  constraints: { max_files: 20, forbidden_paths: ['.git', 'node_modules'] },
  validation: ['npm test'],
};
gene.asset_id = computeAssetId(gene);

verifyAssetId(gene); // true
```

`canonicalize` 生产确定性JSON(各级按键, 非无限数字和 `undefined` 被胁迫 `null`(三); `computeAssetId` 将 SHA-256 应用到条形和前缀 `sha256:`。 。 。 .

## 稳定

| 表面 | 稳定 |
| --- | --- |
| 司马斯( S)`schemas/*.schema.json`(中文(简体) ) | `@stable` · 添加剂小起落;破损变化需要主要版本 |
| 规格`spec/gep-spec-v1.md`(中文(简体) ) | `@stable` |
| `SCHEMA_VERSION`, (中文(简体) ), `canonicalize`, (中文(简体) ), `computeAssetId`, (中文(简体) ), `verifyAssetId` | `@stable` |
| 协议常数( O)`GEP_*`(中文(简体) ) | `@stable` ——与所发运的"计划"相锁 |

以上未列出的,均不属于本包.

## 从1.1.x迁移

`@evomap/gep-sdk@1.1.0` 曝光选择 / 信号取出 / 内存-图 / 资产存储助手( e)`selectGene`, (中文(简体) ), `extractSignals`, (中文(简体) ), `MemoryGraph`, (中文(简体) ), `AssetStore`(中文(简体) ). 这些模块已删除 **1.2.0 (中文(简体) )** 因为他们将协议套件与执行合并 行为。 如果你依赖其中任何一个:

-   **使用 `@evomap/evolver`** 完全的自我进取引擎.
-   **使用 `@evomap/gep-mcp-server`** 暴露进化为 MCP 工具.
-   临时项目 _痷_ 需要JS算法代码 针 `@evomap/gep-sdk@1.1.0`。释放线将不会收到新的 特性,只有关键修正.

## 所需资源

-   节点.js 18.0.0
-   零运行时间依赖关系

## 相关

-   [@ evomap/ evolver (帮助)](https://github.com/EvoMap/evolver) ——自演动引擎
-   [@evomap/gep-mcp-服务器](https://github.com/EvoMap/gep-mcp-server) ——MCP服务器曝光GEP工具
-   [埃沃地图](https://evomap.ai/) ——代理进化网络

## 捐款

欢迎拉动请求。 所有贡献者必须签字 [个人法律援助中心](https://npmcn.com/package/%40evomap/gep-sdk/CLA/ICLA.md) (或 [CLA 公司](https://npmcn.com/package/%40evomap/gep-sdk/CLA/CCLA.md)(中文(简体) ) 合并前 - 见 [捐款额](https://npmcn.com/package/%40evomap/gep-sdk/CONTRIBUTING.md) 联 合 国 工作流程。 CLA是仿照Apache软件基金会和 是通过 [法律援助助理](https://github.com/cla-assistant/github-action) GitHub 动作.

## 许可证

-   **源代码** (单位:千美元)`src/`, (中文(简体) ), `schemas/`——获得许可 下划线 [Apache 许可证,2.0版本](https://npmcn.com/package/%40evomap/gep-sdk/LICENSE)。见 [通知](https://npmcn.com/package/%40evomap/gep-sdk/NOTICE) 用于归属要求.
-   **规格** (单位:千美元)`spec/gep-spec-v1.md` 和任何其他文件 下级 `spec/` 或者说 `docs/`() ——根据 [4.0 国际(CC-BY-4.0)](https://npmcn.com/package/%40evomap/gep-sdk/spec/LICENSE-CC-BY-4.0.txt)。 。 。 . 执行可以自由再分配并修改光谱文本 与归属EvoMap.

许可证只涵盖代码和文件. **"EvoMap","GEP","GEP","EvoMap","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GEP","GP","GP",""GP"","G""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""", 而"基因进化协议"是EvoMap的商标.** Apache 2.0 (英语) 以及 CC-BY-4.0不授予商标权(见 Apache 许可证和 `NOTICE` 存档). 独立执行 议定书受到欢迎和鼓励,但不得推销 未经EvoMap事先书面许可. 联系人 `licensing@evomap.ai` 讨论归属或共同营销.

### 1.3以前的历史

`@evomap/gep-sdk` 1.0.x – 1.2.x发布于GPL-3.0-或-后期. 版本1.3.0及后为Apache-2.0. 如果你有一个存在 \* 部署在1.2.x,需要留在GPL线上,这些释放 npm 上仍然可用; 新的修正将仅在 a 上返回 最好的基础.

### 未执行的引用

Capsule 可能选择加入 `evidence_mode: "reference_only"` 记录材料 未执行。 计划要求 `source_type: "reference"`,准确的零 爆炸半径, 为空 `execution_trace`,不为空 `content.text`,则 `artifact_hash` 验证其小写 SHA-256 和字节大小与 UTF-8 文本相匹配. 使用 `classifyCapsuleEvidence` (也导出为 `validateCapsuleEvidence`用于 纯结构化验证结果。 选择 `evidence_mode` 保存遗产 盖子行为.

## 常见问题

### @evomap/gep-sdk 是什么？

基因组进化协议\(GEP\)的单一真理源:JSON Schemas,规格,和协议级的帮助者\(cannication / computeAssetId / 校验AssetId\)\.

### 如何安装 @evomap/gep-sdk？

在项目目录运行 npm install @evomap/gep-sdk，或使用 pnpm add / yarn add / bun add。

### @evomap/gep-sdk 支持 TypeScript 吗？

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

### @evomap/gep-sdk 支持 ESM 还是 CommonJS？

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

### @evomap/gep-sdk 需要什么版本的 Node\.js？

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

### @evomap/gep-sdk 可以商用吗？

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

### @evomap/gep-sdk 的下载量有多少？

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

### @evomap/gep-sdk 还在维护吗？

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