ComfyUI Nodes for AsymFlow and pi-Flow：支持 FLUX.2 Dev 与 AsymFLUX.2，4 步极速生成与像素级逼真渲染新方案
ComfyUI Nodes for AsymFlow and pi-Flow是一个为 ComfyUI 提供的自定义节点集合，实现了对AsymFlow和pi-Flow的支持。前者致力于在像素空间中实现极致的逼真度与细节还原，后者则通过创新的流匹配算法，将高质量图像生成的采样步数压缩至惊人的 4 步。
- GitHub：https://github.com/Lakonik/ComfyUI-piFlow
这一更新不仅大幅提升了生成效率，更为 FLUX.2、FLUX.1 及 Qwen-Image 等主流模型提供了更强悍的性能扩展方案。
AsymFlow：像素空间的极致逼真
AsymFlow 是一种基于 FLUX.2 klein Base 9B 的适配器技术，旨在将模型转换为用于文本到图像生成的像素空间 AsymFlow 模型。与传统潜在空间生成不同，它在像素空间中直接优化，从而保留更多高频细节和真实感。
1. 三大变体，按需选择
为了平衡多样性与稳定性，AsymFLUX.2 klein 9B 提供了三个版本的 LoRA 适配器：
| 变体名称 | 特点 | 适用场景 |
|---|---|---|
| 基础适配器 (Base) | LAION 子集训练，最原始、多样、创意丰富。审美偏见最小，但文本和解剖结构需精细提示词引导。 | 艺术创作、概念设计、追求极致多样性。 |
| SFT Z-Image Turbo | Z-Image Turbo合成数据微调。多样性略降，但文本渲染、解剖结构更稳定，风格一致性强。 | 商业插画、需要稳定角色/文字输出的场景。 |
| SFT FLUX.2 klein | FLUX.2 Distilled合成数据微调。特性同上，更贴近官方蒸馏版风格。 | 追求官方风格一致性且需更高稳定性的任务。 |
2. 部署指南
- 基础模型：
flux-2-klein-base-9b-fp8.safetensors→models/diffusion_models/ - 适配器 (LoRA)：根据需求选择对应版本 →
models/loras/ - 文本编码器：
qwen_3_8b_fp8mixed.safetensors→models/text_encoders/ - 实时预览：启动 ComfyUI时添加参数
--preview-method auto --preview-size 1024以启用高清实时像素预览。 - GGUF 支持：安装
ComfyUI-GGUF节点后，可使用Load AsymFlow Model (GGUF)节点加载量化模型，节省显存。
pi-Flow：4 步极速生成的革命
pi-Flow 是一种全新的基于流的少步生成方法。它通过优化采样轨迹，仅用 4 个采样步数即可生成高质量、高多样性的图像。相比传统的 DMD 模型，pi-Flow 在保持速度的同时显著提升了结果的多样性，且与基础模型输出高度一致。
1. 支持模型与配置
pi-Flow 目前支持三大主流模型家族，每种模型均有特定的配置要求：
| 模型家族 | 基础模型 | pi-Flow 适配器 | 文本编码器 | VAE | 关键配置 |
|---|---|---|---|---|---|
| pi-Qwen-Image | qwen_image_fp8_e4m3fn.safetensors | gmqwen_k8_piid_4step | qwen_2.5_vl_7b_fp8_scaled | qwen_image_vae | 采样步数 ≥4 |
| pi-Flux (1 Dev) | flux1-dev.safetensors | gmflux_k8_piid_4step / 8step | clip_l + t5xxl_fp16 | ae.safetensors | Guidance = 3.5 (固定) |
| pi-Flux.2 Dev | flux2_dev_fp8mixed.safetensors | gmflux2_k8_piid_4step | mistral_3_small_flux2_fp8 | flux2-vae | Guidance = 4.0 (固定)，步数 ≥4 |
2. 核心优势
- 极速响应：4 步即可完成高质量生成，速度提升数倍。
- 高多样性：避免少步采样常见的模式崩溃问题，结果丰富多变。
- 多任务支持：pi-Flux.2 特别支持文本到图像生成及多图像编辑任务。
安装与注意事项
1. 环境要求
- ComfyUI 版本：需 0.17.0 或更高版本。
- 清理旧版：安装前请卸载任何非官方的 AsymFlow 或 pi-Flow 扩展，以避免兼容性问题。
2. 安装步骤
方式一：ComfyUI Manager（推荐）
加载官方提供的工作流文件，Manager 会自动识别并安装缺失的节点。
方式二：手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/Lakonik/ComfyUI-piFlow
# 重启 ComfyUI
3. 重要提示
- Guidance Scale 锁定：对于 pi-Flux 和 pi-Flux.2，务必将 Guidance Scale 设置为指定值（3.5 或 4.0），切勿修改，否则会导致生成质量严重下降。
- 显存优化：AsymFlow 和 pi-Flow 均针对 FP8 模型进行了优化，建议在显存有限的环境下使用 FP8 版本的基础模型和文本编码器。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
