@tablestore/tablestore-agent-cli 0.1.9 → 0.2.0

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}
       />

package/dist/dashboard-runtime/dashboard/src/components/layout/detail-sidebar.tsx

@@ -0,0 +1,331 @@
+"use client";
+
+import * as React from "react";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { ArrowLeft } from "lucide-react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "@/lib/utils";
+import { useSidebarCollapsed } from "@/hooks/use-sidebar-collapsed";
+
+/**
+ * webUI-style "detail-page" secondary sidebar. Pairs with the primary
+ * application sidebar to give a master-detail layout for entity pages
+ * (knowledge bases, memory stores) that have many sub-routes and rich
+ * persistent context (description, tags, timestamps, etc.).
+ *
+ * The component is generic — consumers compose Header / Menu / Footer
+ * children to fit their entity, mirroring the way webUI's `.detail-layout`
+ * pattern is assembled around different entity types.
+ */
+export function DetailSidebar({
+  className,
+  children,
+}: {
+  className?: string;
+  children: React.ReactNode;
+}) {
+  return (
+    <aside
+      className={cn(
+        // Hidden on mobile (the primary mobile drawer already provides
+        // entity-level navigation); on desktop renders as a flex column
+        // that fills the parent shell's full height. Inside, header is
+        // auto-sized, menu fills with `flex-1 overflow-y-auto`, and the
+        // back button is anchored to the bottom — even when the menu is
+        // short or the page content is shorter than the viewport.
+        "hidden h-full w-[220px] shrink-0 flex-col border-r border-[hsl(var(--border))] bg-[hsl(var(--card))] overflow-hidden md:flex",
+        className,
+      )}
+    >
+      {children}
+    </aside>
+  );
+}
+
+const detailIconAccent = cva(
+  "flex h-9 w-9 items-center justify-center rounded-lg [&>svg]:h-[18px] [&>svg]:w-[18px]",
+  {
+    variants: {
+      accent: {
+        primary: "bg-[hsl(var(--primary-soft))] text-[hsl(var(--primary))]",
+        success: "bg-[hsl(var(--success-soft))] text-[hsl(var(--success))]",
+        warning: "bg-[hsl(var(--warning-soft))] text-[hsl(var(--warning))]",
+        danger: "bg-[hsl(var(--danger-soft))] text-[hsl(var(--danger))]",
+        purple: "bg-[hsl(var(--purple-soft))] text-[hsl(var(--purple))]",
+      },
+    },
+    defaultVariants: {
+      accent: "primary",
+    },
+  },
+);
+
+interface DetailSidebarHeaderProps
+  extends VariantProps<typeof detailIconAccent> {
+  icon: React.ReactNode;
+  name: React.ReactNode;
+  typeLabel?: React.ReactNode;
+  description?: React.ReactNode;
+  actions?: React.ReactNode;
+  /** Tags / chips / dates / extra info. Wrapped in a flex container with
+   *  small text already applied. */
+  extra?: React.ReactNode;
+}
+
+export function DetailSidebarHeader({
+  icon,
+  accent,
+  name,
+  typeLabel,
+  description,
+  actions,
+  extra,
+}: DetailSidebarHeaderProps) {
+  return (
+    <header className="flex flex-col gap-2 border-b border-[hsl(var(--border-light))] px-4 pb-4 pt-4">
+      <div className="flex items-start justify-between gap-2">
+        <div className={detailIconAccent({ accent })}>{icon}</div>
+        {actions ? <div className="-mt-1 -mr-1">{actions}</div> : null}
+      </div>
+      <div className="space-y-0.5">
+        <div className="text-sm font-semibold leading-tight text-[hsl(var(--foreground))]">
+          {name}
+        </div>
+        {typeLabel ? (
+          <div className="text-[11px] font-semibold uppercase tracking-wider text-[hsl(var(--muted-foreground))]">
+            {typeLabel}
+          </div>
+        ) : null}
+      </div>
+      {description ? (
+        <p className="line-clamp-3 text-[13px] leading-snug text-[hsl(var(--muted-foreground))]">
+          {description}
+        </p>
+      ) : null}
+      {extra ? (
+        <div className="flex flex-col gap-1.5 text-[11px] text-[hsl(var(--subtle))]">
+          {extra}
+        </div>
+      ) : null}
+    </header>
+  );
+}
+
+interface DetailSidebarMenuItem {
+  /** Full URL including any search params; passed straight to next/link. */
+  href: string;
+  label: React.ReactNode;
+  icon?: React.ReactNode;
+  /** Optional badge or count rendered on the right edge. */
+  endAdornment?: React.ReactNode;
+}
+
+export function DetailSidebarMenu({
+  items,
+  className,
+}: {
+  items: DetailSidebarMenuItem[];
+  className?: string;
+}) {
+  const pathname = usePathname() ?? "";
+  return (
+    <nav className={cn("flex-1 overflow-y-auto px-2 py-2", className)}>
+      <ul className="space-y-0.5">
+        {items.map((item) => {
+          // Strip any querystring from the href so we can match it against
+          // the bare pathname; otherwise an href like "/foo?bar=baz" never
+          // equals pathname "/foo" and the active state is missed.
+          const hrefPath = item.href.split("?")[0];
+          const active =
+            pathname === hrefPath || pathname.startsWith(`${hrefPath}/`);
+          return (
+            <li key={item.href}>
+              <Link
+                href={item.href}
+                className={cn(
+                  "flex h-8 items-center gap-2 rounded-md px-3 text-[13px] font-medium transition-colors duration-150",
+                  active
+                    ? "bg-[hsl(var(--sidebar-active-bg))] text-[hsl(var(--sidebar-active-fg))]"
+                    : "text-[hsl(var(--sidebar-text))] hover:bg-[hsl(var(--background))] hover:text-[hsl(var(--foreground))]",
+                )}
+              >
+                {item.icon ? (
+                  <span className="[&>svg]:h-4 [&>svg]:w-4">{item.icon}</span>
+                ) : null}
+                <span className="flex-1 truncate">{item.label}</span>
+                {item.endAdornment ? (
+                  <span className="ml-auto text-[11px]">
+                    {item.endAdornment}
+                  </span>
+                ) : null}
+              </Link>
+            </li>
+          );
+        })}
+      </ul>
+    </nav>
+  );
+}
+
+interface DetailSidebarBackProps {
+  href: string;
+  label?: React.ReactNode;
+}
+
+export function DetailSidebarBack({
+  href,
+  label = "返回列表",
+}: DetailSidebarBackProps) {
+  return (
+    <div className="border-t border-[hsl(var(--border-light))] p-3">
+      <Link
+        href={href}
+        className="flex h-8 items-center justify-center gap-1.5 rounded-md text-[13px] font-medium text-[hsl(var(--muted-foreground))] transition-colors hover:bg-[hsl(var(--background))] hover:text-[hsl(var(--primary))]"
+      >
+        <ArrowLeft className="h-3.5 w-3.5" />
+        {label}
+      </Link>
+    </div>
+  );
+}
+
+/**
+ * Master-detail shell. Uses the "fixed shell, internal scroll" pattern that
+ * Slack / Linear / Notion use for chrome-heavy apps: the layout pins to
+ * the viewport with `position: fixed` so it stays exactly one viewport
+ * tall regardless of `<main>`'s padding or any sibling page content. The
+ * sidebar fills the full available height as a static column; only the
+ * right content area scrolls.
+ *
+ * The fixed positioning sidesteps the body-scroll / negative-margin math
+ * that an in-flow shell would have to do — `<main>` keeps its standard
+ * `min-h-screen + px-7 py-5`, body never overflows past the viewport, and
+ * the back button stays anchored to the bottom of the viewport even when
+ * the right pane's content is shorter than one screen.
+ *
+ * Left offset mirrors the primary sidebar's collapsed state via
+ * `useSidebarCollapsed`, keeping the master-detail row in lockstep with
+ * the rest of the application chrome.
+ */
+/**
+ * Generic full-viewport application shell. Pins to the viewport with
+ * `position: fixed`, accounts for the primary sidebar's collapse state,
+ * and reserves the mobile primary-nav bar's 56px above. Used as the
+ * foundation for any page that wants a chrome-heavy "app surface" feel
+ * — the master-detail layout, the chat homepage, etc.
+ */
+export function AppShellLayout({
+  children,
+  className,
+}: {
+  children: React.ReactNode;
+  className?: string;
+}) {
+  const { collapsed } = useSidebarCollapsed();
+  return (
+    <div
+      className={cn(
+        "fixed inset-0 z-30 flex items-stretch overflow-hidden bg-[hsl(var(--background))] transition-[left] duration-200 ease-out",
+        "max-md:top-14",
+        collapsed ? "md:left-16" : "md:left-[220px]",
+        className,
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+export function DetailLayout({
+  sidebar,
+  children,
+}: {
+  sidebar: React.ReactNode;
+  children: React.ReactNode;
+}) {
+  return (
+    <AppShellLayout>
+      {sidebar}
+      <div className="min-w-0 flex-1 overflow-y-auto px-7 py-5 max-md:px-4">
+        {children}
+      </div>
+    </AppShellLayout>
+  );
+}
+
+/**
+ * Cancels the surrounding right-pane padding so a child component can
+ * span the full height/width of the detail layout. Used by workbench-
+ * style pages (split form + workspace) that own their internal padding
+ * and scroll regions and don't want to inherit the page-level inset.
+ *
+ * The negative `-mx-7 -my-5` matches the right pane's `px-7 py-5`
+ * padding so the cancellation is exact; mobile uses px-4 / no extra
+ * vertical padding so we only cancel the horizontal axis there.
+ *
+ * `h-full` plus `overflow-hidden` forces the child to be exactly one
+ * pane tall — no body-scroll fall-back — so workbench panes can lay
+ * out flex columns with internal scroll without overflowing the shell.
+ */
+export function DetailFullBleed({
+  className,
+  children,
+}: {
+  className?: string;
+  children: React.ReactNode;
+}) {
+  return (
+    <div
+      className={cn(
+        "-mx-7 -my-5 flex h-[calc(100%+2.5rem)] overflow-hidden max-md:-mx-4 max-md:my-0 max-md:h-full",
+        className,
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+interface WorkbenchLayoutProps {
+  /** Left configuration column (form / parameters). Scrolls internally. */
+  aside: React.ReactNode;
+  /** Right work surface (chat / results). Owns its own scroll. */
+  children: React.ReactNode;
+  /** Width of the aside on desktop. Defaults to 360px. */
+  asideWidth?: number;
+}
+
+/**
+ * Two-pane workbench shell for detail-page subroutes that want a fixed
+ * configuration column on the left and a full-height work surface on the
+ * right (QA test, retrieval test, memory search). On viewports below the
+ * `lg` breakpoint the configuration stacks above the workspace instead
+ * of sitting beside it.
+ *
+ * Wraps with `DetailFullBleed` so the panes go edge-to-edge — pages don't
+ * need to think about the surrounding right-pane padding.
+ */
+export function WorkbenchLayout({
+  aside,
+  children,
+  asideWidth = 360,
+}: WorkbenchLayoutProps) {
+  return (
+    <DetailFullBleed className="flex-col lg:flex-row">
+      <aside
+        style={{ ["--workbench-aside-w" as string]: `${asideWidth}px` }}
+        className={cn(
+          "shrink-0 overflow-y-auto border-b border-[hsl(var(--border))] bg-[hsl(var(--card))] px-6 py-5 max-md:px-4",
+          "lg:w-[var(--workbench-aside-w)] lg:border-b-0 lg:border-r",
+        )}
+      >
+        {aside}
+      </aside>
+      <main className="flex min-h-0 min-w-0 flex-1 flex-col">
+        {children}
+      </main>
+    </DetailFullBleed>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/layout/help-link.tsx

@@ -0,0 +1,58 @@
+"use client";
+
+import { usePathname } from "next/navigation";
+import { HelpCircle } from "lucide-react";
+
+import { cn } from "@/lib/utils";
+
+const HELP_URL_KB = "https://help.aliyun.com/zh/tablestore/knowledge-base-rag/";
+const HELP_URL_DEFAULT = "https://help.aliyun.com/zh/tablestore/";
+
+function resolveHelpUrl(pathname: string | null): string {
+  if (pathname?.startsWith("/knowledge-base")) return HELP_URL_KB;
+  return HELP_URL_DEFAULT;
+}
+
+interface HelpLinkProps {
+  collapsed?: boolean;
+}
+
+/**
+ * Pathname-aware help link, surfaced in the sidebar footer. Knowledge-base
+ * pages get the RAG help URL; other surfaces fall back to the general portal,
+ * preserving the routing previously hosted in the deprecated breadcrumb bar.
+ */
+export function HelpLink({ collapsed }: HelpLinkProps) {
+  const pathname = usePathname();
+  const url = resolveHelpUrl(pathname);
+
+  if (collapsed) {
+    return (
+      <a
+        href={url}
+        target="_blank"
+        rel="noreferrer"
+        title="帮助"
+        aria-label="帮助"
+        className="flex h-8 w-8 items-center justify-center rounded-md text-[hsl(var(--muted-foreground))] transition-colors hover:bg-[hsl(var(--background))] hover:text-[hsl(var(--foreground))]"
+      >
+        <HelpCircle className="h-4 w-4" />
+      </a>
+    );
+  }
+
+  return (
+    <a
+      href={url}
+      target="_blank"
+      rel="noreferrer"
+      title="帮助"
+      className={cn(
+        "flex h-8 items-center gap-2 rounded-md px-3 text-sm text-[hsl(var(--muted-foreground))] transition-colors hover:bg-[hsl(var(--background))] hover:text-[hsl(var(--foreground))]",
+      )}
+    >
+      <HelpCircle className="h-4 w-4 shrink-0" />
+      <span>帮助</span>
+    </a>
+  );
+}