ComfyUI-SUG启动助手--选项（在助手内可以手动选择的参数）

1. 核心运行引擎 (硬件选择)

决定程序是依赖显卡（GPU）还是处理器（CPU）运行。

参数	对应选项	推荐场景
(留空)	适用 GPU	默认推荐。只要有 NVIDIA 显卡就选这个。
--cpu	仅适用 CPU	没显卡、显卡驱动报错或显存完全不足时（速度极慢）。

2. 显存策略优化 (VRAM Management)

根据显卡硬件的物理显存大小来选择。

参数	对应选项	适用显存	运行特点
(留空)	自动模式	系统自动判断	适合新手，由 ComfyUI 自行分配。
--highvram	高显存模式	16G - 24G	生图最快。模型常驻显存，减少加载等待。
--normalvram	默认模式	8G - 12G	平衡型。兼顾速度与稳定性，主流用户首选。
--medvram	低显存模式	4G - 6G	牺牲速度保容量。将模型切分加载，防止溢出。
--lowvram	极低显存模式	4G 以下	保底模式。速度极慢，仅为了能跑通大模型。

3. 计算精度设置 (Precision)

平衡生成速度、显存占用与画质稳定性。

参数	对应选项	推荐场景
(留空)	自动模式	由系统根据显卡驱动自动选择最匹配精度。
--force-fp16	半精度 (FP16)	主流选择。RTX 显卡必选，显存占用减半，速度翻倍。
--force-fp32	全精度 (FP32)	老卡/稳定版。GTX 老显卡或遇到黑图、花屏时开启。
--bf16-unet	U-Net 优化	RTX 30/40 系列专用。与 FP16 配合可进一步加速，稳定性极佳。

4. 实时预览模式 (Preview)

控制生图过程中间状态的显示效果。

参数	对应选项	视觉效果
(留空)	自动模式	默认预览。
--preview-method latent2rgb	快速预览	速度快，但画面模糊，只能看个大概轮廓。
--preview-method taesd	高清预览	预览图更清晰，能更早看出构图是否正确，稍微消耗一点资源。

5. 自动化与网络设置

提升操作便捷度及局域网协作。

参数	功能	说明
--auto-launch	自动打开浏览器	程序启动完毕后，自动弹出 ComfyUI 网页界面。
--disable-auto-launch	禁止自动打开	启动后静默运行，需手动输入地址访问。
--listen 0.0.0.0	局域网监听	允许同网络下的手机、平板或其他电脑访问此 ComfyUI。

更多 ComfyUI 启动参数（可另外自定义添加）

1、 显存与精度优化 (最核心)（单选）

这部分直接决定了用户能否跑通模型，以及生图的速度。

参数	推荐场景	技术特点
--fp8_e4m3fn-vram	6G/8G 显存首选	8位精度，速度最快。在低显存下画质损失极小，平衡感最好。
--fp8_e5m2-vram	低显存备选	比 e4m3fn 更耐“溢出”。如果用前者频繁报错，换这个。
--bf16-vram	RTX 30/40系列显卡	最稳定。数值范围广，基本不会出黑图。现代显卡用户必开。
--fp16-vram	GTX 10/20系列显卡	老显卡的标准半精度。注意：在某些模型上可能因溢出导致黑图。

2、 稳定性与兼容性 (防黑图/防崩溃)（可复合多选）

专门处理某些特定硬件或环节的报错。

• --fp16-vae / --bf16-vae

  • 作用： 仅针对 VAE 解码环节。（单选）

  • 优化建议： 很多用户生图过程正常，但最后一步**“解码生成图片”时突然变黑**，开启此项能极大缓解。优先尝试 bf16-vae。

• --use-split-cross-attention

  • 作用： 极大降低显存占用。

  • 推荐： GTX 16系列（如 1660Ti, 1650） 必带。虽然速度稍慢，但能保住不崩。

• --use-pytorch-cross-attention

  • 作用： 强制使用原生加速。

  • 推荐： 环境配置正确的高性能显卡（30/40系列）开启，可提升生图效率。

3、 功能与自动化 (提升体验)（可复合多选）

让程序更聪明，更符合用户习惯。

• --auto-launch

  • 评价： 强烈建议默认开启。启动后自动弹窗，用户不需要手动记 127.0.0.1:8188。

• --enable-manager

  • 评价： 必备参数。没有 ComfyUI-Manager 的 ComfyUI 是没有灵魂的。

• --disable-metadata

  • 场景： 想要**“无痕发图”**时使用。图片不包含 JSON 工作流，保护个人配置隐私。

• --port [数字]

  • 场景： 防冲突。如果你正在写易语言多开器，这个必须支持自定义。

4、 路径管理 (解决空间焦虑)（可复合多选）

• --extra-model-paths-config [路径]

  • 核心用途： 模型共享。直接读取 Stable Diffusion WebUI 的 models 文件夹，不用重复下载几十 GB 的模型。

• --output-directory [路径]

  • 核心用途： 存储迁移。把生成的几千张图重定向到机械硬盘或大容量分区。