feat: Add a new node empty-node

Author: wangliang181230

apps/application/flow/common.py

@@ -19,7 +19,7 @@
 from models_provider.tools import get_model_credential
 from tools.models.tool import Tool
 
-end_nodes = ['ai-chat-node', 'reply-node', 'function-node', 'function-lib-node', 'application-node',
+end_nodes = ['ai-chat-node', 'reply-node', 'empty-node', 'function-node', 'function-lib-node', 'application-node',
              'image-understand-node', 'speech-to-text-node', 'text-to-speech-node', 'image-generate-node',
              'variable-assign-node']
 

apps/application/flow/step_node/__init__.py

@@ -13,6 +13,7 @@
 from .data_source_web_node.impl.base_data_source_web_node import BaseDataSourceWebNode
 from .direct_reply_node import *
 from .document_extract_node import *
+from .empty_node import BaseEmptyNode
 from .form_node import *
 from .image_generate_step_node import *
 from .image_to_video_step_node import BaseImageToVideoNode
@@ -44,7 +45,7 @@
 from .tool_start_node import BaseToolStartStepNode
 
 node_list = [BaseStartStepNode, BaseChatNode, BaseSearchKnowledgeNode, BaseSearchDocumentNode, BaseQuestionNode,
-             BaseConditionNode, BaseReplyNode,
+             BaseConditionNode, BaseReplyNode, BaseEmptyNode,
              BaseToolNodeNode, BaseToolLibNodeNode, BaseRerankerNode, BaseApplicationNode,
              BaseDocumentExtractNode,
              BaseImageUnderstandNode, BaseFormNode, BaseSpeechToTextNode, BaseTextToSpeechNode,

apps/application/flow/step_node/empty_node/__init__.py

@@ -0,0 +1 @@
+from .impl import BaseEmptyNode

apps/application/flow/step_node/empty_node/i_empty_node.py

@@ -0,0 +1,39 @@
+# coding=utf-8
+"""
+    @project: MaxKB
+    @Author：AI Assistant
+    @file： i_empty_node.py
+    @date：2026/06/10
+    @desc: 空节点接口定义 - 用于流程判断的ELSE分支占位
+"""
+from typing import Type
+
+from rest_framework import serializers
+
+from application.flow.common import WorkflowMode
+from application.flow.i_step_node import INode, NodeResult
+
+
+class EmptyNodeParamsSerializer(serializers.Serializer):
+    """空节点参数序列化器 - 无需任何参数"""
+    
+    def is_valid(self, *, raise_exception=False):
+        # 空节点不需要验证任何参数，直接返回 True
+        return True
+
+
+class IEmptyNode(INode):
+    """空节点接口"""
+    type = 'empty-node'
+    support = [WorkflowMode.APPLICATION, WorkflowMode.APPLICATION_LOOP, WorkflowMode.KNOWLEDGE_LOOP,
+               WorkflowMode.KNOWLEDGE, WorkflowMode.TOOL, WorkflowMode.TOOL_LOOP]
+
+    def get_node_params_serializer_class(self) -> Type[serializers.Serializer]:
+        return EmptyNodeParamsSerializer
+
+    def _run(self):
+        return self.execute()
+
+    def execute(self, **kwargs) -> NodeResult:
+        """执行空节点 - 不产生任何输出"""
+        return NodeResult({}, {})

apps/application/flow/step_node/empty_node/impl/__init__.py

@@ -0,0 +1 @@
+from .base_empty_node import BaseEmptyNode

apps/application/flow/step_node/empty_node/impl/base_empty_node.py

@@ -0,0 +1,37 @@
+# coding=utf-8
+"""
+    @project: MaxKB
+    @Author：AI Assistant
+    @file： base_empty_node.py
+    @date：2026/06/10
+    @desc: 空节点实现 - 用于流程判断的ELSE分支占位
+"""
+from application.flow.i_step_node import NodeResult
+from application.flow.step_node.empty_node.i_empty_node import IEmptyNode
+
+
+class BaseEmptyNode(IEmptyNode):
+    """空节点实现类"""
+
+    def save_context(self, details, workflow_manage):
+        """保存上下文 - 空节点无需保存任何内容"""
+        self.context['exception_message'] = details.get('err_message')
+
+    def execute(self, **kwargs) -> NodeResult:
+        """
+        执行空节点
+        空节点不产生任何输出，仅作为流程占位符
+        """
+        return NodeResult({}, {})
+
+    def get_details(self, index: int, **kwargs):
+        """获取节点执行详情"""
+        return {
+            'name': self.node.properties.get('stepName'),
+            "index": index,
+            'run_time': self.context.get('run_time'),
+            'type': self.node.type,
+            'status': self.status,
+            'err_message': self.err_message,
+            'enableException': self.node.properties.get('enableException'),
+        }

ui/src/assets/workflow/icon_empty.svg

@@ -14,6 +14,7 @@ export enum WorkflowType {
   Question = 'question-node',
   Condition = 'condition-node',
   Reply = 'reply-node',
+  EmptyNode = 'empty-node',
   ToolLib = 'tool-lib-node',
   ToolWorkflowLib = 'tool-workflow-lib-node',
   ToolLibCustom = 'tool-node',

ui/src/enums/application.ts

@@ -243,6 +243,12 @@ You are a master of problem optimization, adept at accurately inferring user int
       text: 'Specify reply content, referenced variables will be converted to strings for output',
       replyContent: 'Reply Content',
     },
+    emptyNode: {
+      label: 'Empty Node',
+      text: 'No operation, used as a placeholder node in the workflow',
+      description: 'This is an empty node',
+      hint: 'Used when no action is needed',
+    },
     rerankerNode: {
       label: 'Multi-path Recall',
       text: 'Use a re-ranking model to refine retrieval results from multiple knowledge sources',

ui/src/locales/lang/en-US/workflow.ts

@@ -243,6 +243,12 @@ export default {
       text: '指定回复内容，引用变量会转换为字符串进行输出',
       replyContent: '回复内容',
     },
+    emptyNode: {
+      label: '空节点',
+      text: '不执行任何操作，仅作为流程占位节点使用',
+      description: '这是一个空节点',
+      hint: '当不需要执行任何操作时使用',
+    },
     rerankerNode: {
       label: '多路召回',
       text: '使用重排模型对多个知识库的检索结果进行二次召回',