AIGC 工业设计 · 本地 AI 绘画工作流
从零搭建Krita + ComfyUI
本地 AI 绘画环境
面向工业设计师的一站式图文教程：Krita 安装 → ComfyUI 安装 → 连接插件安装 → 必装大模型安装。全部免费开源、本地运行、数据不出电脑， 支持线稿上色、局部重绘、风格迁移、超分辨率放大。
🗺️ 这套工作流长什么样
🎨
Krita
画布 · 线稿 · 手绘
→
🔌
krita-ai-diffusion
连接插件 · 双向通信
→
⚙️
ComfyUI
本地引擎 · 跑大模型
Krita 里选中区域 → 写提示词 → ComfyUI 在本机生成 → 结果实时回填到 Krita，全程可无限迭代
📋 教程目录
🎨
第 1 步
安装 Krita
Krita 是什么？
免费开源的数字绘画软件（Windows / macOS / Linux），业界公认的专业绘画工具，常用于概念设计、 线稿、插画、工业设计草图。它是本工作流的「画布」——AI 生成的结果会直接进到 Krita 图层里。
1
下载安装包：打开官网 krita.org → 点 Download → 选择你的系统版本（Windows 下载 .exe 安装包）。
2
安装：双击安装包按提示下一步即可（安装路径避免中文和空格）。
3
验证版本：打开 Krita → 菜单 帮助 → 关于 Krita，版本号必须 ≥ 5.2.0（连接插件的最低要求）。
4
验证可用：新建画布随便画两笔，确认手绘正常即完成。
⚙️
第 2 步
安装 ComfyUI
ComfyUI 是什么？
本地 AI 图像生成引擎（节点式工作流），Krita 插件的「大脑」。大模型在你自己的电脑上运行， 图片不外传。支持 Stable Diffusion 1.5 / SDXL / Flux / Z-Image 等主流架构。
方式 A（推荐 · Windows 便携版，零配置）
1
下载便携版：打开 ComfyUI Releases 下载
ComfyUI_windows_portable.7z （约 1.5GB，不含模型）。2
解压：用 7-Zip / WinRAR 解压到任意目录（路径避免中文和空格，例如
D:\ComfyUI）。3
启动：双击
run_nvidia_gpu.bat （NVIDIA 显卡）或 run_cpu.bat（无独显）。4
验证：浏览器打开
http://127.0.0.1:8188 看到 ComfyUI 界面即成功（本机地址，不对外网开放）。方式 B（手动安装 · 任意系统通用）
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
pip install -r requirements.txt
python main.py要求 Python 3.10+；NVIDIA 显卡需 CUDA 环境；无显卡用 CPU 也能跑（速度慢）。
建议顺手安装：ComfyUI Manager（节点/模型管理器）
cd ComfyUI
# 进入 custom_nodes 目录
cd custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager
# 重启 ComfyUI，界面会出现 Manager 按钮为什么建议装 Manager？
后面第 3 步的插件依赖 4 个自定义节点，用 Manager 的「Install Custom Nodes」搜索安装最省事，不用手动 git clone。
🔌
第 3 步
安装连接插件 krita-ai-diffusion
插件是什么？
官方插件名 krita-ai-diffusion（在 Krita 里显示为 "AI Image Generation" 面板）。 它让 Krita 与 ComfyUI 双向通信：框选区域 → 输入提示词 → 生成/重绘/放大，结果实时回填图层。
1
下载插件：打开 krita-ai-diffusion Releases 下载最新版 ZIP 包。
2
导入插件：Krita 菜单 工具 → 脚本 → 从文件导入 Python 插件…，选择刚下载的 ZIP。
3
重启 Krita，然后菜单 设置 → 停靠面板 → AI Image Generation，勾选打开 AI 面板。
4
连接 ComfyUI：在 AI 面板点 Configure：
- 若 ComfyUI 已在本机运行，插件会自动尝试连接；
- 或选 Custom Server 手动填
http://127.0.0.1:8188。
ComfyUI 侧必装的自定义节点（插件依赖）
| 节点 | GitHub 仓库 | 用途 |
|---|---|---|
| comfyui_controlnet_aux | Fannovel16/comfyui_controlnet_aux | ControlNet 预处理器：线稿/深度/姿态/边缘 等控制层 |
| ComfyUI_IPAdapter_plus | cubiq/ComfyUI_IPAdapter_plus | IP-Adapter：参考图风格迁移 |
| comfyui-inpaint-nodes | Acly/comfyui-inpaint-nodes | 局部重绘 / 擦除 / 扩图 |
| comfyui-tooling-nodes | Acly/comfyui-tooling-nodes | 插件与 ComfyUI 通信（必需） |
安装方式：ComfyUI Manager → Install Custom Nodes → 搜索上述仓库名安装 → 重启 ComfyUI。 可选增强节点：city96/ComfyUI-GGUF（支持 .gguf 量化模型，省显存）。
注意
这 4 个节点是插件正常工作的必要条件，缺少会导致连接失败或生成报错。请务必装齐。
🧠
第 4 步
安装必装大模型
模型放哪里？
所有模型都放进 ComfyUI 的
models 目录下对应子文件夹（也可通过 extra_model_paths.yml 指定外部目录）。 文件名必须包含插件搜索的模式，放在任意子文件夹都能被识别，放在 krita 子文件夹会优先匹配。① Checkpoint（扩散大模型）— 必须至少装 1 个
这是真正「画图」的模型，体积最大（2~7GB）。按你的显卡显存与风格偏好任选一种架构： SD1.5（低配友好）、SDXL（推荐，插件默认风格）、Flux / Z-Image（最新旗舰）。下载来源：HuggingFace / Civitai，或插件文档的 推荐模型清单。
# 放置目录
ComfyUI/models/checkpoints/ ← 把下载的 .safetensors 放这里② CLIP Vision — 必需（缺它连不上）
插件连接时必需的视觉编码模型，体积小，直接下载放好即可：
# 放置目录：ComfyUI/models/clip_vision/
# 下载（约 2.5GB 的 vit-h 编码器）:
# https://huggingface.co/h94/IP-Adapter/resolve/main/models/image_encoder/model.safetensors
# 下载后重命名为: clip-vision_vit-h.safetensors③ 增强模型（可选但强烈推荐）
| 类型 | 目标目录 | 文件名（下载源） |
|---|---|---|
| 超分放大 | models/upscale_models/ | 4x_NMKD-Superscale-SP_178000_G.pth（HuggingFace: gemasai） |
| IP-Adapter (SDXL) | models/ipadapter/ | ip-adapter_sdxl_vit-h.safetensors（HuggingFace: h94） |
| 局部重绘 | models/inpaint/ | fooocus_inpaint_head.pth + inpaint_v26.fooocus.patch（HuggingFace: lllyasviel） |
| 加速 LoRA | models/loras/ | Hyper-SDXL-8steps-CFG-lora.safetensors（ByteDance/Hyper-SD） |
🚀 一键下载全部所需模型（推荐，省心不出错）
插件自带官方下载脚本 download_models.py， 会自动把全部必需 + 可选模型以正确的文件名和目录下载到你的 ComfyUI：
# 1) 找到脚本：插件安装目录下 ai_diffusion/scripts/download_models.py
# （Krita 插件目录：Windows 一般为 %APPDATA%/krita/pykrita/ai_diffusion/）
# 2) 打开命令行，先装依赖再运行：
python -m pip install aiohttp tqdm
# 3) 下载全部模型到 ComfyUI 目录：
python download_models.py --all D:/ComfyUI
# 4) 只看清单不下载，或只下子集：
python download_models.py --help提示
脚本只下载模型，不会安装或修改 ComfyUI 与自定义节点。下载目录不一定要是 ComfyUI，也可以先下到空文件夹再拷贝。
⚠️ 常见问题排查
- ❌ 连接报错 "missing resources / workload not installed" — 某个必需模型没找到。打开 AI 面板的连接设置 → View Log files，查看
client.log里的警告，会列出缺失的模型与插件查找的文件名模式。 - ❌ 模型找不到 — 文件名必须包含插件搜索的模式；模型可放在任意子文件夹，
krita子文件夹优先匹配；多个同名文件时也会优先取 krita 下的。 - ❌ ComfyUI 连不上 — 确认 ComfyUI 已启动且浏览器能打开 127.0.0.1:8188；确认插件选的是 Custom Server 且地址端口正确。
- ❌ 生成报节点错误 — 检查第 3 步的 4 个自定义节点是否装齐（用 Manager 重新安装并重启）。
- ❌ 显存不足 — 换小模型（SD1.5 系）或装 GGUF 量化模型（ComfyUI-GGUF 节点），或降低分辨率。