@ai-group/chat-sdk 3.1.0 → 3.2.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/ChatHook.ts"],
-  "sourcesContent": ["import { IMessage, SendContent } from \"./index\";\n\n/**\n * 聊天 Hook 标准接口\n * 所有自定义 Hook 必须实现这个接口\n *\n * @example\n * // 使用内置标准协议\n * <XAdkProvider url=\"...\" token=\"...\" config={...}>\n *   <XAdkProvider.DefaultLayout />\n * </XAdkProvider>\n *\n * @example\n * // 使用自定义 Hook (GraphQL)\n * function MyApp() {\n *   const chatData = useMyGraphQLChat({ endpoint: '...' });\n *   return (\n *     <XAdkProvider chatData={chatData}>\n *       <XAdkProvider.DefaultLayout />\n *     </XAdkProvider>\n *   );\n * }\n */\nexport interface ChatHookResult {\n  // ========== 状态 ==========\n\n  /** 消息列表 */\n  messages: IMessage[];\n\n  /** 加载状态 */\n  loading: boolean;\n\n  /** 当前会话ID */\n  currentSessionId: string;\n\n  /** 开场白 */\n  prologue: string;\n\n  /** 建议问题列表 */\n  suggestions: string[];\n\n  /** 应用信息 */\n  appInfo: any | null;\n\n  /** 是否已初始化 */\n  initialized: boolean;\n\n  // ========== 会话列表 ==========\n\n  /** 会话列表 */\n  sessionList: any[];\n\n  /** 会话分页信息 */\n  sessionPagination: {\n    total: number;\n    pageNum: number;\n    pageSize: number;\n  };\n\n  // ========== 操作方法 ==========\n\n  /** 发送消息 */\n  startChat: (content: SendContent) => void;\n\n  /** 停止当前对话 */\n  stopChat: () => void;\n\n  /** 清空当前会话消息 */\n  clearChat: () => void;\n\n  /** 重新生成最后一条回复 */\n  reChat: () => void;\n\n  /** 发送建议问题 */\n  suggestChat: (suggestion: string) => void;\n\n  /** 确认函数调用 */\n  confirmFnCall: (response: any) => void;\n\n  /** 删除会话 */\n  deleteSession: (id: string) => void;\n\n  /** 更新会话标题 */\n  updateSession: (id: string, title: string) => void;\n\n  /** 切换会话 */\n  setCurrentSessionDetail: (id: string) => void;\n\n  /** 直接设置消息列表 */\n  setMessages: (msgs: IMessage[] | ((prev: IMessage[]) => IMessage[])) => void;\n\n  /** 点赞/点踩消息（可选，自定义 Hook 可不实现） */\n  likeMessage?: (\n    invocationId: string,\n    isLike: 1 | -1,\n    feedbackData?: { feedbackTags?: string; feedbackDescription?: string },\n  ) => Promise<boolean>;\n}\n\n/**\n * Hook 工厂函数类型\n *\n * @example\n * const useMyCustomChat: ChatHookFactory = (options) => {\n *   // 实现自定义协议逻辑\n *   return {\n *     messages: [...],\n *     loading: false,\n *     startChat: (content) => { ... },\n *     // ... 其他方法\n *   };\n * };\n */\nexport type ChatHookFactory = (options: any) => ChatHookResult;\n"],
+  "sourcesContent": ["import { IMessage, SendContent } from \"./index\";\n\n/**\n * 聊天 Hook 标准接口\n * 所有自定义 Hook 必须实现这个接口\n *\n * @example\n * // 使用内置标准协议\n * <XAdkProvider url=\"...\" token=\"...\" config={...}>\n *   <XAdkProvider.DefaultLayout />\n * </XAdkProvider>\n *\n * @example\n * // 使用自定义 Hook (GraphQL)\n * function MyApp() {\n *   const chatData = useMyGraphQLChat({ endpoint: '...' });\n *   return (\n *     <XAdkProvider chatData={chatData}>\n *       <XAdkProvider.DefaultLayout />\n *     </XAdkProvider>\n *   );\n * }\n */\nexport interface ChatHookResult {\n  // ========== 状态 ==========\n\n  /** 消息列表 */\n  messages: IMessage[];\n\n  /** 加载状态 */\n  loading: boolean;\n\n  /** 当前会话ID */\n  currentSessionId: string;\n\n  /** 开场白 */\n  prologue: string;\n\n  /** 建议问题列表 */\n  suggestions: string[];\n\n  /** 应用信息 */\n  appInfo: any | null;\n\n  /** 是否已初始化 */\n  initialized: boolean;\n\n  // ========== 会话列表 ==========\n\n  /** 会话列表 */\n  sessionList: any[];\n\n  /** 会话分页信息 */\n  sessionPagination: {\n    total: number;\n    pageNum: number;\n    pageSize: number;\n  };\n\n  // ========== 操作方法 ==========\n\n  /** 发送消息 */\n  startChat: (content: SendContent) => void;\n\n  /** 停止当前对话 */\n  stopChat: () => void;\n\n  /** 清空当前会话消息 */\n  clearChat: () => void;\n\n  /** 重新生成最后一条回复 */\n  reChat: () => void;\n\n  /** 发送建议问题 */\n  suggestChat: (suggestion: string) => void;\n\n  /** 确认函数调用 */\n  confirmFnCall: (response: any) => void;\n\n  /** 删除会话 */\n  deleteSession: (id: string) => void;\n\n  /** 更新会话标题 */\n  updateSession: (id: string, title: string) => void;\n\n  /** 切换会话 */\n  setCurrentSession: (id: string) => void;\n\n  /** 直接设置消息列表 */\n  setMessages: (msgs: IMessage[] | ((prev: IMessage[]) => IMessage[])) => void;\n\n  /** 点赞/点踩消息（可选，自定义 Hook 可不实现） */\n  likeMessage?: (\n    invocationId: string,\n    isLike: 1 | -1,\n    feedbackData?: { feedbackTags?: string; feedbackDescription?: string },\n  ) => Promise<boolean>;\n\n  /**\n   * 设置自定义业务参数 (stateDelta)（可选，自定义 Hook 可不实现）\n   * 设置后每次发送消息时会自动携带该参数\n   * 传入 undefined 可清除已设置的参数\n   */\n  setStateDelta?: (delta: Record<string, any> | undefined) => void;\n}\n\n/**\n * Hook 工厂函数类型\n *\n * @example\n * const useMyCustomChat: ChatHookFactory = (options) => {\n *   // 实现自定义协议逻辑\n *   return {\n *     messages: [...],\n *     loading: false,\n *     startChat: (content) => { ... },\n *     // ... 其他方法\n *   };\n * };\n */\nexport type ChatHookFactory = (options: any) => ChatHookResult;\n"],
   "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

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

@@ -47,6 +47,7 @@ export interface FooterRenderArgs {
 export interface XAdkProviderHandle {
     startChat: (content: SendContent) => void;
     stopChat: () => void;
+    reChat: () => void;
     clearChat: () => void;
     deleteSession: (id: string) => void;
     updateSession: (id: string, title: string) => void;
@@ -54,7 +55,21 @@ export interface XAdkProviderHandle {
     getMessages: () => IMessage[];
     getSessions: () => any[];
     setMessages: (msgs: IMessage[]) => void;
-    setCurrentSessionDetail: (id: string) => void;
+    setCurrentSession: (id: string) => void;
+    /**
+     * 设置自定义业务参数 (stateDelta)
+     * 设置后每次发送消息时会自动携带该参数至后端
+     * 传入 undefined 可清除已设置的参数
+     *
+     * @example
+     * providerRef.current.setStateDelta({ userId: '123', bizType: 'order' });
+     * // 之后发送消息，请求体会携带 stateDelta: { userId: '123', bizType: 'order' }
+     *
+     * @example
+     * // 清除自定义参数
+     * providerRef.current.setStateDelta(undefined);
+     */
+    setStateDelta: (delta: Record<string, any> | undefined) => void;
 }
 /**
  * config.chatProps 中的配置

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAdkProvider.ts"],
-  "sourcesContent": ["import { ReactNode } from \"react\";\nimport {\n  IMessage,\n  Success,\n  Event,\n  Error,\n  SendContent,\n  ThemeType,\n  FileItem,\n  UploadRequestFn,\n} from \"@/types\";\n\nexport interface DebugOptions {\n  url: string;\n  sessionId?: string;\n  config: any;\n  token: string;\n  type?: \"agentDebug\" | \"appDebug\";\n  /**\n   * 是否启用 Hook\n   * 当使用自定义 chatData 时,应设置为 false 以避免内部 Hook 初始化\n   * @default true\n   */\n  enabled?: boolean;\n  onError?: (error: Error) => void;\n  onSuccess?: (data: Success) => void;\n  onStream?: (data: Event) => void;\n  onMessage?: (content: string, data: IMessage) => void;\n}\n\n/**\n * 事件状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum EventCode {\n  /** 切换会话 */\n  SESSION_SWITCH = \"SESSION_SWITCH\",\n  /** 开启新会话 */\n  SESSION_CREATE = \"SESSION_CREATE\",\n}\n\nexport type handleEvent = {\n  code: EventCode;\n  message: string;\n  data?: any;\n};\n/**\n * renderFooter insert 参数说明\n */\nexport interface FooterRenderArgs {\n  message: IMessage;\n  isLastBotMsg: boolean;\n  isLastMsg: boolean;\n}\n\n/**\n * Provider 可通过 ref 暴露的方法句柄\n */\nexport interface XAdkProviderHandle {\n  startChat: (content: SendContent) => void;\n  stopChat: () => void;\n  clearChat: () => void;\n  deleteSession: (id: string) => void;\n  updateSession: (id: string, title: string) => void;\n  getAppInfo: () => any;\n  getMessages: () => IMessage[];\n  getSessions: () => any[];\n  setMessages: (msgs: IMessage[]) => void;\n  setCurrentSessionDetail: (id: string) => void;\n}\n\n/**\n * config.chatProps 中的配置\n */\nexport interface ChatConfig {\n  /**\n   * 是否展示清空按钮\n   * @type {boolean}\n   * @default false\n   */\n  clearBtnShow?: boolean;\n  /**\n   * 是否展示输入框\n   * @type {boolean}\n   * @default true\n   */\n  inputShow?: boolean;\n  /**\n   * 打字机效果速度（单位：毫秒）\n   * @type {number}\n   * @default 60\n   * @version 1.0.0\n   */\n  textSpeed?: number;\n}\n\n/**\n * Provider config 整体配置结构\n */\nexport interface XAdkProviderConfig {\n  session?: {\n    showSessionList?: boolean;\n  };\n  /**\n   * 初始化后是否默认展示第一条会话内容\n   * @type {boolean}\n   * @default false\n   */\n  showFirstSession?: boolean;\n  allowUpload?: boolean;\n  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\n  /**\n   * 是否展示点赞/点踩按钮\n   * @default true\n   */\n  showFeedback?: boolean;\n  /**\n   * 点击对话中附件卡片的回调（非图片、非音视频文件）\n   */\n  onFileClick?: (file: FileItem) => void;\n  /**\n   * 自定义文件上传函数\n   */\n  uploadRequest?: UploadRequestFn;\n}\n\n/**\n * XAdkProvider Props\n */\nexport interface XAdkProviderProps {\n  /**\n   * AI 服务基础地址\n   */\n  url?: string;\n  /**\n   * 认证 token\n   */\n  token: string;\n  /**\n   * 组件功能配置\n   */\n  config?: XAdkProviderConfig;\n  /**\n   * Provider 唯一标识\n   */\n  providerId?: string;\n  /**\n   * 消息成功回调\n   */\n  onSuccess?: (success: any) => void;\n  /**\n   * 流式消息回调\n   */\n  onStream?: (data: Event) => void;\n  /**\n   * 错误回调\n   */\n  onError?: (err: any) => void;\n  /**\n   * 每条消息回调\n   */\n  onMessage?: (content: string, data: IMessage) => void;\n  /**\n   * 事件回调\n   */\n  onEvent?: (event: handleEvent) => void;\n  /**\n   * React 子元素 - 支持 Compound Components\n   */\n  children?: ReactNode;\n}\n\n// XAiSDKProps 继承 XAdkProviderProps\nexport interface XAdkSDKProps extends XAdkProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n"],
+  "sourcesContent": ["import { ReactNode } from \"react\";\nimport {\n  IMessage,\n  Success,\n  Event,\n  Error,\n  SendContent,\n  ThemeType,\n  FileItem,\n  UploadRequestFn,\n} from \"@/types\";\n\nexport interface DebugOptions {\n  url: string;\n  sessionId?: string;\n  config: any;\n  token: string;\n  type?: \"agentDebug\" | \"appDebug\";\n  /**\n   * 是否启用 Hook\n   * 当使用自定义 chatData 时,应设置为 false 以避免内部 Hook 初始化\n   * @default true\n   */\n  enabled?: boolean;\n  onError?: (error: Error) => void;\n  onSuccess?: (data: Success) => void;\n  onStream?: (data: Event) => void;\n  onMessage?: (content: string, data: IMessage) => void;\n}\n\n/**\n * 事件状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum EventCode {\n  /** 切换会话 */\n  SESSION_SWITCH = \"SESSION_SWITCH\",\n  /** 开启新会话 */\n  SESSION_CREATE = \"SESSION_CREATE\",\n}\n\nexport type handleEvent = {\n  code: EventCode;\n  message: string;\n  data?: any;\n};\n/**\n * renderFooter insert 参数说明\n */\nexport interface FooterRenderArgs {\n  message: IMessage;\n  isLastBotMsg: boolean;\n  isLastMsg: boolean;\n}\n\n/**\n * Provider 可通过 ref 暴露的方法句柄\n */\nexport interface XAdkProviderHandle {\n  startChat: (content: SendContent) => void;\n  stopChat: () => void;\n  reChat: () => void;\n  clearChat: () => void;\n  deleteSession: (id: string) => void;\n  updateSession: (id: string, title: string) => void;\n  getAppInfo: () => any;\n  getMessages: () => IMessage[];\n  getSessions: () => any[];\n  setMessages: (msgs: IMessage[]) => void;\n  setCurrentSession: (id: string) => void;\n  /**\n   * 设置自定义业务参数 (stateDelta)\n   * 设置后每次发送消息时会自动携带该参数至后端\n   * 传入 undefined 可清除已设置的参数\n   *\n   * @example\n   * providerRef.current.setStateDelta({ userId: '123', bizType: 'order' });\n   * // 之后发送消息，请求体会携带 stateDelta: { userId: '123', bizType: 'order' }\n   *\n   * @example\n   * // 清除自定义参数\n   * providerRef.current.setStateDelta(undefined);\n   */\n  setStateDelta: (delta: Record<string, any> | undefined) => void;\n}\n\n/**\n * config.chatProps 中的配置\n */\nexport interface ChatConfig {\n  /**\n   * 是否展示清空按钮\n   * @type {boolean}\n   * @default false\n   */\n  clearBtnShow?: boolean;\n  /**\n   * 是否展示输入框\n   * @type {boolean}\n   * @default true\n   */\n  inputShow?: boolean;\n  /**\n   * 打字机效果速度（单位：毫秒）\n   * @type {number}\n   * @default 60\n   * @version 1.0.0\n   */\n  textSpeed?: number;\n}\n\n/**\n * Provider config 整体配置结构\n */\nexport interface XAdkProviderConfig {\n  session?: {\n    showSessionList?: boolean;\n  };\n  /**\n   * 初始化后是否默认展示第一条会话内容\n   * @type {boolean}\n   * @default false\n   */\n  showFirstSession?: boolean;\n  allowUpload?: boolean;\n  appNo?: string;\n  chatProps?: ChatConfig;\n  debug?: boolean;\n  /**\n   * 是否展示点赞/点踩按钮\n   * @default true\n   */\n  showFeedback?: boolean;\n  /**\n   * 点击对话中附件卡片的回调（非图片、非音视频文件）\n   */\n  onFileClick?: (file: FileItem) => void;\n  /**\n   * 自定义文件上传函数\n   */\n  uploadRequest?: UploadRequestFn;\n}\n\n/**\n * XAdkProvider Props\n */\nexport interface XAdkProviderProps {\n  /**\n   * AI 服务基础地址\n   */\n  url?: string;\n  /**\n   * 认证 token\n   */\n  token: string;\n  /**\n   * 组件功能配置\n   */\n  config?: XAdkProviderConfig;\n  /**\n   * Provider 唯一标识\n   */\n  providerId?: string;\n  /**\n   * 消息成功回调\n   */\n  onSuccess?: (success: any) => void;\n  /**\n   * 流式消息回调\n   */\n  onStream?: (data: Event) => void;\n  /**\n   * 错误回调\n   */\n  onError?: (err: any) => void;\n  /**\n   * 每条消息回调\n   */\n  onMessage?: (content: string, data: IMessage) => void;\n  /**\n   * 事件回调\n   */\n  onEvent?: (event: handleEvent) => void;\n  /**\n   * React 子元素 - 支持 Compound Components\n   */\n  children?: ReactNode;\n}\n\n// XAiSDKProps 继承 XAdkProviderProps\nexport interface XAdkSDKProps extends XAdkProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmCO,IAAK,YAAL,kBAAKA,eAAL;AAEL,EAAAA,WAAA,oBAAiB;AAEjB,EAAAA,WAAA,oBAAiB;AAJP,SAAAA;AAAA,GAAA;",
   "names": ["EventCode"]
 }

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

@@ -132,7 +132,7 @@ export interface XAiProviderHandle {
      * @type {(id: string) => void}
      * @version 1.0.0
      */
-    setCurrentSessionDetail: (id: string) => void;
+    setCurrentSession: (id: string) => void;
 }
 export interface sessionConfig {
     /**

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/XAiProvider.ts"],
-  "sourcesContent": ["// context/ProviderContext.ts\nimport React, { ReactNode } from 'react';\nimport { AiClient } from 'src/client/base';\nimport type { ChatbotMessageFields } from './XAiChatbot';\nimport type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from '@/types';\n\n/**\n * 错误码枚举（数字格式）\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCodeNum {\n  /** 应用下架 */\n  APP_NOT_ENABLE = 'client_50017',\n  /** 应用删除 */\n  APP_DELETED = 'client_50017',\n  /** 无该应用 */\n  APP_NOT_FOUND = 'client_59999',\n  /** 接口报错 */\n  API_ERROR = 'client_50054',\n}\n\n/**\n * 错误码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCode {\n  /** 应用未启用 */\n  APP_NOT_ENABLE = 'APP_NOT_ENABLE',\n  /** 应用已删除 */\n  APP_DELETED = 'APP_DELETED',\n  /** 应用未找到 */\n  APP_NOT_FOUND = 'APP_NOT_FOUND',\n  /** API 错误 */\n  API_ERROR = 'API_ERROR',\n}\n\n/**\n * 错误码映射表\n * @type {Record<string, {code: ErrorCode, message: string}>}\n * @version 1.0.0\n */\nexport const ErrorCodeMap = {\n  client_50017: {\n    code: ErrorCode.APP_NOT_ENABLE,\n    message: '该应用已删除或已下架',\n  },\n  client_50054: {\n    code: ErrorCode.API_ERROR,\n    message: '应用服务端出错',\n  },\n};\n\n/**\n * 成功状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum SuccessCode {\n  /** 应用配置初始化成功 */\n  APP_CONFIG_INIT_SUCCESS = 'APP_CONFIG_INIT_SUCCESS',\n  /** 应用消息初始化成功 */\n  APP_MESSAGES_INIT_SUCCESS = 'APP_MESSAGES_INIT_SUCCESS',\n}\n\n/**\n * 错误信息接口\n * @interface Error\n * @version 1.0.0\n */\nexport interface Error {\n  /** 错误码 */\n  code: ErrorCode;\n  /** 错误信息 */\n  message: string;\n}\n\n/**\n * 成功信息接口\n * @interface Success\n * @version 1.0.0\n */\nexport interface Success {\n  /** 成功状态码 */\n  code: SuccessCode;\n  /** 成功信息 */\n  message: string;\n  /** 成功数据 */\n  data?: any;\n}\n\n/**\n * XAiProvider 操作句柄接口\n * @interface XAiProviderHandle\n * @version 1.0.0\n */\nexport interface XAiProviderHandle {\n  /**\n   * 发送聊天消息\n   * @param content - 消息内容\n   * @type {(content: string) => void}\n   * @version 1.0.0\n   */\n  chat: (content: SendContent) => void;\n\n  /**\n   * 停止聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  stopChat: () => void;\n\n  /**\n   * 重新发送聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  reChat: () => void;\n\n  /**\n   * 获取应用信息\n   * @returns {any} 应用信息对象\n   * @type {() => any}\n   * @version 1.0.0\n   */\n  getAppInfo: () => any;\n\n  /**\n   * 获取消息列表\n   * @returns {Messages[]} 消息数组\n   * @type {() => Messages[]}\n   * @version 1.0.0\n   */\n  getMessages: () => Messages[];\n\n  /**\n   * 获取会话列表\n   * @returns {}\n   */\n  getSessions: () => SessionData[];\n\n  /**\n   * 重新设置当前会话\n   * @param id - 会话ID\n   * @type {(id: string) => void}\n   * @version 1.0.0\n   */\n  setCurrentSessionDetail: (id: string) => void;\n}\n\nexport interface sessionConfig {\n  /**\n   * 是否展示会话列表\n   * @type {boolean}\n   * @default false\n   */\n  showSessionList?: boolean;\n}\n\n\n/**\n * XAiProvider 配置接口\n * @interface XAiProviderConfig\n * @version 1.0.0\n */\nexport interface XAiProviderConfig {\n  /**\n   * 应用唯一编号\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  appNo?: string;\n\n  /**\n   * 会话配置\n   * @type {sessionConfig}\n   */\n  session?: sessionConfig;\n\n  /**\n   * 对话框配置\n   * @type {ChatConfig}\n   */\n  chatProps?: ChatConfig;\n\n  /**\n   * 是否启用调试模式\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  debug?: boolean;\n}\n\n/**\n * XAiProvider 组件属性接口\n * @interface XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiProviderProps {\n  /**\n   * AI 服务地址\n   * @type {string}\n   * @version 1.0.0\n   */\n  url: string;\n\n  /**\n   * 认证 token\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 配置信息\n   * @type {XAiProviderConfig}\n   * @default undefined\n   * @version 1.0.0\n   */\n  config?: XAiProviderConfig;\n\n  /**\n   * Provider 唯一标识，用于区分多个 Provider 实例\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  providerId?: string;\n\n  /**\n   * Token 刷新回调\n   * @type {() => Promise<string>}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onRefreshToken?: () => Promise<string>;\n\n  /**\n   * 应用无法正常渲染回调\n   * @type {(error: Error) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * 应用正常渲染回调\n   * @type {(success: Success) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onSuccess?: (success: Success) => void;\n\n  /**\n   * 消息返回回调\n   * @type {(data: Messages) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onMessage?: (content: string, data: Messages) => void;\n\n  /**\n   * 子组件\n   * @type {ReactNode}\n   * @version 1.0.0\n   */\n  children: ReactNode;\n}\n\n/**\n * XAiSDK 组件属性接口\n * @interface XAiSDKProps\n * @extends XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiSDKProps extends XAiProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n\n/**\n * XAi 上下文类型接口\n * @interface XAiContextType\n * @extends Required<ChatbotMessageFields>\n * @version 1.0.0\n */\nexport interface XAiContextType extends Required<ChatbotMessageFields> {\n  /**\n   * AI 客户端实例\n   * @type {AiClient | null}\n   * @default null\n   * @version 1.0.0\n   */\n  client: AiClient | null;\n\n  /**\n   * 认证令牌\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 加载状态\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  loading: boolean;\n\n  /**\n   * 错误信息\n   * @type {string | null}\n   * @default null\n   * @version 1.0.0\n   */\n  error: string | null;\n}\n\n/**\n * XAi 上下文对象\n * @type {React.Context<XAiContextType | null>}\n * @version 1.0.0\n */\nexport const XAiContext = React.createContext<XAiContextType | null>(null);\n"],
+  "sourcesContent": ["// context/ProviderContext.ts\nimport React, { ReactNode } from 'react';\nimport { AiClient } from 'src/client/base';\nimport type { ChatbotMessageFields } from './XAiChatbot';\nimport type { Messages, SendContent, SessionData, ChatConfig, ThemeType } from '@/types';\n\n/**\n * 错误码枚举（数字格式）\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCodeNum {\n  /** 应用下架 */\n  APP_NOT_ENABLE = 'client_50017',\n  /** 应用删除 */\n  APP_DELETED = 'client_50017',\n  /** 无该应用 */\n  APP_NOT_FOUND = 'client_59999',\n  /** 接口报错 */\n  API_ERROR = 'client_50054',\n}\n\n/**\n * 错误码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum ErrorCode {\n  /** 应用未启用 */\n  APP_NOT_ENABLE = 'APP_NOT_ENABLE',\n  /** 应用已删除 */\n  APP_DELETED = 'APP_DELETED',\n  /** 应用未找到 */\n  APP_NOT_FOUND = 'APP_NOT_FOUND',\n  /** API 错误 */\n  API_ERROR = 'API_ERROR',\n}\n\n/**\n * 错误码映射表\n * @type {Record<string, {code: ErrorCode, message: string}>}\n * @version 1.0.0\n */\nexport const ErrorCodeMap = {\n  client_50017: {\n    code: ErrorCode.APP_NOT_ENABLE,\n    message: '该应用已删除或已下架',\n  },\n  client_50054: {\n    code: ErrorCode.API_ERROR,\n    message: '应用服务端出错',\n  },\n};\n\n/**\n * 成功状态码枚举\n * @enum {string}\n * @version 1.0.0\n */\nexport enum SuccessCode {\n  /** 应用配置初始化成功 */\n  APP_CONFIG_INIT_SUCCESS = 'APP_CONFIG_INIT_SUCCESS',\n  /** 应用消息初始化成功 */\n  APP_MESSAGES_INIT_SUCCESS = 'APP_MESSAGES_INIT_SUCCESS',\n}\n\n/**\n * 错误信息接口\n * @interface Error\n * @version 1.0.0\n */\nexport interface Error {\n  /** 错误码 */\n  code: ErrorCode;\n  /** 错误信息 */\n  message: string;\n}\n\n/**\n * 成功信息接口\n * @interface Success\n * @version 1.0.0\n */\nexport interface Success {\n  /** 成功状态码 */\n  code: SuccessCode;\n  /** 成功信息 */\n  message: string;\n  /** 成功数据 */\n  data?: any;\n}\n\n/**\n * XAiProvider 操作句柄接口\n * @interface XAiProviderHandle\n * @version 1.0.0\n */\nexport interface XAiProviderHandle {\n  /**\n   * 发送聊天消息\n   * @param content - 消息内容\n   * @type {(content: string) => void}\n   * @version 1.0.0\n   */\n  chat: (content: SendContent) => void;\n\n  /**\n   * 停止聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  stopChat: () => void;\n\n  /**\n   * 重新发送聊天\n   * @type {() => void}\n   * @version 1.0.0\n   */\n  reChat: () => void;\n\n  /**\n   * 获取应用信息\n   * @returns {any} 应用信息对象\n   * @type {() => any}\n   * @version 1.0.0\n   */\n  getAppInfo: () => any;\n\n  /**\n   * 获取消息列表\n   * @returns {Messages[]} 消息数组\n   * @type {() => Messages[]}\n   * @version 1.0.0\n   */\n  getMessages: () => Messages[];\n\n  /**\n   * 获取会话列表\n   * @returns {}\n   */\n  getSessions: () => SessionData[];\n\n  /**\n   * 重新设置当前会话\n   * @param id - 会话ID\n   * @type {(id: string) => void}\n   * @version 1.0.0\n   */\n  setCurrentSession: (id: string) => void;\n}\n\nexport interface sessionConfig {\n  /**\n   * 是否展示会话列表\n   * @type {boolean}\n   * @default false\n   */\n  showSessionList?: boolean;\n}\n\n\n/**\n * XAiProvider 配置接口\n * @interface XAiProviderConfig\n * @version 1.0.0\n */\nexport interface XAiProviderConfig {\n  /**\n   * 应用唯一编号\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  appNo?: string;\n\n  /**\n   * 会话配置\n   * @type {sessionConfig}\n   */\n  session?: sessionConfig;\n\n  /**\n   * 对话框配置\n   * @type {ChatConfig}\n   */\n  chatProps?: ChatConfig;\n\n  /**\n   * 是否启用调试模式\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  debug?: boolean;\n}\n\n/**\n * XAiProvider 组件属性接口\n * @interface XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiProviderProps {\n  /**\n   * AI 服务地址\n   * @type {string}\n   * @version 1.0.0\n   */\n  url: string;\n\n  /**\n   * 认证 token\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 配置信息\n   * @type {XAiProviderConfig}\n   * @default undefined\n   * @version 1.0.0\n   */\n  config?: XAiProviderConfig;\n\n  /**\n   * Provider 唯一标识，用于区分多个 Provider 实例\n   * @type {string}\n   * @default undefined\n   * @version 1.0.0\n   */\n  providerId?: string;\n\n  /**\n   * Token 刷新回调\n   * @type {() => Promise<string>}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onRefreshToken?: () => Promise<string>;\n\n  /**\n   * 应用无法正常渲染回调\n   * @type {(error: Error) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * 应用正常渲染回调\n   * @type {(success: Success) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onSuccess?: (success: Success) => void;\n\n  /**\n   * 消息返回回调\n   * @type {(data: Messages) => void}\n   * @default undefined\n   * @version 1.0.0\n   */\n  onMessage?: (content: string, data: Messages) => void;\n\n  /**\n   * 子组件\n   * @type {ReactNode}\n   * @version 1.0.0\n   */\n  children: ReactNode;\n}\n\n/**\n * XAiSDK 组件属性接口\n * @interface XAiSDKProps\n * @extends XAiProviderProps\n * @version 1.0.0\n */\nexport interface XAiSDKProps extends XAiProviderProps {\n  /**\n   * 主题类型\n   * @type {ThemeType}\n   * @default 'default'\n   * @version 1.0.0\n   */\n  theme?: ThemeType;\n\n  /**\n   * 组件属性配置\n   * @type {object}\n   * @default undefined\n   * @version 1.0.0\n   */\n  componentProps?: {\n    /**\n     * 组件ID\n     * @type {string}\n     * @default undefined\n     * @version 1.0.0\n     */\n    id?: string;\n    /** 支持任意 CSS 属性 */\n    [key: string]: any;\n  };\n}\n\n/**\n * XAi 上下文类型接口\n * @interface XAiContextType\n * @extends Required<ChatbotMessageFields>\n * @version 1.0.0\n */\nexport interface XAiContextType extends Required<ChatbotMessageFields> {\n  /**\n   * AI 客户端实例\n   * @type {AiClient | null}\n   * @default null\n   * @version 1.0.0\n   */\n  client: AiClient | null;\n\n  /**\n   * 认证令牌\n   * @type {string}\n   * @version 1.0.0\n   */\n  token: string;\n\n  /**\n   * 加载状态\n   * @type {boolean}\n   * @default false\n   * @version 1.0.0\n   */\n  loading: boolean;\n\n  /**\n   * 错误信息\n   * @type {string | null}\n   * @default null\n   * @version 1.0.0\n   */\n  error: string | null;\n}\n\n/**\n * XAi 上下文对象\n * @type {React.Context<XAiContextType | null>}\n * @version 1.0.0\n */\nexport const XAiContext = React.createContext<XAiContextType | null>(null);\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAiC;AAU1B,IAAK,eAAL,kBAAKA,kBAAL;AAEL,EAAAA,cAAA,oBAAiB;AAEjB,EAAAA,cAAA,iBAAc;AAEd,EAAAA,cAAA,mBAAgB;AAEhB,EAAAA,cAAA,eAAY;AARF,SAAAA;AAAA,GAAA;AAgBL,IAAK,YAAL,kBAAKC,eAAL;AAEL,EAAAA,WAAA,oBAAiB;AAEjB,EAAAA,WAAA,iBAAc;AAEd,EAAAA,WAAA,mBAAgB;AAEhB,EAAAA,WAAA,eAAY;AARF,SAAAA;AAAA,GAAA;AAgBL,IAAM,eAAe;AAAA,EAC1B,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AAAA,EACA,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AACF;AAOO,IAAK,cAAL,kBAAKC,iBAAL;AAEL,EAAAA,aAAA,6BAA0B;AAE1B,EAAAA,aAAA,+BAA4B;AAJlB,SAAAA;AAAA,GAAA;AAmSL,IAAM,aAAa,aAAAC,QAAM,cAAqC,IAAI;",
   "names": ["ErrorCodeNum", "ErrorCode", "SuccessCode", "React"]
 }

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

@@ -70,7 +70,7 @@ declare class XAiWebSDK {
      */
     static create(props: XAdkSDKProps): XAiWebSDK;
     /**
-     * 获取当前数据
+     * 获取当前数据（聚合方法）
      * @returns 应用信息、消息列表、会话列表
      */
     getData(): {
@@ -78,24 +78,53 @@ declare class XAiWebSDK {
         messages: IMessage[] | undefined;
         sessions: any[] | undefined;
     };
+    /**
+     * 获取应用信息
+     * @returns 应用信息
+     */
+    getAppInfo(): any;
+    /**
+     * 获取当前会话的消息列表
+     * @returns 消息列表
+     */
+    getMessages(): IMessage[] | undefined;
+    /**
+     * 获取会话列表
+     * @returns 会话列表
+     */
+    getSessions(): any[] | undefined;
+    /**
+     * 设置消息列表
+     * @param msgs - 要设置的消息数组
+     */
+    setMessages(msgs: IMessage[]): void;
     /**
      * 发送消息
      * @param content - 消息内容
      *
      * @example
      * ```javascript
-     * sdk.chat({ text: 'Hello!' });
+     * sdk.startChat({ text: 'Hello!' });
      * ```
      */
-    chat(content: SendContent): void;
+    startChat(content: SendContent): void;
     /**
      * 停止当前消息生成
      */
-    stop(): void;
+    stopChat(): void;
+    /**
+     * 重新生成最后一条回复
+     */
+    reChat(): void;
     /**
      * 清空当前会话
      */
-    clear(): void;
+    clearChat(): void;
+    /**
+     * 切换到指定会话
+     * @param sessionId - 会话 ID
+     */
+    setCurrentSession(sessionId: string): void;
     /**
      * 删除指定会话
      * @param sessionId - 会话 ID
@@ -108,9 +137,10 @@ declare class XAiWebSDK {
      */
     updateSession(sessionId: string, title: string): void;
     /**
-     * 切换到指定会话
-     * @param sessionId - 会话 ID
+     * 设置自定义业务参数 (stateDelta)
+     * 设置后每次发送消息时会自动携带至后端
+     * @param delta - 自定义参数，传入 undefined 可清除
      */
-    switchSession(sessionId: string): void;
+    setStateDelta(delta: Record<string, any> | undefined): void;
 }
 export default XAiWebSDK;

package/dist/cjs/utils/umdEntry.js

@@ -149,7 +149,7 @@ var XAiWebSDK = class {
   }
   // ————对外暴露的方法————
   /**
-   * 获取当前数据
+   * 获取当前数据（聚合方法）
    * @returns 应用信息、消息列表、会话列表
    */
   getData() {
@@ -160,33 +160,80 @@ var XAiWebSDK = class {
       sessions: (_c = this.providerRef.current) == null ? void 0 : _c.getSessions()
     };
   }
+  /**
+   * 获取应用信息
+   * @returns 应用信息
+   */
+  getAppInfo() {
+    var _a;
+    return (_a = this.providerRef.current) == null ? void 0 : _a.getAppInfo();
+  }
+  /**
+   * 获取当前会话的消息列表
+   * @returns 消息列表
+   */
+  getMessages() {
+    var _a;
+    return (_a = this.providerRef.current) == null ? void 0 : _a.getMessages();
+  }
+  /**
+   * 获取会话列表
+   * @returns 会话列表
+   */
+  getSessions() {
+    var _a;
+    return (_a = this.providerRef.current) == null ? void 0 : _a.getSessions();
+  }
+  /**
+   * 设置消息列表
+   * @param msgs - 要设置的消息数组
+   */
+  setMessages(msgs) {
+    var _a;
+    (_a = this.providerRef.current) == null ? void 0 : _a.setMessages(msgs);
+  }
   /**
    * 发送消息
    * @param content - 消息内容
    *
    * @example
    * ```javascript
-   * sdk.chat({ text: 'Hello!' });
+   * sdk.startChat({ text: 'Hello!' });
    * ```
    */
-  chat(content) {
+  startChat(content) {
     var _a;
     (_a = this.providerRef.current) == null ? void 0 : _a.startChat(content);
   }
   /**
    * 停止当前消息生成
    */
-  stop() {
+  stopChat() {
     var _a;
     (_a = this.providerRef.current) == null ? void 0 : _a.stopChat();
   }
+  /**
+   * 重新生成最后一条回复
+   */
+  reChat() {
+    var _a;
+    (_a = this.providerRef.current) == null ? void 0 : _a.reChat();
+  }
   /**
    * 清空当前会话
    */
-  clear() {
+  clearChat() {
     var _a;
     (_a = this.providerRef.current) == null ? void 0 : _a.clearChat();
   }
+  /**
+   * 切换到指定会话
+   * @param sessionId - 会话 ID
+   */
+  setCurrentSession(sessionId) {
+    var _a;
+    (_a = this.providerRef.current) == null ? void 0 : _a.setCurrentSession(sessionId);
+  }
   /**
    * 删除指定会话
    * @param sessionId - 会话 ID
@@ -205,12 +252,13 @@ var XAiWebSDK = class {
     (_a = this.providerRef.current) == null ? void 0 : _a.updateSession(sessionId, title);
   }
   /**
-   * 切换到指定会话
-   * @param sessionId - 会话 ID
+   * 设置自定义业务参数 (stateDelta)
+   * 设置后每次发送消息时会自动携带至后端
+   * @param delta - 自定义参数，传入 undefined 可清除
    */
-  switchSession(sessionId) {
+  setStateDelta(delta) {
     var _a;
-    (_a = this.providerRef.current) == null ? void 0 : _a.setCurrentSessionDetail(sessionId);
+    (_a = this.providerRef.current) == null ? void 0 : _a.setStateDelta(delta);
   }
 };
 window.XAiWebSDK = XAiWebSDK;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/utils/umdEntry.tsx"],
-  "sourcesContent": ["import { createRef } from \"react\";\nimport ReactDOM from \"react-dom/client\";\nimport { XAdkSDKProps, XAdkProviderHandle, IMessage } from \"@/types\";\nimport XAdkProvider from \"@/components/XAdkProvider\";\nimport { SendContent } from \"@/types\";\n\n/**\n * XAiWebSDK - UMD 入口类\n *\n * 用于通过 <script> 标签引入 SDK 的场景\n *\n * @example\n * ```html\n * <script src=\"chat-sdk.min.js\"></script>\n * <script>\n *   const sdk = XAiWebSDK.initChatbot({\n *     url: 'https://api.example.com',\n *     token: 'your-token',\n *     config: {\n *       appNo: 'your-app-no',\n *       session: {\n *         showSessionList: true\n *       }\n *     }\n *   });\n * </script>\n * ```\n */\nclass XAiWebSDK {\n  container: HTMLElement;\n\n  props: XAdkSDKProps;\n\n  root: any;\n\n  providerRef = createRef<XAdkProviderHandle>();\n\n  // ———— hook ————\n  onError?: (error: any) => void;\n\n  onSuccess?: (appInfo: any) => void;\n\n  onMessage?: (content: string, data: IMessage) => void;\n\n  constructor(container: HTMLElement, props: XAdkSDKProps) {\n    this.container = container;\n    this.props = props;\n    this.onError = props.onError;\n    this.onSuccess = props.onSuccess;\n    this.onMessage = props.onMessage;\n    this.mount();\n  }\n\n  mount() {\n    // 提取配置\n    const { config = {} } = this.props;\n    const showSessionList = config.session?.showSessionList ?? false;\n    const allowUpload = config.allowUpload ?? false;\n    const clearBtnShow = config.chatProps?.clearBtnShow ?? true;\n\n    if (ReactDOM.createRoot) {\n      this.root = ReactDOM.createRoot(this.container);\n      this.root.render(\n        <div style={{ width: \"100%\", height: \"100%\" }}>\n          <XAdkProvider ref={this.providerRef} {...this.props}>\n            {/* 使用 DefaultLayout 作为默认布局 */}\n            <XAdkProvider.DefaultLayout\n              showSessionList={showSessionList}\n              allowUpload={allowUpload}\n              clearBtnShow={clearBtnShow}\n              showFnCallDetail={true}\n            />\n          </XAdkProvider>\n        </div>,\n      );\n    } else {\n      // 兼容 React 17\n      // @ts-ignore\n      ReactDOM.render(\n        <div style={{ width: \"100%\", height: \"100%\" }}>\n          <XAdkProvider ref={this.providerRef} {...this.props}>\n            <XAdkProvider.DefaultLayout\n              showSessionList={showSessionList}\n              allowUpload={allowUpload}\n              clearBtnShow={clearBtnShow}\n              showFnCallDetail={true}\n            />\n          </XAdkProvider>\n        </div>,\n        this.container,\n      );\n    }\n  }\n\n  unmount() {\n    if (this.root && this.root.unmount) {\n      this.root.unmount();\n    }\n  }\n\n  /**\n   * 初始化聊天机器人(推荐方式)\n   *\n   * @param props - SDK 配置参数\n   * @returns XAiWebSDK 实例\n   *\n   * @example\n   * ```javascript\n   * const sdk = XAiWebSDK.initChatbot({\n   *   url: 'https://api.example.com',\n   *   token: 'your-token',\n   *   config: {\n   *     appNo: 'your-app-no',\n   *     session: {\n   *       showSessionList: true  // 显示会话列表\n   *     },\n   *     allowUpload: true,       // 允许文件上传\n   *     chatProps: {\n   *       clearBtnShow: false    // 隐藏清空按钮\n   *     }\n   *   },\n   *   componentProps: {\n   *     id: 'my-chatbot',        // 容器 ID\n   *     width: '100%',\n   *     height: '600px'\n   *   }\n   * });\n   * ```\n   */\n  static initChatbot(props: XAdkSDKProps): XAiWebSDK {\n    let container: HTMLElement;\n\n    // 检查是否有指定的 componentProps.id\n    if (props.componentProps?.id) {\n      const existingContainer = document.getElementById(\n        props.componentProps.id,\n      );\n      if (existingContainer) {\n        container = existingContainer;\n      } else {\n        // 如果指定的 ID 不存在，创建新元素\n        container = document.createElement(\"div\");\n        container.id = props.componentProps.id;\n      }\n    } else {\n      // 没有指定 ID，创建默认容器\n      container = document.createElement(\"div\");\n      container.id = \"xai-chatbot-container\";\n    }\n\n    // 设置容器样式 - 将除了 id 以外的所有属性都应用到容器\n    if (props.componentProps) {\n      const { id, ...styleProps } = props.componentProps;\n      Object.assign(container.style, styleProps);\n    }\n\n    // 如果容器不在 DOM 中，添加到 body\n    if (!container.parentNode) {\n      document.body.appendChild(container);\n    }\n\n    return new XAiWebSDK(container, props);\n  }\n\n  /**\n   * 兼容旧版本的静态方法\n   * @deprecated 使用 initChatbot 替代\n   */\n  static create(props: XAdkSDKProps): XAiWebSDK {\n    return this.initChatbot(props);\n  }\n\n  // ————对外暴露的方法————\n\n  /**\n   * 获取当前数据\n   * @returns 应用信息、消息列表、会话列表\n   */\n  getData() {\n    return {\n      appInfo: this.providerRef.current?.getAppInfo(),\n      messages: this.providerRef.current?.getMessages(),\n      sessions: this.providerRef.current?.getSessions(),\n    };\n  }\n\n  /**\n   * 发送消息\n   * @param content - 消息内容\n   *\n   * @example\n   * ```javascript\n   * sdk.chat({ text: 'Hello!' });\n   * ```\n   */\n  chat(content: SendContent) {\n    this.providerRef.current?.startChat(content);\n  }\n\n  /**\n   * 停止当前消息生成\n   */\n  stop() {\n    this.providerRef.current?.stopChat();\n  }\n\n  /**\n   * 清空当前会话\n   */\n  clear() {\n    this.providerRef.current?.clearChat();\n  }\n\n  /**\n   * 删除指定会话\n   * @param sessionId - 会话 ID\n   */\n  deleteSession(sessionId: string) {\n    this.providerRef.current?.deleteSession(sessionId);\n  }\n\n  /**\n   * 更新会话标题\n   * @param sessionId - 会话 ID\n   * @param title - 新标题\n   */\n  updateSession(sessionId: string, title: string) {\n    this.providerRef.current?.updateSession(sessionId, title);\n  }\n\n  /**\n   * 切换到指定会话\n   * @param sessionId - 会话 ID\n   */\n  switchSession(sessionId: string) {\n    this.providerRef.current?.setCurrentSessionDetail(sessionId);\n  }\n}\n\n// 兼容 window 方式，也支持 new\n// @ts-ignore\nwindow.XAiWebSDK = XAiWebSDK;\n\n// 支持 ESModule/UMD 直接 import\nexport default XAiWebSDK;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { createRef } from \"react\";\nimport ReactDOM from \"react-dom/client\";\nimport { XAdkSDKProps, XAdkProviderHandle, IMessage } from \"@/types\";\nimport XAdkProvider from \"@/components/XAdkProvider\";\nimport { SendContent } from \"@/types\";\n\n/**\n * XAiWebSDK - UMD 入口类\n *\n * 用于通过 <script> 标签引入 SDK 的场景\n *\n * @example\n * ```html\n * <script src=\"chat-sdk.min.js\"></script>\n * <script>\n *   const sdk = XAiWebSDK.initChatbot({\n *     url: 'https://api.example.com',\n *     token: 'your-token',\n *     config: {\n *       appNo: 'your-app-no',\n *       session: {\n *         showSessionList: true\n *       }\n *     }\n *   });\n * </script>\n * ```\n */\nclass XAiWebSDK {\n  container: HTMLElement;\n\n  props: XAdkSDKProps;\n\n  root: any;\n\n  providerRef = createRef<XAdkProviderHandle>();\n\n  // ———— hook ————\n  onError?: (error: any) => void;\n\n  onSuccess?: (appInfo: any) => void;\n\n  onMessage?: (content: string, data: IMessage) => void;\n\n  constructor(container: HTMLElement, props: XAdkSDKProps) {\n    this.container = container;\n    this.props = props;\n    this.onError = props.onError;\n    this.onSuccess = props.onSuccess;\n    this.onMessage = props.onMessage;\n    this.mount();\n  }\n\n  mount() {\n    // 提取配置\n    const { config = {} } = this.props;\n    const showSessionList = config.session?.showSessionList ?? false;\n    const allowUpload = config.allowUpload ?? false;\n    const clearBtnShow = config.chatProps?.clearBtnShow ?? true;\n\n    if (ReactDOM.createRoot) {\n      this.root = ReactDOM.createRoot(this.container);\n      this.root.render(\n        <div style={{ width: \"100%\", height: \"100%\" }}>\n          <XAdkProvider ref={this.providerRef} {...this.props}>\n            {/* 使用 DefaultLayout 作为默认布局 */}\n            <XAdkProvider.DefaultLayout\n              showSessionList={showSessionList}\n              allowUpload={allowUpload}\n              clearBtnShow={clearBtnShow}\n              showFnCallDetail={true}\n            />\n          </XAdkProvider>\n        </div>,\n      );\n    } else {\n      // 兼容 React 17\n      // @ts-ignore\n      ReactDOM.render(\n        <div style={{ width: \"100%\", height: \"100%\" }}>\n          <XAdkProvider ref={this.providerRef} {...this.props}>\n            <XAdkProvider.DefaultLayout\n              showSessionList={showSessionList}\n              allowUpload={allowUpload}\n              clearBtnShow={clearBtnShow}\n              showFnCallDetail={true}\n            />\n          </XAdkProvider>\n        </div>,\n        this.container,\n      );\n    }\n  }\n\n  unmount() {\n    if (this.root && this.root.unmount) {\n      this.root.unmount();\n    }\n  }\n\n  /**\n   * 初始化聊天机器人(推荐方式)\n   *\n   * @param props - SDK 配置参数\n   * @returns XAiWebSDK 实例\n   *\n   * @example\n   * ```javascript\n   * const sdk = XAiWebSDK.initChatbot({\n   *   url: 'https://api.example.com',\n   *   token: 'your-token',\n   *   config: {\n   *     appNo: 'your-app-no',\n   *     session: {\n   *       showSessionList: true  // 显示会话列表\n   *     },\n   *     allowUpload: true,       // 允许文件上传\n   *     chatProps: {\n   *       clearBtnShow: false    // 隐藏清空按钮\n   *     }\n   *   },\n   *   componentProps: {\n   *     id: 'my-chatbot',        // 容器 ID\n   *     width: '100%',\n   *     height: '600px'\n   *   }\n   * });\n   * ```\n   */\n  static initChatbot(props: XAdkSDKProps): XAiWebSDK {\n    let container: HTMLElement;\n\n    // 检查是否有指定的 componentProps.id\n    if (props.componentProps?.id) {\n      const existingContainer = document.getElementById(\n        props.componentProps.id,\n      );\n      if (existingContainer) {\n        container = existingContainer;\n      } else {\n        // 如果指定的 ID 不存在，创建新元素\n        container = document.createElement(\"div\");\n        container.id = props.componentProps.id;\n      }\n    } else {\n      // 没有指定 ID，创建默认容器\n      container = document.createElement(\"div\");\n      container.id = \"xai-chatbot-container\";\n    }\n\n    // 设置容器样式 - 将除了 id 以外的所有属性都应用到容器\n    if (props.componentProps) {\n      const { id, ...styleProps } = props.componentProps;\n      Object.assign(container.style, styleProps);\n    }\n\n    // 如果容器不在 DOM 中，添加到 body\n    if (!container.parentNode) {\n      document.body.appendChild(container);\n    }\n\n    return new XAiWebSDK(container, props);\n  }\n\n  /**\n   * 兼容旧版本的静态方法\n   * @deprecated 使用 initChatbot 替代\n   */\n  static create(props: XAdkSDKProps): XAiWebSDK {\n    return this.initChatbot(props);\n  }\n\n  // ————对外暴露的方法————\n\n  /**\n   * 获取当前数据（聚合方法）\n   * @returns 应用信息、消息列表、会话列表\n   */\n  getData() {\n    return {\n      appInfo: this.providerRef.current?.getAppInfo(),\n      messages: this.providerRef.current?.getMessages(),\n      sessions: this.providerRef.current?.getSessions(),\n    };\n  }\n\n  /**\n   * 获取应用信息\n   * @returns 应用信息\n   */\n  getAppInfo() {\n    return this.providerRef.current?.getAppInfo();\n  }\n\n  /**\n   * 获取当前会话的消息列表\n   * @returns 消息列表\n   */\n  getMessages() {\n    return this.providerRef.current?.getMessages();\n  }\n\n  /**\n   * 获取会话列表\n   * @returns 会话列表\n   */\n  getSessions() {\n    return this.providerRef.current?.getSessions();\n  }\n\n  /**\n   * 设置消息列表\n   * @param msgs - 要设置的消息数组\n   */\n  setMessages(msgs: IMessage[]) {\n    this.providerRef.current?.setMessages(msgs);\n  }\n\n  /**\n   * 发送消息\n   * @param content - 消息内容\n   *\n   * @example\n   * ```javascript\n   * sdk.startChat({ text: 'Hello!' });\n   * ```\n   */\n  startChat(content: SendContent) {\n    this.providerRef.current?.startChat(content);\n  }\n\n  /**\n   * 停止当前消息生成\n   */\n  stopChat() {\n    this.providerRef.current?.stopChat();\n  }\n\n  /**\n   * 重新生成最后一条回复\n   */\n  reChat() {\n    this.providerRef.current?.reChat();\n  }\n\n  /**\n   * 清空当前会话\n   */\n  clearChat() {\n    this.providerRef.current?.clearChat();\n  }\n\n  /**\n   * 切换到指定会话\n   * @param sessionId - 会话 ID\n   */\n  setCurrentSession(sessionId: string) {\n    this.providerRef.current?.setCurrentSession(sessionId);\n  }\n\n  /**\n   * 删除指定会话\n   * @param sessionId - 会话 ID\n   */\n  deleteSession(sessionId: string) {\n    this.providerRef.current?.deleteSession(sessionId);\n  }\n\n  /**\n   * 更新会话标题\n   * @param sessionId - 会话 ID\n   * @param title - 新标题\n   */\n  updateSession(sessionId: string, title: string) {\n    this.providerRef.current?.updateSession(sessionId, title);\n  }\n\n  /**\n   * 设置自定义业务参数 (stateDelta)\n   * 设置后每次发送消息时会自动携带至后端\n   * @param delta - 自定义参数，传入 undefined 可清除\n   */\n  setStateDelta(delta: Record<string, any> | undefined) {\n    this.providerRef.current?.setStateDelta(delta);\n  }\n}\n\n// 兼容 window 方式，也支持 new\n// @ts-ignore\nwindow.XAiWebSDK = XAiWebSDK;\n\n// 支持 ESModule/UMD 直接 import\nexport default XAiWebSDK;\n"],
+  "mappings": "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",
   "names": ["ReactDOM", "XAdkProvider"]
 }

package/dist/esm/components/XAdkProvider/compound/Sidebar.js

@@ -35,12 +35,12 @@ var Sidebar = function Sidebar(_ref) {
     sessionList = _useSession.sessionList,
     deleteSession = _useSession.deleteSession,
     updateSession = _useSession.updateSession,
-    setCurrentSessionDetail = _useSession.setCurrentSessionDetail;
+    setCurrentSession = _useSession.setCurrentSession;
 
   // 切换会话
   var handleActiveChange = useCallback(function (key) {
-    setCurrentSessionDetail(key);
-  }, [setCurrentSessionDetail]);
+    setCurrentSession(key);
+  }, [setCurrentSession]);
 
   // 新建对话
   var handleNewChat = useCallback(function () {

package/dist/esm/components/XAdkProvider/compound/Sidebar.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useCallback","message","Modal","Input","ExclamationCircleFilled","XAiConversations","useChatState","useChatActions","useSession","jsx","_jsx","confirm","Sidebar","_ref","_ref$isNarrow","isNarrow","style","className","_useChatState","currentSessionId","_useChatActions","clearChat","_useSession","sessionList","deleteSession","updateSession","setCurrentSessionDetail","handleActiveChange","key","handleNewChat","defaultMenuConfig","conversation","items","label","danger","onClick","menuInfo","domEvent","stopPropagation","inputValue","title","icon","content","defaultValue","autoFocus","width","onChange","e","target","value","okText","cancelText","okButtonProps","background","borderColor","color","onOk","trim","error","Promise","reject","onCancel","okType","activeKey","onActiveChange","onNewChat","menu","displayName"],"sources":["../../../../../src/components/XAdkProvider/compound/Sidebar.tsx"],"sourcesContent":["import React, { useCallback } from 'react';\nimport { message, Modal, Input } from 'antd';\nimport { ExclamationCircleFilled } from '@ant-design/icons';\nimport type { ConversationsProps } from '@ant-design/x';\nimport XAiConversations from '@/components/XAiConversations';\nimport { useChatState } from '../context/ChatStateContext';\nimport { useChatActions } from '../context/ChatActionContext';\nimport { useSession } from '../context/SessionContext';\n\nconst { confirm } = Modal;\n\n/**\n * XAdkProvider.Sidebar - 会话列表侧边栏组件\n *\n * 从 Context 获取会话数据并提供会话管理界面\n * 基于 XAiConversations 组件实现(带展开/收起功能)\n *\n * @example\n * ```tsx\n * <XAdkProvider url=\"...\" token=\"...\">\n *   <XAdkProvider.Sidebar isNarrow={false} />\n * </XAdkProvider>\n * ```\n */\nexport interface XAdkSidebarProps {\n  /** 额外的样式 */\n  style?: React.CSSProperties;\n  /** 额外的类名 */\n  className?: string;\n  /** 是否为窄屏模式 */\n  isNarrow?: boolean;\n}\n\nconst Sidebar: React.FC<XAdkSidebarProps> = ({\n  isNarrow = false,\n  style,\n  className,\n}) => {\n  const { currentSessionId } = useChatState();\n  const { clearChat } = useChatActions();\n  const { sessionList, deleteSession, updateSession, setCurrentSessionDetail } = useSession();\n\n  // 切换会话\n  const handleActiveChange = useCallback((key: string) => {\n    setCurrentSessionDetail(key);\n  }, [setCurrentSessionDetail]);\n\n  // 新建对话\n  const handleNewChat = useCallback(() => {\n    clearChat();\n  }, [clearChat]);\n\n  // 默认会话菜单配置\n  const defaultMenuConfig: ConversationsProps['menu'] = useCallback((conversation: any) => ({\n    items: [\n      {\n        label: '重命名',\n        key: 'edit',\n      },\n      {\n        label: '删除',\n        key: 'delete',\n        danger: true,\n      },\n    ],\n    onClick: (menuInfo: any) => {\n      menuInfo.domEvent.stopPropagation();\n      const { key } = menuInfo;\n      switch (key) {\n        case 'edit': {\n          let inputValue = (conversation.label as string) || '';\n          confirm({\n            title: '编辑对话名称',\n            icon: null,\n            content: (\n              <Input\n                defaultValue={inputValue}\n                autoFocus\n                style={{ width: '100%' }}\n                onChange={(e) => {\n                  inputValue = e.target.value;\n                }}\n              />\n            ),\n            okText: '确认',\n            cancelText: '取消',\n            okButtonProps: {\n              style: {\n                background: '#000',\n                borderColor: '#000',\n                color: '#fff',\n              },\n            },\n            onOk: () => {\n              if (!inputValue.trim()) {\n                message.error('对话名称不能为空');\n                return Promise.reject();\n              }\n              updateSession(conversation.key, inputValue);\n            },\n            onCancel: () => {\n              // 静默处理\n            },\n          });\n          break;\n        }\n        case 'delete':\n          confirm({\n            title: '确认删除?',\n            icon: <ExclamationCircleFilled />,\n            content: '该对话内容将被删除无法恢复。',\n            okText: '确认删除',\n            okType: 'danger',\n            cancelText: '取消',\n            okButtonProps: {\n              style: {\n                background: '#ff4d4f',\n                borderColor: '#ff4d4f',\n                color: '#fff',\n              },\n            },\n            onOk() {\n              deleteSession(conversation.key);\n            },\n            onCancel() {\n              //\n            },\n          });\n          break;\n      }\n    },\n  }), [deleteSession, updateSession]);\n\n  return (\n    <XAiConversations\n      isNarrow={isNarrow}\n      sessionList={sessionList}\n      activeKey={currentSessionId}\n      onActiveChange={handleActiveChange}\n      onNewChat={handleNewChat}\n      menu={defaultMenuConfig}\n      style={style}\n    />\n  );\n};\n\nSidebar.displayName = 'XAdkProvider.Sidebar';\n\nexport default Sidebar;\n"],"mappings":"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"}
+{"version":3,"names":["React","useCallback","message","Modal","Input","ExclamationCircleFilled","XAiConversations","useChatState","useChatActions","useSession","jsx","_jsx","confirm","Sidebar","_ref","_ref$isNarrow","isNarrow","style","className","_useChatState","currentSessionId","_useChatActions","clearChat","_useSession","sessionList","deleteSession","updateSession","setCurrentSession","handleActiveChange","key","handleNewChat","defaultMenuConfig","conversation","items","label","danger","onClick","menuInfo","domEvent","stopPropagation","inputValue","title","icon","content","defaultValue","autoFocus","width","onChange","e","target","value","okText","cancelText","okButtonProps","background","borderColor","color","onOk","trim","error","Promise","reject","onCancel","okType","activeKey","onActiveChange","onNewChat","menu","displayName"],"sources":["../../../../../src/components/XAdkProvider/compound/Sidebar.tsx"],"sourcesContent":["import React, { useCallback } from 'react';\nimport { message, Modal, Input } from 'antd';\nimport { ExclamationCircleFilled } from '@ant-design/icons';\nimport type { ConversationsProps } from '@ant-design/x';\nimport XAiConversations from '@/components/XAiConversations';\nimport { useChatState } from '../context/ChatStateContext';\nimport { useChatActions } from '../context/ChatActionContext';\nimport { useSession } from '../context/SessionContext';\n\nconst { confirm } = Modal;\n\n/**\n * XAdkProvider.Sidebar - 会话列表侧边栏组件\n *\n * 从 Context 获取会话数据并提供会话管理界面\n * 基于 XAiConversations 组件实现(带展开/收起功能)\n *\n * @example\n * ```tsx\n * <XAdkProvider url=\"...\" token=\"...\">\n *   <XAdkProvider.Sidebar isNarrow={false} />\n * </XAdkProvider>\n * ```\n */\nexport interface XAdkSidebarProps {\n  /** 额外的样式 */\n  style?: React.CSSProperties;\n  /** 额外的类名 */\n  className?: string;\n  /** 是否为窄屏模式 */\n  isNarrow?: boolean;\n}\n\nconst Sidebar: React.FC<XAdkSidebarProps> = ({\n  isNarrow = false,\n  style,\n  className,\n}) => {\n  const { currentSessionId } = useChatState();\n  const { clearChat } = useChatActions();\n  const { sessionList, deleteSession, updateSession, setCurrentSession } = useSession();\n\n  // 切换会话\n  const handleActiveChange = useCallback((key: string) => {\n    setCurrentSession(key);\n  }, [setCurrentSession]);\n\n  // 新建对话\n  const handleNewChat = useCallback(() => {\n    clearChat();\n  }, [clearChat]);\n\n  // 默认会话菜单配置\n  const defaultMenuConfig: ConversationsProps['menu'] = useCallback((conversation: any) => ({\n    items: [\n      {\n        label: '重命名',\n        key: 'edit',\n      },\n      {\n        label: '删除',\n        key: 'delete',\n        danger: true,\n      },\n    ],\n    onClick: (menuInfo: any) => {\n      menuInfo.domEvent.stopPropagation();\n      const { key } = menuInfo;\n      switch (key) {\n        case 'edit': {\n          let inputValue = (conversation.label as string) || '';\n          confirm({\n            title: '编辑对话名称',\n            icon: null,\n            content: (\n              <Input\n                defaultValue={inputValue}\n                autoFocus\n                style={{ width: '100%' }}\n                onChange={(e) => {\n                  inputValue = e.target.value;\n                }}\n              />\n            ),\n            okText: '确认',\n            cancelText: '取消',\n            okButtonProps: {\n              style: {\n                background: '#000',\n                borderColor: '#000',\n                color: '#fff',\n              },\n            },\n            onOk: () => {\n              if (!inputValue.trim()) {\n                message.error('对话名称不能为空');\n                return Promise.reject();\n              }\n              updateSession(conversation.key, inputValue);\n            },\n            onCancel: () => {\n              // 静默处理\n            },\n          });\n          break;\n        }\n        case 'delete':\n          confirm({\n            title: '确认删除?',\n            icon: <ExclamationCircleFilled />,\n            content: '该对话内容将被删除无法恢复。',\n            okText: '确认删除',\n            okType: 'danger',\n            cancelText: '取消',\n            okButtonProps: {\n              style: {\n                background: '#ff4d4f',\n                borderColor: '#ff4d4f',\n                color: '#fff',\n              },\n            },\n            onOk() {\n              deleteSession(conversation.key);\n            },\n            onCancel() {\n              //\n            },\n          });\n          break;\n      }\n    },\n  }), [deleteSession, updateSession]);\n\n  return (\n    <XAiConversations\n      isNarrow={isNarrow}\n      sessionList={sessionList}\n      activeKey={currentSessionId}\n      onActiveChange={handleActiveChange}\n      onNewChat={handleNewChat}\n      menu={defaultMenuConfig}\n      style={style}\n    />\n  );\n};\n\nSidebar.displayName = 'XAdkProvider.Sidebar';\n\nexport default Sidebar;\n"],"mappings":"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"}

package/dist/esm/components/XAdkProvider/context/ChatActionContext.d.ts

@@ -25,6 +25,12 @@ export interface ChatActionContextType {
         feedbackTags?: string;
         feedbackDescription?: string;
     }) => Promise<boolean>;
+    /**
+     * 设置自定义业务参数 (stateDelta)
+     * 设置后每次发送消息时会自动携带该参数
+     * 传入 undefined 可清除已设置的参数
+     */
+    setStateDelta: (delta: Record<string, any> | undefined) => void;
 }
 export declare const ChatActionContext: import("react").Context<ChatActionContextType | null>;
 /**

package/dist/esm/components/XAdkProvider/context/ChatActionContext.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","useContext","ChatActionContext","useChatActions","context","Error"],"sources":["../../../../../src/components/XAdkProvider/context/ChatActionContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { SendContent, FunctionCall, IMessage } from '@/types';\n\n/**\n * 聊天动作 Context\n * 只包含操作方法,不包含状态数据\n * 与 ChatStateContext 分离可以优化性能\n */\nexport interface ChatActionContextType {\n  /** 发送消息 */\n  chat: (content: SendContent) => void;\n  /** 停止聊天 */\n  stopChat: () => void;\n  /** 清空/重置聊天 */\n  clearChat: () => void;\n  /** 重新发送 */\n  reChat: () => void;\n  /** 使用建议问题 */\n  suggestChat: (text: string) => void;\n  /** 确认函数调用 */\n  confirmFnCall: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /** 设置消息列表 */\n  setMessages: React.Dispatch<React.SetStateAction<IMessage[]>>;\n  /** 点赞/点踩消息 */\n  likeMessage: (\n    invocationId: string,\n    isLike: 1 | -1,\n    feedbackData?: { feedbackTags?: string; feedbackDescription?: string },\n  ) => Promise<boolean>;\n}\n\nexport const ChatActionContext = createContext<ChatActionContextType | null>(null);\n\n/**\n * 使用聊天动作 Hook\n * @returns ChatActionContextType\n * @throws Error 如果在 XAdkProvider 外部使用\n */\nexport const useChatActions = () => {\n  const context = useContext(ChatActionContext);\n  if (!context) {\n    throw new Error('useChatActions must be used within XAdkProvider');\n  }\n  return context;\n};\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;;AAGjD;AACA;AACA;AACA;AACA;;AAwBA,OAAO,IAAMC,iBAAiB,gBAAGF,aAAa,CAA+B,IAAI,CAAC;;AAElF;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMG,cAAc,GAAG,SAAjBA,cAAcA,CAAA,EAAS;EAClC,IAAMC,OAAO,GAAGH,UAAU,CAACC,iBAAiB,CAAC;EAC7C,IAAI,CAACE,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,iDAAiD,CAAC;EACpE;EACA,OAAOD,OAAO;AAChB,CAAC"}
+{"version":3,"names":["createContext","useContext","ChatActionContext","useChatActions","context","Error"],"sources":["../../../../../src/components/XAdkProvider/context/ChatActionContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { SendContent, FunctionCall, IMessage } from '@/types';\n\n/**\n * 聊天动作 Context\n * 只包含操作方法,不包含状态数据\n * 与 ChatStateContext 分离可以优化性能\n */\nexport interface ChatActionContextType {\n  /** 发送消息 */\n  chat: (content: SendContent) => void;\n  /** 停止聊天 */\n  stopChat: () => void;\n  /** 清空/重置聊天 */\n  clearChat: () => void;\n  /** 重新发送 */\n  reChat: () => void;\n  /** 使用建议问题 */\n  suggestChat: (text: string) => void;\n  /** 确认函数调用 */\n  confirmFnCall: (fnCall: FunctionCall, confirmed: boolean) => void;\n  /** 设置消息列表 */\n  setMessages: React.Dispatch<React.SetStateAction<IMessage[]>>;\n  /** 点赞/点踩消息 */\n  likeMessage: (\n    invocationId: string,\n    isLike: 1 | -1,\n    feedbackData?: { feedbackTags?: string; feedbackDescription?: string },\n  ) => Promise<boolean>;\n  /**\n   * 设置自定义业务参数 (stateDelta)\n   * 设置后每次发送消息时会自动携带该参数\n   * 传入 undefined 可清除已设置的参数\n   */\n  setStateDelta: (delta: Record<string, any> | undefined) => void;\n}\n\nexport const ChatActionContext = createContext<ChatActionContextType | null>(null);\n\n/**\n * 使用聊天动作 Hook\n * @returns ChatActionContextType\n * @throws Error 如果在 XAdkProvider 外部使用\n */\nexport const useChatActions = () => {\n  const context = useContext(ChatActionContext);\n  if (!context) {\n    throw new Error('useChatActions must be used within XAdkProvider');\n  }\n  return context;\n};\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;;AAGjD;AACA;AACA;AACA;AACA;;AA8BA,OAAO,IAAMC,iBAAiB,gBAAGF,aAAa,CAA+B,IAAI,CAAC;;AAElF;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMG,cAAc,GAAG,SAAjBA,cAAcA,CAAA,EAAS;EAClC,IAAMC,OAAO,GAAGH,UAAU,CAACC,iBAAiB,CAAC;EAC7C,IAAI,CAACE,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,iDAAiD,CAAC;EACpE;EACA,OAAOD,OAAO;AAChB,CAAC"}

package/dist/esm/components/XAdkProvider/context/SessionContext.d.ts

@@ -18,7 +18,7 @@ export interface SessionContextType {
     /** 更新会话标题 */
     updateSession: (sessionId: string, title: string) => void;
     /** 设置当前会话详情 */
-    setCurrentSessionDetail: (sessionId: string) => void;
+    setCurrentSession: (sessionId: string) => void;
 }
 export declare const SessionContext: import("react").Context<SessionContextType | null>;
 /**

package/dist/esm/components/XAdkProvider/context/SessionContext.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","useContext","SessionContext","useSession","context","Error"],"sources":["../../../../../src/components/XAdkProvider/context/SessionContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { SessionData } from '@/types';\n\n/**\n * 会话管理 Context\n * 管理会话列表和会话操作\n */\nexport interface SessionContextType {\n  /** 会话列表 */\n  sessionList: SessionData[];\n  /** 会话分页信息 */\n  sessionPagination: {\n    total: number;\n    pageNum: number;\n    pageSize: number;\n  };\n  /** 删除会话 */\n  deleteSession: (sessionId: string) => void;\n  /** 更新会话标题 */\n  updateSession: (sessionId: string, title: string) => void;\n  /** 设置当前会话详情 */\n  setCurrentSessionDetail: (sessionId: string) => void;\n}\n\nexport const SessionContext = createContext<SessionContextType | null>(null);\n\n/**\n * 使用会话管理 Hook\n * @returns SessionContextType\n * @throws Error 如果在 XAdkProvider 外部使用\n */\nexport const useSession = () => {\n  const context = useContext(SessionContext);\n  if (!context) {\n    throw new Error('useSession must be used within XAdkProvider');\n  }\n  return context;\n};\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;;AAGjD;AACA;AACA;AACA;;AAkBA,OAAO,IAAMC,cAAc,gBAAGF,aAAa,CAA4B,IAAI,CAAC;;AAE5E;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMG,UAAU,GAAG,SAAbA,UAAUA,CAAA,EAAS;EAC9B,IAAMC,OAAO,GAAGH,UAAU,CAACC,cAAc,CAAC;EAC1C,IAAI,CAACE,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,6CAA6C,CAAC;EAChE;EACA,OAAOD,OAAO;AAChB,CAAC"}
+{"version":3,"names":["createContext","useContext","SessionContext","useSession","context","Error"],"sources":["../../../../../src/components/XAdkProvider/context/SessionContext.tsx"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { SessionData } from '@/types';\n\n/**\n * 会话管理 Context\n * 管理会话列表和会话操作\n */\nexport interface SessionContextType {\n  /** 会话列表 */\n  sessionList: SessionData[];\n  /** 会话分页信息 */\n  sessionPagination: {\n    total: number;\n    pageNum: number;\n    pageSize: number;\n  };\n  /** 删除会话 */\n  deleteSession: (sessionId: string) => void;\n  /** 更新会话标题 */\n  updateSession: (sessionId: string, title: string) => void;\n  /** 设置当前会话详情 */\n  setCurrentSession: (sessionId: string) => void;\n}\n\nexport const SessionContext = createContext<SessionContextType | null>(null);\n\n/**\n * 使用会话管理 Hook\n * @returns SessionContextType\n * @throws Error 如果在 XAdkProvider 外部使用\n */\nexport const useSession = () => {\n  const context = useContext(SessionContext);\n  if (!context) {\n    throw new Error('useSession must be used within XAdkProvider');\n  }\n  return context;\n};\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;;AAGjD;AACA;AACA;AACA;;AAkBA,OAAO,IAAMC,cAAc,gBAAGF,aAAa,CAA4B,IAAI,CAAC;;AAE5E;AACA;AACA;AACA;AACA;AACA,OAAO,IAAMG,UAAU,GAAG,SAAbA,UAAUA,CAAA,EAAS;EAC9B,IAAMC,OAAO,GAAGH,UAAU,CAACC,cAAc,CAAC;EAC1C,IAAI,CAACE,OAAO,EAAE;IACZ,MAAM,IAAIC,KAAK,CAAC,6CAA6C,CAAC;EAChE;EACA,OAAOD,OAAO;AAChB,CAAC"}

package/dist/esm/components/XAdkProvider/index.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { XAdkProviderProps, XAdkProviderHandle } from "../../types/XAdkProvider";
+import type { XAdkProviderProps, XAdkProviderHandle, XAdkProviderConfig } from "../../types/XAdkProvider";
 import type { ChatHookResult } from "../../types/ChatHook";
 /**
  * XAdkProvider Props (扩展版)
@@ -14,7 +14,7 @@ export interface XAdkProviderPropsExtended extends Omit<XAdkProviderProps, "url"
      */
     url?: string;
     token: string;
-    config?: any;
+    config?: XAdkProviderConfig;
     /**
      * 选项 B: 使用自定义 Hook 数据
      * 如果提供此参数,将忽略 url/token/config

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

@@ -104,7 +104,7 @@ var XAdkProviderComponent = /*#__PURE__*/forwardRef(function (_ref, ref) {
     prologue = data.prologue,
     suggestions = data.suggestions,
     initialized = data.initialized,
-    setCurrentSessionDetail = data.setCurrentSessionDetail,
+    setCurrentSession = data.setCurrentSession,
     setMessages = data.setMessages,
     _data$likeMessage = data.likeMessage,
     likeMessage = _data$likeMessage === void 0 ? /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
@@ -117,7 +117,9 @@ var XAdkProviderComponent = /*#__PURE__*/forwardRef(function (_ref, ref) {
             return _context.stop();
         }
       }, _callee);
-    })) : _data$likeMessage;
+    })) : _data$likeMessage,
+    _data$setStateDelta = data.setStateDelta,
+    setStateDelta = _data$setStateDelta === void 0 ? function () {} : _data$setStateDelta;
   var showFeedback = (_config$showFeedback = config === null || config === void 0 ? void 0 : config.showFeedback) !== null && _config$showFeedback !== void 0 ? _config$showFeedback : true;
   var onFileClick = config === null || config === void 0 ? void 0 : config.onFileClick;
   var uploadRequest = config === null || config === void 0 ? void 0 : config.uploadRequest;
@@ -142,9 +144,10 @@ var XAdkProviderComponent = /*#__PURE__*/forwardRef(function (_ref, ref) {
         return sessionList;
       },
       setMessages: setMessages,
-      setCurrentSessionDetail: setCurrentSessionDetail
+      setCurrentSession: setCurrentSession,
+      setStateDelta: setStateDelta
     };
-  }, [appInfo, messages, sessionList, startChat, stopChat, reChat, clearChat, suggestChat, deleteSession, updateSession, setMessages, setCurrentSessionDetail]);
+  }, [appInfo, messages, sessionList, startChat, stopChat, reChat, clearChat, suggestChat, deleteSession, updateSession, setMessages, setCurrentSession, setStateDelta]);
 
   // 状态 Context Value - 使用 useMemo 避免不必要的 rerender
   var chatStateValue = useMemo(function () {
@@ -174,9 +177,10 @@ var XAdkProviderComponent = /*#__PURE__*/forwardRef(function (_ref, ref) {
       suggestChat: suggestChat,
       confirmFnCall: confirmFnCall,
       setMessages: setMessages,
-      likeMessage: likeMessage
+      likeMessage: likeMessage,
+      setStateDelta: setStateDelta
     };
-  }, [startChat, stopChat, clearChat, reChat, suggestChat, confirmFnCall, setMessages, likeMessage]);
+  }, [startChat, stopChat, clearChat, reChat, suggestChat, confirmFnCall, setMessages, likeMessage, setStateDelta]);
 
   // 会话 Context Value
   var sessionValue = useMemo(function () {
@@ -185,9 +189,9 @@ var XAdkProviderComponent = /*#__PURE__*/forwardRef(function (_ref, ref) {
       sessionPagination: sessionPagination,
       deleteSession: deleteSession,
       updateSession: updateSession,
-      setCurrentSessionDetail: setCurrentSessionDetail
+      setCurrentSession: setCurrentSession
     };
-  }, [sessionList, sessionPagination, deleteSession, updateSession, setCurrentSessionDetail]);
+  }, [sessionList, sessionPagination, deleteSession, updateSession, setCurrentSession]);
   return /*#__PURE__*/_jsx(ConfigProvider, {
     theme: {
       token: {