开源项目解析
ComfyUI
节点式工作流底座。图像 / 视频 / 音频 / 3D / 文本共用一个底座。
节点式工作流图/视频/音频/3D 共用一个底座生态最大
读懂层
2 张 · 架构图 / 流程图
DeepWiki 架构页 · 2026-08-12 索引 · 核验 2026-08-16
DeepWiki 架构页 · 抓取 2026-08-16 · 核验 2026-08-16
入口 main.py / nodes.py / comfy/sd.py；BaseModel 抽象出跨架构统一操作层。执行引擎只重跑发生变化的那部分图。
它管哪几个决定
分镜先出图，再图生视频
8/10 家有官方说法画面构图线稿 / 姿势 / 深度约束
角色跨镜头一致角色参考 · 多参考 · LoRA
7/10 家有官方说法结果可复现权重与随机种子在本地
2/10 家有官方说法自持能力
权重在不在本地不涉及模型权重
种子能不能填可填
换掉它要动几处牵一发动全身
它是底座；换掉等于整条流水线重搭
动手层
文档代码结构踩过的坑实测 未做
装它要过哪几关
- 1克隆仓库钉在 stable release tag 上 —— 官方明说主线之外的提交可能很不稳且会弄坏大量自定义节点
- 2pip install -r requirements.txtPyTorch 版本要和显卡驱动对上，这一步是最常卡住的地方
- 3模型放进 models/ 各自的子目录目录名决定它在哪个节点的下拉里出现，放错了节点里就是空的
- 4python main.py默认只监听本机；要在别的设备上开得加 --listen
改哪个文件能改什么
nodes.py节点注册表。想知道某个节点到底接受什么输入，看这里比看界面快comfy/sd.py模型装载。加载失败的报错基本都从这里抛custom_nodes/放第三方节点包。装节点就是往这个目录里克隆仓库extra_model_paths.yaml模型不想复制两份时，把 WebUI 的模型目录挂进来comfy/model_management.py显存调度都在这儿。`VRAMState` 六档：DISABLED / NO_VRAM / LOW_VRAM / NORMAL_VRAM / HIGH_VRAM / SHARED（Apple 统一内存）--lowvram / --novram / --highvram / --gpu-only / --cpu命令行直接选上面那六档，不用改代码坑在哪一处
带 issue 编号的来自：github issues 按回复数排序 · 核验 2026-08-16
显存不够时的行为它不报错，它变慢。 显存不够就把权重卸到内存、按需搬回来 —— 表现是「怎么这么慢」而不是「爆了」。慢和爆显存是两种症状，别当同一个问题查
图上任意分支接线不完整的分支不报错，直接不执行 —— 官方原话：只有输出端输入齐全的那部分图才会被执行。界面上看不出区别
跟主线更新官方声明 stable tag 之外可能弄坏自定义节点。issue #14618「每次改提示词都重新加载模型」、#11400「更新后预览没了」都是更新后回归
Apple Siliconissue #4165：FLUX 在 MPS 上因不支持 float64 跑不了；#2992：macOS Sonoma 14.4 更新直接弄坏 Apple Silicon 的 GPU 加速。两条都还开着
新版显存流式issue #15255（开着，55 条回复）：Dynamic VRAM streaming 崩在 HostBuffer.read_file_slice → CUDA OOM，更新后所有生成都失败。这是当前最热的一条
教程
官方文档、作者本人的视频，以及 ComfyUI 官方给的原生工作流示例。每条都验过还打得开。
项目自述
以下是仓库 README 的开头部分（原文引用，抓取 2026-08-17）。读全文 ↗
ComfyUI The most powerful and modular AI engine for content creation. [![Website][website-shield]][website-url] [![Dynamic JSON Badge][discord-shield]][discord-url] [![Twitter][twitter-shield]][twitter-url] [![Matrix][matrix-shield]][matrix-url] [![][github-release-shield]][github-release-link] [![][github-release-date-shield]][github-release-link] [![][github-downloads-shield]][github-downloads-link] [![][github-downloads-latest-shield]][github-downloads-link] [matrix-shield]: https://img.shields.io/badge/Matrix-000000?style=flat&logo=matrix&logoColor=white [matrix-url]: https://app.element.io/#/room/%23comfyui_space%3Amatrix.org [website-shield]: https://img.shields.io/badge/ComfyOrg-4285F4?style=flat [website-url]: https://www.comfy.org/ [discord-shield]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Finvites%2Fcomfyorg%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&logo=discord&logoColor=white&label=Discord&color=green&suffix=%20total [discord-url]: https://discord.com/invite/comfyorg [twitter-shield]: https://img.shields.io/twitter/follow/ComfyUI [twitter-url]: https://x.com/ComfyUI [github-release-shield]: https://img.shields.io/github/v/release/comfyanonymous/ComfyUI?style=flat&sort=semver [github-release-link]: https://github.com/comfyanonymous/ComfyUI/releases [github-release-date-shield]: https://img.shields.io/github/release-date/comfyanonymous/ComfyUI?style=flat [github-downloads-shield]: https://img.shields.io/github/downloads/comfyanonymous/ComfyUI/total?style=flat [github-downloads-latest-shield]: https://img.shields.io/github/downloads/comfyanonymous/ComfyUI/latest/total?style=flat&label=downloads%40latest [github-downloads-link]: https://github.com/comfyanonymous/ComfyUI/releases ComfyUI is the AI creation engine for visual professionals who demand control over every model, every parameter, and every output. Its powerful and modular node graph interface empowers creatives to generate images, videos, 3D models, audio, and more... - ComfyUI natively supports the latest open-source state of the art models. - It is by far the most optimized inference engine for diffusion models in the world with a focus on local consumer hardware. - Can run even the biggest open source models on as low as 4GB vram + 8GB ram relatively quickly (saturating your GPU compute) using our state of the art asynchronous weight streaming technology. - Partner nodes provide access to the best closed source models such as Nano Banana, Seedance, Hunyuan3D, etc. - It is available on Windows, Linux, and macOS, locally with our desktop application, our portable install or on our cloud. - The most sophisticated workflows can be exposed through a simple UI thanks to App Mode. - It integrates seamlessly into production pipelines with our API endpoints. Get Started Local Desktop Application - The easiest way to get started. - Available on Windows & macOS. Manual Install Supports all operating systems and GPU types (NVIDIA, AMD, Intel, Apple Silicon, Ascend). Cloud Comfy Cloud - Our official paid cloud version for those who can't afford local hardware. Examples See what ComfyUI can do with the newer template work ……（后略，见原文）
判断
优势
- 社区节点、工作流与教程存量最大
- 图像 / 视频 / 音频 / 3D 共用一个底座
- 增量执行 + 自动卸载，小显存不直接出局
局限
- GPL-3.0 具传染性，嵌入闭源产品前须核对条款
- 官方声明主线不稳，需固定在 stable tag
- 接线不完整的分支不报错，直接不执行
不适用
一次性产出需求 —— 回报来自工作流复用。
同管这些决定的其它项目
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 参数。…InstantID一张脸照做身份保持生成，零样本、免调优。…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-ManagerComfyUI 的节点管理器：装节点、装模型、修依赖、查注册表。ComfyUI 生态…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 重新剪成适配不同版位与时长的多条。…LiveTalking实时交互流式数字人引擎，音视频同步对话。支持 ernerf、musetalk、wav…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 + DeepWiki 架构页 · 核验 2026-10-19 | 判断栏可报错。