@tablestore/tablestore-agent-cli 0.2.6 → 0.2.8

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

@@ -23,6 +23,7 @@ import { MemoryDreamDisabled } from "@/components/memory/memory-dream-disabled";
 import {
   DREAM_TERMINAL_STATUSES,
   type DreamTaskStatus,
+  type DreamTaskType,
   type MemoryScope,
 } from "@/types/memory";
 import { cn } from "@/lib/utils";
@@ -72,6 +73,18 @@ function StatusPill({ status }: { status: DreamTaskStatus }) {
   );
 }
 
+const TASK_TYPE_LABEL: Record<DreamTaskType, string> = {
+  memory: "记忆整理",
+  skill: "技能抽取",
+  profile: "用户画像",
+};
+
+const TASK_TYPE_CLASS: Record<DreamTaskType, string> = {
+  memory: "bg-info-soft text-info",
+  skill: "bg-success-soft text-success",
+  profile: "bg-[hsl(var(--primary-soft,_220_90%_96%))] text-[hsl(var(--primary))]",
+};
+
 function scopeLabel(scope: MemoryScope): string {
   return (
     [scope.appId, scope.tenantId, scope.agentId, scope.runId]
@@ -112,6 +125,7 @@ export default function DreamTaskDetailPage() {
 
   const task = taskQuery.data;
   const isTerminal = task && DREAM_TERMINAL_STATUSES.has(task.status);
+  const isExtractTask = task?.taskType === "skill" || task?.taskType === "profile";
 
   const onCancel = async () => {
     try {
@@ -135,7 +149,7 @@ export default function DreamTaskDetailPage() {
           }
         >
           <ArrowLeft className="mr-1 h-3.5 w-3.5" />
-          返回记忆整理列表
+          返回任务列表
         </Button>
       </div>
 
@@ -150,18 +164,37 @@ export default function DreamTaskDetailPage() {
           <div className="rounded-lg border border-[hsl(var(--border))] p-5">
             <div className="flex items-start justify-between gap-3">
               <div className="space-y-1">
-                <h2 className="font-mono text-base">{task.dreamId}</h2>
+                <div className="flex items-center gap-2">
+                  <h2 className="font-mono text-base">{task.dreamId}</h2>
+                  {(() => {
+                    const tt = (task.taskType || "memory") as DreamTaskType;
+                    return (
+                      <span
+                        className={cn(
+                          "inline-flex rounded-full px-2 py-0.5 text-xs font-medium whitespace-nowrap",
+                          TASK_TYPE_CLASS[tt] ?? "bg-muted text-muted-foreground",
+                        )}
+                      >
+                        {TASK_TYPE_LABEL[tt] ?? tt}
+                      </span>
+                    );
+                  })()}
+                </div>
                 <div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
                   <StatusPill status={task.status} />
-                  <span>
-                    {task.applyMode === "safe_auto"
-                      ? "应用模式：安全变更自动应用"
-                      : "应用模式：建议（手动 apply）"}
-                  </span>
-                  <span>·</span>
-                  <span>
-                    Scope 输出：{task.scopeOutputMode === "promote_scope" ? "提升" : "保留"}
-                  </span>
+                  {(!task.taskType || task.taskType === "memory") && (
+                    <>
+                      <span>
+                        {task.applyMode === "safe_auto"
+                          ? "应用模式：安全变更自动应用"
+                          : "应用模式：建议（手动 apply）"}
+                      </span>
+                      <span>·</span>
+                      <span>
+                        Scope 输出：{task.scopeOutputMode === "promote_scope" ? "提升" : "保留"}
+                      </span>
+                    </>
+                  )}
                   {!isTerminal && (
                     <span className="ml-1 italic">· 每 5 秒自动刷新</span>
                   )}
@@ -199,12 +232,25 @@ export default function DreamTaskDetailPage() {
             <div className="mt-5 grid grid-cols-2 gap-4 sm:grid-cols-4">
               <StatBlock label="会话数" value={task.input.sessionCount} />
               <StatBlock label="消息数" value={task.input.messageCount} />
-              <StatBlock label="记忆数" value={task.input.memoryCount} />
-              <StatBlock label="动作总数" value={task.actions.total} />
-              <StatBlock label="待应用" value={task.actions.proposed} />
-              <StatBlock label="已应用" value={task.actions.applied} />
-              <StatBlock label="跳过" value={task.actions.skipped} />
-              <StatBlock label="失败" value={task.actions.failed} />
+              {(!task.taskType || task.taskType === "memory") && (
+                <StatBlock label="记忆数" value={task.input.memoryCount} />
+              )}
+              <StatBlock
+                label={isExtractTask ? "产出数" : "动作总数"}
+                value={task.actions.total}
+              />
+              {isExtractTask ? (
+                <StatBlock label="已生效" value={task.actions.applied} />
+              ) : (
+                <>
+                  <StatBlock label="待应用" value={task.actions.proposed} />
+                  <StatBlock label="已应用" value={task.actions.applied} />
+                  <StatBlock label="跳过" value={task.actions.skipped} />
+                </>
+              )}
+              {task.actions.failed > 0 && (
+                <StatBlock label="失败" value={task.actions.failed} />
+              )}
             </div>
 
             <div className="mt-5 flex flex-wrap gap-x-6 gap-y-1 text-xs text-muted-foreground">
@@ -238,18 +284,32 @@ export default function DreamTaskDetailPage() {
             </div>
           </div>
 
+          {task.instructions && (
+            <div className="rounded-lg border border-[hsl(var(--border))] p-4">
+              <h3 className="mb-2 text-sm font-semibold">
+                {task.taskType === "profile" ? "画像模板" : task.taskType === "skill" ? "抽取指引" : "额外指引"}
+              </h3>
+              <pre className="max-h-48 overflow-auto whitespace-pre-wrap rounded bg-[hsl(var(--muted)/0.4)] p-3 text-xs">
+                {task.instructions}
+              </pre>
+            </div>
+          )}
+
           <div>
-            <h3 className="mb-3 text-sm font-semibold">动作</h3>
+            <h3 className="mb-3 text-sm font-semibold">
+              {isExtractTask ? "产出结果" : "动作"}
+            </h3>
             <MemoryDreamActionsTable
               memoryStoreName={memoryStoreName}
               dreamId={dreamId}
+              taskType={task.taskType}
             />
           </div>
 
           <ConfirmDialog
             open={cancelOpen}
             onOpenChange={setCancelOpen}
-            title="确认取消记忆整理任务"
+            title="确认取消 Dream 任务"
             description="任务将停止后续动作生成，已应用的动作不会回滚。"
             variant="danger"
             onConfirm={onCancel}

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

@@ -1,8 +1,8 @@
 "use client";
 
-import { useMemo, useState } from "react";
+import { Fragment, useMemo, useState } from "react";
 import { useParams, useRouter, useSearchParams } from "next/navigation";
-import { Plus, Sparkles } from "lucide-react";
+import { ChevronDown, ChevronRight, Plus, Sparkles } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
 import { Skeleton } from "@/components/ui/skeleton";
@@ -25,8 +25,8 @@ import { RefreshButton } from "@/components/shared/refresh-button";
 import { EmptyState } from "@/components/shared/empty-state";
 import { RelativeTime } from "@/components/shared/relative-time";
 import { useDreamTasks } from "@/hooks/use-dream-tasks";
-import { buildMemoryScope } from "@/lib/memory";
-import type { DreamTask, DreamTaskStatus, MemoryScope } from "@/types/memory";
+import { buildMemoryScope, groupDreamTasksByScope } from "@/lib/memory";
+import type { DreamTask, DreamTaskStatus, DreamTaskType, MemoryScope } from "@/types/memory";
 import { MemoryDreamDisabled } from "@/components/memory/memory-dream-disabled";
 import { MemoryDreamCreateDialog } from "@/components/memory/memory-dream-create-dialog";
 import { cn } from "@/lib/utils";
@@ -65,6 +65,18 @@ const STATUS_LABEL: Record<DreamTaskStatus, string> = {
   cancelled: "已取消",
 };
 
+const TASK_TYPE_LABEL: Record<DreamTaskType, string> = {
+  memory: "记忆整理",
+  skill: "技能抽取",
+  profile: "用户画像",
+};
+
+const TASK_TYPE_CLASS: Record<DreamTaskType, string> = {
+  memory: "bg-info-soft text-info",
+  skill: "bg-success-soft text-success",
+  profile: "bg-[hsl(var(--primary-soft,_220_90%_96%))] text-[hsl(var(--primary))]",
+};
+
 const TERMINAL_STATUSES: ReadonlySet<DreamTaskStatus> = new Set([
   "completed",
   "completed_with_failures",
@@ -113,32 +125,116 @@ export default function DreamTasksPage() {
   );
   const [status, setStatus] = useState<string>("all");
   const [createOpen, setCreateOpen] = useState(false);
-  const [nextToken, setNextToken] = useState<string | undefined>(undefined);
+  const [collapsed, setCollapsed] = useState<ReadonlySet<string>>(new Set());
 
   const query = useDreamTasks(memoryStoreName, scope, {
     limit: 50,
-    nextToken,
     status: status === "all" ? undefined : status,
   });
 
-  const isDreamingDisabled =
-    query.error instanceof Error &&
-    "code" in query.error &&
-    (query.error as { code?: string }).code === "DREAMING_DISABLED";
-
-  if (isDreamingDisabled) {
+  if (query.errorCode === "DREAMING_DISABLED") {
     return <MemoryDreamDisabled />;
   }
 
-  const tasks = (query.data?.items ?? []) as DreamTask[];
+  const tasks = query.tasks;
+  // The Dream list API returns tasks scope-major (createdAt desc within a
+  // scope, but not globally). The hook eagerly loads every page; group the
+  // full set by scope so each block reads cleanly newest-first, and fall back
+  // to a flat list when there is only one scope.
+  const groups = groupDreamTasksByScope(tasks);
+  const showGroups = groups.length > 1;
+
+  const toggleGroup = (key: string) => {
+    setCollapsed((prev) => {
+      const next = new Set(prev);
+      if (next.has(key)) next.delete(key);
+      else next.add(key);
+      return next;
+    });
+  };
+
+  const renderTaskRow = (task: DreamTask) => {
+    const createdMs = new Date(task.createdAt).getTime();
+    return (
+      <TableRow
+        key={task.dreamId}
+        className="cursor-pointer hover:bg-[hsl(var(--accent))]"
+        onClick={() =>
+          router.push(
+            `/memory/${encodeURIComponent(memoryStoreName)}/dream/${encodeURIComponent(task.dreamId)}`,
+          )
+        }
+      >
+        <TableCell className="max-w-[220px] truncate font-mono text-xs">
+          {task.dreamId}
+        </TableCell>
+        <TableCell>
+          {(() => {
+            const tt = (task.taskType || "memory") as DreamTaskType;
+            return (
+              <span
+                className={cn(
+                  "inline-flex rounded-full px-2 py-0.5 text-xs font-medium whitespace-nowrap",
+                  TASK_TYPE_CLASS[tt] ?? "bg-muted text-muted-foreground",
+                )}
+              >
+                {TASK_TYPE_LABEL[tt] ?? tt}
+              </span>
+            );
+          })()}
+        </TableCell>
+        <TableCell>
+          <StatusPill status={task.status} />
+        </TableCell>
+        <TableCell className="text-xs">
+          {(task.taskType && task.taskType !== "memory") ? (
+            <span className="text-muted-foreground">—</span>
+          ) : (
+            <>
+              {task.applyMode === "safe_auto" ? "自动" : "建议"}
+              {task.scopeOutputMode === "promote_scope" && (
+                <span className="ml-1 text-muted-foreground">· 提升</span>
+              )}
+            </>
+          )}
+        </TableCell>
+        <TableCell className="text-right text-xs text-muted-foreground">
+          <span className="font-medium text-foreground">
+            {task.actionCount ?? 0}
+          </span>
+          {(task.taskType && task.taskType !== "memory") ? (
+            <span className="ml-1">
+              条产出
+              {(task.failedCount ?? 0) > 0 && (
+                <span className="text-danger"> / {task.failedCount} 败</span>
+              )}
+            </span>
+          ) : (
+            <span className="ml-1">
+              ({task.proposedCount ?? 0} 待 / {task.appliedCount ?? 0} 应用 /
+              {" "}
+              {task.skippedCount ?? 0} 跳 / {task.failedCount ?? 0} 败)
+            </span>
+          )}
+        </TableCell>
+        <TableCell className="text-xs text-muted-foreground">
+          {Number.isFinite(createdMs) ? (
+            <RelativeTime timestamp={createdMs} />
+          ) : (
+            task.createdAt
+          )}
+        </TableCell>
+      </TableRow>
+    );
+  };
 
   return (
     <div className="space-y-4">
       <div className="flex items-center justify-between gap-3">
         <div>
-          <h2 className="text-lg font-semibold">记忆整理</h2>
+          <h2 className="text-lg font-semibold">Dream 任务管理</h2>
           <p className="text-xs text-muted-foreground">
-            跨会话的记忆整理任务，识别模式后产出动作建议或自动应用
+            管理记忆整理、技能抽取、用户画像等离线任务
           </p>
         </div>
         <div className="flex items-center gap-2">
@@ -174,10 +270,10 @@ export default function DreamTasksPage() {
       ) : tasks.length === 0 ? (
         <EmptyState
           icon={Sparkles}
-          title="暂无记忆整理任务"
+          title="暂无 Dream 任务"
           description={
             status === "all"
-              ? "记忆整理任务跨多个会话整合记忆。第一次使用时，先确保该 scope 下已经写入过几轮对话，再点右上角创建任务。"
+              ? "Dream 任务支持记忆整理、技能抽取、用户画像等功能。第一次使用时，先确保该 scope 下已经写入过几轮对话，再点右上角创建任务。"
               : `当前过滤为「${STATUS_OPTIONS.find((o) => o.value === status)?.label ?? status}」状态，可切到「全部状态」看看`
           }
           action={
@@ -193,76 +289,71 @@ export default function DreamTasksPage() {
             <TableHeader>
               <TableRow>
                 <TableHead>Dream ID</TableHead>
+                <TableHead>类型</TableHead>
                 <TableHead>状态</TableHead>
                 <TableHead>应用模式</TableHead>
-                <TableHead className="text-right">动作</TableHead>
+                <TableHead className="text-right">产出</TableHead>
                 <TableHead>创建时间</TableHead>
               </TableRow>
             </TableHeader>
             <TableBody>
-              {tasks.map((task) => {
-                const createdMs = new Date(task.createdAt).getTime();
-                return (
-                  <TableRow
-                    key={task.dreamId}
-                    className="cursor-pointer hover:bg-[hsl(var(--accent))]"
-                    onClick={() =>
-                      router.push(
-                        `/memory/${encodeURIComponent(memoryStoreName)}/dream/${encodeURIComponent(task.dreamId)}`,
-                      )
-                    }
-                  >
-                    <TableCell className="max-w-[220px] truncate font-mono text-xs">
-                      {task.dreamId}
-                    </TableCell>
-                    <TableCell>
-                      <StatusPill status={task.status} />
-                    </TableCell>
-                    <TableCell className="text-xs">
-                      {task.applyMode === "safe_auto" ? "自动" : "建议"}
-                      {task.scopeOutputMode === "promote_scope" && (
-                        <span className="ml-1 text-muted-foreground">· 提升</span>
-                      )}
-                    </TableCell>
-                    <TableCell className="text-right text-xs text-muted-foreground">
-                      <span className="font-medium text-foreground">
-                        {task.actionCount ?? 0}
-                      </span>
-                      <span className="ml-1">
-                        ({task.proposedCount ?? 0} 待 / {task.appliedCount ?? 0} 应用 /
-                        {" "}
-                        {task.skippedCount ?? 0} 跳 / {task.failedCount ?? 0} 败)
-                      </span>
-                    </TableCell>
-                    <TableCell className="text-xs text-muted-foreground">
-                      {Number.isFinite(createdMs) ? (
-                        <RelativeTime timestamp={createdMs} />
-                      ) : (
-                        task.createdAt
-                      )}
-                    </TableCell>
-                  </TableRow>
-                );
-              })}
+              {showGroups
+                ? groups.map((group) => {
+                    const isCollapsed = collapsed.has(group.key);
+                    return (
+                      <Fragment key={group.key}>
+                        <TableRow
+                          className="cursor-pointer select-none bg-muted/40 hover:bg-muted/60"
+                          onClick={() => toggleGroup(group.key)}
+                        >
+                          <TableCell colSpan={6} className="py-2">
+                            <div className="flex items-center gap-2">
+                              {isCollapsed ? (
+                                <ChevronRight className="h-3.5 w-3.5 shrink-0 text-muted-foreground" />
+                              ) : (
+                                <ChevronDown className="h-3.5 w-3.5 shrink-0 text-muted-foreground" />
+                              )}
+                              <span className="break-all font-mono text-xs font-medium text-foreground">
+                                {group.label}
+                              </span>
+                              <span className="shrink-0 rounded-full bg-muted px-2 py-0.5 text-[11px] text-muted-foreground">
+                                {group.tasks.length} 个任务
+                              </span>
+                            </div>
+                          </TableCell>
+                        </TableRow>
+                        {!isCollapsed && group.tasks.map(renderTaskRow)}
+                      </Fragment>
+                    );
+                  })
+                : tasks.map(renderTaskRow)}
             </TableBody>
           </Table>
         </div>
       )}
 
-      {query.data?.nextToken && (
-        <div className="flex justify-end">
+      {query.isFetchingNextPage && (
+        <p className="text-center text-xs text-muted-foreground">
+          正在加载更多任务…
+        </p>
+      )}
+
+      {query.truncated && !query.isFetchingNextPage && (
+        <div className="flex items-center justify-center gap-2 text-xs text-muted-foreground">
+          <span>任务较多，已先加载一部分</span>
           <Button
             variant="outline"
             size="sm"
-            onClick={() => setNextToken(query.data?.nextToken)}
+            onClick={() => query.fetchNextPage()}
           >
-            加载下一页
+            继续加载
           </Button>
         </div>
       )}
 
       <p className="text-xs text-muted-foreground">
         当前过滤 scope：{scopeLabel(scope)}
+        {showGroups && "　·　已按 scope 分组，组内按创建时间倒序（新→旧）"}
       </p>
 
       <MemoryDreamCreateDialog

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

@@ -52,7 +52,7 @@ const TABS = [
     icon: <FileClock className="h-4 w-4" />,
   },
   {
-    label: "记忆整理",
+    label: "Dream 任务",
     segment: "dream",
     icon: <Sparkles className="h-4 w-4" />,
   },

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

@@ -32,6 +32,10 @@ export default function MemorySearchPage() {
         scope: values.scope,
         topK: values.topK,
         enableRerank: values.enableRerank,
+        // Only forward the threshold when the user opts in (> 0); the server
+        // treats 0 as "no filter", and omitting it keeps the request
+        // byte-compatible with servers that predate the minSimilarity field.
+        ...(values.minSimilarity > 0 ? { minSimilarity: values.minSimilarity } : {}),
         metadata: values.metadata,
       });
       setResults(response.results ?? []);

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

@@ -140,7 +140,6 @@ export default function MemoryUnitsPage() {
 
   // Display data: searched unit or paginated list
   const displayUnits = searchedUnit ? [searchedUnit] : units;
-  const displayTotal = searchedUnit ? 1 : (unitsQuery.data?.totalCount ?? 0);
 
   if (unitsQuery.isLoading && !searchedUnit) {
     return (
@@ -154,7 +153,7 @@ export default function MemoryUnitsPage() {
 
   return (
     <div className="space-y-4">
-      <PageHeader title={`长期记忆 (${displayTotal})`}>
+      <PageHeader title="长期记忆">
         <div className="flex items-center gap-2">
           <RefreshButton
             loading={unitsQuery.isRefetching}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/[name]/route.ts

@@ -67,6 +67,7 @@ export async function GET(_request: NextRequest, context: RouteContext) {
       accessKeySecretMasked: detail.access_key_secret
         ? maskSecret(detail.access_key_secret)
         : undefined,
+      apiKeyMasked: detail.api_key ? maskSecret(detail.api_key) : undefined,
       memoryDefaults: {
         storeName: detail.memory_store_name || undefined,
         appId: detail.memory_app_id || undefined,
@@ -111,6 +112,7 @@ export async function PUT(request: NextRequest, context: RouteContext) {
     const d = parsed.data;
     if (d.accessKeyId) patch.access_key_id = d.accessKeyId;
     if (d.accessKeySecret) patch.access_key_secret = d.accessKeySecret;
+    if (d.apiKey) patch.api_key = d.apiKey;
     if (d.otsEndpoint) patch.ots_endpoint = d.otsEndpoint;
     if (d.otsInstanceName) patch.ots_instance_name = d.otsInstanceName;
     if (d.ossEndpoint !== undefined) patch.oss_endpoint = d.ossEndpoint;
@@ -128,6 +130,7 @@ export async function PUT(request: NextRequest, context: RouteContext) {
       const token = encodeTokenV2({
         access_key_id: updated.access_key_id,
         access_key_secret: updated.access_key_secret,
+        api_key: updated.api_key,
         ots_endpoint: updated.ots_endpoint || ots.ots_endpoint,
         ots_instance_name:
           updated.ots_instance_name || ots.ots_instance_name,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/[name]/token/route.ts

@@ -67,6 +67,7 @@ export async function GET(_request: NextRequest, context: RouteContext) {
     const token = encodeTokenV2({
       access_key_id: detail.access_key_id,
       access_key_secret: detail.access_key_secret,
+      api_key: detail.api_key,
       ots_endpoint: detail.ots_endpoint,
       ots_instance_name: detail.ots_instance_name,
       oss_endpoint: effectiveOssEndpoint,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/[name]/use/route.ts

@@ -65,6 +65,7 @@ export async function POST(_request: NextRequest, context: RouteContext) {
     const token = encodeTokenV2({
       access_key_id: detail.access_key_id,
       access_key_secret: detail.access_key_secret,
+      api_key: detail.api_key,
       ots_endpoint: detail.ots_endpoint || ots.ots_endpoint,
       ots_instance_name: detail.ots_instance_name || ots.ots_instance_name,
       oss_endpoint: detail.oss_endpoint || oss.oss_endpoint,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/route.ts

@@ -131,6 +131,7 @@ export async function POST(request: NextRequest) {
       const effective = loadConfig();
       const tokenFields = {
         ...fields,
+        api_key: fields.api_key || "",
         oss_endpoint: effective.oss_endpoint || fields.oss_endpoint || "",
         oss_bucket_name:
           effective.oss_bucket_name || fields.oss_bucket_name || "",
@@ -184,6 +185,7 @@ function createFromFields(raw: unknown): CreationPlan | NextResponse {
     fields: stripEmpty({
       access_key_id: data.accessKeyId,
       access_key_secret: data.accessKeySecret,
+      api_key: data.apiKey,
       ots_endpoint: data.otsEndpoint,
       ots_instance_name: data.otsInstanceName,
       oss_endpoint: data.ossEndpoint,

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

@@ -7,9 +7,10 @@ import { Info } from "lucide-react";
 import { z } from "zod";
 
 import {
-  connectInstanceSchema,
+  connectInstanceBaseSchema,
   editInstanceFormSchema,
   importInstanceSchema,
+  withCredentialModeRules,
 } from "@/schemas/instance";
 import { Button } from "@/components/ui/button";
 import {
@@ -44,15 +45,17 @@ import { stripBucketPrefix } from "@/lib/normalize-oss-endpoint";
  * which the server-side schema cannot assert because tokens may ship bare
  * endpoints — is layered on via `.extend(...)` instead of a parallel copy.
  */
-const connectFormSchema = connectInstanceSchema.extend({
-  otsEndpoint: z.string().trim().url("请输入合法的 OTS Endpoint URL"),
-  ossEndpoint: z
-    .string()
-    .trim()
-    .url("请输入合法的 OSS Endpoint URL")
-    .optional()
-    .or(z.literal("")),
-});
+const connectFormSchema = withCredentialModeRules(
+  connectInstanceBaseSchema.extend({
+    otsEndpoint: z.string().trim().url("请输入合法的 OTS Endpoint URL"),
+    ossEndpoint: z
+      .string()
+      .trim()
+      .url("请输入合法的 OSS Endpoint URL")
+      .optional()
+      .or(z.literal("")),
+  }),
+);
 
 // Token tab only needs the `token` field; omit everything else so the
 // submit handler receives a clean `{ token }` shape.
@@ -81,6 +84,10 @@ export interface ConnectInstanceFormProps {
    * placeholder so users can see "something is set" without exposing it.
    */
   accessKeySecretPlaceholder?: string;
+  /**
+   * Edit-mode hint: masked API Key surfaced as the input placeholder.
+   */
+  apiKeyPlaceholder?: string;
   onSubmit: (
     values: ConnectInstancePayload | ImportInstancePayload,
   ) => Promise<void>;
@@ -96,6 +103,7 @@ export function ConnectInstanceForm({
   defaultValues,
   accessKeyIdPlaceholder,
   accessKeySecretPlaceholder,
+  apiKeyPlaceholder,
   onSubmit,
   busy,
   lockName,
@@ -142,6 +150,8 @@ export function ConnectInstanceForm({
       // users still get the "something is set" affordance.
       accessKeyId: isEdit ? "" : (defaultValues?.accessKeyId ?? ""),
       accessKeySecret: isEdit ? "" : (defaultValues?.accessKeySecret ?? ""),
+      // Same masked-placeholder treatment as AK/SK in edit mode.
+      apiKey: isEdit ? "" : (defaultValues?.apiKey ?? ""),
       otsEndpoint: defaultValues?.otsEndpoint ?? "",
       otsInstanceName: defaultValues?.otsInstanceName ?? "",
       ossEndpoint: defaultValues?.ossEndpoint ?? "",
@@ -332,6 +342,35 @@ export function ConnectInstanceForm({
               />
             </div>
 
+            <FormField
+              control={manualForm.control}
+              name="apiKey"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>API Key（可选）</FormLabel>
+                  <FormControl>
+                    <Input
+                      {...field}
+                      type="password"
+                      autoComplete="new-password"
+                      disabled={busy}
+                      placeholder={
+                        isEdit && apiKeyPlaceholder
+                          ? `${apiKeyPlaceholder} · 留空表示保留`
+                          : "sk-..."
+                      }
+                    />
+                  </FormControl>
+                  <FormDescription>
+                    可替代 AccessKey 作为数据面访问凭证；同时填写时 API Key 优先。
+                    需 HTTPS 端点，且无法自动创建实例 / 使用 OSS 上传（那些仍需
+                    AK/SK）。
+                  </FormDescription>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+
             <div className="grid gap-4 sm:grid-cols-2">
               <FormField
                 control={manualForm.control}