@tablestore/tablestore-agent-cli 0.2.0 → 0.2.1

package/dist/dashboard-runtime/dashboard/src/components/chat/chat-mount-config.tsx

@@ -25,6 +25,7 @@ import { TemperatureSlider } from "@/components/shared/temperature-slider";
 import { newId } from "@/lib/random-id";
 
 import { AddMountRow } from "./add-mount-row";
+import { MountEmptyState } from "./mount-empty-state";
 import { MountRow } from "./mount-row";
 import { UnifiedRetrievalSection } from "./unified-retrieval-section";
 
@@ -163,35 +164,42 @@ export function ChatMountConfig({ open, onOpenChange, onSave }: ChatMountConfigP
               </div>
             </div>
 
-            <AddMountRow
-              kbs={availableKbs}
-              onAdd={(kb) =>
-                cfg.addMount({
-                  id: newId("mount"),
-                  knowledgeBaseName: kb.knowledgeBaseName,
-                })
-              }
-            />
-
             {cfg.mounts.length === 0 ? (
-              <p className="rounded-md border border-dashed border-[hsl(var(--border))] px-3 py-4 text-center text-xs text-muted-foreground">
-                还没有挂载知识库；添加一个以启用 RAG
-              </p>
+              <MountEmptyState
+                kbs={kbs}
+                onAdd={(kb) =>
+                  cfg.addMount({
+                    id: newId("mount"),
+                    knowledgeBaseName: kb.knowledgeBaseName,
+                  })
+                }
+              />
             ) : (
-              <div className="space-y-2">
-                {cfg.mounts.map((mount) => {
-                  const kb = kbs.find(
-                    (k) => k.knowledgeBaseName === mount.knowledgeBaseName,
-                  );
-                  return (
-                    <MountRow
-                      key={mount.id}
-                      mount={mount}
-                      subspaceEnabled={kb?.subspace === true}
-                    />
-                  );
-                })}
-              </div>
+              <>
+                <div className="space-y-2">
+                  {cfg.mounts.map((mount) => {
+                    const kb = kbs.find(
+                      (k) => k.knowledgeBaseName === mount.knowledgeBaseName,
+                    );
+                    return (
+                      <MountRow
+                        key={mount.id}
+                        mount={mount}
+                        subspaceEnabled={kb?.subspace === true}
+                      />
+                    );
+                  })}
+                </div>
+                <AddMountRow
+                  kbs={availableKbs}
+                  onAdd={(kb) =>
+                    cfg.addMount({
+                      id: newId("mount"),
+                      knowledgeBaseName: kb.knowledgeBaseName,
+                    })
+                  }
+                />
+              </>
             )}
           </div>
 

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

@@ -0,0 +1,87 @@
+"use client";
+
+import Link from "next/link";
+import { Database, Plus, Sparkles } from "lucide-react";
+
+import { Button } from "@/components/ui/button";
+import type { KnowledgeBase } from "@/types/knowledge-base";
+
+import { MountPicker } from "./mount-picker";
+
+interface MountEmptyStateProps {
+  /** All KBs that exist in the project. When empty we fall back to a
+   *  "create your first KB" hero instead of the picker. */
+  kbs: KnowledgeBase[];
+  onAdd: (kb: KnowledgeBase) => void;
+}
+
+/**
+ * Hero call-to-action shown when the chat session has zero mounted KBs. The
+ * card is intentionally the visual focal point of the panel — beginners
+ * previously missed the inline Select trigger because it read as a hint
+ * label rather than an action.
+ *
+ * Two variants:
+ *  • `kbs.length > 0`  → primary button opens the searchable picker
+ *  • `kbs.length === 0` → primary link sends the user to the KB creation page
+ *                        (no picker would have any items to offer)
+ */
+export function MountEmptyState({ kbs, onAdd }: MountEmptyStateProps) {
+  const hasNoKbs = kbs.length === 0;
+
+  return (
+    <div
+      className="animate-home-reveal relative overflow-hidden rounded-lg border border-dashed border-[hsl(var(--primary)/0.35)] bg-gradient-to-br from-[hsl(var(--primary-soft))] via-[hsl(var(--surface))] to-[hsl(var(--surface))] px-5 py-6 text-center"
+      role="region"
+      aria-label="挂载知识库"
+    >
+      {/* Decorative corner spark — subtle brand accent, no semantic meaning */}
+      <Sparkles
+        className="pointer-events-none absolute right-3 top-3 h-3.5 w-3.5 text-[hsl(var(--primary)/0.45)]"
+        aria-hidden
+      />
+
+      {/* Soft-tinted icon tile mirroring the home empty-state visual language */}
+      <div className="mx-auto mb-3 flex h-12 w-12 items-center justify-center rounded-xl bg-[hsl(var(--primary-soft))] ring-1 ring-[hsl(var(--primary)/0.18)]">
+        <Database className="h-6 w-6 text-[hsl(var(--primary))]" />
+      </div>
+
+      <h3 className="text-sm font-semibold text-[hsl(var(--foreground))]">
+        {hasNoKbs ? "还没有任何知识库" : "挂载知识库以启用 RAG"}
+      </h3>
+      <p className="mx-auto mt-1 max-w-[320px] text-xs leading-relaxed text-[hsl(var(--muted-foreground))]">
+        {hasNoKbs
+          ? "创建第一个知识库后，即可在对话中挂载并启用检索增强"
+          : "挂载后，模型将基于知识库内容生成回答，支持并行检索与全局重排"}
+      </p>
+
+      <div className="mt-4 flex flex-col items-center gap-2">
+        {hasNoKbs ? (
+          <Button asChild size="default" className="h-9 px-4">
+            <Link href="/knowledge-base/create">
+              <Database className="h-4 w-4" />
+              创建知识库
+            </Link>
+          </Button>
+        ) : (
+          <MountPicker kbs={kbs} onPick={onAdd} align="center">
+            <Button type="button" size="default" className="h-9 px-4">
+              <Plus className="h-4 w-4" />
+              挂载知识库
+            </Button>
+          </MountPicker>
+        )}
+
+        {!hasNoKbs ? (
+          <p className="text-[11px] text-[hsl(var(--muted-foreground))]">
+            从已有的{" "}
+            <span className="font-medium text-[hsl(var(--foreground))]">
+              {kbs.length}
+            </span>{" "}
+            个知识库中选择
+          </p>
+        ) : null}
+      </div>
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/chat/mount-picker.tsx

@@ -0,0 +1,87 @@
+"use client";
+
+import { useState, type ReactNode } from "react";
+import { Database } from "lucide-react";
+
+import {
+  Command,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+} from "@/components/ui/command";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
+import type { KnowledgeBase } from "@/types/knowledge-base";
+
+interface MountPickerProps {
+  /** KBs available to mount — typically the global list minus already-mounted. */
+  kbs: KnowledgeBase[];
+  onPick: (kb: KnowledgeBase) => void;
+  /** Render-prop trigger so the same picker can hang off either the empty-
+   *  state hero button or the compact "add more" affordance below the list. */
+  children: ReactNode;
+  /** Where to anchor the popover relative to the trigger. */
+  align?: "start" | "center" | "end";
+}
+
+/**
+ * Searchable knowledge-base picker rendered inside a Popover. Picking commits
+ * immediately and closes the popover — single-click feel matching the
+ * "label / member picker" pattern used by Linear, GitHub and Vercel.
+ *
+ * The trigger is render-prop-driven so the surrounding UI can promote it into
+ * a dominant primary button (when no KB is mounted yet) or demote it to a
+ * compact dashed pill (once the user has at least one mount).
+ */
+export function MountPicker({
+  kbs,
+  onPick,
+  children,
+  align = "start",
+}: MountPickerProps) {
+  const [open, setOpen] = useState(false);
+
+  const handleSelect = (name: string) => {
+    const kb = kbs.find((k) => k.knowledgeBaseName === name);
+    if (!kb) return;
+    onPick(kb);
+    setOpen(false);
+  };
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>{children}</PopoverTrigger>
+      <PopoverContent
+        align={align}
+        sideOffset={6}
+        className="w-[var(--radix-popover-trigger-width)] min-w-[260px] p-0"
+      >
+        <Command>
+          <CommandInput placeholder="搜索知识库..." />
+          <CommandList>
+            <CommandEmpty>未找到匹配的知识库</CommandEmpty>
+            {kbs.length > 0 ? (
+              <CommandGroup>
+                {kbs.map((kb) => (
+                  <CommandItem
+                    key={kb.knowledgeBaseName}
+                    value={kb.knowledgeBaseName}
+                    onSelect={handleSelect}
+                  >
+                    <Database className="text-[hsl(var(--muted-foreground))]" />
+                    <span className="truncate">{kb.knowledgeBaseName}</span>
+                  </CommandItem>
+                ))}
+              </CommandGroup>
+            ) : null}
+          </CommandList>
+        </Command>
+      </PopoverContent>
+    </Popover>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/chat/unified-retrieval-section.tsx

@@ -112,7 +112,7 @@ export function UnifiedRetrievalSection({
     }
     cfg.setRetrieval(next);
     cfg.setPerKbTopK(
-      typeof values.topK === "number" && values.topK > 0
+      typeof values.topK === "number" && values.topK >= 0
         ? values.topK
         : DEFAULT_PER_KB_TOP_K,
     );
@@ -173,7 +173,8 @@ export function UnifiedRetrievalSection({
               knowledgeBase={singleKb}
               filterRef={filterRef}
               topKLabel="每 KB topK"
-            topKHint="单库检索条数，默认 20"
+              topKHint="单库检索条数，默认 20"
+              topKMode="single"
             />
           </form>
         </Form>

package/dist/dashboard-runtime/dashboard/src/components/documents/doc-upload-dialog.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useCallback, useMemo, useRef } from "react";
-import { Upload, X, FileText, ChevronDown, ChevronRight, FolderOpen } from "lucide-react";
+import { Upload, X, FileText, ChevronDown, ChevronRight, FolderOpen, Cloud } from "lucide-react";
 import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
@@ -24,9 +24,23 @@ import {
 import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/ui/tabs";
 import { Checkbox } from "@/components/ui/checkbox";
 import { useUploadDocuments } from "@/hooks/use-upload-documents";
+import { useOssImport } from "@/hooks/use-oss-import";
+import {
+  filterFolderFiles,
+  parseExtensionList,
+  type RecursiveExtensionRules,
+} from "@/lib/extension-filter";
+import { buildFolderGlobs } from "@/lib/glob-filter";
+import { partitionSelection, type OssSelection } from "@/lib/oss-selection";
 import { cn } from "@/lib/utils";
 import type { MetadataField } from "@/types/knowledge-base";
 
+import {
+  OssImportTab,
+  EMPTY_OSS_FILTER,
+  type OssImportFilterState,
+} from "./oss-import-tab";
+
 interface DocUploadDialogProps {
   knowledgeBaseName: string;
   metadataFields?: MetadataField[];
@@ -35,7 +49,7 @@ interface DocUploadDialogProps {
   onOpenChange: (open: boolean) => void;
 }
 
-type UploadMode = "file" | "folder";
+type UploadMode = "file" | "folder" | "oss";
 
 /** Convert form string values to typed values based on field type */
 function convertMetadataValues(
@@ -75,25 +89,6 @@ function convertMetadataValues(
   return result;
 }
 
-/**
- * Normalize an extension-list input like ".md, pdf , .TXT" into a lowercase
- * array of dotted suffixes: [".md", ".pdf", ".txt"]. Empty tokens are
- * dropped and a leading dot is added when the user omits it.
- */
-function parseExtensionList(raw: string): string[] {
-  return raw
-    .split(",")
-    .map((s) => s.trim().toLowerCase())
-    .filter(Boolean)
-    .map((ext) => (ext.startsWith(".") ? ext : `.${ext}`));
-}
-
-interface FolderFilterOptions {
-  include: string[];
-  exclude: string[];
-  recursive: boolean;
-}
-
 /**
  * Minimal subset of the FileSystemEntry API we rely on. Typescript ships
  * loose types under DOM lib, but they don't reliably expose
@@ -195,27 +190,6 @@ function extractEntries(items: DataTransferItemList): FsEntry[] {
   return out;
 }
 
-/** Apply include / exclude / recursive filters to a batch of picked files. */
-function filterFolderFiles(list: File[], opts: FolderFilterOptions): File[] {
-  const { include, exclude, recursive } = opts;
-  return list.filter((file) => {
-    const relPath = file.webkitRelativePath || file.name;
-    // Depth is the number of slashes in the relative path; a top-level file
-    // inside the picked folder has exactly one ("<root>/<name>").
-    const depth = (relPath.match(/\//g) || []).length;
-    if (!recursive && depth > 1) return false;
-
-    const lowerName = file.name.toLowerCase();
-    if (include.length > 0 && !include.some((ext) => lowerName.endsWith(ext))) {
-      return false;
-    }
-    if (exclude.length > 0 && exclude.some((ext) => lowerName.endsWith(ext))) {
-      return false;
-    }
-    return true;
-  });
-}
-
 export function DocUploadDialog({
   knowledgeBaseName,
   metadataFields,
@@ -240,6 +214,13 @@ export function DocUploadDialog({
   const folderInputRef = useRef<HTMLInputElement | null>(null);
   const fileInputRef = useRef<HTMLInputElement | null>(null);
 
+  // OSS-mode state. Selection lives here (not in OssImportTab) so that
+  // tab-mode switches can reset it cleanly via resetForm().
+  const [ossSelection, setOssSelection] = useState<OssSelection>([]);
+  const [ossFilter, setOssFilter] = useState<OssImportFilterState>(EMPTY_OSS_FILTER);
+
+  const ossImport = useOssImport();
+
   const hasSchemaFields = metadataFields && metadataFields.length > 0;
   const uploadDocuments = useUploadDocuments();
 
@@ -252,7 +233,7 @@ export function DocUploadDialog({
         include: includeList,
         exclude: excludeList,
         recursive,
-      }),
+      } satisfies RecursiveExtensionRules),
     [folderRaw, includeList, excludeList, recursive],
   );
 
@@ -432,6 +413,8 @@ export function DocUploadDialog({
     setMode("file");
     setFiles([]);
     setFolderRaw([]);
+    setOssSelection([]);
+    setOssFilter(EMPTY_OSS_FILTER);
     setIncludeInput("");
     setExcludeInput("");
     setRecursive(true);
@@ -444,9 +427,17 @@ export function DocUploadDialog({
   const handleModeChange = useCallback((next: string) => {
     const nextMode = next as UploadMode;
     setMode(nextMode);
-    // Wipe the other tab's picks to avoid accidental submission of stale data.
-    if (nextMode === "file") setFolderRaw([]);
-    else setFiles([]);
+    // Wipe other tabs' picks to avoid accidental submission of stale data.
+    if (nextMode === "file") {
+      setFolderRaw([]);
+      setOssSelection([]);
+    } else if (nextMode === "folder") {
+      setFiles([]);
+      setOssSelection([]);
+    } else {
+      setFiles([]);
+      setFolderRaw([]);
+    }
   }, []);
 
   const updateMetadataField = useCallback((fieldName: string, value: string) => {
@@ -461,6 +452,91 @@ export function DocUploadDialog({
   }, [hasSchemaFields, metadataValues, metadataFields]);
 
   async function handleSubmit() {
+    // ---- OSS branch — early return, leaves the local-files/folder branch below intact ----
+    if (mode === "oss") {
+      const { fileKeys, folderPrefixes } = partitionSelection(ossSelection);
+      if (fileKeys.length === 0 && folderPrefixes.length === 0) {
+        toast.error("请在 OSS 浏览器中至少选择一个文件或文件夹");
+        return;
+      }
+
+      let metadata: Record<string, unknown> | undefined;
+      if (hasSchemaFields) {
+        const converted = convertMetadataValues(metadataValues, metadataFields!);
+        if (Object.keys(converted).length > 0) metadata = converted;
+      } else if (metadataJson.trim()) {
+        try {
+          metadata = JSON.parse(metadataJson) as Record<string, unknown>;
+        } catch {
+          toast.error("Metadata JSON 格式不正确");
+          return;
+        }
+      }
+
+      try {
+        // Translate the four free-text inputs into the server's glob form.
+        // Filters only travel on folder items; the hook ignores them when
+        // there is no folder selection, so the "filter applies to folder
+        // selections only" semantic is enforced once, in one place.
+        const { inclusionFilters, exclusionFilters } = buildFolderGlobs(ossFilter);
+        const result = await ossImport.mutateAsync({
+          knowledgeBaseName,
+          fileKeys,
+          folderPrefixes,
+          inclusionFilters,
+          exclusionFilters,
+          subspace: subspace || undefined,
+          metadata,
+        });
+        const details = result.documentDetails ?? [];
+        const failed = details.filter((d) => d.status.toLowerCase() === "failed");
+
+        // Distinguish "filter excluded everything" from a successful import.
+        if (details.length === 0) {
+          toast.warning("未导入任何文件", {
+            description:
+              folderPrefixes.length > 0
+                ? "选中的文件夹经过过滤后没有匹配项，请放宽过滤规则"
+                : "选择列表为空",
+          });
+          resetForm();
+          onOpenChange(false);
+          return;
+        }
+
+        if (failed.length === 0) {
+          toast.success(`成功导入 ${details.length} 个文档`);
+        } else if (failed.length < details.length) {
+          const reasons = [
+            ...new Set(failed.map((d) => d.failureReason).filter(Boolean)),
+          ];
+          toast.warning(
+            `${details.length - failed.length} 个导入成功，${failed.length} 个失败`,
+            { description: reasons.length > 0 ? reasons.slice(0, 3).join("; ") : undefined },
+          );
+        } else {
+          // All failed: show the first few distinct failureReasons so the user
+          // can diagnose without digging into devtools. The most common cause
+          // (until we surface it in the UI) is a server-side validation: e.g.
+          // unsupported file type, invalid OSS URI, bucket-endpoint mismatch.
+          const reasons = [
+            ...new Set(failed.map((d) => d.failureReason).filter(Boolean)),
+          ];
+          toast.error(`全部 ${failed.length} 个文档导入失败`, {
+            description:
+              reasons.length > 0 ? reasons.slice(0, 3).join("; ") : undefined,
+          });
+        }
+        resetForm();
+        onOpenChange(false);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "OSS 导入失败";
+        toast.error(message);
+      }
+      return;
+    }
+    // ---- end OSS branch; the existing handleSubmit body continues below this point unchanged ----
+
     if (effectiveFiles.length === 0) {
       toast.error(
         mode === "folder"
@@ -572,7 +648,7 @@ export function DocUploadDialog({
 
         <div className="space-y-4 min-w-0">
           <Tabs value={mode} onValueChange={handleModeChange}>
-            <TabsList className="grid w-full grid-cols-2">
+            <TabsList className="grid w-full grid-cols-3">
               <TabsTrigger value="file" className="gap-2">
                 <FileText className="h-3.5 w-3.5" />
                 按文件
@@ -581,6 +657,10 @@ export function DocUploadDialog({
                 <FolderOpen className="h-3.5 w-3.5" />
                 按文件夹
               </TabsTrigger>
+              <TabsTrigger value="oss" className="gap-2">
+                <Cloud className="h-3.5 w-3.5" />
+                从 OSS 导入
+              </TabsTrigger>
             </TabsList>
 
             {/* ---- File mode ---- */}
@@ -765,6 +845,16 @@ export function DocUploadDialog({
                 </div>
               )}
             </TabsContent>
+
+            {/* ---- OSS mode ---- */}
+            <TabsContent value="oss" className="space-y-3">
+              <OssImportTab
+                selection={ossSelection}
+                onSelectionChange={setOssSelection}
+                filter={ossFilter}
+                onFilterChange={setOssFilter}
+              />
+            </TabsContent>
           </Tabs>
 
           {/* 子空间 */}
@@ -876,19 +966,30 @@ export function DocUploadDialog({
               resetForm();
               onOpenChange(false);
             }}
-            disabled={uploadDocuments.isPending}
+            disabled={uploadDocuments.isPending || ossImport.isPending}
           >
             取消
           </Button>
           <Button
             onClick={handleSubmit}
-            disabled={effectiveFiles.length === 0 || uploadDocuments.isPending}
+            disabled={
+              (mode === "oss" && ossSelection.length === 0) ||
+              (mode !== "oss" && effectiveFiles.length === 0) ||
+              uploadDocuments.isPending ||
+              ossImport.isPending
+            }
           >
-            {uploadDocuments.isPending
-              ? uploadDocuments.progress
-                ? `上传中 ${uploadDocuments.progress.completedFiles}/${uploadDocuments.progress.totalFiles}`
-                : "准备上传..."
-              : `上传 ${effectiveFiles.length} 个文件`}
+            {mode === "oss"
+              ? ossImport.isPending
+                ? ossImport.progress
+                  ? `导入中 ${ossImport.progress.completedItems}/${ossImport.progress.totalItems}`
+                  : "提交中…"
+                : `导入 ${ossSelection.length} 项`
+              : uploadDocuments.isPending
+                ? uploadDocuments.progress
+                  ? `上传中 ${uploadDocuments.progress.completedFiles}/${uploadDocuments.progress.totalFiles}`
+                  : "准备上传..."
+                : `上传 ${effectiveFiles.length} 个文件`}
           </Button>
         </DialogFooter>
       </DialogContent>