@ai-group/chat-sdk 2.1.13 → 3.0.1-alpha.2

package/dist/esm/utils/parseAgentMessage.js

@@ -0,0 +1,286 @@
+/**
+ * 解析后的消息片段类型
+ */
+
+/**
+ * 解析规则配置
+ */
+
+/**
+ * 清理 process 文本
+ * - 移除多余的换行
+ * - 移除 JSON 代码块标记
+ */
+export function cleanProcessText(text) {
+  return text.replace(/```json\s*/g, '').replace(/```\s*/g, '').replace(/^\n+/, '').replace(/\n+$/, '').trim();
+}
+
+/**
+ * XML 模式解析 (默认)
+ * 识别标签: <reasoning>、<planning>、<replanning>、<action_log>
+ */
+function parseXmlMode(text) {
+  var parts = [];
+
+  // 定义标签模式
+  var tagPatterns = [{
+    regex: /<reasoning>([\s\S]*?)<\/reasoning>/g,
+    type: 'reasoning'
+  }, {
+    regex: /<planning>([\s\S]*?)<\/planning>/g,
+    type: 'planning'
+  }, {
+    regex: /<replanning>([\s\S]*?)<\/replanning>/g,
+    type: 'replanning'
+  }, {
+    regex: /<action_log>([\s\S]*?)<\/action_log>/g,
+    type: 'action_log'
+  }];
+
+  // 收集所有标签位置
+
+  var matches = [];
+  tagPatterns.forEach(function (_ref) {
+    var regex = _ref.regex,
+      type = _ref.type;
+    var match;
+    var tempRegex = new RegExp(regex);
+    while ((match = tempRegex.exec(text)) !== null) {
+      matches.push({
+        type: type,
+        start: match.index,
+        end: match.index + match[0].length,
+        content: match[1].trim()
+      });
+    }
+  });
+
+  // 按位置排序
+  matches.sort(function (a, b) {
+    return a.start - b.start;
+  });
+
+  // 提取文本和标签
+  var currentPos = 0;
+  matches.forEach(function (match) {
+    // 添加标签前的文本
+    if (match.start > currentPos) {
+      var textBefore = text.substring(currentPos, match.start).trim();
+      if (textBefore) {
+        parts.push({
+          type: 'text',
+          content: textBefore
+        });
+      }
+    }
+
+    // 添加标签内容
+    parts.push({
+      type: match.type,
+      content: match.content
+    });
+    currentPos = match.end;
+  });
+
+  // 添加最后的文本
+  if (currentPos < text.length) {
+    var textAfter = text.substring(currentPos).trim();
+    if (textAfter) {
+      parts.push({
+        type: 'text',
+        content: textAfter
+      });
+    }
+  }
+  return parts;
+}
+
+/**
+ * 注释模式解析 (/*PLANNING*\/ 格式)
+ * 适用于业务项目的格式
+ */
+function parseCommentMode(text) {
+  var finalMarker = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '/*FINAL_ANSWER*/';
+  // 如果完全没有 Agent 推理标记，则整段文本视为最终结果
+  if (!text.includes('/*')) {
+    return [{
+      type: 'final_result',
+      content: text
+    }];
+  }
+  var results = [];
+  var finalIndex = text.indexOf(finalMarker);
+  var processText = text;
+  var finalText = '';
+  if (finalIndex !== -1) {
+    processText = text.substring(0, finalIndex);
+    finalText = text.substring(finalIndex + finalMarker.length);
+  }
+  var regex = /(\/\*PLANNING\*\/|\/\*REPLANNING\*\/|\/\*REASONING\*\/|\/\*ACTION\*\/)/g;
+  var parts = processText.split(regex);
+  var currentType = 'process_text';
+  parts.forEach(function (part) {
+    if (part === '/*PLANNING*/') {
+      currentType = 'planning';
+      return;
+    }
+    if (part === '/*REPLANNING*/') {
+      currentType = 'replanning';
+      return;
+    }
+    if (part === '/*REASONING*/') {
+      currentType = 'reasoning';
+      return;
+    }
+    if (part === '/*ACTION*/') {
+      currentType = 'action_log';
+      return;
+    }
+    if (part && part.trim().length > 0) {
+      results.push({
+        type: currentType,
+        content: part
+      });
+    }
+  });
+  if (finalText.trim()) {
+    results.push({
+      type: 'final_result',
+      content: finalText
+    });
+  }
+  return results;
+}
+
+/**
+ * 自定义模式解析
+ */
+function parseCustomMode(text, patterns) {
+  var parts = [];
+  var matches = [];
+  patterns.forEach(function (_ref2) {
+    var regex = _ref2.regex,
+      type = _ref2.type;
+    var match;
+    var tempRegex = new RegExp(regex);
+    while ((match = tempRegex.exec(text)) !== null) {
+      var _match$;
+      matches.push({
+        type: type,
+        start: match.index,
+        end: match.index + match[0].length,
+        content: ((_match$ = match[1]) === null || _match$ === void 0 ? void 0 : _match$.trim()) || match[0]
+      });
+    }
+  });
+  matches.sort(function (a, b) {
+    return a.start - b.start;
+  });
+  var currentPos = 0;
+  matches.forEach(function (match) {
+    if (match.start > currentPos) {
+      var textBefore = text.substring(currentPos, match.start).trim();
+      if (textBefore) {
+        parts.push({
+          type: 'text',
+          content: textBefore
+        });
+      }
+    }
+    parts.push({
+      type: match.type,
+      content: match.content
+    });
+    currentPos = match.end;
+  });
+  if (currentPos < text.length) {
+    var textAfter = text.substring(currentPos).trim();
+    if (textAfter) {
+      parts.push({
+        type: 'text',
+        content: textAfter
+      });
+    }
+  }
+  return parts;
+}
+
+/**
+ * 解析 Agent 消息 (支持多种格式)
+ *
+ * @param text 原始消息文本
+ * @param options 解析选项
+ * @returns 解析后的消息片段数组
+ *
+ * @example
+ * // XML 模式 (默认)
+ * const parts1 = parseAgentMessage(`
+ *   <reasoning>分析用户需求...</reasoning>
+ *   最终回复内容
+ * `);
+ *
+ * @example
+ * // 注释模式 (业务项目格式)
+ * const parts2 = parseAgentMessage(`
+ *   /*REASONING*\/分析用户需求...
+ *   /*FINAL_ANSWER*\/最终回复内容
+ * `, { mode: 'comment' });
+ *
+ * @example
+ * // 自定义模式
+ * const parts3 = parseAgentMessage(text, {
+ *   mode: 'custom',
+ *   customPatterns: [
+ *     { regex: /\[REASONING\]([\s\S]*?)\[\/REASONING\]/g, type: 'reasoning' }
+ *   ]
+ * });
+ */
+export function parseAgentMessage(text) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (!text) return [];
+  var _options$mode = options.mode,
+    mode = _options$mode === void 0 ? 'xml' : _options$mode,
+    customPatterns = options.customPatterns,
+    finalMarker = options.finalMarker;
+
+  // 根据模式选择解析器
+  if (mode === 'comment') {
+    return parseCommentMode(text, finalMarker);
+  }
+  if (mode === 'custom' && customPatterns) {
+    return parseCustomMode(text, customPatterns);
+  }
+
+  // 默认 XML 模式
+  var parts = parseXmlMode(text);
+
+  // 如果没有任何标签,返回整个文本
+  if (parts.length === 0) {
+    return [{
+      type: 'text',
+      content: text
+    }];
+  }
+  return parts;
+}
+
+/**
+ * 检查是否包含 process 内容
+ */
+export function hasProcessContent(parts) {
+  return parts.some(function (part) {
+    return ['planning', 'replanning', 'reasoning', 'action_log', 'process_text'].includes(part.type);
+  });
+}
+
+/**
+ * 获取纯文本内容(不包含 process 标签)
+ */
+export function getPlainText(parts) {
+  return parts.filter(function (part) {
+    return part.type === 'text' || part.type === 'final_result';
+  }).map(function (part) {
+    return part.content;
+  }).join('\n\n').trim();
+}
+//# sourceMappingURL=parseAgentMessage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["cleanProcessText","text","replace","trim","parseXmlMode","parts","tagPatterns","regex","type","matches","forEach","_ref","match","tempRegex","RegExp","exec","push","start","index","end","length","content","sort","a","b","currentPos","textBefore","substring","textAfter","parseCommentMode","finalMarker","arguments","undefined","includes","results","finalIndex","indexOf","processText","finalText","split","currentType","part","parseCustomMode","patterns","_ref2","_match$","parseAgentMessage","options","_options$mode","mode","customPatterns","hasProcessContent","some","getPlainText","filter","map","join"],"sources":["../../../src/utils/parseAgentMessage.ts"],"sourcesContent":["/**\n * 解析后的消息片段类型\n */\nexport interface ParsedPart {\n  type: 'text' | 'planning' | 'replanning' | 'reasoning' | 'action_log' | 'final_result' | 'process_text';\n  content: string;\n}\n\n/**\n * 解析规则配置\n */\nexport interface ParseAgentMessageOptions {\n  /**\n   * 解析模式\n   * - 'xml': XML 标签模式 <reasoning>...</reasoning>\n   * - 'comment': 注释标签模式 /*REASONING*\\/\n   * - 'custom': 自定义正则模式\n   */\n  mode?: 'xml' | 'comment' | 'custom';\n\n  /**\n   * 自定义正则规则 (mode='custom' 时使用)\n   * @example\n   * [\n   *   { regex: /\\[REASONING\\]([\\s\\S]*?)\\[\\/REASONING\\]/g, type: 'reasoning' },\n   *   { regex: /\\[PLANNING\\]([\\s\\S]*?)\\[\\/PLANNING\\]/g, type: 'planning' }\n   * ]\n   */\n  customPatterns?: Array<{\n    regex: RegExp;\n    type: ParsedPart['type'];\n  }>;\n\n  /**\n   * 最终答案标记 (comment 模式使用)\n   * @default '/*FINAL_ANSWER*\\/'\n   */\n  finalMarker?: string;\n}\n\n/**\n * 清理 process 文本\n * - 移除多余的换行\n * - 移除 JSON 代码块标记\n */\nexport function cleanProcessText(text: string): string {\n  return text\n    .replace(/```json\\s*/g, '')\n    .replace(/```\\s*/g, '')\n    .replace(/^\\n+/, '')\n    .replace(/\\n+$/, '')\n    .trim();\n}\n\n/**\n * XML 模式解析 (默认)\n * 识别标签: <reasoning>、<planning>、<replanning>、<action_log>\n */\nfunction parseXmlMode(text: string): ParsedPart[] {\n  const parts: ParsedPart[] = [];\n\n  // 定义标签模式\n  const tagPatterns: Array<{\n    regex: RegExp;\n    type: ParsedPart['type'];\n  }> = [\n    { regex: /<reasoning>([\\s\\S]*?)<\\/reasoning>/g, type: 'reasoning' },\n    { regex: /<planning>([\\s\\S]*?)<\\/planning>/g, type: 'planning' },\n    { regex: /<replanning>([\\s\\S]*?)<\\/replanning>/g, type: 'replanning' },\n    { regex: /<action_log>([\\s\\S]*?)<\\/action_log>/g, type: 'action_log' },\n  ];\n\n  // 收集所有标签位置\n  interface TagMatch {\n    type: ParsedPart['type'];\n    start: number;\n    end: number;\n    content: string;\n  }\n\n  const matches: TagMatch[] = [];\n\n  tagPatterns.forEach(({ regex, type }) => {\n    let match;\n    const tempRegex = new RegExp(regex);\n    while ((match = tempRegex.exec(text)) !== null) {\n      matches.push({\n        type,\n        start: match.index,\n        end: match.index + match[0].length,\n        content: match[1].trim(),\n      });\n    }\n  });\n\n  // 按位置排序\n  matches.sort((a, b) => a.start - b.start);\n\n  // 提取文本和标签\n  let currentPos = 0;\n\n  matches.forEach((match) => {\n    // 添加标签前的文本\n    if (match.start > currentPos) {\n      const textBefore = text.substring(currentPos, match.start).trim();\n      if (textBefore) {\n        parts.push({ type: 'text', content: textBefore });\n      }\n    }\n\n    // 添加标签内容\n    parts.push({ type: match.type, content: match.content });\n\n    currentPos = match.end;\n  });\n\n  // 添加最后的文本\n  if (currentPos < text.length) {\n    const textAfter = text.substring(currentPos).trim();\n    if (textAfter) {\n      parts.push({ type: 'text', content: textAfter });\n    }\n  }\n\n  return parts;\n}\n\n/**\n * 注释模式解析 (/*PLANNING*\\/ 格式)\n * 适用于业务项目的格式\n */\nfunction parseCommentMode(text: string, finalMarker: string = '/*FINAL_ANSWER*/'): ParsedPart[] {\n  // 如果完全没有 Agent 推理标记，则整段文本视为最终结果\n  if (!text.includes('/*')) {\n    return [{ type: 'final_result', content: text }];\n  }\n\n  const results: ParsedPart[] = [];\n  const finalIndex = text.indexOf(finalMarker);\n\n  let processText = text;\n  let finalText = '';\n\n  if (finalIndex !== -1) {\n    processText = text.substring(0, finalIndex);\n    finalText = text.substring(finalIndex + finalMarker.length);\n  }\n\n  const regex = /(\\/\\*PLANNING\\*\\/|\\/\\*REPLANNING\\*\\/|\\/\\*REASONING\\*\\/|\\/\\*ACTION\\*\\/)/g;\n  const parts = processText.split(regex);\n\n  let currentType: ParsedPart['type'] = 'process_text';\n\n  parts.forEach((part) => {\n    if (part === '/*PLANNING*/') {\n      currentType = 'planning';\n      return;\n    }\n    if (part === '/*REPLANNING*/') {\n      currentType = 'replanning';\n      return;\n    }\n    if (part === '/*REASONING*/') {\n      currentType = 'reasoning';\n      return;\n    }\n    if (part === '/*ACTION*/') {\n      currentType = 'action_log';\n      return;\n    }\n\n    if (part && part.trim().length > 0) {\n      results.push({ type: currentType, content: part });\n    }\n  });\n\n  if (finalText.trim()) {\n    results.push({ type: 'final_result', content: finalText });\n  }\n\n  return results;\n}\n\n/**\n * 自定义模式解析\n */\nfunction parseCustomMode(text: string, patterns: Array<{ regex: RegExp; type: ParsedPart['type'] }>): ParsedPart[] {\n  const parts: ParsedPart[] = [];\n  const matches: Array<{ type: ParsedPart['type']; start: number; end: number; content: string }> = [];\n\n  patterns.forEach(({ regex, type }) => {\n    let match;\n    const tempRegex = new RegExp(regex);\n    while ((match = tempRegex.exec(text)) !== null) {\n      matches.push({\n        type,\n        start: match.index,\n        end: match.index + match[0].length,\n        content: match[1]?.trim() || match[0],\n      });\n    }\n  });\n\n  matches.sort((a, b) => a.start - b.start);\n\n  let currentPos = 0;\n  matches.forEach((match) => {\n    if (match.start > currentPos) {\n      const textBefore = text.substring(currentPos, match.start).trim();\n      if (textBefore) {\n        parts.push({ type: 'text', content: textBefore });\n      }\n    }\n    parts.push({ type: match.type, content: match.content });\n    currentPos = match.end;\n  });\n\n  if (currentPos < text.length) {\n    const textAfter = text.substring(currentPos).trim();\n    if (textAfter) {\n      parts.push({ type: 'text', content: textAfter });\n    }\n  }\n\n  return parts;\n}\n\n/**\n * 解析 Agent 消息 (支持多种格式)\n *\n * @param text 原始消息文本\n * @param options 解析选项\n * @returns 解析后的消息片段数组\n *\n * @example\n * // XML 模式 (默认)\n * const parts1 = parseAgentMessage(`\n *   <reasoning>分析用户需求...</reasoning>\n *   最终回复内容\n * `);\n *\n * @example\n * // 注释模式 (业务项目格式)\n * const parts2 = parseAgentMessage(`\n *   /*REASONING*\\/分析用户需求...\n *   /*FINAL_ANSWER*\\/最终回复内容\n * `, { mode: 'comment' });\n *\n * @example\n * // 自定义模式\n * const parts3 = parseAgentMessage(text, {\n *   mode: 'custom',\n *   customPatterns: [\n *     { regex: /\\[REASONING\\]([\\s\\S]*?)\\[\\/REASONING\\]/g, type: 'reasoning' }\n *   ]\n * });\n */\nexport function parseAgentMessage(text: string, options: ParseAgentMessageOptions = {}): ParsedPart[] {\n  if (!text) return [];\n\n  const { mode = 'xml', customPatterns, finalMarker } = options;\n\n  // 根据模式选择解析器\n  if (mode === 'comment') {\n    return parseCommentMode(text, finalMarker);\n  }\n\n  if (mode === 'custom' && customPatterns) {\n    return parseCustomMode(text, customPatterns);\n  }\n\n  // 默认 XML 模式\n  const parts = parseXmlMode(text);\n\n  // 如果没有任何标签,返回整个文本\n  if (parts.length === 0) {\n    return [{ type: 'text', content: text }];\n  }\n\n  return parts;\n}\n\n/**\n * 检查是否包含 process 内容\n */\nexport function hasProcessContent(parts: ParsedPart[]): boolean {\n  return parts.some((part) =>\n    ['planning', 'replanning', 'reasoning', 'action_log', 'process_text'].includes(part.type)\n  );\n}\n\n/**\n * 获取纯文本内容(不包含 process 标签)\n */\nexport function getPlainText(parts: ParsedPart[]): string {\n  return parts\n    .filter((part) => part.type === 'text' || part.type === 'final_result')\n    .map((part) => part.content)\n    .join('\\n\\n')\n    .trim();\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,28 @@
 /// <reference types="react" />
 import { XAdkSDKProps, XAdkProviderHandle, IMessage } from "../types";
 import { SendContent } from "../types";
+/**
+ * XAiWebSDK - UMD 入口类
+ *
+ * 用于通过 <script> 标签引入 SDK 的场景
+ *
+ * @example
+ * ```html
+ * <script src="chat-sdk.min.js"></script>
+ * <script>
+ *   const sdk = XAiWebSDK.initChatbot({
+ *     url: 'https://api.example.com',
+ *     token: 'your-token',
+ *     config: {
+ *       appNo: 'your-app-no',
+ *       session: {
+ *         showSessionList: true
+ *       }
+ *     }
+ *   });
+ * </script>
+ * ```
+ */
 declare class XAiWebSDK {
     container: HTMLElement;
     props: XAdkSDKProps;
@@ -12,14 +34,83 @@ declare class XAiWebSDK {
     constructor(container: HTMLElement, props: XAdkSDKProps);
     mount(): void;
     unmount(): void;
+    /**
+     * 初始化聊天机器人(推荐方式)
+     *
+     * @param props - SDK 配置参数
+     * @returns XAiWebSDK 实例
+     *
+     * @example
+     * ```javascript
+     * const sdk = XAiWebSDK.initChatbot({
+     *   url: 'https://api.example.com',
+     *   token: 'your-token',
+     *   config: {
+     *     appNo: 'your-app-no',
+     *     session: {
+     *       showSessionList: true  // 显示会话列表
+     *     },
+     *     allowUpload: true,       // 允许文件上传
+     *     chatProps: {
+     *       clearBtnShow: false    // 隐藏清空按钮
+     *     }
+     *   },
+     *   componentProps: {
+     *     id: 'my-chatbot',        // 容器 ID
+     *     width: '100%',
+     *     height: '600px'
+     *   }
+     * });
+     * ```
+     */
     static initChatbot(props: XAdkSDKProps): XAiWebSDK;
+    /**
+     * 兼容旧版本的静态方法
+     * @deprecated 使用 initChatbot 替代
+     */
     static create(props: XAdkSDKProps): XAiWebSDK;
+    /**
+     * 获取当前数据
+     * @returns 应用信息、消息列表、会话列表
+     */
     getData(): {
         appInfo: any;
         messages: IMessage[] | undefined;
         sessions: any[] | undefined;
     };
+    /**
+     * 发送消息
+     * @param content - 消息内容
+     *
+     * @example
+     * ```javascript
+     * sdk.chat({ text: 'Hello!' });
+     * ```
+     */
     chat(content: SendContent): void;
+    /**
+     * 停止当前消息生成
+     */
     stop(): void;
+    /**
+     * 清空当前会话
+     */
+    clear(): void;
+    /**
+     * 删除指定会话
+     * @param sessionId - 会话 ID
+     */
+    deleteSession(sessionId: string): void;
+    /**
+     * 更新会话标题
+     * @param sessionId - 会话 ID
+     * @param title - 新标题
+     */
+    updateSession(sessionId: string, title: string): void;
+    /**
+     * 切换到指定会话
+     * @param sessionId - 会话 ID
+     */
+    switchSession(sessionId: string): void;
 }
 export default XAiWebSDK;

package/dist/esm/utils/umdEntry.js

@@ -4,10 +4,32 @@ import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
 import _createClass from "@babel/runtime/helpers/esm/createClass";
 import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
 var _excluded = ["id"];
-import { createRef } from 'react';
-import ReactDOM from 'react-dom/client';
-import XAdkWebProvider from "../components/XAdkWebProvider";
+import { createRef } from "react";
+import ReactDOM from "react-dom/client";
+import XAdkProvider from "../components/XAdkProvider";
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * XAiWebSDK - UMD 入口类
+ *
+ * 用于通过 <script> 标签引入 SDK 的场景
+ *
+ * @example
+ * ```html
+ * <script src="chat-sdk.min.js"></script>
+ * <script>
+ *   const sdk = XAiWebSDK.initChatbot({
+ *     url: 'https://api.example.com',
+ *     token: 'your-token',
+ *     config: {
+ *       appNo: 'your-app-no',
+ *       session: {
+ *         showSessionList: true
+ *       }
+ *     }
+ *   });
+ * </script>
+ * ```
+ */
 var XAiWebSDK = /*#__PURE__*/function () {
   function XAiWebSDK(container, props) {
     _classCallCheck(this, XAiWebSDK);
@@ -29,27 +51,49 @@ var XAiWebSDK = /*#__PURE__*/function () {
   _createClass(XAiWebSDK, [{
     key: "mount",
     value: function mount() {
+      var _config$session$showS, _config$session, _config$allowUpload, _config$chatProps$cle, _config$chatProps;
+      // 提取配置
+      var _this$props$config = this.props.config,
+        config = _this$props$config === void 0 ? {} : _this$props$config;
+      var showSessionList = (_config$session$showS = (_config$session = config.session) === null || _config$session === void 0 ? void 0 : _config$session.showSessionList) !== null && _config$session$showS !== void 0 ? _config$session$showS : false;
+      var allowUpload = (_config$allowUpload = config.allowUpload) !== null && _config$allowUpload !== void 0 ? _config$allowUpload : false;
+      var clearBtnShow = (_config$chatProps$cle = (_config$chatProps = config.chatProps) === null || _config$chatProps === void 0 ? void 0 : _config$chatProps.clearBtnShow) !== null && _config$chatProps$cle !== void 0 ? _config$chatProps$cle : true;
       if (ReactDOM.createRoot) {
         this.root = ReactDOM.createRoot(this.container);
         this.root.render( /*#__PURE__*/_jsx("div", {
           style: {
-            width: '100%',
-            height: '100%'
+            width: "100%",
+            height: "100%"
           },
-          children: /*#__PURE__*/_jsx(XAdkWebProvider, _objectSpread({
+          children: /*#__PURE__*/_jsx(XAdkProvider, _objectSpread(_objectSpread({
             ref: this.providerRef
-          }, this.props))
+          }, this.props), {}, {
+            children: /*#__PURE__*/_jsx(XAdkProvider.DefaultLayout, {
+              showSessionList: showSessionList,
+              allowUpload: allowUpload,
+              clearBtnShow: clearBtnShow,
+              showFnCallDetail: true
+            })
+          }))
         }));
       } else {
+        // 兼容 React 17
         // @ts-ignore
         ReactDOM.render( /*#__PURE__*/_jsx("div", {
           style: {
-            width: '100%',
-            height: '100%'
+            width: "100%",
+            height: "100%"
           },
-          children: /*#__PURE__*/_jsx(XAdkWebProvider, _objectSpread({
+          children: /*#__PURE__*/_jsx(XAdkProvider, _objectSpread(_objectSpread({
             ref: this.providerRef
-          }, this.props))
+          }, this.props), {}, {
+            children: /*#__PURE__*/_jsx(XAdkProvider.DefaultLayout, {
+              showSessionList: showSessionList,
+              allowUpload: allowUpload,
+              clearBtnShow: clearBtnShow,
+              showFnCallDetail: true
+            })
+          }))
         }), this.container);
       }
     }
@@ -61,11 +105,44 @@ var XAiWebSDK = /*#__PURE__*/function () {
       }
     }
 
-    // 支持 Coze 风格的语法：new XAiWebSDK.initChatbot()
+    /**
+     * 初始化聊天机器人(推荐方式)
+     *
+     * @param props - SDK 配置参数
+     * @returns XAiWebSDK 实例
+     *
+     * @example
+     * ```javascript
+     * const sdk = XAiWebSDK.initChatbot({
+     *   url: 'https://api.example.com',
+     *   token: 'your-token',
+     *   config: {
+     *     appNo: 'your-app-no',
+     *     session: {
+     *       showSessionList: true  // 显示会话列表
+     *     },
+     *     allowUpload: true,       // 允许文件上传
+     *     chatProps: {
+     *       clearBtnShow: false    // 隐藏清空按钮
+     *     }
+     *   },
+     *   componentProps: {
+     *     id: 'my-chatbot',        // 容器 ID
+     *     width: '100%',
+     *     height: '600px'
+     *   }
+     * });
+     * ```
+     */
   }, {
     key: "getData",
     value:
     // ————对外暴露的方法————
+
+    /**
+     * 获取当前数据
+     * @returns 应用信息、消息列表、会话列表
+     */
     function getData() {
       var _this$providerRef$cur, _this$providerRef$cur2, _this$providerRef$cur3;
       return {
@@ -74,18 +151,76 @@ var XAiWebSDK = /*#__PURE__*/function () {
         sessions: (_this$providerRef$cur3 = this.providerRef.current) === null || _this$providerRef$cur3 === void 0 ? void 0 : _this$providerRef$cur3.getSessions()
       };
     }
+
+    /**
+     * 发送消息
+     * @param content - 消息内容
+     *
+     * @example
+     * ```javascript
+     * sdk.chat({ text: 'Hello!' });
+     * ```
+     */
   }, {
     key: "chat",
     value: function chat(content) {
       var _this$providerRef$cur4;
       (_this$providerRef$cur4 = this.providerRef.current) === null || _this$providerRef$cur4 === void 0 || _this$providerRef$cur4.startChat(content);
     }
+
+    /**
+     * 停止当前消息生成
+     */
   }, {
     key: "stop",
     value: function stop() {
       var _this$providerRef$cur5;
       (_this$providerRef$cur5 = this.providerRef.current) === null || _this$providerRef$cur5 === void 0 || _this$providerRef$cur5.stopChat();
     }
+
+    /**
+     * 清空当前会话
+     */
+  }, {
+    key: "clear",
+    value: function clear() {
+      var _this$providerRef$cur6;
+      (_this$providerRef$cur6 = this.providerRef.current) === null || _this$providerRef$cur6 === void 0 || _this$providerRef$cur6.clearChat();
+    }
+
+    /**
+     * 删除指定会话
+     * @param sessionId - 会话 ID
+     */
+  }, {
+    key: "deleteSession",
+    value: function deleteSession(sessionId) {
+      var _this$providerRef$cur7;
+      (_this$providerRef$cur7 = this.providerRef.current) === null || _this$providerRef$cur7 === void 0 || _this$providerRef$cur7.deleteSession(sessionId);
+    }
+
+    /**
+     * 更新会话标题
+     * @param sessionId - 会话 ID
+     * @param title - 新标题
+     */
+  }, {
+    key: "updateSession",
+    value: function updateSession(sessionId, title) {
+      var _this$providerRef$cur8;
+      (_this$providerRef$cur8 = this.providerRef.current) === null || _this$providerRef$cur8 === void 0 || _this$providerRef$cur8.updateSession(sessionId, title);
+    }
+
+    /**
+     * 切换到指定会话
+     * @param sessionId - 会话 ID
+     */
+  }, {
+    key: "switchSession",
+    value: function switchSession(sessionId) {
+      var _this$providerRef$cur9;
+      (_this$providerRef$cur9 = this.providerRef.current) === null || _this$providerRef$cur9 === void 0 || _this$providerRef$cur9.setCurrentSessionDetail(sessionId);
+    }
   }], [{
     key: "initChatbot",
     value: function initChatbot(props) {
@@ -99,13 +234,13 @@ var XAiWebSDK = /*#__PURE__*/function () {
           container = existingContainer;
         } else {
           // 如果指定的 ID 不存在，创建新元素
-          container = document.createElement('div');
+          container = document.createElement("div");
           container.id = props.componentProps.id;
         }
       } else {
         // 没有指定 ID，创建默认容器
-        container = document.createElement('div');
-        container.id = 'xai-chatbot-container';
+        container = document.createElement("div");
+        container.id = "xai-chatbot-container";
       }
 
       // 设置容器样式 - 将除了 id 以外的所有属性都应用到容器
@@ -123,7 +258,10 @@ var XAiWebSDK = /*#__PURE__*/function () {
       return new XAiWebSDK(container, props);
     }
 
-    // 兼容旧版本的静态方法
+    /**
+     * 兼容旧版本的静态方法
+     * @deprecated 使用 initChatbot 替代
+     */
   }, {
     key: "create",
     value: function create(props) {