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

# 安装自定义节点

> 为团队的代理添加自定义节点包。

本页讲解自定义节点包的上传流程。关于概念概览见
[自定义节点](/zh/cloud/concepts/nodes)。侧边栏必须出现
**自定义节点** 入口 —— 如果没有，说明此部署在你的部署上未启用
自定义节点。

## 开始之前

* 本地的节点包归档文件。
* 一个你所属的团队。任何成员都可以上传。
* 为该包定一个 `package_name`。工作流通过该名称引用包 ——
  请选择一个稳定的名称。

## 上传

1. 打开侧边栏中的 **自定义节点**。

2. 点击 **上传节点**。

3. 选择归档。

4. 填写元数据：

   | 字段     | 说明                                                                 |
   | ------ | ------------------------------------------------------------------ |
   | 显示名    | 在列表中显示的人类可读标签。最多 255 个字符。                                          |
   | 包名     | 位于 `custom_nodes/` 下的目录名。最多 100 个字符，仅允许字母/数字/`-`/`_`/`.`。**不可修改。** |
   | 版本     | 自由格式的版本字符串，最多 50 个字符（`1.0.0`、`2024-05` 等等）。                        |
   | Pip 依赖 | 可选。在包自带的 `requirements.txt` 之外的额外 Python 依赖，一行一项。                  |

5. 点击 **上传**。控制台会上传归档并注册该包。

6. 新节点会出现在列表中并带有版本徽章。

## 更新已有的包

两种路径：

* **重新上传** —— 从节点所在行替换归档。
  包名保持不变；包内容会更新。
  适用于在不变更版本号的前提下发布修复。
  已经在代理上运行的任务会用它启动时的版本继续完成。
* **编辑** —— 在不动归档的情况下修改显示名、版本、pip 依赖或
  状态。

## 编辑或删除

* **编辑** —— 显示名、版本、pip 依赖、状态。
* **删除** —— 移除记录。已经运行中的任务会用其启动时的版本继续完成。

使用多选可以从列表批量删除。

## 包如何到达代理

与自定义文件相同的模型：标签匹配的代理在任务首次引用包时
下载它、缓存它，并在之后重用。

## 相关

* [自定义节点](/zh/cloud/concepts/nodes) —— 概念。
* [模型](/zh/cloud/guides/upload-model) —— 模型文件采用相同
  模式。
* [工作流](/zh/cloud/concepts/workflows) —— 包在哪里被引用。