From cb46db23f552c09b86cfde2778799d8eb9a7da49 Mon Sep 17 00:00:00 2001 From: Binks Riverton Date: Mon, 6 Jul 2026 13:06:29 +0800 Subject: [PATCH] refactor(frontend): extract shared document action menu and card view component - Add DocumentActionMenu.vue: shared component for document context menu items (edit, view-trace, rebuild, cancel-parse, move, batch-manage, delete) with consistent visibility conditions - Add DocumentCardView.vue: standalone card/grid view component extracted from KnowledgeBase.vue inline template, including hover popover, tag chips, move sub-flow, and status display - Update DocumentListView.vue: use shared DocumentActionMenu, add canMutateKnowledge gating for move/batch-manage, add view-trace and batch-manage menu items, add move sub-flow support (targets/confirm) - Update KnowledgeBase.vue: use DocumentCardView component, add handleCardAction bridge, remove unused helpers and imports Both card and list views now render identical operation menus from a single source of truth. --- .../src/views/knowledge/KnowledgeBase.vue | 561 +------- .../components/DocumentActionMenu.vue | 173 +++ .../knowledge/components/DocumentCardView.vue | 1221 +++++++++++++++++ .../knowledge/components/DocumentListView.vue | 261 +++- 4 files changed, 1666 insertions(+), 550 deletions(-) create mode 100644 frontend/src/views/knowledge/components/DocumentActionMenu.vue create mode 100644 frontend/src/views/knowledge/components/DocumentCardView.vue diff --git a/frontend/src/views/knowledge/KnowledgeBase.vue b/frontend/src/views/knowledge/KnowledgeBase.vue index dc3f8aea..f50ab0f5 100644 --- a/frontend/src/views/knowledge/KnowledgeBase.vue +++ b/frontend/src/views/knowledge/KnowledgeBase.vue @@ -2,7 +2,6 @@ import { ref, onMounted, onUnmounted, watch, reactive, computed, nextTick } from "vue"; import { MessagePlugin } from "tdesign-vue-next"; import DocContent from "@/components/doc-content.vue"; -import KnowledgeProcessingTimeline from "@/components/knowledge-processing-timeline.vue"; import useKnowledgeBase from '@/hooks/useKnowledgeBase'; import { useRoute, useRouter } from 'vue-router'; import EmptyKnowledge from '@/components/empty-knowledge.vue'; @@ -40,11 +39,11 @@ import { import { knowledgeSpansPayloadHasTrace } from '@/utils/knowledgeTrace'; import FAQEntryManager from './components/FAQEntryManager.vue'; import DocumentListView from './components/DocumentListView.vue'; +import DocumentCardView from './components/DocumentCardView.vue'; import DocumentBatchBar from './components/DocumentBatchBar.vue'; import KbUploadSourceDropdown from './components/KbUploadSourceDropdown.vue'; import TagEditDialog from './components/TagEditDialog.vue'; import KbTagManageDrawer from './components/KbTagManageDrawer.vue'; -import { useTagChipsOverflow } from '@/composables/useTagChipsOverflow'; import type { KnowledgeProcessOverrides } from '@/types/knowledgeProcess'; import { useUploadConfirmStore, type UploadConfirmResult } from '@/stores/uploadConfirm'; import WikiBrowser from './wiki/WikiBrowser.vue'; @@ -56,8 +55,6 @@ import { } from './wikiStatusRefresh'; import { listMoveTargets, moveKnowledge, getKnowledgeMoveProgress } from '@/api/knowledge-base'; import { useI18n } from 'vue-i18n'; -import { formatStringDate } from '@/utils'; -import { formatFileSize } from '@/utils/files'; import { useMarqueeSelect } from '@/hooks/useMarqueeSelect'; import type { ParserEngineInfo } from '@/api/system'; const route = useRoute(); @@ -335,17 +332,6 @@ function isParseInFlight(status?: string): boolean { return isKnowledgeParseInFlight(status); } -// Status line shown on the card body while parse is still in flight. -function inFlightCardStatusText(item: KnowledgeCard): string { - if (item.parse_status === 'finalizing') { - if (item.summary_status === 'pending' || item.summary_status === 'processing') { - return t('knowledgeBase.generatingSummary'); - } - return t('knowledgeBase.statusFinalizing'); - } - return t('knowledgeBase.parsingInProgress'); -} - function isTraceMenuVisible(item: KnowledgeCard): boolean { if (!item?.id) return false; if (isParseInFlight(item.parse_status)) { @@ -374,7 +360,6 @@ async function probeTraceAvailable(item: KnowledgeCard) { } const onCardMoreVisibleChange = (visible: boolean, item: KnowledgeCard) => { - onVisibleChange(visible); if (visible) { probeTraceAvailable(item); } @@ -631,13 +616,6 @@ const isTagFilterActive = (tagId: string) => selectedTagIds.value.includes(tagId const tagEditDialogVisible = ref(false); const tagEditTarget = ref(null); -const { - setupTagChipsObserver, - getTagLimit, - hasTagOverflow, - getOverflowCount, -} = useTagChipsOverflow('tagItemId'); - function openTagEditDialog(item: KnowledgeCard) { tagEditTarget.value = item; tagEditDialogVisible.value = true; @@ -662,43 +640,6 @@ const getTagName = (tagId?: string | number) => { return tagMap.value[key]?.name || ''; }; -const formatDocTime = (time?: string) => { - if (!time) return '--' - const formatted = formatStringDate(new Date(time)) - return formatted.slice(2, 16) // "YY-MM-DD HH:mm" -} - -const channelLabelMap: Record = { - web: 'knowledgeBase.channelWeb', - api: 'knowledgeBase.channelApi', - browser_extension: 'knowledgeBase.channelBrowserExtension', - wechat: 'knowledgeBase.channelWechat', - wecom: 'knowledgeBase.channelWecom', - feishu: 'knowledgeBase.channelFeishu', - dingtalk: 'knowledgeBase.channelDingtalk', - slack: 'knowledgeBase.channelSlack', - im: 'knowledgeBase.channelIm', -}; - -const getChannelLabel = (channel: string) => { - const key = channelLabelMap[channel]; - return key ? t(key) : t('knowledgeBase.channelUnknown'); -}; - -// 获取知识条目的显示类型 -const getKnowledgeType = (item: any) => { - if (item.type === 'url') { - return t('knowledgeBase.typeURL') || 'URL'; - } - if (item.type === 'manual') { - return t('knowledgeBase.typeManual'); - } - if (item.file_type) { - return item.file_type.toUpperCase(); - } - return '--'; -} - const loadKnowledgeFiles = (kbIdValue: string): Promise => { if (!kbIdValue) return Promise.resolve(); if (!isFAQ.value) { @@ -1226,132 +1167,6 @@ const openSourceDoc = (knowledgeId: string) => { getCardDetails({ id: knowledgeId }); }; -// 悬停知识卡片时显示详情气泡(基于卡片位置定位) -const hoveredCardItem = ref(null); -const cardPopoverPos = ref({ x: 0, y: 0 }); -const CARD_POPOVER_OFFSET = 12; -const CARD_POPOVER_ESTIMATED_WIDTH = 360; -const CARD_POPOVER_ESTIMATED_HEIGHT = 300; -const cardHoverShowDelay = 300; -let cardHoverTimer: ReturnType | null = null; -let cardPopoverElement: HTMLElement | null = null; - -// 根据卡片位置计算气泡位置(优先右侧,自动避开边界) -const calculatePopoverPositionFromCard = (cardElement: HTMLElement): { x: number; y: number } => { - const cardRect = cardElement.getBoundingClientRect(); - const viewportWidth = window.innerWidth; - const viewportHeight = window.innerHeight; - - // 获取实际气泡尺寸 - let popoverWidth = CARD_POPOVER_ESTIMATED_WIDTH; - let popoverHeight = CARD_POPOVER_ESTIMATED_HEIGHT; - - if (cardPopoverElement) { - const rect = cardPopoverElement.getBoundingClientRect(); - if (rect.width > 0) popoverWidth = rect.width; - if (rect.height > 0) popoverHeight = rect.height; - } - - let x = 0; - let y = 0; - - // 策略1:优先尝试放在卡片右侧 - const rightX = cardRect.right + CARD_POPOVER_OFFSET; - if (rightX + popoverWidth <= viewportWidth - 10) { - x = rightX; - y = cardRect.top; - // 确保不超出底部 - if (y + popoverHeight > viewportHeight - 10) { - y = viewportHeight - popoverHeight - 10; - } - // 确保不超出顶部 - y = Math.max(10, y); - return { x, y }; - } - - // 策略2:尝试放在卡片左侧 - const leftX = cardRect.left - popoverWidth - CARD_POPOVER_OFFSET; - if (leftX >= 10) { - x = leftX; - y = cardRect.top; - // 确保不超出底部 - if (y + popoverHeight > viewportHeight - 10) { - y = viewportHeight - popoverHeight - 10; - } - // 确保不超出顶部 - y = Math.max(10, y); - return { x, y }; - } - - // 策略3:尝试放在卡片下方 - const bottomY = cardRect.bottom + CARD_POPOVER_OFFSET; - if (bottomY + popoverHeight <= viewportHeight - 10) { - y = bottomY; - x = cardRect.left; - // 确保不超出右边界 - if (x + popoverWidth > viewportWidth - 10) { - x = viewportWidth - popoverWidth - 10; - } - // 确保不超出左边界 - x = Math.max(10, x); - return { x, y }; - } - - // 策略4:放在卡片上方 - const topY = cardRect.top - popoverHeight - CARD_POPOVER_OFFSET; - y = Math.max(10, topY); - x = cardRect.left; - // 确保不超出右边界 - if (x + popoverWidth > viewportWidth - 10) { - x = viewportWidth - popoverWidth - 10; - } - // 确保不超出左边界 - x = Math.max(10, x); - - return { x, y }; -}; - -const onCardMouseEnter = (ev: MouseEvent, item: KnowledgeCard) => { - if (cardHoverTimer) { - clearTimeout(cardHoverTimer); - cardHoverTimer = null; - } - - const cardElement = (ev.currentTarget as HTMLElement); - - cardHoverTimer = setTimeout(() => { - cardHoverTimer = null; - hoveredCardItem.value = item; - - // 基于卡片位置计算气泡位置 - const pos = calculatePopoverPositionFromCard(cardElement); - cardPopoverPos.value = pos; - - // 获取实际元素后精确计算 - nextTick(() => { - cardPopoverElement = document.querySelector('.knowledge-card-hover-popover') as HTMLElement; - if (cardPopoverElement) { - const refinedPos = calculatePopoverPositionFromCard(cardElement); - cardPopoverPos.value = refinedPos; - } - }); - }, cardHoverShowDelay); -}; - -// 鼠标在卡片上移动时不更新气泡位置 -const onCardMouseMove = (ev: MouseEvent) => { - // 保持气泡固定在卡片旁边 -}; - -const onCardMouseLeave = () => { - if (cardHoverTimer) { - clearTimeout(cardHoverTimer); - cardHoverTimer = null; - } - hoveredCardItem.value = null; - cardPopoverElement = null; -}; - const closeCardMoreMenu = (index: number) => { if (cardList.value?.[index]) { cardList.value[index].isMore = false; @@ -1989,14 +1804,6 @@ const openKnowledgeItem = (item: KnowledgeCard) => { openCardDetails(item); }; -const onCardClick = (item: KnowledgeCard) => { - if (batchMode.value) { - onCardGridCheckboxChange(item.id, !selectedIds.value.has(item.id)); - return; - } - openKnowledgeItem(item); -}; - const confirmBatchDelete = async () => { if (batchDeleting.value || batchReparsing.value || selectedIds.value.size === 0) return; const ids = Array.from(selectedIds.value); @@ -2040,9 +1847,27 @@ const confirmCancelParseKnowledge = async (item: KnowledgeCard) => { } }; +// Bridge card-view actions back to existing per-card handlers. +const handleCardAction = ( + action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'delete' | 'view-trace' | 'batch-manage', + item: KnowledgeCard, +) => { + const idx = (cardList.value || []).findIndex((i: KnowledgeCard) => i.id === item.id); + if (action === 'edit') return handleManualEdit(idx, item); + if (action === 'reparse') { + if (isParseInFlight(item.parse_status)) return onReparseMenuClick(idx, item); + return confirmRebuildKnowledge(idx, item); + } + if (action === 'cancel-parse') return confirmCancelParseKnowledge(item); + if (action === 'move') return handleMoveKnowledge(item); + if (action === 'delete') return confirmDeleteKnowledge(idx, item); + if (action === 'view-trace') return handleViewTrace(idx, item); + if (action === 'batch-manage') return handleEnterBatchFromCard(item); +}; + // Bridge list-view actions back to existing per-card handlers. const handleListAction = ( - action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'delete', + action: 'edit' | 'reparse' | 'cancel-parse' | 'move' | 'delete' | 'view-trace' | 'batch-manage', item: KnowledgeCard, ) => { const idx = (cardList.value || []).findIndex((i: KnowledgeCard) => i.id === item.id); @@ -2051,6 +1876,8 @@ const handleListAction = ( if (action === 'cancel-parse') return confirmCancelParseKnowledge(item); if (action === 'move') return handleMoveKnowledge(item); if (action === 'delete') return confirmDeleteKnowledge(idx, item); + if (action === 'view-trace') return handleViewTrace(idx, item); + if (action === 'batch-manage') return handleEnterBatchFromCard(item); }; // Clear selection on filter/tag/kb change to avoid acting on hidden items. @@ -2397,314 +2224,50 @@ async function createNewSession(value: string): Promise {