n8n-nodes-comfyui-all 2.0.0 → 2.1.1

package/README.md

@@ -1,882 +1,146 @@
-# n8n-comfyui-nodes
+# n8n-nodes-comfyui-all
 
-n8n 社区节点，用于集成 ComfyUI 工作流到 n8n 自动化平台。
+> n8n community node for integrating ComfyUI workflows into n8n automation platform.
 
-## 📚 快速导航
+[![npm version](https://badge.fury.io/js/n8n-nodes-comfyui-all.svg)](https://www.npmjs.com/package/n8n-nodes-comfyui-all)
 
-- **[AI Agent 集成](#ai-agent-集成)** - 在 AI Agent 中使用 ComfyUI 生成图像
-- **[快速开始](#快速开始)** - 安装和配置指南
-- **[使用方法](#使用方法)** - 基础节点使用
-- **[工作流示例](#工作流示例)** - 实际应用案例
-- **[故障排除](#故障排除)** - 常见问题解决
+## ✨ Features
 
-## 版本信息
+- 🎨 **Universal Workflow Support** - Works with any ComfyUI workflow in API format
+- 🔄 **Dynamic Parameters** - Override workflow parameters dynamically
+- 🎬 **Multi-Modal Support** - Supports images and videos for both input and output
+- 🤖 **AI Agent Ready** - Can be used as a tool in AI Agent workflows
+- 📊 **Flexible Configuration** - JSON mode or single parameter mode
 
-**当前版本**: 2.4
-**发布日期**: 2026-01-07
-**节点名称**: ComfyUI Workflow
+## 📦 Installation
 
----
+### n8n Cloud
 
-## 特性
+1. Go to **Settings** → **Community Nodes**
+2. Click **Install**
+3. Enter: `n8n-nodes-comfyui-all`
+4. Click **Install**
 
-- ✅ **统一节点**：支持任意 ComfyUI API 格式工作流
-- ✅ **动态参数**：自动识别和配置工作流中的输入参数
-- ✅ **灵活配置**：支持文本生成图像、图像处理、视频生成等所有 ComfyUI 功能
-- ✅ **智能验证**：自动验证工作流格式和参数
-- ✅ **SSRF 防护**：防止内网地址访问
-- ✅ **错误处理**：完善的错误处理和重试机制
-- ✅ **双模式参数配置**：支持 JSON 模式（多个参数）和单参数模式（逐个配置）
-- ✅ **图像输入验证**：imagesToAny action 自动验证图像输入
-- 🆕 **AI Agent 支持**：既可作为普通节点，也可作为 AI Agent Tool 使用
-- 🆕 **双模式工作**：在普通工作流和 AI Agent 对话中都能使用
-
-### 重要说明
-
-#### 自定义节点 vs 社区节点
-
-本项目是一个**自定义节点**（Custom Node），用于本地开发和测试。
-
-**自定义节点**：
-- 本地开发，无需发布到 npm
-- 可以快速迭代和调试
-- 实时修改代码，立即生效
-- 适合开发环境
-
-**社区节点**（Community Nodes）：
-- 通过 n8n 界面安装（Settings → Community Nodes）
-- 从 npm registry 下载已发布的包
-- n8n 自动管理依赖
-- 适合使用第三方开发的成熟节点
-
----
-
-## 快速开始
-
-### 前置要求
-
-- Node.js 18.10+
-- npm
-- n8n 2.x
-- ComfyUI 服务器运行中（默认：http://127.0.0.1:8188）
-
-### 安装
-
-#### 方法 1: 使用本地安装（推荐）
+### Self-Hosted n8n
 
 ```bash
-# 步骤 1: 编译项目
-cd /home/ZLQyiA/projets/n8n-service/n8n-comfyui-nodes
-npm install
-npm run build
-
-# 步骤 2: 在 n8n 的 custom 目录安装
-cd /home/ZLQyiA/projets/n8n-service/.n8n/custom
-
-# 创建 package.json（如果不存在）
-cat > package.json << 'EOF'
-{
-  "name": "n8n-custom-nodes",
-  "version": "1.0.0",
-  "description": "Custom n8n nodes",
-  "dependencies": {
-    "n8n-nodes-comfyui-all": "file:../../n8n-comfyui-nodes"
-  }
-}
-EOF
-
-# 安装本地包
-npm install
-
-# 步骤 3: 验证安装
-ls -la node_modules/
-# 应该看到: n8n-nodes-comfyui-all -> ../../../n8n-comfyui-nodes
-
-# 步骤 4: 重启 n8n 服务
-cd /home/ZLQyiA/projets/n8n-service
-./stop-n8n.sh
-./start-n8n.sh
-```
-
-**重要说明**:
-- n8n 使用 `N8N_USER_DATA_DIR` 环境变量指定的目录
-- 在我们的环境中，custom 目录位于：`/home/ZLQyiA/projets/n8n-service/.n8n/custom/`
-- 请确保安装到正确的 custom 目录，而不是 `~/.n8n/custom/`
-
-### 重新部署
-
-如果需要重新部署（例如修改代码后）：
-
-```bash
-# 1. 清理旧安装
-cd /home/ZLQyiA/projets/n8n-service
-rm -rf .n8n/custom/node_modules .n8n/custom/package-lock.json
-rm -rf n8n-comfyui-nodes/dist
-
-# 2. 重新编译
-cd n8n-comfyui-nodes
-npm run build
-
-# 3. 重新安装
-cd ../.n8n/custom
-npm install
-
-# 4. 重启 n8n
-cd ../..
-./stop-n8n.sh
-./start-n8n.sh
-
-# 5. 验证部署
-cd n8n-comfyui-nodes
-./check-deployment.sh
+cd ~/.n8n
+npm install n8n-nodes-comfyui-all
 ```
 
-**一键部署脚本** (推荐):
-```bash
-cd /home/ZLQyiA/projets/n8n-service/n8n-comfyui-nodes
-./check-deployment.sh  # 检查当前部署状态
-```
-
-#### 方法 2: 通过 n8n 界面安装
-
-1. 访问 n8n 界面
-2. Settings → Community Nodes
-3. 点击 "Install"
-4. 输入包名并安装
-
-### 重启 n8n
+Or via n8n interface: **Settings** → **Community Nodes** → **Install** → `n8n-nodes-comfyui-all`
 
-```bash
-cd /home/ZLQyiA/projets/n8n-service
-./stop-n8n.sh
-./start-n8n.sh
-```
+> Restart n8n after installation.
 
----
+## 🚀 Quick Start
 
-## 使用方法
+### 1. Prerequisites
 
-### 步骤 1: 在 ComfyUI 中创建工作流
+- ComfyUI server running (default: `http://127.0.0.1:8188`)
+- n8n instance (version 2.x or higher)
 
-1. 在 ComfyUI 中设计你的工作流
-2. 点击 **Save (API Format)** 导出工作流
-3. 复制生成的 JSON
+### 2. Create Your Workflow in ComfyUI
 
-### 步骤 2: 在 n8n 中配置节点
+1. Design your workflow in ComfyUI
+2. Click **Save (API Format)** to export
+3. Copy the generated JSON
 
-1. 添加 **ComfyUI Workflow** 节点
-2. 配置参数：
-   - **ComfyUI URL**: `http://127.0.0.1:8188`
-   - **Workflow JSON**: 粘贴工作流 JSON
-   - **Node Parameters**: 配置节点参数（支持 JSON 模式和单参数模式）
+### 3. Configure n8n Node
 
-### 步骤 3: 配置输入参数
+1. Add **ComfyUI** node to your n8n workflow
+2. Set **ComfyUI URL**: `http://127.0.0.1:8188`
+3. Paste your **Workflow JSON**
+4. Optionally configure **Node Parameters**
 
-使用 **Node Parameters** 功能为节点配置参数，支持两种模式：
+## 📖 Usage
 
-#### 模式 1: JSON 模式（推荐）
+### Basic Example: Text to Image
 
-一次性为节点配置多个参数，适合熟悉 JSON 的用户。
+**Node Configuration:**
+- **Action**: `TextToAny`
+- **ComfyUI URL**: `http://127.0.0.1:8188`
+- **Workflow JSON**: Your ComfyUI workflow in API format
 
-**使用步骤**：
+**Optional Node Parameters (Single Parameter Mode):**
+- Node ID: `6` (your CLIP text node)
+- Parameter Name: `text`
+- Type: `Text`
+- Value: `a beautiful landscape, high quality`
 
-1. 在节点配置中找到 **"Node Parameters"** 部分
-2. 点击 **"Add Node"** 添加一个节点配置
-3. 选择 **Parameter Mode** 为 **JSON Mode**
-4. 填写以下字段：
-   - **Node ID**: 工作流中节点的 ID（例如：`13`）
-   - **Parameters JSON**: 该节点的所有参数，JSON 格式
+### Parameter Configuration Modes
 
-**示例**：
+#### 1. Multiple Parameters Mode (JSON)
 
-假设你的工作流中有一个 EmptyLatentImage 节点（ID: 13），需要配置 width、height 和 batch_size：
+Configure multiple parameters at once using JSON:
 
 ```json
 {
   "width": 1024,
   "height": 1024,
-  "batch_size": 1
-}
-```
-
-**多个节点配置**：
-
-你可以添加多个 Node 条目来配置不同的节点：
-
-- Node 1: ID=13, Mode=JSON, Parameters=`{"width": 1024, "height": 1024, "batch_size": 1}`
-- Node 2: ID=3, Mode=JSON, Parameters=`{"seed": 12345, "steps": 20, "cfg": 7.5}`
-
-**优点**：
-- ✅ 配置更简洁，一个节点一个配置项
-- ✅ 支持 JSON 格式，可以复制粘贴
-- ✅ 适合需要配置多个参数的节点
-
-#### 模式 2: 单参数模式
-
-逐个配置参数，适合不熟悉 JSON 的用户。
-
-**使用步骤**：
-
-1. 在节点配置中找到 **"Node Parameters"** 部分
-2. 点击 **"Add Node"** 添加一个节点配置
-3. 选择 **Parameter Mode** 为 **Single Parameter**
-4. 填写以下字段：
-   - **Node ID**: 工作流中节点的 ID（例如：`13`）
-   - **Parameter Name**: 参数名（例如：`width`）
-   - **Type**: 数据类型（text/number/boolean/json）
-   - **Value**: 参数值
-
-**示例**：
-
-配置 EmptyLatentImage 节点（ID: 13）的 width 参数：
-
-- Node 1: ID=13, Mode=Single, Parameter Name=width, Type=number, Value=1024
-
-配置多个参数：
-
-- Node 1: ID=13, Mode=Single, Parameter Name=width, Type=number, Value=1024
-- Node 2: ID=13, Mode=Single, Parameter Name=height, Type=number, Value=1024
-- Node 3: ID=13, Mode=Single, Parameter Name=batch_size, Type=number, Value=1
-
-**优点**：
-- ✅ 不需要了解 JSON 语法
-- ✅ 有类型验证，避免错误
-- ✅ 适合只需要配置少量参数的情况
-
-#### 两种模式的对比
-
-| 特性 | JSON 模式 | 单参数模式 |
-|------|-----------|-----------|
-| 配置方式 | JSON 格式，一次多个参数 | 逐个参数配置 |
-| 适用场景 | 节点有多个参数需要配置 | 只需要配置少量参数 |
-| 类型验证 | 无（JSON 格式） | 有（Type 字段） |
-| 推荐度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
-
-**注意**：
-- 图像应该通过工作流连接（imagesToAny）或工作流 JSON 直接配置，不需要通过参数上传
-- 参数值会覆盖工作流 JSON 中的默认值
-- 两种模式可以混合使用
-
----
-
-## AI Agent 集成
-
-### 🎉 双模式支持
-
-ComfyUI Workflow 节点现在支持两种使用方式：
-
-#### 模式 1: 作为普通节点使用
-
-拖拽到任何工作流中，手动配置参数。
-
-#### 模式 2: 作为 AI Agent Tool 使用 🆕
-
-在 AI Agent 的 tools 列表中会自动出现 ComfyUI Workflow！
-
-### 在 AI Agent 中使用
-
-#### 步骤 1: 创建 AI Agent
-
-1. 添加 **OpenAI Conversational Agent** 节点
-2. 配置 Chat Model 和 Memory
-
-#### 步骤 2: 添加 ComfyUI Tool
-
-1. 点击 AI Agent 节点
-2. 在 **Tools** 部分点击 **+ Add Tool**
-3. 搜索 **"ComfyUI"**
-4. 选择 **ComfyUI Workflow** 节点
-5. 配置节点参数（ComfyUI URL、Workflow JSON 等）
-
-#### 步骤 3: 开始对话
-
-**示例对话**：
-```
-用户: 生成一只可爱的猫咪
-
-AI: 好的，我来为您生成一张可爱猫咪的图片。
-    [调用 ComfyUI Workflow tool]
-    完成！图片已生成。
-```
-
-### 技术实现
-
-节点通过 `usableAsTool: true` 属性支持 AI Agent。这与 lark/feishu 节点的实现方式相同。
-
-### 使用示例
-
-#### 基础用法
-
-**用户输入**：
-```
-生成一只在森林里的狐狸
-```
-
-**AI Agent 行为**：
-1. 识别用户想要生成图像
-2. 调用 ComfyUI 工具
-3. 使用默认参数生成图像（512x512, 20 steps）
-4. 返回生成的图像 URL
-
-#### 高级用法（带参数）
-
-**用户输入**：
-```
-创建一个赛博朋克城市，size:1024x768, steps:30, cfg:10
-```
-
-**支持的参数**：
-- `size:WIDTHxHEIGHT` - 图像尺寸（如：1024x768）
-- `steps:N` - 采样步数（如：30）
-- `cfg:N` - CFG 强度（如：7.5）
-- `seed:N` - 随机种子（如：12345）
-- `negative:TEXT` - 负向提示词（如：ugly, blurry）
-
-#### 负向提示词
-
-**用户输入**：
-```
-画一个美丽的日落，negative: 模糊, 低质量, 变形
-```
-
-### 文件位置
-
-- **完整代码**: `agent-tools/ComfyUI-Agent-Tool.js`
-- **详细文档**: `agent-tools/README.md`
-- **工作流示例**: `agent-tools/example-workflow.json`
-
-### 定制工作流
-
-要使用你自己的 ComfyUI 工作流：
-
-1. 在 ComfyUI 中创建工作流
-2. 导出为 **API Format**
-3. 替换 `ComfyUI-Agent-Tool.js` 中的 `WORKFLOW_TEMPLATE`
-4. 根据你的工作流调整 `updateWorkflow()` 函数
-
-**详细指南**: 请参考 `agent-tools/README.md`
-
----
-
-## 支持的节点类型
-
-| 节点类型 | 说明 | 可配置参数 |
-|---------|------|-----------|
-| LoadImage | 图像加载 | image |
-| KSampler | 采样器 | seed, steps, cfg, sampler_name, scheduler, denoise |
-| CheckpointLoaderSimple | 模型加载 | ckpt_name |
-| LoraLoader | LoRA 加载 | lora_name, strength_model, strength_clip |
-| CLIPTextEncode | 文本编码 | text |
-| EmptyLatentImage | 潜像尺寸 | width, height, batch_size |
-| SaveImage | 保存图像 | filename_prefix |
-
----
-
-## 常见使用场景
-
-### 1. 文本生成图像
-
-**工作流**: 标准的 text-to-image
-
-**参数**:
-```json
-{
-  "6_text": "beautiful landscape, high quality",
-  "7_text": "ugly, blurry",
-  "3_steps": 25,
-  "3_cfg": 7.5,
-  "3_sampler_name": "euler"
-}
-```
-
-### 2. 图像风格转换
-
-**参数**:
-```json
-{
-  "6_text": "oil painting style, artistic",
-  "10_image": "http://example.com/input.jpg",
-  "3_denoise": 0.65
-}
-```
-
-### 3. 使用固定种子
-
-**参数**:
-```json
-{
-  "6_text": "a cyberpunk city",
-  "3_seed": 12345
-}
-```
-
----
-
-## 参数说明
-
-### 文本参数
-
-```json
-{
-  "6_text": "beautiful landscape",
-  "9_filename_prefix": "my_image"
-}
-```
-
-### 数字参数
-
-```json
-{
-  "3_steps": 20,
-  "3_cfg": 7.5,
-  "5_width": 512,
-  "5_height": 512
-}
-```
-
-### 选项参数
-
-**sampler_name**: `euler`, `euler_ancestral`, `heun`, `dpm_2`, `dpm_2_ancestral`, `lms`, `ddim`, `uni_pc`
-
-**scheduler**: `normal`, `karras`, `exponential`, `sgm_uniform`, `simple`, `ddim_uniform`
-
-### 图像参数
-
-URL 方式：
-```json
-{
-  "10_image": "http://example.com/image.png"
-}
-```
-
-Base64 方式：
-```json
-{
-  "10_image": "data:image/png;base64,iVBORw0KG..."
-}
-```
-
----
-
-## 输出格式
-
-成功执行后返回：
-
-```json
-{
-  "success": true,
-  "images": [
-    {
-      "url": "http://127.0.0.1:8188/view?filename=ComfyUI_00001.png...",
-      "type": "image"
-    }
-  ],
-  "videos": [
-    {
-      "url": "http://127.0.0.1:8188/view?filename=video.mp4...",
-      "type": "video"
-    }
-  ]
+  "batch_size": 1,
+  "seed": 12345
 }
 ```
 
----
-
-## 开发
-
-### 编译
-
-```bash
-npm run build
-```
-
-### 代码检查
-
-```bash
-npm run lint
-npm run lintfix
-```
-
-### 监听模式
-
-```bash
-npm run dev
-```
-
-### 测试
-
-```bash
-node test-load.js
-```
-
----
-
-## 故障排除
-
-### 节点未出现在 n8n 中
-
-1. 确认安装到正确的 custom 目录：
-   ```bash
-   ls -la /home/ZLQyiA/projets/n8n-service/.n8n/custom/node_modules/
-   ```
-   应该看到：`n8n-nodes-comfyui-all -> ../../../n8n-comfyui-nodes`
-
-2. 重启 n8n 服务：
-   ```bash
-   cd /home/ZLQyiA/projets/n8n-service
-   ./stop-n8n.sh
-   ./start-n8n.sh
-   ```
-
-3. 检查 package.json 包含正确配置
-
-### 连接 ComfyUI 失败
-
-1. 确保 ComfyUI 正在运行
-2. 检查 URL 配置
-3. 查看防火墙设置
-
-### 工作流验证失败
-
-1. 确保使用 "Save (API Format)" 导出
-2. 验证 JSON 格式正确
-3. 检查节点 ID 和参数名
-
-### n8n 检测到包缺失警告
-
-如果看到 `n8n detected that some packages are missing` 警告，这是正常的：
-- n8n 尝试从 npm registry 获取社区节点信息但超时
-- 不影响本地自定义节点的使用
-- 如果节点能正常工作，可以忽略此警告
-
----
-
-## 项目结构
-
-```
-n8n-nodes-comfyui-all/
-├── nodes/
-│   ├── ComfyUi/
-│   │   ├── ComfyUi.node.ts     # 主节点实现
-│   │   └── comfyui.svg          # 节点图标
-│   ├── ComfyUiClient.ts         # API 客户端
-│   ├── workflow-parser.ts       # 工作流解析器
-│   ├── validation.ts            # 验证工具
-│   ├── types.ts                 # 类型定义
-│   └── constants.ts             # 配置常量
-├── agent-tools/                 # AI Agent 工具
-│   ├── ComfyUI-Agent-Tool.js   # Custom Code Tool 代码
-│   ├── README.md                # AI Agent 工具文档
-│   └── example-workflow.json   # 工作流示例
-├── dist/                        # 编译输出
-├── index.ts                     # 入口文件
-├── package.json                 # 包配置
-├── tsconfig.json               # TypeScript 配置
-└── README.md                   # 本文件
-```
-
----
+#### 2. Single Parameter Mode
 
-## 工作流示例
+Configure one parameter at a time with type validation:
 
-### 示例 1: 简单的文本生成图像
+- **Parameter Name**: `steps`
+- **Type**: `Number`
+- **Value**: `25`
 
-**工作流 JSON**:
+### Binary File Upload
 
-```json
-{
-  "3": {
-    "inputs": {
-      "seed": 123456789,
-      "steps": 20,
-      "cfg": 8,
-      "sampler_name": "euler",
-      "scheduler": "normal",
-      "denoise": 1,
-      "model": ["4", 0],
-      "positive": ["6", 0],
-      "negative": ["7", 0],
-      "latent_image": ["5", 0]
-    },
-    "class_type": "KSampler"
-  },
-  "4": {
-    "inputs": {
-      "ckpt_name": "v1-5-pruned-emaonly.ckpt"
-    },
-    "class_type": "CheckpointLoaderSimple"
-  },
-  "5": {
-    "inputs": {
-      "width": 512,
-      "height": 512,
-      "batch_size": 1
-    },
-    "class_type": "EmptyLatentImage"
-  },
-  "6": {
-    "inputs": {
-      "text": "beautiful landscape, high quality",
-      "clip": ["4", 1]
-    },
-    "class_type": "CLIPTextEncode"
-  },
-  "7": {
-    "inputs": {
-      "text": "ugly, blurry, low quality",
-      "clip": ["4", 1]
-    },
-    "class_type": "CLIPTextEncode"
-  },
-  "8": {
-    "inputs": {
-      "samples": ["3", 0],
-      "vae": ["4", 2]
-    },
-    "class_type": "VAEDecode"
-  },
-  "9": {
-    "inputs": {
-      "filename_prefix": "ComfyUI",
-      "images": ["8", 0]
-    },
-    "class_type": "SaveImage"
-  }
-}
-```
+To upload input images to ComfyUI:
 
-**n8n 输入参数**:
+- **Type**: `Binary`
+- **Binary Property**: `data` (default)
+- The node will automatically upload the binary data and use the filename
 
-```json
-{
-  "6_text": "a serene mountain landscape at sunset",
-  "7_text": "ugly, blurry, low quality, distorted",
-  "3_steps": 25,
-  "3_cfg": 7.5
-}
-```
-
----
+## 🤖 AI Agent Integration
 
-### 示例 2: 图像风格转换
-
-**工作流 JSON**:
-
-```json
-{
-  "3": {
-    "inputs": {
-      "seed": 0,
-      "steps": 20,
-      "cfg": 8,
-      "sampler_name": "euler",
-      "scheduler": "normal",
-      "denoise": 0.75,
-      "model": ["4", 0],
-      "positive": ["6", 0],
-      "negative": ["7", 0],
-      "latent_image": ["5", 0]
-    },
-    "class_type": "KSampler"
-  },
-  "4": {
-    "inputs": {
-      "ckpt_name": "v1-5-pruned-emaonly.ckpt"
-    },
-    "class_type": "CheckpointLoaderSimple"
-  },
-  "5": {
-    "inputs": {
-      "pixels": ["10", 0],
-      "vae": ["4", 2]
-    },
-    "class_type": "VAEEncode"
-  },
-  "6": {
-    "inputs": {
-      "text": "oil painting style",
-      "clip": ["4", 1]
-    },
-    "class_type": "CLIPTextEncode"
-  },
-  "7": {
-    "inputs": {
-      "text": "ugly, blurry",
-      "clip": ["4", 1]
-    },
-    "class_type": "CLIPTextEncode"
-  },
-  "8": {
-    "inputs": {
-      "samples": ["3", 0],
-      "vae": ["4", 2]
-    },
-    "class_type": "VAEDecode"
-  },
-  "9": {
-    "inputs": {
-      "filename_prefix": "ComfyUI",
-      "images": ["8", 0]
-    },
-    "class_type": "SaveImage"
-  },
-  "10": {
-    "inputs": {
-      "image": "example.png",
-      "choose file to upload": "image"
-    },
-    "class_type": "LoadImage"
-  }
-}
-```
+Use ComfyUI as a tool in AI Agent workflows:
 
-**n8n 输入参数**:
+1. Add an **AI Agent** node (e.g., OpenAI Conversational Agent)
+2. In the **Tools** section, add **ComfyUI**
+3. Configure the ComfyUI node parameters
+4. Start chatting!
 
-```json
-{
-  "6_text": "watercolor painting style, artistic",
-  "7_text": "",
-  "10_image": "http://example.com/input.jpg",
-  "3_denoise": 0.6
-}
+**Example:**
 ```
+User: Generate a cute cat picture
 
----
-
-### 示例 3: 使用固定种子
-
-**工作流**: 使用示例 1 的工作流
-
-**参数**:
-```json
-{
-  "6_text": "a cyberpunk city",
-  "3_seed": 12345
-}
+AI: I'll generate that for you using ComfyUI.
+    [Calls ComfyUI tool]
+    Done! Here's your cute cat picture.
 ```
 
----
-
-## 参数说明
-
-### 节点说明
-
-| 节点 ID | 类型 | 功能 | 可配置参数 |
-|---------|------|------|-----------|
-| 3 | KSampler | 采样器，控制生成参数 | seed, steps, cfg, sampler_name, scheduler, denoise |
-| 4 | CheckpointLoaderSimple | 加载模型 | ckpt_name |
-| 5 | EmptyLatentImage / VAEEncode | 创建空潜像或编码图像 | width, height, batch_size / pixels |
-| 6 | CLIPTextEncode | 正向提示词编码 | text |
-| 7 | CLIPTextEncode | 负向提示词编码 | text |
-| 8 | VAEDecode | 解码潜像为图像 | - |
-| 9 | SaveImage | 保存生成的图像 | filename_prefix |
-| 10 | LoadImage | 加载输入图像 | image |
-
-### 常用参数详解
-
-**KSampler (节点 3)**:
-- `seed`: 随机种子（留空自动生成，固定可复现结果）
-- `steps`: 采样步数 (20-50，通常 20-30 步足够)
-- `cfg`: CFG 强度 (6-15，常用 7-8)
-- `sampler_name`: 采样器类型（euler, euler_ancestral, ddim 等）
-- `scheduler`: 调度器类型（normal, karras, exponential 等）
-- `denoise`: 去噪强度 (0-1)
-  - 文生图: 1.0
-  - 图生图: 0.5-0.75
-  - 图像编辑: 0.3-0.5
-
-**CLIPTextEncode (节点 6/7)**:
-- `text`: 提示词文本
-
-**EmptyLatentImage (节点 5)**:
-- `width`: 图像宽度 (512, 768, 1024)
-- `height`: 图像高度 (512, 768, 1024)
-- `batch_size`: 批次大小 (1-4)
-
-**LoadImage (节点 10)**:
-- `image`: 图像 URL 或 base64 数据
-
-### 使用提示
-
-- **首次使用**：建议使用示例 1（文本生成图像）开始
-- **种子控制**：固定 seed 可以复现结果
-- **步数优化**：20-30 步通常足够，更多步数不一定更好
-- **CFG 值**：7-8 是常用范围，太高可能导致过饱和
-- **去噪强度**：根据使用场景调整（见上方 KSampler 参数说明）
-
----
-
-## 更多示例
-
----
-
-## 技术栈
-
-- TypeScript (严格模式)
-- n8n-workflow
-- axios
-- ComfyUI API
-
----
-
-## 许可证
-
-MIT
-
----
-
-## 更新日志
-
-### v2.4 (2026-01-07)
-
-- ✨ **优雅的模式切换**：添加 Parameter Mode 选择器，动态显示相关字段
-- ✨ **改进用户体验**：JSON 模式和单参数模式清晰分离，不再混淆
-- ✨ **动态显示**：根据选择的模式自动显示/隐藏字段
-- 📝 更新文档，详细说明模式切换的使用方法
-- 🔧 优化代码结构，提升可维护性
-
-### v2.3 (2026-01-07)
-
-- ✨ **Node Parameters 双模式支持**：支持 JSON 模式和单参数模式
-- ✨ **灵活配置**：JSON 模式适合配置多个参数，单参数模式适合逐个配置
-- ✨ **动态显示**：根据选择的模式动态显示相关字段
-- 📝 更新文档，详细说明两种模式的使用方法和对比
-- 🔧 优化代码结构，提升用户体验
+For detailed AI Agent usage, see [AI-AGENT-USAGE.md](AI-AGENT-USAGE.md).
 
-### v2.2 (2026-01-07)
+## 🔧 Configuration Reference
 
-- ✨ **简化参数配置**：移除冗余的 Parameters 功能，只保留 Node Parameters
-- ✨ **优化用户体验**：统一使用 JSON 格式配置节点参数，更加简洁
-- ✨ **图像输入验证**：imagesToAny action 自动验证图像输入，避免配置错误
-- 📝 更新文档，简化参数配置说明
-- 🔧 优化代码结构，移除不必要的类型定义和逻辑
-- ✅ 完善测试覆盖
+| Field | Description |
+|-------|-------------|
+| **ComfyUI URL** | URL of your ComfyUI server |
+| **Action** | TextToAny or ImagesToAny |
+| **Workflow JSON** | ComfyUI workflow in API format |
+| **Timeout** | Maximum wait time in seconds (default: 300) |
+| **Node Parameters** | Override workflow parameters |
 
-### v2.1 (2026-01-07)
+## 💡 Tips
 
-- ✨ **节点级别参数配置**：新增 Node Parameters 功能，支持一次性为节点配置多个参数
-- ✨ **改进参数配置体验**：提供两种参数配置方式，满足不同使用场景
-- ✨ **图像输入验证**：imagesToAny action 自动验证图像输入，避免配置错误
-- 📝 更新文档，详细说明两种参数配置方式的使用方法和对比
-- 🔧 优化代码结构，提升可维护性
-- ✅ 完善测试覆盖
+- **First time**: Start with a simple text-to-image workflow
+- **Parameter overrides**: Use Node Parameters instead of modifying workflow JSON
+- **Seed control**: Fixed seeds produce reproducible results
+- **Optimization**: 20-30 sampling steps are usually sufficient
+- **Binary data**: Use Binary type to upload input images
 
-### v2.0 (2026-01-06)
+## 📚 Additional Documentation
 
-- ✨ 完全重构，支持动态工作流
-- ✨ 自动参数识别和配置
-- ✨ 统一节点设计
-- 🆕 **AI Agent 集成**：通过 Custom Code Tool 在 AI Agent 中生成图像
-- 🆕 添加自然语言参数解析（支持 size, steps, cfg, seed, negative 等）
-- 🆕 提供完整的 AI Agent 工具模板和文档
-- 📚 新增 `agent-tools/` 目录，包含 Custom Code Tool 代码和示例
-- 🐛 修复视频输出 bug
-- 🔒 增强 SSRF 防护
-- 📝 改进错误处理和资源管理
-- 🔧 修复自定义节点安装问题（使用正确的 custom 目录）
-- 🔧 修复重复节点安装问题
+- **[AI Agent Usage Guide](AI-AGENT-USAGE.md)** - Detailed AI Agent integration guide
+- **[Development Guide](DEVELOPMENT.md)** - Contributing and development setup
 
-### v1.0 (2026-01-05)
+## 🤝 Contributing
 
-- 初始版本
-- 支持多种预定义操作类型
+Contributions are welcome! Please see [DEVELOPMENT.md](DEVELOPMENT.md) for guidelines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-comfyui-all",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "n8n community nodes for ComfyUI workflow execution with dynamic parameter support",
   "keywords": [
     "n8n-community-node-package",