> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义节点

> 分发到你团队代理上的自定义节点包。

Cyberun Cloud 中的**自定义节点包**是一个带版本的捆绑文件，用于扩展代理上的运行时——通常是一组 ComfyUI 自定义节点。节点包会被分发到符合条件的代理上，让引用它们的工作流能够运行。

如果本部署没有启用自定义节点，侧边栏不会出现 **自定义节点** 条目。

## 节点记录包含什么

* **显示名称** ——展示在列表中的人类可读标签。最多 255 个字符。
* **包名** ——代理上 `custom_nodes/` 下的目录名。在团队内唯一，最多 100 个字符，仅允许字母数字加 `-`、`_`、`.`。**创建后不可修改。**
* **版本** ——自由格式的版本字符串（`1.0.0`、`2024-05`，任意），最多 50 个字符。
* **文件** ——包归档文件。你上传一次，它就会注册并出现在列表中。
* **大小** ——归档文件的大小。
* **Pip 依赖** ——可选的额外 Python 依赖，每行一个包。代理已经会自动安装包自带的 `requirements.txt`；此字段仅用于追加（例如 `opencv-python>=4.8`）。
* **状态** —— `active`（代理把它纳入同步集合）或 `disabled`（保留在目录中，不参与同步）。

## 节点包如何到达代理

与自定义模型相同的模式：一个标签匹配工作流要求的代理会在首次需要时拉取节点包，缓存到本地，之后复用。

## 更新节点包

可编辑的元数据有**显示名称**、**版本**、**Pip 依赖**和**状态**。你也可以**重新上传**归档文件——包名不变，但文件内容会更新。

重新上传会改变后续派发看到的内容。已经在代理上运行的任务会用它开始时的版本跑完。

## 相关

* [安装自定义节点](/zh/cloud/guides/install-custom-nodes) ——演练。
* [模型](/zh/cloud/concepts/models) ——分发 checkpoint、LoRA 等模型文件。
* [工作流](/zh/cloud/concepts/workflows) ——节点包被引用的地方。