411 lines
13 KiB
TypeScript
411 lines
13 KiB
TypeScript
import { ExternalLinkIcon, FileTextIcon, LoaderCircle } from "lucide-react";
|
||
|
||
import { Button } from "@/components/ui/button";
|
||
import {
|
||
Dialog,
|
||
DialogContent,
|
||
DialogDescription,
|
||
DialogHeader,
|
||
DialogTitle,
|
||
} from "@/components/ui/dialog";
|
||
import type { RuntimeDisplaySource } from "@/core/skill-display/runtime";
|
||
import { apiFetch } from "@/core/api/fetch-client";
|
||
import { getBackendBaseURL } from "@/core/config";
|
||
import { useLocalSettings } from "@/core/settings";
|
||
import { useCitationDisplaySettings } from "@/core/system-settings/hooks";
|
||
import { cn } from "@/lib/utils";
|
||
import { useEffect, useState } from "react";
|
||
|
||
export function SkillDisplaySources({
|
||
highlightedReferenceId,
|
||
sources,
|
||
className,
|
||
}: {
|
||
highlightedReferenceId?: string | null;
|
||
sources: RuntimeDisplaySource[];
|
||
className?: string;
|
||
}) {
|
||
if (sources.length === 0) {
|
||
return null;
|
||
}
|
||
|
||
return (
|
||
<div className={cn("not-prose grid gap-2", className)}>
|
||
{sources.map((source) => (
|
||
<SourceCard
|
||
key={`${source.skillName}-${source.index}`}
|
||
highlighted={highlightedReferenceId === String(source.index)}
|
||
source={source}
|
||
referenceTarget
|
||
/>
|
||
))}
|
||
</div>
|
||
);
|
||
}
|
||
|
||
export function SourceCard({
|
||
highlighted = false,
|
||
source,
|
||
referenceTarget = false,
|
||
}: {
|
||
highlighted?: boolean;
|
||
source: RuntimeDisplaySource;
|
||
referenceTarget?: boolean;
|
||
}) {
|
||
const [open, setOpen] = useState(false);
|
||
const [context, setContext] = useState<WeKnoraSourceContext | null>(null);
|
||
const [contextLoading, setContextLoading] = useState(false);
|
||
const [contextError, setContextError] = useState<string | null>(null);
|
||
const [settings] = useLocalSettings();
|
||
const { data: citationDisplay } = useCitationDisplaySettings();
|
||
const cleanupWords =
|
||
citationDisplay?.cleanup_words ?? settings.display.citationCleanupWords ?? [];
|
||
const content = cleanReferenceText(source.content || source.snippet, cleanupWords);
|
||
const snippet = compactReferenceText(content).slice(0, 280);
|
||
const paragraphs = segmentReferenceText(content);
|
||
const score =
|
||
typeof source.score === "number"
|
||
? source.score <= 1
|
||
? `${Math.round(source.score * 100)}%`
|
||
: String(source.score)
|
||
: null;
|
||
const meta = [
|
||
source.source,
|
||
source.author ? `作者 ${source.author}` : null,
|
||
source.type && source.type !== "result" ? source.type : null,
|
||
source.time,
|
||
score ? `相关度 ${score}` : null,
|
||
].filter(Boolean);
|
||
const isCitation = source.mode === "citation";
|
||
const showReferenceNumber = isCitation;
|
||
const previewTarget = parseWeKnoraPreviewUrl(source.url);
|
||
|
||
useEffect(() => {
|
||
if (!open || !previewTarget) {
|
||
return;
|
||
}
|
||
let cancelled = false;
|
||
setContext(null);
|
||
setContextError(null);
|
||
setContextLoading(true);
|
||
const params = new URLSearchParams({
|
||
knowledge_base_id: previewTarget.knowledgeBaseId,
|
||
chunk_id: previewTarget.chunkId,
|
||
});
|
||
void apiFetch(`${getBackendBaseURL()}/api/weknora/source-context?${params}`)
|
||
.then(async (response) => {
|
||
const payload = (await response.json().catch(() => null)) as unknown;
|
||
if (!response.ok || !isWeKnoraSourceContextResponse(payload)) {
|
||
throw new Error(readPreviewError(payload, response.status));
|
||
}
|
||
if (!cancelled) {
|
||
setContext(payload.data);
|
||
}
|
||
})
|
||
.catch((error: unknown) => {
|
||
if (!cancelled) {
|
||
setContextError(error instanceof Error ? error.message : "无法加载原文上下文");
|
||
}
|
||
})
|
||
.finally(() => {
|
||
if (!cancelled) {
|
||
setContextLoading(false);
|
||
}
|
||
});
|
||
return () => {
|
||
cancelled = true;
|
||
};
|
||
}, [open, previewTarget?.chunkId, previewTarget?.knowledgeBaseId]);
|
||
|
||
return (
|
||
<>
|
||
<button
|
||
id={referenceTarget ? `reference-${source.index}` : undefined}
|
||
type="button"
|
||
className={cn(
|
||
"group bg-card/60 hover:bg-card hover:border-primary/40 focus-visible:ring-primary/30 w-full scroll-mt-12 rounded-xl border px-3.5 py-3 text-left shadow-sm transition-all focus-visible:ring-2 focus-visible:outline-none",
|
||
"target:border-amber-300 target:bg-amber-50/80",
|
||
highlighted &&
|
||
"border-amber-300 bg-amber-50/80 shadow-[0_0_0_2px_rgba(251,191,36,0.14)]",
|
||
)}
|
||
onClick={() => setOpen(true)}
|
||
>
|
||
<div className="flex items-start gap-3">
|
||
{showReferenceNumber && (
|
||
<span className="bg-primary/10 text-primary border-primary/20 group-hover:bg-primary/15 mt-0.5 inline-flex size-6 shrink-0 items-center justify-center rounded-full border text-xs font-semibold tabular-nums">
|
||
{source.index}
|
||
</span>
|
||
)}
|
||
<div className="min-w-0 flex-1 space-y-1.5">
|
||
<div className="text-foreground line-clamp-2 text-sm leading-snug font-medium">
|
||
{source.title}
|
||
</div>
|
||
{meta.length > 0 && (
|
||
<div className="text-muted-foreground flex flex-wrap items-center gap-x-2 gap-y-0.5 text-[11px]">
|
||
{meta.map((item, index) => (
|
||
<span key={`${item}-${index}`} className="inline-flex items-center">
|
||
{index > 0 && <span className="mr-2 opacity-50">·</span>}
|
||
<span className="truncate">{item}</span>
|
||
</span>
|
||
))}
|
||
</div>
|
||
)}
|
||
{snippet && (
|
||
<p className="text-muted-foreground/90 line-clamp-2 text-xs leading-relaxed">
|
||
{snippet}
|
||
</p>
|
||
)}
|
||
</div>
|
||
{source.url && (
|
||
previewTarget ? (
|
||
<span className="text-primary bg-primary/10 mt-0.5 inline-flex shrink-0 items-center gap-1 rounded-md px-1.5 py-1 text-[11px] font-medium">
|
||
<FileTextIcon className="size-3.5" />
|
||
查看原文
|
||
</span>
|
||
) : (
|
||
<ExternalLinkIcon className="text-muted-foreground/60 group-hover:text-primary mt-1 size-3.5 shrink-0 transition-colors" />
|
||
)
|
||
)}
|
||
</div>
|
||
</button>
|
||
<Dialog open={open} onOpenChange={setOpen}>
|
||
<DialogContent className="max-w-2xl">
|
||
<DialogHeader>
|
||
<div className="flex items-start justify-between gap-3 pr-8">
|
||
<div className="min-w-0 flex-1">
|
||
<div className="flex items-start gap-2">
|
||
{showReferenceNumber && (
|
||
<span className="bg-primary/10 text-primary border-primary/20 mt-1 inline-flex size-6 shrink-0 items-center justify-center rounded-full border text-xs font-semibold tabular-nums">
|
||
{source.index}
|
||
</span>
|
||
)}
|
||
<DialogTitle className="text-base leading-relaxed">
|
||
{source.title}
|
||
</DialogTitle>
|
||
</div>
|
||
{meta.length > 0 && (
|
||
<DialogDescription className="mt-2 flex flex-wrap gap-x-2 gap-y-1 text-xs">
|
||
{meta.map((item, index) => (
|
||
<span key={`${item}-${index}`}>{item}</span>
|
||
))}
|
||
</DialogDescription>
|
||
)}
|
||
</div>
|
||
{source.url && !previewTarget && (
|
||
<Button size="icon-sm" variant="outline" asChild>
|
||
<a
|
||
href={source.url}
|
||
target="_blank"
|
||
rel="noopener noreferrer"
|
||
aria-label="打开来源"
|
||
>
|
||
<ExternalLinkIcon className="size-4" />
|
||
</a>
|
||
</Button>
|
||
)}
|
||
</div>
|
||
</DialogHeader>
|
||
{previewTarget ? (
|
||
<WeKnoraSourceContextPanel
|
||
context={context}
|
||
loading={contextLoading}
|
||
error={contextError}
|
||
/>
|
||
) : paragraphs.length > 0 ? (
|
||
<div className="text-foreground max-h-[55vh] space-y-3 overflow-y-auto text-sm leading-relaxed">
|
||
{paragraphs.map((paragraph, index) => (
|
||
<p key={index} className="whitespace-pre-wrap">
|
||
{paragraph}
|
||
</p>
|
||
))}
|
||
</div>
|
||
) : null}
|
||
{source.url && !previewTarget && (
|
||
<div className="text-muted-foreground border-t pt-3 text-xs break-all">
|
||
{source.url}
|
||
</div>
|
||
)}
|
||
</DialogContent>
|
||
</Dialog>
|
||
</>
|
||
);
|
||
}
|
||
|
||
type WeKnoraPreviewTarget = {
|
||
knowledgeBaseId: string;
|
||
chunkId: string;
|
||
};
|
||
|
||
type WeKnoraSourceContext = {
|
||
knowledge_base_name?: string;
|
||
document_title?: string;
|
||
document_file_name?: string;
|
||
focus_chunk_id: string;
|
||
chunks: Array<{
|
||
id: string;
|
||
chunk_index?: number;
|
||
content: string;
|
||
is_focus: boolean;
|
||
}>;
|
||
};
|
||
|
||
function parseWeKnoraPreviewUrl(url?: string): WeKnoraPreviewTarget | null {
|
||
if (!url?.startsWith("/weknora-source-preview?")) {
|
||
return null;
|
||
}
|
||
const queryIndex = url.indexOf("?");
|
||
const params = new URLSearchParams(url.slice(queryIndex + 1));
|
||
const knowledgeBaseId = params.get("knowledge_base_id")?.trim();
|
||
const chunkId = params.get("chunk_id")?.trim();
|
||
return knowledgeBaseId && chunkId ? { knowledgeBaseId, chunkId } : null;
|
||
}
|
||
|
||
function isWeKnoraSourceContextResponse(
|
||
value: unknown,
|
||
): value is { success: true; data: WeKnoraSourceContext } {
|
||
if (!value || typeof value !== "object") {
|
||
return false;
|
||
}
|
||
const data = (value as { data?: unknown }).data;
|
||
return (
|
||
(value as { success?: unknown }).success === true &&
|
||
!!data &&
|
||
typeof data === "object" &&
|
||
Array.isArray((data as WeKnoraSourceContext).chunks)
|
||
);
|
||
}
|
||
|
||
function readPreviewError(payload: unknown, status: number): string {
|
||
if (payload && typeof payload === "object") {
|
||
const detail = (payload as { detail?: unknown }).detail;
|
||
if (typeof detail === "string" && detail) {
|
||
return detail;
|
||
}
|
||
}
|
||
return status === 404 ? "原文已不可用" : "无法加载原文上下文";
|
||
}
|
||
|
||
function WeKnoraSourceContextPanel({
|
||
context,
|
||
loading,
|
||
error,
|
||
}: {
|
||
context: WeKnoraSourceContext | null;
|
||
loading: boolean;
|
||
error: string | null;
|
||
}) {
|
||
if (loading) {
|
||
return (
|
||
<div className="text-muted-foreground flex min-h-36 items-center justify-center gap-2 text-sm">
|
||
<LoaderCircle className="size-4 animate-spin" />
|
||
正在加载原文上下文…
|
||
</div>
|
||
);
|
||
}
|
||
if (error) {
|
||
return (
|
||
<div className="border-destructive/30 bg-destructive/5 text-destructive rounded-lg border p-3 text-sm">
|
||
{error}
|
||
</div>
|
||
);
|
||
}
|
||
if (!context) {
|
||
return null;
|
||
}
|
||
return (
|
||
<div className="max-h-[55vh] space-y-3 overflow-y-auto pr-1">
|
||
<div className="bg-muted/60 text-muted-foreground rounded-lg px-3 py-2 text-xs">
|
||
<span>{context.knowledge_base_name || "WeKnora 知识库"}</span>
|
||
{context.document_title && <span> · {context.document_title}</span>}
|
||
</div>
|
||
{context.chunks.map((chunk) => (
|
||
<section
|
||
key={chunk.id}
|
||
className={cn(
|
||
"rounded-lg border p-3 text-sm leading-relaxed",
|
||
chunk.is_focus
|
||
? "border-primary/50 bg-primary/5 shadow-sm"
|
||
: "bg-muted/20",
|
||
)}
|
||
>
|
||
<div className="text-muted-foreground mb-2 flex items-center gap-2 text-xs">
|
||
<span>分段 {typeof chunk.chunk_index === "number" ? chunk.chunk_index + 1 : "-"}</span>
|
||
{chunk.is_focus && (
|
||
<span className="bg-primary text-primary-foreground rounded px-1.5 py-0.5 font-medium">
|
||
检索命中
|
||
</span>
|
||
)}
|
||
</div>
|
||
<p className="whitespace-pre-wrap">{chunk.content}</p>
|
||
</section>
|
||
))}
|
||
</div>
|
||
);
|
||
}
|
||
|
||
function cleanReferenceText(
|
||
raw: string | undefined,
|
||
cleanupWords: string[],
|
||
): string {
|
||
let text = raw ?? "";
|
||
const words = cleanupWords.map((word) => word.trim()).filter(Boolean);
|
||
if (words.length > 0) {
|
||
text = text
|
||
.replace(/\r\n/g, "\n")
|
||
.split("\n")
|
||
.filter((line) => !words.some((word) => line.includes(word)))
|
||
.join("\n");
|
||
}
|
||
return text
|
||
.replace(/\r\n/g, "\n")
|
||
.replace(/[ \t]+\n/g, "\n")
|
||
.replace(/\n{3,}/g, "\n\n")
|
||
.trim();
|
||
}
|
||
|
||
function compactReferenceText(text: string): string {
|
||
return text.replace(/\s+/g, " ").trim();
|
||
}
|
||
|
||
function segmentReferenceText(text: string): string[] {
|
||
const explicit = text
|
||
.split(/\n{2,}/)
|
||
.map((item) => item.trim())
|
||
.filter(Boolean);
|
||
const base = explicit.length > 1 ? explicit : splitLongParagraph(text);
|
||
return base.slice(0, 80);
|
||
}
|
||
|
||
function splitLongParagraph(text: string): string[] {
|
||
const normalized = text
|
||
.split(/\n+/)
|
||
.map((item) => item.trim())
|
||
.filter(Boolean)
|
||
.join("\n");
|
||
if (normalized.length <= 360) {
|
||
return normalized ? [normalized] : [];
|
||
}
|
||
|
||
const sentences = normalized
|
||
.split(/(?<=[。!?!?;;])\s*/)
|
||
.map((item) => item.trim())
|
||
.filter(Boolean);
|
||
if (sentences.length <= 1) {
|
||
return normalized.match(/[\s\S]{1,360}/g) ?? [];
|
||
}
|
||
|
||
const paragraphs: string[] = [];
|
||
let current = "";
|
||
for (const sentence of sentences) {
|
||
if ((current + sentence).length > 360 && current) {
|
||
paragraphs.push(current.trim());
|
||
current = "";
|
||
}
|
||
current += sentence;
|
||
}
|
||
if (current.trim()) {
|
||
paragraphs.push(current.trim());
|
||
}
|
||
return paragraphs;
|
||
}
|