@ant-design/agentic-ui 2.4.0 → 2.5.0

package/dist/History/hooks/useHistory.js

@@ -71,7 +71,7 @@ var useHistory = (props) => {
   useEffect(() => {
     props.sessionId && setSelectedIds([props.sessionId]);
     loadHistory();
-  }, [props.sessionId]);
+  }, [props.sessionId, props.request, loadHistory]);
   useEffect(() => {
     if (!searchKeyword.trim()) {
       setFilteredList(chatList);

package/dist/History/index.d.ts

@@ -21,6 +21,7 @@ export * from './utils';
  * @param {Function} [props.customDateFormatter] - 日期格式化函数
  * @param {boolean} [props.standalone] - 是否以独立模式显示，为true时直接显示菜单，否则显示为下拉菜单
  * @param {Function} [props.emptyRender] - 空状态渲染函数，当历史记录为空时显示自定义内容
+ * @param {Function} [props.loadMoreRender] - 加载更多渲染函数, 用于自定义加载更多按钮的显示内容
  * @param {boolean} [props.loading] - 加载状态，显示在 GroupMenu 区域
  *
  * @returns {React.ReactElement|null} 返回历史记录组件或null（当没有历史记录时）

package/dist/History/index.js

@@ -42,7 +42,7 @@ export * from "./types";
 export * from "./types/HistoryData";
 export * from "./utils";
 var History = (props) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   const { getPrefixCls } = useContext(ConfigProvider.ConfigContext);
   const menuPrefixCls = getPrefixCls("agentic-chat-history-menu");
   const { locale } = useContext(BubbleConfigContext) || {};
@@ -91,6 +91,27 @@ var History = (props) => {
     type: props.type,
     runningId: (_a = props.agent) == null ? void 0 : _a.runningId
   });
+  const EmptyComponent = () => searchKeyword ? /* @__PURE__ */ React.createElement(HistoryEmpty, null) : props.emptyRender ? props.emptyRender() : /* @__PURE__ */ React.createElement(React.Fragment, null);
+  const LoadMoreComponent = () => {
+    var _a2, _b2;
+    if (props.loadMoreRender) {
+      return props.loadMoreRender();
+    }
+    const shouldRender = ((_a2 = props.agent) == null ? void 0 : _a2.enabled) && !!((_b2 = props.agent) == null ? void 0 : _b2.onLoadMore) && !props.loading;
+    if (!shouldRender) {
+      return null;
+    }
+    return /* @__PURE__ */ React.createElement(
+      HistoryLoadMore,
+      {
+        onLoadMore: handleLoadMore,
+        type: props.type,
+        className: classNames(`${menuPrefixCls}-load-more`, hashId, {
+          chat: props.type !== "task"
+        })
+      }
+    );
+  };
   if (props.standalone) {
     return wrapSSR(
       /* @__PURE__ */ React.createElement(
@@ -123,7 +144,7 @@ var History = (props) => {
             }
           },
           (_h = (_g = props.slots) == null ? void 0 : _g.beforeHistoryList) == null ? void 0 : _h.call(_g, filteredList),
-          (items == null ? void 0 : items.length) === 0 && !props.loading ? props.emptyRender ? props.emptyRender() : /* @__PURE__ */ React.createElement(HistoryEmpty, null) : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
+          (items == null ? void 0 : items.length) === 0 && !props.loading ? /* @__PURE__ */ React.createElement(EmptyComponent, null) : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(
             GroupMenu,
             {
               selectedKeys: [props.sessionId],
@@ -132,16 +153,7 @@ var History = (props) => {
               className: menuPrefixCls,
               loading: props.loading
             }
-          ), ((_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: classNames(`${menuPrefixCls}-load-more`, hashId, {
-                chat: props.type !== "task"
-              })
-            }
-          ))
+          ), /* @__PURE__ */ React.createElement(LoadMoreComponent, null))
         )
       )
     );
@@ -161,7 +173,7 @@ var History = (props) => {
         border: "1px solid var(--color-gray-border-light)"
       },
       getPopupContainer: (p) => p.parentElement || document.body,
-      content: /* @__PURE__ */ React.createElement(React.Fragment, null, (items == null ? void 0 : items.length) === 0 && !(props == null ? void 0 : props.loading) ? /* @__PURE__ */ React.createElement("div", { "data-testid": "empty-state-popover" }, props.emptyRender ? props.emptyRender() : /* @__PURE__ */ React.createElement(HistoryEmpty, null)) : /* @__PURE__ */ React.createElement(
+      content: /* @__PURE__ */ React.createElement(React.Fragment, null, (items == null ? void 0 : items.length) === 0 && !(props == null ? void 0 : props.loading) ? /* @__PURE__ */ React.createElement("div", { "data-testid": "empty-state-popover" }, /* @__PURE__ */ React.createElement(EmptyComponent, null)) : /* @__PURE__ */ React.createElement(
         GroupMenu,
         {
           selectedKeys: [props.sessionId],
@@ -170,16 +182,7 @@ var History = (props) => {
           className: menuPrefixCls,
           loading: props.loading
         }
-      ), ((_k = props.agent) == null ? void 0 : _k.enabled) && !!((_l = props.agent) == null ? void 0 : _l.onLoadMore) && !props.loading && /* @__PURE__ */ React.createElement(
-        HistoryLoadMore,
-        {
-          onLoadMore: handleLoadMore,
-          type: props.type,
-          className: classNames(`${menuPrefixCls}-load-more`, hashId, {
-            chat: props.type !== "task"
-          })
-        }
-      ))
+      ), /* @__PURE__ */ React.createElement(LoadMoreComponent, null))
     },
     /* @__PURE__ */ React.createElement(
       "div",

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

@@ -68,6 +68,8 @@ export interface HistoryProps {
     loading?: boolean;
     /** 加载状态，显示在 GroupMenu 区域 */
     isLoading?: boolean;
+    /** 加载更多渲染函数, 用于自定义加载更多按钮的显示内容 */
+    loadMoreRender?: () => React.ReactNode;
 }
 export interface HistoryActionsBoxProps {
     /** 子组件，通常是时间显示或其他内容 */

package/dist/Hooks/useLanguage.d.ts

@@ -242,6 +242,7 @@ export declare function useLanguage(): {
         'workspace.file.download': string;
         'workspace.file.share': string;
         'workspace.file.preview': string;
+        'workspace.file.location': string;
         'workspace.file.linkCopied': string;
         'workspace.file.copyFailed': string;
         'markdownInput.fileSizeExceeded': string;

package/dist/I18n/locales.d.ts

@@ -206,6 +206,7 @@ export declare const cnLabels: {
     'workspace.file.download': string;
     'workspace.file.share': string;
     'workspace.file.preview': string;
+    'workspace.file.location': string;
     'workspace.file.linkCopied': string;
     'workspace.file.copyFailed': string;
     'markdownInput.fileSizeExceeded': string;

package/dist/I18n/locales.js

@@ -204,6 +204,7 @@ var cnLabels = {
   "workspace.file.download": "下载",
   "workspace.file.share": "分享",
   "workspace.file.preview": "预览",
+  "workspace.file.location": "定位",
   "workspace.file.linkCopied": "已复制链接",
   "workspace.file.copyFailed": "复制失败",
   // MarkdownInputField 组件相关
@@ -557,6 +558,7 @@ var enLabels = {
   "workspace.file.download": "Download",
   "workspace.file.share": "Share",
   "workspace.file.preview": "Preview",
+  "workspace.file.location": "Location",
   "workspace.file.linkCopied": "Link copied",
   "workspace.file.copyFailed": "Copy failed",
   // MarkdownInputField component related

package/dist/MarkdownEditor/BaseMarkdownEditor.js

@@ -171,8 +171,12 @@ var BaseMarkdownEditor = (props) => {
     };
   }, []);
   const store = useMemo(
-    () => new EditorStore(markdownEditorRef, props.plugins),
-    [props.plugins]
+    () => new EditorStore(
+      markdownEditorRef,
+      props.plugins,
+      props.markdownToHtmlOptions
+    ),
+    [props.plugins, props.markdownToHtmlOptions]
   );
   const initSchemaValue = useMemo(() => {
     var _a2;

package/dist/MarkdownEditor/editor/store.d.ts

@@ -8,6 +8,7 @@ import { FootnoteDefinitionNode } from '../el';
 import type { MarkdownEditorPlugin } from '../plugin';
 import { CommentDataType, MarkdownEditorProps } from '../types';
 import { KeyboardTask, Methods } from './utils';
+import type { MarkdownToHtmlOptions } from './utils/markdownToHtml';
 /**
  * 编辑器上下文接口
  *
@@ -88,13 +89,14 @@ export declare class EditorStore {
     _editor: React.MutableRefObject<BaseEditor & ReactEditor & HistoryEditor>;
     /** 当前 setMDContent 操作的 AbortController */
     private _currentAbortController;
+    private markdownToHtmlOptions?;
     /**
      * 获取当前编辑器实例。
      *
      * @returns 当前的 Slate 编辑器实例。
      */
     get editor(): BaseEditor & ReactEditor & HistoryEditor;
-    constructor(_editor: React.MutableRefObject<BaseEditor & ReactEditor & HistoryEditor>, plugins?: MarkdownEditorPlugin[]);
+    constructor(_editor: React.MutableRefObject<BaseEditor & ReactEditor & HistoryEditor>, plugins?: MarkdownEditorPlugin[], markdownToHtmlOptions?: MarkdownToHtmlOptions);
     /**
      * 聚焦到编辑器
      */
@@ -240,7 +242,7 @@ export declare class EditorStore {
      *
      * @returns 转换为 HTML 的当前编辑器内容
      */
-    getHtmlContent(): string;
+    getHtmlContent(options?: MarkdownToHtmlOptions): string;
     /**
      * 使用节点列表设置编辑器内容
      *

package/dist/MarkdownEditor/editor/store.js

@@ -52,7 +52,7 @@ var useEditorStore = () => {
 };
 var SUPPORT_TYPING_TAG = ["table-cell", "paragraph", "head"];
 var EditorStore = class {
-  constructor(_editor, plugins) {
+  constructor(_editor, plugins, markdownToHtmlOptions) {
     /** 高亮缓存映射表 */
     this.highlightCache = /* @__PURE__ */ new Map();
     /** 允许进入的元素类型集合 */
@@ -83,6 +83,7 @@ var EditorStore = class {
     this.dragStart = this.dragStart.bind(this);
     this._editor = _editor;
     this.plugins = plugins;
+    this.markdownToHtmlOptions = markdownToHtmlOptions;
   }
   /**
    * 获取当前编辑器实例。
@@ -629,9 +630,13 @@ var EditorStore = class {
    *
    * @returns 转换为 HTML 的当前编辑器内容
    */
-  getHtmlContent() {
+  getHtmlContent(options) {
     const markdown = this.getMDContent();
-    return markdownToHtmlSync(markdown);
+    const appliedOptions = options != null ? options : this.markdownToHtmlOptions;
+    if (options) {
+      this.markdownToHtmlOptions = options;
+    }
+    return markdownToHtmlSync(markdown, appliedOptions);
   }
   /**
    * 使用节点列表设置编辑器内容

package/dist/MarkdownEditor/editor/utils/markdownToHtml.d.ts

@@ -1,3 +1,7 @@
+import type { Plugin } from 'unified';
+export type MarkdownRemarkPlugin = Plugin | [Plugin, ...unknown[]];
+export type MarkdownToHtmlOptions = MarkdownRemarkPlugin[];
+export declare const DEFAULT_MARKDOWN_REMARK_PLUGINS: readonly MarkdownRemarkPlugin[];
 /**
  * 将 Markdown 内容转换为 HTML（异步版本）
  *
@@ -19,7 +23,7 @@
  *
  * @throws {Error} 当转换过程中发生错误时返回空字符串
  */
-export declare const markdownToHtml: (markdown: string) => Promise<string>;
+export declare const markdownToHtml: (markdown: string, plugins?: MarkdownToHtmlOptions) => Promise<string>;
 /**
  * 将 Markdown 内容转换为 HTML（同步版本）
  *
@@ -41,4 +45,4 @@ export declare const markdownToHtml: (markdown: string) => Promise<string>;
  * - 建议在可能的情况下使用异步版本 `markdownToHtml`
  * - 同步版本可能影响用户界面响应性
  */
-export declare const markdownToHtmlSync: (markdown: string) => string;
+export declare const markdownToHtmlSync: (markdown: string, plugins?: MarkdownToHtmlOptions) => string;

package/dist/MarkdownEditor/editor/utils/markdownToHtml.js

@@ -30,25 +30,57 @@ import remarkParse from "remark-parse";
 import remarkRehype from "remark-rehype";
 import { unified } from "unified";
 import { fixStrongWithSpecialChars } from "../parser/remarkParse";
-var markdownToHtml = (markdown) => __async(void 0, null, function* () {
+var INLINE_MATH_WITH_SINGLE_DOLLAR = { singleDollarTextMath: true };
+var FRONTMATTER_LANGUAGES = ["yaml"];
+var remarkRehypePlugin = remarkRehype;
+var DEFAULT_MARKDOWN_REMARK_PLUGINS = [
+  remarkParse,
+  remarkGfm,
+  fixStrongWithSpecialChars,
+  [remarkMath, INLINE_MATH_WITH_SINGLE_DOLLAR],
+  [remarkFrontmatter, FRONTMATTER_LANGUAGES],
+  [remarkRehypePlugin, { allowDangerousHtml: true }]
+];
+var DEFAULT_REMARK_PLUGINS = [
+  ...DEFAULT_MARKDOWN_REMARK_PLUGINS
+];
+var applyPlugins = (processor, plugins) => {
+  const extendedProcessor = processor;
+  plugins.forEach((entry) => {
+    if (Array.isArray(entry)) {
+      const [plugin, ...pluginOptions] = entry;
+      extendedProcessor.use(plugin, ...pluginOptions);
+      return;
+    }
+    extendedProcessor.use(entry);
+  });
+  return processor;
+};
+var resolveRemarkPlugins = (plugins) => {
+  if (!plugins || plugins.length === 0) {
+    return DEFAULT_REMARK_PLUGINS;
+  }
+  return plugins;
+};
+var createMarkdownProcessor = (plugins) => {
+  const processor = unified();
+  const remarkPlugins = resolveRemarkPlugins(plugins);
+  applyPlugins(processor, remarkPlugins);
+  processor.use(rehypeRaw).use(rehypeKatex).use(rehypeStringify);
+  return processor;
+};
+var markdownToHtml = (markdown, plugins) => __async(void 0, null, function* () {
   try {
-    const htmlContent = yield unified().use(remarkParse).use(remarkGfm).use(fixStrongWithSpecialChars).use(remarkMath, {
-      singleDollarTextMath: true
-      // 允许单美元符号渲染内联数学公式
-    }).use(remarkFrontmatter, ["yaml"]).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeRaw).use(rehypeKatex).use(rehypeStringify).process(markdown);
+    const htmlContent = yield createMarkdownProcessor(plugins).process(markdown);
     return String(htmlContent);
   } catch (error) {
     console.error("Error converting markdown to HTML:", error);
     return "";
   }
 });
-var markdownToHtmlSync = (markdown) => {
+var markdownToHtmlSync = (markdown, plugins) => {
   try {
-    const processor = unified().use(remarkParse).use(remarkGfm).use(fixStrongWithSpecialChars).use(remarkMath, {
-      singleDollarTextMath: true
-      // 允许单美元符号渲染内联数学公式
-    }).use(remarkFrontmatter, ["yaml"]).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeRaw).use(rehypeKatex).use(rehypeStringify);
-    const file = processor.processSync(markdown);
+    const file = createMarkdownProcessor(plugins).processSync(markdown);
     return String(file);
   } catch (error) {
     console.error("Error converting markdown to HTML:", error);
@@ -56,6 +88,7 @@ var markdownToHtmlSync = (markdown) => {
   }
 };
 export {
+  DEFAULT_MARKDOWN_REMARK_PLUGINS,
   markdownToHtml,
   markdownToHtmlSync
 };

package/dist/MarkdownEditor/types.d.ts

@@ -4,6 +4,7 @@ import React from 'react';
 import { BaseEditor, Selection } from 'slate';
 import { HistoryEditor } from 'slate-history';
 import { ReactEditor, RenderElementProps } from 'slate-react';
+import type { MarkdownToHtmlOptions } from './editor/utils/markdownToHtml';
 import { TagPopupProps } from './editor/elements/TagPopup';
 import { EditorStore } from './editor/store';
 import { InsertAutocompleteProps } from './editor/tools/InsertAutocomplete';
@@ -292,6 +293,10 @@ export type MarkdownEditorProps = {
     onFocus?: (value: string, schema: Elements[], e: React.FocusEvent<HTMLDivElement, Element>) => void;
     onBlur?: (value: string, schema: Elements[], e: React.MouseEvent<HTMLDivElement, Element>) => void;
     onPaste?: (e: React.ClipboardEvent<HTMLDivElement>) => void;
+    /**
+     * 自定义 markdown 转 HTML 的 remark 插件配置，格式类似 Babel 插件数组
+     */
+    markdownToHtmlOptions?: MarkdownToHtmlOptions;
     /**
      * 其他属性
      */

package/dist/MarkdownInputField/AttachmentButton/index.js

@@ -55,16 +55,17 @@ var prepareFile = (file) => {
 var getLocaleMessage = (locale, key, defaultMsg) => {
   return (locale == null ? void 0 : locale[key]) || defaultMsg;
 };
-var validateFileCount = (fileCount, props) => {
+var validateFileCount = (newFileCount, existingFileCount, props) => {
   var _a, _b;
-  if (props.maxFileCount && fileCount > props.maxFileCount) {
+  const totalFileCount = newFileCount + existingFileCount;
+  if (props.maxFileCount && totalFileCount > props.maxFileCount) {
     const msg = ((_a = props.locale) == null ? void 0 : _a["markdownInput.maxFileCountExceeded"]) ? compileTemplate(props.locale["markdownInput.maxFileCountExceeded"], {
       maxFileCount: String(props.maxFileCount)
     }) : DEFAULT_MESSAGES.maxFileCountExceeded(props.maxFileCount);
     message.error(msg);
     return false;
   }
-  if (props.minFileCount && fileCount < props.minFileCount) {
+  if (props.minFileCount && totalFileCount < props.minFileCount) {
     const msg = ((_b = props.locale) == null ? void 0 : _b["markdownInput.minFileCountRequired"]) ? compileTemplate(props.locale["markdownInput.minFileCountRequired"], {
       minFileCount: String(props.minFileCount)
     }) : DEFAULT_MESSAGES.minFileCountRequired(props.minFileCount);
@@ -158,13 +159,14 @@ var processFile = (file, index, map, props) => __async(void 0, null, function* (
 });
 var upLoadFileToServer = (files, props) => __async(void 0, null, function* () {
   const map = props.fileMap || /* @__PURE__ */ new Map();
+  const existingFileCount = map.size;
   const hideLoading = message.loading(
     getLocaleMessage(props.locale, "uploading", DEFAULT_MESSAGES.uploading)
   );
   const fileList = Array.from(files);
   fileList.forEach(prepareFile);
   fileList.forEach((file) => updateFileMap(map, file, props.onFileMapChange));
-  if (!validateFileCount(fileList.length, props)) {
+  if (!validateFileCount(fileList.length, existingFileCount, props)) {
     hideLoading();
     return;
   }

package/dist/MarkdownInputField/FileUploadManager/index.js

@@ -72,6 +72,15 @@ var useFileUploadManager = ({
     if (isUploading) {
       return;
     }
+    const currentFileCount = (fileMap == null ? void 0 : fileMap.size) || 0;
+    if ((attachment == null ? void 0 : attachment.maxFileCount) && currentFileCount >= attachment.maxFileCount) {
+      const errorMsg = (locale == null ? void 0 : locale["markdownInput.maxFileCountExceeded"]) ? locale["markdownInput.maxFileCountExceeded"].replace(
+        "${maxFileCount}",
+        String(attachment.maxFileCount)
+      ) : `最多只能上传 ${attachment.maxFileCount} 个文件`;
+      message.error(errorMsg);
+      return;
+    }
     const input = document.createElement("input");
     input.id = "uploadImage_" + Math.random();
     input.type = "file";

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/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>;