%20(1).png)
ComfyUI_WordCloud 插件保姆级教程
1. 插件简介
插件地址： https://github.com/chflame163/ComfyUI_WordCloud
ComfyUI_WordCloud 是一个超级酷炫的词云生成插件！它就像一个"文字艺术家"，能够把你输入的文字变成漂亮的词云图片。词云就像是把文字按照出现频率的高低，用不同大小和颜色展示出来的艺术图片。
这个插件能给我们带来什么效果？
- 📊 智能词云生成：就像把一篇文章变成艺术品，重要的词会显示得更大更醒目
- 🎨 丰富的颜色方案：提供几十种配色方案，就像调色板一样丰富
- 🖼️ 自定义形状：可以让词云按照你提供的图片形状来排列，比如心形、星形等
- 🌈 透明背景支持：可以生成透明背景的词云，方便后期合成
- 📝 中英文支持：完美支持中文分词，让中文词云也很漂亮
- 🎯 关键词突出：可以设置重点词汇，让它们显示得更大
- 🚫 排除词功能：可以排除不想显示的词汇
- 📁 文件加载：可以直接从文本文件加载内容
简单来说，这就像给你的ComfyUI装上了一个专业的"词云设计师"，能把枯燥的文字变成生动有趣的视觉艺术！
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI
- 点击右下角的 "Manager" 按钮
- 在搜索框里输入 "WordCloud"
- 找到 "ComfyUI_WordCloud" 点击安装
- 重启 ComfyUI
方法二：手动安装
- 打开终端或命令提示符
- 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
- 运行以下命令：
git clone https://github.com/chflame163/ComfyUI_WordCloud.git
cd ComfyUI_WordCloud
pip install -r requirements.txt
- 重启 ComfyUI
注意： 插件会自动检测系统字体，如果你想使用自定义字体，可以编辑插件目录下的 font_dir.ini 文件来指定字体文件夹。
3. 节点详解
3.1 ComfyWordCloud 节点
这个节点是干嘛的？
ComfyWordCloud 就像一个"词云魔法师"，它是整个插件的核心。你给它一段文字，它就能分析出每个词的重要程度，然后用不同大小和颜色把这些词排列成漂亮的词云图片。就像把一本书的精华浓缩成一幅艺术画一样！
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本内容 | text | 多行文本输入 | 空字符串 | 这是要制作词云的原始文字，就像给画家提供素材 | 用于生成词云的文本内容 | 输入一篇文章、诗歌或任何想要分析的文字 |
| 宽度 | width | 整数 | 512 | 这是生成词云图片的宽度，就像画布的宽度 | 输出图像的宽度像素 | 1024会生成更宽的词云图片 |
| 高度 | height | 整数 | 512 | 这是生成词云图片的高度，就像画布的高度 | 输出图像的高度像素 | 768会生成更高的词云图片 |
| 缩放倍数 | scale | 0.1-1000.0的小数 | 1.0 | 这控制整个词云的放大倍数，就像放大镜的倍数 | 图像的缩放因子 | 2.0会让词云放大一倍，0.5会缩小一半 |
| 边距 | margin | 整数 | 0 | 这控制词云边缘的空白区域，就像相框的边框 | 词云边缘的空白像素 | 20会在词云周围留出20像素的空白 |
| 字体文件 | font_path | 字体列表选择 | 系统检测 | 这选择词云使用的字体样式，就像选择不同的笔 | 用于渲染文字的字体文件路径 | 选择粗体字体让词云更醒目 |
| 最小字体大小 | min_font_size | 整数 | 4 | 这控制最小词汇的字体大小，就像设置最小的字号 | 词云中最小文字的像素大小 | 8会让最小的词也比较清晰 |
| 最大字体大小 | max_font_size | 整数 | 128 | 这控制最大词汇的字体大小，就像设置最大的字号 | 词云中最大文字的像素大小 | 200会让重要词汇显示得很大 |
| 相对缩放 | relative_scaling | 0.01-1.0的小数 | 0.5 | 这控制词汇大小的差异程度，就像调节"贫富差距" | 控制词汇大小的相对差异 | 0.8会让词汇大小差异更明显 |
| 颜色方案 | colormap | 颜色方案列表 | viridis | 这选择词云的配色方案，就像选择调色板 | 预定义的颜色映射方案 | "rainbow"会用彩虹色，"Blues"会用蓝色系 |
| 背景颜色 | background_color | 颜色字符串 | #FFFFFF | 这设置词云的背景颜色，就像选择画布颜色 | 背景的十六进制颜色值 | "#000000"是黑色背景，"#FF0000"是红色背景 |
| 透明背景 | transparent_background | True/False | True | 这控制背景是否透明，就像选择透明玻璃还是有色玻璃 | 是否生成透明背景的图像 | True会生成透明背景，方便后期合成 |
| 水平排列比例 | prefer_horizontal | 0.0-1.0的小数 | 0.9 | 这控制词汇水平排列的比例，就像调节"躺着"和"站着"的比例 | 水平排列文字的概率 | 1.0全部水平排列，0.0全部垂直排列 |
| 最大词汇数 | max_words | 整数 | 200 | 这限制词云中显示的最大词汇数量，就像限制演员数量 | 词云中包含的最大词汇数量 | 500会显示更多词汇，50会只显示最重要的词 |
| 允许重复 | repeat | True/False | False | 这控制是否允许重复词汇来填满数量，就像是否允许"群众演员" | 当词汇不足时是否重复显示 | True会重复显示词汇直到达到最大数量 |
| 包含数字 | include_numbers | True/False | False | 这控制是否在词云中显示数字，就像是否显示"数据" | 是否在词云中包含数字 | True会显示文本中的数字，False会忽略数字 |
| 随机种子 | random_state | 整数 | -1 | 这控制词云布局的随机性，就像掷骰子的固定点数 | 随机数生成器的种子值 | 42会每次生成相同布局，-1每次都不同 |
| 排除词汇 | stopwords | 文本输入 | 空字符串 | 这设置不想在词云中显示的词汇，就像"黑名单" | 要从词云中排除的词汇列表 | "的,了,是"会排除这些常见词汇 |
| 参考颜色图片 | color_ref_image | IMAGE类型 | 可选 | 这提供一张图片来决定词云的颜色，就像"调色参考" | 用于提取颜色的参考图像 | 提供一张风景图，词云会使用图片中的颜色 |
| 形状遮罩图片 | mask_image | IMAGE类型 | 可选 | 这提供一张图片来决定词云的形状，就像"模具" | 定义词云形状的遮罩图像 | 提供一个心形图片，词云会排列成心形 |
| 轮廓宽度 | contour_width | 0-9999的小数 | 0 | 这控制形状轮廓的粗细，就像描边的粗细 | 遮罩轮廓的线条宽度 | 2.0会给形状加上2像素的轮廓线 |
| 轮廓颜色 | contour_color | 颜色字符串 | #000000 | 这设置形状轮廓的颜色，就像描边的颜色 | 遮罩轮廓的颜色值 | "#FF0000"会用红色轮廓线 |
| 关键词 | keynote_words | 文本输入 | 空字符串 | 这设置要特别突出的重要词汇，就像"VIP名单" | 需要特别强调的关键词列表 | "爱情,友谊,梦想"会让这些词显示得更大 |
| 关键词权重 | keynote_weight | 整数 | 60 | 这控制关键词的突出程度，就像"VIP待遇等级" | 关键词的权重加成值 | 100会让关键词显示得非常大 |
3.2 LoadTextFile 节点
这个节点是干嘛的？
LoadTextFile 就像一个"文件读取器"，它能从你电脑上的文本文件中读取内容，然后传递给词云节点。就像有个助手帮你把文件里的文字搬运过来一样，省得你复制粘贴。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件路径 | path | 文本输入 | c:\text.txt | 这是文本文件在电脑上的位置，就像门牌号码 | 要读取的文本文件的完整路径 | "D:\documents\article.txt"会读取D盘文档文件夹下的文章 |
3.3 RGB_Picker 节点
这个节点是干嘛的？
RGB_Picker 就像一个"调色板"，它提供了一个方便的颜色选择器，让你可以直观地选择颜色，然后输出颜色代码。就像用画笔蘸颜料一样简单直观。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 颜色 | color | 颜色选择器 | white | 这是一个可视化的颜色选择器，就像调色盘 | 通过颜色选择器选择的颜色值 | 点击颜色块会弹出调色板，选择你喜欢的颜色 |
| 输出模式 | mode | HEX/DEC选择 | HEX | 这控制颜色的输出格式，就像选择"中文"还是"英文" | 颜色值的输出格式 | HEX输出"#FF0000"，DEC输出"(255,0,0)" |
3.4 前端扩展：dz_mtb_widgets.js
这个扩展是干嘛的？
dz_mtb_widgets.js 是一个前端界面扩展，它为插件添加了特殊的界面控件，特别是颜色选择器。就像给ComfyUI装上了更好用的"工具箱"，让操作更加直观方便。
功能说明：
- 提供可视化的颜色选择器控件
- 支持颜色的实时预览和选择
- 提供调试功能，帮助开发者排查问题
- 增强节点的交互体验
- 支持多种自定义控件类型
- 提供颜色亮度判断功能
3.5 前端扩展：dz_comfy_shared.js
这个扩展是干嘛的？
dz_comfy_shared.js 是一个共享工具库，它为其他扩展提供基础功能支持。就像一个"工具箱"，里面装着各种实用的小工具，供其他部分使用。
功能说明：
- 提供颜色处理工具，判断颜色明暗
- 管理界面控件的显示和隐藏
- 处理控件与输入的转换
- 提供调试和日志功能
- 支持动态连接管理
- 提供DOM元素定位和样式处理
- 支持控件的清理和内存管理
4. 使用技巧和建议
🎨 词云设计技巧
- 文本准备：文本越长，词云效果越好，建议至少100个词
- 字体选择：中文内容选择中文字体，英文内容选择英文字体
- 颜色搭配：浅色背景配深色词汇，深色背景配浅色词汇
- 形状设计：使用高对比度的黑白图片作为形状遮罩效果最好
📊 参数调节建议
- 新手推荐设置：宽高512x512，最大字体128，最小字体8
- 高质量输出：宽高1024x1024，缩放倍数2.0
- 快速预览：最大词汇数50，缩放倍数0.5
🎯 不同场景的使用建议
- 文章分析：设置排除词为"的,了,是,在,有"等常见词
- 诗歌词云：使用较小的最大词汇数(50-100)突出重点
- 品牌词云：使用关键词功能突出品牌名称
- 装饰用途：使用透明背景，方便后期合成
🌈 颜色方案推荐
- 商务风格：Blues, Grays, BuGn
- 活泼风格：rainbow, Set1, tab10
- 温暖风格：Oranges, YlOrRd, autumn
- 冷色调：Blues, BuPu, winter
5. 常见问题解答
Q1: 为什么生成的词云是空白的？
A:
- 检查输入的文本是否为空
- 确认字体文件是否存在且可读
- 检查最小字体大小是否设置过大
Q2: 中文词云效果不好怎么办？
A:
- 确保使用支持中文的字体文件
- 检查文本编码是否为UTF-8
- 适当增加文本长度，中文分词需要更多内容
Q3: 如何制作特定形状的词云？
A:
- 准备一张黑白对比明显的图片
- 白色区域会被排除，黑色区域会填充词汇
- 图片分辨率建议与输出尺寸一致
Q4: 词云颜色单调怎么办？
A:
- 尝试不同的颜色方案(colormap)
- 使用参考颜色图片功能
- 调整相对缩放参数增加视觉层次
Q5: 如何让特定词汇更突出？
A:
- 使用关键词(keynote_words)功能
- 增加关键词权重(keynote_weight)
- 在排除词中移除想要突出的词汇
Q6: 生成速度很慢怎么办？
A:
- 减少最大词汇数量
- 降低输出图片分辨率
- 减少缩放倍数
6. 实际应用场景
📚 文本分析
- 分析文章或书籍的关键主题
- 制作读书笔记的可视化总结
- 分析社交媒体内容的热点词汇
🎨 设计创作
- 制作海报和宣传图的装饰元素
- 创建个性化的艺术作品
- 设计网站和应用的背景图案
📊 数据可视化
- 展示调研报告的关键发现
- 可视化用户反馈和评论
- 制作会议和演讲的视觉辅助
🎓 教育培训
- 制作课程内容的关键词总结
- 创建学习资料的视觉记忆点
- 分析学生作文的词汇使用情况
💼 商业应用
- 分析品牌提及和用户评价
- 制作营销材料的视觉元素
- 展示企业文化和价值观
7. 工作流程示例
基础词云制作：
- 添加ComfyWordCloud节点
- 输入文本内容或连接LoadTextFile节点
- 选择合适的字体和颜色方案
- 调整尺寸和词汇数量
- 运行生成词云图片
形状词云制作：
- 准备黑白形状图片
- 连接mask_image输入
- 调整轮廓宽度和颜色
- 设置透明背景
- 生成特定形状的词云
彩色词云制作：
- 准备参考颜色图片
- 连接color_ref_image输入
- 调整词汇大小和排列
- 设置关键词突出
- 生成彩色主题词云
8. 总结
ComfyUI_WordCloud 是一个功能强大且易于使用的词云生成插件，包含5个组件（3个核心节点 + 2个前端扩展），能够满足从基础词云到复杂艺术创作的各种需求。
记住这几个要点：
- 文本质量决定词云效果，内容越丰富越好
- 字体选择很重要，要匹配文本语言
- 颜色和形状可以大大提升视觉效果
- 关键词和排除词功能能精确控制显示内容
- 前端扩展提供了更好的用户体验
现在你已经掌握了这个强大工具的使用方法，快去创作出属于你的精美词云吧！记住，好的词云不仅仅是技术的展示，更是艺术和信息的完美结合！