@tablestore/tablestore-agent-cli 0.1.9 → 0.2.1

package/dist/dashboard-runtime/dashboard/src/components/retrieval/retrieval-params-fields.tsx

@@ -4,7 +4,6 @@ import { useEffect, useRef } from "react";
 import type { UseFormReturn } from "react-hook-form";
 import { Check, ChevronDown, HelpCircle, Info } from "lucide-react";
 
-import { Input } from "@/components/ui/input";
 import { Button } from "@/components/ui/button";
 import { useSubspaceOptional } from "@/contexts/subspace-context";
 import {
@@ -27,6 +26,7 @@ import {
   TooltipTrigger,
 } from "@/components/ui/tooltip";
 import { TagInput } from "@/components/shared/tag-input";
+import { RetrievalResultCountField } from "@/components/knowledge-base/retrieval-result-count-field";
 import { FilterBuilder, type FilterBuilderHandle } from "./filter-builder";
 import { RetrievalRerankFields } from "./retrieval-rerank-fields";
 import type { RetrievalInput } from "@/schemas/retrieval";
@@ -58,6 +58,7 @@ export interface RetrievalParamsFieldsProps {
    *  label. Used for verbose explanations that would otherwise wrap the
    *  label across multiple lines and break left/right column alignment. */
   topKHint?: string;
+  topKMode?: "split" | "single";
 }
 
 export function RetrievalParamsFields({
@@ -66,11 +67,13 @@ export function RetrievalParamsFields({
   filterRef,
   topKLabel = "返回数量",
   topKHint,
+  topKMode = "split",
 }: RetrievalParamsFieldsProps) {
   const currentSearchType = form.watch("searchType");
+  const denseEnabled = !!currentSearchType?.includes("DENSE_VECTOR");
+  const fullTextEnabled = !!currentSearchType?.includes("FULL_TEXT");
   const hybrid =
-    !!currentSearchType?.includes("DENSE_VECTOR") &&
-    !!currentSearchType?.includes("FULL_TEXT");
+    denseEnabled && fullTextEnabled;
   const metadataFields = knowledgeBase?.metadata ?? [];
 
   // Pre-fill the subspace field with the active scope, but only once per
@@ -114,59 +117,14 @@ export function RetrievalParamsFields({
         />
       )}
 
-      <div className="grid gap-4 sm:grid-cols-2">
-        <FormField
-          control={form.control}
-          name="topK"
-          render={({ field }) => (
-            <FormItem className="space-y-1.5">
-              <div className="flex items-center gap-1">
-                <FormLabel className="leading-tight">{topKLabel}</FormLabel>
-                {topKHint ? (
-                  <TooltipProvider delayDuration={150}>
-                    <Tooltip>
-                      <TooltipTrigger asChild>
-                        <button
-                          type="button"
-                          tabIndex={-1}
-                          aria-label="字段说明"
-                          className="inline-flex h-5 w-5 items-center justify-center rounded text-muted-foreground/60 transition-colors hover:bg-[hsl(var(--muted))] hover:text-foreground"
-                        >
-                          <HelpCircle className="h-3.5 w-3.5" />
-                        </button>
-                      </TooltipTrigger>
-                      <TooltipContent
-                        side="top"
-                        sideOffset={6}
-                        className="z-[60] max-w-[240px] border border-[hsl(var(--border))] bg-[hsl(var(--popover))] px-3 py-2 text-xs leading-relaxed text-[hsl(var(--popover-foreground))] shadow-md"
-                      >
-                        {topKHint}
-                      </TooltipContent>
-                    </Tooltip>
-                  </TooltipProvider>
-                ) : null}
-              </div>
-              <FormControl>
-                <Input
-                  type="number"
-                  min={1}
-                  max={100}
-                  className="h-9"
-                  {...field}
-                  onChange={(event) =>
-                    field.onChange(
-                      event.target.value
-                        ? Number(event.target.value)
-                        : undefined,
-                    )
-                  }
-                />
-              </FormControl>
-              <FormMessage />
-            </FormItem>
-          )}
-        />
-
+      <div className={topKMode === "single" ? "grid gap-4 sm:grid-cols-2" : "space-y-4"}>
+        {topKMode === "single" ? (
+          <TopKNumberField
+            form={form}
+            label={topKLabel}
+            hint={topKHint}
+          />
+        ) : null}
         <FormField
           control={form.control}
           name="searchType"
@@ -202,6 +160,44 @@ export function RetrievalParamsFields({
         />
       </div>
 
+      {topKMode === "split" ? (
+        <div className="space-y-3">
+          <div className="space-y-1">
+            <p className="text-sm font-medium text-[hsl(var(--foreground))]">
+              返回数量
+            </p>
+            <p className="text-xs text-[hsl(var(--muted-foreground))]">
+              控制每路召回参与排序的候选数，以及 Rerank 后实际返回的片段数。
+            </p>
+          </div>
+          <div className="grid grid-cols-[repeat(auto-fit,minmax(min(260px,100%),1fr))] gap-3">
+            <RetrievalResultCountField
+              control={form.control}
+              name="denseTopK"
+              label="向量召回数"
+              description="向量检索参与后续排序的候选片段数。"
+              max={100}
+              muted={!denseEnabled}
+            />
+            <RetrievalResultCountField
+              control={form.control}
+              name="fullTextTopK"
+              label="全文召回数"
+              description="全文检索参与后续排序的候选片段数。"
+              max={100}
+              muted={!fullTextEnabled}
+            />
+          </div>
+          <RetrievalResultCountField
+            control={form.control}
+            name="rerankTopK"
+            label="重排序返回数"
+            description="Rerank 后保留并返回的片段数。"
+            max={200}
+          />
+        </div>
+      ) : null}
+
       <div className="space-y-2">
         <FormField
           control={form.control}
@@ -279,3 +275,65 @@ export function RetrievalParamsFields({
     </>
   );
 }
+
+function TopKNumberField({
+  form,
+  label,
+  hint,
+}: {
+  form: UseFormReturn<RetrievalInput>;
+  label: string;
+  hint?: string;
+}) {
+  return (
+    <FormField
+      control={form.control}
+      name="topK"
+      render={({ field }) => (
+        <FormItem className="space-y-1.5">
+          <div className="flex items-center gap-1">
+            <FormLabel className="leading-tight">{label}</FormLabel>
+            {hint ? (
+              <TooltipProvider delayDuration={150}>
+                <Tooltip>
+                  <TooltipTrigger asChild>
+                    <button
+                      type="button"
+                      tabIndex={-1}
+                      aria-label="字段说明"
+                      className="inline-flex h-5 w-5 items-center justify-center rounded text-muted-foreground/60 transition-colors hover:bg-[hsl(var(--muted))] hover:text-foreground"
+                    >
+                      <HelpCircle className="h-3.5 w-3.5" />
+                    </button>
+                  </TooltipTrigger>
+                  <TooltipContent
+                    side="top"
+                    sideOffset={6}
+                    className="z-[60] max-w-[240px] border border-[hsl(var(--border))] bg-[hsl(var(--popover))] px-3 py-2 text-xs leading-relaxed text-[hsl(var(--popover-foreground))] shadow-md"
+                  >
+                    {hint}
+                  </TooltipContent>
+                </Tooltip>
+              </TooltipProvider>
+            ) : null}
+          </div>
+          <FormControl>
+            <input
+              type="number"
+              min={0}
+              max={100}
+              className="flex h-9 w-full rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--card))] px-3 py-1 text-sm transition-colors focus-visible:border-[hsl(var(--primary))] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[hsl(var(--primary)/0.2)]"
+              {...field}
+              onChange={(event) =>
+                field.onChange(
+                  event.target.value ? Number(event.target.value) : undefined,
+                )
+              }
+            />
+          </FormControl>
+          <FormMessage />
+        </FormItem>
+      )}
+    />
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/retrieval/retrieval-rerank-fields.tsx

@@ -19,6 +19,7 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
+import { Slider } from "@/components/ui/slider";
 import type { RetrievalInput } from "@/schemas/retrieval";
 
 interface RerankFieldsProps {
@@ -106,32 +107,63 @@ function RrfFields({ form }: { form: UseFormReturn<RetrievalInput> }) {
 }
 
 function WeightFields({ form }: { form: UseFormReturn<RetrievalInput> }) {
+  // WEIGHT rerank weights are bounded 0–1 floats — the previous "0 ~ 1"
+  // FormDescription read as a clunky bottom caption. A slider with the
+  // numeric value pinned inline next to the label communicates the
+  // range visually and gives instant tactile feedback, no caption needed.
   return (
-    <RerankPanel cols={2}>
-      <NumField
-        form={form}
-        name="weightDense"
-        label="向量权重"
-        step={0.1}
-        min={0}
-        max={1}
-        placeholder="0.5"
-        description="0 ~ 1"
-      />
-      <NumField
-        form={form}
-        name="weightFullText"
-        label="全文权重"
-        step={0.1}
-        min={0}
-        max={1}
-        placeholder="0.5"
-        description="0 ~ 1"
-      />
+    <RerankPanel cols={1}>
+      <WeightSliderField form={form} name="weightDense" label="向量权重" />
+      <WeightSliderField form={form} name="weightFullText" label="全文权重" />
     </RerankPanel>
   );
 }
 
+function WeightSliderField({
+  form,
+  name,
+  label,
+}: {
+  form: UseFormReturn<RetrievalInput>;
+  name: "weightDense" | "weightFullText";
+  label: string;
+}) {
+  return (
+    <FormField
+      control={form.control}
+      name={name}
+      render={({ field }) => {
+        const value =
+          typeof field.value === "number" && Number.isFinite(field.value)
+            ? field.value
+            : 0.5;
+        return (
+          <FormItem>
+            <div className="flex items-center justify-between gap-3">
+              <FormLabel>{label}</FormLabel>
+              <span className="rounded bg-[hsl(var(--secondary))] px-2 py-0.5 text-xs font-medium tabular-nums text-[hsl(var(--foreground))]">
+                {value.toFixed(2)}
+              </span>
+            </div>
+            <FormControl>
+              <Slider
+                min={0}
+                max={1}
+                step={0.05}
+                value={[value]}
+                onValueChange={(values) => field.onChange(values[0] ?? 0)}
+                onBlur={field.onBlur}
+                aria-label={label}
+              />
+            </FormControl>
+            <FormMessage />
+          </FormItem>
+        );
+      }}
+    />
+  );
+}
+
 /** Providers currently wired up on the server side. Kept inline because the
  *  list is short and the settings page uses the same hard-coded catalogue. */
 const PROVIDER_OPTIONS: { value: string; label: string }[] = [
@@ -185,10 +217,15 @@ function RerankPanel({
   cols = 3,
   children,
 }: {
-  cols?: 2 | 3;
+  cols?: 1 | 2 | 3;
   children: React.ReactNode;
 }) {
-  const colClass = cols === 2 ? "sm:grid-cols-2" : "sm:grid-cols-3";
+  const colClass =
+    cols === 1
+      ? "grid-cols-1"
+      : cols === 2
+        ? "sm:grid-cols-2"
+        : "sm:grid-cols-3";
   return (
     <div className={"grid gap-3 px-0.5 pt-1 " + colClass}>{children}</div>
   );

package/dist/dashboard-runtime/dashboard/src/components/shared/empty-state.tsx

@@ -25,7 +25,7 @@ export function EmptyState({
           <Icon className="text-primary" size={36} strokeWidth={1.75} />
         </div>
       )}
-      <h3 className="mb-2 font-display text-lg font-semibold text-foreground">
+      <h3 className="mb-2 text-base font-semibold text-foreground">
         {title}
       </h3>
       <p className="mb-6 max-w-sm text-sm text-muted-foreground">

package/dist/dashboard-runtime/dashboard/src/components/shared/error-state.tsx

@@ -31,7 +31,7 @@ export function ErrorState({ error, onRetry }: ErrorStateProps) {
           strokeWidth={1.75}
         />
       </div>
-      <h3 className="mb-2 font-display text-lg font-semibold text-foreground">
+      <h3 className="mb-2 text-base font-semibold text-foreground">
         Failed to load data
       </h3>
       <p className="mb-1 max-w-md text-sm text-muted-foreground">

package/dist/dashboard-runtime/dashboard/src/components/shared/llm-model-selector.tsx

@@ -1,11 +1,23 @@
 "use client";
 
-import { useEffect, useMemo } from "react";
-import { Loader2, RefreshCw } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import { Check, ChevronsUpDown, Loader2, Plus, RefreshCw } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
-import { Input } from "@/components/ui/input";
+import {
+  Command,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+} from "@/components/ui/command";
 import { Label } from "@/components/ui/label";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
 import {
   Select,
   SelectContent,
@@ -15,18 +27,15 @@ import {
 } from "@/components/ui/select";
 import { useLLMProviders } from "@/hooks/use-llm-providers";
 import { useLLMProviderModels } from "@/hooks/use-llm-provider-models";
+import { cn } from "@/lib/utils";
 
 interface LLMModelSelectorProps {
   providerId: string;
   model: string;
   onProviderChange: (providerId: string, defaultModel?: string) => void;
   onModelChange: (model: string) => void;
-  /**
-   * Show a free-text input next to the model dropdown so users can type any
-   * model id (useful when the provider's model list isn't exhaustive).
-   * Defaults to false; the chat config drawer keeps the dropdown only,
-   * while the QA tester opts in.
-   */
+  /** @deprecated Free-text typing is now part of the unified combobox in
+   *  every surface; this flag is ignored. Kept for callsite compatibility. */
   allowFreeText?: boolean;
   /** Auto-select the first provider on mount when no providerId is set. */
   autoSelectFirst?: boolean;
@@ -37,17 +46,19 @@ interface LLMModelSelectorProps {
 }
 
 /**
- * Reusable Provider + Model selector. Both QA test page and chat config
- * drawer mounted nearly identical inline copies of this widget; centralising
- * the data fetch + auto-select + refresh-list affordance keeps behaviour
- * uniform across surfaces.
+ * Reusable Provider + Model selector. The provider stays a plain Select
+ * (the list is small and authoritative), but the model widget is a
+ * typeable combobox: it filters known model ids as the user types and
+ * always offers a `使用 "<typed>"` row so callers can submit a model
+ * the upstream `/models` endpoint did not return — useful when a
+ * provider exposes a partial list, or when the user wants to test a
+ * preview / private model id.
  */
 export function LLMModelSelector({
   providerId,
   model,
   onProviderChange,
   onModelChange,
-  allowFreeText = false,
   autoSelectFirst = false,
   providerLabel = "Provider",
   modelLabel = "Model",
@@ -101,7 +112,7 @@ export function LLMModelSelector({
                 providersLoading
                   ? "加载中..."
                   : providers.length === 0
-                    ? "请先在「大模型」中创建配置"
+                    ? "请先在「模型提供商」中创建配置"
                     : "选择 Provider"
               }
             />
@@ -135,62 +146,141 @@ export function LLMModelSelector({
             刷新列表
           </Button>
         </div>
-        {allowFreeText ? (
-          <div className="flex gap-2">
-            <Select
-              value={modelOptions.includes(model) ? model : ""}
-              onValueChange={onModelChange}
-              disabled={!providerId}
-            >
-              <SelectTrigger className="flex-1">
-                <SelectValue placeholder="选择或输入模型名" />
-              </SelectTrigger>
-              <SelectContent>
-                {modelOptions.length === 0 ? (
-                  <div className="px-3 py-2 text-xs text-muted-foreground">
-                    点击「刷新列表」拉取可用模型
-                  </div>
-                ) : (
-                  modelOptions.map((id) => (
-                    <SelectItem key={id} value={id}>
-                      {id}
-                    </SelectItem>
-                  ))
-                )}
-              </SelectContent>
-            </Select>
-            <Input
-              placeholder="或手动输入"
-              value={model}
-              onChange={(e) => onModelChange(e.target.value)}
-              className="flex-1"
-            />
-          </div>
-        ) : (
-          <Select
-            value={model}
-            onValueChange={onModelChange}
-            disabled={!providerId}
-          >
-            <SelectTrigger>
-              <SelectValue placeholder="选择模型" />
-            </SelectTrigger>
-            <SelectContent>
-              {modelOptions.length === 0 ? (
-                <SelectItem value="__empty" disabled>
-                  无可用模型
-                </SelectItem>
-              ) : (
-                modelOptions.map((id) => (
-                  <SelectItem key={id} value={id}>
-                    {id}
-                  </SelectItem>
-                ))
-              )}
-            </SelectContent>
-          </Select>
-        )}
+        <LLMModelCombobox
+          value={model}
+          options={modelOptions}
+          onChange={onModelChange}
+          disabled={!providerId}
+          fetching={modelsFetching}
+        />
       </div>
     </div>
   );
 }
+
+interface LLMModelComboboxProps {
+  value: string;
+  options: string[];
+  onChange: (model: string) => void;
+  disabled?: boolean;
+  fetching?: boolean;
+}
+
+/**
+ * Typeable model picker with custom-value escape hatch. Built on
+ * Popover + Command (cmdk) so the input filters the known list as the
+ * user types; if no exact match exists, an "use <typed>" row appears at
+ * the bottom of the list, letting the user commit a model id the
+ * upstream `/models` endpoint never returned.
+ */
+function LLMModelCombobox({
+  value,
+  options,
+  onChange,
+  disabled,
+  fetching,
+}: LLMModelComboboxProps) {
+  const [open, setOpen] = useState(false);
+  const [query, setQuery] = useState("");
+
+  // We do our own filtering so we can show a "use custom" row even when
+  // the typed value doesn't match any existing option.
+  const trimmed = query.trim();
+  const filtered = useMemo(() => {
+    if (!trimmed) return options;
+    const lower = trimmed.toLowerCase();
+    return options.filter((opt) => opt.toLowerCase().includes(lower));
+  }, [options, trimmed]);
+  const hasExactMatch = options.some(
+    (opt) => opt.toLowerCase() === trimmed.toLowerCase(),
+  );
+  const showCustom = trimmed.length > 0 && !hasExactMatch;
+
+  const commit = (next: string) => {
+    onChange(next);
+    setQuery("");
+    setOpen(false);
+  };
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>
+        <Button
+          type="button"
+          variant="outline"
+          role="combobox"
+          aria-expanded={open}
+          disabled={disabled}
+          className="w-full justify-between font-normal"
+        >
+          <span
+            className={cn(
+              "truncate text-left",
+              !value && "text-[hsl(var(--subtle))]",
+            )}
+          >
+            {value || "选择或输入模型名"}
+          </span>
+          <ChevronsUpDown className="h-4 w-4 shrink-0 opacity-50" />
+        </Button>
+      </PopoverTrigger>
+      <PopoverContent
+        align="start"
+        // cmdk's Command primitive sizes to its content, so widen the
+        // popover to match the trigger width for visual continuity.
+        className="w-[var(--radix-popover-trigger-width)] p-0"
+      >
+        <Command shouldFilter={false}>
+          <CommandInput
+            placeholder="搜索或输入模型名"
+            value={query}
+            onValueChange={setQuery}
+          />
+          <CommandList>
+            {filtered.length === 0 && !showCustom ? (
+              <CommandEmpty>
+                {fetching
+                  ? "正在拉取模型列表..."
+                  : options.length === 0
+                    ? "点击「刷新列表」拉取可用模型"
+                    : "无匹配结果"}
+              </CommandEmpty>
+            ) : null}
+            {filtered.length > 0 && (
+              <CommandGroup heading={showCustom ? "可选模型" : undefined}>
+                {filtered.map((id) => (
+                  <CommandItem
+                    key={id}
+                    value={id}
+                    onSelect={() => commit(id)}
+                  >
+                    <Check
+                      className={cn(
+                        "h-4 w-4",
+                        value === id ? "opacity-100" : "opacity-0",
+                      )}
+                    />
+                    <span className="truncate">{id}</span>
+                  </CommandItem>
+                ))}
+              </CommandGroup>
+            )}
+            {showCustom && (
+              <CommandGroup heading="使用自定义">
+                <CommandItem
+                  value={`__custom__${trimmed}`}
+                  onSelect={() => commit(trimmed)}
+                >
+                  <Plus className="h-4 w-4 text-[hsl(var(--primary))]" />
+                  <span className="truncate">
+                    使用 &quot;{trimmed}&quot;
+                  </span>
+                </CommandItem>
+              </CommandGroup>
+            )}
+          </CommandList>
+        </Command>
+      </PopoverContent>
+    </Popover>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/shared/relative-time.tsx

@@ -1,10 +1,16 @@
-
 "use client";
 
 import { useSyncExternalStore } from "react";
 import { formatDistanceToNow, format } from "date-fns";
 import { zhCN } from "date-fns/locale";
 
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+
 // Shared singleton timer — all RelativeTime instances share one tick
 let tick = 0;
 const listeners: Set<() => void> = new Set();
@@ -39,21 +45,39 @@ interface RelativeTimeProps {
   timestamp: number;
 }
 
+/**
+ * Shows a relative-time label (e.g. "2 小时前") with a styled tooltip
+ * exposing the absolute local-timezone timestamp on hover. Replaces
+ * the previous native `title` attribute, which had a 1.5 s delay and
+ * unstyled OS tooltip; the shadcn Tooltip surfaces instantly with the
+ * dashboard's own typography + shadow tokens.
+ */
 export function RelativeTime({ timestamp }: RelativeTimeProps) {
   useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
 
-  const relativeText = formatDistanceToNow(new Date(timestamp), {
+  const date = new Date(timestamp);
+  const relativeText = formatDistanceToNow(date, {
     addSuffix: true,
     locale: zhCN,
   });
 
-  const fullDate = format(new Date(timestamp), "yyyy-MM-dd HH:mm:ss", {
+  // `format` from date-fns uses the runtime's local timezone implicitly;
+  // showing the timezone offset tag (e.g. UTC+8) makes that explicit so
+  // users in different regions can interpret the value unambiguously.
+  const localText = format(date, "yyyy-MM-dd HH:mm:ss (OOOO)", {
     locale: zhCN,
   });
 
   return (
-    <span title={fullDate} className="cursor-default text-sm text-muted-foreground">
-      {relativeText}
-    </span>
+    <TooltipProvider delayDuration={150}>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <span className="cursor-default text-sm text-muted-foreground">
+            {relativeText}
+          </span>
+        </TooltipTrigger>
+        <TooltipContent side="top">{localText}</TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
   );
 }