%20(1).png)
ComfyUI-DeepSeek 插件完全入门教程
1. 插件简介
ComfyUI-DeepSeek 是一个专门为 ComfyUI 设计的插件，它的作用就像是在你的 ComfyUI 工作流中安装了一个超级聪明的"对话助手"。这个插件能够让你直接在 ComfyUI 中使用 DeepSeek 的人工智能聊天功能，就像是给你的图像生成工具加上了一个能思考、能对话的大脑。
插件地址： https://github.com/yichengup/Comfyui-Deepseek
主要功能：
- 在 ComfyUI 中直接调用 DeepSeek 的聊天能力
- 支持文本对话和指令处理
- 可以生成创意提示词
- 能够与图像生成工作流完美结合
能带来什么效果：
- 自动生成更好的图像描述词
- 智能优化你的提示词
- 在工作流中加入智能对话环节
- 让AI帮你分析和改进创作思路
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI Manager（管理器）
- 点击"Install Custom Nodes"（安装自定义节点）
- 在搜索框中输入"Deepseek"
- 找到"ComfyUI-Deepseek"并点击安装
- 重启 ComfyUI
方法二：手动安装
- 找到你的 ComfyUI 安装目录
- 进入
custom_nodes文件夹 - 打开命令行（终端）
- 输入命令：
git clone https://github.com/yichengup/Comfyui-Deepseek.git - 进入插件文件夹：
cd Comfyui-Deepseek - 安装依赖：
pip install -r requirements.txt - 重启 ComfyUI
获取 API Key
- 访问 DeepSeek 平台：https://platform.deepseek.com/
- 注册账号并登录
- 找到 API Key 页面，生成你的专属密钥
- 复制这个密钥（就像是你的专属通行证）
配置 API Key
- 在插件文件夹中找到
config.json文件 - 打开文件，将你的 API Key 填入相应位置
- 保存文件
3. 节点详解
3.1 DeepSeek Chat 节点
这个节点就像是一个智能聊天机器人，你可以向它提问，它会给你回答。特别适合用来生成创意内容、优化提示词或者获取创作建议。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | prompt | 文本 | 根据需要 | 这就是你要问AI的问题，就像跟朋友聊天一样 | 发送给DeepSeek模型的提示词输入 | 输入"帮我写一个关于夕阳的诗意描述"，AI就会给你创作 |
| 模型名称 | model | 字符串 | deepseek-chat | 选择要使用的AI大脑版本，不同版本擅长不同任务 | 指定使用的DeepSeek模型版本 | 一般用默认的就行，除非你想要特定功能 |
| 温度 | temperature | 0.0-2.0 | 0.7 | 控制AI回答的"创意程度"，就像调节想象力的旋钮 | 控制生成文本的随机性和创造性 | 0.1很严谨，1.0很有创意，1.5很天马行空 |
| 最大回复长度 | max_tokens | 1-4096 | 1000 | 限制AI回答的长度，防止它说太多废话 | 限制生成文本的最大token数量 | 写短句子用100，写长文章用2000 |
| 历史记录 | history | 列表 | 空 | 存储之前的对话内容，让AI记住你们聊过什么 | 保存对话历史的数据结构 | 第一次使用留空，后续会自动记录 |
3.2 DeepSeek SiliconFlow 节点 V3
这是升级版的聊天节点，就像是给原来的智能助手装上了更强大的处理器。它使用了SiliconFlow的API，速度更快，功能更强。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | prompt | 文本 | 根据需要 | 你想问AI的问题或者想让它帮你做的事情 | 发送给SiliconFlow API的输入文本 | "帮我优化这个图像描述：美丽的风景" |
| 模型版本 | model | 字符串 | deepseek-v3 | 选择AI的"大脑版本"，V3是最新最聪明的 | 指定使用的DeepSeek模型版本 | 用V3获得最好的效果 |
| 温度 | temperature | 0.0-2.0 | 0.7 | 控制AI回答的创意程度，像调节创意的水龙头 | 控制输出的随机性和创造性 | 写技术文档用0.3，写创意内容用1.0 |
| 最大回复长度 | max_tokens | 1-8192 | 2000 | 限制AI回答的长度，防止它太啰嗦 | 限制生成文本的最大长度 | 一般用2000就够了，特殊需要可以调更高 |
| 系统提示 | system_prompt | 文本 | 空 | 给AI设定一个"角色"，告诉它应该怎么表现 | 设定AI的行为模式和回答风格 | "你是一个专业的摄影师，用专业术语回答" |
| 流式输出 | stream | 布尔值 | false | 控制AI是一次性回答还是像打字一样逐字显示 | 控制是否使用流式输出模式 | 一般用false，除非你想看到AI"思考"的过程 |
3.3 DeepSeek R1 节点
这是专门的推理节点，就像是给AI装上了一个"深度思考"的模块。R1版本特别擅长复杂的逻辑推理和问题解决。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | prompt | 文本 | 根据需要 | 你想让AI深度思考的问题或任务 | 发送给R1模型的推理输入 | "分析这个艺术作品的构图特点和情感表达" |
| 模型版本 | model | 字符串 | deepseek-r1 | 选择R1推理模型的版本 | 指定使用的DeepSeek R1模型 | 用默认版本就行 |
| 温度 | temperature | 0.0-2.0 | 0.5 | 控制AI推理的严谨程度，推理任务建议用较低值 | 控制推理过程的随机性 | 逻辑推理用0.3，创意推理用0.8 |
| 最大回复长度 | max_tokens | 1-8192 | 3000 | 限制AI推理结果的长度 | 限制推理输出的最大长度 | 复杂推理需要更多空间，建议用3000+ |
| 思考深度 | reasoning_depth | 1-10 | 5 | 控制AI思考的深度，像设置"思考时间" | 控制推理链的深度和复杂性 | 简单问题用3，复杂问题用7-8 |
| 显示推理过程 | show_reasoning | 布尔值 | true | 是否显示AI的思考过程，就像看到它的"草稿纸" | 是否输出中间推理步骤 | 想学习AI思路就开启，只要结果就关闭 |
3.4 文本预处理节点
这个节点就像是一个文本"洗衣机"，能把你的文本清洗得更干净、更适合AI处理。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | input_text | 文本 | 根据需要 | 需要清理的原始文本 | 待处理的文本输入 | 复制粘贴任何需要整理的文本 |
| 去除多余空格 | remove_extra_spaces | 布尔值 | true | 清理文本中多余的空格，让文本更整洁 | 移除文本中的多余空白字符 | 处理复制粘贴的文本时很有用 |
| 转换大小写 | case_transform | 选择 | none | 统一文本的大小写格式 | 文本大小写转换选项 | 做英文提示词时用lower，做标题用title |
| 移除特殊字符 | remove_special_chars | 布尔值 | false | 去掉文本中的特殊符号 | 移除非字母数字的特殊字符 | 清理网络文本时很有用 |
| 最大长度 | max_length | 1-10000 | 1000 | 限制处理后文本的最大长度 | 限制输出文本的最大字符数 | 防止文本太长导致后续处理出错 |
3.5 提示词生成节点
这个节点就像是一个"创意点子机"，专门帮你生成各种各样的图像描述词和创意提示。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 基础描述 | base_description | 文本 | 空 | 你想画什么的基本描述 | 图像生成的基础描述文本 | "一个美丽的女孩"、"山间小屋" |
| 风格类型 | style_type | 选择 | realistic | 选择你想要的图像风格 | 预设的艺术风格类型 | realistic真实、anime动漫、oil_painting油画 |
| 情感色调 | mood | 选择 | neutral | 设置图像的情感氛围 | 图像的情感表达方向 | happy开心、melancholy忧郁、mysterious神秘 |
| 细节程度 | detail_level | 选择 | medium | 控制生成的提示词有多详细 | 控制生成提示词的详细程度 | simple简单、medium中等、detailed超详细 |
| 添加质量词 | add_quality_tags | 布尔值 | true | 是否自动添加提高图像质量的词汇 | 是否添加质量增强关键词 | 建议开启，能让图像更清晰 |
| 随机因子 | randomness | 0.0-1.0 | 0.3 | 控制生成提示词的随机性和创意性 | 控制随机元素的强度 | 0.1很保守，0.5很有创意，0.9很随机 |
4. 使用技巧和建议
4.1 温度参数的使用心得
- 0.1-0.3：适合需要准确信息的场景，比如技术说明、参数解释
- 0.5-0.7：适合一般对话和创意辅助，平衡了准确性和创造性
- 0.8-1.2：适合创意写作、艺术描述、头脑风暴
- 1.3-2.0：适合实验性创作，可能产生意外惊喜
4.2 提示词编写技巧
- 具体胜过抽象：不要说"好看的图"，要说"阳光透过树叶的温暖画面"
- 分步骤描述：先说主体，再说环境，最后说细节和风格
- 善用否定词：告诉AI不要什么，比如"不要模糊，不要变形"
- 加入情感："充满希望的"、"忧郁的"等情感词能让作品更有感染力
4.3 工作流集成建议
- 串联使用：文本预处理 → DeepSeek Chat → 提示词生成 → 图像生成
- 并联对比：同时使用不同温度参数，对比生成效果
- 循环优化：用AI分析生成的图像，再用分析结果优化提示词
4.4 性能优化建议
- 合理设置最大长度：不要设置过长的max_tokens，避免浪费资源
- 批量处理：处理多个类似任务时，可以在一个对话中完成
- 缓存对话历史：利用历史记录功能，避免重复说明背景
5. 常见问题解答
Q1：为什么我的API Key总是报错？
A1： 检查这几个地方：
- API Key是否正确复制（注意不要有多余空格）
- config.json文件格式是否正确
- 账户是否有足够的API调用次数
- 网络连接是否正常
Q2：AI生成的内容总是不符合我的要求怎么办？
A2： 试试这些方法：
- 降低温度参数到0.3-0.5
- 提供更详细具体的描述
- 使用系统提示设定AI的角色
- 多次尝试，选择最满意的结果
Q3：节点运行很慢怎么办？
A3： 可能的解决方案：
- 减少max_tokens参数
- 检查网络连接速度
- 避免在高峰时间使用
- 考虑使用SiliconFlow版本（通常更快）
Q4：如何让AI生成的提示词更适合我的风格？
A4： 建议这样做：
- 收集几个你喜欢的提示词，让AI分析共同特点
- 使用系统提示告诉AI你的偏好
- 利用历史记录功能，让AI学习你的喜好
- 调整随机因子，找到最适合的创意程度
Q5：R1节点和普通Chat节点有什么区别？
A5： 主要区别：
- R1专门用于复杂推理和逻辑分析
- R1会显示思考过程，更适合学习
- R1处理复杂问题更准确，但速度稍慢
- 普通Chat更适合日常对话和简单创意
6. 进阶使用技巧
6.1 自定义工作流模板
创建你自己的"套路"，比如：
- 风景画生成流程：基础描述 → 风格选择 → 细节优化 → 质量提升
- 人物画生成流程：人物设定 → 表情情绪 → 环境背景 → 光影效果
- 概念设计流程：概念描述 → 功能分析 → 视觉表现 → 技术实现
6.2 AI协作技巧
- 让AI当你的助手：不要把AI当成工具，而是当成合作伙伴
- 分享你的想法：告诉AI你的创作意图和预期效果
- 接受AI的建议：有时候AI的创意会给你意想不到的灵感
- 记录成功案例：把好的提示词和参数组合保存下来
6.3 故障排除指南
- 节点不显示：检查插件是否正确安装，重启ComfyUI
- 连接超时：检查网络，或者稍后重试
- 结果不理想：尝试不同的参数组合，特别是温度值
- 卡住不动：检查API余额，或者减少max_tokens
7. 总结
ComfyUI-DeepSeek 插件就像是给你的创作工具箱加了一个智能大脑，它不仅能帮你生成创意，还能优化你的想法，甚至教会你更好的创作技巧。
记住最重要的一点：AI是你的助手，不是替代品。最好的作品总是来自于人的创意和AI的能力相结合。多尝试，多实验，你会发现这个插件能为你的创作带来无限可能！
开始你的AI创作之旅吧！🎨✨