Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

18.8 KB
Raw Blame
<template>
  <div class="embed-chat">
    <div ref="scrollContainer" class="embed-chat__scroll" @scroll="handleScroll">
      <div class="embed-chat__messages">
        <div v-if="historyLoading && messagesList.length === 0 && !hasWelcomeText" class="msg-skeleton-list">
          <div class="msg-skeleton msg-skeleton-user"><div class="sk-line sk-line--short" /></div>
          <div class="msg-skeleton msg-skeleton-bot">
            <div class="sk-line" />
            <div class="sk-line" />
            <div class="sk-line sk-line--medium" />
          </div>
        </div>

        <div
          v-if="showWelcome"
          class="embed-welcome-bubble"
        >
          <p class="embed-welcome-bubble__text">{{ welcomeText }}</p>
        </div>

        <div
          v-if="showSuggestedBlock"
          class="embed-suggested"
        >
          <p v-if="suggestedQuestions.length > 0" class="embed-suggested__title">
            {{ t('chat.suggestedQuestions') }}
          </p>
          <div v-if="suggestedLoading && suggestedQuestions.length === 0" class="embed-suggested__grid">
            <div v-for="n in 4" :key="`sq-skel-${n}`" class="embed-suggested__card embed-suggested__card--skeleton" />
          </div>
          <div v-else-if="suggestedQuestions.length > 0" class="embed-suggested__grid">
            <button
              v-for="item in suggestedQuestions"
              :key="item.question"
              type="button"
              class="embed-suggested__card"
              @click="handleSuggestedClick(item.question)"
            >
              <span class="embed-suggested__text">{{ item.question }}</span>
            </button>
          </div>
        </div>

        <div
          v-for="(session, index) in messagesList"
          :key="(session.id as string) || `${session.role}-${session.created_at}-${index}`"
          class="msg-item-wrapper"
        >
          <MessageTimestamp
            v-if="shouldShowConversationTimestamp(messagesList, index)"
            :value="session.created_at"
          />
          <div v-if="session.role === 'user'" class="message-row">
            <EmbedUserMessage
              :content="stripHostContextFromQuery(String(session.content || ''))"
              :mentioned_items="asUnknownArray(session.mentioned_items)"
              :images="asEmbedImages(session.images)"
              :attachments="asEmbedAttachments(session.attachments)"
              :embeddedMode="true"
              :embed-channel-id="channelId"
              :embed-token="token"
            />
          </div>
          <div v-if="session.role === 'assistant' && shouldRenderAssistantMessage(session)" class="message-row">
            <EmbedBotMessage
              :content="String(session.content || '')"
              :session="session"
              :session-id="sessionId"
              :user-query="getUserQuery(index)"
              :embedded-mode="true"
              :embed-channel-id="channelId"
              :embed-token="token"
              :embed-session-sig="sessionSig"
              :embed-visitor-id="visitorId"
            />
            <FollowUpSuggestions v-if="!session.suggestionsDismissed"
              :suggestion-set="session.suggestionSet as any"
              :loading="Boolean(session.suggestionLoading)"
              :allow-regenerate="Boolean((session.suggestionSet as any)?.allow_regenerate)"
              @select="(item) => handleFollowUpSelect(session, item)"
              @regenerate="loadFollowUpSuggestions(session, true, true)"
              @impression="(set) => recordFollowUpEvent(set, 'impression')"
              @dismiss="(set) => dismissFollowUps(session, set)" />
          </div>
        </div>

        <div v-if="showGlobalTypingIndicator" class="embed-chat__typing" role="status"
          :aria-label="t('chat.thinkingAlt')">
          <span class="embed-chat__typing-spinner" aria-hidden="true"></span>
        </div>
      </div>
    </div>

    <transition name="scroll-btn-fade">
      <div v-show="userHasScrolledUp" class="scroll-to-bottom-btn" @click="onClickScrollToBottom" aria-label="scroll to bottom">
        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true">
          <path d="M6 9l6 6 6-6" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
        </svg>
      </div>
    </transition>

    <div class="embed-chat__input">
      <PendingPromptDock
        embedded-mode
        :embed-channel-id="channelId"
        :embed-token="token"
        :embed-session-id="sessionId"
        :embed-session-sig="sessionSig"
        :embed-visitor-id="visitorId"
      />
      <EmbedInputField
        :isReplying="isReplying"
        :show-web-search-toggle="showWebSearchToggle"
        v-model:web-search-enabled="webSearchEnabled"
        :show-file-upload-toggle="showFileUploadToggle"
        @send-msg="onSendMsg"
        @stop-generation="handleStopGeneration"
      />
    </div>
    <ChatReferencesDrawer embedded-mode />
  </div>
</template>

<script setup lang="ts">
import { computed, onMounted, onUnmounted, ref, toRef, watch } from 'vue'
import { useI18n } from 'vue-i18n'
import {
  ensureEmbedMessageSuggestions,
  getEmbedMessageSuggestions,
  getEmbedSuggestedQuestions,
  onEmbedHostOpenWithQuery,
  recordEmbedMessageSuggestionEvent,
  type SuggestedQuestion,
} from '@/api/embed'
import EmbedInputField from '@/components/EmbedInputField.vue'
import EmbedBotMessage from '@/views/embed/EmbedBotMessage.vue'
import EmbedUserMessage from '@/views/embed/EmbedUserMessage.vue'
import ChatReferencesDrawer from '@/components/ChatReferencesDrawer.vue'
import PendingPromptDock from '@/views/chat/components/PendingPromptDock.vue'
import { providePromptDock } from '@/composables/usePromptDock'
import { provideChatReferencesDrawer } from '@/composables/useChatReferencesDrawer'
import { useEmbedChatSession } from '@/composables/useEmbedChatSession'
import { isAwaitingInput } from '@/composables/useChatStreamHandler'
import FollowUpSuggestions from '@/components/chat/FollowUpSuggestions.vue'
import MessageTimestamp from '@/components/chat/MessageTimestamp.vue'
import { shouldShowConversationTimestamp } from '@/utils/messageTimestamp'
import { stripHostContextFromQuery } from '@/utils/embedContext'
import type { MessageSuggestionItem, MessageSuggestionSet } from '@/api/message-suggestion'

provideChatReferencesDrawer()

type EmbedImage = { url?: string; data?: string }
type EmbedAttachment = { file_name: string; file_size?: number }

const props = defineProps<{
  sessionId: string
  sessionSig: string
  visitorId: string
  channelId: string
  token: string
  agentId: string
  kbIds: string[]
  welcomeMessage?: string
  showSuggestedQuestions?: boolean
  allowWebSearch?: boolean
  agentWebSearchEnabled?: boolean
  allowFileUpload?: boolean
  agentImageUploadEnabled?: boolean
  useSessionHeaderTitle?: boolean
  hostContext?: Record<string, unknown>
}>()

const emit = defineEmits<{
  (e: 'session-title', title: string): void
  (e: 'messages-state', hasMessages: boolean): void
}>()

const { t } = useI18n()
const sessionIdRef = toRef(props, 'sessionId')
const sessionSigRef = toRef(props, 'sessionSig')
const visitorIdRef = toRef(props, 'visitorId')
const suggestedQuestions = ref<SuggestedQuestion[]>([])
const suggestedLoading = ref(false)
const hostContextRef = ref<Record<string, unknown>>(props.hostContext || {})

const loadFollowUpSuggestions = async (
  message: Record<string, unknown>,
  ensure = false,
  regenerate = false,
) => {
  const messageId = String(message.id || message.assistant_message_id || '')
  const targetSessionId = props.sessionId
  if (!props.showSuggestedQuestions || !messageId || !targetSessionId || message.suggestionsDismissed) return
  if (isAwaitingInput(message)) return
  message.suggestionLoading = true
  try {
    let response = ensure
      ? await ensureEmbedMessageSuggestions(
        props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId, regenerate,
      )
      : await getEmbedMessageSuggestions(
        props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId,
      )
    let set = response?.data
    for (let attempt = 0; set?.status === 'generating' && attempt < 120; attempt++) {
      await new Promise((resolve) => setTimeout(resolve, 1000))
      if (props.sessionId !== targetSessionId || message.suggestionsDismissed) return
      response = await getEmbedMessageSuggestions(
        props.channelId, props.token, targetSessionId, messageId, props.sessionSig, props.visitorId,
      )
      set = response?.data
    }
    message.suggestionSet = set?.status === 'ready' ? set : null
  } catch {
    message.suggestionSet = null
  } finally {
    message.suggestionLoading = false
  }
}

const loadPersistedFollowUps = (messages: Record<string, unknown>[]) => {
  for (const message of messages) {
    if (message.role === 'assistant' && message.is_completed && message.suggestionSet === undefined) {
      void loadFollowUpSuggestions(message, false)
    }
  }
}

function asUnknownArray(value: unknown): unknown[] | undefined {
  return Array.isArray(value) ? value : undefined
}

function asEmbedImages(value: unknown): EmbedImage[] | undefined {
  return Array.isArray(value) ? value as EmbedImage[] : undefined
}

function asEmbedAttachments(value: unknown): EmbedAttachment[] | undefined {
  return Array.isArray(value) ? value as EmbedAttachment[] : undefined
}

const embedWebSearchStorageKey = () => `weknora-embed-web-search:${props.channelId}`

const readStoredWebSearchEnabled = () => {
  if (typeof localStorage === 'undefined') return false
  return localStorage.getItem(embedWebSearchStorageKey()) === '1'
}

const webSearchEnabled = ref(readStoredWebSearchEnabled())

const showWebSearchToggle = computed(
  () => props.allowWebSearch === true && props.agentWebSearchEnabled === true,
)
const showFileUploadToggle = computed(
  () => props.allowFileUpload === true && props.agentImageUploadEnabled === true,
)

watch(webSearchEnabled, (enabled) => {
  if (!showWebSearchToggle.value) return
  if (typeof localStorage === 'undefined') return
  localStorage.setItem(embedWebSearchStorageKey(), enabled ? '1' : '0')
})

watch(showWebSearchToggle, (visible) => {
  if (!visible) {
    webSearchEnabled.value = false
  }
})

watch(() => props.hostContext, (ctx) => {
  hostContextRef.value = ctx || {}
}, { deep: true })

const {
  messagesList,
  loading,
  isReplying,
  historyLoading,
  scrollContainer,
  userHasScrolledUp,
  shouldRenderAssistantMessage,
  shouldShowGlobalTypingIndicator,
  getUserQuery,
  handleScroll,
  scrollToBottom,
  onClickScrollToBottom,
  sendMsg,
  handleStopGeneration,
  setSuggestionAttribution,
} = useEmbedChatSession({
  sessionId: sessionIdRef,
  sessionSig: sessionSigRef,
  visitorId: visitorIdRef,
  channelId: props.channelId,
  token: props.token,
  agentId: props.agentId,
  kbIds: props.kbIds,
  allowWebSearch: props.allowWebSearch,
  allowFileUpload: props.allowFileUpload,
  hostContext: hostContextRef,
  onMessagesChange: (has) => emit('messages-state', has),
  onSessionTitle: (title) => {
    if (props.useSessionHeaderTitle) {
      emit('session-title', title)
    }
  },
  onTurnComplete: (message) => { void loadFollowUpSuggestions(message, true) },
  onMessagesLoaded: loadPersistedFollowUps,
})
providePromptDock(messagesList)

const welcomeText = computed(() => props.welcomeMessage?.trim() || '')
const hasWelcomeText = computed(() => welcomeText.value.length > 0)

const hasUserMessage = computed(() =>
  messagesList.some((m) => m.role === 'user'))

const showGlobalTypingIndicator = computed(() =>
  shouldShowGlobalTypingIndicator(messagesList, loading.value),
)

/** 访客未发言前始终展示欢迎语(含历史加载中),发送后隐藏 */
const showWelcome = computed(() => hasWelcomeText.value && !hasUserMessage.value)

const showSuggestedBlock = computed(() =>
  props.showSuggestedQuestions
  && !hasUserMessage.value
  && !loading.value
  && !historyLoading.value
  && (suggestedLoading.value || suggestedQuestions.value.length > 0))

const fetchSuggestedQuestions = async () => {
  if (!props.showSuggestedQuestions || !props.channelId || !props.token) {
    suggestedQuestions.value = []
    return
  }
  suggestedLoading.value = true
  try {
    const res = await getEmbedSuggestedQuestions(props.channelId, props.token)
    suggestedQuestions.value = res?.data?.questions || []
  } catch {
    suggestedQuestions.value = []
  } finally {
    suggestedLoading.value = false
  }
}

const onSendMsg = (
  query: string,
  imageFiles: File[] = [],
  attachmentFiles: File[] = [],
  onPrepared?: () => void,
) => {
  void sendMsg(query, {
    webSearchEnabled: webSearchEnabled.value,
    imageFiles,
    attachmentFiles,
    onPrepared,
  })
}

const handleSuggestedClick = (question: string) => {
  const text = question.trim()
  if (!text || isReplying.value) return
  void sendMsg(text, { webSearchEnabled: webSearchEnabled.value })
}

const recordFollowUpEvent = (
  set: MessageSuggestionSet,
  eventType: 'impression' | 'click' | 'dismiss',
  questionId = '',
) => {
  if (!set?.id) return
  void recordEmbedMessageSuggestionEvent(
    props.channelId,
    props.token,
    props.sessionId,
    props.sessionSig,
    props.visitorId,
    set.id,
    eventType,
    questionId,
  ).catch(() => undefined)
}

const handleFollowUpSelect = (message: Record<string, unknown>, item: MessageSuggestionItem) => {
  const set = message.suggestionSet as MessageSuggestionSet | undefined
  if (set) recordFollowUpEvent(set, 'click', item.id)
  if (isReplying.value) return
  if (set) setSuggestionAttribution(set.id, item.id)
  void sendMsg(item.text, { webSearchEnabled: webSearchEnabled.value })
}

const dismissFollowUps = (message: Record<string, unknown>, set: MessageSuggestionSet) => {
  message.suggestionsDismissed = true
  recordFollowUpEvent(set, 'dismiss')
}

let removeOpenQueryListener: (() => void) | null = null

onMounted(() => {
  fetchSuggestedQuestions()
  removeOpenQueryListener = onEmbedHostOpenWithQuery((query) => {
    if (isReplying.value) return
    void sendMsg(query, { webSearchEnabled: webSearchEnabled.value })
  })
})

onUnmounted(() => {
  removeOpenQueryListener?.()
})

watch(
  () => [props.showSuggestedQuestions, props.channelId, props.token] as const,
  () => { fetchSuggestedQuestions() },
)
</script>

<style scoped lang="less">
.embed-chat {
  display: flex;
  flex-direction: column;
  flex: 1;
  min-height: 0;
  width: 100%;
  position: relative;
}

.embed-chat__scroll {
  flex: 1;
  min-height: 0;
  width: 100%;
  overflow-y: auto;
}

.embed-chat__messages {
  display: flex;
  flex-direction: column;
  gap: 16px;
  max-width: 800px;
  margin: 0 auto;
  width: 100%;
  padding: 12px 16px 0;
  box-sizing: border-box;
}

.message-row {
  display: flex;
  flex-direction: column;
  width: 100%;
}

.embed-suggested {
  width: 100%;

  &__title {
    margin: 0 0 8px;
    font-size: var(--app-text-md);
    font-weight: 500;
    color: var(--td-text-color-secondary);
  }

  &__grid {
    display: flex;
    flex-direction: column;
    gap: 8px;
  }

  &__card {
    display: block;
    width: 100%;
    padding: 10px 12px;
    border: 1px solid var(--td-component-stroke);
    border-radius: var(--app-radius-lg);
    background: var(--td-bg-color-container);
    text-align: left;
    cursor: pointer;
    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
    transition: border-color var(--app-motion-fast) ease, box-shadow var(--app-motion-fast) ease, background var(--app-motion-fast) ease;

    &:hover {
      border-color: color-mix(in srgb, var(--td-text-color-primary) 10%, var(--td-component-stroke));
      background: color-mix(in srgb, var(--td-text-color-primary) 4%, var(--td-bg-color-container));
      box-shadow: 0 2px 6px rgba(0, 0, 0, 0.05);
    }

    &--skeleton {
      height: 40px;
      cursor: default;
      background: linear-gradient(90deg, #f0f0f0 25%, #e6e6e6 50%, #f0f0f0 75%);
      background-size: 200% 100%;
      animation: sk-shimmer 1.2s ease-in-out infinite;
      border: none;
    }
  }

  &__text {
    font-size: var(--app-text-md);
    line-height: 1.45;
    color: var(--td-text-color-primary);
  }
}

.embed-welcome-bubble {
  display: flex;
  justify-content: flex-start;
  width: 100%;
  animation: welcome-in 0.28s ease both;

  &__text {
    margin: 0;
    max-width: min(88%, 520px);
    padding: 10px 14px;
    font-size: var(--app-text-base);
    line-height: 1.55;
    color: var(--td-text-color-primary);
    white-space: pre-wrap;
    word-break: break-word;
    background: color-mix(
      in srgb,
      var(--embed-primary, var(--td-brand-color)) 7%,
      var(--td-bg-color-container)
    );
    border: 1px solid color-mix(
      in srgb,
      var(--embed-primary, var(--td-brand-color)) 14%,
      var(--td-component-stroke)
    );
    border-radius: 4px 14px 14px 14px;
    box-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
  }
}

@keyframes welcome-in {
  from {
    opacity: 0;
    transform: translateY(6px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

.embed-chat__typing {
  min-height: 28px;
  display: flex;
  align-items: center;
  padding-left: 4px;
}

.embed-chat__typing-spinner {
  width: 12px;
  height: 12px;
  box-sizing: border-box;
  border: 1.5px solid var(--td-component-stroke);
  border-top-color: var(--td-text-color-secondary);
  border-radius: 50%;
  animation: wk-spin 0.8s linear infinite;
}

@media (prefers-reduced-motion: reduce) {
  .embed-chat__typing-spinner {
    animation: none;
  }
}

.embed-chat__input {
  flex-shrink: 0;
  padding: 8px 16px 16px;
  box-sizing: border-box;
}

.embed-chat__input :deep(.prompt-dock) {
  max-width: 800px;
}

.msg-skeleton-list {
  display: flex;
  flex-direction: column;
  gap: 20px;
  padding: 8px 0;
}

.msg-skeleton-user {
  display: flex;
  justify-content: flex-end;
}

.msg-skeleton-bot {
  display: flex;
  flex-direction: column;
  gap: 8px;
  padding-left: 4px;
}

.sk-line {
  height: 14px;
  border-radius: var(--app-radius-sm);
  background: linear-gradient(90deg, #f0f0f0 25%, #e6e6e6 50%, #f0f0f0 75%);
  background-size: 200% 100%;
  animation: sk-shimmer 1.2s ease-in-out infinite;
}

.sk-line--short { width: 45%; height: 36px; }
.sk-line--medium { width: 60%; }

@keyframes sk-shimmer {
  0% { background-position: 200% 0; }
  100% { background-position: -200% 0; }
}

.scroll-to-bottom-btn {
  position: absolute;
  left: 50%;
  transform: translateX(-50%);
  bottom: 100px;
  z-index: 10;
  width: 36px;
  height: 36px;
  border-radius: 50%;
  background: var(--td-bg-color-container);
  border: 1px solid var(--td-component-stroke);
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  color: var(--td-text-color-secondary);
}

.scroll-btn-fade-enter-active,
.scroll-btn-fade-leave-active {
  transition: opacity var(--app-motion-base) ease, transform var(--app-motion-base) ease;
}

.scroll-btn-fade-enter-from,
.scroll-btn-fade-leave-to {
  opacity: 0;
  transform: translateX(-50%) translateY(8px);
}
</style>