# Krea 2 (K2) 图像模型 · ComfyUI 部署配置记录

> 配置日期：2026-09-08 · 目标机：GPU 机（RTX 5060 Ti 16GB · ComfyUI 0.34.0）
> 状态：✅ 完成并验证通过（Turbo fp8_scaled 原生加载 + 1024×1024 测试出图成功）

## 一、结论速览

- Krea 2 是 Krea AI 开源的图像基础模型（RAW=基础版可微调 / Turbo=8步蒸馏版出图快），官方称"最具美感的开源图像模型"。
- **部署形态**：官方 ComfyUI repack（`Comfy-Org/Krea-2` 仓库）单文件权重 + **ComfyUI 内核原生 Krea2 支持**，**未安装任何第三方自定义节点、未重启 ComfyUI**。
- 官方 BF16 权重 26.6GB/个，16GB 卡必须量化；本机选用 `krea2_turbo_fp8_scaled.safetensors`（13.1GB，fp8 缩放量化，画质接近 BF16）。
- 文本编码器：`qwen3vl_4b_fp8_scaled.safetensors`（Krea2 的 TE 是 Qwen3VL 系，ComfyUI CLIPLoader 类型选 `krea2`）。

## 二、⚠️ 环境地址说明

- GPU 机内网 IP 已于 **2026-09-06 由 DHCP 重分配**：`192.168.31.25` → **`192.168.31.31`**（.25 已 100% 丢包；见 `dl-hub/06-ComfyUI-H3运维记录/2026-09-06-SageAttention是否导致GPU掉线-核实.md`）。本次操作全链路实测 .31 正常。
- ComfyUI API/Web：`http://192.168.31.31:8189`（本机访问需 `curl --noproxy '*'`）。
- ⚠️ `~/.dsh/AGENTS.md` 等备忘仍写 .25（未同步），建议尽快更正，避免后续会话继续踩错地址；更稳妥做法是路由器给 GPU 机 MAC 绑定固定 IP。

## 三、已安装文件（均在 GPU 机 ComfyUI models 下）

| 文件 | 目标目录 | 大小 | 来源 |
|---|---|---|---|
| `krea2_turbo_fp8_scaled.safetensors` | `models/diffusion_models/` | 13.1 GB | `hf-mirror.com/Comfy-Org/Krea-2`（HF 官方源 gated，走镜像） |
| `qwen3vl_4b_fp8_scaled.safetensors` | `models/text_encoders/` | 5.2 GB | 同上 `text_encoders/` |
| `qwen_image_vae.safetensors` | `models/vae/` | 253 MB | 同上 `vae/` |

镜像下载命令示例：
```bash
curl -L -C - -o /home/zyw/ComfyUI/models/diffusion_models/krea2_turbo_fp8_scaled.safetensors \
  https://hf-mirror.com/Comfy-Org/Krea-2/resolve/main/diffusion_models/krea2_turbo_fp8_scaled.safetensors
```

仓库内还有可选版本（未来需要再补）：`krea2_raw_*`（RAW 基础版）、`*_int8_convrot`、`*_nvfp4`、`*_mxfp8`，以及官方 LoRA（darkbrush/retroanime/softwatercolor 等，各带触发词，见 Comfy-Org/Krea-2 仓库 README）。

## 四、为何不装 GGUF / 第三方节点

- 备选方案 molbal GGUF（Q5_1 ≈ 10.7GB）需额外安装 RealRebelAI/ComfyUI-GGUF_KREA-2 等第三方加载节点；GPU 机访问 GitHub 不稳定（ls-remote 超时）。
- 本机 ComfyUI **0.34.0 内核已原生注册 Krea2 架构**（`comfy/supported_models.py` 含 `class Krea2`，`comfy/text_encoders/krea2.py`），且已装 city96 ComfyUI-GGUF 与本机既有 Dasiwa/minimax/ltx 原生单文件加载模式一致 → 官方 repack 单文件最稳妥。

## 五、出图参数（已验证）

节点链：`CLIPLoader(type=krea2)` → 正向 `CLIPTextEncode`；负向走 `ConditioningZeroOut`（Turbo 免 CFG）→ `EmptySD3LatentImage` → `KSampler` → `VAEDecode(qwen_image_vae)` → SaveImage

- sampler：`er_sde` · scheduler：`simple` · steps：**9** · cfg：**1**（负向置零）
- 分辨率：RAW 训练上限 1k；Turbo 支持 1k~2k
- 提示词语言：英文效果最佳（TE 为 Qwen3VL 系，理论上支持中文）

## 六、验证记录（2026-09-08）

- [x] 三文件落位 + 大小校验：unet 13,141,730,784 B / TE 5,242,467,968 B / VAE 253,806,246 B —— 与 hf-mirror LFS 大小逐字节一致（hf-mirror 直连下载，GPU 机 11:16 起，约 45 分钟下完，平均 ~7MB/s）
- [x] 无需重启：运行中的 ComfyUI 0.34.0 `/object_info` 已即时识别三个新文件（内核自带 Krea2 架构注册）
- [x] API 测试出图：POST `/prompt`（结构见 `krea2-api-prompt-example.json`），无节点错误
  - 提示词：雪地晨光中的赤狐（cinematic photo …）
  - 参数：1024×1024 · steps 9 · cfg 1（负向 ConditioningZeroOut）· er_sde / simple
  - 耗时：提交到 execution_success ≈ **142 秒**（含 13GB 模型首次加载；二次生成会更快）
  - 输出：`ComfyUI/output/krea2_test_00001_.png`（已回传本目录 → `krea2测试图_狐狸_1024_00001.png`）
- [x] 质量核验：DeepSeek Vision 识图确认——赤狐行走于雪地松林、晨光虚化、高清无花屏/噪点/崩坏，符合提示词
- 分辨率说明：Turbo 原生支持 1k~2k（RAW 上限 1k）；16GB 显存建议 1024~1536 边长，2k 请配合 --lowvram 并留意显存

## 七、使用方式

1. **GUI（推荐日常用）**：打开 `http://192.168.31.31:8189` → 左侧 Workflow 列表选择
   `krea2_turbo_gui.json`（已放入 `user/default/workflows/`）→ 改提示词 → Queue。
   工作流结构：Load CLIP(krea2) → CLIP Text Encode → Conditioning Zero Out(负向) → EmptySD3LatentImage → UNETLoader(fp8) → KSampler(er_sde/simple/9步/cfg1) → VAE(qwen_image_vae) → Save。
2. **API**：POST `http://192.168.31.31:8189/prompt`，JSON 模板见同目录
   `krea2-api-prompt-example.json`（本机需 `curl --noproxy '*'`）。
3. 出图保存于 GPU 机 `ComfyUI/output/`。

## 八、后续可选（需要时再做）

- 下载 RAW 版或 int8_convrot / nvfp4 / mxfp8 变体、官方风格 LoRA（darkbrush/retroanime/softwatercolor 等，各带触发词，清单见 Comfy-Org/Krea-2 仓库 README）；
- LoRA 建议 RAW 训练、Turbo 出图（官方推荐组合）；
- 若嫌 9 步不够，可小步试 steps 6–12 对比质量。

## 九、已装 LoRA 清单（GPU 机 models/loras/）

| 文件 | 来源 | 大小 | SHA256 | 说明/用法 |
|---|---|---|---|---|
| `krea2_darkbrush.safetensors` | Comfy-Org/Krea-2（官方风格包） | 447.55 MiB | — | 墨染水墨风，触发词 `monochrome ink wash style`，强度 ~1.0 |
| `KNP_000003000.safetensors` | Civitai "Krea 2 NSFW V4" v4.3_EXP（作者 19doorsside884，CivitArchive 登记 SHA 验证） | 435.94 MiB（457,111,960 B） | `6ec564e04eed317ae24093b4907004ac59a7c528d19d025bb41b4d719c4d16ec` | Krea 2 写实向 NSFW LoRA；**V4 起无需触发词**；建议强度 0.8→1→1.2→2（常用 1~1.5）；勿堆砌提示词、多用短句（详见作者 prompt 指南）；转载源：huggingface.co/Kutches/Kr3a |

- 加载方式：ComfyUI 里在 KSampler 前加 `LoraLoader`（model 接 UNETLoader 输出、clip 接 CLIP 输出），或 `LoraLoaderModelOnly`；文件列表已即时刷新，无需重启。
- KNP 下载链路备忘：civitai.com / civitai.red 直连不可达且需登录 → CivArchive 页拿到 SHA 与 33 个 HF 转载源 → hf-mirror + 迅雷 ~30s 下载 → SHA256 与源一致 → LAN scp。

## 十、Krea2Turbo 2pass(10Eros) 工作流导入记录（2026-09-09）

- 工作流：`user/default/workflows/Krea2/Krea2Turbo_2pass_10Eros.json`（用户上传的韩国 2pass+FaceDetailer 流，50 节点+2 子图）
- **策略改写**（16GB 卡用本地档，不下载 26GB BF16）：主模型→`krea2_turbo_fp8_scaled.safetensors`；TE→`qwen3vl_4b_fp8_scaled.safetensors`；SAM→`sam_vit_h_4b8939.pth`；检测器→`bbox/face_yolov8m.pt`；放大段 `CRT_UpscaleModelAdv`（上游新版已删）→核心 `ImageScale`
- **新增安装节点包**（12 个，github→DSH 中转→scp，重启后全注册）：Easy-Use、comfyui-ollama、AlekPet 翻译、Comfyroll、mxToolkit、CRT-Nodes、eros EulerDiscreteScheduler、Rebalance-Pack、Krea2T-Enhancer、krea2-negpip、KreaSeedVarianceEnhancer；依赖含 clip-interrogator/spandrel/deep-translator 等，torch 2.11+cu130 完好
- **新增 LoRA**（models/loras/krea/，迅雷+scp）：krea2-masterpieces-v51(205MB)、krea2filterbypass3(160B)、realism_engine_krea2_v3.1(1.49GB)、snofs_krea_v1_1(1.49GB)、krea2-bloomgirls-realism-step00004000(448MB,同源正式版)；另 `krea/haru/` 目录已建
- **未找到公开源**（条目保留但已关闭/不可用）：harustyle_v3（唯一开启项→已置 off）、harustyle_v2、Krea2_Nikki_Style_Anime、Detailer_-_Krea2_project（仅 civitai 登录源）
- 核验：流程内全部真实节点类型已注册（REAL-MISSING: NONE）；7 只 LoRA+SAM/检测器/双放大模型均在 loader 列表
- 提醒：硬刷新浏览器后从 Workflow 列表 Krea2 分组打开；Ollama 链与放大重绘分支默认旁路（bypass），启用需本机 ollama 服务(:11434)与模型

## 十一、Civitai API Key 配置（2026-09-09 更新）
- Key 已存本机 `~/Downloads/civitai_api_key.txt`（chmod 600，勿外发）。
- 可用端点：`civitai.red`（`Authorization: Bearer <key>`，/api/v1/me 200 = 账号 coolerman；文件下载对普通档有效，如 Krea2 NSFW v4.3 原档可直接拉）。官方 `civitai.com` 出口在本网被 DNS 污染不可达，`b2.civitai.com` CDN 直连/迅雷均不通。
- 经 key 测试结论：
  - `Detailer_-_Krea2_project`(v3144156)：作者设 **Early Access(Buzz 付费)**，key 无法绕过 → 仍缺。
  - bloomgirls 4k beta(v3075850)、harustyle v1.6(v3196113)：key 可拿签名直链但 B2 CDN 本网不可达 → 无法下载；bloomgirls 以 krea/ 内正式版 v1.0 替代，harustyle 仍缺（等公开镜像/作者放出）。
  - `Krea2_Nikki_Style_Anime`：civitai 与 HF 均无此公开文件 → 仍缺。

## 十二、启动方式变更（2026-09-09，按用户要求）
- 当日先按用户要求试**近裸启动**（仅 --listen/--port，NORMAL_VRAM 自动），实测出图明显变慢（16GB 卡边界显存反复腾挪）→ 用户确认后**已回退到完整优化参数**运行。
- 现行启动命令（稳定版）：`cd /home/zyw/ComfyUI && nohup env PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:512,expandable_segments:True CUDA_VISIBLE_DEVICES=0 OMP_NUM_THREADS=4 venv/bin/python main.py --listen 0.0.0.0 --port 8189 --lowvram --force-fp16 --reserve-vram 1.0 --fast-disk --cache-lru 20 --preview-method none > /home/zyw/comfyui_8189_opt.log 2>&1 &`（LOW_VRAM）。
- `start_comfyui_v4.sh`（含 --use-sage-attention 变体）仍保留备用。

## 十三、JANK2 - Anime Krea2 Turbo 下载部署（2026-09-11）
- Civitai `models/2897086` v1.0（Krea 2 动漫向微调）原档 **Early Access（Buzz 付费，2026-09-19 21:33 UTC 解锁）**，key 拉取 403；改用作者 HF 镜像 `janxd/JANk2`（LFS sha256 与 Civitai 登记值一致）→ hf-mirror + 迅雷 ~25MB/s 十分钟下完。
- 已部署：`/home/zyw/ComfyUI/models/diffusion_models/JANK2_v1.0_INT8_CONVROT.safetensors`（14,135,089,176 B，sha256 `ed1ea73c...d147d` 双向校验一致）；ComfyUI `/object_info/UNETLoader` 已可见。
- 用法：Krea2 工作流 UNETLoader 的 `unet_name` 换成该文件即可（TE 仍 `qwen3vl_4b_fp8_scaled.safetensors`）；推荐参数 1024-2048px / 8 步 / CFG 1 / euler-er_sde + simple-normal；默认即出动漫风，无需 anime 风格词；未内置去审查。
- 详情见同目录 `JANK2-Anime-Krea2-Turbo下载与部署记录.md`。

## 十四、JANK2 官方样图内嵌工作流提取（2026-09-11）
- 作者 9 张官方样图中 **8 张是 PNG 直出**，含完整 ComfyUI 工作流（`tEXt: workflow` ≈143–151KB + `prompt` API 格式），已提取成可直接加载的 JSON。
- 该工作流 = **Gladas' Workflow for Krea 2 Turbo v3**（134 节点）+ `AlexImagePicker`，仅把 UNet 换成 `JANK2_v1.0_INT8_CONVROT.safetensors`；Gladas v3 原版也已下载对照。
- 样图参数：832×1216 起手 → USDU 2× 到 1664×2432；8 步 / cfg 1.0 / euler / normal；Detailer ×3（手/脸/眼，denoise 0.22）；LoRA 槽全关；负向为空；出图用 Image Saver（embed_workflow=true，所以才有工作流可提取）。
- 本机跑它还缺 5 个插件包（ComfyMath、Image-Saver、Inspire、Easy-Color-Corrector、gps-supplements）与 3 个检测器模型；主链（UNet+CLIP+VAE+SamplerCustomAdvanced）现有环境即可跑。
- 产出目录：`JANK2样图工作流/`（README + workflow/ + 样图/ + 元数据/）。提取要点：Civitai 图片 API **必须带 `nsfw=X`** 才返回 meta；原图需走代理（image.civitai.com 被 DNS 污染）。