@ant-design/agentic-ui 2.4.0 → 2.4.2

package/dist/Workspace/File/FileComponent.d.ts

@@ -1,62 +1,13 @@
 import React, { type FC } from 'react';
 import type { MarkdownEditorProps } from '../../MarkdownEditor';
 import type { FileNode, FileProps } from '../types';
-/**
- * FileComponent 组件 - 文件管理组件
- *
- * 该组件提供一个完整的文件管理界面，支持文件列表显示、分组管理、
- * 文件预览、下载等功能。支持多种文件类型的预览和自定义预览内容。
- *
- * @component
- * @description 文件管理组件，支持文件列表、预览、下载等功能
- * @param {Object} props - 组件属性
- * @param {FileNode[]} props.nodes - 文件节点列表
- * @param {(files: FileNode[], groupType: FileType) => void} [props.onGroupDownload] - 分组下载回调
- * @param {(file: FileNode) => void} [props.onDownload] - 单个文件下载回调
- * @param {(file: FileNode) => void} [props.onFileClick] - 文件点击回调
- * @param {(type: FileType, collapsed: boolean) => void} [props.onToggleGroup] - 分组折叠/展开回调
- * @param {(file: FileNode) => Promise<React.ReactNode | FileNode>} [props.onPreview] - 文件预览回调
- * @param {Partial<MarkdownEditorProps>} [props.markdownEditorProps] - Markdown编辑器配置
- * @param {React.ReactNode | (() => React.ReactNode)} [props.emptyRender] - 自定义空状态渲染
- * @param {string} [props.keyword] - 搜索关键字（受控）
- * @param {(keyword: string) => void} [props.onChange] - 搜索关键字变化回调
- * @param {boolean} [props.showSearch] - 是否显示搜索框，默认显示
- * @param {string} [props.searchPlaceholder] - 搜索框占位符
- *
- * @example
- * ```tsx
- * <FileComponent
- *   nodes={fileNodes}
- *   onDownload={(file) => console.log('下载文件:', file.name)}
- *   onPreview={async (file) => {
- *     // 自定义预览逻辑
- *     return <div>预览内容</div>;
- *   }}
- *   markdownEditorProps={{
- *     theme: 'dark'
- *   }}
- *   emptyRender={<MyEmpty />}
- *   keyword={keyword}
- *   onChange={setKeyword}
- * />
- * ```
- *
- * @returns {React.ReactElement|null} 渲染的文件管理组件，无文件时返回null
- *
- * @remarks
- * - 支持文件分组显示和折叠/展开
- * - 支持多种文件类型的预览（图片、文档、代码等）
- * - 支持自定义预览内容和头部
- * - 提供文件下载和分组下载功能
- * - 支持Markdown文件的编辑器预览
- * - 处理异步预览的竞态条件
- */
 export declare const FileComponent: FC<{
     nodes: FileProps['nodes'];
     onGroupDownload?: FileProps['onGroupDownload'];
     onDownload?: FileProps['onDownload'];
     onShare?: FileProps['onShare'];
     onFileClick?: FileProps['onFileClick'];
+    onLocate?: FileProps['onLocate'];
     onToggleGroup?: FileProps['onToggleGroup'];
     onPreview?: FileProps['onPreview'];
     onBack?: FileProps['onBack'];
@@ -84,4 +35,6 @@ export declare const FileComponent: FC<{
     showSearch?: boolean;
     /** 搜索框占位符 */
     searchPlaceholder?: string;
+    /** 是否在元素上绑定 DOM id（默认 false） */
+    bindDomId?: FileProps['bindDomId'];
 }>;

package/dist/Workspace/File/FileComponent.js

@@ -45,6 +45,7 @@ import {
   ChevronDown as DownIcon,
   Download as DownloadIcon,
   Eye as EyeIcon,
+  Locate,
   ChevronRight as RightIcon,
   Search,
   SquareArrowOutUpRight as ShareIcon
@@ -130,10 +131,12 @@ var AccessibleButton = ({
   icon,
   onClick,
   className,
-  ariaLabel
+  ariaLabel,
+  id
 }) => /* @__PURE__ */ React.createElement(
   "div",
   {
+    id,
     className,
     onClick,
     role: "button",
@@ -170,7 +173,17 @@ var SearchInput = React.memo(
   }
 );
 SearchInput.displayName = "SearchInput";
-var FileItemComponent = ({ file, onClick, onDownload, onPreview, onShare, prefixCls, hashId }) => {
+var FileItemComponent = ({
+  file,
+  onClick,
+  onDownload,
+  onPreview,
+  onShare,
+  onLocate,
+  prefixCls,
+  hashId,
+  bindDomId = false
+}) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const { locale } = useContext(I18nContext);
   const finalPrefixCls = prefixCls || getPrefixCls("workspace-file");
@@ -223,6 +236,11 @@ var FileItemComponent = ({ file, onClick, onDownload, onPreview, onShare, prefix
     return onPreview && (isImageFile(fileWithId) ? !!(fileWithId.url || fileWithId.previewUrl) : fileTypeProcessor.processFile(fileWithId).canPreview);
   })();
   const showShareButton = fileWithId.canShare === true;
+  const showLocationButton = fileWithId.canLocate === true;
+  const handleLocate = (e) => {
+    e.stopPropagation();
+    onLocate == null ? void 0 : onLocate(fileWithId);
+  };
   return /* @__PURE__ */ React.createElement(
     AccessibleButton,
     {
@@ -297,6 +315,19 @@ var FileItemComponent = ({ file, onClick, onDownload, onPreview, onShare, prefix
           },
           /* @__PURE__ */ React.createElement(EyeIcon, null)
         ),
+        showLocationButton && /* @__PURE__ */ React.createElement(
+          ActionIconBox,
+          {
+            title: (locale == null ? void 0 : locale["workspace.file.location"]) || "定位",
+            onClick: handleLocate,
+            tooltipProps: { mouseEnterDelay: 0.3 },
+            className: classNames(
+              `${finalPrefixCls}-item-action-btn`,
+              hashId
+            )
+          },
+          /* @__PURE__ */ React.createElement(Locate, null)
+        ),
         showShareButton && /* @__PURE__ */ React.createElement(
           ActionIconBox,
           {
@@ -326,7 +357,8 @@ var FileItemComponent = ({ file, onClick, onDownload, onPreview, onShare, prefix
       )),
       onClick: handleClick,
       className: classNames(`${finalPrefixCls}-item`, hashId),
-      ariaLabel: `${(locale == null ? void 0 : locale["workspace.file"]) || "文件"}：${fileWithId.name}`
+      ariaLabel: `${(locale == null ? void 0 : locale["workspace.file"]) || "文件"}：${fileWithId.name}`,
+      id: bindDomId ? fileWithId.id : void 0
     }
   );
 };
@@ -434,8 +466,10 @@ var FileGroupComponent = ({
   onFileClick,
   onPreview,
   onShare,
+  onLocate,
   prefixCls,
-  hashId
+  hashId,
+  bindDomId
 }) => {
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const finalPrefixCls = prefixCls || getPrefixCls("workspace-file");
@@ -457,8 +491,10 @@ var FileGroupComponent = ({
       onDownload,
       onPreview,
       onShare,
+      onLocate,
       prefixCls: finalPrefixCls,
-      hashId
+      hashId,
+      bindDomId: !!bindDomId
     }
   ))));
 };
@@ -468,6 +504,7 @@ var FileComponent = ({
   onDownload,
   onShare,
   onFileClick,
+  onLocate,
   onToggleGroup,
   onPreview,
   onBack,
@@ -481,7 +518,8 @@ var FileComponent = ({
   keyword,
   onChange,
   showSearch = false,
-  searchPlaceholder
+  searchPlaceholder,
+  bindDomId = false
 }) => {
   const [previewFile, setPreviewFile] = useState(null);
   const [customPreviewContent, setCustomPreviewContent] = useState(null);
@@ -590,7 +628,7 @@ var FileComponent = ({
               download: () => handleDownloadInPreview(file),
               share: () => {
                 if (onShare) {
-                  onShare(file);
+                  onShare(file, void 0);
                 } else {
                   handleDefaultShare(file, locale);
                 }
@@ -705,6 +743,7 @@ var FileComponent = ({
             handleDefaultShare(file, locale);
           }
         },
+        onLocate,
         customContent: customPreviewContent || void 0,
         customHeader: customPreviewHeader || void 0,
         customActions: typeof customActions === "function" ? customActions(previewFile) : customActions,
@@ -740,8 +779,10 @@ var FileComponent = ({
             onFileClick,
             onPreview: handlePreview,
             onShare,
+            onLocate,
             prefixCls,
-            hashId
+            hashId,
+            bindDomId
           }
         );
       }
@@ -754,8 +795,10 @@ var FileComponent = ({
           onDownload,
           onShare,
           onPreview: handlePreview,
+          onLocate,
           prefixCls,
-          hashId
+          hashId,
+          bindDomId
         }
       );
     });

package/dist/Workspace/File/FileTypeProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTypeProcessor.d.ts","sourceRoot":"","sources":["FileTypeProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,QAAQ,EACR,QAAQ,EAET,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW;IACX,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa;IACb,aAAa,EAAE,iBAAiB,CAAC;IACjC,cAAc;IACd,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa;IACb,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAExD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB;IAsDhD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB;IAkB9C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA0BlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA0B7B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA2C,CAAC;AAQ1E;;GAEG;AACH,eAAO,MAAM,WAAW,SAAU,QAAQ,KAAG,OACH,CAAC;AAE3C,eAAO,MAAM,WAAW,SAAU,QAAQ,KAAG,OACH,CAAC;AAE3C,eAAO,MAAM,SAAS,SAAU,QAAQ,KAAG,OACH,CAAC;AAEzC,eAAO,MAAM,UAAU,SAAU,QAAQ,KAAG,OACH,CAAC;AAE1C,eAAO,MAAM,aAAa,SAAU,QAAQ,KAAG,OACH,CAAC;AAE7C,eAAO,MAAM,WAAW,SAAU,QAAQ,KAAG,OACH,CAAC;AAE3C,eAAO,MAAM,WAAW,SAAU,QAAQ,KAAG,MAG5C,CAAC"}

package/dist/Workspace/File/PreviewComponent.d.ts

@@ -22,6 +22,8 @@ export interface PreviewComponentProps {
         anchorEl?: HTMLElement;
         origin?: string;
     }) => void;
+    /** 定位回调 */
+    onLocate?: (file: FileNode) => void;
     /** Markdown 编辑器配置 */
     markdownEditorProps?: Partial<Omit<MarkdownEditorProps, 'editorRef' | 'initValue' | 'readonly'>>;
     /** 头部文件信息覆盖 */
@@ -29,14 +31,5 @@ export interface PreviewComponentProps {
 }
 /**
  * 文件预览组件
- *
- * @example
- * ```tsx
- * <PreviewComponent
- *   file={fileNode}
- *   onBack={() => setPreviewFile(null)}
- *   customActions={<Button icon={<EditIcon />}>编辑</Button>}
- * />
- * ```
  */
 export declare const PreviewComponent: FC<PreviewComponentProps>;

package/dist/Workspace/File/PreviewComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewComponent.d.ts","sourceRoot":"","sources":["PreviewComponent.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAA2C,MAAM,OAAO,CAAC;AAGhF,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAgDpC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,cAAc;IACd,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,YAAY;IACZ,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,cAAc;IACd,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW;IACX,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,WAAW;IACX,OAAO,CAAC,EAAE,CACR,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAClD,IAAI,CAAC;IACV,WAAW;IACX,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,qBAAqB;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAC3B,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC,CAClE,CAAC;IACF,eAAe;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxC;AA6DD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA2jBtD,CAAC"}

package/dist/Workspace/File/PreviewComponent.js

@@ -20,6 +20,7 @@ import { LoadingOutlined } from "@ant-design/icons";
 import {
   Download as DownloadIcon,
   ArrowLeft as LeftIcon,
+  Locate,
   SquareArrowOutUpRight as ShareIcon
 } from "@sofa-design/icons";
 import {
@@ -108,6 +109,7 @@ var PreviewComponent = ({
   onBack,
   onDownload,
   onShare,
+  onLocate,
   markdownEditorProps,
   headerFileOverride
 }) => {
@@ -138,6 +140,9 @@ var PreviewComponent = ({
       origin: "preview"
     });
   };
+  const handleLocate = () => {
+    onLocate == null ? void 0 : onLocate(file);
+  };
   useEffect(() => {
     if (customContent)
       return;
@@ -525,6 +530,15 @@ var PreviewComponent = ({
         className: classNames(`${prefixCls}-custom-actions`, hashId)
       },
       customActions
+    ), onLocate && file.canLocate === true && /* @__PURE__ */ React.createElement(
+      ActionIconBox,
+      {
+        title: (locale == null ? void 0 : locale["workspace.file.location"]) || "定位",
+        onClick: handleLocate,
+        tooltipProps: { mouseEnterDelay: 0.3 },
+        className: classNames(`${prefixCls}-item-action-btn`, hashId)
+      },
+      /* @__PURE__ */ React.createElement(Locate, null)
     ), onShare && file.canShare === true && /* @__PURE__ */ React.createElement(
       ActionIconBox,
       {

package/dist/Workspace/File/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/Workspace/File/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["style.ts"],"names":[],"mappings":";AAoeA,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM;;;EAS9C"}

package/dist/Workspace/File/style.js

@@ -22,6 +22,12 @@ var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 import { useEditorStyleRegister } from "../../Hooks/useStyle";
 var genStyle = (token) => {
   return {
+    // 定位高亮动画关键帧
+    "@keyframes flash-shadow": {
+      "0%, 100%": {
+        boxShadow: "-5.23px -3.23px 12px 0 rgba(229, 255, 115, 40%), 4.23px 5.23px 16px 0 rgba(0, 206, 255, 24.12%)"
+      }
+    },
     // 文件组件样式
     [`${token.componentCls}-container`]: {
       height: "100%",
@@ -109,6 +115,13 @@ var genStyle = (token) => {
       cursor: "pointer",
       transition: "all 0.2s cubic-bezier(0.645, 0.045, 0.355, 1)",
       boxSizing: "border-box",
+      // 定位高亮动画
+      "&:target": {
+        animationName: "flash-shadow",
+        animationDuration: "3s",
+        animationTimingFunction: "ease-in-out",
+        animationIterationCount: 1
+      },
       "&:last-child": {
         marginBottom: 0
       },

package/dist/Workspace/File/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAGL,QAAQ,EACR,QAAQ,EAER,SAAS,EACV,MAAM,UAAU,CAAC;AAqClB;;GAEG;AACH,eAAO,MAAM,eAAe,SACpB,QAAQ,eACD,MAAM,SAAS,aACjB,MAAM,iGAmBlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,UAChB,SAAS,aACL,QAAQ,eACN,MAAM,SAAS,iGA6C7B,CAAC;AAGF,eAAO,MAAM,gBAAgB,SAAU,QAAQ,GAAG,SAAS,KAAG,MAO7D,CAAC"}

package/dist/Workspace/HtmlPreview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAwC,MAAM,OAAO,CAAC;AAE7D,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAE5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAsJlD,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/Workspace/HtmlPreview/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["style.ts"],"names":[],"mappings":";AA6DA,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM;;;EASrD"}

package/dist/Workspace/RealtimeFollow/index.js

@@ -159,7 +159,8 @@ var RealtimeHeader = ({ data, hasBorder, prefixCls, hashId }) => {
           className: classNames(
             `${finalPrefixCls}-header-subtitle`,
             hashId
-          )
+          ),
+          title: headerSubTitle
         },
         headerSubTitle
       )

package/dist/Workspace/RealtimeFollow/style.js

@@ -78,7 +78,10 @@ var genStyle = (token) => {
         [`&-left`]: {
           display: "flex",
           alignItems: "center",
-          gap: "8px"
+          gap: "8px",
+          flex: 1,
+          minWidth: 0,
+          overflow: "hidden"
         },
         [`&-icon`]: {
           display: "flex",
@@ -106,12 +109,15 @@ var genStyle = (token) => {
         [`&-content`]: {
           display: "flex",
           alignItems: "center",
-          gap: "12px"
+          gap: "12px",
+          minWidth: 0
         },
         [`&-title-wrapper`]: {
           display: "flex",
           flexDirection: "column",
-          gap: "-4px"
+          gap: "-4px",
+          flex: 1,
+          minWidth: 0
         },
         [`&-title`]: {
           display: "flex",
@@ -130,8 +136,13 @@ var genStyle = (token) => {
           color: "var(--color-gray-text-secondary)",
           font: "var(--font-text-body-sm)",
           letterSpacing: "var(--letter-spacing-body-sm, normal)",
-          gridColumn: "1 / span 2"
+          gridColumn: "1 / span 2",
           // 下一行并与图标左对齐，横跨两列
+          display: "block",
+          maxWidth: "100%",
+          whiteSpace: "nowrap",
+          overflow: "hidden",
+          textOverflow: "ellipsis"
         },
         [`&-right`]: {
           display: "flex",

package/dist/Workspace/Task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAc,MAAM,OAAO,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAC9C,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;KACrD,EAAE,CAAC;CACL;AAwBD,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAiChD,CAAC"}

package/dist/Workspace/Task/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["style.ts"],"names":[],"mappings":";AAwDA,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM;;;EAS9C"}

package/dist/Workspace/index.d.ts

@@ -7,48 +7,8 @@ declare const TaskComponent: FC<TaskProps>;
 declare const FileComponent: FC<FileProps>;
 declare const CustomComponent: FC<CustomProps>;
 /**
- * Workspace 组件 - 工作空间组件
- *
- * 该组件提供一个多标签页的工作空间界面，支持实时跟随、浏览器、任务、文件等多种功能模块。
- * 每个标签页可以独立配置，支持自定义图标、标题、计数等功能。
- *
- * @component
- * @description 工作空间组件，提供多标签页功能模块管理
- * @param {WorkspaceProps} props - 组件属性
- * @param {string} [props.activeTabKey] - 当前激活的标签页key
- * @param {(key: string) => void} [props.onTabChange] - 标签页切换回调
- * @param {React.CSSProperties} [props.style] - 自定义样式
- * @param {string} [props.className] - 自定义CSS类名
- * @param {string} [props.title] - 工作空间标题
- * @param {() => void} [props.onClose] - 关闭回调
- * @param {boolean} [props.pure] - 纯净模式，关闭阴影和边框
- * @param {React.ReactNode} [props.children] - 子组件，支持Workspace.Realtime、Workspace.Browser等
- *
- * @example
- * ```tsx
- * <Workspace
- *   title="我的工作空间"
- *   activeTabKey="realtime"
- *   onTabChange={(key) => console.log('切换到:', key)}
- *   onClose={() => console.log('关闭工作空间')}
- * >
- *   <Workspace.Realtime data={realtimeData} />
- *   <Workspace.Browser data={browserData} />
- *   <Workspace.Task data={taskData} />
- *   <Workspace.File {...fileProps} />
- * </Workspace>
- * ```
- *
- * @returns {React.ReactElement} 渲染的工作空间组件
- *
- * @remarks
- * - 支持多种功能模块标签页
- * - 自动根据子组件生成标签页
- * - 支持标签页的展开/折叠状态管理
- * - 提供响应式布局适配
- * - 支持自定义标签页配置
- * - 集成国际化支持
- * - 提供关闭功能
+ * 工作空间组件
+ * 提供多标签页界面，支持实时跟随、浏览器、任务、文件等功能模块
  */
 declare const Workspace: FC<WorkspaceProps> & {
     Realtime: typeof RealtimeComponent;

package/dist/Workspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.tsx"],"names":[],"mappings":"AASA,OAAc,EACZ,EAAE,EAMH,MAAM,OAAO,CAAC;AAOf,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EAGb,SAAS,EACT,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAsD7C,QAAA,MAAM,iBAAiB,EAAE,EAAE,CAAC,aAAa,CACS,CAAC;AACnD,QAAA,MAAM,gBAAgB,EAAE,EAAE,CAAC,YAAY,CACI,CAAC;AAC5C,QAAA,MAAM,aAAa,EAAE,EAAE,CAAC,SAAS,CACO,CAAC;AACzC,QAAA,MAAM,aAAa,EAAE,EAAE,CAAC,SAAS,CAAkC,CAAC;AACpE,QAAA,MAAM,eAAe,EAAE,EAAE,CAAC,WAAW,CAAsC,CAAC;AAiB5E;;;GAGG;AACH,QAAA,MAAM,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG;IACpC,QAAQ,EAAE,OAAO,iBAAiB,CAAC;IACnC,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,IAAI,EAAE,OAAO,aAAa,CAAC;IAC3B,MAAM,EAAE,OAAO,eAAe,CAAC;CA6LhC,CAAC;AAQF,cAAc,QAAQ,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,eAAe,SAAS,CAAC"}

package/dist/Workspace/index.js

@@ -132,11 +132,8 @@ var Workspace = ({
         key: tabConfig.key,
         icon: tabConfig.icon,
         componentType,
-        // 保存组件类型
         label: /* @__PURE__ */ React.createElement("div", { className: classNames(`${prefixCls}-tab-item`, hashId) }, /* @__PURE__ */ React.createElement("span", { className: classNames(`${prefixCls}-tab-title`, hashId) }, tabConfig.title), tabConfig.count !== void 0 && /* @__PURE__ */ React.createElement("span", { className: classNames(`${prefixCls}-tab-count`, hashId) }, tabConfig.count)),
-        content: React.createElement(child.type, __spreadValues(__spreadValues({}, child.props), componentType === "file" /* FILE */ && {
-          resetKey
-        }))
+        content: React.createElement(child.type, __spreadValues(__spreadValues({}, child.props), componentType === "file" /* FILE */ && { resetKey }))
       });
     });
     return tabs;

package/dist/Workspace/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["style.ts"],"names":[],"mappings":";AAqJA,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM;;;EASnD"}

package/dist/Workspace/types.d.ts

@@ -79,6 +79,8 @@ export interface FileNode extends BaseNode {
     canDownload?: boolean;
     /** 用户自定义是否可以分享（默认隐藏，设置为 true 显示） */
     canShare?: boolean;
+    /** 用户自定义是否可以定位（默认隐藏，设置为 true 显示） */
+    canLocate?: boolean;
     loading?: boolean;
 }
 export interface GroupNode extends BaseNode {
@@ -101,6 +103,7 @@ export interface FileProps extends BaseChildProps {
     onGroupDownload?: (files: FileNode[], groupType: FileType) => void;
     onDownload?: (file: FileNode) => void;
     onFileClick?: (file: FileNode) => void;
+    onLocate?: (file: FileNode) => void;
     onToggleGroup?: (groupType: FileType, collapsed: boolean) => void;
     /** 重置标识，用于重置预览状态（内部使用） */
     resetKey?: number;
@@ -161,6 +164,12 @@ export interface FileProps extends BaseChildProps {
     showSearch?: boolean;
     /** 搜索框占位符 */
     searchPlaceholder?: string;
+    /**
+     * 是否在文件项根元素上绑定 DOM id
+     * @default false
+     * @description 置为 false 时，不会向元素写入 id 属性（不影响 React key）
+     */
+    bindDomId?: boolean;
 }
 export interface CustomProps extends BaseChildProps {
     children?: ReactNode;

package/dist/Workspace/utils/codeLanguageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeLanguageUtils.d.ts","sourceRoot":"","sources":["codeLanguageUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4GH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,aAAc,MAAM,KAAG,MAsC1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,aAAc,MAAM,KAAG,OAEtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,YACxB,MAAM,YACL,MAAM,KACf,MAQF,CAAC"}

package/dist/Workspace/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["utils.tsx"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,cAAc,SAAU,MAAM,GAAG,MAAM,KAAG,MAatD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAQjE,CAAC"}

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",
@@ -52,7 +52,7 @@
     "@better-scroll/observe-dom": "^2.5.1",
     "@better-scroll/scroll-bar": "^2.5.1",
     "@juggle/resize-observer": "^3.4.0",
-    "@sofa-design/icons": "^1.5.3",
+    "@sofa-design/icons": "^1.6.1",
     "ace-builds": "^1.43.4",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",