需安装DeepSeek专用节点、正确放置模型文件并匹配接口：一、确认节点支持DeepSeek V4；二、通过Git或ComfyUI-Manager安装节点；三、将GGUF或HF模型放入指定路径并配置；四、按MODEL→PROMPT→TEXT顺序连接节点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在ComfyUI中调用DeepSeek V4模型执行文本生成任务，但工作流中缺少对应节点或连接失败，则可能是由于DeepSeek专用节点未安装、模型文件未放置正确，或节点间输入输出接口不匹配所致。以下是解决此问题的步骤：
一、确认DeepSeek V4支持状态与节点来源
DeepSeek V4为大语言模型，需通过专门适配的ComfyUI节点实现接入。当前社区主流方案依赖ComfyUI-LLM或ComfyUI-DeepSeek-Adapter类节点包，其功能是将LLM推理封装为可拖拽、可连接的图形化节点，并提供文本输入/输出、参数配置等接口。该节点不依赖Stable Diffusion原生组件，需独立安装并确保Python环境兼容。
1、访问GitHub仓库页面：https://github.com/llm-comfyui/ComfyUI-DeepSeek-Adapter（或检索最新维护分支）。
2、核对README中明确标注的兼容版本，确认支持DeepSeek V4的quantized GGUF或HF Transformers加载方式。
3、检查项目是否已发布预编译wheel包，或仅支持源码安装；若需编译，须确保系统已安装rustc与pybind11。
二、通过Git命令行安装DeepSeek节点包
该方法适用于具备基础终端操作能力的用户，能精准控制安装路径与版本，避免启动器自动覆盖风险。节点将被置于custom_nodes目录下，重启后自动注册为可用组件。
1、打开ComfyUI根目录，在custom_nodes文件夹空白处右键，选择“Open in Terminal”或“Git Bash Here”。
2、执行克隆命令：git clone https://github.com/llm-comfyui/ComfyUI-DeepSeek-Adapter.git。
3、进入新生成的文件夹：cd ComfyUI-DeepSeek-Adapter。
4、若目录内存在requirements.txt，运行：pip install -r requirements.txt；若提示权限错误，改用pip install --user -r requirements.txt。
5、返回ComfyUI根目录，执行python main.py重启服务，观察控制台是否打印"[DeepSeek Adapter] loaded successfully"字样。
三、使用ComfyUI-Manager图形化安装
该方式无需记忆命令，由管理器自动解析依赖、校验签名并提示冲突，适合中阶用户快速部署。安装后节点将出现在左侧节点列表的“LLM”或“Text”分类中。
1、确保已安装并启用ComfyUI-Manager，界面右上角可见“Manager”按钮。
2、点击“Manager”→“Node Manager”，切换至“Install”标签页。
3、在搜索框输入DeepSeek-Adapter，从结果列表中勾选目标条目。
4、点击“Install”按钮，等待进度条完成；若出现红色报错，查看日志中提示的缺失包名（如llama-cpp-python），手动执行pip install llama-cpp-python --no-deps后再重试。
5、安装完毕后刷新页面，按Ctrl+Space唤出节点搜索框，输入deepseek应能即时匹配到DeepSeekV4Loader与DeepSeekTextGenerate等节点。
四、配置DeepSeek V4模型文件路径
节点本身不包含模型权重，必须手动提供DeepSeek V4的GGUF量化文件（如deepseek-v4.Q5_K_M.gguf）或HF格式完整模型。路径错误将导致加载时报“Model not found”或空响应。
1、创建专用模型目录：ComfyUI/models/llm/deepseek-v4/。
2、将下载的GGUF文件放入该路径，确保文件名不含中文、空格或特殊符号。
3、在ComfyUI中添加DeepSeekV4Loader节点，双击打开配置面板，在“Model Path”字段中点击文件夹图标，导航至上述路径并选中GGUF文件。
4、若使用HF格式，需额外确认transformers版本≥4.40.0，并在配置中勾选Use HF Transformers选项，同时填入HuggingFace模型ID（如deepseek-ai/DeepSeek-V4）。
五、构建并验证DeepSeek V4工作流连接
DeepSeek节点遵循标准输入/输出协议，但其接口命名与SD节点不同，误连会导致静默失败。关键接口必须严格匹配类型与语义，例如文本输入必须接STRING而非CONDITIONING。
1、在画布添加DeepSeekV4Loader节点，配置模型路径后，其输出端口标记为MODEL。
2、添加DeepSeekTextGenerate节点，将其MODEL输入端口拖拽连接至Loader的MODEL输出端口。
3、添加StringConstant节点（或使用Input Text），将输出连接至DeepSeekTextGenerate的PROMPT端口。
4、添加SaveText或PreviewText节点，接收DeepSeekTextGenerate的TEXT输出，用于查看生成结果。
5、点击“Queue Prompt”，观察右下角日志是否显示"Starting DeepSeek inference..."及后续token流；若卡在“Loading model…”超60秒，检查VRAM占用或GGUF文件完整性。
