安装自定义节点

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

​

开始之前

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

​

上传

1. 打开侧边栏中的 自定义节点。
2. 点击 上传节点。
3. 选择归档。
4. 填写元数据：

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

5. 点击 上传。控制台会上传归档并注册该包。
6. 新节点会出现在列表中并带有版本徽章。

​

更新已有的包

两种路径：

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

​

编辑或删除

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

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

​

包如何到达代理

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

​

相关

• 自定义节点 —— 概念。
• 模型 —— 模型文件采用相同 模式。
• 工作流 —— 包在哪里被引用。