# @comfyorg/litegraph 中文文档

规范地址：https://npmcn.com/package/%40comfyorg/litegraph/

版本：0\.17\.2
npm 元数据更新时间：2026-11-01T18:51:23.310Z
中文译文更新时间：2026-11-10T11:46:35.711Z
软件包许可：MIT

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

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

弃用说明：Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

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

- 包体积（解压后）：3.8 MB，98 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2024-07-05T16:27:47.322Z
- 最新版本发布：2025-08-06T03:32:44.679Z
- 近 30 天下载量：13107（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：290（近 12 个月 0 个）

## 中文简介

一个类似于PD或UDK蓝图的图节点编辑器. 它在HTML5 Canvas中工作,并允许导出图表以包含在应用程序中.

## 安装

```sh
npm install @comfyorg/litegraph
```

也可以使用：`pnpm add @comfyorg/litegraph`、`yarn add @comfyorg/litegraph`、`bun add @comfyorg/litegraph`

## README

# @comfyOrg/ 书法

这是在 [舒适 界面前端( U)](https://github.com/Comfy-Org/ComfyUI_frontend)。 。 。 .

这是原作的叉子 `litegraph.js`. 某些API可能没有改变,但与原始文件基本不符.

一些早期的要闻:

-   累计comfyUI自定义变化(2024-01~2024-05) (中文(简体) )[https://github.com/Comfy-Org/litegraph.js/pull/1 (中文(简体) )](https://github.com/Comfy-Org/litegraph.js/pull/1)(中文(简体) )
-   ComfyUI 前端 TS 迁移的型式变换([https://github.com/Comfy-Org/litegraph.js/pull/3 互联网档案馆的存檔,存档日期2014-12-22](https://github.com/Comfy-Org/litegraph.js/pull/3)(中文(简体) )
-   缩放修正( E)[https://github.com/Comfy-Org/litegraph.js/pull/7 (中文(简体) )](https://github.com/Comfy-Org/litegraph.js/pull/7)(中文(简体) )
-   Emit 搜索框触发自定义事件( E)[https://github.com/Comfy-Org/litegraph.js/pull/10 (英语)](https://github.com/Comfy-Org/litegraph.js/pull/10)(中文(简体) )
-   流出组合部件文本( T)[https://github.com/Comfy-Org/litegraph.js/pull/17 (中文(简体) )](https://github.com/Comfy-Org/litegraph.js/pull/17)(中文(简体) )
-   根据图表序列化排序节点( I)[https://github.com/Comfy-Org/litegraph.js/pull/21 (中文(简体) )](https://github.com/Comfy-Org/litegraph.js/pull/21)(中文(简体) )
-   修复连接链接时未使用的空输入( F)[https://github.com/Comfy-Org/litegraph.js/pull/24 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/Comfy-Org/litegraph.js/pull/24)(中文(简体) )
-   批量输出连接移动/ 断开连接( M)[https://github.com/Comfy-Org/litegraph.js/pull/39 (中文(简体) )](https://github.com/Comfy-Org/litegraph.js/pull/39)(中文(简体) )
-   现在还有上百人...

# 安装

`npm i @comfyorg/litegraph`

# 平面图.js

一个TypeScript库,用于在浏览器中创建类似于"不真实蓝图"的图表.

原始语法说明.js

一个Javascript中的库来在浏览器中创建类似于"不真实的蓝图"的图表. 节点可以很容易地编程,它包括一个编辑器来构造和测试图表.

它可以很容易地被集成到任何现有的网络应用中,图表可以运行而不需要编辑器.

![Node Graph](https://npmcn.com/package/%40comfyorg/litegraph/imgs/node_graph_example.png "Node graph example")

## 特征

-   在 Canvas2D 上的渲染器( 插入/ 输出和平整区域, 易于渲染复杂的界面, 可在 WebGLTexture 内使用)
-   方便使用编辑器(搜索框,键盘快捷键,多选项,上下文菜单,.)
-   优化到每个图支持上百个节点(在编辑上,也在执行上)
-   自定义主题( 颜色、 形状、 背景)
-   召回将节点的每个动作/绘制/事件个性化
-   图表可以在节点JS中执行
-   高度自定义节点( 颜色、 形状、 部件、 自定义渲染)
-   容易融入任何JS应用程序(一个文件,没有依赖性)
-   字体支持

## 安装

您可以使用 npm 安装它

```bash
npm install @comfyorg/litegraph
```

## 如何编码新节点类型

以下是一个实例,说明如何建立一个汇集两种投入的节点:

```ts
import { LiteGraph, LGraphNode } from "./litegraph"

class MyAddNode extends LGraphNode {
  // Name to show
  title = "Sum"

  constructor() {
    this.addInput("A", "number")
    this.addInput("B", "number")
    this.addOutput("A+B", "number")
    this.properties.precision = 1
  }

  // Function to call when the node is executed
  onExecute() {
    var A = this.getInputData(0)
    if (A === undefined) A = 0
    var B = this.getInputData(1)
    if (B === undefined) B = 0
    this.setOutputData(0, A + B)
  }
}

// Register the node type
LiteGraph.registerNodeType("basic/sum", MyAddNode)
```

## 服务器侧

它也使用NodeJS在服务器侧面工作,尽管一些节点在服务器上不工作(音频,图形,输入等).

```ts
import { LiteGraph, LGraph } from "./litegraph.js"

const graph = new LGraph()

const firstNode = LiteGraph.createNode("basic/sum")
graph.add(firstNode)

const secondNode = LiteGraph.createNode("basic/sum")
graph.add(secondNode)

firstNode.connect(0, secondNode, 1)

graph.start()
```

## 使用它的项目

### [康菲乌伊](https://github.com/comfyanonymous/ComfyUI)

![ComfyUI default workflow](https://github.com/comfyanonymous/ComfyUI/blob/6efe561c2a7321501b1b27f47039c7616dda1860/comfyui_screenshot.png "ComfyUI default workflow")

### 使用原始语法.js的项目

单击以扩展

### [校对:soup](http://webglstudio.org/)

![WebGLStudio](https://npmcn.com/package/%40comfyorg/litegraph/imgs/webglstudio.gif "WebGLStudio")

### [MOI 象头](http://moiscript.weebly.com/elephant-systegraveme-nodal.html)

![MOI Elephant](https://npmcn.com/package/%40comfyorg/litegraph/imgs/elephant.gif "MOI Elephant")

### 我的节点

![MyNodes](https://npmcn.com/package/%40comfyorg/litegraph/imgs/mynodes.png "MyNodes")

## 反馈

请 [打开一个问题](https://github.com/Comfy-Org/litegraph.js/issues/) 在GitHub重播时.

# 发展

文学没有运行时间依赖性. 已测试了节点JS 20.18.x的构建工具

## 释放

使用 GitHub 动作发布普通版本 .

1.  运行 `Release a New Version` 动作,选择正文类型
2.  合并结果 PR
3.  合并时自动发布 GitHub 发布

### 释放前

动作直接翻译 `Version increment type` 到 npm 版本命令. `Pre-release ID (suffix)` 选项 `--preid` 参数.

例如,使用 `prerelease` 递增型可以自动撞出补丁版本并创建出预放出版本. 随后的发行会只更新发行前版本. 使用 `patch` 当准备去除预发后缀时.

## 贡献者

你可以找到那个 [当前贡献者列表](https://github.com/Comfy-Org/litegraph.js/graphs/contributors) (原始内容存档于2018-09-29). on GitHub.

### 贡献者(叉前)

-   阿特拉桑岛
-   克里夫语name
-   饶舌歌手
-   发明者Dev
-   内特·斯卡莱
-   编码救生
-   伊利亚布斯克
-   高斯州

## 常见问题

### @comfyorg/litegraph 是什么？

一个类似于PD或UDK蓝图的图节点编辑器\. 它在HTML5 Canvas中工作,并允许导出图表以包含在应用程序中\.注意：该包已被作者标记为弃用——Package no longer supported\. Contact Support at https://www\.npmjs\.com/support for more info\.

### 如何安装 @comfyorg/litegraph？

在项目目录运行 npm install @comfyorg/litegraph，或使用 pnpm add / yarn add / bun add。

### @comfyorg/litegraph 支持 TypeScript 吗？

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

### @comfyorg/litegraph 支持 ESM 还是 CommonJS？

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

### @comfyorg/litegraph 可以商用吗？

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

### @comfyorg/litegraph 的下载量有多少？

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

### @comfyorg/litegraph 还在维护吗？

最新版本 0\.17\.2 发布于 2025/08/06（1\.3 年前）；至今共发布 290 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/07/06。作者已将其标记为弃用，新项目建议寻找替代方案。