@ai-group/chat-sdk 3.8.0-alpha.1 → 3.8.0-alpha.2

package/dist/cjs/types/antdx.d.ts

@@ -57,7 +57,10 @@ export type BaseNode = React.ReactNode | false;
 export type NodeRender = (oriNode: React.ReactNode, info: {
     components: ActionsComponents;
 }) => BaseNode;
-export interface SenderProps extends Partial<Pick<TextareaProps, 'placeholder' | 'onKeyUp' | 'onFocus' | 'onBlur'>> {
+export interface SenderProps extends Omit<Partial<Pick<TextareaProps, 'placeholder' | 'onKeyUp' | 'onFocus' | 'onBlur'>>, 'onKeyUp' | 'onFocus' | 'onBlur'> {
+    onKeyUp?: React.KeyboardEventHandler<HTMLTextAreaElement>;
+    onFocus?: React.FocusEventHandler<HTMLTextAreaElement>;
+    onBlur?: React.FocusEventHandler<HTMLTextAreaElement>;
     prefixCls?: string;
     defaultValue?: string;
     value?: string;

package/dist/cjs/types/antdx.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/antdx.ts"],
-  "sourcesContent": ["/**\n * @ant-design/x 类型本地声明\n * 从 @ant-design/x 源码提取的公共 API 类型，减少外部依赖\n */\nimport type React from 'react';\nimport type { UploadFile, MenuProps, InputProps } from 'antd';\n\n// ==================== Conversations ====================\n\nexport interface ConversationItemType\n  extends Omit<React.HTMLAttributes<HTMLLIElement>, 'onClick'> {\n  key: string;\n  label?: React.ReactNode;\n  group?: string;\n  icon?: React.ReactNode;\n  disabled?: boolean;\n  [key: string]: any;\n}\n\nexport interface DividerItemType {\n  type: 'divider';\n  key?: string;\n  dashed?: boolean;\n}\n\nexport type ItemType = ConversationItemType | DividerItemType;\n\ntype ConversationsSemanticType = 'root' | 'creation' | 'group' | 'item';\n\nexport interface ConversationsProps extends React.HTMLAttributes<HTMLUListElement> {\n  items?: ItemType[];\n  activeKey?: ConversationItemType['key'];\n  defaultActiveKey?: ConversationItemType['key'];\n  onActiveChange?: (value: ConversationItemType['key'], item?: ItemType) => void;\n  menu?:\n    | (MenuProps & {\n        trigger?:\n          | React.ReactNode\n          | ((\n              conversation: ConversationItemType,\n              info: { originNode: React.ReactNode },\n            ) => React.ReactNode);\n        getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement;\n      })\n    | ((\n        value: ConversationItemType,\n      ) => MenuProps & {\n        trigger?:\n          | React.ReactNode\n          | ((\n              conversation: ConversationItemType,\n              info: { originNode: React.ReactNode },\n            ) => React.ReactNode);\n        getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement;\n      });\n  groupable?: boolean | Record<string, any>;\n  styles?: Partial<Record<ConversationsSemanticType, React.CSSProperties>>;\n  classNames?: Partial<Record<ConversationsSemanticType, string>>;\n  prefixCls?: string;\n  rootClassName?: string;\n}\n\n// ==================== Sender ====================\n\ntype TextareaProps = InputProps;\n\ntype SubmitType = 'enter' | 'shiftEnter';\n\ntype SenderSemanticType = 'root' | 'prefix' | 'input' | 'suffix' | 'footer' | 'switch' | 'content';\n\nexport interface SenderComponents {\n  input?: React.ComponentType<any>;\n}\n\nexport type ActionsComponents = {\n  SendButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n  LoadingButton: React.ComponentType<any>;\n  SpeechButton: React.ComponentType<any>;\n};\n\nexport type BaseNode = React.ReactNode | false;\nexport type NodeRender = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => BaseNode;\n\nexport interface SenderProps\n  extends Partial<Pick<TextareaProps, 'placeholder' | 'onKeyUp' | 'onFocus' | 'onBlur'>> {\n  prefixCls?: string;\n  defaultValue?: string;\n  value?: string;\n  loading?: boolean;\n  readOnly?: boolean;\n  submitType?: SubmitType;\n  disabled?: boolean;\n  onSubmit?: (message: string, ...args: any[]) => void;\n  onChange?: (value: string, ...args: any[]) => void;\n  onCancel?: VoidFunction;\n  onKeyDown?: (event: React.KeyboardEvent) => void | false;\n  onPaste?: React.ClipboardEventHandler<HTMLElement>;\n  onPasteFile?: (files: FileList) => void;\n  components?: SenderComponents;\n  classNames?: Partial<Record<SenderSemanticType, string>>;\n  styles?: Partial<Record<SenderSemanticType, React.CSSProperties>>;\n  rootClassName?: string;\n  style?: React.CSSProperties;\n  className?: string;\n  allowSpeech?: any;\n  prefix?: BaseNode | NodeRender;\n  footer?: BaseNode | NodeRender;\n  suffix?: BaseNode | NodeRender;\n  header?: BaseNode | NodeRender;\n  autoSize?: boolean | { minRows?: number; maxRows?: number };\n  slotConfig?: Readonly<any[]>;\n  skill?: any;\n}\n\n// ==================== Prompts ====================\n\nexport interface BasePromptsItemType {\n  key: string;\n  icon?: React.ReactNode;\n  label?: React.ReactNode;\n  description?: React.ReactNode;\n  disabled?: boolean;\n}\n\nexport interface PromptsItemType extends BasePromptsItemType {\n  children?: BasePromptsItemType[];\n}\n\ntype PromptsSemanticType =\n  | 'root'\n  | 'list'\n  | 'item'\n  | 'itemContent'\n  | 'title'\n  | 'subList'\n  | 'subItem';\n\nexport interface PromptsProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick' | 'title'> {\n  items?: PromptsItemType[];\n  title?: React.ReactNode;\n  onClick?: (info: { data: PromptsItemType }) => void;\n  styles?: Partial<Record<PromptsSemanticType, React.CSSProperties>>;\n  classNames?: Partial<Record<PromptsSemanticType, string>>;\n  prefixCls?: string;\n  rootClassName?: string;\n  vertical?: boolean;\n  wrap?: boolean;\n}\n\n// ==================== Attachments ====================\n\nexport interface Attachment<T = any>\n  extends UploadFile<T> {\n  description?: React.ReactNode;\n  cardType?: 'audio' | 'video' | 'image' | 'file';\n}\n\nexport interface AttachmentsRef {\n  nativeElement?: HTMLDivElement | null;\n  fileNativeElement?: HTMLInputElement | null;\n  upload: (file: File) => void;\n  select: (options?: { accept?: string; multiple?: boolean }) => void;\n}\n\n// ==================== Think ====================\n\ntype ThinkSemanticType = 'root' | 'header' | 'content' | 'icon';\n\nexport interface ThinkProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {\n  prefixCls?: string;\n  style?: React.CSSProperties;\n  styles?: Partial<Record<ThinkSemanticType, React.CSSProperties>>;\n  className?: string;\n  classNames?: Partial<Record<ThinkSemanticType, string>>;\n  rootClassName?: string;\n  title?: React.ReactNode;\n  icon?: React.ReactNode;\n  loading?: boolean | React.ReactNode;\n  defaultExpanded?: boolean;\n  expanded?: boolean;\n  onExpand?: (expand: boolean) => void;\n  blink?: boolean;\n  destroyOnHidden?: boolean;\n}\n"],
+  "sourcesContent": ["/**\n * @ant-design/x 类型本地声明\n * 从 @ant-design/x 源码提取的公共 API 类型，减少外部依赖\n */\nimport type React from 'react';\nimport type { UploadFile, MenuProps, InputProps } from 'antd';\n\n// ==================== Conversations ====================\n\nexport interface ConversationItemType\n  extends Omit<React.HTMLAttributes<HTMLLIElement>, 'onClick'> {\n  key: string;\n  label?: React.ReactNode;\n  group?: string;\n  icon?: React.ReactNode;\n  disabled?: boolean;\n  [key: string]: any;\n}\n\nexport interface DividerItemType {\n  type: 'divider';\n  key?: string;\n  dashed?: boolean;\n}\n\nexport type ItemType = ConversationItemType | DividerItemType;\n\ntype ConversationsSemanticType = 'root' | 'creation' | 'group' | 'item';\n\nexport interface ConversationsProps extends React.HTMLAttributes<HTMLUListElement> {\n  items?: ItemType[];\n  activeKey?: ConversationItemType['key'];\n  defaultActiveKey?: ConversationItemType['key'];\n  onActiveChange?: (value: ConversationItemType['key'], item?: ItemType) => void;\n  menu?:\n    | (MenuProps & {\n        trigger?:\n          | React.ReactNode\n          | ((\n              conversation: ConversationItemType,\n              info: { originNode: React.ReactNode },\n            ) => React.ReactNode);\n        getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement;\n      })\n    | ((\n        value: ConversationItemType,\n      ) => MenuProps & {\n        trigger?:\n          | React.ReactNode\n          | ((\n              conversation: ConversationItemType,\n              info: { originNode: React.ReactNode },\n            ) => React.ReactNode);\n        getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement;\n      });\n  groupable?: boolean | Record<string, any>;\n  styles?: Partial<Record<ConversationsSemanticType, React.CSSProperties>>;\n  classNames?: Partial<Record<ConversationsSemanticType, string>>;\n  prefixCls?: string;\n  rootClassName?: string;\n}\n\n// ==================== Sender ====================\n\ntype TextareaProps = InputProps;\n\ntype SubmitType = 'enter' | 'shiftEnter';\n\ntype SenderSemanticType = 'root' | 'prefix' | 'input' | 'suffix' | 'footer' | 'switch' | 'content';\n\nexport interface SenderComponents {\n  input?: React.ComponentType<any>;\n}\n\nexport type ActionsComponents = {\n  SendButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n  LoadingButton: React.ComponentType<any>;\n  SpeechButton: React.ComponentType<any>;\n};\n\nexport type BaseNode = React.ReactNode | false;\nexport type NodeRender = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => BaseNode;\n\nexport interface SenderProps\n  extends Omit<Partial<Pick<TextareaProps, 'placeholder' | 'onKeyUp' | 'onFocus' | 'onBlur'>>, 'onKeyUp' | 'onFocus' | 'onBlur'> {\n  onKeyUp?: React.KeyboardEventHandler<HTMLTextAreaElement>;\n  onFocus?: React.FocusEventHandler<HTMLTextAreaElement>;\n  onBlur?: React.FocusEventHandler<HTMLTextAreaElement>;\n  prefixCls?: string;\n  defaultValue?: string;\n  value?: string;\n  loading?: boolean;\n  readOnly?: boolean;\n  submitType?: SubmitType;\n  disabled?: boolean;\n  onSubmit?: (message: string, ...args: any[]) => void;\n  onChange?: (value: string, ...args: any[]) => void;\n  onCancel?: VoidFunction;\n  onKeyDown?: (event: React.KeyboardEvent) => void | false;\n  onPaste?: React.ClipboardEventHandler<HTMLElement>;\n  onPasteFile?: (files: FileList) => void;\n  components?: SenderComponents;\n  classNames?: Partial<Record<SenderSemanticType, string>>;\n  styles?: Partial<Record<SenderSemanticType, React.CSSProperties>>;\n  rootClassName?: string;\n  style?: React.CSSProperties;\n  className?: string;\n  allowSpeech?: any;\n  prefix?: BaseNode | NodeRender;\n  footer?: BaseNode | NodeRender;\n  suffix?: BaseNode | NodeRender;\n  header?: BaseNode | NodeRender;\n  autoSize?: boolean | { minRows?: number; maxRows?: number };\n  slotConfig?: Readonly<any[]>;\n  skill?: any;\n}\n\n// ==================== Prompts ====================\n\nexport interface BasePromptsItemType {\n  key: string;\n  icon?: React.ReactNode;\n  label?: React.ReactNode;\n  description?: React.ReactNode;\n  disabled?: boolean;\n}\n\nexport interface PromptsItemType extends BasePromptsItemType {\n  children?: BasePromptsItemType[];\n}\n\ntype PromptsSemanticType =\n  | 'root'\n  | 'list'\n  | 'item'\n  | 'itemContent'\n  | 'title'\n  | 'subList'\n  | 'subItem';\n\nexport interface PromptsProps\n  extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick' | 'title'> {\n  items?: PromptsItemType[];\n  title?: React.ReactNode;\n  onClick?: (info: { data: PromptsItemType }) => void;\n  styles?: Partial<Record<PromptsSemanticType, React.CSSProperties>>;\n  classNames?: Partial<Record<PromptsSemanticType, string>>;\n  prefixCls?: string;\n  rootClassName?: string;\n  vertical?: boolean;\n  wrap?: boolean;\n}\n\n// ==================== Attachments ====================\n\nexport interface Attachment<T = any>\n  extends UploadFile<T> {\n  description?: React.ReactNode;\n  cardType?: 'audio' | 'video' | 'image' | 'file';\n}\n\nexport interface AttachmentsRef {\n  nativeElement?: HTMLDivElement | null;\n  fileNativeElement?: HTMLInputElement | null;\n  upload: (file: File) => void;\n  select: (options?: { accept?: string; multiple?: boolean }) => void;\n}\n\n// ==================== Think ====================\n\ntype ThinkSemanticType = 'root' | 'header' | 'content' | 'icon';\n\nexport interface ThinkProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {\n  prefixCls?: string;\n  style?: React.CSSProperties;\n  styles?: Partial<Record<ThinkSemanticType, React.CSSProperties>>;\n  className?: string;\n  classNames?: Partial<Record<ThinkSemanticType, string>>;\n  rootClassName?: string;\n  title?: React.ReactNode;\n  icon?: React.ReactNode;\n  loading?: boolean | React.ReactNode;\n  defaultExpanded?: boolean;\n  expanded?: boolean;\n  onExpand?: (expand: boolean) => void;\n  blink?: boolean;\n  destroyOnHidden?: boolean;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

package/dist/esm/components/XAdkChatbot/index.js

@@ -1,6 +1,6 @@
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
-import { useMemo, useCallback, useEffect, useRef, useImperativeHandle, forwardRef } from "react";
+import { useMemo, useCallback, useEffect, useLayoutEffect, useRef, useImperativeHandle, forwardRef, Fragment } from "react";
 import { Button, Flex, Tooltip, message as antdMessage } from "antd";
 import clsx from "clsx";
 import { SwapRightOutlined, ReloadOutlined, CopyOutlined, InfoCircleOutlined } from "@ant-design/icons";
@@ -30,12 +30,16 @@ var scrollThreshold = 10;
  * - ✅ 欢迎页面 (agentName/agentIcon/description)
  */
 var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
-  var _mergedStrategies$par;
+  var _mergedStrategies$par, _history$direction;
   var _ref$loading = _ref.loading,
     loading = _ref$loading === void 0 ? false : _ref$loading,
     prologue = _ref.prologue,
     suggestions = _ref.suggestions,
     messages = _ref.messages,
+    renderBeforeGroup = _ref.renderBeforeGroup,
+    renderAfterGroup = _ref.renderAfterGroup,
+    renderGroup = _ref.renderGroup,
+    history = _ref.history,
     showFnCallDetail = _ref.showFnCallDetail,
     onConfirm = _ref.onConfirm,
     onSuggest = _ref.onSuggest,
@@ -76,6 +80,98 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var prevInitializedRef = useRef(false);
   var prevSessionIdRef = useRef(sessionId);
   var previousMessageCountRef = useRef(messages.length);
+  var historyRef = useRef(history);
+  historyRef.current = history;
+  var messagesRef = useRef(messages);
+  messagesRef.current = messages;
+  var historyRequestRef = useRef(false);
+  var historyRequestIdRef = useRef(0);
+  var historyRequestControllerRef = useRef(null);
+  var historyRefreshRef = useRef(false);
+  var historyRefreshIdRef = useRef(0);
+  var historyRefreshControllerRef = useRef(null);
+  var prependAnchorRef = useRef(null);
+  var skipNextAutoScrollRef = useRef(false);
+  var prependExpiryRef = useRef(null);
+  var loadMoreHistory = useCallback(function () {
+    var _pagination$direction;
+    var pagination = historyRef.current;
+    var el = listRef.current;
+    if (!(pagination !== null && pagination !== void 0 && pagination.hasMore) || pagination.loading || historyRequestRef.current || !el) return;
+    var direction = (_pagination$direction = pagination.direction) !== null && _pagination$direction !== void 0 ? _pagination$direction : "top";
+    if (direction === "top") {
+      var _currentMessages$;
+      if (prependExpiryRef.current) clearTimeout(prependExpiryRef.current);
+      var currentMessages = messagesRef.current;
+      prependAnchorRef.current = {
+        sessionId: prevSessionIdRef.current,
+        firstMessageId: (_currentMessages$ = currentMessages[0]) === null || _currentMessages$ === void 0 ? void 0 : _currentMessages$.id,
+        messageCount: currentMessages.length,
+        scrollTop: el.scrollTop,
+        scrollHeight: el.scrollHeight
+      };
+    }
+    historyRequestRef.current = true;
+    var requestId = ++historyRequestIdRef.current;
+    var controller = new AbortController();
+    historyRequestControllerRef.current = controller;
+    void Promise.resolve().then(function () {
+      return pagination.onLoadMore({
+        signal: controller.signal
+      });
+    }).catch(function () {
+      if (requestId !== historyRequestIdRef.current || controller.signal.aborted) return;
+      prependAnchorRef.current = null;
+      antdMessage.error("加载历史消息失败，请重试");
+    }).finally(function () {
+      if (requestId === historyRequestIdRef.current) {
+        historyRequestRef.current = false;
+        historyRequestControllerRef.current = null;
+        // 没有新页时解除滚动锚点，避免后续正常消息被误认为 prepend。
+        prependExpiryRef.current = setTimeout(function () {
+          prependAnchorRef.current = null;
+          prependExpiryRef.current = null;
+        }, 500);
+      }
+    });
+  }, []);
+  var refreshHistory = useCallback(function () {
+    var pagination = historyRef.current;
+    if (!(pagination !== null && pagination !== void 0 && pagination.onRefresh) || pagination.refreshing || historyRefreshRef.current) return;
+    historyRefreshRef.current = true;
+    var requestId = ++historyRefreshIdRef.current;
+    var controller = new AbortController();
+    historyRefreshControllerRef.current = controller;
+    void Promise.resolve().then(function () {
+      var _pagination$onRefresh;
+      return (_pagination$onRefresh = pagination.onRefresh) === null || _pagination$onRefresh === void 0 ? void 0 : _pagination$onRefresh.call(pagination, {
+        signal: controller.signal
+      });
+    }).catch(function () {
+      if (!controller.signal.aborted) antdMessage.error("刷新历史消息失败，请重试");
+    }).finally(function () {
+      if (requestId === historyRefreshIdRef.current) {
+        historyRefreshRef.current = false;
+        historyRefreshControllerRef.current = null;
+      }
+    });
+  }, []);
+  useLayoutEffect(function () {
+    var _messages$;
+    var anchor = prependAnchorRef.current;
+    var el = listRef.current;
+    if (!anchor || !el) return;
+    if (anchor.sessionId !== sessionId) {
+      prependAnchorRef.current = null;
+      return;
+    }
+    if (messages.length <= anchor.messageCount || ((_messages$ = messages[0]) === null || _messages$ === void 0 ? void 0 : _messages$.id) === anchor.firstMessageId) return;
+    el.scrollTop = anchor.scrollTop + el.scrollHeight - anchor.scrollHeight;
+    skipNextAutoScrollRef.current = true;
+    prependAnchorRef.current = null;
+    if (prependExpiryRef.current) clearTimeout(prependExpiryRef.current);
+    prependExpiryRef.current = null;
+  }, [messages, sessionId]);
 
   // 暴露命令式 API
   var scrollToBottom = useCallback(function () {
@@ -174,18 +270,40 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
 
   // 会话切换时重置滚动状态，允许重新触发初始化置底
   useEffect(function () {
+    var _historyRequestContro, _historyRefreshContro;
     if (sessionId === undefined) return; // 未传 sessionId 不处理
     if (prevSessionIdRef.current === sessionId) return; // 同一会话不处理
     prevSessionIdRef.current = sessionId;
     prevInitializedRef.current = false;
     userHasScrolledRef.current = false;
+    (_historyRequestContro = historyRequestControllerRef.current) === null || _historyRequestContro === void 0 || _historyRequestContro.abort();
+    (_historyRefreshContro = historyRefreshControllerRef.current) === null || _historyRefreshContro === void 0 || _historyRefreshContro.abort();
+    prependAnchorRef.current = null;
+    historyRequestRef.current = false;
+    historyRequestIdRef.current += 1;
+    historyRefreshRef.current = false;
+    historyRefreshIdRef.current += 1;
+    if (prependExpiryRef.current) clearTimeout(prependExpiryRef.current);
+    prependExpiryRef.current = null;
   }, [sessionId]);
+  useEffect(function () {
+    return function () {
+      var _historyRequestContro2, _historyRefreshContro2;
+      (_historyRequestContro2 = historyRequestControllerRef.current) === null || _historyRequestContro2 === void 0 || _historyRequestContro2.abort();
+      (_historyRefreshContro2 = historyRefreshControllerRef.current) === null || _historyRefreshContro2 === void 0 || _historyRefreshContro2.abort();
+      if (prependExpiryRef.current) clearTimeout(prependExpiryRef.current);
+    };
+  }, []);
 
   // 新增用户消息代表一次主动发送，应无条件恢复跟随并置底。
   // 之后的流式回复继续沿用“用户未主动上滚时跟随”的规则。
   useEffect(function () {
     var previousCount = previousMessageCountRef.current;
     previousMessageCountRef.current = messages.length;
+    if (skipNextAutoScrollRef.current || prependAnchorRef.current) {
+      skipNextAutoScrollRef.current = false;
+      return;
+    }
     var hasNewUserMessage = messages.slice(previousCount).some(function (message) {
       return message.role === "user";
     });
@@ -234,8 +352,15 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
     if (isAtBottom) {
       userHasScrolledRef.current = false;
     }
+    var pagination = historyRef.current;
+    if (pagination !== null && pagination !== void 0 && pagination.hasMore) {
+      var _pagination$threshold, _pagination$direction2;
+      var threshold = (_pagination$threshold = pagination.threshold) !== null && _pagination$threshold !== void 0 ? _pagination$threshold : 80;
+      var atLoadEdge = ((_pagination$direction2 = pagination.direction) !== null && _pagination$direction2 !== void 0 ? _pagination$direction2 : "top") === "top" ? currentTop <= threshold : el.scrollHeight - currentTop - el.clientHeight <= threshold;
+      if (atLoadEdge) loadMoreHistory();
+    }
     lastScrollTopRef.current = currentTop;
-  }, []);
+  }, [loadMoreHistory]);
   useEffect(function () {
     var listElement = listRef.current;
     if (!listElement) return;
@@ -245,6 +370,13 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
     };
   }, [handleScroll]);
 
+  // 首屏内容不足一屏时没有滚动事件，继续按需加载直到内容可滚动或数据耗尽。
+  useEffect(function () {
+    if (!initialized || !(history !== null && history !== void 0 && history.hasMore) || history.loading) return;
+    var el = listRef.current;
+    if (el && el.scrollHeight <= el.clientHeight + 1) loadMoreHistory();
+  }, [history === null || history === void 0 ? void 0 : history.hasMore, history === null || history === void 0 ? void 0 : history.loading, initialized, loadMoreHistory, messages]);
+
   // ========== 消息分组逻辑 ==========
   var chatGroups = useMemo(function () {
     if (!enableGrouping) {
@@ -570,12 +702,25 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
   }, [enableProcessParsing, parseOptions, parseProcessMessage, showFnCallDetail, onConfirm, loading, showRetry, showCopy, showLog, onRetry, onCopy, onShowLog, actions, actionsExtra, onFileClick, onResourceLinkClick, renderResourceLink, mergedMarkdownExtensions, resourceLinkSchemes, styles, resolveToolKind, mergedStrategies]);
 
   // ========== 渲染用户消息组 ==========
-  var renderUserGroup = useCallback(function (group) {
-    return /*#__PURE__*/_jsx("div", {
+  var renderUserGroup = useCallback(function (group, nextGroup) {
+    var _userActions, _group$msgs;
+    var compactWithNextText = group.msgs.some(function (message) {
+      var _message$fileData;
+      return Boolean((_message$fileData = message.fileData) === null || _message$fileData === void 0 ? void 0 : _message$fileData.length);
+    }) && group.msgs.every(function (message) {
+      var _message$text;
+      return !((_message$text = message.text) !== null && _message$text !== void 0 && _message$text.trim());
+    }) && (nextGroup === null || nextGroup === void 0 ? void 0 : nextGroup.role) === "user" && nextGroup.msgs.some(function (message) {
+      var _message$text2;
+      return Boolean((_message$text2 = message.text) === null || _message$text2 === void 0 ? void 0 : _message$text2.trim());
+    });
+    return /*#__PURE__*/_jsxs("div", {
       className: styles.userMsg,
       "data-message-id": group.id,
-      children: group.msgs.map(function (m, i) {
-        var _userActions;
+      style: compactWithNextText ? {
+        marginBottom: 8
+      } : undefined,
+      children: [group.msgs.map(function (m, i) {
         return /*#__PURE__*/_jsxs("div", {
           className: styles.userContainer,
           children: [m.fileData && m.fileData.length > 0 && /*#__PURE__*/_jsx(_Fragment, {
@@ -584,7 +729,7 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
                 file: file,
                 align: "left",
                 style: {
-                  marginBottom: "16px"
+                  marginBottom: compactWithNextText && i === group.msgs.length - 1 && index === m.fileData.length - 1 ? 0 : 16
                 },
                 onClick: onFileClick
               }, index);
@@ -611,30 +756,36 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
               renderResourceLink: renderResourceLink,
               markdownExtensions: mergedMarkdownExtensions
             })
-          }), showUserActions && /*#__PURE__*/_jsx("div", {
-            className: "x-user-actions ".concat(styles.userActions),
-            children: (_userActions = userActions === null || userActions === void 0 ? void 0 : userActions({
-              message: group
-            })) !== null && _userActions !== void 0 ? _userActions : /*#__PURE__*/_jsxs(_Fragment, {
-              children: [/*#__PURE__*/_jsx("span", {
-                className: styles.userTime,
-                children: formatTimestamp(m.timestamp)
-              }), /*#__PURE__*/_jsx(Tooltip, {
-                title: "\u590D\u5236\u5185\u5BB9",
-                children: /*#__PURE__*/_jsx(CopyOutlined, {
-                  className: styles.userActionIcon,
-                  onClick: function onClick() {
-                    var card = document.querySelector("[data-message-id=\"".concat(group.id, "\"] [data-xadk-user-card]"));
-                    var selected = getSelectionText(card);
-                    copy(selected || m.text || "");
-                    antdMessage.success("复制成功");
-                  }
-                })
-              })]
-            })
           })]
         }, m.id || i);
-      })
+      }), showUserActions && group.msgs.some(function (message) {
+        var _message$text3;
+        return Boolean((_message$text3 = message.text) === null || _message$text3 === void 0 ? void 0 : _message$text3.trim());
+      }) && /*#__PURE__*/_jsx("div", {
+        className: "x-user-actions ".concat(styles.userActions),
+        children: (_userActions = userActions === null || userActions === void 0 ? void 0 : userActions({
+          message: group
+        })) !== null && _userActions !== void 0 ? _userActions : /*#__PURE__*/_jsxs(_Fragment, {
+          children: [/*#__PURE__*/_jsx("span", {
+            className: styles.userTime,
+            children: formatTimestamp((_group$msgs = group.msgs[group.msgs.length - 1]) === null || _group$msgs === void 0 ? void 0 : _group$msgs.timestamp)
+          }), /*#__PURE__*/_jsx(Tooltip, {
+            title: "\u590D\u5236\u5185\u5BB9",
+            children: /*#__PURE__*/_jsx(CopyOutlined, {
+              className: styles.userActionIcon,
+              onClick: function onClick() {
+                var container = document.querySelector("[data-message-id=\"".concat(group.id, "\"]"));
+                var selected = getSelectionText(container);
+                var fullText = group.msgs.map(function (message) {
+                  return message.text || "";
+                }).join("");
+                copy(selected || fullText);
+                antdMessage.success("复制成功");
+              }
+            })
+          })]
+        })
+      })]
     }, group.id);
   }, [styles, onFileClick, onResourceLinkClick, renderResourceLink, mergedMarkdownExtensions, resourceLinkSchemes, showUserActions, userActions]);
 
@@ -676,6 +827,20 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
 
   // 空状态判断
   var isEmpty = messages.length === 0 && !prologue && (!suggestions || suggestions.length === 0);
+  var historyControls = history && (history.hasMore || history.loading || history.onRefresh) && /*#__PURE__*/_jsxs("div", {
+    className: styles.historyControls,
+    children: [history.onRefresh && /*#__PURE__*/_jsx("button", {
+      type: "button",
+      onClick: refreshHistory,
+      disabled: history.refreshing,
+      children: history.refreshing ? "正在刷新..." : "刷新"
+    }), (history.hasMore || history.loading) && /*#__PURE__*/_jsx("button", {
+      type: "button",
+      onClick: loadMoreHistory,
+      disabled: history.loading,
+      children: history.loading ? "正在加载..." : "加载更多"
+    })]
+  });
   return /*#__PURE__*/_jsxs("div", {
     className: clsx(styles.wrapper, className),
     style: style,
@@ -688,7 +853,7 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
       style: isEmpty ? {
         flex: 0
       } : undefined,
-      children: [prologue && /*#__PURE__*/_jsx("div", {
+      children: [((_history$direction = history === null || history === void 0 ? void 0 : history.direction) !== null && _history$direction !== void 0 ? _history$direction : "top") === "top" && historyControls, prologue && /*#__PURE__*/_jsx("div", {
         className: styles.prologue,
         children: /*#__PURE__*/_jsx(MarkdownRender, {
           text: prologue,
@@ -699,8 +864,20 @@ var XAdkChatbot = /*#__PURE__*/forwardRef(function (_ref, ref) {
           markdownExtensions: mergedMarkdownExtensions
         })
       }), chatGroups.map(function (group, idx) {
-        return group.role === "user" ? renderUserGroup(group) : renderBotGroup(group, idx === chatGroups.length - 1, renderFunctionCall);
-      }), renderSuggestions(), /*#__PURE__*/_jsx("div", {
+        var context = {
+          group: group,
+          index: idx,
+          previousGroup: chatGroups[idx - 1],
+          nextGroup: chatGroups[idx + 1]
+        };
+        var defaultNode = group.role === "user" ? renderUserGroup(group, chatGroups[idx + 1]) : renderBotGroup(group, idx === chatGroups.length - 1, renderFunctionCall);
+        var customNode = renderGroup === null || renderGroup === void 0 ? void 0 : renderGroup(_objectSpread(_objectSpread({}, context), {}, {
+          defaultNode: defaultNode
+        }));
+        return /*#__PURE__*/_jsxs(Fragment, {
+          children: [renderBeforeGroup === null || renderBeforeGroup === void 0 ? void 0 : renderBeforeGroup(context), customNode === undefined ? defaultNode : customNode, renderAfterGroup === null || renderAfterGroup === void 0 ? void 0 : renderAfterGroup(context)]
+        }, group.id);
+      }), (history === null || history === void 0 ? void 0 : history.direction) === "bottom" && historyControls, renderSuggestions(), /*#__PURE__*/_jsx("div", {
         ref: messagesEndRef
       })]
     })]