【backup】feat: Add a new node empty-node as a placeholder node

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/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">

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',

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',

ui/src/locales/lang/zh-CN/workflow.ts

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

ui/src/locales/lang/zh-Hant/views/application.ts

@@ -129,7 +129,7 @@ export default {
     },
     reasoningContent: {
       label: '輸出思考',
-      tooltip: '請根據模型返回的思考標簽設置，標簽中間的內容將會認定爲思考過程',
+      tooltip: '請根據模型返回的思考標籤設置，標籤中間的內容將會認定爲思考過程',
       start: '開始',
       end: '結束',
     },

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: '使用重排模型對多個知識庫的檢索結果進行二次召回',

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 />

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'],
   [

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,

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>

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
+}