Files
Gin3601-LLS-node/LLS-Nodes-Reference.md
2026-05-25 15:29:07 +08:00

1048 lines
38 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# LLS-Node 节点参考手册
> LLS ComfyUI 插件全部节点及参数说明文档。
> 核心设计:移除 `task_context` 端口,从 MODEL/CLIP/VAE 等标准对象自动推导模型家族与任务模式。
---
## 目录
1. [模型加载 (Model Loader)](#1-模型加载-model-loader)
2. [文本编码 (Conditioning)](#2-文本编码-conditioning)
3. [采样与去噪 (Sampling)](#3-采样与去噪-sampling)
4. [Qwen 一体化节点](#4-qwen-一体化节点)
5. [Latent 空间操作](#5-latent-空间操作)
6. [图像处理 (Image)](#6-图像处理-image)
7. [图像修复 (Repair)](#7-图像修复-repair)
8. [交互式遮罩绘制 (Mask Draw)](#8-交互式遮罩绘制-mask-draw)
9. [专业图像编辑 (Pro Edit)](#9-专业图像编辑-pro-edit)
10. [图像超分 (Upscale)](#10-图像超分-upscale)
11. [遮罩操作 (Mask)](#11-遮罩操作-mask)
12. [工具节点 (Utils)](#12-工具节点-utils)
13. [根级统一节点](#13-根级统一节点)
14. [待实现功能域](#14-待实现功能域)
---
## 1. 模型加载 (Model Loader)
分类:`LLS/Model Loader`
### LLS Simple Checkpoint Loader
统一封装的基础模型加载器,支持 SD1.5 / SDXL / SDXL Turbo / FLUX 全家族。输出同时保留旧工作流兼容的 `clip` 端口和新的 `text_encoder` 别名。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| clip | CLIP | 原生 CLIP(旧工作流兼容) |
| vae | VAE | VAE 解码器 |
| text_encoder | CLIP | 同 clip,新命名别名 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| ckpt_name | 下拉列表 | — | 模型文件名,从 ComfyUI 的 checkpoints 和 diffusion_models 目录自动扫描 |
| model_family | 下拉列表 | Auto | 模型家族:`Auto` / `SD1.5` / `SDXL` / `SDXL_TURBO` / `FLUX_DEV` / `FLUX_SDXL`。Auto 时从模型文件名自动推断 |
| load_mode | 下拉列表 | simple | 加载模式:`simple`(简化)/ `advanced`(高级,暴露更多选项) |
| vae_source | 下拉列表 | auto | VAE 来源:`auto`(优先内嵌)/ `embedded`(仅用内嵌)/ `external`(仅用外部)/ `none`(不加载 VAE) |
| text_encoder_source | 下拉列表 | auto | 文本编码器来源:`auto` / `embedded` / `external` / `manual` |
| external_vae_name | 下拉列表 | (auto) | 外部 VAE 文件名,auto 时自动匹配 |
| external_text_encoder_1 | 下拉列表 | (auto) | 外部文本编码器 1(SD1.5: CLIP-L,SDXL: CLIP-L,FLUX: CLIP-L) |
| external_text_encoder_2 | 下拉列表 | (auto) | 外部文本编码器 2(SDXL: CLIP-G,FLUX: T5XXL) |
---
### LLS Universal Model Loader
统一模型加载器,始终输出单一 `text_encoder`,额外输出 `model_info` JSON 串供下游节点使用。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| text_encoder | CLIP | 统一文本编码器(内部处理单/双编码器差异) |
| vae | VAE | VAE 解码器 |
| model_info | STRING | JSON 格式模型元信息(家族、profile、能力标签等) |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model_name | 下拉列表 | — | 模型文件名 |
| model_family | 下拉列表 | Auto | 模型家族选择 |
| load_mode | 下拉列表 | simple | 加载模式 |
| vae_source | 下拉列表 | auto | VAE 来源:`auto` / `embedded` / `external` |
| text_encoder_source | 下拉列表 | auto | 文本编码器来源:`auto` / `embedded` / `external` |
| text_encoder_1 | 下拉列表 | (auto) | 外部文本编码器 1 |
| text_encoder_2 | 下拉列表 | (auto) | 外部文本编码器 2 |
| vae_name | 下拉列表 | (auto) | 外部 VAE 文件名 |
---
## 2. 文本编码 (Conditioning)
分类:`LLS/Conditioning`
### LLS Simple Prompt Encode
家族感知的提示词编码节点。自动根据模型家族选择编码路径(SD1.5 CLIP / SDXL 双编码器 / FLUX CLIP-L+T5)。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
| prompt_info | STRING | JSON 格式编码元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| positive_prompt | STRING(多行) | "" | 正向提示词 |
| negative_prompt | STRING(多行) | "" | 反向提示词 |
| clip_skip | 下拉列表 | -1 | CLIP 跳层:-1 表示不跳层,-2 跳最后一层,依此类推。FLUX 家族强制 -1 |
| model_family | 下拉列表 | Auto | 模型家族选择 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| text_encoder | CLIP | 文本编码器(新端口) |
| clip | CLIP | CLIP(旧端口兼容) |
> text_encoder 和 clip 至少连接一个。
---
### LLS Universal Prompt Encode
统一文本编码节点,只公开一个 `text_encoder` 输入,可选接收 `model_info` 来明确家族信息。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
| prompt_info | STRING | JSON 格式编码元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| text_encoder | CLIP | — | 文本编码器(必接) |
| positive_prompt | STRING(多行) | "" | 正向提示词 |
| negative_prompt | STRING(多行) | "" | 反向提示词 |
| clip_skip | 下拉列表 | -1 | CLIP 跳层数 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model_info | STRING | 模型元信息 JSON(来自 Universal Model Loader) |
---
## 3. 采样与去噪 (Sampling)
分类:`LLS/Sampling`
### LLS Simple KSampler
简化版 KSampler。内部复用 ComfyUI 原生采样能力,支持 `quality_preset` 一键切换采样参数,并输出 `sample_info` 元数据。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 采样后的潜空间 |
| sample_info | STRING | JSON 格式采样元信息(seed/steps/cfg/denoise/家族等) |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model | MODEL | — | 扩散模型 |
| positive | CONDITIONING | — | 正向条件 |
| negative | CONDITIONING | — | 反向条件 |
| latent_image | LATENT | — | 输入潜空间 |
| quality_preset | 下拉列表 | Family Default | 质量预设:`Family Default`(家族默认)/ `Manual`(手动)/ `Fast` / `Balanced` / `High Quality`。非 Manual 时覆盖 steps/cfg/sampler/scheduler/denoise |
| seed | INT | -1 | 随机种子。-1 时自动随机生成 |
| steps | INT | 20 | 采样步数(1–10000) |
| cfg | FLOAT | 7.0 | CFG 引导强度(0.0–100.0) |
| sampler_name | 下拉列表 | euler_ancestral | 采样器名称 |
| scheduler | 下拉列表 | karras | 调度器名称 |
| denoise | FLOAT | 1.0 | 去噪强度(0.0–1.0) |
| denoise_mode | 下拉列表 | manual | 去噪模式:`manual`(手动)/ `auto_from_repair`(从修复信息自动推荐) |
| adapter_mode | 下拉列表 | auto | 适配器模式:`auto` / `sd_classic` / `flux` / `sd3` / `qwen` / `zimage` |
| flux_guidance | FLOAT | 3.5 | FLUX 家族 guidance 值(0.0–100.0),仅 FLUX 时生效 |
| model_family | 下拉列表 | Auto | 模型家族选择 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| repair_info | LLS_REPAIR_INFO | 修复信息(来自 Repair Prepare) |
| guidance_stack | LLS_GUIDANCE_STACK | 引导栈 |
| model_info | STRING | 模型元信息 JSON |
---
## 4. Qwen 一体化节点
分类:`LLS/Qwen`
### LLS Qwen Text To Image
Qwen 文生图一体化节点。内部自动加载 Qwen 模型资源,支持高级采样控制和可选 Turbo LoRA。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 生成的图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model_name | 下拉列表 | — | Qwen 文生图模型名称 |
| prompt | STRING(多行) | "" | 提示词 |
| width | INT | 1024 | 图像宽度(16–8192,步长16) |
| height | INT | 1024 | 图像高度(16–8192,步长16) |
| steps | INT | 20 | 采样步数 |
| seed | INT | 0 | 随机种子(0–最大值) |
| batch_size | INT | 1 | 批量大小(1–64) |
| negative_prompt | STRING(多行) | "" | 反向提示词(高级参数) |
| cfg | FLOAT | 4.0 | CFG 引导强度(高级参数) |
| sampler_name | 下拉列表 | euler | 采样器(高级参数) |
| scheduler | 下拉列表 | simple | 调度器(高级参数) |
| shift | FLOAT | 3.1 | 采样偏移量(高级参数,0.0–100.0) |
| enable_turbo_mode | BOOLEAN | False | 启用 Turbo 加速模式(高级参数) |
| turbo_lora_name | 下拉列表 | (auto) | Turbo LoRA 模型名称(高级参数) |
| turbo_strength | FLOAT | 1.0 | Turbo LoRA 强度(高级参数,-100.0–100.0) |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 外部模型(可选链式连接) |
---
### LLS Qwen Image Edit
Qwen 图像编辑节点。支持多图编辑条件、可选 Turbo LoRA。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 编辑后的图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model_name | 下拉列表 | — | Qwen 编辑模型名称 |
| image | IMAGE | — | 输入图像 |
| prompt | STRING(多行) | "" | 编辑提示词 |
| steps | INT | 20 | 采样步数 |
| seed | INT | 0 | 随机种子 |
| negative_prompt | STRING(多行) | "" | 反向提示词(高级参数) |
| cfg | FLOAT | 4.0 | CFG 引导强度(高级参数) |
| sampler_name | 下拉列表 | euler | 采样器(高级参数) |
| scheduler | 下拉列表 | simple | 调度器(高级参数) |
| shift | FLOAT | 3.1 | 采样偏移量(高级参数) |
| cfg_norm_strength | FLOAT | 1.0 | CFG 归一化强度(高级参数,0.0–100.0) |
| reference_latents_method | 下拉列表 | index_timestep_zero | 参考潜空间方法(高级参数) |
| enable_turbo_mode | BOOLEAN | False | 启用 Turbo 加速(高级参数) |
| turbo_lora_name | 下拉列表 | (auto) | Turbo LoRA(高级参数) |
| turbo_strength | FLOAT | 1.0 | Turbo LoRA 强度(高级参数) |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| image2 | IMAGE | 第二张参考图(多图编辑) |
| image3 | IMAGE | 第三张参考图(多图编辑) |
| model | MODEL | 外部模型 |
---
## 5. Latent 空间操作
分类:`LLS/Latent`
### LLS Simple Empty Latent
统一的 Latent 入口节点。未连接 `image` 时生成空白 Latent(txt2img),连接 `image` 时通过 VAE Encode 生成 img2img Latent。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 潜空间张量 |
| width | INT | 实际宽度 |
| height | INT | 实际高度 |
| latent_info | STRING | JSON 格式元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| size_preset | 下拉列表 | Family Default | 尺寸预设:`Family Default`(家族默认)/ `Custom` / `512x512` / `768x768` / `512x768` / `768x512` / `1024x1024` / `832x1216` / `1216x832` / `896x1152` / `1152x896` / `1024x576` / `576x1024` |
| width | INT | 512 | 宽度(Custom 时生效,64–8192,步长8) |
| height | INT | 512 | 高度(Custom 时生效,64–8192,步长8) |
| batch_size | INT | 1 | 批量大小(1–64) |
| model_family | 下拉列表 | Auto | 模型家族选择 |
| resize_mode | 下拉列表 | keep_aspect | 缩放模式:`keep_aspect`(保持比例)/ `crop_center`(居中裁剪)/ `stretch`(拉伸)/ `none`(不缩放) |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型(用于推断家族) |
| image | IMAGE | 输入图像(连接后切换为 img2img 模式) |
| vae | VAE | VAE(img2img 时必需) |
---
## 6. 图像处理 (Image)
分类:`LLS/Image`
### LLS Simple VAE Encode
将 IMAGE 编码为 LATENT,供 img2img 使用。内部复用 ComfyUI 原生 `vae.encode`,外层补尺寸处理与元信息。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 编码后的潜空间 |
| width | INT | 实际宽度 |
| height | INT | 实际高度 |
| latent_info | STRING | JSON 格式元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image | IMAGE | — | 输入图像 |
| vae | VAE | — | VAE 解码器 |
| resize_mode | 下拉列表 | keep_aspect | 缩放模式:`keep_aspect` / `crop_center` / `stretch` / `none` |
| size_source | 下拉列表 | input_image | 尺寸来源:`input_image`(原图尺寸)/ `custom`(自定义)/ `model_recommended`(模型推荐) |
| width | INT | 512 | 自定义宽度 |
| height | INT | 512 | 自定义高度 |
| model_family | 下拉列表 | Auto | 模型家族 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| clip | CLIP | CLIP 编码器 |
---
### LLS Simple VAE Decode
将 LATENT 解码为 IMAGE。内部复用 ComfyUI 原生 `vae.decode`。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 解码后的图像 |
| decode_info | STRING | JSON 格式解码元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| samples | LATENT | — | 潜空间张量 |
| vae | VAE | — | VAE 解码器 |
---
### LLS Save Image
保存图像,并将 LLS 生成链路信息合并进 PNG metadata。支持同时保存图像和遮罩。
**输出端口**:无(终端节点)
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| filename_prefix | STRING | LLS | 文件名前缀 |
| output_mode | 下拉列表 | save | 输出模式:`save`(保存到磁盘)/ `preview_only`(仅预览) |
| save_metadata | BOOLEAN | True | 是否保存 LLS 元数据到 PNG |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 要保存的图像(与 mask 至少接一个) |
| mask | MASK | 要保存的遮罩 |
| prompt_info | STRING | 提示词元信息 |
| latent_info | STRING | 潜空间元信息 |
| sample_info | STRING | 采样元信息 |
| decode_info | STRING | 解码元信息 |
| upscale_info | STRING | 超分元信息 |
---
### LLS Simple Image Composite
将叠加图像合成到背景图像上,支持平移、缩放、旋转和透明度控制。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| output_image | IMAGE | 合成后的图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| background_image | IMAGE | — | 背景图像 |
| overlay_image | IMAGE | — | 叠加图像 |
| x_offset | INT | 0 | X 轴偏移(-8192–8192) |
| y_offset | INT | 0 | Y 轴偏移(-8192–8192) |
| anchor_mode | 下拉列表 | top_left | 锚点模式:`top_left`(左上角为基准)/ `center`(中心点为基准) |
| rotation_origin_mode | 下拉列表 | center | 旋转原点模式:`top_left` / `center` |
| opacity | FLOAT | 1.0 | 不透明度(0.0–1.0) |
| blend_mode | 下拉列表 | normal | 混合模式:`normal` |
| scale | FLOAT | 1.0 | 缩放比例(0.01–32.0) |
| rotation | FLOAT | 0.0 | 旋转角度(-360.0–360.0 度) |
| keep_aspect | BOOLEAN | True | 是否保持宽高比 |
---
## 7. 图像修复 (Repair)
分类:`LLS/Image Repair`
### LLS Simple Repair Prepare
修复流程的"准备"节点。处理输入图像和遮罩,确定修复范围(region/crop/canvas)、修复核心策略,生成工作区 Latent 和元数据。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 工作区潜空间 |
| work_image | IMAGE | 工作区图像 |
| work_mask | MASK | 工作区遮罩 |
| repair_info | LLS_REPAIR_INFO | 修复元数据 |
| recommended_denoise | FLOAT | 推荐去噪强度 |
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image | IMAGE | — | 原始图像 |
| mask | MASK | — | 修复遮罩 |
| vae | VAE | — | VAE 解码器 |
| repair_scope | 下拉列表 | auto | 修复范围:`auto` / `region`(全图区域)/ `crop`(裁剪局部)/ `canvas`(画布扩展) |
| repair_kernel | 下拉列表 | auto | 修复核心:`auto` / `latent_mask` / `vae_inpaint` / `native_fill` |
| task_hint | 下拉列表 | auto | 任务提示:`auto` / `repair` / `remove` / `replace` / `fill` / `appearance` / `content` / `structure` / `dehaze` / `deshadow` / `recolor` |
| mask_grow | INT | 24 | 遮罩扩展像素数(0–2048) |
| mask_blur | FLOAT | 8.0 | 遮罩模糊半径(0.0–256.0) |
| mask_threshold | FLOAT | 0.5 | 遮罩二值化阈值(0.0–1.0) |
| invert_mask | BOOLEAN | False | 是否反转遮罩 |
| crop_context | INT | 64 | 裁剪额外上下文边距(0–512 像素) |
| crop_context_factor | FLOAT | 1.5 | 裁剪上下文缩放因子(1.0–8.0) |
| min_size | INT | 256 | 最小工作区尺寸(64–8192,步长8) |
| max_size | INT | 1024 | 最大工作区尺寸(64–8192,步长8) |
| resize_mode | 下拉列表 | fit | 缩放模式:`fit` / `pad` / `stretch` |
| expand_left | INT | 0 | 画布左扩像素(0–4096) |
| expand_right | INT | 0 | 画布右扩像素 |
| expand_top | INT | 0 | 画布上扩像素 |
| expand_bottom | INT | 0 | 画布下扩像素 |
| canvas_fill | 下拉列表 | edge | 画布填充模式:`edge`(边缘延展)/ `blur` / `black` / `white` / `neutral` |
| auto_recommend | 下拉列表 | enabled | 自动推荐去噪值:`enabled` / `disabled` |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| model_info | STRING | 模型元信息 |
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
---
### LLS Simple Repair Finish
修复流程的"合成"节点。将修复结果合成回原始图像,支持羽化、颜色匹配、亮度匹配和边缘修复。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| final_image | IMAGE | 最终合成图像 |
| preview_image | IMAGE | 预览图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| original_image | IMAGE | — | 原始图像 |
| generated_image | IMAGE | — | 修复后的图像 |
| repair_info | LLS_REPAIR_INFO | — | 修复元数据(来自 Repair Prepare) |
| feather | FLOAT | 8.0 | 羽化半径(0.0–256.0) |
| color_match | 下拉列表 | disabled | 颜色匹配:`disabled` / `mean_std`(均值标准差匹配)/ `histogram_simple`(直方图匹配) |
| brightness_match | 下拉列表 | enabled | 亮度匹配:`disabled` / `enabled` |
| blend_strength | FLOAT | 1.0 | 混合强度(0.0–1.0) |
| restore_unmasked_area | BOOLEAN | True | 是否恢复未遮罩区域 |
| edge_fix | 下拉列表 | soft | 边缘修复:`none` / `soft` / `strong` |
| preview_mode | 下拉列表 | final | 预览模式:`final` / `compare` / `mask` / `before_after` |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| work_mask | MASK | 工作区遮罩 |
| sample_info | STRING | 采样元信息 |
---
### LLS Native Inpaint Conditioning
ComfyUI 原生 InpaintModelConditioning 的薄封装。可自动为 FLUX 家族应用 DifferentialDiffusion 模型补丁。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 可能经过补丁的模型 |
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
| latent | LATENT | 编码后的潜空间 |
| inpaint_info | STRING | JSON 格式修复信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model | MODEL | — | 扩散模型 |
| positive | CONDITIONING | — | 正向条件 |
| negative | CONDITIONING | — | 反向条件 |
| vae | VAE | — | VAE 解码器 |
| image | IMAGE | — | 原始图像 |
| mask | MASK | — | 修复遮罩 |
| patch_mode | 下拉列表 | auto | 模型补丁模式:`auto`(FLUX 自动应用)/ `disabled` / `differential_diffusion` |
| patch_strength | FLOAT | 1.0 | 补丁强度(0.0–1.0) |
| noise_mask | BOOLEAN | True | 是否使用噪声遮罩 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model_info | STRING | 模型元信息 |
---
## 8. 交互式遮罩绘制 (Mask Draw)
分类:`LLS/Image Repair`
### LLS Simple Mask Draw
交互式遮罩绘制节点。前端 JS 配合实现在画布上绘制/擦除遮罩,后端解析绘制状态并输出遮罩和预览。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 原始图像(透传) |
| mask | MASK | 最终遮罩 |
| preview_image | IMAGE | 遮罩叠加预览图 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image | IMAGE | — | 原始图像(同时作为绘制画布背景) |
| draw_mode | 下拉列表 | brush | 绘制模式:`brush`(画笔)/ `erase`(擦除) |
| brush_size | INT | 32 | 画笔大小(1–512) |
| brush_softness | FLOAT | 0.5 | 画笔柔和度(0.0–1.0) |
| overlay_alpha | FLOAT | 0.4 | 预览叠加透明度(0.0–1.0) |
| invert_mask | BOOLEAN | False | 是否反转遮罩 |
| mask_state_json | STRING | {} | 遮罩绘制状态 JSON(前端自动维护,高级参数) |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| input_mask | MASK | 初始遮罩(可在此基础继续编辑) |
---
## 9. 专业图像编辑 (Pro Edit)
分类:`LLS/Image Edit`
### LLS Pro Image Edit Prepare
专业图像编辑的"准备"节点。与 Repair Prepare 类似,但面向更通用的图像编辑场景(如局部替换、外观修改),支持自动后端路由。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 工作区潜空间 |
| work_image | IMAGE | 工作区图像 |
| work_mask | MASK | 工作区遮罩 |
| edit_info | LLS_EDIT_INFO | 编辑元数据 |
| recommended_denoise | FLOAT | 推荐去噪强度 |
| positive | CONDITIONING | 正向条件 |
| negative | CONDITIONING | 反向条件 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image | IMAGE | — | 原始图像 |
| mask | MASK | — | 编辑遮罩 |
| vae | VAE | — | VAE 解码器 |
| positive | CONDITIONING | — | 正向条件 |
| negative | CONDITIONING | — | 反向条件 |
| backend_mode | 下拉列表 | auto | 后端模式:`auto` / `sdxl` / `flux` |
| edit_scope | 下拉列表 | auto | 编辑范围:`auto` / `region` / `crop` / `canvas` |
| mask_grow | INT | 24 | 遮罩扩展(0–2048) |
| mask_blur | FLOAT | 8.0 | 遮罩模糊(0.0–256.0) |
| mask_threshold | FLOAT | 0.5 | 遮罩阈值 |
| invert_mask | BOOLEAN | False | 反转遮罩 |
| crop_context | INT | 64 | 裁剪上下文边距 |
| crop_context_factor | FLOAT | 1.5 | 裁剪上下文因子 |
| min_size | INT | 256 | 最小尺寸 |
| max_size | INT | 1024 | 最大尺寸 |
| resize_mode | 下拉列表 | fit | 缩放模式:`fit` / `pad` / `stretch` |
| expand_left | INT | 0 | 左扩像素 |
| expand_right | INT | 0 | 右扩像素 |
| expand_top | INT | 0 | 上扩像素 |
| expand_bottom | INT | 0 | 下扩像素 |
| canvas_fill | 下拉列表 | edge | 画布填充:`edge` / `blur` / `black` / `white` / `neutral` |
| auto_recommend | 下拉列表 | enabled | 自动推荐:`enabled` / `disabled` |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| model_info | STRING | 模型元信息 |
---
### LLS Pro KSampler Bridge
专业编辑流程的高级采样器桥接节点,支持分步采样控制(start_at_step / end_at_step)。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| latent | LATENT | 采样结果 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model | MODEL | — | 扩散模型 |
| add_noise | 下拉列表 | enable | 是否添加噪声:`enable` / `disable`(高级参数) |
| noise_seed | INT | 0 | 噪声种子 |
| steps | INT | 20 | 采样步数 |
| cfg | FLOAT | 8.0 | CFG 引导强度 |
| sampler_name | 下拉列表 | — | 采样器 |
| scheduler | 下拉列表 | — | 调度器 |
| positive | CONDITIONING | — | 正向条件 |
| negative | CONDITIONING | — | 反向条件 |
| latent_image | LATENT | — | 输入潜空间 |
| start_at_step | INT | 0 | 起始步(高级参数,0–10000) |
| end_at_step | INT | 10000 | 结束步(高级参数,0–10000) |
| return_with_leftover_noise | 下拉列表 | disable | 返回残余噪声:`disable` / `enable`(高级参数) |
---
### LLS Pro Image Edit Finish
专业图像编辑的"合成"节点。与 Repair Finish 类似,处理编辑结果的合成回贴。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| final_image | IMAGE | 最终合成图像 |
| preview_image | IMAGE | 预览图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| original_image | IMAGE | — | 原始图像 |
| generated_image | IMAGE | — | 编辑后图像 |
| edit_info | LLS_EDIT_INFO | — | 编辑元数据(来自 Pro Edit Prepare) |
| feather | FLOAT | 8.0 | 羽化半径 |
| color_match | 下拉列表 | disabled | 颜色匹配:`disabled` / `mean_std` / `histogram_simple` |
| brightness_match | 下拉列表 | enabled | 亮度匹配:`disabled` / `enabled` |
| blend_strength | FLOAT | 1.0 | 混合强度 |
| restore_unmasked_area | BOOLEAN | True | 恢复未遮罩区域 |
| edge_fix | 下拉列表 | soft | 边缘修复:`none` / `soft` / `strong` |
| preview_mode | 下拉列表 | final | 预览模式:`final` / `compare` / `mask` / `before_after` |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| work_mask | MASK | 工作区遮罩 |
| sample_info | STRING | 采样元信息 |
---
## 10. 图像超分 (Upscale)
分类:`LLS/Upscale`
### LLS Upscale Switcher
超分辨率切换节点,可在 ESRGAN 等超分模型和 PyTorch 插值之间切换。超分模型模式支持分块推理防止 OOM。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 超分后的图像 |
| upscale_info | STRING | JSON 格式超分元信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image | IMAGE | — | 输入图像 |
| mode | 下拉列表 | upscale_model | 超分模式:`none`(不放大)/ `interpolation`(PyTorch 插值)/ `upscale_model`(超分模型)/ `latent_upscale`(潜空间超分,回退到插值)/ `tile_upscale`(分块超分)/ `pytorch`(同 interpolation) |
| scale | FLOAT | 2.0 | 放大倍率(0.1–8.0) |
| interpolation | 下拉列表 | bilinear | 插值方法:`nearest` / `bilinear` / `bicubic` / `area` |
| model_name | 下拉列表 | — | 超分模型文件名 |
| tile | INT | 512 | 分块大小(128–2048,步长64) |
| overlap | INT | 32 | 分块重叠(0–256,步长8) |
---
## 11. 遮罩操作 (Mask)
分类:`LLS/Mask`
### LLS Simple Mask Create
几何遮罩创建节点。通过指定宽高、形状、位置等参数创建矩形/圆形/椭圆遮罩。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| mask_image | IMAGE | 遮罩可视化图像 |
| mask | MASK | 遮罩张量 |
| area_info | STRING | JSON 格式遮罩区域信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| image_width | INT | 1024 | 图像宽度(1–8192) |
| image_height | INT | 1024 | 图像高度(1–8192) |
| shape_type | 下拉列表 | rectangle | 形状类型:`rectangle` / `ellipse` / `circle` 等 |
| coordinate_mode | 下拉列表 | percent | 坐标模式:`percent`(百分比)/ `pixel`(像素) |
| center_x | FLOAT | 0.5 | 中心 X 坐标 |
| center_y | FLOAT | 0.5 | 中心 Y 坐标 |
| width | FLOAT | 0.3 | 形状宽度 |
| height | FLOAT | 0.3 | 形状高度 |
| radius | FLOAT | 0.15 | 圆形半径 |
| feather | FLOAT | 0.0 | 羽化强度(0.0–128.0) |
| blur | FLOAT | 0.0 | 模糊强度(0.0–128.0) |
| invert_mask | BOOLEAN | False | 是否反转遮罩 |
| combine_mode | 下拉列表 | replace | 与输入遮罩的合并模式:`replace` / `add` / `subtract` / `intersect` 等 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| input_mask | MASK | 输入遮罩(在 replace 以外的模式下与此合并) |
---
### LLS Mask Process
单遮罩处理节点,支持多种常见操作。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| mask | MASK | 处理后的遮罩 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| mask | MASK | — | 输入遮罩 |
| operation | 下拉列表 | passthrough | 处理操作:`passthrough`(透传)/ `threshold`(二值化)/ `invert`(反转)/ `grow`(扩展)/ `shrink`(收缩)/ `blur`(模糊)/ `feather`(羽化)/ `fill_holes`(填充孔洞)/ `remove_small_regions`(去除小区域)/ `smooth`(平滑)/ `clamp`(裁剪)/ `resize_to_image`(缩放至图像尺寸) |
| value_float | FLOAT | 0.5 | 浮点参数(threshold 时为阈值,0.0–1.0) |
| value_int | INT | 8 | 整数参数(grow/shrink/blur 的像素值,-512–512) |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 目标图像(resize_to_image 操作时使用) |
---
### LLS Mask Combine
双遮罩合并节点,支持逻辑运算风格的合并。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| mask | MASK | 合并后的遮罩 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| mask_a | MASK | — | 遮罩 A |
| mask_b | MASK | — | 遮罩 B |
| mode | 下拉列表 | add | 合并模式:`add`/`max`(取大)/ `subtract`(A减B)/ `intersect`/`min`(取小)/ `xor`(异或) |
---
## 12. 工具节点 (Utils)
分类:`LLS/Utils`
### LLS String Literal
输出一个字符串常量,可复用于多个下游节点。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| string | STRING | 字符串值 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| value | STRING(多行) | "" | 字符串内容 |
---
### LLS Int Literal
输出一个整数常量。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| int | INT | 整数值 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| value | INT | 0 | 整数值(-2^31 – 2^31-1) |
---
### LLS Float Literal
输出一个浮点数常量。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| float | FLOAT | 浮点数值 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| value | FLOAT | 0.0 | 浮点数值 |
---
### LLS Resolution Selector
常用分辨率选择器,返回宽度和高度。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| width | INT | 宽度 |
| height | INT | 高度 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| preset | 下拉列表 | 1024x1024 | 预设分辨率:`Custom` / `512x512` / `768x768` / `1024x1024` / `512x768` / `768x512` / `768x1024` / `1024x768` / `1024x576` / `576x1024` / `1280x720` / `720x1280` / `1920x1080` / `1080x1920` / `2048x2048` |
| custom_width | INT | 1024 | 自定义宽度(64–8192,步长8) |
| custom_height | INT | 1024 | 自定义高度(64–8192,步长8) |
---
### LLS Generation Config
按模型家族输出推荐分辨率与采样配置。根据 quality_preset 和 size_preset 自动生成最佳参数。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| width | INT | 推荐宽度 |
| height | INT | 推荐高度 |
| steps | INT | 推荐步数 |
| cfg | FLOAT | 推荐 CFG |
| guidance | FLOAT | 推荐 guidance(FLUX 用) |
| sampler_name | STRING | 推荐采样器 |
| scheduler | STRING | 推荐调度器 |
| denoise | FLOAT | 推荐去噪强度 |
| config_info | STRING | JSON 格式完整配置信息 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| quality_preset | 下拉列表 | Family Default | 质量预设:`Family Default` / `Manual` / `Fast` / `Balanced` / `High Quality` |
| size_preset | 下拉列表 | Family Default | 尺寸预设:`Family Default` / `Custom` / `512x512` / `768x768` / `1024x1024` |
| model_family | 下拉列表 | Auto | 模型家族 |
**可选输入**
| 参数名 | 类型 | 说明 |
|--------|------|------|
| model | MODEL | 扩散模型 |
| clip | CLIP | CLIP 编码器 |
---
## 13. 根级统一节点
### LLS Universal Image Generator
根级统一 txt2img 入口节点。收集请求并交给 dispatcher 选择对应家族后端适配器(SD1.5 / SDXL / FLUX)。
**输出端口**
| 端口名 | 类型 | 说明 |
|--------|------|------|
| image | IMAGE | 生成的图像 |
**输入参数**
| 参数名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| model_family | 下拉列表 | SD1.5 | 模型家族:`SD1.5` / `SDXL` / `FLUX` |
| task_mode | 下拉列表 | txt2img | 任务模式 |
| model_name | 下拉列表 | — | 模型文件名 |
| positive_prompt | STRING(多行) | "" | 正向提示词 |
| negative_prompt | STRING(多行) | "" | 反向提示词 |
| width | INT | 1024 | 图像宽度(64–8192,步长8) |
| height | INT | 1024 | 图像高度 |
| steps | INT | 20 | 采样步数 |
| cfg | FLOAT | 7.0 | CFG 引导强度 |
| seed | INT | -1 | 随机种子(-1 自动生成) |
| sampler_name | 下拉列表 | euler | 采样器 |
| scheduler | 下拉列表 | normal | 调度器 |
| denoise | FLOAT | 1.0 | 去噪强度 |
---
## 14. 待实现功能域
以下子包已创建框架,但节点尚未实现(`NODE_CLASS_MAPPINGS` 为空):
### ControlNet (`LLS/ControlNet`)
计划节点:
- LLSControlNetApply / LLSControlNetApplyAdv
- LLST2IAdapterApply / LLSControlNetStack
- LLSCannyPreprocess / LLSDepthPreprocess / LLSHEDPreprocess
- LLSLotusDepth / LLSLotusNormal
### LoRA (`LLS/LoRA`)
计划节点:
- LLSLoRALoader / LLSLoRAApply / LLSLoRAStack / LLSLoRAStackApply
- LLSHypernetworkApply / LLSLoRAExtract
- LLSIPAdapterApply / LLSHookLoRA / LLSWeightAdapter
### Video (`LLS/Video`)
计划节点:
- LLSLoadVideoFrames / LLSSaveVideo / LLSFrameInterpolation
- LLSSVDSampler / LLSCogVideoXSampler / LLSHunyuanVideoSampler
- LLSWanVideoSampler / LLSLTXVideoSampler / LLSVideoUpscale / LLSCameraControl
### Audio (`LLS/Audio`)
计划节点:
- LLSLoadAudio / LLSSaveAudio / LLSAudioCrop / LLSAudioConcat
- LLSAudioResample / LLSAudioVolumeAdjust / LLSAudioBatch
- LLSAudioEncode / LLSCosyVoiceTTS / LLSHunyuanAudio / LLSSpectrogram
---
## 节点总览表
| # | 节点类名 | 显示名 | 分类 | 状态 |
|---|----------|--------|------|------|
| 1 | LLSSimpleCheckpointLoader | LLS Simple Checkpoint Loader | LLS/Model Loader | 已实现 |
| 2 | LLSUniversalModelLoader | LLS Universal Model Loader | LLS/Model Loader | 已实现 |
| 3 | LLSSimplePromptEncode | LLS Simple Prompt Encode | LLS/Conditioning | 已实现 |
| 4 | LLSUniversalPromptEncode | LLS Universal Prompt Encode | LLS/Conditioning | 已实现 |
| 5 | LLSSimpleKSampler | LLS Simple KSampler | LLS/Sampling | 已实现 |
| 6 | LLSQwenTextToImage | LLS Qwen Text To Image | LLS/Qwen | 已实现 |
| 7 | LLSQwenImageEdit | LLS Qwen Image Edit | LLS/Qwen | 已实现 |
| 8 | LLSSimpleEmptyLatent | LLS Simple Empty Latent | LLS/Latent | 已实现 |
| 9 | LLSSimpleVAEEncode | LLS Simple VAE Encode | LLS/Image | 已实现 |
| 10 | LLSSimpleVAEDecode | LLS Simple VAE Decode | LLS/Image | 已实现 |
| 11 | LLSSaveImage | LLS Save Image | LLS/Image | 已实现 |
| 12 | LLSSimpleImageComposite | LLS Simple Image Composite | LLS/Image | 已实现 |
| 13 | LLSSimpleRepairPrepare | LLS Simple Repair Prepare | LLS/Image Repair | 已实现 |
| 14 | LLSSimpleRepairFinish | LLS Simple Repair Finish | LLS/Image Repair | 已实现 |
| 15 | LLSNativeInpaintConditioning | LLS Native Inpaint Conditioning | LLS/Image Repair | 已实现 |
| 16 | LLSSimpleMaskDraw | LLS Simple Mask Draw | LLS/Image Repair | 已实现 |
| 17 | LLSProImageEditPrepare | LLS Pro Image Edit Prepare | LLS/Image Edit | 已实现 |
| 18 | LLSProKSamplerBridge | LLS Pro KSampler Bridge | LLS/Image Edit | 已实现 |
| 19 | LLSProImageEditFinish | LLS Pro Image Edit Finish | LLS/Image Edit | 已实现 |
| 20 | LLSUpscaleSwitcher | LLS Upscale Switcher | LLS/Upscale | 已实现 |
| 21 | LLSSimpleMaskCreate | LLS Simple Mask Create | LLS/Mask | 已实现 |
| 22 | LLSMaskProcess | LLS Mask Process | LLS/Mask | 已实现 |
| 23 | LLSMaskCombine | LLS Mask Combine | LLS/Mask | 已实现 |
| 24 | LLSStringLiteral | LLS String Literal | LLS/Utils | 已实现 |
| 25 | LLSIntLiteral | LLS Int Literal | LLS/Utils | 已实现 |
| 26 | LLSFloatLiteral | LLS Float Literal | LLS/Utils | 已实现 |
| 27 | LLSResolutionSelector | LLS Resolution Selector | LLS/Utils | 已实现 |
| 28 | LLSGenerationConfig | LLS Generation Config | LLS/Utils | 已实现 |
| 29 | LLSUniversalImageGenerator | LLS Universal Image Generator | LLS/Image | 已实现 |