perf: chunk trigger and paragraph split (#4893)

* perf: chunk trigger and paragraph split * update max size computed * perf: i18n * remove table
2025-07-22 12:20:34 +00:00 · 2025-05-26 18:57:22 +08:00
parent 874300a56a
commit c25cd48e72
23 changed files with 859 additions and 164 deletions
--- a/docSite/content/zh-cn/docs/development/upgrading/4910.md
+++ b/docSite/content/zh-cn/docs/development/upgrading/4910.md
@@ -11,9 +11,11 @@ weight: 790
 ## 🚀 新增内容

 1. 支持 PG 设置`systemEnv.hnswMaxScanTuples`参数，提高迭代搜索的数据总量。
-2. 工作流调整为单向接入和接出，支持快速的添加下一步节点。
-3. 开放飞书和语雀知识库到开源版。
-4. gemini 和 claude 最新模型预设。
+2. 知识库预处理参数增加 “分块条件”，可控制某些情况下不进行分块处理。
+3. 知识库预处理参数增加 “段落优先” 模式，可控制最大段落深度。原“长度优先”模式，不再内嵌段落优先逻辑。
+4. 工作流调整为单向接入和接出，支持快速的添加下一步节点。
+5. 开放飞书和语雀知识库到开源版。
+6. gemini 和 claude 最新模型预设。

 ## ⚙️ 优化

@@ -31,4 +33,5 @@ weight: 790
 3. 工具调用模式，未保存思考输出。
 4. 知识库 indexSize 参数未生效。
 5. 工作流嵌套 2 层后，获取预览引用、上下文不正确。
-6. xlsx 转成 Markdown 时候，前面会多出一个空格。
+6. xlsx 转成 Markdown 时候，前面会多出一个空格。
+7. 读取 Markdown 文件时，Base64 图片未进行额外抓换保存。
--- a/packages/global/common/string/textSplitter.ts
+++ b/packages/global/common/string/textSplitter.ts
@@ -7,6 +7,10 @@ export const CUSTOM_SPLIT_SIGN = '-----CUSTOM_SPLIT_SIGN-----';
 type SplitProps = {
  text: string;
  chunkSize: number;
+
+  paragraphChunkDeep?: number; // Paragraph deep
+  paragraphChunkMinSize?: number; // Paragraph min size, if too small, it will merge
+
  maxSize?: number;
  overlapRatio?: number;
  customReg?: string[];
@@ -108,6 +112,8 @@ const commonSplit = (props: SplitProps): SplitResponse => {
  let {
    text = '',
    chunkSize,
+    paragraphChunkDeep = 5,
+    paragraphChunkMinSize = 100,
    maxSize = defaultMaxChunkSize,
    overlapRatio = 0.15,
    customReg = []
@@ -123,7 +129,7 @@ const commonSplit = (props: SplitProps): SplitResponse => {
  text = text.replace(/(```[\s\S]*?```|~~~[\s\S]*?~~~)/g, function (match) {
    return match.replace(/\n/g, codeBlockMarker);
  });
-  // 2. 表格处理 - 单独提取表格出来，进行表头合并
+  // 2. Markdown 表格处理 - 单独提取表格出来，进行表头合并
  const tableReg =
    /(\n\|(?:(?:[^\n|]+\|){1,})\n\|(?:[:\-\s]+\|){1,}\n(?:\|(?:[^\n|]+\|)*\n?)*)(?:\n|$)/g;
  const tableDataList = text.match(tableReg);
@@ -143,25 +149,40 @@ const commonSplit = (props: SplitProps): SplitResponse => {
  text = text.replace(/(\r?\n|\r){3,}/g, '\n\n\n');

  // The larger maxLen is, the next sentence is less likely to trigger splitting
-  const markdownIndex = 4;
-  const forbidOverlapIndex = 8;
+  const customRegLen = customReg.length;
+  const markdownIndex = paragraphChunkDeep - 1;
+  const forbidOverlapIndex = customRegLen + markdownIndex + 4;
+
+  const markdownHeaderRules = ((deep?: number): { reg: RegExp; maxLen: number }[] => {
+    if (!deep || deep === 0) return [];
+
+    const maxDeep = Math.min(deep, 8); // Maximum 8 levels
+    const rules: { reg: RegExp; maxLen: number }[] = [];
+
+    for (let i = 1; i <= maxDeep; i++) {
+      const hashSymbols = '#'.repeat(i);
+      rules.push({
+        reg: new RegExp(`^(${hashSymbols}\\s[^\\n]+\\n)`, 'gm'),
+        maxLen: chunkSize
+      });
+    }
+
+    return rules;
+  })(paragraphChunkDeep);

  const stepReges: { reg: RegExp | string; maxLen: number }[] = [
    ...customReg.map((text) => ({
      reg: text.replaceAll('\\n', '\n'),
      maxLen: chunkSize
    })),
-    { reg: /^(#\s[^\n]+\n)/gm, maxLen: chunkSize },
-    { reg: /^(##\s[^\n]+\n)/gm, maxLen: chunkSize },
-    { reg: /^(###\s[^\n]+\n)/gm, maxLen: chunkSize },
-    { reg: /^(####\s[^\n]+\n)/gm, maxLen: chunkSize },
-    { reg: /^(#####\s[^\n]+\n)/gm, maxLen: chunkSize },
+    ...markdownHeaderRules,

    { reg: /([\n](```[\s\S]*?```|~~~[\s\S]*?~~~))/g, maxLen: maxSize }, // code block
+    // HTML Table tag 尽可能保障完整
    {
      reg: /(\n\|(?:(?:[^\n|]+\|){1,})\n\|(?:[:\-\s]+\|){1,}\n(?:\|(?:[^\n|]+\|)*\n)*)/g,
-      maxLen: Math.min(chunkSize * 1.5, maxSize)
-    }, // Table 尽可能保证完整性
+      maxLen: chunkSize
+    }, // Markdown Table 尽可能保证完整性
    { reg: /(\n{2,})/g, maxLen: chunkSize },
    { reg: /([\n])/g, maxLen: chunkSize },
    // ------ There's no overlap on the top
@@ -172,12 +193,10 @@ const commonSplit = (props: SplitProps): SplitResponse => {
    { reg: /([，]|,\s)/g, maxLen: chunkSize }
  ];

-  const customRegLen = customReg.length;
  const checkIsCustomStep = (step: number) => step < customRegLen;
  const checkIsMarkdownSplit = (step: number) =>
    step >= customRegLen && step <= markdownIndex + customRegLen;
-
-  const checkForbidOverlap = (step: number) => step <= forbidOverlapIndex + customRegLen;
+  const checkForbidOverlap = (step: number) => step <= forbidOverlapIndex;

  // if use markdown title split, Separate record title
  const getSplitTexts = ({ text, step }: { text: string; step: number }) => {
@@ -301,6 +320,7 @@ const commonSplit = (props: SplitProps): SplitResponse => {
    const splitTexts = getSplitTexts({ text, step });

    const chunks: string[] = [];
+
    for (let i = 0; i < splitTexts.length; i++) {
      const item = splitTexts[i];

@@ -443,7 +463,6 @@ const commonSplit = (props: SplitProps): SplitResponse => {
 */
 export const splitText2Chunks = (props: SplitProps): SplitResponse => {
  let { text = '' } = props;
-  const start = Date.now();
  const splitWithCustomSign = text.split(CUSTOM_SPLIT_SIGN);

  const splitResult = splitWithCustomSign.map((item) => {
--- a/packages/global/core/dataset/training/utils.ts
+++ b/packages/global/core/dataset/training/utils.ts
@@ -120,7 +120,6 @@ export const computeChunkSize = (params: {

  return Math.min(params.chunkSize ?? chunkAutoChunkSize, getLLMMaxChunkSize(params.llmModel));
 };
-
 export const computeChunkSplitter = (params: {
  chunkSettingMode?: ChunkSettingModeEnum;
  chunkSplitMode?: DataChunkSplitModeEnum;
@@ -129,8 +128,21 @@ export const computeChunkSplitter = (params: {
  if (params.chunkSettingMode === ChunkSettingModeEnum.auto) {
    return undefined;
  }
-  if (params.chunkSplitMode === DataChunkSplitModeEnum.size) {
+  if (params.chunkSplitMode !== DataChunkSplitModeEnum.char) {
    return undefined;
  }
  return params.chunkSplitter;
 };
+export const computeParagraphChunkDeep = (params: {
+  chunkSettingMode?: ChunkSettingModeEnum;
+  chunkSplitMode?: DataChunkSplitModeEnum;
+  paragraphChunkDeep?: number;
+}) => {
+  if (params.chunkSettingMode === ChunkSettingModeEnum.auto) {
+    return 5;
+  }
+  if (params.chunkSplitMode === DataChunkSplitModeEnum.paragraph) {
+    return params.paragraphChunkDeep;
+  }
+  return 0;
+};
--- a/packages/global/core/dataset/type.d.ts
+++ b/packages/global/core/dataset/type.d.ts
@@ -9,7 +9,8 @@ import type {
  DatasetTypeEnum,
  SearchScoreTypeEnum,
  TrainingModeEnum,
-  ChunkSettingModeEnum
+  ChunkSettingModeEnum,
+  ChunkTriggerConfigTypeEnum
 } from './constants';
 import type { DatasetPermission } from '../../support/permission/dataset/controller';
 import type { APIFileServer, FeishuServer, YuqueServer } from './apiDataset';
@@ -37,11 +38,10 @@ export type ChunkSettingsType = {
  paragraphChunkAIMode?: ParagraphChunkAIModeEnum;
  paragraphChunkDeep?: number; // Paragraph deep
  paragraphChunkMinSize?: number; // Paragraph min size, if too small, it will merge
-  paragraphChunkMaxSize?: number; // Paragraph max size, if too large, it will split
  // Size split
-  chunkSize?: number;
+  chunkSize?: number; // chunk/qa chunk size, Paragraph max chunk size.
  // Char split
-  chunkSplitter?: string;
+  chunkSplitter?: string; // chunk/qa chunk splitter
  indexSize?: number;

  qaPrompt?: string;
--- a/packages/service/core/dataset/collection/controller.ts
+++ b/packages/service/core/dataset/collection/controller.ts
@@ -34,6 +34,7 @@ import { getTrainingModeByCollection } from './utils';
 import {
  computeChunkSize,
  computeChunkSplitter,
+  computeParagraphChunkDeep,
  getLLMMaxChunkSize
 } from '@fastgpt/global/core/dataset/training/utils';
 import { DatasetDataIndexTypeEnum } from '@fastgpt/global/core/dataset/data/constants';
@@ -74,6 +75,8 @@ export const createCollectionAndInsertData = async ({
    llmModel: getLLMModel(dataset.agentModel)
  });
  const chunkSplitter = computeChunkSplitter(createCollectionParams);
+  const paragraphChunkDeep = computeParagraphChunkDeep(createCollectionParams);
+
  if (trainingType === DatasetCollectionDataProcessModeEnum.qa) {
    delete createCollectionParams.chunkTriggerType;
    delete createCollectionParams.chunkTriggerMinSize;
@@ -87,7 +90,11 @@ export const createCollectionAndInsertData = async ({
  // 1. split chunks
  const chunks = rawText2Chunks({
    rawText,
+    chunkTriggerType: createCollectionParams.chunkTriggerType,
+    chunkTriggerMinSize: createCollectionParams.chunkTriggerMinSize,
    chunkSize,
+    paragraphChunkDeep,
+    paragraphChunkMinSize: createCollectionParams.paragraphChunkMinSize,
    maxSize: getLLMMaxChunkSize(getLLMModel(dataset.agentModel)),
    overlapRatio: trainingType === DatasetCollectionDataProcessModeEnum.chunk ? 0.2 : 0,
    customReg: chunkSplitter ? [chunkSplitter] : [],
@@ -112,6 +119,7 @@ export const createCollectionAndInsertData = async ({
    const { _id: collectionId } = await createOneCollection({
      ...createCollectionParams,
      trainingType,
+      paragraphChunkDeep,
      chunkSize,
      chunkSplitter,

@@ -212,46 +220,19 @@ export type CreateOneCollectionParams = CreateDatasetCollectionParams & {
  tmbId: string;
  session?: ClientSession;
 };
-export async function createOneCollection({
-  teamId,
-  tmbId,
-  name,
-  parentId,
-  datasetId,
-  type,
+export async function createOneCollection({ session, ...props }: CreateOneCollectionParams) {
+  const {
+    teamId,
+    parentId,
+    datasetId,
+    tags,

-  createTime,
-  updateTime,
-
-  hashRawText,
-  rawTextLength,
-  metadata = {},
-  tags,
-
-  nextSyncTime,
-
-  fileId,
-  rawLink,
-  externalFileId,
-  externalFileUrl,
-  apiFileId,
-
-  // Parse settings
-  customPdfParse,
-  imageIndex,
-  autoIndexes,
-
-  // Chunk settings
-  trainingType,
-  chunkSettingMode,
-  chunkSplitMode,
-  chunkSize,
-  indexSize,
-  chunkSplitter,
-  qaPrompt,
-
-  session
-}: CreateOneCollectionParams) {
+    fileId,
+    rawLink,
+    externalFileId,
+    externalFileUrl,
+    apiFileId
+  } = props;
  // Create collection tags
  const collectionTags = await createOrGetCollectionTags({ tags, teamId, datasetId, session });

@@ -259,41 +240,18 @@ export async function createOneCollection({
  const [collection] = await MongoDatasetCollection.create(
    [
      {
+        ...props,
        teamId,
-        tmbId,
        parentId: parentId || null,
        datasetId,
-        name,
-        type,

-        rawTextLength,
-        hashRawText,
        tags: collectionTags,
-        metadata,
-
-        createTime,
-        updateTime,
-        nextSyncTime,

        ...(fileId ? { fileId } : {}),
        ...(rawLink ? { rawLink } : {}),
        ...(externalFileId ? { externalFileId } : {}),
        ...(externalFileUrl ? { externalFileUrl } : {}),
-        ...(apiFileId ? { apiFileId } : {}),
-
-        // Parse settings
-        customPdfParse,
-        imageIndex,
-        autoIndexes,
-
-        // Chunk settings
-        trainingType,
-        chunkSettingMode,
-        chunkSplitMode,
-        chunkSize,
-        indexSize,
-        chunkSplitter,
-        qaPrompt
+        ...(apiFileId ? { apiFileId } : {})
      }
    ],
    { session, ordered: true }
--- a/packages/service/core/dataset/read.ts
+++ b/packages/service/core/dataset/read.ts
@@ -1,5 +1,8 @@
 import { BucketNameEnum } from '@fastgpt/global/common/file/constants';
-import { DatasetSourceReadTypeEnum } from '@fastgpt/global/core/dataset/constants';
+import {
+  ChunkTriggerConfigTypeEnum,
+  DatasetSourceReadTypeEnum
+} from '@fastgpt/global/core/dataset/constants';
 import { readFileContentFromMongo } from '../../common/file/gridfs/controller';
 import { urlsFetch } from '../../common/string/cheerio';
 import { type TextSplitProps, splitText2Chunks } from '@fastgpt/global/common/string/textSplitter';
@@ -179,11 +182,17 @@ export const readApiServerFileContent = async ({

 export const rawText2Chunks = ({
  rawText,
+  chunkTriggerType = ChunkTriggerConfigTypeEnum.minSize,
+  chunkTriggerMinSize = 1000,
  backupParse,
  chunkSize = 512,
  ...splitProps
 }: {
  rawText: string;
+
+  chunkTriggerType?: ChunkTriggerConfigTypeEnum;
+  chunkTriggerMinSize?: number; // maxSize from agent model, not store
+
  backupParse?: boolean;
  tableParse?: boolean;
 } & TextSplitProps): {
@@ -209,6 +218,28 @@ export const rawText2Chunks = ({
    };
  };

+  // Chunk condition
+  // 1. 选择最大值条件，只有超过了最大值(默认为模型的最大值*0.7），才会触发分块
+  if (chunkTriggerType === ChunkTriggerConfigTypeEnum.maxSize) {
+    const textLength = rawText.trim().length;
+    const maxSize = splitProps.maxSize ? splitProps.maxSize * 0.7 : 16000;
+    if (textLength < maxSize) {
+      return [
+        {
+          q: rawText,
+          a: ''
+        }
+      ];
+    }
+  }
+  // 2. 选择最小值条件，只有超过最小值(手动决定)才会触发分块
+  if (chunkTriggerType !== ChunkTriggerConfigTypeEnum.forceChunk) {
+    const textLength = rawText.trim().length;
+    if (textLength < chunkTriggerMinSize) {
+      return [{ q: rawText, a: '' }];
+    }
+  }
+
  if (backupParse) {
    return parseDatasetBackup2Chunks(rawText).chunks;
  }
--- a/packages/service/core/dataset/schema.ts
+++ b/packages/service/core/dataset/schema.ts
@@ -47,7 +47,6 @@ export const ChunkSettings = {
  },
  paragraphChunkDeep: Number,
  paragraphChunkMinSize: Number,
-  paragraphChunkMaxSize: Number,
  chunkSize: Number,
  chunkSplitter: String,

--- a/packages/service/core/dataset/search/controller.ts
+++ b/packages/service/core/dataset/search/controller.ts
@@ -658,7 +658,7 @@ export async function searchDatasetData(
        tokenLen: 0
      };
    } catch (error) {
-      addLog.error('multiQueryRecall error', error);
+      addLog.error('Full text search error', error);
      return {
        fullTextRecallResults: [],
        tokenLen: 0
--- a/packages/service/worker/readFile/extension/rawText.ts
+++ b/packages/service/worker/readFile/extension/rawText.ts
@@ -1,5 +1,6 @@
 import iconv from 'iconv-lite';
 import { type ReadRawTextByBuffer, type ReadFileResponse } from '../type';
+import { matchMdImg } from '@fastgpt/global/common/string/markdown';

 const rawEncodingList = [
  'ascii',
@@ -34,7 +35,10 @@ export const readFileRawText = ({ buffer, encoding }: ReadRawTextByBuffer): Read
    }
  })();

+  const { text, imageList } = matchMdImg(content);
+
  return {
-    rawText: content
+    rawText: text,
+    imageList
  };
 };
--- a/packages/web/components/common/Radio/RadioGroup.tsx
+++ b/packages/web/components/common/Radio/RadioGroup.tsx
@@ -54,7 +54,7 @@ const RadioGroup = <T = any,>({ list, value, onChange, ...props }: Props<T>) =>
              />
            </Flex>
          </Box>
-          <HStack spacing={1} color={'myGray.900'} whiteSpace={'nowrap'} fontSize={'sm'}>
+          <HStack spacing={0.5} color={'myGray.900'} whiteSpace={'nowrap'} fontSize={'sm'}>
            <Box>{typeof item.title === 'string' ? t(item.title as any) : item.title}</Box>
            {!!item.tooltip && <QuestionTip label={item.tooltip} color={'myGray.600'} />}
          </HStack>
--- a/packages/web/i18n/en/dataset.json
+++ b/packages/web/i18n/en/dataset.json
@@ -15,7 +15,13 @@
  "backup_dataset_tip": "You can reimport the downloaded csv file when exporting the knowledge base.",
  "backup_mode": "Backup import",
  "chunk_max_tokens": "max_tokens",
+  "chunk_process_params": "Block processing parameters",
  "chunk_size": "Block size",
+  "chunk_trigger": "Blocking conditions",
+  "chunk_trigger_force_chunk": "Forced chunking",
+  "chunk_trigger_max_size": "The original text length is less than the maximum context 70% of the file processing model",
+  "chunk_trigger_min_size": "The original text is greater than",
+  "chunk_trigger_tips": "Block storage is triggered when certain conditions are met, otherwise the original text will be stored in full directly",
  "close_auto_sync": "Are you sure you want to turn off automatic sync?",
  "collection.Create update time": "Creation/Update Time",
  "collection.Training type": "Training",
@@ -29,6 +35,7 @@
  "collection_tags": "Collection Tags",
  "common_dataset": "General Dataset",
  "common_dataset_desc": "Building a knowledge base by importing files, web page links, or manual entry",
+  "condition": "condition",
  "config_sync_schedule": "Configure scheduled synchronization",
  "confirm_to_rebuild_embedding_tip": "Are you sure you want to switch the index for the Dataset?\nSwitching the index is a significant operation that requires re-indexing all data in your Dataset, which may take a long time. Please ensure your account has sufficient remaining points.\n\nAdditionally, you need to update the applications that use this Dataset to avoid conflicts with other indexed model Datasets.",
  "core.dataset.import.Adjust parameters": "Adjust parameters",
@@ -100,6 +107,7 @@
  "is_open_schedule": "Enable scheduled synchronization",
  "keep_image": "Keep the picture",
  "loading": "Loading...",
+  "max_chunk_size": "Maximum chunk size",
  "move.hint": "After moving, the selected knowledge base/folder will inherit the permission settings of the new folder, and the original permission settings will become invalid.",
  "noChildren": "No subdirectories",
  "noSelectedFolder": "No selected folder",
@@ -107,8 +115,10 @@
  "noValidId": "No valid ID",
  "open_auto_sync": "After scheduled synchronization is turned on, the system will try to synchronize the collection from time to time every day. During the collection synchronization period, the collection data will not be searched.",
  "other_dataset": "Third-party knowledge base",
+  "paragraph_max_deep": "Maximum paragraph depth",
+  "paragraph_split": "Partition by paragraph",
+  "paragraph_split_tip": "Priority is given to chunking according to the Makdown title paragraph. If the chunking is too long, then chunking is done according to the length.",
  "params_config": "Config",
-  "params_setting": "Parameter settings",
  "pdf_enhance_parse": "PDF enhancement analysis",
  "pdf_enhance_parse_price": "{{price}} points/page",
  "pdf_enhance_parse_tips": "Calling PDF recognition model for parsing, you can convert it into Markdown and retain pictures in the document. At the same time, you can also identify scanned documents, which will take a long time to identify them.",
--- a/packages/web/i18n/zh-CN/common.json
+++ b/packages/web/i18n/zh-CN/common.json
@@ -554,7 +554,7 @@
  "core.dataset.training.Agent queue": "QA 训练排队",
  "core.dataset.training.Auto mode": "补充索引",
  "core.dataset.training.Auto mode Tip": "通过子索引以及调用模型生成相关问题与摘要，来增加数据块的语义丰富度，更利于检索。需要消耗更多的存储空间和增加 AI 调用次数。",
-  "core.dataset.training.Chunk mode": "直接分块",
+  "core.dataset.training.Chunk mode": "分块存储",
  "core.dataset.training.Full": "预计 20 分钟以上",
  "core.dataset.training.Leisure": "空闲",
  "core.dataset.training.QA mode": "问答对提取",
--- a/packages/web/i18n/zh-CN/dataset.json
+++ b/packages/web/i18n/zh-CN/dataset.json
@@ -15,7 +15,13 @@
  "backup_dataset_tip": "可以将导出知识库时，下载的 csv 文件重新导入。",
  "backup_mode": "备份导入",
  "chunk_max_tokens": "分块上限",
+  "chunk_process_params": "分块处理参数",
  "chunk_size": "分块大小",
+  "chunk_trigger": "分块条件",
+  "chunk_trigger_force_chunk": "强制分块",
+  "chunk_trigger_max_size": "原文长度小于文件处理模型最大上下文70%",
+  "chunk_trigger_min_size": "原文长度大于",
+  "chunk_trigger_tips": "当满足一定条件时才触发分块存储，否则会直接完整存储原文",
  "close_auto_sync": "确认关闭自动同步功能？",
  "collection.Create update time": "创建/更新时间",
  "collection.Training type": "训练模式",
@@ -29,6 +35,7 @@
  "collection_tags": "集合标签",
  "common_dataset": "通用知识库",
  "common_dataset_desc": "通过导入文件、网页链接或手动录入形式构建知识库",
+  "condition": "条件",
  "config_sync_schedule": "配置定时同步",
  "confirm_to_rebuild_embedding_tip": "确认为知识库切换索引？\n切换索引是一个非常重量的操作，需要对您知识库内所有数据进行重新索引，时间可能较长，请确保账号内剩余积分充足。\n\n此外，你还需要注意修改选择该知识库的应用，避免它们与其他索引模型知识库混用。",
  "core.dataset.import.Adjust parameters": "调整参数",
@@ -100,6 +107,7 @@
  "is_open_schedule": "启用定时同步",
  "keep_image": "保留图片",
  "loading": "加载中...",
+  "max_chunk_size": "最大分块大小",
  "move.hint": "移动后，所选知识库/文件夹将继承新文件夹的权限设置，原先的权限设置失效。",
  "noChildren": "无子目录",
  "noSelectedFolder": "没有选择文件夹",
@@ -107,8 +115,10 @@
  "noValidId": "没有有效的 ID",
  "open_auto_sync": "开启定时同步后，系统将会每天不定时尝试同步集合，集合同步期间，会出现无法搜索到该集合数据现象。",
  "other_dataset": "第三方知识库",
+  "paragraph_max_deep": "最大段落深度",
+  "paragraph_split": "按段落分块",
+  "paragraph_split_tip": "优先按 Makdown 标题段落进行分块，如果分块过长，再按长度进行二次分块",
  "params_config": "配置",
-  "params_setting": "参数设置",
  "pdf_enhance_parse": "PDF增强解析",
  "pdf_enhance_parse_price": "{{price}}积分/页",
  "pdf_enhance_parse_tips": "调用 PDF 识别模型进行解析，可以将其转换成 Markdown 并保留文档中的图片，同时也可以对扫描件进行识别，识别时间较长。",
--- a/packages/web/i18n/zh-Hant/common.json
+++ b/packages/web/i18n/zh-Hant/common.json
@@ -554,7 +554,7 @@
  "core.dataset.training.Agent queue": "問答訓練排隊中",
  "core.dataset.training.Auto mode": "補充索引",
  "core.dataset.training.Auto mode Tip": "透過子索引以及呼叫模型產生相關問題與摘要，來增加資料區塊的語意豐富度，更有利於檢索。需要消耗更多的儲存空間並增加 AI 呼叫次數。",
-  "core.dataset.training.Chunk mode": "直接分塊",
+  "core.dataset.training.Chunk mode": "分塊存儲",
  "core.dataset.training.Full": "預計 20 分鐘以上",
  "core.dataset.training.Leisure": "閒置",
  "core.dataset.training.QA mode": "問答對提取",
--- a/packages/web/i18n/zh-Hant/dataset.json
+++ b/packages/web/i18n/zh-Hant/dataset.json
@@ -14,7 +14,12 @@
  "backup_dataset_tip": "可以將導出知識庫時，下載的 csv 文件重新導入。",
  "backup_mode": "備份導入",
  "chunk_max_tokens": "分塊上限",
+  "chunk_process_params": "分塊處理參數",
  "chunk_size": "分塊大小",
+  "chunk_trigger": "分塊條件",
+  "chunk_trigger_force_chunk": "強制分塊",
+  "chunk_trigger_max_size": "原文長度小於文件處理模型最大上下文 70%",
+  "chunk_trigger_min_size": "原文長度大於",
  "close_auto_sync": "確認關閉自動同步功能？",
  "collection.Create update time": "建立／更新時間",
  "collection.Training type": "分段模式",
@@ -28,6 +33,7 @@
  "collection_tags": "集合標籤",
  "common_dataset": "通用資料集",
  "common_dataset_desc": "通過導入文件、網頁鏈接或手動錄入形式構建知識庫",
+  "condition": "條件",
  "config_sync_schedule": "設定定時同步",
  "confirm_to_rebuild_embedding_tip": "確定要為資料集切換索引嗎？\n切換索引是一個重要的操作，需要對您資料集內所有資料重新建立索引，可能需要較長時間，請確保帳號內剩餘點數充足。\n\n此外，您還需要注意修改使用此資料集的應用程式，避免與其他索引模型資料集混用。",
  "core.dataset.import.Adjust parameters": "調整參數",
@@ -99,6 +105,7 @@
  "is_open_schedule": "啟用定時同步",
  "keep_image": "保留圖片",
  "loading": "加載中...",
+  "max_chunk_size": "最大分塊大小",
  "move.hint": "移動後，所選資料集／資料夾將繼承新資料夾的權限設定，原先的權限設定將失效。",
  "noChildren": "無子目錄",
  "noSelectedFolder": "沒有選擇文件夾",
@@ -106,8 +113,10 @@
  "noValidId": "沒有有效的 ID",
  "open_auto_sync": "開啟定時同步後，系統將每天不定時嘗試同步集合，集合同步期間，會出現無法搜尋到該集合資料現象。",
  "other_dataset": "第三方知識庫",
+  "paragraph_max_deep": "最大段落深度",
+  "paragraph_split": "按段落分塊",
+  "paragraph_split_tip": "優先按 Makdown 標題段落進行分塊，如果分塊過長，再按長度進行二次分塊",
  "params_config": "設定",
-  "params_setting": "參數設定",
  "pdf_enhance_parse": "PDF 增強解析",
  "pdf_enhance_parse_price": "{{price}}積分/頁",
  "pdf_enhance_parse_tips": "呼叫 PDF 識別模型進行解析，可以將其轉換成 Markdown 並保留文件中的圖片，同時也可以對掃描件進行識別，識別時間較長。",
--- a/projects/app/src/pageComponents/dataset/detail/CollectionCard/WebsiteConfig.tsx
+++ b/projects/app/src/pageComponents/dataset/detail/CollectionCard/WebsiteConfig.tsx
@@ -100,8 +100,6 @@ const WebsiteConfigModal = ({
      paragraphChunkDeep: chunkSettings?.paragraphChunkDeep || defaultFormData.paragraphChunkDeep,
      paragraphChunkMinSize:
        chunkSettings?.paragraphChunkMinSize || defaultFormData.paragraphChunkMinSize,
-      paragraphChunkMaxSize:
-        chunkSettings?.paragraphChunkMaxSize || defaultFormData.paragraphChunkMaxSize,

      chunkSize: chunkSettings?.chunkSize || defaultFormData.chunkSize,

--- a/projects/app/src/pageComponents/dataset/detail/Form/CollectionChunkForm.tsx
+++ b/projects/app/src/pageComponents/dataset/detail/Form/CollectionChunkForm.tsx
@@ -17,10 +17,8 @@ import {
 } from '@chakra-ui/react';
 import MyIcon from '@fastgpt/web/components/common/Icon';
 import LeftRadio from '@fastgpt/web/components/common/Radio/LeftRadio';
-import type {
-  ChunkTriggerConfigTypeEnum,
-  ParagraphChunkAIModeEnum
-} from '@fastgpt/global/core/dataset/constants';
+import type { ParagraphChunkAIModeEnum } from '@fastgpt/global/core/dataset/constants';
+import { ChunkTriggerConfigTypeEnum } from '@fastgpt/global/core/dataset/constants';
 import {
  DataChunkSplitModeEnum,
  DatasetCollectionDataProcessModeEnum,
@@ -108,7 +106,6 @@ export type CollectionChunkFormType = {
  paragraphChunkAIMode: ParagraphChunkAIModeEnum;
  paragraphChunkDeep: number; // Paragraph deep
  paragraphChunkMinSize: number; // Paragraph min size, if too small, it will merge
-  paragraphChunkMaxSize: number; // Paragraph max size, if too large, it will split
  // Size split
  chunkSize: number;
  // Char split
@@ -130,6 +127,7 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
  const { setValue, register, watch, getValues } = form;

  const trainingType = watch('trainingType');
+  const chunkTriggerType = watch('chunkTriggerType');
  const chunkSettingMode = watch('chunkSettingMode');
  const chunkSplitMode = watch('chunkSplitMode');
  const autoIndexes = watch('autoIndexes');
@@ -151,6 +149,14 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
    }));
  }, [t]);

+  // Chunk trigger
+  const chunkTriggerSelectList = [
+    { label: t('dataset:chunk_trigger_min_size'), value: ChunkTriggerConfigTypeEnum.minSize },
+    { label: t('dataset:chunk_trigger_max_size'), value: ChunkTriggerConfigTypeEnum.maxSize },
+    { label: t('dataset:chunk_trigger_force_chunk'), value: ChunkTriggerConfigTypeEnum.forceChunk }
+  ];
+
+  // Form max or min value
  const {
    maxChunkSize,
    minChunkSize: minChunkSizeValue,
@@ -189,14 +195,11 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
    { label: '=====', value: '=====' },
    { label: t('dataset:split_sign_custom'), value: 'Other' }
  ];
-  const [customListSelectValue, setCustomListSelectValue] = useState(getValues('chunkSplitter'));
-  useEffect(() => {
-    if (customListSelectValue === 'Other') {
-      setValue('chunkSplitter', '');
-    } else {
-      setValue('chunkSplitter', customListSelectValue);
-    }
-  }, [customListSelectValue, setValue]);
+  const [customListSelectValue, setCustomListSelectValue] = useState(
+    customSplitList.some((item) => item.value === getValues('chunkSplitter'))
+      ? getValues('chunkSplitter')
+      : 'Other'
+  );

  // Index size
  const indexSizeSeletorList = useMemo(() => getIndexSizeSelectList(maxIndexSize), [maxIndexSize]);
@@ -243,6 +246,41 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
          gridTemplateColumns={'repeat(2, 1fr)'}
        />
      </Box>
+
+      {trainingType === DatasetCollectionDataProcessModeEnum.chunk && (
+        <Box mt={6}>
+          <HStack fontSize={'sm'} mb={2} color={'myGray.600'} spacing={1}>
+            <Box>{t('dataset:chunk_trigger')}</Box>
+            <QuestionTip label={t('dataset:chunk_trigger_tips')} />
+          </HStack>
+          <HStack>
+            <Box flex={'1 0 0'} h={'34px'}>
+              <MySelect
+                borderRadius={'md'}
+                list={chunkTriggerSelectList}
+                value={chunkTriggerType}
+                onChange={(e) => {
+                  setValue('chunkTriggerType', e);
+                }}
+              />
+            </Box>
+            {chunkTriggerType === ChunkTriggerConfigTypeEnum.minSize && (
+              <Box flex={'1 0 0'}>
+                <MyNumberInput
+                  h={'34px'}
+                  bg={'white'}
+                  min={100}
+                  max={100000}
+                  register={register}
+                  name={'chunkTriggerMinSize'}
+                  step={100}
+                />
+              </Box>
+            )}
+          </HStack>
+        </Box>
+      )}
+
      {trainingType === DatasetCollectionDataProcessModeEnum.chunk &&
        feConfigs?.show_dataset_enhance !== false && (
          <Box mt={6}>
@@ -287,7 +325,7 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
        )}
      <Box mt={6}>
        <Box fontSize={'sm'} mb={2} color={'myGray.600'}>
-          {t('dataset:params_setting')}
+          {t('dataset:chunk_process_params')}
        </Box>
        <LeftRadio<ChunkSettingModeEnum>
          list={[
@@ -305,6 +343,11 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
                  <Box>
                    <RadioGroup<DataChunkSplitModeEnum>
                      list={[
+                        {
+                          title: t('dataset:paragraph_split'),
+                          value: DataChunkSplitModeEnum.paragraph,
+                          tooltip: t('dataset:paragraph_split_tip')
+                        },
                        {
                          title: t('dataset:split_chunk_size'),
                          value: DataChunkSplitModeEnum.size
@@ -321,30 +364,76 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
                      }}
                    />

-                    {chunkSplitMode === DataChunkSplitModeEnum.size && (
-                      <Box
-                        mt={1.5}
-                        css={{
-                          '& > span': {
-                            display: 'block'
-                          }
-                        }}
-                      >
-                        <MyTooltip
-                          label={t('common:core.dataset.import.Chunk Range', {
-                            min: minChunkSizeValue,
-                            max: maxChunkSize
-                          })}
-                        >
+                    {chunkSplitMode === DataChunkSplitModeEnum.paragraph && (
+                      <>
+                        <Box mt={1.5}>
+                          <Box>{t('dataset:paragraph_max_deep')}</Box>
                          <MyNumberInput
-                            register={register}
-                            name={'chunkSize'}
-                            min={minChunkSizeValue}
-                            max={maxChunkSize}
                            size={'sm'}
-                            step={100}
+                            bg={'myGray.50'}
+                            register={register}
+                            name={'paragraphChunkDeep'}
+                            min={1}
+                            max={8}
+                            step={1}
+                            h={'32px'}
                          />
-                        </MyTooltip>
+                        </Box>
+                        <Box mt={1.5}>
+                          <Box>{t('dataset:max_chunk_size')}</Box>
+                          <Box
+                            css={{
+                              '& > span': {
+                                display: 'block'
+                              }
+                            }}
+                          >
+                            <MyTooltip
+                              label={t('common:core.dataset.import.Chunk Range', {
+                                min: minChunkSizeValue,
+                                max: maxChunkSize
+                              })}
+                            >
+                              <MyNumberInput
+                                register={register}
+                                name={'chunkSize'}
+                                min={minChunkSizeValue}
+                                max={maxChunkSize}
+                                size={'sm'}
+                                step={100}
+                              />
+                            </MyTooltip>
+                          </Box>
+                        </Box>
+                      </>
+                    )}
+
+                    {chunkSplitMode === DataChunkSplitModeEnum.size && (
+                      <Box mt={1.5}>
+                        <Box>{t('dataset:chunk_size')}</Box>
+                        <Box
+                          css={{
+                            '& > span': {
+                              display: 'block'
+                            }
+                          }}
+                        >
+                          <MyTooltip
+                            label={t('common:core.dataset.import.Chunk Range', {
+                              min: minChunkSizeValue,
+                              max: maxChunkSize
+                            })}
+                          >
+                            <MyNumberInput
+                              register={register}
+                              name={'chunkSize'}
+                              min={minChunkSizeValue}
+                              max={maxChunkSize}
+                              size={'sm'}
+                              step={100}
+                            />
+                          </MyTooltip>
+                        </Box>
                      </Box>
                    )}

@@ -358,6 +447,11 @@ const CollectionChunkForm = ({ form }: { form: UseFormReturn<CollectionChunkForm
                            value={customListSelectValue}
                            h={'32px'}
                            onChange={(val) => {
+                              if (val === 'Other') {
+                                setValue('chunkSplitter', '');
+                              } else {
+                                setValue('chunkSplitter', val);
+                              }
                              setCustomListSelectValue(val);
                            }}
                          />
--- a/projects/app/src/pageComponents/dataset/detail/Import/Context.tsx
+++ b/projects/app/src/pageComponents/dataset/detail/Import/Context.tsx
@@ -51,11 +51,10 @@ export const defaultFormData: ImportFormType = {
  autoIndexes: false,

  chunkSettingMode: ChunkSettingModeEnum.auto,
-  chunkSplitMode: DataChunkSplitModeEnum.size,
+  chunkSplitMode: DataChunkSplitModeEnum.paragraph,
  paragraphChunkAIMode: ParagraphChunkAIModeEnum.auto,
-  paragraphChunkDeep: 4,
+  paragraphChunkDeep: 5,
  paragraphChunkMinSize: 100,
-  paragraphChunkMaxSize: chunkAutoChunkSize,

  chunkSize: chunkAutoChunkSize,
  chunkSplitter: '',
--- a/projects/app/src/pageComponents/dataset/detail/Import/diffSource/ReTraining.tsx
+++ b/projects/app/src/pageComponents/dataset/detail/Import/diffSource/ReTraining.tsx
@@ -8,10 +8,8 @@ import { useRouter } from 'next/router';
 import { useRequest2 } from '@fastgpt/web/hooks/useRequest';
 import { getDatasetCollectionById } from '@/web/core/dataset/api';
 import MyBox from '@fastgpt/web/components/common/MyBox';
-import { ChunkSettingModeEnum } from '@fastgpt/global/core/dataset/constants';
 import { getCollectionIcon } from '@fastgpt/global/core/dataset/utils';
 import { Box } from '@chakra-ui/react';
-import { DataChunkSplitModeEnum } from '@fastgpt/global/core/dataset/constants';
 import { Prompt_AgentQA } from '@fastgpt/global/core/ai/prompt/agent';

 const Upload = dynamic(() => import('../commonProgress/Upload'));
@@ -68,8 +66,6 @@ const ReTraining = () => {
        paragraphChunkDeep: collection.paragraphChunkDeep || defaultFormData.paragraphChunkDeep,
        paragraphChunkMinSize:
          collection.paragraphChunkMinSize || defaultFormData.paragraphChunkMinSize,
-        paragraphChunkMaxSize:
-          collection.paragraphChunkMaxSize || defaultFormData.paragraphChunkMaxSize,

        chunkSize: collection.chunkSize || defaultFormData.chunkSize,

@@ -85,11 +81,13 @@ const ReTraining = () => {

  return (
    <MyBox isLoading={loading} h={'100%'}>
-      <Box h={'100%'} overflow={'auto'}>
-        {activeStep === 0 && <DataProcess />}
-        {activeStep === 1 && <PreviewData />}
-        {activeStep === 2 && <Upload />}
-      </Box>
+      {!loading && (
+        <Box h={'100%'} overflow={'auto'}>
+          {activeStep === 0 && <DataProcess />}
+          {activeStep === 1 && <PreviewData />}
+          {activeStep === 2 && <Upload />}
+        </Box>
+      )}
    </MyBox>
  );
 };
--- a/projects/app/src/pages/api/core/dataset/file/getPreviewChunks.ts
+++ b/projects/app/src/pages/api/core/dataset/file/getPreviewChunks.ts
@@ -1,7 +1,6 @@
 import {
-  type ChunkSettingModeEnum,
-  type DataChunkSplitModeEnum,
-  type DatasetCollectionDataProcessModeEnum
+  ChunkSettingModeEnum,
+  DatasetCollectionDataProcessModeEnum
 } from '@fastgpt/global/core/dataset/constants';
 import { DatasetSourceReadTypeEnum } from '@fastgpt/global/core/dataset/constants';
 import { rawText2Chunks, readDatasetSourceRawText } from '@fastgpt/service/core/dataset/read';
@@ -16,25 +15,21 @@ import { authDataset } from '@fastgpt/service/support/permission/dataset/auth';
 import {
  computeChunkSize,
  computeChunkSplitter,
+  computeParagraphChunkDeep,
  getLLMMaxChunkSize
 } from '@fastgpt/global/core/dataset/training/utils';
 import { CommonErrEnum } from '@fastgpt/global/common/error/code/common';
 import { getLLMModel } from '@fastgpt/service/core/ai/model';
+import type { ChunkSettingsType } from '@fastgpt/global/core/dataset/type';

-export type PostPreviewFilesChunksProps = {
+export type PostPreviewFilesChunksProps = ChunkSettingsType & {
  datasetId: string;
  type: DatasetSourceReadTypeEnum;
  sourceId: string;

  customPdfParse?: boolean;

-  trainingType: DatasetCollectionDataProcessModeEnum;
-
  // Chunk settings
-  chunkSettingMode: ChunkSettingModeEnum;
-  chunkSplitMode: DataChunkSplitModeEnum;
-  chunkSize: number;
-  chunkSplitter?: string;
  overlapRatio: number;

  // Read params
@@ -57,9 +52,15 @@ async function handler(
    sourceId,
    customPdfParse = false,

-    trainingType,
-    chunkSettingMode,
+    trainingType = DatasetCollectionDataProcessModeEnum.chunk,
+
+    chunkTriggerType,
+    chunkTriggerMinSize,
+
+    chunkSettingMode = ChunkSettingModeEnum.auto,
    chunkSplitMode,
+    paragraphChunkDeep,
+    paragraphChunkMinSize,
    chunkSize,
    chunkSplitter,

@@ -103,12 +104,16 @@ async function handler(
    chunkSize,
    llmModel: getLLMModel(dataset.agentModel)
  });
-
  chunkSplitter = computeChunkSplitter({
    chunkSettingMode,
    chunkSplitMode,
    chunkSplitter
  });
+  paragraphChunkDeep = computeParagraphChunkDeep({
+    chunkSettingMode,
+    chunkSplitMode,
+    paragraphChunkDeep
+  });

  const { rawText } = await readDatasetSourceRawText({
    teamId,
@@ -125,7 +130,11 @@ async function handler(

  const chunks = rawText2Chunks({
    rawText,
+    chunkTriggerType,
+    chunkTriggerMinSize,
    chunkSize,
+    paragraphChunkDeep,
+    paragraphChunkMinSize,
    maxSize: getLLMMaxChunkSize(getLLMModel(dataset.agentModel)),
    overlapRatio,
    customReg: chunkSplitter ? [chunkSplitter] : []
--- a/projects/app/src/web/core/dataset/api.ts
+++ b/projects/app/src/web/core/dataset/api.ts
@@ -16,7 +16,6 @@ import type {
  ApiDatasetCreateDatasetCollectionParams,
  CreateDatasetCollectionParams,
  CreateDatasetCollectionTagParams,
-  CsvTableCreateDatasetCollectionParams,
  DatasetUpdateBody,
  ExternalFileCreateDatasetCollectionParams,
  FileIdCreateDatasetCollectionParams,
--- a/test/cases/function/packages/global/common/string/textSplitter.test.ts
+++ b/test/cases/function/packages/global/common/string/textSplitter.test.ts
@@ -1,5 +1,6 @@
 import { it, expect } from 'vitest'; // 必须显式导入
 import { splitText2Chunks } from '@fastgpt/global/common/string/textSplitter';
+import fs from 'fs';

 const simpleChunks = (chunks: string[]) => {
  return chunks.map((chunk) => chunk.replace(/\s+/g, ''));
@@ -634,9 +635,83 @@ it(`Test splitText2Chunks 9`, () => {
 | 10012 | 杨一 | 34 | 程序员 | 厦门 |
 `,
    result: [
-      '测试的呀,第一个表格\n\n| 序号 | 姓名 | 年龄 | 职业 | 城市 |\n| --- | --- | --- | --- | --- |\n| 1 | 张三 | 25 | 工程师 | 北京 |\n| 2 | 李四 | 30 | 教师 | 上海 |\n| 3 | 王五 | 28 | 医生 | 广州 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 4 | 赵六 | 35 | 律师 | 深圳 |\n| 5 | 孙七 | 27 | 设计师 | 杭州 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 7 | 吴九 | 29 | 销售 | 武汉 |\n| 8 | 郑十 | 31 | 记者 | 南京 |\n| 9 | 刘一 | 33 | 建筑师 | 天津 |\n| 10 | 陈二 | 26 | 程序员 | 重庆 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1001 | 杨一 | 34 | 程序员 | 厦门 |\n| 1002 | 杨二 | 34 | 程序员 | 厦门 |\n| 1003 | 杨三 | 34 | 程序员 | 厦门 |',
-      '| 序号 | 姓名 | 年龄 | 职业 | 城市 |\n| --- | --- | --- | --- | --- |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 1004 | 杨四 | 34 | 程序员 | 厦门 |\n| 1005 | 杨五 | 34 | 程序员 | 厦门 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 9 | 刘一 | 33 | 建筑师 | 天津 |\n| 10 | 陈二 | 26 | 程序员 | 重庆 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1001 | 杨一 | 34 | 程序员 | 厦门 |\n| 1002 | 杨二 | 34 | 程序员 | 厦门 |\n| 1003 | 杨三 | 34 | 程序员 | 厦门 |\n| 1004 | 杨四 | 34 | 程序员 | 厦门 |\n| 1005 | 杨五 | 34 | 程序员 | 厦门 |\n\n| 序号 | 姓名 | 年龄 | 职业 | 城市 |\n| --- | --- | --- | --- | --- |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |\n| 1000 | 黄末 | 28 | 作家 | 厦门 |',
-      '这是第二段了，第二表格\n\n| 序号 | 姓名 | 年龄 | 职业 | 城市 |\n| --- | --- | --- | --- | --- |\n| 1 | 张三 | 25 | 工程师 | 北京 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 2 | 李四 | 30 | 教师 | 上海 |\n| 3 | 王五 | 28 | 医生 | 广州 |\n| 4 | 赵六 | 35 | 律师 | 深圳 |\n| 5 | 孙七 | 27 | 设计师 | 杭州 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 7 | 吴九 | 29 | 销售 | 武汉 |\n| 8 | 郑十 | 31 | 记者 | 南京 |\n| 9 | 刘一 | 33 | 建筑师 | 天津 |\n| 10 | 陈二 | 26 | 程序员 | 重庆 |\n| 10004 | 黄末 | 28 | 作家 | 厦门 |\n| 10013 | 杨一 | 34 | 程序员 | 厦门 |\n\n\n结束了\n\n| 序号22 | 姓名 | 年龄 | 职业 | 城市 |\n| --- | --- | --- | --- | --- |\n| 1 | 张三 | 25 | 工程师 | 北京 |\n| 2 | 李四 | 30 | 教师 | 上海 |\n| 3 | 王五 | 28 | 医生 | 广州 |\n| 4 | 赵六 | 35 | 律师 | 深圳 |\n| 5 | 孙七 | 27 | 设计师 | 杭州 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 6 | 周八 | 32 | 会计 | 成都 |\n| 7 | 吴九 | 29 | 销售 | 武汉 |\n| 8 | 郑十 | 31 | 记者 | 南京 |\n| 9 | 刘一 | 33 | 建筑师 | 天津 |\n| 10 | 陈二 | 26 | 程序员 | 重庆 |\n| 10002 | 黄末 | 28 | 作家 | 厦门 |\n| 10012 | 杨一 | 34 | 程序员 | 厦门 |'
+      `测试的呀,第一个表格
+
+| 序号 | 姓名 | 年龄 | 职业 | 城市 |
+| --- | --- | --- | --- | --- |
+| 1 | 张三 | 25 | 工程师 | 北京 |
+| 2 | 李四 | 30 | 教师 | 上海 |
+| 3 | 王五 | 28 | 医生 | 广州 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 4 | 赵六 | 35 | 律师 | 深圳 |
+| 5 | 孙七 | 27 | 设计师 | 杭州 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 7 | 吴九 | 29 | 销售 | 武汉 |
+| 8 | 郑十 | 31 | 记者 | 南京 |
+| 9 | 刘一 | 33 | 建筑师 | 天津 |
+| 10 | 陈二 | 26 | 程序员 | 重庆 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1001 | 杨一 | 34 | 程序员 | 厦门 |
+| 1002 | 杨二 | 34 | 程序员 | 厦门 |
+| 1003 | 杨三 | 34 | 程序员 | 厦门 |`,
+      `| 序号 | 姓名 | 年龄 | 职业 | 城市 |
+| --- | --- | --- | --- | --- |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 1004 | 杨四 | 34 | 程序员 | 厦门 |
+| 1005 | 杨五 | 34 | 程序员 | 厦门 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 9 | 刘一 | 33 | 建筑师 | 天津 |
+| 10 | 陈二 | 26 | 程序员 | 重庆 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1001 | 杨一 | 34 | 程序员 | 厦门 |
+| 1002 | 杨二 | 34 | 程序员 | 厦门 |
+| 1003 | 杨三 | 34 | 程序员 | 厦门 |
+| 1004 | 杨四 | 34 | 程序员 | 厦门 |
+| 1005 | 杨五 | 34 | 程序员 | 厦门 |`,
+      `| 序号 | 姓名 | 年龄 | 职业 | 城市 |
+| --- | --- | --- | --- | --- |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+| 1000 | 黄末 | 28 | 作家 | 厦门 |
+
+这是第二段了，第二表格
+
+| 序号 | 姓名 | 年龄 | 职业 | 城市 |
+| --- | --- | --- | --- | --- |
+| 1 | 张三 | 25 | 工程师 | 北京 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 2 | 李四 | 30 | 教师 | 上海 |
+| 3 | 王五 | 28 | 医生 | 广州 |
+| 4 | 赵六 | 35 | 律师 | 深圳 |
+| 5 | 孙七 | 27 | 设计师 | 杭州 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 7 | 吴九 | 29 | 销售 | 武汉 |
+| 8 | 郑十 | 31 | 记者 | 南京 |
+| 9 | 刘一 | 33 | 建筑师 | 天津 |
+| 10 | 陈二 | 26 | 程序员 | 重庆 |
+| 10004 | 黄末 | 28 | 作家 | 厦门 |
+| 10013 | 杨一 | 34 | 程序员 | 厦门 |`,
+      `结束了
+
+| 序号22 | 姓名 | 年龄 | 职业 | 城市 |
+| --- | --- | --- | --- | --- |
+| 1 | 张三 | 25 | 工程师 | 北京 |
+| 2 | 李四 | 30 | 教师 | 上海 |
+| 3 | 王五 | 28 | 医生 | 广州 |
+| 4 | 赵六 | 35 | 律师 | 深圳 |
+| 5 | 孙七 | 27 | 设计师 | 杭州 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 6 | 周八 | 32 | 会计 | 成都 |
+| 7 | 吴九 | 29 | 销售 | 武汉 |
+| 8 | 郑十 | 31 | 记者 | 南京 |
+| 9 | 刘一 | 33 | 建筑师 | 天津 |
+| 10 | 陈二 | 26 | 程序员 | 重庆 |
+| 10002 | 黄末 | 28 | 作家 | 厦门 |
+| 10012 | 杨一 | 34 | 程序员 | 厦门 |`
    ]
  };

@@ -644,3 +719,91 @@ it(`Test splitText2Chunks 9`, () => {

  expect(chunks).toEqual(mock.result);
 });
+
+// 段落优化先测试 - 段落深度 0
+it(`Test splitText2Chunks 10`, () => {
+  const mock = {
+    text: `# A
+af da da fda a a 
+
+## B
+段落 2
+### D
+段落 3
+## E
+段落 4`,
+    result: [
+      `# A
+af da da fda a a 
+
+## B
+段落 2
+### D
+段落 3
+## E
+段落 4`
+    ]
+  };
+
+  const { chunks } = splitText2Chunks({ text: mock.text, chunkSize: 2000, paragraphChunkDeep: 0 });
+  expect(chunks).toEqual(mock.result);
+});
+
+// 段落优化先测试 - 段落深度 1
+it(`Test splitText2Chunks 11`, () => {
+  const mock = {
+    text: `# A
+af da da fda a a 
+
+## B
+段落 2
+### D
+段落 3
+## E
+段落 4`,
+    result: [
+      `# A
+af da da fda a a 
+
+## B
+段落 2
+### D
+段落 3
+## E
+段落 4`
+    ]
+  };
+
+  const { chunks } = splitText2Chunks({ text: mock.text, chunkSize: 2000, paragraphChunkDeep: 1 });
+  expect(chunks).toEqual(mock.result);
+});
+
+// 段落优化先测试 - 段落深度 2
+it(`Test splitText2Chunks 12`, () => {
+  const mock = {
+    text: `# A
+af da da fda a a 
+
+## B
+段落 2
+### D
+段落 3
+## E
+段落 4`,
+    result: [
+      `# A
+af da da fda a a`,
+      `# A
+## B
+段落 2
+### D
+段落 3`,
+      `# A
+## E
+段落 4`
+    ]
+  };
+
+  const { chunks } = splitText2Chunks({ text: mock.text, chunkSize: 2000, paragraphChunkDeep: 2 });
+  expect(chunks).toEqual(mock.result);
+});
--- a/test/cases/function/packages/service/core/dataset/textSplitter.test.ts
+++ b/test/cases/function/packages/service/core/dataset/textSplitter.test.ts
@@ -0,0 +1,380 @@
+import { it, expect } from 'vitest'; // 必须显式导入
+import { rawText2Chunks } from '@fastgpt/service/core/dataset/read';
+import { ChunkTriggerConfigTypeEnum } from '@fastgpt/global/core/dataset/constants';
+
+const formatChunks = (
+  chunks: {
+    q: string;
+    a: string;
+    indexes?: string[];
+  }[]
+) => {
+  return chunks.map((chunk) => chunk.q.replace(/\s+/g, ''));
+};
+const formatResult = (result: string[]) => {
+  return result.map((item) => item.replace(/\s+/g, ''));
+};
+
+// 最大值分块测试-小于最大值，不分块
+it(`Test splitText2Chunks 1`, () => {
+  const mock = {
+    text: `# A
+  
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd
+`,
+    result: [
+      `# A
+  
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.maxSize,
+    chunkTriggerMinSize: 1000,
+    maxSize: 20000,
+    chunkSize: 512,
+    backupParse: false
+  });
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});
+// 最大值分块测试-大于最大值，分块
+it(`Test splitText2Chunks 2`, () => {
+  const mock = {
+    text: `# A
+
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd`,
+    result: [
+      `# A
+
+af da da fda a a`,
+      `# A
+## B
+
+阿凡撒发生的都是发大水`,
+      `# A
+## B
+### c
+
+dsgsgfsgs22`,
+      `# A
+## B
+### c
+#### D
+
+dsgsgfsgs22`,
+      `# A
+## B
+### c
+#### D
+##### E
+
+dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.maxSize,
+    chunkTriggerMinSize: 10,
+    maxSize: 10,
+    chunkSize: 512,
+    backupParse: false
+  });
+
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});
+
+// 最小值分块测试-大于最小值，不分块
+it(`Test splitText2Chunks 3`, () => {
+  const mock = {
+    text: `# A
+  
+  af da da fda a a 
+  
+  ## B
+  
+  阿凡撒发生的都是发大水
+  
+  ### c
+  
+  dsgsgfsgs22
+  
+  #### D
+  
+  dsgsgfsgs22
+  
+  ##### E
+  
+  dsgsgfsgs22sddddddd`,
+    result: [
+      `# A
+  
+  af da da fda a a 
+  
+  ## B
+  
+  阿凡撒发生的都是发大水
+  
+  ### c
+  
+  dsgsgfsgs22
+  
+  #### D
+  
+  dsgsgfsgs22
+  
+  ##### E
+  
+  dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.minSize,
+    chunkTriggerMinSize: 1000,
+    maxSize: 1000,
+    chunkSize: 512,
+    backupParse: false
+  });
+
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});
+// 最小值分块测试-小于最小值，分块
+it(`Test splitText2Chunks 4`, () => {
+  const mock = {
+    text: `# A
+
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd`,
+    result: [
+      `# A
+  
+  af da da fda a a`,
+      `# A
+  ## B
+  
+  阿凡撒发生的都是发大水`,
+      `# A
+  ## B
+  ### c
+  
+  dsgsgfsgs22`,
+      `# A
+  ## B
+  ### c
+  #### D
+  
+  dsgsgfsgs22`,
+      `# A
+  ## B
+  ### c
+  #### D
+  ##### E
+  
+  dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.minSize,
+    chunkTriggerMinSize: 10,
+    maxSize: 10,
+    chunkSize: 512,
+    backupParse: false
+  });
+
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});
+
+// 强制分块测试-小于最小值和最大值
+it(`Test splitText2Chunks 5`, () => {
+  const mock = {
+    text: `# A
+
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd`,
+    result: [
+      `# A
+    
+    af da da fda a a`,
+      `# A
+    ## B
+    
+    阿凡撒发生的都是发大水`,
+      `# A
+    ## B
+    ### c
+    
+    dsgsgfsgs22`,
+      `# A
+    ## B
+    ### c
+    #### D
+    
+    dsgsgfsgs22`,
+      `# A
+    ## B
+    ### c
+    #### D
+    ##### E
+    
+    dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.forceChunk,
+    chunkTriggerMinSize: 1000,
+    maxSize: 10000,
+    chunkSize: 512,
+    backupParse: false
+  });
+
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});
+
+// 强制分块测试-大于最小值
+it(`Test splitText2Chunks 6`, () => {
+  const mock = {
+    text: `# A
+  
+af da da fda a a 
+
+## B
+
+阿凡撒发生的都是发大水
+
+### c
+
+dsgsgfsgs22
+
+#### D
+
+dsgsgfsgs22
+
+##### E
+
+dsgsgfsgs22sddddddd`,
+    result: [
+      `# A
+      
+      af da da fda a a`,
+      `# A
+      ## B
+      
+      阿凡撒发生的都是发大水`,
+      `# A
+      ## B
+      ### c
+      
+      dsgsgfsgs22`,
+      `# A
+      ## B
+      ### c
+      #### D
+      
+      dsgsgfsgs22`,
+      `# A
+      ## B
+      ### c
+      #### D
+      ##### E
+      
+      dsgsgfsgs22sddddddd`
+    ]
+  };
+
+  const data = rawText2Chunks({
+    rawText: mock.text,
+    chunkTriggerType: ChunkTriggerConfigTypeEnum.forceChunk,
+    chunkTriggerMinSize: 10,
+    maxSize: 10000,
+    chunkSize: 512,
+    backupParse: false
+  });
+
+  expect(formatChunks(data)).toEqual(formatResult(mock.result));
+});