修改知识库页面交互和布局

This commit is contained in:
mlogclub
2026-07-29 00:12:11 +08:00
parent abbb3594f5
commit e54c87a660
6 changed files with 348 additions and 810 deletions
+158 -281
View File
@@ -1,293 +1,170 @@
"use client"
import { Button } from "@/components/ui/button"
import {
Sheet,
SheetContent,
SheetHeader,
SheetTitle,
} from "@/components/ui/sheet"
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
import type { KnowledgeBase } from "@/lib/api/admin"
import { exportKnowledgeFAQs } from "@/lib/api/admin"
import { useI18n } from "@/i18n/provider"
import {
Bug,
DownloadIcon,
LayoutGridIcon,
LayoutListIcon,
PanelLeftCloseIcon,
PanelLeftOpenIcon,
PlusIcon,
RefreshCwIcon,
UploadIcon,
} from "lucide-react"
import { useEffect, useState, type PointerEvent } from "react"
import { CircleHelpIcon, FileTextIcon, RefreshCwIcon } from "lucide-react"
import Link from "next/link"
import { toast } from "sonner"
import { DebugPanel } from "./_components/debug-panel"
import { DocumentList, type DocumentListActionState } from "./_components/document-list"
import { FAQList, type FAQListActionState } from "./_components/faq-list"
import { KnowledgeBaseList } from "./_components/knowledge-base-list"
import { RetrieveLogList } from "./_components/retrieve-log-list"
const KNOWLEDGE_BASE_LIST_WIDTH_STORAGE_KEY = "knowledge-base-list-width"
const KNOWLEDGE_BASE_LIST_MIN_WIDTH = 240
const KNOWLEDGE_BASE_LIST_MAX_WIDTH = 520
const KNOWLEDGE_BASE_LIST_DEFAULT_WIDTH = 320
import { DashboardCrudPage } from "@/components/dashboard/crud"
import { Badge } from "@/components/ui/badge"
import { EditDialog } from "./_components/knowledge-base-edit"
import {
createKnowledgeBase,
deleteKnowledgeBase,
fetchKnowledgeBases,
rebuildKnowledgeBaseIndex,
updateKnowledgeBase,
updateKnowledgeBaseSort,
type CreateKnowledgeBasePayload,
type KnowledgeBase,
} from "@/lib/api/admin"
import { KnowledgeBaseType, Status } from "@/lib/generated/enums"
import { useI18n } from "@/i18n/provider"
import { formatDateTime } from "@/lib/utils"
export default function DashboardKnowledgeDocumentsPage() {
export default function DashboardKnowledgePage() {
const t = useI18n()
const [selectedKnowledgeBase, setSelectedKnowledgeBase] = useState<KnowledgeBase | null>(null)
const [sidebarCollapsed, setSidebarCollapsed] = useState(false)
const [sidebarResizing, setSidebarResizing] = useState(false)
const [sidebarWidth, setSidebarWidth] = useState(() => {
if (typeof window === "undefined") {
return KNOWLEDGE_BASE_LIST_DEFAULT_WIDTH
}
const saved = Number(localStorage.getItem(KNOWLEDGE_BASE_LIST_WIDTH_STORAGE_KEY))
if (!Number.isFinite(saved)) {
return KNOWLEDGE_BASE_LIST_DEFAULT_WIDTH
}
return Math.min(
KNOWLEDGE_BASE_LIST_MAX_WIDTH,
Math.max(KNOWLEDGE_BASE_LIST_MIN_WIDTH, saved),
)
})
const [debugPanelOpen, setDebugPanelOpen] = useState(false)
const [activeTab, setActiveTab] = useState("documents")
const [documentActionState, setDocumentActionState] = useState<DocumentListActionState | null>(null)
const [faqActionState, setFAQActionState] = useState<FAQListActionState | null>(null)
const [exportingFAQ, setExportingFAQ] = useState(false)
const isFAQKnowledgeBase = selectedKnowledgeBase?.knowledgeType === "faq"
useEffect(() => {
localStorage.setItem(KNOWLEDGE_BASE_LIST_WIDTH_STORAGE_KEY, String(sidebarWidth))
}, [sidebarWidth])
function handleSidebarResizePointerDown(event: PointerEvent<HTMLDivElement>) {
event.preventDefault()
const startX = event.clientX
const startWidth = sidebarWidth
function handlePointerMove(moveEvent: globalThis.PointerEvent) {
const nextWidth = startWidth + moveEvent.clientX - startX
setSidebarWidth(
Math.min(
KNOWLEDGE_BASE_LIST_MAX_WIDTH,
Math.max(KNOWLEDGE_BASE_LIST_MIN_WIDTH, nextWidth),
),
)
}
function handlePointerEnd() {
window.removeEventListener("pointermove", handlePointerMove)
window.removeEventListener("pointerup", handlePointerEnd)
window.removeEventListener("pointercancel", handlePointerEnd)
document.body.style.cursor = ""
document.body.style.userSelect = ""
setSidebarResizing(false)
}
setSidebarResizing(true)
document.body.style.cursor = "col-resize"
document.body.style.userSelect = "none"
window.addEventListener("pointermove", handlePointerMove)
window.addEventListener("pointerup", handlePointerEnd)
window.addEventListener("pointercancel", handlePointerEnd)
}
async function handleExportFAQ() {
if (!selectedKnowledgeBase || exportingFAQ) {
return
}
setExportingFAQ(true)
try {
await exportKnowledgeFAQs(selectedKnowledgeBase.id)
toast.success(t("knowledge.exportFAQSuccess"))
} catch (error) {
toast.error(error instanceof Error ? error.message : t("knowledge.exportFAQFailed"))
} finally {
setExportingFAQ(false)
}
}
const statusOptions = [
{ value: "all", label: t("knowledge.allStatus") },
{ value: String(Status.Ok), label: t("knowledge.statusOk") },
{ value: String(Status.Disabled), label: t("knowledge.statusDisabled") },
{ value: String(Status.Deleted), label: t("knowledge.statusDeleted") },
]
return (
<div className="flex h-full min-h-0 overflow-hidden">
<div
className={`relative shrink-0 overflow-hidden ${
sidebarResizing ? "" : "transition-[width] duration-200"
}`}
style={{ width: sidebarCollapsed ? 0 : sidebarWidth }}
>
<KnowledgeBaseList
selectedKnowledgeBaseId={selectedKnowledgeBase?.id ?? null}
onSelectKnowledgeBase={setSelectedKnowledgeBase}
<DashboardCrudPage<KnowledgeBase, CreateKnowledgeBasePayload>
filters={[
{
name: "name",
label: t("knowledge.searchBase"),
placeholder: t("knowledge.searchBase"),
defaultValue: "",
trim: true,
className: "w-full sm:w-80",
},
{
name: "status",
label: t("knowledge.allStatus"),
type: "select",
defaultValue: "all",
allValue: "all",
options: statusOptions,
className: "w-full sm:w-36",
},
]}
columns={[
{
key: "knowledgeBase",
label: t("knowledge.columnBase"),
className: "w-[36rem] max-w-[36rem]",
render: (item) => {
const isFAQ = item.knowledgeType === KnowledgeBaseType.FAQ
const Icon = isFAQ ? CircleHelpIcon : FileTextIcon
return (
<div className="flex w-full min-w-0 items-start gap-3">
<div className="mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground">
<Icon className="size-4" />
</div>
<div className="min-w-0 flex-1">
<Link
href={`/dashboard/knowledge/detail?id=${item.id}`}
className="block truncate font-medium hover:underline"
>
{item.name}
</Link>
<p className="mt-1 truncate text-xs text-muted-foreground">
{item.description || t("knowledge.noDescription")}
</p>
</div>
</div>
)
},
},
{
key: "type",
label: t("knowledge.columnType"),
render: (item) => <Badge variant="outline">{item.knowledgeTypeName}</Badge>,
},
{
key: "contentCount",
label: t("knowledge.columnContent"),
render: (item) => (
<span className="text-muted-foreground">
{item.knowledgeType === KnowledgeBaseType.FAQ
? `${item.faqCount} ${t("knowledge.faq")}`
: `${item.documentCount} ${t("knowledge.document")}`}
</span>
),
},
{
key: "status",
label: t("knowledge.columnStatus"),
render: (item) => (
<Badge variant={item.status === Status.Ok ? "secondary" : "outline"}>
{item.statusName}
</Badge>
),
},
{
key: "updatedAt",
label: t("knowledge.columnUpdatedAt"),
className: "whitespace-nowrap",
render: (item) => (
<span className="text-sm text-muted-foreground">{formatDateTime(item.updatedAt)}</span>
),
},
]}
fetchList={fetchKnowledgeBases}
getItemId={(item) => item.id}
createItem={createKnowledgeBase}
updateItem={(item, payload) => updateKnowledgeBase({ id: item.id, ...payload })}
deleteItem={(item) => deleteKnowledgeBase(item.id)}
renderEditDialog={({ open, saving, itemId, onOpenChange, onSubmit }) => (
<EditDialog
open={open}
saving={saving}
itemId={itemId}
onOpenChange={onOpenChange}
onSubmit={onSubmit}
/>
{!sidebarCollapsed ? (
<div
className="absolute top-0 right-[-3px] z-20 h-full w-1.5 cursor-col-resize transition-colors hover:bg-primary/30"
onPointerDown={handleSidebarResizePointerDown}
role="separator"
aria-orientation="vertical"
aria-label={t("knowledge.resizeList")}
/>
) : null}
</div>
<div className="relative shrink-0 bg-background">
<Button
variant="outline"
size="icon"
className="absolute top-4 left-1/2 z-10 size-7 -translate-x-1/2 rounded-full shadow-sm"
onClick={() => setSidebarCollapsed((value) => !value)}
aria-label={sidebarCollapsed ? t("knowledge.expandList") : t("knowledge.collapseList")}
>
{sidebarCollapsed ? (
<PanelLeftOpenIcon className="size-3.5" />
) : (
<PanelLeftCloseIcon className="size-3.5" />
)}
</Button>
</div>
<div className="min-w-0 min-h-0 h-full flex-1 overflow-hidden">
<Tabs value={activeTab} onValueChange={setActiveTab} className="h-full min-h-0 gap-0">
<div className="border-b px-6 py-4">
<div className="flex items-center gap-2">
<TabsList>
<TabsTrigger value="documents">{isFAQKnowledgeBase ? t("knowledge.faq") : t("knowledge.document")}</TabsTrigger>
<TabsTrigger value="retrieveLogs">{t("knowledge.retrieveLogs")}</TabsTrigger>
</TabsList>
{activeTab === "documents" && !isFAQKnowledgeBase && documentActionState ? (
<div className="ml-auto flex items-center gap-1">
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={documentActionState.onRefresh}
disabled={documentActionState.loading}
aria-label={t("knowledge.refreshDocuments")}
>
<RefreshCwIcon className={documentActionState.loading ? "size-4 animate-spin" : "size-4"} />
</Button>
<Button
variant={documentActionState.viewMode === "list" ? "secondary" : "ghost"}
size="icon"
className="size-7"
onClick={() => documentActionState.onChangeViewMode("list")}
aria-label={t("knowledge.listLayout")}
>
<LayoutListIcon className="size-4" />
</Button>
<Button
variant={documentActionState.viewMode === "grid" ? "secondary" : "ghost"}
size="icon"
className="size-7"
onClick={() => documentActionState.onChangeViewMode("grid")}
aria-label={t("knowledge.gridLayout")}
>
<LayoutGridIcon className="size-4" />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={() => setDebugPanelOpen(true)}
aria-label={t("knowledge.openDebugPanel")}
>
<Bug className="size-4" />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={documentActionState.onCreate}
aria-label={t("knowledge.newDocument")}
>
<PlusIcon className="size-4" />
</Button>
</div>
) : null}
{activeTab === "documents" && isFAQKnowledgeBase && faqActionState ? (
<div className="ml-auto flex items-center gap-1">
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={faqActionState.onRefresh}
disabled={faqActionState.loading}
aria-label={t("knowledge.refreshFAQ")}
>
<RefreshCwIcon className={faqActionState.loading ? "size-4 animate-spin" : "size-4"} />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={faqActionState.onImport}
disabled={faqActionState.importing}
aria-label={t("knowledge.importFAQ")}
>
<UploadIcon className="size-4" />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={() => void handleExportFAQ()}
disabled={exportingFAQ}
aria-label={t("knowledge.exportFAQ")}
>
<DownloadIcon className={exportingFAQ ? "size-4 animate-pulse" : "size-4"} />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={() => setDebugPanelOpen(true)}
aria-label={t("knowledge.openDebugPanel")}
>
<Bug className="size-4" />
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={faqActionState.onCreate}
aria-label={t("knowledge.newFAQ")}
>
<PlusIcon className="size-4" />
</Button>
</div>
) : null}
</div>
</div>
<TabsContent value="documents" className="min-h-0 flex-1">
{isFAQKnowledgeBase ? (
<FAQList
knowledgeBaseId={selectedKnowledgeBase?.id ?? null}
onActionStateChange={setFAQActionState}
/>
) : (
<DocumentList
knowledgeBaseId={selectedKnowledgeBase?.id ?? null}
onActionStateChange={setDocumentActionState}
/>
)}
</TabsContent>
<TabsContent value="retrieveLogs" className="min-h-0 flex-1">
<RetrieveLogList
knowledgeBaseId={selectedKnowledgeBase?.id ?? null}
/>
</TabsContent>
</Tabs>
</div>
<Sheet open={debugPanelOpen} onOpenChange={setDebugPanelOpen}>
<SheetContent side="right" className="min-w-170">
<SheetHeader>
<SheetTitle>{t("knowledge.ragDebug")}</SheetTitle>
</SheetHeader>
<DebugPanel knowledgeBaseId={selectedKnowledgeBase?.id ?? null} />
</SheetContent>
</Sheet>
</div>
)}
rowActions={[
{
key: "rebuild-index",
label: (item) => t("knowledge.rebuildIndex"),
icon: <RefreshCwIcon />,
run: async ({ item }) => {
await rebuildKnowledgeBaseIndex(item.id)
toast.success(t("knowledge.rebuildStarted", { name: item.name }))
},
},
]}
sort={{
enabled: true,
onReorder: (items) => updateKnowledgeBaseSort(items.map((item) => item.id)),
successMessage: t("knowledge.sortUpdated"),
errorMessage: t("knowledge.sortUpdateFailed"),
handleLabel: t("knowledge.sortHandle"),
}}
pageSize={1000}
labels={{
refresh: t("knowledge.refreshBases"),
create: t("knowledge.createBaseTitle"),
query: t("knowledge.query"),
loading: t("knowledge.loading"),
empty: t("knowledge.emptyBases"),
actions: t("knowledge.columnActions"),
edit: t("knowledge.edit"),
delete: t("knowledge.delete"),
processing: t("knowledge.processing"),
moreActions: (item) => t("knowledge.moreActions", { name: item.name }),
loadFailed: t("knowledge.loadBasesFailed"),
saveFailed: t("knowledge.baseSaveFailed"),
deleteFailed: t("knowledge.baseDeleteFailed"),
created: (payload) => t("knowledge.baseCreated", { name: payload.name }),
updated: (item, payload) => t("knowledge.baseUpdated", { name: payload.name || item.name }),
deleted: (item) => t("knowledge.baseDeleted", { name: item.name }),
}}
/>
)
}