"use client"; import { useEffect, useRef, useState } from "react"; import { useForm } from "react-hook-form"; import { zodResolver } from "@hookform/resolvers/zod"; import { ChevronDown, Info } from "lucide-react"; import { Collapsible, CollapsibleContent, CollapsibleTrigger, } from "@/components/ui/collapsible"; import { Form } from "@/components/ui/form"; import { Label } from "@/components/ui/label"; import type { FilterBuilderHandle } from "@/components/retrieval/filter-builder"; import { RetrievalParamsFields } from "@/components/retrieval/retrieval-params-fields"; import { retrievalSchema, type RetrievalInput } from "@/schemas/retrieval"; import { DEFAULT_PER_KB_TOP_K, useChatConfig, } from "@/components/chat/chat-config-context"; import type { ChatRetrievalConfig } from "@/hooks/use-chat-history"; import { useI18n } from "@/i18n/i18n-context"; import type { KnowledgeBase } from "@/types/knowledge-base"; interface UnifiedRetrievalSectionProps { disabled: boolean; singleKb: KnowledgeBase | undefined; } /** Subset of `RetrievalInput` fields persisted to `ChatRetrievalConfig`. */ const RETRIEVAL_CFG_KEYS = [ "searchType", "rerankType", "rrfK", "rrfDenseWeight", "rrfFullTextWeight", "weightDense", "weightFullText", "modelName", "modelProvider", ] as const satisfies readonly (keyof RetrievalInput & keyof ChatRetrievalConfig)[]; /** * Session-wide retrieval parameter editor. The same configuration is applied * to every mounted KB at send time so cross-KB scores stay comparable — any * per-KB divergence would make the post-merge global sort meaningless. * * Disabled when no KB is mounted; multi-KB mode drops the KB-specific * `FilterBuilder` because metadata filters are only meaningful against a * known schema (the retrieval-test page remains the place to debug filters). */ export function UnifiedRetrievalSection({ disabled, singleKb, }: UnifiedRetrievalSectionProps) { const { t } = useI18n(); const cfg = useChatConfig(); // Filter ref is required by RetrievalParamsFields' API even when we choose // not to render FilterBuilder (we skip it unconditionally here). const filterRef = useRef(null); const form = useForm({ resolver: zodResolver(retrievalSchema), defaultValues: { // `knowledgeBaseName` is structurally required by the schema but unused // here; a placeholder keeps Zod quiet without leaking into persistence. knowledgeBaseName: singleKb?.knowledgeBaseName ?? "__unified__", queryType: "TEXT" as const, query: "__unified_placeholder__", subspace: [], topK: cfg.perKbTopK, searchType: cfg.retrieval.searchType ?? ["DENSE_VECTOR", "FULL_TEXT"], rerankType: cfg.retrieval.rerankType, rrfK: cfg.retrieval.rrfK, rrfDenseWeight: cfg.retrieval.rrfDenseWeight, rrfFullTextWeight: cfg.retrieval.rrfFullTextWeight, weightDense: cfg.retrieval.weightDense, weightFullText: cfg.retrieval.weightFullText, modelName: cfg.retrieval.modelName, modelProvider: cfg.retrieval.modelProvider, }, }); // Rehydrate the form when the underlying context is hydrated from a // session load; RHF does not observe defaultValues after mount so we // mirror the relevant fields through reset(). useEffect(() => { form.reset({ knowledgeBaseName: singleKb?.knowledgeBaseName ?? "__unified__", queryType: "TEXT" as const, query: "__unified_placeholder__", subspace: [], topK: cfg.perKbTopK, searchType: cfg.retrieval.searchType ?? ["DENSE_VECTOR", "FULL_TEXT"], rerankType: cfg.retrieval.rerankType, rrfK: cfg.retrieval.rrfK, rrfDenseWeight: cfg.retrieval.rrfDenseWeight, rrfFullTextWeight: cfg.retrieval.rrfFullTextWeight, weightDense: cfg.retrieval.weightDense, weightFullText: cfg.retrieval.weightFullText, modelName: cfg.retrieval.modelName, modelProvider: cfg.retrieval.modelProvider, }); // `form` is stable from RHF; depending on the whole `cfg.retrieval` // object is intentional to pick up hydrate() updates. // eslint-disable-next-line react-hooks/exhaustive-deps }, [cfg.retrieval, cfg.perKbTopK, singleKb?.knowledgeBaseName]); const commit = () => { const values = form.getValues(); const next: ChatRetrievalConfig = {}; for (const k of RETRIEVAL_CFG_KEYS) { const v = values[k]; if (v !== undefined && !(Array.isArray(v) && v.length === 0)) { // `as never` sidesteps the union-over-keys assignment; each key is // already validated by the satisfies clause on RETRIEVAL_CFG_KEYS. (next as Record)[k] = v; } } cfg.setRetrieval(next); cfg.setPerKbTopK( typeof values.topK === "number" && values.topK >= 0 ? values.topK : DEFAULT_PER_KB_TOP_K, ); }; // When the user switches rerank strategy to MODEL, fill in a sensible // provider/model pair if either is blank. Mirrors the KB creation form's // default (bailian + gte-rerank-v2) and writes back to the context right // away — without this, users who toggle strategy without touching the // provider/model inputs would see empty values persisted on next onBlur. const rerankType = form.watch("rerankType"); useEffect(() => { if (rerankType !== "MODEL") return; let touched = false; if (!form.getValues("modelProvider")) { form.setValue("modelProvider", "bailian"); touched = true; } if (!form.getValues("modelName")) { form.setValue("modelName", "gte-rerank-v2"); touched = true; } if (touched) commit(); // `commit` and `form` are stable references within this component; // we only want this effect to fire when the strategy actually changes. // eslint-disable-next-line react-hooks/exhaustive-deps }, [rerankType]); // 默认折叠:现在的角色从“统一应用”降格为“默认 fallback”,绝大部分 // 用户在 KB 自定义参数后无需展开此区域。disabled 状态下隐藏触发器, // 避免用户在没有挂载 KB 时点开一个内容为空的折叠区。 const [open, setOpen] = useState(false); return ( { if (disabled) return; setOpen(next); }} className={ "space-y-3 border-t border-[hsl(var(--border))] pt-4" + (disabled ? " pointer-events-none opacity-50" : "") } aria-disabled={disabled} >

{t("chat.config.unifiedDesc")}

{!disabled && ( )}
{disabled ? (
{t("chat.config.unifiedDisabledHint")}
) : (
e.preventDefault()} onBlur={commit} className="space-y-4" >
)}
); }