开源项目解析
ComfyUI-Manager
ComfyUI 的节点管理器:装节点、装模型、修依赖、查注册表。ComfyUI 生态的事实标准。
解决「工作流打开一片红」带 pip 重映射与黑名单
读懂层
2 张 · 架构图 / 流程图
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
浏览器界面(`comfyui-manager.js`)与命令行(`cm-cli.py`)都打到 `manager_server.py` 的 HTTP 接口,任务进异步队列。节点来源是 `custom-node-list.json` 等几份注册表。装依赖时会先过 `pip_overrides.json`(包名重映射)与 `pip_blacklist.list`(禁装名单),再跑各节点自己的 `install.py`。
它管哪几个决定
分镜先出图,再图生视频
8/10 家有官方说法画面构图线稿 / 姿势 / 深度约束
自持能力
权重在不在本地不涉及模型权重
种子能不能填不涉及
换掉它要动几处牵一发动全身
它管的是别的节点;换掉它等于换整套装配方式
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1确认前置Python 3 与 git 是硬前置,README 第一句就写了
- 2装到现有 ComfyUI 上克隆进 `custom_nodes/`;桌面版另有装法(见 issue #2374 的坑)
- 3装节点先看安全等级设置 —— 设太严会禁掉 `Install via git url` 与 `pip install`
改哪个文件能改什么
custom-node-list.json节点注册表。要加自己的节点从这里提pip_overrides.json / pip_blacklist.list依赖重映射与禁装名单。依赖打架时看这两个cm-cli.py命令行入口。没有界面的机器上用它坑在哪一处
带 issue 编号的来自:github issues 按回复数排序 · 核验 2026-08-16
桌面版升级后管理器不见了issue #2374 回复 51 条、开着 —— ComfyUI Desktop 升级后最常见的一条
被安全等级锁住issue #1049「Locked out by security level configuration」回复 41 条(已关闭)—— 设严了连改回来的入口都没了
git 报错issue #257 `Cmd('git') failed exit code(3221225725)` 开着,回复 39 条 —— Windows 上高频
装完 numpy 坏了issue #1665「Failed to restore numpy」回复 27 条(已关闭)—— 依赖冲突的典型
教程
官方文档、作者本人的视频,以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分(原文引用,抓取 2026-08-17)。读全文 ↗
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. NOTICE * V3.38: Security patch - Manager data migrated to protected path. See Migration Guide. * V3.16: Support for uv has been added. Set use_uv in config.ini. * V3.10: double-click feature is removed * This feature has been moved to https://github.com/ltdrdata/comfyui-connection-helper * V3.3.2: Overhauled. Officially supports https://registry.comfy.org/. * You can see whole nodes info on ComfyUI Nodes Info page. Installation Installation[method1] (General installation method: ComfyUI-Manager only) To install ComfyUI-Manager in addition to an existing installation of ComfyUI, you can follow the following steps: 1. Go to ComfyUI/custom_nodes dir in terminal (cmd) 2. git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager 3. Restart ComfyUI Installation[method2] (Installation for portable ComfyUI version: ComfyUI-Manager only) 1. install git - https://git-scm.com/download/win - standalone version - select option: use windows default console window 2. Download scripts/install-manager-for-portable-version.bat into installed "ComfyUI_windows_portable" directory - Don't click. Right-click the link and choose 'Save As...' 3. Double-click install-manager-for-portable-version.bat batch file Installation[method3] (Installation through comfy-cli: install ComfyUI and ComfyUI-Manager at once.) > RECOMMENDED: comfy-cli provides various features to manage ComfyUI from the CLI. * prerequisite: python 3, git Windows: commandline python -m venv venv venv\Scripts\activate pip install comfy-cli comfy install Linux/macOS: commandline python -m venv venv . venv/bin/activate pip install comfy-cli comfy install * See also: https://github.com/Comfy-Org/comfy-cli Installation[method4] (Installation for Linux+venv: ComfyUI + ComfyUI-Manager) To install ComfyUI with ComfyUI-Manager on Linux using a venv environment, you can follow these steps: * prerequisite: python-is-python3, python3-venv, git 1. Download scripts/install-comfyui-venv-linux.sh into empty install directory - Don't click. Right-click the link and choose 'Save As...' - ComfyUI will be installed in the subdirectory of the specified directory, and the directory will contain the generated executable script. 2. chmod +x install-comfyui-venv-linux.sh 3. ./install-comfyui-venv-linux.sh Installation Precautions * DO: ComfyUI-Manager files must be accurately located in the path ComfyUI/custom_nodes/comfyui-manager * Installing in a compressed file format is not recommended. * DON'T: Decompress directly into the ComfyUI/custom_nodes location, resulting in the Manager contents like __init__.py being placed directly in that directory. * You have to remove all ComfyUI-Manager files from ComfyUI/custom_nodes * DON'T: In a form where decompression occurs in a path such as ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager. * DON'T: In a form where deco ……(后略,见原文)
判断
优势
- 几乎所有 ComfyUI 工作流的前置条件 —— 别人给的工作流缺节点,靠它一键补齐
- 带 pip 重映射与黑名单,挡掉一批「装完 ComfyUI 就坏了」的依赖冲突
- 界面与命令行两套入口,服务器上也能用
- 官方组织维护,还在持续更新
局限
- GPL-3.0,传染性许可
- 409 个 issue 开着 —— 它站在所有第三方节点与 Python 依赖的交叉口,问题天然多
- 安全等级配置容易把自己锁在外面(issue #1049,已关闭但回复 41 条)
- 桌面版升级后管理器消失是长期问题(issue #2374,回复 51 条,开着)
不适用
不用 ComfyUI 的人 —— 它是那个生态的装配件,脱开没有意义。
同管这些决定的其它项目
ComfyUI节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。…Wan2.2文生 / 图生 / 语音驱动 / 角色动画替换,480P–720P。五个变体。…HunyuanVideo腾讯的开源视频生成模型,文生视频与图生视频。720×1280、129 帧。…FramePack把 13B 视频模型压进 6GB 显存的桌面程序。图生视频,一分钟长度、30 帧。…LTX-VideoLightricks 的视频生成模型,主打快。文生 / 图生 / 视频续写,默认 1…MiniMax H3全模态生成:文字、图片、视频、音频进同一个 Transformer,出带 32kHz…ControlNet给扩散模型加条件控制。九种结构信号:Canny 边缘、直线、HED 边界、涂鸦、人体…IP-Adapter用图片当提示词,锁住风格或人物。仅 22M 参数。…Real-ESRGAN通用图像 / 视频超分修复,支持 2× / 3× / 4×,含动漫专用与轻量模型。…Practical-RIFE视频插帧:在两帧之间算出中间帧,把 24 帧的片子补成 48、60 帧。作者是 RI…CodeFormer人脸修复:把糊掉、压坏、老照片里的脸修回来。图片与视频都能做。…kohya sd-scripts训练脚本集:覆盖 SD1.x/2.x、SDXL、SD3/3.5、FLUX.1;202…musubi-tuner视频模型的 LoRA 训练器。同一套代码训 Wan 2.1/2.2、HunyuanV…Ollama一条命令在本机跑开源大模型。写脚本、翻译这两段靠它才不出本机。…DiffSynth-Studio魔搭扩散模型工程框架,覆盖图像、视频、音乐推理与训练;近期加入 FLUX.3、MOS…MoneyPrinterTurbo给个主题或关键词,一键出高清短视频,含字幕与配音。…火宝短剧基于 AI 的一站式短剧生成平台,从剧本到成片全自动化。…ToonflowAI 创作平台:无限画布、AI Agent、可视化工作流,支持图像、视频、分镜和短剧…infinite-canvas面向 AI 创作的无限画布工作台:生图、参考图编辑、视频生成、Agent 助手、画布…open-ai-canvas面向 AI 影视创作的无限画布:多模态生成、分镜编排、素材管理、Agent 工作流。…VOZEB PRO把统一创作 Agent、画布、短剧生产线、素材库和商业运营后台放进同一套 Next.…OpenMontage让 Agent 编排视频生产:通过声明式流水线组织素材、生成、字幕、音频与合成。…video-shotcraft为 Claude Code / Codex 提供产品宣传片镜头配方,以网页截图与文案…Generative Media Skills给 Agent(Claude Code / Cursor / Gemini CLI)…motion-skills动效技能索引:55 个技能分成 18 个安装包,覆盖短视频、数据动画、网页动效、3D…ComfyUI-WanVideoWrapper把 Wan 系列模型接进 ComfyUI 的节点包。社区里跑 Wan 的事实标准封装…ComfyUI 官方工作流模板ComfyUI 内置的那批官方工作流模板与子图蓝图的真身仓库。…waoowaoo把一部小说灌进去,自动拆角色、拆场景、出分镜,再合成整集短剧。中英双界面。…JellyfishAI 短剧的端到端工作台:从剧本进,到分镜、角色一致性管理、出片、导出。…魔因漫创桌面端 AI 影视工具(Electron):剧本 → 角色 → 场景 → 导演 → …BigBanana AI Director一站式 AI 短剧 / 漫剧工作台,四阶段:剧本 → 视觉资产 → 分镜制作 → 导…ClipForge带货短视频专用的一站式工具:上传商品图,自动提炼卖点、写种草脚本、配音配字幕加背景乐…短视频工厂跨平台桌面应用:给提示词文本加分镜素材,自动剪出产品营销或泛内容短视频。集成文案生成…AI YouTube Shorts Generator把一条长视频切成一批排好序的竖屏短片:用语言模型找高光片段、用 Whisper 转写…Open AI UGC生成 UGC 风格的口播广告:用多个视频模型出真人感的 AI 演员念你的脚本。定位是…ViGenAiR把一条已有的视频广告用生成式 AI 重新剪成适配不同版位与时长的多条。…Seedance 2.0 Prompt Skills给 Agent 装的 Seedance 2.0 提示词技能:讲输入约束、@ 引用语法…Drama Skills面向编剧与漫剧工作室的短剧创作流水线:十个技能把一个点子或一部长篇材料,一路做成分集…Seedance2 Storyboard Generator开源剧情剧本技能:把故事拆成分镜,并整合成 Seedance 2.0 认的结构化提示…AI Shortfilm Prompts一个 Claude Code 技能:把任意一个想法变成电影语言的、模型直接能用的视频…Awesome Seedance 2 Prompts整理好的 Seedance 2.0 视频提示词库,README 自述逾六千条,覆盖电…歸藏的提示词库中文 AI 圈里流传最广的个人提示词仓库之一,存放作者为各家模型撰写的提示词。…MidJourney 风格与关键词参考一份带示例图的风格与关键词对照表:同一个提示词加不同风格词,画面变成什么样,逐个列出…AI Visual Prompt Cookbook171 套结构化提示词风格、342 张预览;JSON 模板支持 v2.1 / v2.…PromptLensAI 视频提示词分析工具:丢进一条别人的视频,反推出它的提示词与创作脚本,并做画面分…Prompt Engineering Guide提示词工程的系统性指南:教程、论文、课程笔记与可运行的示例。不针对视频,讲的是提示词…蓝书 AI 视频工具包AI 视频提示词、技能与方法论工具包。2026-10-10 README 自述:60…
github README + GitHub API + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。