@tablestore/tablestore-agent-cli 0.1.3 → 0.1.4

package/dist/dashboard-runtime/dashboard/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/apsarapangu/disk1/agent-storage-cli","allowedDevOrigins":["http://127.0.0.1:3000","http://localhost:3000"],"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":95,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["ali-oss","urllib","tablestore","proxy-agent"],"turbopack":{"root":"/apsarapangu/disk1/agent-storage-cli"},"distDirRoot":".next"}
+const nextConfig = {"env":{},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/aoneci/runner/work/source","allowedDevOrigins":["http://127.0.0.1:3000","http://localhost:3000"],"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":103,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["ali-oss","urllib","tablestore","proxy-agent"],"turbopack":{"root":"/aoneci/runner/work/source"},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/dist/dashboard-runtime/dashboard/src/components/instance/connect-instance-dialog.tsx

@@ -51,9 +51,9 @@ export function ConnectInstanceDialog({
     <Dialog open={open} onOpenChange={onOpenChange}>
       <DialogContent className="max-w-xl">
         <DialogHeader>
-          <DialogTitle>连接新实例</DialogTitle>
+          <DialogTitle>创建新项目</DialogTitle>
           <DialogDescription>
-            填写 Tablestore 实例的连接凭证，或粘贴已有的实例 Token。
+            填写项目的连接凭证，或粘贴已有的项目 Token。
           </DialogDescription>
         </DialogHeader>
         <ConnectInstanceForm

package/dist/dashboard-runtime/dashboard/src/components/instance/connect-instance-form.tsx

@@ -8,6 +8,7 @@ import { z } from "zod";
 
 import {
   connectInstanceSchema,
+  editInstanceFormSchema,
   importInstanceSchema,
 } from "@/schemas/instance";
 import { Button } from "@/components/ui/button";
@@ -67,6 +68,18 @@ const REGION_OPTIONS = [
 export interface ConnectInstanceFormProps {
   mode: "create" | "edit";
   defaultValues?: Partial<ConnectInstancePayload>;
+  /**
+   * Edit-mode hint: masked AccessKey ID surfaced as the input placeholder.
+   * The form never prefills the actual field with the masked value because
+   * submitting it would overwrite the live credential with stars on the
+   * server. Ignored in create mode.
+   */
+  accessKeyIdPlaceholder?: string;
+  /**
+   * Edit-mode hint: masked AccessKey Secret surfaced as the input
+   * placeholder so users can see "something is set" without exposing it.
+   */
+  accessKeySecretPlaceholder?: string;
   onSubmit: (
     values: ConnectInstancePayload | ImportInstancePayload,
   ) => Promise<void>;
@@ -80,12 +93,15 @@ type Tab = "manual" | "token";
 export function ConnectInstanceForm({
   mode,
   defaultValues,
+  accessKeyIdPlaceholder,
+  accessKeySecretPlaceholder,
   onSubmit,
   busy,
   lockName,
   submitLabel,
 }: ConnectInstanceFormProps) {
   const [tab, setTab] = useState<Tab>("manual");
+  const isEdit = mode === "edit";
 
   const initialRegion = defaultValues?.region ?? "cn-hangzhou";
   const initialRegionIsPreset = useMemo(
@@ -96,12 +112,35 @@ export function ConnectInstanceForm({
     initialRegionIsPreset ? initialRegion : "__custom__",
   );
 
+  // The two modes need different validation:
+  //   - create: every field required (connectFormSchema).
+  //   - edit:   AK/SK optional but pair-locked, and every other endpoint
+  //             field still validated (editInstanceFormSchema). Submitting
+  //             with both blank means "keep the existing credential".
+  // The resolver typing differs between the two schemas because of the
+  // `.refine` overload on the edit variant; the cast below keeps the
+  // FormValues shape (ConnectInstancePayload) intact at the call sites.
+  const resolver = useMemo(
+    () =>
+      zodResolver(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (isEdit ? editInstanceFormSchema : connectFormSchema) as any,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      ) as any,
+    [isEdit],
+  );
+
   const manualForm = useForm<ConnectInstancePayload>({
-    resolver: zodResolver(connectFormSchema),
+    resolver,
     defaultValues: {
       name: defaultValues?.name ?? "",
-      accessKeyId: defaultValues?.accessKeyId ?? "",
-      accessKeySecret: defaultValues?.accessKeySecret ?? "",
+      // Never seed AK/SK in edit mode: the dialog only has access to
+      // masked values (e.g. "LTAI****t2j2"), and prefilling them would
+      // round-trip the stars back to the server on save and brick the
+      // instance. The masked string is shown as a placeholder instead so
+      // users still get the "something is set" affordance.
+      accessKeyId: isEdit ? "" : (defaultValues?.accessKeyId ?? ""),
+      accessKeySecret: isEdit ? "" : (defaultValues?.accessKeySecret ?? ""),
       otsEndpoint: defaultValues?.otsEndpoint ?? "",
       otsInstanceName: defaultValues?.otsInstanceName ?? "",
       ossEndpoint: defaultValues?.ossEndpoint ?? "",
@@ -155,7 +194,7 @@ export function ConnectInstanceForm({
               name="name"
               render={({ field }) => (
                 <FormItem>
-                  <FormLabel>实例名称</FormLabel>
+                  <FormLabel>项目名称</FormLabel>
                   <FormControl>
                     <Input
                       {...field}
@@ -180,8 +219,22 @@ export function ConnectInstanceForm({
                   <FormItem>
                     <FormLabel>AccessKey ID</FormLabel>
                     <FormControl>
-                      <Input {...field} autoComplete="off" disabled={busy} />
+                      <Input
+                        {...field}
+                        autoComplete="off"
+                        disabled={busy}
+                        placeholder={
+                          isEdit && accessKeyIdPlaceholder
+                            ? `${accessKeyIdPlaceholder} · 留空表示保留`
+                            : undefined
+                        }
+                      />
                     </FormControl>
+                    {isEdit && (
+                      <FormDescription>
+                        AK 与 SK 必须成对更新，留空则保留现有凭证。
+                      </FormDescription>
+                    )}
                     <FormMessage />
                   </FormItem>
                 )}
@@ -243,7 +296,7 @@ export function ConnectInstanceForm({
               <Info className="mt-0.5 h-3.5 w-3.5 shrink-0 text-[hsl(var(--primary))]" />
               <span>
                 OSS 信息为可选项。若需上传文档到知识库，OSS Endpoint 与 Bucket 必填；
-                留空则实例只能用于查询与检索，文件上传功能将不可用。
+                留空则项目只能用于查询与检索，文件上传功能将不可用。
               </span>
             </div>
 
@@ -344,7 +397,7 @@ export function ConnectInstanceForm({
               <Button type="submit" disabled={busy}>
                 {busy
                   ? "提交中..."
-                  : (submitLabel ?? (mode === "edit" ? "保存" : "连接实例"))}
+                  : (submitLabel ?? (mode === "edit" ? "保存" : "创建项目"))}
               </Button>
             </div>
           </form>
@@ -363,12 +416,12 @@ export function ConnectInstanceForm({
                 name="token"
                 render={({ field }) => (
                   <FormItem>
-                    <FormLabel>实例 Token</FormLabel>
+                    <FormLabel>项目 Token</FormLabel>
                     <FormControl>
                       <Textarea
                         {...field}
                         rows={5}
-                        placeholder="粘贴从其他环境导出的实例 Token"
+                        placeholder="粘贴从其他环境导出的项目 Token"
                         disabled={busy}
                       />
                     </FormControl>

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

@@ -40,9 +40,17 @@ export function EditInstanceDialog({
     if (!name) return;
     // Edit mode never exposes the token tab, so `values` is always manual.
     const manual = values as ConnectInstancePayload;
+    // The form's edit schema enforces "AK and SK are filled together or
+    // both blank". Both blank means "keep the existing credential", so
+    // we strip the pair from the patch entirely instead of sending empty
+    // strings (which the server would interpret as "clear the credential"
+    // and brick the instance).
+    const ak = manual.accessKeyId?.trim() ?? "";
+    const sk = manual.accessKeySecret?.trim() ?? "";
+    const credentialPatch =
+      ak && sk ? { accessKeyId: ak, accessKeySecret: sk } : {};
     const patch: UpdateInstancePayload = {
-      accessKeyId: manual.accessKeyId,
-      accessKeySecret: manual.accessKeySecret || undefined,
+      ...credentialPatch,
       otsEndpoint: manual.otsEndpoint,
       otsInstanceName: manual.otsInstanceName,
       ossEndpoint: manual.ossEndpoint,
@@ -62,7 +70,7 @@ export function EditInstanceDialog({
     <Dialog open={open} onOpenChange={onOpenChange}>
       <DialogContent className="max-w-xl">
         <DialogHeader>
-          <DialogTitle>编辑实例{name ? ` · ${name}` : ""}</DialogTitle>
+          <DialogTitle>编辑项目{name ? ` · ${name}` : ""}</DialogTitle>
           <DialogDescription>
             修改连接凭证后会立即生效，其他会话可能需要刷新。
           </DialogDescription>
@@ -77,7 +85,7 @@ export function EditInstanceDialog({
           </SkeletonGroup>
         ) : detailQuery.isError ? (
           <p className="text-sm text-[hsl(var(--destructive))]">
-            加载实例详情失败：
+            加载项目详情失败：
             {detailQuery.error instanceof Error
               ? detailQuery.error.message
               : "未知错误"}
@@ -89,7 +97,11 @@ export function EditInstanceDialog({
             busy={update.isPending}
             defaultValues={{
               name: detail.name,
-              accessKeyId: detail.accessKeyIdMasked ?? "",
+              // Leave AK/SK blank: the form treats blank pair as "keep
+              // existing credential". Masked values flow through dedicated
+              // placeholder props below so the input still hints at what
+              // is currently configured.
+              accessKeyId: "",
               accessKeySecret: "",
               otsEndpoint: detail.otsEndpoint ?? "",
               otsInstanceName: detail.otsInstanceName ?? "",
@@ -97,6 +109,8 @@ export function EditInstanceDialog({
               ossBucketName: detail.ossBucketName ?? "",
               region: detail.region ?? "",
             }}
+            accessKeyIdPlaceholder={detail.accessKeyIdMasked}
+            accessKeySecretPlaceholder={detail.accessKeySecretMasked}
             onSubmit={handleSubmit}
             submitLabel="保存修改"
           />

package/dist/dashboard-runtime/dashboard/src/components/layout/breadcrumb-bar.tsx

@@ -29,6 +29,7 @@ const SEGMENT_LABELS: Record<string, string> = {
   "knowledge-base": "知识库",
   memory: "记忆库",
   "llm-providers": "大模型",
+  projects: "项目管理",
   documents: "文档",
   retrieval: "检索测试",
   qa: "问答测试",

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

@@ -1,7 +1,7 @@
 "use client";
 
 import { useState } from "react";
-import { useRouter } from "next/navigation";
+import { usePathname, useRouter } from "next/navigation";
 import { Check, ChevronDown, Plus, Settings2 } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
@@ -17,8 +17,26 @@ import { ConnectInstanceDialog } from "@/components/instance/connect-instance-di
 import { useInstances, useSwitchInstance } from "@/hooks/use-instances";
 import { cn } from "@/lib/utils";
 
+/**
+ * Map the current path to a safe destination after switching the active
+ * instance. Pages that address a specific resource by name (knowledge base
+ * detail, memory store detail, ...) would render a "not found" state under
+ * the new instance, so we fall back to the corresponding list view. Pages
+ * that are instance-scoped but not resource-scoped (e.g. the chat homepage
+ * or the LLM provider list) stay where they are.
+ */
+function resolveSwitchTarget(pathname: string | null): string | null {
+  if (!pathname) return null;
+  const kbDetail = pathname.match(/^\/knowledge-base\/[^/]+(?:\/.*)?$/);
+  if (kbDetail) return "/knowledge-base";
+  const memoryDetail = pathname.match(/^\/memory\/[^/]+(?:\/.*)?$/);
+  if (memoryDetail) return "/memory";
+  return null;
+}
+
 export function InstanceSwitcher() {
   const router = useRouter();
+  const pathname = usePathname();
   const [connectOpen, setConnectOpen] = useState(false);
   const { data, isLoading } = useInstances();
   const switchMutation = useSwitchInstance();
@@ -30,7 +48,22 @@ export function InstanceSwitcher() {
     if (name === activeName || switchMutation.isPending) return;
     try {
       await switchMutation.mutateAsync(name);
-      router.refresh();
+      // Hard reload (not router.refresh) so every client-side state owned
+      // by the dashboard rebuilds against the new instance:
+      //   - ChatConfigProvider's mounts / provider / model selection
+      //   - QaChatPanel local drafts and unsent input
+      //   - any in-memory hook state keyed off the previous instance
+      // router.refresh only re-fetches RSC payloads; it leaves the React
+      // tree (and thus all of the above) intact, which is what made the
+      // dashboard appear to "not actually switch" in production builds.
+      // Mirrors the standard Discord / GitHub / Notion workspace-switch UX.
+      //
+      // When the current page is scoped to a resource that does not exist
+      // under the new instance (e.g. /knowledge-base/<name>), redirect to
+      // the corresponding list view to avoid the "knowledge base not found"
+      // dead-end. Other pages keep the current pathname.
+      const target = resolveSwitchTarget(pathname) ?? window.location.pathname;
+      window.location.assign(target);
     } catch {
       // Error toast is handled inside the hook.
     }
@@ -47,19 +80,19 @@ export function InstanceSwitcher() {
             disabled={isLoading}
           >
             <span className="max-w-[140px] truncate">
-              {activeName ? `*${activeName}` : "选择实例"}
+              {activeName ? `*${activeName}` : "选择项目"}
             </span>
             <ChevronDown className="h-3.5 w-3.5 opacity-60" />
           </Button>
         </DropdownMenuTrigger>
         <DropdownMenuContent align="end" className="min-w-[220px]">
           <DropdownMenuLabel className="text-xs font-medium text-muted-foreground">
-            切换实例
+            切换项目
           </DropdownMenuLabel>
 
           {instances.length === 0 ? (
             <div className="px-2 py-3 text-xs text-muted-foreground">
-              暂无实例，先连接一个。
+              暂无项目，先创建一个。
             </div>
           ) : (
             instances.map((item) => {
@@ -100,17 +133,17 @@ export function InstanceSwitcher() {
             className="gap-2"
           >
             <Plus className="h-3.5 w-3.5" />
-            连接新实例
+            创建新项目
           </DropdownMenuItem>
           <DropdownMenuItem
             onSelect={(event) => {
               event.preventDefault();
-              router.push("/instances");
+              router.push("/projects");
             }}
             className="gap-2"
           >
             <Settings2 className="h-3.5 w-3.5" />
-            实例管理
+            项目管理
           </DropdownMenuItem>
         </DropdownMenuContent>
       </DropdownMenu>

package/dist/dashboard-runtime/dashboard/src/components/qa/qa-chat-panel.tsx

@@ -11,6 +11,14 @@ import type { ChatMessage } from "@/types/llm-chat";
 
 import { QaMessage } from "./qa-message";
 
+export interface QaChatPanelEmptyState {
+  title: string;
+  description: string;
+  /** Optional CTA shown beneath the empty-state copy. */
+  actionLabel?: string;
+  onAction?: () => void;
+}
+
 interface QaChatPanelProps {
   messages: ChatMessage[];
   isStreaming: boolean;
@@ -18,12 +26,24 @@ interface QaChatPanelProps {
   error: string | null;
   onSend: (text: string) => void;
   onStop: () => void;
+  /**
+   * Override the built-in empty-state copy. The panel always renders the
+   * composer at the bottom, so callers can use this to surface page-level
+   * onboarding (e.g. "open settings to pick a model") without hiding the
+   * input — matching the ChatGPT / Claude convention.
+   */
+  emptyState?: QaChatPanelEmptyState;
+  /** Composer placeholder shown when `canSend` is false. */
+  disabledPlaceholder?: string;
 }
 
 /**
  * Chat surface for the QA playground: scrollable message list on top,
  * sticky composer at the bottom. Handles Enter-to-send / Shift+Enter-for-
  * newline and auto-scrolls to the latest turn.
+ *
+ * The composer is always mounted, even when the message list is empty, so
+ * users can start typing immediately on a fresh session.
  */
 export function QaChatPanel({
   messages,
@@ -32,6 +52,8 @@ export function QaChatPanel({
   error,
   onSend,
   onStop,
+  emptyState,
+  disabledPlaceholder,
 }: QaChatPanelProps) {
   const [input, setInput] = useState("");
   const scrollRef = useRef<HTMLDivElement>(null);
@@ -81,8 +103,18 @@ export function QaChatPanel({
           <div className="flex h-full min-h-[320px] items-center justify-center">
             <EmptyState
               icon={MessageSquare}
-              title="开始对话"
-              description="输入问题，系统会先从知识库检索相关内容，再让大模型基于检索结果回答"
+              title={emptyState?.title ?? "开始对话"}
+              description={
+                emptyState?.description ??
+                "输入问题，系统会先从知识库检索相关内容，再让大模型基于检索结果回答"
+              }
+              action={
+                emptyState?.actionLabel && emptyState?.onAction ? (
+                  <Button type="button" onClick={emptyState.onAction}>
+                    {emptyState.actionLabel}
+                  </Button>
+                ) : undefined
+              }
             />
           </div>
         ) : (
@@ -102,7 +134,7 @@ export function QaChatPanel({
             placeholder={
               canSend
                 ? "输入问题，Enter 发送，Shift+Enter 换行"
-                : "请先在左侧选择模型..."
+                : disabledPlaceholder ?? "请先在左侧选择模型..."
             }
             disabled={!canSend}
             className={cn(

package/dist/dashboard-runtime/dashboard/src/hooks/use-instances.ts

@@ -24,7 +24,9 @@ import type {
 
 export const INSTANCES_QUERY_KEY = ["instances"] as const;
 
-/** Invalidate every cache whose data depends on the active instance. */
+/** Invalidate every cache whose data depends on the active instance.
+ *  Used after non-switch mutations (connect / import / update / delete) where
+ *  the current session can keep the existing data while a refetch lands. */
 function invalidateInstanceScopedCaches(queryClient: QueryClient) {
   queryClient.invalidateQueries({ queryKey: INSTANCES_QUERY_KEY });
   queryClient.invalidateQueries({ queryKey: ["knowledge-bases"] });
@@ -33,6 +35,22 @@ function invalidateInstanceScopedCaches(queryClient: QueryClient) {
   queryClient.invalidateQueries({ queryKey: ["auth-status"] });
 }
 
+/** Hard-reset every cache whose data is scoped to the active instance.
+ *  `removeQueries` evicts the entries outright instead of marking them
+ *  stale, so observers on the next render fetch from scratch — no stale
+ *  data flash from the previous instance during the brief refetch window.
+ *  Mirrors the pattern recommended by TanStack Query maintainers for
+ *  logout / tenant-switch flows. */
+function resetInstanceScopedCaches(queryClient: QueryClient) {
+  queryClient.removeQueries({ queryKey: ["knowledge-bases"] });
+  queryClient.removeQueries({ queryKey: ["memory-stores"] });
+  queryClient.removeQueries({ queryKey: ["llm-providers"] });
+  queryClient.removeQueries({ queryKey: ["documents"] });
+  queryClient.removeQueries({ queryKey: ["instance"] });
+  queryClient.invalidateQueries({ queryKey: INSTANCES_QUERY_KEY });
+  queryClient.invalidateQueries({ queryKey: ["auth-status"] });
+}
+
 export function useInstances() {
   return useQuery({
     queryKey: INSTANCES_QUERY_KEY,
@@ -56,10 +74,10 @@ export function useConnectInstance() {
     mutationFn: (payload: ConnectInstancePayload) => connectInstance(payload),
     onSuccess: () => {
       invalidateInstanceScopedCaches(queryClient);
-      toast.success("实例已连接");
+      toast.success("项目已创建");
     },
     onError: (error) => {
-      toast.error(error instanceof Error ? error.message : "连接实例失败");
+      toast.error(error instanceof Error ? error.message : "创建项目失败");
     },
   });
 }
@@ -85,10 +103,10 @@ export function useUpdateInstance(name: string) {
     onSuccess: () => {
       invalidateInstanceScopedCaches(queryClient);
       queryClient.invalidateQueries({ queryKey: ["instance", name] });
-      toast.success("实例已更新");
+      toast.success("项目已更新");
     },
     onError: (error) => {
-      toast.error(error instanceof Error ? error.message : "更新实例失败");
+      toast.error(error instanceof Error ? error.message : "更新项目失败");
     },
   });
 }
@@ -99,10 +117,10 @@ export function useDeleteInstance() {
     mutationFn: (name: string) => deleteInstance(name),
     onSuccess: () => {
       invalidateInstanceScopedCaches(queryClient);
-      toast.success("实例已删除");
+      toast.success("项目已删除");
     },
     onError: (error) => {
-      toast.error(error instanceof Error ? error.message : "删除实例失败");
+      toast.error(error instanceof Error ? error.message : "删除项目失败");
     },
   });
 }
@@ -112,11 +130,15 @@ export function useSwitchInstance() {
   return useMutation({
     mutationFn: (name: string) => switchInstance(name),
     onSuccess: () => {
-      invalidateInstanceScopedCaches(queryClient);
-      toast.success("已切换活跃实例");
+      // Switching the active instance is conceptually a tenant change:
+      // every instance-scoped cache must be evicted (not just invalidated)
+      // so the new instance never inherits the old one's KB / memory /
+      // provider rows for even a single render.
+      resetInstanceScopedCaches(queryClient);
+      toast.success("已切换当前项目");
     },
     onError: (error) => {
-      toast.error(error instanceof Error ? error.message : "切换实例失败");
+      toast.error(error instanceof Error ? error.message : "切换项目失败");
     },
   });
 }