fix: clear reference values in node debug (#6915)

* fix: clear reference values in node debug

* doc

* fix: align invalid condition input type

* fix: support boolean values in BoolSchema

* update lock

document/content/self-host/upgrading/4-15/41502.mdx

+---
+title: 'V4.15.0-beta2(进行中)'
+description: 'FastGPT V4.15.0-beta2 更新说明'
+---
+
+## 🚀 新增内容
+
+## ⚙️ 优化
+
+1. 优化 OTEL 日志采集格式。
+2. 增加 workflow zod 检查鲁棒性。
+
+## 🐛 修复
+
+1. 工作流，单节点调试，存在异常默认值。
+
+## 代码优化

document/content/self-host/upgrading/4-15/meta.en.json

 {
   "title": "4.15.x",
   "description": "",
-  "pages": ["4150"]
+    "pages": ["41502", "4150"]
 }

document/content/self-host/upgrading/4-15/meta.json

 {
   "title": "4.15.x",
   "description": "",
-  "pages": ["4150"]
+  "pages": ["41502", "4150"]
 }

document/content/toc.mdx

@@ -140,6 +140,7 @@ description: FastGPT 文档目录
 - [/self-host/upgrading/4-14/41481](/self-host/upgrading/4-14/41481)
 - [/self-host/upgrading/4-14/4149](/self-host/upgrading/4-14/4149)
 - [/self-host/upgrading/4-15/4150](/self-host/upgrading/4-15/4150)
+- [/self-host/upgrading/4-15/41502](/self-host/upgrading/4-15/41502)
 - [/self-host/upgrading/outdated/40](/self-host/upgrading/outdated/40)
 - [/self-host/upgrading/outdated/41](/self-host/upgrading/outdated/41)
 - [/self-host/upgrading/outdated/4100](/self-host/upgrading/outdated/4100)

document/data/doc-last-modified.json

@@ -271,7 +271,7 @@
   "content/self-host/upgrading/4-14/41481.mdx": "2026-04-26T21:08:47+08:00",
   "content/self-host/upgrading/4-14/4149.en.mdx": "2026-04-26T21:08:47+08:00",
   "content/self-host/upgrading/4-14/4149.mdx": "2026-04-26T21:08:47+08:00",
-  "content/self-host/upgrading/4-15/4150.mdx": "2026-05-09T14:27:39+08:00",
+  "content/self-host/upgrading/4-15/4150.mdx": "2026-05-09T16:13:01+08:00",
   "content/self-host/upgrading/outdated/40.en.mdx": "2026-04-26T21:08:47+08:00",
   "content/self-host/upgrading/outdated/40.mdx": "2026-04-26T21:08:47+08:00",
   "content/self-host/upgrading/outdated/41.en.mdx": "2026-04-26T21:08:47+08:00",

document/package.json

@@ -27,7 +27,7 @@
     "fumadocs-ui": "15.6.3",
     "gray-matter": "^4.0.3",
     "lucide-react": "^0.525.0",
-    "next": "^15.5.15",
+    "next": "^15.5.18",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-responsive": "^10.0.1",

packages/global/common/zod/index.ts

 import z from 'zod';
 import { stripUrlTrailingSlash } from '../string/url';
 
-const truthyBoolStrs = ['true', '1', 'yes', 'y'];
-export const BoolSchema = z
-  .string()
-  .transform((val) => truthyBoolStrs.includes(val.toLowerCase()))
-  .pipe(z.boolean());
+const truthyBoolStrs = ['true', '1', 'yes', 'y', 'on'];
+export const BoolSchema = z.preprocess((val) => {
+  if (typeof val === 'boolean') return val;
+
+  if (typeof val === 'string') {
+    return truthyBoolStrs.includes(val.trim().toLowerCase());
+  }
+
+  if (typeof val === 'number') {
+    if (val === 1) return true;
+    if (val === 0) return false;
+  }
+
+  return val;
+}, z.boolean());
 
 export const NumSchema = z.coerce.number<number>();
 export const IntSchema = NumSchema.int().nonnegative();

packages/global/core/workflow/type/io.ts

@@ -3,6 +3,7 @@ import { WorkflowIOValueTypeEnum, NodeInputKeyEnum, NodeOutputKeyEnum } from '..
 import { FlowNodeInputTypeEnum, FlowNodeOutputTypeEnum } from '../node/constant';
 import { SecretValueTypeSchema } from '../../../common/secret/type';
 import z from 'zod';
+import { BoolSchema, IntSchema, NumSchema } from '../../../common/zod';
 
 /* Dataset node */
 export const SelectedDatasetSchema = z.object({
@@ -19,9 +20,9 @@ export type SelectedDatasetType = z.infer<typeof SelectedDatasetSchema>;
 export const CustomFieldConfigTypeSchema = z.object({
   // reference
   selectValueTypeList: z.array(z.enum(WorkflowIOValueTypeEnum)).optional(), // 可以选哪个数据类型, 只有1个的话,则默认选择
-  showDefaultValue: z.boolean().optional(),
-  showDescription: z.boolean().optional(),
-  hideBottomDivider: z.boolean().optional()
+  showDefaultValue: BoolSchema.optional(),
+  showDescription: BoolSchema.optional(),
+  hideBottomDivider: BoolSchema.optional()
 });
 export type CustomFieldConfigType = z.infer<typeof CustomFieldConfigTypeSchema>;
 
@@ -30,15 +31,15 @@ export const InputComponentPropsTypeSchema = z.object({
   label: z.string(),
 
   valueType: z.enum(WorkflowIOValueTypeEnum).optional(),
-  required: z.boolean().optional(),
+  required: BoolSchema.optional(),
   defaultValue: z.any().optional(),
 
   // 不同组件的配置嘻嘻
   referencePlaceholder: z.string().optional(),
-  isRichText: z.boolean().optional(), // Prompt editor
+  isRichText: BoolSchema.optional(), // Prompt editor
   placeholder: z.string().optional(), // input,textarea
-  maxLength: z.number().optional(), // input,textarea
-  minLength: z.number().optional(), // password
+  maxLength: IntSchema.optional(), // input,textarea
+  minLength: IntSchema.optional(), // password
   list: z
     .array(
       z.object({
@@ -49,21 +50,21 @@ export const InputComponentPropsTypeSchema = z.object({
       })
     )
     .optional(), // select
-  markList: z.array(z.object({ label: z.string(), value: z.number() })).optional(), // slider
-  step: z.number().optional(), // slider
-  max: z.number().optional(), // slider, number input
-  min: z.number().optional(), // slider, number input
-  precision: z.number().optional(), // number input
-
-  canSelectFile: z.boolean().optional(), // file select
-  canSelectImg: z.boolean().optional(), // file select
-  canSelectVideo: z.boolean().optional(), // file select
-  canSelectAudio: z.boolean().optional(), // file select
-  canSelectCustomFileExtension: z.boolean().optional(), // file select
+  markList: z.array(z.object({ label: z.string(), value: NumSchema })).optional(), // slider
+  step: NumSchema.optional(), // slider
+  max: NumSchema.optional(), // slider, number input
+  min: NumSchema.optional(), // slider, number input
+  precision: NumSchema.optional(), // number input
+
+  canSelectFile: BoolSchema.optional(), // file select
+  canSelectImg: BoolSchema.optional(), // file select
+  canSelectVideo: BoolSchema.optional(), // file select
+  canSelectAudio: BoolSchema.optional(), // file select
+  canSelectCustomFileExtension: BoolSchema.optional(), // file select
   customFileExtensionList: z.array(z.string()).optional(), // file select
-  canLocalUpload: z.boolean().optional(), // file select
-  canUrlUpload: z.boolean().optional(), // file select
-  maxFiles: z.number().optional(), // file select
+  canLocalUpload: BoolSchema.optional(), // file select
+  canUrlUpload: BoolSchema.optional(), // file select
+  maxFiles: IntSchema.optional(), // file select
 
   // Time
   timeGranularity: z.enum(['day', 'hour', 'minute', 'second']).optional(), // time point select, time range select
@@ -86,7 +87,7 @@ export const InputConfigTypeSchema = z.object({
   key: z.string(),
   label: z.string(),
   description: z.string().optional(),
-  required: z.boolean().optional(),
+  required: BoolSchema.optional(),
   inputType: z.enum(['input', 'numberInput', 'secret', 'switch', 'select']),
   value: SecretValueTypeSchema.optional(),
 
@@ -97,7 +98,7 @@ export type InputConfigType = z.infer<typeof InputConfigTypeSchema>;
 
 // Workflow node input
 export const FlowNodeInputItemTypeSchema = InputComponentPropsTypeSchema.extend({
-  selectedTypeIndex: z.number().optional(),
+  selectedTypeIndex: IntSchema.optional(),
   renderTypeList: z.array(z.enum(FlowNodeInputTypeEnum)), // Node Type. Decide on a render style
   valueDesc: z.string().optional(), // data desc
   value: z.any().optional(),
@@ -111,11 +112,11 @@ export const FlowNodeInputItemTypeSchema = InputComponentPropsTypeSchema.extend(
   inputList: z.array(InputConfigTypeSchema).optional(), // when key === 'system_input_config', this field is used
 
   // render components params
-  canEdit: z.boolean().optional(), // dynamic inputs
-  isPro: z.boolean().optional(), // Pro version field
-  isToolOutput: z.boolean().optional(),
+  canEdit: BoolSchema.optional(), // dynamic inputs
+  isPro: BoolSchema.optional(), // Pro version field
+  isToolOutput: BoolSchema.optional(),
 
-  deprecated: z.boolean().optional() // node deprecated
+  deprecated: BoolSchema.optional() // node deprecated
 });
 export type FlowNodeInputItemType = z.infer<typeof FlowNodeInputItemTypeSchema>;
 
@@ -131,18 +132,18 @@ export const FlowNodeOutputItemTypeSchema = z.object({
   label: z.string().optional(),
   description: z.string().optional(),
   defaultValue: z.any().optional(),
-  required: z.boolean().optional(),
+  required: BoolSchema.optional(),
 
-  invalid: z.boolean().optional(),
+  invalid: BoolSchema.optional(),
   invalidCondition: z
     .function({
       input: z.tuple([
         z.object({
-          inputs: z.array(FlowNodeInputItemTypeSchema),
+          inputs: z.custom<FlowNodeInputItemType[]>(),
           llmModelMap: z.record(z.string(), LLMModelItemSchema)
         })
       ]),
-      output: z.boolean()
+      output: BoolSchema
     })
     .optional()
     .meta({
@@ -153,7 +154,7 @@ export const FlowNodeOutputItemTypeSchema = z.object({
     }),
 
   customFieldConfig: CustomFieldConfigTypeSchema.optional(),
-  deprecated: z.boolean().optional()
+  deprecated: BoolSchema.optional()
 });
 export type FlowNodeOutputItemType = z.infer<typeof FlowNodeOutputItemTypeSchema>;
 

packages/global/test/common/zod/index.test.ts

+import { describe, expect, it } from 'vitest';
+import { BoolSchema } from '@fastgpt/global/common/zod';
+import {
+  FlowNodeInputItemTypeSchema,
+  FlowNodeOutputItemTypeSchema
+} from '@fastgpt/global/core/workflow/type/io';
+import { WorkflowIOValueTypeEnum } from '@fastgpt/global/core/workflow/constants';
+import {
+  FlowNodeInputTypeEnum,
+  FlowNodeOutputTypeEnum
+} from '@fastgpt/global/core/workflow/node/constant';
+
+describe('BoolSchema', () => {
+  it('should accept boolean values directly', () => {
+    expect(BoolSchema.parse(true)).toBe(true);
+    expect(BoolSchema.parse(false)).toBe(false);
+  });
+
+  it('should convert common truthy string values to true', () => {
+    ['true', '1', 'yes', 'y', 'on', ' TRUE '].forEach((value) => {
+      expect(BoolSchema.parse(value)).toBe(true);
+    });
+  });
+
+  it('should convert other string values to false', () => {
+    ['false', '0', 'no', 'n', 'off', '', 'random'].forEach((value) => {
+      expect(BoolSchema.parse(value)).toBe(false);
+    });
+  });
+
+  it('should convert numeric 0 and 1 values', () => {
+    expect(BoolSchema.parse(1)).toBe(true);
+    expect(BoolSchema.parse(0)).toBe(false);
+    expect(BoolSchema.safeParse(2).success).toBe(false);
+  });
+
+  it('should keep workflow io boolean fields compatible with runtime objects', () => {
+    expect(
+      FlowNodeInputItemTypeSchema.parse({
+        key: 'input',
+        label: 'Input',
+        renderTypeList: [FlowNodeInputTypeEnum.input],
+        valueType: WorkflowIOValueTypeEnum.string,
+        required: true
+      }).required
+    ).toBe(true);
+
+    const output = FlowNodeOutputItemTypeSchema.parse({
+      id: 'output',
+      key: 'output',
+      type: FlowNodeOutputTypeEnum.static,
+      required: true,
+      invalid: false,
+      invalidCondition: () => true
+    });
+
+    expect(output.required).toBe(true);
+    expect(output.invalid).toBe(false);
+    expect(output.invalidCondition?.({ inputs: [], llmModelMap: {} })).toBe(true);
+  });
+});

pro @ 78d6cc12

-Subproject commit 91c9337cb64290f7fbaf68939545e432ddacbc7a
+Subproject commit 78d6cc129c75f2fc123b92f5016af5edb632ad14

projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/hooks/useDebug.tsx

@@ -6,7 +6,6 @@ import {
 } from '@fastgpt/global/core/workflow/type/edge';
 import { useCallback, useState, useMemo } from 'react';
 import { checkWorkflowNodeAndConnection } from '@/web/core/workflow/utils';
-import { useTranslation } from 'next-i18next';
 import { useToast } from '@fastgpt/web/hooks/useToast';
 import { uiWorkflow2StoreWorkflow } from '../../utils';
 import { type RuntimeNodeItemType } from '@fastgpt/global/core/workflow/runtime/type';
@@ -14,10 +13,7 @@ import { type RuntimeNodeItemType } from '@fastgpt/global/core/workflow/runtime/
 import dynamic from 'next/dynamic';
 import { Box, Button, Flex } from '@chakra-ui/react';
 import { type FieldErrors, useForm } from 'react-hook-form';
-import {
-  VariableInputEnum,
-  WorkflowIOValueTypeEnum
-} from '@fastgpt/global/core/workflow/constants';
+import { VariableInputEnum } from '@fastgpt/global/core/workflow/constants';
 import { checkInputIsReference } from '@fastgpt/global/core/workflow/utils';
 import { useContextSelector } from 'use-context-selector';
 import { FlowNodeTypeEnum } from '@fastgpt/global/core/workflow/node/constant';
@@ -30,9 +26,13 @@ import {
   variableInputTypeToInputType
 } from '@/components/core/app/formRender/utils';
 import { useSafeTranslation } from '@fastgpt/web/hooks/useSafeTranslation';
-import { WorkflowUtilsContext } from '../../context/workflowUtilsContext';
 import { WorkflowActionsContext } from '../../context/workflowActionsContext';
 import { WorkflowDebugContext } from '../../context/workflowDebugContext';
+import {
+  getDebugInputFormProps,
+  getDebugInputFormValue,
+  getDebugRuntimeInputs
+} from './useDebugInput';
 
 const MyRightDrawer = dynamic(
   () => import('@fastgpt/web/components/common/MyDrawer/MyRightDrawer')
@@ -159,15 +159,7 @@ export const useDebug = () => {
     const variablesForm = useForm<Record<string, any>>({
       defaultValues: {
         nodeVariables: renderInputs.reduce((acc: Record<string, any>, input) => {
-          const isReference = checkInputIsReference(input);
-          if (isReference) {
-            acc[input.key] = undefined;
-          } else if (typeof input.value === 'object') {
-            acc[input.key] = JSON.stringify(input.value, null, 2);
-          } else {
-            acc[input.key] = input.value;
-          }
-
+          acc[input.key] = getDebugInputFormValue(input);
           return acc;
         }, {}),
         variables: defaultGlobalVariables
@@ -188,27 +180,9 @@ export const useDebug = () => {
           node.nodeId === runtimeNode.nodeId
             ? {
                 ...runtimeNode,
-                inputs: runtimeNode.inputs.map((input) => {
-                  let parseValue = (() => {
-                    try {
-                      if (
-                        input.valueType === WorkflowIOValueTypeEnum.string ||
-                        input.valueType === WorkflowIOValueTypeEnum.number ||
-                        input.valueType === WorkflowIOValueTypeEnum.boolean
-                      ) {
-                        return data.nodeVariables[input.key];
-                      }
-
-                      return JSON.parse(data.nodeVariables[input.key]);
-                    } catch (e) {
-                      return data.nodeVariables[input.key];
-                    }
-                  })();
-
-                  return {
-                    ...input,
-                    value: parseValue ?? input.value
-                  };
+                inputs: getDebugRuntimeInputs({
+                  inputs: runtimeNode.inputs,
+                  nodeVariables: data.nodeVariables
                 })
               }
             : node
@@ -263,19 +237,23 @@ export const useDebug = () => {
             />
           )}
           <Box display={currentTab === TabEnum.node ? 'block' : 'none'}>
-            {renderInputs.map((item) => (
-              <LabelAndFormRender
-                {...item}
-                key={item.key}
-                label={item.label}
-                required={item.required}
-                description={t(item.placeholder || item.description)}
-                inputType={nodeInputTypeToInputType(item.renderTypeList)}
-                form={variablesForm}
-                fieldName={`nodeVariables.${item.key}`}
-                bg={'myGray.50'}
-              />
-            ))}
+            {renderInputs.map((item) => {
+              const inputProps = getDebugInputFormProps(item);
+
+              return (
+                <LabelAndFormRender
+                  {...inputProps}
+                  key={item.key}
+                  label={item.label}
+                  required={item.required}
+                  description={t(item.placeholder || item.description)}
+                  inputType={nodeInputTypeToInputType(item.renderTypeList)}
+                  form={variablesForm}
+                  fieldName={`nodeVariables.${item.key}`}
+                  bg={'myGray.50'}
+                />
+              );
+            })}
           </Box>
           <Box display={currentTab === TabEnum.global ? 'block' : 'none'}>
             {customVar.map((item) => (

projects/app/src/pageComponents/app/detail/WorkflowComponents/Flow/hooks/useDebugInput.ts

+import { WorkflowIOValueTypeEnum } from '@fastgpt/global/core/workflow/constants';
+import { checkInputIsReference } from '@fastgpt/global/core/workflow/utils';
+import type { FlowNodeInputItemType } from '@fastgpt/global/core/workflow/type/io';
+
+const primitiveValueTypes = new Set<WorkflowIOValueTypeEnum>([
+  WorkflowIOValueTypeEnum.string,
+  WorkflowIOValueTypeEnum.number,
+  WorkflowIOValueTypeEnum.boolean
+]);
+
+export const getDebugInputFormValue = (input: FlowNodeInputItemType) => {
+  if (checkInputIsReference(input)) return undefined;
+
+  const value = input.value ?? input.defaultValue;
+  if (typeof value === 'object' && value !== null) {
+    return JSON.stringify(value, null, 2);
+  }
+
+  return value;
+};
+
+export const getDebugInputFormProps = (input: FlowNodeInputItemType) => {
+  const props = { ...input };
+  delete props.value;
+  delete props.defaultValue;
+
+  return props;
+};
+
+const parseDebugInputFormValue = (input: FlowNodeInputItemType, value: any) => {
+  if (primitiveValueTypes.has(input.valueType as WorkflowIOValueTypeEnum)) {
+    return value;
+  }
+
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+};
+
+export const getDebugRuntimeInputs = ({
+  inputs,
+  nodeVariables = {}
+}: {
+  inputs: FlowNodeInputItemType[];
+  nodeVariables?: Record<string, any>;
+}) => {
+  return inputs.map((input) => {
+    if (!Object.prototype.hasOwnProperty.call(nodeVariables, input.key)) {
+      return input;
+    }
+
+    return {
+      ...input,
+      value: parseDebugInputFormValue(input, nodeVariables[input.key])
+    };
+  });
+};

projects/app/test/pageComponents/app/detail/WorkflowComponents/Flow/hooks/useDebugInput.test.ts

+import { describe, expect, it } from 'vitest';
+import { WorkflowIOValueTypeEnum } from '@fastgpt/global/core/workflow/constants';
+import { FlowNodeInputTypeEnum } from '@fastgpt/global/core/workflow/node/constant';
+import type { FlowNodeInputItemType } from '@fastgpt/global/core/workflow/type/io';
+import {
+  getDebugInputFormProps,
+  getDebugInputFormValue,
+  getDebugRuntimeInputs
+} from '@/pageComponents/app/detail/WorkflowComponents/Flow/hooks/useDebugInput';
+
+const makeInput = (input: Partial<FlowNodeInputItemType>): FlowNodeInputItemType => ({
+  key: 'input',
+  label: 'Input',
+  renderTypeList: [FlowNodeInputTypeEnum.input],
+  valueType: WorkflowIOValueTypeEnum.string,
+  ...input
+});
+
+describe('useDebugInput', () => {
+  it('should not use reference value as node debug form default value', () => {
+    const input = makeInput({
+      key: 'userChatInput',
+      renderTypeList: [FlowNodeInputTypeEnum.reference, FlowNodeInputTypeEnum.input],
+      selectedTypeIndex: 0,
+      value: [['workflowStart', 'userChatInput']]
+    });
+
+    expect(getDebugInputFormValue(input)).toBeUndefined();
+  });
+
+  it('should remove raw value props before rendering debug form fields', () => {
+    const input = makeInput({
+      value: [['workflowStart', 'userChatInput']],
+      defaultValue: 'default'
+    });
+
+    const props = getDebugInputFormProps(input);
+
+    expect(props).not.toHaveProperty('value');
+    expect(props).not.toHaveProperty('defaultValue');
+  });
+
+  it('should clear old reference value when a rendered debug field is submitted empty', () => {
+    const referenceInput = makeInput({
+      key: 'userChatInput',
+      renderTypeList: [FlowNodeInputTypeEnum.reference, FlowNodeInputTypeEnum.input],
+      selectedTypeIndex: 0,
+      value: [['workflowStart', 'userChatInput']]
+    });
+
+    const [updatedInput] = getDebugRuntimeInputs({
+      inputs: [referenceInput],
+      nodeVariables: {
+        userChatInput: undefined
+      }
+    });
+
+    expect(updatedInput.value).toBeUndefined();
+  });
+
+  it('should keep inputs that are not shown in the debug form unchanged', () => {
+    const hiddenInput = makeInput({
+      key: 'temperature',
+      valueType: WorkflowIOValueTypeEnum.number,
+      value: 0.7
+    });
+
+    const [updatedInput] = getDebugRuntimeInputs({
+      inputs: [hiddenInput],
+      nodeVariables: {}
+    });
+
+    expect(updatedInput).toBe(hiddenInput);
+  });
+
+  it('should parse json values from debug form', () => {
+    const objectInput = makeInput({
+      key: 'config',
+      valueType: WorkflowIOValueTypeEnum.object,
+      value: { old: true }
+    });
+
+    const [updatedInput] = getDebugRuntimeInputs({
+      inputs: [objectInput],
+      nodeVariables: {
+        config: '{"new":true}'
+      }
+    });
+
+    expect(updatedInput.value).toEqual({ new: true });
+  });
+});

projects/code-sandbox/package.json

@@ -28,7 +28,7 @@
     "crypto-js": "^4.2.0",
     "dayjs": "catalog:",
     "dotenv": "^17.3.1",
-    "hono": "^4.7.6",
+    "hono": "^4.12.18",
     "lodash": "catalog:",
     "moment": "^2.30.1",
     "qs": "^6.13.1",