# @genart-dev/core 中文文档

规范地址：https://npmcn.com/package/%40genart-dev/core/

版本：0\.12\.1
npm 元数据更新时间：2026-10-27T20:54:36.279Z
中文译文更新时间：2026-11-16T02:53:05.920Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40genart-dev/core
原文对照：https://npmcn.com/package/%40genart-dev/core/?lang=original
项目主页：https://genart.dev/
源码仓库：https://github.com/genart-dev/core

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

- 包体积（解压后）：14.2 MB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：esbuild \>=0\.17\.0
- 首次发布：2026-02-22T23:20:31.471Z
- 最新版本发布：2026-10-27T20:54:35.691Z
- 近 30 天下载量：2446（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

Render 适配器、 技能注册和 genart.dev 的运行时界面

## 安装

```sh
npm install @genart-dev/core
```

也可以使用：`pnpm add @genart-dev/core`、`yarn add @genart-dev/core`、`bun add @genart-dev/core`

## README

# @ genart- dev/ core (中文(简体) )

渲染器适配器、技能注册和运行时接口 [格纳特.德夫](https://genart.dev/) ——有MCP服务器的基因艺术平台,桌面应用,以及IDE扩展.

再出口一切从 [`@genart-dev/format`](https://github.com/genart-dev/format) 所以消费者可以得到完整的 API 格式而不单独导入.

## 安装

```bash
npm install @genart-dev/core
```

## 使用量

```typescript
import {
  createDefaultRegistry,
  createDefaultSkillRegistry,
  parseGenart,
  resolvePreset,
} from "@genart-dev/core";

// Set up renderer registry with all 5 adapters
const renderers = createDefaultRegistry();

// Parse a .genart file and resolve its renderer
const sketch = parseGenart(JSON.parse(fileContents));
const adapter = renderers.resolve(sketch.renderer.type); // → P5RendererAdapter

// Validate an algorithm for a specific renderer
const result = adapter.validate(sketch.algorithm);
if (!result.valid) {
  console.error(result.errors);
}

// Generate standalone HTML (embeds algorithm + CDN runtime)
const html = adapter.generateStandaloneHTML(sketch);

// Browse design knowledge skills
const skills = createDefaultSkillRegistry();
skills.list("composition"); // → 6 composition skills
skills.list("color");       // → 6 color skills
```

## 渲染器适配器

5个可插接的渲染引擎,每个装置 `RendererAdapter` 接口 :

| 适配器 | 类型 | 语言 | 运行时间 | 算法签名 |
| --- | --- | --- | --- | --- |
| `P5RendererAdapter` | `p5` | Java 脚本 | 页:1 | `function sketch(p, state)` |
| `Canvas2DRendererAdapter` | `canvas2d` | Java 脚本 | 土著 | `function sketch(ctx, state)` |
| `ThreeRendererAdapter` | `three` | Java 脚本 | 3个J | `function sketch(THREE, state, container)` |
| `GLSLRendererAdapter` | `glsl` | GLSL 语言 | 网络GL2 | 碎片阴影源 |
| `SVGRendererAdapter` | `svg` | Java 脚本 | 土著 | `function sketch(state)` |

```typescript
import { P5RendererAdapter } from "@genart-dev/core";

const p5 = new P5RendererAdapter();

// Validate algorithm source
p5.validate(algorithm);

// Compile for execution
const compiled = await p5.compile(algorithm);

// Create a live instance (browser context)
const instance = p5.createInstance(compiled, sketch.state, sketch.canvas);
instance.mount(document.getElementById("canvas"));
instance.updateState(newState);
instance.captureFrame({ format: "png" }); // → data URL

// Generate standalone HTML with embedded CDN runtime
const html = p5.generateStandaloneHTML(sketch);

// Get starter template for new sketches
const template = p5.getAlgorithmTemplate();
```

### 渲染器注册

```typescript
import { createDefaultRegistry, RendererRegistry } from "@genart-dev/core";

// Pre-loaded with all 5 adapters
const registry = createDefaultRegistry();

registry.resolve("p5");      // → P5RendererAdapter
registry.resolve("glsl");    // → GLSLRendererAdapter
registry.list();             // → ["p5", "canvas2d", "three", "glsl", "svg"]
registry.getDefault();       // → P5RendererAdapter
registry.has("three");       // → true
```

## 技能登记处

以古典设计理论为基础的11个内置设计知识技能——组成原理(Arnheim, Wong)和色彩理论(Albers, Itten). 每个技能包括理论文本,关键原理,学术参考,以及可选的渲染器特定算法实例.

### 技能(6)

| 身份证 | 复杂性 | 来源 |
| --- | --- | --- |
| `golden-ratio` | 中级 | 1:1.618 比例,螺旋布局 |
| `rule-of-thirds` | 初学者 | 3x3 电网、电站、动态平衡 |
| `visual-weight` | 中级 | 大小、价值、饱和度、位置平衡 |
| `gestalt-grouping` | 中级 | 近相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 |
| `figure-ground` | 初学者 | 阳性形式对阴性空间 |
| `rhythm-movement` | 高级 | 重复、变化、进步、流动 |

### 色彩技能(6)

| 身份证 | 复杂性 | 来源 |
| --- | --- | --- |
| `color-harmony` | 初学者 | 补充性、类似性、三角性、分部分补充 |
| `simultaneous-contrast` | 高级 | 阿尔伯斯相邻的颜色感知变化 |
| `color-temperature` | 初学者 | 温暖(提前)与凉爽(接收) |
| `itten-contrasts` | 高级 | 这是7个对比型 |
| `value-structure` | 中级 | 灯光、中子和暗子;通式键 |
| `palette-generation` | 中级 | 算法 OKLCH 色彩空间生成 |

```typescript
import { createDefaultSkillRegistry } from "@genart-dev/core";

const skills = createDefaultSkillRegistry();

const skill = skills.resolve("golden-ratio");
skill.theory;              // Markdown theory text
skill.principles;          // Key design principles
skill.references;          // Academic citations
skill.suggestedParameters; // Example ParamDefs for this technique
skill.examples?.p5;        // p5.js algorithm example
```

## API 参考

### 接口

| 接口 | 说明 |
| --- | --- |
| `RendererAdapter` | 制造引擎的合同——验证、编译、上载、捕获、出口 |
| `SketchInstance` | 活生生的草图——挂载/卸载,更新状态,暂停/重现,捕获Frame |
| `SkillDefinition` | 设计知识技能——理论,原理,参考,实例 |
| `SkillReference` | 学术引文(标题、作者,年份) |
| `ValidationResult` | 算法验证结果( E)`valid` + 键 `errors[]`(中文(简体) ) |
| `RuntimeDependency` | 独立 HTML 导出( 名称、 版本、 cdnUrl) 依赖 CDN |
| `CaptureOptions` | 截图选项(格式、质量、比例) |
| `CompiledAlgorithm` | 不透明编译算法手柄 |

### 类

| 类 | 说明 |
| --- | --- |
| `RendererRegistry` | 按类型分列的登记和解析渲染器适配器 |
| `SkillRegistry` | 注册和解决设计知识技能 |

### 工厂功能

| 函数 | 说明 |
| --- | --- |
| `createDefaultRegistry()` | 登记册预装了所有5个变形器适配器 |
| `createDefaultSkillRegistry()` | 登记册预装了所有11个技能 |

### 公用事业

| 函数 | 说明 |
| --- | --- |
| `hexToVec3(hex)` | 转换 `"#rrggbb"` 改为 `[r, g, b]` 以 \[0, 1\] 形式浮动——用于 GLSL 制服 |

### 从@genart-dev/format再出口

所有类型和职能来自 `@genart-dev/format` 被再出口: `parseGenart`, (中文(简体) ), `serializeGenart`, (中文(简体) ), `parseWorkspace`, (中文(简体) ), `serializeWorkspace`, (中文(简体) ), `convertLegacySketch`, (中文(简体) ), `CANVAS_PRESETS`, (中文(简体) ), `resolvePreset`, (中文(简体) ), `SketchDefinition`, (中文(简体) ), `WorkspaceDefinition`, (中文(简体) ), `ParamDef`, (中文(简体) ), `ColorDef`还有更多 见 [格式 README](https://github.com/genart-dev/format) 完整名单.

## 相关软件包

| 软件包 | 目的 |
| --- | --- |
| [`@genart-dev/format`](https://github.com/genart-dev/format) | 文件格式类型、解析器、预设( 依赖性) |
| [`@genart-dev/mcp-server`](https://github.com/genart-dev/mcp-server) | 33个工具 MCP 服务器 + CLI(依赖核心) |

## 支助

问题、错误或反馈—— [支持@ genart.dev](mailto:support@genart.dev) 或者说 [打开一个问题](https://github.com/genart-dev/core/issues)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @genart-dev/core 是什么？

Render 适配器、 技能注册和 genart\.dev 的运行时界面

### 如何安装 @genart-dev/core？

在项目目录运行 npm install @genart-dev/core，或使用 pnpm add / yarn add / bun add。

### @genart-dev/core 支持 TypeScript 吗？

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

### @genart-dev/core 支持 ESM 还是 CommonJS？

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

### @genart-dev/core 可以商用吗？

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

### @genart-dev/core 的下载量有多少？

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

### @genart-dev/core 还在维护吗？

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

