paul-ai-assistant 1.0.6 → 1.0.7

package/es/AssistantChat/AssistantChatCard/OperationCard/AigcTipsRender/index.js

@@ -9,7 +9,7 @@ var AigcTipsRender = function AigcTipsRender(props) {
   var _ctx$meta;
   var ctx = props.ctx,
     _props$showAigcTips = props.showAigcTips,
-    showAigcTips = _props$showAigcTips === void 0 ? true : _props$showAigcTips;
+    showAigcTips = _props$showAigcTips === void 0 ? false : _props$showAigcTips;
   var _ref = (ctx === null || ctx === void 0 || (_ctx$meta = ctx.meta) === null || _ctx$meta === void 0 ? void 0 : _ctx$meta.originData) || {},
     dataInfo = _ref.dataInfo;
   var headerTips = useMemo(function () {

package/es/context/index.js

@@ -4,14 +4,14 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
-var _excluded = ["children", "bizId", "bizDomain", "locateAfterSingleMessageUpdate", "dataSource", "interruptLlmMessageScroll", "toolConfig", "placeholder", "messageCardWidth", "enableWsConnectCallback", "onSend", "assistantChat", "log", "logTrace", "messagesMaxLength", "mode", "activeToken", "onStopMessage", "imConnectCallback", "chatTitle", "isAssistant", "isThirdEmbed", "getApiHost"],
+var _excluded = ["children", "bizId", "bizDomain", "locateAfterSingleMessageUpdate", "dataSource", "interruptLlmMessageScroll", "toolConfig", "placeholder", "messageCardWidth", "enableWsConnectCallback", "onSend", "assistantChat", "log", "logTrace", "messagesMaxLength", "mode", "activeToken", "onStopMessage", "imConnectCallback", "chatTitle", "isAssistant", "isThirdEmbed", "getApiHost", "subjectId", "autoConnect", "autoSendMessage", "onConnectionReady", "onSendSuccess", "onSendError"],
   _excluded2 = ["chatType", "onSuccessCallback"];
 import React, { createContext, useEffect, useRef, useState } from 'react';
 import { event } from "../utils/event";
 import { getWorkId } from "../utils/helpers";
 import { FEATURE_MODE_TYPE_KEY } from "../components/ModelSelect/const";
 import { ASSIST_CHAT_EVENT } from "../constants/assistChatEvent";
-import { CHAT_TYPE, ChatTypeEnum, COPILOT_TOOL_TYPE_ENUM, initPlaceholder } from "../constants/common";
+import { CHAT_TYPE, ChatTypeEnum, COPILOT_TOOL_TYPE_ENUM, initPlaceholder, REQUEST_SUCCESS_CODE } from "../constants/common";
 import { LOG_TRACE_TYPE_ENUMS } from "../constants/logTrace";
 import { ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS, disconnectAssistantWs, startAssistantWs } from "../utils/apushAssistant";
 import { triggerPlugin } from "../utils/clientPlugin";
@@ -21,17 +21,53 @@ import { AesCustomLogEventEnum, setAesCustomEvent } from "../utils/log";
 import { updateMessageList, updateMessageValue, updateSingleMessage } from "./utils/messages";
 import { clickSendMessage, sendMessageRequest, stopMessage, successCallback } from "./utils/send";
 import { clearContext, initTools, searchTools } from "./utils/tool";
+import { getConversationConnection } from "../service/conversation";
+import { useAutoSend } from "../hooks/useAutoSend";
+
+// ======================================= URL 参数工具函数 =======================================
+var SUBJECT_ID_URL_PARAM = 'subjectId';
+
+/**
+ * 从 URL 中读取 subjectId 参数
+ */
+var getSubjectIdFromUrl = function getSubjectIdFromUrl() {
+  if (typeof window === 'undefined') return null;
+  var urlParams = new URLSearchParams(window.location.search);
+  return urlParams.get(SUBJECT_ID_URL_PARAM);
+};
+
+/**
+ * 将 subjectId 写入 URL（使用 history.pushState 产生浏览历史）
+ * 只有当 URL 中的 subjectId 与传入的不同时才更新
+ */
+var updateUrlWithSubjectId = function updateUrlWithSubjectId(subjectId) {
+  if (typeof window === 'undefined') return;
+
+  // 获取当前 URL 中的 subjectId
+  var currentSubjectId = getSubjectIdFromUrl();
+  var newSubjectId = String(subjectId);
+
+  // 如果 subjectId 没有变化，不更新 URL
+  if (currentSubjectId === newSubjectId) {
+    return;
+  }
+  var url = new URL(window.location.href);
+  url.searchParams.set(SUBJECT_ID_URL_PARAM, newSubjectId);
+  window.history.pushState({
+    subjectId: newSubjectId
+  }, '', url.toString());
+};
 export var AssistantChatContext = /*#__PURE__*/createContext({
   bizId: '',
-  bizDomain: 'CSE',
+  bizDomain: 'CHAT',
   messagesLoading: true
 });
 var AssistantChatProvider = function AssistantChatProvider() {
   var props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
   var children = props.children,
-    bizId = props.bizId,
+    propBizId = props.bizId,
     _props$bizDomain = props.bizDomain,
-    bizDomain = _props$bizDomain === void 0 ? 'CSE' : _props$bizDomain,
+    bizDomain = _props$bizDomain === void 0 ? 'CHAT' : _props$bizDomain,
     _props$locateAfterSin = props.locateAfterSingleMessageUpdate,
     locateAfterSingleMessageUpdate = _props$locateAfterSin === void 0 ? true : _props$locateAfterSin,
     dataSource = props.dataSource,
@@ -45,7 +81,7 @@ var AssistantChatProvider = function AssistantChatProvider() {
     _props$enableWsConnec = props.enableWsConnectCallback,
     enableWsConnectCallback = _props$enableWsConnec === void 0 ? false : _props$enableWsConnec,
     onSend = props.onSend,
-    assistantChat = props.assistantChat,
+    propAssistantChat = props.assistantChat,
     _props$log = props.log,
     log = _props$log === void 0 ? setAesCustomEvent : _props$log,
     logTrace = props.logTrace,
@@ -61,44 +97,63 @@ var AssistantChatProvider = function AssistantChatProvider() {
     isAssistant = _props$isAssistant === void 0 ? false : _props$isAssistant,
     isThirdEmbed = props.isThirdEmbed,
     getApiHost = props.getApiHost,
+    subjectId = props.subjectId,
+    _props$autoConnect = props.autoConnect,
+    autoConnect = _props$autoConnect === void 0 ? true : _props$autoConnect,
+    autoSendMessage = props.autoSendMessage,
+    onConnectionReady = props.onConnectionReady,
+    onSendSuccess = props.onSendSuccess,
+    onSendError = props.onSendError,
     otherProps = _objectWithoutProperties(props, _excluded);
+
+  // 内部维护的 bizId，支持自动获取会话时使用
+  var _useState = useState(propBizId),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalBizId = _useState2[0],
+    setInternalBizId = _useState2[1];
+  // 实际使用的 bizId：优先使用外部传入的，其次使用内部状态
+  var bizId = propBizId || internalBizId;
+  // 标记是否已自动发送过消息
+  var autoSendDoneRef = useRef(false);
+  // 标记是否正在获取会话连接
+  var isConnectingRef = useRef(false);
   // 是否受控数据
   var hasDefaultDataSource = dataSource && Array.isArray(dataSource);
   // 消息流
-  var _useState = useState([]),
-    _useState2 = _slicedToArray(_useState, 2),
-    messages = _useState2[0],
-    setMessageList = _useState2[1];
-  var _useState3 = useState(true),
+  var _useState3 = useState([]),
     _useState4 = _slicedToArray(_useState3, 2),
-    messagesLoading = _useState4[0],
-    setMessagesLoading = _useState4[1];
+    messages = _useState4[0],
+    setMessageList = _useState4[1];
+  var _useState5 = useState(true),
+    _useState6 = _slicedToArray(_useState5, 2),
+    messagesLoading = _useState6[0],
+    setMessagesLoading = _useState6[1];
 
   // 工具展示List
-  var _useState5 = useState([]),
-    _useState6 = _slicedToArray(_useState5, 2),
-    toolShowList = _useState6[0],
-    setToolShowList = _useState6[1];
-  var _useState7 = useState(false),
+  var _useState7 = useState([]),
     _useState8 = _slicedToArray(_useState7, 2),
-    showAddTag = _useState8[0],
-    setShowAddTag = _useState8[1];
-
-  // 分享模式相关状态
+    toolShowList = _useState8[0],
+    setToolShowList = _useState8[1];
   var _useState9 = useState(false),
     _useState10 = _slicedToArray(_useState9, 2),
-    shareMode = _useState10[0],
-    setShareMode = _useState10[1];
-  var _useState11 = useState([]),
+    showAddTag = _useState10[0],
+    setShowAddTag = _useState10[1];
+
+  // 分享模式相关状态
+  var _useState11 = useState(false),
     _useState12 = _slicedToArray(_useState11, 2),
-    selectedMessages = _useState12[0],
-    setSelectedMessages = _useState12[1];
+    shareMode = _useState12[0],
+    setShareMode = _useState12[1];
+  var _useState13 = useState([]),
+    _useState14 = _slicedToArray(_useState13, 2),
+    selectedMessages = _useState14[0],
+    setSelectedMessages = _useState14[1];
 
   // WebSocket 连接状态
-  var _useState13 = useState(null),
-    _useState14 = _slicedToArray(_useState13, 2),
-    wsConnectionStatus = _useState14[0],
-    setWsConnectionStatus = _useState14[1];
+  var _useState15 = useState(null),
+    _useState16 = _slicedToArray(_useState15, 2),
+    wsConnectionStatus = _useState16[0],
+    setWsConnectionStatus = _useState16[1];
   var chatAppRef = useRef(null);
   var chatInputRef = useRef(null);
   var messageListRef = useRef([]);
@@ -108,22 +163,27 @@ var AssistantChatProvider = function AssistantChatProvider() {
   var textAreaRef = useRef(null);
   // 请求版本号，用于忽略过时的 API 响应
   var requestVersionRef = useRef(0);
+
+  // 存储最新的 getMessageList 函数引用，避免闭包陷阱
+  var getMessageListRef = useRef();
+  // 防抖定时器 ref
+  var getMessageListDebounceRef = useRef();
   var inputFormRef = useRef(null);
-  var _useState15 = useState(null),
-    _useState16 = _slicedToArray(_useState15, 2),
-    inputFormSchema = _useState16[0],
-    setInputFormSchema = _useState16[1];
+  var _useState17 = useState(null),
+    _useState18 = _slicedToArray(_useState17, 2),
+    inputFormSchema = _useState18[0],
+    setInputFormSchema = _useState18[1];
   // 当前消息id
   var currentUpdateMessageIdRef = useRef(null);
   // 当前消息id index
   var currentUpdateMessageIndexRef = useRef(-1);
-  var _useState17 = useState({
+  var _useState19 = useState({
       thinkingMode: FEATURE_MODE_TYPE_KEY.AUTO,
       webSearchMode: FEATURE_MODE_TYPE_KEY.AUTO
     }),
-    _useState18 = _slicedToArray(_useState17, 2),
-    featureConfig = _useState18[0],
-    setFeatureConfig = _useState18[1];
+    _useState20 = _slicedToArray(_useState19, 2),
+    featureConfig = _useState20[0],
+    setFeatureConfig = _useState20[1];
   useEffect(function () {
     if (hasDefaultDataSource) {
       var _chatAppRef$current;
@@ -140,6 +200,68 @@ var AssistantChatProvider = function AssistantChatProvider() {
     }
   }, [dataSource, hasDefaultDataSource]);
 
+  // ======================================= 开箱即用：自动获取会话连接 =======================================
+  /**
+   * 自动获取会话连接逻辑
+   * 当 autoConnect 为 true 且没有传入 bizId 时，自动调用 API 获取会话连接
+   * 只在 CHAT 场景下生效
+   *
+   * 优先级：propBizId > URL参数中的subjectId > props中的subjectId > 自动创建新会话
+   */
+  useEffect(function () {
+    // 只有在 CHAT 模式下才启用自动连接
+    var isChatMode = mode === ChatTypeEnum.Chat || bizDomain === 'CHAT';
+    // 检查是否需要自动连接：启用自动连接 && 没有外部传入的 bizId && 是 CHAT 模式 && 不在连接中
+    var shouldAutoConnect = autoConnect && !propBizId && isChatMode && !isConnectingRef.current;
+    if (shouldAutoConnect) {
+      isConnectingRef.current = true;
+
+      // 优先从 URL 读取 subjectId，其次使用 props 中的 subjectId
+      var urlSubjectId = getSubjectIdFromUrl();
+      var effectiveSubjectId = urlSubjectId || subjectId;
+      getConversationConnection({
+        bizDomain: 'CHAT',
+        subjectId: effectiveSubjectId
+      }).then(function (res) {
+        if ((res === null || res === void 0 ? void 0 : res.code) === REQUEST_SUCCESS_CODE) {
+          var connectionInfo = res.data;
+          // 更新内部 bizId
+          setInternalBizId(connectionInfo.subjectId);
+          // 将 subjectId 持久化到 URL
+          updateUrlWithSubjectId(connectionInfo.subjectId);
+          // 触发回调
+          onConnectionReady === null || onConnectionReady === void 0 || onConnectionReady(connectionInfo);
+        } else {
+          console.warn('自动获取会话连接失败:', res === null || res === void 0 ? void 0 : res.message);
+        }
+      }).catch(function (error) {
+        console.error('自动获取会话连接出错:', error);
+      }).finally(function () {
+        isConnectingRef.current = false;
+      });
+    }
+  }, [autoConnect, propBizId, subjectId, mode, bizDomain]);
+
+  // 当 propBizId 变化时，同步更新内部状态
+  useEffect(function () {
+    if (propBizId) {
+      setInternalBizId(propBizId);
+    }
+  }, [propBizId]);
+
+  // ======================================= 内置 onSend 逻辑 =======================================
+  /**
+   * 使用 useAutoSend Hook 获取有效的 onSend 方法
+   * 如果用户传入了 onSend，使用用户的；否则使用内置逻辑
+   */
+  var effectiveOnSend = useAutoSend({
+    bizId: bizId,
+    bizDomain: bizDomain,
+    onSend: onSend,
+    onSendSuccess: onSendSuccess,
+    onSendError: onSendError
+  });
+
   // ======================================= log埋点 =======================================
   /**
    *  辅助交互通用监控日志上报
@@ -169,27 +291,38 @@ var AssistantChatProvider = function AssistantChatProvider() {
   };
 
   // ======================================= 消息更新 =======================================
-  // 拉取消息列表
+  // 拉取消息列表（带防抖机制）
   var getMessageList = function getMessageList() {
-    var _chatInputRef$current;
     var isInit = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
     var scroll = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-    updateMessageList({
-      bizId: bizId,
-      bizDomain: bizDomain,
-      messagesMaxLength: messagesMaxLength,
-      setMessagesLoading: setMessagesLoading,
-      currentUpdateMessageIdRef: currentUpdateMessageIdRef,
-      messageListRef: messageListRef,
-      setMessageList: setMessageList,
-      chatAppRef: chatAppRef,
-      currentUpdateMessageIndexRef: currentUpdateMessageIndexRef,
-      isInit: isInit,
-      scroll: scroll,
-      setSendMessageDisabled: chatInputRef === null || chatInputRef === void 0 || (_chatInputRef$current = chatInputRef.current) === null || _chatInputRef$current === void 0 ? void 0 : _chatInputRef$current.setSendMessageDisabled,
-      requestVersionRef: requestVersionRef
-    });
+    // 清除之前的定时器，实现防抖
+    if (getMessageListDebounceRef.current) {
+      clearTimeout(getMessageListDebounceRef.current);
+    }
+
+    // 使用 50ms 防抖，防止短时间内多次调用产生多个请求
+    getMessageListDebounceRef.current = setTimeout(function () {
+      var _chatInputRef$current;
+      updateMessageList({
+        bizId: bizId,
+        bizDomain: bizDomain,
+        messagesMaxLength: messagesMaxLength,
+        setMessagesLoading: setMessagesLoading,
+        currentUpdateMessageIdRef: currentUpdateMessageIdRef,
+        messageListRef: messageListRef,
+        setMessageList: setMessageList,
+        chatAppRef: chatAppRef,
+        currentUpdateMessageIndexRef: currentUpdateMessageIndexRef,
+        isInit: isInit,
+        scroll: scroll,
+        setSendMessageDisabled: chatInputRef === null || chatInputRef === void 0 || (_chatInputRef$current = chatInputRef.current) === null || _chatInputRef$current === void 0 ? void 0 : _chatInputRef$current.setSendMessageDisabled,
+        requestVersionRef: requestVersionRef
+      });
+    }, 50);
   };
+
+  // 更新 ref 为最新的 getMessageList 函数
+  getMessageListRef.current = getMessageList;
   var initMessageList = function initMessageList() {
     getMessageList === null || getMessageList === void 0 || getMessageList(true);
   };
@@ -237,6 +370,19 @@ var AssistantChatProvider = function AssistantChatProvider() {
             if (imConnectCallback && typeof imConnectCallback === 'function') {
               imConnectCallback();
             }
+            // 开箱即用：自动发送消息
+            if (autoSendMessage && !autoSendDoneRef.current) {
+              autoSendDoneRef.current = true;
+              // 延迟一下，确保消息列表已加载
+              setTimeout(function () {
+                effectiveOnSend === null || effectiveOnSend === void 0 || effectiveOnSend({
+                  params: {
+                    query: autoSendMessage
+                  },
+                  featureConfig: featureConfig
+                }, function () {});
+              }, 100);
+            }
           },
           log: log,
           // 连接状态变化回调
@@ -294,12 +440,12 @@ var AssistantChatProvider = function AssistantChatProvider() {
     };
   }, [bizId]);
   useEffect(function () {
-    // 监听全部list
-    var listenerGetMessageList = function listenerGetMessageList(x) {
-      var _logTrace$closeTrace;
+    // 监听全部list - 使用 ref 调用最新的 getMessageList 函数，避免闭包陷阱
+    var listenerGetMessageList = function listenerGetMessageList() {
+      var _logTrace$closeTrace, _getMessageListRef$cu;
       logTrace === null || logTrace === void 0 || (_logTrace$closeTrace = logTrace.closeTrace) === null || _logTrace$closeTrace === void 0 || _logTrace$closeTrace.call(logTrace, LOG_TRACE_TYPE_ENUMS.LLM_GET_MESSAGE_LIET_APUSH, window.currentMessageSendTimestamp);
       window.currentMessageSendTimestamp = undefined;
-      getMessageList();
+      (_getMessageListRef$cu = getMessageListRef.current) === null || _getMessageListRef$cu === void 0 || _getMessageListRef$cu.call(getMessageListRef);
     };
     // 监听单条数据
     var listenerGetSingleMessage = function listenerGetSingleMessage(argJson) {
@@ -343,22 +489,26 @@ var AssistantChatProvider = function AssistantChatProvider() {
         chatInputRef === null || chatInputRef === void 0 || (_chatInputRef$current9 = chatInputRef.current) === null || _chatInputRef$current9 === void 0 || (_chatInputRef$current10 = _chatInputRef$current9.setSendMessageDisabled) === null || _chatInputRef$current10 === void 0 || _chatInputRef$current10.call(_chatInputRef$current9, false);
       }
     };
-    if (!hasDefaultDataSource) {
-      // 消息受控，不再监听消息列表刷新
+
+    // 保存当前 hasDefaultDataSource 值用于 cleanup，确保清理时使用相同的条件
+    var shouldListen = !hasDefaultDataSource;
+    if (shouldListen) {
+      // 消息非受控，监听消息列表刷新
       event.on(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_GET_MESSAGE_LIST, listenerGetMessageList);
       event.on(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_GET_MESSAGE, listenerGetSingleMessage);
     }
     event.on(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_LLM_STREAM_MESSAGE, updateStreamMessage);
     event.on(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_LLM_TRACE_MESSAGE, updateTraceMessage);
     return function () {
-      if (!hasDefaultDataSource) {
+      if (shouldListen) {
         event.off(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_GET_MESSAGE_LIST, listenerGetMessageList);
         event.off(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_GET_MESSAGE, listenerGetSingleMessage);
       }
       event.off(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_LLM_STREAM_MESSAGE, updateStreamMessage);
       event.off(ASSISTANT_APUSH_MESSAGE_TYPE_ENUMS.COPILOT_LLM_TRACE_MESSAGE, updateTraceMessage);
     };
-  }, [bizId]);
+  }, [bizId, hasDefaultDataSource]); // 添加 hasDefaultDataSource 依赖，确保条件变化时正确清理和重新注册 listener
+
   useEffect(function () {
     var updateInputValue = function updateInputValue(_value) {
       var _chatInputRef$current11, _chatInputRef$current12;
@@ -395,7 +545,7 @@ var AssistantChatProvider = function AssistantChatProvider() {
       chatType: chatType
     }, otherSendProps);
     sendMessageRequest({
-      onSend: onSend,
+      onSend: effectiveOnSend,
       sendInfoQuery: sendInfoQuery,
       onSuccessCallback: onSuccessCallback
       // setSendMessageDisabled: chatInputRef?.current?.setSendMessageDisabled,
@@ -720,9 +870,12 @@ var AssistantChatProvider = function AssistantChatProvider() {
     placeholder: placeholder,
     messageCardWidth: messageCardWidth,
     enableWsConnectCallback: enableWsConnectCallback,
-    onSend: onSend,
-    assistantChat: assistantChat,
+    // 使用有效的 onSend（可能是用户传入的，也可能是内置的）
+    onSend: effectiveOnSend,
+    assistantChat: propAssistantChat,
     isAssistant: isAssistant,
+    // WebSocket 连接状态
+    wsConnectionStatus: wsConnectionStatus,
     textAreaRef: textAreaRef,
     messages: messages,
     setMessageList: setMessageList,

package/es/hooks/index.js

@@ -0,0 +1 @@
+export { useAutoSend } from "./useAutoSend";

package/es/hooks/useAutoSend.js

@@ -0,0 +1,95 @@
+import { useCallback, useRef, useEffect } from 'react';
+import { assistantChat } from "../service/conversation";
+import { getAssistantWsStatus, reconnectAssistantWs } from "../utils/apushAssistant";
+import { REQUEST_SUCCESS_CODE } from "../constants/common";
+/**
+ * 内置自动发送消息逻辑的 Hook
+ * 如果用户传入了 onSend，直接返回用户的 onSend
+ * 否则返回内置的发送逻辑
+ */
+export function useAutoSend(props) {
+  var bizId = props.bizId,
+    _props$bizDomain = props.bizDomain,
+    bizDomain = _props$bizDomain === void 0 ? 'CHAT' : _props$bizDomain,
+    userOnSend = props.onSend,
+    onSendSuccess = props.onSendSuccess,
+    onSendError = props.onSendError;
+  var pendingSendRef = useRef(null);
+
+  // 监听 WebSocket 连接状态，处理待发送消息
+  useEffect(function () {
+    if (pendingSendRef.current) {
+      var _getAssistantWsStatus;
+      var status = (getAssistantWsStatus === null || getAssistantWsStatus === void 0 || (_getAssistantWsStatus = getAssistantWsStatus()) === null || _getAssistantWsStatus === void 0 ? void 0 : _getAssistantWsStatus.status) || 'disconnected';
+      if (status === 'connected') {
+        var pendingSend = pendingSendRef.current;
+        pendingSendRef.current = null;
+        pendingSend();
+      }
+    }
+  }, [bizId]);
+
+  // 内置 onSend 逻辑
+  var internalOnSend = useCallback(function (data, onSuccessCallback) {
+    var _getAssistantWsStatus2;
+    var _ref = (data === null || data === void 0 ? void 0 : data.params) || {},
+      query = _ref.query;
+    if (!bizId) {
+      console.warn('useAutoSend: bizId is required for sending message');
+      onSendError === null || onSendError === void 0 || onSendError(new Error('bizId is required'));
+      return;
+    }
+    var doSend = function doSend() {
+      var _data$params;
+      assistantChat({
+        subjectId: String(bizId),
+        content: query,
+        featureConfig: (data === null || data === void 0 ? void 0 : data.featureConfig) || {},
+        attachments: (data === null || data === void 0 || (_data$params = data.params) === null || _data$params === void 0 ? void 0 : _data$params.attachments) || []
+      }).then(function (res) {
+        if ((res === null || res === void 0 ? void 0 : res.code) === REQUEST_SUCCESS_CODE) {
+          onSuccessCallback === null || onSuccessCallback === void 0 || onSuccessCallback(res);
+          onSendSuccess === null || onSendSuccess === void 0 || onSendSuccess(res);
+        } else {
+          onSendError === null || onSendError === void 0 || onSendError(res);
+        }
+      }).catch(function (error) {
+        console.error('useAutoSend: send message failed', error);
+        onSendError === null || onSendError === void 0 || onSendError(error);
+      });
+    };
+
+    // 检查 WebSocket 连接状态
+    var status = (getAssistantWsStatus === null || getAssistantWsStatus === void 0 || (_getAssistantWsStatus2 = getAssistantWsStatus()) === null || _getAssistantWsStatus2 === void 0 ? void 0 : _getAssistantWsStatus2.status) || 'disconnected';
+    if (status === 'connected') {
+      doSend();
+    } else {
+      // 保存待发送消息
+      pendingSendRef.current = doSend;
+
+      // 如果连接断开，触发重连
+      if (status === 'disconnected') {
+        reconnectAssistantWs === null || reconnectAssistantWs === void 0 || reconnectAssistantWs({
+          bizId: String(bizId),
+          bizDomain: bizDomain
+        });
+      }
+
+      // 设置超时，避免无限等待
+      setTimeout(function () {
+        if (pendingSendRef.current === doSend) {
+          pendingSendRef.current = null;
+          // 超时后直接尝试发送
+          doSend();
+        }
+      }, 5000);
+    }
+  }, [bizId, bizDomain, onSendSuccess, onSendError]);
+
+  // 如果用户传入了 onSend，直接返回用户的
+  if (userOnSend) {
+    return userOnSend;
+  }
+  return internalOnSend;
+}
+export default useAutoSend;

package/es/index.js

@@ -25,6 +25,9 @@ import { ASSIST_CHAT_EVENT } from "./constants/assistChatEvent";
 import { BIZ_DOMAIN_TYPE } from "./constants/common";
 import ErrorBoundary from "./ErrorBoundary";
 import { parseLlmComponentUrl } from "./utils/parseUrl";
+// 开箱即用相关导出
+import { getConversationConnection, assistantChat } from "./service/conversation";
+import { useAutoSend } from "./hooks/useAutoSend";
 import "./index.scss";
 
 // 导出大模型卡片组件
@@ -60,4 +63,8 @@ registerAssistChatForm,
 // 表单组件
 PaulButtonGroupProps, SelectBlurry, ArrayInput,
 // utils
-parseLlmComponentUrl, ShareContent };
+parseLlmComponentUrl, ShareContent,
+// 开箱即用相关
+getConversationConnection, assistantChat, useAutoSend };
+
+// 导出开箱即用相关类型

package/es/service/conversation.js

@@ -0,0 +1,74 @@
+import _regeneratorRuntime from "@babel/runtime/helpers/esm/regeneratorRuntime";
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import { customRequest } from "../utils/request";
+
+/**
+ * 会话连接信息
+ */
+
+/**
+ * 获取会话连接 API 响应
+ */
+
+/**
+ * 获取会话连接信息
+ * 用于自动创建或获取现有会话
+ * @param params 请求参数
+ * @returns Promise<IConversationConnectionResponse>
+ */
+export function getConversationConnection(_x) {
+  return _getConversationConnection.apply(this, arguments);
+}
+
+/**
+ * 发送聊天消息
+ * @param params 消息参数
+ * @returns Promise<any>
+ */
+function _getConversationConnection() {
+  _getConversationConnection = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(params) {
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          return _context.abrupt("return", customRequest({
+            method: 'GET',
+            url: '/cognipilot/api/conversation/connection',
+            query: {
+              bizDomain: params.bizDomain || 'CHAT',
+              subjectId: params.subjectId
+            }
+          }));
+        case 1:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _getConversationConnection.apply(this, arguments);
+}
+export function assistantChat(_x2) {
+  return _assistantChat.apply(this, arguments);
+}
+function _assistantChat() {
+  _assistantChat = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(params) {
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          return _context2.abrupt("return", customRequest({
+            method: 'POST',
+            url: '/cognipilot/api/assistant/chat',
+            query: {
+              subjectId: params.subjectId,
+              content: params.content,
+              featureConfig: params.featureConfig || {},
+              attachments: params.attachments || []
+            }
+          }));
+        case 1:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return _assistantChat.apply(this, arguments);
+}

package/es/service/index.js

@@ -0,0 +1 @@
+export { getConversationConnection, assistantChat } from "./conversation";

package/es/utils/apushAssistant.js

@@ -51,29 +51,38 @@ var msgCallback = function msgCallback(v) {
     return;
   }
 
-  // 检查 ticketId 是否匹配
+  // 检查 ticketId 或 subjectId 是否匹配
+  // STREAM 消息使用 subjectId，其他消息使用 ticketId
   var ticketId = argJson === null || argJson === void 0 ? void 0 : argJson.ticketId;
-  var isMatch = ticketId === bizId;
+  var subjectId = argJson === null || argJson === void 0 ? void 0 : argJson.subjectId;
+  var isMatch = ticketId === bizId || subjectId === bizId;
   if (isMatch) {
     event.emit(msgType, argJson);
     logger.debug('消息已分发', {
       msgType: msgType,
-      ticketId: ticketId
+      ticketId: ticketId,
+      subjectId: subjectId
     });
   } else {
     // 消息被过滤，记录调试日志
-    logger.debug('消息 ticketId 不匹配，已过滤', {
+    logger.debug('消息 ticketId/subjectId 不匹配，已过滤', {
       expected: bizId,
-      received: ticketId,
+      receivedTicketId: ticketId,
+      receivedSubjectId: subjectId,
       msgType: msgType
     });
   }
 };
-var callback = function callback(msgBody, bizId) {
+var callback = function callback(message, bizId) {
   try {
+    // message 是完整的 WebSocket 消息对象，真正的消息体在 message.msgBody 中
+    var msgBody = (message === null || message === void 0 ? void 0 : message.msgBody) || message;
     var _ref3 = msgBody || {},
-      version = _ref3.version,
-      msgDetail = _ref3.msgDetail;
+      msgVersion = _ref3.msgVersion,
+      msgDetail = _ref3.msgDetail,
+      msgType = _ref3.msgType;
+    // 兼容旧版本的 version 字段
+    var version = msgVersion || (msgBody === null || msgBody === void 0 ? void 0 : msgBody.version);
     if (version === '1.0.0') {
       var _msgDetail$, _msgDetail$2;
       if (msgDetail !== null && msgDetail !== void 0 && (_msgDetail$ = msgDetail[0]) !== null && _msgDetail$ !== void 0 && _msgDetail$.arg && msgDetail !== null && msgDetail !== void 0 && (_msgDetail$2 = msgDetail[0]) !== null && _msgDetail$2 !== void 0 && _msgDetail$2.app) {
@@ -94,8 +103,8 @@ var callback = function callback(msgBody, bizId) {
     } else if (version === '2.0.0' || !version) {
       // version 不传默认为 2.0.0
       msgCallback({
-        msgType: msgBody === null || msgBody === void 0 ? void 0 : msgBody.msgType,
-        arg: msgBody === null || msgBody === void 0 ? void 0 : msgBody.msgDetail,
+        msgType: msgType,
+        arg: msgDetail,
         bizId: bizId
       });
     }
@@ -241,11 +250,11 @@ export var startAssistantWs = function startAssistantWs(wsProps) {
       });
     }
   };
+  console.log(appId, userId, '=====');
   var im = new IM(_objectSpread({
     url: url,
     appKey: "".concat(appId, ",").concat(userId),
     // appKey: `${appId},1000`,
-
     commonParams: {
       appId: appId,
       userId: userId

package/es/utils/im.js

@@ -1,5 +1,4 @@
 import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
-import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _regeneratorRuntime from "@babel/runtime/helpers/esm/regeneratorRuntime";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
@@ -205,36 +204,46 @@ var IM = /*#__PURE__*/function () {
       return connect;
     }()
     /**
-     * 构建 WebSocket URL
+     * 解析 JWT token 的 payload
      */
     )
   }, {
-    key: "buildUrl",
-    value: function buildUrl(token) {
-      var url = new URL(this.url);
-
-      // 添加通用参数
-      if (this.commonParams) {
-        Object.entries(this.commonParams).forEach(function (_ref) {
-          var _ref2 = _slicedToArray(_ref, 2),
-            key = _ref2[0],
-            value = _ref2[1];
-          if (value !== undefined && value !== null) {
-            url.searchParams.set(key, String(value));
-          }
-        });
+    key: "parseJwtPayload",
+    value: function parseJwtPayload(token) {
+      try {
+        var parts = token.split('.');
+        if (parts.length !== 3) {
+          return null;
+        }
+        // Base64Url 解码
+        var payload = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+        var decoded = atob(payload);
+        return JSON.parse(decoded);
+      } catch (e) {
+        logger.error('JWT 解析失败', e);
+        return null;
       }
+    }
 
-      // 添加 appKey
-      if (this.appKey) {
-        url.searchParams.set('appKey', this.appKey);
-      }
+    /**
+     * 构建 WebSocket URL
+     * 格式：wss://domain/paulWebPush/ws?param={bizDomain},{userId},{token}
+     * 其中 userId 从 token 的 payload 中获取
+     */
+  }, {
+    key: "buildUrl",
+    value: function buildUrl(token) {
+      var _this$commonParams;
+      var bizDomain = ((_this$commonParams = this.commonParams) === null || _this$commonParams === void 0 ? void 0 : _this$commonParams.appId) || '';
 
-      // 添加 token
+      // 从 token 中解析 userId
+      var userId = '';
       if (token) {
-        url.searchParams.set('token', token);
+        var payload = this.parseJwtPayload(token);
+        userId = (payload === null || payload === void 0 ? void 0 : payload.userId) || '';
       }
-      return url.toString();
+      var param = "".concat(bizDomain, ",").concat(userId, ",").concat(token || '');
+      return "".concat(this.url, "?param=").concat(param);
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paul-ai-assistant",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Paul AI 智能辅助组件",
   "keywords": [
     "Magic Workbench",
@@ -39,6 +39,7 @@
     "prettier": "prettier --write \"src/**/*.{js,jsx,tsx,ts,less,scss,md,json}\" --end-of-line auto",
     "prepublish": "npm run build:docs",
     "publish:beta": "npm run build && tnpm publish",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access=public",
     "publish:prod": "npm run build && tnpm publish",
     "start": "dumi dev",
     "test": "jest",