@ai-group/chat-sdk 3.7.0 → 3.7.1-alpha10

package/dist/cjs/types/XAdkSender.d.ts

@@ -1,4 +1,97 @@
 import React from "react";
+/** 快捷键触发的列表项 */
+export interface QuickListOption {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    /** 分组名（用于聚合列表，子分组通过下划线分割） */
+    group?: string;
+    [key: string]: any;
+}
+/** 快捷键配置 */
+export interface QuickKeyConfig {
+    /** 触发字符，如 '@', '#', '$' */
+    key: string;
+    /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */
+    mentionType?: string;
+    /** @deprecated 请使用 mentionType。 */
+    tagType?: string;
+    /** 列表标题 */
+    title?: string;
+    /** 列表数据 */
+    options: QuickListOption[];
+    /** 自定义列表项渲染 */
+    renderItem?: (option: QuickListOption) => React.ReactNode;
+    /** 选中回调 */
+    onSelect?: (option: QuickListOption) => void;
+}
+/** 输入框内的资源引用。SDK 只理解通用 Mention，业务语义可放入 data 或可选语义字段。 */
+export interface MentionTag {
+    id: string;
+    label: string;
+    /** Mention 类型，如 'knowledge', 'skill', 'plugin', 'agent' */
+    type: string;
+    /** 资源 URI，如 skill://skillNo、kb://kb/knNo/dir/docs/2024 */
+    uri?: string;
+    /** 业务资源 ID，如 skillNo、knowledgeNo */
+    targetId?: string;
+    /** 展示名；不传时回退 label */
+    displayName?: string;
+    /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 uri/targetId/label */
+    value?: string;
+    /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */
+    trigger?: string;
+    color?: string;
+    icon?: React.ReactNode;
+    /** 业务扩展上下文，例如知识库目录 scope */
+    scope?: any;
+    /** 原始数据 */
+    data?: any;
+}
+/** @deprecated 请使用 MentionTag。 */
+export type InputTag = MentionTag;
+export interface InlineTagRenderInfo {
+    onRemove: () => void;
+}
+export type XAdkSenderSubmitFormat = "text" | "structured" | "markdown" | "xml";
+export type XAdkSenderSubmitPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "mention";
+    mention: MentionTag;
+};
+/** @deprecated 旧 tag part，仅用于兼容 defaultInputParts 历史传入。 */
+export type XAdkSenderLegacyTagPart = {
+    type: "tag";
+    tag: MentionTag;
+};
+/** 输入框文本/Mention 有序片段，表示用户正在编辑的输入内容 */
+export type XAdkSenderInputPart = XAdkSenderSubmitPart | XAdkSenderLegacyTagPart;
+export interface XAdkSenderFormatMentionContext {
+    format: Exclude<XAdkSenderSubmitFormat, "structured">;
+    index: number;
+}
+/** @deprecated 请使用 XAdkSenderFormatMentionContext。 */
+export type XAdkSenderFormatTagContext = XAdkSenderFormatMentionContext;
+export interface XAdkSenderSubmitData<TPayload = unknown> {
+    /** 根据 submitFormat 生成的最终内容，默认是纯文本 */
+    text: string;
+    /** 去掉标签后的用户原始输入文本 */
+    rawText: string;
+    /** 当前提交格式 */
+    format: XAdkSenderSubmitFormat;
+    /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */
+    parts: XAdkSenderSubmitPart[];
+    files: ServerFile[];
+    /** 当前 Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
+    /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */
+    payload?: TPayload;
+}
 export interface UploadFileResult {
     fileName?: string;
     fileId?: string | number;
@@ -53,7 +146,6 @@ export type FileValidator = (file: File, context: {
 }) => string | null;
 export interface ActionsComponents {
     SendButton: React.ComponentType<any>;
-    UploadButton: React.ComponentType<any>;
     ClearButton: React.ComponentType<any>;
 }
 export type SlotRenderFunction = (oriNode: React.ReactNode, info: {
@@ -71,21 +163,27 @@ export interface UploaderCoreProps {
 }
 export interface SenderUIProps {
     clearBtnShow?: boolean;
-    allowUpload?: boolean;
-    /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */
+    /**
+     * 是否启用 Sender 自身的拖拽上传。
+     * 拖拽产生的文件通过 onFileSelect 回调交给业务/外层处理；
+     * 默认 false，由外层（如 DefaultLayout）管理拖拽时无需开启。
+     */
     draggable?: boolean;
+    /**
+     * 拖拽文件回调：当 draggable 为 true 且用户向输入区拖拽文件时触发。
+     * 业务/外层在此回调中决定如何处理文件（通常调用 senderRef.addFiles 注入）。
+     */
+    onFileSelect?: (files: File[]) => void;
     loading?: boolean;
     disabled?: boolean;
+    placeholder?: string;
     /** 受控：输入框的值 */
     value?: string;
     /** 非受控：输入框默认值 */
     defaultValue?: string;
     onClear?: () => void;
     onChange?: (value: string) => void;
-    onSubmit?: (data: {
-        text: string;
-        files: ServerFile[];
-    }) => void;
+    onSubmit?: (data: XAdkSenderSubmitData) => void;
     onStop?: () => void;
     /** 自定义发送按钮渲染 */
     sendButtonRender?: (info: {
@@ -98,15 +196,63 @@ export interface SenderUIProps {
     }) => React.ReactNode;
     /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */
     suffix?: React.ReactNode | false | SlotRenderFunction;
-    /** 头部面板 */
+    /** 输入主体内部的头部内容 */
     header?: React.ReactNode | false | SlotRenderFunction;
     /** 前缀内容 */
     prefix?: React.ReactNode | false | SlotRenderFunction;
     /** 底部内容 */
     footer?: React.ReactNode | false | SlotRenderFunction;
+    /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */
+    footerLeft?: React.ReactNode | false | SlotRenderFunction;
+    /** 快捷键配置列表 */
+    quickKeys?: QuickKeyConfig[];
+    /** 是否把 Mention 以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */
+    inlineTags?: boolean;
+    /** 自定义内联 Mention 渲染 */
+    renderMention?: (mention: MentionTag, info: InlineTagRenderInfo) => React.ReactNode;
+    /** @deprecated 请使用 renderMention。 */
+    renderTag?: (mention: MentionTag, info: InlineTagRenderInfo) => React.ReactNode;
+    /** 受控：Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
+    /** 非受控：默认 Mention 列表 */
+    defaultMentions?: MentionTag[];
+    /** @deprecated 请使用 defaultMentions。 */
+    defaultTags?: MentionTag[];
+    /** 非受控：默认输入内容片段，用于初始化内联 Mention 输入区 */
+    defaultInputParts?: XAdkSenderInputPart[];
+    /** Mention 变化回调 */
+    onMentionsChange?: (mentions: MentionTag[]) => void;
+    /** @deprecated 请使用 onMentionsChange。 */
+    onTagsChange?: (mentions: MentionTag[]) => void;
+    /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */
+    onQuickKeyTrigger?: (key: string, keyword: string) => void;
+    /**
+     * 提交内容格式：
+     * - text: 默认，输出文字 + Mention 文本（如 @生图技能）
+     * - structured: 保留 parts/mentions/files 结构化数据，text 为 rawText
+     * - markdown/xml: 输出对应标记文本
+     */
+    submitFormat?: XAdkSenderSubmitFormat;
+    /** 自定义 Mention 在 text/markdown/xml 格式中的序列化结果 */
+    formatMention?: (mention: MentionTag, context: XAdkSenderFormatMentionContext) => string;
+    /** @deprecated 请使用 formatMention。 */
+    formatTag?: (mention: MentionTag, context: XAdkSenderFormatMentionContext) => string;
+    /**
+     * 基于 SDK 标准提交结构派生业务 payload。
+     * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。
+     */
+    transformSubmitData?: (data: Omit<XAdkSenderSubmitData, "payload">) => unknown;
 }
 export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
 export interface XAdkSenderHandle {
     addFiles: (files: File[]) => void;
+    /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */
+    insertMention: (mention: MentionTag) => void;
+    /** @deprecated 请使用 insertMention。 */
+    insertTag: (mention: MentionTag) => void;
+    /** 聚焦输入区 */
+    focus: () => void;
 }
 export {};

package/dist/cjs/types/XAdkSender.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAdkSender.ts"],
-  "sourcesContent": ["// types/XAdkSender.ts\nimport React from \"react\";\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  UploadButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  allowUpload?: boolean;\n  /** 是否启用 Sender 自身的拖拽上传，设为 false 时由外层（如 DefaultLayout）管理拖拽 */\n  draggable?: boolean;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: { text: string; files: ServerFile[] }) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 头部面板 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n}\n"],
+  "sourcesContent": ["// types/XAdkSender.ts\nimport React from \"react\";\n\n// ===================== 快捷键/Mention 相关类型 =====================\n\n/** 快捷键触发的列表项 */\nexport interface QuickListOption {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: React.ReactNode;\n  /** 分组名（用于聚合列表，子分组通过下划线分割） */\n  group?: string;\n  [key: string]: any;\n}\n\n/** 快捷键配置 */\nexport interface QuickKeyConfig {\n  /** 触发字符，如 '@', '#', '$' */\n  key: string;\n  /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */\n  mentionType?: string;\n  /** @deprecated 请使用 mentionType。 */\n  tagType?: string;\n  /** 列表标题 */\n  title?: string;\n  /** 列表数据 */\n  options: QuickListOption[];\n  /** 自定义列表项渲染 */\n  renderItem?: (option: QuickListOption) => React.ReactNode;\n  /** 选中回调 */\n  onSelect?: (option: QuickListOption) => void;\n}\n\n/** 输入框内的资源引用。SDK 只理解通用 Mention，业务语义可放入 data 或可选语义字段。 */\nexport interface MentionTag {\n  id: string;\n  label: string;\n  /** Mention 类型，如 'knowledge', 'skill', 'plugin', 'agent' */\n  type: string;\n  /** 资源 URI，如 skill://skillNo、kb://kb/knNo/dir/docs/2024 */\n  uri?: string;\n  /** 业务资源 ID，如 skillNo、knowledgeNo */\n  targetId?: string;\n  /** 展示名；不传时回退 label */\n  displayName?: string;\n  /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 uri/targetId/label */\n  value?: string;\n  /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */\n  trigger?: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 业务扩展上下文，例如知识库目录 scope */\n  scope?: any;\n  /** 原始数据 */\n  data?: any;\n}\n\n/** @deprecated 请使用 MentionTag。 */\nexport type InputTag = MentionTag;\n\nexport interface InlineTagRenderInfo {\n  onRemove: () => void;\n}\n\nexport type XAdkSenderSubmitFormat = \"text\" | \"structured\" | \"markdown\" | \"xml\";\n\nexport type XAdkSenderSubmitPart =\n  | { type: \"text\"; text: string }\n  | { type: \"mention\"; mention: MentionTag };\n\n/** @deprecated 旧 tag part，仅用于兼容 defaultInputParts 历史传入。 */\nexport type XAdkSenderLegacyTagPart = { type: \"tag\"; tag: MentionTag };\n\n/** 输入框文本/Mention 有序片段，表示用户正在编辑的输入内容 */\nexport type XAdkSenderInputPart =\n  | XAdkSenderSubmitPart\n  | XAdkSenderLegacyTagPart;\n\nexport interface XAdkSenderFormatMentionContext {\n  format: Exclude<XAdkSenderSubmitFormat, \"structured\">;\n  index: number;\n}\n\n/** @deprecated 请使用 XAdkSenderFormatMentionContext。 */\nexport type XAdkSenderFormatTagContext = XAdkSenderFormatMentionContext;\n\nexport interface XAdkSenderSubmitData<TPayload = unknown> {\n  /** 根据 submitFormat 生成的最终内容，默认是纯文本 */\n  text: string;\n  /** 去掉标签后的用户原始输入文本 */\n  rawText: string;\n  /** 当前提交格式 */\n  format: XAdkSenderSubmitFormat;\n  /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */\n  parts: XAdkSenderSubmitPart[];\n  files: ServerFile[];\n  /** 当前 Mention 列表 */\n  mentions?: MentionTag[];\n  /** @deprecated 请使用 mentions。 */\n  tags?: MentionTag[];\n  /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */\n  payload?: TPayload;\n}\n\n// ===================== 上传相关类型 =====================\n\nexport interface UploadFileResult {\n  fileName?: string;\n  fileId?: string | number;\n  tempUrl?: string;\n  url?: string;\n  fileUrl?: string;\n  fileType?: string;\n  fileSize?: number;\n  mimeType?: string;\n  [key: string]: any;\n}\n\nexport interface UploadSuccessResponse {\n  data?: UploadFileResult | UploadFileResult[];\n  [key: string]: any;\n}\n\ninterface uploadRequestProps {\n  (options: {\n    file: File;\n    onProgress?: (e: { percent: number }) => void;\n    onSuccess?: (\n      response: UploadFileResult | UploadFileResult[] | UploadSuccessResponse,\n    ) => void;\n    onError?: (error: Error) => void;\n  }): Promise<void> | void;\n}\n\nexport type UploadRequestFn = uploadRequestProps;\n\nexport interface ServerFile {\n  fileName: string;\n  fileId: string | number;\n  tempUrl: string;\n  type: string;\n  size?: number;\n  mimeType: string;\n  raw?: UploadFileResult;\n}\n\nexport interface LocalFile {\n  id: string;\n  uid: string;\n  name: string;\n  file: File;\n  size: number;\n  type: string;\n  progress: number;\n  status: \"pending\" | \"uploading\" | \"success\" | \"error\";\n  // 服务器返回字段\n  fileId?: string | number;\n  tempUrl?: string;\n  response?: any;\n  errorMessage?: string; // 上传错误信息\n}\n\nexport type FileValidator = (\n  file: File,\n  context: { files: LocalFile[] },\n) => string | null;\n\nexport interface ActionsComponents {\n  SendButton: React.ComponentType<any>;\n  ClearButton: React.ComponentType<any>;\n}\n\nexport type SlotRenderFunction = (\n  oriNode: React.ReactNode,\n  info: { components: ActionsComponents },\n) => React.ReactNode | false;\n\n// 上传相关\nexport interface UploaderCoreProps {\n  uploadRequest?: uploadRequestProps;\n\n  maxFileSize?: number;\n  allowedFileTypes?: string[];\n  maxFiles?: number;\n\n  validators?: FileValidator[];\n\n  // 数据层回调\n  onFilesChange?: (files: LocalFile[]) => void;\n  onUploadSuccess?: (file: LocalFile) => void;\n  onUploadError?: (file: LocalFile, error: Error) => void;\n}\n\n// UI 相关\nexport interface SenderUIProps {\n  clearBtnShow?: boolean;\n  /**\n   * 是否启用 Sender 自身的拖拽上传。\n   * 拖拽产生的文件通过 onFileSelect 回调交给业务/外层处理；\n   * 默认 false，由外层（如 DefaultLayout）管理拖拽时无需开启。\n   */\n  draggable?: boolean;\n  /**\n   * 拖拽文件回调：当 draggable 为 true 且用户向输入区拖拽文件时触发。\n   * 业务/外层在此回调中决定如何处理文件（通常调用 senderRef.addFiles 注入）。\n   */\n  onFileSelect?: (files: File[]) => void;\n  loading?: boolean;\n  disabled?: boolean; // 只读状态\n  placeholder?: string;\n  /** 受控：输入框的值 */\n  value?: string;\n  /** 非受控：输入框默认值 */\n  defaultValue?: string;\n  onClear?: () => void;\n  onChange?: (value: string) => void;\n  onSubmit?: (data: XAdkSenderSubmitData) => void;\n  onStop?: () => void;\n\n  /** 自定义发送按钮渲染 */\n  sendButtonRender?: (info: {\n    loading: boolean;\n    disabled: boolean;\n    /** 当前是否可以发送（文本非空或有已上传的文件） */\n    canSend: boolean;\n    onSend: () => void;\n    onStop?: () => void;\n  }) => React.ReactNode;\n\n  // UI插槽功能\n  /** 后缀内容,默认展示操作按钮,设为 false 时不显示 */\n  suffix?: React.ReactNode | false | SlotRenderFunction;\n  /** 输入主体内部的头部内容 */\n  header?: React.ReactNode | false | SlotRenderFunction;\n  /** 前缀内容 */\n  prefix?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部内容 */\n  footer?: React.ReactNode | false | SlotRenderFunction;\n  /** 底部左侧拓展区域，不传时 footer 保持原有居中布局 */\n  footerLeft?: React.ReactNode | false | SlotRenderFunction;\n\n  // 快捷键/Mention 功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把 Mention 以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联 Mention 渲染 */\n  renderMention?: (\n    mention: MentionTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** @deprecated 请使用 renderMention。 */\n  renderTag?: (\n    mention: MentionTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：Mention 列表 */\n  mentions?: MentionTag[];\n  /** @deprecated 请使用 mentions。 */\n  tags?: MentionTag[];\n  /** 非受控：默认 Mention 列表 */\n  defaultMentions?: MentionTag[];\n  /** @deprecated 请使用 defaultMentions。 */\n  defaultTags?: MentionTag[];\n  /** 非受控：默认输入内容片段，用于初始化内联 Mention 输入区 */\n  defaultInputParts?: XAdkSenderInputPart[];\n  /** Mention 变化回调 */\n  onMentionsChange?: (mentions: MentionTag[]) => void;\n  /** @deprecated 请使用 onMentionsChange。 */\n  onTagsChange?: (mentions: MentionTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n  /**\n   * 提交内容格式：\n   * - text: 默认，输出文字 + Mention 文本（如 @生图技能）\n   * - structured: 保留 parts/mentions/files 结构化数据，text 为 rawText\n   * - markdown/xml: 输出对应标记文本\n   */\n  submitFormat?: XAdkSenderSubmitFormat;\n  /** 自定义 Mention 在 text/markdown/xml 格式中的序列化结果 */\n  formatMention?: (\n    mention: MentionTag,\n    context: XAdkSenderFormatMentionContext,\n  ) => string;\n  /** @deprecated 请使用 formatMention。 */\n  formatTag?: (\n    mention: MentionTag,\n    context: XAdkSenderFormatMentionContext,\n  ) => string;\n  /**\n   * 基于 SDK 标准提交结构派生业务 payload。\n   * SDK 不理解 knowledge/skill/agent 等业务字段，只负责把 payload 原样放入 onSubmit 数据中。\n   */\n  transformSubmitData?: (\n    data: Omit<XAdkSenderSubmitData, \"payload\">,\n  ) => unknown;\n}\n\nexport type XAdkSenderProps = SenderUIProps & UploaderCoreProps;\n\nexport interface XAdkSenderHandle {\n  addFiles: (files: File[]) => void;\n  /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */\n  insertMention: (mention: MentionTag) => void;\n  /** @deprecated 请使用 insertMention。 */\n  insertTag: (mention: MentionTag) => void;\n  /** 聚焦输入区 */\n  focus: () => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -11,3 +11,4 @@ export * from "./FileGallery";
 export * from "./common";
 export * from "./FunctionCallRender";
 export * from "./ChatStrategies";
+export * from "./Sources";

package/dist/cjs/types/index.js

@@ -29,6 +29,7 @@ __reExport(types_exports, require("./FileGallery"), module.exports);
 __reExport(types_exports, require("./common"), module.exports);
 __reExport(types_exports, require("./FunctionCallRender"), module.exports);
 __reExport(types_exports, require("./ChatStrategies"), module.exports);
+__reExport(types_exports, require("./Sources"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./XAiChatbot"),
@@ -43,6 +44,7 @@ __reExport(types_exports, require("./ChatStrategies"), module.exports);
   ...require("./FileGallery"),
   ...require("./common"),
   ...require("./FunctionCallRender"),
-  ...require("./ChatStrategies")
+  ...require("./ChatStrategies"),
+  ...require("./Sources")
 });
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/index.ts"],
-  "sourcesContent": ["export * from \"./XAiChatbot\";\nexport * from \"./XAiMessage\";\nexport * from \"./XAiProvider\";\nexport * from \"./XAiSender\";\nexport * from \"./XAiConversations\";\nexport * from \"./XAdkProvider\";\nexport * from \"./XAdkChatbot\";\nexport * from \"./XAdkSender\";\nexport * from \"./XAdkThoughtChain\";\nexport * from \"./FileGallery\";\nexport * from \"./common\";\nexport * from \"./FunctionCallRender\";\nexport * from \"./ChatStrategies\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,yBAAd;AACA,0BAAc,yBADd;AAEA,0BAAc,0BAFd;AAGA,0BAAc,wBAHd;AAIA,0BAAc,+BAJd;AAKA,0BAAc,2BALd;AAMA,0BAAc,0BANd;AAOA,0BAAc,yBAPd;AAQA,0BAAc,+BARd;AASA,0BAAc,0BATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,iCAXd;AAYA,0BAAc,6BAZd;",
+  "sourcesContent": ["export * from \"./XAiChatbot\";\nexport * from \"./XAiMessage\";\nexport * from \"./XAiProvider\";\nexport * from \"./XAiSender\";\nexport * from \"./XAiConversations\";\nexport * from \"./XAdkProvider\";\nexport * from \"./XAdkChatbot\";\nexport * from \"./XAdkSender\";\nexport * from \"./XAdkThoughtChain\";\nexport * from \"./FileGallery\";\nexport * from \"./common\";\nexport * from \"./FunctionCallRender\";\nexport * from \"./ChatStrategies\";\nexport * from \"./Sources\";\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,yBAAd;AACA,0BAAc,yBADd;AAEA,0BAAc,0BAFd;AAGA,0BAAc,wBAHd;AAIA,0BAAc,+BAJd;AAKA,0BAAc,2BALd;AAMA,0BAAc,0BANd;AAOA,0BAAc,yBAPd;AAQA,0BAAc,+BARd;AASA,0BAAc,0BATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,iCAXd;AAYA,0BAAc,6BAZd;AAaA,0BAAc,sBAbd;",
   "names": []
 }

package/dist/cjs/utils/index.d.ts

@@ -2,3 +2,4 @@ export declare const safeJsonParse: <T = any>(str?: string, defaultValue?: any)
 export declare const safeJsonStringify: <T = any>(obj?: T, defaultValue?: any) => string;
 export declare function cleanProcessText(text: string): string;
 export * from './parseAgentMessage';
+export * from './markdownResource';

package/dist/cjs/utils/index.js

@@ -26,6 +26,7 @@ __export(utils_exports, {
 });
 module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./parseAgentMessage"), module.exports);
+__reExport(utils_exports, require("./markdownResource"), module.exports);
 var safeJsonParse = (str, defaultValue = {}) => {
   if (!str)
     return defaultValue;
@@ -54,6 +55,7 @@ function cleanProcessText(text) {
   cleanProcessText,
   safeJsonParse,
   safeJsonStringify,
-  ...require("./parseAgentMessage")
+  ...require("./parseAgentMessage"),
+  ...require("./markdownResource")
 });
 //# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/utils/index.ts"],
-  "sourcesContent": ["export const safeJsonParse = <T = any>(\n  str?: string,\n  defaultValue: any = {},\n): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(\n  obj?: T,\n  defaultValue: any = {},\n): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n\nexport function cleanProcessText(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/\\/\\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\\*\\//g, \"\")\n    .trim();\n}\n\n// 导出新的解析工具\nexport * from './parseAgentMessage';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,0BAAc,gCAhCd;AAAO,IAAM,gBAAgB,CAC3B,KACA,eAAoB,CAAC,MACf;AACN,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,MAAM,GAAG,KAAK;AAAA,EAC5B,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,IAAM,oBAAoB,CAC/B,KACA,eAAoB,CAAC,MACV;AACX,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,UAAU,GAAG,KAAK;AAAA,EAChC,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,CAAC;AAAM,WAAO;AAClB,SAAO,KACJ,QAAQ,gEAAgE,EAAE,EAC1E,KAAK;AACV;",
+  "sourcesContent": ["export const safeJsonParse = <T = any>(\n  str?: string,\n  defaultValue: any = {},\n): T => {\n  if (!str) return defaultValue as T;\n  try {\n    return JSON.parse(str) || defaultValue;\n  } catch (error) {\n    return defaultValue as T;\n  }\n};\n\nexport const safeJsonStringify = <T = any>(\n  obj?: T,\n  defaultValue: any = {},\n): string => {\n  if (!obj) return defaultValue as string;\n  try {\n    return JSON.stringify(obj) || defaultValue;\n  } catch (error) {\n    return defaultValue as string;\n  }\n};\n\nexport function cleanProcessText(text: string): string {\n  if (!text) return \"\";\n  return text\n    .replace(/\\/\\*(PLANNING|REPLANNING|REASONING|ACTION|FINAL_ANSWER)\\*\\//g, \"\")\n    .trim();\n}\n\n// 导出新的解析工具\nexport * from './parseAgentMessage';\nexport * from './markdownResource';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCA,0BAAc,gCAhCd;AAiCA,0BAAc,+BAjCd;AAAO,IAAM,gBAAgB,CAC3B,KACA,eAAoB,CAAC,MACf;AACN,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,MAAM,GAAG,KAAK;AAAA,EAC5B,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,IAAM,oBAAoB,CAC/B,KACA,eAAoB,CAAC,MACV;AACX,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI;AACF,WAAO,KAAK,UAAU,GAAG,KAAK;AAAA,EAChC,SAAS,OAAP;AACA,WAAO;AAAA,EACT;AACF;AAEO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,CAAC;AAAM,WAAO;AAClB,SAAO,KACJ,QAAQ,gEAAgE,EAAE,EAC1E,KAAK;AACV;",
   "names": []
 }

package/dist/cjs/utils/markdownResource.d.ts

@@ -0,0 +1,14 @@
+import type { MarkdownResourceLink, XAdkSenderSubmitPart } from "../types";
+export declare const MARKDOWN_RESOURCE_LINK_SCHEMES: readonly ["skill", "kb"];
+export type MarkdownResourceLinkScheme = (typeof MARKDOWN_RESOURCE_LINK_SCHEMES)[number] | (string & {});
+export interface MarkdownResourceLinkOptions {
+    schemes?: readonly MarkdownResourceLinkScheme[];
+}
+export declare const getMarkdownResourceDisplayLabel: (label: string) => string;
+/** 将包含资源链接的 Markdown 还原成 Sender 可编辑的有序片段。 */
+export declare const parseMarkdownResourceLinksAsParts: (text: string, options?: MarkdownResourceLinkOptions) => XAdkSenderSubmitPart[];
+export declare const parseMarkdownResourceHref: (href: string, label?: string, options?: MarkdownResourceLinkOptions) => MarkdownResourceLink | null;
+export declare const replaceMarkdownResourceLinks: (text: string, replacer: (link: MarkdownResourceLink) => string, options?: MarkdownResourceLinkOptions) => string;
+export declare const formatMarkdownResourceLinksAsText: (text: string, options?: MarkdownResourceLinkOptions & {
+    stripTrigger?: boolean;
+}) => string;

package/dist/cjs/utils/markdownResource.js

@@ -0,0 +1,131 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/markdownResource.ts
+var markdownResource_exports = {};
+__export(markdownResource_exports, {
+  MARKDOWN_RESOURCE_LINK_SCHEMES: () => MARKDOWN_RESOURCE_LINK_SCHEMES,
+  formatMarkdownResourceLinksAsText: () => formatMarkdownResourceLinksAsText,
+  getMarkdownResourceDisplayLabel: () => getMarkdownResourceDisplayLabel,
+  parseMarkdownResourceHref: () => parseMarkdownResourceHref,
+  parseMarkdownResourceLinksAsParts: () => parseMarkdownResourceLinksAsParts,
+  replaceMarkdownResourceLinks: () => replaceMarkdownResourceLinks
+});
+module.exports = __toCommonJS(markdownResource_exports);
+var MARKDOWN_RESOURCE_LINK_SCHEMES = [
+  "skill",
+  "kb"
+  // "plugin",
+  // "tool",
+  // "knowledge",
+  // "agent",
+  // "model",
+];
+var getResourceLinkSchemeSet = (options) => new Set((options == null ? void 0 : options.schemes) || MARKDOWN_RESOURCE_LINK_SCHEMES);
+var RESOURCE_LINK_REGEX = /\[([^\]\n]+)\]\(([a-z][a-z0-9+.-]*:\/{2,3}[^)\s]+)\)/gi;
+var stripTriggerPrefix = (label) => label.replace(/^[@/#$]+/, "");
+var getMarkdownResourceDisplayLabel = (label) => stripTriggerPrefix(label).trim();
+var parseMarkdownResourceLinksAsParts = (text, options) => {
+  var _a;
+  if (!text)
+    return [];
+  const parts = [];
+  let lastIndex = 0;
+  let mentionIndex = 0;
+  const regex = new RegExp(
+    RESOURCE_LINK_REGEX.source,
+    RESOURCE_LINK_REGEX.flags
+  );
+  let match;
+  while ((match = regex.exec(text)) !== null) {
+    const source = match[0];
+    const label = match[1] || "";
+    const href = match[2] || "";
+    const start = match.index ?? 0;
+    const link = parseMarkdownResourceHref(href, label, options);
+    if (!link)
+      continue;
+    if (start > lastIndex) {
+      parts.push({ type: "text", text: text.slice(lastIndex, start) });
+    }
+    const displayName = getMarkdownResourceDisplayLabel(
+      link.label || link.value
+    );
+    const mention = {
+      id: `pasted-${link.type}-${mentionIndex}-${Date.now().toString(36)}`,
+      label: displayName,
+      displayName,
+      type: link.type,
+      uri: link.href,
+      targetId: link.value,
+      value: link.value,
+      trigger: (_a = label.match(/^[@/#$]+/)) == null ? void 0 : _a[0],
+      data: { uri: link.href, value: link.value }
+    };
+    parts.push({ type: "mention", mention });
+    mentionIndex += 1;
+    lastIndex = start + source.length;
+  }
+  if (lastIndex < text.length) {
+    parts.push({ type: "text", text: text.slice(lastIndex) });
+  }
+  return parts.length > 0 ? parts : [{ type: "text", text }];
+};
+var parseMarkdownResourceHref = (href, label = "", options) => {
+  const match = href.match(/^([a-z][a-z0-9+.-]*):\/{2,3}(.+)$/i);
+  if (!match)
+    return null;
+  const type = match[1].toLowerCase();
+  if (!getResourceLinkSchemeSet(options).has(type))
+    return null;
+  return {
+    href,
+    label: label || href,
+    type,
+    value: decodeURIComponent(match[2])
+  };
+};
+var replaceMarkdownResourceLinks = (text, replacer, options) => {
+  if (!text)
+    return "";
+  return text.replace(
+    RESOURCE_LINK_REGEX,
+    (source, label, href) => {
+      const link = parseMarkdownResourceHref(href, label, options);
+      return link ? replacer(link) : source;
+    }
+  );
+};
+var formatMarkdownResourceLinksAsText = (text, options) => replaceMarkdownResourceLinks(
+  text,
+  (link) => {
+    const label = link.label || link.value;
+    return (options == null ? void 0 : options.stripTrigger) === false ? label : stripTriggerPrefix(label);
+  },
+  options
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MARKDOWN_RESOURCE_LINK_SCHEMES,
+  formatMarkdownResourceLinksAsText,
+  getMarkdownResourceDisplayLabel,
+  parseMarkdownResourceHref,
+  parseMarkdownResourceLinksAsParts,
+  replaceMarkdownResourceLinks
+});
+//# sourceMappingURL=markdownResource.js.map

package/dist/cjs/utils/markdownResource.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/markdownResource.ts"],
+  "sourcesContent": ["import type {\n  MarkdownResourceLink,\n  MentionTag,\n  XAdkSenderSubmitPart,\n} from \"@/types\";\n\nexport const MARKDOWN_RESOURCE_LINK_SCHEMES = [\n  \"skill\",\n  \"kb\",\n  // \"plugin\",\n  // \"tool\",\n  // \"knowledge\",\n  // \"agent\",\n  // \"model\",\n] as const;\n\nexport type MarkdownResourceLinkScheme =\n  | (typeof MARKDOWN_RESOURCE_LINK_SCHEMES)[number]\n  | (string & {});\n\nexport interface MarkdownResourceLinkOptions {\n  schemes?: readonly MarkdownResourceLinkScheme[];\n}\n\nconst getResourceLinkSchemeSet = (options?: MarkdownResourceLinkOptions) =>\n  new Set<string>(options?.schemes || MARKDOWN_RESOURCE_LINK_SCHEMES);\n\nconst RESOURCE_LINK_REGEX =\n  /\\[([^\\]\\n]+)\\]\\(([a-z][a-z0-9+.-]*:\\/{2,3}[^)\\s]+)\\)/gi;\n\nconst stripTriggerPrefix = (label: string) => label.replace(/^[@/#$]+/, \"\");\n\nexport const getMarkdownResourceDisplayLabel = (label: string) =>\n  stripTriggerPrefix(label).trim();\n\n/** 将包含资源链接的 Markdown 还原成 Sender 可编辑的有序片段。 */\nexport const parseMarkdownResourceLinksAsParts = (\n  text: string,\n  options?: MarkdownResourceLinkOptions,\n): XAdkSenderSubmitPart[] => {\n  if (!text) return [];\n\n  const parts: XAdkSenderSubmitPart[] = [];\n  let lastIndex = 0;\n  let mentionIndex = 0;\n  const regex = new RegExp(\n    RESOURCE_LINK_REGEX.source,\n    RESOURCE_LINK_REGEX.flags,\n  );\n\n  let match: RegExpExecArray | null;\n  while ((match = regex.exec(text)) !== null) {\n    const source = match[0];\n    const label = match[1] || \"\";\n    const href = match[2] || \"\";\n    const start = match.index ?? 0;\n    const link = parseMarkdownResourceHref(href, label, options);\n    if (!link) continue;\n\n    if (start > lastIndex) {\n      parts.push({ type: \"text\", text: text.slice(lastIndex, start) });\n    }\n\n    const displayName = getMarkdownResourceDisplayLabel(\n      link.label || link.value,\n    );\n    const mention: MentionTag = {\n      id: `pasted-${link.type}-${mentionIndex}-${Date.now().toString(36)}`,\n      label: displayName,\n      displayName,\n      type: link.type,\n      uri: link.href,\n      targetId: link.value,\n      value: link.value,\n      trigger: label.match(/^[@/#$]+/)?.[0],\n      data: { uri: link.href, value: link.value },\n    };\n    parts.push({ type: \"mention\", mention });\n    mentionIndex += 1;\n    lastIndex = start + source.length;\n  }\n\n  if (lastIndex < text.length) {\n    parts.push({ type: \"text\", text: text.slice(lastIndex) });\n  }\n  return parts.length > 0 ? parts : [{ type: \"text\", text }];\n};\n\nexport const parseMarkdownResourceHref = (\n  href: string,\n  label = \"\",\n  options?: MarkdownResourceLinkOptions,\n): MarkdownResourceLink | null => {\n  const match = href.match(/^([a-z][a-z0-9+.-]*):\\/{2,3}(.+)$/i);\n  if (!match) return null;\n\n  const type = match[1].toLowerCase();\n  if (!getResourceLinkSchemeSet(options).has(type)) return null;\n\n  return {\n    href,\n    label: label || href,\n    type,\n    value: decodeURIComponent(match[2]),\n  };\n};\n\nexport const replaceMarkdownResourceLinks = (\n  text: string,\n  replacer: (link: MarkdownResourceLink) => string,\n  options?: MarkdownResourceLinkOptions,\n) => {\n  if (!text) return \"\";\n  return text.replace(\n    RESOURCE_LINK_REGEX,\n    (source, label: string, href: string) => {\n      const link = parseMarkdownResourceHref(href, label, options);\n      return link ? replacer(link) : source;\n    },\n  );\n};\n\nexport const formatMarkdownResourceLinksAsText = (\n  text: string,\n  options?: MarkdownResourceLinkOptions & { stripTrigger?: boolean },\n) =>\n  replaceMarkdownResourceLinks(\n    text,\n    (link) => {\n      const label = link.label || link.value;\n      return options?.stripTrigger === false\n        ? label\n        : stripTriggerPrefix(label);\n    },\n    options,\n  );\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/components/FileGallery/index.js

@@ -131,6 +131,7 @@ var ImageWithLoading = function ImageWithLoading(_ref) {
     preview = _ref.preview,
     fallback = _ref.fallback,
     displayMode = _ref.displayMode,
+    className = _ref.className,
     styles = _ref.styles;
   var _useState = useState("loading"),
     _useState2 = _slicedToArray(_useState, 2),
@@ -144,7 +145,7 @@ var ImageWithLoading = function ImageWithLoading(_ref) {
   if (width) containerStyle.width = typeof width === "number" ? "".concat(width, "px") : width;
   if (height) containerStyle.height = typeof height === "number" ? "".concat(height, "px") : height;
   return /*#__PURE__*/_jsxs("div", {
-    className: modeClass,
+    className: "".concat(modeClass, " ").concat(className || ""),
     style: containerStyle,
     children: [loadState === "loading" && /*#__PURE__*/_jsx("div", {
       className: styles.imageLoadingSkeleton,
@@ -193,6 +194,8 @@ var FileGallery = function FileGallery(_ref2) {
   var file = _ref2.file,
     _ref2$align = _ref2.align,
     align = _ref2$align === void 0 ? "left" : _ref2$align,
+    _ref2$size = _ref2.size,
+    size = _ref2$size === void 0 ? "default" : _ref2$size,
     _ref2$removable = _ref2.removable,
     removable = _ref2$removable === void 0 ? false : _ref2$removable,
     _ref2$onRemove = _ref2.onRemove,
@@ -237,6 +240,8 @@ var FileGallery = function FileGallery(_ref2) {
   var fileSize = getFileSize(file);
   var fileId = getFileId(file);
   var url = getFileUrl(file) || objectUrl;
+  var isSmall = size === "small";
+  var cardClassName = "".concat(styles.fileCard, " ").concat(isSmall ? styles.fileCardSmall : "", " ").concat(align === "right" ? "align-right" : "", " ").concat(className || "");
 
   // 核心逻辑：type prop 决定渲染方式（参考 file-card）
   // - 不传 type：自动推断，图片/音频/视频用原生渲染
@@ -262,7 +267,7 @@ var FileGallery = function FileGallery(_ref2) {
   // ==================== 渲染删除按钮 ====================
   var renderRemoveBtn = function renderRemoveBtn() {
     return removable ? /*#__PURE__*/_jsx("button", {
-      className: styles.fileRemoveBtn,
+      className: "".concat(styles.fileRemoveBtn, " ").concat(isSmall ? styles.fileRemoveBtnSmall : ""),
       onClick: function onClick(e) {
         e.stopPropagation();
         onRemove(fileId);
@@ -294,7 +299,7 @@ var FileGallery = function FileGallery(_ref2) {
       color = _getIcon.color;
     var isExternalUrl = url && url.startsWith("http");
     return /*#__PURE__*/_jsxs("div", {
-      className: "".concat(styles.fileCard, " ").concat(align === "right" ? "align-right" : "", " ").concat(className || ""),
+      className: cardClassName,
       style: _objectSpread(_objectSpread({}, style), {}, {
         cursor: _onClick ? "pointer" : undefined
       }),
@@ -302,7 +307,7 @@ var FileGallery = function FileGallery(_ref2) {
         return _onClick === null || _onClick === void 0 ? void 0 : _onClick(file);
       },
       children: [/*#__PURE__*/_jsx("div", {
-        className: styles.fileIcon,
+        className: "".concat(styles.fileIcon, " ").concat(isSmall ? styles.fileIconSmall : ""),
         style: {
           color: color
         },
@@ -317,14 +322,14 @@ var FileGallery = function FileGallery(_ref2) {
           children: /*#__PURE__*/_jsx(Tooltip, {
             title: fileName,
             children: /*#__PURE__*/_jsx("div", {
-              className: styles.fileName,
+              className: "".concat(styles.fileName, " ").concat(isSmall ? styles.fileNameSmall : ""),
               children: fileName.length > 15 ? "".concat(fileName.substring(0, 15), "...") : fileName
             })
           })
         }) : /*#__PURE__*/_jsx(Tooltip, {
           title: fileName,
           children: /*#__PURE__*/_jsx("div", {
-            className: styles.fileName,
+            className: "".concat(styles.fileName, " ").concat(isSmall ? styles.fileNameSmall : ""),
             children: fileName.length > 15 ? "".concat(fileName.substring(0, 15), "...") : fileName
           })
         }), file.status === "uploading" ? /*#__PURE__*/_jsx(Progress, {
@@ -332,8 +337,8 @@ var FileGallery = function FileGallery(_ref2) {
           size: "small",
           showInfo: false,
           strokeColor: "#1677ff",
-          className: styles.progress
-        }) : fileSize > 0 && /*#__PURE__*/_jsx("div", {
+          className: "".concat(styles.progress, " ").concat(isSmall ? styles.progressSmall : "")
+        }) : !isSmall && fileSize > 0 && /*#__PURE__*/_jsx("div", {
           className: styles.fileSize,
           children: formatFileSize(fileSize)
         }), file.status === "error" && file.errorMessage && /*#__PURE__*/_jsx("div", {
@@ -374,7 +379,7 @@ var FileGallery = function FileGallery(_ref2) {
 
     // thumbnail 模式：卡片形式
     return /*#__PURE__*/_jsxs("div", {
-      className: "".concat(styles.fileCard, " ").concat(align === "right" ? "align-right" : "", " ").concat(className || ""),
+      className: cardClassName,
       style: _objectSpread(_objectSpread({}, style), {}, {
         cursor: _onClick ? "pointer" : undefined
       }),
@@ -384,24 +389,25 @@ var FileGallery = function FileGallery(_ref2) {
       children: [/*#__PURE__*/_jsx(ImageWithLoading, {
         src: url,
         alt: imageAlt || fileName,
-        width: imageWidth,
-        height: imageHeight,
+        width: size === "small" ? 22 : imageWidth,
+        height: size === "small" ? 22 : imageHeight,
         displayMode: "thumbnail",
         loading: imageLoading,
         preview: _onClick ? false : {
           src: url
         },
         fallback: FALLBACK_IMAGE,
-        styles: styles
+        styles: styles,
+        className: isSmall ? styles.imageThumbnailSmall : undefined
       }), renderUploadOverlay(), /*#__PURE__*/_jsxs("div", {
         className: styles.fileInfo,
         children: [/*#__PURE__*/_jsx(Tooltip, {
           title: fileName,
           children: /*#__PURE__*/_jsx("div", {
-            className: styles.fileName,
+            className: "".concat(styles.fileName, " ").concat(isSmall ? styles.fileNameSmall : ""),
             children: fileName.length > 15 ? "".concat(fileName.substring(0, 15), "...") : fileName
           })
-        }), Number(file === null || file === void 0 ? void 0 : file.size) > 0 && /*#__PURE__*/_jsx("div", {
+        }), !isSmall && Number(file === null || file === void 0 ? void 0 : file.size) > 0 && /*#__PURE__*/_jsx("div", {
           className: styles.fileSize,
           children: formatFileSize(fileSize)
         })]
@@ -410,7 +416,7 @@ var FileGallery = function FileGallery(_ref2) {
   }
 
   // ==================== 音频渲染（原生播放器，无卡片包裹） ====================
-  if (fileType === "audio") {
+  if (fileType === "audio" && size !== "small") {
     return /*#__PURE__*/_jsxs("div", {
       className: "file-gallery-audio ".concat(className || ""),
       style: _objectSpread({
@@ -431,7 +437,7 @@ var FileGallery = function FileGallery(_ref2) {
   }
 
   // ==================== 视频渲染（原生播放器，无卡片包裹） ====================
-  if (fileType === "video") {
+  if (fileType === "video" && size !== "small") {
     return /*#__PURE__*/_jsxs("div", {
       className: "file-gallery-video ".concat(className || ""),
       style: _objectSpread({