From 49448e3f48a92052c39e4732eb1862e90fde11fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E8=89=AF?= <841369634@qq.com>
Date: Thu, 11 Jun 2026 10:42:27 +0800
Subject: [PATCH] feat: Add a new node `empty-node`

---
 apps/application/flow/common.py               |  2 +-
 apps/application/flow/step_node/__init__.py   |  3 +-
 .../flow/step_node/empty_node/__init__.py     |  1 +
 .../flow/step_node/empty_node/i_empty_node.py | 39 +++++++++++++++
 .../step_node/empty_node/impl/__init__.py     |  1 +
 .../empty_node/impl/base_empty_node.py        | 37 ++++++++++++++
 ui/src/assets/workflow/icon_empty.svg         |  4 ++
 .../execution-detail-card/index.vue           | 12 +++++
 ui/src/enums/application.ts                   |  1 +
 ui/src/locales/lang/en-US/workflow.ts         |  6 +++
 ui/src/locales/lang/zh-CN/workflow.ts         |  6 +++
 .../locales/lang/zh-Hant/views/application.ts |  2 +-
 ui/src/locales/lang/zh-Hant/workflow.ts       |  8 ++-
 ui/src/workflow/common/NodeContainer.vue      |  9 +++-
 ui/src/workflow/common/data.ts                | 27 +++++++---
 ui/src/workflow/common/validate.ts            |  2 +
 ui/src/workflow/icons/empty-node-icon.vue     |  6 +++
 ui/src/workflow/nodes/empty-node/index.ts     | 14 ++++++
 ui/src/workflow/nodes/empty-node/index.vue    | 49 +++++++++++++++++++
 19 files changed, 216 insertions(+), 13 deletions(-)
 create mode 100644 apps/application/flow/step_node/empty_node/__init__.py
 create mode 100644 apps/application/flow/step_node/empty_node/i_empty_node.py
 create mode 100644 apps/application/flow/step_node/empty_node/impl/__init__.py
 create mode 100644 apps/application/flow/step_node/empty_node/impl/base_empty_node.py
 create mode 100644 ui/src/assets/workflow/icon_empty.svg
 create mode 100644 ui/src/workflow/icons/empty-node-icon.vue
 create mode 100644 ui/src/workflow/nodes/empty-node/index.ts
 create mode 100644 ui/src/workflow/nodes/empty-node/index.vue

diff --git a/apps/application/flow/common.py b/apps/application/flow/common.py
index d7520cf690c..1b126435585 100644
--- a/apps/application/flow/common.py
+++ b/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']
 
diff --git a/apps/application/flow/step_node/__init__.py b/apps/application/flow/step_node/__init__.py
index 4c38020771e..b6951f8966e 100644
--- a/apps/application/flow/step_node/__init__.py
+++ b/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,
diff --git a/apps/application/flow/step_node/empty_node/__init__.py b/apps/application/flow/step_node/empty_node/__init__.py
new file mode 100644
index 00000000000..8fa7a380ddc
--- /dev/null
+++ b/apps/application/flow/step_node/empty_node/__init__.py
@@ -0,0 +1 @@
+from .impl import BaseEmptyNode
diff --git a/apps/application/flow/step_node/empty_node/i_empty_node.py b/apps/application/flow/step_node/empty_node/i_empty_node.py
new file mode 100644
index 00000000000..f94134ab4f5
--- /dev/null
+++ b/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({}, {})
diff --git a/apps/application/flow/step_node/empty_node/impl/__init__.py b/apps/application/flow/step_node/empty_node/impl/__init__.py
new file mode 100644
index 00000000000..5d5a92f400f
--- /dev/null
+++ b/apps/application/flow/step_node/empty_node/impl/__init__.py
@@ -0,0 +1 @@
+from .base_empty_node import BaseEmptyNode
diff --git a/apps/application/flow/step_node/empty_node/impl/base_empty_node.py b/apps/application/flow/step_node/empty_node/impl/base_empty_node.py
new file mode 100644
index 00000000000..b010d031015
--- /dev/null
+++ b/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'),
+        }
diff --git a/ui/src/assets/workflow/icon_empty.svg b/ui/src/assets/workflow/icon_empty.svg
new file mode 100644
index 00000000000..62b802097a0
--- /dev/null
+++ b/ui/src/assets/workflow/icon_empty.svg
@@ -0,0 +1,4 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect x="2" y="2" width="16" height="16" rx="3" stroke="#FFF" stroke-width="1.5" stroke-dasharray="2.5 2" fill="none"/>
+<circle cx="10" cy="10" r="3" stroke="#FFF" stroke-width="1.5" fill="none"/>
+</svg>
\ No newline at end of file
diff --git a/ui/src/components/execution-detail-card/index.vue b/ui/src/components/execution-detail-card/index.vue
index f163b40c7a3..f33042dd421 100644
--- a/ui/src/components/execution-detail-card/index.vue
+++ b/ui/src/components/execution-detail-card/index.vue
@@ -351,6 +351,18 @@
             </div>
           </template>
 
+          <!-- 空节点 -->
+          <template v-if="data.type === WorkflowType.EmptyNode">
+            <div class="card-never border-r-6">
+              <div class="p-8-12 lighter">
+                <div class="empty-node-info">
+                  <p class="mb-8">{{ $t('workflow.nodes.emptyNode.description') }}</p>
+                  <p class="lighter">{{ $t('workflow.nodes.emptyNode.text') }}</p>
+                </div>
+              </div>
+            </div>
+          </template>
+
           <!-- 文档内容提取 -->
           <template v-if="data.type === WorkflowType.DocumentExtractNode">
             <div class="card-never border-r-6">
diff --git a/ui/src/enums/application.ts b/ui/src/enums/application.ts
index 173a723e064..7a667ffaa79 100644
--- a/ui/src/enums/application.ts
+++ b/ui/src/enums/application.ts
@@ -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',
diff --git a/ui/src/locales/lang/en-US/workflow.ts b/ui/src/locales/lang/en-US/workflow.ts
index f322667c8a3..39eb526a755 100644
--- a/ui/src/locales/lang/en-US/workflow.ts
+++ b/ui/src/locales/lang/en-US/workflow.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',
diff --git a/ui/src/locales/lang/zh-CN/workflow.ts b/ui/src/locales/lang/zh-CN/workflow.ts
index 42cdf5a89f7..8708a39896f 100644
--- a/ui/src/locales/lang/zh-CN/workflow.ts
+++ b/ui/src/locales/lang/zh-CN/workflow.ts
@@ -243,6 +243,12 @@ export default {
       text: '指定回复内容，引用变量会转换为字符串进行输出',
       replyContent: '回复内容',
     },
+    emptyNode: {
+      label: '空节点',
+      text: '不执行任何操作，仅作为流程占位节点使用',
+      description: '这是一个空节点',
+      hint: '当不需要执行任何操作时使用',
+    },
     rerankerNode: {
       label: '多路召回',
       text: '使用重排模型对多个知识库的检索结果进行二次召回',
diff --git a/ui/src/locales/lang/zh-Hant/views/application.ts b/ui/src/locales/lang/zh-Hant/views/application.ts
index 988d0958593..4c2406c1687 100644
--- a/ui/src/locales/lang/zh-Hant/views/application.ts
+++ b/ui/src/locales/lang/zh-Hant/views/application.ts
@@ -129,7 +129,7 @@ export default {
     },
     reasoningContent: {
       label: '輸出思考',
-      tooltip: '請根據模型返回的思考標簽設置，標簽中間的內容將會認定爲思考過程',
+      tooltip: '請根據模型返回的思考標籤設置，標籤中間的內容將會認定爲思考過程',
       start: '開始',
       end: '結束',
     },
diff --git a/ui/src/locales/lang/zh-Hant/workflow.ts b/ui/src/locales/lang/zh-Hant/workflow.ts
index 6678d4536a7..e3b32abd64f 100644
--- a/ui/src/locales/lang/zh-Hant/workflow.ts
+++ b/ui/src/locales/lang/zh-Hant/workflow.ts
@@ -194,7 +194,7 @@ export default {
       custom: '手動',
       customTooltip: '手動設置標籤過濾條件',
       auto: '自動',
-      autoTooltip: '根據檢索問題自動匹配文檔標簽',
+      autoTooltip: '根據檢索問題自動匹配文檔標籤',
       documentList: '文檔列表',
       knowledgeList: '知識庫列表',
       result: '檢索結果',
@@ -243,6 +243,12 @@ export default {
       text: '指定回覆內容，引用變量會轉換為字符串進行輸出',
       replyContent: '回覆內容',
     },
+    emptyNode: {
+      label: '空節點',
+      text: '不執行任何操作，僅作爲流程佔位節點使用',
+      description: '這是一個空節點',
+      hint: '當不需要執行任何操作時使用',
+    },
     rerankerNode: {
       label: '多路召回',
       text: '使用重排模型對多個知識庫的檢索結果進行二次召回',
diff --git a/ui/src/workflow/common/NodeContainer.vue b/ui/src/workflow/common/NodeContainer.vue
index 162a678ff41..35619e2a498 100644
--- a/ui/src/workflow/common/NodeContainer.vue
+++ b/ui/src/workflow/common/NodeContainer.vue
@@ -13,7 +13,6 @@
             @drag.prevent
             @dragover.prevent
             @dragend.prevent
-            style="width: 69%"
           >
             <component
               :is="iconComponent(`${nodeModel.type}-icon`)"
@@ -28,7 +27,13 @@
             ></h4>
           </div>
 
-          <div @mousemove.stop @mousedown.stop @keydown.stop @click.stop>
+          <div
+            @mousemove.stop
+            @mousedown.stop
+            @keydown.stop
+            @click.stop
+            style="min-width: 85px; text-align: right"
+          >
             <el-button text @click="showNode = !showNode">
               <el-icon class="arrow-icon color-secondary" :class="showNode ? 'rotate-180' : ''"
                 ><ArrowDownBold />
diff --git a/ui/src/workflow/common/data.ts b/ui/src/workflow/common/data.ts
index 23fe80e60e2..b184a4a2e22 100644
--- a/ui/src/workflow/common/data.ts
+++ b/ui/src/workflow/common/data.ts
@@ -356,6 +356,18 @@ export const replyNode = {
     },
   },
 }
+export const emptyNode = {
+  type: WorkflowType.EmptyNode,
+  text: t('workflow.nodes.emptyNode.text'),
+  label: t('workflow.nodes.emptyNode.label'),
+  height: 150,
+  properties: {
+    stepName: t('workflow.nodes.emptyNode.label'),
+    config: {
+      fields: [],
+    },
+  },
+}
 export const rerankerNode = {
   type: WorkflowType.RerankerNode,
   text: t('workflow.nodes.rerankerNode.text'),
@@ -784,7 +796,6 @@ export const knowledgeMenuNodes = [
       questionNode,
     ],
   },
-
   {
     label: t('workflow.nodes.classify.businessLogic'),
     list: [conditionNode, replyNode, loopNode],
@@ -800,7 +811,7 @@ export const knowledgeMenuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 
@@ -839,7 +850,7 @@ export const menuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 export const applicationLoopMenuNodes = [
@@ -877,7 +888,7 @@ export const applicationLoopMenuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 export const knowledgeLoopMenuNodes = [
@@ -919,7 +930,7 @@ export const knowledgeLoopMenuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 export const toolLoopMenuNodes = [
@@ -961,7 +972,7 @@ export const toolLoopMenuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 const toolMenuNodes = [
@@ -1005,7 +1016,7 @@ const toolMenuNodes = [
   },
   {
     label: t('common.other'),
-    list: [mcpNode, toolNode],
+    list: [mcpNode, toolNode, emptyNode],
   },
 ]
 export const getMenuNodes = (workflowMode: WorkflowMode) => {
@@ -1152,6 +1163,7 @@ export const nodeDict: any = {
   [WorkflowType.Base]: baseNode,
   [WorkflowType.Start]: startNode,
   [WorkflowType.Reply]: replyNode,
+  [WorkflowType.EmptyNode]: emptyNode,
   [WorkflowType.ToolLib]: toolNode,
   [WorkflowType.ToolWorkflowLib]: toolWorkflowLibNode,
   [WorkflowType.ToolLibCustom]: toolNode,
@@ -1283,6 +1295,7 @@ const nodeLocaleBindings: Array<[any, string, string]> = [
   ],
   [conditionNode, 'workflow.nodes.conditionNode.text', 'workflow.nodes.conditionNode.label'],
   [replyNode, 'workflow.nodes.replyNode.text', 'workflow.nodes.replyNode.label'],
+  [emptyNode, 'workflow.nodes.emptyNode.text', 'workflow.nodes.emptyNode.label'],
   [rerankerNode, 'workflow.nodes.rerankerNode.text', 'workflow.nodes.rerankerNode.label'],
   [formNode, 'workflow.nodes.formNode.text', 'workflow.nodes.formNode.label'],
   [
diff --git a/ui/src/workflow/common/validate.ts b/ui/src/workflow/common/validate.ts
index 08c7f8935d8..5e5c0d48377 100644
--- a/ui/src/workflow/common/validate.ts
+++ b/ui/src/workflow/common/validate.ts
@@ -6,6 +6,7 @@ import { t } from '@/locales'
 const end_nodes: Array<string> = [
   WorkflowType.AiChat,
   WorkflowType.Reply,
+  WorkflowType.EmptyNode,
   WorkflowType.ToolLib,
   WorkflowType.ToolLibCustom,
   WorkflowType.ImageUnderstandNode,
@@ -27,6 +28,7 @@ const end_nodes: Array<string> = [
 const loop_end_nodes: Array<string> = [
   WorkflowType.AiChat,
   WorkflowType.Reply,
+  WorkflowType.EmptyNode,
   WorkflowType.ToolLib,
   WorkflowType.ToolLibCustom,
   WorkflowType.ImageUnderstandNode,
diff --git a/ui/src/workflow/icons/empty-node-icon.vue b/ui/src/workflow/icons/empty-node-icon.vue
new file mode 100644
index 00000000000..70b25f259df
--- /dev/null
+++ b/ui/src/workflow/icons/empty-node-icon.vue
@@ -0,0 +1,6 @@
+<template>
+  <el-avatar shape="square" style="background: #9CA3AF">
+    <img src="@/assets/workflow/icon_empty.svg" style="width: 75%" alt="" />
+  </el-avatar>
+</template>
+<script setup lang="ts"></script>
diff --git a/ui/src/workflow/nodes/empty-node/index.ts b/ui/src/workflow/nodes/empty-node/index.ts
new file mode 100644
index 00000000000..1a415e9f899
--- /dev/null
+++ b/ui/src/workflow/nodes/empty-node/index.ts
@@ -0,0 +1,14 @@
+import EmptyNodeVue from './index.vue'
+import { AppNode, AppNodeModel } from '@/workflow/common/app-node'
+
+class EmptyNode extends AppNode {
+  constructor(props: any) {
+    super(props, EmptyNodeVue)
+  }
+}
+
+export default {
+  type: 'empty-node',
+  model: AppNodeModel,
+  view: EmptyNode
+}
diff --git a/ui/src/workflow/nodes/empty-node/index.vue b/ui/src/workflow/nodes/empty-node/index.vue
new file mode 100644
index 00000000000..b6292a26dab
--- /dev/null
+++ b/ui/src/workflow/nodes/empty-node/index.vue
@@ -0,0 +1,49 @@
+<template>
+  <NodeContainer :nodeModel="nodeModel">
+    <el-card shadow="never" class="card-never" style="--el-card-padding: 12px">
+      <div class="empty-node-content">
+        <p class="empty-text">{{ $t('workflow.nodes.emptyNode.description') }}</p>
+        <p class="empty-hint">{{ $t('workflow.nodes.emptyNode.hint') }}</p>
+      </div>
+    </el-card>
+  </NodeContainer>
+</template>
+
+<script setup lang="ts">
+import { set } from 'lodash'
+import NodeContainer from '@/workflow/common/NodeContainer.vue'
+import { onMounted } from 'vue'
+
+const props = defineProps<{ nodeModel: any }>()
+
+const validate = () => {
+  return Promise.resolve()
+}
+
+onMounted(() => {
+  set(props.nodeModel, 'validate', validate)
+})
+</script>
+
+<style lang="scss" scoped>
+.empty-node-content {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 10px;
+  text-align: center;
+
+  .empty-text {
+    font-size: 14px;
+    color: #606266;
+    margin: 0 0 8px 0;
+  }
+
+  .empty-hint {
+    font-size: 13px;
+    color: #909399;
+    margin: 0;
+  }
+}
+</style>