%20(1).png)
Comfyui_TTP_Toolset 插件保姆级教程
1. 插件简介
插件地址： https://github.com/TTPlanetPig/Comfyui_TTP_Toolset
这个插件就像是一个"超级图片处理工具箱"！它的主要作用是帮你把大图片切成小块，然后对每一小块进行精细处理，最后再无缝拼接回去。就像拼图游戏一样，但是是反过来的——先拆开，处理好，再拼回去。
主要功能：
- 图片切块：把大图片像切蛋糕一样切成小块
- 智能拼接：把处理过的小块无缝拼接回完整图片
- 条件控制：为每个小块设置不同的处理条件
- 文字混合：把多段文字按模板组合
- 视频加速：专门为混元视频模型提供加速采样
能带来什么效果：
- 超高分辨率图片放大（8K、16K甚至更高）
- 避免显存不足的问题
- 提高图片处理的精度和质量
- 加速视频生成过程
2. 如何安装
第一步：确保你已经安装了 ComfyUI
如果还没有，请先去安装 ComfyUI 主程序。
第二步：安装插件
方法一：使用 ComfyUI Manager（推荐）
- 在 ComfyUI 界面中找到 Manager 按钮
- 搜索 "TTP_Toolset"
- 找到对应插件并点击安装
方法二：手动安装
- 打开命令行（Windows 按 Win+R，输入 cmd）
- 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
- 输入以下命令：
cd custom_nodes
git clone https://github.com/TTPlanetPig/Comfyui_TTP_Toolset.git
- 重启 ComfyUI
第三步：安装依赖
这个插件需要一些图片处理工具：
- OpenCV（图片处理）
- PIL（图片操作）
- NumPy（数学计算）
通常这些在安装 ComfyUI 时就已经包含了。
3. 节点详细解析
3.1 TTPlanet_Tile_Preprocessor_Simple 节点 - 简单瓦片预处理器
这个节点就像一个"图片柔化器"，它会把图片先缩小再放大，同时加上一点模糊效果，让图片变得更适合后续的瓦片处理。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图像 | image | IMAGE类型 | 必须连接 | 要处理的原始图片，就像要美颜的照片 | 输入的图像数据 | 连接图片加载器或其他图像节点 |
| 缩放因子 | scale_factor | 小数 | 2.00 (范围1.00-8.00) | 图片缩小的倍数，像调整照片的"精细度" | 图像缩放比例，用于预处理 | 2.0表示先缩小一半再放大，让图片更柔和 |
| 模糊强度 | blur_strength | 小数 | 1.0 (范围1.0-20.0) | 给图片加多少模糊效果，像给照片加柔光滤镜 | 高斯模糊的强度参数 | 1.0是轻微模糊，5.0是明显模糊，20.0是很模糊 |
3.3 TTP_Image_Tile_Batch 节点 - 图片切块器
这个节点就像一个"智能切蛋糕机"，能把大图片按照你设定的尺寸切成很多小块，同时记住每一块的位置信息。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图像 | image | IMAGE类型 | 必须连接 | 要切块的大图片 | 输入的图像数据 | 连接要处理的高分辨率图片 |
| 瓦片宽度 | tile_width | 整数 | 1024 (最小1) | 每个小块的宽度，像设定每块蛋糕的宽度 | 单个瓦片的像素宽度 | 1024适合大多数情况，显存小可以用512 |
| 瓦片高度 | tile_height | 整数 | 1024 (最小1) | 每个小块的高度，像设定每块蛋糕的高度 | 单个瓦片的像素高度 | 1024是常用尺寸，可以根据显存调整 |
输出说明：
- IMAGES：切好的所有小块图片
- POSITIONS：每个小块在原图中的位置信息
- ORIGINAL_SIZE：原图的尺寸
- GRID_SIZE：切块的网格大小（几行几列）
3.5 TTP_Image_Assy 节点 - 图片拼接器
这个节点就像一个"拼图大师"，能把处理过的小块图片无缝拼接回完整的大图片，还能处理重叠部分让接缝看不出来。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 瓦片 | tiles | IMAGE类型 | 必须连接 | 处理过的小块图片，像拼图的每一片 | 处理后的瓦片图像数据 | 连接处理过的图片小块 |
| 位置信息 | positions | LIST类型 | 必须连接 | 每个小块的位置信息，像拼图说明书 | 瓦片位置坐标列表 | 连接切块器输出的位置信息 |
| 原始尺寸 | original_size | TUPLE类型 | 必须连接 | 原图的大小信息 | 原始图像的尺寸信息 | 连接切块器输出的尺寸信息 |
| 网格尺寸 | grid_size | TUPLE类型 | 必须连接 | 切块的网格信息（几行几列） | 瓦片网格的行列数 | 连接切块器输出的网格信息 |
| 填充值 | padding | 整数 | 64 (最小0) | 拼接时的融合宽度，像胶水的厚度 | 瓦片间融合的像素宽度 | 64能很好地隐藏接缝，0表示不融合 |
3.7 TTP_CoordinateSplitter 节点 - 坐标分离器
这个节点就像一个"地址翻译器"，把位置信息转换成更容易使用的坐标格式。
3.8 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 位置信息 | Positions | LIST类型 | 必须连接 | 从切块器来的位置信息 | 位置坐标列表数据 | 连接切块器的位置输出 |
输出说明：
- Coordinates：转换后的坐标信息，格式为(x, y, 宽度, 高度)
3.9 TTP_condtobatch 节点 - 条件合并器
这个节点就像一个"条件收集器"，把多个单独的条件合并成一个大的条件组。
3.10 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 条件列表 | conditionings | CONDITIONING类型 | 必须连接 | 多个条件输入，像收集不同的指令 | 条件编码数据列表 | 连接多个条件编码器的输出 |
特殊说明：
- 这个节点支持多输入，可以连接很多个条件
3.11 TTP_condsetarea_merge 节点 - 条件区域设置器
这个节点就像一个"区域指挥官"，为每个图片小块设置对应的处理条件和区域范围。
3.12 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 条件组 | conditioning_batch | CONDITIONING类型 | 必须连接 | 合并后的条件组 | 条件编码数据批次 | 连接条件合并器的输出 |
| 坐标信息 | coordinates | LIST类型 | 必须连接 | 每个区域的坐标信息 | 区域坐标列表 | 连接坐标分离器的输出 |
| 强度 | strength | 小数 | 1.0 (范围0.0-10.0) | 条件的影响强度，像调节"命令的严格程度" | 条件应用的强度系数 | 1.0是正常强度，2.0是加强，0.5是减弱 |
3.13 TTP_condsetarea_merge_test 节点 - 条件区域设置器（测试版）
这个节点是上一个节点的增强版，就像一个"高级区域指挥官"，可以更灵活地处理条件分组。
3.14 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 条件组 | conditioning_batch | CONDITIONING类型 | 必须连接 | 合并后的条件组 | 条件编码数据批次 | 连接条件合并器的输出 |
| 坐标信息 | coordinates | LIST类型 | 必须连接 | 每个区域的坐标信息 | 区域坐标列表 | 连接坐标分离器的输出 |
| 组大小 | group_size | 整数 | 1 (最小1) | 每组包含多少个条件，像设定每个小队的人数 | 条件分组的大小 | 1表示一对一，2表示两个条件共用一个区域 |
| 强度 | strength | 小数 | 1.0 (范围0.0-10.0) | 条件的影响强度 | 条件应用的强度系数 | 同上一个节点 |
3.15 Tile_imageSize 节点 - 瓦片尺寸计算器
这个节点就像一个"智能计算器"，根据原图大小和你想要的分割数量，自动计算出每个小块应该多大。
3.16 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图像 | image | IMAGE类型 | 必须连接 | 要分析的图片 | 输入图像数据 | 连接原始图片 |
| 宽度因子 | width_factor | 整数 | 3 (范围1-10) | 横向切几块，像切蛋糕时横向切几刀 | 水平方向的分割数量 | 3表示横向切成3块 |
| 高度因子 | height_factor | 整数 | 3 (范围1-10) | 纵向切几块，像切蛋糕时纵向切几刀 | 垂直方向的分割数量 | 3表示纵向切成3块 |
| 重叠率 | overlap_rate | 小数 | 0.1 (范围0.00-0.95) | 相邻块之间的重叠程度，像拼图片的重叠部分 | 瓦片间重叠的比例 | 0.1表示10%重叠，0表示不重叠 |
输出说明：
- tile_width：计算出的瓦片宽度
- tile_height：计算出的瓦片高度
3.17 TTP_Expand_And_Mask 节点 - 图片扩展和遮罩生成器
这个节点就像一个"画布扩展器"，能把图片向四个方向扩展，同时生成对应的遮罩。
3.18 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图像 | image | IMAGE类型 | 必须连接 | 要扩展的原始图片 | 输入图像数据 | 连接需要扩展的图片 |
| 填充模式 | fill_mode | 选择列表 | "duplicate" | 扩展区域用什么填充，像选择墙纸的花纹 | 扩展区域的填充方式 | duplicate复制边缘，white用白色填充 |
| 透明区域填色 | fill_alpha_decision | 布尔值 | False | 是否把透明部分填上颜色 | 是否填充透明区域 | 处理PNG图片时很有用 |
| 填充颜色 | fill_color | 文本 | "#7F7F7F" | 填充透明区域的颜色，用十六进制表示 | 透明区域填充的颜色值 | #FF0000是红色，#00FF00是绿色 |
| 向左扩展 | expand_left | 布尔值 | False | 是否向左边扩展 | 控制左侧扩展 | True表示向左扩展 |
| 左侧块数 | num_blocks_left | 整数 | 1 (范围0-3) | 向左扩展几个图片宽度 | 左侧扩展的块数 | 1表示扩展1倍宽度 |
| 向右扩展 | expand_right | 布尔值 | False | 是否向右边扩展 | 控制右侧扩展 | True表示向右扩展 |
| 右侧块数 | num_blocks_right | 整数 | 1 (范围0-3) | 向右扩展几个图片宽度 | 右侧扩展的块数 | 同左侧块数 |
| 向上扩展 | expand_top | 布尔值 | False | 是否向上边扩展 | 控制上方扩展 | True表示向上扩展 |
| 上方块数 | num_blocks_top | 整数 | 1 (范围0-3) | 向上扩展几个图片高度 | 上方扩展的块数 | 1表示扩展1倍高度 |
| 向下扩展 | expand_bottom | 布尔值 | False | 是否向下边扩展 | 控制下方扩展 | True表示向下扩展 |
| 下方块数 | num_blocks_bottom | 整数 | 1 (范围0-3) | 向下扩展几个图片高度 | 下方扩展的块数 | 同上方块数 |
3.19 TTP_text_mix 节点 - 文字混合器
这个节点就像一个"智能文字组装机"，能按照模板把多段文字组合成完整的句子。
3.20 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本1 | text1 | 文本 | "" | 第一段要组合的文字 | 第一个文本输入 | 输入"美丽的" |
| 文本2 | text2 | 文本 | "" | 第二段要组合的文字 | 第二个文本输入 | 输入"花朵" |
| 文本3 | text3 | 文本 | "" | 第三段要组合的文字 | 第三个文本输入 | 输入"在花园里" |
| 模板 | template | 文本 | "" | 组合的模板，用{text1}等占位符 | 文本组合模板 | 输入"一朵{text1}{text2}{text3}盛开" |
3.21 TeaCacheHunyuanVideoSampler 节点 - 混元视频加速采样器
这个节点就像一个"视频生成加速器"，专门为混元视频模型提供更快的采样速度。
3.22 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 噪声 | noise | NOISE类型 | 必须连接 | 生成用的随机噪声 | 噪声生成器输入 | 连接噪声生成器 |
| 引导器 | guider | GUIDER类型 | 必须连接 | 生成过程的引导器 | 采样引导器 | 连接CFG引导器 |
| 采样器 | sampler | SAMPLER类型 | 必须连接 | 采样算法 | 采样器实例 | 连接欧拉采样器等 |
| 时间步 | sigmas | SIGMAS类型 | 必须连接 | 采样的时间步序列 | 噪声调度序列 | 连接调度器输出 |
| 潜在图像 | latent_image | LATENT类型 | 必须连接 | 潜在空间的图像 | 潜在空间数据 | 连接潜在图像 |
| 加速档位 | speedup | 选择列表 | "Fast (1.6x)" | 选择加速程度，像汽车的档位 | 预设的加速倍数 | Fast适合平衡，Ultra Fast最快但质量略低 |
| 启用自定义速度 | enable_custom_speed | 布尔值 | False | 是否使用自定义的加速倍数 | 启用自定义速度控制 | True可以精确控制加速倍数 |
| 自定义速度 | custom_speed | 小数 | 1.0 (范围1.0-4.4) | 自定义的加速倍数 | 自定义加速系数 | 2.0表示2倍速，4.0表示4倍速 |
4. 使用技巧和建议
4.1 超高分辨率图片处理流程
标准瓦片处理流程：
- 用
TTP_Image_Tile_Batch切割大图 - 对每个小块进行AI处理（放大、增强等）
- 用
TTP_Image_Assy拼接回完整图片 - 设置合适的
padding值避免接缝
4.2 条件控制的高级用法
精确区域控制：
- 用
TTP_CoordinateSplitter获取坐标 - 为每个区域准备不同的提示词
- 用
TTP_condsetarea_merge应用区域条件 - 实现每个区域不同的处理效果
4.3 内存优化建议
避免显存不足：
- 瓦片尺寸不要设置太大（推荐1024x1024）
- 使用适当的重叠率（0.1-0.2）
- 分批处理大量瓦片
- 及时清理不用的中间结果
4.4 视频加速使用技巧
TeaCache采样器优化：
- 从 "Fast (1.6x)" 开始测试
- 质量要求高用较低倍数
- 速度要求高可以用 "Ultra Fast"
- 自定义速度可以精确控制
5. 常见问题解答
Q1: 为什么拼接后的图片有明显接缝？
A: 解决方法：
- 增加
padding值到64或更高 - 确保瓦片有适当重叠
- 检查处理过程是否一致
- 使用相同的处理参数
Q2: 显存不足怎么办？
A: 优化策略：
- 减小瓦片尺寸（从1024降到512）
- 减少同时处理的瓦片数量
- 使用更低精度的模型
- 分批处理大图
Q3: 条件设置不生效怎么办？
A: 检查要点：
- 确认坐标信息正确传递
- 检查条件数量和坐标数量是否匹配
- 调整
strength参数 - 确认条件编码正确
Q4: TeaCache采样器报错怎么办？
A: 可能原因：
- 只支持混元视频模型
- 检查模型版本兼容性
- 确认所有输入连接正确
- 尝试降低加速倍数
Q5: 文字模板不工作怎么办？
A: 检查事项：
- 确认占位符格式正确：{text1}、{text2}、{text3}
- 检查大括号是否为英文字符
- 确认文本框有内容
- 模板可以为空
6. 高级应用案例
6.1 8K图片智能放大
- 用瓦片切割器把4K图片切成16块
- 每块用AI放大到2倍
- 用智能拼接器组合成8K图片
- 实现无损的超高分辨率放大
6.2 区域化图片编辑
- 切割图片为多个区域
- 为每个区域设置不同的编辑提示词
- 分别处理每个区域
- 拼接成具有不同风格的完整图片
6.3 批量图片处理
- 使用相同的瓦片设置
- 批量处理多张图片
- 保持处理参数一致
- 实现工业级的图片处理流水线
6.4 视频生成加速
- 使用TeaCache采样器
- 根据质量需求选择加速档位
- 在4090显卡上实现2倍加速
- 大幅提升视频生成效率
7. 技术原理简单解释
7.1 瓦片处理的原理
想象你要给一面巨大的墙刷漆，但是你的刷子很小。最好的方法就是把墙分成很多小块，一块一块地刷，最后整面墙就刷好了。瓦片处理就是这个道理，把大图片分成小块处理，避免一次性处理太大的图片导致内存不足。
7.2 智能拼接的原理
拼接时最大的问题是接缝。就像贴墙纸一样，如果直接拼接会有明显的缝隙。这个插件使用渐变融合技术，让相邻块的边缘部分逐渐过渡，就像用渐变的胶水粘合，让接缝变得看不见。
7.3 条件控制的原理
每个图片区域可以有不同的"指令"。就像告诉不同的画家画同一幅画的不同部分，每个画家都有自己的特殊要求。通过精确的坐标控制，可以让AI对图片的不同区域应用不同的处理效果。
7.4 TeaCache加速原理
TeaCache就像一个"智能跳帧器"。在视频生成过程中，它会判断哪些计算步骤的结果变化不大，就跳过这些步骤，直接使用之前的结果。这样可以大幅减少计算量，提高生成速度。
8. 总结
Comfyui_TTP_Toolset 是一个功能强大的图片处理工具集：
主要优势：
- 功能全面：从切割到拼接，从条件控制到加速采样
- 易于使用：节点设计直观，参数设置简单
- 性能优秀：支持超高分辨率处理，内存管理良好
- 扩展性强：可以与其他插件配合使用
适合的用户：
- 需要处理超高分辨率图片的设计师
- 想要精确控制图片不同区域的创作者
- 需要批量处理图片的工作流用户
- 使用混元视频模型的视频创作者
使用建议：
- 从简单的瓦片处理开始学习
- 逐步掌握条件控制的高级功能
- 根据硬件配置调整参数
- 多尝试不同的组合方式
记住，这个工具集就像给你的ComfyUI装了一套"专业级图片处理设备"，掌握了它，你就能处理以前无法处理的超大图片，实现以前无法实现的精细控制！