Hanafubuki

扩展管理

安装、更新、启停、切换版本或卸载当前 WebUI 支持的扩展。

“扩展”页是否可用,以及提供哪些按钮,由当前 WebUI 的管理能力决定。页面通常包含“本地扩展”和“扩展市场”两个视图;不支持市场的实例仍可能允许管理已经安装的扩展。

安装扩展

打开“扩展市场”,使用搜索框在已加载的索引中筛选扩展。
查看扩展名称、作者、来源和安装状态;标记为“无法安装”的条目不能强制安装。
点击安装,在任务中心等待任务完成,再切换到“本地扩展”确认条目出现。

扩展市场使用后端缓存的索引。需要获取新条目或最新安装状态时点击刷新;输入搜索词只筛选当前已经加载的数据。

管理本地扩展

操作说明
启用 / 停用修改扩展状态,通常在下次启动 WebUI 时生效
更新更新一个 Git 型扩展
全部更新依次处理当前可以更新的扩展,失败项在任务中心中查看
分支 / 提交将 Git 型扩展切换到指定分支或提交
Registry 版本为支持 Registry 的 ComfyUI 节点选择已发布版本
卸载删除扩展目录或由当前 WebUI 执行对应卸载操作

列表中的来源标记可以帮助判断可用操作:Git 来源通常支持分支与提交;Registry 来源可能支持发布版本;本地来源不一定能够自动更新。

更新或切换版本

创建快照,并记录重要扩展当前的分支、提交或 Registry 版本。
建议停止 WebUI,避免运行时代码与磁盘文件同时变化。
对单个扩展执行更新或版本切换;需要批量更新时再使用“全部更新”。
等待任务完成,刷新本地扩展列表并重新启动 WebUI。
若启动失败,先停用最近修改的扩展,再检查其任务输出和兼容说明。

卸载会删除扩展文件

卸载确认窗口明确表示扩展文件将从实例中删除。扩展自己的配置、模型或输出是否一并消失取决于它们实际存放的位置;卸载前应先检查并备份。

扩展下载失败时检查网络与代理镜像;需要整体回退环境时使用快照管理

本页目录