@genart-dev/core

中文文档
0.12.1发布于 2026/10/28MITTypeScriptESM + CJS近 30 天下载 2446

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

中文使用文档
文档目录16 节
  1. 安装
  2. 使用量
  3. 渲染器适配器
  4. 渲染器注册
  5. 技能登记处
  6. 技能(6)
  7. 色彩技能(6)
  8. API 参考
  9. 接口
  10. 类
  11. 工厂功能
  12. 公用事业
  13. 从@genart-dev/format再出口
  14. 相关软件包
  15. 支助
  16. 许可证

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

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

再出口一切从 @genart-dev/format 所以消费者可以得到完整的 API 格式而不单独导入.

安装

npm install @genart-dev/core

使用量

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 接口 :

适配器类型语言运行时间算法签名
P5RendererAdapterp5Java 脚本页:1function sketch(p, state)
Canvas2DRendererAdaptercanvas2dJava 脚本土著function sketch(ctx, state)
ThreeRendererAdapterthreeJava 脚本3个Jfunction sketch(THREE, state, container)
GLSLRendererAdapterglslGLSL 语言网络GL2碎片阴影源
SVGRendererAdaptersvgJava 脚本土著function sketch(state)
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();

渲染器注册

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 色彩空间生成
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 完整名单.

软件包目的
@genart-dev/format文件格式类型、解析器、预设( 依赖性)
@genart-dev/mcp-server33个工具 MCP 服务器 + CLI(依赖核心)

支助

问题、错误或反馈—— 支持@ genart.dev 或者说 打开一个问题。 。 。 .

许可证

麻省理工学院

版本与发布记录

@genart-dev/core 共发布 31 个版本,首次发布于 2026/02/23;过去 12 个月发布了 31 个版本。

版本发布日期距今
0.12.1latest2026/10/2819 天前
0.12.02026/10/2720 天前
0.11.12026/03/297 个月前
0.11.02026/03/287 个月前
0.10.02026/03/237 个月前
0.9.02026/03/197 个月前

关于 @genart-dev/core 的常见问题

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