@tablestore/tablestore-agent-cli 0.2.9 → 0.2.11

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/units/page.tsx

@@ -1,7 +1,7 @@
 "use client";
 
-import { useMemo, useState } from "react";
-import { useParams, useSearchParams } from "next/navigation";
+import { useEffect, useMemo, useState } from "react";
+import { useParams, useRouter, useSearchParams } from "next/navigation";
 import {
   ChevronLeft,
   ChevronRight,
@@ -27,9 +27,16 @@ import { useMemoryUnits } from "@/hooks/use-memory-units";
 import { useDeleteMemoryUnit } from "@/hooks/use-delete-memory-unit";
 import { useMemoryStore } from "@/hooks/use-memory-store";
 import { buildMemoryScope, hasWildcardScope } from "@/lib/memory";
-import { isFileMemory } from "@/lib/memory-storage-mode";
+import { storageModeCapabilities } from "@/lib/memory-storage-mode";
+import {
+  applyFileScopeToSearchParams,
+  normalizeExactFileMemoryScope,
+  readRecentFileScopes,
+  rememberRecentFileScope,
+} from "@/lib/file-scope-history";
 import { cn } from "@/lib/utils";
 import type { MemoryUnit } from "@/types/memory";
+import type { FileMemoryScope } from "@/types/file-memory";
 import { MemoryAddDialog } from "@/components/memory/memory-add-dialog";
 import { MemoryEditDialog } from "@/components/memory/memory-edit-dialog";
 import { MemoryUnitDetailPanel } from "@/components/memory/memory-unit-detail-panel";
@@ -38,13 +45,17 @@ import {
   MemoryUnitTable,
 } from "@/components/memory/memory-unit-table";
 import { MemoryFilesBrowser } from "@/components/memory/memory-files-browser";
+import { FileScopeOnboarding } from "@/components/memory/file-scope-onboarding";
 import { apiGet } from "@/services/api-client";
 import { useI18n } from "@/i18n/i18n-context";
+import { useDataScopeKey } from "@/providers/runtime-context-provider";
 
 export default function MemoryUnitsPage() {
   const { t } = useI18n();
   const params = useParams<{ store: string }>();
+  const router = useRouter();
   const searchParams = useSearchParams();
+  const dataScopeKey = useDataScopeKey();
   const memoryStoreName = decodeURIComponent(params.store);
   const searchParamsString = searchParams.toString();
   const scope = useMemo(
@@ -58,15 +69,75 @@ export default function MemoryUnitsPage() {
     [scope.appId, scope.tenantId, scope.agentId, scope.runId],
   );
 
-  // 文件记忆库（storageMode=oss+ots）在长期记忆 tab 下额外提供「文件记忆」视图，
-  // 展示按 scope 投影出的本地文件树。storageMode 仅在 GetMemoryStore 里有，
-  // 故单独查库。
   const { data: memoryStore } = useMemoryStore(memoryStoreName);
-  const fileMemory = isFileMemory(memoryStore?.storageMode);
-  const [viewMode, setViewMode] = useState<"units" | "files">("units");
-  // 文件记忆挂载需要 appId 且无通配符（空的租户/智能体/会话由 BFF 归一为
-  // __default__）。
-  const fileScopeUsable = !!scope.appId && !wildcard;
+  const capabilities = storageModeCapabilities(memoryStore?.storageMode);
+  const fileMemory = capabilities.files;
+  const writableFileMemory = capabilities.writableFiles;
+  const requestedView = searchParams.get("view");
+  const requestedFile = searchParams.get("file");
+  const [viewMode, setViewMode] = useState<"units" | "files">(
+    requestedView === "files" ? "files" : "units",
+  );
+  useEffect(() => {
+    if (!memoryStore) return;
+    if (!capabilities.structured || requestedView === "files") {
+      setViewMode(capabilities.files ? "files" : "units");
+    } else if (!capabilities.files) {
+      setViewMode("units");
+    }
+  }, [capabilities.files, capabilities.structured, memoryStore, requestedView]);
+  const exactFileScope = useMemo(
+    () =>
+      normalizeExactFileMemoryScope({
+        appId: scope.appId,
+        tenantId: scope.tenantId,
+        agentId: scope.agentId,
+        runId: scope.runId,
+      }),
+    [scope.appId, scope.tenantId, scope.agentId, scope.runId],
+  );
+  const fileScopeUsable = !wildcard && exactFileScope !== null;
+  const [recentFileScopes, setRecentFileScopes] = useState<FileMemoryScope[]>(
+    [],
+  );
+
+  useEffect(() => {
+    if (!writableFileMemory) {
+      setRecentFileScopes([]);
+      return;
+    }
+    const recent = exactFileScope
+      ? rememberRecentFileScope(
+          window.localStorage,
+          dataScopeKey,
+          memoryStoreName,
+          exactFileScope,
+        )
+      : readRecentFileScopes(
+          window.localStorage,
+          dataScopeKey,
+          memoryStoreName,
+        );
+    setRecentFileScopes(recent);
+  }, [dataScopeKey, exactFileScope, memoryStoreName, writableFileMemory]);
+
+  function applyFileScope(nextScope: FileMemoryScope) {
+    setRecentFileScopes(
+      rememberRecentFileScope(
+        window.localStorage,
+        dataScopeKey,
+        memoryStoreName,
+        nextScope,
+      ),
+    );
+    const nextParams = applyFileScopeToSearchParams(
+      new URLSearchParams(searchParamsString),
+      nextScope,
+    );
+    router.replace(
+      `/memory/${encodeURIComponent(memoryStoreName)}/units?${nextParams.toString()}`,
+    );
+  }
 
   const [pagination, setPagination] = useState<{
     scopeKey: string;
@@ -227,9 +298,15 @@ export default function MemoryUnitsPage() {
 
   return (
     <div className="space-y-4">
-      <PageHeader title={t("memory.units.title")}>
+      <PageHeader
+        title={
+          capabilities.structured
+            ? t("memory.units.title")
+            : t("memory.detail.tabFiles")
+        }
+      >
         <div className="flex items-center gap-2">
-          {fileMemory && (
+          {fileMemory && capabilities.structured && (
             <UnitsViewToggle viewMode={viewMode} onChange={setViewMode} t={t} />
           )}
           {viewMode === "units" && (
@@ -273,14 +350,20 @@ export default function MemoryUnitsPage() {
       {viewMode === "files" ? (
         <FileMemoryView
           usable={fileScopeUsable}
-          hasAppId={!!scope.appId}
+          writable={writableFileMemory}
+          hasAppId={!!scope.appId && scope.appId !== "*"}
           memoryStoreName={memoryStoreName}
-          scope={{
-            appId: scope.appId ?? "",
-            tenantId: scope.tenantId ?? "",
-            agentId: scope.agentId ?? "",
-            runId: scope.runId ?? "",
-          }}
+          scope={
+            exactFileScope ?? {
+              appId: scope.appId ?? "",
+              tenantId: scope.tenantId ?? "",
+              agentId: scope.agentId ?? "",
+              runId: scope.runId ?? "",
+            }
+          }
+          recentScopes={recentFileScopes}
+          onApplyScope={applyFileScope}
+          initialPath={requestedFile}
         />
       ) : (
         <>
@@ -473,23 +556,38 @@ function UnitsViewToggle({
 }
 
 /**
- * 文件记忆视图：按当前范围栏 scope 展示投影出的本地文件树，点击文件查看内容。
- * scope 需含 appId 且无通配符（空的租户/智能体/会话由 BFF 归一为 __default__）。
+ * 文件记忆视图：按当前精确 scope 通过 JSON API 展示虚拟文件树。
+ * 可读写 filemem 在缺少 scope 时提供本地 onboarding；只读投影继续依赖
+ * ListMemoryScopes picker 或手动范围栏。
  */
 function FileMemoryView({
   usable,
+  writable,
   hasAppId,
   memoryStoreName,
   scope,
+  recentScopes,
+  onApplyScope,
+  initialPath,
 }: {
   usable: boolean;
+  writable: boolean;
   hasAppId: boolean;
   memoryStoreName: string;
-  scope: { appId: string; tenantId: string; agentId: string; runId: string };
+  scope: FileMemoryScope;
+  recentScopes: FileMemoryScope[];
+  onApplyScope: (scope: FileMemoryScope) => void;
+  initialPath?: string | null;
 }) {
   const { t } = useI18n();
   if (!usable) {
-    return (
+    return writable ? (
+      <FileScopeOnboarding
+        initialScope={scope}
+        recentScopes={recentScopes}
+        onApply={onApplyScope}
+      />
+    ) : (
       <div className="rounded-lg border border-dashed border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.25)] p-8 text-center">
         <FolderTree className="mx-auto mb-2 h-6 w-6 text-muted-foreground" />
         <p className="text-sm text-muted-foreground">
@@ -504,6 +602,7 @@ function FileMemoryView({
     <MemoryFilesBrowser
       memoryStoreName={memoryStoreName}
       scope={scope}
+      initialPath={initialPath}
       className="h-[calc(100vh-320px)] min-h-[360px]"
     />
   );