@evomap/gep-sdk

中文文档
1.14.0发布于 2026/09/11Apache-2.0TypeScriptES Module零依赖近 30 天下载 3万

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

中文使用文档
文档目录12 节
  1. 包裹里有什么
  2. 安装
  3. 用作计划来源
  4. 使用资产标识助手
  5. 稳定
  6. 从1.1.x迁移
  7. 所需资源
  8. 相关
  9. 捐款
  10. 许可证
  11. 1.3以前的历史
  12. 未执行的引用

@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.jsonCapsule 资产计划
schemas/evolution-event.schema.json进化事件资产计划
schemas/mutation.schema.json变异资产计划a
schemas/task.schema.json任务资产计划a(内部工作项目)
spec/gep-spec-v1.md协议的完整规格
src/contentHash.jsSCHEMA_VERSION, (中文(简体) ), canonicalize, (中文(简体) ), computeAssetId, (中文(简体) ), verifyAssetId
src/protocolConstants.js共享协议条目,例如 GEP_GENE_CATEGORIES, (中文(简体) ), GEP_OUTCOME_STATUSES,以及 GEP_EVIDENCE_MODES
src/capsuleEvidence.js纯遗留/ 仅引用 Capsule 分类器和证据散列验证器

安装

npm install @evomap/gep-sdk

用作计划来源

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

使用资产标识助手

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/[email protected] 曝光选择 / 信号取出 / 内存-图 / 资产存储助手( e)selectGene, (中文(简体) ), extractSignals, (中文(简体) ), MemoryGraph, (中文(简体) ), AssetStore(中文(简体) ). 这些模块已删除 1.2.0 (中文(简体) ) 因为他们将协议套件与执行合并 行为。 如果你依赖其中任何一个:

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

所需资源

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

捐款

欢迎拉动请求。 所有贡献者必须签字 个人法律援助中心 (或 CLA 公司(中文(简体) ) 合并前 - 见 捐款额 联 合 国 工作流程。 CLA是仿照Apache软件基金会和 是通过 法律援助助理 GitHub 动作.

许可证

  • 源代码 (单位:千美元)src/, (中文(简体) ), schemas/——获得许可 下划线 Apache 许可证,2.0版本。见 通知 用于归属要求.
  • 规格 (单位:千美元)spec/gep-spec-v1.md 和任何其他文件 下级 spec/ 或者说 docs/() ——根据 4.0 国际(CC-BY-4.0)。 。 。 . 执行可以自由再分配并修改光谱文本 与归属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事先书面许可. 联系人 [email protected] 讨论归属或共同营销.

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 共发布 13 个版本,首次发布于 2026/03/13;过去 12 个月发布了 13 个版本。

版本发布日期距今
1.14.0latest2026/09/112 个月前
1.13.02026/08/162 个月前
1.12.12026/06/264 个月前
1.12.02026/06/264 个月前
1.5.02026/05/245 个月前
1.4.02026/05/205 个月前

关于 @evomap/gep-sdk 的常见问题

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