【版权严正声明】
本文系作者 [编程界的小学生] 原创,并拥有完整、独立的著作权。
未经本人 书面授权 ,任何单位、平台或个人, 严禁 以任何形式(包括但不限于转载、复制、摘编、修改、链接、转贴、建立镜像等)使用本文的全部或部分内容。
任何无视本声明的侵权行为,本人将依据《中华人民共和国著作权法》等相关法律法规,采取一切必要的法律手段,追究其侵权责任,要求其 立即停止侵权、赔礼道歉、消除影响,并赔偿因此造成的一切经济损失及维权成本(包括但不限于律师费、诉讼费、公证费等)。
侵权必究,切勿以身试法!
1. 插件简介
插件地址: https://github.com/heshengtao/comfyui_LLM_party
这个插件就像一个超级强大的"AI聚会平台"!它能让你在ComfyUI中使用各种大语言模型(就像ChatGPT那样的AI),并且可以让这些AI互相配合工作。简单来说:
你可以在ComfyUI里直接和AI聊天
可以让AI帮你生成图片的提示词
可以让多个AI一起工作,就像开会讨论问题一样
支持本地AI模型和在线AI服务
主要功能:
能带来什么效果:
让ComfyUI变成一个智能助手平台
自动生成高质量的AI绘画提示词
创建专业的AI客服系统
构建个人知识管理系统
实现复杂的AI工作流程
2. 如何安装
方法一:通过ComfyUI管理器安装(推荐)
打开ComfyUI
点击"Manager"按钮
搜索"comfyui_LLM_party"
点击安装
方法二:手动安装
打开ComfyUI的安装文件夹
进入custom_nodes文件夹
在这里打开命令行,输入:
git clone https://github.com/heshengtao/comfyui_LLM_party.git
cd comfyui_LLM_party
pip install -r requirements.txt
重启ComfyUI
配置说明:
需要配置API密钥才能使用在线AI服务
可以在config.ini文件中配置各种参数
支持中文和英文界面
3. 节点详细解析
本插件包含超过100个节点,是ComfyUI中最大的LLM插件之一。以下将详细解析所有主要节点:
3.1 LLM(API大语言模型)节点
这个节点是干嘛的? 这是插件的"核心大脑",就像给ComfyUI装了一个ChatGPT。你可以和它聊天,让它帮你做各种文字工作。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
system_prompt | system_prompt | 文本 | 你是一个强大的人工智能助手 | 给AI设定角色和行为规则 | 系统提示词,定义AI的行为模式 | "你是一个专业的摄影师,帮我生成拍照提示词" |
user_prompt | user_prompt | 文本 | 你好 | 你想问AI的问题 | 用户输入的提示词 | "帮我写一个关于春天的诗" |
model | model | CUSTOM | - | 选择要使用的AI模型 | 连接的LLM模型实例 | 连接LLM_api_loader节点的输出 |
temperature | temperature | 0.0-1.0 | 0.7 | 控制AI回答的创意程度 | 控制输出随机性的参数 | 0.1很严谨,0.9很有创意 |
is_memory | is_memory | enable/disable | enable | 是否记住之前的对话 | 是否启用对话历史记忆 | enable会记住上下文,disable每次都是新对话 |
is_tools_in_sys_prompt | is_tools_in_sys_prompt | enable/disable | disable | 是否把工具说明加到系统提示词里 | 将工具列表集成到系统提示中 | 某些模型需要enable才能使用工具 |
is_locked | is_locked | enable/disable | disable | 是否锁定输出结果 | 是否直接输出上次的结果 | enable时不会重新计算,节省时间 |
main_brain | main_brain | enable/disable | enable | 是否作为主要AI | 是否作为主要的LLM节点 | disable时可以被其他AI调用 |
max_length | max_length | 256-128000 | 1920 | AI回答的最大字数 | 输出文本的最大长度 | 1920够用,太大会很慢 |
system_prompt_input | system_prompt_input | STRING | - | 从其他节点输入的系统提示词 | 外部输入的系统提示词 | 可以连接其他节点动态生成提示词 |
user_prompt_input | user_prompt_input | STRING | - | 从其他节点输入的用户问题 | 外部输入的用户提示词 | 连接文本处理节点的输出 |
tools | tools | STRING | - | AI可以使用的工具列表 | 工具函数的JSON定义 | 连接工具组合节点,让AI能搜索、计算等 |
file_content | file_content | STRING | - | 给AI参考的文件内容 | 输入的文件内容 | 连接文件加载节点,让AI分析文档 |
images | images | IMAGE | - | 给AI看的图片 | 输入的图像数据 | 连接图片,让AI描述图片内容 |
imgbb_api_key | imgbb_api_key | STRING | - | 图片上传服务的密钥 | ImgBB图床的API密钥 | 用于上传图片到网络,某些AI需要 |
conversation_rounds | conversation_rounds | 1-10000 | 100 | 记住多少轮对话 | 对话历史的最大轮数 | 100轮够用,太多会占内存 |
historical_record | historical_record | 文件列表 | - | 选择对话历史文件 | 对话历史记录文件 | 可以继续之前的对话 |
is_enable | is_enable | true/false | true | 是否启用这个节点 | 是否启用LLM节点 | false时节点不工作,用于调试 |
extra_parameters | extra_parameters | DICT | - | 额外的模型参数 | 额外的模型配置参数 | 高级用户可以调整特殊参数 |
user_history | user_history | STRING | - | 直接输入的对话历史 | JSON格式的对话历史 | 可以直接粘贴对话记录 |
img_URL | img_URL | STRING | - | 图片的网络地址 | 图像的URL链接 | 直接提供图片链接给AI |
stream | stream | true/false | false | 是否实时显示AI回答 | 是否启用流式输出 | true时可以看到AI逐字回答 |
3.2 LLM_local(本地大语言模型)节点
这个节点是干嘛的? 这是"本地AI大脑",可以在你自己的电脑上运行AI模型,不需要联网,隐私更安全。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model | model | CUSTOM | - | 本地AI模型 | 本地加载的模型实例 | 连接本地模型加载器的输出 |
system_prompt | system_prompt | 文本 | 你是一个强大的人工智能助手 | 给AI设定角色 | 系统提示词 | 同API版本 |
user_prompt | user_prompt | 文本 | 你好 | 你的问题 | 用户提示词 | 同API版本 |
model_type | model_type | LLM/VLM等 | LLM | 模型的类型 | 模型类型选择 | LLM是纯文本,VLM可以看图 |
temperature | temperature | 0.0-1.0 | 0.7 | 创意程度 | 输出随机性控制 | 同API版本 |
max_length | max_length | 256-128000 | 512 | 最大回答长度 | 输出文本最大长度 | 本地模型建议设小一点 |
is_memory | is_memory | enable/disable | enable | 是否记住对话 | 对话记忆开关 | 同API版本 |
is_locked | is_locked | enable/disable | disable | 是否锁定输出 | 输出锁定开关 | 同API版本 |
main_brain | main_brain | enable/disable | enable | 是否为主AI | 主要LLM标识 | 同API版本 |
tokenizer | tokenizer | CUSTOM | - | 文本处理器 | 模型的分词器 | 通常和model一起从加载器获得 |
image | image | IMAGE | - | 输入图片 | 图像输入 | VLM模型可以分析图片 |
system_prompt_input | system_prompt_input | STRING | - | 外部系统提示词 | 外部输入的系统提示 | 同API版本 |
user_prompt_input | user_prompt_input | STRING | - | 外部用户问题 | 外部输入的用户提示 | 同API版本 |
tools | tools | STRING | - | 工具列表 | 可用工具的定义 | 同API版本 |
file_content | file_content | STRING | - | 文件内容 | 参考文件内容 | 同API版本 |
conversation_rounds | conversation_rounds | 1-10000 | 100 | 对话轮数 | 记忆的对话轮数 | 同API版本 |
historical_record | historical_record | 文件列表 | - | 历史记录文件 | 对话历史文件 | 同API版本 |
is_enable | is_enable | true/false | true | 是否启用 | 节点启用开关 | 同API版本 |
extra_parameters | extra_parameters | DICT | - | 额外参数 | 额外的模型参数 | 同API版本 |
user_history | user_history | STRING | - | 对话历史 | JSON格式的对话历史 | 同API版本 |
is_enable_system_role | is_enable_system_role | enable/disable | enable | 是否启用系统角色 | 系统角色启用开关 | 某些模型需要disable |
3.3 LLM_api_loader(API模型加载器)节点
这个节点是干嘛的? 这是"AI模型连接器",负责连接各种在线AI服务,就像给ComfyUI装了一个万能插头,可以连接OpenAI、Claude等各种AI。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model_name | model_name | 文本 | gpt-4o-mini | AI模型的名称 | 要使用的模型名称 | "gpt-4o"、"claude-3-sonnet" |
base_url | base_url | 文本 | - | AI服务的网址 | API的基础URL | "https://api.openai.com/v1/" |
api_key | api_key | 文本 | - | 访问AI服务的密钥 | API访问密钥 | 从AI服务商获得的密钥 |
is_ollama | is_ollama | true/false | false | 是否使用Ollama本地服务 | 是否连接Ollama服务 | true时连接本地Ollama |
3.4 LLM_local_loader(本地模型加载器)节点
这个节点是干嘛的? 这是"本地AI装载机",负责把存储在你电脑上的AI模型加载到内存中,让它们可以工作。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model_name_or_path | model_name_or_path | 文本 | - | 模型文件的位置 | 模型路径或HuggingFace ID | "E:\models\llama-3-8b" |
device | device | auto/cuda/cpu/mps | auto | 使用什么硬件运行 | 运行设备选择 | cuda用显卡,cpu用处理器 |
dtype | dtype | auto/float16等 | auto | 数据精度类型 | 模型数据类型 | float16省显存,float32更精确 |
is_locked | is_locked | true/false | true | 是否锁定模型 | 模型锁定状态 | true防止重复加载 |
这个节点是干嘛的? 这是"工具箱管理员",把各种AI工具(搜索、计算器、天气等)打包在一起,让AI可以使用这些工具。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
tool_1 | tool_1 | STRING | - | 第一个工具 | 工具函数定义 | 连接搜索工具节点 |
tool_2 | tool_2 | STRING | - | 第二个工具 | 工具函数定义 | 连接天气工具节点 |
tool_3 | tool_3 | STRING | - | 第三个工具 | 工具函数定义 | 连接计算器工具节点 |
tool_4 | tool_4 | STRING | - | 第四个工具 | 工具函数定义 | 连接时间工具节点 |
tool_5 | tool_5 | STRING | - | 第五个工具 | 工具函数定义 | 可以继续添加更多工具 |
这个节点是干嘛的? 这是"谷歌搜索助手",让AI可以在谷歌上搜索最新信息,就像给AI装了一个搜索引擎。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
google_api_key | google_api_key | 文本 | - | 谷歌搜索的密钥 | Google Custom Search API密钥 | 从Google Cloud获得 |
cse_id | cse_id | 文本 | - | 自定义搜索引擎ID | Custom Search Engine ID | 在Google CSE创建 |
is_enable | is_enable | true/false | true | 是否启用搜索 | 工具启用开关 | false时AI无法搜索 |
这个节点是干嘛的? 这是"时间管家",让AI知道现在是什么时间,可以回答关于时间的问题。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用时间工具 | 时间工具启用开关 | AI可以知道当前时间 |
3.8 load_file(文件加载器)节点
这个节点是干嘛的? 这是"文件阅读器",可以读取各种文件(Word、PDF、网页等),让AI分析文件内容。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
file_path | file_path | 文本 | - | 文件的位置 | 文件路径 | "C:\Documents\report.pdf" |
is_enable | is_enable | true/false | true | 是否启用文件加载 | 文件加载启用开关 | false时不读取文件 |
3.9 show_text_party(文本显示器)节点
这个节点是干嘛的? 这是"文本展示板",用来显示AI的回答或其他文本内容,方便查看结果。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
text | text | STRING | - | 要显示的文本 | 输入的文本内容 | 连接LLM节点的输出 |
3.10 embeddings_function(词向量搜索)节点
这个节点是干嘛的? 这是"智能搜索器",可以在大量文档中找到与问题最相关的内容,就像一个超级聪明的图书管理员。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
query | query | 文本 | - | 搜索的问题 | 查询文本 | "如何使用ComfyUI" |
database | database | CUSTOM | - | 知识库 | 向量数据库 | 连接词嵌入数据库 |
top_k | top_k | 1-100 | 5 | 返回多少个结果 | 返回的最相关结果数量 | 5个结果通常够用 |
这个节点是干嘛的? 这是"必应搜索助手",让AI可以在必应上搜索最新信息,支持网页、图片、视频、新闻等多种搜索类型。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用搜索 | 工具启用开关 | false时AI无法搜索 |
searchType | searchType | web/image/video/news | web | 搜索类型 | 搜索内容类型选择 | web搜网页,image搜图片 |
bing_api_key | bing_api_key | 文本 | - | 必应搜索的密钥 | Bing Search API密钥 | 从Microsoft Azure获得 |
custom_config_id | custom_config_id | 文本 | - | 自定义搜索配置ID | 自定义搜索引擎ID | 可选,用于定制搜索范围 |
is_custom_api | is_custom_api | true/false | false | 是否使用自定义搜索 | 自定义搜索API开关 | true时使用自定义搜索配置 |
这个节点是干嘛的? 这是"隐私搜索助手",使用DuckDuckGo搜索引擎,不追踪用户隐私,支持网页和图片搜索。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用搜索 | 工具启用开关 | false时AI无法搜索 |
searchType | searchType | web/image | web | 搜索类型 | 搜索内容类型选择 | web搜网页,image搜图片 |
这个节点是干嘛的? 这是"网页阅读器",可以访问指定网页并提取其中的文本内容,让AI能够阅读网页信息。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用网页检查 | 工具启用开关 | false时AI无法访问网页 |
这个节点是干嘛的? 这是"天气预报员",可以查询全球各地的天气信息,包括当前天气和未来预报。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用天气查询 | 工具启用开关 | false时AI无法查询天气 |
accuweather_api_key | accuweather_api_key | 文本 | - | AccuWeather的API密钥 | AccuWeather API访问密钥 | 从AccuWeather官网获得 |
这个节点是干嘛的? 这是"百科全书",可以从维基百科搜索和获取知识信息,为AI提供权威的百科知识。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用维基百科搜索 | 工具启用开关 | false时AI无法搜索维基百科 |
language | language | zh/en等 | zh | 搜索语言 | 维基百科语言版本 | zh是中文,en是英文 |
这个节点是干嘛的? 这是"代码仓库搜索器",可以在GitHub上搜索开源项目和代码仓库。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用GitHub搜索 | 工具启用开关 | false时AI无法搜索GitHub |
github_token | github_token | 文本 | - | GitHub访问令牌 | GitHub API访问令牌 | 从GitHub设置中生成 |
这个节点是干嘛的? 这是"代码执行器",让AI可以编写和执行Python代码,进行数据分析、计算等操作。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用代码执行 | 工具启用开关 | false时AI无法执行代码 |
safe_mode | safe_mode | true/false | true | 是否启用安全模式 | 代码执行安全限制 | true时限制危险操作 |
3.18 openai_tts(OpenAI语音合成)节点
这个节点是干嘛的? 这是"语音合成器",可以将文本转换为语音,让AI的回答变成可以听的声音。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
text | text | STRING | - | 要转换的文本 | 输入的文本内容 | 连接LLM节点的输出 |
voice | voice | alloy/echo/fable/onyx/nova/shimmer | alloy | 语音类型 | 语音模型选择 | alloy是默认声音 |
model | model | tts-1/tts-1-hd | tts-1 | 语音模型 | TTS模型选择 | tts-1-hd质量更高 |
speed | speed | 0.25-4.0 | 1.0 | 语音速度 | 播放速度控制 | 1.0是正常速度 |
api_key | api_key | 文本 | - | OpenAI API密钥 | API访问密钥 | 从OpenAI获得 |
这个节点是干嘛的? 这是"企业微信机器人",可以将AI的回答发送到企业微信群聊中。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用企业微信发送 | 工具启用开关 | false时不发送消息 |
webhook_url | webhook_url | 文本 | - | 企业微信机器人地址 | Webhook URL | 从企业微信群机器人获得 |
这个节点是干嘛的? 这是"飞书机器人",可以将AI的回答发送到飞书群聊中。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用飞书发送 | 工具启用开关 | false时不发送消息 |
webhook_url | webhook_url | 文本 | - | 飞书机器人地址 | Webhook URL | 从飞书群机器人获得 |
这个节点是干嘛的? 这是"钉钉机器人",可以将AI的回答发送到钉钉群聊中。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
is_enable | is_enable | true/false | true | 是否启用钉钉发送 | 工具启用开关 | false时不发送消息 |
webhook_url | webhook_url | 文本 | - | 钉钉机器人地址 | Webhook URL | 从钉钉群机器人获得 |
这个节点是干嘛的? 这是"万能接口调用器",可以让AI调用任意的网络API接口,获取各种在线服务的数据。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
api_url | api_url | 文本 | - | API接口地址 | API端点URL | "https://api.example.com/data" |
method | method | GET/POST/PUT/DELETE | GET | 请求方法 | HTTP请求方法 | GET获取数据,POST提交数据 |
headers | headers | JSON | {} | 请求头 | HTTP请求头 | 包含认证信息等 |
params | params | JSON | {} | 请求参数 | API请求参数 | 查询参数或请求体 |
is_enable | is_enable | true/false | true | 是否启用API调用 | 工具启用开关 | false时不调用API |
这个节点是干嘛的? 这是"工作流调用器",可以让AI调用其他ComfyUI工作流,实现复杂的自动化任务。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
workflow_path | workflow_path | 文本 | - | 工作流文件路径 | 工作流JSON文件路径 | "./workflow/image_gen.json" |
is_enable | is_enable | true/false | true | 是否启用工作流调用 | 工具启用开关 | false时不调用工作流 |
3.24 classify_persona(分类器面具)节点
这个节点是干嘛的? 这是"智能分类器",可以根据输入内容自动分类,比如判断邮件是垃圾邮件还是正常邮件。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
categories | categories | 文本 | - | 分类类别 | 分类标签列表 | "正面,负面,中性" |
text_input | text_input | STRING | - | 要分类的文本 | 输入的文本内容 | 连接其他节点的输出 |
model | model | CUSTOM | - | 分类模型 | 用于分类的LLM模型 | 连接LLM加载器 |
3.25 custom_persona(自定义面具)节点
这个节点是干嘛的? 这是"角色定制器",可以创建各种专业的AI角色,比如医生、律师、老师等。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
persona_name | persona_name | 文本 | - | 角色名称 | 人格面具名称 | "专业医生" |
persona_description | persona_description | 文本 | - | 角色描述 | 人格面具详细描述 | "你是一位经验丰富的医生..." |
save_path | save_path | 文本 | - | 保存路径 | 面具文件保存路径 | "./persona/doctor.txt" |
3.26 omost_decode(omost解码器)节点
这个节点是干嘛的? 这是"画面描述解析器",专门用于解析AI生成的画面描述,转换为可用于图像生成的格式。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
omost_code | omost_code | STRING | - | omost代码 | omost格式的画面描述代码 | 连接LLM输出的omost代码 |
image_width | image_width | 512-2048 | 1024 | 图片宽度 | 生成图像的宽度 | 1024像素 |
image_height | image_height | 512-2048 | 1024 | 图片高度 | 生成图像的高度 | 1024像素 |
这个节点是干嘛的? 这是"知识图谱管理器",可以创建和管理JSON格式的知识图谱,让AI学习和记忆复杂的知识关系。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
kg_file_path | kg_file_path | 文本 | - | 知识图谱文件路径 | JSON格式知识图谱文件路径 | "./KG/knowledge.json" |
is_enable | is_enable | true/false | true | 是否启用知识图谱 | 工具启用开关 | false时不使用知识图谱 |
3.28 load_excel(Excel迭代器)节点
这个节点是干嘛的? 这是"表格处理器",可以读取Excel文件并逐行处理数据,适合批量数据处理任务。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
excel_path | excel_path | 文本 | - | Excel文件路径 | Excel文件的完整路径 | "./data/customers.xlsx" |
sheet_name | sheet_name | 文本 | Sheet1 | 工作表名称 | Excel工作表名称 | "Sheet1"或"客户数据" |
start_row | start_row | 1-1000 | 1 | 开始行号 | 数据开始的行号 | 1表示从第一行开始 |
batch_size | batch_size | 1-100 | 1 | 批处理大小 | 每次处理的行数 | 1表示逐行处理 |
3.29 text_iterator(文本迭代器)节点
这个节点是干嘛的? 这是"文本分割器",可以将长文本分割成小段,逐段处理,适合处理长文档。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
text | text | STRING | - | 要分割的文本 | 输入的长文本内容 | 连接文件加载器的输出 |
chunk_size | chunk_size | 100-5000 | 1000 | 分割大小 | 每段文本的字符数 | 1000字符一段 |
overlap | overlap | 0-500 | 100 | 重叠字符数 | 段落间重叠的字符数 | 100字符重叠保持连贯性 |
3.30 string_logic(字符串逻辑)节点
这个节点是干嘛的? 这是"文本逻辑处理器",可以对文本进行各种逻辑操作,比如判断、替换、提取等。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
input_string | input_string | STRING | - | 输入文本 | 要处理的文本内容 | 连接其他节点的文本输出 |
operation | operation | contains/equals/startswith/endswith | contains | 逻辑操作类型 | 字符串逻辑操作选择 | contains检查是否包含 |
target_string | target_string | 文本 | - | 目标文本 | 用于比较的目标字符串 | "错误"、"成功"等关键词 |
case_sensitive | case_sensitive | true/false | false | 是否区分大小写 | 大小写敏感性设置 | false时不区分大小写 |
3.31 clear_model(清空模型)节点
这个节点是干嘛的? 这是"内存清理器",可以清空已加载的模型,释放显存和内存,避免内存不足的问题。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model | model | CUSTOM | - | 要清空的模型 | 模型实例 | 连接模型加载器的输出 |
clear_cache | clear_cache | true/false | true | 是否清空缓存 | 是否清理GPU缓存 | true时彻底清理内存 |
3.32 save_ebd_database(保存向量数据库)节点
这个节点是干嘛的? 这是"知识库保存器",可以将处理好的文档向量化并保存为数据库,供后续搜索使用。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
documents | documents | STRING | - | 文档内容 | 要向量化的文档文本 | 连接文件加载器的输出 |
database_path | database_path | 文本 | - | 数据库保存路径 | 向量数据库文件路径 | "./database/knowledge.db" |
embedding_model | embedding_model | CUSTOM | - | 词嵌入模型 | 用于向量化的模型 | 连接词嵌入模型加载器 |
chunk_size | chunk_size | 100-2000 | 500 | 文档分割大小 | 文档分割的字符数 | 500字符一段 |
3.33 load_ebd(加载词嵌入模型)节点
这个节点是干嘛的? 这是"词嵌入模型加载器",用于加载各种词嵌入模型,为文本向量化和相似度搜索提供支持。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model_name | model_name | 文本 | - | 模型名称或路径 | 词嵌入模型名称或本地路径 | "sentence-transformers/all-MiniLM-L6-v2" |
device | device | auto/cuda/cpu | auto | 运行设备 | 模型运行的硬件设备 | auto自动选择最佳设备 |
is_locked | is_locked | true/false | true | 是否锁定模型 | 模型锁定状态 | true防止重复加载 |
3.34 translate_persona(翻译面具)节点
这个节点是干嘛的? 这是"专业翻译官",专门用于各种语言之间的翻译,支持多种翻译风格和专业领域。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
source_language | source_language | 文本 | auto | 源语言 | 原文的语言类型 | "中文"、"英文"、"auto"自动检测 |
target_language | target_language | 文本 | 英文 | 目标语言 | 翻译后的语言类型 | "英文"、"日文"、"法文" |
translation_style | translation_style | 文本 | 准确 | 翻译风格 | 翻译的风格类型 | "准确"、"流畅"、"文学" |
domain | domain | 文本 | 通用 | 专业领域 | 翻译的专业领域 | "医学"、"法律"、"技术" |
3.35 flux_persona(Flux提示词生成器面具)节点
这个节点是干嘛的? 这是"Flux专用提示词生成器",专门为Flux图像生成模型优化提示词,提高图像生成质量。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
description | description | STRING | - | 图像描述 | 用户输入的图像描述 | "一只可爱的小猫" |
style | style | 文本 | realistic | 图像风格 | 生成图像的艺术风格 | "realistic"、"anime"、"oil_painting" |
quality | quality | high/medium/low | high | 图像质量 | 生成图像的质量等级 | high生成最佳质量 |
3.36 Lorebook(传说书)节点
这个节点是干嘛的? 这是"故事背景管理器",用于管理小说、游戏等创作中的世界观、角色设定等背景信息。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
lorebook_path | lorebook_path | 文本 | - | 传说书文件路径 | Lorebook文件的路径 | "./lorebook/fantasy_world.json" |
keywords | keywords | 文本 | - | 触发关键词 | 激活相关条目的关键词 | "魔法"、"龙"、"王国" |
max_entries | max_entries | 1-20 | 5 | 最大条目数 | 同时激活的最大条目数 | 5个条目通常够用 |
3.37 json_iterator(JSON迭代器)节点
这个节点是干嘛的? 这是"JSON数据处理器",可以遍历JSON数据结构,逐个处理其中的数据项。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
json_data | json_data | STRING | - | JSON数据 | 要处理的JSON格式数据 | 连接API或文件加载器的输出 |
path | path | 文本 | - | 数据路径 | JSON中的数据路径 | "data.items"、"results[0].name" |
batch_size | batch_size | 1-100 | 1 | 批处理大小 | 每次处理的数据项数量 | 1表示逐项处理 |
3.38 text_writing(文件写入)节点
这个节点是干嘛的? 这是"文件写入器",可以将AI生成的内容保存到文件中,支持多种文件格式。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
text | text | STRING | - | 要写入的文本 | 输入的文本内容 | 连接LLM节点的输出 |
file_path | file_path | 文本 | - | 文件保存路径 | 文件的完整保存路径 | "./output/result.txt" |
mode | mode | write/append | write | 写入模式 | 文件写入方式 | write覆盖,append追加 |
encoding | encoding | utf-8/gbk | utf-8 | 文件编码 | 文本文件的字符编码 | utf-8支持中文 |
3.39 json_writing(JSON写入)节点
这个节点是干嘛的? 这是"JSON文件写入器",专门用于保存JSON格式的数据,确保数据格式正确。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
json_data | json_data | STRING | - | JSON数据 | 要保存的JSON格式数据 | 连接API或处理节点的输出 |
file_path | file_path | 文本 | - | 文件保存路径 | JSON文件的保存路径 | "./output/data.json" |
indent | indent | 0-8 | 4 | 缩进空格数 | JSON格式化的缩进 | 4个空格便于阅读 |
ensure_ascii | ensure_ascii | true/false | false | 是否转义非ASCII字符 | ASCII字符转义设置 | false保持中文显示 |
3.40 file_path_iterator(文件路径迭代器)节点
这个节点是干嘛的? 这是"文件批处理器",可以遍历指定文件夹中的所有文件,逐个进行处理。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
folder_path | folder_path | 文本 | - | 文件夹路径 | 要遍历的文件夹路径 | "./documents/" |
file_pattern | file_pattern | 文本 | . | 文件匹配模式 | 文件名匹配规则 | "*.txt"只处理文本文件 |
recursive | recursive | true/false | false | 是否递归子文件夹 | 是否包含子文件夹 | true时处理所有子文件夹 |
batch_size | batch_size | 1-50 | 1 | 批处理大小 | 每次处理的文件数量 | 1表示逐个处理 |
3.41 aisuite_loader(AISuite加载器)节点
这个节点是干嘛的? 这是"多平台AI模型加载器",支持同时连接多个AI服务商(OpenAI、Anthropic、AWS等),提供统一的接口。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
provider | provider | openai/anthropic/aws/azure/vertex/huggingface | openai | AI服务提供商 | AI服务商选择 | openai是OpenAI,anthropic是Claude |
model_name | model_name | 文本 | gpt-4o-mini | 模型名称 | 具体的模型名称 | "gpt-4o"、"claude-3-sonnet" |
api_key | api_key | 文本 | - | API密钥 | 对应服务商的API密钥 | 从各服务商获得 |
base_url | base_url | 文本 | - | 基础URL | API的基础地址 | 可选,用于自定义端点 |
aws_access_key_id | aws_access_key_id | 文本 | - | AWS访问密钥ID | AWS服务的访问密钥 | 使用AWS时必需 |
aws_secret_access_key | aws_secret_access_key | 文本 | - | AWS秘密访问密钥 | AWS服务的秘密密钥 | 使用AWS时必需 |
aws_region_name | aws_region_name | 文本 | - | AWS区域名称 | AWS服务的区域 | "us-east-1"等 |
google_project_id | google_project_id | 文本 | - | Google项目ID | Google Cloud项目ID | 使用Vertex AI时必需 |
google_region | google_region | 文本 | - | Google区域 | Google Cloud区域 | "us-central1"等 |
google_application_credentials | google_application_credentials | 文本 | - | Google应用凭证 | 服务账号凭证文件路径 | JSON凭证文件路径 |
hf_api_token | hf_api_token | 文本 | - | Hugging Face API令牌 | HF服务的访问令牌 | 从Hugging Face获得 |
3.42 easy_LLM_api_loader(简易API LLM加载器)节点
这个节点是干嘛的? 这是"一键AI模型加载器",预配置了常用的AI模型,只需选择模型名称即可快速使用。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model_name | model_name | 下拉列表 | - | 预配置模型名称 | 从配置文件中的模型列表选择 | 选择已配置好的模型 |
3.43 easy_LLM_local_loader(简易本地LLM加载器)节点
这个节点是干嘛的? 这是"一键本地模型加载器",可以快速加载放在指定文件夹中的本地AI模型。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
model_name_or_path | model_name_or_path | 下拉列表 | - | 本地模型选择 | 从LLM文件夹中选择模型 | 选择已下载的本地模型 |
device | device | auto/cuda/cpu/mps | auto | 运行设备 | 模型运行的硬件设备 | auto自动选择最佳设备 |
dtype | dtype | auto/float32/float16/bfloat16/int8/int4 | auto | 数据类型 | 模型的数据精度 | auto自动选择,int4最省显存 |
is_locked | is_locked | true/false | true | 是否锁定模型 | 模型锁定状态 | true防止重复加载 |
3.44 start_dialog(开始对话)节点
这个节点是干嘛的? 这是"对话开始器",用于标记对话流程的开始,可以设置初始状态和参数。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
dialog_name | dialog_name | 文本 | - | 对话名称 | 对话会话的标识名称 | "客服对话"、"面试对话" |
initial_message | initial_message | 文本 | - | 初始消息 | 对话开始时的欢迎消息 | "您好,我是AI助手" |
3.45 end_dialog(结束对话)节点
这个节点是干嘛的? 这是"对话结束器",用于标记对话流程的结束,可以进行清理和总结工作。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
save_history | save_history | true/false | true | 是否保存对话历史 | 对话记录保存开关 | true时保存完整对话记录 |
summary | summary | true/false | false | 是否生成对话总结 | 对话总结生成开关 | true时AI生成对话摘要 |
3.46 start_workflow(开始工作流)节点
这个节点是干嘛的? 这是"工作流启动器",用于初始化复杂的自动化工作流程,设置全局参数。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
workflow_name | workflow_name | 文本 | - | 工作流名称 | 工作流的标识名称 | "图像生成流程"、"数据处理流程" |
parameters | parameters | JSON | {} | 全局参数 | 工作流的全局配置参数 | 设置通用的配置信息 |
3.47 end_workflow(结束工作流)节点
这个节点是干嘛的? 这是"工作流终结器",用于完成工作流程,输出最终结果和统计信息。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
output_path | output_path | 文本 | - | 输出路径 | 最终结果的保存路径 | "./output/final_result" |
generate_report | generate_report | true/false | false | 是否生成报告 | 工作流执行报告生成 | true时生成详细执行报告 |
3.48 About_us(关于我们)节点
这个节点是干嘛的? 这是"信息展示器",用于显示插件的版本信息、作者信息和使用说明。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
show_info | show_info | true/false | true | 是否显示信息 | 信息显示开关 | true时显示插件相关信息 |
3.49 load_name(加载模型名称)节点
这个节点是干嘛的? 这是"配置读取器",可以从config.ini配置文件中读取预设的模型名称和参数。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
config_section | config_section | 文本 | - | 配置节名称 | config.ini中的节名称 | "openai"、"claude"等 |
3.50 substring(提取字符串)节点
这个节点是干嘛的? 这是"文本提取器",可以从长文本中提取指定位置或符合条件的子字符串。
参数详解:
参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|
input_string | input_string | STRING | - | 输入文本 | 要提取子串的原始文本 | 连接其他节点的文本输出 |
start_index | start_index | 0-10000 | 0 | 开始位置 | 子串开始的字符位置 | 0表示从开头开始 |
end_index | end_index | 0-10000 | -1 | 结束位置 | 子串结束的字符位置 | -1表示到文本末尾 |
pattern | pattern | 文本 | - | 匹配模式 | 正则表达式匹配模式 | 可选,用于模式匹配提取 |
4. 使用技巧和建议
4.1 新手入门建议
从简单开始:先用API版本的LLM节点,配置OpenAI或其他在线服务
逐步添加功能:先实现基本对话,再添加工具和记忆功能
多看示例:插件提供了很多示例工作流,可以直接使用
合理设置参数:temperature控制创意度,max_length控制回答长度
4.2 高级使用技巧
多智能体协作:让多个AI分工合作,一个负责搜索,一个负责总结
知识库集成:使用词向量搜索给AI添加专业知识
工具链组合:把搜索、计算、文件处理等工具串联起来
自定义角色:通过system_prompt创建专业的AI助手
4.3 性能优化建议
本地模型:使用量化模型(int4、int8)节省显存
对话管理:合理设置conversation_rounds避免内存溢出
工具选择:只启用需要的工具,减少处理时间
缓存利用:启用is_locked避免重复计算
4.4 常用工作流模式
智能客服:LLM + 知识库 + 工具调用
内容创作:LLM + 文件加载 + 图像生成
数据分析:LLM + 文件处理 + 图表生成
多语言翻译:LLM + 文本处理 + 语音合成
5. 常见问题解答
Q1:如何配置API密钥?
A:
方法1:在config.ini文件中配置
方法2:直接在节点中输入
支持OpenAI、Claude、国产大模型等
Q2:本地模型需要什么配置?
A:
显存:至少8GB(推荐16GB以上)
内存:至少16GB(推荐32GB以上)
存储:模型文件通常几GB到几十GB
Q3:如何让AI使用工具?
A:
连接工具组合节点到LLM的tools输入
确保AI模型支持function calling
在system_prompt中说明工具用途
Q4:对话记忆如何管理?
A:
Q5:如何处理中文?
A:
插件完全支持中文
可以在config.ini中设置语言
所有节点都有中文显示名称
Q6:插件运行很慢怎么办?
A:
检查网络连接(API模式)
降低模型精度(本地模式)
减少max_length参数
关闭不需要的工具
Q7:如何创建专业AI助手?
A:
编写详细的system_prompt
添加相关的知识库
配置专业工具
测试和优化提示词
6. 结语
学习建议:
从简单的对话开始,逐步添加功能
多参考官方示例工作流
加入社区交流群获得帮助
定期关注插件更新
获得帮助:
这个插件真正实现了将ComfyUI从图像生成工具升级为全能AI工作平台的目标。通过118个核心节点的组合,你可以构建出几乎任何你想要的AI应用!🚀