@mxmweb/aichat 1.1.7 → 1.1.8

package/src/adopters/HeadLessChat/index.tsx

@@ -0,0 +1,1038 @@
+import React, { useEffect, useState, useMemo, useRef } from 'react';
+import AiChat, { AppStatusManager, SidebarTabConfig } from '../../components/AiChat';
+import request from '../gientechCommon/utils/request';
+import { isCancel } from 'axios';
+import dayjs from 'dayjs';
+
+import {
+  getFeedbackList,
+  handleCancelFeedBack,
+  handleFeedBack,
+  removeFilefromTempUpload,
+} from '../gientechCommon/utils/serverFn';
+import { getFileTypeByName, toCopy } from '../../utils/commonFn';
+import { uid } from 'uid';
+
+import AiChatBox from '../gientechCommon/components/Messages/AiChatBox';
+import UserChatBox from '../gientechCommon/components/Messages/UserChatBox';
+import GientechNewChatWelcome from '../gientechCommon/components/Messages/GientechNewChatWelcome';
+import AichatUseController from '../gientechCommon/hooks/AichatUseController';
+import FeedBackModal from '../gientechCommon/components/FeedBackModal';
+import { message, Modal } from 'antd';
+import FileManager from '../gientechCommon/components/FileManager';
+import AppLoading from '../gientechCommon/components/AppLoading';
+import DisplayLoading from '../gientechCommon/components/DisplayLoading';
+import AppError from '../gientechCommon/components/AppError';
+import DisplayError from '../gientechCommon/components/DisplayError';
+import { DefaultSenderConfig } from './constants';
+import { maxPollCount, maxPollInterval } from '../gientechCommon/configs/commonConfig';
+import { getNameFromFile } from '../../utils';
+
+interface UploadedFile {
+  name: string;
+  size: number;
+  type: string;
+  filePath: string;
+  convertedFilePath?: string;
+  uid: string;
+}
+
+interface EmptyMessageData {
+  content: string;
+  filePaths?: string;
+  queryId: string;
+  currentFiles?: UploadedFile[];
+}
+
+interface HeadlessChatAdopterProps {
+  token: string;
+  url?: string;
+  configId?: string;
+  useLogin?: boolean;
+  styles?: any;
+  welcomeContent?: string;
+  onError?: (ems: any) => void;
+  eventsEmit?: (eventName: string, data: any) => void;
+  [key: string]: any;
+}
+
+export default function withHeadLessChatAdopter(WrappedComponent = AiChat) {
+  /**
+   * GientechChatAdopter 高阶组件
+   * 封装了与Gientech后端服务的接口对接、状态管理、事件处理等核心业务逻辑
+   * @param {React.ComponentType} WrappedComponent - 需要包裹的基础聊天组件，默认为 AiChat
+   */
+  return function GientechChatAdopter({
+    token,
+    url = 'http://localhost:8888',
+    welcomeContent = '欢迎来到小鲸智能助手，有什么能帮你的么？',
+    styles,
+    eventsEmit,
+    onError,
+    configId,
+    ...rest
+  }: HeadlessChatAdopterProps) {
+    // =================================================================
+    // 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, setAssistantList] = useState<any[]>([]); // 智能体（助手）列表
+    const [newAssistantId, setNewAssistantId] = useState<string | undefined>(undefined); // 新建对话时选择的智能体ID
+    const [fileManagerOpen, setFileManagerOpen] = useState<boolean>(false); // 文件管理器抽屉的开关状态
+    const [appStatus, setAppStatus] = useState<AppStatusManager>({
+      display: 'ready', // 主聊天区域状态: ready, loading, processing, error, uploading
+      sender: 'ready', // 发送器状态: ready, processing, error, uploading
+      app: 'initializing', // 应用整体状态: initializing, ready, error
+    });
+    const [pendingFiles, setPendingFiles] = useState<any[]>([]); // 准备上传的文件列表
+    const [dynamicSenderConfig, setDynamicSenderConfig] = useState(DefaultSenderConfig); // 动态的发送器配置
+    const [fileStatuses, setFileStatuses] = useState<any[]>([]); // 用于跟踪每个上传文件的状态
+    const [fileManagerData, setFileManagerData] = useState<{ uploadedFiles: any[] }>({
+      uploadedFiles: [],
+    });
+    useEffect(() => {
+      console.log('chatDatachatDatachatData', chatData);
+    }, [chatData]);
+    // =================================================================
+    // 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 [feedParam, setFeedParam] = useState<{
+      queryId?: number | string | undefined;
+      restult?: number;
+    }>({});
+    const [openFeed, setOpenFeed] = useState(false);
+    const [feedBackList, setFeedBackList] = useState<any>([]);
+    const stoppedRef = useRef(false);
+
+    // =================================================================
+    // Custom Hooks - 自定义钩子
+    // =================================================================
+    // 引入SSE控制器，封装了流式请求、消息管理等复杂逻辑
+    const {
+      api_startChat_re,
+      addEmptyMessage,
+      setLastEmptyMessage,
+      stopStream,
+      updateUserFilesMessage,
+    } = 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]);
+
+    /**
+     * 用 useEffect 监听 currentChatData 自动同步
+     */
+    useEffect(() => {
+      let uploaded: any[] = [];
+      const lastAiMsg = [...(currentChatData.messages || [])]
+        .reverse()
+        .find((msg: any) => msg.istype === 'ai');
+      if (lastAiMsg?.reference && lastAiMsg.resultType === 5) {
+        try {
+          const fileList = JSON.parse(lastAiMsg.reference);
+          uploaded = fileList.map((f: any) => ({
+            file: {
+              name: f.name,
+              size: Number(f.size?.replace('MB', '')) * 1024 * 1024 || 0,
+              type: f.type,
+            } as File,
+            type: getFileTypeByName(f.name),
+            status: 'uploaded' as const,
+            url: f.filePath,
+            convertedFilePath: f.convertedFilePath,
+            uid: f.uid,
+            preview: f.type === 'image' ? f.filePath : undefined,
+          }));
+        } catch (e) {}
+      }
+      // 只有 reference 有内容时才 set，避免无意义清空
+      if (uploaded.length > 0) {
+        setFileManagerData({ uploadedFiles: uploaded });
+      }
+      // 否则不 set，保持上一次的 uploadedFiles
+    }, [currentChatData]);
+
+    // =================================================================
+    // 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 (configId && 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]);
+
+    /**
+     * 监听文件数据变化，更新Sender上的角标
+     */
+    useEffect(() => {
+      const totalFiles = fileManagerData.uploadedFiles.length;
+      setDynamicSenderConfig(prev => {
+        const newConfig = {
+          ...prev,
+          actions: prev.actions.map(action =>
+            action.name === 'history' ? { ...action, badgeCount: totalFiles } : action
+          ),
+        };
+        return newConfig;
+      });
+    }, [fileManagerData.uploadedFiles]);
+    useEffect(() => {
+      getFeedbackList({ url, token }, data => {
+        setFeedBackList(data);
+      });
+    }, []);
+    // =================================================================
+    // Core Functions - 核心功能函数
+    // =================================================================
+
+    // 1. 在组件作用域定义控制器和轮询停止标志
+    let uploadController: AbortController | null = null;
+    let stopPoll: (() => void) | null = null;
+
+    /**
+     * 轮询文件解析状态
+     * @param {string[]} uids - 文件UID列表
+     * @param {(serverStatuses: any[]) => void} onStatusUpdate - 每次获取到新状态后的回调
+     * @param {() => void} onComplete - 所有文件解析完成后的回调
+     * @param {(errorMsg: string) => void} onFail - 轮询失败或超时的回调
+     */
+    const pollFileStatus = (
+      uids: string[],
+      onStatusUpdate: (serverStatuses: any[]) => void,
+      onComplete: () => void,
+      onFail: (errorMsg: string) => void
+    ) => {
+      const uidsString = uids.join(',');
+      let pollCount = 0;
+      //const maxPollCount = maxPollCount;
+      stopPoll = () => {
+        stoppedRef.current = true;
+      };
+
+      const checkStatus = async () => {
+        if (stoppedRef.current) return;
+        if (pollCount >= maxPollCount) {
+          if (!stoppedRef.current) onFail('文件解析超时，请稍后重试');
+          return;
+        }
+        pollCount++;
+        try {
+          const res = await request.get(
+            `${url}/index/knowledgeBase/file/getFileStatusByUids?uids=${uidsString}`,
+            {
+              headers: { Authorization: token },
+            }
+          );
+          if (stoppedRef.current) return;
+          if (res.data.success) {
+            const statuses = res.data.data;
+            if (!stoppedRef.current) onStatusUpdate(statuses);
+            const allDone = statuses.every((file: any) => file.status === 3);
+            if (allDone) {
+              if (!stoppedRef.current) onComplete();
+            } else {
+              if (!stoppedRef.current) setTimeout(checkStatus, maxPollInterval);
+            }
+          } else {
+            if (!stoppedRef.current) onFail(res.data.errorMsg || '查询文件状态失败');
+          }
+        } catch (error) {
+          onError?.(error);
+          if (stoppedRef.current) return;
+          onFail('查询文件状态时发生网络错误');
+        }
+      };
+      checkStatus();
+    };
+
+    /**
+     * 设置消息的反馈结果（赞/踩）
+     * @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([]);
+      }
+    };
+
+    /**
+     * 处理重新发送消息逻辑
+     */
+    function handleReSenderSend(data: any) {
+      const { content, audioUrl, filePaths, queryId } = data;
+      if (!content) return;
+      const _fileUids = (
+        typeof filePaths === 'string' && filePaths ? JSON.parse(filePaths) : filePaths || []
+      ).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))
+      );
+      api_startChat_re(
+        {
+          configId: configId || currentChatData.configId,
+          content,
+          fileUids: _fileUids,
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: queryId,
+          sessionId: activeSessionId,
+          type: audioUrl ? 'audioUrl' : 'text',
+          audioUrl,
+          sysType: 'TEMPORARY',
+        },
+        gmtModified => {
+          fetchRecommendQuestions(queryId);
+        }
+      );
+    }
+
+    /**
+     * 处理消息发送（核心逻辑）
+     * 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();
+        stoppedRef.current = false;
+        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
+          ) {
+            updateUserFilesMessage({
+              currentFiles: response.data.data.map((item: any) => {
+                return {
+                  filePath: item.filePath,
+                  name: item.fileName,
+                  type: getNameFromFile(item.fileName || item.fileName),
+                };
+              }),
+            });
+            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;
+                  });
+                });
+              },
+              // onComplete: 全部解析成功后才发起AI请求
+              () => {
+                clearFn?.();
+                setAppStatus(pre => ({ ...pre, sender: 'processing', display: 'processing' }));
+                setFileStatuses(prev => prev.map(f => ({ ...f, status: 'finished' })));
+                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',
+                  },
+                  gmtModified => {
+                    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?.();
+      api_startChat_re(
+        {
+          configId: configId || currentChatData.configId,
+          content: data.content || data.text || '',
+          fileUids: [],
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: queryId,
+          sessionId: activeSessionId,
+          type: 'text',
+          audioUrl: '',
+          sysType: 'TEMPORARY',
+        },
+        gmtModified => {
+          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 || '';
+      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 (effectiveConfigId && 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 handleFileManagerUpload = (fileList: FileList) => {
+      // 1. 收集所有已经存在的文件名
+      const existingFileNames = new Set<string>([
+        ...fileManagerData.uploadedFiles.map((f: any) => f.file.name as string),
+        ...pendingFiles.map((f: any) => f.file.name as string),
+      ]);
+
+      const newFiles: { file: File; type: string; status: string; preview?: string }[] = [];
+      const duplicateFileNames = new Set<string>();
+
+      // 2. 遍历新选择的文件，筛选出重复项和有效项
+      Array.from(fileList).forEach(file => {
+        if (existingFileNames.has(file.name)) {
+          duplicateFileNames.add(file.name);
+        } else {
+          newFiles.push({
+            file,
+            type: getFileTypeByName(file.name),
+            status: 'pending',
+            preview: file.type.startsWith('image') ? URL.createObjectURL(file) : undefined,
+          });
+          existingFileNames.add(file.name); // 添加到Set中，以防本次上传的文件之间有重复
+        }
+      });
+
+      // 3. 如果有重复，发出警告
+      if (duplicateFileNames.size > 0) {
+        message.warning(`不能上传同名文件: ${Array.from(duplicateFileNames).join(', ')}`);
+      }
+
+      // 4. 将有效的文件添加到待上传列表
+      if (newFiles.length > 0) {
+        setPendingFiles(prev => [...prev, ...newFiles]);
+        // 直接同步到核心发送器组件
+        setUploadedFilesRef.current?.(newFiles);
+      }
+    };
+
+    /**
+     * 文件管理器：处理文件移除
+     */
+    const handleFileManagerRemove = (fileObj: any, idx: number, _type: string) => {
+      removeFileRef.current?.(fileObj, idx, _type);
+    };
+
+    /**
+     * 处理会话列表项点击
+     */
+    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 mergedEventsEmit = (eventName: string, data: any) => {
+      console.log(`[Event] ${eventName}`, data);
+      switch (eventName) {
+        // --- 对话列表事件 ---
+        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':
+          setNewAssistantId(data.assistantId);
+          break;
+
+        // --- 发送器事件 ---
+        case 'sender:send':
+          handleSenderSend(data, data.clearFn);
+          break;
+        case 'sender:send_recommandQuestion':
+          // 点击推荐问题，视作一次普通发送
+          handleSenderSend(data, data.clearFn);
+          break;
+        case 'sender:action_history':
+          setFileManagerOpen(true);
+          break;
+        case 'sender:stop':
+          stoppedRef.current = true;
+          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':
+          // 配置项变化，可在此处理
+          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 '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;
+          }
+          // 获取当前对话最后一条 AI 消息的 queryId
+          const lastAiMsg = [...(currentChatData.messages || [])]
+            .reverse()
+            .find((msg: any) => msg.istype === 'user');
+          const queryId = lastAiMsg?.queryId;
+          console.log('[DEBUG] mergedEventsEmit 获取到 queryId', queryId, lastAiMsg);
+
+          removeFilefromTempUpload({ url, token }, { uid, queryId }, (success, res) => {
+            console.log('[DEBUG] removeFilefromTempUpload 回调触发', { success, res });
+            if (success) {
+              message.success('文件已从临时知识库移除');
+              // 用后端返回的新data数组（新文件列表）更新本地uploadedFiles
+              //console.log('[DEBUG] removeFilefromTempUpload 回调 true，res:', res, Array.isArray(res.data && res.data.data));
+              if (res && Array.isArray(res.data && res.data.data)) {
+                const uploaded = res.data.data.map((f: any) => {
+                  const fileName = f.name || f.fileName || '';
+                  return {
+                    file: {
+                      name: fileName,
+                      size: Number(f.size?.replace('MB', '')) * 1024 * 1024 || 0,
+                      type: f.type,
+                    } as File,
+                    type: getFileTypeByName(fileName),
+                    status: 'uploaded' as const,
+                    url: f.filePath,
+                    convertedFilePath: f.convertedFilePath,
+                    uid: f.uid,
+                    preview: f.type === 'image' ? f.filePath : undefined,
+                  };
+                });
+                // console.log('[DEBUG] uploaded 构造完成:', uploaded, '当前 fileManagerData:', fileManagerData);
+                setFileManagerData({ uploadedFiles: uploaded });
+              } else {
+                //console.log('[DEBUG] res.data.data 不是数组', res && res.data && res.data.data);
+              }
+            } else {
+              console.log('[DEBUG] removeFilefromTempUpload 回调 false，res:', res);
+              message.error('文件移除失败');
+            }
+          });
+          break;
+        }
+        // --- 文件管理器事件 ---
+        case 'fileManager:change': {
+          const files = Array.isArray(data?.uploadedFiles) ? data.uploadedFiles : [];
+          setPendingFiles(files);
+          // 保存核心组件传递的文件处理函数引用
+          if (typeof data?.setUploadedFiles === 'function') {
+            setUploadedFilesRef.current = data.setUploadedFiles;
+            removeFileRef.current = data.removeFile;
+          }
+          break;
+        }
+
+        default:
+          // 其他未处理事件可继续向上层抛出
+          eventsEmit?.(eventName, data);
+      }
+    };
+
+    // =================================================================
+    // Component & UI Configuration - 组件及UI配置
+    // =================================================================
+
+    /**
+     * Sidebar 配置
+     */
+    const sidebar = undefined;
+
+    /**
+     * 业务层自定义组件
+     */
+    const businessCustomComponents: { [key: string]: any } = {
+      AiChatBox: (msg: any, idx: number) => {
+        const isLastMessage = idx === (currentChatData?.messages?.length || 0) - 1;
+        const displayStatus = isLastMessage ? appStatus.display : 'ready';
+        // console.log('AiChatBox', msg);
+        return (
+          <AiChatBox
+            {...msg}
+            displayStatus={displayStatus}
+            eventsEmit={mergedEventsEmit}
+            defaultAnswer={
+              currentChatData?.searchConfigDTO?.defaultAnswer ||
+              '不知道什么原因我们没能查到你要的问题*-*'
+            }
+            styles={styles}
+          />
+        );
+      },
+      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) => {
+        // console.log('UserChatBox files:', msg.files, 'currentFiles:', msg.currentFiles, 'filePaths:', msg.filePaths);
+        return (
+          <UserChatBox
+            {...msg}
+            eventsEmit={mergedEventsEmit}
+            isLast={idx === (currentChatData?.messages?.length || 0) - 2}
+            styles={styles}
+            idx={idx}
+          />
+        );
+      },
+      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;
+        }
+      });
+    }
+
+    // =================================================================
+    // Render - 渲染
+    // =================================================================
+    return (
+      <>
+        <FileManager
+          open={fileManagerOpen}
+          onCancel={() => setFileManagerOpen(false)}
+          files={fileManagerData.uploadedFiles}
+          currentFiles={pendingFiles}
+          onUpload={handleFileManagerUpload}
+          onRemoveFile={handleFileManagerRemove}
+          styles={styles}
+          eventsEmit={mergedEventsEmit}
+        />
+
+        <WrappedComponent
+          {...rest}
+          status={appStatus}
+          chatData={currentChatData}
+          sidebar={sidebar}
+          recommandQuestions={recommandQuestions}
+          eventsEmit={mergedEventsEmit}
+          styles={styles}
+          senderConfig={dynamicSenderConfig}
+          fileUploadStatus={fileStatuses}
+          CustomComponents={mergedCustomComponents}
+        />
+        <FeedBackModal
+          open={openFeed}
+          feedBackList={feedBackList}
+          setOpen={setOpenFeed}
+          handleConfirm={handleFeedDownConfirm}
+        />
+      </>
+    );
+  };
+}