ComfyUI_tinyterraNodes 插件完整教程

1. 插件简介

插件地址： https://github.com/TinyTerra/ComfyUI_tinyterraNodes

这个插件是一个功能强大的 ComfyUI 扩展包，提供了大量实用的节点来简化工作流程。它就像是给 ComfyUI 装了一个超级工具箱，里面有各种各样的小工具，让你做图更方便、更高效。

主要功能：

管道式节点：把复杂的连线简化成一根管子，数据在里面流动
高级 XY 图表：批量生成不同参数的图片对比
全屏图片查看器：更好地查看生成的图片
文本处理工具：各种文本操作功能
图片处理工具：图片输出、背景移除等
实用小工具：数字、种子等基础工具

2. 如何安装

打开命令行/终端
进入 ComfyUI 的 custom_nodes 文件夹
运行命令：git clone https://github.com/TinyTerra/ComfyUI_tinyterraNodes.git
重启 ComfyUI

3. 节点详细解析

3.1 基础节点 (ttN/base)

3.1.1 tinyLoader 节点

这个节点就像一个简化版的模型加载器，把原本需要好几个节点才能完成的模型加载工作合并到一个节点里。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
模型名称	ckpt_name	模型文件列表	根据需要选择	选择要用的AI模型，就像选择画笔	选择checkpoint模型文件	选择 "v1-5-pruned.ckpt"
配置名称	config_name	Default/配置文件列表	Default	模型的配置文件，一般用默认的	模型配置文件	保持 "Default"
采样方式	sampling	Default/eps/v_prediction等	Default	不同的采样算法，影响生成效果	采样算法类型	一般用 "Default"
ZSNR	zsnr	True/False	False	一种优化技术，一般不用开	Zero SNR优化	保持 False
CFG重缩放	cfg_rescale_mult	0.0-1.0	0.0	CFG引导的重缩放，高级功能	CFG rescale multiplier	保持 0.0
VAE名称	vae_name	Baked VAE/VAE文件列表	Baked VAE	图像编码器，用默认的就行	VAE模型选择	用 "Baked VAE"
CLIP跳过层数	clip_skip	-24到0	-1	跳过CLIP的最后几层，影响理解能力	CLIP层数跳过	用 -1 或 -2
空白潜在空间宽高比	empty_latent_aspect	预设比例列表	512 x 512 [S] 1:1	生成图片的尺寸比例	潜在空间尺寸比例	选择想要的图片比例
宽度	empty_latent_width	64-最大分辨率	512	图片宽度，必须是8的倍数	图像宽度像素	512、768、1024等
高度	empty_latent_height	64-最大分辨率	512	图片高度，必须是8的倍数	图像高度像素	512、768、1024等
批次大小	batch_size	1-64	1	一次生成几张图	批处理大小	一般用1

3.1.2 tinyConditioning 节点

这个节点专门处理提示词，把正面和负面提示词转换成AI能理解的格式。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
模型	model	MODEL类型	连接输入	从其他节点接收模型	模型输入	连接tinyLoader的model输出
CLIP	clip	CLIP类型	连接输入	从其他节点接收CLIP	CLIP输入	连接tinyLoader的clip输出
LoRA设置	loras	文本	空	LoRA模型的设置，格式特殊	LoRA配置字符串	`<lora:detail:0.8>`
正面提示词	positive	文本	Positive	你想要的内容描述	正向条件提示	"beautiful girl, detailed"
正面词元标准化	positive_token_normalization	none/mean/length等	none	提示词处理方式，一般不改	token标准化方法	保持 "none"
正面权重解释	positive_weight_interpretation	comfy/A1111等	comfy	权重语法的解释方式	权重解释方法	保持 "comfy"
负面提示词	negative	文本	Negative	你不想要的内容	负向条件提示	"blurry, low quality"
负面词元标准化	negative_token_normalization	none/mean/length等	none	同正面设置	token标准化方法	保持 "none"
负面权重解释	negative_weight_interpretation	comfy/A1111等	comfy	同正面设置	权重解释方法	保持 "comfy"
空内容归零	zero_out_empty	True/False	False	空提示词时是否归零处理	空条件处理	一般用False

3.1.3 tinyKSampler 节点

这是采样器节点，负责实际生成图片的过程。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
模型	model	MODEL类型	连接输入	AI模型	扩散模型	连接conditioning的model输出
正面条件	positive	CONDITIONING类型	连接输入	正面提示词处理结果	正向条件	连接conditioning的positive输出
负面条件	negative	CONDITIONING类型	连接输入	负面提示词处理结果	负向条件	连接conditioning的negative输出
潜在空间	latent	LATENT类型	连接输入	图片的潜在表示	潜在张量	连接tinyLoader的latent输出
VAE	vae	VAE类型	连接输入	图像编码解码器	VAE模型	连接tinyLoader的vae输出
LoRA名称	lora_name	None/LoRA列表	None	要使用的LoRA模型	LoRA模型选择	选择具体的LoRA文件
LoRA强度	lora_strength	-10.0到10.0	1.0	LoRA的影响强度	LoRA权重	0.8表示80%强度
放大方法	upscale_method	None/各种放大方法	None	是否要放大图片	上采样方法	选择放大算法
放大模型	upscale_model_name	放大模型列表	-	用于放大的AI模型	上采样模型	选择RealESRGAN等
放大倍数	factor	0.0-10.0	2.0	放大几倍	放大系数	2.0表示放大2倍
重缩放方式	rescale	按百分比/到宽高等	by percentage	放大后如何调整尺寸	重缩放方法	选择合适的方式
百分比	percent	0-1000	50	重缩放的百分比	缩放百分比	50表示缩放到50%
宽度	width	64-最大分辨率	1024	目标宽度	目标宽度像素	1024像素
高度	height	64-最大分辨率	1024	目标高度	目标高度像素	1024像素
长边	longer_side	64-最大分辨率	1024	保持比例时的长边尺寸	长边像素数	1024像素
裁剪方式	crop	disabled/center	disabled	是否裁剪图片	裁剪方法	一般不裁剪
步数	steps	1-10000	20	生成的迭代次数，越多越精细	采样步数	20-50步比较常用
CFG	cfg	0.0-100.0	8.0	提示词的遵循程度	CFG引导强度	7-12比较常用
采样器名称	sampler_name	采样器列表	-	采样算法的选择	采样器类型	DPM++、Euler等
调度器	scheduler	调度器列表	-	步长调度方式	调度器类型	normal、karras等
去噪强度	denoise	0.0-1.0	1.0	去噪的强度，1.0是完全重新生成	去噪系数	1.0表示完全重新生成
图片输出	image_output	Hide/Preview/Save等	Preview	图片的显示和保存方式	输出模式	Preview用于预览
保存前缀	save_prefix	文本	ComfyUI	保存文件的前缀名	文件名前缀	"my_image"
文件类型	file_type	png/jpg等	png	保存的文件格式	文件格式	png质量最好
嵌入工作流	embed_workflow	True/False	True	是否在图片中保存工作流信息	工作流嵌入	True便于分享

3.2 管道节点 (ttN/pipe)

3.2.1 pipeLoader 节点

这个节点就像一个超级加载器，把模型、VAE、CLIP、提示词处理等功能都集成在一起，输出一个"管道"，让数据像水流一样在管道里传输。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
模型名称	ckpt_name	模型文件列表	根据需要	选择AI模型文件	checkpoint模型	选择你要用的模型
配置名称	config_name	Default/配置列表	Default	模型配置文件	模型配置	一般用Default
VAE名称	vae_name	Baked VAE/VAE列表	Baked VAE	图像编码器选择	VAE选择	用默认的就行
CLIP跳过	clip_skip	-24到0	-1	跳过CLIP最后几层	CLIP层跳过	-1或-2
LoRA设置	loras	文本	空	LoRA模型配置	LoRA字符串	`<lora:name:0.8>`
正面提示词	positive	文本	Positive	想要的内容描述	正向提示	描述你想要的画面
正面标准化	positive_token_normalization	none/mean等	none	提示词处理方式	token标准化	保持默认
正面权重解释	positive_weight_interpretation	comfy/A1111等	comfy	权重语法解释	权重解释方式	保持默认
负面提示词	negative	文本	Negative	不想要的内容	负向提示	描述不要的元素
负面标准化	negative_token_normalization	none/mean等	none	同正面设置	token标准化	保持默认
负面权重解释	negative_weight_interpretation	comfy/A1111等	comfy	同正面设置	权重解释方式	保持默认
空白潜在宽高比	empty_latent_aspect	比例列表	512 x 512 [S] 1:1	图片尺寸比例	潜在空间比例	选择合适比例
宽度	empty_latent_width	64-最大分辨率	512	图片宽度	宽度像素	512、768等
高度	empty_latent_height	64-最大分辨率	512	图片高度	高度像素	512、768等
批次大小	batch_size	1-64	1	一次生成几张	批处理大小	通常用1
种子	seed	0-最大整数	0	随机种子，控制随机性	随机种子	固定种子得到相同结果

3.2.2 pipeKSampler 节点

这是管道版的采样器，接收管道输入，进行图片生成。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
管道	pipe	PIPE_LINE类型	连接输入	从pipeLoader接收的数据管道	管道输入	连接pipeLoader输出
LoRA名称	lora_name	None/LoRA列表	None	额外的LoRA模型	LoRA模型	可以叠加使用
LoRA强度	lora_strength	-10.0到10.0	1.0	LoRA影响强度	LoRA权重	0.8表示80%强度
放大方法	upscale_method	None/放大方法列表	None	图片放大方式	上采样方法	选择放大算法
放大模型	upscale_model_name	放大模型列表	-	放大用的AI模型	上采样模型	RealESRGAN等
放大倍数	factor	0.0-10.0	2.0	放大几倍	放大系数	2倍、4倍等
重缩放	rescale	按百分比等	by percentage	放大后调整方式	重缩放方法	选择合适方式
百分比	percent	0-1000	50	重缩放百分比	缩放百分比	50表示50%
宽度	width	64-最大分辨率	1024	目标宽度	目标宽度	1024像素
高度	height	64-最大分辨率	1024	目标高度	目标高度	1024像素
长边	longer_side	64-最大分辨率	1024	长边尺寸	长边像素	保持比例
裁剪	crop	disabled/center	disabled	裁剪方式	裁剪方法	一般不裁剪
步数	steps	1-10000	20	生成步数	采样步数	20-50步
CFG	cfg	0.0-100.0	8.0	提示词遵循度	CFG引导	7-12常用
采样器	sampler_name	采样器列表	-	采样算法	采样器	DPM++等
调度器	scheduler	调度器列表	-	步长调度	调度器	normal等
去噪强度	denoise	0.0-1.0	1.0	去噪程度	去噪系数	1.0完全重生成
图片输出	image_output	Hide/Preview等	Preview	输出方式	输出模式	Preview预览
保存前缀	save_prefix	文本	ComfyUI	文件名前缀	文件前缀	自定义名称
文件类型	file_type	png/jpg等	png	文件格式	文件格式	png最佳
嵌入工作流	embed_workflow	True/False	True	保存工作流信息	工作流嵌入	True便于分享

3.3 XY图表节点 (ttN/xyPlot)

3.3.1 advanced xyPlot 节点

这个节点可以批量生成不同参数的图片对比，就像做实验一样，一次性测试多种参数组合。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
网格间距	grid_spacing	0-500	0	图片之间的间距	网格间距像素	0表示紧贴
保存单张	save_individuals	True/False	False	是否保存每张单独的图	单独保存开关	True保存所有单图
翻转XY	flip_xy	True/False	False	交换X轴和Y轴	轴交换	改变对比方向
X轴设置	x_plot	文本	空	X轴的参数变化设置	X轴配置	设置横向对比参数
Y轴设置	y_plot	文本	空	Y轴的参数变化设置	Y轴配置	设置纵向对比参数
Z轴设置	z_plot	文本	空	Z轴的参数变化设置	Z轴配置	多层对比
反转背景	invert_background	True/False	False	背景颜色反转	背景反转	黑白背景切换

3.3.2 advPlot images 节点

专门用于从图片输入创建XY对比图。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
启用	enabled	True/False	True	是否启用这个功能	功能开关	True启用
图片	image	IMAGE类型	连接输入	输入的图片	图像输入	连接图片源
图片输出	image_output	Hide/Preview等	Preview	输出方式	输出模式	Preview预览
保存前缀	save_prefix	文本	ComfyUI	文件名前缀	文件前缀	自定义名称
文件类型	file_type	png/jpg等	png	文件格式	文件格式	png最佳
嵌入工作流	embed_workflow	True/False	True	保存工作流信息	工作流嵌入	True便于分享

3.4 文本节点 (ttN/text)

3.4.1 text 节点

基础的文本输入节点，就像一个文本框。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
文本	text	文本	空	输入任意文本内容	字符串输入	输入提示词或其他文本

3.4.2 textDebug 节点

用于调试的文本显示节点，可以在控制台打印文本。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
打印到控制台	print_to_console	True/False	False	是否在控制台显示	控制台输出	True显示调试信息
控制台标题	console_title	文本	空	控制台显示的标题	调试标题	给调试信息加标题
执行方式	execute	Always/On Change	On Change	何时执行显示	执行条件	On Change仅变化时
文本	text	文本	空	要显示的文本内容	文本输入	连接其他节点的文本输出

3.4.3 textConcat 节点

文本连接节点，把多个文本合并成一个。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
文本1	text1	文本	空	第一段文本	文本输入1	"beautiful"
文本2	text2	文本	空	第二段文本	文本输入2	"girl"
文本3	text3	文本	空	第三段文本	文本输入3	"portrait"
分隔符	delimiter	文本	,	文本之间的分隔符	分隔字符	用逗号或空格分隔

3.5 图片节点 (ttN/image)

3.5.1 imageOutput 节点

专门用于图片输出和保存的节点。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
图片	image	IMAGE类型	连接输入	要输出的图片	图像输入	连接生成的图片
图片输出	image_output	Hide/Preview/Save等	Preview	输出方式	输出模式	Preview预览，Save保存
输出路径	output_path	文本	默认输出目录	保存图片的文件夹路径	输出目录	自定义保存位置
保存前缀	save_prefix	文本	ComfyUI	文件名前缀	文件前缀	给文件起个好名字
数字填充	number_padding	None/2-9	5	文件名数字的位数	数字填充位数	5表示00001格式
文件类型	file_type	png/jpg等	png	保存的文件格式	文件格式	png质量最好
覆盖已存在	overwrite_existing	True/False	False	是否覆盖同名文件	覆盖模式	False避免覆盖
嵌入工作流	embed_workflow	True/False	True	在图片中保存工作流	工作流嵌入	True便于分享

3.5.2 imageREMBG 节点

背景移除节点，可以自动去除图片背景。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
图片	image	IMAGE类型	连接输入	要去背景的图片	图像输入	连接原图
图片输出	image_output	Hide/Preview等	Preview	输出方式	输出模式	Preview查看效果
保存前缀	save_prefix	文本	ComfyUI	文件名前缀	文件前缀	自定义名称

3.6 实用工具节点 (ttN/util)

3.6.1 int 节点

整数输入和转换节点。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
整数	int	0-最大整数	0	输入一个整数	整数输入	输入步数、种子等

3.6.2 float 节点

浮点数输入和转换节点。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
浮点数	float	0.00-最大浮点数	0.00	输入一个小数	浮点数输入	输入CFG、去噪强度等

3.6.3 seed 节点

种子输入节点，用于控制随机性。

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
种子	seed	0-最大整数	0	随机种子数值	随机种子	固定种子得到相同结果

4. 使用技巧和建议

4.1 管道节点的优势

简化连线：用一根管道代替多根连线，让工作流更清爽
数据完整性：管道包含所有必要信息，不容易遗漏
易于调试：可以在管道的任何位置插入调试节点

4.2 XY图表的使用技巧

参数对比：用于测试不同CFG、步数、采样器的效果
模型对比：比较不同模型或LoRA的效果
提示词测试：测试不同提示词的影响

4.3 文本处理技巧

动态提示词：使用文本连接节点组合复杂提示词
调试信息：用textDebug查看中间处理结果

5. 常见问题解答

Q1: 管道节点和普通节点有什么区别？

A: 管道节点把多个数据打包成一个"管道"传输，就像把多根水管合并成一根大管子，数据流动更高效，连线更简洁。

Q2: XY图表怎么设置参数？

A: 在X轴或Y轴设置框中输入特定格式的文本，比如：

<1:CFG对比>
[节点ID:cfg='7']

<2:CFG对比>
[节点ID:cfg='12']

Q3: 为什么有些节点显示红色？

A: 红色表示节点版本不匹配，需要更新插件或重新加载工作流。

Q4: 如何使用全屏查看器？

A: 右键点击有图片输出的节点，选择"🌏 Fullscreen"即可全屏查看生成的图片。

Q5: LoRA设置的格式是什么？

A: 格式为：<lora:文件名:模型强度:CLIP强度>，例如：<lora:detail:0.8:0.8>

6. 高级功能

6.1 全屏图片查看器

支持幻灯片模式
可以设置默认全屏节点
支持快捷键操作
可以查看生成历史

6.2 自动完成功能

嵌入词自动完成
LoRA名称自动完成
节点参数自动完成

6.3 界面定制

节点尺寸调整
背景颜色设置
连线样式定制

6.4 文件名解析

支持日期时间变量
支持参数变量替换
自动数字编号

这个插件功能非常丰富，建议从基础的管道节点开始学习，逐步掌握高级功能。每个节点都有其特定用途，合理组合使用可以大大提高工作效率。

ComfyUI插件tinyterraNodes使用教程 从入门到精通