ComfyUI String Helper 插件完全入门指南

1. 插件简介

ComfyUI String Helper 是一个专门处理文字的工具包，就像给你的 ComfyUI 添加了一个超级强大的文字处理器。这个插件包含了 String Formatter、StringList、StringListFromCSV、StringListToCSV、StringConverter、StringMatcher、TimeFormatter、ShowTranslateString 等多个节点。

插件原地址： https://github.com/liuqianhonga/ComfyUI-String-Helper

想象一下，你在做 AI 绘画时经常需要处理各种文字提示词，比如：

• 把多个提示词组合成一句完整的话
• 从一堆提示词中随机选择几个
• 把中文提示词翻译成英文
• 把当前时间加到文件名里
• 从文件中读取提示词列表

这个插件就是专门帮你解决这些文字处理问题的万能工具箱！

2. 如何安装

安装方法很简单，就像往你的工具箱里添加新工具一样：

1. 打开你的 ComfyUI 安装文件夹
2. 找到 custom_nodes 文件夹（这是放插件的地方）
3. 在命令行中进入这个文件夹，然后运行：

   cd custom_nodes
   git clone https://github.com/liuqianhonga/ComfyUI-String-Helper.git
   

4. 重启 ComfyUI 就可以了

3. 节点详细解析

3.1 String Formatter 节点 - 文字格式化神器

这个节点就像一个智能的文字模板机，你可以设计一个模板，然后把不同的内容填进去，就像填空题一样。

这个节点能干什么？
比如你想生成 "一个美丽的女孩在花园里" 这样的句子，但是你想要 "美丽的" 和 "花园" 这两个词可以随时替换，那你就可以用这个节点。

参数详解：

3.2 StringList 节点 - 智能提示词选择器

这个节点就像一个智能的提示词抽屉，你可以往里面放很多提示词，然后让它帮你选择，可以随机选、按顺序选、或者指定选哪几个。

这个节点能干什么？
比如你有10个不同的发型描述，你想每次随机选3个，或者你想按顺序一个一个试，这个节点都能帮你做到。

参数详解：

3.3 StringListFromCSV 节点 - 文件提示词读取器

这个节点就像一个智能的文件读取器，专门从 CSV 文件（就像 Excel 表格）中读取提示词。特别适合管理大量提示词的场景。

这个节点能干什么？
比如你有一个包含1000个人物描述的 CSV 文件，你想随机选几个来用，或者你想用中文版本还是英文版本，这个节点都能帮你搞定。

参数详解：

3.4 StringListToCSV 节点 - 提示词文件保存器

这个节点就像一个智能的文件存储器，把你的提示词列表保存到 CSV 文件中，方便以后使用。

这个节点能干什么？
比如你通过各种方式收集了很多好用的提示词，你想把它们保存到文件中，以后可以重复使用，这个节点就是专门干这个的。

参数详解：

3.5 StringMatcher 节点 - 智能条件匹配器

这个节点就像一个智能的条件判断器，根据不同的条件返回不同的结果，就像 "如果...那么..." 的逻辑。

这个节点能干什么？
比如你想根据不同的模型名称选择不同的参数，或者根据不同的风格选择不同的提示词，这个节点可以帮你自动判断和选择。

参数详解：

3.6 TimeFormatter 节点 - 时间格式化器

这个节点就像一个智能的时钟，可以按照你想要的格式显示当前时间，特别适合给文件命名或者记录时间。

这个节点能干什么？
比如你想在生成的图片文件名中加入当前时间，或者你想在提示词中加入"现在是2024年12月"这样的时间信息。

参数详解：

3.7 StringConverter 节点 - 格式转换器

这个节点就像一个智能的格式转换器，可以把文字转换成数字、布尔值、列表等不同的格式。

这个节点能干什么？
比如你有一个写着"123"的文字，你想把它转换成真正的数字123来进行计算，或者你想把"true"转换成真正的布尔值。

参数详解：

3.8 StringTranslate 节点 - 单独翻译器

这个节点就像一个专门的翻译器，只负责把一个文字翻译成英文。

这个节点能干什么？
比如你有一个中文的提示词"美丽的女孩"，你想把它翻译成英文"beautiful girl"来使用。

参数详解：

4. 使用技巧和建议

4.1 优先级理解

在 StringList 和 StringListFromCSV 节点中，选择方式有优先级：

1. 最高优先级： 指定序号选择（p1_select_by_numbers）
2. 中等优先级： 顺序循环选择（p2_select_sequential）
3. 最低优先级： 随机选择（p3_select_random_count）

4.2 文件路径建议

• 使用相对路径比较安全，比如 prompts/my_list.csv
• 如果文件夹不存在，插件会自动创建
• 建议把常用的提示词文件放在 template 文件夹中

4.3 翻译功能提示

• 翻译功能使用必应翻译服务，需要网络连接
• 支持自动语言检测，不只是中文，其他语言也可以
• 翻译结果会保存，避免重复翻译

4.4 格式化模板技巧

• 同一个参数可以在模板中多次使用，比如 {arg1} is {arg1}
• 支持 Python 的所有格式化语法，比如 {arg1:.2f} 控制小数位数
• 模板出错时会显示详细错误信息，方便调试

5. 常见问题解答

Q1: 为什么我的 CSV 文件读取失败？

答： 检查以下几点：

• 文件路径是否正确
• 文件是否包含 string 和 translate_string 两列
• 文件编码是否是 UTF-8（建议使用 UTF-8 编码保存）

Q2: 翻译功能不工作怎么办？

答：

• 检查网络连接是否正常
• 确认 translate_output 参数设置为 True
• 如果还是不行，可能是翻译服务暂时不可用

Q3: StringList 节点的选择逻辑混乱怎么办？

答：

• 记住优先级：指定序号 > 顺序循环 > 随机选择
• 如果设置了 p1_select_by_numbers，其他选择方式会被忽略
• 想要随机选择，确保 p1_select_by_numbers 为空

Q4: 时间格式化显示不对怎么办？

答：

• 检查格式化字符串是否正确
• 常用格式：%Y-%m-%d (年-月-日)、%H:%M:%S (时:分:秒)
• 可以参考 Python 的 strftime 格式说明

Q5: 字符串转换失败怎么办？

答：

• 确认输入字符串格式正确
• 转换为数字时，确保字符串只包含数字
• 转换为布尔值时，使用 "true"、"false"、"1"、"0" 等
• 转换为列表时，使用逗号分隔

6. 高级应用场景

6.1 批量提示词管理

结合 StringListFromCSV 和 StringListToCSV，可以建立一个完整的提示词管理系统：

• 用 StringListFromCSV 读取分类好的提示词
• 用 StringList 进行选择和组合
• 用 StringListToCSV 保存新的组合结果

6.2 多语言工作流

利用翻译功能，可以建立中英文混合的工作流：

• 用中文思考和组织提示词
• 自动翻译成英文送给模型
• 保存双语版本便于后续使用

6.3 智能文件命名

结合 TimeFormatter 和 StringFormatter，可以生成智能的文件名：

• 包含时间戳避免重复
• 包含关键参数便于识别
• 格式统一便于管理

这个插件就像给你的 ComfyUI 装了一个超级强大的文字处理工具包，让你在处理各种文字任务时游刃有余！