插件管理

ComfyUI 插件（Custom Nodes）用于为工作流扩展额外的处理节点与功能支持。在页面顶部点击 插件 标签页，可直接搜索社区插件库、安装新插件、更新已有插件或调整运行状态。

搜索与筛选

插件列表顶部提供了关键词检索、状态分类与排序控制。

在搜索框中输入插件名称或功能关键词，列表会实时展示匹配的插件结果。右侧的 刷新 按钮用于重新同步上游索引与本地插件状态。

状态筛选

选项	用途	效果
全部状态	查看完整列表。	显示索引库中的全部插件与本地已装插件。
已安装	查看当前环境中已部署的插件。	仅列出本地已下载的插件。
未安装	查找可添加的新扩展。	仅列出本地尚未安装的插件。
有更新	检查已有插件的新版本。	仅列出本地版本落后于云端最新版本的插件。
已禁用	查看暂时停用的插件。	仅列出已停止加载但保留本地文件的插件。

排序方式

选项	用途	效果
按热度	了解社区常用插件。	依据社区收藏量与使用热度由高到低排列。
最近更新	查看最新维护进展。	依据插件最新的版本发布或提交时间排列。
按名称	依据名称字母查找。	按照插件名称字母升序排列。

安装新插件

对于尚未安装的插件，支持以下三种安装途径：

• 安装最新版：在插件卡片右侧点击 下载图标，确认后开始拉取插件源码并自动安装所需的 Python 依赖。
• 指定版本安装：点击 版本切换（双向箭头图标），在弹出的版本列表中选择特定的版本标签或提交记录进行安装。
• 通过 Git 仓库安装：若所需插件未收录在官方索引库中，点击工具栏中的 Git 安装 按钮，输入完整的 GitHub 仓库地址（以 http:// 或 https:// 开头）直接克隆安装。

管理已安装插件

已安装的插件卡片上会显示当前运行的版本号、最新可用版本、作者信息以及操作按钮。

操作	用途	效果
更新（刷新图标）	升级插件代码。	拉取云端最新代码并更新运行依赖（仅在检测到新版本时显示）。
版本切换（双向箭头）	更换运行版本。	重新安装指定版本，用于特定工作流的版本兼容或回退。
启用 / 停用（开关）	控制插件是否加载。	切换为关闭后，插件文件仍保留在磁盘上，但 ComfyUI 启动时跳过该插件；切换为开启后恢复加载。
卸载（垃圾桶图标）	删除插件。	完全移除本地插件目录与相关文件。

ComfyUI-Manager 作为插件系统的底层运行依赖，不支持停用与卸载，仅保留版本切换与更新。

使变更生效与重启

所有插件的安装、更新、版本切换、启停与卸载，均需在 ComfyUI 重启后才能重新加载生效。

• 立即重启生效：单次操作完成后，确认窗口会直接提供 立即重启 选项。点击后系统在后台自动重启 ComfyUI 并检测就绪状态，无需离开当前页面。
• 批量处理后统一重启：若需要连续处理多个插件，可在每次操作后先暂不重启。已修改但尚未重启的插件会显示 待生效 徽章；待全部插件调整完毕后，点击页面右上角的 重启 按钮统一生效。
• 后台执行长任务：遇到依赖项较多、下载或编译耗时较长的插件时，可选择 后台继续。任务将转入后台静默执行，处理完成后插件列表会自动刷新。