ComfyUI 节点式生成引擎
ComfyUI 早就不只是"Stable Diffusion 的前端"了——官方 README 把它定位成
内容创作的模块化 AI 引擎，图像、视频、音频、3D 与文本生成都在里面。
但它也是一个每两周就发一个大版本、启动参数几十个、升级容易把自定义节点弄坏的工程。
本专题共 53 篇，不复述功能清单，而是回答四件事：
这个参数到底管什么、这条命令什么时候用、报错了怎么判定、该选哪一条路。
内容依据
官方仓库
的 README、comfy/cli_args.py、release notes 与安全公告整理，核对日 2026-08-09，对应版本 v0.31.0。
本专题内容为官方文档与源码口径，非本机实测；参数与默认值随版本变动，请以官方文档与
python main.py --help 的实际输出为准。
ComfyUI 是什么：一个节点式的生成引擎，以及它带来的一整套工程问题
它早就不是「Stable Diffusion 的前端」了，官方把自己定位成内容创作的模块化 AI 引擎，图像、视频、音频、3D 与文本生成都在里面。但它同时是一个每两周一个大版本、启动参数几十个、升级容易弄坏自定义节点的工程。这篇把定位、版本节奏、安装路径、执行模型、显存主线、扩展风险一次讲清，并给出整个专题的阅读路径。
入门与安装
桌面版、portable、comfy-cli、手动装四条路各自的官方定位；四个 portable 包别下错；Python 与 PyTorch 版本怎么定。
让 ComfyUI 和别的 UI 共享同一份模型目录
同一批模型被几个 UI 各存一份，硬盘很快就撑不住。ComfyUI 官方给的入口只有一个：把仓库里的示例配置改名成 extra_model_paths.yaml 再编辑。本文按 README 与 comfy/cli_args.py（v0.31.0）的口径讲清这个文件在哪、便携版里的位置、为什么启动参数能重复叠加多个配置，以及它和整体搬家用的两个目录参数分别该在什么时候用，最后给出四步验收顺序和几种不该这么干的场景。
四个 portable 包别下错：ComfyUI Windows 便携版的选包与落地流程
ComfyUI 的 Windows Portable 在官方 release 页上一次给出四个 7z 包，文件名只差一个后缀，下错了轻则起不来重则白折腾一晚上。这篇按官方 README 口径把四个包的完整文件名、适用 GPU 范围、cu126 包那句全大写警告、默认包自带的 Python 与 PyTorch CUDA 版本、解压与解除锁定的两个必检点、模型该放进哪个目录一次讲清，并给出下错之后怎么快速判定与回退的动作。
桌面版 / portable / 手动装：ComfyUI 三条安装路怎么选
ComfyUI 官方给了桌面版、Windows portable 包、手动安装三条路，README 对它们的定位差别很大：桌面版被明确推荐给新用户，portable 包反而写着不推荐给普通用户。本文按 v0.31.0（2026-08-08）时点的官方仓库口径，从手上是什么硬件、要不要最新模型、能不能接受自定义节点被弄坏、会不会用命令行这四个问题倒推出一条决策路径，并说明桌面版跟随 stable core 构建所带来的滞后代价。
ComfyUI 的 Python 与 PyTorch 版本怎么定：照 README 版本矩阵倒推一条安装命令
装 ComfyUI 之前先把 Python 和 PyTorch 的版本定死，能省掉后面一大半自定义节点装不上、CUDA 起不来的麻烦。本文按官方 README 的版本矩阵，把 Python 3.14/3.13/3.12 三档的取舍、torch 2.7 这条最低线、cu130 在 20 系及以上的强制要求、以及各平台的原样安装命令捋成一条可执行路径，并给出验收清单和不适用场景。
ComfyUI 提示词语法全解：权重、转义、动态提示与 embedding 引用
ComfyUI 的提示词语法只有五条官方规则，但每条都容易读偏：括号权重的默认值是多少、反斜杠该转义谁、花括号的随机到底发生在哪一层、注释挂在哪一节下、embedding 引用为什么可以省掉扩展名。这篇按 README 原文逐条拆开，重点讲这些规则分别由前端还是节点执行，出问题时你该往哪个方向查。
Windows 上装 ComfyUI 的四条路径：桌面版、portable、comfy-cli、手动装怎么挑
Windows 上装 ComfyUI 有四条常见路径，第一步就容易挑错——官方 README 对普通用户明确不推荐 portable 包。本文按官方仓库口径对照四条路径的定位、命令与 Python/torch 版本要求，讲清 portable 四个包别装错哪个、装完怎么验收、各自在什么场景下不适用。
机制与参数
DynamicVRAM 什么时候会被悄悄关掉、五种缓存模式怎么选、精度参数三组各管什么、局部重执行为什么让你觉得"没反应"——搞懂机制才能自己做决定。
读懂 DynamicVRAM：它什么时候会被悄悄关掉
ComfyUI 的 dynamic VRAM 不是一个你打开才生效的开关，而是由源码里的 enables_dynamic_vram() 按五个条件推算出来的状态，默认启动时它是开着的。本文按 v0.31.0 的 comfy/cli_args.py 逐条拆开这段判定逻辑，讲清 --highvram、--gpu-only、--novram、--cpu 这四个开关为什么会顺手把它一起关掉，为什么 --lowvram 在默认状态下什么都不做，--vram-headroom、--reserve-vram、--disable-nvml-pressure 三个参数各自管的到底是什么，以及你该怎么从启动命令和启动日志里确认自己当前处在哪一侧。
为什么改了参数它不重跑：ComfyUI 局部重执行机制怎么读
ComfyUI 里改了节点参数、点了排队，画面却纹丝不动，很多人第一反应是软件卡了。其实官方 README 的执行规则里写得很清楚：只有输入正确的那部分图会执行，且只有相对上一次发生变化的部分会执行。这篇按 v0.31.0 的 README 与 comfy/cli_args.py 拆开这两条规则，给出区分「缓存生效」和「图确实没变」的判定动作，并说明 --cache-none 该在什么时候用、什么时候不该常开。
ComfyUI `--fast` 的四个优化项，开之前要知道的
ComfyUI 的 --fast 是官方自己写了三条警示的参数：未经测试、可能劣化质量、可能让 ComfyUI 崩溃。本文按 comfy/cli_args.py（v0.31.0）的口径讲清它的四个枚举值，以及「不写=不开、写了不带值=四项全开」这条三态逻辑，并给出按需单开、随时可回退的用法与判定排除路径。
ComfyUI 的版本关系：Core、前端、模板包、桌面版到底谁跟着谁
升级 ComfyUI 后界面变了、模板不见了、自定义节点报 import 失败，多半是同一次操作的连带结果。本文按官方 README 的 Release Process 与 v0.31.0 的 requirements.txt，讲清 Core、前端、模板包与桌面版谁跟着谁，以及跟 tag 还是跟 master 的判断依据。
ComfyUI 的六类目录与覆盖优先级：`--base-directory` 和五个单项参数谁说了算
ComfyUI 把模型、自定义节点、输入、输出、临时文件、用户配置分成六类目录，既能用 --base-directory 一次性搬家，也能用五个单项参数逐个覆盖。本文按 v0.31.0 的 comfy/cli_args.py 讲清这两套参数的优先级、哪些路径会在启动时被校验、哪些拼错了也不报错，以及模型搬家该选目录参数还是 extra_model_paths.yaml。
ComfyUI 的五个注意力实现参数怎么选，以及 xformers 在里面扮演什么角色
ComfyUI 五个注意力实现参数互斥，其中两个的 help 明写「用了 xformers 就会被忽略」。本文按 v0.31.0 的 cli_args.py 原始 help，讲清这五个参数的关系、独立开关 --disable-xformers 站在哪一层、两个 upcast 开关怎么用，以及注意力后端连改两版后结论为何要带版本号。
ComfyUI 五种缓存模式该选哪个：从 `--cache-ram` 的默认阈值倒推启动参数
ComfyUI 缓存这一组有五个互斥开关，默认是 RAM 压力缓存。本文按 v0.31.0 的 cli_args.py 讲清 --cache-ram 两个阈值怎么算、--high-ram 为何隐含旧式缓存、--cache-lru 的内存代价与 --cache-none 的取舍，并按内存大小给出选择路径。
pinned memory 上限：Windows 和 Linux 不一样
ComfyUI 启动日志里那行 Enabled pinned memory 后面的数字是算出来的，Windows 和其它系统用的根本不是同一个公式。本文按 v0.31.0 源码原样列出两套公式，拆开非 Windows 那个 max/min 嵌套逐项解释，说清初始值 -1 代表什么、两条 swap 告警各自意味着什么，以及什么时候该考虑 --disable-pinned-memory；顺带给出几条判断依据，帮你确认日志里那行数字对不对得上，以及哪些症状其实和它无关。
unet / VAE / 文本编码器的精度参数各管什么
ComfyUI 的精度开关分成扩散模型、VAE、文本编码器三个互斥组，外加全局开关和几个独立参数，混着加最容易调错地方。这篇按 v0.31.0 的 comfy/cli_args.py 原始 help 把三组参数列全，讲清互斥组意味着什么、force-fp16 为什么会连带影响 unet、fp8 三种变体的 help 只说存储不说计算、fp16-vae 那句黑图警示该怎么用来排查、cpu-vae 为什么不在互斥组里，以及标了 Experimental 的参数要不要放进常驻启动脚本。
部署实战
每篇按同一套写：命令怎么写、产出物落在哪、怎么验收、什么情况不适用。以服务器部署、HTTPS、多卡、完全离线这些能落到生产的用法为主。
把 ComfyUI 部署到服务器上：`--listen`、目录参数与日志落盘的完整启动命令
在服务器上跑 ComfyUI，绕不开监听地址、端口、上传体积、多用户存储、目录规划和日志落文件这几件事。本文按 ComfyUI v0.31.0 的 comfy/cli_args.py 逐个说清这些参数的语义与互相覆盖关系，给出一条可直接复制的完整启动命令和逐条理由，再给出起来之后该检查哪几处、最容易在哪一步出错，并把最容易被忽略的安全前提摆在前面：多用户参数只管存储分离不等于登录，用户名密码认证目前仍是一个 open 的 feature request，TLS 必须成对给参数才生效。
给 ComfyUI 开 HTTPS：自签证书、`--tls-keyfile` 与它管不到的那些事
ComfyUI 的 TLS 开关只有 --tls-keyfile 与 --tls-certfile 成对给出才生效，官方 README 也明说自签证书不适合共享或生产使用。本文按官方 README 与 v0.31.0 的 cli_args.py 口径，给出证书生成命令原文、Windows 上的两条替代途径、容器相对路径挂载写法、验收该查哪几处，以及哪些场景不该这么干。
启用 ComfyUI-Manager 与它的三个开关
ComfyUI-Manager 在 v0.31.0 上不是装完就能用，要先装 manager_requirements.txt 再用 --enable-manager 启动。本文按官方 README 与 comfy/cli_args.py 的口径讲清这两步命令、三个命令行开关各自的语义、互斥与隐含关系，说明为什么禁用界面不等于关掉扩展，并给出多用户与服务器场景下只保留后台任务、关掉 Manager 界面的组合写法、四步验收清单，以及离线机器和生产流水线上不该这么配的几种情形。
让 ComfyUI 完全离线跑：`--disable-api-nodes` 之外还要关掉哪些出网路径
把 ComfyUI 放进不能出网的内网里跑，光拔网线是不够的。官方 README 说核心完全离线、不会主动下载任何东西，但像 --front-end-version 这样从教程里抄来的参数，按它自己的 help 说明本身就需要联网。本文按 v0.31.0 的 comfy/cli_args.py 口径，梳理 --disable-api-nodes、--disable-all-custom-nodes、--front-end-root、--comfy-api-base 各自管的到底是什么，组合成一条离线启动命令该怎么写，模型与预览解码器要提前落到哪几个目录，验收时人要盯哪几处最容易漏，以及哪些场景根本就不该这么干。
ComfyUI 多卡机器上的设备参数：`--cuda-device` 与 `--default-device` 到底差在哪
多卡机器上 ComfyUI 该怎么指定用哪张卡？按 v0.31.0 的 comfy/cli_args.py 对照 --cuda-device 与 --default-device 的 help 语义，讲清「其它设备不可见」与「仍可见」这条关键差别，并给出一卡一实例的启动命令、启动日志验收点与不适用场景。
ComfyUI 日志分级、落文件与 DETAIL 等级：`--verbose` 的三种用法
ComfyUI 的 --verbose 可以不带值、给一个等级、也可以给「等级 + 文件名」，还能重复使用；等级枚举里多出来的 DETAIL 是 v0.30.0 才加的。本文按 v0.31.0 的源码口径讲清三种写法怎么组合、控制台等级由谁决定、日志默认走 stderr 会带来什么麻烦，以及配好后该检查哪几处。
安全与选型
四个已修复的高危漏洞与升级门槛、自定义节点的供应链风险、公网暴露前该想清楚的事、API 节点被下架的风险。给决策路径，不罗列参数。
把 ComfyUI 放到公网前要想清楚的事
从「谁需要访问」倒推，梳理 ComfyUI v0.31.0 里 --listen、--enable-cors-header、--max-upload-size 这几个参数的真实语义，以及官方在 TLS、认证、自定义节点上的现状与边界，帮你判断这台机器该不该、以什么形态对外开放。
依赖 API 节点的工作流有什么风险：从三次真实的节点移除说起
ComfyUI 的 API 节点让工作流可以调用闭源模型，但这类节点会随上游模型退役而被官方从 core 里移除，升级之后工作流可能就打不开了。本文按 v0.31.0（2026-08-08）口径，梳理官方 release notes 里三次真实的移除记录以及同期的新增记录，按「有没有 API 节点、能不能出网、是否进生产、跟 tag 还是跟 master」四个岔口给出决策路径，并说明升级前该检查哪些条目。
ComfyUI 的 assets 系统、数据库与 blake3 哈希：`--enable-assets` 到底要不要开
ComfyUI v0.31.0 里 assets 系统与 blake3 哈希都是默认关闭、需要主动开启的能力。这篇按官方 cli_args.py 的 help 原意拆开三件事：--enable-assets 到底启用了什么、--enable-asset-hashing 官方给的收益与代价分别是什么、--database-url 的默认 sqlite 路径与内存库写法怎么用，最后按模型目录规模和是否多机给一条条件式的决策路径。
ComfyUI 的四个高危漏洞与为什么必须升到 0.28.0
ComfyUI 在 2026-07-15 一次性披露并修复了四个 high 级安全公告，修复版本都是 0.28.0。这篇按「你手上是什么实例」倒推：本机自用、局域网共享、公网可达、生产接口，各自该升到哪个版本、该关掉哪些开关，以及 0.28.0 的修复自己引出的 user.css 回归说明了什么。
ComfyUI 适不适合接进生产流水线
按官方 README 与仓库事实判断 ComfyUI 能不能接进生产流水线：官方给了本地 API、API endpoints 和 App Mode，但端点细节本文没有取到；两周一个大版本、三个精确 pin 的依赖包、partner 节点会被移除，才是决定成败的变量。结论按硬件、联网、是否依赖第三方模型分条件给出。
ComfyUI 自定义节点的供应链风险怎么控：三个官方开关的取舍路径
装了一堆自定义节点，却不知道该怎么控风险？本文不列白名单、不点名节点，只从 ComfyUI v0.31.0 的 comfy/cli_args.py 出发，讲清 --disable-all-custom-nodes、--whitelist-custom-nodes、--disable-api-nodes 各自关掉了什么，--disable-manager-ui 为什么不等于关掉 Manager，并按单机、共享、生产三种处境给出条件式的选择路径。
在 ComfyUI 里跑 MiniMax H3
ComfyUI v0.30.0 起原生支持 MiniMax H3。这几篇讲清模型文件怎么放、分辨率与帧数被什么规则约束、音视频联合 latent 怎么解码，以及它用的量化权重和官方 BF16 权重不是一回事。
音视频联合 latent 是怎么解码成一个 MP4 的
MiniMax H3 的 Omni-Transformer 联合预测视频与音频 latent，落到 ComfyUI 节点图上就是一根 LATENT 线同时接进 VAEDecode 与 VAEDecodeAudio，再由 CreateVideo mux 成 MP4。本文按官方模板与教程页口径拆开这条链路并给出选择依据。
在 ComfyUI 里跑 MiniMax H3：版本门槛、模型放置与 R2V 模板节点链拆解
按官方文档口径梳理 MiniMax H3 在 ComfyUI 里的上手路径：0.30.0 版本门槛与 v0.31.0 的 H3 VAE 修复、五个模型文件该落到哪个目录、T2V/I2V/R2V 三个官方模板的区别，以及 R2V 节点链怎么读、怎么验收、什么情况别这么干。
ComfyUI 里 H3 的分辨率与帧数是怎么定的
ComfyUI 官方 H3 模板里，输出尺寸不是你直接填的，而是 megapixels 经 ResolutionSelector 换算出来的；秒数也不是你填多少就是多少，会被表达式吸附到 17k+5 帧网格。本文按官方教程页与模板 JSON 梳理这两条链路，给出按处境倒推的取值决策路径。
ComfyUI 里的 H3 和官方权重不是同一套
在 ComfyUI 里跑 MiniMax H3，下的是 Comfy-Org/MiniMax-H3 的 pruned_int8_convrot 与 nvfp4_awq 文件；MiniMax 官方 README 写的 checkpoint 精度是 BF16。这篇把两边的文件清单、版本铺路过程和 fl2va 与 ref2va 两套权重讲清楚，并给出一条按自身处境倒推的选择路径，以及为什么两边的结果不该混在一起评估。
MiniMax H3 的五个模型文件分别放哪：ComfyUI 侧的下载来源、目录对应与验收方法
在 ComfyUI 里跑 MiniMax H3 要准备五个模型文件，最常见的翻车不是放错目录，而是从 MiniMaxAI/MiniMax-H3 下了官方 BF16 权重。本文按官方教程与模板文件梳理五个文件与目录的对应关系、下载地址形态、fl2va 与 ref2va 两套权重的区别，以及放完之后怎么在节点里验收。
Ref2VA 的参考标签体系：<Subject N> / <Picture N> / <Video N> / <Audio N> 怎么用
MiniMax H3 的全参考模式 Ref2VA 靠一套参考标签把素材与提示词绑在一起。本文按官方 h3-prompt-writing skill 与 ComfyUI 官方 R2V 模板的口径，讲清四类标签的分工、六段式章节的固定顺序、subject_definitions 与 retention_analysis 的写法规则，以及「按连接顺序引用」这条工程约束。
SGLang / vLLM / diffusers / ComfyUI：H3 四种跑法怎么选
MiniMax H3 官方 README 推荐了 SGLang、vLLM、diffusers、ComfyUI 四个推理入口，四者的落地成本、权重形态与官方给料的详细程度都不一样，其中 ComfyUI 用的还不是官方那套原始权重。本文按官方仓库与 ComfyUI 官方教程的口径，把四条路线各自的版本门槛、下载方式与已知坑位摆清楚，再从你有没有图形界面需求、会不会命令行、要不要接进服务、能不能从 git 分支装依赖这几个真实处境出发，倒推出一组带前提的条件式选择建议。
排查与故障
显存 OOM、每次都重载模型、黑图、老显卡起不来、AMD 与 Apple Silicon 的边界——按官方文档与源码语义给判定方法，官方没给修复方案的地方明说。
别的机器打不开 ComfyUI 页面：先看 `--listen` 而不是查网络
局域网里别的机器打不开 ComfyUI，多半不是路由或防火墙的锅，而是服务端默认只绑 127.0.0.1。本文按 v0.31.0 的 comfy/cli_args.py 口径讲清 --listen 的三种写法、--port 默认值、--enable-cors-header 的真实作用，以及开放监听后的暴露面与验收动作。
采样预览不显示，先看这个参数
ComfyUI 采样时看不到预览图，多数时候不是装坏了，而是 --preview-method 这个开关在源码里的默认值本来就是 none，官方 README 要你自己显式加 auto。本文按 v0.31.0 的 comfy/cli_args.py 与 README，给出怎么确认参数有没有生效、四个取值该选哪个、TAESD 的四个解码器文件该放进哪个目录、改完之后怎么验证，以及出现哪几种迹象就说明问题根本不在这个参数上、该往执行模型和前端版本那边查。
老显卡启动就崩：cudaMallocAsync 这条线索
老显卡上 ComfyUI 装完就崩、连界面都打不开，很多人第一反应是重装驱动、重建环境，一晚上白折腾。这篇按官方参数语义给出一条更省事的排查线：先弄清 --cuda-malloc 这个开关在 torch 2.0 及以上其实是默认开着的，再用 --cpu、--disable-all-custom-nodes、--verbose 三步做减法定位，最后才轮到用 --disable-cuda-malloc 试一把；同时说清楚处置完该验证哪三处，以及出现哪些情况就说明根本不是这个原因，别在一条道上走到黑。
升级后坏了：ComfyUI 的版本回退策略
拉了一次更新，ComfyUI 就起不来、前端变样、自定义节点报错。这篇按官方 README 的 Release Process 规则讲清楚 core、desktop、frontend 三个仓库的关系，为什么回退要退到 stable tag 而不是某个 commit，requirements.txt 里三个被精确 pin 的包会跟着一起换，以及从 v0.22.0 到 v0.31.0 的版本时间线该怎么用来定位回退目标，最后给出判断「不是升级问题」的几条依据。
用二分法定位是哪个自定义节点的锅：`--disable-all-custom-nodes` 与白名单放行
ComfyUI 升级后启动报错、界面加载不出来、日志里冒出内存泄漏告警，多半和某个自定义节点有关，但插件装了几十个，一个个删太慢。这篇按 v0.31.0 的 comfy/cli_args.py 讲清 --disable-all-custom-nodes 与 --whitelist-custom-nodes 的组合语义，给出先全关确认、再逐批放行的完整二分流程，以及处置后怎么验证、哪些现象其实和自定义节点无关。
AMD 卡上 ComfyUI 跑不动的排查清单
AMD 卡上 ComfyUI 装不上、起不来或者卡在加载环节，同一句「跑不动」可能落在完全不同的层上。本文按官方 README 与 comfy/cli_args.py（v0.31.0）的口径，把排查拆成五步：先确认 torch 是否为 ROCm 构建，再选对稳定版还是 RDNA3、3.5、4 的实验性 nightly，然后是 HSA_OVERRIDE_GFX_VERSION 的两个取值、卡在加载时该逐个关掉哪几个开关、以及 Triton 后端在 AMD 上的自动默认，最后列出哪些常见现象其实与 AMD 无关，避免一条道走到黑。
ComfyUI 报 CUDA no kernel image is available：成因方向与判定路径
这条报错在 ComfyUI 上最常见的成因方向是显卡代次与 PyTorch 的 CUDA 构建对不上。本文按官方 README 的版本矩阵和 Windows portable 分包规则，给出一条可执行的判定路径：先定卡的代次、再定 torch 构建、最后才动手换包，并列出哪几类报错根本不该往这个方向查。
ComfyUI 报 CUDA OOM 时的排查顺序
ComfyUI 抛出 CUDA 显存不足时，多数人第一反应是加 --lowvram，但在当前版本这个开关很可能什么都不做。这篇按启动日志、dynamic VRAM 判定、保留显存三层给出可执行的排查顺序，讲清 --reserve-vram 与 --vram-headroom 的语义差别与 EXTRA_RESERVED_VRAM 的默认值，并列出哪些现象其实不是显存问题。
ComfyUI 报 memory leak 告警怎么办：先分清两条文案，再做二分排查
ComfyUI 控制台里冒出 Potential memory leak detected 和 WARNING, memory leak 两条告警时，多数人第一反应是重装或者回滚版本。本文按 v0.31.0 的源码日志文案逐字拆开这两条的差别与严重程度，给出先抄哪几行启动日志作为基线、怎么用 --disable-all-custom-nodes 配合白名单参数做二分排查、处置之后怎么验证告警是否真的消失，以及缓存策略、pinned memory 等哪几类内存占用偏高其实跟泄漏无关、不该顺着这条路一直走下去，最后说清什么时候才具备去仓库提 issue 的条件。
ComfyUI 报 Torch not compiled with CUDA enabled 怎么修
这条报错要修的是 torch 的安装，不是 ComfyUI 的启动参数。本文按官方 README 口径讲清楚：怎么确认确实是它、README 唯一给出的处置、各平台原样安装命令、cu130 对 20 系及以上为何必需、portable 与手动安装用户的动作差别，以及处置后怎么验证、什么情况说明不是这个原因。
ComfyUI 的 `--lowvram` 为什么不管用了
老教程里「显存小就加 --lowvram」这句话，在当前版本的 ComfyUI 上大概率什么都没做。原因写在 cli_args.py 的 help 原文和 enables_dynamic_vram() 这个判定函数里。这篇讲怎么用启动日志和参数对照确认自己是不是撞上了这件事、真正该动的是 --reserve-vram 与 --vram-headroom 里的哪几个、改完怎么验证，以及什么情况下说明你的问题根本不在这条线上。
ComfyUI 改一次提示词就重载一次模型：缓存模式与局部重执行的排查路径
只改了提示词里的一个词，日志却又打出一遍 Requested to load。本文按 ComfyUI v0.31.0 的源码与 README 口径，讲清楚怎么用日志确认重载真的在发生、五种缓存模式的语义与 --cache-ram 的默认阈值算法、为什么 --cache-none 与 --high-ram 常帮倒忙，以及哪些迹象说明问题不在缓存策略上。
ComfyUI 模型加载慢：能调的几个开关
点了运行之后长时间停在 Requested to load 那一行，多数时候不是显卡不行，而是加载路径上的开关没配对。本文按 ComfyUI 官方仓库与源码口径梳理 v0.23.0 的多线程磁盘加载、v0.30.0 的 pinning 与 MRU 策略、--fast-disk 的适用前提，以及经常被混为一谈的 --mmap-torch-files 与 --disable-mmap，给出怎么判断是加载慢、该动哪个开关、改完怎么验证，以及什么情况说明问题根本不在加载路径上。
ComfyUI 启动日志逐行读懂：八行关键信息与 VRAM 状态机
ComfyUI 出问题时，线索大多藏在启动那二十来行日志里。本文按 v0.31.0 的源码文案，解释显存总量、VRAM 状态、pinned memory、异步卸载、xformers 版本这八行日志在说什么，以及 --verbose 的六个等级、日志默认走 stderr 该怎么抓全，并给出验证方法与不该在这层折腾的情况。
ComfyUI 前端出问题该提到哪个仓库：三路分流规则与 `--front-end-version` 的用法
ComfyUI 的前端自 2024-08-15 起已迁到独立仓库，界面问题提到主仓容易被转走。本文讲怎么判定问题落在前端、核心还是工作流模板：看 requirements.txt 的 pin 行，用 --front-end-version 切换前端版本做对照，再按官方模板的三路分流规则提对地方，并说明哪些现象不算前端。
ComfyUI 生成出黑图：官方口径里只有这三条线索
出图打开是一张纯黑，网上能搜到十几种说法，但在 ComfyUI v0.31.0 的源码与 README 里，明确写着 black images 的地方其实只有三处：`--fp16-vae` 的 help 警告、启动日志里那条 xformers 高分辨率黑图告警、以及 `--force-upcast-attention` 的 help 留下的上报入口。本文把这三条线索分别拆成怎么确认、官方给出的处置、处置之后怎么验证，以及什么情况说明不是它；其余原因官方文档里没有写，本文一条都不猜。
ComfyUI 在 Apple Silicon 上的已知边界：先分清是 MPS 的限制，还是你装错了环境
在 Mac 上跑 ComfyUI，报错常被笼统归给「M 芯片不行」，排查就此停摆。本文按官方仓库与源码口径，梳理 Apple Silicon 这条安装路径官方给了什么、又没给什么，教你用启动日志里的两行和几个判定动作，把 MPS 已知限制、环境装错、自定义节点惹的祸分开，并说清哪些启动开关只能试、不能当解药。
ComfyUI 在无 swap 分区的 Linux 上 pin 太多内存：v0.31.0 之前怎么判定与规避
没划 swap 分区的 Linux 机器上跑 ComfyUI，pinned memory 的上限要按一条把 swap 算进去的公式取值。本文按源码里的两套公式和两条与 swap 有关的告警文案，讲清楚怎么从启动日志判定自己是不是撞上了这件事、v0.31.0 修掉的到底是什么、旧版本上关 pin 与调缓存阈值该怎么用，以及哪几种情况说明不是这个原因。
想把生成式模型真正接进自己的流水线，而不只是点点按钮？
从 AI 编程实践到 Agent 工程落地，站内有成体系的教程与课程。