Description

n8n-nodes-deepseek-next

面向 n8n 的社区节点包：DeepSeek Chat Model (Next)。基于 DeepSeek OpenAI 兼容 Chat Completions 接口，通过 @langchain/deepseek 接入 LangChain，并与官方 AI Agent / Tools Agent 流式执行链路对齐。

• npm： n8n-nodes-deepseek-next
• 源码：

—

支持的模型（含 DeepSeek V4）

节点会通过凭证调用 GET /models 动态加载可选模型列表；若接口不可用，则回退到下列静态 ID：

| 模型 ID | 说明 |
|——–|——|
| deepseek-v4-flash | V4 系列，默认推荐（节点默认选中） |
| deepseek-v4-pro | V4 系列 |
| deepseek-chat | 经典对话模型（官方日程中有下线计划，请以 DeepSeek 控制台 / 文档为准） |
| deepseek-reasoner | 推理向模型（同上） |

自定义 Base URL 时（私有化代理等），仍以远端返回的 /models 为准；静态列表仅作兜底。

—

思考模式（Thinking Mode）与 reasoning_content

DeepSeek 在开启思考能力后，会在响应中携带 reasoningcontent（思维链）；在多轮对话、尤其是 工具调用（function calling） 后再次请求时，官方要求把上一轮助手消息里的 reasoningcontent 原样带回，否则会报错（例如 400 The reasoning_content in the thinking mode must be passed back to the API）。

本节点在该场景下的处理要点：

1. 请求侧补齐
LangChain 在把历史 AIMessage 转成 API 的 messages 时，可能不把 additionalkwargs.reasoningcontent 写回请求体。本节点在调用底层 API 前会对 assistant 消息注入对应的 reasoningcontent，并与 toolcalls id 尽量对齐，满足 DeepSeek 思考模式协议。

2. 跨 n8n Engine 周期缓存（Tools Agent 关键）
n8n 在每轮工具执行后的 Engine Response 上会再次调用模型的 supplyData()，往往会 新建模型客户端实例。仅靠实例内缓存会在第二轮丢失 reasoning_content。本节点使用 进程级（模块级）LRU + TTL（默认 15 分钟） 缓存，按工具调用签名关联上一轮聚合到的推理文本，供下一轮注入兜底。

3. 流式聚合
在流式响应中按增量拼接 reasoningcontent，并在出现 finishreason / 流结束 时写入缓存（兼容「最后一帧 tool_calls 为空」等情况）。

4. 节点默认值与官方默认的差异
DeepSeek API 文档侧思考能力可能默认开启；本节点将 Thinking Mode 默认设为 Disabled，便于成本与延迟可控。需要推理时再在 Options → Thinking Mode 中选 Enabled。

必读官方文档：

• DeepSeek API 总览（中文）
• ，节点会在发往 API 前尽量规范化，减少调用被拒。

• Parallel Tool Calls

默认 关闭（paralleltoolcalls: false），降低单次响应触发大量并行工具、迅速耗尽 Tools Agent Max iterations 的概率；可按需打开。

• 代理

凭证支持配置 HTTP(S) 代理（实现依赖 undici ProxyAgent，与节点内请求逻辑一致）。

• JSON 响应格式

选择 JSON Object 时，请遵循各模型提供方要求在 prompt 中出现 json 等约束（节点内有简短 Notice）。

• Additional Model Arguments

支持 JSON 合并到模型请求参数（在 thinking / reasoningeffort / responseformat 之后浅层合并），便于跟进 DeepSeek 新字段。

—

Reasoning Effort（思考强度）

在 Thinking Mode = Enabled 下可选 Reasoning Effort（映射到 API 的 reasoning_effort）。节点当前 UI 提供 High / Max；文档若列出更多档位，可通过 Additional Model Arguments 覆盖或扩展（与 LangChain / DeepSeek 版本保持一致）。

—

安装

1. 在自有部署中启用 Community nodes（权限允许时）。
2. 在 n8n 使用的环境中安装：

   npm install n8n-nodes-deepseek-next
   

3. 或在本仓库执行 npm pack，将生成的 .tgz 上传到实例的 Community nodes 安装流程（与贵司运维方式一致即可）。

安装后在工作流中添加 「DeepSeek Chat Model (Next)」，并创建凭证 DeepSeek Next API（API Key；可选 Base URL、代理）。

—

凭证与环境

• API Key：DeepSeek 控制台发放的密钥。
• Base URL：默认为 https://api.deepseek.com（按需改为代理或兼容网关地址，不要多余末尾斜杠带来的路径歧义；节点内会做规范化）。
• Node.js：package.json 中 engines.node 要求 ≥ 22.16（与当前依赖与构建约定一致）。