z-tipo-extension 插件完整教程

1. 插件简介

插件地址： https://github.com/KohakuBlueleaf/z-tipo-extension

这个插件就像是给 ComfyUI 装了一个超级智能的"提示词写手"！它能把你简单的几个关键词变成详细专业的绘画提示词，就像请了一个专业的AI助手来帮你写提示词一样。

想象一下，你只需要输入"蓝发女孩"，这个插件就能自动帮你扩展成"1girl, blue hair, long hair, beautiful detailed eyes, school uniform, standing, outdoor, cherry blossoms, masterpiece, best quality"这样的专业提示词！

主要功能：

智能提示词扩展：把简单的关键词变成详细的提示词
支持自然语言：不仅支持标签，还能理解普通话描述
多种长度控制：可以生成短、中、长不同长度的提示词
黑名单过滤：可以屏蔽不想要的标签
格式化输出：按照指定格式整理提示词
多种AI模型：支持TIPO和DanTagGen等不同模型

能给我们带来什么效果：

节省写提示词的时间：不用绞尽脑汁想词汇
提高图片质量：AI生成的提示词更专业更全面
学习提示词技巧：看AI怎么写提示词来学习
创意灵感：AI会添加你想不到的有趣元素
标准化输出：按照专业格式整理提示词

2. 如何安装

2.1 基础安装步骤

进入 ComfyUI 插件目录
```
cd ComfyUI/custom_nodes
```

下载插件

git clone https://github.com/KohakuBlueleaf/z-tipo-extension.git

安装依赖包

cd z-tipo-extension
pip install -r requirements.txt

模型自动下载
- 插件会自动下载所需的AI模型
- 模型会保存到 ComfyUI/models/kgen/ 文件夹
- 首次使用时需要等待模型下载
重启 ComfyUI

2.2 注意事项

需要较好的网络连接下载模型
模型文件较大，需要耐心等待
建议有4GB以上显存以获得最佳体验

3. 节点详细解析

3.1 TIPO 节点 - 智能提示词生成器

这个节点就像一个"超级提示词写手"，能把你输入的简单关键词变成详细专业的绘画提示词。它就像请了一个经验丰富的画师来帮你写提示词。

3.1.1 节点功能说明

这个节点接收你输入的简单标签和自然语言描述，然后通过AI模型的智能分析，生成详细、专业、格式化的提示词。就像把"蓝发女孩"变成完整的人物描述。

3.1.2 参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
标签输入	tags	文本	空	输入你想要的关键词标签，就像告诉AI你想画什么	输入标签字符串	"1girl, blue hair, school uniform"
自然语言	nl_prompt	文本	空	用普通话描述你想要的画面，就像跟朋友聊天一样	自然语言提示词	"一个穿校服的蓝发女孩在樱花树下"
禁用标签	ban_tags	文本	空	不想要的标签黑名单，就像告诉AI什么不要画	黑名单标签列表	"nsfw, nude, blood"
AI模型	tipo_model	模型列表	第一个模型	选择要使用的AI写手，不同模型有不同风格	TIPO模型选择	选择适合的模型版本
输出格式	format	文本模板	默认格式	决定最终提示词的排列格式，就像选择作文的格式	提示词格式模板	使用默认格式或自定义
图片宽度	width	1-16384	1024	告诉AI要生成多宽的图片，影响构图建议	图像宽度像素	1024适合方形图，1536适合横图
图片高度	height	1-16384	1024	告诉AI要生成多高的图片，影响构图建议	图像高度像素	1024适合方形图，768适合横图
创意温度	temperature	小数	0.5	控制AI的创意程度，就像调节想象力的大小	生成温度参数	0.3保守，0.7创意，1.0很随机
词汇范围	top_p	小数	0.95	控制AI选词的范围，数字越大词汇越丰富	核采样参数	0.95是好的平衡点
最小概率	min_p	小数	0.05	过滤掉太不可能的词汇，保证质量	最小概率阈值	0.05过滤低质量词汇
候选词数	top_k	整数	80	每次选择时考虑多少个候选词	Top-K采样参数	80是常用值
标签长度	tag_length	长度选项	long	控制生成标签的数量，就像选择描述的详细程度	标签生成长度	short简洁，long详细
语言长度	nl_length	长度选项	long	控制自然语言描述的长度	自然语言长度	short简洁，long详细
随机种子	seed	整数	1234	控制随机性，相同种子得到相同结果	随机种子值	1234固定，-1随机
运行设备	device	cpu/cuda	cuda	选择用CPU还是显卡运行，显卡更快	计算设备选择	cuda用显卡，cpu用处理器

3.2 TIPOOperation 节点 - 单项操作处理器

这个节点就像一个"专项技能师"，专门执行某一种特定的提示词处理操作，比如只扩展人物描述或只添加背景元素。

3.2.1 节点功能说明

这个节点不像TIPO节点那样做全套处理，而是专门执行某一种特定操作。就像请一个专门画人物的画师或专门画背景的画师，各司其职。

3.2.2 参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
标签输入	tags	文本	空	输入你想要的关键词标签	输入标签字符串	"1girl, blue hair"
自然语言	nl_prompt	文本	空	用普通话描述你想要的画面	自然语言提示词	"一个蓝发女孩"
禁用标签	ban_tags	文本	空	不想要的标签黑名单	黑名单标签列表	"nsfw, nude"
AI模型	tipo_model	模型列表	第一个模型	选择要使用的AI模型	TIPO模型选择	选择合适的模型
操作类型	operation	操作列表	第一个操作	选择要执行的具体操作，就像选择专项技能	具体操作类型	选择人物扩展或背景添加等
图片宽度	width	1-16384	1024	告诉AI图片宽度	图像宽度像素	1024适合方形图
图片高度	height	1-16384	1024	告诉AI图片高度	图像高度像素	1024适合方形图
创意温度	temperature	小数	0.5	控制AI的创意程度	生成温度参数	0.5平衡创意和稳定
词汇范围	top_p	小数	0.95	控制AI选词的范围	核采样参数	0.95平衡多样性
最小概率	min_p	小数	0.05	过滤低质量词汇	最小概率阈值	0.05保证质量
候选词数	top_k	整数	80	每次考虑的候选词数量	Top-K采样参数	80是常用值
标签长度	tag_length	长度选项	long	控制生成标签的数量	标签生成长度	long获得详细描述
语言长度	nl_length	长度选项	long	控制自然语言描述的长度	自然语言长度	long获得详细描述
随机种子	seed	整数	1234	控制随机性	随机种子值	固定种子得到一致结果
运行设备	device	cpu/cuda	cuda	选择运行设备	计算设备选择	cuda更快

3.3 TIPOFormat 节点 - 格式化输出器

这个节点就像一个"文档排版师"，专门负责把处理好的提示词按照指定格式整理排版，让输出更加规范美观。

3.3.1 节点功能说明

这个节点接收从TIPOOperation节点输出的原始数据，然后按照你指定的格式模板进行排版整理。就像把散乱的文字按照作文格式整理成规范的文档。

3.3.2 参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释	专业解释	怎么用/举个例子
完整输出	full_output	列表数据	连接输入	从TIPOOperation接收的完整处理结果	完整标签映射数据	连接TIPOOperation的full_output
附加输出	addon_output	列表数据	连接输入	从TIPOOperation接收的附加信息	附加标签数据	连接TIPOOperation的addon_output
输出格式	format	文本模板	默认格式	决定最终提示词的排列格式模板	提示词格式模板	使用默认格式或自定义排版

4. 使用技巧和建议

4.1 输入技巧

标签输入：使用英文标签，用逗号分隔，如"1girl, blue hair, school uniform"
自然语言：可以用中文或英文描述，如"一个穿校服的蓝发女孩"
组合使用：标签和自然语言可以同时使用，互相补充

4.2 参数调节建议

创意控制：temperature 0.3保守，0.7创意，1.0随机
长度选择：新手建议用"long"，经验丰富可以用"short"
模型选择：不同模型有不同特色，可以多试试
格式定制：可以修改format参数来定制输出格式

4.3 工作流建议

简单流程：TIPO节点 → 直接输出
精细控制：TIPOOperation → TIPOFormat → 输出
批量处理：多个TIPOOperation并行处理不同方面

4.4 黑名单使用

用逗号分隔不想要的标签
支持正则表达式匹配
常用黑名单："nsfw, nude, blood, violence"

5. 常见问题解答

Q1: 为什么第一次使用很慢？

A: 插件需要下载AI模型文件，模型较大需要时间。下载完成后使用就会很快。

Q2: 生成的提示词质量不好怎么办？

A: 尝试调整temperature参数，或者换一个AI模型。也可以在输入中提供更详细的描述。

Q3: 如何避免生成不想要的内容？

A: 在ban_tags参数中添加不想要的标签，用逗号分隔。

Q4: CPU和GPU有什么区别？

A: GPU（cuda）运行更快但需要显卡，CPU运行较慢但兼容性好。

Q5: 如何自定义输出格式？

A: 修改format参数，使用<|special|>、<|characters|>等标记来定制格式。

Q6: 标签长度选择有什么区别？

A: very_short最简洁，very_long最详细。一般推荐使用short或long。

Q7: 随机种子有什么用？

A: 相同的种子会产生相同的结果，-1表示随机。固定种子可以重现结果。

6. 高级应用场景

6.1 创意写作辅助

输入简单的角色设定，生成详细的人物描述
用于小说、漫画的角色设计
快速生成各种场景描述

6.2 绘画提示词优化

把简单的想法扩展成专业提示词
学习如何写高质量的提示词
为不同的AI绘画模型优化提示词

6.3 内容创作

社交媒体内容的创意生成
广告文案的灵感来源
游戏角色的设定扩展

6.4 教育学习

学习英文标签的使用方法
了解不同艺术风格的描述方式
提高对视觉元素的理解

6.5 批量处理

为大量图片生成不同的提示词变体
创建提示词数据库
自动化内容生成流程

7. 格式模板说明

7.1 内置标记说明

<|special|>：特殊标签（如1girl, 1boy等）
<|characters|>：角色名称标签
<|copyrights|>：版权/作品名标签
<|artist|>：画师风格标签
<|general|>：一般描述标签
<|meta|>：元数据标签（如分辨率等）
<|quality|>：质量相关标签
<|rating|>：内容分级标签
<|generated|>：AI生成的自然语言
<|extended|>：扩展的自然语言描述

7.2 自定义格式示例

角色：<|characters|>
风格：<|artist|>
描述：<|general|>
质量：<|quality|>

8. 技术原理简介（用大白话解释）

8.1 TIPO是什么？

TIPO就像一个专门学习过无数绘画提示词的AI老师，它通过分析大量的图片和对应的描述文字，学会了如何把简单的词汇扩展成详细的描述。

8.2 工作原理

理解输入：AI首先理解你输入的标签和描述
知识匹配：从它学过的知识中找到相关的内容
智能扩展：根据上下文添加合适的细节描述
格式整理：按照指定格式排列输出

8.3 为什么效果好？

大数据训练：AI学习了海量的高质量提示词
上下文理解：能理解词汇之间的关联关系
风格一致性：保持生成内容的风格统一
可控性强：可以通过参数精确控制输出

这个插件为 ComfyUI 带来了强大的提示词生成能力，让新手也能轻松写出专业的提示词。通过AI的帮助，我们可以把简单的想法变成详细的描述，大大提高创作效率和质量。

ComfyUI必备插件z-tipo-extension使用教程详解