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

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
+1 -1
Submodule docs updated: d4a2681597...c5048b78eb
@@ -1,528 +0,0 @@
"use client";
import {
DndContext,
KeyboardSensor,
MouseSensor,
TouchSensor,
closestCenter,
useSensor,
useSensors,
type DragEndEvent,
} from "@dnd-kit/core";
import {
SortableContext,
arrayMove,
sortableKeyboardCoordinates,
useSortable,
verticalListSortingStrategy,
} from "@dnd-kit/sortable";
import { CSS } from "@dnd-kit/utilities";
import {
CircleHelpIcon,
FileTextIcon,
MoreHorizontalIcon,
PencilIcon,
PlusIcon,
RefreshCwIcon,
SearchIcon,
Trash2Icon,
} from "lucide-react";
import type { CSSProperties } from "react";
import { useCallback, useEffect, useMemo, useState } from "react";
import { toast } from "sonner";
import { Button } from "@/components/ui/button";
import {
ContextMenu,
ContextMenuContent,
ContextMenuItem,
ContextMenuTrigger,
} from "@/components/ui/context-menu";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
import { Input } from "@/components/ui/input";
import { ScrollArea } from "@/components/ui/scroll-area";
import { OptionCombobox } from "@/components/option-combobox";
import {
createKnowledgeBase,
deleteKnowledgeBase,
fetchKnowledgeBases,
rebuildKnowledgeBaseIndex,
updateKnowledgeBase,
updateKnowledgeBaseSort,
type CreateKnowledgeBasePayload,
type KnowledgeBase,
} from "@/lib/api/admin";
import { useI18n } from "@/i18n/provider";
import { KnowledgeBaseType, Status } from "@/lib/generated/enums";
import { cn } from "@/lib/utils";
import { EditDialog } from "./knowledge-base-edit";
type KnowledgeBaseListProps = {
selectedKnowledgeBaseId: number | null;
onSelectKnowledgeBase: (knowledgeBase: KnowledgeBase | null) => void;
};
type TFunction = (key: string, values?: Record<string, string | number>) => string;
function getStatusOptions(t: TFunction) {
return [
{ 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") },
];
}
type SortableKnowledgeBaseCardProps = {
item: KnowledgeBase;
isSelected: boolean;
isContextMenuOpen: boolean;
disabled: boolean;
onContextMenuOpenChange: (open: boolean) => void;
onSelect: () => void;
onEdit: () => void;
onDelete: () => void;
onRebuildIndex: () => void;
deleteLoadingId: number | null;
rebuildIndexLoadingId: number | null;
t: TFunction;
};
function SortableKnowledgeBaseCard({
item,
isSelected,
isContextMenuOpen,
disabled,
onContextMenuOpenChange,
onSelect,
onEdit,
onDelete,
onRebuildIndex,
deleteLoadingId,
rebuildIndexLoadingId,
t,
}: SortableKnowledgeBaseCardProps) {
const {
attributes,
listeners,
setNodeRef,
transform,
transition,
isDragging,
} = useSortable({
id: item.id,
disabled,
});
const style: CSSProperties = {
transform: CSS.Transform.toString(transform),
transition,
};
return (
<ContextMenu onOpenChange={onContextMenuOpenChange}>
<ContextMenuTrigger
ref={setNodeRef}
style={style}
className={cn(
"group flex items-center gap-1 rounded mx-2 px-2 py-1.5 text-sm transition-colors hover:bg-accent cursor-pointer",
(isSelected || isContextMenuOpen) && "bg-accent text-accent-foreground",
isDragging && "bg-muted/60 shadow-sm opacity-80",
)}
onClick={onSelect}
onKeyDown={(e) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
onSelect();
}
}}
{...attributes}
{...listeners}
>
{item.knowledgeType === KnowledgeBaseType.FAQ ? (
<CircleHelpIcon className="size-4 shrink-0 text-muted-foreground" />
) : (
<FileTextIcon className="size-4 shrink-0 text-muted-foreground" />
)}
<span className="min-w-0 flex-1 truncate">{item.name}</span>
<span className="shrink-0 text-xs text-muted-foreground">
{item.knowledgeType === "faq" ? item.faqCount : item.documentCount}
</span>
<DropdownMenu>
<DropdownMenuTrigger
render={
<Button
variant="ghost"
size="icon"
className="size-6 opacity-0 group-hover:opacity-100"
/>
}
aria-label={t("knowledge.moreActions", { name: item.name })}
>
<MoreHorizontalIcon className="size-3.5" />
</DropdownMenuTrigger>
<DropdownMenuContent align="end" className="w-40 min-w-40">
<DropdownMenuItem
onClick={(e) => {
e.stopPropagation();
onEdit();
}}
>
<PencilIcon className="mr-2 size-3.5" />
{t("knowledge.edit")}
</DropdownMenuItem>
<DropdownMenuItem
onClick={(e) => {
e.stopPropagation();
onRebuildIndex();
}}
>
<RefreshCwIcon className="mr-2 size-3.5" />
{rebuildIndexLoadingId === item.id ? t("knowledge.rebuilding") : t("knowledge.rebuildIndex")}
</DropdownMenuItem>
<DropdownMenuItem
onClick={(e) => {
e.stopPropagation();
onDelete();
}}
className="text-destructive focus:text-destructive"
>
<Trash2Icon className="mr-2 size-3.5" />
{deleteLoadingId === item.id ? t("knowledge.deleting") : t("knowledge.delete")}
</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
</ContextMenuTrigger>
<ContextMenuContent>
<ContextMenuItem
onClick={(e) => {
e.stopPropagation();
onEdit();
}}
>
<PencilIcon className="mr-2 size-3.5" />
{t("knowledge.edit")}
</ContextMenuItem>
<ContextMenuItem
onClick={(e) => {
e.stopPropagation();
onRebuildIndex();
}}
>
<RefreshCwIcon className="mr-2 size-3.5" />
{rebuildIndexLoadingId === item.id ? t("knowledge.rebuilding") : t("knowledge.rebuildIndex")}
</ContextMenuItem>
<ContextMenuItem
onClick={(e) => {
e.stopPropagation();
onDelete();
}}
variant="destructive"
>
<Trash2Icon className="mr-2 size-3.5" />
{deleteLoadingId === item.id ? t("knowledge.deleting") : t("knowledge.delete")}
</ContextMenuItem>
</ContextMenuContent>
</ContextMenu>
);
}
export function KnowledgeBaseList({
selectedKnowledgeBaseId,
onSelectKnowledgeBase,
}: KnowledgeBaseListProps) {
const t = useI18n();
const [keywordInput, setKeywordInput] = useState("");
const [statusFilterInput, setStatusFilterInput] = useState("all");
const [keyword, setKeyword] = useState("");
const [statusFilter, setStatusFilter] = useState("all");
const [loading, setLoading] = useState(true);
const [saving, setSaving] = useState(false);
const [sorting, setSorting] = useState(false);
const [deleteLoadingId, setDeleteLoadingId] = useState<number | null>(null);
const [rebuildIndexLoadingId, setRebuildIndexLoadingId] = useState<
number | null
>(null);
const [dialogOpen, setDialogOpen] = useState(false);
const [editingItemId, setEditingItemId] = useState<number | null>(null);
const [knowledgeBases, setKnowledgeBases] = useState<KnowledgeBase[]>([]);
const [contextMenuKnowledgeBaseId, setContextMenuKnowledgeBaseId] = useState<number | null>(null);
const statusOptions = useMemo(() => getStatusOptions(t), [t]);
const sensors = useSensors(
useSensor(MouseSensor, {
activationConstraint: { distance: 8 },
}),
useSensor(TouchSensor, {
activationConstraint: { delay: 150, tolerance: 8 },
}),
useSensor(KeyboardSensor, {
coordinateGetter: sortableKeyboardCoordinates,
}),
);
const loadData = useCallback(async () => {
setLoading(true);
try {
const data = await fetchKnowledgeBases({
name: keyword.trim() || undefined,
status: statusFilter === "all" ? undefined : statusFilter,
limit: 1000,
});
setKnowledgeBases(data.results);
} catch (error) {
toast.error(error instanceof Error ? error.message : t("knowledge.loadBasesFailed"));
} finally {
setLoading(false);
}
}, [keyword, statusFilter, t]);
useEffect(() => {
void loadData();
}, [loadData]);
useEffect(() => {
if (
selectedKnowledgeBaseId === null &&
knowledgeBases.length > 0 &&
!loading
) {
onSelectKnowledgeBase(knowledgeBases[0]);
}
}, [selectedKnowledgeBaseId, knowledgeBases, loading, onSelectKnowledgeBase]);
function handleStatusFilterChange(value: string | null) {
setStatusFilterInput(value ?? "all");
}
function applyFilters() {
setKeyword(keywordInput);
setStatusFilter(statusFilterInput);
}
function handleFilterKeyDown(event: React.KeyboardEvent<HTMLInputElement>) {
if (event.key !== "Enter") {
return;
}
event.preventDefault();
applyFilters();
}
function openCreateDialog() {
setEditingItemId(null);
setDialogOpen(true);
}
function openEditDialog(item: KnowledgeBase) {
setEditingItemId(item.id);
setDialogOpen(true);
}
function handleDialogOpenChange(open: boolean) {
if (saving) {
return;
}
if (!open) {
setEditingItemId(null);
}
setDialogOpen(open);
}
async function handleSubmit(payload: CreateKnowledgeBasePayload) {
if (saving) {
return;
}
setSaving(true);
try {
if (editingItemId) {
await updateKnowledgeBase({
id: editingItemId,
...payload,
});
const editingItem = knowledgeBases.find(
(item) => item.id === editingItemId,
);
toast.success(t("knowledge.baseUpdated", { name: editingItem?.name || payload.name }));
} else {
await createKnowledgeBase(payload);
toast.success(t("knowledge.baseCreated", { name: payload.name }));
}
setDialogOpen(false);
setEditingItemId(null);
await loadData();
} catch (error) {
toast.error(error instanceof Error ? error.message : t("knowledge.baseSaveFailed"));
} finally {
setSaving(false);
}
}
async function handleDelete(item: KnowledgeBase) {
setDeleteLoadingId(item.id);
try {
await deleteKnowledgeBase(item.id);
toast.success(t("knowledge.baseDeleted", { name: item.name }));
if (selectedKnowledgeBaseId === item.id) {
onSelectKnowledgeBase(null);
}
await loadData();
} catch (error) {
toast.error(error instanceof Error ? error.message : t("knowledge.baseDeleteFailed"));
} finally {
setDeleteLoadingId(null);
}
}
async function handleRebuildIndex(item: KnowledgeBase) {
setRebuildIndexLoadingId(item.id);
try {
await rebuildKnowledgeBaseIndex(item.id);
toast.success(t("knowledge.rebuildStarted", { name: item.name }));
} catch (error) {
toast.error(
error instanceof Error ? error.message : t("knowledge.rebuildFailed"),
);
} finally {
setRebuildIndexLoadingId(null);
}
}
async function handleDragEnd(event: DragEndEvent) {
const { active, over } = event;
if (!over || active.id === over.id || sorting) {
return;
}
const previousResults = knowledgeBases;
const oldIndex = previousResults.findIndex((item) => item.id === active.id);
const newIndex = previousResults.findIndex((item) => item.id === over.id);
if (oldIndex < 0 || newIndex < 0) {
return;
}
const nextResults = arrayMove(previousResults, oldIndex, newIndex);
setKnowledgeBases(nextResults);
setSorting(true);
try {
await updateKnowledgeBaseSort(nextResults.map((item) => item.id));
toast.success(t("knowledge.sortUpdated"));
await loadData();
} catch (error) {
setKnowledgeBases(previousResults);
toast.error(
error instanceof Error ? error.message : t("knowledge.sortUpdateFailed"),
);
} finally {
setSorting(false);
}
}
return (
<>
<div className="flex h-full flex-col border-r bg-muted/30">
<div className="flex flex-col gap-2 border-b bg-background p-4">
<div className="flex items-center justify-between">
<h2 className="text-sm font-semibold">{t("knowledge.title")}</h2>
<div className="flex items-center gap-1">
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={() => void loadData()}
disabled={loading || sorting}
>
<RefreshCwIcon
className={loading || sorting ? "animate-spin" : "size-4"}
/>
</Button>
<Button
variant="ghost"
size="icon"
className="size-7"
onClick={openCreateDialog}
>
<PlusIcon className="size-4" />
</Button>
</div>
</div>
<div className="flex items-center gap-2">
<div className="relative min-w-0 flex-1">
<SearchIcon className="pointer-events-none absolute top-1/2 left-2 size-3.5 -translate-y-1/2 text-muted-foreground" />
<Input
value={keywordInput}
onChange={(event) => setKeywordInput(event.target.value)}
onKeyDown={handleFilterKeyDown}
placeholder={t("knowledge.searchBase")}
className="h-8 pl-8 text-xs"
/>
</div>
<div className="w-24 shrink-0">
<OptionCombobox
value={statusFilterInput}
onChange={handleStatusFilterChange}
options={statusOptions}
placeholder={t("knowledge.allStatus")}
searchPlaceholder={t("knowledge.searchStatus")}
emptyText={t("knowledge.emptyStatus")}
/>
</div>
</div>
</div>
<ScrollArea className="flex-1">
<div className="py-1 space-y-0.5">
<DndContext
sensors={sensors}
collisionDetection={closestCenter}
onDragEnd={(event) => void handleDragEnd(event)}
>
<SortableContext
items={knowledgeBases.map((item) => item.id)}
strategy={verticalListSortingStrategy}
>
{knowledgeBases.map((item) => (
<SortableKnowledgeBaseCard
key={item.id}
item={item}
isSelected={selectedKnowledgeBaseId === item.id}
isContextMenuOpen={contextMenuKnowledgeBaseId === item.id}
disabled={loading || sorting}
onContextMenuOpenChange={(open) =>
setContextMenuKnowledgeBaseId(open ? item.id : null)
}
onSelect={() => onSelectKnowledgeBase(item)}
onEdit={() => openEditDialog(item)}
onDelete={() => void handleDelete(item)}
onRebuildIndex={() => void handleRebuildIndex(item)}
deleteLoadingId={deleteLoadingId}
rebuildIndexLoadingId={rebuildIndexLoadingId}
t={t}
/>
))}
</SortableContext>
</DndContext>
{!loading && knowledgeBases.length === 0 ? (
<div className="py-8 text-center text-sm text-muted-foreground">
{t("knowledge.emptyBases")}
</div>
) : null}
</div>
</ScrollArea>
</div>
<EditDialog
open={dialogOpen}
saving={saving}
itemId={editingItemId}
onOpenChange={handleDialogOpenChange}
onSubmit={handleSubmit}
/>
</>
);
}
+163
View File
@@ -0,0 +1,163 @@
"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 { useI18n } from "@/i18n/provider"
import { exportKnowledgeFAQs, fetchKnowledgeBase, type KnowledgeBase } from "@/lib/api/admin"
import {
ArrowLeftIcon,
BugIcon,
DownloadIcon,
FileTextIcon,
LayoutGridIcon,
LayoutListIcon,
PlusIcon,
RefreshCwIcon,
UploadIcon,
} from "lucide-react"
import { useRouter, useSearchParams } from "next/navigation"
import { useCallback, useEffect, useState } from "react"
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 { RetrieveLogList } from "../_components/retrieve-log-list"
export default function KnowledgeBaseDetailPage() {
const t = useI18n()
const router = useRouter()
const searchParams = useSearchParams()
const knowledgeBaseId = Number(searchParams.get("id"))
const [knowledgeBase, setKnowledgeBase] = useState<KnowledgeBase | null>(null)
const [loading, setLoading] = useState(true)
const [activeTab, setActiveTab] = useState("documents")
const [debugPanelOpen, setDebugPanelOpen] = useState(false)
const [documentActionState, setDocumentActionState] = useState<DocumentListActionState | null>(null)
const [faqActionState, setFAQActionState] = useState<FAQListActionState | null>(null)
const [exportingFAQ, setExportingFAQ] = useState(false)
const loadKnowledgeBase = useCallback(async () => {
if (!Number.isInteger(knowledgeBaseId) || knowledgeBaseId <= 0) {
setKnowledgeBase(null)
setLoading(false)
return
}
setLoading(true)
try {
setKnowledgeBase(await fetchKnowledgeBase(knowledgeBaseId))
} catch (error) {
setKnowledgeBase(null)
toast.error(error instanceof Error ? error.message : t("knowledge.loadBaseFailed"))
} finally {
setLoading(false)
}
}, [knowledgeBaseId, t])
useEffect(() => {
void loadKnowledgeBase()
}, [loadKnowledgeBase])
async function handleExportFAQ() {
if (!knowledgeBase || exportingFAQ) {
return
}
setExportingFAQ(true)
try {
await exportKnowledgeFAQs(knowledgeBase.id)
toast.success(t("knowledge.exportFAQSuccess"))
} catch (error) {
toast.error(error instanceof Error ? error.message : t("knowledge.exportFAQFailed"))
} finally {
setExportingFAQ(false)
}
}
if (!loading && !knowledgeBase) {
return (
<div className="flex h-full flex-col items-center justify-center gap-4 p-6 text-center">
<FileTextIcon className="size-10 text-muted-foreground" />
<p className="text-sm text-muted-foreground">{t("knowledge.baseNotFound")}</p>
<Button variant="outline" onClick={() => router.push("/dashboard/knowledge")}>
<ArrowLeftIcon className="size-4" />
{t("knowledge.backToList")}
</Button>
</div>
)
}
const isFAQKnowledgeBase = knowledgeBase?.knowledgeType === "faq"
return (
<div className="flex h-full min-h-0 flex-col overflow-hidden">
<Tabs value={activeTab} onValueChange={setActiveTab} className="min-h-0 flex-1 gap-0">
<div className="flex shrink-0 items-center gap-3 border-b bg-background px-4 py-2">
<Button
variant="ghost"
size="icon"
className="size-8"
onClick={() => router.push("/dashboard/knowledge")}
aria-label={t("knowledge.backToList")}
>
<ArrowLeftIcon className="size-4" />
</Button>
<div className="flex min-w-0 flex-1 items-center gap-2">
<h1 className="shrink-0 truncate text-sm font-semibold">{knowledgeBase?.name ?? t("knowledge.title")}</h1>
{knowledgeBase?.description ? (
<>
<span className="h-3 w-px shrink-0 bg-border" aria-hidden="true" />
<p className="min-w-0 truncate text-xs text-muted-foreground">{knowledgeBase.description}</p>
</>
) : null}
</div>
{activeTab === "documents" && !isFAQKnowledgeBase && documentActionState ? (
<div className="flex shrink-0 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")}><BugIcon className="size-4" /></Button>
<Button size="sm" className="h-7 gap-1.5 px-2.5 text-xs" onClick={documentActionState.onCreate}>
<PlusIcon className="size-3.5" />
{t("knowledge.newDocument")}
</Button>
</div>
) : null}
{activeTab === "documents" && isFAQKnowledgeBase && faqActionState ? (
<div className="flex shrink-0 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")}><BugIcon className="size-4" /></Button>
<Button size="sm" className="h-7 gap-1.5 px-2.5 text-xs" onClick={faqActionState.onCreate}>
<PlusIcon className="size-3.5" />
{t("knowledge.newFAQ")}
</Button>
</div>
) : null}
<TabsList className="ml-auto h-8 shrink-0 border bg-muted/40 p-0.5">
<TabsTrigger value="documents" className="h-7 px-3 text-xs text-muted-foreground data-[state=active]:bg-background data-[state=active]:font-medium data-[state=active]:text-foreground data-[state=active]:shadow-sm">
{isFAQKnowledgeBase ? t("knowledge.faq") : t("knowledge.document")}
</TabsTrigger>
<TabsTrigger value="retrieveLogs" className="h-7 px-3 text-xs text-muted-foreground data-[state=active]:bg-background data-[state=active]:font-medium data-[state=active]:text-foreground data-[state=active]:shadow-sm">
{t("knowledge.retrieveLogs")}
</TabsTrigger>
</TabsList>
</div>
<TabsContent value="documents" className="min-h-0 flex-1">
{isFAQKnowledgeBase ? <FAQList knowledgeBaseId={knowledgeBase?.id ?? null} onActionStateChange={setFAQActionState} /> : <DocumentList knowledgeBaseId={knowledgeBase?.id ?? null} onActionStateChange={setDocumentActionState} />}
</TabsContent>
<TabsContent value="retrieveLogs" className="min-h-0 flex-1">
<RetrieveLogList knowledgeBaseId={knowledgeBase?.id ?? null} />
</TabsContent>
</Tabs>
<Sheet open={debugPanelOpen} onOpenChange={setDebugPanelOpen}>
<SheetContent side="right" className="min-w-170">
<SheetHeader><SheetTitle>{t("knowledge.ragDebug")}</SheetTitle></SheetHeader>
<DebugPanel knowledgeBaseId={knowledgeBase?.id ?? null} />
</SheetContent>
</Sheet>
</div>
)
}
+158 -281
View File
@@ -1,293 +1,170 @@
"use client" "use client"
import { Button } from "@/components/ui/button" import { CircleHelpIcon, FileTextIcon, RefreshCwIcon } from "lucide-react"
import { import Link from "next/link"
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 { toast } from "sonner" 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" import { DashboardCrudPage } from "@/components/dashboard/crud"
const KNOWLEDGE_BASE_LIST_MIN_WIDTH = 240 import { Badge } from "@/components/ui/badge"
const KNOWLEDGE_BASE_LIST_MAX_WIDTH = 520 import { EditDialog } from "./_components/knowledge-base-edit"
const KNOWLEDGE_BASE_LIST_DEFAULT_WIDTH = 320 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 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(() => { const statusOptions = [
localStorage.setItem(KNOWLEDGE_BASE_LIST_WIDTH_STORAGE_KEY, String(sidebarWidth)) { value: "all", label: t("knowledge.allStatus") },
}, [sidebarWidth]) { value: String(Status.Ok), label: t("knowledge.statusOk") },
{ value: String(Status.Disabled), label: t("knowledge.statusDisabled") },
function handleSidebarResizePointerDown(event: PointerEvent<HTMLDivElement>) { { value: String(Status.Deleted), label: t("knowledge.statusDeleted") },
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)
}
}
return ( return (
<div className="flex h-full min-h-0 overflow-hidden"> <DashboardCrudPage<KnowledgeBase, CreateKnowledgeBasePayload>
<div filters={[
className={`relative shrink-0 overflow-hidden ${ {
sidebarResizing ? "" : "transition-[width] duration-200" name: "name",
}`} label: t("knowledge.searchBase"),
style={{ width: sidebarCollapsed ? 0 : sidebarWidth }} placeholder: t("knowledge.searchBase"),
> defaultValue: "",
<KnowledgeBaseList trim: true,
selectedKnowledgeBaseId={selectedKnowledgeBase?.id ?? null} className: "w-full sm:w-80",
onSelectKnowledgeBase={setSelectedKnowledgeBase} },
{
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 rowActions={[
className="absolute top-0 right-[-3px] z-20 h-full w-1.5 cursor-col-resize transition-colors hover:bg-primary/30" {
onPointerDown={handleSidebarResizePointerDown} key: "rebuild-index",
role="separator" label: (item) => t("knowledge.rebuildIndex"),
aria-orientation="vertical" icon: <RefreshCwIcon />,
aria-label={t("knowledge.resizeList")} run: async ({ item }) => {
/> await rebuildKnowledgeBaseIndex(item.id)
) : null} toast.success(t("knowledge.rebuildStarted", { name: item.name }))
</div> },
<div className="relative shrink-0 bg-background"> },
<Button ]}
variant="outline" sort={{
size="icon" enabled: true,
className="absolute top-4 left-1/2 z-10 size-7 -translate-x-1/2 rounded-full shadow-sm" onReorder: (items) => updateKnowledgeBaseSort(items.map((item) => item.id)),
onClick={() => setSidebarCollapsed((value) => !value)} successMessage: t("knowledge.sortUpdated"),
aria-label={sidebarCollapsed ? t("knowledge.expandList") : t("knowledge.collapseList")} errorMessage: t("knowledge.sortUpdateFailed"),
> handleLabel: t("knowledge.sortHandle"),
{sidebarCollapsed ? ( }}
<PanelLeftOpenIcon className="size-3.5" /> pageSize={1000}
) : ( labels={{
<PanelLeftCloseIcon className="size-3.5" /> refresh: t("knowledge.refreshBases"),
)} create: t("knowledge.createBaseTitle"),
</Button> query: t("knowledge.query"),
</div> loading: t("knowledge.loading"),
<div className="min-w-0 min-h-0 h-full flex-1 overflow-hidden"> empty: t("knowledge.emptyBases"),
<Tabs value={activeTab} onValueChange={setActiveTab} className="h-full min-h-0 gap-0"> actions: t("knowledge.columnActions"),
<div className="border-b px-6 py-4"> edit: t("knowledge.edit"),
<div className="flex items-center gap-2"> delete: t("knowledge.delete"),
<TabsList> processing: t("knowledge.processing"),
<TabsTrigger value="documents">{isFAQKnowledgeBase ? t("knowledge.faq") : t("knowledge.document")}</TabsTrigger> moreActions: (item) => t("knowledge.moreActions", { name: item.name }),
<TabsTrigger value="retrieveLogs">{t("knowledge.retrieveLogs")}</TabsTrigger> loadFailed: t("knowledge.loadBasesFailed"),
</TabsList> saveFailed: t("knowledge.baseSaveFailed"),
{activeTab === "documents" && !isFAQKnowledgeBase && documentActionState ? ( deleteFailed: t("knowledge.baseDeleteFailed"),
<div className="ml-auto flex items-center gap-1"> created: (payload) => t("knowledge.baseCreated", { name: payload.name }),
<Button updated: (item, payload) => t("knowledge.baseUpdated", { name: payload.name || item.name }),
variant="ghost" deleted: (item) => t("knowledge.baseDeleted", { name: item.name }),
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>
) )
} }
+13
View File
@@ -1702,6 +1702,19 @@
"newFAQ": "New FAQ", "newFAQ": "New FAQ",
"ragDebug": "RAG Debug", "ragDebug": "RAG Debug",
"title": "Knowledge Base", "title": "Knowledge Base",
"columnBase": "Knowledge base",
"columnType": "Type",
"columnContent": "Items",
"columnStatus": "Status",
"columnUpdatedAt": "Last updated",
"columnActions": "Actions",
"sortHandle": "Drag to reorder",
"processing": "Processing...",
"noDescription": "No description",
"refreshBases": "Refresh knowledge bases",
"backToList": "Back to knowledge bases",
"baseNotFound": "This knowledge base was not found or has been deleted.",
"loadBaseFailed": "Could not load the knowledge base.",
"allStatus": "All statuses", "allStatus": "All statuses",
"status": "Status", "status": "Status",
"statusOk": "Enabled", "statusOk": "Enabled",
+13
View File
@@ -1703,6 +1703,19 @@
"newFAQ": "新增FAQ", "newFAQ": "新增FAQ",
"ragDebug": "RAG 调试", "ragDebug": "RAG 调试",
"title": "知识库", "title": "知识库",
"columnBase": "知识库",
"columnType": "类型",
"columnContent": "内容数量",
"columnStatus": "状态",
"columnUpdatedAt": "最近更新",
"columnActions": "操作",
"sortHandle": "拖拽排序",
"processing": "处理中...",
"noDescription": "暂无描述",
"refreshBases": "刷新知识库",
"backToList": "返回知识库列表",
"baseNotFound": "未找到该知识库,或它已被删除。",
"loadBaseFailed": "加载知识库失败",
"allStatus": "全部状态", "allStatus": "全部状态",
"statusOk": "启用", "statusOk": "启用",
"statusDisabled": "禁用", "statusDisabled": "禁用",