nodes/Gin3601-LLS-node

Fork 0

Files

T

Gin3601 54aa780608 开发图像拼接节点

2026-05-25 15:29:07 +08:00

38 KiB

Raw Permalink Blame History

LLS-Node 节点参考手册

LLS ComfyUI 插件全部节点及参数说明文档。
核心设计：移除 task_context 端口，从 MODEL/CLIP/VAE 等标准对象自动推导模型家族与任务模式。

模型加载 (Model Loader)
文本编码 (Conditioning)
采样与去噪 (Sampling)
Qwen 一体化节点
Latent 空间操作
图像处理 (Image)
图像修复 (Repair)
交互式遮罩绘制 (Mask Draw)
专业图像编辑 (Pro Edit)
图像超分 (Upscale)
遮罩操作 (Mask)
工具节点 (Utils)
根级统一节点
待实现功能域

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	已实现

38 KiB Raw Permalink Blame History Unescape Escape

LLS-Node 节点参考手册

目录

1. 模型加载 (Model Loader)

LLS Simple Checkpoint Loader

LLS Universal Model Loader

2. 文本编码 (Conditioning)

LLS Simple Prompt Encode

LLS Universal Prompt Encode

3. 采样与去噪 (Sampling)

LLS Simple KSampler

4. Qwen 一体化节点

LLS Qwen Text To Image

LLS Qwen Image Edit

5. Latent 空间操作

LLS Simple Empty Latent

6. 图像处理 (Image)

LLS Simple VAE Encode

LLS Simple VAE Decode

LLS Save Image

LLS Simple Image Composite

7. 图像修复 (Repair)

LLS Simple Repair Prepare

LLS Simple Repair Finish

LLS Native Inpaint Conditioning

8. 交互式遮罩绘制 (Mask Draw)

LLS Simple Mask Draw

9. 专业图像编辑 (Pro Edit)

LLS Pro Image Edit Prepare

LLS Pro KSampler Bridge

LLS Pro Image Edit Finish

10. 图像超分 (Upscale)

LLS Upscale Switcher

11. 遮罩操作 (Mask)

LLS Simple Mask Create

LLS Mask Process

LLS Mask Combine

12. 工具节点 (Utils)

LLS String Literal

LLS Int Literal

LLS Float Literal

LLS Resolution Selector

LLS Generation Config

13. 根级统一节点

LLS Universal Image Generator

14. 待实现功能域

ControlNet (LLS/ControlNet)

LoRA (LLS/LoRA)

Video (LLS/Video)

Audio (LLS/Audio)

节点总览表

38 KiB

Raw Permalink Blame History

ControlNet (`LLS/ControlNet`)

LoRA (`LLS/LoRA`)

Video (`LLS/Video`)

Audio (`LLS/Audio`)