@ant-design/agentic-ui 2.0.24 → 2.0.25

package/dist/AgenticLayout/index.d.ts

@@ -19,6 +19,8 @@ export interface AgenticLayoutProps {
     rightWidth?: number;
     /** 最小高度 */
     minHeight?: string | number;
+    /** 子元素（用于兼容性，实际内容应使用 center 属性） */
+    children?: ReactNode;
 }
 /**
  * AgenticLayout 组件 - 智能体布局组件

package/dist/Bubble/List/index.d.ts

@@ -13,9 +13,14 @@ export type BubbleListProps = {
     bubbleListRef?: MutableRefObject<HTMLDivElement | null>;
     bubbleRef?: MutableRefObject<any | undefined>;
     /**
-     * 是否正在加载
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
      */
     loading?: boolean;
+    /**
+     * 加载状态
+     */
+    isLoading?: boolean;
     pure?: boolean;
     /**
      * 组件的类名

package/dist/Bubble/List/index.js

@@ -32,7 +32,8 @@ var BubbleList = (props) => {
     bubbleListRef,
     bubbleRenderConfig,
     className,
-    loading,
+    loading: legacyLoading,
+    isLoading,
     styles,
     classNames,
     markdownRenderConfig,
@@ -44,6 +45,7 @@ var BubbleList = (props) => {
     onWheel,
     onTouchMove
   } = props;
+  const loading = isLoading != null ? isLoading : legacyLoading;
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const { compact } = useContext(BubbleConfigContext) || {};
   const prefixClass = getPrefixCls("agentic-bubble-list");

package/dist/Bubble/type.d.ts

@@ -2,302 +2,124 @@ import { TooltipProps } from 'antd';
 import { ReactNode } from 'react';
 import { MarkdownEditorProps } from '../MarkdownEditor/types';
 import { AttachmentFile } from '../MarkdownInputField/AttachmentButton/types';
-import { WhiteBoxProcessInterface } from '../ThoughtChainList/types';
 import type { UseSpeechAdapter } from './MessagesContent/VoiceButton';
 import { BubbleExtraProps } from './types/BubbleExtra';
 import { DocInfoListProps } from './types/DocInfo';
+import { BaseStyleProps, WithFalse, MessageBubbleData, BubbleMetaData, MultiStyleProps, MultiClassNameProps } from '../Types';
 /**
  * 基础样式属性
+ * @deprecated 请使用 BaseStyleProps from '../Types'
  */
-export interface BubbleStyleProps {
-    /**
-     * 自定义 CSS 类名
-     */
-    className?: string;
-    /**
-     * 自定义 CSS 样式
-     */
-    style?: React.CSSProperties;
-}
+export type BubbleStyleProps = BaseStyleProps;
 /**
- * 气泡项样式属性
+ * 气泡样式配置
+ * @description 气泡组件各部分的样式配置
  */
-export interface BubbleItemStyleProps extends BubbleStyleProps {
-    styles?: {
-        /**
-         * 气泡根容器的自定义样式
-         */
-        bubbleStyle?: React.CSSProperties;
-        /**
-         * 头像标题区域的自定义样式
-         */
-        bubbleAvatarTitleStyle?: React.CSSProperties;
-        /**
-         * 主容器的自定义样式
-         */
-        bubbleContainerStyle?: React.CSSProperties;
-        /**
-         * 加载图标的自定义样式
-         */
-        bubbleLoadingIconStyle?: React.CSSProperties;
-        /**
-         * 名称区域的自定义样式
-         */
-        bubbleNameStyle?: React.CSSProperties;
-        /**
-         * 内容的自定义样式
-         */
-        bubbleListItemContentStyle?: React.CSSProperties;
-        /**
-         * 内容前置区域的自定义样式
-         */
-        bubbleListItemBeforeStyle?: React.CSSProperties;
-        /**
-         * 内容后置区域的自定义样式
-         */
-        bubbleListItemAfterStyle?: React.CSSProperties;
-        /**
-         * 标题的自定义样式
-         */
-        bubbleListItemTitleStyle?: React.CSSProperties;
-        /**
-         * 头像的自定义样式
-         */
-        bubbleListItemAvatarStyle?: React.CSSProperties;
-        /**
-         * 额外内容的自定义样式
-         */
-        bubbleListItemExtraStyle?: React.CSSProperties;
-    };
-    classNames?: {
-        /**
-         * 气泡根容器的自定义类名
-         */
-        bubbleClassName?: string;
-        /**
-         * 头像标题区域的自定义类名
-         */
-        bubbleAvatarTitleClassName?: string;
-        /**
-         * 主容器的自定义类名
-         */
-        bubbleContainerClassName?: string;
-        /**
-         * 加载图标的自定义类名
-         */
-        bubbleLoadingIconClassName?: string;
-        /**
-         * 名称区域的自定义类名
-         */
-        bubbleNameClassName?: string;
-        /**
-         * 内容的自定义类名
-         */
-        bubbleListItemContentClassName?: string;
-        /**
-         * 内容前置区域的自定义类名
-         */
-        bubbleListItemBeforeClassName?: string;
-        /**
-         * 内容后置区域的自定义类名
-         */
-        bubbleListItemAfterClassName?: string;
-        /**
-         * 标题的自定义类名
-         */
-        bubbleListItemTitleClassName?: string;
-        /**
-         * 头像的自定义类名
-         */
-        bubbleListItemAvatarClassName?: string;
-        bubbleListItemExtraClassName?: string;
-    };
-}
-/**
- * 气泡元数据
- */
-export interface BubbleMetaData {
-    /**
-     * 角色头像
-     */
-    avatar?: string;
-    /**
-     * 背景色
-     */
-    backgroundColor?: string;
+export interface BubbleStyles {
+    [key: string]: React.CSSProperties | undefined;
     /**
-     * 名称
+     * 气泡根容器的自定义样式
      */
-    title?: string;
+    bubbleStyle?: React.CSSProperties;
     /**
-     * 其他元数据
+     * 头像标题区域的自定义样式
      */
-    [key: string]: any;
-}
-/**
- * 消息数据
- */
-export interface MessageBubbleData<T extends Record<string, any> = Record<string, any>> {
+    bubbleAvatarTitleStyle?: React.CSSProperties;
     /**
-     * @title 内容
-     * @description 消息的显示内容，可以是React元素
-     * @example <div>Hello, world!</div>
+     * 主容器的自定义样式
      */
-    content?: React.ReactNode;
+    bubbleContainerStyle?: React.CSSProperties;
     /**
-     * @title 原始内容
-     * @description 消息的原始文本内容，通常用于存储未经处理的文本
-     * @example "Hello, world!"
+     * 加载图标的自定义样式
      */
-    originContent?: string;
+    bubbleLoadingIconStyle?: React.CSSProperties;
     /**
-     * @title 错误信息
-     * @description 消息处理过程中可能出现的错误
-     * @example { code: "ERROR_CODE", message: "发生了错误" }
+     * 名称区域的自定义样式
      */
-    error?: any;
+    bubbleNameStyle?: React.CSSProperties;
     /**
-     * @title 模型标识
-     * @description 生成此消息的AI模型标识符
-     * @example "gpt-4"
+     * 内容的自定义样式
      */
-    model?: string;
+    bubbleListItemContentStyle?: React.CSSProperties;
     /**
-     * @title 名称
-     * @description 消息发送者的名称
-     * @example "用户小明"
+     * 内容前置区域的自定义样式
      */
-    name?: string;
+    bubbleListItemBeforeStyle?: React.CSSProperties;
     /**
-     * @title 父消息ID
-     * @description 当前消息回复的消息ID，用于构建消息树结构
-     * @example "msg_123456"
+     * 内容后置区域的自定义样式
      */
-    parentId?: string;
+    bubbleListItemAfterStyle?: React.CSSProperties;
     /**
-     * @title 角色
-     * @description 消息发送者的角色，如用户、助手等
-     * @example "user" 或 "assistant"
+     * 标题的自定义样式
      */
-    role: 'user' | 'system' | 'assistant' | 'agent' | 'bot';
+    bubbleListItemTitleStyle?: React.CSSProperties;
     /**
-     * @title 创建时间
-     * @description 消息创建的时间戳（毫秒）
-     * @example 1625097600000
+     * 头像的自定义样式
      */
-    createAt: number;
+    bubbleListItemAvatarStyle?: React.CSSProperties;
     /**
-     * @title 消息结束时间
-     * @description 消息生成或接收完成的时间戳（毫秒）
-     * @example 1625097605000
+     * 额外内容的自定义样式
      */
-    endTime?: number;
+    bubbleListItemExtraStyle?: React.CSSProperties;
+}
+/**
+ * 气泡类名配置
+ * @description 气泡组件各部分的类名配置
+ */
+export interface BubbleClassNames {
+    [key: string]: string | undefined;
     /**
-     * @title 唯一标识
-     * @description 消息的唯一标识符
-     * @example "msg_abcdef123456"
+     * 气泡根容器的自定义类名
      */
-    id: string;
+    bubbleClassName?: string;
     /**
-     * @title 修改时间
-     * @description 消息最后修改的时间戳（毫秒）
-     * @example 1625097610000
+     * 头像标题区域的自定义类名
      */
-    updateAt: number;
+    bubbleAvatarTitleClassName?: string;
     /**
-     * @title 附加数据
-     * @description 消息的额外信息，可以包含多种自定义数据
+     * 主容器的自定义类名
      */
-    extra?: T & {
-        /**
-         * @title 白盒处理过程
-         * @description 模型处理过程的可解释性数据
-         */
-        white_box_process?: WhiteBoxProcessInterface[] | WhiteBoxProcessInterface;
-        /**
-         * @title 聊天跟踪ID
-         * @description 用于追踪整个对话流程的ID
-         * @example "trace_xyz789"
-         */
-        chat_trace_id?: string;
-        /**
-         * @title 会话ID
-         * @description 当前会话的唯一标识符
-         * @example "session_123abc"
-         */
-        sessionId?: string;
-        /**
-         * @title 消息UUID
-         * @description 消息的全局唯一标识符
-         * @example "uuid_456def"
-         */
-        uuid?: string;
-        /**
-         * @title 客户端ID
-         * @description 问答对的客户端标识符
-         * @example "client_789ghi"
-         */
-        clientId?: string;
-        /**
-         * @title 标签列表
-         * @description 消息的分类标签
-         * @example ["NORMAL", "ABOUT_YOU"]
-         */
-        tags?: ('REJECT_TO_ANSWER' | 'ABOUT_YOU' | 'NORMAL')[];
-    };
+    bubbleContainerClassName?: string;
     /**
-     * @title 模型元数据
-     * @description 有关生成此消息的模型的额外信息
-     * @example { model: "gpt-4", temperature: 0.7, tokens: { total: 150, prompt: 50, completion: 100 } }
+     * 加载图标的自定义类名
      */
-    meta?: BubbleMetaData;
+    bubbleLoadingIconClassName?: string;
     /**
-     * @title 是否完成
-     * @description 标识消息是否已完全生成或接收完成
-     * @example true
+     * 名称区域的自定义类名
      */
-    isFinished?: boolean;
+    bubbleNameClassName?: string;
     /**
-     * @title 是否被终止
-     * @description 标识消息生成是否被中途终止
-     * @example false
+     * 内容的自定义类名
      */
-    isAborted?: boolean;
+    bubbleListItemContentClassName?: string;
     /**
-     * @title 用户反馈
-     * @description 用户对消息的评价反馈
-     * - thumbsUp: 点赞，表示满意
-     * - thumbsDown: 点踩，表示不满意
-     * - none: 无反馈
-     * @example "thumbsUp"
+     * 内容前置区域的自定义类名
      */
-    feedback?: 'thumbsUp' | 'thumbsDown' | 'none';
+    bubbleListItemBeforeClassName?: string;
     /**
-     * @title 是否重试
-     * @description 标识当前消息是否是之前消息的重试
-     * @example false
+     * 内容后置区域的自定义类名
      */
-    isRetry?: boolean;
+    bubbleListItemAfterClassName?: string;
     /**
-     * @title 文件映射
-     * @description 消息相关的附件文件映射
-     * @example new Map([["file1", { name: "示例.pdf", size: 1024, type: "application/pdf" }]])
+     * 标题的自定义类名
      */
-    fileMap?: Map<string, AttachmentFile>;
+    bubbleListItemTitleClassName?: string;
     /**
-     * @deprecated 已废弃，请使用 isLast 代替
-     * @description 已废弃，请使用 isLast 代替
-     * @example true
+     * 头像的自定义类名
      */
-    isLatest?: boolean;
+    bubbleListItemAvatarClassName?: string;
     /**
-     * @title 是否为最后一个节点
-     * @description 用于标识当前消息是否为对话中的最新消息
-     * @default false
-     * @optional
+     * 额外内容的自定义类名
      */
-    isLast?: boolean;
+    bubbleListItemExtraClassName?: string;
+}
+/**
+ * 气泡项样式属性
+ * @description 包含单一根样式和多个子元素样式的完整配置
+ */
+export interface BubbleItemStyleProps extends BubbleStyleProps, MultiStyleProps<BubbleStyles>, MultiClassNameProps<BubbleClassNames> {
 }
+export type { BubbleMetaData, MessageBubbleData } from '../Types';
 /**
  * 自定义配置
  */
@@ -314,7 +136,7 @@ export interface CustomConfig {
         contentStyle?: React.CSSProperties;
     };
 }
-export type WithFalse<T> = T | false;
+export type { WithFalse } from '../Types';
 /**
  * 气泡渲染配置
  */

package/dist/Bubble/types/BubbleExtra.d.ts

@@ -1,24 +1,5 @@
 import React from 'react';
-export type WithFalse<T> = T | false;
-export interface MessageBubbleData<T = Record<string, any>> {
-    content?: React.ReactNode;
-    originContent?: string;
-    error?: any;
-    model?: string;
-    name?: string;
-    parentId?: string;
-    role: 'user' | 'system' | 'assistant' | 'agent' | 'bot';
-    createAt: number;
-    endTime?: number;
-    id: string;
-    updateAt: number;
-    extra?: T;
-    isFinished?: boolean;
-    isAborted?: boolean;
-    feedback?: 'thumbsUp' | 'thumbsDown' | 'none';
-    isRetry?: boolean;
-    isLatest?: boolean;
-}
+import { WithFalse, MessageBubbleData } from '../../Types';
 export interface SimpleBubbleProps<T = Record<string, any>> {
     originData?: T & MessageBubbleData;
     [key: string]: any;

package/dist/ChatLayout/types.d.ts

@@ -1,19 +1,16 @@
-import type { CSSProperties, ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { LayoutHeaderConfig } from '../Components/LayoutHeader';
+import type { BaseStyleProps } from '../Types';
 /**
  * ChatLayout 组件的属性接口
  */
-export interface ChatLayoutProps {
+export interface ChatLayoutProps extends BaseStyleProps {
     /** 头部配置 */
     header?: LayoutHeaderConfig;
     /** 内容区域的自定义内容 */
     children?: ReactNode;
     /** 底部区域的自定义内容 */
     footer?: ReactNode;
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: CSSProperties;
 }
 export interface ChatLayoutRef {
     scrollContainer: HTMLDivElement | null;

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

@@ -10,7 +10,13 @@ export type ActionIconBoxProps = {
     transform?: boolean;
     className?: string;
     borderLess?: boolean;
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
     loading?: boolean;
+    /** 加载状态 */
+    isLoading?: boolean;
     style?: React.CSSProperties;
     active?: boolean;
     onInit?: () => void;

package/dist/Components/ActionIconBox/index.js

@@ -46,9 +46,10 @@ import { useMergedState } from "rc-util";
 import React, { useContext, useEffect, useMemo } from "react";
 import { useStyle } from "./style";
 var ActionIconBox = (props) => {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e;
+  const propLoading = (_a = props.isLoading) != null ? _a : props.loading;
   const [loading, setLoading] = useMergedState(false, {
-    value: props.loading,
+    value: propLoading,
     onChange: props.onLoadingChange
   });
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
@@ -94,16 +95,16 @@ var ActionIconBox = (props) => {
       __spreadValues({
         title: props.title,
         arrow: false,
-        mouseEnterDelay: 2
+        mouseEnterDelay: 1
       }, props.tooltipProps),
       /* @__PURE__ */ React.createElement(
         "span",
         {
-          "data-title": (_a = props.title) == null ? void 0 : _a.toString(),
+          "data-title": (_b = props.title) == null ? void 0 : _b.toString(),
           "data-testid": props["data-testid"] || "action-icon-box",
           role: "button",
           tabIndex: 0,
-          "aria-label": (_b = props.title) == null ? void 0 : _b.toString(),
+          "aria-label": (_c = props.title) == null ? void 0 : _c.toString(),
           className: cx(prefixCls, hashId, props.className, {
             [`${prefixCls}-danger`]: props.type === "danger",
             [`${prefixCls}-primary`]: props.type === "primary",
@@ -157,8 +158,8 @@ var ActionIconBox = (props) => {
         "data-testid": props["data-testid"] || "action-icon-box",
         role: "button",
         tabIndex: 0,
-        "aria-label": (_c = props.title) == null ? void 0 : _c.toString(),
-        title: (_d = props.title) == null ? void 0 : _d.toString(),
+        "aria-label": (_d = props.title) == null ? void 0 : _d.toString(),
+        title: (_e = props.title) == null ? void 0 : _e.toString(),
         className: cx(prefixCls, hashId, props.className, {
           [`${prefixCls}-danger`]: props.type === "danger",
           [`${prefixCls}-primary`]: props.type === "primary",

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

@@ -7,7 +7,13 @@ export interface IconButtonProps {
     active?: boolean;
     elevated?: boolean;
     size?: 'base' | 'sm' | 'xs';
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
     loading?: boolean;
+    /** 加载状态 */
+    isLoading?: boolean;
     onClick?: () => void | Promise<void>;
     className?: string;
     style?: React.CSSProperties;

package/dist/Components/Button/IconButton/index.js

@@ -12,9 +12,11 @@ var IconButton = ({
   active,
   elevated,
   size = "base",
-  loading,
+  loading: legacyLoading,
+  isLoading,
   onClick
 }) => {
+  const loading = isLoading != null ? isLoading : legacyLoading;
   const context = useContext(ConfigProvider.ConfigContext);
   const prefixCls = context == null ? void 0 : context.getPrefixCls("icon-button");
   const { wrapSSR, hashId } = useStyle(prefixCls);

package/dist/Components/LayoutHeader/types.d.ts

@@ -35,7 +35,4 @@ export interface LayoutHeaderConfig {
 /**
  * 布局头部组件属性接口
  */
-export interface LayoutHeaderProps extends LayoutHeaderConfig {
-    /** 自定义类名 */
-    className?: string;
-}
+export type LayoutHeaderProps = LayoutHeaderConfig;

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

@@ -30,8 +30,13 @@ export interface VisualListProps {
     emptyRender?: () => React.ReactNode;
     /** 自定义列表项渲染函数 */
     renderItem?: (item: VisualListItem, index: number) => React.ReactNode;
-    /** 是否显示加载状态 */
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
     loading?: boolean;
+    /** 加载状态 */
+    isLoading?: boolean;
     /** 加载状态自定义渲染函数 */
     loadingRender?: () => React.ReactNode;
     /** 列表项自定义样式 */

package/dist/Components/VisualList/index.js

@@ -31,7 +31,8 @@ var VisualListComponent = ({
   filter,
   emptyRender,
   renderItem,
-  loading = false,
+  loading: legacyLoading = false,
+  isLoading,
   loadingRender,
   itemStyle,
   imageStyle,
@@ -41,6 +42,7 @@ var VisualListComponent = ({
   variant = "default",
   description
 }) => {
+  const loading = isLoading != null ? isLoading : legacyLoading;
   const { wrapSSR, hashId } = useStyle(prefixCls);
   const displayList = useMemo(() => {
     if (!filter) {

package/dist/History/components/HistoryList.js

@@ -30,7 +30,16 @@ var generateHistoryItems = ({
       return formatTime(item.gmtCreate);
     }
   );
-  const items = Object.keys(groupList).map((key) => {
+  const groupMaxTimes = Object.fromEntries(
+    Object.entries(groupList).map(([key, list]) => [
+      key,
+      Math.max(...list.map((item) => dayjs(item.gmtCreate).valueOf()))
+    ])
+  );
+  const sortedGroupKeys = Object.keys(groupList).sort(
+    (keyA, keyB) => (groupMaxTimes[keyB] || 0) - (groupMaxTimes[keyA] || 0)
+  );
+  const items = sortedGroupKeys.map((key) => {
     var _a;
     const list = groupList[key];
     const firstItem = list == null ? void 0 : list.at(0);

package/dist/History/index.d.ts

@@ -15,7 +15,8 @@ export * from './utils';
  * @param {Function} props.request - 请求函数，用于获取历史数据
  * @param {Function} [props.onInit] - 组件初始化时的回调函数
  * @param {Function} [props.onShow] - 组件显示时的回调函数
- * @param {Function} [props.onSelected] - 选择历史记录项时的回调函数 (已弃用，请使用 onClick)
+ * @param {Function} [props.onSelected] - (已废弃，请使用 onClick) 选择历史记录项时的回调函数
+ * @param {Function} [props.onClick] - 点击历史记录项时的回调函数
  * @param {Function} [props.onDeleteItem] - 删除历史记录项时的回调函数
  * @param {Function} [props.customDateFormatter] - 日期格式化函数
  * @param {boolean} [props.standalone] - 是否以独立模式显示，为true时直接显示菜单，否则显示为下拉菜单

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

@@ -61,8 +61,13 @@ export interface HistoryProps {
     };
     /** 空状态渲染函数，当历史记录为空时显示 */
     emptyRender?: () => React.ReactNode;
-    /** 加载状态，显示在 GroupMenu 区域 */
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
     loading?: boolean;
+    /** 加载状态，显示在 GroupMenu 区域 */
+    isLoading?: boolean;
 }
 export interface HistoryActionsBoxProps {
     /** 子组件，通常是时间显示或其他内容 */

package/dist/MarkdownEditor/editor/components/LazyElement/index.d.ts

@@ -3,8 +3,8 @@ import React from 'react';
  * LazyElement 组件属性
  */
 export interface LazyElementProps {
-    /** 元素在文档中的位置信息 */
-    elementInfo: {
+    /** 元素在文档中的位置信息（可选，用于自定义占位符渲染） */
+    elementInfo?: {
         /** 元素类型 */
         type: string;
         /** 元素在文档中的索引 */
@@ -29,7 +29,7 @@ export interface LazyElementProps {
         /** 元素是否即将进入视口 */
         isIntersecting: boolean;
         /** 元素在文档中的位置信息 */
-        elementInfo: {
+        elementInfo?: {
             /** 元素类型 */
             type: string;
             /** 元素在文档中的索引 */

package/dist/MarkdownEditor/types.d.ts

@@ -192,8 +192,8 @@ export type MarkdownEditorProps = {
             style: React.CSSProperties;
             /** 元素是否即将进入视口 */
             isIntersecting: boolean;
-            /** 元素在文档中的位置信息 */
-            elementInfo: {
+            /** 元素在文档中的位置信息（可选） */
+            elementInfo?: {
                 /** 元素类型 */
                 type: string;
                 /** 元素在文档中的索引 */

package/dist/MarkdownInputField/AttachmentButton/AttachmentButtonPopover.js

@@ -75,7 +75,7 @@ var AttachmentButtonPopover = ({ children, supportedFormat }) => {
     Tooltip,
     {
       arrow: false,
-      mouseEnterDelay: 2,
+      mouseEnterDelay: 1,
       trigger: ["hover", "click"],
       title: /* @__PURE__ */ React.createElement(AttachmentSupportedFormatsContent, { supportedFormat })
     },

package/dist/MarkdownInputField/AttachmentButton/index.js

@@ -200,8 +200,8 @@ var BUTTON_TITLE_STYLE = {
 };
 var ButtonContent = ({ title }) => {
   if (!title)
-    return /* @__PURE__ */ React.createElement("div", { style: BUTTON_WITH_TITLE_STYLE }, /* @__PURE__ */ React.createElement(Paperclip, null));
-  return /* @__PURE__ */ React.createElement("div", { style: BUTTON_WITH_TITLE_STYLE }, /* @__PURE__ */ React.createElement(Paperclip, null), /* @__PURE__ */ React.createElement("div", { style: BUTTON_TITLE_STYLE }, title));
+    return /* @__PURE__ */ React.createElement(Paperclip, null);
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(Paperclip, null), /* @__PURE__ */ React.createElement("div", { style: BUTTON_TITLE_STYLE }, title));
 };
 var AttachmentButton = ({ disabled, uploadImage, title, supportedFormat, render }) => {
   const context = useContext(ConfigProvider.ConfigContext);
@@ -214,9 +214,9 @@ var AttachmentButton = ({ disabled, uploadImage, title, supportedFormat, render
     uploadImage == null ? void 0 : uploadImage();
   };
   const wrapper = render ? render({
-    children: /* @__PURE__ */ React.createElement(ButtonContent, { title }),
+    children: /* @__PURE__ */ React.createElement("div", { style: BUTTON_WITH_TITLE_STYLE }, /* @__PURE__ */ React.createElement(ButtonContent, { title })),
     supportedFormat: format
-  }) : /* @__PURE__ */ React.createElement(AttachmentButtonPopover, { supportedFormat: format }, /* @__PURE__ */ React.createElement(ButtonContent, { title }));
+  }) : /* @__PURE__ */ React.createElement(AttachmentButtonPopover, { supportedFormat: format }, /* @__PURE__ */ React.createElement("div", { style: BUTTON_WITH_TITLE_STYLE }, /* @__PURE__ */ React.createElement(ButtonContent, { title })));
   return wrapSSR(
     /* @__PURE__ */ React.createElement(
       "div",

package/dist/MarkdownInputField/VoiceInput/index.js

@@ -60,7 +60,7 @@ var VoiceInputButton = (props) => {
     /* @__PURE__ */ React.createElement(
       Tooltip,
       {
-        mouseEnterDelay: 2,
+        mouseEnterDelay: 1,
         arrow: false,
         title: recording ? (locale == null ? void 0 : locale["input.voiceInputting"]) || "语音输入中，点击可停止。" : (locale == null ? void 0 : locale["input.voiceInput"]) || "语音输入"
       },

package/dist/Plugins/chart/AreaChart/style.js

@@ -25,6 +25,14 @@ import {
 var genStyle = (token) => {
   return {
     [token.componentCls]: {
+      // 统计数据容器样式
+      "&-statistic-container": {
+        display: "flex",
+        gap: "16px",
+        marginBottom: "16px",
+        flexWrap: "wrap",
+        alignItems: "flex-start"
+      },
       // 面积图容器样式
       ".chart-wrapper": {
         width: "100%",

package/dist/Plugins/chart/BarChart/style.js

@@ -25,6 +25,14 @@ import {
 var genStyle = (token) => {
   return {
     [token.componentCls]: {
+      // 统计数据容器样式
+      "&-statistic-container": {
+        display: "flex",
+        gap: "16px",
+        marginBottom: "16px",
+        flexWrap: "wrap",
+        alignItems: "flex-start"
+      },
       // 柱状图容器样式
       ".chart-wrapper": {
         width: "100%",

package/dist/Plugins/chart/RadarChart/index.d.ts

@@ -3,10 +3,13 @@ import { ChartContainerProps } from '../components';
 import { StatisticConfigType } from '../hooks/useChartStatistic';
 export interface RadarChartDataItem {
     category?: string;
-    label: string;
+    label?: string;
     type?: string;
-    score: number | string;
+    score?: number | string;
     filterLabel?: string;
+    x?: string;
+    y?: number;
+    [key: string]: any;
 }
 interface RadarChartProps extends ChartContainerProps {
     /** 扁平化数据数组 */
@@ -17,6 +20,12 @@ interface RadarChartProps extends ChartContainerProps {
     width?: number | string;
     /** 图表高度，默认400px */
     height?: number | string;
+    /** 自定义边框颜色 */
+    borderColor?: string;
+    /** 自定义背景颜色 */
+    backgroundColor?: string;
+    /** 自定义点背景颜色 */
+    pointBackgroundColor?: string;
     /** 自定义CSS类名 */
     className?: string;
     /** 数据时间 */

package/dist/ThoughtChainList/types.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="react" />
 import { MarkdownEditorProps } from '../MarkdownEditor';
+import { BaseStyleProps } from '../Types';
 export interface WhiteBoxProcessInterface {
     /** 分类类型
      * @example "TableSql"
@@ -126,18 +127,22 @@ export interface DocMeta {
     origin_text?: string;
     answer?: string;
 }
-export interface ThoughtChainListProps {
+export interface ThoughtChainListProps extends BaseStyleProps {
     titleRender?: (props: ThoughtChainListProps, defaultDom: React.ReactNode) => React.ReactNode;
     thoughtChainList: WhiteBoxProcessInterface[];
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
     loading?: boolean;
+    /** 加载状态 */
+    isLoading?: boolean;
     bubble?: {
         isFinished?: boolean;
         endTime?: number;
         createAt?: number;
         isAborted?: boolean;
     };
-    className?: string;
-    style?: React.CSSProperties;
     compact?: boolean;
     markdownRenderProps?: MarkdownEditorProps;
     finishAutoCollapse?: boolean;

package/dist/Types/common.d.ts

@@ -0,0 +1,68 @@
+import React from 'react';
+/**
+ * 基础样式属性
+ * @description 用于需要自定义样式和类名的组件
+ */
+export interface BaseStyleProps {
+    /**
+     * 自定义 CSS 类名
+     */
+    className?: string;
+    /**
+     * 自定义 CSS 样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 多层级样式属性
+ * @description 用于支持多个子元素自定义样式的组件
+ */
+export interface MultiStyleProps<T> {
+    /**
+     * 多个子元素的样式配置
+     */
+    styles?: T;
+}
+/**
+ * 多层级类名属性
+ * @description 用于支持多个子元素自定义类名的组件
+ */
+export interface MultiClassNameProps<T> {
+    /**
+     * 多个子元素的类名配置
+     */
+    classNames?: T;
+}
+/**
+ * 工具类型：表示值可以是 T 或 false
+ * @description 用于条件渲染函数，false 表示不渲染
+ */
+export type WithFalse<T> = T | false;
+/**
+ * 角色类型
+ * @description 消息发送者的角色类型
+ */
+export type RoleType = 'user' | 'system' | 'assistant' | 'agent' | 'bot';
+/**
+ * 反馈类型
+ * @description 用户对消息的评价反馈类型
+ */
+export type FeedbackType = 'thumbsUp' | 'thumbsDown' | 'none';
+/**
+ * 基础状态属性
+ * @description 组件的常用状态属性
+ */
+export interface BaseStateProps {
+    /**
+     * 加载状态
+     */
+    isLoading?: boolean;
+    /**
+     * 禁用状态
+     */
+    isDisabled?: boolean;
+    /**
+     * 只读状态
+     */
+    readonly?: boolean;
+}

package/dist/Types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 通用类型定义
+ * @description 导出项目中共享的类型定义，减少重复
+ */
+export * from './common';
+export * from './message';

package/dist/Types/index.js

@@ -0,0 +1,3 @@
+// src/Types/index.ts
+export * from "./common";
+export * from "./message";

package/dist/Types/message.d.ts

@@ -0,0 +1,190 @@
+import React from 'react';
+import { AttachmentFile } from '../MarkdownInputField/AttachmentButton/types';
+import { WhiteBoxProcessInterface } from '../ThoughtChainList/types';
+import { FeedbackType, RoleType } from './common';
+/**
+ * 气泡元数据
+ */
+export interface BubbleMetaData {
+    /**
+     * 角色头像
+     */
+    avatar?: string;
+    /**
+     * 背景色
+     */
+    backgroundColor?: string;
+    /**
+     * 名称
+     */
+    title?: string;
+    /**
+     * 其他元数据
+     */
+    [key: string]: any;
+}
+/**
+ * 消息数据
+ * @description 聊天消息的完整数据结构
+ */
+export interface MessageBubbleData<T extends Record<string, any> = Record<string, any>> {
+    /**
+     * @title 内容
+     * @description 消息的显示内容，可以是React元素
+     * @example <div>Hello, world!</div>
+     */
+    content?: React.ReactNode;
+    /**
+     * @title 原始内容
+     * @description 消息的原始文本内容，通常用于存储未经处理的文本
+     * @example "Hello, world!"
+     */
+    originContent?: string;
+    /**
+     * @title 错误信息
+     * @description 消息处理过程中可能出现的错误
+     * @example { code: "ERROR_CODE", message: "发生了错误" }
+     */
+    error?: any;
+    /**
+     * @title 模型标识
+     * @description 生成此消息的AI模型标识符
+     * @example "gpt-4"
+     */
+    model?: string;
+    /**
+     * @title 名称
+     * @description 消息发送者的名称
+     * @example "用户小明"
+     */
+    name?: string;
+    /**
+     * @title 父消息ID
+     * @description 当前消息回复的消息ID，用于构建消息树结构
+     * @example "msg_123456"
+     */
+    parentId?: string;
+    /**
+     * @title 角色
+     * @description 消息发送者的角色，如用户、助手等
+     * @example "user" 或 "assistant"
+     */
+    role: RoleType;
+    /**
+     * @title 创建时间
+     * @description 消息创建的时间戳（毫秒）
+     * @example 1625097600000
+     */
+    createAt: number;
+    /**
+     * @title 消息结束时间
+     * @description 消息生成或接收完成的时间戳（毫秒）
+     * @example 1625097605000
+     */
+    endTime?: number;
+    /**
+     * @title 唯一标识
+     * @description 消息的唯一标识符
+     * @example "msg_abcdef123456"
+     */
+    id: string;
+    /**
+     * @title 修改时间
+     * @description 消息最后修改的时间戳（毫秒）
+     * @example 1625097610000
+     */
+    updateAt: number;
+    /**
+     * @title 附加数据
+     * @description 消息的额外信息，可以包含多种自定义数据
+     */
+    extra?: T & {
+        /**
+         * @title 白盒处理过程
+         * @description 模型处理过程的可解释性数据
+         */
+        white_box_process?: WhiteBoxProcessInterface[] | WhiteBoxProcessInterface;
+        /**
+         * @title 聊天跟踪ID
+         * @description 用于追踪整个对话流程的ID
+         * @example "trace_xyz789"
+         */
+        chat_trace_id?: string;
+        /**
+         * @title 会话ID
+         * @description 当前会话的唯一标识符
+         * @example "session_123abc"
+         */
+        sessionId?: string;
+        /**
+         * @title 消息UUID
+         * @description 消息的全局唯一标识符
+         * @example "uuid_456def"
+         */
+        uuid?: string;
+        /**
+         * @title 客户端ID
+         * @description 问答对的客户端标识符
+         * @example "client_789ghi"
+         */
+        clientId?: string;
+        /**
+         * @title 标签列表
+         * @description 消息的分类标签
+         * @example ["NORMAL", "ABOUT_YOU"]
+         */
+        tags?: ('REJECT_TO_ANSWER' | 'ABOUT_YOU' | 'NORMAL')[];
+    };
+    /**
+     * @title 模型元数据
+     * @description 有关生成此消息的模型的额外信息
+     * @example { model: "gpt-4", temperature: 0.7, tokens: { total: 150, prompt: 50, completion: 100 } }
+     */
+    meta?: BubbleMetaData;
+    /**
+     * @title 是否完成
+     * @description 标识消息是否已完全生成或接收完成
+     * @example true
+     */
+    isFinished?: boolean;
+    /**
+     * @title 是否被终止
+     * @description 标识消息生成是否被中途终止
+     * @example false
+     */
+    isAborted?: boolean;
+    /**
+     * @title 用户反馈
+     * @description 用户对消息的评价反馈
+     * - thumbsUp: 点赞，表示满意
+     * - thumbsDown: 点踩，表示不满意
+     * - none: 无反馈
+     * @example "thumbsUp"
+     */
+    feedback?: FeedbackType;
+    /**
+     * @title 是否重试
+     * @description 标识当前消息是否是之前消息的重试
+     * @example false
+     */
+    isRetry?: boolean;
+    /**
+     * @title 文件映射
+     * @description 消息相关的附件文件映射
+     * @example new Map([["file1", { name: "示例.pdf", size: 1024, type: "application/pdf" }]])
+     */
+    fileMap?: Map<string, AttachmentFile>;
+    /**
+     * @deprecated 已废弃，请使用 isLast 代替
+     * @description 已废弃，请使用 isLast 代替
+     * @example true
+     */
+    isLatest?: boolean;
+    /**
+     * @title 是否为最后一个节点
+     * @description 用于标识当前消息是否为对话中的最新消息
+     * @default false
+     * @optional
+     */
+    isLast?: boolean;
+}

package/dist/WelcomeMessage/index.d.ts

@@ -11,7 +11,7 @@ export interface WelcomeMessageProps {
     /** 标题 */
     title?: React.ReactNode;
     /** 描述 */
-    description?: string;
+    description?: React.ReactNode;
     /** 自定义样式类名，用于各个提示项的不同部分 */
     classNames?: {
         title?: string;

package/dist/Workspace/types.d.ts

@@ -133,14 +133,19 @@ export interface FileProps extends BaseChildProps {
      * 对外暴露的操作引用，允许外部主动打开预览或返回列表
      */
     actionRef?: React.MutableRefObject<FileActionRef | null>;
+    /**
+     * @deprecated 请使用 isLoading 代替
+     * @description 已废弃，将在未来版本移除
+     */
+    loading?: boolean;
     /**
      * 是否显示加载状态
      * @description 当为true时，显示加载动画，通常在文件列表数据加载过程中使用
      */
-    loading?: boolean;
+    isLoading?: boolean;
     /**
      * 自定义加载渲染函数
-     * @description 当loading为true时，如果提供了此函数则使用自定义渲染，否则使用默认的Spin组件
+     * @description 当isLoading为true时，如果提供了此函数则使用自定义渲染，否则使用默认的Spin组件
      */
     loadingRender?: () => React.ReactNode;
     /**

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export * from './MarkdownEditor/editor/store';
 export * from './MarkdownEditor/editor/utils';
 export * from './MarkdownEditor/editor/utils/docx/index';
 export * from './MarkdownEditor/editor/utils/markdownToHtml';
+export * from './Types';
 export { default as Workspace } from './Workspace';
 export * from './AnswerAlert';
 export * from './BackTo';
@@ -56,7 +57,7 @@ export { default as Quote } from './Quote';
 export * from './Plugins/chart';
 export * from './Plugins/mermaid';
 export * from './MarkdownEditor/types';
-export type { BubbleItemStyleProps, BubbleRenderConfig, BubbleStyleProps, CustomConfig, WithFalse, } from './Bubble/type';
+export type { BubbleClassNames, BubbleItemStyleProps, BubbleRenderConfig, BubbleStyles, BubbleStyleProps, CustomConfig, WithFalse, } from './Bubble/type';
 export type { CustomConfig as BubbleCustomConfig } from './Bubble/type';
 export * from './Bubble/types/DocInfo';
 export * from './ThoughtChainList/types';

package/dist/index.js

@@ -30,6 +30,7 @@ export * from "./MarkdownEditor/editor/store";
 export * from "./MarkdownEditor/editor/utils";
 export * from "./MarkdownEditor/editor/utils/docx/index";
 export * from "./MarkdownEditor/editor/utils/markdownToHtml";
+export * from "./Types";
 import { default as default2 } from "./Workspace";
 export * from "./AnswerAlert";
 export * from "./BackTo";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.0.24",
+  "version": "2.0.25",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",