Comfy-Org/ComfyUI-Manager

ComfyUI-Manager is an extension designed to enhance the usability of ComfyUI. It offers management functions to install, remove, disable, and enable various custom nodes of ComfyUI. Furthermore, this extension provides a hub feature and convenience functions to access a wide range of information within ComfyUI.

什么是 ComfyUI‑Manager？

ComfyUI‑Manager 是一个扩展，用于开源的可视化编程工具 ComfyUI（用于构建 Stable Diffusion 流水线的 UI）。该管理器添加了一个图形化“管理器”按钮，使用户可以在不离开 UI 的情况下 浏览、安装、更新、启用/禁用和移除自定义节点和模型文件。

为什么重要

ComfyUI 的强大之处在于 自定义节点 —— 用于添加新图像生成操作的插件式 Python 包。保持这些节点更新并处理其 Python 依赖项可能很繁琐。ComfyUI‑Manager 自动化了这一流程，提供快照/恢复系统，并与官方 ComfyUI 注册表 及多个社区共享站点集成。

核心功能（如 README 所述）

功能	作用
节点与模型安装	打开一个对话框，可搜索注册表，查看三种数据库模式（缓存频道、本地列表、远程频道），并点击安装或尝试安装。
启用/禁用与移除	已安装的节点可直接在管理器 UI 中切换开启/关闭或移除。
更新处理	“获取更新” 拉取最新版本信息；更新按钮应用这些更改。
快照管理器	将当前已安装的节点/模型集保存为快照文件；可在下次 ComfyUI 启动时恢复该快照。
共享工作流	一键分享至 https://comfyworkflows.com、https://openart.ai、https://youml.com 及通过 Matrix。
命令行工具 (`cm‑cli`)	所有管理器操作均可通过 CLI 供高级用户和自动化脚本使用。
安全优先的存储	从 v3.38 起，管理器数据存储在受保护的 `<USER_DIRECTORY>/__manager/` 路径下，降低意外篡改风险。
可配置行为	`config.ini` 允许设置 git 路径、使用快速的 uv 安装器、控制网络模式（公开/私有/离线）、黑名单/覆盖 pip 包、启用文件日志等。
组件共享	可复制/粘贴或拖拽 JSON/`.pack` 组件文件，在项目间复用节点组。
缺失节点助手	检测工作流中引用但未安装的节点，并提供一键安装所需自定义节点的功能。
环境变量覆盖	`COMFYUI_PATH`、`GITHUB_ENDPOINT`、`HF_ENDPOINT` 可将管理器指向镜像或自定义安装位置。
Aria2 下载器支持	可选的高速下载器，用于大模型文件。

如何获取

README 列出了四种安装路径：

手动克隆 – 在 ComfyUI/custom_nodes 内执行 git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager。
便携式 Windows 脚本 – 下载并运行提供的 .bat 文件。
通过 comfy-cli – 一条命令（comfy install）即可同时设置 ComfyUI 和管理器。
Linux venv 脚本 – 下载后运行 install-comfyui-venv-linux.sh。

所有方法最终都会将管理器安装在 ComfyUI/custom_nodes/comfyui-manager 路径下。

典型工作流

打开 ComfyUI → 点击顶部栏的 管理器 按钮。
选择 安装自定义节点 或 安装模型。
浏览列表（缓存频道为默认视图），点击安装或 尝试安装。
使用 获取更新 → 更新保持所有内容最新。
当工作流引用了缺失节点时，点击 安装缺失的自定义节点 以自动解决。
可选地在重大更改前 保存快照；之后可恢复以回滚。
使用内置的分享按钮共享完成的工作流。

配置亮点

use_uv = true – 使用快速的 uv 安装器而非 pip。
network_mode = public|private|offline – 控制管理器是否可访问互联网。
security_level – 选择受保护路径处理的严格程度。
pip 黑名单/覆盖文件可阻止或替换特定 Python 包。

谁应该使用它？

定期添加或测试第三方节点的 ComfyUI 用户。
需要可复现环境（快照、锁定 pip 版本）的 艺术家与开发者。
偏好 CLI 自动化（cm‑cli）的 高级用户。

总结

ComfyUI‑Manager 是一个实用、文档齐全的扩展，将原本手动处理自定义节点、模型和工作流共享的过程转变为流畅的 UI 驱动体验，同时为更高级设置提供 CLI 工具和安全意识的数据存储。