@tablestore/tablestore-agent-cli 0.2.1 → 0.2.4

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

@@ -111,6 +111,10 @@ interface DetailSidebarHeaderProps
   typeLabel?: React.ReactNode;
   description?: React.ReactNode;
   actions?: React.ReactNode;
+  /** Status pills (multimodal / subspace / etc.) rendered as their own
+   *  row directly below the icon — kept separate from `name` so they
+   *  get their own line and don't crowd the title row. */
+  pills?: React.ReactNode;
   /** Tags / chips / dates / extra info. Wrapped in a flex container with
    *  small text already applied. */
   extra?: React.ReactNode;
@@ -123,21 +127,53 @@ export function DetailSidebarHeader({
   typeLabel,
   description,
   actions,
+  pills,
   extra,
 }: DetailSidebarHeaderProps) {
   const { toggle } = useDetailSidebarCollapsed();
   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>
+      {/*
+        Identity row: accent icon on the left, the name + optional type
+        label in the middle (truncates with ellipsis when too long), and
+        consumer actions plus the built-in "collapse sidebar" button on
+        the right. Status pills sit on their own row underneath so they
+        can wrap freely without squeezing the title.
+      */}
+      <div className="flex items-center gap-3">
+        <div className={cn(detailIconAccent({ accent }), "shrink-0")}>
+          {icon}
+        </div>
+        <div className="min-w-0 flex-1 space-y-0.5">
+          {typeof name === "string" ? (
+            <TooltipProvider delayDuration={200}>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <div className="truncate text-sm font-semibold leading-tight text-[hsl(var(--foreground))]">
+                    {name}
+                  </div>
+                </TooltipTrigger>
+                <TooltipContent side="bottom" sideOffset={4}>
+                  {name}
+                </TooltipContent>
+              </Tooltip>
+            </TooltipProvider>
+          ) : (
+            <div className="truncate text-sm font-semibold leading-tight text-[hsl(var(--foreground))]">
+              {name}
+            </div>
+          )}
+          {typeLabel ? (
+            <div className="truncate text-[11px] font-semibold uppercase tracking-wider text-[hsl(var(--muted-foreground))]">
+              {typeLabel}
+            </div>
+          ) : null}
+        </div>
         {/*
-          Right-side controls: any consumer-supplied actions (delete, etc.)
-          plus a built-in "collapse sidebar" button. The collapse button is
-          baked in so every detail page gets it for free; it sits to the
-          right of consumer actions so it always lands at the far edge —
-          the visual anchor users learn to reach for.
+          Right-side controls: consumer actions (delete, etc.) plus a
+          built-in "collapse sidebar" button anchored at the far edge.
         */}
-        <div className="-mt-1 -mr-1 flex items-center gap-0.5">
+        <div className="-mr-1 flex shrink-0 items-center gap-0.5">
           {actions}
           <TooltipProvider delayDuration={200}>
             <Tooltip>
@@ -158,16 +194,9 @@ export function DetailSidebarHeader({
           </TooltipProvider>
         </div>
       </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>
+      {pills ? (
+        <div className="flex flex-wrap gap-2">{pills}</div>
+      ) : null}
       {description ? (
         <p className="line-clamp-3 text-[13px] leading-snug text-[hsl(var(--muted-foreground))]">
           {description}

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

@@ -60,7 +60,7 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
           <DropdownMenuTrigger asChild>
             <button
               type="button"
-              aria-label={activeName ? `当前实例：${activeName}` : "选择项目"}
+              aria-label={activeName ? `当前项目：${activeName}` : "选择项目"}
               title={activeName ?? "选择项目"}
               disabled={isLoading}
               className={cn(
@@ -103,7 +103,7 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
           >
             <div className="flex flex-1 flex-col overflow-hidden">
               <span className="text-[11px] uppercase tracking-wider text-[hsl(var(--muted-foreground))]">
-                当前实例
+                当前项目
               </span>
               <span className="truncate text-sm font-semibold text-[hsl(var(--foreground))]">
                 {activeName ?? "未选择"}

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-add-dialog.tsx

@@ -67,7 +67,7 @@ export function MemoryAddDialog({
         </DialogHeader>
         <div className="space-y-4">
           <div className="space-y-2">
-            <Label>Text</Label>
+            <Label>记忆文本</Label>
             <Textarea
               value={text}
               onChange={(event) => setText(event.target.value)}
@@ -76,7 +76,7 @@ export function MemoryAddDialog({
             />
           </div>
           <div className="space-y-2">
-            <Label>Metadata JSON（可选）</Label>
+            <Label>元数据（JSON，可选）</Label>
             <Textarea
               value={metadataJson}
               onChange={(event) => setMetadataJson(event.target.value)}

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-create-form.tsx

@@ -1,40 +1,50 @@
 'use client';
 
 import { useRouter } from "next/navigation";
-import { useState } from "react";
+import { useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { z } from "zod";
 import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
-import { Label } from "@/components/ui/label";
 import { Textarea } from "@/components/ui/textarea";
+import {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/components/ui/form";
 import { useCreateMemoryStore } from "@/hooks/use-create-memory-store";
 
+const createMemoryStoreSchema = z.object({
+  memoryStoreName: z
+    .string()
+    .trim()
+    .min(1, "名称不能为空")
+    .max(32, "名称不能超过 32 个字符")
+    .regex(/^[a-zA-Z0-9_]+$/, "只能包含字母、数字和下划线"),
+  description: z.string().trim().max(256, "描述不超过 256 字").optional(),
+});
+
+type CreateMemoryStoreInput = z.infer<typeof createMemoryStoreSchema>;
+
 export function MemoryCreateForm() {
   const router = useRouter();
   const createStore = useCreateMemoryStore();
-  const [memoryStoreName, setMemoryStoreName] = useState("");
-  const [description, setDescription] = useState("");
 
-  async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
-    event.preventDefault();
-    const trimmedName = memoryStoreName.trim();
-    if (!trimmedName) {
-      toast.error("记忆库名称不能为空");
-      return;
-    }
-    if (trimmedName.length > 32) {
-      toast.error("记忆库名称不能超过 32 个字符");
-      return;
-    }
-    if (!/^[a-zA-Z0-9_]+$/.test(trimmedName)) {
-      toast.error("记忆库名称只能包含字母、数字和下划线");
-      return;
-    }
+  const form = useForm<CreateMemoryStoreInput>({
+    resolver: zodResolver(createMemoryStoreSchema),
+    defaultValues: { memoryStoreName: "", description: "" },
+  });
 
+  async function onSubmit(values: CreateMemoryStoreInput) {
     try {
       await createStore.mutateAsync({
-        memoryStoreName: trimmedName,
-        description: description.trim() || undefined,
+        memoryStoreName: values.memoryStoreName,
+        description: values.description?.length ? values.description : undefined,
       });
       toast.success("记忆库创建成功");
       router.push("/memory");
@@ -44,45 +54,63 @@ export function MemoryCreateForm() {
   }
 
   return (
-    <form onSubmit={handleSubmit} className="space-y-6">
-      <section className="space-y-4">
-        <h3 className="text-lg font-semibold">基本信息</h3>
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-8">
+        <section className="space-y-4">
+          <h3 className="text-lg font-semibold">基本信息</h3>
 
-        <div className="space-y-2">
-          <Label htmlFor="memory-store-name">
-            名称 <span className="text-[hsl(var(--destructive))]">*</span>
-          </Label>
-          <Input
-            id="memory-store-name"
-            value={memoryStoreName}
-            onChange={(event) => setMemoryStoreName(event.target.value)}
-            placeholder="my_memory_store"
+          <FormField
+            control={form.control}
+            name="memoryStoreName"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>
+                  名称 <span className="text-[hsl(var(--destructive))]">*</span>
+                </FormLabel>
+                <FormControl>
+                  <Input placeholder="my_memory_store" {...field} />
+                </FormControl>
+                <FormDescription>
+                  用于 memory CLI 的 --store 参数和控制台路由。仅支持字母、数字和下划线，最多 32 个字符。
+                </FormDescription>
+                <FormMessage />
+              </FormItem>
+            )}
           />
-          <p className="text-xs text-muted-foreground">
-            用于 memory CLI 的 --store 参数和控制台路由。仅支持字母、数字和下划线，最多 32 个字符。
-          </p>
-        </div>
 
-        <div className="space-y-2">
-          <Label htmlFor="memory-store-description">描述</Label>
-          <Textarea
-            id="memory-store-description"
-            value={description}
-            onChange={(event) => setDescription(event.target.value)}
-            placeholder="描述这个记忆库的用途..."
-            rows={4}
+          <FormField
+            control={form.control}
+            name="description"
+            render={({ field }) => (
+              <FormItem>
+                <FormLabel>描述</FormLabel>
+                <FormControl>
+                  <Textarea
+                    placeholder="描述这个记忆库的用途..."
+                    className="resize-none"
+                    rows={4}
+                    {...field}
+                  />
+                </FormControl>
+                <FormMessage />
+              </FormItem>
+            )}
           />
-        </div>
-      </section>
+        </section>
 
-      <div className="flex justify-end gap-3">
-        <Button type="button" variant="outline" onClick={() => router.push("/memory")}>
-          取消
-        </Button>
-        <Button type="submit" disabled={createStore.isPending}>
-          {createStore.isPending ? "创建中..." : "创建记忆库"}
-        </Button>
-      </div>
-    </form>
+        <div className="flex justify-end gap-3 border-t border-[hsl(var(--border-light))] pt-4">
+          <Button
+            type="button"
+            variant="outline"
+            onClick={() => router.push("/memory")}
+          >
+            取消
+          </Button>
+          <Button type="submit" disabled={createStore.isPending}>
+            {createStore.isPending ? "创建中..." : "创建记忆库"}
+          </Button>
+        </div>
+      </form>
+    </Form>
   );
 }

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-edit-dialog.tsx

@@ -70,11 +70,11 @@ export function MemoryEditDialog({
         </DialogHeader>
         <form key={unitKey} onSubmit={handleSubmit} className="space-y-4">
           <div className="space-y-2">
-            <Label>Text</Label>
+            <Label>记忆文本</Label>
             <Textarea name="text" defaultValue={unit?.text ?? ""} rows={5} />
           </div>
           <div className="space-y-2">
-            <Label>Metadata JSON</Label>
+            <Label>元数据（JSON）</Label>
             <Textarea
               name="metadata"
               defaultValue={unit?.metadata ? JSON.stringify(unit.metadata, null, 2) : ""}

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-messages-table.tsx

@@ -76,7 +76,7 @@ export function MemoryMessagesTable({ messages }: MemoryMessagesTableProps) {
   if (!messages.length) {
     return (
       <div className="rounded-lg border border-dashed py-12 text-center text-sm text-muted-foreground">
-        当前 scope 下暂无消息记录
+        当前范围下暂无消息记录
       </div>
     );
   }
@@ -88,9 +88,9 @@ export function MemoryMessagesTable({ messages }: MemoryMessagesTableProps) {
           <TableRow>
             <TableHead className="w-[180px]">时间</TableHead>
             <TableHead className="w-[120px]">角色</TableHead>
-            <TableHead className="w-[140px]">Speaker</TableHead>
+            <TableHead className="w-[140px]">说话人</TableHead>
             <TableHead>内容</TableHead>
-            <TableHead className="w-[260px]">Metadata</TableHead>
+            <TableHead className="w-[260px]">元数据</TableHead>
           </TableRow>
         </TableHeader>
         <TableBody>

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-requests-table.tsx

@@ -72,15 +72,15 @@ function RequestDetailDialog({ request, open, onOpenChange }: {
         </DialogHeader>
         <div className="grid gap-4 sm:grid-cols-2">
           <div className="space-y-1">
-            <p className="text-xs text-muted-foreground">Operation</p>
+            <p className="text-xs text-muted-foreground">操作</p>
             <p className="text-sm font-medium">{request.operation ?? "-"}</p>
           </div>
           <div className="space-y-1">
-            <p className="text-xs text-muted-foreground">Request ID</p>
+            <p className="text-xs text-muted-foreground">请求 ID</p>
             <p className="text-sm font-mono">{request.requestId ?? "-"}</p>
           </div>
           <div className="space-y-1">
-            <p className="text-xs text-muted-foreground">Target ID</p>
+            <p className="text-xs text-muted-foreground">目标 ID</p>
             <p className="text-sm font-medium">{request.targetId ?? "-"}</p>
           </div>
           <div className="space-y-1">
@@ -96,18 +96,18 @@ function RequestDetailDialog({ request, open, onOpenChange }: {
             <p className="text-sm font-medium">{formatTimestamp(request.createdAt)}</p>
           </div>
           <div className="space-y-1">
-            <p className="text-xs text-muted-foreground">Ingest 状态</p>
+            <p className="text-xs text-muted-foreground">入库状态</p>
             <p className="text-sm font-medium">{request.ingestStatus ?? "-"}</p>
           </div>
           <div className="space-y-1 sm:col-span-2">
-            <p className="text-xs text-muted-foreground">Scope</p>
+            <p className="text-xs text-muted-foreground">范围</p>
             <p className="text-sm font-medium">{scopeLabel(request.scope)}</p>
             {request.scope && (
               <div className="mt-2 grid grid-cols-2 gap-x-4 gap-y-1 text-xs text-muted-foreground">
-                <span>App ID:</span><span className="font-mono">{request.scope.appId ?? "-"}</span>
-                <span>Tenant ID:</span><span className="font-mono">{request.scope.tenantId ?? "-"}</span>
-                <span>Agent ID:</span><span className="font-mono">{request.scope.agentId ?? "-"}</span>
-                <span>Run ID:</span><span className="font-mono">{request.scope.runId ?? "-"}</span>
+                <span>应用：</span><span className="font-mono">{request.scope.appId ?? "-"}</span>
+                <span>租户：</span><span className="font-mono">{request.scope.tenantId ?? "-"}</span>
+                <span>智能体：</span><span className="font-mono">{request.scope.agentId ?? "-"}</span>
+                <span>会话：</span><span className="font-mono">{request.scope.runId ?? "-"}</span>
               </div>
             )}
           </div>
@@ -173,7 +173,7 @@ export function MemoryRequestsTable({ requests }: MemoryRequestsTableProps) {
   if (!requests.length) {
     return (
       <div className="rounded-lg border border-dashed py-12 text-center text-sm text-muted-foreground">
-        当前 scope 下暂无请求审计记录
+        当前范围下暂无请求审计记录
       </div>
     );
   }
@@ -185,8 +185,8 @@ export function MemoryRequestsTable({ requests }: MemoryRequestsTableProps) {
           <TableHeader>
             <TableRow>
               <TableHead className="w-[160px]">时间</TableHead>
-              <TableHead className="w-[120px]">Operation</TableHead>
-              <TableHead className="w-[160px]">Request ID</TableHead>
+              <TableHead className="w-[120px]">操作</TableHead>
+              <TableHead className="w-[160px]">请求 ID</TableHead>
               <TableHead className="w-[80px]">响应码</TableHead>
               <TableHead className="w-[80px]">耗时</TableHead>
               <TableHead className="w-[80px]">操作</TableHead>

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-scope-bar.tsx

@@ -19,10 +19,10 @@ import { describeMemoryStore, listMemoryUnits } from "@/services/memory";
 import type { MemoryScope } from "@/types/memory";
 
 const FIELDS: Array<{ key: keyof MemoryScope; label: string; placeholder: string }> = [
-  { key: "appId", label: "App", placeholder: "app-001" },
-  { key: "tenantId", label: "Tenant", placeholder: "tenant-001" },
-  { key: "agentId", label: "Agent", placeholder: "agent-001" },
-  { key: "runId", label: "Run", placeholder: "run-001" },
+  { key: "appId", label: "应用", placeholder: "app-001" },
+  { key: "tenantId", label: "租户", placeholder: "tenant-001" },
+  { key: "agentId", label: "智能体", placeholder: "agent-001" },
+  { key: "runId", label: "会话", placeholder: "run-001" },
 ];
 
 function isWildcardScope(scope: MemoryScope): boolean {
@@ -47,7 +47,11 @@ export function MemoryScopeBar() {
   const router = useRouter();
   const pathname = usePathname();
   const searchParams = useSearchParams();
-  const currentScope = useMemo(() => buildMemoryScope(searchParams), [searchParams.toString()]);
+  const searchParamsString = searchParams.toString();
+  const currentScope = useMemo(
+    () => buildMemoryScope(new URLSearchParams(searchParamsString)),
+    [searchParamsString],
+  );
   const [expanded, setExpanded] = useState(false);
   const [draft, setDraft] = useState<MemoryScope>(currentScope);
   const [error, setError] = useState<string | null>(null);
@@ -90,15 +94,20 @@ export function MemoryScopeBar() {
   // Default to wildcard on memory detail pages
   useEffect(() => {
     if (!storeName || pathname.includes("/create")) return;
-    
-    const appId = searchParams.get("appId");
+
+    // 基于 searchParamsString 重建以避免 closure 捕获 searchParams 引用。
+    const sp = new URLSearchParams(searchParamsString);
+    const appId = sp.get("appId");
     if (!appId) {
       const params = new URLSearchParams({ appId: "*", tenantId: "*", agentId: "*", runId: "*" });
       router.replace(`${pathname}?${params.toString()}`);
     }
-  }, [searchParams.toString(), pathname, router, storeName]);
+  }, [searchParamsString, pathname, router, storeName]);
 
-  // Sync draft when URL changes
+  // Sync draft when URL changes.
+  // currentScope 来自 useMemo，仅当 searchParamsString 变化才会更新引用。
+  // setDraft 内部已经对 4 个字段做了相等性比较再返回 prev 以避免无效重渲染；
+  // setError(null) 在 error 已是 null 时也会被 React 自动跳过。
   useEffect(() => {
     setDraft(prev => {
       // Only update if values actually changed
@@ -113,7 +122,7 @@ export function MemoryScopeBar() {
       return currentScope;
     });
     setError(null);
-  }, [currentScope.appId, currentScope.tenantId, currentScope.agentId, currentScope.runId]);
+  }, [currentScope]);
 
   const presetLabel = firstUnitScope
     ? `${firstUnitScope.appId ?? "-"}/${firstUnitScope.tenantId ?? "-"}/${firstUnitScope.agentId ?? "-"}/${firstUnitScope.runId ?? "-"}`
@@ -127,7 +136,7 @@ export function MemoryScopeBar() {
       runId: (draft.runId ?? "").trim() || undefined,
     };
     if (!trimmed.appId || trimmed.appId === "appId") {
-      setError("App 是必填项");
+      setError("应用 是必填项");
       return;
     }
     setError(null);

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-search-form.tsx

@@ -36,15 +36,15 @@ export function MemorySearchForm({ scope, isLoading, onSubmit }: MemorySearchFor
     event.preventDefault();
     setError(null);
     if (!searchable) {
-      setError("请先在 Scope 栏中设置 appId 和 tenantId 的具体值");
+      setError("请先在范围栏中设置「应用」和「租户」的具体值");
       return;
     }
     if (!query.trim()) {
-      setError("请输入搜索 query");
+      setError("请输入检索内容");
       return;
     }
     if (topK < 0 || topK > 50) {
-      setError("topK 必须在 0 到 50 之间");
+      setError("Top K 必须在 0 到 50 之间");
       return;
     }
 
@@ -71,7 +71,7 @@ export function MemorySearchForm({ scope, isLoading, onSubmit }: MemorySearchFor
       </div>
 
       <div className="space-y-2">
-        <Label>Query</Label>
+        <Label>检索内容</Label>
         <Textarea
           value={query}
           onChange={(event) => setQuery(event.target.value)}
@@ -95,13 +95,13 @@ export function MemorySearchForm({ scope, isLoading, onSubmit }: MemorySearchFor
         <div className="flex items-end pb-1">
           <label className="flex items-center gap-2 text-sm">
             <Checkbox checked={enableRerank} onCheckedChange={(checked) => setEnableRerank(checked === true)} />
-            启用 Rerank
+            启用重排序
           </label>
         </div>
       </div>
 
       <div className="space-y-2">
-        <Label>Metadata Filter JSON</Label>
+        <Label>元数据过滤（JSON）</Label>
         <Textarea
           value={metadataJson}
           onChange={(event) => setMetadataJson(event.target.value)}
@@ -116,7 +116,7 @@ export function MemorySearchForm({ scope, isLoading, onSubmit }: MemorySearchFor
         {isLoading ? "搜索中..." : "搜索"}
       </Button>
       {!searchable && (
-        <p className="text-xs text-muted-foreground">请先在 Scope 栏中设置 appId 和 tenantId 的具体值。</p>
+        <p className="text-xs text-muted-foreground">请先在范围栏中设置「应用」和「租户」的具体值。</p>
       )}
     </form>
   );

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-search-results.tsx

@@ -35,7 +35,7 @@ export function MemorySearchResults({ results, elapsedMs }: MemorySearchResultsP
       <EmptyState
         icon={Brain}
         title="尚未搜索"
-        description="填写左侧查询条件后，可以验证当前 scope 下的记忆检索效果"
+        description="填写左侧查询条件后，可以验证当前范围下的记忆检索效果"
       />
     );
   }
@@ -65,17 +65,17 @@ export function MemorySearchResults({ results, elapsedMs }: MemorySearchResultsP
             <CardContent className="space-y-3 p-4">
               <div className="flex flex-wrap items-center gap-2">
                 {hit.score !== undefined && (
-                  <Badge variant="secondary">score {hit.score.toFixed(4)}</Badge>
+                  <Badge variant="secondary">相似度 {hit.score.toFixed(4)}</Badge>
                 )}
                 {hit.source && <Badge variant="outline">{hit.source}</Badge>}
                 {hit.unit.unit_type && <Badge variant="outline">{hit.unit.unit_type}</Badge>}
               </div>
               <p className="whitespace-pre-wrap text-sm">{hit.unit.text}</p>
               <div className="grid gap-2 text-xs text-muted-foreground sm:grid-cols-2">
-                <span>ID: {hit.unit.id ?? hit.unit.memoryId ?? "-"}</span>
-                <span>Scope: {formatScope(hit.unit.scope)}</span>
-                <span>Created: {formatTimestamp(hit.unit.created_at)}</span>
-                <span>Version: {hit.unit.version ?? "-"}</span>
+                <span>ID：{hit.unit.id ?? hit.unit.memoryId ?? "-"}</span>
+                <span>范围：{formatScope(hit.unit.scope)}</span>
+                <span>创建时间：{formatTimestamp(hit.unit.created_at)}</span>
+                <span>版本：{hit.unit.version ?? "-"}</span>
               </div>
             </CardContent>
           </Card>