@tablestore/tablestore-agent-cli 0.1.9 → 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-chunks-dialog.tsx

@@ -12,6 +12,12 @@ import {
   DialogTitle,
   DialogDescription,
 } from "@/components/ui/dialog";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
 import { listChunks, updateChunks } from "@/services/chunks";
 import { queryKeys } from "@/lib/query-keys";
 import { extractFileName } from "@/lib/utils";
@@ -145,34 +151,52 @@ function ChunkCard({
         <div className="flex items-center gap-1">
           {/* 状态开关 */}
           {chunk.status !== "failed" && (
-            <Button
-              variant="ghost"
-              size="icon"
-              className="h-7 w-7"
-              onClick={handleToggleStatus}
-              disabled={toggling}
-              title={isActive ? "停用切片" : "启用切片"}
-            >
-              {toggling ? (
-                <Loader2 className="h-3.5 w-3.5 animate-spin" />
-              ) : isActive ? (
-                <Power className="h-3.5 w-3.5 text-green-600" />
-              ) : (
-                <PowerOff className="h-3.5 w-3.5 text-gray-400" />
-              )}
-            </Button>
+            <TooltipProvider delayDuration={200}>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Button
+                    variant="ghost"
+                    size="icon"
+                    className="h-7 w-7"
+                    onClick={handleToggleStatus}
+                    disabled={toggling}
+                    aria-label={isActive ? "停用切片" : "启用切片"}
+                  >
+                    {toggling ? (
+                      <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                    ) : isActive ? (
+                      <Power className="h-3.5 w-3.5 text-[hsl(var(--success))]" />
+                    ) : (
+                      <PowerOff className="h-3.5 w-3.5 text-[hsl(var(--muted-foreground))]" />
+                    )}
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent side="top">
+                  {isActive
+                    ? "停用切片：检索时跳过此切片"
+                    : "启用切片：纳入检索"}
+                </TooltipContent>
+              </Tooltip>
+            </TooltipProvider>
           )}
           {/* 编辑按钮 */}
           {!editing && (
-            <Button
-              variant="ghost"
-              size="icon"
-              className="h-7 w-7"
-              onClick={() => setEditing(true)}
-              title="编辑切片"
-            >
-              <Pencil className="h-3.5 w-3.5" />
-            </Button>
+            <TooltipProvider delayDuration={200}>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <Button
+                    variant="ghost"
+                    size="icon"
+                    className="h-7 w-7"
+                    onClick={() => setEditing(true)}
+                    aria-label="编辑切片"
+                  >
+                    <Pencil className="h-3.5 w-3.5" />
+                  </Button>
+                </TooltipTrigger>
+                <TooltipContent side="top">编辑切片</TooltipContent>
+              </Tooltip>
+            </TooltipProvider>
           )}
         </div>
       </div>

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

@@ -1,13 +1,13 @@
 import type { ColumnDef } from "@tanstack/react-table";
-import { MoreHorizontal, Eye, Trash2, Layers } from "lucide-react";
+import { Eye, Trash2, Layers } from "lucide-react";
 import { Checkbox } from "@/components/ui/checkbox";
 import { Button } from "@/components/ui/button";
 import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuItem,
-  DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
 import { RelativeTime } from "@/components/shared/relative-time";
 import { DocStatusBadge } from "./doc-status-badge";
 import { extractFileName } from "@/lib/utils";
@@ -17,14 +17,12 @@ interface DocColumnsOptions {
   onView?: (document: Document) => void;
   onDelete?: (document: Document) => void;
   onViewChunks?: (document: Document) => void;
-  hideSubspace?: boolean;
 }
 
 export function createDocColumns({
   onView,
   onDelete,
   onViewChunks,
-  hideSubspace,
 }: DocColumnsOptions): ColumnDef<Document>[] {
   const columns: ColumnDef<Document>[] = [
     {
@@ -79,48 +77,61 @@ export function createDocColumns({
     },
     {
       id: "actions",
+      header: () => <span className="sr-only">操作</span>,
       cell: ({ row }) => (
-        <DropdownMenu>
-          <DropdownMenuTrigger asChild>
-            <Button variant="ghost" size="icon" className="h-8 w-8">
-              <MoreHorizontal className="h-4 w-4" />
-            </Button>
-          </DropdownMenuTrigger>
-          <DropdownMenuContent align="end">
-            <DropdownMenuItem onClick={() => onView?.(row.original)}>
-              <Eye className="mr-2 h-4 w-4" />
-              查看详情
-            </DropdownMenuItem>
-            <DropdownMenuItem onClick={() => onViewChunks?.(row.original)}>
-              <Layers className="mr-2 h-4 w-4" />
-              查看切片
-            </DropdownMenuItem>
-            <DropdownMenuItem
-              className="text-destructive focus:text-destructive"
-              onClick={() => onDelete?.(row.original)}
-            >
-              <Trash2 className="mr-2 h-4 w-4" />
-              删除
-            </DropdownMenuItem>
-          </DropdownMenuContent>
-        </DropdownMenu>
+        <TooltipProvider delayDuration={200}>
+          <div className="flex items-center justify-end gap-0.5">
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  className="h-7 w-7"
+                  onClick={() => onView?.(row.original)}
+                  aria-label="查看详情"
+                >
+                  <Eye className="h-3.5 w-3.5" />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent side="top">查看详情</TooltipContent>
+            </Tooltip>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  className="h-7 w-7"
+                  onClick={() => onViewChunks?.(row.original)}
+                  aria-label="查看切片"
+                >
+                  <Layers className="h-3.5 w-3.5" />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent side="top">查看切片</TooltipContent>
+            </Tooltip>
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <Button
+                  variant="ghost"
+                  size="icon"
+                  className="h-7 w-7 text-[hsl(var(--muted-foreground))] hover:bg-[hsl(var(--danger-soft))] hover:text-[hsl(var(--destructive))]"
+                  onClick={() => onDelete?.(row.original)}
+                  aria-label="删除"
+                >
+                  <Trash2 className="h-3.5 w-3.5" />
+                </Button>
+              </TooltipTrigger>
+              <TooltipContent side="top">删除</TooltipContent>
+            </Tooltip>
+          </div>
+        </TooltipProvider>
       ),
     },
   ];
 
-  if (!hideSubspace) {
-    // Insert the subspace column right after `ossKey` (index 2) so the visual
-    // order remains: select | ossKey | subspace | status | chunkNum | ...
-    columns.splice(2, 0, {
-      accessorKey: "subspace",
-      header: "子空间",
-      cell: ({ row }) => (
-        <span className="text-sm text-muted-foreground">
-          {row.original.subspace || "—"}
-        </span>
-      ),
-    });
-  }
-
+  // The subspace column is intentionally absent: when subspace is disabled
+  // it is always "_default" (no signal), and when subspace is enabled the
+  // user has already chosen one at the SubspaceGate so it is shown in the
+  // detail sidebar. Surfacing it again per-row is redundant noise.
   return columns;
 }

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

@@ -7,7 +7,6 @@ import type { Document } from "@/types/knowledge-base";
 
 interface DocTableProps {
   documents: Document[];
-  hideSubspace?: boolean;
   onView?: (document: Document) => void;
   onDelete?: (document: Document) => void;
   onViewChunks?: (document: Document) => void;
@@ -16,7 +15,6 @@ interface DocTableProps {
 
 export function DocTable({
   documents,
-  hideSubspace,
   onView,
   onDelete,
   onViewChunks,
@@ -25,8 +23,8 @@ export function DocTable({
   const [rowSelection, setRowSelection] = useState<Record<string, boolean>>({});
 
   const columns = useMemo(
-    () => createDocColumns({ onView, onDelete, onViewChunks, hideSubspace }),
-    [onView, onDelete, onViewChunks, hideSubspace]
+    () => createDocColumns({ onView, onDelete, onViewChunks }),
+    [onView, onDelete, onViewChunks]
   );
 
   const handleRowSelectionChange = (

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

@@ -39,7 +39,7 @@ export function DocToolbar({
   return (
     <div className="flex items-center gap-3 flex-wrap">
       <SearchInput
-        placeholder="搜索文档..."
+        placeholder="页内搜索..."
         value={searchQuery}
         onChange={onSearchChange}
       />