@mxmweb/aichat 1.1.1 → 1.1.8

package/src/adopters/GientechChat/index.tsx

@@ -0,0 +1,1242 @@
+import React, { useEffect, useState, useMemo, useRef } from 'react';
+import AiChat, { AppStatusManager, SidebarTabConfig } from '../../components/AiChat';
+import axios from 'axios';
+
+import {
+  getFeedbackList,
+  handleCancelFeedBack,
+  handleDeleteConversation,
+  handleFeedBack,
+  handleRename,
+  removeFilefromTempUpload,
+} from '../gientechCommon/utils/serverFn';
+import {
+  convertQueryReplyPairListToMessages,
+  getFileTypeByName,
+  toCopy,
+} from '../../utils/commonFn';
+import { uid } from 'uid';
+
+import { History } from 'lucide-react';
+import GientechConversationPanel from './Conversations';
+
+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';
+
+interface UploadedFile {
+  name: string;
+  size: number;
+  type: string;
+  filePath: string;
+  convertedFilePath?: string;
+  uid: string;
+}
+
+interface GientechChatAdopterProps {
+  token: string;
+  url?: string;
+  styles?: any;
+  eventsEmit?: (eventName: string, data: any) => void;
+  [key: string]: any;
+}
+
+export default function withGientechChatAdopter(WrappedComponent = AiChat) {
+  /**
+   * GientechChatAdopter 高阶组件
+   * 封装了与Gientech后端服务的接口对接、状态管理、事件处理等核心业务逻辑
+   * @param {React.ComponentType} WrappedComponent - 需要包裹的基础聊天组件，默认为 AiChat
+   */
+  return function GientechChatAdopter({
+    token,
+    url = 'http://localhost:8888',
+    styles,
+    eventsEmit,
+    ...rest
+  }: GientechChatAdopterProps) {
+    // =================================================================
+    // 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[] }>(() => {
+      let uploaded: any[] = [];
+      return { uploadedFiles: uploaded };
+    });
+
+    // =================================================================
+    // Refs - 引用
+    // =================================================================
+    const prevActiveSessionId = useRef<string | undefined>(); // 记录上一个激活的对话ID，用于对比变化
+    const setUploadedFilesRef = useRef<(files: any[]) => void>(); // 引用核心组件的文件上传方法
+    const removeFileRef = useRef<(fileObj: any, idx: number, _type: string) => void>(); // 引用核心组件的文件移除方法
+    const deleteData = useRef({ sessionId: '' }); // 暂存待删除的对话数据
+    const confirmed = useRef<any>(null); // 暂存 antd Modal.confirm 的引用
+    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 } =
+      AichatUseController({
+        baseUrl: url,
+        token,
+        setChatData,
+        activeSessionId,
+        setAppStatus,
+        setConversationList,
+      });
+
+    // =================================================================
+    // Memoized Values - 缓存计算值
+    // =================================================================
+
+    /**
+     * 将智能体列表转换为以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(() => {
+      const data = chatData.find((c: any) => c.id === activeSessionId) || {
+        id: activeSessionId,
+        messages: [],
+      };
+      const assistantInfo = data.configId ? assistantMap[data.configId] : null;
+      return {
+        ...data,
+        assistantInfo,
+      };
+    }, [chatData, activeSessionId, assistantMap]);
+
+    /**
+     * 监听 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) {}
+      }
+      setFileManagerData({ uploadedFiles: uploaded });
+    }, [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]);
+
+    /**
+     * 首次加载时获取对话列表和智能体列表
+     */
+    useEffect(() => {
+      setAppStatus(prev => ({ ...prev, app: 'initializing' }));
+      Promise.all([
+        axios.get(`${url}/qa/dialogue/list?pageNo=1&pageSize=1000&sysType=INT_SESSION`, {
+          headers: { Authorization: token },
+        }),
+        axios.get(`${url}/qa/search/config/helper/list?pageNo=1&pageSize=3000`, {
+          headers: { Authorization: token },
+        }),
+      ])
+        .then(([convRes, assistantRes]) => {
+          const rawList = convRes.data.data.records || [];
+          setConversationList(rawList);
+          // 如果有对话列表，默认选中第一个
+          if (rawList.length > 0 && !activeSessionId) {
+            setActiveSessionId(rawList[0].sessionId);
+          }
+          // 如果对话列表为空，自动新建一个欢迎会话
+          if (rawList.length === 0) {
+            handleConversationCreate({});
+          }
+          setAssistantList(assistantRes.data.data || []);
+          setAppStatus(prev => ({ ...prev, app: 'ready' }));
+        })
+        .catch(err => {
+          setAppStatus(prev => ({ ...prev, app: 'error' }));
+        });
+    }, [url, token]);
+
+    /**
+     * 当 activeSessionId 变化时，获取对应的聊天记录
+     */
+    useEffect(() => {
+      if (!activeSessionId) return;
+
+      setAppStatus(prev => ({ ...prev, display: 'loading' }));
+      axios
+        .get(`${url}/qa/dialogue/getDialogBySessionId?sessionId=${activeSessionId}`, {
+          headers: { Authorization: token },
+        })
+        .then(res => {
+          // 如果会话没有数据（例如新建的），直接返回
+
+          if (!res.data.data) {
+            setAppStatus(prev => ({ ...prev, display: 'ready' }));
+            return;
+          }
+          // 解析消息数据
+          const queryReplyPairList = res.data.data?.queryReplyPairList || [];
+          const messages = convertQueryReplyPairListToMessages(queryReplyPairList);
+          const { sessionId, searchConfigDTO, filePath, configId } = res.data.data;
+
+          // 更新对话列表中的对应项的元数据
+          const item = conversationList.find(item => item.sessionId === sessionId);
+          if (item) {
+            // console.log(item,'你大爷')
+            setConversationList(list =>
+              list.map(item =>
+                item.sessionId === sessionId
+                  ? { ...item, searchConfigDTO, filePath, configId }
+                  : item
+              )
+            );
+          }
+
+          // 构造当前对话的完整数据
+          const conversationConfig = {
+            configId: res.data.data.configId,
+            filePath: res.data.data.filePath,
+            searchConfigDTO: res.data.data.searchConfigDTO || {},
+            sessionId: res.data.data.sessionId,
+            label: res.data.data.label,
+            kbId: res.data.data.kbId,
+          };
+
+          // 更新聊天数据
+          setChatData(prev => {
+            const others = prev.filter((c: any) => c.id !== activeSessionId);
+            console.log(others, 'others');
+            const newChatData = [
+              { id: activeSessionId, messages, ...conversationConfig },
+              ...others,
+            ];
+            return newChatData;
+          });
+          setAppStatus(prev => ({ ...prev, display: 'ready' }));
+        })
+        .catch(err => {
+          console.error('获取聊天数据失败:', err);
+          if (err.response && err.response.status === 404) {
+            // 404 表示会话在后端不存在，按新建会话处理
+            handleConversationCreate({});
+          }
+          setAppStatus(prev => ({ ...prev, display: 'error' }));
+        });
+    }, [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);
+      });
+    }, []);
+
+    /**
+     * 实时同步 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 - 核心功能函数
+    // =================================================================
+    useEffect(() => {
+      console.log('来看看数据，地方的房价大幅借贷纠纷', fileManagerData);
+    }, [fileManagerData]);
+    // 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 = 3000;
+      stopPoll = () => {
+        stoppedRef.current = true;
+      };
+
+      const checkStatus = async () => {
+        if (stoppedRef.current) return;
+        if (pollCount >= maxPollCount) {
+          if (!stoppedRef.current) onFail('文件解析超时，请稍后重试');
+          return;
+        }
+        pollCount++;
+        try {
+          const res = await axios.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) {
+          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 axios.get(`${url}/qa/ai/recommendQuestion?queryId=${queryId}`, {
+          headers: { Authorization: token },
+        });
+        setRecommandQuestions(res.data?.data || []);
+      } catch (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: currentChatData.configId,
+          content,
+          fileUids: _fileUids,
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: queryId,
+          sessionId: String(activeSessionId || ''),
+          type: audioUrl ? 'audioUrl' : 'text',
+          audioUrl,
+        },
+        gmtModified => {
+          // 只在AI回复完成后请求推荐问题
+          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,
+      });
+      // 2. 文件上传逻辑 ---
+      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 = String(activeSessionId || '');
+        formData.append('sessionId', sessionIdStr);
+        formData.append('uids', clientFileUids.join(','));
+        try {
+          const response = await axios.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
+          ) {
+            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: currentChatData.configId,
+                    content: data.content || data.text || '',
+                    fileUids: serverUids,
+                    lastDate: now,
+                    name: currentChatData.label || '',
+                    queryId: queryId,
+                    sessionId: String(activeSessionId || ''),
+                    type: 'text',
+                    audioUrl: '',
+                  },
+                  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: currentChatData.configId,
+          content: data.content || data.text || '',
+          fileUids: [],
+          lastDate: now,
+          name: currentChatData.label || '',
+          queryId: queryId,
+          sessionId: String(activeSessionId || ''),
+          type: 'text',
+          audioUrl: '',
+        },
+        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);
+      // 新会话对象，等待用户输入后再发起创建请求
+      const newConversation = {
+        sessionId,
+        label: '未命名会话',
+        gmtModified: Date.now(),
+        searchConfigDTO: {},
+        filePath: '',
+        configId: '',
+        isNew: true, // 标记为新会话
+      };
+      // 在列表顶部插入新会话
+      setConversationList(list => [{ ...newConversation, messages: [] }, ...list]);
+      setChatData(list => [{ id: sessionId, messages: [], ...newConversation }, ...list]);
+      // 激活新会话
+      setActiveSessionId(sessionId);
+    }
+
+    /**
+     * 处理删除会话（打开确认弹窗）
+     */
+    const handleDelete = async (data: any) => {
+      try {
+        deleteData.current = data;
+        confirmed.current = await Modal.confirm({
+          title: '删除',
+          content: <span>删除后无法恢复，是否继续删除？</span>,
+          okText: '确定',
+          cancelText: '取消',
+          onOk: async () => {
+            try {
+              // 调用接口删除
+              handleDeleteConversation({ url, token }, deleteData.current, (res: any) => {
+                if (res) {
+                  message.success('删除成功!');
+                } else {
+                  message.success('删除失败!');
+                }
+              });
+            } catch (error) {
+              console.log(error);
+            }
+          },
+        });
+      } catch (error) {}
+    };
+
+    /**
+     * 文件管理器：处理文件选择后的上传
+     */
+    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([]);
+        }
+      }
+    }
+
+    // =================================================================
+    // Async Data Operations - 异步数据操作 (供事件发射器使用)
+    // =================================================================
+
+    /**
+     * 异步删除会话接口
+     */
+    const async_deleteConversation = async (sessionId: string) => {
+      return new Promise((resolve, reject) => {
+        handleDeleteConversation({ url, token }, { sessionId }, (res: any) => {
+          if (res) {
+            message.success('删除成功!');
+            resolve(res);
+          } else {
+            message.error('删除失败!');
+            reject(res);
+          }
+        });
+      });
+    };
+    /**
+     * 异步刷新会话列表接口
+     */
+    const async_refreshConversationList = async () => {
+      try {
+        const convRes = await axios.get(
+          `${url}/qa/dialogue/list?pageNo=1&pageSize=1000&sysType=INT_SESSION`,
+          {
+            headers: { Authorization: token },
+          }
+        );
+        const rawList = convRes.data.data.records || [];
+        setConversationList(rawList);
+        return rawList;
+      } catch (e) {
+        message.error('刷新会话列表失败');
+        throw e;
+      }
+    };
+
+    /**
+     * 异步重命名会话接口
+     */
+    const async_renameConversation = async (sessionId: string, newLabel: string) => {
+      return new Promise((resolve, reject) => {
+        handleRename({ url, token }, { label: newLabel, sessionId }, res => {
+          if (res) {
+            // 成功后立即更新本地状态
+            const now = Date.now();
+            setConversationList(list =>
+              list.map(item =>
+                item.sessionId === sessionId ? { ...item, label: newLabel, gmtModified: now } : item
+              )
+            );
+            message.success('重命名成功!');
+            resolve(res);
+          } else {
+            message.error('重命名失败');
+            reject(res);
+          }
+        });
+      });
+    };
+
+    // =================================================================
+    // Local State Updaters - 本地状态更新 (供事件发射器使用)
+    // =================================================================
+
+    /**
+     * 从本地状态中移除会话项
+     */
+    const fn_removeItemFromList = (sessionId: string) => {
+      setConversationList(list => {
+        const newList = list.filter(c => c.sessionId !== sessionId);
+        // 如果删除的是当前会话，则激活列表中的第一个
+        if (activeSessionId === sessionId) {
+          if (newList.length > 0) {
+            setActiveSessionId(newList[0].sessionId);
+          } else {
+            // 如果列表空了，则新建一个
+            handleConversationCreate({});
+          }
+        }
+        return newList;
+      });
+    };
+
+    /**
+     * 在本地状态中重命名会话项
+     */
+    const fn_renameItemInList = (sessionId: string, newLabel: string) => {
+      const now = Date.now();
+      setConversationList(list =>
+        list.map(item =>
+          item.sessionId === sessionId ? { ...item, label: newLabel, gmtModified: now } : item
+        )
+      );
+    };
+
+    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 'conversations:delete_icon_clicked':
+          // 向上暴露删除相关的方法
+          eventsEmit?.('conversations:delete_icon_clicked', {
+            data,
+            async_deleteConversation: () => async_deleteConversation(data.sessionId),
+            async_refreshConversationList,
+            fn_removeItemFromList: () => fn_removeItemFromList(data.sessionId),
+          });
+          break;
+        case 'conversations:rename_icon_clicked':
+          // 向上暴露重命名相关的方法
+          eventsEmit?.('conversations:rename_icon_clicked', {
+            data,
+            async_renameConversation: (newLabel: string) =>
+              async_renameConversation(data.sessionId, newLabel),
+            fn_renameItemInList: (newLabel: string) =>
+              fn_renameItemInList(data.sessionId, newLabel),
+          });
+          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 '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;
+        }
+
+        // --- 文件管理器上传文件删除事件，透传到业务层 ---
+        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 'uploaded_file:remove_batch':
+          console.log('hahah');
+          break;
+
+        default:
+          // 其他未处理事件可继续向上层抛出
+          eventsEmit?.(eventName, data);
+      }
+    };
+
+    // =================================================================
+    // Component & UI Configuration - 组件及UI配置
+    // =================================================================
+
+    /**
+     * Sidebar 配置
+     */
+    const sidebar: SidebarTabConfig[] = [
+      {
+        key: 'conversations',
+        type: 'custom',
+        label: '对话历史',
+        icon: <History size={16} />,
+        enabled: true,
+        component: (
+          <GientechConversationPanel
+            data={conversationList}
+            assistantList={assistantList}
+            activedItem={activeSessionId || ''}
+            sortRules={[
+              { label: '当天', dayPeriod: 1 },
+              { label: '3天', dayPeriod: 3 },
+              { label: '7天', dayPeriod: 7 },
+              { label: '30天', dayPeriod: 30 },
+            ]}
+            eventsEmit={mergedEventsEmit}
+            styles={styles?.theme}
+          />
+        ),
+      },
+      // {
+      //   key: 'llmConfig',
+      //   type: 'form',
+      //   label: '大模型配置',
+      //   icon: <Settings2 size={16} />,
+      //   enabled: true,
+      //   formConfig: mockFormConfig,
+      //   initialValues: { apiKey: '', advanced: false, modelType: 'gpt-4', maxTokens: 2048, temperature: 1, expireDate: undefined, priority: 'normal', remark: '' },
+      //   onChange: (values: any) => { console.log('表单变更', values); },
+      // },
+      // {
+      //   key: 'netConfig',
+      //   type: 'form',
+      //   label: '联网配置',
+      //   icon: <Settings2 size={16} />,
+      //   enabled: true,
+      //   formConfig: mockNetConfig,
+      //   initialValues: { apiKey: '', advanced: false, modelType: 'gpt-4', maxTokens: 2048, temperature: 1, expireDate: undefined, priority: 'normal', remark: '' },
+      //   onChange: (values: any) => { console.log('表单变更', values); },
+      // },
+    ];
+
+    /**
+     * 业务层自定义组件
+     */
+    const businessCustomComponents: { [key: string]: any } = {
+      AiChatBox: (msg: any, idx: number) => {
+        const isLastMessage = idx === (currentChatData?.messages?.length || 0) - 1;
+        const displayStatus = isLastMessage ? appStatus.display : 'ready';
+        return (
+          <AiChatBox
+            {...msg}
+            displayStatus={displayStatus}
+            eventsEmit={mergedEventsEmit}
+            defaultAnswer={
+              currentChatData?.searchConfigDTO?.defaultAnswer ||
+              '不知道什么原因我们没能查到你要的问题*-*'
+            }
+            styles={styles}
+          />
+        );
+      },
+      LogoBox: (props: any) => {
+        if (props && props.LogoBox === null) return null;
+        if (props && typeof props.LogoBox === 'function') return <props.LogoBox />;
+        return <div className="text-2xl w-full text-center font-bold">小鲸智能助手</div>;
+      },
+      DisplayLoading: () => <DisplayLoading />,
+      DisplayError: () => <DisplayError />,
+      AppError: () => (
+        <AppError
+          msg="应用初始化失败"
+          subMsg="无法完成应用初始化，这可能是由于网络连接问题或服务配置错误导致的。请检查您的网络连接并重试。"
+        />
+      ),
+      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}
+          />
+        );
+      },
+      WelcomeComponent: () => (
+        <GientechNewChatWelcome
+          eventsEmit={mergedEventsEmit}
+          assistantList={assistantList}
+          styles={styles}
+          defaultSelect={newAssistantId || assistantList[0]?.id}
+        />
+      ),
+    };
+
+    /**
+     * 合并外部传入和业务默认的自定义组件，外部优先
+     */
+    const mergedCustomComponents: { [key: string]: any } = {
+      ...businessCustomComponents,
+      ...(rest.CustomComponents || {})
+    };
+
+    // =================================================================
+    // 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}
+          activeSessionId={activeSessionId}
+        />
+        <FeedBackModal
+          open={openFeed}
+          feedBackList={feedBackList}
+          setOpen={setOpenFeed}
+          handleConfirm={handleFeedDownConfirm}
+        />
+      </>
+    );
+  };
+}