@tablestore/tablestore-agent-cli 0.2.1 → 0.2.4

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

@@ -1,27 +1,45 @@
 'use client';
 
-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 { Label } from "@/components/ui/label";
 import { Textarea } from "@/components/ui/textarea";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/components/ui/form";
 import { useUpdateMemoryStore } from "@/hooks/use-update-memory-store";
 import type { MemoryStore } from "@/types/memory";
 
+const updateMemoryStoreSchema = z.object({
+  description: z.string().trim().max(256, "描述不超过 256 字").optional(),
+});
+
+type UpdateMemoryStoreInput = z.infer<typeof updateMemoryStoreSchema>;
+
 interface MemorySettingsFormProps {
   memoryStore: MemoryStore;
 }
 
 export function MemorySettingsForm({ memoryStore }: MemorySettingsFormProps) {
   const updateStore = useUpdateMemoryStore();
-  const [description, setDescription] = useState(memoryStore.description ?? "");
 
-  async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
-    event.preventDefault();
+  const form = useForm<UpdateMemoryStoreInput>({
+    resolver: zodResolver(updateMemoryStoreSchema),
+    defaultValues: { description: memoryStore.description ?? "" },
+  });
+
+  async function onSubmit(values: UpdateMemoryStoreInput) {
     try {
       await updateStore.mutateAsync({
         memoryStoreName: memoryStore.memoryStoreName,
-        description: description.trim() || undefined,
+        description: values.description?.length ? values.description : undefined,
       });
       toast.success("记忆库设置已更新");
     } catch (error) {
@@ -30,20 +48,71 @@ export function MemorySettingsForm({ memoryStore }: MemorySettingsFormProps) {
   }
 
   return (
-    <form onSubmit={handleSubmit} className="space-y-4">
-      <div className="space-y-2">
-        <Label htmlFor="memory-settings-description">描述</Label>
-        <Textarea
-          id="memory-settings-description"
-          value={description}
-          onChange={(event) => setDescription(event.target.value)}
-          rows={5}
-          placeholder="描述这个记忆库的用途..."
-        />
-      </div>
-      <Button type="submit" disabled={updateStore.isPending}>
-        {updateStore.isPending ? "保存中..." : "保存设置"}
-      </Button>
-    </form>
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-6">
+        <section className="rounded-lg border border-[hsl(var(--border))] bg-[hsl(var(--card))] p-5 shadow-sm">
+          <SettingsSectionHeader
+            title="基本信息"
+            description="调整记忆库的描述，帮助团队识别用途。名称在创建后不可修改。"
+          />
+          <div className="space-y-4">
+            <ReadOnlyField label="名称" value={memoryStore.memoryStoreName} />
+
+            <FormField
+              control={form.control}
+              name="description"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>描述</FormLabel>
+                  <FormControl>
+                    <Textarea
+                      placeholder="描述这个记忆库的用途..."
+                      className="resize-none"
+                      rows={4}
+                      {...field}
+                    />
+                  </FormControl>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+
+            <div className="flex justify-end border-t border-[hsl(var(--border-light))] pt-4">
+              <Button type="submit" disabled={updateStore.isPending}>
+                {updateStore.isPending ? "保存中..." : "保存更改"}
+              </Button>
+            </div>
+          </div>
+        </section>
+      </form>
+    </Form>
+  );
+}
+
+function SettingsSectionHeader({
+  title,
+  description,
+}: {
+  title: string;
+  description: string;
+}) {
+  return (
+    <header className="mb-4 border-b border-[hsl(var(--border-light))] pb-3">
+      <h3 className="text-[15px] font-semibold leading-tight text-[hsl(var(--foreground))]">
+        {title}
+      </h3>
+      <p className="mt-1 text-xs leading-relaxed text-[hsl(var(--muted-foreground))]">
+        {description}
+      </p>
+    </header>
+  );
+}
+
+function ReadOnlyField({ label, value }: { label: string; value: string }) {
+  return (
+    <div className="flex items-center justify-between">
+      <span className="text-sm text-muted-foreground">{label}</span>
+      <span className="text-sm font-medium">{value}</span>
+    </div>
   );
 }

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-store-card.tsx

@@ -85,7 +85,7 @@ function MemoryStoreCardImpl({ memoryStore, onDelete }: MemoryStoreCardProps) {
 
           <div className="mt-auto flex items-center gap-2 pt-5">
             <Badge variant="secondary" className="border-0 bg-[hsl(var(--primary-50))] text-primary">
-              Agent Memory
+              智能体记忆
             </Badge>
           </div>
         </CardContent>

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-store-list.tsx

@@ -53,7 +53,7 @@ export function MemoryStoreList() {
       <EmptyState
         icon={Brain}
         title="还没有记忆库"
-        description="创建第一个记忆库，开始管理 Agent 的长期记忆"
+        description="创建第一个记忆库，开始管理智能体的长期记忆"
         action={
           <Button asChild>
             <Link href="/memory/create">

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-unit-detail-panel.tsx

@@ -87,18 +87,18 @@ export function MemoryUnitDetailPanel({
               </p>
             </DetailRow>
             {detailUnit.search_text && (
-              <DetailRow label="Search Text">
+              <DetailRow label="检索文本">
                 <p className="whitespace-pre-wrap rounded-md bg-muted p-3 text-sm">
                   {detailUnit.search_text}
                 </p>
               </DetailRow>
             )}
-            <DetailRow label="Scope">{formatScope(detailUnit.scope)}</DetailRow>
+            <DetailRow label="范围">{formatScope(detailUnit.scope)}</DetailRow>
             <DetailRow label="类型">{detailUnit.unit_type ?? "-"}</DetailRow>
-            <DetailRow label="Salience">{detailUnit.salience ?? "-"}</DetailRow>
+            <DetailRow label="重要度">{detailUnit.salience ?? "-"}</DetailRow>
             <DetailRow label="版本">{detailUnit.version ?? "-"}</DetailRow>
             {detailUnit.metadata && (
-              <DetailRow label="Metadata">
+              <DetailRow label="元数据">
                 <pre className="overflow-auto rounded-md bg-muted p-3 text-xs">
                   {JSON.stringify(detailUnit.metadata, null, 2)}
                 </pre>

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

@@ -22,7 +22,7 @@ interface MemoryUnitTableProps {
   onDelete?: (unit: MemoryUnit) => void;
 }
 
-const DISABLED_TITLE = "当前记忆单元缺少精确 scope 或 ID，无法操作";
+const DISABLED_TITLE = "当前记忆单元缺少精确范围或 ID，无法操作";
 
 function unitId(unit: MemoryUnit): string {
   return unit.id ?? unit.memoryId ?? "-";
@@ -135,7 +135,7 @@ export function MemoryUnitTable({
   if (!units.length) {
     return (
       <div className="rounded-lg border border-dashed py-12 text-center text-sm text-muted-foreground">
-        当前 scope 下暂无记忆单元
+        当前范围下暂无记忆单元
       </div>
     );
   }

package/dist/dashboard-runtime/dashboard/src/components/qa/qa-message.tsx

@@ -24,16 +24,41 @@ import {
   CollapsibleTrigger,
 } from "@/components/ui/collapsible";
 import { Textarea } from "@/components/ui/textarea";
+import {
+  Dialog,
+  DialogContent,
+  DialogTitle,
+} from "@/components/ui/dialog";
 import { ConfirmDialog } from "@/components/shared/confirm-dialog";
 import { cn } from "@/lib/utils";
+import { IMAGE_FALLBACK_DATA_PREFIX } from "@/lib/constants";
 import type {
   ChatMessage,
   RetrievalGroup,
   RetrievedChunk,
 } from "@/types/llm-chat";
+import type { MemorySearchHit } from "@/types/memory";
 
 import { Markdown } from "./markdown";
 
+/** Fallback for clipboard copy when navigator.clipboard is unavailable (e.g.
+ *  non-HTTPS contexts). Uses the deprecated execCommand approach. */
+function fallbackCopy(text: string) {
+  try {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    document.execCommand("copy");
+    document.body.removeChild(textarea);
+    toast.success("已复制");
+  } catch {
+    toast.error("复制失败");
+  }
+}
+
 interface QaMessageProps {
   message: ChatMessage;
   /** Whether ANY turn in the session is currently streaming. All action
@@ -296,8 +321,21 @@ function UserBubble({
   const [withNextAssistant, setWithNextAssistant] = useState(true);
 
   const handleCopy = useCallback(() => {
-    void navigator.clipboard.writeText(message.content);
-    toast.success("已复制");
+    if (!message.content) return;
+    try {
+      if (navigator.clipboard && window.isSecureContext) {
+        void navigator.clipboard.writeText(message.content).then(
+          () => toast.success("已复制"),
+          () => {
+            fallbackCopy(message.content);
+          },
+        );
+      } else {
+        fallbackCopy(message.content);
+      }
+    } catch {
+      fallbackCopy(message.content);
+    }
   }, [message.content]);
 
   const handleSaveEdit = useCallback(() => {
@@ -469,8 +507,21 @@ function AssistantBlock({
     .map((g) => ({ name: g.knowledgeBaseName, reason: g.error ?? "" }));
 
   const handleCopy = useCallback(() => {
-    void navigator.clipboard.writeText(message.content);
-    toast.success("已复制");
+    if (!message.content) return;
+    try {
+      if (navigator.clipboard && window.isSecureContext) {
+        void navigator.clipboard.writeText(message.content).then(
+          () => toast.success("已复制"),
+          () => {
+            fallbackCopy(message.content);
+          },
+        );
+      } else {
+        fallbackCopy(message.content);
+      }
+    } catch {
+      fallbackCopy(message.content);
+    }
   }, [message.content]);
 
   return (
@@ -517,6 +568,17 @@ function AssistantBlock({
         />
       ) : null}
 
+      {/* Retrieved memory hits. Shown right under the KB chunks so both
+          evidence sources sit in the same vertical stack. The differentiator
+          is the trigger pill (Brain icon + "参考" verb), since memory hits
+          are soft prior context rather than bracketed citations. */}
+      {message.memoryHits && message.memoryHits.length > 0 ? (
+        <MemoryHitsBlock
+          hits={message.memoryHits}
+          query={message.memoryQuery}
+        />
+      ) : null}
+
       {/* Main content. */}
       {hasError ? (
         <div className="flex items-start gap-2 rounded-md border border-[hsl(var(--destructive))/0.3] bg-[hsl(var(--destructive))/0.05] px-3 py-2 text-[hsl(var(--destructive))]">
@@ -863,8 +925,17 @@ function GroupedChunkList({
 }
 
 function ChunkCard({ chunk, index }: { chunk: RetrievedChunk; index: number }) {
+  const [zoomedImage, setZoomedImage] = useState<string | null>(null);
   const fileName =
     chunk.ossKey?.split("/").pop() || chunk.ossKey || "未知文件";
+
+  const isImageChunk = chunk.chunkType?.toLowerCase() === "image";
+  const imageSrc = chunk.imageBase64
+    ? chunk.imageBase64.startsWith("data:")
+      ? chunk.imageBase64
+      : `${IMAGE_FALLBACK_DATA_PREFIX}${chunk.imageBase64}`
+    : undefined;
+
   return (
     <div className="rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
       <div className="mb-1.5 flex items-center gap-2 text-xs text-muted-foreground">
@@ -873,10 +944,150 @@ function ChunkCard({ chunk, index }: { chunk: RetrievedChunk; index: number }) {
         </span>
         <span className="font-medium text-foreground/80">{fileName}</span>
         <span>Chunk #{chunk.chunkId}</span>
+        {isImageChunk && (
+          <span className="rounded bg-primary/10 px-1 py-0.5 text-[10px] font-medium text-primary">
+            IMAGE
+          </span>
+        )}
         <span className="ml-auto font-mono">{chunk.score.toFixed(4)}</span>
       </div>
+
+      {/* 图片缩略图 */}
+      {isImageChunk && imageSrc && (
+        <img
+          src={imageSrc}
+          alt={`Image chunk #${chunk.chunkId}`}
+          className="mt-2 max-w-[180px] max-h-[180px] object-contain rounded border border-border cursor-pointer hover:opacity-80 transition-opacity"
+          onClick={() => setZoomedImage(imageSrc)}
+        />
+      )}
+
+      {/* 文本内容 */}
+      {chunk.content && (
+        <p
+          className={cn(
+            "line-clamp-4 whitespace-pre-wrap text-xs text-foreground/80",
+            isImageChunk && "mt-2",
+          )}
+        >
+          {chunk.content}
+        </p>
+      )}
+
+      {/* 图片放大预览 */}
+      <Dialog open={!!zoomedImage} onOpenChange={() => setZoomedImage(null)}>
+        <DialogContent className="max-w-[90vw] max-h-[90vh] p-2 flex items-center justify-center border-none bg-black/90 data-[state=open]:animate-none data-[state=closed]:animate-none duration-0">
+          <DialogTitle className="sr-only">图片放大预览</DialogTitle>
+          {zoomedImage && (
+            <img
+              src={zoomedImage}
+              alt="放大预览"
+              className="max-w-full max-h-[85vh] object-contain"
+            />
+          )}
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}
+
+/**
+ * Memory evidence panel — sister component of {@link ChunksBlock}.
+ *
+ * Skeleton (Collapsible + numbered card grid + score-right-aligned header) is
+ * intentionally identical to ChunksBlock so users learn one "evidence card"
+ * mental model. The differentiation lives entirely in the trigger:
+ *   - icon: Brain (vs BookOpen)
+ *   - verb: "参考" (vs "查看") — memory hits are soft prior context injected
+ *     into the system prompt, not bracket-cited like KB chunks
+ *   - optional sub-label: the actual SearchMemories query the server used,
+ *     making it easy to debug "what did the server actually search for"
+ *     when hits seem off.
+ */
+export function MemoryHitsBlock({
+  hits,
+  query,
+}: {
+  hits: MemorySearchHit[];
+  query?: string;
+}) {
+  const [open, setOpen] = useState(false);
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <CollapsibleTrigger asChild>
+        <button
+          type="button"
+          className="inline-flex items-center gap-1.5 rounded-md px-2 py-1 text-xs text-muted-foreground transition-colors hover:bg-[hsl(var(--accent))] hover:text-foreground"
+        >
+          <Brain className="h-3.5 w-3.5" />
+          参考 {hits.length} 条记忆
+          {query ? (
+            <span className="max-w-[200px] truncate text-muted-foreground/70">
+              · {query}
+            </span>
+          ) : null}
+          <ChevronDown
+            className={cn(
+              "h-3 w-3 transition-transform duration-200",
+              open && "rotate-180",
+            )}
+          />
+        </button>
+      </CollapsibleTrigger>
+      <CollapsibleContent>
+        <div className="mt-2 space-y-2">
+          {hits.map((hit, idx) => (
+            <MemoryHitCard
+              key={
+                hit.unit.memcell_id ??
+                `${idx}-${(hit.unit.text ?? "").slice(0, 16)}`
+              }
+              hit={hit}
+              index={idx + 1}
+            />
+          ))}
+        </div>
+      </CollapsibleContent>
+    </Collapsible>
+  );
+}
+
+function MemoryHitCard({
+  hit,
+  index,
+}: {
+  hit: MemorySearchHit;
+  index: number;
+}) {
+  const id = hit.unit.memcell_id;
+  const score = typeof hit.score === "number" ? hit.score : undefined;
+  return (
+    <div className="rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
+      <div className="mb-1.5 flex items-center gap-2 text-xs text-muted-foreground">
+        <span className="inline-flex h-5 w-5 items-center justify-center rounded-full bg-[hsl(var(--primary-50))] font-semibold text-primary">
+          {index}
+        </span>
+        {id ? (
+          <span
+            className="min-w-0 truncate font-mono text-foreground/80"
+            title={id}
+          >
+            {id}
+          </span>
+        ) : (
+          <span className="text-muted-foreground/70">未命名记忆</span>
+        )}
+        {hit.source ? (
+          <span className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 text-[10px] uppercase tracking-wide text-muted-foreground">
+            {hit.source}
+          </span>
+        ) : null}
+        <span className="ml-auto shrink-0 font-mono">
+          {score !== undefined ? score.toFixed(4) : "—"}
+        </span>
+      </div>
       <p className="line-clamp-4 whitespace-pre-wrap text-xs text-foreground/80">
-        {chunk.content}
+        {hit.unit.text}
       </p>
     </div>
   );