@ai-group/chat-sdk 3.7.1-alpha3 → 3.7.1-alpha4

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

@@ -13,7 +13,9 @@ export interface QuickListOption {
 export interface QuickKeyConfig {
     /** 触发字符，如 '@', '#', '$' */
     key: string;
-    /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */
+    /** 选中后写入 MentionTag.type 的语义类型，不传时回退为 key */
+    mentionType?: string;
+    /** @deprecated 请使用 mentionType。 */
     tagType?: string;
     /** 列表标题 */
     title?: string;
@@ -24,21 +26,31 @@ export interface QuickKeyConfig {
     /** 选中回调 */
     onSelect?: (option: QuickListOption) => void;
 }
-/** 输入框内标签 */
-export interface InputTag {
+/** 输入框内的资源引用。SDK 只理解通用 Mention，业务语义可放入 data 或可选语义字段。 */
+export interface MentionTag {
     id: string;
     label: string;
-    /** 标签类型，如 'aggregation', 'skill', 'app' */
+    /** Mention 类型，如 'knowledge', 'skill', 'plugin', 'agent' */
     type: string;
-    /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */
+    /** 资源 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;
 }
@@ -47,13 +59,22 @@ export type XAdkSenderSubmitPart = {
     type: "text";
     text: string;
 } | {
+    type: "mention";
+    mention: MentionTag;
+};
+/** @deprecated 旧 tag part，仅用于兼容 defaultInputParts 历史传入。 */
+export type XAdkSenderLegacyTagPart = {
     type: "tag";
-    tag: InputTag;
+    tag: MentionTag;
 };
-export interface XAdkSenderFormatTagContext {
+/** 输入框文本/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;
@@ -61,10 +82,13 @@ export interface XAdkSenderSubmitData<TPayload = unknown> {
     rawText: string;
     /** 当前提交格式 */
     format: XAdkSenderSubmitFormat;
-    /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */
+    /** 文本与 Mention 的有序片段，inlineTags 模式下可还原资源引用在输入框中的位置 */
     parts: XAdkSenderSubmitPart[];
     files: ServerFile[];
-    tags?: InputTag[];
+    /** 当前 Mention 列表 */
+    mentions?: MentionTag[];
+    /** @deprecated 请使用 mentions。 */
+    tags?: MentionTag[];
     /** 业务方通过 transformSubmitData 派生出的自定义提交结构 */
     payload?: TPayload;
 }
@@ -175,27 +199,39 @@ export interface SenderUIProps {
     footerLeft?: React.ReactNode | false | SlotRenderFunction;
     /** 快捷键配置列表 */
     quickKeys?: QuickKeyConfig[];
-    /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */
+    /** 是否把 Mention 以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */
     inlineTags?: boolean;
-    /** 自定义内联标签渲染 */
-    renderTag?: (tag: InputTag, info: InlineTagRenderInfo) => React.ReactNode;
-    /** 受控：标签列表 */
-    tags?: InputTag[];
-    /** 非受控：默认标签列表 */
-    defaultTags?: InputTag[];
-    /** 标签变化回调 */
-    onTagsChange?: (tags: InputTag[]) => void;
+    /** 自定义内联 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: 默认，输出文字 + 标签文本（如 /生图技能）
-     * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText
+     * - text: 默认，输出文字 + Mention 文本（如 @生图技能）
+     * - structured: 保留 parts/mentions/files 结构化数据，text 为 rawText
      * - markdown/xml: 输出对应标记文本
      */
     submitFormat?: XAdkSenderSubmitFormat;
-    /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */
-    formatTag?: (tag: InputTag, context: XAdkSenderFormatTagContext) => string;
+    /** 自定义 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 数据中。
@@ -205,8 +241,10 @@ export interface SenderUIProps {
 export type XAdkSenderProps = SenderUIProps & UploaderCoreProps;
 export interface XAdkSenderHandle {
     addFiles: (files: File[]) => void;
-    /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */
-    insertTag: (tag: InputTag) => void;
+    /** 向当前光标位置插入一个内联 Mention；未启用 inlineTags 时会退化为追加 Mention。 */
+    insertMention: (mention: MentionTag) => void;
+    /** @deprecated 请使用 insertMention。 */
+    insertTag: (mention: MentionTag) => void;
     /** 聚焦输入区 */
     focus: () => void;
 }

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

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"sourcesContent":["// types/XAdkSender.ts\nimport React from \"react\";\n\n// ===================== 快捷键/标签相关类型 =====================\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  /** 选中后写入 InputTag.type 的语义类型，不传时回退为 key 以兼容旧行为 */\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/** 输入框内标签 */\nexport interface InputTag {\n  id: string;\n  label: string;\n  /** 标签类型，如 'aggregation', 'skill', 'app' */\n  type: string;\n  /** 提交为纯文本/Markdown/XML 时使用的业务值，不传时回退 label */\n  value?: string;\n  /** 触发字符，如 '@', '#', '$'，用于业务方区分来源 */\n  trigger?: string;\n  color?: string;\n  icon?: React.ReactNode;\n  /** 原始数据 */\n  data?: any;\n}\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: \"tag\"; tag: InputTag };\n\nexport interface XAdkSenderFormatTagContext {\n  format: Exclude<XAdkSenderSubmitFormat, \"structured\">;\n  index: number;\n}\n\nexport interface XAdkSenderSubmitData<TPayload = unknown> {\n  /** 根据 submitFormat 生成的最终内容，默认是纯文本 */\n  text: string;\n  /** 去掉标签后的用户原始输入文本 */\n  rawText: string;\n  /** 当前提交格式 */\n  format: XAdkSenderSubmitFormat;\n  /** 文本与标签的有序片段，inlineTags 模式下可还原标签在输入框中的位置 */\n  parts: XAdkSenderSubmitPart[];\n  files: ServerFile[];\n  tags?: InputTag[];\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  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  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  // 快捷键/标签功能\n  /** 快捷键配置列表 */\n  quickKeys?: QuickKeyConfig[];\n  /** 是否把标签以内联 token 形式展示在输入区内；默认 false 保持历史 textarea 行为 */\n  inlineTags?: boolean;\n  /** 自定义内联标签渲染 */\n  renderTag?: (\n    tag: InputTag,\n    info: InlineTagRenderInfo,\n  ) => React.ReactNode;\n  /** 受控：标签列表 */\n  tags?: InputTag[];\n  /** 非受控：默认标签列表 */\n  defaultTags?: InputTag[];\n  /** 标签变化回调 */\n  onTagsChange?: (tags: InputTag[]) => void;\n  /** 快捷键触发回调（业务方可在此处理搜索等逻辑） */\n  onQuickKeyTrigger?: (key: string, keyword: string) => void;\n  /**\n   * 提交内容格式：\n   * - text: 默认，输出文字 + 标签文本（如 /生图技能）\n   * - structured: 保留 parts/tags/files 结构化数据，text 为 rawText\n   * - markdown/xml: 输出对应标记文本\n   */\n  submitFormat?: XAdkSenderSubmitFormat;\n  /** 自定义标签在 text/markdown/xml 格式中的序列化结果 */\n  formatTag?: (\n    tag: InputTag,\n    context: XAdkSenderFormatTagContext,\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  /** 向当前光标位置插入一个内联标签；未启用 inlineTags 时会退化为追加标签。 */\n  insertTag: (tag: InputTag) => void;\n  /** 聚焦输入区 */\n  focus: () => void;\n}\n"],"mappings":""}
+{"version":3,"names":[],"sources":["../../../src/types/XAdkSender.ts"],"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  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  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":""}

package/dist/esm/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/esm/utils/index.js

@@ -23,4 +23,5 @@ export function cleanProcessText(text) {
 
 // 导出新的解析工具
 export * from "./parseAgentMessage";
+export * from "./markdownResource";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["safeJsonParse","str","defaultValue","arguments","length","undefined","JSON","parse","error","safeJsonStringify","obj","stringify","cleanProcessText","text","replace","trim"],"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,OAAO,IAAMA,aAAa,GAAG,SAAhBA,aAAaA,CACxBC,GAAY,EAEN;EAAA,IADNC,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACF,GAAG,EAAE,OAAOC,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACC,KAAK,CAACN,GAAG,CAAC,IAAIC,YAAY;EACxC,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,IAAMO,iBAAiB,GAAG,SAApBA,iBAAiBA,CAC5BC,GAAO,EAEI;EAAA,IADXR,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACO,GAAG,EAAE,OAAOR,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACK,SAAS,CAACD,GAAG,CAAC,IAAIR,YAAY;EAC5C,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,SAASU,gBAAgBA,CAACC,IAAY,EAAU;EACrD,IAAI,CAACA,IAAI,EAAE,OAAO,EAAE;EACpB,OAAOA,IAAI,CACRC,OAAO,CAAC,8DAA8D,EAAE,EAAE,CAAC,CAC3EC,IAAI,CAAC,CAAC;AACX;;AAEA;AACA"}
+{"version":3,"names":["safeJsonParse","str","defaultValue","arguments","length","undefined","JSON","parse","error","safeJsonStringify","obj","stringify","cleanProcessText","text","replace","trim"],"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';\nexport * from './markdownResource';\n"],"mappings":"AAAA,OAAO,IAAMA,aAAa,GAAG,SAAhBA,aAAaA,CACxBC,GAAY,EAEN;EAAA,IADNC,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACF,GAAG,EAAE,OAAOC,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACC,KAAK,CAACN,GAAG,CAAC,IAAIC,YAAY;EACxC,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,IAAMO,iBAAiB,GAAG,SAApBA,iBAAiBA,CAC5BC,GAAO,EAEI;EAAA,IADXR,YAAiB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEtB,IAAI,CAACO,GAAG,EAAE,OAAOR,YAAY;EAC7B,IAAI;IACF,OAAOI,IAAI,CAACK,SAAS,CAACD,GAAG,CAAC,IAAIR,YAAY;EAC5C,CAAC,CAAC,OAAOM,KAAK,EAAE;IACd,OAAON,YAAY;EACrB;AACF,CAAC;AAED,OAAO,SAASU,gBAAgBA,CAACC,IAAY,EAAU;EACrD,IAAI,CAACA,IAAI,EAAE,OAAO,EAAE;EACpB,OAAOA,IAAI,CACRC,OAAO,CAAC,8DAA8D,EAAE,EAAE,CAAC,CAC3EC,IAAI,CAAC,CAAC;AACX;;AAEA;AACA;AACA"}

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

@@ -0,0 +1,7 @@
+import type { MarkdownResourceLink } from "../types";
+export declare const MARKDOWN_RESOURCE_LINK_SCHEMES: readonly ["skill", "plugin", "tool", "knowledge", "kb", "agent", "model"];
+export declare const parseMarkdownResourceHref: (href: string, label?: string) => MarkdownResourceLink | null;
+export declare const replaceMarkdownResourceLinks: (text: string, replacer: (link: MarkdownResourceLink) => string) => string;
+export declare const formatMarkdownResourceLinksAsText: (text: string, options?: {
+    stripTrigger?: boolean;
+}) => string;

package/dist/esm/utils/markdownResource.js

@@ -0,0 +1,33 @@
+export var MARKDOWN_RESOURCE_LINK_SCHEMES = ["skill", "plugin", "tool", "knowledge", "kb", "agent", "model"];
+var RESOURCE_LINK_SCHEME_SET = new Set(MARKDOWN_RESOURCE_LINK_SCHEMES);
+var RESOURCE_LINK_REGEX = /\[([^\]\n]+)\]\(((?:skill|plugin|tool|knowledge|kb|agent|model):\/{2,3}[^)\s]+)\)/gi;
+var stripTriggerPrefix = function stripTriggerPrefix(label) {
+  return label.replace(/^[@/#$]+/, "");
+};
+export var parseMarkdownResourceHref = function parseMarkdownResourceHref(href) {
+  var label = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "";
+  var match = href.match(/^([a-z][a-z0-9+.-]*):\/{2,3}(.+)$/i);
+  if (!match) return null;
+  var type = match[1].toLowerCase();
+  if (!RESOURCE_LINK_SCHEME_SET.has(type)) return null;
+  return {
+    href: href,
+    label: label || href,
+    type: type,
+    value: decodeURIComponent(match[2])
+  };
+};
+export var replaceMarkdownResourceLinks = function replaceMarkdownResourceLinks(text, replacer) {
+  if (!text) return "";
+  return text.replace(RESOURCE_LINK_REGEX, function (source, label, href) {
+    var link = parseMarkdownResourceHref(href, label);
+    return link ? replacer(link) : source;
+  });
+};
+export var formatMarkdownResourceLinksAsText = function formatMarkdownResourceLinksAsText(text, options) {
+  return replaceMarkdownResourceLinks(text, function (link) {
+    var label = link.label || link.value;
+    return (options === null || options === void 0 ? void 0 : options.stripTrigger) === false ? label : stripTriggerPrefix(label);
+  });
+};
+//# sourceMappingURL=markdownResource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["MARKDOWN_RESOURCE_LINK_SCHEMES","RESOURCE_LINK_SCHEME_SET","Set","RESOURCE_LINK_REGEX","stripTriggerPrefix","label","replace","parseMarkdownResourceHref","href","arguments","length","undefined","match","type","toLowerCase","has","value","decodeURIComponent","replaceMarkdownResourceLinks","text","replacer","source","link","formatMarkdownResourceLinksAsText","options","stripTrigger"],"sources":["../../../src/utils/markdownResource.ts"],"sourcesContent":["import type { MarkdownResourceLink } from \"@/types\";\n\nexport const MARKDOWN_RESOURCE_LINK_SCHEMES = [\n  \"skill\",\n  \"plugin\",\n  \"tool\",\n  \"knowledge\",\n  \"kb\",\n  \"agent\",\n  \"model\",\n] as const;\n\nconst RESOURCE_LINK_SCHEME_SET = new Set<string>(MARKDOWN_RESOURCE_LINK_SCHEMES);\nconst RESOURCE_LINK_REGEX =\n  /\\[([^\\]\\n]+)\\]\\(((?:skill|plugin|tool|knowledge|kb|agent|model):\\/{2,3}[^)\\s]+)\\)/gi;\n\nconst stripTriggerPrefix = (label: string) => label.replace(/^[@/#$]+/, \"\");\n\nexport const parseMarkdownResourceHref = (\n  href: string,\n  label = \"\",\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 (!RESOURCE_LINK_SCHEME_SET.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) => {\n  if (!text) return \"\";\n  return text.replace(RESOURCE_LINK_REGEX, (source, label: string, href: string) => {\n    const link = parseMarkdownResourceHref(href, label);\n    return link ? replacer(link) : source;\n  });\n};\n\nexport const formatMarkdownResourceLinksAsText = (\n  text: string,\n  options?: { stripTrigger?: boolean },\n) =>\n  replaceMarkdownResourceLinks(text, (link) => {\n    const label = link.label || link.value;\n    return options?.stripTrigger === false ? label : stripTriggerPrefix(label);\n  });\n"],"mappings":"AAEA,OAAO,IAAMA,8BAA8B,GAAG,CAC5C,OAAO,EACP,QAAQ,EACR,MAAM,EACN,WAAW,EACX,IAAI,EACJ,OAAO,EACP,OAAO,CACC;AAEV,IAAMC,wBAAwB,GAAG,IAAIC,GAAG,CAASF,8BAA8B,CAAC;AAChF,IAAMG,mBAAmB,GACvB,qFAAqF;AAEvF,IAAMC,kBAAkB,GAAG,SAArBA,kBAAkBA,CAAIC,KAAa;EAAA,OAAKA,KAAK,CAACC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;AAAA;AAE3E,OAAO,IAAMC,yBAAyB,GAAG,SAA5BA,yBAAyBA,CACpCC,IAAY,EAEoB;EAAA,IADhCH,KAAK,GAAAI,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;EAEV,IAAMG,KAAK,GAAGJ,IAAI,CAACI,KAAK,CAAC,oCAAoC,CAAC;EAC9D,IAAI,CAACA,KAAK,EAAE,OAAO,IAAI;EAEvB,IAAMC,IAAI,GAAGD,KAAK,CAAC,CAAC,CAAC,CAACE,WAAW,CAAC,CAAC;EACnC,IAAI,CAACb,wBAAwB,CAACc,GAAG,CAACF,IAAI,CAAC,EAAE,OAAO,IAAI;EAEpD,OAAO;IACLL,IAAI,EAAJA,IAAI;IACJH,KAAK,EAAEA,KAAK,IAAIG,IAAI;IACpBK,IAAI,EAAJA,IAAI;IACJG,KAAK,EAAEC,kBAAkB,CAACL,KAAK,CAAC,CAAC,CAAC;EACpC,CAAC;AACH,CAAC;AAED,OAAO,IAAMM,4BAA4B,GAAG,SAA/BA,4BAA4BA,CACvCC,IAAY,EACZC,QAAgD,EAC7C;EACH,IAAI,CAACD,IAAI,EAAE,OAAO,EAAE;EACpB,OAAOA,IAAI,CAACb,OAAO,CAACH,mBAAmB,EAAE,UAACkB,MAAM,EAAEhB,KAAa,EAAEG,IAAY,EAAK;IAChF,IAAMc,IAAI,GAAGf,yBAAyB,CAACC,IAAI,EAAEH,KAAK,CAAC;IACnD,OAAOiB,IAAI,GAAGF,QAAQ,CAACE,IAAI,CAAC,GAAGD,MAAM;EACvC,CAAC,CAAC;AACJ,CAAC;AAED,OAAO,IAAME,iCAAiC,GAAG,SAApCA,iCAAiCA,CAC5CJ,IAAY,EACZK,OAAoC;EAAA,OAEpCN,4BAA4B,CAACC,IAAI,EAAE,UAACG,IAAI,EAAK;IAC3C,IAAMjB,KAAK,GAAGiB,IAAI,CAACjB,KAAK,IAAIiB,IAAI,CAACN,KAAK;IACtC,OAAO,CAAAQ,OAAO,aAAPA,OAAO,uBAAPA,OAAO,CAAEC,YAAY,MAAK,KAAK,GAAGpB,KAAK,GAAGD,kBAAkB,CAACC,KAAK,CAAC;EAC5E,CAAC,CAAC;AAAA"}