@ant-design/agentic-ui 2.29.25 → 2.29.27

package/dist/Bubble/AIBubble.js

@@ -275,7 +275,7 @@ var shouldRenderBeforeContent = function shouldRenderBeforeContent(placement, ro
     var _React_useState = _sliced_to_array(React.useState(false), 2), hidePadding = _React_useState[0], setHidePadding = _React_useState[1];
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var context = useContext(BubbleConfigContext);
-    var _ref = context || {}, compact = _ref.compact, standalone = _ref.standalone, locale = _ref.locale;
+    var _ref = context || {}, compact = _ref.compact, standalone = _ref.standalone;
     var prefixClass = getPrefixCls('agentic');
     var _useStyle = useStyle(prefixClass), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
     var preMessageSameRole = isSameRoleAsPrevious(preMessage, originData);
@@ -356,7 +356,6 @@ var shouldRenderBeforeContent = function shouldRenderBeforeContent(placement, ro
         value: {
             compact: compact,
             standalone: !!standalone,
-            locale: locale,
             bubble: props
         }
     }, /*#__PURE__*/ React.createElement(Flex, {

package/dist/Bubble/BubbleConfigProvide.d.ts

@@ -1,5 +1,4 @@
 import React from 'react';
-import { cnLabels } from '../I18n/locales';
 import { ThoughtChainListProps } from '../ThoughtChainList/types';
 import { BubbleProps } from './type';
 export type ChatConfigType = {
@@ -18,7 +17,6 @@ export type ChatConfigType = {
          */
         enable: boolean;
     };
-    locale: Partial<typeof cnLabels>;
     bubble?: BubbleProps<{
         /**
          * 聊天内容

package/dist/Bubble/BubbleConfigProvide.js

@@ -1,6 +1,4 @@
 import React from "react";
-import { cnLabels } from "../I18n/locales";
 export var BubbleConfigContext = /*#__PURE__*/ React.createContext({
-    standalone: false,
-    locale: cnLabels
+    standalone: false
 });

package/dist/Bubble/MessagesContent/BubbleExtra.js

@@ -269,6 +269,7 @@ import { motion } from "framer-motion";
 import React, { useContext, useEffect, useMemo, useState } from "react";
 import { ActionIconBox } from "../../Components/ActionIconBox";
 import { Loading } from "../../Components/Loading";
+import { useLocale } from "../../I18n";
 import { BubbleConfigContext } from "../BubbleConfigProvide";
 import { CopyButton } from "./CopyButton";
 import { VoiceButton } from "./VoiceButton";
@@ -303,9 +304,10 @@ import { VoiceButton } from "./VoiceButton";
         "pure",
         "placement"
     ]);
-    var _originalData_extra, _originalData_extra1, _originalData_extra2, _originalData_extra3, _bubble_originData, _bubble_originData1, _props_rightRender, _context_locale;
+    var _originalData_extra, _originalData_extra1, _originalData_extra2, _originalData_extra3, _bubble_originData, _bubble_originData1, _props_rightRender;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var context = useContext(BubbleConfigContext);
+    var locale = useLocale();
     var _useState = _sliced_to_array(useState(false), 2), feedbackLoading = _useState[0], setFeedbackLoading = _useState[1];
     // 获取聊天项的原始数据
     var originalData = bubble === null || bubble === void 0 ? void 0 : bubble.originData;
@@ -325,35 +327,30 @@ import { VoiceButton } from "./VoiceButton";
         if (alreadyFeedback && (originalData === null || originalData === void 0 ? void 0 : originalData.feedback) === 'thumbsUp') {
             // 已经点赞的情况
             if (props.onLikeCancel || props.onCancelLike) {
-                var _context_locale;
-                return (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.cancel-like']) || '取消点赞';
+                return (locale === null || locale === void 0 ? void 0 : locale['chat.message.cancel-like']) || '取消点赞';
             } else {
-                var _context_locale1;
-                return (context === null || context === void 0 ? void 0 : (_context_locale1 = context.locale) === null || _context_locale1 === void 0 ? void 0 : _context_locale1['chat.message.feedback-success']) || '已经反馈过了哦';
+                return (locale === null || locale === void 0 ? void 0 : locale['chat.message.feedback-success']) || '已经反馈过了哦';
             }
         } else {
-            var _context_locale2;
             // 未点赞的情况
-            return (context === null || context === void 0 ? void 0 : (_context_locale2 = context.locale) === null || _context_locale2 === void 0 ? void 0 : _context_locale2['chat.message.like']) || '喜欢';
+            return (locale === null || locale === void 0 ? void 0 : locale['chat.message.like']) || '喜欢';
         }
     }, [
         alreadyFeedback,
         originalData === null || originalData === void 0 ? void 0 : originalData.feedback,
         !!(props.onLikeCancel || props.onCancelLike),
-        context === null || context === void 0 ? void 0 : context.locale
+        locale
     ]);
     // 获取点踩按钮的标题文本
     var getDislikeButtonTitle = useMemo(function() {
         if (alreadyFeedback) {
-            var _context_locale;
-            return (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.feedback-success']) || '已经反馈过了哦';
+            return (locale === null || locale === void 0 ? void 0 : locale['chat.message.feedback-success']) || '已经反馈过了哦';
         } else {
-            var _context_locale1;
-            return (context === null || context === void 0 ? void 0 : (_context_locale1 = context.locale) === null || _context_locale1 === void 0 ? void 0 : _context_locale1['chat.message.dislike']) || '不喜欢';
+            return (locale === null || locale === void 0 ? void 0 : locale['chat.message.dislike']) || '不喜欢';
         }
     }, [
         alreadyFeedback,
-        context === null || context === void 0 ? void 0 : context.locale
+        locale
     ]);
     var typing = (originalData === null || originalData === void 0 ? void 0 : originalData.isAborted) !== true && (originalData === null || originalData === void 0 ? void 0 : originalData.isFinished) === false && (originalData === null || originalData === void 0 ? void 0 : (_originalData_extra2 = originalData.extra) === null || _originalData_extra2 === void 0 ? void 0 : _originalData_extra2.isHistory) === undefined && (originalData === null || originalData === void 0 ? void 0 : originalData.isFinished) !== undefined;
     var like = useMemo(function() {
@@ -551,8 +548,8 @@ import { VoiceButton } from "./VoiceButton";
    * @constant
    * @type {boolean}
    */ var shouldShowCopy = useMemo(function() {
-        var _originalData_extra, _context_locale;
-        var defaultConditions = (originalData === null || originalData === void 0 ? void 0 : originalData.content) && !(originalData === null || originalData === void 0 ? void 0 : (_originalData_extra = originalData.extra) === null || _originalData_extra === void 0 ? void 0 : _originalData_extra.answerStatus) && (originalData === null || originalData === void 0 ? void 0 : originalData.content) !== ((context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.aborted']) || '回答已停止生成');
+        var _originalData_extra;
+        var defaultConditions = (originalData === null || originalData === void 0 ? void 0 : originalData.content) && !(originalData === null || originalData === void 0 ? void 0 : (_originalData_extra = originalData.extra) === null || _originalData_extra === void 0 ? void 0 : _originalData_extra.answerStatus) && (originalData === null || originalData === void 0 ? void 0 : originalData.content) !== ((locale === null || locale === void 0 ? void 0 : locale['chat.message.aborted']) || '回答已停止生成');
         if (!defaultConditions) {
             return false;
         }
@@ -567,13 +564,12 @@ import { VoiceButton } from "./VoiceButton";
         bubble,
         originalData === null || originalData === void 0 ? void 0 : originalData.content,
         originalData === null || originalData === void 0 ? void 0 : (_originalData_extra3 = originalData.extra) === null || _originalData_extra3 === void 0 ? void 0 : _originalData_extra3.answerStatus,
-        context === null || context === void 0 ? void 0 : context.locale
+        locale
     ]);
     var copyDom = useMemo(function() {
-        var _context_locale;
         return shouldShowCopy ? /*#__PURE__*/ React.createElement(CopyButton, {
             "data-testid": "chat-item-copy-button",
-            title: (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.copy']) || '复制',
+            title: (locale === null || locale === void 0 ? void 0 : locale['chat.message.copy']) || '复制',
             onClick: function onClick() {
                 try {
                     var _bubble_originData;
@@ -591,11 +587,11 @@ import { VoiceButton } from "./VoiceButton";
         }) : null;
     }, [
         shouldShowCopy,
-        context === null || context === void 0 ? void 0 : context.locale,
+        locale,
         (_bubble_originData = bubble.originData) === null || _bubble_originData === void 0 ? void 0 : _bubble_originData.content
     ]);
     var voiceDom = useMemo(function() {
-        var _originalData_extra, _context_locale, _bubble_originData;
+        var _originalData_extra, _bubble_originData;
         /**
      * 判断是否应该显示语音选项。
      *
@@ -604,7 +600,7 @@ import { VoiceButton } from "./VoiceButton";
      *    - 聊天项的原始数据包含内容
      *    - 聊天项的原始数据在额外字段中没有回答状态
      *    - 聊天项的内容不等于本地化的 'chat.message.aborted' 消息或其默认值 '回答已停止生成'
-     * */ var defaultShow = !!(originalData === null || originalData === void 0 ? void 0 : originalData.content) && !(originalData === null || originalData === void 0 ? void 0 : (_originalData_extra = originalData.extra) === null || _originalData_extra === void 0 ? void 0 : _originalData_extra.answerStatus) && !typing && (originalData === null || originalData === void 0 ? void 0 : originalData.content) !== ((context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.aborted']) || '回答已停止生成');
+     * */ var defaultShow = !!(originalData === null || originalData === void 0 ? void 0 : originalData.content) && !(originalData === null || originalData === void 0 ? void 0 : (_originalData_extra = originalData.extra) === null || _originalData_extra === void 0 ? void 0 : _originalData_extra.answerStatus) && !typing && (originalData === null || originalData === void 0 ? void 0 : originalData.content) !== ((locale === null || locale === void 0 ? void 0 : locale['chat.message.aborted']) || '回答已停止生成');
         if (!props.shouldShowVoice || !defaultShow) return null;
         return /*#__PURE__*/ React.createElement(VoiceButton, {
             text: ((_bubble_originData = bubble.originData) === null || _bubble_originData === void 0 ? void 0 : _bubble_originData.content) || '',
@@ -663,11 +659,10 @@ import { VoiceButton } from "./VoiceButton";
         prefixCls
     ]);
     var reSend = useMemo(function() {
-        var _originalData_extra_preMessage, _originalData_extra, _context_locale;
+        var _originalData_extra_preMessage, _originalData_extra;
         console.log('originalData?.isAborted', originalData, typing);
         if ((originalData === null || originalData === void 0 ? void 0 : originalData.isAborted) && !originalData.isFinished) {
-            var _context_locale1;
-            return /*#__PURE__*/ React.createElement("span", null, (context === null || context === void 0 ? void 0 : (_context_locale1 = context.locale) === null || _context_locale1 === void 0 ? void 0 : _context_locale1['chat.message.aborted']) || '回答已停止生成');
+            return /*#__PURE__*/ React.createElement("span", null, (locale === null || locale === void 0 ? void 0 : locale['chat.message.aborted']) || '回答已停止生成');
         }
         if (!(originalData === null || originalData === void 0 ? void 0 : (_originalData_extra = originalData.extra) === null || _originalData_extra === void 0 ? void 0 : (_originalData_extra_preMessage = _originalData_extra.preMessage) === null || _originalData_extra_preMessage === void 0 ? void 0 : _originalData_extra_preMessage.content)) return null;
         if (typing) return null;
@@ -676,29 +671,29 @@ import { VoiceButton } from "./VoiceButton";
             borderLess: true,
             onClick: function onClick() {
                 return _async_to_generator(function() {
-                    var _bubble_originData_extra_preMessage, _bubble_originData_extra, _bubble_originData, _context_locale;
+                    var _bubble_originData_extra_preMessage, _bubble_originData_extra, _bubble_originData;
                     return _ts_generator(this, function(_state) {
-                        onReply === null || onReply === void 0 ? void 0 : onReply(((_bubble_originData = bubble.originData) === null || _bubble_originData === void 0 ? void 0 : (_bubble_originData_extra = _bubble_originData.extra) === null || _bubble_originData_extra === void 0 ? void 0 : (_bubble_originData_extra_preMessage = _bubble_originData_extra.preMessage) === null || _bubble_originData_extra_preMessage === void 0 ? void 0 : _bubble_originData_extra_preMessage.content) || (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.retrySend']) || '重新生成');
+                        onReply === null || onReply === void 0 ? void 0 : onReply(((_bubble_originData = bubble.originData) === null || _bubble_originData === void 0 ? void 0 : (_bubble_originData_extra = _bubble_originData.extra) === null || _bubble_originData_extra === void 0 ? void 0 : (_bubble_originData_extra_preMessage = _bubble_originData_extra.preMessage) === null || _bubble_originData_extra_preMessage === void 0 ? void 0 : _bubble_originData_extra_preMessage.content) || (locale === null || locale === void 0 ? void 0 : locale['chat.message.retrySend']) || '重新生成');
                         return [
                             2
                         ];
                     });
                 })();
             },
-            title: (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.retrySend']) || '重新生成'
+            title: (locale === null || locale === void 0 ? void 0 : locale['chat.message.retrySend']) || '重新生成'
         }, function(isHovered) {
-            var _context_locale;
             return /*#__PURE__*/ React.createElement("div", {
                 className: classNames("".concat(chatCls, "-messages-content-retry")),
                 "data-messages-content-retry": true
             }, /*#__PURE__*/ React.createElement(RefreshLottie, {
                 active: isHovered
-            }), /*#__PURE__*/ React.createElement("span", null, (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.retrySend']) || '重新生成'));
+            }), /*#__PURE__*/ React.createElement("span", null, (locale === null || locale === void 0 ? void 0 : locale['chat.message.retrySend']) || '重新生成'));
         });
     }, [
         originalData === null || originalData === void 0 ? void 0 : originalData.isAborted,
         typing,
-        originalData === null || originalData === void 0 ? void 0 : originalData.isFinished
+        originalData === null || originalData === void 0 ? void 0 : originalData.isFinished,
+        locale
     ]);
     useEffect(function() {
         var _props_onRenderExtraNull;
@@ -758,5 +753,5 @@ import { VoiceButton } from "./VoiceButton";
         style: {
             fontSize: (context === null || context === void 0 ? void 0 : context.compact) ? 20 : 16
         }
-    }), /*#__PURE__*/ React.createElement("span", null, (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.generating']) || '')) : null, reSend || null, (originalData === null || originalData === void 0 ? void 0 : originalData.isAborted) ? copyDom : rightDom);
+    }), /*#__PURE__*/ React.createElement("span", null, (locale === null || locale === void 0 ? void 0 : locale['chat.message.generating']) || '')) : null, reSend || null, (originalData === null || originalData === void 0 ? void 0 : originalData.isAborted) ? copyDom : rightDom);
 };

package/dist/Bubble/MessagesContent/CopyButton/index.js

@@ -214,13 +214,13 @@ function _ts_generator(thisArg, body) {
         };
     }
 }
-import { memo, useContext } from "react";
+import { memo } from "react";
 import { CheckCircleFilled } from "@ant-design/icons";
 import { isFunction } from "lodash-es";
 import React from "react";
 import { ActionIconBox } from "../../../Components/ActionIconBox";
 import { useCopied } from "../../../Hooks/useCopied";
-import { BubbleConfigContext } from "../../BubbleConfigProvide";
+import { useLocale } from "../../../I18n";
 /**
  * CopyIcon 组件 - 复制图标组件
  *
@@ -309,10 +309,9 @@ import { BubbleConfigContext } from "../../BubbleConfigProvide";
         "onClick",
         'data-testid'
     ]);
-    var _context_locale;
     var _useCopied = useCopied(), copied = _useCopied.copied, setCopied = _useCopied.setCopied;
-    var context = useContext(BubbleConfigContext);
-    var copySuccessText = (context === null || context === void 0 ? void 0 : (_context_locale = context.locale) === null || _context_locale === void 0 ? void 0 : _context_locale['chat.message.copy.success']) || '复制成功';
+    var locale = useLocale();
+    var copySuccessText = (locale === null || locale === void 0 ? void 0 : locale['chat.message.copy.success']) || '复制成功';
     return /*#__PURE__*/ React.createElement(ActionIconBox, _object_spread_props(_object_spread({
         onClick: function onClick1(e) {
             return _async_to_generator(function() {

package/dist/Bubble/MessagesContent/MarkdownPreview.js

@@ -54,6 +54,7 @@ import { Popover, theme } from "antd";
 import React, { useContext, useEffect, useMemo } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { MarkdownEditor, parserMdToSchema } from "../..";
+import { useLocale } from "../../I18n";
 import { BubbleConfigContext } from "../BubbleConfigProvide";
 import { MessagesContext } from "./BubbleContext";
 /**
@@ -96,7 +97,9 @@ import { MessagesContext } from "./BubbleContext";
     var content = props.content, extra = props.extra, typing = props.typing, htmlRef = props.htmlRef, fncProps = props.fncProps, docListNode = props.docListNode, beforeContent = props.beforeContent, afterContent = props.afterContent;
     var MarkdownEditorRef = React.useRef(undefined);
     var hidePadding = (useContext(MessagesContext) || {}).hidePadding;
-    var _ref = useContext(BubbleConfigContext) || {}, locale = _ref.locale, standalone = _ref.standalone;
+    var config = useContext(BubbleConfigContext);
+    var locale = useLocale();
+    var standalone = config === null || config === void 0 ? void 0 : config.standalone;
     var token = theme.useToken().token;
     var isPaddingHidden = useMemo(function() {
         return !!extra;

package/dist/Bubble/PureBubble.js

@@ -279,7 +279,7 @@ export var PureBubble = /*#__PURE__*/ memo(function(props) {
     var _React_useState = _sliced_to_array(React.useState(false), 2), hidePadding = _React_useState[0], setHidePadding = _React_useState[1];
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var context = useContext(BubbleConfigContext);
-    var _ref1 = context || {}, compact = _ref1.compact, standalone = _ref1.standalone, locale = _ref1.locale;
+    var _ref1 = context || {}, compact = _ref1.compact, standalone = _ref1.standalone;
     var prefixClass = getPrefixCls('agentic');
     var _useStyle = useStyle(prefixClass), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
     var placement = (_props_placement = props.placement) !== null && _props_placement !== void 0 ? _props_placement : 'left';
@@ -452,7 +452,6 @@ export var PureBubble = /*#__PURE__*/ memo(function(props) {
         value: {
             compact: compact,
             standalone: !!standalone,
-            locale: locale,
             bubble: props
         }
     }, /*#__PURE__*/ React.createElement(Flex, {

package/dist/Bubble/UserBubble.js

@@ -128,7 +128,7 @@ var getContentStyle = function getContentStyle(standalone, customStyle) {
     var _React_useState = _sliced_to_array(React.useState(false), 2), hidePadding = _React_useState[0], setHidePadding = _React_useState[1];
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var context = useContext(BubbleConfigContext);
-    var _ref = context || {}, compact = _ref.compact, standalone = _ref.standalone, locale = _ref.locale;
+    var _ref = context || {}, compact = _ref.compact, standalone = _ref.standalone;
     var prefixClass = getPrefixCls('agentic');
     var _useStyle = useStyle(prefixClass, classNames), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;
     var time = (originData === null || originData === void 0 ? void 0 : originData.createAt) || props.time;
@@ -180,7 +180,6 @@ var getContentStyle = function getContentStyle(standalone, customStyle) {
         value: {
             compact: compact,
             standalone: !!standalone,
-            locale: locale,
             bubble: props
         }
     }, /*#__PURE__*/ React.createElement(Flex, {

package/dist/History/index.js

@@ -131,7 +131,7 @@ import { ConfigProvider, Popover } from "antd";
 import classNames from "clsx";
 import React, { memo, useContext, useMemo, useRef } from "react";
 import useClickAway from "../Hooks/useClickAway";
-import { ActionIconBox, BubbleConfigContext } from "../index";
+import { ActionIconBox, I18nContext } from "../index";
 import { HistoryEmpty, HistoryLoadMore, HistoryNewChat, HistorySearch, generateHistoryItems } from "./components";
 import { useHistory } from "./hooks/useHistory";
 import GroupMenu from "./menu";
@@ -175,7 +175,7 @@ export * from "./utils";
     var _props_agent, _props_agent1, _props_agent2;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var menuPrefixCls = getPrefixCls('agentic-chat-history-menu');
-    var locale = (useContext(BubbleConfigContext) || {}).locale;
+    var locale = useContext(I18nContext).locale;
     var containerRef = useRef(null);
     // 注册样式
     var _useStyle = useStyle(menuPrefixCls), wrapSSR = _useStyle.wrapSSR, hashId = _useStyle.hashId;

package/dist/I18n/index.d.ts

@@ -24,6 +24,7 @@ export declare function saveUserLanguage(language: 'zh-CN' | 'en-US'): void;
  * 国际化上下文
  *
  * 提供国际化功能的React Context，包含当前语言环境和设置语言的方法。
+ * 所有国际化文案应统一通过 I18nContext 获取，保证单一数据源。
  */
 export declare const I18nContext: React.Context<{
     locale: LocalKeys;
@@ -31,6 +32,15 @@ export declare const I18nContext: React.Context<{
     setLanguage?: ((language: 'zh-CN' | 'en-US') => void) | undefined;
     setLocale?: ((locale: LocalKeys) => void) | undefined;
 }>;
+/**
+ * 从 I18nContext 获取当前 locale，国际化统一入口
+ */
+export declare function useLocale(): LocalKeys;
+/**
+ * 获取合并后的 locale：以 I18nContext 为基准，用 override 覆盖部分 key
+ * 用于 Bubble 等支持 config 级文案覆盖的场景，仍以 I18nContext 为主
+ */
+export declare function useMergedLocale(override?: Partial<LocalKeys>): LocalKeys;
 /**
  * I18nProvide 组件 - 国际化提供者组件
  *

package/dist/I18n/index.js

@@ -6,6 +6,19 @@ function _array_like_to_array(arr, len) {
 function _array_with_holes(arr) {
     if (Array.isArray(arr)) return arr;
 }
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
 function _iterable_to_array_limit(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
@@ -33,6 +46,21 @@ function _iterable_to_array_limit(arr, i) {
 function _non_iterable_rest() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
 function _sliced_to_array(arr, i) {
     return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
 }
@@ -133,10 +161,28 @@ export { cnLabels, enLabels };
  * 国际化上下文
  *
  * 提供国际化功能的React Context，包含当前语言环境和设置语言的方法。
+ * 所有国际化文案应统一通过 I18nContext 获取，保证单一数据源。
  */ export var I18nContext = /*#__PURE__*/ React.createContext({
     locale: cnLabels,
     language: 'zh-CN'
 });
+/**
+ * 从 I18nContext 获取当前 locale，国际化统一入口
+ */ export function useLocale() {
+    return useContext(I18nContext).locale;
+}
+/**
+ * 获取合并后的 locale：以 I18nContext 为基准，用 override 覆盖部分 key
+ * 用于 Bubble 等支持 config 级文案覆盖的场景，仍以 I18nContext 为主
+ */ export function useMergedLocale(override) {
+    var locale = useContext(I18nContext).locale;
+    return useMemo(function() {
+        return override ? _object_spread({}, locale, override) : locale;
+    }, [
+        locale,
+        override
+    ]);
+}
 /**
  * I18nProvide 组件 - 国际化提供者组件
  *

package/dist/Schema/SchemaForm/index.js

@@ -101,7 +101,7 @@ import { Plus } from "@sofa-design/icons";
 import { Button, Card, Form, Input, InputNumber, Select, Space } from "antd";
 import { merge } from "lodash-es";
 import React, { memo, useCallback, useContext, useEffect, useMemo } from "react";
-import { I18nContext, cnLabels } from "../../I18n";
+import { I18nContext } from "../../I18n";
 /**
  * SchemaForm 组件 - 基于Schema的表单组件
  *
@@ -156,7 +156,7 @@ import { I18nContext, cnLabels } from "../../I18n";
     var schema = param.schema, onValuesChange = param.onValuesChange, initialValues = param.initialValues, _param_readonly = param.readonly, readonly = _param_readonly === void 0 ? false : _param_readonly;
     var _Form_useForm = _sliced_to_array(Form.useForm(), 1), form = _Form_useForm[0];
     var _ref = (schema === null || schema === void 0 ? void 0 : schema.component) || {}, _ref_properties = _ref.properties, properties = _ref_properties === void 0 ? {} : _ref_properties;
-    var _useContext = useContext(I18nContext), _useContext_locale = _useContext.locale, locale = _useContext_locale === void 0 ? cnLabels : _useContext_locale;
+    var locale = useContext(I18nContext).locale;
     // 生成表单验证规则
     var generateRules = useCallback(function(property) {
         var rules = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.29.25",
+  "version": "2.29.27",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",
@@ -150,6 +150,7 @@
     "@vitejs/plugin-react": "^4.7.0",
     "@vitest/coverage-istanbul": "^2.1.9",
     "@vitest/ui": "2.1.9",
+    "cross-env": "^7.0.3",
     "dumi": "^2.4.21",
     "dumi-theme-antd-style": "^0.31.1",
     "eslint": "^8.57.1",
@@ -172,7 +173,6 @@
     "sast": "^0.8.1",
     "stylelint": "^14.16.1",
     "typescript": "^5.9.3",
-    "cross-env": "^7.0.3",
     "vitest": "^2.1.9"
   },
   "peerDependencies": {