n8n-nodes-comfyui-all 2.0.0

package/README.md

@@ -0,0 +1,882 @@
+# n8n-comfyui-nodes
+
+n8n 社区节点，用于集成 ComfyUI 工作流到 n8n 自动化平台。
+
+## 📚 快速导航
+
+- **[AI Agent 集成](#ai-agent-集成)** - 在 AI Agent 中使用 ComfyUI 生成图像
+- **[快速开始](#快速开始)** - 安装和配置指南
+- **[使用方法](#使用方法)** - 基础节点使用
+- **[工作流示例](#工作流示例)** - 实际应用案例
+- **[故障排除](#故障排除)** - 常见问题解决
+
+## 版本信息
+
+**当前版本**: 2.4
+**发布日期**: 2026-01-07
+**节点名称**: ComfyUI Workflow
+
+---
+
+## 特性
+
+- ✅ **统一节点**：支持任意 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: 使用本地安装（推荐）
+
+```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
+```
+
+**一键部署脚本** (推荐):
+```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
+
+```bash
+cd /home/ZLQyiA/projets/n8n-service
+./stop-n8n.sh
+./start-n8n.sh
+```
+
+---
+
+## 使用方法
+
+### 步骤 1: 在 ComfyUI 中创建工作流
+
+1. 在 ComfyUI 中设计你的工作流
+2. 点击 **Save (API Format)** 导出工作流
+3. 复制生成的 JSON
+
+### 步骤 2: 在 n8n 中配置节点
+
+1. 添加 **ComfyUI Workflow** 节点
+2. 配置参数：
+   - **ComfyUI URL**: `http://127.0.0.1:8188`
+   - **Workflow JSON**: 粘贴工作流 JSON
+   - **Node Parameters**: 配置节点参数（支持 JSON 模式和单参数模式）
+
+### 步骤 3: 配置输入参数
+
+使用 **Node Parameters** 功能为节点配置参数，支持两种模式：
+
+#### 模式 1: JSON 模式（推荐）
+
+一次性为节点配置多个参数，适合熟悉 JSON 的用户。
+
+**使用步骤**：
+
+1. 在节点配置中找到 **"Node Parameters"** 部分
+2. 点击 **"Add Node"** 添加一个节点配置
+3. 选择 **Parameter Mode** 为 **JSON Mode**
+4. 填写以下字段：
+   - **Node ID**: 工作流中节点的 ID（例如：`13`）
+   - **Parameters JSON**: 该节点的所有参数，JSON 格式
+
+**示例**：
+
+假设你的工作流中有一个 EmptyLatentImage 节点（ID: 13），需要配置 width、height 和 batch_size：
+
+```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"
+    }
+  ]
+}
+```
+
+---
+
+## 开发
+
+### 编译
+
+```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                   # 本文件
+```
+
+---
+
+## 工作流示例
+
+### 示例 1: 简单的文本生成图像
+
+**工作流 JSON**:
+
+```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"
+  }
+}
+```
+
+**n8n 输入参数**:
+
+```json
+{
+  "6_text": "a serene mountain landscape at sunset",
+  "7_text": "ugly, blurry, low quality, distorted",
+  "3_steps": 25,
+  "3_cfg": 7.5
+}
+```
+
+---
+
+### 示例 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"
+  }
+}
+```
+
+**n8n 输入参数**:
+
+```json
+{
+  "6_text": "watercolor painting style, artistic",
+  "7_text": "",
+  "10_image": "http://example.com/input.jpg",
+  "3_denoise": 0.6
+}
+```
+
+---
+
+### 示例 3: 使用固定种子
+
+**工作流**: 使用示例 1 的工作流
+
+**参数**:
+```json
+{
+  "6_text": "a cyberpunk city",
+  "3_seed": 12345
+}
+```
+
+---
+
+## 参数说明
+
+### 节点说明
+
+| 节点 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 模式适合配置多个参数，单参数模式适合逐个配置
+- ✨ **动态显示**：根据选择的模式动态显示相关字段
+- 📝 更新文档，详细说明两种模式的使用方法和对比
+- 🔧 优化代码结构，提升用户体验
+
+### v2.2 (2026-01-07)
+
+- ✨ **简化参数配置**：移除冗余的 Parameters 功能，只保留 Node Parameters
+- ✨ **优化用户体验**：统一使用 JSON 格式配置节点参数，更加简洁
+- ✨ **图像输入验证**：imagesToAny action 自动验证图像输入，避免配置错误
+- 📝 更新文档，简化参数配置说明
+- 🔧 优化代码结构，移除不必要的类型定义和逻辑
+- ✅ 完善测试覆盖
+
+### v2.1 (2026-01-07)
+
+- ✨ **节点级别参数配置**：新增 Node Parameters 功能，支持一次性为节点配置多个参数
+- ✨ **改进参数配置体验**：提供两种参数配置方式，满足不同使用场景
+- ✨ **图像输入验证**：imagesToAny action 自动验证图像输入，避免配置错误
+- 📝 更新文档，详细说明两种参数配置方式的使用方法和对比
+- 🔧 优化代码结构，提升可维护性
+- ✅ 完善测试覆盖
+
+### v2.0 (2026-01-06)
+
+- ✨ 完全重构，支持动态工作流
+- ✨ 自动参数识别和配置
+- ✨ 统一节点设计
+- 🆕 **AI Agent 集成**：通过 Custom Code Tool 在 AI Agent 中生成图像
+- 🆕 添加自然语言参数解析（支持 size, steps, cfg, seed, negative 等）
+- 🆕 提供完整的 AI Agent 工具模板和文档
+- 📚 新增 `agent-tools/` 目录，包含 Custom Code Tool 代码和示例
+- 🐛 修复视频输出 bug
+- 🔒 增强 SSRF 防护
+- 📝 改进错误处理和资源管理
+- 🔧 修复自定义节点安装问题（使用正确的 custom 目录）
+- 🔧 修复重复节点安装问题
+
+### v1.0 (2026-01-05)
+
+- 初始版本
+- 支持多种预定义操作类型