用途:这是一份 ComfyUI 启动与性能命令行参数的决策矩阵,帮助在显存不足(OOM)、速度过慢或输出异常时挑选合适的 main.py 参数。
主要能力:资料按三类参数给出选择依据。显存策略(互斥,只选一个):--gpu-only、--highvram、--lowvram、--novram、--cpu,默认是智能卸载;修饰参数 --reserve-vram N 为系统预留显存,--disable-smart-memory 强制卸载到内存,异步卸载相关开关可切换。注意力后端(互斥,只选一个):--use-ck-attention(kitchen INT8,无需 sage wheel)、--use-sage-attention(约快 20–40%,需版本匹配的 sageattention)、--use-flash-attention、--use-pytorch-cross-attention(默认安全回退)、--enable/--disable-triton-backend 等。缓存模式(互斥):默认 --cache-ram、--cache-classic、--cache-lru N、--cache-none。此外 --fast 可启用 fp16_accumulation、fp8_matrix_mult 等实验性加速。三类参数可各取其一组合,如 --novram --use-sage-attention --cache-none。
使用方式:这些参数在自行启动 ComfyUI 时传入(python main.py 加参数),工具 restart_comfyui 的 start 动作会原样保留上一次 argv,不负责拼装新参数。
适用场景:长视频模型 OOM 用 --novram(可配 --cache-none);Windows 共享显存导致降速用 --reserve-vram 2 到 4;大文本编码器不卸载用 --cache-none;高显存追求吞吐用 --gpu-only 或 --highvram。注意 Z-Image 用 sage 会输出黑图,应改用 --use-pytorch-cross-attention;某些模型 sage 黑图也需回退。参数可能随版本增删,以 python main.py --help 为准。具体平台支持与数值请以实际环境为准。