@gientech/modual 2.0.7 → 2.0.9

package/src/modules/headlessChat/index.tsx

@@ -0,0 +1,1782 @@
+import React, { useEffect, useState, useMemo, useRef } from 'react';
+import { AiChat, AppStatusManager, validateFileUpload, showValidationErrors } from '@mxmweb/aichat';
+import { ChatMessageAdapter } from '@mxmweb/rtext';
+import request from '../../utils/gientechCommon/utils/request';
+import { registerPDFWorker } from '../streamFilesReader';
+registerPDFWorker('/worker/pdf.worker.min.js');
+import {
+  getFeedbackList,
+  handleCancelFeedBack,
+  handleFeedBack,
+} from '../../utils/gientechCommon/utils/serverFn';
+import { toCopy } from '../../utils/commonFn';
+import { uid } from 'uid';
+import GientechNewChatWelcome from '../../utils/gientechCommon/components/Messages/GientechNewChatWelcome';
+import AichatUseController from '../../utils/gientechCommon/hooks/AichatUseController';
+import { useFileManager } from '../../utils/gientechCommon/hooks/useFileManager';
+import { useFileDisplayTools } from '../../utils/gientechCommon/hooks/useFileDisplayTools';
+import FeedBackModal from '../../utils/gientechCommon/components/FeedBackModal';
+import { ConfigProvider, Drawer, message } from 'antd';
+import AppLoading from '../../utils/gientechCommon/components/AppLoading';
+import DisplayLoading from '../../utils/gientechCommon/components/DisplayLoading';
+import AppError from '../../utils/gientechCommon/components/AppError';
+import DisplayError from '../../utils/gientechCommon/components/DisplayError';
+import { DefaultSenderConfig } from './constants';
+import { mergeFiles } from '../../utils/gientechCommon/utils/fileUtils';
+import '@mxmweb/rtext/style.css';
+import '@mxmweb/aichat/style.css';
+import '@mxmweb/zui/style.css';
+import { ReferenceBar } from './ReferenceBar';
+import { DrawerType } from '../chat';
+import { fileViewTypes, getMarkExcludeType, getUrlPrefix, TempBaseUrl } from './utils';
+import { DrawerContent } from './referenceCom/DrawerContent';
+import axios from 'axios';
+import DrawerPreview from './referenceCom/DrawerPreview';
+
+interface SenderConfig {
+  upload_size_limit?: number;
+  upload_number_limit?: number;
+  upload_file_type_limit?: string[];
+  upload_limit_message?: string;
+  actions?: Array<{
+    name: string;
+    icon?: React.ReactNode;
+    badgeCount?: number;
+    tip?: string;
+  }>;
+  switchs?: Array<{
+    label: string;
+    name: string;
+    type: 'switch' | 'checkbox';
+    defaultValue: boolean;
+    enabled: boolean;
+    icon?: React.ReactNode;
+  }>;
+}
+
+interface HeadlessChatAdopterProps {
+  token: string;
+  url?: string;
+  initialMessage?: string;
+  title?: string;
+  configId?: string;
+  useLogin?: boolean;
+  styles?: any;
+  welcomeContent?: string;
+  senderConfig?: SenderConfig;
+  onError?: (ems: any) => void;
+  eventsEmit?: (eventName: string, data: any) => void;
+  [key: string]: any;
+}
+
+export default function withHeadLessChatAdopter(
+  WrappedComponent: React.ComponentType<any> = AiChat as any
+) {
+  /**
+   * GientechChatAdopter 高阶组件
+   * 封装了与Gientech后端服务的接口对接、状态管理、事件处理等核心业务逻辑
+   * @param {React.ComponentType} WrappedComponent - 需要包裹的基础聊天组件，默认为 AiChat
+   */
+  return function GientechChatAdopter({
+    disclaimers,
+    token,
+    url = 'http://localhost:8888',
+    welcomeContent = '欢迎来到小鲸智能助手，有什么能帮你的么？',
+    styles,
+    eventsEmit,
+    onError,
+    configId,
+    senderConfig,
+    initialMessage,
+    ...rest
+  }: HeadlessChatAdopterProps) {
+    console.log('[HeadlessChat] 组件初始化 - 接收到的 props:', {
+      configId,
+      url,
+      hasToken: !!token,
+    });
+    const [open, setOpen] = useState(false);
+    const [content, setContent] = useState<
+      | {
+          title: '';
+          file_type: '';
+          metadata: { offset: [] };
+        }
+      | any
+    >(null);
+    const [drawerType, setDrawerType] = useState<string>('mark');
+    const [curFileInfo, setCurFileInfo] = useState({
+      url: '',
+      parse_url: '',
+      file_type: '',
+      file_name: '',
+    });
+    // =================================================================
+    // State Management - 状态管理
+    // =================================================================
+    const [conversationList, setConversationList] = useState<any[]>([]); // 对话列表
+    const [chatData, setChatData] = useState<any[]>([]); // 所有对话的聊天记录
+    const [activeSessionId, setActiveSessionId] = useState<string | undefined>(undefined); // 当前激活的对话ID
+    const [recommandQuestions, setRecommandQuestions] = useState<any[]>([]); // 推荐问题列表
+    const [assistantList] = useState<any[]>([]); // 智能体（助手）列表
+    const [appStatus, setAppStatus] = useState<AppStatusManager>({
+      display: 'ready', // 主聊天区域状态: ready, loading, processing, error, uploading
+      sender: 'ready', // 发送器状态: ready, processing, error, uploading
+      app: 'initializing', // 应用整体状态: initializing, ready, error
+    });
+    // 深合并函数，用于合并默认配置和外部配置
+    function deepMerge(defaultConfig: any, customConfig: any): any {
+      if (!customConfig) return defaultConfig;
+      const result = { ...defaultConfig };
+      for (const key in customConfig) {
+        if (Object.prototype.hasOwnProperty.call(customConfig, key)) {
+          // 特殊处理 actions 数组：合并而不是替换
+          if (
+            key === 'actions' &&
+            Array.isArray(defaultConfig[key]) &&
+            Array.isArray(customConfig[key])
+          ) {
+            // 创建一个以 name 为 key 的 Map，优先使用 customConfig 中的 action
+            const actionsMap = new Map();
+            // 先添加 defaultConfig 中的 actions
+            (defaultConfig[key] as any[]).forEach((action: any) => {
+              if (action.name) {
+                actionsMap.set(action.name, action);
+              }
+            });
+            // 然后用 customConfig 中的 actions 覆盖或添加
+            (customConfig[key] as any[]).forEach((action: any) => {
+              if (action.name) {
+                actionsMap.set(action.name, action);
+              }
+            });
+            result[key] = Array.from(actionsMap.values());
+          } else if (
+            typeof defaultConfig[key] === 'object' &&
+            defaultConfig[key] !== null &&
+            !Array.isArray(defaultConfig[key]) &&
+            typeof customConfig[key] === 'object' &&
+            customConfig[key] !== null &&
+            !Array.isArray(customConfig[key])
+          ) {
+            result[key] = deepMerge(defaultConfig[key], customConfig[key]);
+          } else {
+            result[key] = customConfig[key];
+          }
+        }
+      }
+      return result;
+    }
+
+    // 发送器配置支持外部传入，merge 默认和外部
+    const [dynamicSenderConfig, setDynamicSenderConfig] = useState(() => {
+      const merged = deepMerge(DefaultSenderConfig, senderConfig);
+      return merged;
+    });
+
+    // 监听外部 senderConfig 变化自动 merge
+    useEffect(() => {
+      if (senderConfig) {
+        const merged = deepMerge(DefaultSenderConfig, senderConfig);
+        setDynamicSenderConfig(merged);
+      }
+    }, [senderConfig]);
+
+    // 使用统一的文件管理 Hook
+    const {
+      fileManagerData,
+      fileStatuses,
+      setFileManagerData,
+      setFileStatuses,
+      pollFileStatus: pollFileStatusHook,
+      handleRemoveFromTemp,
+      resetStopFlag,
+      setStopFlag,
+      stoppedRef,
+    } = useFileManager({
+      url,
+      token,
+      activeSessionId,
+      chatData,
+      onError,
+    });
+
+    // 新增：记录 sender switchs 的选中状态
+    const [senderSwitchValues, setSenderSwitchValues] = useState<{ [key: string]: boolean }>({});
+
+    // =================================================================
+    // Refs - 引用
+    // =================================================================
+    const prevActiveSessionId = useRef<string | undefined>(undefined); // 记录上一个激活的对话ID，用于对比变化
+    const setUploadedFilesRef = useRef<(files: any[]) => void>(undefined); // 引用核心组件的文件上传方法
+    const removeFileRef = useRef<(fileObj: any, idx: number, _type: string) => void>(undefined); // 引用核心组件的文件移除方法
+    const fileInputRef = useRef<HTMLInputElement>(null); // 文件上传input引用
+    const setFileListPopoverOpenRef = useRef<((open: boolean) => void) | null>(null); // 文件列表 Popover 控制函数引用
+    const senderConfigRef = useRef<SenderConfig | undefined>(undefined); // 引用核心组件的上传限制配置
+    const uploadedFilesRef = useRef<any[]>([]); // 引用核心组件的已上传文件列表
+
+    const [feedParam, setFeedParam] = useState<{
+      queryId?: number | string | undefined;
+      restult?: number;
+    }>({});
+    const [openFeed, setOpenFeed] = useState(false);
+    const [feedBackList, setFeedBackList] = useState<any>([]);
+    // stoppedRef 已由 useFileManager hook 管理
+
+    // =================================================================
+    // Custom Hooks - 自定义钩子
+    // =================================================================
+    // 引入SSE控制器，封装了流式请求、消息管理等复杂逻辑
+    const { api_startChat_re, addEmptyMessage, setLastEmptyMessage, stopStream } =
+      AichatUseController({
+        baseUrl: url,
+        token,
+        setChatData,
+        activeSessionId,
+        setAppStatus,
+        setConversationList,
+      });
+
+    // =================================================================
+    // Memoized Values - 缓存计算值
+    // =================================================================
+
+    // welcomeContent 伪消息唯一 id/time/queryId
+    const welcomeMsgId = useRef(uid(32));
+    const welcomeMsgQueryId = useRef(uid(32));
+    const welcomeMsgTime = useRef(Date.now());
+
+    /**
+     * 将智能体列表转换为以ID为键的Map，便于快速查找
+     */
+    const assistantMap = useMemo(() => {
+      const map: Record<string, any> = {};
+      (assistantList || []).forEach(item => {
+        map[item.id] = item;
+      });
+      return map;
+    }, [assistantList]);
+
+    /**
+     * 根据 activeSessionId 从 chatData 中筛选出当前对话的数据, 并合并智能体信息
+     */
+    const currentChatData = useMemo(() => {
+      let data = chatData.find((c: any) => c.id === activeSessionId) || {
+        id: activeSessionId,
+        messages: [],
+      };
+      let messages = data.messages || [];
+      // 检查第一条是否已经是 welcome 消息，如果不是则插入
+      if (welcomeContent && (messages.length === 0 || !messages[0]?.isDefault)) {
+        messages = [
+          {
+            istype: 'ai',
+            content: welcomeContent,
+            time: welcomeMsgTime.current,
+            clientSideId: welcomeMsgId.current,
+            isWelcome: true,
+            isDefault: true,
+            queryId: welcomeMsgQueryId.current,
+          },
+          ...messages,
+        ];
+      }
+      // 如果第一条已经是 isDefault: true 的欢迎消息，确保它的 isWelcome 字段存在
+      if (messages[0]?.isDefault && !messages[0]?.isWelcome) {
+        messages[0].isWelcome = true;
+      }
+      const assistantInfo = data.configId ? assistantMap[data.configId] : null;
+      return {
+        ...data,
+        messages,
+        assistantInfo,
+      };
+    }, [chatData, activeSessionId, assistantMap, welcomeContent]);
+
+    // 文件工具函数已提取到 useFileManager hook 中
+
+    // 文件同步逻辑已由 useFileManager hook 处理
+
+    // =================================================================
+    // Side Effects (useEffect) - 副作用钩子
+    // =================================================================
+
+    /**
+     * 跟踪 activeSessionId 的变化:
+     * 1. 清理上一个无消息的临时会话
+     * 2. 更新推荐问题
+     */
+    useEffect(() => {
+      // 切换会话时，检查上一个会话是否为临时且无消息
+      if (prevActiveSessionId.current && prevActiveSessionId.current !== activeSessionId) {
+        const prevId = prevActiveSessionId.current;
+        const prevConv = conversationList.find(c => c.sessionId === prevId && c.isNew);
+        const prevChat = chatData.find(c => c.id === prevId && c.isNew);
+        const prevHasMsg = prevChat && prevChat.messages && prevChat.messages.length > 0;
+        // 如果是临时的且没有消息，则自动删除
+        if (prevConv && !prevHasMsg) {
+          setConversationList(list => list.filter(c => c.sessionId !== prevId));
+          setChatData(list => list.filter(c => c.id !== prevId));
+        }
+      }
+      prevActiveSessionId.current = activeSessionId;
+
+      // 更新推荐问题为当前对话的最后一个推荐问题
+      const historyRQ =
+        currentChatData.messages && currentChatData.messages.length > 0
+          ? currentChatData.messages[currentChatData.messages.length - 1].recommendQuestion
+          : [];
+      setRecommandQuestions(historyRQ);
+    }, [activeSessionId, conversationList, chatData, currentChatData.messages]);
+
+    /**
+     * 1. useEffect 只拉助手列表，自动新建会话
+     */
+    useEffect(() => {
+      setAppStatus(prev => ({ ...prev, app: 'initializing' }));
+
+      if (token) {
+        handleConversationCreate({ configId });
+      }
+      setAppStatus(prev => ({ ...prev, app: 'ready' }));
+    }, [url, token, configId]);
+
+    /**
+     * 当 activeSessionId 变化时，获取对应的聊天记录
+     */
+    useEffect(() => {
+      if (!activeSessionId) return;
+      setAppStatus(prev => ({ ...prev, display: 'loading' }));
+
+      setAppStatus(prev => ({ ...prev, display: 'ready' }));
+    }, [activeSessionId, url, token]);
+
+    /**
+     * 自动发送初始消息
+     * 当 activeSessionId 设置且组件准备好后，如果有 initialMessage，就自动发送
+     */
+    const hasSentInitialMessage = useRef(false);
+    const initialMessageRef = useRef<string | undefined>(initialMessage);
+
+    // 更新 ref，确保始终使用最新的 initialMessage
+    useEffect(() => {
+      initialMessageRef.current = initialMessage;
+    }, [initialMessage]);
+
+    useEffect(() => {
+      // 确保只在组件初始化时发送一次，且 activeSessionId 已设置，且应用状态为 ready
+      // 适配两种模式：
+      // 1. 直接有token：组件挂载时 token 已存在，立即创建会话并发送
+      // 2. 需要登录：登录成功后组件才开始渲染，此时 token 已有值，创建会话并发送
+      if (
+        initialMessageRef.current &&
+        activeSessionId &&
+        appStatus.app === 'ready' &&
+        appStatus.display === 'ready' &&
+        !hasSentInitialMessage.current
+      ) {
+        hasSentInitialMessage.current = true;
+        // 延迟一下确保组件完全准备好
+        setTimeout(() => {
+          handleSenderSend({ content: initialMessageRef.current }, () => {});
+        }, 100);
+      }
+    }, [activeSessionId, appStatus.app, appStatus.display, initialMessage]);
+
+    // 文件角标逻辑已移除，upload action 不需要角标
+    useEffect(() => {
+      getFeedbackList({ url, token }, data => {
+        setFeedBackList(data);
+      });
+    }, []);
+
+    /**
+     * 实时同步 fileStatuses 到当前消息的 currentFiles，便于消息区细致显示每个文件的处理状态
+     */
+    React.useEffect(() => {
+      if (!fileStatuses.length) return;
+      setChatData(chatList => {
+        if (!chatList[0]) return chatList;
+        const { messages } = chatList[0];
+        for (let i = messages.length - 1; i >= 0; i--) {
+          if (messages[i].istype === 'user') {
+            const oldFiles = messages[i].currentFiles || [];
+            messages[i].currentFiles = fileStatuses.map((f: any) => {
+              const old = oldFiles.find((of: any) => of.uid === f.uid);
+              return {
+                name: f.file?.name || f.name,
+                size: f.file?.size || f.size,
+                type: f.file?.type || f.type,
+                status: f.status,
+                uid: f.uid,
+                url: f.url || old?.url || '', // 优先用已有 url
+              };
+            });
+            break;
+          }
+        }
+        return [...chatList];
+      });
+    }, [fileStatuses]);
+
+    // =================================================================
+    // Core Functions - 核心功能函数
+    // =================================================================
+
+    // 1. 在组件作用域定义控制器和轮询停止标志
+    let uploadController: AbortController | null = null;
+    let stopPoll: (() => void) | null = null;
+
+    /**
+     * 轮询文件解析状态（使用统一的 hook）
+     */
+    const pollFileStatus = (
+      uids: string[],
+      onStatusUpdate: (serverStatuses: any[]) => void,
+      onComplete: () => void,
+      onFail: (errorMsg: string) => void
+    ) => {
+      stopPoll = pollFileStatusHook(uids, {
+        onStatusUpdate,
+        onComplete,
+        onFail,
+      });
+    };
+
+    /**
+     * 设置消息的反馈结果（赞/踩）
+     * @param {string} queryId - 消息ID
+     * @param {number} result - 反馈结果 (1: 赞, -1: 踩)
+     */
+    const setFeed = (queryId: any, restult: any) => {
+      setChatData(chatList => {
+        const newList = [...chatList];
+        if (!newList[0]) return newList;
+        newList[0] = {
+          ...newList[0],
+          messages: newList[0].messages.map((item: any) => {
+            if (item.queryId === queryId) {
+              return {
+                ...item,
+                feedbackResult: restult,
+              };
+            }
+            return item;
+          }),
+        };
+        return newList;
+      });
+    };
+
+    /**
+     * 获取指定queryId的推荐问题
+     * @param {string} queryId - 消息ID
+     */
+    const fetchRecommendQuestions = async (queryId: string) => {
+      if (!queryId) return;
+      try {
+        const res = await request.get(`${url}/qa/ai/recommendQuestion?queryId=${queryId}`, {
+          headers: { Authorization: token },
+        });
+        setRecommandQuestions(res.data?.data || []);
+      } catch (e) {
+        onError?.(e);
+        setRecommandQuestions([]);
+      }
+    };
+
+    /**
+     * 处理重新发送消息逻辑
+     * 重发时应该使用上一次用户的提问内容，而不是AI的回复内容
+     */
+    function handleReSenderSend(data: any) {
+      const { audioUrl, filePaths, queryId } = data;
+      if (!queryId) return;
+
+      // 从当前对话的消息列表中找到对应的用户消息
+      const messages = currentChatData.messages || [];
+      let userMessage: any = null;
+
+      // 首先尝试通过 queryId 找到对应的消息
+      const targetMessageIndex = messages.findIndex((msg: any) => msg.queryId === queryId);
+
+      if (targetMessageIndex !== -1) {
+        const targetMessage = messages[targetMessageIndex];
+        // 如果找到的是AI消息，向前查找对应的用户消息
+        if (targetMessage.istype === 'ai') {
+          // 从当前位置向前查找用户消息
+          for (let i = targetMessageIndex - 1; i >= 0; i--) {
+            if (messages[i].istype === 'user') {
+              userMessage = messages[i];
+              break;
+            }
+          }
+        } else if (targetMessage.istype === 'user') {
+          // 如果找到的就是用户消息，直接使用
+          userMessage = targetMessage;
+        }
+      } else {
+        // 如果没找到对应queryId的消息，尝试找到最后一条用户消息
+        for (let i = messages.length - 1; i >= 0; i--) {
+          if (messages[i].istype === 'user') {
+            userMessage = messages[i];
+            break;
+          }
+        }
+      }
+
+      // 如果找不到用户消息，则使用传入的content作为兜底
+      const content = userMessage?.content || data.content;
+      if (!content) return;
+
+      // 优先使用用户消息中的文件信息
+      const userFilePaths = userMessage?.filePaths || filePaths;
+      const _fileUids = (
+        typeof userFilePaths === 'string' && userFilePaths
+          ? JSON.parse(userFilePaths)
+          : userFilePaths || []
+      ).map((item: any) => item.uid);
+
+      const now = Date.now();
+      setLastEmptyMessage({ now });
+      if (!activeSessionId) return;
+      setAppStatus(pre => {
+        return {
+          ...pre,
+          display: 'processing',
+          sender: 'processing',
+        };
+      });
+
+      data.clearFn && data.clearFn();
+      setConversationList(list =>
+        list.map(c => (c.sessionId === activeSessionId ? { ...c, gmtModified: now } : c))
+      );
+
+      // 使用用户消息的queryId，如果没有则使用传入的queryId
+      const userQueryId = userMessage?.queryId || queryId;
+
+      api_startChat_re(
+        {
+          configId: configId ?? currentChatData.configId ?? null,
+          content,
+          fileUids: _fileUids,
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: userQueryId,
+          sessionId: activeSessionId,
+          type: audioUrl ? 'audioUrl' : 'text',
+          audioUrl: userMessage?.audioUrl || audioUrl,
+          sysType: 'TEMPORARY',
+          enableThinking: !!senderSwitchValues.reasoning,
+          enableWebsearch: !!senderSwitchValues.netSearch,
+          qaChannel: senderSwitchValues.qaChannel,
+        } as any,
+        () => {
+          fetchRecommendQuestions(userQueryId);
+        }
+      );
+    }
+
+    /**
+     * 处理消息发送（核心逻辑）
+     * 1. 包含文件：先上传文件，成功后再发消息
+     * 2. 新建会话：先调用创建会话接口，成功后再发消息
+     * 3. 普通消息：直接发送
+     * @param {object} data - 消息数据
+     */
+    async function handleSenderSend(data: any, clearFn: () => void) {
+      const queryId = 'query-' + uid(32);
+      // 1. 立即插入空壳消息
+      let localCurrentFiles = undefined;
+      if (data.files && data.files.length > 0) {
+        localCurrentFiles = data.files.map((fileItem: any) => ({
+          name: fileItem.file.name,
+          size: fileItem.file.size,
+          type: fileItem.file.type,
+          filePath: fileItem.filePath || '',
+          convertedFilePath: fileItem.convertedFilePath || '',
+          uid: fileItem.uid || '',
+        }));
+      }
+      addEmptyMessage({
+        content: data.content || data.text || '',
+        queryId,
+        currentFiles: localCurrentFiles,
+        filePaths: localCurrentFiles ? JSON.stringify(localCurrentFiles) : undefined,
+      });
+      setConversationList(list => {
+        const newList = list
+          .map(c =>
+            c.sessionId === activeSessionId ? { ...c, isNew: false, gmtModified: Date.now() } : c
+          )
+          .sort((a, b) => b.gmtModified - a.gmtModified);
+        setTimeout(() => {
+          setActiveSessionId(activeSessionId);
+        }, 300);
+        return newList;
+      });
+      // 2. 有文件时，先上传并轮询，全部解析成功后再发起AI请求
+      if (data.files && data.files.length > 0) {
+        setAppStatus(pre => ({ ...pre, sender: 'uploading', display: 'uploading' }));
+        uploadController = new AbortController();
+        resetStopFlag(); // 使用 hook 提供的重置函数
+        const clientFileUids = data.files.map(
+          () => `rc-upload-${Date.now()}-${Math.random().toString(36).slice(2)}`
+        );
+        const initialFileStatuses = data.files.map((fileItem: any, index: number) => ({
+          ...fileItem,
+          uid: clientFileUids[index],
+          status: 'uploading',
+        }));
+        setFileStatuses(initialFileStatuses);
+        const formData = new FormData();
+        data.files.forEach((fileItem: any) => {
+          formData.append('files', fileItem.file);
+        });
+        const sessionIdStr = activeSessionId ? String(activeSessionId) : '';
+        formData.append('sessionId', sessionIdStr);
+        formData.append('uids', clientFileUids.join(','));
+        try {
+          const response = await request.post(
+            `${url}/index/knowledgeBase/file/uploadFiles`,
+            formData,
+            {
+              headers: {
+                Authorization: token,
+                'Content-Type': 'multipart/form-data',
+              },
+              signal: uploadController.signal,
+            }
+          );
+          if (stoppedRef.current) return;
+          if (
+            response.data.success &&
+            Array.isArray(response.data.data) &&
+            response.data.data.length > 0
+          ) {
+            // === 新增：合并后端返回字段到 fileStatuses ===
+            setFileStatuses(prev => {
+              return prev.map(localFile => {
+                const serverFile = response.data.data.find((f: any) => f.uid === localFile.uid);
+                return serverFile ? { ...localFile, ...serverFile } : localFile;
+              });
+            });
+            setAppStatus(pre => ({ ...pre, sender: 'processing', display: 'analyzing' }));
+            setFileStatuses(prev => prev.map(f => ({ ...f, status: 'parsing' })));
+            const uploadedFilesData = response.data.data;
+            const serverUids = uploadedFilesData.map((f: any) => f.uid);
+            pollFileStatus(
+              serverUids,
+              serverStatuses => {
+                setFileStatuses(currentLocalStatuses => {
+                  return currentLocalStatuses.map(localFile => {
+                    const correspondingServerFile = serverStatuses.find(
+                      (sf: any) => sf.uid === localFile.uid
+                    );
+                    if (correspondingServerFile) {
+                      switch (correspondingServerFile.status) {
+                        case 3:
+                          return { ...localFile, status: 'done' };
+                        case 4:
+                          return { ...localFile, status: 'error' };
+                        case 1:
+                        case 2:
+                        default:
+                          return { ...localFile, status: 'parsing' };
+                      }
+                    }
+                    return localFile;
+                  });
+                });
+                // === 新增：全部完成时清空 sender 区并合并文件 ===
+                const allDone =
+                  serverStatuses.length > 0 &&
+                  serverStatuses.every((file: any) => file.status === 3);
+                if (allDone) {
+                  setFileStatuses([]);
+                  // 上传完成后合并新文件到 uploadedFiles，保证结构统一
+                  const map = new Map();
+                  (uploadedFilesData || []).forEach((item: any) => {
+                    map.set(item.id, item);
+                  });
+                  setFileManagerData(prev => {
+                    const r = mergeFiles(prev.uploadedFiles, uploadedFilesData);
+
+                    return {
+                      uploadedFiles: r.map(item => {
+                        return {
+                          ...item,
+                          pdfPages: map.get(item.id)?.pdfPages || 0, // 保留后端返回的 pdfPages 字段
+                        };
+                      }),
+                    };
+                  });
+                }
+              },
+              // onComplete: 全部解析成功后才发起AI请求
+              () => {
+                clearFn?.();
+                setAppStatus(pre => ({ ...pre, sender: 'processing', display: 'processing' }));
+                // === 新增：回填 filePath 到 fileStatuses ===
+                setFileStatuses(prev => {
+                  return prev.map(localFile => {
+                    const serverFile = uploadedFilesData.find((f: any) => f.uid === localFile.uid);
+
+                    if (serverFile) {
+                      return {
+                        ...localFile,
+                        ...serverFile, // 合并后端所有字段
+                        url: serverFile.filePath, // 兼容 url 字段
+                        filePath: serverFile.filePath,
+                        name: serverFile.fileName || localFile.name,
+                        convertedFilePath:
+                          serverFile.convertedFilePath || localFile.convertedFilePath,
+                      };
+                    }
+                    return localFile;
+                  });
+                });
+                // === 同步 currentFiles 字段到 chatData ===
+                setChatData(chatList => {
+                  if (!chatList[0]) return chatList;
+                  const { messages } = chatList[0];
+                  for (let i = messages.length - 1; i >= 0; i--) {
+                    if (messages[i].istype === 'user') {
+                      const oldFiles = messages[i].currentFiles || [];
+                      messages[i].currentFiles = oldFiles.map((localFile: any) => {
+                        const serverFile = uploadedFilesData.find(
+                          (f: any) => f.uid === localFile.uid
+                        );
+                        return serverFile ? { ...localFile, ...serverFile } : localFile;
+                      });
+                      break;
+                    }
+                  }
+                  return [...chatList];
+                });
+                // === 全部完成时清空 sender 区并合并文件 ===
+                setFileStatuses([]);
+                // 上传完成后合并新文件到 uploadedFiles，保证结构统一
+                const map = new Map();
+                (uploadedFilesData || []).forEach((item: any) => {
+                  map.set(item.id, item);
+                });
+                setFileManagerData(prev => {
+                  const r = mergeFiles(prev.uploadedFiles, uploadedFilesData);
+
+                  return {
+                    uploadedFiles: r.map(item => {
+                      return {
+                        ...item,
+                        pdfPages: map.get(item.id)?.pdfPages || 0, // 保留后端返回的 pdfPages 字段
+                      };
+                    }),
+                  };
+                });
+                const now = Date.now();
+                api_startChat_re(
+                  {
+                    configId: configId || currentChatData.configId,
+                    content: data.content || data.text || '',
+                    fileUids: serverUids,
+                    lastDate: now,
+                    name: currentChatData.label || '',
+                    queryId: queryId,
+                    sessionId: String(activeSessionId || ''),
+                    type: 'text',
+                    audioUrl: '',
+                    sysType: 'TEMPORARY',
+                    enableThinking: !!senderSwitchValues.reasoning,
+                    enableWebsearch: !!senderSwitchValues.netSearch,
+                    qaChannel: senderSwitchValues.qaChannel,
+                  } as any,
+                  () => {
+                    fetchRecommendQuestions(queryId);
+                  }
+                );
+              },
+              (errorMsg: string) => {
+                setAppStatus(pre => ({ ...pre, display: 'ready', sender: 'ready' }));
+                setFileStatuses(prev =>
+                  prev.map(f => ({ ...f, status: 'error', message: errorMsg }))
+                );
+              }
+            );
+          } else {
+            const errorMsg = response.data.errorMsg || '文件上传失败';
+            setAppStatus(pre => ({ ...pre, display: 'error', sender: 'ready' }));
+            setFileStatuses(prev => prev.map(f => ({ ...f, status: 'error', message: errorMsg })));
+          }
+        } catch (error) {
+          setAppStatus(pre => ({ ...pre, display: 'error', sender: 'ready' }));
+          setFileStatuses(prev => prev.map(f => ({ ...f, status: 'error', message: '网络错误' })));
+        }
+        return;
+      }
+      // 3. 无文件，直接发起AI请求
+      if (!activeSessionId) return;
+      setAppStatus(pre => ({ ...pre, display: 'processing', sender: 'processing' }));
+      const now = Date.now();
+      setConversationList(list =>
+        list.map(c => (c.sessionId === activeSessionId ? { ...c, gmtModified: now } : c))
+      );
+      clearFn?.();
+      const requestConfigId = configId ?? currentChatData.configId ?? null;
+      console.log('[HeadlessChat] handleSenderSend - 发送请求 configId:', {
+        propsConfigId: configId,
+        currentChatDataConfigId: currentChatData.configId,
+        requestConfigId,
+      });
+      api_startChat_re(
+        {
+          configId: requestConfigId,
+          content: data.content || data.text || '',
+          fileUids: [],
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: queryId,
+          sessionId: activeSessionId,
+          type: 'text',
+          audioUrl: '',
+          sysType: 'TEMPORARY',
+          enableThinking: !!senderSwitchValues.reasoning,
+          enableWebsearch: !!senderSwitchValues.netSearch,
+          qaChannel: senderSwitchValues.qaChannel,
+        } as any,
+        () => {
+          fetchRecommendQuestions(queryId);
+        }
+      );
+    }
+
+    // =================================================================
+    // Event Handlers - 事件处理器
+    // =================================================================
+
+    /**
+     * 处理点赞反馈
+     */
+    function handleThumbsup(data: any) {
+      if (data.restult == 1) {
+        handleCancelFeedBack({ url, token }, { queryId: data.queryId }, () => {
+          setFeed(data.queryId, null);
+        });
+      } else {
+        handleFeedBack({ url, token }, { restult: 1, queryId: data.queryId }, () => {
+          setFeed(data.queryId, 1);
+        });
+      }
+    }
+
+    /**
+     * 处理新建一个临时会话
+     */
+    function handleConversationCreate(data: any) {
+      const sessionId = uid(32);
+      // 优先用 props.configId，使用 ?? 确保空字符串也能正确传递
+      const effectiveConfigId = configId ?? data?.configId ?? '';
+      console.log('[HeadlessChat] handleConversationCreate - configId 解析:', {
+        propsConfigId: configId,
+        dataConfigId: data?.configId,
+        effectiveConfigId,
+      });
+      const newConversation = {
+        sessionId,
+        label: '未命名会话',
+        gmtModified: Date.now(),
+        searchConfigDTO: {},
+        filePath: '',
+        configId: effectiveConfigId,
+        isNew: true,
+      };
+      setConversationList(list => [{ ...newConversation, messages: [] }, ...list]);
+      setChatData(list => [{ id: sessionId, messages: [], ...newConversation }, ...list]);
+      setActiveSessionId(sessionId);
+      // 自动触发新建会话接口
+
+      if (token && url) {
+        request
+          .post(
+            `${url}/qa/dialogue/create`,
+            {
+              configId: effectiveConfigId,
+              label: `来自内嵌应用${uid(8)}`,
+              sessionId,
+              sysType: 'TEMPORARY',
+            },
+            {
+              headers: { Authorization: token },
+            }
+          )
+          .then(res => {
+            const newSession = res.data.data;
+            if (newSession?.sessionId) {
+              setConversationList(list => [
+                { ...newSession, messages: [] },
+                ...list.filter(c => c.sessionId !== sessionId),
+              ]);
+              setChatData(list => [
+                { id: newSession.sessionId, messages: [], ...newSession },
+                ...list.filter(c => c.id !== sessionId),
+              ]);
+              setActiveSessionId(newSession.sessionId);
+            }
+          })
+          .catch(err => {
+            onError?.(err);
+          });
+      }
+    }
+
+    /**
+     * 处理文件选择
+     */
+    const handleFileSelect = (e: React.ChangeEvent<HTMLInputElement>) => {
+      const files = e.target.files;
+      if (files && files.length > 0) {
+        const fileArray = Array.from(files);
+
+        // 应用上传限制配置验证（优先使用 ref，如果 ref 未设置则使用 dynamicSenderConfig）
+        const configSource = senderConfigRef.current || dynamicSenderConfig;
+        const existingFiles = uploadedFilesRef.current || [];
+
+        // 检查是否有上传限制配置
+        const hasUploadLimitConfig =
+          configSource &&
+          (configSource.upload_size_limit !== undefined ||
+           configSource.upload_number_limit !== undefined ||
+           (configSource.upload_file_type_limit && configSource.upload_file_type_limit.length > 0));
+
+        if (hasUploadLimitConfig) {
+          // 提取上传限制相关配置
+          const uploadConfig = {
+            upload_size_limit: configSource.upload_size_limit,
+            upload_number_limit: configSource.upload_number_limit,
+            upload_file_type_limit: configSource.upload_file_type_limit,
+            upload_limit_message: configSource.upload_limit_message,
+          };
+
+          const validationResult = validateFileUpload(
+            fileArray,
+            existingFiles,
+            uploadConfig
+          );
+
+          if (!validationResult.valid) {
+            // 显示错误提示
+            showValidationErrors(validationResult);
+            // 只保留通过验证的文件
+            const validFiles = fileArray.filter(
+              file => !validationResult.rejectedFiles.includes(file)
+            );
+
+            if (validFiles.length === 0) {
+              // 所有文件都被拒绝，清空 input 并返回
+              if (fileInputRef.current) {
+                fileInputRef.current.value = '';
+              }
+              return;
+            }
+
+            // 使用通过验证的文件
+            fileArray.splice(0, fileArray.length, ...validFiles);
+          }
+        }
+
+        // 收集所有已经存在的文件名（用于检查重复）
+        const existingFileNames = new Set<string>(
+          fileManagerData.uploadedFiles.map((f: any) => (f.name || f.file?.name || '') as string)
+        );
+
+        const newFiles: { file: File; type: string }[] = [];
+        const duplicateFileNames = new Set<string>();
+
+        // 遍历新选择的文件，筛选出重复项和有效项
+        fileArray.forEach(file => {
+          if (existingFileNames.has(file.name)) {
+            duplicateFileNames.add(file.name);
+          } else {
+            newFiles.push({
+              file,
+              type: file.type.startsWith('image/') ? ('image' as const) : ('document' as const),
+            });
+            existingFileNames.add(file.name);
+          }
+        });
+
+        // 如果有重复，发出警告
+        if (duplicateFileNames.size > 0) {
+          message.warning(`不能上传同名文件: ${Array.from(duplicateFileNames).join(', ')}`);
+        }
+
+        // 将有效的文件通过 setUploadedFilesRef 设置到 aichat 内部
+        if (newFiles.length > 0) {
+          if (setUploadedFilesRef.current) {
+            setUploadedFilesRef.current(newFiles);
+          } else {
+            // 如果 ref 还没有设置，等待一下再试
+            setTimeout(() => {
+              if (setUploadedFilesRef.current) {
+                setUploadedFilesRef.current(newFiles);
+              }
+            }, 100);
+          }
+        }
+      }
+      // 清空 input，以便可以重复选择同一文件
+      if (fileInputRef.current) {
+        fileInputRef.current.value = '';
+      }
+    };
+
+    const [is_download, setIs_download] = useState(false);
+
+    const getConfigById = async (params: any) => {
+      try {
+        const res: any = await axios.get(
+          `${getUrlPrefix()}/qa/search/config/getById?${new URLSearchParams(params).toString()}`,
+          { headers: { Authorization: token } }
+        );
+        console.log('resslkdjgalsg', res);
+        if (res?.data?.success && res?.data?.data?.configJson) {
+          const config = JSON.parse(res.data.data.configJson);
+          setIs_download(config.is_download);
+        }
+      } catch (error) {}
+    };
+
+    useEffect(() => {
+      if (!configId) return;
+      getConfigById({ configId });
+    }, [configId]);
+
+    /**
+     * 处理会话列表项点击
+     */
+    function handleItemClick(data: any) {
+      if (data?.sessionId && data.sessionId !== activeSessionId) {
+        setActiveSessionId(data.sessionId);
+        setAppStatus(prev => ({ ...prev, sender: 'ready' }));
+        // 点击会话时，使用其最后一条AI消息的推荐问题
+        const conv = chatData.find(c => c.id === data.sessionId);
+        if (conv && conv.messages && conv.messages.length > 0) {
+          const lastAiMsg = [...conv.messages].reverse().find((m: any) => m.istype === 'ai');
+          if (lastAiMsg && lastAiMsg.recommendQuestion) {
+            setRecommandQuestions(lastAiMsg.recommendQuestion);
+          } else {
+            setRecommandQuestions([]);
+          }
+        } else {
+          setRecommandQuestions([]);
+        }
+      }
+    }
+
+    // =================================================================
+    // Local State Updaters - 本地状态更新 (供事件发射器使用)
+    // =================================================================
+
+    const handleFeedDownConfirm = (data: any) => {
+      handleFeedBack({ url, token }, { ...data, ...feedParam, restult: 0 }, () => {
+        setFeed(feedParam.queryId, 0);
+      });
+    };
+
+    // =================================================================
+    // Event Emitter - 事件分发器
+    // =================================================================
+    /**
+     * 统一事件分发器，连接业务逻辑与所有子组件的事件
+     * @param {string} eventName - 事件名称
+     * @param {any} data - 事件数据
+     */
+    const api_getFileStatusByUid = async (data: any) => {
+      try {
+        const res: any = await axios.get(
+          `${getUrlPrefix()}/index/knowledgeBase/file/getFileStatusByUids?uids=${data.data.uids}`,
+          { headers: { Authorization: token } }
+        );
+        console.log('resslkdjgalsg', res);
+        return res?.data?.data;
+      } catch (error) {}
+    };
+    const referenceFile_question_upload = async (data: any) => {
+      if (fileViewTypes.includes(data.file_type)) {
+        // 优先使用 metadata.source，否则使用 url 或 convertedFilePath
+        const previewUrl = data.metadata?.source
+          ? `${TempBaseUrl}${data.metadata.source}`
+          : data.url || data.convertedFilePath || data.filePath;
+        setCurFileInfo({
+          ...data,
+          parse_url: previewUrl,
+        });
+
+        setDrawerType('preview');
+        setOpen(true);
+        return;
+      }
+      try {
+        const res: any = await api_getFileStatusByUid({
+          data: { uids: data.uid },
+          config: {
+            url: getUrlPrefix(),
+            token: configId,
+            enableMock: false,
+          },
+        });
+        if (res?.length) {
+          const d = res[0];
+          setCurFileInfo({
+            ...data,
+            parse_url: d.convertedFilePath,
+          });
+
+          setDrawerType('preview');
+          setOpen(true);
+        }
+      } catch (error) {}
+    };
+    const mergedEventsEmit = (eventName: string, data: any) => {
+      console.log(`[Event] ${eventName}`, data);
+      switch (eventName) {
+        case 'reference_file:click':
+          if (data.file_type === 'image') return;
+
+          if (!data.parse_url) {
+            if (!data.uid) {
+              if (data.references) return;
+              return message.warning('文件还未解析完成,请稍后预览');
+            }
+            referenceFile_question_upload(data);
+            return;
+          }
+          setCurFileInfo({
+            ...data,
+            file_type: data.type,
+            file_name: data.file,
+          });
+          setDrawerType('preview');
+          setOpen(true);
+
+          break;
+        case 'referenceFile_question':
+          referenceFile_question_upload(data.data);
+          break;
+        case 'retrive_tag:click':
+          if (data?.graph?.id) {
+            //图谱溯源
+            setDrawerType('graphPreview');
+            setCurFileInfo({ ...data.graph, traceNode: data.traceNode });
+            setOpen(true);
+            return;
+          }
+          if (!data?.tagInfo && !data?.file && !data?.referenceDoc) return;
+          const curFile = data?.referenceDoc || data?.file || data?.tagInfo;
+          const { pdfPages, parsedFilePath, order_num, metadata, tags } = curFile;
+          if (curFile.type == 'video') {
+            setCurFileInfo({
+              ...metadata,
+              displayType: 'retrive',
+            });
+            setDrawerType('video');
+            setOpen(true);
+            return;
+          }
+
+          const id = curFile.id || order_num || 'Unknown ID';
+          // 解析 source 字段
+          const sourceParts = metadata.source.split('/');
+          const fileName = sourceParts[sourceParts.length - 1] || '';
+          const fileParts = fileName.split('.');
+          const label = fileParts.slice(0, -1).join('.') || 'Unknown Label';
+          const file_type = fileParts[fileParts.length - 1] || 'Unknown Type';
+
+          setContent({
+            id,
+            title: label,
+            file_name: fileName,
+            file_type: file_type,
+            file_source: getMarkExcludeType(file_type)
+              ? `${TempBaseUrl}${metadata.source}`
+              : parsedFilePath,
+            metadata: metadata,
+            pdfPages: pdfPages,
+          });
+          setDrawerType('mark');
+          setOpen(true);
+          break;
+        // --- 对话列表事件 ---
+        case 'conversation:item_click':
+          handleItemClick(data);
+          break;
+
+        case 'files:finished_animation_complete':
+          setFileStatuses([]);
+          break;
+
+        case 'conversation:create':
+          handleConversationCreate(data);
+          break;
+        case 'conversation:new_assistant_change':
+          // headlessChat 不需要处理助手切换
+          break;
+
+        // --- 发送器事件 ---
+        case 'sender:send':
+          handleSenderSend(data, data.clearFn);
+          break;
+        case 'sender:send_recommandQuestion':
+          // 点击推荐问题，视作一次普通发送
+          handleSenderSend(data, data.clearFn);
+          break;
+        case 'sender:action_upload':
+          // 触发文件上传按钮点击，打开文件选择对话框
+          if (fileInputRef.current) {
+            fileInputRef.current.click();
+          }
+          break;
+        case 'fileManager:change':
+          // 接收核心组件提供的文件管理方法引用
+          if (data) {
+            setUploadedFilesRef.current = data.setUploadedFiles;
+            removeFileRef.current = data.removeFile;
+            // 保存上传限制配置和已上传文件列表引用，供 handleFileSelect 使用
+            senderConfigRef.current = data?.senderConfig;
+            uploadedFilesRef.current = Array.isArray(data?.uploadedFiles) ? data.uploadedFiles : [];
+          }
+          break;
+        case 'sender:stop':
+          setStopFlag(); // 使用 hook 提供的停止函数
+          if (uploadController) {
+            uploadController.abort();
+            uploadController = null;
+          }
+          if (stopPoll) {
+            stopPoll();
+            stopPoll = null;
+          }
+          setAppStatus(pre => ({ ...pre, display: 'ready', sender: 'ready' }));
+          setFileStatuses([]);
+          stopStream?.();
+          break;
+        case 'sender:clear':
+          data.clearFn?.();
+          break;
+        case 'sender:configChange':
+          // 配置项变化，记录最新 switch 状态
+          if (data && data.all) {
+            setSenderSwitchValues(data.all);
+          }
+          break;
+        case 'chatbox:follow_up_question_click': {
+          // 新链路：来自 ChatMessageAdapter 的追问点击
+          const content = (data?.question ?? data?.content ?? '').toString();
+          if (!content) break;
+          handleSenderSend({ content }, () => {});
+          break;
+        }
+        case 'chatbox:copy': {
+          const text = data?.content || '';
+          if (!text) break;
+          // 直接使用 Clipboard API，避免依赖 event.currentTarget
+          const copyByClipboardApi = async (t: string) => {
+            try {
+              await navigator.clipboard.writeText(t);
+              message.success('已复制到剪贴板');
+              return true;
+            } catch (_) {
+              return false;
+            }
+          };
+          const fallbackCopy = (t: string) => {
+            const textarea = document.createElement('textarea');
+            textarea.value = t;
+            textarea.style.position = 'fixed';
+            textarea.style.opacity = '0';
+            document.body.appendChild(textarea);
+            textarea.focus();
+            textarea.select();
+            try {
+              document.execCommand('copy');
+              message.success('已复制到剪贴板');
+            } catch (_) {
+              message.error('复制失败');
+            }
+            document.body.removeChild(textarea);
+          };
+          copyByClipboardApi(text).then(ok => {
+            if (!ok) fallbackCopy(text);
+          });
+          break;
+        }
+        case 'chatbox:repeat':
+          handleReSenderSend(data);
+          break;
+        case 'chatbox:like':
+          handleThumbsup({ queryId: data?.queryId, restult: data?.result });
+          break;
+        case 'chatbox:dislike':
+          if (data?.result === 0) {
+            handleCancelFeedBack({ url, token }, { queryId: data.queryId }, () => {
+              setFeed(data.queryId, null);
+            });
+          } else {
+            setFeedParam({ queryId: data?.queryId });
+            setOpenFeed(true);
+          }
+          break;
+
+        // --- 消息卡片事件 ---
+        case 'action_copy:click':
+          if (data) {
+            toCopy(data.content, data.event);
+          }
+          break;
+        case 'action_retry':
+          handleReSenderSend(data);
+          break;
+        case 'action_thumbsup':
+          handleThumbsup(data);
+          break;
+        case 'references:click': {
+          // 使用 AiChat 内置的右侧栏事件
+          const Content = () => {
+            // const safe = (() => {
+            //   try {
+            //     return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+            //   } catch (e) {
+            //     return String(data);
+            //   }
+            // })();
+            return (
+              <ReferenceBar
+                type={DrawerType.REFERENCELIST}
+                data={data}
+                token={token}
+                is_download={is_download}
+              />
+            );
+          };
+          const setContentEvent = new CustomEvent('aichat:right_set_content', {
+            detail: { content: <Content /> },
+          });
+          window.dispatchEvent(setContentEvent);
+          const openEvent = new CustomEvent('aichat:right_set', {
+            detail: { collapsed: false },
+          });
+          window.dispatchEvent(openEvent);
+          break;
+        }
+        case 'action_thumbsdown':
+          if (data.restult === 0) {
+            handleCancelFeedBack({ url, token }, { queryId: data.queryId }, () => {
+              setFeed(data.queryId, null);
+            });
+          } else {
+            setFeedParam(data);
+            setOpenFeed(true);
+          }
+          break;
+        // --- 文件管理器上传文件删除事件，透传到业务层 ---
+        case 'uploaded_file:removeFromTemp': {
+          console.log('[DEBUG] mergedEventsEmit uploaded_file:removeFromTemp 事件', data);
+
+          const uid = data?.file?.uid;
+          if (!uid) {
+            console.warn('[DEBUG] 缺少uid，无法删除临时文件', data);
+            break;
+          }
+          // 获取当前对话最后一条用户消息的 queryId
+          const lastUserMsg = [...(currentChatData?.messages || [])]
+            .reverse()
+            .find((msg: any) => msg.istype === 'user');
+          const queryId = lastUserMsg?.queryId;
+          console.log('[DEBUG] mergedEventsEmit 获取到 queryId', queryId, lastUserMsg);
+
+          // 使用统一的文件删除处理函数
+          handleRemoveFromTemp(uid, queryId);
+          break;
+        }
+        case 'uploaded_file:item_click': {
+          // 处理文件列表项点击，触发预览
+          const file = data?.file;
+          if (!file) break;
+
+          // 获取文件信息
+          const fileName = file.name || file.file?.name || '';
+          const fileExt = fileName.split('.').pop()?.toLowerCase() || '';
+          const fileType = file.type || fileExt;
+
+          // 构建预览数据，参考 referenceFile_question_upload 的逻辑
+          const previewData = {
+            ...file,
+            file_type: fileType,
+            file_name: fileName,
+            uid: file.uid,
+            url: file.url || file.preview,
+            convertedFilePath: file.convertedFilePath,
+            metadata: file.metadata || { source: file.url || file.preview },
+          };
+
+          // 如果是图片等可直接预览的类型，直接打开预览
+          if (fileViewTypes.includes(fileExt)) {
+            // 关闭文件列表 Popover，避免与预览 Drawer 重叠
+            setFileListPopoverOpenRef.current?.(false);
+            setCurFileInfo({
+              ...previewData,
+              parse_url:
+                previewData.url || previewData.metadata?.source
+                  ? `${TempBaseUrl}${previewData.metadata.source}`
+                  : previewData.url || previewData.convertedFilePath || '',
+            });
+            setDrawerType('preview');
+            setOpen(true);
+            break;
+          }
+
+          // 如果有转换后的文件路径，直接使用
+          if (previewData.convertedFilePath) {
+            // 关闭文件列表 Popover，避免与预览 Drawer 重叠
+            setFileListPopoverOpenRef.current?.(false);
+            setCurFileInfo({
+              ...previewData,
+              parse_url: previewData.convertedFilePath,
+            });
+            setDrawerType('preview');
+            setOpen(true);
+            break;
+          }
+
+          // 如果有 uid，尝试获取文件状态（参考 referenceFile_question_upload）
+          if (previewData.uid) {
+            api_getFileStatusByUid({
+              data: { uids: previewData.uid },
+              config: {
+                url: getUrlPrefix(),
+                token: configId || token,
+                enableMock: false,
+              },
+            })
+              .then((res: any) => {
+                // 关闭文件列表 Popover，避免与预览 Drawer 重叠
+                setFileListPopoverOpenRef.current?.(false);
+                if (res?.length) {
+                  const fileStatus = res[0];
+                  setCurFileInfo({
+                    ...previewData,
+                    parse_url: fileStatus.convertedFilePath || previewData.url || '',
+                  });
+                  setDrawerType('preview');
+                  setOpen(true);
+                } else {
+                  // 如果没有获取到状态，尝试直接使用 url
+                  if (previewData.url) {
+                    setCurFileInfo({
+                      ...previewData,
+                      parse_url: previewData.url,
+                    });
+                    setDrawerType('preview');
+                    setOpen(true);
+                  }
+                }
+              })
+              .catch((error: any) => {
+                console.error('获取文件状态失败:', error);
+                // 关闭文件列表 Popover
+                setFileListPopoverOpenRef.current?.(false);
+                // 失败时尝试直接使用 url
+                if (previewData.url) {
+                  setCurFileInfo({
+                    ...previewData,
+                    parse_url: previewData.url,
+                  });
+                  setDrawerType('preview');
+                  setOpen(true);
+                }
+              });
+          } else if (previewData.url) {
+            // 没有 uid 但有 url，直接使用
+            // 关闭文件列表 Popover，避免与预览 Drawer 重叠
+            setFileListPopoverOpenRef.current?.(false);
+            setCurFileInfo({
+              ...previewData,
+              parse_url: previewData.url,
+            });
+            setDrawerType('preview');
+            setOpen(true);
+          }
+          break;
+        }
+
+        default:
+          // 其他未处理事件可继续向上层抛出
+          eventsEmit?.(eventName, data);
+      }
+    };
+
+    // =================================================================
+    // Component & UI Configuration - 组件及UI配置
+    // =================================================================
+
+    /**
+     * Sidebar 配置 - headlessChat 不需要左侧历史对话栏
+     */
+    const sidebar = undefined;
+
+    /**
+     * 业务层自定义组件
+     */
+    const businessCustomComponents: { [key: string]: any } = {
+      AiChatBox: (msg: any, idx: number) => {
+        const isLastMessage = idx === (currentChatData?.messages?.length || 0) - 1;
+
+        // 根据消息的 status 和 appStatus 来确定 displayStatus
+        let displayStatus = 'ready';
+        if (isLastMessage) {
+          // 优先使用消息的 status 字段
+          if (msg.status !== undefined) {
+            switch (msg.status) {
+              case 0: // StatusType.Pending
+                displayStatus = 'thinking';
+                break;
+              case 1: // StatusType.Process
+                displayStatus = 'processing';
+                break;
+              case 2: // StatusType.Done
+                displayStatus = 'ready';
+                break;
+              case 3: // StatusType.Error
+                displayStatus = 'error';
+                break;
+              default:
+                displayStatus = appStatus.display;
+            }
+          } else {
+            // 如果没有 status 字段，使用 appStatus.display
+            displayStatus = appStatus.display;
+          }
+        }
+        // 将推荐问题强制转换为数组，避免切换会话时报 .map 错误
+        let safeFollowUps: string[] = [];
+        if (Array.isArray(recommandQuestions)) {
+          safeFollowUps = recommandQuestions as string[];
+        } else if (typeof recommandQuestions === 'string') {
+          try {
+            safeFollowUps = JSON.parse(recommandQuestions) || [];
+          } catch {
+            safeFollowUps = [];
+          }
+        }
+        // 保证传入 ChatMessageAdapter 的 reference/webReference/graphReference 始终是有效的 JSON 字符串
+        const safeReference = (() => {
+          const r = (msg as any)?.reference;
+          if (!r) return '[]';
+          if (typeof r === 'string') {
+            try {
+              JSON.parse(r);
+              return r;
+            } catch {
+              return '[]';
+            }
+          }
+          try {
+            return JSON.stringify(r);
+          } catch {
+            return '[]';
+          }
+        })();
+        const safeWebReference = (() => {
+          const r = (msg as any)?.webReference;
+          if (!r) return '[]';
+          if (typeof r === 'string') {
+            try {
+              JSON.parse(r);
+              return r;
+            } catch {
+              return '[]';
+            }
+          }
+          try {
+            return JSON.stringify(r);
+          } catch {
+            return '[]';
+          }
+        })();
+        const safeGraphReference = (() => {
+          const r = (msg as any)?.graphReference;
+          if (!r) return '[]';
+          if (typeof r === 'string') {
+            try {
+              JSON.parse(r);
+              return r;
+            } catch {
+              return '[]';
+            }
+          }
+          try {
+            return JSON.stringify(r);
+          } catch {
+            return '[]';
+          }
+        })();
+        return (
+          <div>
+            <ChatMessageAdapter
+              key={`${msg?.queryId || msg?.id || idx}-${msg?.istype || 'unknown'}`}
+              {...msg}
+              referenceMode="button"
+              reference={safeReference}
+              webReference={safeWebReference}
+              graphReference={safeGraphReference}
+              contentType="stream"
+              displayStatus={displayStatus}
+              eventsEmit={mergedEventsEmit}
+              // 仅最后一条 AI 消息展示追问
+              isLast={isLastMessage && msg?.istype === 'ai'}
+              followUpQuestions={isLastMessage && msg?.istype === 'ai' ? safeFollowUps : []}
+              defaultAnswer={
+                currentChatData?.searchConfigDTO?.defaultAnswer ||
+                '不知道什么原因我们没能查到你要的问题*-*'
+              }
+              styles={styles}
+            />
+            {!!msg?.resultType && (
+              <div
+                style={{ display: 'flex', justifyContent: 'center', ...(disclaimers?.style || {}) }}
+              >
+                {msg?.resultType == 2
+                  ? disclaimers?.faqText || disclaimers?.text
+                  : disclaimers?.text}
+              </div>
+            )}
+          </div>
+        );
+      },
+      LogoBox: () => <div className="text-2xl w-full text-center font-bold">智能助手</div>,
+      DisplayLoading: () => <DisplayLoading />,
+      DisplayError: () => <DisplayError />,
+      AppError: () => <AppError />,
+      AppLoading: () => <AppLoading />,
+      UserChatBox: (msg: any, idx: number) => {
+        return (
+          <ChatMessageAdapter
+            key={`${msg?.queryId || msg?.id || idx}-user`}
+            {...msg}
+            referenceMode="button"
+            contentType="plainText"
+            isUser={true}
+            displayStatus="ready"
+            eventsEmit={mergedEventsEmit}
+            styles={styles}
+            fileManagerData={fileManagerData}
+          />
+        );
+      },
+      WelcomeComponent: () => (
+        <GientechNewChatWelcome
+          eventsEmit={mergedEventsEmit}
+          assistantList={assistantList}
+          styles={styles}
+          // defaultSelect={newAssistantId || assistantList[0]?.id}
+        />
+      ),
+    };
+
+    /**
+     * 合并外部传入和业务默认的自定义组件，外部优先
+     */
+    const mergedCustomComponents: { [key: string]: any } = { ...businessCustomComponents };
+    if (rest.CustomComponents) {
+      Object.keys(rest.CustomComponents).forEach(key => {
+        const val = rest.CustomComponents?.[key];
+        if (val !== undefined) {
+          mergedCustomComponents[key] = val;
+        }
+      });
+    }
+
+    // 使用统一的文件展示工具 Hook
+    const { FileDisplayTools, setFileListPopoverOpen } = useFileDisplayTools({
+      fileManagerData,
+      styles,
+      eventsEmit: mergedEventsEmit,
+    });
+    // 保存 setFileListPopoverOpen 到 ref，以便在 mergedEventsEmit 中访问
+    setFileListPopoverOpenRef.current = setFileListPopoverOpen;
+
+    // =================================================================
+    // Render - 渲染
+    // =================================================================
+    return (
+      <>
+        {/* 隐藏的文件上传input */}
+        <input
+          ref={fileInputRef}
+          type="file"
+          multiple
+          accept="image/*,.pdf,.doc,.docx,.ppt,.pptx,.xls,.xlsx,.txt,.md,.json,.csv,.zip,.rar,.7z"
+          style={{ display: 'none' }}
+          onChange={handleFileSelect}
+        />
+
+        <WrappedComponent
+          activeSessionId={activeSessionId}
+          status={appStatus}
+          chatData={currentChatData}
+          sidebar={sidebar}
+          recommandQuestions={[]}
+          eventsEmit={mergedEventsEmit}
+          styles={styles}
+          senderConfig={dynamicSenderConfig}
+          fileUploadStatus={fileStatuses}
+          CustomComponents={mergedCustomComponents}
+          rightbarWidth={'400px'}
+          chatHeader={{
+            title: rest.title || '智能助手',
+            tools: FileDisplayTools,
+          }}
+        />
+        <FeedBackModal
+          open={openFeed}
+          feedBackList={feedBackList}
+          setOpen={setOpenFeed}
+          handleConfirm={handleFeedDownConfirm}
+        />
+        <ConfigProvider
+          drawer={{
+            styles: {
+              body: { padding: 0 },
+              header: { display: 'none' },
+            },
+          }}
+        >
+          <Drawer
+            autoFocus={false}
+            onClose={() => setOpen(false)}
+            open={open}
+            width={drawerType === 'graphPreview' ? '100%' : 720}
+            className="overflow-x-hidden"
+            destroyOnClose
+            afterOpenChange={open => {
+              if (!open) {
+                setContent(null);
+              }
+            }}
+          >
+            {drawerType === 'preview' && (
+              <DrawerPreview curFileInfo={curFileInfo} onClose={setOpen} token={token} />
+            )}
+            {drawerType === 'mark' && (
+              <DrawerContent
+                content={content as any}
+                onClose={() => setOpen(false)}
+                token={token}
+              />
+            )}
+          </Drawer>
+        </ConfigProvider>
+      </>
+    );
+  };
+}