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）。该管理器添加了一个图形化“Manager”面板，使用户无需离开 UI 即可 安装、更新、启用/禁用、移除自定义节点包和模型文件。

为什么重要

自定义节点生态系统 – ComfyUI 的强大之处在于社区制作的“节点”（Python 插件），它们实现了新的图像处理步骤。跟踪数十个节点仓库可能很繁琐；该管理器集中化了发现和安装过程。
一键安装 – 用户可以浏览一个精选列表（从官方注册表 https://registry.comfy.org/ 或本地缓存获取），点击 Install 或 Try Install 即可克隆节点仓库、安装其 Python 依赖项，并立即在 UI 中可用。
模型处理 – 同样的 UI 也支持下载大型模型文件（例如检查点权重），并将其放置在正确的文件夹中。
安全与可复现性 – 快照记录了已安装节点/模型的精确集合，允许用户稍后恢复到已知的工作环境。
CLI 工具（cm-cli） – 高级用户可以从命令行脚本执行相同操作，适用于自动化设置或无头服务器。

核心功能（如 README 所述）

功能	说明
安装/移除/启用/禁用自定义节点	拉取节点仓库，运行可选的 `install.py`/`requirements.txt`，并将其注册到 ComfyUI。
模型安装器	将模型文件（例如 .ckpt、.safetensors）下载到可配置的目录中。
Hub / Channel 系统	三种数据库模式 – Channel（1天缓存）、Local、Channel（远程） – 控制节点列表的来源和更新频率。
快照管理器	将当前安装的节点/模型集合保存为快照文件；之后可在下次 ComfyUI 启动时恢复该快照。
共享工作流	一键将当前工作流分享到外部网站，如 comfyworkflows.com、openart.ai、youml.com，或通过 Matrix。
组件共享	通过复制/粘贴或拖放方式，将可重用的节点组（"组件"）以 JSON 或 `.pack` 文件形式共享。
缺失节点助手	检测工作流中引用但未安装的节点，并提供安装所需自定义节点的选项。
可配置行为	`config.ini` 允许设置 git 路径、选择 pip 或 uv、安全级别、网络模式（公开/私有/离线）、自定义 pip 覆盖/黑名单等。
CLI（`cm-cli`）	在不启动 UI 的情况下提供相同的安装/更新功能。
安全补丁（v3.38）	管理器数据现在位于受保护的用户目录（`<USER_DIRECTORY>/__manager/`）中，以防止意外篡改。
环境变量覆盖	`COMFYUI_PATH`、`GITHUB_ENDPOINT`、`HF_ENDPOINT` 可用于将管理器指向镜像或自定义安装。

如何使用

安装扩展 – 将仓库克隆到 ComfyUI/custom_nodes/comfyui-manager（或使用提供的便携式安装脚本或 comfy-cli 辅助工具）。重启 ComfyUI。
打开管理器 – 顶部菜单栏会出现新的“Manager”按钮。
浏览节点/模型 – 选择一个频道模式，然后点击任意条目的 Install 或 Try Install。
创建快照 – 设置好工作流后，点击 Save snapshot；之后可点击 Restore 恢复该快照以回滚更改。
共享 – 点击“分享”按钮，将工作流推送到外部网站或复制 JSON 包。
CLI – 运行 cm-cli <command>（参见 docs/en/cm-cli.md）以进行脚本化安装或批量更新。

适合谁？

使用 ComfyUI 构建图像生成流水线的艺术家和爱好者，希望有一个简单 UI 来添加社区节点。
自定义节点的开发者 – 他们可以提交节点元数据（custom-node-list.json）以在管理器中列出。
高级用户 / 系统管理员 – CLI 和快照功能使在多台机器或 CI 流水线中配置相同环境变得容易。

限制 / 注意事项

该管理器仅适用于 ComfyUI 版本 ≥ 0.3.76（或旧版本的回退路径）。旧版 ComfyUI 需手动放置扩展。
依赖项安装依赖于主机的 Python 环境；网络受限设置（network_mode=offline）仅使用缓存数据。
快照恢复不完全覆盖未被 Git 跟踪的自定义节点；这些可能需要手动重新安装。

快速入门检查清单

确保拥有一个正常工作的 ComfyUI 安装（Python 3，Git）。

克隆管理器：

cd path/to/ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager

重启 ComfyUI → 点击 Manager → 探索节点列表。
（可选）如果希望使用更快的 uv 安装器，请在 config.ini 中设置 use_uv = true。
（可选）调整 channels.list 或为内部节点仓库创建私有频道。

简而言之：ComfyUI‑Manager 是一个功能丰富、具备安全意识的扩展，将原本手动查找、安装和管理社区构建的节点和模型文件的过程，转变为流畅、点击驱动的体验，并提供了用于共享、快照和命令行自动化的额外工具。