ComfyUI

1. 📌 Skill基础信息

Skill名称：ComfyUI

简称：ComfyUI

来源：社区第三方（作者：kbarbel640-del）

运行宿主：Claude-Code CLI

核心定位：通过HTTP API在本地运行ComfyUI工作流，适用于基于文本描述生成图像、执行预设工作流或下载模型权重的场景。

2. 🧩 内部核心组成

子Agent集合

【无公开信息】

脚本工具

工具名称	功能简述
comfyui_run.py	提交工作流到ComfyUI服务器并轮询执行结果
download_weights.py	从URL下载模型权重文件到指定目录

资源文件

• assets/default-workflow.json：默认工作流配置文件

目录结构

skills/comfyui/
├── scripts/
│   ├── comfyui_run.py
│   └── download_weights.py
└── assets/
    └── default-workflow.json

3. 🛠 安装与启用方式

安装命令：

skills install --user kbarbel640-del/skills

前置依赖：

• Python 3
• 本地ComfyUI环境（需预先安装）

API要求：

• ComfyUI服务器运行在127.0.0.1:8188

启动准备：

1. 安装ComfyUI（如未安装）：

git clone https://github.com/comfyanonymous/ComfyUI.git ~/ComfyUI
cd ~/ComfyUI
python3 -m venv venv
~/ComfyUI/venv/bin/pip install -r requirements.txt

1. 启动ComfyUI服务器：

~/ComfyUI/venv/bin/python ~/ComfyUI/main.py --listen 127.0.0.1

4. 📋 标准工作流

1. 用户输入：用户提供图像生成描述、工作流文件路径或原始JSON
2. 工作流预处理：

- 读取工作流JSON文件（默认或用户指定）

- 识别并修改提示相关节点（CLIPTextEncode等）

- 可选设置样式前缀和随机种子

- 保存修改后的工作流到临时文件

1. 执行工作流：

```bash

~/ComfyUI/venv/bin/python skills/comfyui/scripts/comfyui_run.py --workflow <临时文件路径>

```

1. 模型下载（如需要）：

- 处理用户提供的模型权重URL列表

- 使用download_weights.py脚本下载到对应子目录

1. 结果交付：

- 解析生成的图像文件路径

- 将图像文件发送给用户

5. ⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅支持本地部署的ComfyUI环境
• 需要预先安装完整的ComfyUI生态系统

资源消耗：

• 依赖本地GPU资源进行图像生成
• 模型下载需要足够的磁盘空间

适用项目：

• 本地图像生成和实验
• 基于工作流的图像处理流水线

不适用场景：

• 云端或服务器less环境
• 实时或低延迟图像生成需求

已知坑点：

• 需要手动维护ComfyUI服务器状态
• 工作流节点ID和结构可能变化，需要人工检查
• 模型权重需要手动管理

生产环境适用性：❌ 不适合直接上生产环境，主要用于开发和实验

6. ✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

• AI研究人员和开发者进行本地图像生成实验
• 需要定制化ComfyUI工作流的项目
• 批量处理图像生成任务
• 模型权重管理和下载自动化

❌ 不适合场景

• 商业级图像生成服务
• 高并发或大规模部署
• 无本地GPU资源的环境
• 需要即开即用的简单图像生成需求

skills install --user kbarbel640-del/skills