@ant-design/agentic-ui 2.0.13 → 2.0.15

package/README.md

@@ -153,12 +153,12 @@ import { MarkdownEditor } from '@ant-design/agentic-ui';
 
 ### 📋 布局与容器组件
 
-| 组件         | 描述         | 主要功能                             |
-| ------------ | ------------ | ------------------------------------ |
-| `ChatLayout` | 聊天布局容器 | 标准聊天界面布局，支持左右栏、全屏等 |
-| `History`    | 历史记录组件 | 会话历史管理，支持搜索、筛选、导出   |
-| `Welcome`    | 欢迎页组件   | 应用启动欢迎页，展示功能介绍         |
-| `Quote`      | 引用组件     | 引用消息或内容                       |
+| 组件             | 描述         | 主要功能                             |
+| ---------------- | ------------ | ------------------------------------ |
+| `ChatLayout`     | 聊天布局容器 | 标准聊天界面布局，支持左右栏、全屏等 |
+| `History`        | 历史记录组件 | 会话历史管理，支持搜索、筛选、导出   |
+| `WelcomeMessage` | 欢迎语组件   | 应用启动欢迎语，展示功能介绍         |
+| `Quote`          | 引用组件     | 引用消息或内容                       |
 
 ### 🎯 交互与反馈组件
 
@@ -172,12 +172,12 @@ import { MarkdownEditor } from '@ant-design/agentic-ui';
 
 ### 🧠 智能体专属组件
 
-| 组件             | 描述          | 主要功能                     |
-| ---------------- | ------------- | ---------------------------- |
-| `ChatBoot`       | 聊天引导组件  | 快速回复、案例推荐等引导功能 |
-| `SchemaEditor`   | Schema 编辑器 | 结构化数据编辑               |
-| `SchemaForm`     | Schema 表单   | 基于 Schema 自动生成表单     |
-| `SchemaRenderer` | Schema 渲染器 | 渲染结构化数据               |
+| 组件             | 描述           | 主要功能                     |
+| ---------------- | -------------- | ---------------------------- |
+| `ChatBootPage`   | 对话启动页组件 | 快速回复、案例推荐等引导功能 |
+| `SchemaEditor`   | Schema 编辑器  | 结构化数据编辑               |
+| `SchemaForm`     | Schema 表单    | 基于 Schema 自动生成表单     |
+| `SchemaRenderer` | Schema 渲染器  | 渲染结构化数据               |
 
 ### 🔌 插件组件
 

package/dist/BackTo/BackBottom.d.ts

@@ -1,5 +1,9 @@
 import React from 'react';
 import { ScrollVisibleButtonProps, ScrollVisibleButtonRef } from './ScrollVisibleButton';
+/**
+ * BackBottom 组件属性接口
+ * @interface BackBottomProps
+ */
 export interface BackBottomProps extends ScrollVisibleButtonProps {
     /**
      * 滚动到底部的持续时间
@@ -7,4 +11,56 @@ export interface BackBottomProps extends ScrollVisibleButtonProps {
      */
     duration?: number;
 }
+/**
+ * BackBottom 组件 - 返回底部按钮组件
+ *
+ * 该组件提供一个返回底部的浮动按钮，点击后平滑滚动到页面底部。
+ * 当距离底部超过指定阈值时自动显示，支持自定义滚动持续时间和显示条件。
+ *
+ * @component
+ * @description 返回底部按钮，点击后平滑滚动到页面底部
+ * @param {BackBottomProps} props - 组件属性
+ * @param {number} [props.duration=450] - 滚动到底部的持续时间（毫秒）
+ * @param {number | ((scrollTop: number, container: HTMLElement | Window) => boolean)} [props.shouldVisible=400] - 显示条件阈值或自定义函数
+ * @param {(e: React.MouseEvent, container: HTMLElement | Window) => void} [props.onClick] - 点击回调函数
+ * @param {string} [props.className] - 自定义CSS类名
+ * @param {React.CSSProperties} [props.style] - 自定义样式
+ * @param {HTMLElement | Window} [props.target] - 滚动容器，默认为 window
+ *
+ * @example
+ * ```tsx
+ * // 基本用法
+ * <BackBottom />
+ *
+ * // 自定义滚动持续时间
+ * <BackBottom duration={300} />
+ *
+ * // 自定义显示阈值
+ * <BackBottom shouldVisible={600} />
+ *
+ * // 自定义显示条件
+ * <BackBottom
+ *   shouldVisible={(scrollTop, container) => {
+ *     const scrollHeight = container instanceof Window
+ *       ? document.documentElement.scrollHeight
+ *       : container.scrollHeight;
+ *     return scrollHeight - scrollTop >= 800;
+ *   }}
+ * />
+ *
+ * // 指定滚动容器
+ * <BackBottom target={document.getElementById('container')} />
+ * ```
+ *
+ * @returns {React.ReactElement} 渲染的返回底部按钮组件
+ *
+ * @remarks
+ * - 默认在距离底部超过 400px 时显示
+ * - 支持平滑滚动动画
+ * - 可自定义滚动持续时间
+ * - 支持自定义显示条件
+ * - 支持指定滚动容器
+ * - 使用 forwardRef 支持 ref 传递
+ * - 提供完整的无障碍支持
+ */
 export declare const BackBottom: React.ForwardRefExoticComponent<BackBottomProps & React.RefAttributes<ScrollVisibleButtonRef>>;

package/dist/BackTo/BackTop.d.ts

@@ -8,13 +8,50 @@ export interface BackTopProps extends ScrollVisibleButtonProps {
     duration?: number;
 }
 /**
- * BackTop 组件
+ * BackTop 组件 - 返回顶部按钮组件
  *
- * 返回顶部按钮，点击后平滑滚动到页面顶部
+ * 该组件提供一个返回顶部的浮动按钮，点击后平滑滚动到页面顶部。
+ * 当滚动距离超过指定阈值时自动显示，支持自定义滚动持续时间和显示条件。
+ *
+ * @component
+ * @description 返回顶部按钮，点击后平滑滚动到页面顶部
+ * @param {BackTopProps} props - 组件属性
+ * @param {number} [props.duration=450] - 滚动到顶部的持续时间（毫秒）
+ * @param {number | ((scrollTop: number, container: HTMLElement | Window) => boolean)} [props.shouldVisible=400] - 显示条件阈值或自定义函数
+ * @param {(e: React.MouseEvent, container: HTMLElement | Window) => void} [props.onClick] - 点击回调函数
+ * @param {string} [props.className] - 自定义CSS类名
+ * @param {React.CSSProperties} [props.style] - 自定义样式
+ * @param {HTMLElement | Window} [props.target] - 滚动容器，默认为 window
  *
  * @example
  * ```tsx
+ * // 基本用法
+ * <BackTop />
+ *
+ * // 自定义滚动持续时间
  * <BackTop duration={300} />
+ *
+ * // 自定义显示阈值
+ * <BackTop shouldVisible={600} />
+ *
+ * // 自定义显示条件
+ * <BackTop
+ *   shouldVisible={(scrollTop) => scrollTop > 500}
+ * />
+ *
+ * // 指定滚动容器
+ * <BackTop target={document.getElementById('container')} />
  * ```
+ *
+ * @returns {React.ReactElement} 渲染的返回顶部按钮组件
+ *
+ * @remarks
+ * - 默认在滚动距离超过 400px 时显示
+ * - 支持平滑滚动动画
+ * - 可自定义滚动持续时间
+ * - 支持自定义显示条件
+ * - 支持指定滚动容器
+ * - 使用 forwardRef 支持 ref 传递
+ * - 提供完整的无障碍支持
  */
 export declare const BackTop: React.ForwardRefExoticComponent<BackTopProps & React.RefAttributes<ScrollVisibleButtonRef>>;

package/dist/BackTo/index.d.ts

@@ -1,6 +1,26 @@
 /// <reference types="react" />
 export type { BackBottomProps } from './BackBottom';
 export type { BackTopProps } from './BackTop';
+/**
+ * BackTo 组件集合 - 页面滚动导航组件
+ *
+ * 该对象导出包含返回顶部和返回底部两个组件，提供便捷的页面滚动导航功能。
+ *
+ * @namespace BackTo
+ * @property {React.FC<BackTopProps>} Top - 返回顶部按钮组件
+ * @property {React.FC<BackBottomProps>} Bottom - 返回底部按钮组件
+ *
+ * @example
+ * ```tsx
+ * import { BackTo } from 'agentic-ui';
+ *
+ * // 使用返回顶部组件
+ * <BackTo.Top duration={300} />
+ *
+ * // 使用返回底部组件
+ * <BackTo.Bottom duration={300} />
+ * ```
+ */
 export declare const BackTo: {
     Top: import("react").ForwardRefExoticComponent<import("./BackTop").BackTopProps & import("react").RefAttributes<import("./ScrollVisibleButton").ScrollVisibleButtonRef>>;
     Bottom: import("react").ForwardRefExoticComponent<import("./BackBottom").BackBottomProps & import("react").RefAttributes<import("./ScrollVisibleButton").ScrollVisibleButtonRef>>;

package/dist/Bubble/AIBubble.js

@@ -94,7 +94,7 @@ var AIBubble = memo((props) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const context = useContext(BubbleConfigContext);
   const { compact, standalone, locale } = context || {};
-  const prefixClass = getPrefixCls("agent");
+  const prefixClass = getPrefixCls("agentic");
   const { wrapSSR, hashId } = useStyle(prefixClass);
   const typing = isTyping(originData);
   const preMessageSameRole = isSameRoleAsPrevious(preMessage, originData);
@@ -167,7 +167,9 @@ var AIBubble = memo((props) => {
         {
           style: __spreadValues({
             minWidth: standalone ? "min(296px,100%)" : "0px",
-            paddingLeft: 12
+            paddingLeft: 12,
+            maxWidth: "100%",
+            width: "100%"
           }, styles == null ? void 0 : styles.bubbleListItemExtraStyle),
           className: cx(
             `${prefixClass}-bubble-after`,

package/dist/Bubble/List/index.js

@@ -46,7 +46,7 @@ var BubbleList = (props) => {
   } = props;
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const { compact } = useContext(BubbleConfigContext) || {};
-  const prefixClass = getPrefixCls("agent-bubble-list");
+  const prefixClass = getPrefixCls("agentic-bubble-list");
   const { wrapSSR, hashId } = useStyle(prefixClass);
   const deps = useMemo(() => [props.style], [JSON.stringify(props.style)]);
   const bubbleListDom = useMemo(() => {

package/dist/Bubble/UserBubble.js

@@ -60,7 +60,7 @@ var UserBubble = memo((props) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const context = useContext(BubbleConfigContext);
   const { compact, standalone, locale } = context || {};
-  const prefixClass = getPrefixCls("agent");
+  const prefixClass = getPrefixCls("agentic");
   const { wrapSSR, hashId } = useStyle(prefixClass, classNames);
   const time = (originData == null ? void 0 : originData.createAt) || props.time;
   const placement = USER_PLACEMENT;

package/dist/Bubble/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @file Bubble 组件模块导出
+ *
+ * 该文件导出聊天气泡相关组件，包括 AI 消息气泡、用户消息气泡和通用气泡容器。
+ * 所有组件的详细文档请参考各自的组件定义文件。
+ */
 export { AIBubble, runRender } from './AIBubble';
 export { Bubble } from './Bubble';
 export * from './BubbleConfigProvide';

package/dist/Bubble/style.js

@@ -39,7 +39,7 @@ var genStyle = (token, classNames) => {
           }
         }
       },
-      ".md-editor-code": {
+      ".agentic-md-editor-code": {
         borderRadius: "12px !important",
         overflow: "auto",
         padding: "var(--padding-3x)"

package/dist/{ChatBoot → ChatBootPage}/ButtonTab.js

@@ -1,4 +1,4 @@
-// src/ChatBoot/ButtonTab.tsx
+// src/ChatBootPage/ButtonTab.tsx
 import React from "react";
 import { useStyle } from "./ButtonTabStyle";
 var ButtonTab = ({

package/dist/{ChatBoot → ChatBootPage}/ButtonTabGroup.js

@@ -1,4 +1,4 @@
-// src/ChatBoot/ButtonTabGroup.tsx
+// src/ChatBootPage/ButtonTabGroup.tsx
 import React, { useState } from "react";
 import ButtonTab from "./ButtonTab";
 import { useStyle } from "./ButtonTabGroupStyle";

package/dist/{ChatBoot → ChatBootPage}/ButtonTabGroupStyle.js

@@ -18,7 +18,7 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
-// src/ChatBoot/ButtonTabGroupStyle.ts
+// src/ChatBootPage/ButtonTabGroupStyle.ts
 import {
   useEditorStyleRegister
 } from "../Hooks/useStyle";

package/dist/{ChatBoot → ChatBootPage}/ButtonTabStyle.js

@@ -18,7 +18,7 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
-// src/ChatBoot/ButtonTabStyle.ts
+// src/ChatBootPage/ButtonTabStyle.ts
 import {
   useEditorStyleRegister
 } from "../Hooks/useStyle";

package/dist/{ChatBoot → ChatBootPage}/CaseReply.js

@@ -1,4 +1,4 @@
-// src/ChatBoot/CaseReply.tsx
+// src/ChatBootPage/CaseReply.tsx
 import { ConfigProvider } from "antd";
 import classNames from "classnames";
 import React, { useContext, useState } from "react";
@@ -16,7 +16,7 @@ var CaseReply = ({
   prefixCls: customPrefixCls
 }) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const prefixCls = getPrefixCls("chatboot-case-reply", customPrefixCls);
+  const prefixCls = getPrefixCls("agentic-chatboot-case-reply", customPrefixCls);
   const { wrapSSR, hashId } = useStyle(prefixCls);
   const [isHovered, setIsHovered] = useState(false);
   const containerCls = classNames(prefixCls, hashId, className);

package/dist/{ChatBoot → ChatBootPage}/CaseReplyStyle.js

@@ -18,7 +18,7 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
-// src/ChatBoot/CaseReplyStyle.ts
+// src/ChatBootPage/CaseReplyStyle.ts
 import {
   useEditorStyleRegister
 } from "../Hooks/useStyle";

package/dist/{ChatBoot → ChatBootPage}/Title.js

@@ -1,4 +1,4 @@
-// src/ChatBoot/Title.tsx
+// src/ChatBootPage/Title.tsx
 import { ConfigProvider } from "antd";
 import classNames from "classnames";
 import React, { useContext } from "react";
@@ -11,7 +11,7 @@ var Title = ({
   prefixCls: customPrefixCls
 }) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const prefixCls = getPrefixCls("chatboot-title", customPrefixCls);
+  const prefixCls = getPrefixCls("agentic-chatboot-title", customPrefixCls);
   const { wrapSSR, hashId } = useStyle(prefixCls);
   if (!title && !subtitle) {
     return null;

package/dist/{ChatBoot → ChatBootPage}/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @file ChatBootPage 组件模块导出
+ *
+ * 该文件导出聊天启动页面相关组件。
+ * 所有组件的详细文档请参考各自的组件定义文件。
+ */
 export { default as Title } from './Title';
 export type { TitleProps } from './Title';
 export { default as CaseReply } from './CaseReply';

package/dist/{ChatBoot → ChatBootPage}/index.js

@@ -1,4 +1,4 @@
-// src/ChatBoot/index.ts
+// src/ChatBootPage/index.ts
 import { default as default2 } from "./Title";
 import { default as default3 } from "./CaseReply";
 import { default as default4 } from "./ButtonTab";

package/dist/{ChatBoot → ChatBootPage}/style.js

@@ -18,7 +18,7 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
-// src/ChatBoot/style.ts
+// src/ChatBootPage/style.ts
 import {
   useEditorStyleRegister
 } from "../Hooks/useStyle";

package/dist/Components/ActionIconBox/index.js

@@ -52,7 +52,7 @@ var ActionIconBox = (props) => {
     onChange: props.onLoadingChange
   });
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const prefixCls = getPrefixCls("md-editor-action-icon-box");
+  const prefixCls = getPrefixCls("agentic-md-editor-action-icon-box");
   const { wrapSSR, hashId } = useStyle(prefixCls);
   useEffect(() => {
     var _a2;

package/dist/Components/ActionItemBox/ActionItemBox.js

@@ -24,7 +24,7 @@ import { useStyle } from "./style";
 var ActionItemBox = (props) => {
   var _a, _b;
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const basePrefixCls = getPrefixCls("agent-chat-action-item-box");
+  const basePrefixCls = getPrefixCls("agentic-chat-action-item-box");
   const { wrapSSR, hashId } = useStyle(basePrefixCls);
   useEffect(() => {
     var _a2;

package/dist/Components/ActionItemBox/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @file ActionItemBox 组件模块导出
+ *
+ * 该文件导出操作项盒子组件。
+ * 组件的详细文档请参考 ActionItemBox 组件定义文件。
+ */
 export { ActionItemBox } from './ActionItemBox';
 export type { ActionItemBoxProps } from './ActionItemBox';
 export { useStyle } from './style';

package/dist/Components/Button/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @file Button 组件模块导出
+ *
+ * 该文件导出多种类型的按钮组件。
+ * 所有组件的详细文档请参考各自的组件定义文件。
+ */
 export * from './IconButton';
 export * from './SwitchButton';
 export * from './ToggleButton';

package/dist/History/components/HistoryItem.js

@@ -107,7 +107,7 @@ var HistoryItemSingle = React.memo(
     itemDateFormatter
   }) => {
     const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-    const prefixCls = getPrefixCls("agent-chat-history-menu");
+    const prefixCls = getPrefixCls("agentic-chat-history-menu");
     const { hashId } = useStyle(prefixCls);
     const { textRef, isTextOverflow } = useTextOverflow(item.sessionTitle);
     const isRunning = React.useMemo(
@@ -268,7 +268,7 @@ var HistoryItemMulti = React.memo(
     itemDateFormatter
   }) => {
     const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-    const prefixCls = getPrefixCls("agent-chat-history-menu");
+    const prefixCls = getPrefixCls("agentic-chat-history-menu");
     const { hashId } = useStyle(prefixCls);
     const { textRef, isTextOverflow } = useTextOverflow(item.sessionTitle);
     const isTask = React.useMemo(() => type === "task", [type]);

package/dist/History/components/NewChatComponent.js

@@ -30,7 +30,7 @@ var HistoryNewChat = ({
   className
 }) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const menuPrefixCls = getPrefixCls("agent-chat-history-menu");
+  const menuPrefixCls = getPrefixCls("agentic-chat-history-menu");
   const { wrapSSR, hashId } = useNewChatStyle(menuPrefixCls);
   const { locale } = useContext(I18nContext);
   const [loading, setLoading] = useState(false);

package/dist/History/components/SearchComponent.d.ts

@@ -15,6 +15,8 @@ interface HistorySearchProps {
         placeholder?: string;
         /** 未展开时的默认文本 */
         text?: string;
+        /** 搜索触发方式: 'change' - 实时搜索(默认), 'enter' - 回车触发 */
+        trigger?: 'change' | 'enter';
     };
 }
 /**

package/dist/History/components/SearchComponent.js

@@ -74,7 +74,9 @@ var HistorySearch = ({
   const { locale } = useContext(I18nContext);
   const [loading, setLoading] = useState(false);
   const [isExpanded, setIsExpanded] = useState(false);
+  const [inputValue, setInputValue] = useState("");
   const ref = useRef(null);
+  const trigger = (searchOptions == null ? void 0 : searchOptions.trigger) || "change";
   useClickAway(() => {
     setIsExpanded(false);
   }, ref);
@@ -97,6 +99,18 @@ var HistorySearch = ({
     }),
     360
   );
+  const handleInputChange = (e) => {
+    const value = e.target.value;
+    setInputValue(value);
+    if (trigger === "change") {
+      handleSearchChange.run(e);
+    }
+  };
+  const handleKeyDown = (e) => {
+    if (trigger === "enter" && e.key === "Enter") {
+      handleSearchWithLoading(inputValue);
+    }
+  };
   return /* @__PURE__ */ React.createElement(
     "div",
     {
@@ -117,9 +131,9 @@ var HistorySearch = ({
       {
         placeholder: (_a = searchOptions == null ? void 0 : searchOptions.placeholder) != null ? _a : type === "task" ? (locale == null ? void 0 : locale["chat.task.search.placeholder"]) || "搜索任务" : (locale == null ? void 0 : locale["chat.history.search.placeholder"]) || "搜索话题",
         prefix: loading ? /* @__PURE__ */ React.createElement(Spin, { size: "small" }) : /* @__PURE__ */ React.createElement(SearchIcon, null),
-        onChange: (e) => {
-          handleSearchChange.run(e);
-        },
+        value: inputValue,
+        onChange: handleInputChange,
+        onKeyDown: handleKeyDown,
         style: {
           width: "100%",
           height: 32,

package/dist/History/index.d.ts

@@ -19,6 +19,8 @@ export * from './utils';
  * @param {Function} [props.onDeleteItem] - 删除历史记录项时的回调函数
  * @param {Function} [props.customDateFormatter] - 日期格式化函数
  * @param {boolean} [props.standalone] - 是否以独立模式显示，为true时直接显示菜单，否则显示为下拉菜单
+ * @param {Function} [props.emptyRender] - 空状态渲染函数，当历史记录为空时显示自定义内容
+ * @param {boolean} [props.loading] - 加载状态，显示在 GroupMenu 区域
  *
  * @returns {React.ReactElement|null} 返回历史记录组件或null（当没有历史记录时）
  *
@@ -29,5 +31,7 @@ export * from './utils';
  *
  * 历史记录按日期分组显示，每组内按时间倒序排列。
  * 支持查看历史会话和删除历史记录。
+ * 当历史记录为空时，可通过 emptyRender 自定义空状态显示。
+ * 通过 loading 属性可以在 GroupMenu 区域显示加载动画。
  */
 export declare const History: React.FC<HistoryProps>;

package/dist/History/index.js

@@ -42,7 +42,7 @@ export * from "./utils";
 var History = (props) => {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const menuPrefixCls = getPrefixCls("agent-chat-history-menu");
+  const menuPrefixCls = getPrefixCls("agentic-chat-history-menu");
   const { locale } = useContext(BubbleConfigContext) || {};
   const containerRef = useRef(null);
   const { wrapSSR, hashId } = useStyle(menuPrefixCls);
@@ -111,23 +111,23 @@ var History = (props) => {
           }
         ),
         (_h = (_g = props.slots) == null ? void 0 : _g.beforeHistoryList) == null ? void 0 : _h.call(_g, filteredList),
-        /* @__PURE__ */ React.createElement(
+        (items == null ? void 0 : items.length) === 0 && !props.loading && (props == null ? void 0 : props.emptyRender) ? props.emptyRender() : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
           GroupMenu,
           {
             selectedKeys: [props.sessionId],
             inlineIndent: 20,
             items,
-            className: menuPrefixCls
+            className: menuPrefixCls,
+            loading: props.loading
           }
-        ),
-        ((_i = props.agent) == null ? void 0 : _i.enabled) && !!((_j = props.agent) == null ? void 0 : _j.onLoadMore) && /* @__PURE__ */ React.createElement(
+        ), ((_i = props.agent) == null ? void 0 : _i.enabled) && !!((_j = props.agent) == null ? void 0 : _j.onLoadMore) && /* @__PURE__ */ React.createElement(
           HistoryLoadMore,
           {
             onLoadMore: handleLoadMore,
             type: props.type,
             className: `${menuPrefixCls}-load-more  ${props.type === "task" ? "" : "chat"} ${hashId}`
           }
-        )
+        ))
       )
     );
   }
@@ -146,15 +146,16 @@ var History = (props) => {
         border: "1px solid var(--color-gray-border-light)"
       },
       getPopupContainer: (p) => p.parentElement || document.body,
-      content: /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
+      content: /* @__PURE__ */ React.createElement(React.Fragment, null, (items == null ? void 0 : items.length) === 0 && !(props == null ? void 0 : props.loading) && (props == null ? void 0 : props.emptyRender) ? /* @__PURE__ */ React.createElement("div", { "data-testid": "empty-state-popover" }, props.emptyRender()) : /* @__PURE__ */ React.createElement(
         GroupMenu,
         {
           selectedKeys: [props.sessionId],
           inlineIndent: 20,
           items,
-          className: menuPrefixCls
+          className: menuPrefixCls,
+          loading: props.loading
         }
-      ), ((_k = props.agent) == null ? void 0 : _k.enabled) && !!((_l = props.agent) == null ? void 0 : _l.onLoadMore) && /* @__PURE__ */ React.createElement(
+      ), ((_k = props.agent) == null ? void 0 : _k.enabled) && !!((_l = props.agent) == null ? void 0 : _l.onLoadMore) && !props.loading && /* @__PURE__ */ React.createElement(
         HistoryLoadMore,
         {
           onLoadMore: handleLoadMore,

package/dist/History/menu.d.ts

@@ -42,6 +42,8 @@ export interface GroupMenuProps {
     inlineIndent?: number;
     /** 菜单模式 - 兼容 Antd Menu */
     mode?: 'vertical' | 'horizontal' | 'inline';
+    /** 加载状态 */
+    loading?: boolean;
 }
 /**
  * GroupMenu 组件 - 兼容 Antd Menu API 的自定义菜单组件

package/dist/History/menu.js

@@ -28,7 +28,7 @@ var __objRest = (source, exclude) => {
 };
 
 // src/History/menu.tsx
-import { ConfigProvider } from "antd";
+import { ConfigProvider, Spin } from "antd";
 import classNames from "classnames";
 import React, { useCallback, useContext } from "react";
 import { useStyle } from "./style";
@@ -158,7 +158,8 @@ var GroupMenu = (props) => {
     inlineIndent = 20,
     className,
     classNames: propsClassNames = {},
-    style
+    style,
+    loading = false
   } = _a, restProps = __objRest(_a, [
     "items",
     "selectedKeys",
@@ -166,10 +167,11 @@ var GroupMenu = (props) => {
     "inlineIndent",
     "className",
     "classNames",
-    "style"
+    "style",
+    "loading"
   ]);
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
-  const prefixCls = getPrefixCls("agent-chat-history-menu");
+  const prefixCls = getPrefixCls("agentic-chat-history-menu");
   const { wrapSSR, hashId } = useStyle(prefixCls);
   const currentSelectedKey = selectedKeys && selectedKeys[0];
   const dataSource = items || [];
@@ -189,7 +191,18 @@ var GroupMenu = (props) => {
         "aria-label": "菜单",
         tabIndex: 0
       }, restProps),
-      dataSource.map((item) => /* @__PURE__ */ React.createElement(
+      loading ? /* @__PURE__ */ React.createElement(
+        "div",
+        {
+          style: {
+            display: "flex",
+            justifyContent: "center",
+            alignItems: "center",
+            height: "100%"
+          }
+        },
+        /* @__PURE__ */ React.createElement(Spin, null)
+      ) : dataSource.map((item) => /* @__PURE__ */ React.createElement(
         MenuItem,
         {
           key: item.key,

package/dist/History/style.js

@@ -266,7 +266,7 @@ var genStyle = (token) => {
   };
 };
 function useStyle(prefixCls) {
-  return useEditorStyleRegister("GroupMenu", (token) => {
+  return useEditorStyleRegister("history-group-menu", (token) => {
     const groupMenuToken = __spreadProps(__spreadValues({}, token), {
       componentCls: `.${prefixCls}`
     });

package/dist/History/types/index.d.ts

@@ -51,12 +51,18 @@ export interface HistoryProps {
             placeholder?: string;
             /** 未展开时的默认文本 */
             text?: string;
+            /** 搜索触发方式: 'change' - 实时搜索(默认), 'enter' - 回车触发 */
+            trigger?: 'change' | 'enter';
         };
     };
     /** 插槽 */
     slots?: {
         beforeHistoryList?: (list: HistoryDataType[]) => React.ReactNode;
     };
+    /** 空状态渲染函数，当历史记录为空时显示 */
+    emptyRender?: () => React.ReactNode;
+    /** 加载状态，显示在 GroupMenu 区域 */
+    loading?: boolean;
 }
 export interface HistoryActionsBoxProps {
     /** 子组件，通常是时间显示或其他内容 */