fix(claw): restore spreadsheet attachment badges

.env.example

@@ -120,9 +120,6 @@ ZOO_BASE_URL=https://api.zoo.dev
 # /vendor/pascal-editor/index.html bundle.
 NEXT_PUBLIC_PASCAL_EDITOR_URL=
 PASCAL_EDITOR_URL=
-# Shared only by the main app, Nginx, and the private Pascal service. Generate a
-# long random value; never expose it through NEXT_PUBLIC_* variables.
-PASCAL_PROXY_SECRET=
 
 # RUXA / video callback.
 RUXA_CALLBACK_URL=
@@ -153,9 +150,8 @@ PRODUCT_PLANNING_DB_SSL=false
 # Home Performance / Queues
 # -----------------------------------------------------------------------------
 
-# Legacy image queue fields: 0 = unrestricted; model/user admission caps are disabled.
+CANVAS_IMAGE_TASK_CONCURRENCY=3
-CANVAS_IMAGE_TASK_CONCURRENCY=0
+CANVAS_IMAGE_TASK_BATCH_DISPATCH_INTERVAL_MS=1000
-CANVAS_IMAGE_TASK_BATCH_DISPATCH_INTERVAL_MS=0
 EXTERNAL_IMAGE_API_MAX_CONCURRENT=3
 EXTERNAL_IMAGE_API_MAX_QUEUE=20
 EXTERNAL_IMAGE_API_QUEUE_TIMEOUT_MS=120000

.gitattributes

@@ -1,20 +0,0 @@
-# Keep source checkouts consistent across Windows and Linux.
-.gitattributes text eol=lf
-.gitignore text eol=lf
-*.ts text eol=lf
-*.tsx text eol=lf
-*.js text eol=lf
-*.jsx text eol=lf
-*.mjs text eol=lf
-*.cjs text eol=lf
-*.json text eol=lf
-*.jsonc text eol=lf
-*.yaml text eol=lf
-*.yml text eol=lf
-*.css text eol=lf
-*.html text eol=lf
-*.md text eol=lf
-*.sh text eol=lf
-*.py text eol=lf
-*.bat text eol=crlf
-*.cmd text eol=crlf

.gitignore

@@ -11,9 +11,6 @@ coverage
 
 # next.js
 .next/
-.next-build/
-.next-previous/
-/.next-*/
 out/
 build
 
@@ -51,7 +48,6 @@ yarn-error.log*
 /playwright-report/
 /blob-report/
 /playwright/*
-/output/
 deploy.tar.gz
 libvips-8.14.5-linux-x64.tar.br
 .temp-packages/
@@ -68,19 +64,10 @@ migration-backup-complete/
 migration-*.log
 migration-*.txt
 
-# Local release backups, model credentials and migration scratch data.
-/.model-config-backups/
-/backups/
-/tmp/
-
 # 本地抓包/竞品参考产物，不能提交
 artifacts/liblib-*/
 analysis/qiaodou-extract/
 
-# 本地运行时数据库与上传文件
-.local/
-public/uploads/local/
-
 # 模型文件
 *.model
 *.pth
@@ -100,7 +87,13 @@ checkpoints/
 # 第三方参考源码（不提交到git）
 reference-sources/
 
-# Legacy external Pascal Editor checkout (the managed source is under services/).
+# Development-only upload fallback.
+public/uploads/local/
+
+# Local isolated database and video-canvas test fixtures.
+.local/
+
+# Local self-hosted Pascal Editor checkout.
 .pascal-editor/
 
 # Local self-hosted Zoo Design Studio checkout.
@@ -111,30 +104,3 @@ public/vendor/zoo-modeling-app/
 
 # Drizzle migrations must be versioned (override the global *.sql ignore above)
 !lib/db/migrations/*.sql
-
-# Private smart edit runtime and media/model caches
-.venv-smart-edit/
-.smart-edit-models/
-.cache/smart-edit/
-
-services/video-render/dist/
-
-# Downloaded and normalized subtitle fonts are runtime assets.
-.cache/smart-edit-fonts/
-services/smart-edit/__pycache__/
-
-# Local verification artefacts (also excluded from Tailwind's automatic source scan).
-.qa/
-.next-video-*/
-.next-tvstar-*/
-
-services/video-upscale/dist/
-services/video-upscale/__pycache__/
-services/video-upscale/vendor/__pycache__/
-
-/services/audio-processing/dist/
-/services/audio-processing/__pycache__/
-
-# Python release-tool and test bytecode.
-__pycache__/
-*.pyc

README.md

@@ -94,7 +94,7 @@ pnpm db:generate
 推荐提交前至少运行：
 
 ```bash
-git fetch origin --prune
+git fetch github main --prune
 pnpm check:branch
 pnpm check:quality
 pnpm audit:security

SECURITY_IMPROVEMENTS_SUMMARY.md

@@ -144,10 +144,18 @@ log.error("Operation failed", error, { userId: "123" });
 #### 7. 修复 service 层错误吞没
 **风险等级**: 🟡 中等风险  
 **改动**:
+- `services/ai-cad/index.ts`: 完全重写，所有 catch 块现在记录错误
 - `services/canvas/index.ts`: 添加 logger 导入和辅助函数（未全部迁移）
 
 **潜在问题**:
 - `handleError(err, context, fallbackMessage)` 参数顺序与之前不同
+- 如果有其他代码依赖 ai-cad service 的错误格式，可能受影响
+
+**测试建议**:
+```bash
+# 触发一个 AI-CAD 错误（如无效的 workspace ID）
+# 检查日志是否包含完整错误堆栈
+```
 
 ---
 

app/(admin)/settings/_components/access-security-dashboard.tsx

@@ -1,706 +0,0 @@
-"use client";
-
-import {
-  Activity,
-  AlertTriangle,
-  Ban,
-  Clock3,
-  Globe2,
-  LogIn,
-  Plus,
-  RefreshCw,
-  Search,
-  ShieldAlert,
-  Unlock,
-  UserCheck,
-} from "lucide-react";
-import { useMemo, useState } from "react";
-import { toast } from "sonner";
-import useSWR from "swr";
-import { Badge } from "@/components/ui/badge";
-import { Button } from "@/components/ui/button";
-import {
-  Card,
-  CardContent,
-  CardDescription,
-  CardHeader,
-  CardTitle,
-} from "@/components/ui/card";
-import { Input } from "@/components/ui/input";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@/components/ui/select";
-import { cn, fetcher } from "@/lib/utils";
-
-type Severity = "info" | "watch" | "high" | "critical";
-
-type AccessLogEvent = {
-  id: string;
-  eventType: string;
-  ip: string;
-  userEmail: string | null;
-  userRole: string | null;
-  method: string | null;
-  path: string | null;
-  routeGroup: string | null;
-  statusCode: number | null;
-  outcome: string;
-  severity: Severity;
-  reasons: string[] | null;
-  userAgent: string | null;
-  createdAt: string;
-};
-
-type AccessLogTopIp = {
-  ip: string;
-  total: number;
-  uniqueUsers: number;
-  failureCount: number;
-  rateLimitedCount: number;
-  authFailureCount: number;
-  loginSuccessCount: number;
-  suspiciousCount: number;
-  firstSeen: string;
-  lastSeen: string;
-  severity: Severity;
-  failureRate: number;
-  reasons: string[];
-};
-
-type AccessLogResponse = {
-  overview: {
-    totalEvents: number;
-    uniqueIps: number;
-    abnormalEvents: number;
-    abnormalIps: number;
-    rateLimitedEvents: number;
-    manualBlockedEvents: number;
-    loginSuccessEvents: number;
-    unauthorizedEvents: number;
-  };
-  topIps: AccessLogTopIp[];
-  hourlyStats: Array<{
-    hour: string;
-    count: number;
-    abnormalCount: number;
-  }>;
-  pathStats: Array<{
-    path: string | null;
-    routeGroup: string | null;
-    count: number;
-    abnormalCount: number;
-  }>;
-  recentEvents: AccessLogEvent[];
-  rules: string[];
-};
-
-type AccessBlocklistEntry = {
-  id: string;
-  ip: string;
-  reason: string | null;
-  isActive: boolean;
-  expiresAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-  createdByEmail: string | null;
-};
-
-const severityLabels: Record<Severity, string> = {
-  info: "正常",
-  watch: "关注",
-  high: "异常",
-  critical: "高危",
-};
-
-const severityClassNames: Record<Severity, string> = {
-  info:
-    "border-emerald-200 bg-emerald-50 text-emerald-700 dark:border-emerald-800/70 dark:bg-emerald-950/45 dark:text-emerald-300",
-  watch:
-    "border-amber-200 bg-amber-50 text-amber-700 dark:border-amber-800/70 dark:bg-amber-950/45 dark:text-amber-300",
-  high:
-    "border-orange-200 bg-orange-50 text-orange-700 dark:border-orange-800/70 dark:bg-orange-950/45 dark:text-orange-300",
-  critical:
-    "border-red-200 bg-red-50 text-red-700 dark:border-red-800/70 dark:bg-red-950/45 dark:text-red-300",
-};
-
-function formatNumber(value: number | null | undefined) {
-  return new Intl.NumberFormat("zh-CN").format(Number(value || 0));
-}
-
-function formatPercent(value: number | null | undefined) {
-  return `${Math.round(Number(value || 0) * 100)}%`;
-}
-
-function formatTime(value: string | null | undefined) {
-  if (!value) return "--";
-  const date = new Date(value);
-  if (Number.isNaN(date.getTime())) return "--";
-  return new Intl.DateTimeFormat("zh-CN", {
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-  }).format(date);
-}
-
-function getStatusClassName(statusCode: number | null) {
-  if (!statusCode) return "text-muted-foreground";
-  if (statusCode >= 500) return "text-red-700 dark:text-red-300";
-  if (statusCode >= 400) return "text-orange-700 dark:text-orange-300";
-  if (statusCode >= 300) return "text-sky-700 dark:text-sky-300";
-  return "text-emerald-700 dark:text-emerald-300";
-}
-
-function AccessSeverityBadge({ severity }: { severity: Severity }) {
-  return (
-    <Badge
-      className={cn("shrink-0 border px-2 py-0.5", severityClassNames[severity])}
-      variant="outline"
-    >
-      {severityLabels[severity]}
-    </Badge>
-  );
-}
-
-export function AccessSecurityDashboard() {
-  const [hours, setHours] = useState("24");
-  const [severity, setSeverity] = useState("all");
-  const [query, setQuery] = useState("");
-  const [blockIp, setBlockIp] = useState("");
-  const [blockReason, setBlockReason] = useState("");
-  const [isSavingBlock, setIsSavingBlock] = useState(false);
-
-  const accessLogUrl = useMemo(() => {
-    const params = new URLSearchParams({
-      hours,
-      severity,
-      limit: "160",
-    });
-    if (query.trim()) params.set("q", query.trim());
-    return `/api/admin/access-logs?${params.toString()}`;
-  }, [hours, query, severity]);
-
-  const { data, isLoading, mutate } = useSWR<AccessLogResponse>(
-    accessLogUrl,
-    fetcher,
-    { refreshInterval: 30_000 }
-  );
-  const { data: blocklistData, mutate: mutateBlocklist } = useSWR<{
-    entries: AccessBlocklistEntry[];
-  }>("/api/admin/access-blocklist", fetcher);
-
-  const activeBlocklistEntries = useMemo(
-    () => (blocklistData?.entries || []).filter((entry) => entry.isActive),
-    [blocklistData?.entries]
-  );
-  const blockedRules = useMemo(
-    () => new Set(activeBlocklistEntries.map((entry) => entry.ip.toLowerCase())),
-    [activeBlocklistEntries]
-  );
-
-  const saveBlockEntry = async (targetIp?: string, targetReason?: string) => {
-    const ip = String(targetIp || blockIp).trim();
-    const reason = String(targetReason ?? blockReason).trim();
-    if (!ip) {
-      toast.error("请输入要拉黑的 IP");
-      return;
-    }
-
-    setIsSavingBlock(true);
-    try {
-      const response = await fetch("/api/admin/access-blocklist", {
-        method: "POST",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({ ip, reason }),
-      });
-      const payload = await response.json().catch(() => ({}));
-      if (!response.ok) {
-        throw new Error(payload?.message || payload?.error || "拉黑失败");
-      }
-
-      toast.success(`${ip} 已加入手动黑名单`);
-      setBlockIp("");
-      setBlockReason("");
-      await Promise.all([mutateBlocklist(), mutate()]);
-    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "拉黑失败");
-    } finally {
-      setIsSavingBlock(false);
-    }
-  };
-
-  const updateBlockEntry = async (entry: AccessBlocklistEntry, isActive: boolean) => {
-    try {
-      const response = await fetch("/api/admin/access-blocklist", {
-        method: "PATCH",
-        headers: { "content-type": "application/json" },
-        body: JSON.stringify({
-          id: entry.id,
-          isActive,
-          reason: entry.reason || "",
-          expiresAt: entry.expiresAt || null,
-        }),
-      });
-      const payload = await response.json().catch(() => ({}));
-      if (!response.ok) {
-        throw new Error(payload?.message || payload?.error || "更新失败");
-      }
-
-      toast.success(isActive ? `${entry.ip} 已重新拉黑` : `${entry.ip} 已解除拉黑`);
-      await Promise.all([mutateBlocklist(), mutate()]);
-    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "更新失败");
-    }
-  };
-
-  const overviewCards = [
-    {
-      key: "events",
-      label: "访问记录",
-      value: formatNumber(data?.overview.totalEvents),
-      note: `${hours} 小时窗口`,
-      icon: Activity,
-      className:
-        "border-slate-200 bg-slate-50 text-slate-900 dark:border-slate-700/70 dark:bg-slate-900/70 dark:text-slate-100",
-    },
-    {
-      key: "ips",
-      label: "独立 IP",
-      value: formatNumber(data?.overview.uniqueIps),
-      note: `${formatNumber(data?.overview.abnormalIps)} 个异常标注`,
-      icon: Globe2,
-      className:
-        "border-sky-200 bg-sky-50 text-sky-900 dark:border-sky-800/70 dark:bg-sky-950/45 dark:text-sky-100",
-    },
-    {
-      key: "abnormal",
-      label: "异常事件",
-      value: formatNumber(data?.overview.abnormalEvents),
-      note: `${formatNumber(data?.overview.manualBlockedEvents)} 次手动阻断`,
-      icon: ShieldAlert,
-      className:
-        "border-orange-200 bg-orange-50 text-orange-900 dark:border-orange-800/70 dark:bg-orange-950/45 dark:text-orange-100",
-    },
-    {
-      key: "login",
-      label: "成功登录",
-      value: formatNumber(data?.overview.loginSuccessEvents),
-      note: `${formatNumber(data?.overview.unauthorizedEvents)} 次未授权`,
-      icon: LogIn,
-      className:
-        "border-emerald-200 bg-emerald-50 text-emerald-900 dark:border-emerald-800/70 dark:bg-emerald-950/45 dark:text-emerald-100",
-    },
-  ];
-
-  const maxHourlyCount = Math.max(
-    1,
-    ...(data?.hourlyStats || []).map((item) => item.count)
-  );
-  const maxPathCount = Math.max(
-    1,
-    ...(data?.pathStats || []).map((item) => item.count)
-  );
-
-  return (
-    <div className="space-y-4">
-      <Card>
-        <CardHeader className="pb-4">
-          <div className="flex flex-col gap-3 lg:flex-row lg:items-end lg:justify-between">
-            <div>
-              <CardTitle className="text-xl">访问安全分析</CardTitle>
-              <CardDescription>
-                IP 访问记录、登录来源、异常标注与请求趋势
-              </CardDescription>
-            </div>
-            <div className="flex flex-col gap-2 sm:flex-row sm:items-center">
-              <div className="relative sm:w-[260px]">
-                <Search className="-translate-y-1/2 absolute left-3 top-1/2 h-4 w-4 text-muted-foreground" />
-                <Input
-                  className="h-9 pl-9"
-                  onChange={(event) => setQuery(event.target.value)}
-                  placeholder="搜索 IP、路径、用户"
-                  value={query}
-                />
-              </div>
-              <Select onValueChange={setHours} value={hours}>
-                <SelectTrigger className="h-9 sm:w-[132px]">
-                  <SelectValue />
-                </SelectTrigger>
-                <SelectContent>
-                  <SelectItem value="1">近 1 小时</SelectItem>
-                  <SelectItem value="6">近 6 小时</SelectItem>
-                  <SelectItem value="24">近 24 小时</SelectItem>
-                  <SelectItem value="72">近 3 天</SelectItem>
-                  <SelectItem value="168">近 7 天</SelectItem>
-                </SelectContent>
-              </Select>
-              <Select onValueChange={setSeverity} value={severity}>
-                <SelectTrigger className="h-9 sm:w-[132px]">
-                  <SelectValue />
-                </SelectTrigger>
-                <SelectContent>
-                  <SelectItem value="all">全部级别</SelectItem>
-                  <SelectItem value="abnormal">仅异常</SelectItem>
-                  <SelectItem value="watch">关注</SelectItem>
-                  <SelectItem value="high">异常</SelectItem>
-                  <SelectItem value="critical">高危</SelectItem>
-                </SelectContent>
-              </Select>
-              <Button
-                className="h-9 gap-2"
-                onClick={() => mutate()}
-                size="sm"
-                variant="outline"
-              >
-                <RefreshCw className={cn("h-4 w-4", isLoading && "animate-spin")} />
-                刷新
-              </Button>
-            </div>
-          </div>
-        </CardHeader>
-        <CardContent className="space-y-4">
-          <div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
-            {overviewCards.map((item) => {
-              const Icon = item.icon;
-              return (
-                <div
-                  className={cn("rounded-lg border p-4", item.className)}
-                  key={item.key}
-                >
-                  <div className="flex items-center justify-between gap-3">
-                    <div className="text-sm text-current/70">{item.label}</div>
-                    <Icon className="h-4 w-4" />
-                  </div>
-                  <div className="mt-3 font-semibold text-3xl tracking-tight">
-                    {item.value}
-                  </div>
-                  <div className="mt-1 text-current/65 text-xs">{item.note}</div>
-                </div>
-              );
-            })}
-          </div>
-
-          <div className="rounded-lg border bg-background p-4">
-            <div className="mb-3 flex items-center justify-between gap-3">
-              <div className="flex items-center gap-2 font-medium text-sm">
-                <Clock3 className="h-4 w-4" />
-                小时趋势
-              </div>
-              <div className="text-muted-foreground text-xs">
-                橙色表示异常事件占比
-              </div>
-            </div>
-            <div className="flex h-[180px] items-end gap-1">
-              {(data?.hourlyStats || []).map((item) => {
-                const height = Math.max(4, (item.count / maxHourlyCount) * 100);
-                const abnormalHeight =
-                  item.count > 0
-                    ? Math.max(0, (item.abnormalCount / item.count) * height)
-                    : 0;
-                return (
-                  <div
-                    className="group relative flex min-w-[10px] flex-1 items-end overflow-hidden rounded bg-slate-200 dark:bg-slate-800"
-                    key={item.hour}
-                    style={{ height: `${height}%` }}
-                  >
-                    <div
-                      className="w-full bg-orange-400"
-                      style={{ height: `${abnormalHeight}%` }}
-                    />
-                    <div className="-translate-x-1/2 pointer-events-none absolute bottom-full left-1/2 z-10 mb-2 hidden whitespace-nowrap rounded-md bg-zinc-950 px-2 py-1 text-white text-xs shadow-lg group-hover:block">
-                      {item.hour} · {formatNumber(item.count)} 次 · 异常{" "}
-                      {formatNumber(item.abnormalCount)}
-                    </div>
-                  </div>
-                );
-              })}
-              {(!data?.hourlyStats || data.hourlyStats.length === 0) && (
-                <div className="flex h-full w-full items-center justify-center rounded-lg border border-dashed text-muted-foreground text-sm">
-                  暂无访问记录
-                </div>
-              )}
-            </div>
-          </div>
-        </CardContent>
-      </Card>
-
-      <Card>
-        <CardHeader className="pb-4">
-          <CardTitle className="text-lg">手动 IP 黑名单</CardTitle>
-          <CardDescription>
-            管理员手动加入后，命中 IP 会被阻断并写入访问日志
-          </CardDescription>
-        </CardHeader>
-        <CardContent className="space-y-4">
-          <div className="grid gap-3 lg:grid-cols-[220px_minmax(240px,1fr)_auto]">
-            <Input
-              className="h-9"
-              onChange={(event) => setBlockIp(event.target.value)}
-              placeholder="IP 或 IPv4 CIDR"
-              value={blockIp}
-            />
-            <Input
-              className="h-9"
-              onChange={(event) => setBlockReason(event.target.value)}
-              placeholder="拉黑原因"
-              value={blockReason}
-            />
-            <Button
-              className="h-9 gap-2"
-              disabled={isSavingBlock}
-              onClick={() => saveBlockEntry()}
-              size="sm"
-            >
-              <Plus className="h-4 w-4" />
-              加入黑名单
-            </Button>
-          </div>
-
-          <div className="grid gap-2 md:grid-cols-2 xl:grid-cols-3">
-            {activeBlocklistEntries.map((entry) => (
-              <div
-                className="rounded-lg border border-red-100 bg-red-50/60 px-3 py-3 dark:border-red-900/60 dark:bg-red-950/30"
-                key={entry.id}
-              >
-                <div className="flex items-start justify-between gap-3">
-                  <div className="min-w-0">
-                    <div className="flex items-center gap-2">
-                      <Ban className="h-4 w-4 text-red-600 dark:text-red-400" />
-                      <span className="truncate font-mono font-semibold text-sm text-red-900 dark:text-red-200">
-                        {entry.ip}
-                      </span>
-                    </div>
-                    <div className="mt-1 line-clamp-2 text-red-800/75 text-xs dark:text-red-300/75">
-                      {entry.reason || "未填写原因"}
-                    </div>
-                    <div className="mt-2 text-red-700/70 text-xs dark:text-red-400/70">
-                      {formatTime(entry.updatedAt)}
-                    </div>
-                  </div>
-                  <Button
-                    className="h-8 shrink-0 gap-1 border-red-200 bg-white text-red-700 hover:bg-red-50 dark:border-red-800 dark:bg-red-950/30 dark:text-red-300 dark:hover:bg-red-950/60"
-                    onClick={() => updateBlockEntry(entry, false)}
-                    size="sm"
-                    variant="outline"
-                  >
-                    <Unlock className="h-3.5 w-3.5" />
-                    解除
-                  </Button>
-                </div>
-              </div>
-            ))}
-            {activeBlocklistEntries.length === 0 ? (
-              <div className="rounded-lg border border-dashed py-8 text-center text-muted-foreground text-sm md:col-span-2 xl:col-span-3">
-                暂无手动拉黑 IP
-              </div>
-            ) : null}
-          </div>
-        </CardContent>
-      </Card>
-
-      <div className="grid gap-4 xl:grid-cols-[minmax(0,1.3fr)_minmax(320px,0.7fr)]">
-        <Card>
-          <CardHeader className="pb-4">
-            <CardTitle className="text-lg">异常 IP 标注</CardTitle>
-            <CardDescription>
-              按限流、失败率、认证异常、敏感路径和请求量综合排序
-            </CardDescription>
-          </CardHeader>
-          <CardContent>
-            <div className="space-y-2">
-              {(data?.topIps || []).map((item) => (
-                <div
-                  className="rounded-lg border bg-background px-4 py-3"
-                  key={item.ip}
-                >
-                  <div className="flex flex-col gap-3 md:flex-row md:items-start md:justify-between">
-                    <div className="min-w-0">
-                      <div className="flex flex-wrap items-center gap-2">
-                        <span className="font-mono font-semibold text-sm">
-                          {item.ip}
-                        </span>
-                        <AccessSeverityBadge severity={item.severity} />
-                      </div>
-                      <div className="mt-2 flex flex-wrap gap-2 text-muted-foreground text-xs">
-                        <span>{formatNumber(item.total)} 次访问</span>
-                        <span>{formatNumber(item.uniqueUsers)} 个用户</span>
-                        <span>失败率 {formatPercent(item.failureRate)}</span>
-                        <span>最近 {formatTime(item.lastSeen)}</span>
-                      </div>
-                    </div>
-                    <div className="flex flex-wrap items-center gap-1 md:justify-end">
-                      {(item.reasons.length > 0 ? item.reasons : ["正常访问"]).map(
-                        (reason) => (
-                          <Badge
-                            className="border-zinc-200 bg-zinc-50 text-zinc-700 dark:border-zinc-700 dark:bg-zinc-900 dark:text-zinc-300"
-                            key={reason}
-                            variant="outline"
-                          >
-                            {reason}
-                          </Badge>
-                        )
-                      )}
-                      <Button
-                        className="h-7 gap-1 px-2 text-xs"
-                        disabled={blockedRules.has(item.ip.toLowerCase()) || isSavingBlock}
-                        onClick={() =>
-                          saveBlockEntry(
-                            item.ip,
-                            item.reasons.join("、") || "管理员从异常 IP 排行手动拉黑"
-                          )
-                        }
-                        size="sm"
-                        variant="outline"
-                      >
-                        <Ban className="h-3.5 w-3.5" />
-                        {blockedRules.has(item.ip.toLowerCase()) ? "已拉黑" : "拉黑"}
-                      </Button>
-                    </div>
-                  </div>
-                </div>
-              ))}
-              {(!data?.topIps || data.topIps.length === 0) && (
-                <div className="rounded-lg border border-dashed py-10 text-center text-muted-foreground text-sm">
-                  暂无 IP 聚合数据
-                </div>
-              )}
-            </div>
-          </CardContent>
-        </Card>
-
-        <Card>
-          <CardHeader className="pb-4">
-            <CardTitle className="text-lg">访问路径</CardTitle>
-            <CardDescription>按请求数量排序</CardDescription>
-          </CardHeader>
-          <CardContent>
-            <div className="space-y-3">
-              {(data?.pathStats || []).map((item) => {
-                const abnormalRate =
-                  item.count > 0 ? item.abnormalCount / item.count : 0;
-                return (
-                  <div key={`${item.routeGroup || "page"}-${item.path || "/"}`}>
-                    <div className="flex items-center justify-between gap-3 text-sm">
-                      <span className="min-w-0 truncate font-medium">
-                        {item.path || "/"}
-                      </span>
-                      <span className="shrink-0 text-muted-foreground text-xs">
-                        {formatNumber(item.count)}
-                      </span>
-                    </div>
-                    <div className="mt-2 h-2 overflow-hidden rounded-full bg-zinc-100 dark:bg-zinc-800">
-                      <div
-                        className="h-full rounded-full bg-zinc-900 dark:bg-zinc-200"
-                        style={{
-                          width: `${Math.max(4, (item.count / maxPathCount) * 100)}%`,
-                        }}
-                      />
-                      <div
-                        className="-mt-2 h-full rounded-full bg-orange-400"
-                        style={{
-                          width: `${Math.round(abnormalRate * 100)}%`,
-                        }}
-                      />
-                    </div>
-                  </div>
-                );
-              })}
-              {(!data?.pathStats || data.pathStats.length === 0) && (
-                <div className="rounded-lg border border-dashed py-10 text-center text-muted-foreground text-sm">
-                  暂无路径统计
-                </div>
-              )}
-            </div>
-          </CardContent>
-        </Card>
-      </div>
-
-      <Card>
-        <CardHeader className="pb-4">
-          <div className="flex flex-col gap-2 sm:flex-row sm:items-center sm:justify-between">
-            <div>
-              <CardTitle className="text-lg">访问日志列表</CardTitle>
-              <CardDescription>最近 {formatNumber(data?.recentEvents.length)} 条</CardDescription>
-            </div>
-            <div className="flex flex-wrap gap-2">
-              {(data?.rules || []).map((rule) => (
-                <Badge
-                  className="border-zinc-200 bg-zinc-50 text-zinc-600 dark:border-zinc-700 dark:bg-zinc-900 dark:text-zinc-300"
-                  key={rule}
-                  variant="outline"
-                >
-                  {rule}
-                </Badge>
-              ))}
-            </div>
-          </div>
-        </CardHeader>
-        <CardContent>
-          <div className="overflow-x-auto rounded-lg border">
-            <div className="min-w-[980px]">
-              <div className="grid grid-cols-[138px_132px_86px_minmax(220px,1fr)_140px_120px] border-b bg-zinc-50 px-4 py-2 font-medium text-muted-foreground text-xs dark:bg-zinc-900/70">
-                <div>时间</div>
-                <div>IP</div>
-                <div>状态</div>
-                <div>路径</div>
-                <div>用户</div>
-                <div>标注</div>
-              </div>
-              {(data?.recentEvents || []).map((event) => (
-                <div
-                  className="grid grid-cols-[138px_132px_86px_minmax(220px,1fr)_140px_120px] items-center border-b px-4 py-3 text-sm last:border-b-0"
-                  key={event.id}
-                >
-                  <div className="text-muted-foreground text-xs">
-                    {formatTime(event.createdAt)}
-                  </div>
-                  <div className="font-mono text-xs">{event.ip}</div>
-                  <div
-                    className={cn(
-                      "font-semibold text-xs",
-                      getStatusClassName(event.statusCode)
-                    )}
-                  >
-                    {event.statusCode || "--"}
-                  </div>
-                  <div className="min-w-0">
-                    <div className="truncate font-medium">
-                      {event.method || "GET"} {event.path || "/"}
-                    </div>
-                    <div className="mt-1 truncate text-muted-foreground text-xs">
-                      {event.reasons?.join("、") || event.outcome}
-                    </div>
-                  </div>
-                  <div className="min-w-0">
-                    <div className="truncate text-xs">
-                      {event.userEmail || "匿名"}
-                    </div>
-                    <div className="mt-1 flex items-center gap-1 text-muted-foreground text-xs">
-                      <UserCheck className="h-3 w-3" />
-                      {event.userRole || "unknown"}
-                    </div>
-                  </div>
-                  <div className="flex items-center gap-2">
-                    {event.severity === "high" || event.severity === "critical" ? (
-                      <AlertTriangle className="h-4 w-4 text-orange-500" />
-                    ) : null}
-                    <AccessSeverityBadge severity={event.severity} />
-                  </div>
-                </div>
-              ))}
-              {(!data?.recentEvents || data.recentEvents.length === 0) && (
-                <div className="py-10 text-center text-muted-foreground text-sm">
-                  暂无访问日志
-                </div>
-              )}
-            </div>
-          </div>
-        </CardContent>
-      </Card>
-    </div>
-  );
-}

app/(admin)/settings/_components/admin-settings-navigation.tsx

@@ -11,9 +11,11 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
-import { ADMIN_SETTINGS_NAV_ITEMS } from "../_lib/settings-navigation";
+import { ADMIN_SETTINGS_NAV_GROUPS } from "../_lib/settings-navigation";
 import type { AdminSettingsNavItem } from "../_lib/types";
 
+const ALL_SETTINGS_ITEMS = ADMIN_SETTINGS_NAV_GROUPS.flatMap((group) => group.items);
+
 function SettingsQuickAction({
   activeTab,
   item,
@@ -31,8 +33,8 @@ function SettingsQuickAction({
       ? "border-foreground/10 bg-foreground text-background shadow-sm hover:!bg-foreground/90 hover:!text-background dark:border-white/20 dark:bg-white dark:text-black dark:hover:!bg-white/90 dark:hover:!text-black"
       : "border-transparent bg-transparent text-muted-foreground hover:!border-border/80 hover:!bg-zinc-100 hover:!text-foreground dark:hover:!bg-zinc-900/50";
   const layoutClassName = stretched
-    ? "h-8 w-full min-w-0 justify-center gap-1.5 rounded-md border px-2.5 text-xs"
+    ? "h-10 w-full min-w-0 justify-center gap-2 rounded-2xl border px-4"
-    : "h-8 shrink-0 gap-1.5 rounded-md border px-2.5 text-xs";
+    : "h-9 shrink-0 gap-2 rounded-full border px-3.5";
 
   if (item.href) {
     return (
@@ -43,7 +45,7 @@ function SettingsQuickAction({
         variant="ghost"
       >
         <Link href={item.href}>
-          <Icon className="h-3.5 w-3.5" />
+          <Icon className="h-4 w-4" />
           <span className={stretched ? "truncate" : ""}>{item.label}</span>
         </Link>
       </Button>
@@ -57,7 +59,7 @@ function SettingsQuickAction({
       size="sm"
       variant="ghost"
     >
-      <Icon className="h-3.5 w-3.5" />
+      <Icon className="h-4 w-4" />
       <span className={stretched ? "truncate" : ""}>{item.label}</span>
     </Button>
   );
@@ -71,13 +73,9 @@ export function AdminSettingsNavigation({
   onTabChange: (value: string) => void;
 }) {
   const router = useRouter();
-  const activeItem = ADMIN_SETTINGS_NAV_ITEMS.find(
+  const activeItem = ALL_SETTINGS_ITEMS.find((item) => item.value === activeTab);
-    (item) => item.value === activeTab
-  );
   const handleSelectChange = (value: string) => {
-    const nextItem = ADMIN_SETTINGS_NAV_ITEMS.find(
+    const nextItem = ALL_SETTINGS_ITEMS.find((item) => item.value === value);
-      (item) => item.value === value
-    );
     if (nextItem?.href) {
       router.push(nextItem.href);
       return;
@@ -86,18 +84,15 @@ export function AdminSettingsNavigation({
   };
 
   return (
-    <nav
+    <div className="rounded-2xl border bg-background px-4 py-3 shadow-sm">
-      aria-label="系统设置导航"
+      <div className="flex flex-col gap-2 md:hidden">
-      className="sticky top-2 z-30 rounded-lg border bg-background/95 p-2 shadow-sm backdrop-blur supports-[backdrop-filter]:bg-background/85"
-    >
-      <div className="md:hidden">
         <div className="flex items-center gap-2">
           <Select onValueChange={handleSelectChange} value={activeTab}>
-            <SelectTrigger className="h-8 flex-1 border-border/70 bg-background shadow-none">
+            <SelectTrigger className="h-9 flex-1 border-border/70 bg-background shadow-none">
               <SelectValue placeholder={activeItem?.label || "选择设置项"} />
             </SelectTrigger>
             <SelectContent>
-              {ADMIN_SETTINGS_NAV_ITEMS.map((item) => (
+              {ALL_SETTINGS_ITEMS.map((item) => (
                 <SelectItem key={item.value} value={item.value}>
                   {item.label}
                 </SelectItem>
@@ -107,7 +102,7 @@ export function AdminSettingsNavigation({
 
           <Button
             asChild
-            className="h-8 rounded-md border-border/70 px-2.5 text-xs"
+            className="h-9 rounded-full border-border/70 px-3 text-[13px]"
             size="sm"
             variant="outline"
           >
@@ -118,22 +113,35 @@ export function AdminSettingsNavigation({
           </Button>
         </div>
 
+        <div className="flex flex-wrap gap-1">
+          {ALL_SETTINGS_ITEMS.map((item) => (
+            <SettingsQuickAction
+              activeTab={activeTab}
+              item={item}
+              key={item.value}
+              onTabChange={onTabChange}
+            />
+          ))}
+        </div>
       </div>
 
-      <div className="hidden min-w-0 grid-cols-7 gap-1 md:grid xl:grid-cols-[repeat(13,minmax(78px,1fr))_auto]">
+      <div className="hidden min-w-0 items-center gap-3 md:flex">
-        {ADMIN_SETTINGS_NAV_ITEMS.map((item) => (
+        <div className="flex min-w-0 flex-1 items-center gap-2 overflow-x-auto">
-          <SettingsQuickAction
+          {ALL_SETTINGS_ITEMS.map((item) => (
-            activeTab={activeTab}
+            <div className="min-w-[118px] flex-1" key={item.value}>
-            item={item}
+              <SettingsQuickAction
-            key={item.value}
+                activeTab={activeTab}
-            onTabChange={onTabChange}
+                item={item}
-            stretched
+                onTabChange={onTabChange}
-          />
+                stretched
-        ))}
+              />
+            </div>
+          ))}
+        </div>
 
         <Button
           asChild
-          className="h-8 min-w-0 rounded-md border-border/70 px-2.5 text-xs"
+          className="h-9 shrink-0 rounded-full border-border/70 px-3.5 text-[13px]"
           size="sm"
           variant="outline"
         >
@@ -143,6 +151,6 @@ export function AdminSettingsNavigation({
           </Link>
         </Button>
       </div>
-    </nav>
+    </div>
   );
 }

app/(admin)/settings/_components/local-ai-command-center.tsx

@@ -26,22 +26,22 @@ export function LocalAiCommandCenter({
   onSetAllExpanded: (expanded: boolean) => void;
 }) {
   return (
-    <div className="overflow-hidden rounded-lg border bg-background">
+    <div className="overflow-hidden rounded-xl border bg-background">
-      <div className="border-b bg-muted/20 px-4 py-3">
+      <div className="border-b bg-muted/20 px-5 py-4">
-        <div className="flex flex-col gap-2.5 lg:flex-row lg:items-start lg:justify-between">
+        <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
-          <div className="space-y-1">
+          <div className="space-y-1.5">
-            <div className="font-semibold text-[10px] text-muted-foreground">
+            <div className="font-semibold text-muted-foreground text-xs">
               SYSTEM INTEGRATIONS
             </div>
-            <h2 className="font-semibold text-lg">
+            <h2 className="font-semibold text-2xl tracking-normal">
               高级能力与外部服务
             </h2>
-            <p className="max-w-3xl text-muted-foreground text-xs leading-5">
+            <p className="max-w-3xl text-muted-foreground text-sm leading-6">
               把商品策划、图像处理、3D/CAD、实时画布和开放 API
               按运维任务重新归类。折叠状态会保留，常用模块可以保持展开。
             </p>
           </div>
-          <div className="flex flex-wrap gap-1.5">
+          <div className="flex flex-wrap gap-2">
             <SettingStatusBadge tone="neutral">
               已展开 {openSectionCount} 个模块
             </SettingStatusBadge>
@@ -52,7 +52,7 @@ export function LocalAiCommandCenter({
               模型 {modelCount}
             </SettingStatusBadge>
             <Button
-              className="h-6 rounded-md px-2 text-[11px]"
+              className="h-7 rounded-md px-2 text-xs"
               onClick={() => onSetAllExpanded(true)}
               size="sm"
               type="button"
@@ -61,7 +61,7 @@ export function LocalAiCommandCenter({
               全部展开
             </Button>
             <Button
-              className="h-6 rounded-md px-2 text-[11px]"
+              className="h-7 rounded-md px-2 text-xs"
               onClick={() => onSetAllExpanded(false)}
               size="sm"
               type="button"
@@ -77,21 +77,21 @@ export function LocalAiCommandCenter({
           const Icon = item.icon;
           return (
             <button
-              className="group bg-background p-3 text-left transition-colors hover:bg-muted/30"
+              className="group bg-background p-4 text-left transition-colors hover:bg-muted/30"
               key={item.key}
               onClick={() => onFocusSection(item.key)}
               type="button"
             >
               <div className="flex items-start justify-between gap-3">
                 <div className="flex min-w-0 items-center gap-2">
-                  <div className="flex h-7 w-7 shrink-0 items-center justify-center rounded-md border bg-muted/30">
+                  <div className="flex h-8 w-8 shrink-0 items-center justify-center rounded-md border bg-muted/30">
-                    <Icon className="h-3.5 w-3.5 text-muted-foreground" />
+                    <Icon className="h-4 w-4 text-muted-foreground" />
                   </div>
                   <div className="min-w-0">
-                    <div className="truncate font-semibold text-xs">
+                    <div className="truncate font-semibold text-sm">
                       {item.title}
                     </div>
-                    <div className="mt-0.5 truncate text-[11px] text-muted-foreground">
+                    <div className="mt-0.5 truncate text-muted-foreground text-xs">
                       {item.description}
                     </div>
                   </div>
@@ -104,20 +104,20 @@ export function LocalAiCommandCenter({
           );
         })}
       </div>
-      <div className="border-t bg-muted/10 px-4 py-3">
+      <div className="border-t bg-muted/10 px-5 py-4">
-        <div className="grid gap-3 lg:grid-cols-4">
+        <div className="grid gap-4 lg:grid-cols-4">
           {LOCAL_AI_QUICK_LINK_GROUPS.map((group) => (
-            <div className="space-y-1.5" key={group}>
+            <div className="space-y-2" key={group}>
-              <div className="font-semibold text-[11px] text-muted-foreground">
+              <div className="font-semibold text-muted-foreground text-xs">
                 {group}
               </div>
-              <div className="flex flex-wrap gap-1.5">
+              <div className="flex flex-wrap gap-2">
                 {quickLinks
                   .filter((item) => item.group === group)
                   .map((item) => (
                     <button
                       className={cn(
-                        "inline-flex h-6 items-center gap-1 rounded-md border px-2 text-[11px] transition-colors hover:bg-background",
+                        "inline-flex h-7 items-center gap-1.5 rounded-md border px-2 text-xs transition-colors hover:bg-background",
                         isSectionExpanded(item.key)
                           ? "border-foreground/20 bg-background text-foreground"
                           : "border-border bg-transparent text-muted-foreground"

app/(admin)/settings/_components/local-ai-section-shell.tsx

@@ -24,13 +24,13 @@ export function LocalAiGroupHeading({
   description: string;
 }) {
   return (
-    <div className="rounded-lg border bg-muted/20 px-3 py-2.5">
+    <div className="rounded-lg border bg-muted/20 px-4 py-3">
-      <div className="font-semibold text-[10px] text-muted-foreground uppercase">
+      <div className="font-semibold text-[11px] text-muted-foreground uppercase tracking-[0.16em]">
         {eyebrow}
       </div>
       <div className="mt-1 flex flex-col gap-1 md:flex-row md:items-end md:justify-between">
-        <h3 className="font-semibold text-sm text-foreground">{title}</h3>
+        <h3 className="font-semibold text-base text-foreground">{title}</h3>
-        <p className="max-w-3xl text-muted-foreground text-xs">{description}</p>
+        <p className="max-w-3xl text-muted-foreground text-sm">{description}</p>
       </div>
     </div>
   );
@@ -45,7 +45,7 @@ export function LocalAiSectionSummary({
   }>;
 }) {
   return (
-    <div className="flex flex-wrap gap-1.5 pt-1">
+    <div className="flex flex-wrap gap-2 pt-1">
       {items.map((item) => (
         <SettingStatusBadge key={item.label} tone={item.tone || "neutral"}>
           {item.label}
@@ -65,16 +65,16 @@ export function LocalAiSectionToggleButton({
   return (
     <Button
       aria-expanded={expanded}
-      className="h-7 shrink-0 gap-1 rounded-md px-2 text-[11px]"
+      className="h-8 shrink-0 gap-1.5 rounded-md px-2.5 text-xs"
       onClick={onClick}
       size="sm"
       type="button"
       variant="outline"
     >
       {expanded ? (
-        <ArrowUp className="h-3 w-3" />
+        <ArrowUp className="h-3.5 w-3.5" />
       ) : (
-        <ArrowDown className="h-3 w-3" />
+        <ArrowDown className="h-3.5 w-3.5" />
       )}
       {expanded ? "收起配置" : "展开配置"}
     </Button>
@@ -100,9 +100,9 @@ export function LocalAiSectionShell({
 }) {
   return (
     <Card id={id}>
-      <CardHeader className="flex flex-col gap-3 space-y-0 md:flex-row md:items-start md:justify-between">
+      <CardHeader className="flex flex-col gap-4 space-y-0 md:flex-row md:items-start md:justify-between">
-        <div className="space-y-1">
+        <div className="space-y-1.5">
-          <CardTitle className="text-base">{title}</CardTitle>
+          <CardTitle className="text-xl">{title}</CardTitle>
           <CardDescription>{description}</CardDescription>
           {summary}
         </div>
@@ -110,7 +110,7 @@ export function LocalAiSectionShell({
       </CardHeader>
       <CardContent
         className={cn(
-          "local-ai-config-card-content space-y-4 pt-4",
+          "local-ai-config-card-content space-y-6 pt-6",
           !expanded && "hidden"
         )}
       >

app/(admin)/settings/_components/local-ai-sections/image-pipeline-sections.tsx

@@ -665,7 +665,7 @@ export function LocalAiImagePipelineSections({
                 </p>
                 <p>• 支持的图片格式：JPG, JPEG, PNG, BMP, WEBP, TIFF等</p>
                 <p>
-                  • 图片大小：不超过20MB，不限制分辨率（建议按业务需求控制尺寸）
+                  • 图片大小：不超过50MB，不限制分辨率（建议按业务需求控制尺寸）
                 </p>
                 <p>• 返回的链接有效期为1小时，系统会自动下载并存储到S3</p>
               </div>
@@ -784,7 +784,7 @@ export function LocalAiImagePipelineSections({
                 <p>• 支持2x、4x、8x放大倍数</p>
                 <p>• 处理时间：通常1-10秒，取决于图片大小</p>
                 <p>• 支持格式：JPG, PNG, JPEG等常见图片格式</p>
-                <p>• 文件限制：最大20MB</p>
+                <p>• 文件限制：最大50MB</p>
               </div>
             </div>
           </>
@@ -2377,12 +2377,13 @@ export function LocalAiImagePipelineSections({
             items={[
               {
                 label:
-                  extendConfig.provider === "fal"
+                  extendConfig.provider === "vip98k" || extendConfig.apiKey
-                    ? "fal · FLUX 2 Pro 扩图"
+                    ? "Key 已配置"
-                    : extendConfig.provider === "vip98k"
+                    : "Key 待配置",
-                    ? `98K · ${extendConfig.modelId || "image-expansion"}`
+                tone:
-                    : "阿里云服务商",
+                  extendConfig.provider === "vip98k" || extendConfig.apiKey
-                tone: "enabled",
+                    ? "enabled"
+                    : "warning",
               },
               {
                 label: `${extendConfig.xScale}x / ${extendConfig.yScale}x`,
@@ -2393,21 +2394,28 @@ export function LocalAiImagePipelineSections({
         }
         title="图像拓展API配置"
       >
-        {extendConfig.provider === "fal" ? (
+        {extendConfig.provider === "vip98k" ? (
           <div className="rounded-lg border bg-muted/40 p-4 text-sm">
-            使用 FLUX 2 Pro Outpaint 扩展图片。密钥从已启用的 fal 官方服务商读取。
+            使用 VIP98K 的 image-expansion 模型。API Key 从“AI 模型设置”中的
-          </div>
-        ) : extendConfig.provider === "vip98k" ? (
-          <div className="rounded-lg border bg-muted/40 p-4 text-sm">
-            使用 98K 的 {extendConfig.modelId || "image-expansion"} 模型。API Key 从“AI 模型设置”中的
             VIP98K 服务商读取，仅在这里维护扩展比例。
           </div>
         ) : (
-          <div className="rounded-lg border bg-muted/40 p-4 text-sm">
+        <div className="space-y-2">
-            使用阿里云 DashScope 的 image-out-painting 模型。API Key
+          <Label htmlFor="extendApiKey">API密钥 *</Label>
-            从“AI 模型设置”中已启用的阿里云官方生图服务商读取，
+          <Input
-            仅在这里维护拓展比例。
+            id="extendApiKey"
+            onChange={(e) =>
+              setExtendConfig({ ...extendConfig, apiKey: e.target.value })
+            }
+            placeholder="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+            type="password"
+            value={extendConfig.apiKey}
+          />
+          <div className="text-muted-foreground text-xs">
+            请输入阿里云Dashscope API密钥，例如:
+            sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
           </div>
+        </div>
         )}
         <div className="grid grid-cols-2 gap-4">
           <div className="space-y-2">
@@ -2462,7 +2470,7 @@ export function LocalAiImagePipelineSections({
               https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/out-painting
             </p>
             <p>• 支持的图片格式：JPG, PNG, WebP等常见格式</p>
-            <p>• 最大图片大小：10MB</p>
+            <p>• 最大图片大小：4MB</p>
             <p>• 处理时间：约5-15秒/张</p>
             <p>• 放大倍数范围：1.0-2.0（推荐1.5倍等比例扩展）</p>
           </div>

app/(admin)/settings/_components/local-ai-sections/model3d-sections.tsx

@@ -916,8 +916,8 @@ export function LocalAiModel3dSections({
       <LocalAiSectionShell
         description={
           <>
-            配置官方 HiCAD 使用的 KittyCAD / Zoo 服务，保存后写入数据库 AI
+            配置 AI-CAD 页面后续接入的 KittyCAD / Zoo Text-to-CAD
-            提供商配置。
+            服务，保存后写入数据库 AI 提供商配置。
           </>
         }
         expanded={isLocalAiSectionExpanded("kittycad-cad")}
@@ -1003,7 +1003,7 @@ export function LocalAiModel3dSections({
           <div className="space-y-0.5">
             <Label className="text-sm">启用 KittyCAD CAD</Label>
             <div className="text-muted-foreground text-xs">
-              关闭后 HiCAD 将无法连接 Zoo 建模和 AI 助手服务
+              关闭后 AI-CAD 页面将无法切换到外部 CAD 服务
             </div>
           </div>
           <div className="flex items-center gap-2">

app/(admin)/settings/_components/local-ai-sections/planning-sections.tsx

@@ -590,7 +590,7 @@ export function LocalAiPlanningSections({
       <LocalAiSectionShell
         description={
           <>
-            为 AI详情生成 单独配置 Kimi Code 编程套餐
+            为 AI详情生成 单独配置 Moonshot 官方 Kimi K2.6
             模型。保存后会自动绑定到“AI详情生成 - Agent专用模型”。
           </>
         }
@@ -615,7 +615,7 @@ export function LocalAiPlanningSections({
             ]}
           />
         }
-        title={<>Kimi Code 编程套餐配置</>}
+        title={<>Moonshot 官方 Kimi K2.6 配置</>}
       >
         <div className="space-y-2">
           <Label htmlFor="moonshotProviderName">提供商名称</Label>
@@ -627,13 +627,13 @@ export function LocalAiPlanningSections({
                 providerName: e.target.value,
               }))
             }
-            placeholder="Kimi Code 编程套餐"
+            placeholder="Moonshot AI (Official)"
             value={moonshotDetailAgentConfig.providerName}
           />
         </div>
 
         <div className="space-y-2">
-          <Label htmlFor="moonshotBaseUrl">编程套餐专用 API 地址</Label>
+          <Label htmlFor="moonshotBaseUrl">官方 API 地址</Label>
           <Input
             id="moonshotBaseUrl"
             onChange={(e) =>
@@ -646,7 +646,7 @@ export function LocalAiPlanningSections({
             value={moonshotDetailAgentConfig.baseUrl}
           />
           <div className="text-muted-foreground text-xs">
-            根据 Kimi Code 文档，编程套餐 OpenAI 兼容接口地址为 `
+            根据 Moonshot 官方文档，OpenAI 兼容接口地址为 `
             {DETAIL_AGENT_LOCAL_MOONSHOT_BASE_URL}`
           </div>
         </div>
@@ -667,7 +667,7 @@ export function LocalAiPlanningSections({
             placeholder={
               moonshotDetailAgentConfig.providerId
                 ? "留空则不修改当前 Key"
-                : "请输入 Kimi Code 控制台 API Key"
+                : "请输入 Moonshot 官方 API Key"
             }
             type="password"
             value={moonshotDetailAgentConfig.apiKey}
@@ -675,7 +675,7 @@ export function LocalAiPlanningSections({
         </div>
 
         <div className="space-y-2">
-          <Label htmlFor="moonshotModelId">Kimi Code API 模型 ID *</Label>
+          <Label htmlFor="moonshotModelId">Kimi K2.6 API 模型 ID *</Label>
           <Input
             id="moonshotModelId"
             onChange={(e) =>
@@ -688,8 +688,8 @@ export function LocalAiPlanningSections({
             value={moonshotDetailAgentConfig.modelId}
           />
           <div className="text-muted-foreground text-xs">
-            Kimi Code 编程套餐专用接口固定使用
+            已按你提供的 Moonshot 官方文档默认填写
-            `kimi-for-coding`；保存后系统会自动创建/更新对应模型记录。
+            `kimi-k2.6`；保存后系统会自动创建/更新对应模型记录。
           </div>
         </div>
 
@@ -745,7 +745,7 @@ export function LocalAiPlanningSections({
         <div className="flex justify-end">
           <Button onClick={handleSaveMoonshotDetailAgentConfig}>
             <Save className="mr-2 h-4 w-4" />
-            保存 Kimi Code 编程套餐配置
+            保存 Moonshot Kimi K2.6 配置
           </Button>
         </div>
       </LocalAiSectionShell>

app/(admin)/settings/_components/local-ai-sections/runtime-sections.tsx

@@ -1078,15 +1078,139 @@ export function LocalAiRuntimeSections({
         </Button>
       </LocalAiSectionShell>
 
+      {/* 全站生图单模型并发 */}
       <LocalAiSectionShell
-        description="生图任务直接发起，图片先显示，后台转存到存储桶。"
+        description={
+          <>
+            控制全站生图链路中，同一个模型允许同时运行的任务数，以及排队后下一批任务的发起间隔。配置保存到数据库，异步队列和直调生成都会自动读取，无需重启服务。
+          </>
+        }
         expanded={isLocalAiSectionExpanded("canvas-image-task-queue")}
         id="local-ai-section-canvas-image-task-queue"
         onToggle={() => toggleLocalAiSection("canvas-image-task-queue")}
-        summary={<LocalAiSectionSummary items={[{ label: "并发不限", tone: "enabled" }, { label: "即时发起", tone: "enabled" }]} />}
+        summary={
-        title={<span className="flex items-center gap-2"><ImageIcon className="h-5 w-5" />生图任务执行</span>}
+          <LocalAiSectionSummary
+            items={[
+              {
+                label: `${canvasImageTaskQueueConfig.concurrency} 并发/模型`,
+                tone: "neutral",
+              },
+              {
+                label: `${(
+                  canvasImageTaskQueueConfig.batchDispatchIntervalMs / 1000
+                ).toFixed(1)} 秒补位`,
+                tone: "neutral",
+              },
+              { label: "全站生图生效", tone: "enabled" },
+            ]}
+          />
+        }
+        title={
+          <span className="flex items-center gap-2">
+            <ImageIcon className="h-5 w-5" />
+            全站生图单模型并发与批次间隔
+          </span>
+        }
       >
-        <p className="text-muted-foreground text-sm">已取消模型及单用户并发限制，任务无需等待其他图片生成完成。任务状态、超时处理和失败重试继续保留。</p>
+        <div className="grid gap-6 lg:grid-cols-[minmax(0,1fr)_minmax(220px,320px)]">
+          <div className="rounded-lg border border-amber-200 bg-amber-50 p-4 text-amber-900 text-sm">
+            <div className="font-medium">生效范围</div>
+            <div className="mt-2 space-y-1 text-amber-800 text-xs leading-5">
+              <p>
+                •
+                影响画布异步生图、智能体直调生图、视频分镜高清预览等全站生图入口。
+              </p>
+              <p>
+                •
+                多用户共享同一套并发限制，但会按模型分别计数，不同模型之间不再互相阻塞。
+              </p>
+              <p>
+                • 当前配置的是单模型并发，不是全站总并发，也不是单用户并发。
+              </p>
+              <p>
+                •
+                批次间隔只控制排队补位的“下一批”发起节奏，不影响首批任务即时启动。
+              </p>
+              <p>
+                • 数值过高可能触发上游模型 429、超时或 504，建议配合模型 Key
+                池继续细分。
+              </p>
+            </div>
+          </div>
+
+          <div className="space-y-4">
+            <div className="space-y-2">
+              <Label htmlFor="canvasImageTaskQueueConcurrency">
+                单模型最大同时运行任务数
+              </Label>
+              <Input
+                id="canvasImageTaskQueueConcurrency"
+                max={MAX_CANVAS_IMAGE_TASK_CONCURRENCY}
+                min={MIN_CANVAS_IMAGE_TASK_CONCURRENCY}
+                onChange={(e) =>
+                  setCanvasImageTaskQueueConfig(
+                    normalizeCanvasImageTaskQueueConfig({
+                      ...canvasImageTaskQueueConfig,
+                      concurrency: e.target.value,
+                    })
+                  )
+                }
+                type="number"
+                value={canvasImageTaskQueueConfig.concurrency}
+              />
+              <div className="text-muted-foreground text-xs">
+                可配置范围 {MIN_CANVAS_IMAGE_TASK_CONCURRENCY}-
+                {MAX_CANVAS_IMAGE_TASK_CONCURRENCY}，当前为{" "}
+                {canvasImageTaskQueueConfig.concurrency} 并发，默认值为{" "}
+                {DEFAULT_CANVAS_IMAGE_TASK_CONCURRENCY}。
+              </div>
+            </div>
+
+            <div className="space-y-2">
+              <Label htmlFor="canvasImageTaskBatchDispatchIntervalSeconds">
+                下一批排队任务发起间隔（秒）
+              </Label>
+              <Input
+                id="canvasImageTaskBatchDispatchIntervalSeconds"
+                max={MAX_CANVAS_IMAGE_BATCH_DISPATCH_INTERVAL_MS / 1000}
+                min={MIN_CANVAS_IMAGE_BATCH_DISPATCH_INTERVAL_MS / 1000}
+                onChange={(e) =>
+                  setCanvasImageTaskQueueConfig(
+                    normalizeCanvasImageTaskQueueConfig({
+                      ...canvasImageTaskQueueConfig,
+                      batchDispatchIntervalMs: Math.round(
+                        Number.parseFloat(e.target.value || "0") * 1000
+                      ),
+                    })
+                  )
+                }
+                step="0.5"
+                type="number"
+                value={String(
+                  canvasImageTaskQueueConfig.batchDispatchIntervalMs / 1000
+                )}
+              />
+              <div className="text-muted-foreground text-xs">
+                可配置范围 {MIN_CANVAS_IMAGE_BATCH_DISPATCH_INTERVAL_MS / 1000}-
+                {MAX_CANVAS_IMAGE_BATCH_DISPATCH_INTERVAL_MS / 1000} 秒，当前为{" "}
+                {(
+                  canvasImageTaskQueueConfig.batchDispatchIntervalMs / 1000
+                ).toFixed(1)}{" "}
+                秒，默认值为{" "}
+                {(
+                  DEFAULT_CANVAS_IMAGE_BATCH_DISPATCH_INTERVAL_MS / 1000
+                ).toFixed(1)}{" "}
+                秒。
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <div className="flex justify-end">
+          <Button onClick={handleSaveCanvasImageTaskQueueConfig}>
+            <Save className="mr-2 h-4 w-4" /> 保存并发与间隔
+          </Button>
+        </div>
       </LocalAiSectionShell>
 
       {/* 批量处理配置 */}

app/(admin)/settings/_components/setting-status-badge.tsx

@@ -15,7 +15,7 @@ export function SettingStatusBadge({
   return (
     <Badge
       className={cn(
-        "h-5 rounded-md border px-1.5 font-medium text-[10px]",
+        "h-6 rounded-md border px-2 font-medium text-[11px]",
         tone === "enabled" &&
           "border-emerald-200 bg-emerald-50 text-emerald-700",
         tone === "disabled" && "border-zinc-200 bg-zinc-50 text-zinc-500",

app/(admin)/settings/_lib/settings-navigation.ts

@@ -9,7 +9,6 @@ import {
   MessageSquare,
   Scissors,
   Settings,
-  ShieldAlert,
   Sparkles,
   User,
 } from "lucide-react";
@@ -38,12 +37,6 @@ export const ADMIN_SETTINGS_NAV_GROUPS: AdminSettingsNavGroup[] = [
         description: "用量、趋势与运营指标",
         icon: BarChart3,
       },
-      {
-        value: "access-security",
-        label: "访问安全",
-        description: "访问 IP、异常标注与登录来源",
-        icon: ShieldAlert,
-      },
     ],
   },
   {
@@ -114,7 +107,3 @@ export const ADMIN_SETTINGS_NAV_GROUPS: AdminSettingsNavGroup[] = [
     ],
   },
 ];
-
-export const ADMIN_SETTINGS_NAV_ITEMS = ADMIN_SETTINGS_NAV_GROUPS.flatMap(
-  (group) => group.items
-);

app/(admin)/settings/_lib/types.ts

@@ -274,9 +274,8 @@ export type EnhanceConfig = {
 };
 
 export type ExtendConfig = {
-  provider: "vip98k" | "dashscope" | "fal";
+  provider: "vip98k" | "dashscope";
-  modelId: string;
+  apiKey: string;
-  routeOptionId: string;
   xScale: string;
   yScale: string;
 };

app/(admin)/settings/agent-workflow/agent-workflow-settings-client.tsx

@@ -5933,7 +5933,7 @@ export function AgentWorkflowSettingsClient({
 
   if (isLoading) {
     return (
-      <div className="settings-workspace container mx-auto p-4">
+      <div className="container mx-auto p-6">
         <div className="flex h-[60vh] items-center justify-center">
           <div className="flex items-center gap-3 text-muted-foreground">
             <Loader2 className="h-5 w-5 animate-spin" />
@@ -5945,18 +5945,18 @@ export function AgentWorkflowSettingsClient({
   }
 
   return (
-    <div className="settings-workspace min-h-screen bg-muted/10">
+    <div className="min-h-screen bg-gradient-to-b from-background to-muted/20">
       {/* Header */}
       <header className="sticky top-0 z-30 border-b bg-background/95 backdrop-blur supports-[backdrop-filter]:bg-background/60">
-        <div className="container mx-auto px-4 py-3 sm:px-5">
+        <div className="container mx-auto px-6 py-4">
-          <div className="flex flex-wrap items-center justify-between gap-3">
+          <div className="flex flex-wrap items-center justify-between gap-4">
-            <div className="flex items-center gap-3">
+            <div className="flex items-center gap-4">
-              <div className="flex h-8 w-8 items-center justify-center rounded-lg bg-foreground">
+              <div className="flex h-10 w-10 items-center justify-center rounded-xl bg-gradient-to-br from-violet-500 to-purple-600 shadow-lg shadow-violet-500/20">
-                <Sparkles className="h-4 w-4 text-background" />
+                <Sparkles className="h-5 w-5 text-white" />
               </div>
               <div>
-                <h1 className="text-base font-semibold">风格化工作流配置</h1>
+                <h1 className="text-xl font-semibold tracking-tight">风格化工作流配置</h1>
-                <p className="text-xs text-muted-foreground">
+                <p className="text-sm text-muted-foreground">
                   配置风格化页面的视频海报、素材搜索、品牌模特及工作流步骤
                 </p>
               </div>
@@ -6006,6 +6006,7 @@ export function AgentWorkflowSettingsClient({
                 onClick={handleSave} 
                 disabled={isSaving}
                 size="sm"
+                className="bg-gradient-to-r from-violet-600 to-purple-600 hover:from-violet-500 hover:to-purple-500"
               >
                 {isSaving ? (
                   <Loader2 className="mr-2 h-4 w-4 animate-spin" />
@@ -6141,8 +6142,8 @@ export function AgentWorkflowSettingsClient({
 
       {/* Stats Bar */}
       <div className="border-b bg-muted/30">
-        <div className="container mx-auto px-4 py-2.5 sm:px-5">
+        <div className="container mx-auto px-6 py-3">
-          <div className="flex flex-wrap items-center gap-3">
+          <div className="flex flex-wrap items-center gap-6">
             <div className="flex items-center gap-2">
               <Badge variant="secondary" className="font-mono">
                 {enabledStepsCount}
@@ -6196,8 +6197,8 @@ export function AgentWorkflowSettingsClient({
       </div>
 
       {/* Main Content */}
-      <main className="container mx-auto p-4 sm:px-5">
+      <main className="container mx-auto p-6">
-        <Tabs value={activeTab} onValueChange={setActiveTab} className="space-y-4">
+        <Tabs value={activeTab} onValueChange={setActiveTab} className="space-y-6">
           <TabsList className="grid w-full grid-cols-5 lg:w-fit">
             <TabsTrigger value="showcase" className="gap-2">
               <MonitorPlay className="h-4 w-4" />

app/(admin)/settings/agent-workflow/psd-templates/psd-templates-settings-client.tsx

@@ -2430,17 +2430,17 @@ export function PsdTemplatesSettingsClient({
   );
 
   return (
-    <div className="settings-workspace min-h-screen bg-muted/10">
+    <div className="min-h-screen bg-gradient-to-b from-background to-muted/20">
       <header className="sticky top-0 z-30 border-b bg-background/95 backdrop-blur supports-[backdrop-filter]:bg-background/60">
-        <div className="container mx-auto px-4 py-3 sm:px-5">
+        <div className="container mx-auto px-6 py-4">
-          <div className="flex flex-wrap items-center justify-between gap-3">
+          <div className="flex flex-wrap items-center justify-between gap-4">
-            <div className="flex items-center gap-3">
+            <div className="flex items-center gap-4">
-              <div className="flex h-8 w-8 items-center justify-center rounded-lg bg-foreground">
+              <div className="flex h-10 w-10 items-center justify-center rounded-xl bg-gradient-to-br from-orange-500 to-rose-600 shadow-lg shadow-orange-500/20">
-                <Sparkles className="h-4 w-4 text-background" />
+                <Sparkles className="h-5 w-5 text-white" />
               </div>
               <div>
-                <h1 className="text-base font-semibold">PSD 模板配置</h1>
+                <h1 className="text-xl font-semibold tracking-tight">PSD 模板配置</h1>
-                <p className="text-xs text-muted-foreground">
+                <p className="text-sm text-muted-foreground">
                   上传 PSD 模板、管理字体库、配置图片和文字槽位，并在风格化结果区直接套版导出
                 </p>
               </div>
@@ -2457,6 +2457,7 @@ export function PsdTemplatesSettingsClient({
                 onClick={handleSaveTemplate}
                 disabled={!draftTemplate || isSaving}
                 size="sm"
+                className="bg-gradient-to-r from-orange-600 to-rose-600 hover:from-orange-500 hover:to-rose-500"
               >
                 {isSaving ? (
                   <Loader2 className="mr-2 h-4 w-4 animate-spin" />
@@ -2471,8 +2472,8 @@ export function PsdTemplatesSettingsClient({
       </header>
 
       <div className="border-b bg-muted/30">
-        <div className="container mx-auto px-4 py-2.5 sm:px-5">
+        <div className="container mx-auto px-6 py-3">
-          <div className="flex flex-wrap items-center gap-3">
+          <div className="flex flex-wrap items-center gap-4">
             <Badge variant="secondary" className="font-mono">
               {templates.length}
             </Badge>
@@ -2508,8 +2509,8 @@ export function PsdTemplatesSettingsClient({
         </div>
       </div>
 
-      <div className="container mx-auto px-4 py-4 sm:px-5">
+      <div className="container mx-auto px-6 py-6">
-        <div className="space-y-4">
+        <div className="space-y-6">
           <Card>
             <CardHeader>
               <CardTitle className="text-base">品类标签</CardTitle>

app/(admin)/settings/style-pro/style-pro-settings-client.tsx

@@ -1,7 +1,7 @@
 "use client";
 
-import { Plus, Save, Trash2, Wand2 } from "lucide-react";
+import Link from "next/link";
-import { useRouter } from "next/navigation";
+import { ArrowLeft, Plus, Save, Trash2, Wand2 } from "lucide-react";
 import { useEffect, useMemo, useState } from "react";
 import useSWR from "swr";
 import { toast } from "sonner";
@@ -25,7 +25,6 @@ import {
 import { Switch } from "@/components/ui/switch";
 import { Textarea } from "@/components/ui/textarea";
 import { fetcher } from "@/lib/utils";
-import { AdminSettingsNavigation } from "../_components/admin-settings-navigation";
 import {
   STYLE_PRO_CONFIG_KEY,
   defaultStyleProConfig,
@@ -323,7 +322,6 @@ function CustomFieldEditor({
 }
 
 export function StyleProSettingsClient() {
-  const router = useRouter();
   const { data, mutate } = useSWR<SettingsResponse>(
     `/api/admin/settings?key=${STYLE_PRO_CONFIG_KEY}`,
     fetcher
@@ -563,17 +561,19 @@ export function StyleProSettingsClient() {
   };
 
   return (
-    <div className="settings-workspace w-full px-3 py-3 sm:px-4 xl:px-5">
+    <main className="mx-auto flex w-full max-w-7xl flex-col gap-6 px-6 py-8">
-      <AdminSettingsNavigation
+      <div className="flex flex-col gap-4 md:flex-row md:items-start md:justify-between">
-        activeTab="style-pro"
-        onTabChange={(value) => router.push(`/settings?tab=${value}`)}
-      />
-
-      <main className="mt-6 flex w-full flex-col gap-4">
-        <div className="flex flex-col gap-3 md:flex-row md:items-start md:justify-between">
         <div>
-          <h1 className="font-semibold text-xl">风格化 PRO 设置</h1>
+          <div className="mb-3">
-          <p className="mt-1 max-w-2xl text-muted-foreground text-xs leading-5">
+            <Button asChild variant="outline">
+              <Link href="/settings">
+                <ArrowLeft className="mr-2 h-4 w-4" />
+                返回设置
+              </Link>
+            </Button>
+          </div>
+          <h1 className="font-semibold text-3xl tracking-tight">风格化 PRO 设置</h1>
+          <p className="mt-2 max-w-2xl text-muted-foreground">
             配置无限画布里的风格化 PRO 子页面。用户只看到分类和按钮名称，隐藏提示词和模型只在服务端生成时使用。
           </p>
         </div>
@@ -592,7 +592,7 @@ export function StyleProSettingsClient() {
             {saving ? "保存中" : "保存配置"}
           </Button>
         </div>
-        </div>
+      </div>
 
       <Card>
         <CardHeader>
@@ -1193,7 +1193,6 @@ export function StyleProSettingsClient() {
           ))}
         </CardContent>
       </Card>
-      </main>
+    </main>
-    </div>
   );
 }

app/(auth)/auth.ts

@@ -17,7 +17,6 @@ import {
   requiresSingleActiveSession,
   revokeSingleActiveSession,
 } from "@/lib/auth/session-control";
-import { recordAccessIpEventFromHeaders } from "@/lib/security/access-log";
 
 export type UserType = "guest" | "regular" | "admin" | "agent_admin";
 
@@ -201,10 +200,7 @@ async function resolveRuntimeAuthUrl(settingsAuthUrl?: string | null) {
 }
 
 const nextAuth = NextAuth(async () => {
-  const runtimeAuthSettings =
+  const runtimeAuthSettings = await getAuthSettings().catch(() => null as any);
-    process.env.CANVAS_E2E_LOCAL === "true"
-      ? null
-      : await getAuthSettings().catch(() => null as any);
   const resolvedAuthUrl =
     (await resolveRuntimeAuthUrl(runtimeAuthSettings?.authUrl)) || undefined;
   const googleClientId =
@@ -287,32 +283,6 @@ const nextAuth = NextAuth(async () => {
           delete token.sessionKey;
         }
 
-        if (account && resolvedUserId) {
-          await recordAccessIpEventFromHeaders({
-            eventType: "login_success",
-            userId: resolvedUserId,
-            userEmail:
-              typeof token.email === "string"
-                ? token.email
-                : typeof user?.email === "string"
-                  ? user.email
-                  : null,
-            userRole: resolvedUserType || "regular",
-            method: "POST",
-            path: `/api/auth/${account.provider}`,
-            routeGroup: "auth",
-            statusCode: 200,
-            outcome: "login_success",
-            severity: "info",
-            reasons: ["登录成功"],
-            metadata: {
-              provider: account.provider,
-            },
-          }).catch((error) => {
-            console.warn("[Auth] Failed to record login access event:", error);
-          });
-        }
-
         return token;
       },
       session({ session, token }) {

app/(chat)/ai-cad/page.tsx

@@ -3,9 +3,9 @@ import path from "node:path";
 import type { Metadata } from "next";
 import { redirect } from "next/navigation";
 import { auth } from "@/app/(auth)/auth";
+import { ZooDesignStudioFrame } from "@/components/ai-cad/zoo-design-studio-frame";
 
-const ZOO_MODELING_APP_SRC =
+const ZOO_MODELING_APP_SRC = "/vendor/zoo-modeling-app/index.html";
-  "/vendor/zoo-modeling-app/index.html?v=f2b345db-eng1";
 
 export const dynamic = "force-dynamic";
 export const metadata: Metadata = {
@@ -23,22 +23,10 @@ export default async function AiCadPage() {
     path.join(process.cwd(), "public/vendor/zoo-modeling-app/index.html")
   );
 
-  if (isReady) {
-    redirect(ZOO_MODELING_APP_SRC);
-  }
-
   return (
-    <main className="flex h-svh w-full items-center justify-center bg-[#10100e] p-6 text-[#f8f6ef]">
+    <ZooDesignStudioFrame
-      <section className="w-full max-w-xl rounded-lg border border-[#3a352c] bg-[#171510] p-6 shadow-2xl">
+      isReady={isReady}
-        <h1 className="font-semibold text-lg">HiCAD 官方前端尚未构建</h1>
+      src={ZOO_MODELING_APP_SRC}
-        <p className="mt-2 text-[#d3cabb] text-sm leading-6">
+    />
-          请运行
-          <code className="mx-1 rounded bg-white/10 px-1.5 py-0.5">
-            pnpm zoo-modeling-app:vendor
-          </code>
-          生成官方前端，然后刷新本页。
-        </p>
-      </section>
-    </main>
   );
 }

app/(chat)/api/chat/_lib/detail-replacement.ts

@@ -2,34 +2,12 @@ import { createLogger } from "@/lib/observability/logger";
 import { generateText } from "ai";
 import { fetchImageBufferFromUrl } from "@/lib/ai/rmbg/service";
 import { getLanguageModelById } from "@/lib/ai/dynamic-provider";
-import {
-  DETAIL_REPLACEMENT_IMAGE_MODEL_CONFIG_KEY,
-  findConfiguredDetailReplacementImageModel,
-  isDetailReplacementImageModel,
-} from "@/lib/ai/detail-replacement-image-model-config";
-import {
-  compositeReplacementWithReferenceLocks,
-  parseReplacementLayoutLockRegions,
-  type NormalizedReplacementBox,
-} from "@/lib/ai/replacement-layout-lock";
-import {
-  buildReplacementProductIdentityAnalysisPrompt,
-  buildReplacementProductStructureLockLines,
-  formatReplacementProductIdentityProfile,
-  normalizeReplacementProductImageIndexes,
-  parseReplacementProductIdentityProfile,
-  type ReplacementProductIdentityProfile,
-} from "@/lib/ai/replacement-product-identity";
 import { resolveDetailAgentLocalMoonshotModel } from "@/lib/ai/detail-agent-model-runtime";
-import { resolveDetailReplacementVisionRuntime } from "@/lib/ai/detail-replacement-vision-runtime";
 import { inlineVisionImages } from "@/lib/ai/vision-inline";
-import {
+import { getEnabledAiModelsWithProvider, getSiteSettings } from "@/lib/db/queries";
-  getEnabledAiModelsWithProvider,
-  getSiteSettings,
-  getSystemSetting,
-} from "@/lib/db/queries";
 import { uploadFile } from "@/lib/storage/service";
 import { bufferToArrayBuffer } from "./persistence";
+import { isVideoProviderType } from "./video-models";
 import type { AgentPresetMessageImagePart } from "./agent-scene-workflow";
 import type { PostRequestBody } from "../schema";
 
@@ -256,8 +234,6 @@ export async function normalizeReplacementResultImage(params: {
   referenceImageUrl: string;
   referenceGeometry?: ReplacementReferenceGeometry | null;
   scenePlan?: ReplacementScenePlan | null;
-  preserveReferenceOutsideSubject?: boolean;
-  preserveReferenceText?: boolean;
   uploadPrefix: string;
 }): Promise<{
   originalUrl: string;
@@ -266,11 +242,6 @@ export async function normalizeReplacementResultImage(params: {
 }> {
   const sharp = (await import("sharp")).default;
   const generatedBuffer = await fetchImageBufferFromUrl(params.generatedImageUrl);
-  let referenceBuffer: Buffer | null = null;
-  const getReferenceBuffer = async () => {
-    referenceBuffer ||= await fetchImageBufferFromUrl(params.referenceImageUrl);
-    return referenceBuffer;
-  };
   let targetWidth = params.referenceGeometry?.width;
   let targetHeight = params.referenceGeometry?.height;
   const generatedMetadata = await sharp(generatedBuffer, { failOn: "none" })
@@ -279,8 +250,8 @@ export async function normalizeReplacementResultImage(params: {
 
   if (!targetWidth || !targetHeight) {
     try {
-      const resolvedReferenceBuffer = await getReferenceBuffer();
+      const referenceBuffer = await fetchImageBufferFromUrl(params.referenceImageUrl);
-      const referenceMetadata = await sharp(resolvedReferenceBuffer, { failOn: "none" })
+      const referenceMetadata = await sharp(referenceBuffer, { failOn: "none" })
         .rotate()
         .metadata();
       targetWidth = referenceMetadata.width;
@@ -327,7 +298,7 @@ export async function normalizeReplacementResultImage(params: {
     : shouldPreserveFullGeneratedCanvas
       ? "contain"
       : "cover";
-  let normalizedBuffer =
+  const normalizedBuffer =
     targetWidth && targetHeight
       ? await imagePipeline
           .resize(targetWidth, targetHeight, {
@@ -341,82 +312,6 @@ export async function normalizeReplacementResultImage(params: {
           .png()
           .toBuffer()
       : await imagePipeline.png().toBuffer();
-
-  if (
-    targetWidth &&
-    targetHeight &&
-    (params.preserveReferenceOutsideSubject || params.preserveReferenceText)
-  ) {
-    let layoutLocks = {
-      subjectBoundingBox: params.scenePlan?.subjectBoundingBox || null,
-      textBoundingBoxes: params.scenePlan?.textBoundingBoxes || [],
-      analyzed: params.scenePlan?.layoutLockAnalyzed === true,
-    };
-    const needsLayoutLockFallback =
-      !layoutLocks.analyzed ||
-      (params.preserveReferenceOutsideSubject && !layoutLocks.subjectBoundingBox);
-
-    if (needsLayoutLockFallback) {
-      const fallbackLocks = await resolveReplacementLayoutLockRegions({
-        referenceImageUrl: params.referenceImageUrl,
-        referenceBuffer: await getReferenceBuffer(),
-      });
-      layoutLocks = {
-        subjectBoundingBox:
-          layoutLocks.subjectBoundingBox || fallbackLocks.subjectBoundingBox,
-        textBoundingBoxes:
-          layoutLocks.textBoundingBoxes.length > 0
-            ? layoutLocks.textBoundingBoxes
-            : fallbackLocks.textBoundingBoxes,
-        analyzed: layoutLocks.analyzed || fallbackLocks.analyzed,
-      };
-    }
-
-    const shouldUseSafeReferenceFallback = Boolean(
-      (params.preserveReferenceOutsideSubject && !layoutLocks.subjectBoundingBox) ||
-        (params.preserveReferenceText && !layoutLocks.analyzed),
-    );
-    normalizedBuffer = shouldUseSafeReferenceFallback
-      ? await sharp(await getReferenceBuffer(), { failOn: "none" })
-          .rotate()
-          .resize(targetWidth, targetHeight, { fit: "fill" })
-          .png()
-          .toBuffer()
-      : await compositeReplacementWithReferenceLocks({
-          generatedBuffer: normalizedBuffer,
-          referenceBuffer: await getReferenceBuffer(),
-          width: targetWidth,
-          height: targetHeight,
-          preserveReferenceOutsideSubject: Boolean(
-            params.preserveReferenceOutsideSubject && layoutLocks.subjectBoundingBox,
-          ),
-          subjectBoundingBox: layoutLocks.subjectBoundingBox,
-          textBoundingBoxes: params.preserveReferenceText
-            ? layoutLocks.textBoundingBoxes
-            : [],
-        });
-    if (shouldUseSafeReferenceFallback) {
-      chatApiLogger.warn(
-        "[Chat API] Replacement layout lock analysis unavailable; preserved the reference image instead of returning a layout-damaged result",
-        {
-          preserveReferenceOutsideSubject: params.preserveReferenceOutsideSubject,
-          preserveReferenceText: params.preserveReferenceText,
-          hasSubjectBoundingBox: Boolean(layoutLocks.subjectBoundingBox),
-          layoutLockAnalyzed: layoutLocks.analyzed,
-        },
-      );
-    }
-    chatApiLogger.info("[Chat API] Replacement reference layout locks applied:", {
-      preserveReferenceOutsideSubject: Boolean(
-        params.preserveReferenceOutsideSubject && layoutLocks.subjectBoundingBox,
-      ),
-      preservedTextRegionCount: params.preserveReferenceText
-        ? layoutLocks.textBoundingBoxes.length
-        : 0,
-      usedFallbackAnalysis: needsLayoutLockFallback,
-      usedSafeReferenceFallback: shouldUseSafeReferenceFallback,
-    });
-  }
   const thumbnailBuffer = await createAgentImageThumbnailBuffer(normalizedBuffer);
 
   const uniqueSuffix = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
@@ -504,12 +399,6 @@ export type ReplacementScenePlan = {
   generationPrompt: string;
   selectedProductImageIndexes: number[];
   productSelectionReason: string;
-  productIdentitySummary?: string;
-  productStructureSummary?: string;
-  productStructuralRisks?: string;
-  subjectBoundingBox?: NormalizedReplacementBox | null;
-  textBoundingBoxes?: NormalizedReplacementBox[];
-  layoutLockAnalyzed?: boolean;
   analysisModelName?: string | null;
   analysisSource: "local_moonshot" | "configured_vision" | "heuristic";
 };
@@ -550,188 +439,6 @@ export type ReplacementScenePlanningRuntime =
 
 const QWEN_VL_MODEL_MATCHER = /(qwen|千问|通义).*(vl|vision)|qwen3-vl|qwen-vl/i;
 
-const replacementProductIdentityProfileCache = new Map<
-  string,
-  {
-    expiresAt: number;
-    promise: Promise<ReplacementProductIdentityProfile | null>;
-  }
->();
-
-async function resolveReplacementProductIdentityProfile(params: {
-  productImageUrls: string[];
-  planningRuntime: Exclude<ReplacementScenePlanningRuntime, null>;
-}) {
-  const productImageUrls = Array.from(
-    new Set(
-      params.productImageUrls
-        .map((url) => String(url || "").trim())
-        .filter((url) => /^https?:\/\//i.test(url)),
-    ),
-  ).slice(0, 8);
-  if (productImageUrls.length === 0) return null;
-
-  const cacheKey = [
-    params.planningRuntime.kind,
-    params.planningRuntime.modelName,
-    ...productImageUrls,
-  ].join("|");
-  const now = Date.now();
-  const cached = replacementProductIdentityProfileCache.get(cacheKey);
-  if (cached && cached.expiresAt > now) {
-    return cached.promise;
-  }
-
-  if (replacementProductIdentityProfileCache.size >= 100) {
-    const oldestKey = replacementProductIdentityProfileCache.keys().next().value;
-    if (oldestKey) replacementProductIdentityProfileCache.delete(oldestKey);
-  }
-
-  const promise = (async () => {
-    try {
-      const { inlineDataUrls } = await inlineVisionImages(productImageUrls, {
-        maxImages: productImageUrls.length,
-        maxSide: 800,
-        timeoutMs: 12_000,
-        retries: 2,
-        loggerPrefix: "[Chat API] Replacement product identity",
-        trimTransparentPadding: true,
-      });
-      const effectiveImages =
-        inlineDataUrls.length === productImageUrls.length
-          ? inlineDataUrls
-          : productImageUrls;
-      const { text } = await generateText({
-        model: params.planningRuntime.model,
-        messages: [
-          {
-            role: "user",
-            content: [
-              {
-                type: "text",
-                text: buildReplacementProductIdentityAnalysisPrompt(
-                  productImageUrls.length,
-                ),
-              },
-              ...effectiveImages.map((image) => ({
-                type: "image" as const,
-                image,
-              })),
-            ],
-          },
-        ],
-        system:
-          "你是高精度商品结构分析器。多张图片属于同一商品；请跨视角还原唯一结构身份，并明确每个视角最清楚的构件。",
-        temperature: params.planningRuntime.kind === "local_moonshot" ? 1 : 0.1,
-        maxTokens: 1800,
-        abortSignal: AbortSignal.timeout(
-          params.planningRuntime.kind === "local_moonshot" ? 90_000 : 60_000,
-        ),
-      } as any);
-      const profile = parseReplacementProductIdentityProfile(
-        text,
-        productImageUrls.length,
-      );
-      if (!profile) {
-        throw new Error("商品结构画像缺少必需字段");
-      }
-      return profile;
-    } catch (error) {
-      chatApiLogger.warn("[Chat API] Replacement product identity analysis failed:", {
-        productImageCount: productImageUrls.length,
-        modelName: params.planningRuntime.modelName,
-        error: error instanceof Error ? error.message : "unknown",
-      });
-      return null;
-    }
-  })();
-
-  replacementProductIdentityProfileCache.set(cacheKey, {
-    expiresAt: now + 30 * 60 * 1000,
-    promise,
-  });
-  return promise;
-}
-
-const replacementLayoutLockCache = new Map<
-  string,
-  {
-    expiresAt: number;
-    promise: Promise<ReturnType<typeof parseReplacementLayoutLockRegions>>;
-  }
->();
-
-async function resolveReplacementLayoutLockRegions(params: {
-  referenceImageUrl: string;
-  referenceBuffer: Buffer;
-}) {
-  const now = Date.now();
-  const cached = replacementLayoutLockCache.get(params.referenceImageUrl);
-  if (cached && cached.expiresAt > now) {
-    return cached.promise;
-  }
-
-  if (replacementLayoutLockCache.size >= 200) {
-    const oldestKey = replacementLayoutLockCache.keys().next().value;
-    if (oldestKey) {
-      replacementLayoutLockCache.delete(oldestKey);
-    }
-  }
-
-  const promise = (async () => {
-    try {
-      const sharp = (await import("sharp")).default;
-      const inlineBuffer = await sharp(params.referenceBuffer, { failOn: "none" })
-        .rotate()
-        .resize(1600, 1600, {
-          fit: "inside",
-          withoutEnlargement: true,
-        })
-        .flatten({ background: "#ffffff" })
-        .jpeg({ quality: 88 })
-        .toBuffer();
-      const { callQwen3Vl } = await import("@/lib/ai/qwen3-vl");
-      const result = await callQwen3Vl({
-        imageUrl: `data:image/jpeg;base64,${inlineBuffer.toString("base64")}`,
-        prompt: [
-          "你是电商详情图的布局区域定位器。",
-          "只分析当前图像，返回严格 JSON，不要解释。",
-          "所有坐标使用 0到1000 的归一化坐标，格式必须是 [x1,y1,x2,y2]，绝对不是 x/y/宽/高。",
-          "subjectBoundingBox：只框出图中当前旧商品主体的可视外轮廓区域，包含完整商品和它的自然阴影，不要包含文字；没有商品则为 null。",
-          "textBoundingBoxes：框出所有可见文案块，包括中英文标题、卖点、参数、标签、数字、品牌字样、按钮文字和紧邻的图标；没有则返回空数组。",
-          '{"subjectBoundingBox":[0,0,1000,1000],"textBoundingBoxes":[[0,0,1000,1000]]}',
-        ].join("\n"),
-        temperature: 0,
-        maxTokens: 1600,
-        timeoutMs: 60_000,
-        retries: 1,
-      });
-      const parsedLocks = parseReplacementLayoutLockRegions(result.text);
-      if (!parsedLocks.analyzed) {
-        throw new Error("布局区域定位结果缺少必需字段");
-      }
-      return parsedLocks;
-    } catch (error) {
-      replacementLayoutLockCache.delete(params.referenceImageUrl);
-      chatApiLogger.warn("[Chat API] Replacement layout lock fallback analysis failed:", {
-        referenceImageUrl: params.referenceImageUrl,
-        error: error instanceof Error ? error.message : "unknown",
-      });
-      return {
-        subjectBoundingBox: null,
-        textBoundingBoxes: [],
-        analyzed: false,
-      };
-    }
-  })();
-
-  replacementLayoutLockCache.set(params.referenceImageUrl, {
-    expiresAt: now + 30 * 60 * 1000,
-    promise,
-  });
-  return promise;
-}
-
 export function normalizeDetailReplacementStrategy(
   value: unknown,
 ): AgentDetailReplacementStrategy {
@@ -1734,27 +1441,7 @@ export function parseReplacementScenePlan(
         visualProfile: params.visualProfile,
       });
 
-    const defaultProductImageSelection = buildDefaultProductImageSelection(
+    const productImageSelection = buildDefaultProductImageSelection(params.productImageCount);
-      params.productImageCount,
-    );
-    const selectedProductImageIndexes = normalizeReplacementProductImageIndexes(
-      parsed.selectedProductImageIndexes ??
-        parsed.selectedProductIndexes ??
-        parsed.productImageIndexes,
-      params.productImageCount,
-    );
-    const productImageSelection =
-      selectedProductImageIndexes.length > 0
-        ? {
-            selectedProductImageIndexes,
-            productSelectionReason:
-              truncateReplacementAnalysisText(
-                parsed.productSelectionReason ?? parsed.selectionReason,
-                240,
-              ) || "按当前详情底板机位选择最匹配的产品视角。",
-          }
-        : defaultProductImageSelection;
-    const layoutLocks = parseReplacementLayoutLockRegions(parsed);
     let scenePlan: ReplacementScenePlan = {
       pageKind,
       generationRoute,
@@ -1799,9 +1486,6 @@ export function parseReplacementScenePlan(
       generationPrompt,
       selectedProductImageIndexes: productImageSelection.selectedProductImageIndexes,
       productSelectionReason: productImageSelection.productSelectionReason,
-      subjectBoundingBox: layoutLocks.subjectBoundingBox,
-      textBoundingBoxes: layoutLocks.textBoundingBoxes,
-      layoutLockAnalyzed: layoutLocks.analyzed,
       analysisModelName: null,
       analysisSource: "heuristic",
     };
@@ -2160,15 +1844,6 @@ export async function resolveDirectReplacementModelRef(params: {
   finalModelId?: string | null;
   models?: Awaited<ReturnType<typeof getEnabledAiModelsWithProvider>>;
 }) {
-  const models = params.models || (await getEnabledAiModelsWithProvider(false));
-  const configuredModelSetting = await getSystemSetting({
-    key: DETAIL_REPLACEMENT_IMAGE_MODEL_CONFIG_KEY,
-  }).catch(() => null);
-  const configuredModel = findConfiguredDetailReplacementImageModel(models, configuredModelSetting?.value);
-  if (configuredModel) {
-    return configuredModel.model.id;
-  }
-
   const explicitModel = String(params.selectedChatModel || "").trim();
   if (explicitModel && explicitModel !== "auto") {
     return explicitModel;
@@ -2178,7 +1853,13 @@ export async function resolveDirectReplacementModelRef(params: {
     return routedModel;
   }
 
-  const imageModels = models.filter(isDetailReplacementImageModel);
+  const models = params.models || (await getEnabledAiModelsWithProvider(false));
+  const imageModels = models.filter(
+    ({ model, provider }) =>
+      model.supportsImageGen &&
+      !model.isSubModel &&
+      !isVideoProviderType(provider?.type, model),
+  );
   const preferred =
     imageModels.find(({ model }) => model.isDefault) ||
     imageModels.find(({ provider }) => String(provider?.type || "").includes("image")) ||
@@ -2440,16 +2121,6 @@ export async function analyzeReplacementReferenceImage(params: {
 export async function resolveReplacementScenePlanningRuntime(params: {
   models?: Awaited<ReturnType<typeof getEnabledAiModelsWithProvider>>;
 }): Promise<ReplacementScenePlanningRuntime> {
-  try {
-    const dedicatedVisionRuntime = await resolveDetailReplacementVisionRuntime();
-    if (dedicatedVisionRuntime) return dedicatedVisionRuntime;
-  } catch (error) {
-    chatApiLogger.warn(
-      "[Chat API] Failed to resolve dedicated detail replacement vision model:",
-      error,
-    );
-  }
-
   try {
     const siteSettings = await getSiteSettings().catch(() => null);
     const localDetailAgentResolved = await resolveDetailAgentLocalMoonshotModel({
@@ -2520,13 +2191,6 @@ export async function analyzeReplacementExecutionPlan(params: {
   const referenceVisualProfile = isDetailReplacement
     ? await resolveReplacementReferenceVisualProfile(params.referenceImageUrl)
     : null;
-  const productIdentityProfile =
-    params.planningRuntime && params.productImageUrls.length > 0
-      ? await resolveReplacementProductIdentityProfile({
-          productImageUrls: params.productImageUrls,
-          planningRuntime: params.planningRuntime,
-        })
-      : null;
   if (params.planningRuntime) {
     try {
       const replacementScenePlanningTimeoutMs =
@@ -2557,10 +2221,7 @@ export async function analyzeReplacementExecutionPlan(params: {
           ? "你是电商详情参考图背景替换流程中的“版式与背景区域规划器”。"
           : "你是电商详情替换流程中的“场景理解规划器”。",
         `当前要分析的参考图：${params.referenceLabel}`,
-        "当前视觉输入只包含这一张详情参考图；产品图已经单独做过跨视角结构分析，请根据下面的产品结构画像选择最匹配当前机位的产品视角，不要臆测产品结构。",
+        "你现在只分析这一张参考图本身，不分析产品图，不分析模特图。",
-        productIdentityProfile
-          ? `【产品结构画像】\n${formatReplacementProductIdentityProfile(productIdentityProfile)}`
-          : "产品结构画像暂不可用：仍需按当前参考图机位选择产品图，但不得把旧产品的腿型、支架或构件拓扑当成新产品结构。",
         referenceVisualProfile
           ? `像素初筛：nearWhite=${referenceVisualProfile.nearWhitePixelRatio.toFixed(2)}, lightLowSaturation=${referenceVisualProfile.lightLowSaturationPixelRatio.toFixed(2)}, topLight=${referenceVisualProfile.topLightLowSaturationPixelRatio.toFixed(2)}, borderLight=${referenceVisualProfile.borderLightLowSaturationPixelRatio.toFixed(2)}, dark=${referenceVisualProfile.darkPixelRatio.toFixed(2)}, likelyWhiteLayout=${referenceVisualProfile.likelyWhiteLayout ? "true" : "false"}, likelyWhiteScene=${referenceVisualProfile.likelyWhiteScene ? "true" : "false"}。${referenceVisualProfile.reason}`
           : "",
@@ -2570,7 +2231,7 @@ export async function analyzeReplacementExecutionPlan(params: {
         !referenceVisualProfile?.likelyWhiteLayout && referenceVisualProfile?.likelyWhiteScene
           ? "像素初筛已经命中白/浅色低饱和真实场景：这不是白底说明页。若画面存在真实空间、人物或产品照片，promptPackPolicy 应为 soft 或 allow，必须使用前置工作流词包重建图片框内产品、空间、软装和灯光，使差异清晰可见；但最终仍保持白/浅色低饱和基调，不要改造成深色厨房、黑墙、复杂吊灯或强软装。"
           : "",
-        "产品图和模特图会在后续生图阶段单独提供给生图模型。你必须依据产品结构画像输出 selectedProductImageIndexes，选择最多两张最能匹配当前参考图机位并共同说明完整结构的产品图；不得固定选择前两张，也不要要求强行使用全部产品图。",
+        "产品图和模特图会在后续生图阶段单独提供给生图模型使用，你这里不要尝试理解它们的具体外观，也不要要求必须使用所有输入图。",
         params.modelImageUrl && !isProductOnlyDetailReplacement
           ? "你只需要根据当前参考图判断：这一屏是否存在真实的人物展示需求；如果没有人物需求，useModelImage 必须为 false。"
           : "本轮没有模特图，useModelImage 必须为 false。",
@@ -2617,18 +2278,12 @@ export async function analyzeReplacementExecutionPlan(params: {
         isDetailReplacement
           ? "5. 判断 textPolicy：画面中存在营销标题、卖点、编号、参数、标签且与图匹配时必须 lock 或 preserve，避免后续生图改字、混色或重排。"
           : "",
-        isDetailReplacement
-          ? "5a. 必须输出 subjectBoundingBox 和 textBoundingBoxes。所有坐标为 0到1000 归一化坐标 [x1,y1,x2,y2]，不是 x/y/宽/高。subjectBoundingBox 紧密框住旧商品主体及自然阴影，不含文字，无商品时为 null；textBoundingBoxes 覆盖所有中英文文案、标题、卖点、参数、标签、数字、品牌字样、按钮文字及紧邻图标，无文字时为 []。"
-          : "",
         isDetailReplacement
           ? "6. 判断 peoplePolicy：有人物/多人/自拍/聚会/围坐/聚餐/模特互动/拿手机/用餐/试坐/承重动作时必须 preserve_relation；如果文字明确写了“多人围坐、聚餐、合照、用餐、单侧承重、横向受力测试、拿手机”等动作，generationPrompt 必须把这个动作写成硬约束；如果只提供 1 张模特图但参考图多人，仍要保留参考图人数和关系，额外人物按参考图生成相近人群。"
           : "",
         isDetailReplacement
           ? "7. 提炼 sceneSummary、cameraSummary、placementSummary、preserveSummary、styleSummary、avoidSummary；cameraSummary 必须写出产品主体的视角特征，例如正侧视/三分之四/俯视/平视、倾斜方向、可见面数量、主体朝向和透视消失方向。"
           : "",
-        isDetailReplacement
-          ? "7a. 输出 selectedProductImageIndexes：根据当前详情图机位，从产品结构画像的图片编号中选择最多两张最相关的产品图；第一张应最接近当前机位，第二张补足腿、支架、横梁、侧框或其他容易变形的结构。输出 productSelectionReason 说明选择依据。"
-          : "",
         isProductOnlyDetailReplacement
           ? "4. 输出 generationPrompt：这是一段给后续生图模型的本屏生成指令，要求只替换产品主体，保留其余背景、文案、排版、装饰和光影完全不变。"
           : isDetailReplacement
@@ -2654,7 +2309,7 @@ export async function analyzeReplacementExecutionPlan(params: {
           : "",
         "只返回严格 JSON，不要任何额外解释。",
         `JSON 格式：
-{"shouldReplace":true,"containsFurnitureProduct":true,"reason":"不超过30字","pageKind":"prompt_pack_scene|white_scene|white_layout|copy_locked|people_scene|action_poster|dimension_spec|material_detail|unknown","generationRoute":"${isDetailReplacement ? "prompt_pack_scene|layout_preserve_replace|copy_locked_regenerate|people_relation_locked" : "prompt_pack_scene|layout_preserve_replace|copy_locked_regenerate|people_relation_locked|direct_passthrough"}","promptPackPolicy":"allow|soft|forbid","textPolicy":"free|preserve|lock","peoplePolicy":"none|preserve_relation|require_user_model","whiteBackgroundLikely":false,"copyImageCoupled":false,"containsPeople":false,"containsMultiplePeople":false,"subjectBoundingBox":[0,0,1000,1000],"textBoundingBoxes":[[0,0,1000,1000]],"selectedProductImageIndexes":[1,2],"productSelectionReason":"不超过80字","routeReason":"不超过50字","useModelImage":false,"modelImageReason":"不超过40字","sceneSummary":"不超过80字","cameraSummary":"不超过60字","placementSummary":"不超过60字","preserveSummary":"不超过80字","styleSummary":"不超过80字","avoidSummary":"不超过80字","generationPrompt":"不超过300字"}`,
+{"shouldReplace":true,"containsFurnitureProduct":true,"reason":"不超过30字","pageKind":"prompt_pack_scene|white_scene|white_layout|copy_locked|people_scene|action_poster|dimension_spec|material_detail|unknown","generationRoute":"${isDetailReplacement ? "prompt_pack_scene|layout_preserve_replace|copy_locked_regenerate|people_relation_locked" : "prompt_pack_scene|layout_preserve_replace|copy_locked_regenerate|people_relation_locked|direct_passthrough"}","promptPackPolicy":"allow|soft|forbid","textPolicy":"free|preserve|lock","peoplePolicy":"none|preserve_relation|require_user_model","whiteBackgroundLikely":false,"copyImageCoupled":false,"containsPeople":false,"containsMultiplePeople":false,"routeReason":"不超过50字","useModelImage":false,"modelImageReason":"不超过40字","sceneSummary":"不超过80字","cameraSummary":"不超过60字","placementSummary":"不超过60字","preserveSummary":"不超过80字","styleSummary":"不超过80字","avoidSummary":"不超过80字","generationPrompt":"不超过300字"}`,
       ]
         .filter(Boolean)
         .join("\n");
@@ -2679,7 +2334,7 @@ export async function analyzeReplacementExecutionPlan(params: {
         system:
           "你是高精度商品详情图场景规划器。你只分析当前参考图本身，负责理解这一屏的场景、机位、主体位置和人物需求，不要臆测或依赖其他输入图片。",
         temperature: params.planningRuntime.kind === "local_moonshot" ? 1 : 0.1,
-        maxTokens: 1600,
+        maxTokens: 1200,
         abortSignal: AbortSignal.timeout(replacementScenePlanningTimeoutMs),
       } as any);
 
@@ -2713,9 +2368,6 @@ export async function analyzeReplacementExecutionPlan(params: {
               : "configured_vision",
           scenePlan: {
             ...normalizedPlan.scenePlan,
-            productIdentitySummary: productIdentityProfile?.identitySummary || "",
-            productStructureSummary: productIdentityProfile?.structureSummary || "",
-            productStructuralRisks: productIdentityProfile?.structuralRisks || "",
             analysisModelName: params.planningRuntime.modelName,
             analysisSource:
               params.planningRuntime.kind === "local_moonshot"
@@ -2761,12 +2413,7 @@ export async function analyzeReplacementExecutionPlan(params: {
   );
   return {
     ...normalizedFallbackPlan.decision,
-    scenePlan: {
+    scenePlan: normalizedFallbackPlan.scenePlan,
-      ...normalizedFallbackPlan.scenePlan,
-      productIdentitySummary: productIdentityProfile?.identitySummary || "",
-      productStructureSummary: productIdentityProfile?.structureSummary || "",
-      productStructuralRisks: productIdentityProfile?.structuralRisks || "",
-    },
   };
 }
 
@@ -2890,17 +2537,11 @@ export function buildAgentReplacementPrompt(params: {
         ]
       : [];
   const productAngleLockLines = [
-    "【产品角度锁定规则】最终商品/主体的拍摄角度、朝向、占比、重心和透视消失方向以最后一张参考图为准；商品身份、外轮廓、腿型、支架拓扑、构件数量和连接方式以前面的产品输入图为准。",
+    "【产品角度锁定规则】最终商品/主体的拍摄角度以最后一张参考图为准，而不是以前面的产品输入图为准；前面的产品图只提供款式、材质、颜色、结构和细节。",
-    "必须对齐最后一张参考图的正侧视/三分之四/俯视/平视关系、桌面或面板倾斜方向和可见侧面数量，但不得照搬旧商品的腿部、横梁、侧框、把手、转轴或内部构件设计。",
+    "必须逐项对齐最后一张参考图中的产品姿态：朝向、正侧视/三分之四/俯视/平视关系、桌面或面板倾斜方向、可见侧面数量、支架/腿部/把手/转轴位置、主体外轮廓、占比、重心和透视消失方向。",
     "如果最后一张参考图的产品是侧视或低视角，不允许改成俯视三分之四；如果是俯视三分之四，不允许改成正侧视；不允许镜像、旋转、翻转或把产品重画成另一个角度。",
     "若参考图含功能标签、箭头、尺寸线、编号或引导线，它们指向的实际结构部位必须保持一致，不得因产品转角改变而让标签指向错误位置。",
   ];
-  const productStructureLockLines = buildReplacementProductStructureLockLines({
-    productImageCount: params.productImageCount,
-    identitySummary: params.scenePlan?.productIdentitySummary,
-    structureSummary: params.scenePlan?.productStructureSummary,
-    structuralRisks: params.scenePlan?.productStructuralRisks,
-  });
   const normalizedBasePrompt = String(params.basePrompt || "").trim();
   const promptPackInstructionLines =
     params.modeType === "detail_replacement" &&
@@ -3000,7 +2641,6 @@ export function buildAgentReplacementPrompt(params: {
           ...promptPackInstructionLines,
           ...scenePlanLines,
           ...marketplaceBrandRemovalLines,
-          ...productStructureLockLines,
           ...productAngleLockLines,
           "你现在做的是‘仅替换产品’，不是重建场景，也不是重新设计整张详情图。",
           "忽略用户补充提示词里的场景风格、氛围、空间改造要求；这一次只服务于产品主体替换。",
@@ -3030,7 +2670,6 @@ export function buildAgentReplacementPrompt(params: {
           ...promptPackInstructionLines,
           ...scenePlanLines,
           ...marketplaceBrandRemovalLines,
-          ...productStructureLockLines,
           ...productAngleLockLines,
           "你现在做的是“详情参考图背景/场景图替换”，不是重新设计整张详情图。",
           "【版式锁层规则】把最后一张参考图当成 PSD 模板：文字、标题、编号、卖点标签、按钮、图标、白底/浅色底、留白、分割线、原有圆角照片区域和原有裁切范围都属于锁定版式层，不允许移动、缩放、重排或重新设计；不要把这些版式边界画成新的白色线框、描边或卡片。",
@@ -3146,7 +2785,6 @@ export function buildAgentReplacementPrompt(params: {
     "【图片顺序规则】",
     ...imageOrderLines,
     ...scenePlanLines,
-    ...productStructureLockLines,
     ...productAngleLockLines,
     params.pairedProductIndex !== undefined
       ? `请优先使用第 ${params.pairedProductIndex + 1} 张输入商品图作为本张参考图的一对一替换主体。`

app/(chat)/api/chat/_lib/errors.ts

@@ -1,6 +1,6 @@
 import { createLogger } from "@/lib/observability/logger";
 import { NextResponse } from "next/server";
-import { getRequestErrorMessage, isProviderBalanceError, isRateLimitError } from "@/lib/request-error";
+import { getRequestErrorMessage } from "@/lib/request-error";
 import { generateUUID } from "@/lib/utils";
 
 const chatApiLogger = createLogger("chat.errors");
@@ -20,14 +20,6 @@ export function getChatStreamErrorMessage(error: unknown): string {
     error instanceof Error ? String(error.message || "").trim() : String(error || "").trim();
   const normalized = rawMessage.toLowerCase();
 
-  if (isProviderBalanceError(error)) {
-    return "当前模型服务商线路余额或额度不足，请切换模型或联系管理员；与您的积分余额无关。";
-  }
-
-  if (isRateLimitError(error)) {
-    return "当前模型服务请求过于频繁，请稍后重试或切换模型。";
-  }
-
   if (
     normalized.includes("token quota is not enough") ||
     normalized.includes("pre_consume_token_quota_failed") ||
@@ -55,16 +47,6 @@ function resolveChatApiFailure(error: unknown) {
   const detailMessage = getRequestErrorMessage(error);
   const normalized = String(detailMessage || "").toLowerCase();
 
-  if (isProviderBalanceError(error)) {
-    return {
-      code: "server_error:chat",
-      message: "模型服务商线路余额或额度不足，请切换模型或联系管理员。",
-      status: 503,
-      category: "provider_balance",
-      detailMessage,
-    };
-  }
-
   if (
     normalized.includes("payload too large") ||
     normalized.includes("request entity too large") ||

app/(chat)/api/chat/_lib/image-failover.ts

@@ -4,8 +4,6 @@ import { getLanguageModelById } from "@/lib/ai/dynamic-provider";
 import { modelLacksReferenceImageInputSupport } from "@/lib/ai/reference-image-capability";
 import type { ChatMessage } from "@/lib/types";
 import { convertMessagesWithImages } from "./image-media";
-import { isProviderBalanceError } from "@/lib/request-error";
-import { isImageModelBalanceBlocked } from "@/lib/ai/runtime/image-balance";
 
 const chatApiLogger = createLogger("chat.imageFailover");
 
@@ -59,21 +57,7 @@ export function resolveImageModelRuntimeId(
 export function normalizeFailoverErrorMessage(error: unknown): string {
   if (!error) return "";
   if (typeof error === "string") return error;
-  if (error instanceof Error) {
+  if (error instanceof Error) return error.message || String(error);
-    const record = error as Error & {
-      status?: unknown;
-      statusCode?: unknown;
-      httpStatus?: unknown;
-      response?: { status?: unknown };
-    };
-    const status =
-      record.status ??
-      record.statusCode ??
-      record.httpStatus ??
-      record.response?.status;
-    const message = error.message || String(error);
-    return status ? `[HTTP ${String(status)}] ${message}` : message;
-  }
   try {
     return JSON.stringify(error);
   } catch {
@@ -84,7 +68,6 @@ export function normalizeFailoverErrorMessage(error: unknown): string {
 export function shouldCooldownImageFallbackModel(errorMessage: string): boolean {
   const msg = errorMessage.toLowerCase();
   return (
-    isProviderBalanceError(errorMessage) ||
     msg.includes("model not found") ||
     msg.includes("model_not_found") ||
     msg.includes("no available channel for model") ||
@@ -93,13 +76,6 @@ export function shouldCooldownImageFallbackModel(errorMessage: string): boolean
     msg.includes("api key is missing") ||
     msg.includes("invalid api key") ||
     msg.includes("unauthorized") ||
-    /(?:^|\D)401(?:\D|$)/.test(msg) ||
-    msg === "forbidden" ||
-    msg.includes("access forbidden") ||
-    msg.includes("access denied") ||
-    msg.includes("permission denied") ||
-    /(?:^|\D)403(?:\D|$)/.test(msg) ||
-    msg.includes("vip98k task failed") ||
     msg.includes("cannot convert argument to a bytestring") ||
     msg.includes("model maintenance") ||
     msg.includes("maintenance") ||
@@ -326,9 +302,9 @@ export function buildImageFallbackCandidates(
     if (!sameProvider && !IMAGE_FAILOVER_PROVIDER_ALLOWLIST.has(providerType)) {
       return false;
     }
-    if (isImageFallbackModelCoolingDown(item.model.id) || isImageModelBalanceBlocked(item.model)) {
+    if (isImageFallbackModelCoolingDown(item.model.id)) {
       const cooldown = imageFailoverModelCooldown.get(item.model.id);
-      chatApiLogger.info(`[Chat API] ⏭ Skip configured image fallback on cooldown: ${item.model.displayName} (${providerType}) - ${cooldown?.reason || "provider balance cooldown"}`);
+      chatApiLogger.info(`[Chat API] ⏭ Skip configured image fallback on cooldown: ${item.model.displayName} (${providerType}) - ${cooldown?.reason || "cooldown"}`);
       return false;
     }
     return true;
@@ -488,9 +464,9 @@ export function getImageCrossProviderCandidates(
       }
       if (m.model.id === options.currentModelId) return false;
       if (options.currentProviderId && m.provider.id === options.currentProviderId) return false;
-      if (isImageFallbackModelCoolingDown(m.model.id) || isImageModelBalanceBlocked(m.model)) {
+      if (isImageFallbackModelCoolingDown(m.model.id)) {
         const cooldown = imageFailoverModelCooldown.get(m.model.id);
-        chatApiLogger.info(`[Chat API] ⏭ Skip image failover model on cooldown: ${m.model.displayName} (${m.provider.type}) - ${cooldown?.reason || "provider balance cooldown"}`);
+        chatApiLogger.info(`[Chat API] ⏭ Skip image failover model on cooldown: ${m.model.displayName} (${m.provider.type}) - ${cooldown?.reason || "cooldown"}`);
         return false;
       }
       return true;

app/(chat)/api/chat/_lib/image-generation-failure.ts

@@ -1,47 +0,0 @@
-import { saveMessages } from "@/lib/db/queries";
-import type { ImageGenerationStatusStreamPayload } from "@/lib/canvas/image-generation-status";
-import { formatRequestFailure, getRequestFailureDetails } from "@/lib/request-error";
-import { safeWriteStreamChunk, type StreamWriter, writeAssistantTextChunk, writeStructuredDataChunk } from "./stream";
-
-export async function reportImageGenerationFailure(params: {
-  writer: StreamWriter;
-  chatId: string;
-  userMessageId: string;
-  messageId: string;
-  error: unknown;
-  label: string;
-}) {
-  const failure = getRequestFailureDetails(params.error, "图片生成失败");
-  const status: ImageGenerationStatusStreamPayload = {
-    phase: "failed",
-    userMessageId: params.userMessageId,
-    requestId: params.messageId,
-    failure,
-  };
-  const text = formatRequestFailure(failure, params.messageId);
-  const parts = [
-    { type: "text", text },
-    { type: "data-imageGenerationStatus", data: status },
-  ];
-  writeStructuredDataChunk(params.writer, "data-imageGenerationStatus", status, `${params.label}:status`);
-  safeWriteStreamChunk(params.writer, {
-    type: "data-appendMessage",
-    data: JSON.stringify({ id: params.messageId, role: "assistant", parts }),
-  }, params.label);
-  writeAssistantTextChunk(params.writer, "<!-- IMAGE_GENERATION_END -->", `${params.label}:end`);
-  // History carries the same terminal state when the browser loses the stream.
-  await saveMessages({ messages: [{
-    id: params.messageId,
-    chatId: params.chatId,
-    role: "assistant",
-    parts,
-    attachments: [],
-    createdAt: new Date(),
-    videoStorageStatus: null,
-    temporaryVideoUrl: null,
-    permanentVideoUrl: null,
-    archivedAt: null,
-    videoMetadata: null,
-  }] });
-  return text;
-}

app/(chat)/api/chat/_lib/stream.ts

@@ -7,7 +7,6 @@ import type {
   ResolvedTargetAssets,
 } from "@/lib/ai/context-memory/types";
 import type { CanvasViewOperationPlan } from "@/types/canvas/agent-protocol";
-import type { CanvasCapabilityClientCommand } from "@/lib/canvas/capabilities/client-command";
 import { generateUUID } from "@/lib/utils";
 
 const chatApiLogger = createLogger("chat.stream");
@@ -208,13 +207,14 @@ export function writeImageGenerationStatusChunk(
   writer: StreamWriter,
   params: {
     phase: "queued" | "processing" | "finalizing" | "failed" | "completed";
-    userMessageId?: string;
     providerType?: string | null;
     modelName?: string | null;
     imageCount?: number | null;
     queuePosition?: number | null;
+    sameModelPendingCount?: number | null;
     sameModelRunningCount?: number | null;
     concurrencyLimit?: number | null;
+    dispatchIntervalMs?: number | null;
     estimatedWaitMs?: number | null;
   },
   label: string
@@ -224,7 +224,6 @@ export function writeImageGenerationStatusChunk(
     "data-imageGenerationStatus",
     {
       phase: params.phase,
-      userMessageId: params.userMessageId,
       providerType: normalizeImageLoadingProviderType(params.providerType),
       modelName: String(params.modelName || "").trim() || undefined,
       imageCount:
@@ -236,6 +235,11 @@ export function writeImageGenerationStatusChunk(
         Number(params.queuePosition) >= 0
           ? Number(params.queuePosition)
           : undefined,
+      sameModelPendingCount:
+        Number.isFinite(Number(params.sameModelPendingCount)) &&
+        Number(params.sameModelPendingCount) >= 0
+          ? Number(params.sameModelPendingCount)
+          : undefined,
       sameModelRunningCount:
         Number.isFinite(Number(params.sameModelRunningCount)) &&
         Number(params.sameModelRunningCount) >= 0
@@ -246,6 +250,11 @@ export function writeImageGenerationStatusChunk(
         Number(params.concurrencyLimit) > 0
           ? Number(params.concurrencyLimit)
           : undefined,
+      dispatchIntervalMs:
+        Number.isFinite(Number(params.dispatchIntervalMs)) &&
+        Number(params.dispatchIntervalMs) >= 0
+          ? Number(params.dispatchIntervalMs)
+          : undefined,
       estimatedWaitMs:
         Number.isFinite(Number(params.estimatedWaitMs)) &&
         Number(params.estimatedWaitMs) >= 0
@@ -428,19 +437,6 @@ export function writeCanvasViewOperationChunk(
   );
 }
 
-export function writeCanvasCapabilityCommandChunk(
-  writer: StreamWriter,
-  command: CanvasCapabilityClientCommand,
-  label: string
-) {
-  writeStructuredDataChunk(
-    writer,
-    "data-canvasCapabilityCommand",
-    command,
-    label
-  );
-}
-
 type AgentTargetLockRefPreview = {
   url: string;
   title?: string;

app/(chat)/api/files/direct-upload/route.ts

@@ -13,10 +13,6 @@ import { z } from "zod";
 
 import { auth } from "@/app/(auth)/auth";
 import { upsertMediaAsset } from "@/lib/db/queries";
-import {
-  IMAGE_UPLOAD_MAX_BYTES,
-  IMAGE_UPLOAD_TOO_LARGE_MESSAGE,
-} from "@/lib/image-upload-limits";
 import { createLogger } from "@/lib/observability/logger";
 import {
   buildS3PublicUrl,
@@ -164,10 +160,7 @@ function isAllowedDirectUpload(
   );
 }
 
-function getPurposeMaxBytes(purpose?: string, contentType?: string) {
+function getPurposeMaxBytes(purpose?: string) {
-  if (String(contentType || "").toLowerCase().startsWith("image/")) {
-    return IMAGE_UPLOAD_MAX_BYTES;
-  }
   if (purpose === OPENCLAW_CHAT_VIDEO_UPLOAD_PURPOSE) {
     return OPENCLAW_CHAT_VIDEO_MAX_BYTES;
   }
@@ -288,14 +281,9 @@ export async function POST(request: Request) {
           { status: 400 }
         );
       }
-      const maxBytes = getPurposeMaxBytes(payload.purpose, contentType);
+      if (payload.size > getPurposeMaxBytes(payload.purpose)) {
-      if (payload.size > maxBytes) {
         return NextResponse.json(
-          {
+          { error: `文件不能超过 ${getPurposeMaxBytes(payload.purpose) / 1024 / 1024}MB` },
-            error: contentType.startsWith("image/")
-              ? IMAGE_UPLOAD_TOO_LARGE_MESSAGE
-              : `文件不能超过 ${maxBytes / 1024 / 1024}MB`,
-          },
           { status: 413 }
         );
       }
@@ -331,6 +319,7 @@ export async function POST(request: Request) {
           contentType,
           clientUploadId: payload.clientUploadId || null,
         });
+
         const headers: Record<string, string> = {
           "Content-Type": contentType,
           "Cache-Control": "public, max-age=31536000, immutable",
@@ -402,15 +391,8 @@ export async function POST(request: Request) {
       if (!isAllowedDirectUpload(contentType, payload.purpose, payload.filename)) {
         return NextResponse.json({ error: "不支持续传该文件类型" }, { status: 400 });
       }
-      if (payload.size > getPurposeMaxBytes(payload.purpose, contentType)) {
+      if (payload.size > getPurposeMaxBytes(payload.purpose)) {
-        return NextResponse.json(
+        return NextResponse.json({ error: "文件超过允许的上传大小" }, { status: 413 });
-          {
-            error: contentType.startsWith("image/")
-              ? IMAGE_UPLOAD_TOO_LARGE_MESSAGE
-              : "文件超过允许的上传大小",
-          },
-          { status: 413 }
-        );
       }
       const expectedPartSize = computePartSize(payload.size);
       if (payload.partSize !== expectedPartSize) {
@@ -524,15 +506,8 @@ export async function POST(request: Request) {
         { status: 400 }
       );
     }
-    if (payload.size > getPurposeMaxBytes(payload.purpose, contentType)) {
+    if (payload.size > getPurposeMaxBytes(payload.purpose)) {
-      return NextResponse.json(
+      return NextResponse.json({ error: "文件超过允许的上传大小" }, { status: 413 });
-        {
-          error: contentType.startsWith("image/")
-            ? IMAGE_UPLOAD_TOO_LARGE_MESSAGE
-            : "文件超过允许的上传大小",
-        },
-        { status: 413 }
-      );
     }
 
     if (payload.uploadId) {

app/(chat)/api/files/upload/route.ts

@@ -1,16 +1,25 @@
 import { NextResponse } from "next/server";
 import { z } from "zod";
-import {
-  IMAGE_UPLOAD_TOO_LARGE_MESSAGE,
-  isImageUploadTooLarge,
-} from "@/lib/image-upload-limits";
 
 import { auth } from "@/app/(auth)/auth";
 import { createAgentWorkflowPreviewImageBuffer } from "@/lib/agents/workflow-preview-images";
-import { upsertMediaAsset } from "@/lib/db/queries";
+import { getSystemSetting, upsertMediaAsset } from "@/lib/db/queries";
 import { isSiteAdminType } from "@/lib/middleware/admin";
 import { getContentType, uploadFile } from "@/lib/storage/service";
 import { createLogger } from "@/lib/observability/logger";
+import {
+  defaultVideoCanvasFunctionConfig,
+  normalizeVideoCanvasFunctionConfig,
+  VIDEO_CANVAS_FUNCTION_CONFIG_KEY,
+} from "@/lib/video-canvas/config";
+import {
+  VIDEO_CANVAS_SUBJECT_UPLOAD_SOURCE_TYPE,
+  VIDEO_CANVAS_SUBJECT_VOICE_SOURCE_TYPE,
+} from "@/lib/video-canvas/subjects";
+import {
+  VIDEO_CANVAS_RESOURCE_UPLOAD_PURPOSE,
+  VIDEO_CANVAS_RESOURCE_UPLOAD_SOURCE_TYPE,
+} from "@/lib/video-canvas/uploaded-resource";
 import { OPENCLAW_CHAT_VIDEO_UPLOAD_PURPOSE } from "@/lib/openclaw-chat/media-attachments";
 
 const logger = createLogger("upload-api");
@@ -19,19 +28,21 @@ const ALLOWED_UPLOAD_IMAGE_TYPES = new Set([
   "image/jpg",
   "image/png",
   "image/webp",
-  "image/avif",
-  "image/tiff",
-  "image/x-tiff",
   "image/svg+xml",
   "image/heic",
   "image/heif",
 ]);
-const ALLOWED_ATLASCLOUD_VIDEO_TYPES = new Set([
+const ALLOWED_UPLOAD_AUDIO_TYPES = new Set([
-  "video/mp4",
+  "audio/mpeg",
-  "video/quicktime",
+  "audio/mp3",
-  "video/webm",
+  "audio/mp4",
+  "audio/wav",
+  "audio/x-wav",
+  "audio/webm",
+  "audio/ogg",
+  "audio/aac",
 ]);
-const ALLOWED_OPENCLAW_VIDEO_TYPES = new Set([
+const ALLOWED_UPLOAD_VIDEO_TYPES = new Set([
   "video/mp4",
   "video/quicktime",
   "video/webm",
@@ -40,14 +51,10 @@ const ALLOWED_OPENCLAW_VIDEO_TYPES = new Set([
 ]);
 
 const HEIC_UPLOAD_TYPES = new Set(["image/heic", "image/heif"]);
-const SHARP_COMPATIBILITY_UPLOAD_TYPES = new Set([
+const GAUSSIAN_SPLAT_EXTENSION_RE = /\.(ply|splat|spz|ksplat)$/i;
-  "image/avif",
-  "image/tiff",
-  "image/x-tiff",
-]);
 
 function normalizeUploadContentType(contentType: string, filename: string) {
-  const normalized = contentType.trim().toLowerCase();
+  const normalized = contentType.split(";", 1)[0].trim().toLowerCase();
   if (normalized && normalized !== "application/octet-stream") {
     return normalized;
   }
@@ -55,21 +62,22 @@ function normalizeUploadContentType(contentType: string, filename: string) {
   return getContentType(filename);
 }
 
+function getAcceptedMimeTypes(accept: string) {
+  return new Set(
+    accept
+      .split(",")
+      .map((item) => item.trim().toLowerCase())
+      .filter((item) => item.includes("/") && !item.endsWith("/*")),
+  );
+}
+
 function createUnsupportedImageTypeMessage(contentType: string, filename: string) {
   const extension = filename.toLowerCase().split(".").pop() || "unknown";
   if (contentType === "image/heic" || contentType === "image/heif" || extension === "heic" || extension === "heif") {
     return "HEIC/HEIF 图片转码失败，请在手机相册中导出为 JPG/PNG 后再上传。";
   }
-  if (
-    SHARP_COMPATIBILITY_UPLOAD_TYPES.has(contentType) ||
-    extension === "avif" ||
-    extension === "tif" ||
-    extension === "tiff"
-  ) {
-    return "AVIF/TIFF 图片转码失败，请导出为 JPG/PNG 后再上传。";
-  }
 
-  return "图片格式不支持，请上传 JPG、PNG、WebP、HEIC、AVIF 或 TIFF 图片。";
+  return "File type should be JPEG, PNG, WebP or SVG";
 }
 
 function isHeicUpload(contentType: string, filename: string) {
@@ -81,20 +89,10 @@ function isHeicUpload(contentType: string, filename: string) {
   );
 }
 
-function isSharpCompatibilityUpload(contentType: string, filename: string) {
-  const extension = filename.toLowerCase().split(".").pop() || "";
-  return (
-    SHARP_COMPATIBILITY_UPLOAD_TYPES.has(contentType) ||
-    extension === "avif" ||
-    extension === "tif" ||
-    extension === "tiff"
-  );
-}
-
 function toJpegFilename(filename: string) {
   const trimmed = filename.trim() || `upload-${Date.now()}`;
-  if (/\.(avif|heic|heif|tif|tiff)$/i.test(trimmed)) {
+  if (/\.(heic|heif)$/i.test(trimmed)) {
-    return trimmed.replace(/\.(avif|heic|heif|tif|tiff)$/i, ".jpg");
+    return trimmed.replace(/\.(heic|heif)$/i, ".jpg");
   }
   if (/\.[a-z0-9]+$/i.test(trimmed)) {
     return trimmed.replace(/\.[a-z0-9]+$/i, ".jpg");
@@ -114,21 +112,6 @@ async function convertHeicToJpeg(buffer: Buffer): Promise<Buffer> {
   }
   return Buffer.from(output);
 }
-
-async function convertSharpCompatibilityImageToJpeg(
-  buffer: Buffer
-): Promise<Buffer> {
-  const sharp = (await import("sharp")).default;
-  return sharp(buffer, { animated: false, failOn: "none" })
-    .rotate()
-    .flatten({ background: "#ffffff" })
-    .jpeg({
-      quality: 92,
-      mozjpeg: true,
-      progressive: true,
-    })
-    .toBuffer();
-}
 /**
  * 使用Sharp智能优化图片（保持原格式）
  * 策略：避免双重压缩，只在需要时优化
@@ -212,24 +195,17 @@ function toArrayBuffer(buffer: Buffer): ArrayBuffer {
 }
 
 // Use Blob instead of File since File is not available in Node.js environment
-const FileSchema = z.object({
+function createFileSchema(maxBytes: number, maxSizeLabel: string) {
-  file: z
+  return z.object({
-    .instanceof(Blob)
+    file: z.instanceof(Blob).refine((value) => value.size <= maxBytes, {
-    .refine((file) => file.size <= 50 * 1024 * 1024, {
+      message: `File size should be less than ${maxSizeLabel}`,
-      message: "File size should be less than 50MB",
     }),
-});
+  });
+}
 
 export async function POST(request: Request) {
   logger.debug("[Upload API] Received upload request");
 
-  const session = await auth();
-
-  if (!session) {
-    logger.debug("[Upload API] Unauthorized - no session");
-    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
-  }
-
   if (request.body === null) {
     logger.debug("[Upload API] Request body is empty");
     return new Response("Request body is empty", { status: 400 });
@@ -255,24 +231,88 @@ export async function POST(request: Request) {
     let filename = originalFilename;
     let contentType = originalContentType;
     const uploadPurpose = String(formData.get("purpose") || "");
-    const isAtlasCloudReferenceVideo =
+    const isDirectorGaussianUpload = uploadPurpose === "director-gaussian";
-      uploadPurpose === "canvas-video-process" &&
+    const isCanvasAudioUpload = uploadPurpose === "canvas-audio-process";
-      ALLOWED_ATLASCLOUD_VIDEO_TYPES.has(contentType);
+    const isCanvasVideoUpload = uploadPurpose === "canvas-video-process";
     const isOpenClawChatVideoUpload =
-      uploadPurpose === OPENCLAW_CHAT_VIDEO_UPLOAD_PURPOSE &&
+      uploadPurpose === OPENCLAW_CHAT_VIDEO_UPLOAD_PURPOSE;
-      ALLOWED_OPENCLAW_VIDEO_TYPES.has(contentType);
+    const isVideoCanvasAssetLibraryUpload =
+      uploadPurpose === "video-canvas-asset-library";
+    const isVideoCanvasResourceUpload =
+      uploadPurpose === VIDEO_CANVAS_RESOURCE_UPLOAD_PURPOSE;
+    const isVideoCanvasSubjectUpload =
+      uploadPurpose === "video-canvas-subject";
+    const isVideoCanvasSubjectVoiceUpload =
+      uploadPurpose === "video-canvas-subject-voice";
+    const videoCanvasSetting =
+      isDirectorGaussianUpload ||
+      isVideoCanvasResourceUpload ||
+      isVideoCanvasSubjectUpload
+        ? await getSystemSetting({ key: VIDEO_CANVAS_FUNCTION_CONFIG_KEY }).catch(
+            () => undefined,
+          )
+        : undefined;
+    const videoCanvasConfig = videoCanvasSetting
+      ? normalizeVideoCanvasFunctionConfig(videoCanvasSetting.value)
+      : defaultVideoCanvasFunctionConfig;
+    const gaussianConfig = videoCanvasConfig.directorDesk.gaussian;
+    const subjectLibraryConfig = videoCanvasConfig.subjectLibrary;
+    if (
+      isDirectorGaussianUpload &&
+      !GAUSSIAN_SPLAT_EXTENSION_RE.test(originalFilename)
+    ) {
+      return NextResponse.json(
+        { error: `高斯泼溅仅支持 ${gaussianConfig.uploadAccept}` },
+        { status: 400 },
+      );
+    }
+    if (isVideoCanvasSubjectUpload) {
+      const acceptedTypes = new Set([
+        ...getAcceptedMimeTypes(subjectLibraryConfig.imageAccept),
+        ...getAcceptedMimeTypes(subjectLibraryConfig.videoAccept),
+      ]);
+      if (!acceptedTypes.has(originalContentType)) {
+        return NextResponse.json(
+          { error: "主体素材仅支持 JPG、PNG、WebP、MP4 或 MOV" },
+          { status: 400 },
+        );
+      }
+    }
+    if (
+      isVideoCanvasSubjectVoiceUpload &&
+      !ALLOWED_UPLOAD_AUDIO_TYPES.has(originalContentType) &&
+      !ALLOWED_UPLOAD_VIDEO_TYPES.has(originalContentType)
+    ) {
+      return NextResponse.json(
+        { error: "音色素材仅支持 MP3、WAV、MP4 或 MOV" },
+        { status: 400 },
+      );
+    }
+    const requestHostname = new URL(request.url).hostname.toLowerCase();
+    const isLoopbackRequest =
+      requestHostname === "localhost" ||
+      requestHostname === "127.0.0.1" ||
+      requestHostname === "::1";
+    const isLocalDevelopmentCanvasUpload =
+      (process.env.NODE_ENV !== "production" || isLoopbackRequest) &&
+      process.env.USE_REMOTE_STORAGE_IN_DEV !== "true" &&
+      (uploadPurpose === "canvas-upload" ||
+        isCanvasAudioUpload ||
+        isCanvasVideoUpload ||
+        isOpenClawChatVideoUpload ||
+        isDirectorGaussianUpload);
+    const session = isLocalDevelopmentCanvasUpload ? null : await auth();
+
+    if (!isLocalDevelopmentCanvasUpload && !session) {
+      logger.debug("[Upload API] Unauthorized - no session");
+      return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+    }
     const clientUploadId =
       String(formData.get("clientUploadId") || "").trim() || null;
     const isSvgUpload = contentType === "image/svg+xml";
-    if (contentType.startsWith("image/") && isImageUploadTooLarge(file.size)) {
-      return NextResponse.json(
-        { error: IMAGE_UPLOAD_TOO_LARGE_MESSAGE },
-        { status: 413 }
-      );
-    }
     if (
       isSvgUpload &&
-      (uploadPurpose !== "admin-svg-icon" || !isSiteAdminType(session.user.type))
+      (uploadPurpose !== "admin-svg-icon" || !isSiteAdminType(session?.user.type))
     ) {
       return NextResponse.json(
         { error: "SVG uploads are only allowed for administrator icon settings" },
@@ -286,7 +326,19 @@ export async function POST(request: Request) {
       sizeInMB: (file.size / 1024 / 1024).toFixed(2) + "MB"
     });
 
-    const validatedFile = FileSchema.safeParse({ file });
+    const maxFileSizeMb = isDirectorGaussianUpload
+      ? gaussianConfig.maxFileSizeMb
+      : isVideoCanvasResourceUpload
+        ? videoCanvasConfig.nodeCreation.upload.maxFileSizeMb
+      : isVideoCanvasSubjectUpload
+        ? originalContentType.startsWith("video/")
+          ? subjectLibraryConfig.videoMaxFileSizeMb
+          : subjectLibraryConfig.imageMaxFileSizeMb
+        : 50;
+    const validatedFile = createFileSchema(
+      maxFileSizeMb * 1024 * 1024,
+      `${maxFileSizeMb}MB`,
+    ).safeParse({ file });
 
     if (!validatedFile.success) {
       const errorMessage = validatedFile.error.errors
@@ -298,9 +350,34 @@ export async function POST(request: Request) {
     }
 
     if (
+      !isDirectorGaussianUpload &&
       !ALLOWED_UPLOAD_IMAGE_TYPES.has(contentType) &&
-      !isAtlasCloudReferenceVideo &&
+      !(isCanvasAudioUpload && ALLOWED_UPLOAD_AUDIO_TYPES.has(contentType)) &&
-      !isOpenClawChatVideoUpload
+      !(isCanvasVideoUpload && ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType)) &&
+      !(
+        isOpenClawChatVideoUpload &&
+        ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType)
+      ) &&
+      !(
+        isVideoCanvasAssetLibraryUpload &&
+        (ALLOWED_UPLOAD_AUDIO_TYPES.has(contentType) ||
+          ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType))
+      ) &&
+      !(
+        isVideoCanvasResourceUpload &&
+        (ALLOWED_UPLOAD_IMAGE_TYPES.has(contentType) ||
+          ALLOWED_UPLOAD_AUDIO_TYPES.has(contentType) ||
+          ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType))
+      ) &&
+      !(
+        isVideoCanvasSubjectUpload &&
+        ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType)
+      ) &&
+      !(
+        isVideoCanvasSubjectVoiceUpload &&
+        (ALLOWED_UPLOAD_AUDIO_TYPES.has(contentType) ||
+          ALLOWED_UPLOAD_VIDEO_TYPES.has(contentType))
+      )
     ) {
       const errorMessage = createUnsupportedImageTypeMessage(contentType, filename);
       logger.warn("[Upload API] Unsupported upload content type", {
@@ -322,7 +399,7 @@ export async function POST(request: Request) {
       let uploadBuffer: Buffer = Buffer.from(fileBuffer);
       let convertedFrom: string | null = null;
 
-      if (isHeicUpload(contentType, filename)) {
+      if (!isDirectorGaussianUpload && isHeicUpload(contentType, filename)) {
         try {
           const convertedBuffer = await convertHeicToJpeg(uploadBuffer);
           logger.info("[Upload API] HEIC image converted to JPEG", {
@@ -351,38 +428,6 @@ export async function POST(request: Request) {
             { status: 400 }
           );
         }
-      } else if (isSharpCompatibilityUpload(contentType, filename)) {
-        try {
-          const convertedBuffer =
-            await convertSharpCompatibilityImageToJpeg(uploadBuffer);
-          logger.info("[Upload API] Compatibility image converted to JPEG", {
-            clientUploadId,
-            originalContentType: contentType,
-            originalSize: uploadBuffer.length,
-            convertedSize: convertedBuffer.length,
-          });
-          uploadBuffer = convertedBuffer;
-          filename = toJpegFilename(filename);
-          convertedFrom = contentType;
-          contentType = "image/jpeg";
-        } catch (conversionError) {
-          logger.warn("[Upload API] Compatibility image conversion failed", {
-            clientUploadId,
-            contentType,
-            size: uploadBuffer.length,
-            error:
-              conversionError instanceof Error
-                ? conversionError.message
-                : String(conversionError),
-          });
-          return NextResponse.json(
-            {
-              error: createUnsupportedImageTypeMessage(contentType, filename),
-              clientUploadId,
-            },
-            { status: 400 }
-          );
-        }
       }
 
       if (uploadPurpose === "agent-workflow-preview" && contentType !== "image/svg+xml") {
@@ -395,7 +440,7 @@ export async function POST(request: Request) {
         let assetId: string | null = null;
         try {
           const asset = await upsertMediaAsset({
-            userId: session.user.id,
+            userId: session?.user.id || "",
             mediaType: "image",
             sourceType: "agent_workflow_preview_upload",
             status: "ready",
@@ -441,7 +486,10 @@ export async function POST(request: Request) {
       // ✅ 优化原图（保持JPG/PNG格式）
       // WebP格式不优化（用于预览图，保持原样）
       const shouldOptimizeImage =
+        !isCanvasAudioUpload &&
+        !isCanvasVideoUpload &&
         uploadPurpose !== "canvas-upload" &&
+        !isDirectorGaussianUpload &&
         (contentType === 'image/jpeg' || contentType === 'image/jpg' || contentType === 'image/png');
 
       if (shouldOptimizeImage) {
@@ -449,7 +497,13 @@ export async function POST(request: Request) {
       } else if (contentType === 'image/webp' || contentType === 'image/svg+xml') {
         // WebP/SVG 不优化；SVG 是矢量文件，交给前端按状态反色渲染。
         logger.debug(`[Upload] ${contentType}格式，跳过优化，直接上传`);
-      } else if (uploadPurpose === "canvas-upload") {
+      } else if (
+        uploadPurpose === "canvas-upload" ||
+        isCanvasAudioUpload ||
+        isCanvasVideoUpload ||
+        isOpenClawChatVideoUpload ||
+        isDirectorGaussianUpload
+      ) {
         logger.debug("[Upload] Canvas upload, skip server-side image optimization for faster paste/drop");
       }
       
@@ -464,47 +518,83 @@ export async function POST(request: Request) {
       const data = await uploadFile(filename, optimizedArrayBuffer);
 
       let assetId: string | null = null;
-      try {
+      const isLocalDevelopmentUpload = data.pathname.startsWith("uploads/local/");
-        const asset = await upsertMediaAsset({
+      if (
-          userId: session.user.id,
+        !isLocalDevelopmentUpload ||
-          mediaType:
+        isVideoCanvasResourceUpload ||
-            isAtlasCloudReferenceVideo || isOpenClawChatVideoUpload
+        isVideoCanvasAssetLibraryUpload ||
-              ? "video"
+        isVideoCanvasSubjectUpload ||
-              : "image",
+        isVideoCanvasSubjectVoiceUpload
-          sourceType: isOpenClawChatVideoUpload
+      ) {
-            ? "openclaw_chat_video_upload"
+        try {
-            : "upload",
+          const uploadedMediaType = isDirectorGaussianUpload
-          status: "ready",
+            ? "model"
-          originalUrl: data.url,
+            : isCanvasAudioUpload || contentType.startsWith("audio/")
-          previewUrl:
+              ? "audio"
-            isAtlasCloudReferenceVideo || isOpenClawChatVideoUpload
+              : isCanvasVideoUpload || contentType.startsWith("video/")
-              ? null
+                ? "video"
-              : data.url,
+                : "image";
-          thumbnailUrl:
+          const asset = await upsertMediaAsset({
-            isAtlasCloudReferenceVideo || isOpenClawChatVideoUpload
+            userId: session?.user.id || "",
-              ? null
+            mediaType: uploadedMediaType,
-              : data.url,
+            sourceType: isDirectorGaussianUpload
-          mimeType: data.contentType || contentType || null,
+              ? "director_gaussian_upload"
-          displayName: filename,
+              : isCanvasAudioUpload
-          sourceTable: isOpenClawChatVideoUpload
+                ? "canvas_audio_process"
-            ? "openclaw_chat_video_upload"
+                : isCanvasVideoUpload
-            : "upload",
+                ? "canvas_video_process"
-          metadata: {
+                : isOpenClawChatVideoUpload
-            pathname: data.pathname,
+                  ? "openclaw_chat_video_upload"
-            size: optimizedBuffer.length,
+                  : isVideoCanvasResourceUpload
-            purpose: uploadPurpose || null,
+                    ? VIDEO_CANVAS_RESOURCE_UPLOAD_SOURCE_TYPE
-            clientUploadId,
+                  : isVideoCanvasAssetLibraryUpload
-            convertedFrom,
+                    ? "video_canvas_asset_library_upload"
-          },
+                    : isVideoCanvasSubjectUpload
-        });
+                      ? VIDEO_CANVAS_SUBJECT_UPLOAD_SOURCE_TYPE
-        assetId = asset?.id ?? null;
+                      : isVideoCanvasSubjectVoiceUpload
-      } catch (assetError) {
+                        ? VIDEO_CANVAS_SUBJECT_VOICE_SOURCE_TYPE
-        logger.warn("[Upload API] Failed to register uploaded image as media asset:", assetError);
+                    : "upload",
+            status: "ready",
+            originalUrl: data.url,
+            previewUrl: isDirectorGaussianUpload ? null : data.url,
+            thumbnailUrl: isDirectorGaussianUpload ? null : data.url,
+            mimeType: contentType || data.contentType || null,
+            displayName: filename,
+            sourceTable: isDirectorGaussianUpload
+              ? "director_gaussian_upload"
+              : isCanvasAudioUpload
+                ? "canvas_audio_process"
+                : isCanvasVideoUpload
+                ? "canvas_video_process"
+                : isOpenClawChatVideoUpload
+                  ? "openclaw_chat_video_upload"
+                : isVideoCanvasResourceUpload
+                  ? VIDEO_CANVAS_RESOURCE_UPLOAD_SOURCE_TYPE
+                : isVideoCanvasSubjectUpload
+                    ? VIDEO_CANVAS_SUBJECT_UPLOAD_SOURCE_TYPE
+                    : isVideoCanvasSubjectVoiceUpload
+                      ? VIDEO_CANVAS_SUBJECT_VOICE_SOURCE_TYPE
+                : "upload",
+            metadata: {
+              pathname: data.pathname,
+              size: optimizedBuffer.length,
+              clientUploadId,
+              convertedFrom,
+              purpose: uploadPurpose || null,
+              category:
+                String(formData.get("assetCategory") || "").trim() || null,
+            },
+          });
+          assetId = asset?.id ?? null;
+        } catch (assetError) {
+          logger.warn("[Upload API] Failed to register uploaded image as media asset:", assetError);
+        }
       }
 
       logger.debug("[Upload API] Upload successful:", data.url);
       return NextResponse.json({
         ...data,
+        contentType,
         assetId,
         clientUploadId,
         convertedFrom,

app/(chat)/api/models/route.ts

@@ -10,10 +10,6 @@ import {
 } from "@/lib/db/queries";
 import { getAiModelFrontendAvailability } from "@/lib/ai/model-frontend-availability";
 import { buildVideoToolCapability } from "@/lib/ai/video-tool-capability";
-import {
-  DETAIL_REPLACEMENT_IMAGE_MODEL_CONFIG_KEY,
-  findConfiguredDetailReplacementImageModel,
-} from "@/lib/ai/detail-replacement-image-model-config";
 import {
   isImageGenerationModelDescriptor,
   isVideoModelDescriptor,
@@ -76,73 +72,6 @@ function isWorkflowImageGenerationModel(model: {
 // 获取前端可用的 AI 模型列表（需要登录但不需要管理员权限）
 export async function GET(request: Request) {
   try {
-    const isLocalCanvasE2E = process.env.CANVAS_E2E_LOCAL === "true";
-
-    if (isLocalCanvasE2E) {
-      const models = [
-        {
-          id: "local-e2e-image-model",
-          modelId: "nano-banana-pro-local",
-          displayName: "Nano Banana Pro",
-          avatarUrl: null,
-          description: "本地视频画布测试图片模型",
-          supportsVision: true,
-          supportsImageGen: true,
-          isMultimodal: true,
-          isDefault: true,
-          providerName: "Local E2E",
-          providerType: "local",
-          isSubModel: false,
-          parentModelId: null,
-          capabilities: { image: true },
-          videoToolCapability: null,
-          imageGenConfig: {
-            creditCostPerImage: 1,
-            creditCostPerVideo: 20,
-            videoDurationOptions: [5, 10],
-          },
-          sortOrder: 0,
-          selectable: true,
-        },
-        {
-          id: "local-e2e-video-model",
-          modelId: "veo-3.1-fast",
-          displayName: "Veo 3.1 Fast（本地布局测试）",
-          avatarUrl: null,
-          description: "本地视频画布测试视频模型",
-          supportsVision: true,
-          supportsImageGen: false,
-          isMultimodal: true,
-          isDefault: false,
-          providerName: "Local E2E",
-          providerType: "vip98k",
-          isSubModel: false,
-          parentModelId: null,
-          capabilities: { kind: "video", supportedModes: ["text-to-video", "first-frame", "first-last-frame", "reference-images"], supportedRatios:["16:9"], supportedResolutions:["720p","1080p"], durationOptions:[8], maxReferenceImages:3 },
-          videoToolCapability: {
-            supported: true,
-            durations: [8],
-            resolutions: ["720p", "1080p"],
-          },
-          imageGenConfig: {
-            creditCostPerVideo: 20,
-            videoDurationOptions: [8],
-          },
-          sortOrder: 1,
-          selectable: true,
-        },
-      ];
-
-      return Response.json({
-        models,
-        defaultModelId: models[0].id,
-        agentWorkflowConfiguredDefaultModelId: null,
-        agentWorkflowDefaultModelId: null,
-        agentWorkflowConfiguredModels: [],
-        agentModel: null,
-      });
-    }
-
     const session = await auth();
 
     if (!session?.user) {
@@ -161,17 +90,10 @@ export async function GET(request: Request) {
       : await getEnabledAiModelsWithProvider(false, true);
     const agentModelWithProvider = await getAgentAiModelWithProvider();
     const defaultModel = await getDefaultAiModel();
-    const [siteSettings, agentWorkflowUiConfigSetting, detailReplacementModelSetting] = await Promise.all([
+    const [siteSettings, agentWorkflowUiConfigSetting] = await Promise.all([
       getSiteSettings(),
       getSystemSetting({ key: AGENT_WORKFLOW_UI_CONFIG_KEY }).catch(() => null),
-      getSystemSetting({ key: DETAIL_REPLACEMENT_IMAGE_MODEL_CONFIG_KEY }).catch(() => null),
     ]);
-    const detailReplacementModel = findConfiguredDetailReplacementImageModel(
-      includeUnavailable ? modelsWithProvider.filter(({ model, provider }) =>
-        provider.isEnabled && model.isEnabled && getAiModelFrontendAvailability(model).selectable !== false
-      ) : modelsWithProvider,
-      detailReplacementModelSetting?.value,
-    );
     type ModelWithProvider = (typeof modelsWithProvider)[number];
     const serializeModel = ({ model, provider }: ModelWithProvider) => ({
       id: model.id,
@@ -320,7 +242,6 @@ export async function GET(request: Request) {
         : null,
       agentWorkflowDefaultModelId: agentWorkflowDefaultModel?.model.id || null,
       agentWorkflowConfiguredModels,
-      detailReplacementModel: detailReplacementModel ? serializeModel(detailReplacementModel) : null,
       agentModel: agentModelWithProvider
         ? {
             id: agentModelWithProvider.model.id,

app/(chat)/featured/page.tsx

@@ -8,8 +8,6 @@ import { ArrowLeft, Download, ChevronLeft, ChevronRight, ChevronsLeft, ChevronsR
 import { Input } from "@/components/ui/input";
 import Image from "next/image";
 import { formatBeijingTime } from "@/lib/utils";
-import { toast } from "sonner";
-import { downloadOriginalImage, getCanvasImageDownloadErrorMessage } from "@/lib/client/canvas-image-download";
 
 type FeaturedImage = {
   id: string;
@@ -76,11 +74,18 @@ export default function FeaturedPage() {
 
   const handleDownload = async (url: string, prompt: string) => {
     try {
-      await downloadOriginalImage({ url, name: "featured-image" });
+      const response = await fetch(url);
-      toast.success("原图已开始下载");
+      const blob = await response.blob();
+      const blobUrl = window.URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = blobUrl;
+      link.download = `featured-${Date.now()}.png`;
+      document.body.appendChild(link);
+      link.click();
+      document.body.removeChild(link);
+      window.URL.revokeObjectURL(blobUrl);
     } catch (error) {
       console.error("Download failed:", error);
-      toast.error(getCanvasImageDownloadErrorMessage(error));
     }
   };
 

app/(chat)/flow-board/layout.tsx

@@ -3,5 +3,10 @@ export default function FlowBoardLayout({
 }: {
   children: React.ReactNode;
 }) {
-  return <>{children}</>;
+  return (
+    <>
+      <link href="/vendor/drawnix.css" rel="stylesheet" />
+      {children}
+    </>
+  );
 }

app/(chat)/gallery/page.tsx

@@ -1,5 +1,4 @@
 "use client";
-import { isRetiredStorageUrl, RETIRED_STORAGE_MESSAGE } from "@/lib/storage/retired-storage";
 
 import { useState, useEffect } from "react";
 import { useRouter } from "next/navigation";
@@ -10,10 +9,9 @@ import { Input } from "@/components/ui/input";
 import Image from "next/image";
 import { toast } from "sonner";
 import { requestLongTaskResult } from "@/lib/client/long-task";
-import { buildImageProxyUrl, getImageDownloadExtension } from "@/lib/image-delivery";
+import { buildImageProxyUrl } from "@/lib/image-delivery";
 import { inferOriginalImageUrl } from "@/lib/image-url";
 import { formatBeijingTime } from "@/lib/utils";
-import { downloadOriginalImage, getCanvasImageDownloadErrorMessage } from "@/lib/client/canvas-image-download";
 
 type GalleryImage = {
   id: string;
@@ -34,7 +32,7 @@ type Pagination = {
   totalPages: number;
 };
 
-function buildGalleryDownloadFilename(url: string, alt: string, contentType: string) {
+function buildGalleryDownloadFilename(url: string, alt: string) {
   const rawUrl = String(url || "").trim();
   const rawAlt = String(alt || "").trim();
   const safeBase =
@@ -60,7 +58,7 @@ function buildGalleryDownloadFilename(url: string, alt: string, contentType: str
     }
   }
 
-  return `${safeBase}.${getImageDownloadExtension(contentType) || extension}`;
+  return `${safeBase}-${Date.now()}.${extension}`;
 }
 
 export default function GalleryPage() {
@@ -105,7 +103,7 @@ export default function GalleryPage() {
   };
 
   const handleDownload = async (url: string, alt: string) => {
-    const originalUrl = String(url || "").trim();
+    const originalUrl = inferOriginalImageUrl(String(url || "").trim());
     if (!originalUrl) {
       toast.error("图片地址无效");
       return;
@@ -114,17 +112,32 @@ export default function GalleryPage() {
     try {
       toast.info("正在准备下载...");
 
-      // Validate the supplied URL before any legacy thumbnail inference can
+      const response = await fetch(
-      // remove signed storage transformation parameters.
+        buildImageProxyUrl(originalUrl, { delivery: "proxy" })
-      buildImageProxyUrl(originalUrl, { delivery: "original" });
+      );
-      const parsed = new URL(originalUrl, window.location.origin);
+      if (!response.ok) {
-      const source = parsed.pathname === "/api/image-proxy" ? originalUrl : inferOriginalImageUrl(originalUrl);
+        throw new Error(`download failed: ${response.status}`);
-
+      }
-      await downloadOriginalImage({ url: source, name: buildGalleryDownloadFilename(originalUrl, alt, "") });
+      const blob = await response.blob();
+      const blobUrl = window.URL.createObjectURL(blob);
+      const link = document.createElement("a");
+      link.href = blobUrl;
+      link.download = buildGalleryDownloadFilename(originalUrl, alt);
+      document.body.appendChild(link);
+      link.click();
+      document.body.removeChild(link);
+      window.setTimeout(() => window.URL.revokeObjectURL(blobUrl), 1000);
       toast.success("图片已开始下载");
     } catch (error) {
       console.error("Download failed:", error);
-      toast.error(getCanvasImageDownloadErrorMessage(error));
+      const fallbackLink = document.createElement("a");
+      fallbackLink.href = originalUrl;
+      fallbackLink.target = "_blank";
+      fallbackLink.rel = "noopener noreferrer";
+      document.body.appendChild(fallbackLink);
+      fallbackLink.click();
+      document.body.removeChild(fallbackLink);
+      toast.error("下载失败，已为你打开原图，可直接另存为");
     }
   };
 
@@ -304,12 +317,7 @@ export default function GalleryPage() {
         <>
           <div className="flex-1 overflow-y-auto">
             <div className="flex flex-wrap justify-center gap-6 px-4">
-              {images.map((img) => isRetiredStorageUrl(img.url) ? (
+              {images.map((img) => (
-                <div key={img.id} className="flex h-[270px] w-[200px] shrink-0 flex-col justify-center rounded-lg border bg-muted p-4 text-center text-sm text-muted-foreground">
-                  <p>{RETIRED_STORAGE_MESSAGE}</p>
-                  <p className="mt-3 line-clamp-3 text-xs">{img.alt}</p>
-                </div>
-              ) : (
                 <div
                   key={img.id}
                   className="group relative cursor-pointer rounded-lg border bg-muted overflow-hidden transition-all hover:shadow-lg hover:scale-105"
@@ -318,7 +326,7 @@ export default function GalleryPage() {
                 >
                   <div className="relative w-full h-full">
                     <Image
-                      src={isRetiredStorageUrl(img.thumbnailUrl) ? img.url : img.thumbnailUrl || img.url}
+                      src={img.thumbnailUrl || img.url}
                       alt={img.alt}
                       width={200}
                       height={270}

app/(chat)/layout.tsx

@@ -1,6 +1,5 @@
 import { Suspense } from "react";
 import { ChatShell } from "@/components/chat-shell";
-import { CanvasLogoLoadingView } from "@/components/canvas/canvas-logo-loading";
 import { DataStreamProvider } from "@/components/data-stream-provider";
 import { auth } from "../(auth)/auth";
 import {
@@ -9,14 +8,10 @@ import {
   getTutorialVideos,
 } from "@/lib/db/queries";
 
-export const dynamic = "force-dynamic";
-
 export default function Layout({ children }: { children: React.ReactNode }) {
   return (
     <DataStreamProvider>
-      <Suspense
+      <Suspense fallback={<div className="flex h-dvh" />}>
-        fallback={<CanvasLogoLoadingView label="正在加载页面..." />}
-      >
         <SidebarWrapper>{children}</SidebarWrapper>
       </Suspense>
     </DataStreamProvider>

app/(chat)/video-canvas/page.tsx

@@ -1,75 +1,79 @@
+import { randomUUID } from "node:crypto";
 import { redirect } from "next/navigation";
-import { and, desc, eq } from "drizzle-orm";
 import { auth } from "@/app/(auth)/auth";
-import { VideoCanvasHome, type VideoCanvasHomeProject } from "@/components/canvas/VideoCanvasHome";
 import { db } from "@/lib/db";
-import { getSiteSettings } from "@/lib/db/queries";
 import { canvasProject } from "@/lib/db/schema";
+import { and, desc, eq } from "drizzle-orm";
 
-type Props = { searchParams?: Promise<Record<string, string | string[] | undefined>> };
+type VideoCanvasRedirectPageProps = {
+  searchParams?: Promise<Record<string, string | string[] | undefined>>;
+};
 
-function first(value: string | string[] | undefined) {
+function getSearchParam(
+  params: Record<string, string | string[] | undefined>,
+  key: string
+) {
+  const value = params[key];
   return Array.isArray(value) ? value[0] : value;
 }
 
-function canvasHref(id: string, incoming: Record<string, string | string[] | undefined>) {
+function buildVideoCanvasUrl(
-  const params = new URLSearchParams({ mode: "video", workspaceType: "video" });
+  canvasId: string,
-  for (const [key, value] of Object.entries(incoming)) {
+  params: Record<string, string | string[] | undefined>
-    if (["new", "mode", "workspaceType"].includes(key) || value === undefined) continue;
+) {
-    for (const item of Array.isArray(value) ? value : [value]) params.append(key, item);
+  const query = new URLSearchParams();
+  query.set("mode", "video");
+  query.set("workspaceType", "video");
+
+  for (const [key, value] of Object.entries(params)) {
+    if (
+      key === "new" ||
+      key === "mode" ||
+      key === "workspaceType" ||
+      value === undefined
+    ) {
+      continue;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((item) => query.append(key, item));
+      continue;
+    }
+    query.set(key, value);
   }
-  return `/canvas/${id}?${params.toString()}`;
+
+  return `/canvas/${canvasId}?${query.toString()}`;
 }
 
-function projectPreview(thumbnail: string | null, canvasData: unknown) {
+async function getLatestVideoCanvasId(userId: string) {
-  const nodes = canvasData && typeof canvasData === "object" && "nodes" in canvasData
+  const [latestProject] = await db
-    ? (canvasData as { nodes?: unknown }).nodes : null;
+    .select({ id: canvasProject.id })
-  const candidates = [thumbnail];
+    .from(canvasProject)
-  if (Array.isArray(nodes)) for (const node of [...nodes].reverse()) {
+    .where(
-    if (!node || typeof node !== "object") continue;
+      and(
-    const item = node as { inputType?: string; draftValues?: Record<string, unknown> };
+        eq(canvasProject.userId, userId),
-    const draft = item.draftValues || {};
+        eq(canvasProject.workspaceType, "video")
-    candidates.push(
+      )
-      String(draft.poster || draft.previewImageUrl || draft.thumbnailUrl || draft.resultImage || (item.inputType === "image" ? draft.mediaUrl || (Array.isArray(draft.url) ? draft.url[0] : "") : "") || ""),
+    )
-    );
+    .orderBy(desc(canvasProject.updatedAt))
-  }
+    .limit(1);
-  return candidates.find(value => typeof value === "string" && (value.startsWith("https://") || value.startsWith("/"))) || null;
+
+  return latestProject?.id || null;
 }
 
-export default async function VideoCanvasHomePage({ searchParams }: Props) {
+export default async function VideoCanvasRedirectPage({
-  const session = await auth();
+  searchParams,
-  if (!session?.user?.id) redirect("/login?callbackUrl=%2Fvideo-canvas");
+}: VideoCanvasRedirectPageProps) {
-
   const params = (await searchParams) || {};
-  if (first(params.new) === "1") {
+  const shouldCreateNew = getSearchParam(params, "new") === "1";
-    const [created] = await db.insert(canvasProject).values({
+
-      userId: session.user.id,
+  if (shouldCreateNew) {
-      title: "未命名视频画布",
+    redirect(buildVideoCanvasUrl(randomUUID(), params));
-      workspaceType: "video",
-      canvasData: { nodes: [], edges: [], viewport: { x: 0, y: 0, zoom: 1 } },
-    }).returning({ id: canvasProject.id });
-    redirect(canvasHref(created.id, params));
   }
 
-  const [rows, siteSettings] = await Promise.all([db.select({
+  const session = await auth();
-    id: canvasProject.id,
+  const latestCanvasId = session?.user?.id
-    title: canvasProject.title,
+    ? await getLatestVideoCanvasId(session.user.id).catch(() => null)
-    thumbnail: canvasProject.thumbnail,
+    : null;
-    canvasData: canvasProject.canvasData,
-    createdAt: canvasProject.createdAt,
-    updatedAt: canvasProject.updatedAt,
-  }).from(canvasProject).where(and(
-    eq(canvasProject.userId, session.user.id),
-    eq(canvasProject.workspaceType, "video"),
-  )).orderBy(desc(canvasProject.updatedAt)).limit(25), getSiteSettings()]);
 
-  const projects: VideoCanvasHomeProject[] = rows.slice(0, 24).map(row => ({
+  redirect(buildVideoCanvasUrl(latestCanvasId || randomUUID(), params));
-    id: row.id,
-    title: row.title,
-    thumbnail: projectPreview(row.thumbnail, row.canvasData),
-    createdAt: row.createdAt.toISOString(),
-    updatedAt: row.updatedAt.toISOString(),
-  }));
-
-  return <VideoCanvasHome initialHasMore={rows.length > 24} initialProjects={projects} siteLogo={siteSettings.siteLogo} siteLogoDark={siteSettings.siteLogoDark} siteName={siteSettings.siteName} userName={session.user.name || ""} />;
 }

app/api/admin/access-blocklist/route.ts

@@ -1,207 +0,0 @@
-import { desc, eq, sql } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { db } from "@/lib/db";
-import { accessIpBlocklist, user } from "@/lib/db/schema";
-import { ChatSDKError } from "@/lib/errors";
-import { requireAdmin } from "@/lib/middleware/admin";
-import { recordAccessIpEventFromHeaders } from "@/lib/security/access-log";
-import { normalizeManualBlockIp } from "@/lib/security/manual-ip-blocklist";
-
-export const runtime = "nodejs";
-export const maxDuration = 10;
-
-const createSchema = z.object({
-  ip: z.string().trim().min(1).max(128),
-  reason: z.string().trim().max(500).optional().nullable(),
-  expiresAt: z.string().trim().optional().nullable(),
-});
-
-const patchSchema = z.object({
-  id: z.string().uuid(),
-  isActive: z.boolean(),
-  reason: z.string().trim().max(500).optional().nullable(),
-  expiresAt: z.string().trim().optional().nullable(),
-});
-
-function normalizeOptionalDate(value?: string | null) {
-  const normalized = String(value || "").trim();
-  if (!normalized) return null;
-  const date = new Date(normalized);
-  return Number.isNaN(date.getTime()) ? null : date;
-}
-
-export async function GET() {
-  try {
-    await requireAdmin();
-
-    const entries = await db
-      .select({
-        id: accessIpBlocklist.id,
-        ip: accessIpBlocklist.ip,
-        reason: accessIpBlocklist.reason,
-        isActive: accessIpBlocklist.isActive,
-        expiresAt: accessIpBlocklist.expiresAt,
-        createdAt: accessIpBlocklist.createdAt,
-        updatedAt: accessIpBlocklist.updatedAt,
-        createdBy: accessIpBlocklist.createdBy,
-        createdByEmail: user.email,
-      })
-      .from(accessIpBlocklist)
-      .leftJoin(user, eq(accessIpBlocklist.createdBy, user.id))
-      .orderBy(desc(accessIpBlocklist.isActive), desc(accessIpBlocklist.updatedAt))
-      .limit(300);
-
-    return NextResponse.json({ entries });
-  } catch (error) {
-    if (error instanceof ChatSDKError) {
-      return error.toResponse();
-    }
-    console.error("[AccessIpBlocklist] failed to list entries", error);
-    return new ChatSDKError("offline:admin").toResponse();
-  }
-}
-
-export async function POST(request: Request) {
-  try {
-    const session = await requireAdmin();
-    const body = createSchema.parse(await request.json());
-    const normalizedIp = normalizeManualBlockIp(body.ip);
-
-    if (!normalizedIp) {
-      return new ChatSDKError(
-        "bad_request:api",
-        "请输入有效的 IP 地址或 IPv4 CIDR，例如 1.2.3.4 或 1.2.3.0/24"
-      ).toResponse();
-    }
-
-    const now = new Date();
-    const expiresAt = normalizeOptionalDate(body.expiresAt);
-    const reason = body.reason?.trim() || null;
-
-    const [existing] = await db
-      .select({ id: accessIpBlocklist.id })
-      .from(accessIpBlocklist)
-      .where(sql`lower(${accessIpBlocklist.ip}) = lower(${normalizedIp})`)
-      .limit(1);
-
-    const [entry] = existing
-      ? await db
-          .update(accessIpBlocklist)
-          .set({
-            reason,
-            isActive: true,
-            expiresAt,
-            updatedBy: session.user.id,
-            updatedAt: now,
-          })
-          .where(eq(accessIpBlocklist.id, existing.id))
-          .returning()
-      : await db
-          .insert(accessIpBlocklist)
-          .values({
-            ip: normalizedIp,
-            reason,
-            isActive: true,
-            expiresAt,
-            createdBy: session.user.id,
-            updatedBy: session.user.id,
-            createdAt: now,
-            updatedAt: now,
-          })
-          .returning();
-
-    await recordAccessIpEventFromHeaders({
-      eventType: "manual_block_added",
-      userId: session.user.id,
-      userEmail: session.user.email || null,
-      userRole: session.user.type,
-      method: "POST",
-      path: "/api/admin/access-blocklist",
-      routeGroup: "admin-api",
-      statusCode: 200,
-      outcome: "manual_block_added",
-      severity: "high",
-      reasons: ["管理员手动拉黑 IP"],
-      metadata: {
-        targetIp: normalizedIp,
-        reason,
-      },
-    }).catch((error) => {
-      console.warn("[AccessIpBlocklist] failed to record block action", error);
-    });
-
-    return NextResponse.json({ entry });
-  } catch (error) {
-    if (error instanceof ChatSDKError) {
-      return error.toResponse();
-    }
-    if (error instanceof z.ZodError) {
-      return new ChatSDKError("bad_request:api", error.message).toResponse();
-    }
-    console.error("[AccessIpBlocklist] failed to create entry", error);
-    return new ChatSDKError("offline:admin").toResponse();
-  }
-}
-
-export async function PATCH(request: Request) {
-  try {
-    const session = await requireAdmin();
-    const body = patchSchema.parse(await request.json());
-    const now = new Date();
-    const expiresAt = normalizeOptionalDate(body.expiresAt);
-
-    const [existing] = await db
-      .select({ ip: accessIpBlocklist.ip })
-      .from(accessIpBlocklist)
-      .where(eq(accessIpBlocklist.id, body.id))
-      .limit(1);
-
-    if (!existing) {
-      return new ChatSDKError("bad_request:api", "IP 黑名单记录不存在").toResponse();
-    }
-
-    const [entry] = await db
-      .update(accessIpBlocklist)
-      .set({
-        isActive: body.isActive,
-        reason: body.reason?.trim() || undefined,
-        expiresAt,
-        updatedBy: session.user.id,
-        updatedAt: now,
-      })
-      .where(eq(accessIpBlocklist.id, body.id))
-      .returning();
-
-    await recordAccessIpEventFromHeaders({
-      eventType: body.isActive ? "manual_block_enabled" : "manual_block_released",
-      userId: session.user.id,
-      userEmail: session.user.email || null,
-      userRole: session.user.type,
-      method: "PATCH",
-      path: "/api/admin/access-blocklist",
-      routeGroup: "admin-api",
-      statusCode: 200,
-      outcome: body.isActive ? "manual_block_enabled" : "manual_block_released",
-      severity: body.isActive ? "high" : "watch",
-      reasons: [body.isActive ? "管理员启用 IP 拉黑" : "管理员解除 IP 拉黑"],
-      metadata: {
-        targetIp: existing.ip,
-        blocklistId: body.id,
-      },
-    }).catch((error) => {
-      console.warn("[AccessIpBlocklist] failed to record update action", error);
-    });
-
-    return NextResponse.json({ entry });
-  } catch (error) {
-    if (error instanceof ChatSDKError) {
-      return error.toResponse();
-    }
-    if (error instanceof z.ZodError) {
-      return new ChatSDKError("bad_request:api", error.message).toResponse();
-    }
-    console.error("[AccessIpBlocklist] failed to update entry", error);
-    return new ChatSDKError("offline:admin").toResponse();
-  }
-}

app/api/admin/access-logs/route.ts

@@ -1,271 +0,0 @@
-import { and, desc, gte, sql, type SQL } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { db } from "@/lib/db";
-import { accessIpEvent } from "@/lib/db/schema";
-import { ChatSDKError } from "@/lib/errors";
-import { requireAdmin } from "@/lib/middleware/admin";
-
-export const runtime = "nodejs";
-export const maxDuration = 10;
-
-type Severity = "info" | "watch" | "high" | "critical";
-
-const severityByRank: Record<number, Severity> = {
-  0: "info",
-  1: "watch",
-  2: "high",
-  3: "critical",
-};
-
-function clampInt(value: string | null, fallback: number, min: number, max: number) {
-  const parsed = Number.parseInt(value || "", 10);
-  if (!Number.isFinite(parsed)) return fallback;
-  return Math.min(Math.max(parsed, min), max);
-}
-
-function normalizeSearch(value: string | null) {
-  return String(value || "").trim().slice(0, 120);
-}
-
-function buildSeverityFromAggregate(params: {
-  eventSeverityRank: number;
-  total: number;
-  failureCount: number;
-  rateLimitedCount: number;
-  authFailureCount: number;
-  suspiciousCount: number;
-}) {
-  let severity = severityByRank[params.eventSeverityRank] || "info";
-  const failureRate =
-    params.total > 0 ? params.failureCount / Math.max(params.total, 1) : 0;
-
-  if (params.rateLimitedCount > 0 || params.suspiciousCount > 0) {
-    severity = "high";
-  } else if (params.authFailureCount >= 5 || params.total >= 250) {
-    severity = severity === "critical" ? severity : "high";
-  } else if (
-    params.failureCount >= 20 ||
-    (params.total >= 10 && failureRate >= 0.45)
-  ) {
-    severity = severity === "critical" ? severity : "high";
-  } else if (params.authFailureCount > 0 || params.failureCount > 0) {
-    severity = severity === "info" ? "watch" : severity;
-  }
-
-  return severity;
-}
-
-function buildAggregateReasons(params: {
-  total: number;
-  failureCount: number;
-  rateLimitedCount: number;
-  authFailureCount: number;
-  suspiciousCount: number;
-  loginSuccessCount: number;
-}) {
-  const reasons: string[] = [];
-  const failureRate =
-    params.total > 0 ? params.failureCount / Math.max(params.total, 1) : 0;
-
-  if (params.rateLimitedCount > 0) reasons.push("触发限流");
-  if (params.authFailureCount >= 5) reasons.push("认证失败偏多");
-  if (params.suspiciousCount > 0) reasons.push("命中异常规则");
-  if (params.total >= 250) reasons.push("请求量偏高");
-  if (params.failureCount >= 20 || (params.total >= 10 && failureRate >= 0.45)) {
-    reasons.push("失败率偏高");
-  }
-  if (params.loginSuccessCount > 0 && reasons.length === 0) {
-    reasons.push("有成功登录记录");
-  }
-
-  return reasons;
-}
-
-export async function GET(request: Request) {
-  try {
-    await requireAdmin();
-
-    const { searchParams } = new URL(request.url);
-    const hours = clampInt(searchParams.get("hours"), 24, 1, 168);
-    const limit = clampInt(searchParams.get("limit"), 120, 25, 500);
-    const severityFilter = searchParams.get("severity") || "all";
-    const search = normalizeSearch(searchParams.get("q"));
-    const since = new Date(Date.now() - hours * 60 * 60 * 1000);
-    const whereParts: SQL[] = [gte(accessIpEvent.createdAt, since)];
-
-    if (severityFilter === "abnormal") {
-      whereParts.push(sql`${accessIpEvent.severity} <> 'info'`);
-    } else if (["info", "watch", "high", "critical"].includes(severityFilter)) {
-      whereParts.push(sql`${accessIpEvent.severity} = ${severityFilter}`);
-    }
-
-    if (search) {
-      const pattern = `%${search}%`;
-      whereParts.push(sql`(
-        ${accessIpEvent.ip} ILIKE ${pattern}
-        OR ${accessIpEvent.path} ILIKE ${pattern}
-        OR ${accessIpEvent.userEmail} ILIKE ${pattern}
-        OR ${accessIpEvent.userAgent} ILIKE ${pattern}
-      )`);
-    }
-
-    const whereClause = and(...whereParts);
-
-    const [overview] = await db
-      .select({
-        totalEvents: sql<number>`count(*)::int`,
-        uniqueIps: sql<number>`count(distinct ${accessIpEvent.ip})::int`,
-        abnormalEvents: sql<number>`count(*) filter (where ${accessIpEvent.severity} <> 'info')::int`,
-        abnormalIps: sql<number>`count(distinct ${accessIpEvent.ip}) filter (where ${accessIpEvent.severity} <> 'info')::int`,
-        rateLimitedEvents: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'rate_limited' or ${accessIpEvent.statusCode} = 429)::int`,
-        manualBlockedEvents: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'manual_blocked')::int`,
-        loginSuccessEvents: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'login_success')::int`,
-        unauthorizedEvents: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'unauthorized' or ${accessIpEvent.statusCode} in (401, 403))::int`,
-      })
-      .from(accessIpEvent)
-      .where(whereClause);
-
-    const recentEvents = await db
-      .select({
-        id: accessIpEvent.id,
-        eventType: accessIpEvent.eventType,
-        ip: accessIpEvent.ip,
-        userId: accessIpEvent.userId,
-        userEmail: accessIpEvent.userEmail,
-        userRole: accessIpEvent.userRole,
-        method: accessIpEvent.method,
-        path: accessIpEvent.path,
-        routeGroup: accessIpEvent.routeGroup,
-        statusCode: accessIpEvent.statusCode,
-        outcome: accessIpEvent.outcome,
-        severity: accessIpEvent.severity,
-        reasons: accessIpEvent.reasons,
-        userAgent: accessIpEvent.userAgent,
-        referer: accessIpEvent.referer,
-        occurredAt: accessIpEvent.occurredAt,
-        createdAt: accessIpEvent.createdAt,
-      })
-      .from(accessIpEvent)
-      .where(whereClause)
-      .orderBy(desc(accessIpEvent.createdAt))
-      .limit(limit);
-
-    const topIpRows = await db
-      .select({
-        ip: accessIpEvent.ip,
-        total: sql<number>`count(*)::int`,
-        uniqueUsers: sql<number>`count(distinct ${accessIpEvent.userId}) filter (where ${accessIpEvent.userId} is not null)::int`,
-        failureCount: sql<number>`count(*) filter (where ${accessIpEvent.statusCode} >= 400)::int`,
-        rateLimitedCount: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'rate_limited' or ${accessIpEvent.statusCode} = 429)::int`,
-        authFailureCount: sql<number>`count(*) filter (where ${accessIpEvent.path} like '/api/auth%' and ${accessIpEvent.statusCode} >= 400)::int`,
-        loginSuccessCount: sql<number>`count(*) filter (where ${accessIpEvent.outcome} = 'login_success')::int`,
-        suspiciousCount: sql<number>`count(*) filter (where ${accessIpEvent.severity} in ('watch', 'high', 'critical'))::int`,
-        firstSeen: sql<string>`min(${accessIpEvent.createdAt})::text`,
-        lastSeen: sql<string>`max(${accessIpEvent.createdAt})::text`,
-        eventSeverityRank: sql<number>`max(case ${accessIpEvent.severity}
-          when 'critical' then 3
-          when 'high' then 2
-          when 'watch' then 1
-          else 0
-        end)::int`,
-      })
-      .from(accessIpEvent)
-      .where(whereClause)
-      .groupBy(accessIpEvent.ip)
-      .orderBy(
-        desc(sql`(
-          count(*) filter (where ${accessIpEvent.severity} in ('watch', 'high', 'critical')) * 8
-          + count(*) filter (where ${accessIpEvent.outcome} = 'rate_limited' or ${accessIpEvent.statusCode} = 429) * 12
-          + count(*) filter (where ${accessIpEvent.statusCode} >= 400) * 3
-          + count(*)
-        )`)
-      )
-      .limit(24);
-
-    const topIps = topIpRows.map((row) => {
-      const severity = buildSeverityFromAggregate({
-        eventSeverityRank: Number(row.eventSeverityRank || 0),
-        total: Number(row.total || 0),
-        failureCount: Number(row.failureCount || 0),
-        rateLimitedCount: Number(row.rateLimitedCount || 0),
-        authFailureCount: Number(row.authFailureCount || 0),
-        suspiciousCount: Number(row.suspiciousCount || 0),
-      });
-
-      return {
-        ...row,
-        severity,
-        failureRate:
-          Number(row.total || 0) > 0
-            ? Number(row.failureCount || 0) / Number(row.total || 1)
-            : 0,
-        reasons: buildAggregateReasons({
-          total: Number(row.total || 0),
-          failureCount: Number(row.failureCount || 0),
-          rateLimitedCount: Number(row.rateLimitedCount || 0),
-          authFailureCount: Number(row.authFailureCount || 0),
-          suspiciousCount: Number(row.suspiciousCount || 0),
-          loginSuccessCount: Number(row.loginSuccessCount || 0),
-        }),
-      };
-    });
-
-    const hourlyStats = await db
-      .select({
-        hour: sql<string>`to_char(date_trunc('hour', ${accessIpEvent.createdAt}), 'MM-DD HH24:00')`,
-        count: sql<number>`count(*)::int`,
-        abnormalCount: sql<number>`count(*) filter (where ${accessIpEvent.severity} <> 'info')::int`,
-      })
-      .from(accessIpEvent)
-      .where(whereClause)
-      .groupBy(sql`date_trunc('hour', ${accessIpEvent.createdAt})`)
-      .orderBy(sql`date_trunc('hour', ${accessIpEvent.createdAt})`);
-
-    const pathStats = await db
-      .select({
-        path: accessIpEvent.path,
-        routeGroup: accessIpEvent.routeGroup,
-        count: sql<number>`count(*)::int`,
-        abnormalCount: sql<number>`count(*) filter (where ${accessIpEvent.severity} <> 'info')::int`,
-      })
-      .from(accessIpEvent)
-      .where(whereClause)
-      .groupBy(accessIpEvent.path, accessIpEvent.routeGroup)
-      .orderBy(desc(sql`count(*)`))
-      .limit(12);
-
-    return NextResponse.json({
-      window: {
-        hours,
-        since: since.toISOString(),
-      },
-      overview: {
-        totalEvents: overview?.totalEvents || 0,
-        uniqueIps: overview?.uniqueIps || 0,
-        abnormalEvents: overview?.abnormalEvents || 0,
-        abnormalIps: overview?.abnormalIps || 0,
-        rateLimitedEvents: overview?.rateLimitedEvents || 0,
-        manualBlockedEvents: overview?.manualBlockedEvents || 0,
-        loginSuccessEvents: overview?.loginSuccessEvents || 0,
-        unauthorizedEvents: overview?.unauthorizedEvents || 0,
-      },
-      topIps,
-      hourlyStats,
-      pathStats,
-      recentEvents,
-      rules: [
-        "短时间请求量偏高",
-        "4xx/5xx 或失败率偏高",
-        "认证失败偏多",
-        "触发限流",
-        "命中敏感路径或异常 User-Agent",
-      ],
-    });
-  } catch (error) {
-    if (error instanceof ChatSDKError) {
-      return error.toResponse();
-    }
-    console.error("[AccessIpEvent] failed to load admin analytics", error);
-    return new ChatSDKError("offline:admin").toResponse();
-  }
-}

app/api/admin/ai-model-health/route.ts

@@ -1,10 +1,8 @@
 import { z } from "zod";
 import { requireAdmin } from "@/lib/middleware/admin";
 import { ChatSDKError } from "@/lib/errors";
-import { db } from "@/lib/db";
-import { aiModelHealthEvent } from "@/lib/db/schema";
-import { and, desc, eq, sql } from "drizzle-orm";
 import {
+  listAiModelHealthEvents,
   restoreAiModelHealth,
 } from "@/lib/ai/runtime/model-health";
 
@@ -17,30 +15,14 @@ export async function GET(request: Request) {
     await requireAdmin();
 
     const { searchParams } = new URL(request.url);
-    const modelId = searchParams.get("modelId");
+    const modelId = searchParams.get("modelId") || undefined;
-    const providerId = searchParams.get("providerId");
+    const limit = Number(searchParams.get("limit") || 80);
-    const rawLimit = Number(searchParams.get("limit") || 20);
+    const events = await listAiModelHealthEvents({
-    const limit = Number.isFinite(rawLimit) ? Math.max(1, Math.min(200, Math.floor(rawLimit))) : 20;
+      modelId,
-    const rawPage = Number(searchParams.get("page") || 1);
+      limit: Number.isFinite(limit) ? limit : 80,
-    const page = Number.isFinite(rawPage) ? Math.max(1, Math.floor(rawPage)) : 1;
+    });
-    const filters = [];
+
-    if (modelId) filters.push(eq(aiModelHealthEvent.modelId, modelId));
+    return Response.json({ events });
-    if (providerId) filters.push(eq(aiModelHealthEvent.providerId, providerId));
-    if (searchParams.get("eventType")) filters.push(eq(aiModelHealthEvent.eventType, searchParams.get("eventType")!));
-    const start = searchParams.get("startDate");
-    const end = searchParams.get("endDate");
-    if (start && /^\d{4}-\d{2}-\d{2}$/.test(start)) filters.push(sql`${aiModelHealthEvent.createdAt}>=${start}::date`);
-    if (end && /^\d{4}-\d{2}-\d{2}$/.test(end)) filters.push(sql`${aiModelHealthEvent.createdAt}<${end}::date+interval '1 day'`);
-    const events = await db.select({
-      id: aiModelHealthEvent.id, modelId: aiModelHealthEvent.modelId, modelDisplayName: aiModelHealthEvent.modelDisplayName,
-      modelRuntimeId: aiModelHealthEvent.modelRuntimeId, providerName: aiModelHealthEvent.providerName,
-      providerId: aiModelHealthEvent.providerId, eventType: aiModelHealthEvent.eventType,
-      errorMessage: aiModelHealthEvent.errorMessage, elapsedMs: aiModelHealthEvent.elapsedMs,
-      consecutiveFailures: aiModelHealthEvent.consecutiveFailures, autoDisabled: aiModelHealthEvent.autoDisabled,
-      counted: aiModelHealthEvent.counted, createdAt: aiModelHealthEvent.createdAt,
-    }).from(aiModelHealthEvent).where(and(...filters)).orderBy(desc(aiModelHealthEvent.createdAt), desc(aiModelHealthEvent.id))
-      .limit(limit + 1).offset((page - 1) * limit);
-    return Response.json({ events: events.slice(0, limit), hasMore: events.length > limit, page });
   } catch (error) {
     if (error instanceof ChatSDKError) {
       return error.toResponse();

app/api/admin/ai-models/route.ts

@@ -1,10 +1,9 @@
 import { z } from "zod";
-import { db } from "@/lib/db";
-import { aiModel, aiProvider } from "@/lib/db/schema";
-import { eq } from "drizzle-orm";
 import { requireAdmin } from "@/lib/middleware/admin";
 import {
+  getAllAiModels,
   getAiModelById,
+  getAiModelsByProviderId,
   createAiModel,
   updateAiModel,
   deleteAiModel,
@@ -155,14 +154,8 @@ export async function GET(request: Request) {
     const id = searchParams.get("id");
     const providerId = searchParams.get("providerId");
 
-    if (searchParams.get("view") === "options") {
-      const models = await db.select({ id: aiModel.id, modelId: aiModel.modelId, displayName: aiModel.displayName,
-        providerName: aiProvider.name }).from(aiModel).leftJoin(aiProvider, eq(aiModel.providerId, aiProvider.id));
-      return Response.json({ models: sortModelsForDisplay(models) });
-    }
-
     if (id) {
-      const model = await db.query.aiModel.findFirst({ where: eq(aiModel.id, id) });
+      const model = await getAiModelById({ id });
       if (!model) {
         return new ChatSDKError("bad_request:api", "Model not found").toResponse();
       }
@@ -170,19 +163,12 @@ export async function GET(request: Request) {
     }
 
     if (providerId) {
-      const models = await db.select().from(aiModel).where(eq(aiModel.providerId, providerId));
+      const models = await getAiModelsByProviderId({ providerId });
       return Response.json({ models: sortModelsForDisplay(models.map(normalizeModel)) });
     }
 
-    const models = await db.select().from(aiModel);
+    const models = await getAllAiModels();
-    const normalized = models.map(normalizeModel);
+    return Response.json({ models: sortModelsForDisplay(models.map(normalizeModel)) });
-    const output = searchParams.get("view") === "summary" ? normalized.map(model => {
-      const { capabilities, defaultParams, imageGenConfig, description, ...summary } = model;
-      const fields = ["kind", "mediaType", "modelType", "outputType", "supportedModes"];
-      return { ...summary, healthLastError: summary.healthLastError?.slice(0, 1200),
-        capabilities: Object.fromEntries(fields.filter(key => capabilities?.[key] !== undefined).map(key => [key, capabilities[key]])) };
-    }) : normalized;
-    return Response.json({ models: sortModelsForDisplay(output) });
   } catch (error) {
     if (error instanceof ChatSDKError) {
       return error.toResponse();

app/api/admin/atlascloud-models/route.ts

@@ -1,10 +1,6 @@
 import { and, eq } from "drizzle-orm";
 import { NextResponse } from "next/server";
-import {
+import { fetchAtlasCloudImagePresets } from "@/lib/ai/atlascloud-models";
-  fetchAtlasCloudModelPresets,
-  resolveAtlasCloudDisplayName,
-  shouldInsertMissingAtlasCloudPreset,
-} from "@/lib/ai/atlascloud-models";
 import { db } from "@/lib/db";
 import { getAiProviderById } from "@/lib/db/queries";
 import { type AiModel, aiModel } from "@/lib/db/schema";
@@ -16,7 +12,7 @@ export const maxDuration = 300;
 export async function GET() {
   try {
     await requireAdmin();
-    const result = await fetchAtlasCloudModelPresets();
+    const result = await fetchAtlasCloudImagePresets();
     return NextResponse.json({
       presets: result.presets,
       errors: result.errors.length > 0 ? result.errors : undefined,
@@ -33,7 +29,7 @@ export async function GET() {
         error:
           error instanceof Error
             ? error.message
-            : "Failed to fetch Atlas Cloud models",
+            : "Failed to fetch Atlas Cloud image models",
       },
       { status: 500 }
     );
@@ -62,50 +58,31 @@ export async function POST(request: Request) {
       );
     }
 
-    const catalog = await fetchAtlasCloudModelPresets();
+    const catalog = await fetchAtlasCloudImagePresets();
     const presets = requestedModelIds
       ? catalog.presets.filter((preset) => requestedModelIds.has(preset.modelId))
       : catalog.presets;
     const addedModels: AiModel[] = [];
     const updatedModels: AiModel[] = [];
     const errors = [...catalog.errors];
-    const providerModels = await db.query.aiModel.findMany({
-      where: eq(aiModel.providerId, providerId),
-    });
-    const existingByModelId = new Map(
-      providerModels.map((model) => [model.modelId, model])
-    );
-    const existingMediaKinds = new Set(
-      providerModels.map((model) => {
-        const capabilities = model.capabilities as Record<string, unknown> | null;
-        return String(capabilities?.mediaType || "image");
-      })
-    );
-    let preservedDeletedCount = 0;
 
     for (const preset of presets) {
       try {
-        const existing = existingByModelId.get(preset.modelId);
+        const existing = await db.query.aiModel.findFirst({
-        const presetCapabilities = preset.capabilities as Record<string, unknown>;
+          where: and(
-        const mediaKind = String(presetCapabilities.mediaType || "image");
+            eq(aiModel.providerId, providerId),
-        if (
+            eq(aiModel.modelId, preset.modelId)
-          !existing &&
-          !shouldInsertMissingAtlasCloudPreset(existingMediaKinds, mediaKind)
-        ) {
-          preservedDeletedCount += 1;
-          continue;
-        }
-        const values = {
-          displayName: resolveAtlasCloudDisplayName(
-            existing?.displayName,
-            preset.displayName,
-            preset.modelId
           ),
+        });
+        const values = {
+          displayName: preset.displayName,
           avatarUrl: preset.avatarUrl || null,
           description: preset.description,
           supportsVision: preset.supportsVision,
           supportsImageGen: preset.supportsImageGen,
-          sortOrder: existing?.sortOrder ?? preset.sortOrder,
+          isEnabled: true,
+          isHidden: false,
+          sortOrder: preset.sortOrder,
           capabilities: preset.capabilities,
           defaultParams: preset.defaultParams,
           imageGenConfig: preset.imageGenConfig,
@@ -131,8 +108,6 @@ export async function POST(request: Request) {
               providerId,
               modelId: preset.modelId,
               ...values,
-              isEnabled: true,
-              isHidden: false,
               isDefault: false,
               isSubModel: false,
               parentModelId: null,
@@ -163,8 +138,6 @@ export async function POST(request: Request) {
         requested: presets.length,
         total: catalog.catalogCount,
         available: catalog.presets.length,
-        skippedUnsupported: catalog.skipped.length,
-        preservedDeleted: preservedDeletedCount,
       },
     });
   } catch (error) {
@@ -174,7 +147,7 @@ export async function POST(request: Request) {
         error:
           error instanceof Error
             ? error.message
-            : "Failed to sync Atlas Cloud models",
+            : "Failed to sync Atlas Cloud image models",
       },
       { status: 500 }
     );

app/api/admin/bananaimage-models/route.ts

@@ -94,8 +94,6 @@ export async function POST(request: Request) {
             providerId,
             modelId: preset.modelId,
             ...values,
-            isEnabled: true,
-            isHidden: false,
             isDefault: false,
             isSubModel: false,
             parentModelId: null,

app/api/admin/images/route.ts

@@ -1,31 +1,237 @@
 import { NextRequest, NextResponse } from "next/server";
 import { db } from "@/lib/db";
-import { generatedImage, user } from "@/lib/db/schema";
+import { chat, generatedImage, message, user } from "@/lib/db/schema";
-import { eq } from "drizzle-orm";
+import { eq, desc, sql, and, gte, lte, like, or, isNotNull } from "drizzle-orm";
 import { auth } from "@/app/(auth)/auth";
-import { requireAdmin } from "@/lib/middleware/admin";
+
-import { ChatSDKError } from "@/lib/errors";
+function extractVideoUrlFromParts(parts: unknown): string | null {
-import { mediaRecordsQuery, parseMediaQuery } from "@/lib/admin/media-records";
+  const text = Array.isArray(parts)
-import { resolveArchivedImageUrls } from "@/lib/storage/image-archive-db";
+    ? parts
+        .map((part) => (part && typeof part === "object" && "text" in part ? String((part as any).text || "") : ""))
+        .join("\n")
+    : typeof parts === "string"
+      ? parts
+      : "";
+
+  if (!text) return null;
+
+  const htmlMatch = text.match(/<video[^>]+src="([^"]+)"/i);
+  if (htmlMatch?.[1]) return htmlMatch[1];
+
+  const markdownMatch = text.match(/\[[^\]]*]\((https?:\/\/[^)\s]+\.mp4(?:\?[^)\s]*)?)\)/i);
+  if (markdownMatch?.[1]) return markdownMatch[1];
+
+  const plainMatch = text.match(/(https?:\/\/[^\s"'<>]+\.mp4(?:\?[^\s"'<>]+)?)/i);
+  return plainMatch?.[1] || null;
+}
 
 export async function GET(request: NextRequest) {
   try {
-    const session = await requireAdmin();
+    const session = await auth();
-    const operator = await db.query.user.findFirst({ where: eq(user.id, session.user.id) });
+    
-    if (operator?.role !== "admin") return NextResponse.json({ error: "Forbidden" }, { status: 403 });
+    if (!session?.user?.id) {
-    const query = parseMediaQuery(request.nextUrl.searchParams);
+      return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
-    if (query.startDate && query.endDate && query.startDate > query.endDate) {
-      return NextResponse.json({ error: "开始日期不能晚于结束日期" }, { status: 400 });
     }
-    const [result] = await db.execute(mediaRecordsQuery(query));
+
-    const images = await resolveArchivedImageUrls(result.records);
+    // 检查是否为管理员
-    const total = Number(result.total);
+    const currentUser = await db.query.user.findFirst({
-    return NextResponse.json({ images, pagination: { page: query.page, pageSize: query.pageSize, total,
+      where: eq(user.id, session.user.id),
-      totalPages: Math.ceil(total / query.pageSize), totalImages: Number(result.totalImages), totalVideos: Number(result.totalVideos) } });
+    });
+
+    if (currentUser?.role !== "admin") {
+      return NextResponse.json({ error: "Forbidden" }, { status: 403 });
+    }
+
+    // 获取查询参数
+    const searchParams = request.nextUrl.searchParams;
+    const page = Number.parseInt(searchParams.get("page") || "1");
+    const pageSize = Number.parseInt(searchParams.get("pageSize") || "200");
+    const offset = (page - 1) * pageSize;
+    const search = searchParams.get("search") || "";
+    const startDate = searchParams.get("startDate");
+    const endDate = searchParams.get("endDate");
+
+    // 构建查询条件
+    const imageConditions = [];
+    const videoConditions = [
+      eq(message.role, "assistant"),
+      or(
+        isNotNull(message.temporaryVideoUrl),
+        isNotNull(message.permanentVideoUrl),
+        sql`${message.parts}::text ILIKE '%<video%'`,
+        sql`${message.parts}::text ILIKE '%.mp4%'`
+      ),
+    ];
+    if (search) {
+      // 搜索用户名或邮箱
+      const matchingUsers = await db
+        .select({ id: user.id })
+        .from(user)
+        .where(or(
+          like(user.name, `%${search}%`),
+          like(user.email, `%${search}%`)
+        ));
+      
+      if (matchingUsers.length > 0) {
+        const matchedUserIds = matchingUsers.map((u) => u.id);
+        imageConditions.push(
+          sql`${generatedImage.userId} IN (${sql.join(matchedUserIds.map((id) => sql`${id}`), sql`, `)})`
+        );
+        videoConditions.push(
+          sql`${chat.userId} IN (${sql.join(matchedUserIds.map((id) => sql`${id}`), sql`, `)})`
+        );
+      } else {
+        // 没有匹配的用户，返回空结果
+        return NextResponse.json({
+          images: [],
+          pagination: { page, pageSize, total: 0, totalPages: 0 }
+        });
+      }
+    }
+
+    if (startDate) {
+      const start = new Date(startDate);
+      imageConditions.push(gte(generatedImage.createdAt, start));
+      videoConditions.push(gte(message.createdAt, start));
+    }
+
+    if (endDate) {
+      const end = new Date(endDate);
+      end.setHours(23, 59, 59, 999);
+      imageConditions.push(lte(generatedImage.createdAt, end));
+      videoConditions.push(lte(message.createdAt, end));
+    }
+
+    const imageWhereClause = imageConditions.length > 0 ? and(...imageConditions) : undefined;
+    const videoWhereClause = videoConditions.length > 0 ? and(...videoConditions) : undefined;
+
+    // 查询图片总数
+    const imageCountResult = await db
+      .select({ count: sql<number>`count(*)::int` })
+      .from(generatedImage)
+      .where(imageWhereClause);
+
+    // 查询视频总数
+    const videoCountResult = await db
+      .select({ count: sql<number>`count(*)::int` })
+      .from(message)
+      .innerJoin(chat, eq(message.chatId, chat.id))
+      .where(videoWhereClause);
+
+    const totalImages = imageCountResult[0]?.count || 0;
+    const totalVideos = videoCountResult[0]?.count || 0;
+    const total = totalImages + totalVideos;
+    const totalPages = Math.ceil(total / pageSize);
+
+    const fetchLimit = Math.max(page * pageSize, pageSize);
+
+    // 查询图片列表（包含用户信息）
+    const imageRows = await db
+      .select({
+        id: generatedImage.id,
+        userId: generatedImage.userId,
+        userName: user.name,
+        userEmail: user.email,
+        userDepartment: user.department,
+        thumbnailUrl: generatedImage.thumbnailUrl,
+        originalUrl: generatedImage.originalUrl,
+        imageSize: generatedImage.imageSize,
+        prompt: generatedImage.prompt,
+        modelId: generatedImage.modelId,
+        isFeatured: generatedImage.isFeatured,
+        featuredCategory: generatedImage.featuredCategory,
+        featuredAt: generatedImage.featuredAt,
+        createdAt: generatedImage.createdAt,
+        chatId: generatedImage.chatId,
+        recordType: sql<"image">`'image'`,
+        videoUrl: sql<string | null>`null`,
+      })
+      .from(generatedImage)
+      .leftJoin(user, eq(generatedImage.userId, user.id))
+      .where(imageWhereClause)
+      .orderBy(desc(generatedImage.createdAt))
+      .limit(fetchLimit);
+
+    // 查询视频列表（来自消息表）
+    const videoRows = await db
+      .select({
+        id: message.id,
+        userId: chat.userId,
+        userName: user.name,
+        userEmail: user.email,
+        userDepartment: user.department,
+        temporaryVideoUrl: message.temporaryVideoUrl,
+        permanentVideoUrl: message.permanentVideoUrl,
+        parts: message.parts,
+        videoMetadata: message.videoMetadata,
+        createdAt: message.createdAt,
+        chatId: message.chatId,
+      })
+      .from(message)
+      .innerJoin(chat, eq(message.chatId, chat.id))
+      .leftJoin(user, eq(chat.userId, user.id))
+      .where(videoWhereClause)
+      .orderBy(desc(message.createdAt))
+      .limit(fetchLimit);
+
+    const normalizedVideos = videoRows
+      .map((item) => {
+        const metadata = (item.videoMetadata as Record<string, any> | null) || {};
+        const videoUrl =
+          item.permanentVideoUrl ||
+          item.temporaryVideoUrl ||
+          extractVideoUrlFromParts(item.parts);
+
+        if (!videoUrl) return null;
+
+        const resolution =
+          typeof metadata.resolution === "string" && metadata.resolution.trim()
+            ? metadata.resolution.trim()
+            : null;
+        const prompt =
+          typeof metadata.prompt === "string" && metadata.prompt.trim()
+            ? metadata.prompt.trim()
+            : null;
+        const modelId =
+          typeof metadata.model === "string" && metadata.model.trim()
+            ? metadata.model.trim()
+            : null;
+
+        return {
+          id: `video-${item.id}`,
+          sourceMessageId: item.id,
+          userId: item.userId,
+          userName: item.userName,
+          userEmail: item.userEmail,
+          userDepartment: item.userDepartment,
+          thumbnailUrl: videoUrl,
+          originalUrl: videoUrl,
+          videoUrl,
+          imageSize: resolution,
+          prompt,
+          modelId,
+          isFeatured: false,
+          featuredCategory: null,
+          featuredAt: null,
+          createdAt: item.createdAt,
+          chatId: item.chatId,
+          recordType: "video" as const,
+        };
+      })
+      .filter((item): item is NonNullable<typeof item> => Boolean(item));
+
+    const merged = [...imageRows, ...normalizedVideos].sort(
+      (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
+    );
+    const images = merged.slice(offset, offset + pageSize);
+
+    return NextResponse.json({
+      images,
+      pagination: { page, pageSize, total, totalPages, totalImages, totalVideos }
+    });
   } catch (error) {
-    if (error instanceof ChatSDKError) return error.toResponse();
+    console.error("[Admin Images API] Error:", error);
-    console.error("[Admin Images API] GET failed", error);
+    return NextResponse.json({ error: "Failed to fetch images" }, { status: 500 });
-    return NextResponse.json({ error: "记录加载失败，请重试" }, { status: 500 });
   }
 }
 

app/api/admin/media-tasks/route.ts

@@ -1,31 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-import { db } from "@/lib/db";
-import { sql } from "drizzle-orm";
-import { requireAdmin } from "@/lib/middleware/admin";
-import { ChatSDKError } from "@/lib/errors";
-import { parseMediaQuery } from "@/lib/admin/media-records";
-
-export async function GET(request: NextRequest) {
-  try {
-    await requireAdmin();
-    const q = parseMediaQuery(request.nextUrl.searchParams);
-    const status = request.nextUrl.searchParams.get("status") || "all";
-    const filters = [sql`true`];
-    if (q.search)
-      filters.push(sql`(u.name ilike ${`%${q.search}%`} or u.email ilike ${`%${q.search}%`})`);
-    if (["pending", "running", "failed", "succeeded"].includes(status))
-      filters.push(sql`t.status=${status}`);
-    if (q.startDate) filters.push(sql`t."createdAt">=${q.startDate}::date - interval '8 hours'`);
-    if (q.endDate) filters.push(sql`t."createdAt"<${q.endDate}::date+interval '16 hours'`);
-    const [result] = await db.execute(sql`with filtered as not materialized (
-      select t.id,u.name as "userName",t.status,t."createdAt"+interval '8 hours' as "createdAt",t.error,coalesce(t.request->>'modelId',t.request->>'model') as model,
-        extract(epoch from (t."completedAt"-t."startedAt"))*1000 as "elapsedMs"
-      from "CanvasImageTask" t left join "User" u on u.id=t."userId" where ${sql.join(filters, sql` and `)}
-    ) select (select count(*)::int from filtered) as total,
-      coalesce((select jsonb_agg(p) from (select * from filtered order by "createdAt" desc,id desc limit ${q.pageSize} offset ${(q.page - 1) * q.pageSize}) p),'[]'::jsonb) as tasks`);
-    return NextResponse.json(result);
-  } catch (error) {
-    if (error instanceof ChatSDKError) return error.toResponse();
-    return NextResponse.json({ error: "任务记录加载失败，请重试" }, { status: 500 });
-  }
-}

app/api/admin/settings/route.ts

@@ -18,8 +18,6 @@ import {
   DETAIL_AGENT_LOCAL_MOONSHOT_DISPLAY_NAME,
   DETAIL_AGENT_LOCAL_MOONSHOT_MODEL_ID,
   DETAIL_AGENT_LOCAL_MOONSHOT_SETTING_KEY,
-  isDetailAgentLocalMoonshotBaseUrl,
-  normalizeDetailAgentLocalMoonshotBaseUrl,
 } from "@/lib/ai/detail-agent-model-config";
 import {
   normalizeProductPlanningApiConfig,
@@ -101,7 +99,7 @@ const moonshotDetailAgentConfigSchema = z.object({
 const MOONSHOT_OFFICIAL_BASE_URL = DETAIL_AGENT_LOCAL_MOONSHOT_BASE_URL;
 
 function isMoonshotOfficialBaseUrl(value: string) {
-  return isDetailAgentLocalMoonshotBaseUrl(value);
+  return String(value || "").trim().replace(/\/+$/, "") === MOONSHOT_OFFICIAL_BASE_URL;
 }
 
 function isObjectLike(value: unknown): value is Record<string, unknown> {
@@ -203,27 +201,19 @@ export async function POST(request: Request) {
           ? (existingSetting.value as Record<string, unknown>)
           : {};
       const config = moonshotDetailAgentConfigSchema.parse(value || {});
-      const normalizedBaseUrl = normalizeDetailAgentLocalMoonshotBaseUrl(config.baseUrl);
+      const normalizedBaseUrl = String(config.baseUrl || "").trim() || MOONSHOT_OFFICIAL_BASE_URL;
       const rawModelId = String(config.modelId || "").trim();
       const rawDisplayName = String(config.displayName || "").trim();
       const normalizedModelId =
-        !rawModelId ||
+        !rawModelId || rawModelId === "kimi-k2.5"
-        rawModelId === "kimi-k2.5" ||
-        rawModelId === "kimi-k2.6" ||
-        rawModelId === "kimi-k2.7-code" ||
-        rawModelId === "kimi-k2.7-code-highspeed"
           ? DETAIL_AGENT_LOCAL_MOONSHOT_MODEL_ID
           : rawModelId;
       const normalizedDisplayName =
-        !rawDisplayName ||
+        !rawDisplayName || rawDisplayName === "官方 Kimi K2.5"
-        rawDisplayName === "官方 Kimi K2.5" ||
-        rawDisplayName === "官方 Kimi K2.6" ||
-        rawDisplayName === "官方 Kimi K2.7 Code Highspeed" ||
-        rawDisplayName === "Kimi Code 编程套餐 K2.7 Highspeed"
           ? DETAIL_AGENT_LOCAL_MOONSHOT_DISPLAY_NAME
           : rawDisplayName;
       const normalizedProviderName =
-        String(config.providerName || "").trim() || "Kimi Code 编程套餐";
+        String(config.providerName || "").trim() || "Moonshot AI (Official)";
       const normalizedApiKey =
         String(config.apiKey || "").trim() ||
         String(existingValue.apiKey || "").trim();
@@ -232,12 +222,12 @@ export async function POST(request: Request) {
       if (!isMoonshotOfficialBaseUrl(normalizedBaseUrl)) {
         return new ChatSDKError(
           "bad_request:api",
-          `Kimi Code 编程套餐专用地址必须为 ${MOONSHOT_OFFICIAL_BASE_URL}`,
+          `Moonshot 官方地址必须为 ${MOONSHOT_OFFICIAL_BASE_URL}`,
         ).toResponse();
       }
 
       if (!normalizedApiKey) {
-        return new ChatSDKError("bad_request:api", "缺少 Kimi Code 控制台 API Key").toResponse();
+        return new ChatSDKError("bad_request:api", "缺少 Moonshot 官方 API Key").toResponse();
       }
 
       const saved = await upsertSystemSetting({

app/api/admin/snapgen-image-models/route.ts

@@ -76,6 +76,8 @@ export async function POST(request: Request) {
               description: preset.description,
               supportsVision: preset.supportsVision,
               supportsImageGen: preset.supportsImageGen,
+              isEnabled: true,
+              isHidden: false,
               sortOrder: preset.sortOrder,
               capabilities: preset.capabilities || null,
               defaultParams: preset.defaultParams || null,

app/api/admin/vip98k-models/route.ts

@@ -106,22 +106,6 @@ export async function POST(request: Request) {
         ? catalogPresets.filter((preset) => existingModelIds.has(preset.modelId))
         : catalogPresets;
 
-    if (body?.dryRun === true) {
-      const catalogIds = new Set(catalogPresets.map(preset => preset.modelId));
-      const fields = ["displayName", "description", "supportsVision", "supportsImageGen", "isHidden", "sortOrder", "capabilities", "defaultParams", "imageGenConfig"] as const;
-      const added = presets.filter(preset => !existingModelIds.has(preset.modelId)).map(preset => ({ modelId: preset.modelId, displayName: preset.displayName }));
-      const updated = presets.flatMap(preset => {
-        const existing = existingModels.find(model => model.modelId === preset.modelId);
-        if (!existing) return [];
-        const changedFields: string[] = fields.filter(field => preset[field] !== undefined && JSON.stringify(existing[field]) !== JSON.stringify(preset[field]));
-        if (existing.avatarUrl) changedFields.push("avatarUrl");
-        if (requestedModelIds !== null && !existing.isEnabled) changedFields.push("isEnabled");
-        return changedFields.length ? [{ modelId: preset.modelId, displayName: existing.displayName, changedFields }] : [];
-      });
-      const disabled = requestedModelIds === null ? existingModels.filter(model => !catalogIds.has(model.modelId) && (model.isEnabled || !model.isHidden)).map(model => ({ modelId: model.modelId, displayName: model.displayName })) : [];
-      return NextResponse.json({ preview: { added, updated, disabled }, total: catalogPresets.length });
-    }
-
     const addedModels: AiModel[] = [];
     const updatedModels: AiModel[] = [];
     const disabledModels: AiModel[] = [];

app/api/agent-projects/[id]/route.ts

@@ -7,7 +7,10 @@ import {
   extractAgentProjectStateFromCanvasData,
   isAgentProjectRow,
 } from "@/lib/agents/agent-project-compat";
-import { normalizeAgentGenerationProjectPersistedState } from "@/lib/agents/generation-project-state";
+import {
+  getAllResultUrlsFromAgentProjectState,
+  mergeAgentProjectStateForSave,
+} from "@/lib/agents/agent-project-save-merge";
 
 export const dynamic = "force-dynamic";
 export const revalidate = 0;
@@ -79,16 +82,28 @@ export async function PUT(
       return NextResponse.json({ success: false, error: "生图项目不存在" }, { status: 404 });
     }
 
-    const title = body.title !== undefined ? String(body.title || "").trim() || "未命名生图项目" : undefined;
+    const title =
+      body.title !== undefined
+        ? String(body.title || "").trim() || "未命名生图项目"
+        : existingProject.title;
     const description =
-      body.description !== undefined ? String(body.description || "").trim() || null : undefined;
+      body.description !== undefined
-    const thumbnail =
+        ? String(body.description || "").trim() || null
-      body.thumbnail !== undefined ? String(body.thumbnail || "").trim() || null : undefined;
+        : existingProject.description || null;
 
+    const existingProjectState = extractAgentProjectStateFromCanvasData(existingProject.canvasData);
     const nextProjectState =
       body.projectState !== undefined
-        ? normalizeAgentGenerationProjectPersistedState(body.projectState)
+        ? mergeAgentProjectStateForSave({
-        : extractAgentProjectStateFromCanvasData(existingProject.canvasData);
+            existingState: existingProjectState,
+            incomingState: body.projectState,
+          })
+        : existingProjectState;
+    const firstResultUrl = getAllResultUrlsFromAgentProjectState(nextProjectState)[0] || null;
+    const requestedThumbnail =
+      body.thumbnail !== undefined ? String(body.thumbnail || "").trim() || null : undefined;
+    const thumbnail =
+      requestedThumbnail || existingProject.thumbnail || firstResultUrl || null;
 
     const [project] = await db
       .update(canvasProject)

app/api/agent-projects/route.ts

@@ -1,6 +1,5 @@
 import { NextRequest, NextResponse } from "next/server";
-import { and, desc, eq } from "drizzle-orm";
+import { desc, eq } from "drizzle-orm";
-import { z } from "zod";
 import { auth } from "@/app/(auth)/auth";
 import { db } from "@/lib/db";
 import { canvasProject } from "@/lib/db/schema";
@@ -57,20 +56,14 @@ export async function POST(request: NextRequest) {
     }
 
     const body = await request.json().catch(() => ({}));
-    const requestedId = body.id === undefined ? undefined : z.string().uuid().safeParse(body.id);
-    if (requestedId && !requestedId.success) {
-      return NextResponse.json({ success: false, error: "项目编号无效" }, { status: 400 });
-    }
-    const id = requestedId?.data;
     const title = String(body.title || "").trim() || "未命名生图项目";
     const description = String(body.description || "").trim() || null;
     const thumbnail = String(body.thumbnail || "").trim() || null;
     const projectState = normalizeAgentGenerationProjectPersistedState(body.projectState);
 
-    const [insertedProject] = await db
+    const [project] = await db
       .insert(canvasProject)
       .values({
-        id,
         userId: session.user.id,
         title,
         description,
@@ -85,22 +78,8 @@ export async function POST(request: NextRequest) {
           agentProjectState: projectState,
         } as any,
       })
-      .onConflictDoNothing({ target: canvasProject.id })
       .returning();
 
-    const project = insertedProject || (id ? (await db
-      .select()
-      .from(canvasProject)
-      .where(and(
-        eq(canvasProject.id, id),
-        eq(canvasProject.userId, session.user.id),
-        eq(canvasProject.workspaceType, "agent")
-      ))
-      .limit(1))[0] : undefined);
-    if (!project) {
-      return NextResponse.json({ success: false, error: "项目编号不可用，请重试" }, { status: 409 });
-    }
-
     return NextResponse.json({ success: true, data: mapAgentProjectRow(project) });
   } catch (error) {
     console.error("[AgentProjects API] 创建项目失败:", error);

app/api/agent-workflow/template-prompts/route.ts

@@ -1,20 +0,0 @@
-import { z } from "zod";
-import { auth } from "@/app/(auth)/auth";
-import { resolveAgentWorkflowComposerSelections } from "@/lib/agents/workflow-composer";
-import { AGENT_WORKFLOW_UI_CONFIG_KEY, normalizeAgentWorkflowUiConfig } from "@/lib/agents/workflow-ui-config";
-import { getSystemSetting } from "@/lib/db/queries";
-
-const selectionsSchema = z.record(z.string().max(160), z.string().max(8192))
-  .refine((selections) => Object.keys(selections).length <= 100);
-
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return Response.json({ error: "请先登录" }, { status: 401 });
-
-  const selections = selectionsSchema.safeParse(await request.json().catch(() => null));
-  if (!selections.success) return Response.json({ error: "风格模板选择无效" }, { status: 400 });
-
-  const setting = await getSystemSetting({ key: AGENT_WORKFLOW_UI_CONFIG_KEY });
-  const config = normalizeAgentWorkflowUiConfig(setting?.value);
-  return Response.json({ selections: resolveAgentWorkflowComposerSelections({ config, selections: selections.data }) });
-}

app/api/agents/detail-replacement/batches/route.ts

@@ -1,309 +0,0 @@
-import { and, desc, eq, inArray, sql } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { canvasImageTask, canvasProject, message } from "@/lib/db/schema";
-import { extractAgentProjectStateFromCanvasData, isAgentProjectRow } from "@/lib/agents/agent-project-compat";
-import { MAX_DETAIL_REPLACEMENT_REFERENCES } from "@/lib/agents/mode-workspace-state";
-import {
-  createCanvasImageTask,
-  enqueueCanvasImageTask,
-  ensureCanvasImageTaskActive,
-  getCanvasImageTaskForUser,
-} from "@/lib/canvas/image-task-queue";
-import {
-  checkUserImageQuota,
-  getChatById,
-  getEnabledAiModelsWithProvider,
-  getPointsSystemConfig,
-  getUserById,
-  saveChat,
-} from "@/lib/db/queries";
-import { getModelGenerationCreditCost } from "@/lib/ai/image-model-pricing";
-import { resolveDirectReplacementModelRef } from "@/app/(chat)/api/chat/_lib/detail-replacement";
-import {
-  buildAgentSlotPrompt,
-  normalizeAgentSupplementPrompt,
-} from "@/app/(chat)/api/chat/_lib/agent-scene-workflow";
-import {
-  detailReplacementSubmissionKey,
-  isDetailReplacementBatchRequest,
-  isDetailReplacementUuid,
-  type DetailReplacementBatchReference,
-  type DetailReplacementBatchRequest,
-  type DetailReplacementBatchResult,
-} from "@/lib/agents/detail-replacement-batch";
-
-export const maxDuration = 1200;
-
-function scopedChatId(projectId: string) {
-  const normalized = projectId.toLowerCase().replace(/-/g, "");
-  const scoped = `${normalized.slice(0, 20)}a93e17a60001`;
-  return [scoped.slice(0, 8), scoped.slice(8, 12), scoped.slice(12, 16), scoped.slice(16, 20), scoped.slice(20, 32)].join("-");
-}
-
-function taskResponse(task: Awaited<ReturnType<typeof getCanvasImageTaskForUser>>) {
-  const result = task?.result as DetailReplacementBatchResult | null;
-  const request = task?.request as DetailReplacementBatchRequest | null;
-  return {
-    id: task?.id,
-    status: task?.status,
-    attempts: task?.attempts,
-    error: task?.error || null,
-    cards: Array.isArray(result?.cards) ? result.cards : [],
-    currentCardId: result?.currentCardId || null,
-    requestedCardIds: request?.references?.map((item) => item.id) || [],
-    createdAt: task?.createdAt || null,
-    queueStatus: task?.queueStatus || null,
-  };
-}
-
-async function findActiveBatchId(params: {
-  userId: string;
-  projectId: string;
-  submissionKey: string;
-}) {
-  const [row] = await db.select({ id: canvasImageTask.id })
-    .from(canvasImageTask)
-    .where(and(
-      eq(canvasImageTask.userId, params.userId),
-      inArray(canvasImageTask.status, ["pending", "running"]),
-      sql`${canvasImageTask.request}->>'taskKind' = 'agent-detail-replacement-batch'`,
-      sql`${canvasImageTask.request}->>'projectId' = ${params.projectId}`,
-      sql`${canvasImageTask.request}->>'submissionKey' = ${params.submissionKey}`,
-    ))
-    .orderBy(desc(canvasImageTask.createdAt)).limit(1);
-  return row?.id || null;
-}
-
-function isUniqueViolation(error: unknown) {
-  for (let cursor: unknown = error; cursor && typeof cursor === "object"; ) {
-    if ((cursor as { code?: unknown }).code === "23505") return true;
-    cursor = (cursor as { cause?: unknown }).cause;
-  }
-  return false;
-}
-
-export async function GET(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  const params = new URL(request.url).searchParams;
-  const projectId = String(params.get("projectId") || "").trim();
-  const taskId = String(params.get("taskId") || "").trim();
-  if (!isDetailReplacementUuid(projectId)) {
-    return NextResponse.json({ error: "项目编号无效" }, { status: 400 });
-  }
-  const [project] = await db.select({ id: canvasProject.id }).from(canvasProject).where(and(
-    eq(canvasProject.id, projectId), eq(canvasProject.userId, session.user.id),
-  )).limit(1);
-  if (!project) return NextResponse.json({ error: "项目不存在" }, { status: 404 });
-
-  const [candidate] = await db.select({ id: canvasImageTask.id, request: canvasImageTask.request })
-    .from(canvasImageTask)
-    .where(and(
-      eq(canvasImageTask.userId, session.user.id),
-      ...(isDetailReplacementUuid(taskId) ? [eq(canvasImageTask.id, taskId)] : []),
-      sql`${canvasImageTask.request}->>'taskKind' = 'agent-detail-replacement-batch'`,
-      sql`${canvasImageTask.request}->>'projectId' = ${projectId}`,
-    ))
-    // A batch that is still working matters more than a newer finished one, so the
-    // workspace keeps showing live progress after a rerun of a single card.
-    .orderBy(
-      sql`case when ${canvasImageTask.status} in ('pending', 'running') then 0 else 1 end`,
-      desc(canvasImageTask.createdAt),
-    ).limit(1);
-  if (!candidate || !isDetailReplacementBatchRequest(candidate.request)) {
-    return NextResponse.json({ task: null });
-  }
-  let task = await getCanvasImageTaskForUser({ taskId: candidate.id, userId: session.user.id });
-  if (task && (task.status === "failed" ||
-    (task.status === "running" && Date.now() - task.updatedAt.getTime() > 90_000))) {
-    await ensureCanvasImageTaskActive({ taskId: task.id, userId: session.user.id });
-    task = await getCanvasImageTaskForUser({ taskId: candidate.id, userId: session.user.id });
-  }
-  return NextResponse.json({ task: taskResponse(task) });
-}
-
-export async function POST(request: Request) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-    const body = await request.json();
-    const projectId = String(body.projectId || "").trim();
-    const taskId = String(body.requestId || "").trim();
-    if (!isDetailReplacementUuid(projectId) || !isDetailReplacementUuid(taskId)) {
-      return NextResponse.json({ error: "任务编号或项目编号无效" }, { status: 400 });
-    }
-    const [project] = await db.select().from(canvasProject).where(and(
-      eq(canvasProject.id, projectId), eq(canvasProject.userId, session.user.id),
-    )).limit(1);
-    if (!project || !isAgentProjectRow(project)) {
-      return NextResponse.json({ error: "风格化项目不存在" }, { status: 404 });
-    }
-
-    const state = extractAgentProjectStateFromCanvasData(project.canvasData);
-    const knownReferences = new Map(
-      (state.workflowState.agentModeState?.detailReplacement?.references || [])
-        .map((item) => [String(item.id), String(item.imageUrl)]),
-    );
-    const requested = Array.isArray(body.references) ? body.references : [];
-    if (requested.length === 0) {
-      return NextResponse.json({ error: "请先选择详情参考图" }, { status: 400 });
-    }
-    if (requested.length > MAX_DETAIL_REPLACEMENT_REFERENCES) {
-      return NextResponse.json({
-        error: `本次选中了 ${requested.length} 张详情参考图，一次最多替换 ${MAX_DETAIL_REPLACEMENT_REFERENCES} 张，请减少本次选择后重试`,
-      }, { status: 400 });
-    }
-    const references: DetailReplacementBatchReference[] = requested.map((raw: unknown) => {
-      const item = raw && typeof raw === "object" ? raw as Record<string, unknown> : {};
-      return {
-        id: String(item.id || "").slice(0, 128),
-        label: String(item.label || "详情参考图").slice(0, 255),
-        imageUrl: String(item.imageUrl || "").trim(),
-        candidateId: String(item.candidateId || "").slice(0, 128) || null,
-        passthrough: item.passthrough === true,
-        rerunReferenceImages: Array.isArray(item.rerunReferenceImages)
-          ? item.rerunReferenceImages.slice(0, 6).map((entry: { url?: string }) => ({ url: String(entry?.url || "") }))
-          : [],
-      };
-    });
-    if (
-      new Set(references.map((item) => item.id)).size !== references.length ||
-      references.some((item) => !item.id || knownReferences.get(item.id) !== item.imageUrl)
-    ) {
-      return NextResponse.json({ error: "详情参考图尚未保存或已发生变化，请刷新后重试" }, { status: 400 });
-    }
-    const productImageUrls = Array.isArray(body.productImageUrls)
-      ? Array.from(new Set(body.productImageUrls.map((url: unknown) => String(url || "").trim())
-          .filter((url: string) => /^https?:\/\//i.test(url)))).slice(0, 16) as string[]
-      : [];
-    if (productImageUrls.length === 0 && !references.every((item) => item.passthrough)) {
-      return NextResponse.json({ error: "请先在输入图区选择至少一张产品图" }, { status: 400 });
-    }
-    const strategy = body.replacementStrategy === "product_only" ? "product_only" : "scene_replace";
-    const prompt = String(body.prompt || "").trim().slice(0, 24_000);
-    if (strategy !== "product_only" && !prompt) {
-      return NextResponse.json({ error: "请先配置风格化提示词" }, { status: 400 });
-    }
-    const models = await getEnabledAiModelsWithProvider();
-    const model = await resolveDirectReplacementModelRef({
-      selectedChatModel: String(body.model || "auto"),
-      finalModelId: String(body.model || "auto"),
-      models,
-    });
-    if (!model || model === "auto" || !models.some((entry) => entry.model.id === model)) {
-      return NextResponse.json({ error: "详情替换模型不可用，请检查模型配置" }, { status: 400 });
-    }
-    if (typeof body.expectedModelId === "string" && body.expectedModelId !== model) {
-      return NextResponse.json({
-        code: "DETAIL_REPLACEMENT_MODEL_CHANGED",
-        error: "详情替换模型已更新，请确认页面显示的模型后重新提交",
-      }, { status: 409 });
-    }
-    const quota = await checkUserImageQuota(session.user.id);
-    if (!quota.allowed) {
-      return NextResponse.json({ error: "本月图片生成配额已用完" }, { status: 429 });
-    }
-    const requestedImageCount = references.filter((item) => !item.passthrough).length;
-    if (quota.limit != null && quota.used + requestedImageCount > quota.limit) {
-      return NextResponse.json({ error: `本月剩余生图配额不足 ${requestedImageCount} 张` }, { status: 429 });
-    }
-    const pointsConfig = await getPointsSystemConfig();
-    if (pointsConfig.enabled && pointsConfig.blockOnInsufficient !== false) {
-      const selectedModel = models.find((entry) => entry.model.id === model)?.model;
-      const unitCost = getModelGenerationCreditCost(
-        selectedModel as Parameters<typeof getModelGenerationCreditCost>[0], "image", {
-        imageSize: ["1K", "2K", "4K"].includes(body.imageSize) ? body.imageSize : "2K",
-      });
-      const user = await getUserById({ id: session.user.id });
-      const expectedCost = unitCost * requestedImageCount;
-      if (!user?.isHighVip && expectedCost > Number(user?.pointsBalance || 0)) {
-        return NextResponse.json({ error: `积分不足，本批次预计消耗 ${expectedCost} 积分` }, { status: 402 });
-      }
-    }
-    const chatId = scopedChatId(projectId);
-    const existingChat = await getChatById({ id: chatId });
-    if (existingChat && existingChat.userId !== session.user.id) {
-      return NextResponse.json({ error: "无权访问项目对话" }, { status: 403 });
-    }
-    if (!existingChat) await saveChat({
-      id: chatId, userId: session.user.id, title: project.title || "详情替换", visibility: "private",
-    });
-    const taskRequest: DetailReplacementBatchRequest = {
-      taskKind: "agent-detail-replacement-batch",
-      projectId,
-      chatId,
-      model,
-      prompt: strategy === "product_only"
-        ? "仅替换参考详情图中的产品主体"
-        : buildAgentSlotPrompt({
-            workflowPrompt: prompt,
-            slotPrompt: "",
-            userSupplementPrompt: normalizeAgentSupplementPrompt(
-              String(body.userPrompt || ""), "详情参考图替换",
-            ),
-            includeSlotTitle: false,
-            modeType: "detail_replacement",
-          }),
-      userPrompt: String(body.userPrompt || "").slice(0, 12_000),
-      imageSize: ["1K", "2K", "4K"].includes(body.imageSize) ? body.imageSize : "2K",
-      replacementStrategy: strategy,
-      productImageUrls,
-      modelImageUrl: /^https?:\/\//i.test(String(body.modelImageUrl || ""))
-        ? String(body.modelImageUrl) : null,
-      references,
-    };
-    const submissionKey = detailReplacementSubmissionKey(taskRequest);
-    taskRequest.submissionKey = submissionKey;
-
-    const duplicateId = await findActiveBatchId({
-      userId: session.user.id, projectId, submissionKey,
-    });
-    if (duplicateId) {
-      await ensureCanvasImageTaskActive({ taskId: duplicateId, userId: session.user.id });
-      const duplicate = await getCanvasImageTaskForUser({ taskId: duplicateId, userId: session.user.id });
-      return NextResponse.json({ task: taskResponse(duplicate) });
-    }
-
-    let task: Awaited<ReturnType<typeof createCanvasImageTask>>;
-    try {
-      task = await createCanvasImageTask({
-        taskId, userId: session.user.id, request: taskRequest as unknown as Record<string, unknown>,
-      });
-    } catch (error) {
-      if (!isUniqueViolation(error)) throw error;
-      // Two identical submissions raced past the lookup above; the database
-      // unique index kept one of them, so answer with that batch.
-      const racedId = await findActiveBatchId({
-        userId: session.user.id, projectId, submissionKey,
-      });
-      if (!racedId) throw error;
-      const raced = await getCanvasImageTaskForUser({ taskId: racedId, userId: session.user.id });
-      return NextResponse.json({ task: taskResponse(raced) });
-    }
-    const existingTask = await getCanvasImageTaskForUser({ taskId: task.id, userId: session.user.id });
-    const storedRequest = existingTask?.request as DetailReplacementBatchRequest | null;
-    if (
-      !isDetailReplacementBatchRequest(storedRequest) ||
-      storedRequest.projectId !== projectId ||
-      (storedRequest.submissionKey && storedRequest.submissionKey !== submissionKey)
-    ) {
-      return NextResponse.json({ error: "任务编号已被其他请求使用" }, { status: 409 });
-    }
-    await db.insert(message).values({
-      id: taskId,
-      chatId,
-      role: "user",
-      parts: [{ type: "text", text: taskRequest.userPrompt || `批量替换 ${references.length} 张详情图` }],
-      attachments: [],
-      createdAt: new Date(),
-    }).onConflictDoNothing({ target: message.id });
-    await enqueueCanvasImageTask(task.id);
-    const current = await getCanvasImageTaskForUser({ taskId, userId: session.user.id });
-    return NextResponse.json({ task: taskResponse(current) });
-  } catch (error) {
-    console.error("[Detail Replacement Batch] Failed to start", error);
-    return NextResponse.json({ error: error instanceof Error ? error.message : "提交详情替换任务失败" }, { status: 500 });
-  }
-}

app/api/ai-cad/modeling/command/route.ts

@@ -0,0 +1,122 @@
+import { randomUUID } from "node:crypto";
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  getKittyCadModelingCommandError,
+  isKittyCadModelingCommandSuccessful,
+  sendKittyCadModelingCommand,
+  takeKittyCadModelingSnapshot,
+} from "@/lib/kittycad/modeling-session";
+
+export const runtime = "nodejs";
+export const maxDuration = 60;
+
+type ModelingCommandRequest = {
+  captureSnapshot?: boolean;
+  cmd?: Record<string, unknown>;
+  cmdId?: string;
+  sessionId?: string;
+  snapshotFormat?: "jpeg" | "png";
+};
+
+function readOptionalRecord(value: unknown) {
+  return value && typeof value === "object" && !Array.isArray(value)
+    ? (value as Record<string, unknown>)
+    : null;
+}
+
+export async function POST(request: Request) {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json(
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const body = (await request.json()) as ModelingCommandRequest;
+    const sessionId = String(body.sessionId || "").trim();
+    if (!sessionId) {
+      return NextResponse.json(
+        { success: false, error: "缺少官方建模会话 ID" },
+        { status: 400 }
+      );
+    }
+
+    const cmd = readOptionalRecord(body.cmd);
+    const cmdType = String(cmd?.type || "").trim();
+    if (!cmd || !cmdType) {
+      return NextResponse.json(
+        { success: false, error: "缺少有效的官方建模命令" },
+        { status: 400 }
+      );
+    }
+
+    const cmdId = String(body.cmdId || "").trim() || randomUUID();
+    const response = await sendKittyCadModelingCommand({
+      cmd: {
+        ...cmd,
+        type: cmdType,
+      },
+      cmdId,
+      sessionId,
+    });
+
+    if (!isKittyCadModelingCommandSuccessful(response)) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: getKittyCadModelingCommandError(response),
+          payload: response.errors || null,
+        },
+        { status: 400 }
+      );
+    }
+
+    let snapshotUrl: string | null = null;
+    let snapshotError: string | null = null;
+
+    const shouldCaptureSnapshot =
+      body.captureSnapshot === true && cmdType !== "take_snapshot";
+
+    if (cmdType === "take_snapshot") {
+      const contents = String(response.resp?.data?.contents || "").trim();
+      const snapshotFormat = body.snapshotFormat || "png";
+      snapshotUrl = contents
+        ? `data:${snapshotFormat === "jpeg" ? "image/jpeg" : "image/png"};base64,${contents}`
+        : null;
+    } else if (shouldCaptureSnapshot) {
+      try {
+        const snapshot = await takeKittyCadModelingSnapshot({
+          format: body.snapshotFormat || "png",
+          sessionId,
+        });
+        snapshotUrl = snapshot.snapshotUrl;
+      } catch (error) {
+        snapshotError =
+          error instanceof Error ? error.message : "获取官方建模快照失败";
+      }
+    }
+
+    return NextResponse.json({
+      success: true,
+      data: {
+        raw: response,
+        requestId: response.request_id || cmdId,
+        responseData: response.resp?.data || null,
+        responseType: response.resp?.type || cmdType,
+        snapshotError,
+        snapshotUrl,
+      },
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "发送官方建模命令失败",
+      },
+      { status: 500 }
+    );
+  }
+}

app/api/ai-cad/modeling/session/[sessionId]/route.ts

@@ -0,0 +1,48 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import { closeKittyCadModelingSession } from "@/lib/kittycad/modeling-session";
+
+export const runtime = "nodejs";
+export const maxDuration = 60;
+
+type RouteParams = {
+  params: Promise<{
+    sessionId: string;
+  }>;
+};
+
+export async function DELETE(_request: Request, { params }: RouteParams) {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json(
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const { sessionId } = await params;
+    const normalizedSessionId = String(sessionId || "").trim();
+    if (!normalizedSessionId) {
+      return NextResponse.json(
+        { success: false, error: "缺少 sessionId" },
+        { status: 400 }
+      );
+    }
+
+    const result = await closeKittyCadModelingSession(normalizedSessionId);
+
+    return NextResponse.json({
+      success: true,
+      data: result,
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "关闭官方建模会话失败",
+      },
+      { status: 500 }
+    );
+  }
+}

app/api/ai-cad/modeling/session/route.ts

@@ -0,0 +1,33 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import { createKittyCadModelingSession } from "@/lib/kittycad/modeling-session";
+
+export const runtime = "nodejs";
+export const maxDuration = 60;
+
+export async function POST() {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json(
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const modelingSession = await createKittyCadModelingSession();
+
+    return NextResponse.json({
+      success: true,
+      data: modelingSession,
+    });
+  } catch (error) {
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "创建官方建模会话失败",
+      },
+      { status: 500 }
+    );
+  }
+}

app/api/ai-cad/provider/route.ts

@@ -0,0 +1,27 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import { findKittyCadProviderConfig } from "@/lib/kittycad/server";
+
+export const runtime = "nodejs";
+
+export async function GET() {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const config = await findKittyCadProviderConfig();
+
+  return NextResponse.json({
+    success: true,
+    data: {
+      configured: Boolean(config),
+      source: config?.source || "none",
+      providerName: config?.providerName || null,
+      baseUrl: config?.baseUrl || null,
+    },
+  });
+}

app/api/ai-cad/tasks/[taskId]/route.ts

@@ -0,0 +1,467 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import { KittyCadApiError, kittyCadRequest } from "@/lib/kittycad/client";
+import { getKittyCadProviderConfig } from "@/lib/kittycad/server";
+import { uploadFile } from "@/lib/storage/service";
+
+export const runtime = "nodejs";
+export const maxDuration = 60;
+
+type KittyCadTaskResponse = {
+  id?: string;
+  status?: string;
+  outputs?: Record<string, string> | null;
+  error?: string | null;
+  code?: string | null;
+  prompt?: string | null;
+  conversation_id?: string | null;
+  model_version?: string | null;
+  output_format?: string | null;
+};
+
+type KittyCadAsyncOperationResponse = KittyCadTaskResponse & {
+  type?: string | null;
+};
+
+type ArchivedFile = {
+  sourceHash: string;
+  archivedUrl: string;
+};
+
+type RouteParams = {
+  params: Promise<{ taskId: string }>;
+};
+
+function getArchiveCache() {
+  const globalState = globalThis as Record<string, unknown>;
+  if (!globalState.__kittyCadAssetArchiveCache) {
+    globalState.__kittyCadAssetArchiveCache = new Map<string, ArchivedFile>();
+  }
+  return globalState.__kittyCadAssetArchiveCache as Map<string, ArchivedFile>;
+}
+
+function getArchiveInflight() {
+  const globalState = globalThis as Record<string, unknown>;
+  if (!globalState.__kittyCadAssetArchiveInflight) {
+    globalState.__kittyCadAssetArchiveInflight = new Map<
+      string,
+      Promise<string | null>
+    >();
+  }
+  return globalState.__kittyCadAssetArchiveInflight as Map<
+    string,
+    Promise<string | null>
+  >;
+}
+
+function mapKittyCadStatus(status: unknown) {
+  const normalized = String(status || "")
+    .trim()
+    .toLowerCase();
+  if (!normalized) {
+    return "queued" as const;
+  }
+  if (
+    normalized === "queued" ||
+    normalized === "pending" ||
+    normalized === "created" ||
+    normalized === "submitted"
+  ) {
+    return "queued" as const;
+  }
+  if (
+    normalized === "running" ||
+    normalized === "processing" ||
+    normalized === "in_progress" ||
+    normalized === "working" ||
+    normalized === "generating"
+  ) {
+    return "running" as const;
+  }
+  if (
+    normalized === "completed" ||
+    normalized === "success" ||
+    normalized === "succeeded" ||
+    normalized === "done" ||
+    normalized === "finished"
+  ) {
+    return "success" as const;
+  }
+  if (normalized === "cancelled" || normalized === "canceled") {
+    return "cancelled" as const;
+  }
+  if (normalized === "expired" || normalized === "timed_out") {
+    return "expired" as const;
+  }
+  if (normalized === "banned" || normalized === "blocked") {
+    return "banned" as const;
+  }
+  if (
+    normalized === "failed" ||
+    normalized === "error" ||
+    normalized === "errored"
+  ) {
+    return "failed" as const;
+  }
+  return "unknown" as const;
+}
+
+function getFileExtension(filename: string) {
+  const normalized = String(filename || "")
+    .trim()
+    .toLowerCase();
+  const cleanName = normalized.split("?")[0]?.split("#")[0] || normalized;
+  const segments = cleanName.split(".");
+  return segments.length > 1 ? segments.at(-1) || "" : "";
+}
+
+function isImageExtension(extension: string) {
+  return ["png", "jpg", "jpeg", "webp", "gif"].includes(extension);
+}
+
+function pickPreferredModelFile(files: Array<{ name: string; url: string }>) {
+  const preferredOrder = ["glb", "gltf", "obj", "stl", "step", "stp"];
+  for (const extension of preferredOrder) {
+    const matched = files.find(
+      (item) => getFileExtension(item.name) === extension
+    );
+    if (matched) {
+      return matched;
+    }
+  }
+  return null;
+}
+
+function pickPreviewImageFile(files: Array<{ name: string; url: string }>) {
+  return (
+    files.find((item) => isImageExtension(getFileExtension(item.name))) || null
+  );
+}
+
+function extractOutputEntries(task: KittyCadTaskResponse) {
+  return Object.entries(task.outputs || {}).filter(
+    (entry): entry is [string, string] =>
+      typeof entry[0] === "string" &&
+      entry[0].trim().length > 0 &&
+      typeof entry[1] === "string" &&
+      entry[1].trim().length > 0
+  );
+}
+
+async function enrichTextToCadOutputs(params: {
+  config: Awaited<ReturnType<typeof getKittyCadProviderConfig>>;
+  task: KittyCadTaskResponse;
+  taskId: string;
+}) {
+  if (extractOutputEntries(params.task).length > 0) {
+    return params.task;
+  }
+
+  try {
+    const asyncOperation = await kittyCadRequest<KittyCadAsyncOperationResponse>(
+      params.config,
+      {
+        method: "GET",
+        path: `/async/operations/${encodeURIComponent(params.taskId)}`,
+      }
+    );
+
+    if (extractOutputEntries(asyncOperation).length === 0) {
+      return params.task;
+    }
+
+    return {
+      ...params.task,
+      ...asyncOperation,
+      code: asyncOperation.code || params.task.code || null,
+      conversation_id:
+        asyncOperation.conversation_id || params.task.conversation_id || null,
+      model_version:
+        asyncOperation.model_version || params.task.model_version || null,
+      output_format:
+        asyncOperation.output_format || params.task.output_format || null,
+      outputs: asyncOperation.outputs,
+      prompt: asyncOperation.prompt || params.task.prompt || null,
+    } satisfies KittyCadTaskResponse;
+  } catch (error) {
+    console.warn("[KittyCADStatus] async output fallback failed", {
+      taskId: params.taskId,
+      error: error instanceof Error ? error.message : String(error),
+    });
+    return params.task;
+  }
+}
+
+function createClientSafeTaskOutput(task: KittyCadTaskResponse) {
+  const outputEntries = extractOutputEntries(task);
+  const outputSummary = Object.fromEntries(
+    outputEntries.map(([name, base64]) => [
+      name,
+      {
+        base64Length: base64.length,
+        extension: getFileExtension(name) || null,
+      },
+    ])
+  );
+
+  return {
+    ...task,
+    outputs: outputSummary,
+  };
+}
+
+async function archiveOutputIfNeeded(params: {
+  taskId: string;
+  filename: string;
+  base64: string;
+}) {
+  const normalizedFilename = String(params.filename || "").trim();
+  const normalizedBase64 = String(params.base64 || "").trim();
+  if (!normalizedFilename || !normalizedBase64) {
+    return null;
+  }
+
+  const cacheKey = `${params.taskId}:${normalizedFilename}`;
+  const cache = getArchiveCache();
+  const cached = cache.get(cacheKey);
+  if (cached && cached.sourceHash === normalizedBase64) {
+    return cached.archivedUrl;
+  }
+
+  const inflight = getArchiveInflight();
+  const existingTask = inflight.get(cacheKey);
+  if (existingTask) {
+    return (await existingTask) || null;
+  }
+
+  const archiveTask = (async () => {
+    try {
+      const binary = Buffer.from(normalizedBase64, "base64");
+      if (binary.byteLength <= 0) {
+        throw new Error("KittyCAD 输出文件为空");
+      }
+      const arrayBuffer = Uint8Array.from(binary).buffer;
+
+      const safeFilename =
+        normalizedFilename.replace(/[^\w.-]+/g, "-") || "kittycad-output.bin";
+      const uploaded = await uploadFile(
+        `kittycad-${params.taskId}-${safeFilename}`,
+        arrayBuffer
+      );
+      cache.set(cacheKey, {
+        sourceHash: normalizedBase64,
+        archivedUrl: uploaded.url,
+      });
+      return uploaded.url;
+    } catch (error) {
+      console.error("[KittyCADArchive] failed", {
+        taskId: params.taskId,
+        filename: normalizedFilename,
+        error: error instanceof Error ? error.message : String(error),
+      });
+      return null;
+    } finally {
+      inflight.delete(cacheKey);
+    }
+  })();
+
+  inflight.set(cacheKey, archiveTask);
+  return await archiveTask;
+}
+
+async function archiveTextOutputIfNeeded(params: {
+  taskId: string;
+  filename: string;
+  content: string;
+}) {
+  const normalizedFilename = String(params.filename || "").trim();
+  const normalizedContent = String(params.content || "");
+  if (!normalizedFilename || !normalizedContent.trim()) {
+    return null;
+  }
+
+  const cacheKey = `${params.taskId}:${normalizedFilename}`;
+  const cache = getArchiveCache();
+  const cached = cache.get(cacheKey);
+  if (cached && cached.sourceHash === normalizedContent) {
+    return cached.archivedUrl;
+  }
+
+  const inflight = getArchiveInflight();
+  const existingTask = inflight.get(cacheKey);
+  if (existingTask) {
+    return (await existingTask) || null;
+  }
+
+  const archiveTask = (async () => {
+    try {
+      const arrayBuffer = Uint8Array.from(
+        new TextEncoder().encode(normalizedContent)
+      ).buffer;
+      const safeFilename =
+        normalizedFilename.replace(/[^\w.-]+/g, "-") || "kittycad-output.kcl";
+      const uploaded = await uploadFile(
+        `kittycad-${params.taskId}-${safeFilename}`,
+        arrayBuffer
+      );
+      cache.set(cacheKey, {
+        sourceHash: normalizedContent,
+        archivedUrl: uploaded.url,
+      });
+      return uploaded.url;
+    } catch (error) {
+      console.error("[KittyCADArchive:text] failed", {
+        taskId: params.taskId,
+        filename: normalizedFilename,
+        error: error instanceof Error ? error.message : String(error),
+      });
+      return null;
+    } finally {
+      inflight.delete(cacheKey);
+    }
+  })();
+
+  inflight.set(cacheKey, archiveTask);
+  return await archiveTask;
+}
+
+export async function GET(_request: Request, { params }: RouteParams) {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json(
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const { taskId } = await params;
+    const normalizedTaskId = String(taskId || "").trim();
+    if (!normalizedTaskId) {
+      return NextResponse.json(
+        { success: false, error: "缺少 taskId" },
+        { status: 400 }
+      );
+    }
+
+    const config = await getKittyCadProviderConfig();
+    let result = await kittyCadRequest<KittyCadTaskResponse>(config, {
+      method: "GET",
+      path: `/user/text-to-cad/${encodeURIComponent(normalizedTaskId)}`,
+    });
+
+    const status = mapKittyCadStatus(result.status);
+    if (status !== "success") {
+      return NextResponse.json({
+        success: true,
+        data: {
+          taskId: normalizedTaskId,
+          type: "cad",
+          status,
+          progress: status === "running" ? 65 : null,
+          errorMessage: result.error || null,
+          conversationId: result.conversation_id || null,
+          modelVersion: result.model_version || null,
+          outputFormat: result.output_format || null,
+          output: createClientSafeTaskOutput(result),
+        },
+      });
+    }
+
+    result = await enrichTextToCadOutputs({
+      config,
+      task: result,
+      taskId: normalizedTaskId,
+    });
+
+    const outputEntries = extractOutputEntries(result);
+
+    const archivedEntries = await Promise.all(
+      outputEntries.map(async ([name, base64]) => {
+        const archivedUrl = await archiveOutputIfNeeded({
+          taskId: normalizedTaskId,
+          filename: name,
+          base64,
+        });
+        return archivedUrl ? { name, url: archivedUrl } : null;
+      })
+    );
+
+    const archivedFiles = archivedEntries.filter(
+      (item): item is { name: string; url: string } =>
+        Boolean(item?.name && item?.url)
+    );
+
+    const hasArchivedKclFile = archivedFiles.some(
+      (item) => getFileExtension(item.name) === "kcl"
+    );
+    if (
+      !hasArchivedKclFile &&
+      typeof result.code === "string" &&
+      result.code.trim()
+    ) {
+      const archivedCodeUrl = await archiveTextOutputIfNeeded({
+        taskId: normalizedTaskId,
+        filename: "main.kcl",
+        content: result.code,
+      });
+      if (archivedCodeUrl) {
+        archivedFiles.push({
+          name: "main.kcl",
+          url: archivedCodeUrl,
+        });
+      }
+    }
+
+    const modelFile = pickPreferredModelFile(archivedFiles);
+    const previewImageFile = pickPreviewImageFile(archivedFiles);
+    const downloadUrls = Object.fromEntries(
+      archivedFiles.map((item) => [item.name, item.url])
+    );
+    const codeFile =
+      archivedFiles.find((item) => getFileExtension(item.name) === "kcl") ||
+      null;
+
+    return NextResponse.json({
+      success: true,
+      data: {
+        taskId: normalizedTaskId,
+        type: "cad",
+        status: "success",
+        progress: 100,
+        modelUrl:
+          modelFile &&
+          ["glb", "gltf"].includes(getFileExtension(modelFile.name))
+            ? modelFile.url
+            : null,
+        previewImageUrl: previewImageFile?.url || null,
+        errorMessage: result.error || null,
+        conversationId: result.conversation_id || null,
+        modelVersion: result.model_version || null,
+        outputFormat: result.output_format || null,
+        codeUrl: codeFile?.url || null,
+        downloadUrls,
+        output: createClientSafeTaskOutput(result),
+      },
+    });
+  } catch (error) {
+    if (error instanceof KittyCadApiError) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: error.message,
+          payload: error.payload,
+        },
+        { status: error.httpStatus || 502 }
+      );
+    }
+
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "查询 AI-CAD 任务失败",
+      },
+      { status: 500 }
+    );
+  }
+}

app/api/ai-cad/tasks/route.ts

@@ -0,0 +1,331 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  consumeUserPoints,
+  getPointsSystemConfig,
+  getUserById,
+} from "@/lib/db/queries";
+import { KittyCadApiError, kittyCadRequest } from "@/lib/kittycad/client";
+import { getKittyCadProviderConfig } from "@/lib/kittycad/server";
+
+export const runtime = "nodejs";
+export const maxDuration = 60;
+
+type CreateAiCadTaskRequest = {
+  prompt?: string;
+  outputFormat?: string;
+  projectName?: string;
+  iterationSourceTaskId?: string;
+  sourceCode?: string;
+  sourceRanges?: Record<string, unknown>[];
+};
+
+type KittyCadCreateResponse = {
+  id?: string;
+  status?: string;
+  conversation_id?: string | null;
+  model_version?: string | null;
+  output_format?: string | null;
+};
+
+type KittyCadSourceTaskResponse = {
+  code?: string | null;
+  outputs?: Record<string, string> | null;
+};
+
+type KittyCadIterationResponse = {
+  id?: string;
+  status?: string;
+  conversation_id?: string | null;
+  model_version?: string | null;
+  output_format?: string | null;
+};
+
+function getFileExtension(filename: string) {
+  const normalized = String(filename || "")
+    .trim()
+    .toLowerCase();
+  const cleanName = normalized.split("?")[0]?.split("#")[0] || normalized;
+  const segments = cleanName.split(".");
+  return segments.length > 1 ? segments.at(-1) || "" : "";
+}
+
+function decodeBase64Text(value: unknown) {
+  const normalized = String(value || "").trim();
+  if (!normalized) {
+    return null;
+  }
+
+  try {
+    const decoded = Buffer.from(normalized, "base64").toString("utf8").trim();
+    return decoded || null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+function extractSourceCodeFromTask(task: KittyCadSourceTaskResponse) {
+  const directCode = String(task.code || "").trim();
+  if (directCode) {
+    return directCode;
+  }
+
+  const kclOutputEntry = Object.entries(task.outputs || {}).find(
+    (entry): entry is [string, string] =>
+      typeof entry[0] === "string" &&
+      entry[0].trim().length > 0 &&
+      getFileExtension(entry[0]) === "kcl" &&
+      typeof entry[1] === "string" &&
+      entry[1].trim().length > 0
+  );
+
+  if (!kclOutputEntry) {
+    return null;
+  }
+
+  return decodeBase64Text(kclOutputEntry[1]);
+}
+
+function mapKittyCadStatus(status: unknown) {
+  const normalized = String(status || "")
+    .trim()
+    .toLowerCase();
+  if (!normalized) {
+    return "queued" as const;
+  }
+  if (
+    normalized === "queued" ||
+    normalized === "pending" ||
+    normalized === "created" ||
+    normalized === "submitted"
+  ) {
+    return "queued" as const;
+  }
+  if (
+    normalized === "running" ||
+    normalized === "processing" ||
+    normalized === "in_progress" ||
+    normalized === "working" ||
+    normalized === "generating"
+  ) {
+    return "running" as const;
+  }
+  if (
+    normalized === "completed" ||
+    normalized === "success" ||
+    normalized === "succeeded" ||
+    normalized === "done" ||
+    normalized === "finished"
+  ) {
+    return "success" as const;
+  }
+  if (normalized === "cancelled" || normalized === "canceled") {
+    return "cancelled" as const;
+  }
+  if (normalized === "expired" || normalized === "timed_out") {
+    return "expired" as const;
+  }
+  if (normalized === "banned" || normalized === "blocked") {
+    return "banned" as const;
+  }
+  if (
+    normalized === "failed" ||
+    normalized === "error" ||
+    normalized === "errored"
+  ) {
+    return "failed" as const;
+  }
+  return "unknown" as const;
+}
+
+export async function POST(request: Request) {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json(
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const body = (await request.json()) as CreateAiCadTaskRequest;
+    const prompt = String(body.prompt || "").trim();
+
+    const pointsConfig = await getPointsSystemConfig();
+    const unitCost = Number.isFinite(Number(pointsConfig.creditCostPer3DModel))
+      ? Math.max(0, Math.round(Number(pointsConfig.creditCostPer3DModel)))
+      : 0;
+
+    if (
+      pointsConfig.enabled &&
+      unitCost > 0 &&
+      pointsConfig.blockOnInsufficient !== false
+    ) {
+      const userData = await getUserById({ id: session.user.id });
+      if (!userData?.isHighVip) {
+        const currentBalance = Math.max(
+          0,
+          Number(userData?.pointsBalance || 0)
+        );
+        if (currentBalance < unitCost) {
+          return NextResponse.json(
+            {
+              success: false,
+              error: "积分不足",
+              code: "insufficient_points",
+              message: `积分不足，当前余额 ${currentBalance}，本次预计消耗 ${unitCost}。`,
+              balance: currentBalance,
+              expectedCost: unitCost,
+              unitCost,
+            },
+            { status: 402 }
+          );
+        }
+      }
+    }
+
+    const outputFormat =
+      String(body.outputFormat || "glb")
+        .trim()
+        .toLowerCase() || "glb";
+    const normalizedProjectName = String(body.projectName || "").trim();
+    const iterationSourceTaskId = String(
+      body.iterationSourceTaskId || ""
+    ).trim();
+    const sourceCode = String(body.sourceCode || "");
+    const normalizedSourceCode = sourceCode.trim();
+    const sourceRanges = Array.isArray(body.sourceRanges)
+      ? body.sourceRanges.filter(
+          (item): item is Record<string, unknown> =>
+            Boolean(item) && typeof item === "object" && !Array.isArray(item)
+        )
+      : [];
+    const config = await getKittyCadProviderConfig();
+    const generationMode =
+      iterationSourceTaskId || normalizedSourceCode ? "iterate" : "create";
+
+    if (generationMode === "create" && !prompt) {
+      return NextResponse.json(
+        { success: false, error: "请输入 CAD 描述" },
+        { status: 400 }
+      );
+    }
+
+    const iterationPrompt =
+      prompt || "Apply the edited KCL source and rebuild the CAD model.";
+    const result =
+      generationMode === "iterate"
+        ? await (async () => {
+            const originalSourceCode =
+              normalizedSourceCode ||
+              (await (async () => {
+                if (!iterationSourceTaskId) {
+                  return null;
+                }
+
+                const sourceTask =
+                  await kittyCadRequest<KittyCadSourceTaskResponse>(config, {
+                    method: "GET",
+                    path: `/user/text-to-cad/${encodeURIComponent(iterationSourceTaskId)}`,
+                  });
+                return extractSourceCodeFromTask(sourceTask);
+              })());
+
+            if (!originalSourceCode) {
+              throw new KittyCadApiError({
+                message:
+                  "当前参考版本缺少可继续编辑的 KCL 源码，请先等待该版本完成，或重新选择一个 KittyCAD 版本。",
+                httpStatus: 409,
+              });
+            }
+
+            return kittyCadRequest<KittyCadIterationResponse>(config, {
+              method: "POST",
+              path: "/ml/text-to-cad/iteration",
+              json: {
+                original_source_code: originalSourceCode,
+                prompt: iterationPrompt,
+                source_ranges: sourceRanges,
+                ...(normalizedProjectName
+                  ? { project_name: normalizedProjectName }
+                  : {}),
+              },
+            });
+          })()
+        : await kittyCadRequest<KittyCadCreateResponse>(config, {
+            method: "POST",
+            path: `/ai/text-to-cad/${encodeURIComponent(outputFormat)}?kcl=true`,
+            json: {
+              prompt,
+              ...(normalizedProjectName
+                ? { project_name: normalizedProjectName }
+                : {}),
+            },
+          });
+
+    const taskId = String(result.id || "").trim();
+    if (!taskId) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: "KittyCAD 返回缺少任务 ID",
+          raw: result,
+        },
+        { status: 502 }
+      );
+    }
+
+    if (pointsConfig.enabled && unitCost > 0) {
+      try {
+        await consumeUserPoints({
+          userId: session.user.id,
+          amount: unitCost,
+          reason: "model3d_generation",
+          modelId: "kittycad-cad",
+          note:
+            generationMode === "iterate"
+              ? "AI-CAD 连续迭代消耗积分"
+              : "AI-CAD 生成消耗积分",
+        });
+      } catch (error) {
+        console.error("[Points] Failed to consume AI-CAD points:", error);
+      }
+    }
+
+    return NextResponse.json({
+      success: true,
+      data: {
+        taskId,
+        status: mapKittyCadStatus(result.status),
+        conversationId: result.conversation_id || null,
+        modelVersion: result.model_version || null,
+        outputFormat:
+          generationMode === "iterate"
+            ? result.output_format || null
+            : result.output_format || outputFormat,
+        generationMode,
+        sourceTaskId: iterationSourceTaskId || null,
+        raw: result,
+      },
+    });
+  } catch (error) {
+    if (error instanceof KittyCadApiError) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: error.message,
+          payload: error.payload,
+        },
+        { status: error.httpStatus || 502 }
+      );
+    }
+
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "创建 AI-CAD 任务失败",
+      },
+      { status: 500 }
+    );
+  }
+}

app/api/ai-cad/workspace-utils.ts

@@ -0,0 +1,195 @@
+import type { AiCadWorkspace } from "@/lib/db/schema";
+
+type CadGenerationProvider = "kittycad-cad" | "tripo-3d";
+
+const FINAL_TASK_STATUS = new Set([
+  "success",
+  "failed",
+  "banned",
+  "expired",
+  "cancelled",
+  "unknown",
+]);
+
+const DEFAULT_VIEWER_SETTINGS = {
+  cameraPreset: "iso",
+  envPreset: "studio",
+  lightIntensity: 1.1,
+  autoRotate: true,
+  showGrid: true,
+  wireframe: false,
+} as const;
+
+type WorkspaceVersionLike = {
+  status?: unknown;
+  prompt?: unknown;
+};
+
+export type UpdateAiCadWorkspaceRequest = {
+  name?: string;
+  prompt?: string;
+  generationProvider?: string;
+  modelVersion?: string;
+  viewerSettings?: unknown;
+  messages?: unknown;
+  versions?: unknown;
+  activeVersionId?: string | null;
+};
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+function getWorkspaceVersions(value: unknown): WorkspaceVersionLike[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value.filter((item): item is WorkspaceVersionLike => isRecord(item));
+}
+
+export function normalizeViewerSettings(
+  value: unknown
+): Record<string, unknown> {
+  if (!isRecord(value)) {
+    return { ...DEFAULT_VIEWER_SETTINGS };
+  }
+
+  return {
+    cameraPreset:
+      value.cameraPreset === "top" ||
+      value.cameraPreset === "front" ||
+      value.cameraPreset === "right" ||
+      value.cameraPreset === "iso"
+        ? value.cameraPreset
+        : DEFAULT_VIEWER_SETTINGS.cameraPreset,
+    envPreset:
+      typeof value.envPreset === "string" && value.envPreset.trim()
+        ? value.envPreset
+        : DEFAULT_VIEWER_SETTINGS.envPreset,
+    lightIntensity:
+      typeof value.lightIntensity === "number" &&
+      Number.isFinite(value.lightIntensity)
+        ? value.lightIntensity
+        : DEFAULT_VIEWER_SETTINGS.lightIntensity,
+    autoRotate:
+      typeof value.autoRotate === "boolean"
+        ? value.autoRotate
+        : DEFAULT_VIEWER_SETTINGS.autoRotate,
+    showGrid:
+      typeof value.showGrid === "boolean"
+        ? value.showGrid
+        : DEFAULT_VIEWER_SETTINGS.showGrid,
+    wireframe:
+      typeof value.wireframe === "boolean"
+        ? value.wireframe
+        : DEFAULT_VIEWER_SETTINGS.wireframe,
+  };
+}
+
+export function normalizeJsonRecordArray(
+  value: unknown
+): Record<string, unknown>[] {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+
+  return value.filter((item): item is Record<string, unknown> =>
+    isRecord(item)
+  );
+}
+
+export function normalizeWorkspaceName(
+  value: unknown,
+  fallbackName = "AI-CAD 工作台"
+) {
+  return typeof value === "string" && value.trim()
+    ? value.trim()
+    : fallbackName;
+}
+
+export function normalizeWorkspacePayload(body: UpdateAiCadWorkspaceRequest): {
+  name?: string;
+  prompt: string;
+  generationProvider: CadGenerationProvider;
+  modelVersion: string;
+  viewerSettings: Record<string, unknown>;
+  messages: Record<string, unknown>[];
+  versions: Record<string, unknown>[];
+  activeVersionId: string | null;
+} {
+  return {
+    ...(typeof body.name === "string" && body.name.trim()
+      ? { name: body.name.trim() }
+      : {}),
+    prompt: String(body.prompt || ""),
+    generationProvider:
+      body.generationProvider === "tripo-3d" ? "tripo-3d" : "kittycad-cad",
+    modelVersion:
+      typeof body.modelVersion === "string" && body.modelVersion.trim()
+        ? body.modelVersion
+        : "Turbo-v1.0-20250506",
+    viewerSettings: normalizeViewerSettings(body.viewerSettings),
+    messages: normalizeJsonRecordArray(body.messages),
+    versions: normalizeJsonRecordArray(body.versions),
+    activeVersionId:
+      typeof body.activeVersionId === "string" && body.activeVersionId.trim()
+        ? body.activeVersionId
+        : null,
+  };
+}
+
+export function buildDefaultWorkspaceName(index: number) {
+  return index > 1 ? `AI-CAD 工作台 ${index}` : "AI-CAD 工作台";
+}
+
+export function createWorkspaceSummary(workspace: AiCadWorkspace) {
+  const versions = getWorkspaceVersions(workspace.versions);
+  const versionCount = versions.length;
+  const completedCount = versions.filter(
+    (version) => version.status === "success"
+  ).length;
+  const hasPendingTasks = versions.some(
+    (version) =>
+      typeof version.status !== "string" ||
+      !FINAL_TASK_STATUS.has(version.status)
+  );
+  const latestPrompt =
+    typeof workspace.prompt === "string" && workspace.prompt.trim()
+      ? workspace.prompt.trim()
+      : versions.find(
+          (version) =>
+            typeof version.prompt === "string" && version.prompt.trim()
+        )?.prompt || null;
+
+  return {
+    id: workspace.id,
+    name: workspace.name,
+    generationProvider: workspace.generationProvider,
+    versionCount,
+    completedCount,
+    hasPendingTasks,
+    latestPrompt:
+      typeof latestPrompt === "string" && latestPrompt.trim()
+        ? latestPrompt.trim()
+        : null,
+    createdAt: workspace.createdAt?.toISOString() || null,
+    updatedAt: workspace.updatedAt?.toISOString() || null,
+  };
+}
+
+export function createWorkspaceDocument(workspace: AiCadWorkspace) {
+  return {
+    id: workspace.id,
+    name: workspace.name,
+    prompt: workspace.prompt,
+    generationProvider: workspace.generationProvider,
+    modelVersion: workspace.modelVersion,
+    viewerSettings: workspace.viewerSettings,
+    messages: workspace.messages,
+    versions: workspace.versions,
+    activeVersionId: workspace.activeVersionId,
+    createdAt: workspace.createdAt?.toISOString() || null,
+    updatedAt: workspace.updatedAt?.toISOString() || null,
+  };
+}

app/api/ai-cad/workspace/route.ts

@@ -0,0 +1,89 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  createWorkspaceDocument,
+  normalizeWorkspacePayload,
+  type UpdateAiCadWorkspaceRequest,
+} from "@/app/api/ai-cad/workspace-utils";
+import {
+  createAiCadWorkspace,
+  listAiCadWorkspacesByUserId,
+  updateAiCadWorkspace,
+} from "@/lib/db/queries";
+
+export const runtime = "nodejs";
+
+export async function GET() {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const workspaces = await listAiCadWorkspacesByUserId({
+    userId: session.user.id,
+  });
+  const workspace = workspaces[0] ?? null;
+
+  if (!workspace) {
+    return NextResponse.json({
+      success: true,
+      data: null,
+    });
+  }
+
+  return NextResponse.json({
+    success: true,
+    data: createWorkspaceDocument(workspace),
+  });
+}
+
+export async function PUT(request: Request) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const body = (await request.json()) as UpdateAiCadWorkspaceRequest;
+  const existingWorkspaces = await listAiCadWorkspacesByUserId({
+    userId: session.user.id,
+  });
+  const targetWorkspace =
+    existingWorkspaces[0] ??
+    (await createAiCadWorkspace({
+      userId: session.user.id,
+      name: "AI-CAD 工作台",
+    }));
+
+  if (!targetWorkspace) {
+    return NextResponse.json(
+      { success: false, error: "初始化 AI-CAD 工作台失败" },
+      { status: 500 }
+    );
+  }
+
+  const savedWorkspace = await updateAiCadWorkspace({
+    workspaceId: targetWorkspace.id,
+    userId: session.user.id,
+    ...normalizeWorkspacePayload(body),
+  });
+
+  if (!savedWorkspace) {
+    return NextResponse.json(
+      { success: false, error: "保存 AI-CAD 工作台失败" },
+      { status: 500 }
+    );
+  }
+
+  return NextResponse.json({
+    success: true,
+    data: {
+      updatedAt: savedWorkspace.updatedAt?.toISOString() || null,
+    },
+  });
+}

app/api/ai-cad/workspaces/[workspaceId]/route.ts

@@ -0,0 +1,114 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  createWorkspaceDocument,
+  createWorkspaceSummary,
+  normalizeWorkspacePayload,
+  type UpdateAiCadWorkspaceRequest,
+} from "@/app/api/ai-cad/workspace-utils";
+import {
+  deleteAiCadWorkspaceById,
+  getAiCadWorkspaceById,
+  updateAiCadWorkspace,
+} from "@/lib/db/queries";
+
+export const runtime = "nodejs";
+
+type RouteContext = {
+  params: Promise<{
+    workspaceId: string;
+  }>;
+};
+
+export async function GET(_request: Request, context: RouteContext) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const { workspaceId } = await context.params;
+  const workspace = await getAiCadWorkspaceById({
+    userId: session.user.id,
+    workspaceId,
+  });
+
+  if (!workspace) {
+    return NextResponse.json(
+      { success: false, error: "AI-CAD 工作台不存在" },
+      { status: 404 }
+    );
+  }
+
+  return NextResponse.json({
+    success: true,
+    data: createWorkspaceDocument(workspace),
+  });
+}
+
+export async function PUT(request: Request, context: RouteContext) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const { workspaceId } = await context.params;
+  const body = (await request.json()) as UpdateAiCadWorkspaceRequest;
+  const savedWorkspace = await updateAiCadWorkspace({
+    workspaceId,
+    userId: session.user.id,
+    ...normalizeWorkspacePayload(body),
+  });
+
+  if (!savedWorkspace) {
+    return NextResponse.json(
+      { success: false, error: "AI-CAD 工作台不存在或保存失败" },
+      { status: 404 }
+    );
+  }
+
+  return NextResponse.json({
+    success: true,
+    data: {
+      id: savedWorkspace.id,
+      name: savedWorkspace.name,
+      updatedAt: savedWorkspace.updatedAt?.toISOString() || null,
+      summary: createWorkspaceSummary(savedWorkspace),
+    },
+  });
+}
+
+export async function DELETE(_request: Request, context: RouteContext) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const { workspaceId } = await context.params;
+  const deletedWorkspace = await deleteAiCadWorkspaceById({
+    workspaceId,
+    userId: session.user.id,
+  });
+
+  if (!deletedWorkspace) {
+    return NextResponse.json(
+      { success: false, error: "AI-CAD 工作台不存在" },
+      { status: 404 }
+    );
+  }
+
+  return NextResponse.json({
+    success: true,
+    data: {
+      id: deletedWorkspace.id,
+    },
+  });
+}

app/api/ai-cad/workspaces/route.ts

@@ -0,0 +1,69 @@
+import { NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  buildDefaultWorkspaceName,
+  createWorkspaceSummary,
+  normalizeWorkspaceName,
+} from "@/app/api/ai-cad/workspace-utils";
+import {
+  createAiCadWorkspace,
+  listAiCadWorkspacesByUserId,
+} from "@/lib/db/queries";
+
+export const runtime = "nodejs";
+
+export async function GET() {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const workspaces = await listAiCadWorkspacesByUserId({
+    userId: session.user.id,
+  });
+
+  return NextResponse.json({
+    success: true,
+    data: workspaces.map(createWorkspaceSummary),
+  });
+}
+
+export async function POST(request: Request) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json(
+      { success: false, error: "未登录" },
+      { status: 401 }
+    );
+  }
+
+  const body = (await request.json().catch(() => ({}))) as { name?: unknown };
+  const existingWorkspaces = await listAiCadWorkspacesByUserId({
+    userId: session.user.id,
+  });
+  const workspace = await createAiCadWorkspace({
+    userId: session.user.id,
+    name: normalizeWorkspaceName(
+      body.name,
+      buildDefaultWorkspaceName(existingWorkspaces.length + 1)
+    ),
+  });
+
+  if (!workspace) {
+    return NextResponse.json(
+      { success: false, error: "创建 AI-CAD 工作台失败" },
+      { status: 500 }
+    );
+  }
+
+  return NextResponse.json(
+    {
+      success: true,
+      data: createWorkspaceSummary(workspace),
+    },
+    { status: 201 }
+  );
+}

app/api/angle-edit/route.ts

@@ -1,10 +1,385 @@
-import { NextResponse } from "next/server";
+import { NextRequest, NextResponse } from "next/server";
+import {
+  createMediaAssetRelation,
+  getMediaAssetsByUserAndUrls,
+  getPointsSystemConfig,
+  getSystemSetting,
+  upsertMediaAsset,
+} from "@/lib/db/queries";
 import { auth } from "@/app/(auth)/auth";
-import { executeAngleEditPOST } from "@/lib/canvas/operations/angle-edit";
+import { uploadFile } from "@/lib/storage/service";
-export const runtime = "nodejs";
+import { db } from "@/lib/db";
+import { generatedImage } from "@/lib/db/schema";
+import { createLogger } from "@/lib/observability/logger";
+import { getImageToolCreditCost } from "@/lib/points/config";
+import { prepareFeaturePointsCharge } from "@/lib/points/feature-charge";
+
+const logger = createLogger("angle-edit-api");
+
+// 角度编辑API配置类型
+type AngleEditConfig = {
+  enabled?: boolean;
+  falApiKey?: string;
+  loraScale?: number;
+  inferenceSteps?: number;
+  guidanceScale?: number;
+  maxImageSize?: number;
+  timeout?: number;
+};
+
+// 设置API路由最大执行时间为3分钟（180秒）
 export const maxDuration = 180;
-export async function POST(request: Request) {
+
-  const session = await auth();
+/**
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
+ * 压缩图片生成缩略图
-  return executeAngleEditPOST(request, session.user.id);
+ */
+async function createThumbnail(buffer: Buffer): Promise<Buffer> {
+  try {
+    const sharp = await import("sharp");
+
+    const thumbnailBuffer = await sharp.default(buffer)
+      .resize(500, null, {
+        fit: "inside",
+        withoutEnlargement: true,
+      })
+      .jpeg({ quality: 80 })
+      .toBuffer();
+
+    logger.debug("thumbnail_created", {
+      originalBytes: buffer.length,
+      thumbnailBytes: thumbnailBuffer.length,
+    });
+    return thumbnailBuffer;
+  } catch (error) {
+    logger.warn("thumbnail_creation_failed", error);
+    return buffer;
+  }
+}
+
+/**
+ * 将 base64 图片上传到 S3
+ */
+async function uploadBase64ToS3(base64Data: string, prefix: string = "angle-edit"): Promise<{ thumbnail: string; original: string }> {
+  try {
+    const buffer = Buffer.from(base64Data, "base64");
+    const timestamp = Date.now();
+    const randomStr = Math.random().toString(36).slice(2, 8);
+    const thumbnailFilename = `${prefix}-thumb-${timestamp}-${randomStr}.png`;
+    const originalFilename = `${prefix}-orig-${timestamp}-${randomStr}.png`;
+
+    logger.debug("source_image_prepared", { originalBytes: buffer.length });
+
+    const thumbnailBuffer = await createThumbnail(buffer);
+
+    const thumbnailArrayBuffer = thumbnailBuffer.buffer.slice(
+      thumbnailBuffer.byteOffset,
+      thumbnailBuffer.byteOffset + thumbnailBuffer.byteLength
+    ) as ArrayBuffer;
+    const originalArrayBuffer = buffer.buffer.slice(
+      buffer.byteOffset,
+      buffer.byteOffset + buffer.byteLength
+    ) as ArrayBuffer;
+
+    logger.debug("storage_upload_started", {
+      hasOriginal: originalArrayBuffer.byteLength > 0,
+      hasThumbnail: thumbnailArrayBuffer.byteLength > 0,
+      prefix,
+    });
+    const [thumbnailResult, originalResult] = await Promise.all([
+      uploadFile(thumbnailFilename, thumbnailArrayBuffer),
+      uploadFile(originalFilename, originalArrayBuffer),
+    ]);
+
+    logger.info("storage_upload_completed", {
+      originalUrl: originalResult.url,
+      thumbnailUrl: thumbnailResult.url,
+    });
+
+    return {
+      thumbnail: thumbnailResult.url,
+      original: originalResult.url,
+    };
+  } catch (error) {
+    logger.error("storage_upload_failed", error);
+    throw new Error(`图片上传失败: ${error instanceof Error ? error.message : "未知错误"}`);
+  }
+}
+
+export async function POST(request: NextRequest) {
+  const startTime = Date.now();
+
+  try {
+    // 1. 验证用户登录
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json({ error: "未登录" }, { status: 401 });
+    }
+
+    logger.info("request_received", { authenticated: true });
+
+    // 2. 从数据库获取配置
+    const angleEditConfig = await getSystemSetting({ key: "angle_edit_config" });
+    const config = (angleEditConfig?.value as AngleEditConfig) || {};
+
+    // 验证功能是否启用
+    if (!config.enabled) {
+      return NextResponse.json(
+        { error: "角度编辑功能未启用，请联系管理员在系统设置中开启" },
+        { status: 400 }
+      );
+    }
+
+    // 验证 API Key
+    if (!config.falApiKey) {
+      return NextResponse.json(
+        { error: "fal.ai API Key 未配置，请联系管理员配置" },
+        { status: 500 }
+      );
+    }
+
+    logger.debug("config_loaded", {
+      enabled: Boolean(config.enabled),
+      hasApiKey: Boolean(config.falApiKey),
+      loraScale: config.loraScale || 1,
+    });
+
+    // 3. 解析请求
+    const body = await request.json();
+    const {
+      image_url,
+      image_base64,
+      // 数值参数 (官方 API 格式)
+      horizontal_angle, // 0-360 度
+      vertical_angle, // -30 到 90 度
+      zoom, // 0-10
+      lora_scale,
+    } = body;
+
+    if (!image_url && !image_base64) {
+      return NextResponse.json({ error: "缺少图片数据" }, { status: 400 });
+    }
+
+    // 使用请求中的参数或配置中的默认值
+    const finalLoraScale = lora_scale ?? config.loraScale ?? 1;
+    const finalHorizontalAngle = horizontal_angle ?? 0;
+    const finalVerticalAngle = vertical_angle ?? 0;
+    const finalZoom = zoom ?? 5;
+
+    logger.info("request_parameters_normalized", {
+      hasBase64Input: Boolean(image_base64),
+      hasUrlInput: Boolean(image_url),
+      horizontalAngle: finalHorizontalAngle,
+      loraScale: finalLoraScale,
+      verticalAngle: finalVerticalAngle,
+      zoom: finalZoom,
+    });
+
+    const pointsConfig = await getPointsSystemConfig();
+    const pointsCharge = await prepareFeaturePointsCharge({
+      userId: session.user.id,
+      unitCost: getImageToolCreditCost(pointsConfig, "angle-edit"),
+      reason: "image_angle_edit",
+      modelId: "qwen-image-edit-2511-multiple-angles",
+      note: "多角度编辑消耗积分",
+      pointsConfig,
+    });
+    if (!pointsCharge.ok) {
+      return NextResponse.json(pointsCharge.payload, { status: pointsCharge.status });
+    }
+
+    // 4. 准备图片输入
+    let imageInput: string;
+    if (image_url) {
+      imageInput = image_url;
+    } else {
+      const mimeType = image_base64.startsWith("/9j/") ? "image/jpeg" : "image/png";
+      imageInput = `data:${mimeType};base64,${image_base64}`;
+    }
+
+    // 5. 动态导入 fal.ai SDK 并调用官方多角度 API
+    logger.info("provider_call_started", {
+      modelId: "fal-ai/qwen-image-edit-2511-multiple-angles",
+    });
+
+    const fal = await import("@fal-ai/serverless-client");
+
+    fal.config({
+      credentials: config.falApiKey,
+    });
+
+    // 使用官方多角度 API 端点
+    // 文档: https://fal.ai/models/fal-ai/qwen-image-edit-2511-multiple-angles
+    const result = await fal.subscribe("fal-ai/qwen-image-edit-2511-multiple-angles", {
+      input: {
+        image_urls: [imageInput], // 官方使用 image_urls (数组)
+        horizontal_angle: finalHorizontalAngle, // 水平旋转角度 0-360
+        vertical_angle: finalVerticalAngle, // 垂直角度 -30 到 90
+        zoom: finalZoom, // 缩放 0-10
+        lora_scale: finalLoraScale, // LoRA 强度
+        num_inference_steps: config.inferenceSteps || 28,
+        guidance_scale: config.guidanceScale || 4.5, // 官方默认 4.5
+        enable_safety_checker: true,
+        output_format: "png",
+      },
+      logs: true,
+      onQueueUpdate: (update) => {
+        if (update.status === "IN_PROGRESS") {
+          logger.debug("provider_progress", { status: update.status });
+        }
+      },
+    });
+
+    // 6. 处理结果
+    const apiResult = result as { images?: Array<{ url?: string }>; prompt?: string };
+    const outputImage = apiResult.images?.[0];
+    if (!outputImage?.url) {
+      throw new Error("API 未返回有效图片");
+    }
+
+    const outputImageUrl = outputImage.url;
+    logger.info("provider_call_completed", {
+      hasGeneratedPrompt: Boolean(apiResult.prompt),
+      imageCount: apiResult.images?.length ?? 0,
+      outputImageUrl,
+    });
+
+    // 7. 下载图片并上传到我们的 S3
+    const imageResponse = await fetch(outputImageUrl);
+    if (!imageResponse.ok) {
+      throw new Error(`下载输出图片失败: ${imageResponse.status}`);
+    }
+    const imageBuffer = Buffer.from(await imageResponse.arrayBuffer());
+    const imageBase64Result = imageBuffer.toString("base64");
+
+    const s3Result = await uploadBase64ToS3(imageBase64Result, "angle-edit");
+    logger.info("result_image_persisted", {
+      originalUrl: s3Result.original,
+      thumbnailUrl: s3Result.thumbnail,
+    });
+
+    // 8. 保存到数据库
+    const processingTime = (Date.now() - startTime) / 1000;
+
+    const [savedImage] = await db
+      .insert(generatedImage)
+      .values({
+        userId: session.user.id,
+        thumbnailUrl: s3Result.thumbnail,
+        originalUrl: s3Result.original,
+        prompt: `角度编辑: H${finalHorizontalAngle}° V${finalVerticalAngle}° Z${finalZoom}`,
+        modelId: "qwen-image-edit-2511-multiple-angles",
+        createdAt: new Date(),
+      })
+      .returning();
+
+    if (pointsCharge.chargeable) {
+      try {
+        await pointsCharge.consume({
+          note: `多角度编辑消耗积分（${savedImage.id}）`,
+        });
+      } catch (pointsError) {
+        logger.error("points_consume_failed", pointsError, {
+          imageId: savedImage.id,
+          userId: session.user.id,
+        });
+      }
+    }
+
+    try {
+      const sourceAssets =
+        typeof image_url === "string" && image_url.trim()
+          ? await getMediaAssetsByUserAndUrls({
+              userId: session.user.id,
+              urls: [image_url],
+            })
+          : [];
+      const media = await upsertMediaAsset({
+        userId: session.user.id,
+        mediaType: "image",
+        sourceType: "edited",
+        status: "ready",
+        originalUrl: s3Result.original,
+        previewUrl: s3Result.original,
+        thumbnailUrl: s3Result.thumbnail,
+        displayName: `角度编辑 ${finalHorizontalAngle}/${finalVerticalAngle}`.slice(0, 80),
+        prompt: `角度编辑: H${finalHorizontalAngle}° V${finalVerticalAngle}° Z${finalZoom}`,
+        modelId: "qwen-image-edit-2511-multiple-angles",
+        sourceTable: "GeneratedImage",
+        sourceRowId: savedImage.id,
+        primaryParentAssetId: sourceAssets[0]?.id ?? null,
+        metadata: {
+          horizontalAngle: finalHorizontalAngle,
+          verticalAngle: finalVerticalAngle,
+          zoom: finalZoom,
+        },
+      });
+      if (media) {
+        for (const sourceAsset of sourceAssets) {
+          await createMediaAssetRelation({
+            userId: session.user.id,
+            fromAssetId: sourceAsset.id,
+            toAssetId: media.id,
+            relationType: "edited_from",
+            metadata: {
+              horizontalAngle: finalHorizontalAngle,
+              verticalAngle: finalVerticalAngle,
+              zoom: finalZoom,
+            },
+          });
+        }
+      }
+    } catch (assetError) {
+      logger.warn("media_asset_registration_failed", assetError);
+    }
+
+    logger.info("request_completed", {
+      processingSeconds: Number(processingTime.toFixed(2)),
+    });
+
+    // 9. 返回结果
+    return NextResponse.json({
+      success: true,
+      image_url: s3Result.original,
+      thumbnail_url: s3Result.thumbnail,
+      image_base64: imageBase64Result,
+      processing_time: processingTime,
+      angles: {
+        horizontal_angle: finalHorizontalAngle,
+        vertical_angle: finalVerticalAngle,
+        zoom: finalZoom,
+      },
+      prompt: apiResult.prompt,
+    });
+
+  } catch (error) {
+    logger.error("request_failed", error);
+
+    // 输出详细的错误信息
+    if (error && typeof error === "object" && "status" in error) {
+      const apiError = error as { status?: number; body?: unknown; message?: string };
+      logger.warn("provider_error_summary", {
+        bodyType: typeof apiError.body,
+        hasBody: apiError.body != null,
+        message: apiError.message,
+        status: apiError.status,
+      });
+
+      if (apiError.status === 403) {
+        return NextResponse.json(
+          {
+            error: "API 访问被拒绝 (403 Forbidden)。请检查 API Key 是否正确，以及是否有权限访问该模型。",
+            details: apiError.body,
+          },
+          { status: 403 }
+        );
+      }
+    }
+
+    return NextResponse.json(
+      {
+        error: error instanceof Error ? error.message : "角度编辑处理失败",
+      },
+      { status: 500 }
+    );
+  }
 }

app/api/app-version/route.ts

@@ -1,8 +0,0 @@
-import { NextResponse } from "next/server";
-
-export const dynamic = "force-dynamic";
-export function GET() {
-  return NextResponse.json({ version: process.env.NEXT_PUBLIC_APP_RELEASE || "development" }, {
-    headers: { "Cache-Control": "no-store, max-age=0" },
-  });
-}

app/api/canvas/3d/model-proxy/route.ts

@@ -1,5 +1,4 @@
 import { NextResponse } from "next/server";
-import { isRetiredStorageUrl, normalizeLegacyAliyunStorageUrl, RETIRED_STORAGE_MESSAGE } from "@/lib/storage/retired-storage";
 import { auth } from "@/app/(auth)/auth";
 import { buildThreeAssetUrl } from "@/lib/canvas/three-asset-url";
 
@@ -13,8 +12,8 @@ const ALLOWED_MODEL_HOST_DOMAINS = [
   "tripo3d.ai",
   "tripo3d.com",
   "worldlabs.ai",
+  "s3.1080p.hk",
   "img.yydd.ai",
-  "scqny.jiansun.vip",
   "blob.vercel-storage.com",
   "aliyuncs.com",
   "amazonaws.com",
@@ -25,6 +24,7 @@ const ALLOWED_MODEL_HOST_DOMAINS = [
 
 const ALLOWED_HTTP_MODEL_HOST_DOMAINS = [
   "bbyy.ai",
+  "s3.1080p.hk",
   "img.yydd.ai",
 ];
 
@@ -164,9 +164,6 @@ async function handleRequest(request: Request, method: "GET" | "HEAD") {
 
     const { searchParams } = new URL(request.url);
     const rawUrl = String(searchParams.get("url") || "").trim();
-    if (isRetiredStorageUrl(rawUrl)) {
-      return NextResponse.json({ success: false, error: RETIRED_STORAGE_MESSAGE, code: "storage_retired" }, { status: 410 });
-    }
     if (!rawUrl) {
       return NextResponse.json({ success: false, error: "缺少 url 参数" }, { status: 400 });
     }
@@ -182,18 +179,6 @@ async function handleRequest(request: Request, method: "GET" | "HEAD") {
       return NextResponse.json({ success: false, error: "仅支持 http/https 模型地址" }, { status: 400 });
     }
 
-    if (normalizeLegacyAliyunStorageUrl(targetUrl.toString())) {
-      try {
-        const { resolveLegacyAliyunStorageUrl } = await import("@/lib/storage/image-archive-db");
-        targetUrl = new URL(await resolveLegacyAliyunStorageUrl(targetUrl.toString()));
-      } catch (error) {
-        if (error instanceof Error && error.message.includes("HTTP 410")) {
-          return NextResponse.json({ success: false, error: RETIRED_STORAGE_MESSAGE, code: "storage_retired" }, { status: 410 });
-        }
-        throw error;
-      }
-    }
-
     if (!isAllowedModelHost(targetUrl.hostname)) {
       return NextResponse.json({ success: false, error: "不允许的模型地址域名" }, { status: 403 });
     }

app/api/canvas/[id]/capabilities/route.ts

@@ -1,97 +0,0 @@
-import { NextResponse } from "next/server";
-import { ZodError } from "zod";
-
-import { auth } from "@/app/(auth)/auth";
-import { RmbgServiceError } from "@/lib/ai/rmbg/service";
-import { canvasCapabilityClientCommandSchema } from "@/lib/canvas/capabilities/client-command";
-import { CanvasCapabilityRuntimeError } from "@/lib/canvas/capabilities/context";
-import { getCanvasCapabilityManifest } from "@/lib/canvas/capabilities/registry";
-import { executeCanvasCapabilityRuntime } from "@/lib/canvas/capabilities/runtime";
-import { getCanvasCapabilityTask } from "@/lib/canvas/capabilities/task-store";
-import { CanvasAgentMutationError } from "@/lib/canvas/agent-mutations";
-import { formatRequestFailure, getRequestFailureDetails } from "@/lib/request-error";
-
-export const dynamic = "force-dynamic";
-export const maxDuration = 600;
-
-export async function GET(
-  request: Request,
-  { params }: { params: Promise<{ id: string }> }
-) {
-  const session = await auth();
-  if (!session?.user?.id) {
-    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-  }
-  const { id } = await params;
-  const requestId = new URL(request.url).searchParams.get("requestId");
-  if (!requestId) {
-    return NextResponse.json({
-      success: true,
-      capabilities: getCanvasCapabilityManifest(),
-    });
-  }
-  const task = await getCanvasCapabilityTask({
-    requestId,
-    userId: session.user.id,
-    projectId: id,
-  });
-  if (!task) {
-    return NextResponse.json(
-      { success: false, error: "能力任务不存在" },
-      { status: 404 }
-    );
-  }
-  const failure = task.status === "failed" ? getRequestFailureDetails(task.error) : undefined;
-  return NextResponse.json({ success: true, task: { ...task, failure, error: failure ? formatRequestFailure(failure, task.id) : task.error } });
-}
-
-export async function POST(
-  request: Request,
-  { params }: { params: Promise<{ id: string }> }
-) {
-  const session = await auth();
-  if (!session?.user?.id) {
-    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-  }
-
-  let requestId: string | undefined;
-  try {
-    const { id } = await params;
-    const command = canvasCapabilityClientCommandSchema.parse(await request.json());
-    requestId = command.requestId;
-    const result = await executeCanvasCapabilityRuntime({
-      command,
-      projectId: id,
-      requestHeaders: request.headers,
-      requestUrl: request.url,
-      userId: session.user.id,
-    });
-    return NextResponse.json({ success: true, ...result });
-  } catch (error) {
-    if (
-      error instanceof CanvasCapabilityRuntimeError ||
-      error instanceof CanvasAgentMutationError
-    ) {
-      const failure = getRequestFailureDetails(error);
-      return NextResponse.json(
-        { success: false, error: formatRequestFailure(failure, requestId), code: error.code, failure, requestId },
-        { status: error.status }
-      );
-    }
-    if (error instanceof ZodError) {
-      return NextResponse.json(
-        {
-          success: false,
-          error: "画布能力参数无效",
-          issues: error.issues,
-        },
-        { status: 400 }
-      );
-    }
-    const failure = getRequestFailureDetails(error, "执行画布能力失败");
-    return NextResponse.json(
-      { success: false, error: formatRequestFailure(failure, requestId), failure, requestId },
-      { status: error instanceof RmbgServiceError ? error.status : 500 }
-    );
-  }
-}

app/api/canvas/[id]/image-archives/route.ts

@@ -1,65 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-import { and, eq, inArray, sql } from "drizzle-orm";
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { canvasProject, imageArchiveTask, generatedImage, canvasImageTask } from "@/lib/db/schema";
-import { imageArchiveSourceKey } from "@/lib/storage/image-archive-db";
-import { isGeneratedImageSource } from "@/lib/storage/image-archive-urls";
-import { scheduleImageArchiveWorker } from "@/lib/storage/image-archive-worker";
-
-export async function POST(request: NextRequest, { params }: { params: Promise<{ id: string }> }) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  const { id } = await params;
-  const [project] = await db
-    .select({ id: canvasProject.id })
-    .from(canvasProject)
-    .where(and(eq(canvasProject.id, id), eq(canvasProject.userId, session.user.id)))
-    .limit(1);
-  if (!project) return NextResponse.json({ error: "画布不存在" }, { status: 404 });
-  const body = await request.json();
-  if (
-    !Array.isArray(body.urls) ||
-    body.urls.length > 100 ||
-    body.urls.some((url: unknown) => typeof url !== "string" || !isGeneratedImageSource(url))
-  ) {
-    return NextResponse.json({ error: "图片地址格式错误" }, { status: 400 });
-  }
-  const urls: string[] = [...new Set<string>(body.urls)];
-  if (!urls.length) return NextResponse.json({ replacements: {}, pending: [] });
-  const source = imageArchiveTask.sourceUrl;
-  const rows = await db
-    .select({
-      sourceUrl: imageArchiveTask.sourceUrl,
-      targetUrl: imageArchiveTask.targetUrl,
-      status: imageArchiveTask.status,
-    })
-    .from(imageArchiveTask)
-    .where(
-      and(
-        inArray(imageArchiveTask.sourceUrl, urls.map(imageArchiveSourceKey)),
-        sql`(
-        exists (select 1 from ${generatedImage} where ${generatedImage.userId} = ${session.user.id}
-          and (${generatedImage.originalUrl} = ${source} or ${generatedImage.thumbnailUrl} = ${source}
-            or ${generatedImage.originalUrl} = ${imageArchiveTask.targetUrl} or ${generatedImage.thumbnailUrl} = ${imageArchiveTask.targetUrl}))
-        or exists (select 1 from ${canvasImageTask} where ${canvasImageTask.userId} = ${session.user.id}
-          and (position(${source} in ${canvasImageTask.result}::text) > 0 or position(${imageArchiveTask.targetUrl} in ${canvasImageTask.result}::text) > 0))
-        or exists (select 1 from ${canvasProject} where ${canvasProject.id} = ${id} and ${canvasProject.userId} = ${session.user.id}
-          and (position(${source} in ${canvasProject.canvasData}::text) > 0 or position(${imageArchiveTask.targetUrl} in ${canvasProject.canvasData}::text) > 0))
-      )`,
-      ),
-    );
-  const byKey = new Map(rows.map((row) => [row.sourceUrl, row]));
-  const replacements: Record<string, string> = {};
-  const pending: string[] = [];
-  for (const url of urls) {
-    const row = byKey.get(imageArchiveSourceKey(url));
-    if (row?.targetUrl) replacements[url] = row.targetUrl;
-    else if (row && row.status !== "abandoned") pending.push(url);
-  }
-  if (rows.some((row) => row.status === "pending")) scheduleImageArchiveWorker(true);
-  return NextResponse.json(
-    { replacements, pending },
-    { headers: { "Cache-Control": "private, no-store" } },
-  );
-}

app/api/canvas/[id]/route.ts

@@ -3,12 +3,17 @@ import { auth } from '@/app/(auth)/auth';
 import { db } from '@/lib/db';
 import { canvasProject } from '@/lib/db/schema';
 import { syncCanvasNodesForProject } from '@/lib/db/queries';
-import { resolveArchivedImageUrls } from '@/lib/storage/image-archive-db';
+import { eq, and, inArray } from 'drizzle-orm';
-import { eq, and } from 'drizzle-orm';
 import {
   buildStaleCanvasSaveConflictPayload,
   isStaleCanvasSaveBaseRevision,
 } from '@/lib/canvas/canvas-save-conflict';
+import { normalizeCanvasProjectTitle } from '@/lib/canvas/project-title';
+import {
+  getExplicitVideoCanvasWorkspaceMeta,
+  getVideoCanvasWorkspaceProjects,
+  withVideoCanvasWorkspaceMeta,
+} from '@/lib/canvas/video-workspace';
 
 function resolveWorkspaceType(input: unknown) {
   return input === "agent" || input === "video" ? input : "canvas";
@@ -18,67 +23,19 @@ function getDefaultWorkspaceTitle(workspaceType: ReturnType<typeof resolveWorksp
   return workspaceType === "video" ? "未命名视频画布" : "未命名画布";
 }
 
-function shouldUseLocalCanvasE2E(request: NextRequest) {
-  const hostname = request.nextUrl.hostname;
-  return (
-    process.env.CANVAS_E2E_LOCAL === "true" &&
-    (hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1")
-  );
-}
-
-function createLocalCanvasProject(
-  id: string,
-  input: {
-    canvasData?: unknown;
-    description?: unknown;
-    thumbnail?: unknown;
-    title?: unknown;
-    workspaceType?: unknown;
-  } = {}
-) {
-  const now = new Date().toISOString();
-  const workspaceType = resolveWorkspaceType(input.workspaceType || "video");
-  return {
-    id,
-    userId: "local-video-canvas-e2e-user",
-    title: String(input.title || getDefaultWorkspaceTitle(workspaceType)),
-    description: typeof input.description === "string" ? input.description : null,
-    thumbnail: typeof input.thumbnail === "string" ? input.thumbnail : null,
-    workspaceType,
-    canvasData:
-      input.canvasData && typeof input.canvasData === "object"
-        ? input.canvasData
-        : {
-            nodes: [],
-            edges: [],
-            selectedNodeIds: [],
-            viewport: { x: 0, y: 0, zoom: 1 },
-            tool: "select",
-          },
-    createdAt: now,
-    updatedAt: now,
-  };
-}
-
 // 获取单个画布
 export async function GET(
   request: NextRequest,
   { params }: { params: Promise<{ id: string }> }
 ) {
   try {
-    const { id } = await params;
-    if (shouldUseLocalCanvasE2E(request)) {
-      return NextResponse.json({
-        success: true,
-        data: createLocalCanvasProject(id),
-      });
-    }
-
     const session = await auth();
     if (!session?.user?.id) {
       return NextResponse.json({ success: false, error: '未登录' }, { status: 401 });
     }
 
+    const { id } = await params;
+
     const [project] = await db
       .select()
       .from(canvasProject)
@@ -103,48 +60,36 @@ export async function GET(
 // 更新画布（支持 upsert：如果不存在则创建）
 export async function PUT(
   request: NextRequest,
-  { params }: { params: Promise<{ id: string }> },
+  { params }: { params: Promise<{ id: string }> }
 ) {
   try {
-    const { id } = await params;
-    const body = await request.json();
-    if (shouldUseLocalCanvasE2E(request)) {
-      return NextResponse.json({
-        success: true,
-        data: createLocalCanvasProject(id, body),
-      });
-    }
-
     const session = await auth();
     if (!session?.user?.id) {
-      return NextResponse.json(
+      return NextResponse.json({ success: false, error: '未登录' }, { status: 401 });
-        { success: false, error: "未登录" },
-        { status: 401 },
-      );
     }
 
-    const { title, description, canvasData } = body;
+    const { id } = await params;
-    const thumbnail = await resolveArchivedImageUrls(body.thumbnail);
+    const body = await request.json();
-    const baseCanvasRevision =
+    const { title, description, thumbnail, canvasData } = body;
-      body?.baseCanvasUpdatedAt || body?.baseCanvasRevision;
+    const baseCanvasRevision = body?.baseCanvasUpdatedAt || body?.baseCanvasRevision;
     const workspaceType =
       body && Object.prototype.hasOwnProperty.call(body, "workspaceType")
         ? resolveWorkspaceType(body.workspaceType)
         : undefined;
 
-    return await db.transaction(async (tx) => {
+    // 先检查画布是否存在
-      const [existingProject] = await tx
+    const [existingProject] = await db
-        .select()
+      .select()
-        .from(canvasProject)
+      .from(canvasProject)
-        .where(
+      .where(
-          and(
+        and(
-            eq(canvasProject.id, id),
+          eq(canvasProject.id, id),
-            eq(canvasProject.userId, session.user.id),
+          eq(canvasProject.userId, session.user.id)
-          ),
         )
-        .for("update");
+      );
+
+    if (existingProject) {
       if (
-        existingProject &&
         canvasData !== undefined &&
         baseCanvasRevision &&
         isStaleCanvasSaveBaseRevision({
@@ -155,70 +100,142 @@ export async function PUT(
       ) {
         return NextResponse.json(
           buildStaleCanvasSaveConflictPayload(existingProject.updatedAt),
-          { status: 409 },
+          { status: 409 }
         );
       }
-      if (!existingProject) {
+
-        // The parent must exist before node/asset foreign keys are synchronized.
+      const explicitWorkspaceMeta = getExplicitVideoCanvasWorkspaceMeta(
-        const [created] = await tx
+        existingProject.canvasData
-          .insert(canvasProject)
+      );
-          .values({
+      const canvasDataWithWorkspace =
-            id,
+        canvasData !== undefined && explicitWorkspaceMeta
-            userId: session.user.id,
+          ? withVideoCanvasWorkspaceMeta(canvasData, explicitWorkspaceMeta)
-            createdAt: new Date(),
+          : canvasData;
-            updatedAt: new Date(),
-            title: title || getDefaultWorkspaceTitle(workspaceType || "canvas"),
-            workspaceType: workspaceType || "canvas",
-            canvasData: {
-              nodes: [],
-              edges: [],
-              viewport: { x: 0, y: 0, zoom: 1 },
-            },
-          })
-          .onConflictDoNothing({ target: canvasProject.id })
-          .returning();
-        if (!created)
-          return NextResponse.json(
-            { success: false, error: "画布已被创建，请重新加载后保存" },
-            { status: 409 },
-          );
-      }
       const syncedCanvasData =
-        canvasData !== undefined
+        canvasDataWithWorkspace !== undefined
-          ? await syncCanvasNodesForProject(
+          ? await syncCanvasNodesForProject({
-              { projectId: id, userId: session.user.id, canvasData },
+              projectId: id,
-              tx,
+              userId: session.user.id,
-            )
+              canvasData: canvasDataWithWorkspace,
+            })
           : undefined;
-      const updateData: any = { updatedAt: new Date(Math.max(Date.now(), (existingProject?.updatedAt.getTime() || 0) + 1)) };
+
-      if (title !== undefined) updateData.title = title;
+      // 更新现有画布
+      const updateData: any = { updatedAt: new Date() };
+      if (title !== undefined) {
+        updateData.title = normalizeCanvasProjectTitle(
+          title,
+          existingProject.title
+        );
+        if (existingProject.workspaceType === "video") {
+          const videoProjects = await db
+            .select({
+              canvasData: canvasProject.canvasData,
+              id: canvasProject.id,
+            })
+            .from(canvasProject)
+            .where(
+              and(
+                eq(canvasProject.userId, session.user.id),
+                eq(canvasProject.workspaceType, "video")
+              )
+            );
+          const workspaceProjectIds = getVideoCanvasWorkspaceProjects(
+            videoProjects,
+            existingProject
+          )
+            .map((project) => project.id)
+            .filter((projectId) => projectId !== id);
+          if (workspaceProjectIds.length > 0) {
+            await db
+              .update(canvasProject)
+              .set({ title: updateData.title, updatedAt: new Date() })
+              .where(inArray(canvasProject.id, workspaceProjectIds));
+          }
+        }
+      }
       if (description !== undefined) updateData.description = description;
       if (thumbnail !== undefined) updateData.thumbnail = thumbnail;
       if (workspaceType !== undefined) updateData.workspaceType = workspaceType;
-      if (syncedCanvasData !== undefined)
+      if (syncedCanvasData !== undefined) updateData.canvasData = syncedCanvasData;
-        updateData.canvasData = syncedCanvasData;
+
-      const [saved] = await tx
+      const [updatedProject] = await db
         .update(canvasProject)
         .set(updateData)
         .where(
           and(
             eq(canvasProject.id, id),
-            eq(canvasProject.userId, session.user.id),
+            eq(canvasProject.userId, session.user.id)
-          ),
+          )
         )
         .returning();
-      return NextResponse.json({
+
-        success: true,
+      return NextResponse.json({ success: true, data: updatedProject });
-        data: saved,
+    } else {
-        previousCanvasRevision: existingProject?.updatedAt.toISOString() ?? null,
+      const syncedCanvasData =
-      });
+        canvasData !== undefined
-    });
+          ? await syncCanvasNodesForProject({
+              projectId: id,
+              userId: session.user.id,
+              canvasData,
+            })
+          : undefined;
+
+      const nextWorkspaceType = workspaceType || "canvas";
+      const nextCanvasData = syncedCanvasData || {
+        nodes: [],
+        edges: [],
+        viewport: { x: 0, y: 0, zoom: 1 },
+      };
+      const nextTitle = normalizeCanvasProjectTitle(
+        title,
+        getDefaultWorkspaceTitle(nextWorkspaceType)
+      );
+      const insertData: any = {
+        id, // 使用指定的 ID
+        userId: session.user.id,
+        title: nextTitle,
+        workspaceType: nextWorkspaceType,
+        canvasData: nextCanvasData,
+      };
+      const conflictUpdateData: any = {
+        title: nextTitle,
+        workspaceType: nextWorkspaceType,
+        canvasData: nextCanvasData,
+        updatedAt: new Date(),
+      };
+      if (description !== undefined) {
+        insertData.description = description;
+        conflictUpdateData.description = description;
+      }
+      if (thumbnail !== undefined) {
+        insertData.thumbnail = thumbnail;
+        conflictUpdateData.thumbnail = thumbnail;
+      }
+
+      // 创建新画布（使用指定 ID），并兼容同一用户并发创建同一画布的场景。
+      const [newProject] = await db
+        .insert(canvasProject)
+        .values(insertData)
+        .onConflictDoUpdate({
+          target: canvasProject.id,
+          set: conflictUpdateData,
+          where: eq(canvasProject.userId, session.user.id),
+        })
+        .returning();
+
+      if (!newProject) {
+        return NextResponse.json(
+          { success: false, error: '画布ID已被占用' },
+          { status: 409 }
+        );
+      }
+
+      return NextResponse.json({ success: true, data: newProject });
+    }
   } catch (error) {
-    console.error("更新/创建画布失败:", error);
+    console.error('更新/创建画布失败:', error);
-    return NextResponse.json(
+    return NextResponse.json({ success: false, error: '更新画布失败' }, { status: 500 });
-      { success: false, error: "更新画布失败" },
-      { status: 500 },
-    );
   }
 }
 

app/api/canvas/[id]/tvstar-sessions/route.ts

@@ -1,57 +0,0 @@
-import { and, desc, eq, lte } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { tvstarSession } from "@/lib/db/schema";
-import { ownsTaskProject } from "@/lib/video-canvas/task-store";
-import { tvstarSessionSchema } from "@/lib/video-canvas/tvstar-session";
-
-export const dynamic = "force-dynamic";
-
-async function authorize(projectId: string) {
-  const session = await auth();
-  if (!session?.user?.id) return { error: NextResponse.json({ error: "未登录" }, { status: 401 }) };
-  if (!z.string().uuid().safeParse(projectId).success || !await ownsTaskProject(session.user.id, projectId)) {
-    return { error: NextResponse.json({ error: "画布不存在" }, { status: 404 }) };
-  }
-  return { userId: session.user.id };
-}
-
-export async function GET(_request: Request, { params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-  const access = await authorize(id);
-  if (access.error) return access.error;
-  const rows = await db.select({ snapshot: tvstarSession.snapshot, shareToken: tvstarSession.shareToken })
-    .from(tvstarSession)
-    .where(and(eq(tvstarSession.userId, access.userId!), eq(tvstarSession.projectId, id)))
-    .orderBy(desc(tvstarSession.clientUpdatedAt)).limit(20);
-  return NextResponse.json({ sessions: rows.map(({ snapshot, shareToken }) => ({
-    ...(snapshot as Record<string, unknown>), shareToken: shareToken || undefined,
-  })) }, { headers: { "Cache-Control": "no-store" } });
-}
-
-export async function PUT(request: Request, { params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-  const access = await authorize(id);
-  if (access.error) return access.error;
-  const raw = await request.text();
-  if (raw.length > 900_000) return NextResponse.json({ error: "对话记录过大" }, { status: 413 });
-  let body: unknown;
-  try { body = JSON.parse(raw); } catch { return NextResponse.json({ error: "请求格式无效" }, { status: 400 }); }
-  const parsed = z.object({ sessions: z.array(tvstarSessionSchema).max(20) }).safeParse(body);
-  if (!parsed.success) return NextResponse.json({ error: "对话记录格式无效" }, { status: 400 });
-  for (const session of parsed.data.sessions) {
-    const clientUpdatedAt = new Date(Math.min(session.updatedAt, Date.now() + 60_000));
-    await db.insert(tvstarSession).values({
-      id: session.id, projectId: id, userId: access.userId!, title: session.title,
-      snapshot: session, clientUpdatedAt,
-    }).onConflictDoNothing({ target: tvstarSession.id });
-    await db.update(tvstarSession).set({ title: session.title, snapshot: session, clientUpdatedAt, updatedAt: new Date() })
-      .where(and(
-        eq(tvstarSession.id, session.id), eq(tvstarSession.projectId, id), eq(tvstarSession.userId, access.userId!),
-        lte(tvstarSession.clientUpdatedAt, clientUpdatedAt),
-      ));
-  }
-  return NextResponse.json({ ok: true });
-}

app/api/canvas/[id]/tvstar-sessions/share/route.ts

@@ -1,58 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { and, eq } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { tvstarSession } from "@/lib/db/schema";
-import { ownsTaskProject } from "@/lib/video-canvas/task-store";
-import { publicTVstarSnapshot, tvstarSessionSchema } from "@/lib/video-canvas/tvstar-session";
-
-export const dynamic = "force-dynamic";
-
-async function owner(projectId: string) {
-  const session = await auth();
-  if (!session?.user?.id) return { error: NextResponse.json({ error: "未登录" }, { status: 401 }) };
-  if (!z.string().uuid().safeParse(projectId).success || !await ownsTaskProject(session.user.id, projectId)) {
-    return { error: NextResponse.json({ error: "画布不存在" }, { status: 404 }) };
-  }
-  return { userId: session.user.id };
-}
-
-export async function POST(request: Request, { params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-  const access = await owner(id);
-  if (access.error) return access.error;
-  const raw = await request.text();
-  if (raw.length > 300_000) return NextResponse.json({ error: "对话记录过大" }, { status: 413 });
-  let body: unknown;
-  try { body = JSON.parse(raw); } catch { return NextResponse.json({ error: "请求格式无效" }, { status: 400 }); }
-  const parsed = z.object({ session: tvstarSessionSchema }).safeParse(body);
-  if (!parsed.success) return NextResponse.json({ error: "对话记录格式无效" }, { status: 400 });
-  const current = parsed.data.session;
-  const condition = and(eq(tvstarSession.id, current.id), eq(tvstarSession.projectId, id), eq(tvstarSession.userId, access.userId!));
-  await db.insert(tvstarSession).values({
-    id: current.id, projectId: id, userId: access.userId!, title: current.title,
-    snapshot: current, clientUpdatedAt: new Date(Math.min(current.updatedAt, Date.now() + 60_000)),
-  }).onConflictDoNothing({ target: tvstarSession.id });
-  const existing = (await db.select({ shareToken: tvstarSession.shareToken }).from(tvstarSession).where(condition).limit(1))[0];
-  if (!existing) return NextResponse.json({ error: "对话不存在" }, { status: 404 });
-  const token = existing.shareToken || randomBytes(24).toString("base64url");
-  if (!existing.shareToken) {
-    await db.update(tvstarSession).set({
-      shareToken: token, sharedSnapshot: publicTVstarSnapshot(current), sharedAt: new Date(), updatedAt: new Date(),
-    }).where(condition);
-  }
-  return NextResponse.json({ url: `/tvstar/share/${token}`, token });
-}
-
-export async function DELETE(request: Request, { params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-  const access = await owner(id);
-  if (access.error) return access.error;
-  const sessionId = new URL(request.url).searchParams.get("sessionId") || "";
-  if (!z.string().uuid().safeParse(sessionId).success) return NextResponse.json({ error: "对话 ID 无效" }, { status: 400 });
-  await db.update(tvstarSession).set({ shareToken: null, sharedSnapshot: null, sharedAt: null, updatedAt: new Date() })
-    .where(and(eq(tvstarSession.id, sessionId), eq(tvstarSession.projectId, id), eq(tvstarSession.userId, access.userId!)));
-  return NextResponse.json({ ok: true });
-}

app/api/canvas/[id]/video-workspace/route.ts

@@ -0,0 +1,266 @@
+import { and, desc, eq } from "drizzle-orm";
+import { NextRequest, NextResponse } from "next/server";
+import { auth } from "@/app/(auth)/auth";
+import {
+  duplicateVideoCanvasData,
+  getExplicitVideoCanvasWorkspaceMeta,
+  getNextVideoCanvasName,
+  getVideoCanvasCopyName,
+  getVideoCanvasWorkspaceProjects,
+  normalizeVideoCanvasName,
+  resolveVideoCanvasWorkspaceMeta,
+  withVideoCanvasWorkspaceMeta,
+} from "@/lib/canvas/video-workspace";
+import { db } from "@/lib/db";
+import { syncCanvasNodesForProject } from "@/lib/db/queries";
+import { canvasProject } from "@/lib/db/schema";
+
+type CanvasProjectRow = typeof canvasProject.$inferSelect;
+
+function toCanvasItem(project: CanvasProjectRow, currentId: string) {
+  const meta = resolveVideoCanvasWorkspaceMeta(project);
+  return {
+    createdAt: project.createdAt.toISOString(),
+    id: project.id,
+    isCurrent: project.id === currentId,
+    name: meta.canvasName,
+  };
+}
+
+async function getWorkspaceContext(userId: string, currentId: string) {
+  const projects = await db
+    .select()
+    .from(canvasProject)
+    .where(
+      and(
+        eq(canvasProject.userId, userId),
+        eq(canvasProject.workspaceType, "video"),
+      ),
+    )
+    .orderBy(desc(canvasProject.createdAt));
+  const currentProject = projects.find((project) => project.id === currentId);
+  if (!currentProject) return null;
+  return {
+    currentProject,
+    projects: getVideoCanvasWorkspaceProjects(projects, currentProject),
+  };
+}
+
+async function ensureExplicitWorkspaceMetadata(projects: CanvasProjectRow[]) {
+  for (const project of projects) {
+    if (getExplicitVideoCanvasWorkspaceMeta(project.canvasData)) continue;
+    const canvasData = withVideoCanvasWorkspaceMeta(
+      project.canvasData,
+      resolveVideoCanvasWorkspaceMeta(project),
+    );
+    await db
+      .update(canvasProject)
+      .set({ canvasData })
+      .where(eq(canvasProject.id, project.id));
+    project.canvasData = canvasData;
+  }
+}
+
+export async function GET(
+  _request: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+  }
+  const { id } = await params;
+  const context = await getWorkspaceContext(session.user.id, id);
+  if (!context) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  return NextResponse.json({
+    success: true,
+    data: {
+      canvases: context.projects.map((project) => toCanvasItem(project, id)),
+      currentCanvasId: id,
+      workspaceTitle: context.currentProject.title,
+    },
+  });
+}
+
+export async function POST(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+  }
+  const { id } = await params;
+  const body = await request.json();
+  if (body?.action !== "create" && body?.action !== "copy") {
+    return NextResponse.json(
+      { success: false, error: "不支持的画布操作" },
+      { status: 400 },
+    );
+  }
+  const action = body.action;
+  const context = await getWorkspaceContext(session.user.id, id);
+  if (!context) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  await ensureExplicitWorkspaceMetadata(context.projects);
+  const currentMeta = resolveVideoCanvasWorkspaceMeta(context.currentProject);
+  const existingNames = context.projects.map(
+    (project) => resolveVideoCanvasWorkspaceMeta(project).canvasName,
+  );
+  const source =
+    action === "copy"
+      ? context.projects.find((project) => project.id === body?.targetId)
+      : context.currentProject;
+  if (!source) {
+    return NextResponse.json(
+      { success: false, error: "要复制的画布不存在" },
+      { status: 404 },
+    );
+  }
+  const canvasName =
+    action === "copy"
+      ? getVideoCanvasCopyName(
+          resolveVideoCanvasWorkspaceMeta(source).canvasName,
+          existingNames,
+        )
+      : getNextVideoCanvasName(existingNames);
+  const meta = {
+    canvasName,
+    workspaceId: currentMeta.workspaceId,
+  };
+  const canvasData =
+    action === "copy"
+      ? duplicateVideoCanvasData(source.canvasData, meta)
+      : withVideoCanvasWorkspaceMeta(null, meta);
+  const [insertedProject] = await db
+    .insert(canvasProject)
+    .values({
+      canvasData,
+      description: context.currentProject.description,
+      title: context.currentProject.title,
+      userId: session.user.id,
+      workspaceType: "video",
+    })
+    .returning();
+  const syncedCanvasData = await syncCanvasNodesForProject({
+    canvasData,
+    projectId: insertedProject.id,
+    userId: session.user.id,
+  });
+  const [createdProject] = await db
+    .update(canvasProject)
+    .set({ canvasData: syncedCanvasData })
+    .where(eq(canvasProject.id, insertedProject.id))
+    .returning();
+
+  return NextResponse.json({
+    success: true,
+    data: toCanvasItem(createdProject || insertedProject, id),
+  });
+}
+
+export async function PATCH(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+  }
+  const { id } = await params;
+  const body = await request.json();
+  const context = await getWorkspaceContext(session.user.id, id);
+  if (!context) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  const target = context.projects.find((project) => project.id === body?.targetId);
+  if (!target) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  const currentMeta = resolveVideoCanvasWorkspaceMeta(context.currentProject);
+  const targetMeta = resolveVideoCanvasWorkspaceMeta(target);
+  const canvasName = normalizeVideoCanvasName(body?.name, targetMeta.canvasName);
+  const [updatedProject] = await db
+    .update(canvasProject)
+    .set({
+      canvasData: withVideoCanvasWorkspaceMeta(target.canvasData, {
+        canvasName,
+        workspaceId: currentMeta.workspaceId,
+      }),
+      updatedAt: new Date(),
+    })
+    .where(
+      and(
+        eq(canvasProject.id, target.id),
+        eq(canvasProject.userId, session.user.id),
+      ),
+    )
+    .returning();
+
+  return NextResponse.json({
+    success: true,
+    data: toCanvasItem(updatedProject, id),
+  });
+}
+
+export async function DELETE(
+  request: NextRequest,
+  { params }: { params: Promise<{ id: string }> },
+) {
+  const session = await auth();
+  if (!session?.user?.id) {
+    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+  }
+  const { id } = await params;
+  const body = await request.json();
+  const context = await getWorkspaceContext(session.user.id, id);
+  if (!context) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  const target = context.projects.find((project) => project.id === body?.targetId);
+  if (!target) {
+    return NextResponse.json(
+      { success: false, error: "画布不存在" },
+      { status: 404 },
+    );
+  }
+  if (context.projects.length <= 1) {
+    return NextResponse.json(
+      { success: false, error: "至少保留一个画布" },
+      { status: 409 },
+    );
+  }
+  await db
+    .delete(canvasProject)
+    .where(
+      and(
+        eq(canvasProject.id, target.id),
+        eq(canvasProject.userId, session.user.id),
+      ),
+    );
+  const remaining = context.projects.filter((project) => project.id !== target.id);
+  return NextResponse.json({
+    success: true,
+    data: {
+      nextCanvasId: target.id === id ? remaining[0]?.id || null : id,
+    },
+  });
+}

app/api/canvas/agent-capabilities/route.ts

@@ -1,40 +0,0 @@
-import { PROJECT_AGENT_OPERATIONS, projectOperationAuthorized } from "@/lib/ai/canvas-agent-runtime/project-operation-catalog";
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { and, eq } from "drizzle-orm";
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { canvasProject } from "@/lib/db/schema";
-import { getSystemSetting } from "@/lib/db/queries";
-import {
-  normalizeVideoCanvasFunctionConfig,
-  VIDEO_CANVAS_FUNCTION_CONFIG_KEY,
-} from "@/lib/video-canvas/config";
-import { getCanvasAgentAccessManifest } from "@/lib/ai/canvas-agent-runtime/capability-access";
-export const dynamic = "force-dynamic";
-export async function GET(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  const parsed = z.string().uuid().safeParse(new URL(request.url).searchParams.get("projectId"));
-  if (!parsed.success) return NextResponse.json({ error: "画布编号无效" }, { status: 400 });
-  const [project] = await db
-    .select({ id: canvasProject.id, workspace: canvasProject.workspaceType })
-    .from(canvasProject)
-    .where(and(eq(canvasProject.id, parsed.data), eq(canvasProject.userId, session.user.id)))
-    .limit(1);
-  if (!project) return NextResponse.json({ error: "画布不存在" }, { status: 404 });
-  const config = normalizeVideoCanvasFunctionConfig(
-    (await getSystemSetting({ key: VIDEO_CANVAS_FUNCTION_CONFIG_KEY }))?.value,
-  );
-  return NextResponse.json(
-    {
-      workspace: project.workspace,
-      projectServices: PROJECT_AGENT_OPERATIONS.map(item => ({ ...item, authorized: projectOperationAuthorized(item) })),
-      utilityTools: ["getWeather", "createDocument", "updateDocument", "requestSuggestions", "loadProjectSkill"],
-      capabilities: getCanvasAgentAccessManifest(config).filter(
-        (item) => item.workspace === (project.workspace === "video" ? "video" : "canvas"),
-      ),
-    },
-    { headers: { "Cache-Control": "private, no-store" } },
-  );
-}

app/api/canvas/agent-chat/route.ts

@@ -1,492 +0,0 @@
-import { agentModelCandidates } from "@/lib/ai/runtime/agent-model-failover";
-import { agentModelCircuitStore } from "@/lib/ai/runtime/agent-model-circuit-store";
-import { createAgentVisionExecutor } from "@/lib/ai/runtime/agent-vision-failover";
-import { canvasAgentProgress } from "@/lib/ai/canvas-agent-runtime/progress";
-import { getStyleProImageModelEntries } from "@/lib/style-pro/model-options";
-import { registerProjectAgentTools } from "@/lib/ai/canvas-agent-runtime/project-tools";
-import { isZcodeWorkspaceAuthorized } from "@/lib/ai/canvas-agent-runtime/authorization";
-import {
-  createUIMessageStream,
-  createUIMessageStreamResponse,
-  generateText,
-} from "ai";
-import { after, NextResponse } from "next/server";
-import { z } from "zod";
-import { db } from "@/lib/db";
-import { siteSettings, canvasProject } from "@/lib/db/schema";
-import { eq } from "drizzle-orm";
-import { auth } from "@/app/(auth)/auth";
-import { postRequestBodySchema } from "@/app/(chat)/api/chat/schema";
-import { entitlementsByUserType } from "@/lib/ai/entitlements";
-import { getLanguageModelById } from "@/lib/ai/dynamic-provider";
-import {
-  getAgentAiModelWithProvider,
-  getAccessibleAgentPresetById,
-  getEnabledAiModelsWithProvider,
-  getChatById,
-  getMessagesByChatId,
-  getMessageCountByUserId,
-  getSiteSettings,
-  saveChat,
-  saveMessages,
-} from "@/lib/db/queries";
-import { runZcodeCanvasTask } from "@/lib/ai/zcode-agent/task";
-import { canvasAgentReplyText } from "@/lib/ai/zcode-agent/assistant-output";
-import { createZcodeModelGateway } from "@/lib/ai/zcode-agent/model-gateway";
-import { newAgentRunSnapshot, publicAgentError } from "@/lib/ai/canvas-agent-runtime/protocol";
-import { shouldUseCanvasAgentRuntime } from "@/lib/ai/canvas-agent-runtime/routing";
-import {
-  acquireAgentRun,
-  agentRunView,
-  AgentRunError,
-  checkpointAgentRun,
-  consumeAgentRunInputs,
-  heartbeatAgentRun,
-} from "@/lib/ai/canvas-agent-runtime/store";
-import { readOwnedCanvas } from "@/lib/ai/canvas-agent-runtime/canvas";
-import { buildCanvasRuntimeTools } from "@/lib/ai/canvas-agent-runtime/tools";
-import { canvasRuntimeSystemPrompt } from "@/lib/ai/canvas-agent-runtime/prompt";
-import { verifyCanvasAgentResults } from "@/lib/ai/canvas-agent-runtime/review";
-import { inferCanvasTaskRequirements } from "@/lib/ai/canvas-agent-runtime/requirements";
-import {
-  resolveRuntimeConversationSources,
-  persistRuntimeConversationResults,
-} from "@/lib/ai/canvas-agent-runtime/conversation";
-import { getCanvasAgentFeatureFlagsFromSystemSettings } from "@/lib/canvas/agent-feature-settings";
-import { canApplyCanvasAgentMutations } from "@/lib/canvas/agent-feature-flags";
-
-import {
-  videoAgentSettingsSchema,
-  inferVideoTaskRequirements,
-  videoNodeUrl,
-  videoRuntimeSystemPrompt,
-} from "@/lib/ai/canvas-agent-runtime/video-protocol";
-import { readOwnedVideoCanvas } from "@/lib/ai/canvas-agent-runtime/video-store";
-import {
-  buildVideoRuntimeTools,
-  createVideoRuntimePorts,
-} from "@/lib/ai/canvas-agent-runtime/video-tools";
-import { probeVideoMetadata } from "@/lib/ai/canvas-agent-runtime/video-probe";
-import { verifyVideoAgentResults } from "@/lib/ai/canvas-agent-runtime/video-review";
-
-export const runtime = "nodejs";
-export const maxDuration = 1200;
-const requestSchema = postRequestBodySchema.extend({
-  resumeRunId: z.string().uuid().optional(),
-  selectedImageModel: z.string().min(1).max(180).optional(),
-  workspaceVariant: z.enum(["canvas", "video"]).default("canvas"),
-  videoAgentSettings: videoAgentSettingsSchema.optional(),
-});
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const body = requestSchema.parse(await request.json());
-    if (!shouldUseCanvasAgentRuntime(body))
-      throw new AgentRunError("此请求不属于画布 Agent 任务", 400);
-    const projectId = body.contextPayload!.projectId!;
-    const [ownedProject] = await db.select({ userId: canvasProject.userId, workspaceType: canvasProject.workspaceType })
-      .from(canvasProject).where(eq(canvasProject.id, projectId)).limit(1);
-    if (!ownedProject || ownedProject.userId !== session.user.id) throw new AgentRunError("画布不存在", 404);
-    if (!isZcodeWorkspaceAuthorized(ownedProject.workspaceType)) throw new AgentRunError("视频画布暂未授权给 ZCode Agent，请使用手工功能。", 403);
-    const isVideo = ownedProject.workspaceType === "video";
-    const preset = body.agentPresetId ? await getAccessibleAgentPresetById({ id: body.agentPresetId, userId: session.user.id }) : null;
-    if (preset && String(preset.type) === "video") throw new AgentRunError("视频技能暂未授权给 ZCode Agent", 403);
-    if (body.agentPresetId && (!preset || preset.status !== "active")) throw new AgentRunError("此 Agent 预设不可用", 403);
-    const objective = body.message.parts
-      .filter((part) => part.type === "text")
-      .map((part) => part.text)
-      .join("\n")
-      .trim();
-    if (!objective) throw new AgentRunError("请描述需要完成的创作任务", 400);
-    const settings = await getSiteSettings();
-    if (
-      !settings.agentEnabled ||
-      !canApplyCanvasAgentMutations(await getCanvasAgentFeatureFlagsFromSystemSettings())
-    ) {
-      throw new AgentRunError("管理员尚未开启画布 Agent 操作", 403);
-    }
-    const [usageSettings] = await db.select().from(siteSettings).limit(1);
-    if (usageSettings?.usageTimeEnabled) {
-      const time = new Intl.DateTimeFormat("en-GB", {
-        timeZone: "Asia/Shanghai",
-        hour: "2-digit",
-        minute: "2-digit",
-        hourCycle: "h23",
-      }).format(new Date());
-      if (
-        time < (usageSettings.usageTimeStart || "08:00") ||
-        time > (usageSettings.usageTimeEnd || "20:00")
-      )
-        throw new AgentRunError(usageSettings.usageTimeMessage || "当前不在系统使用时间段内", 403);
-    }
-    const count = await getMessageCountByUserId({ id: session.user.id, differenceInHours: 24 });
-    if (count > entitlementsByUserType[session.user.type].maxMessagesPerDay)
-      throw new AgentRunError("今日对话次数已达到限额", 429);
-    const imageCanvas = isVideo ? null : await readOwnedCanvas(session.user.id, projectId);
-    if (imageCanvas?.project.workspaceType === "video")
-      throw new AgentRunError("请使用视频画布 Agent 入口", 400);
-    const videoCanvas = isVideo ? await readOwnedVideoCanvas(session.user.id, projectId) : null;
-    const nodes = imageCanvas?.nodes || [];
-    const availableIds = isVideo
-      ? videoCanvas!.nodes.map((node) => node.id)
-      : nodes.map((node) => node.id);
-    const selectedNodeIds = body.contextPayload?.selectedNodeIds || [];
-    if (selectedNodeIds.some((id) => !availableIds.includes(id))) {
-      throw new AgentRunError("选中图片尚未保存到画布，请等待保存完成后重试。");
-    }
-    const existingChat = await getChatById({ id: body.id });
-    if (existingChat && existingChat.userId !== session.user.id)
-      throw new AgentRunError("对话不存在", 404);
-    if (!existingChat)
-      await saveChat({
-        id: body.id,
-        userId: session.user.id,
-        title: objective.slice(0, 80),
-        visibility: "private",
-      });
-    const conversation = isVideo
-      ? {
-          sourceNodeIds: selectedNodeIds,
-          targetReason: "video-selected-nodes",
-          previousContext: null,
-        }
-      : await resolveRuntimeConversationSources({
-          userId: session.user.id,
-          chatId: body.id,
-          projectId,
-          text: objective,
-          parts: body.message.parts,
-          nodes,
-          selectedNodeIds,
-        });
-    const candidates = agentModelCandidates(await getAgentAiModelWithProvider(), await getEnabledAiModelsWithProvider());
-    const configured = candidates[0];
-    if (!configured) throw new AgentRunError("请先在后台配置可用的多模态 Agent 对话模型", 503);
-    let model = await getLanguageModelById(configured.model.id);
-    for (const candidate of candidates.slice(1)) {
-      if (model) break;
-      model = await getLanguageModelById(candidate.model.id);
-    }
-    if (!model) throw new AgentRunError("Agent 模型暂不可用", 503);
-    const visionModel = model;
-    const executeVisionModel = createAgentVisionExecutor(candidates, agentModelCircuitStore, getLanguageModelById);
-    // Validate the user's image choice independently of the Agent planning model.
-    if (body.selectedImageModel) {
-      const images = await getStyleProImageModelEntries();
-      if (!images.some(({ model }) => model.id === body.selectedImageModel && model.healthStatus !== "auto_disabled"))
-        throw new AgentRunError("你选择的生图模型当前不可用，请重新选择；不会自动换模型生成。", 400);
-    }
-    const assistantMessageId = crypto.randomUUID();
-    const previousVideoMessages =
-      existingChat
-        ? (await getMessagesByChatId({ id: body.id })).slice(-6).map((message) => ({
-            role: message.role as "user" | "assistant",
-            content: (message.parts as Array<{ type: string; text?: string }>)
-              .filter((part) => part.type === "text")
-              .map((part) => part.text || "")
-              .join("\n")
-              .slice(0, 4000),
-          }))
-        : [];
-    const initialSnapshot = newAgentRunSnapshot(objective, [
-      ...previousVideoMessages,
-      { role: "user", content: objective },
-    ]);
-    initialSnapshot.workspace = isVideo ? "video" : "canvas";
-    if (isVideo) {
-      initialSnapshot.videoRequirements = inferVideoTaskRequirements(objective);
-      initialSnapshot.videoSettings = videoAgentSettingsSchema.parse({
-        ...body.videoAgentSettings,
-        ...(initialSnapshot.videoRequirements.duration
-          ? { duration: initialSnapshot.videoRequirements.duration }
-          : {}),
-        ...(initialSnapshot.videoRequirements.ratio
-          ? { ratio: initialSnapshot.videoRequirements.ratio }
-          : {}),
-      });
-    }
-    initialSnapshot.sourceNodeIds = conversation.sourceNodeIds;
-    initialSnapshot.requirements = {
-      ...inferCanvasTaskRequirements(objective, initialSnapshot.sourceNodeIds.length),
-      sourceCount: initialSnapshot.sourceNodeIds.length,
-    };
-    const run = await acquireAgentRun({
-      id: body.message.id,
-      userId: session.user.id,
-      projectId,
-      chatId: body.id,
-      assistantMessageId,
-      resumeRunId: body.resumeRunId,
-      snapshot: initialSnapshot,
-    });
-    const snapshot = run.snapshot;
-    snapshot.imagePreferences = {
-      ...snapshot.imagePreferences,
-      // Each submitted turn captures the current controls, including switching back to Auto.
-      modelId: body.selectedImageModel,
-      parameters: body.imageParams || snapshot.imagePreferences?.parameters,
-    };
-    const taskSourceNodeIds = snapshot.sourceNodeIds ?? selectedNodeIds;
-    const context = {
-      recentConversation: previousVideoMessages,
-      preset: preset ? { name: preset.name, type: preset.type, promptTemplate: preset.promptTemplate, defaultModelId: preset.defaultModelId, defaultParams: preset.defaultParams, slots: preset.slots.map(slot => ({ title: slot.title, promptTemplate: slot.promptTemplate, defaultParams: slot.defaultParams })) } : null,
-      videoSettings: snapshot.videoSettings,
-      selectedNodeIds: taskSourceNodeIds,
-      nodes: nodes
-        .filter((node) => taskSourceNodeIds.includes(node.id))
-        .map((node) => ({
-          id: node.id,
-          type: node.type,
-          position: node.position,
-          size: node.size,
-          title: node.data.title,
-        })),
-      skillInstructions: body.hiddenPrompt || undefined,
-      imagePreferences: snapshot.imagePreferences,
-      targetReason: conversation.targetReason,
-      previousConversationContext: conversation.previousContext,
-    };
-    await saveMessages({
-      messages: [
-        {
-          id: body.message.id,
-          chatId: body.id,
-          role: "user",
-          parts: body.message.parts,
-          attachments: [],
-          createdAt: new Date(),
-          videoStorageStatus: null,
-          temporaryVideoUrl: null,
-          permanentVideoUrl: null,
-          archivedAt: null,
-          videoMetadata: null,
-        },
-      ],
-    });
-    let archiveVideoResults: (() => Promise<void>) | undefined;
-    const stream = createUIMessageStream({
-      execute: async ({ writer }) => {
-        const emit = (type: string, data: unknown) => writer.write({ type, data, ...(type === "data-canvasAgentRun" ? { transient: true } : {}) } as never);
-        let cancelled = false;
-        let leaseLost = false;
-        const activeModelController = new AbortController();
-        const withModel: typeof executeVisionModel = (execute, signal) => executeVisionModel(execute,
-          signal ? AbortSignal.any([signal, activeModelController.signal]) : activeModelController.signal);
-        const heartbeat = setInterval(() => {
-          void heartbeatAgentRun(run)
-            .then((current) => {
-              if (!current) leaseLost = true;
-              if (current?.cancelRequested) cancelled = true;
-              if (cancelled || leaseLost) activeModelController?.abort();
-            })
-            .catch(() => {
-              leaseLost = true;
-              activeModelController?.abort();
-            });
-          emit("data-keepalive", { label: "canvas-agent-runtime", ts: Date.now() });
-        }, 10_000);
-        const textId = crypto.randomUUID();
-        writer.write({ type: "start", messageId: assistantMessageId });
-        writer.write({ type: "text-start", id: textId });
-        let streamedText = "";
-        const emitAssistantText = (delta: string) => {
-          streamedText += delta;
-          writer.write({ type: "text-delta", id: textId, delta });
-        };
-        try {
-          const videoPorts = isVideo
-            ? await createVideoRuntimePorts({
-                userId: session.user.id,
-                chatId: body.id,
-                projectId,
-                runId: run.id,
-                assistantMessageId,
-                request,
-                snapshot,
-                emit,
-              })
-            : null;
-          archiveVideoResults = videoPorts?.archiveResults;
-          const tools = isVideo
-            ? buildVideoRuntimeTools({
-                runId: run.id,
-                projectId,
-                selectedNodeIds,
-                snapshot,
-                ports: videoPorts!,
-              })
-            : await buildCanvasRuntimeTools({
-                userId: session.user.id,
-                chatId: body.id,
-                projectId,
-                runId: run.id,
-                assistantMessageId,
-                selectedNodeIds: taskSourceNodeIds,
-                request,
-                model: visionModel || model,
-                supportsVision: Boolean(visionModel),
-                withModel,
-                imageSize: snapshot.imagePreferences?.parameters?.imageSize,
-                imagePreferences: snapshot.imagePreferences,
-                priorCalls: snapshot.calls,
-                preferredModelId: snapshot.imagePreferences?.modelId || (preset?.type === "image" ? preset.defaultModelId || undefined : undefined),
-                operationSelectedNodeIds: selectedNodeIds,
-                objective: [snapshot.objective, ...snapshot.inputs.map((input) => input.text)].join(
-                  "\n",
-                ),
-                emit,
-              });
-          await registerProjectAgentTools({ session, projectId, request, objective: snapshot.objective,
-            definitions: tools.definitions, executable: tools.executable, emit,
-            imagePreferences: snapshot.imagePreferences });
-          const gateway = await createZcodeModelGateway(configured, undefined, candidates);
-          const status = await runZcodeCanvasTask({
-            runId: run.id, snapshot, definitions: tools.definitions,
-            instructions: (isVideo ? videoRuntimeSystemPrompt : canvasRuntimeSystemPrompt)(snapshot.objective, snapshot.summary, snapshot.inputs.map(input => input.text), context),
-            context, gateway, signal: activeModelController.signal,
-            onAssistantText: emitAssistantText,
-            tools: tools.executable,
-            checkpoint: async (state, stateStatus) => {
-              if (leaseLost) throw new AgentRunError("任务执行已中断");
-              const saved = await checkpointAgentRun(run, state, stateStatus);
-              cancelled ||= saved.cancelRequested;
-              emit("data-canvasAgentRun", agentRunView(saved));
-            },
-            consumeInputs: async (state) => {
-              if (leaseLost) throw new AgentRunError("任务执行已中断");
-              const control = await consumeAgentRunInputs(run, state);
-              cancelled ||= control.cancelled;
-              return { cancelled };
-            },
-            isCancelled: async () => {
-              const current = await heartbeatAgentRun(run);
-              if (!current) throw new AgentRunError("任务执行已中断");
-              cancelled ||= current.cancelRequested;
-              return cancelled;
-            },
-            verify: async (state) =>
-              isVideo
-                ? verifyVideoAgentResults({
-                    snapshot: state,
-                    nodes: (await readOwnedVideoCanvas(session.user.id, projectId)).nodes,
-                    inspect: async (node, requirements) => {
-                      const metadata = await probeVideoMetadata(videoNodeUrl(node));
-                      const report = await videoPorts!.analyze({
-                        mode: "video-analysis",
-                        prompt: `请基于真实抽帧画面检查主体、场景、镜头连贯性，说明不确定内容。用户要求：${requirements}`,
-                        imageUrls: [],
-                        videoUrls: [videoNodeUrl(node)],
-                      });
-                      const verdict = await generateText({
-                        model,
-                        system:
-                          '你是视频验收员。依据实际抽帧分析判断是否满足用户要求；不能从文件名或提示词判断。若报告无法读取真实帧，必须不通过。抽帧只能检查画面，不能证明音频、精确时长或完整运动，涉及这些要求无法确认时说明需要人工检查。仅返回 JSON {"passed":boolean,"issues":string[]}。',
-                        prompt: JSON.stringify({ requirements, report }),
-                        maxOutputTokens: 1200,
-                        maxRetries: 0,
-                        abortSignal: AbortSignal.timeout(60_000),
-                      });
-                      state.inputTokens += verdict.usage.inputTokens || 0;
-                      state.outputTokens += verdict.usage.outputTokens || 0;
-                      const match = verdict.text.match(/\{[\s\S]*\}/);
-                      if (!match) throw new Error("视频检查未返回有效结果");
-                      return {
-                        ...z
-                          .object({ passed: z.boolean(), issues: z.array(z.string()).max(12) })
-                          .parse(JSON.parse(match[0])),
-                        ...metadata,
-                      };
-                    },
-                  })
-                : verifyCanvasAgentResults({
-                    snapshot: state,
-                    userId: session.user.id,
-                    projectId,
-                    model: visionModel || model,
-                    supportsVision: Boolean(visionModel),
-                    withModel,
-                    signal: activeModelController.signal,
-                  }),
-          });
-          const finalText = canvasAgentReplyText(snapshot);
-          const progress = canvasAgentProgress(agentRunView({ ...run, snapshot, status }));
-          writer.write({ type: "data-canvasAgentProgress", id: run.id, data: progress });
-          if (!isVideo)
-            await persistRuntimeConversationResults({
-              userId: session.user.id,
-              chatId: body.id,
-              projectId,
-              assistantMessageId,
-              snapshot,
-            }).catch((error) => {
-              console.warn("[Canvas Agent] Conversation memory update failed", {
-                runId: run.id,
-                error: publicAgentError(error),
-              });
-            });
-          await saveMessages({
-            messages: [
-              {
-                id: assistantMessageId,
-                chatId: body.id,
-                role: "assistant",
-                parts: [{ type: "text", text: finalText }, { type: "data-canvasAgentProgress", data: progress }],
-                attachments: [],
-                createdAt: new Date(),
-                videoStorageStatus: null,
-                temporaryVideoUrl: null,
-                permanentVideoUrl: null,
-                archivedAt: null,
-                videoMetadata: null,
-              },
-            ],
-          });
-          emitAssistantText(finalText.startsWith(streamedText) ? finalText.slice(streamedText.length) : `\n\n${snapshot.message}`);
-        } catch (error) {
-          const statusText = publicAgentError(error);
-          const text = canvasAgentReplyText({ ...snapshot, message: statusText });
-          await checkpointAgentRun(run, { ...snapshot, message: statusText }, "needs_review").catch(
-            () => undefined,
-          );
-          const progress = canvasAgentProgress(agentRunView({ ...run, snapshot: { ...snapshot, message: statusText }, status: "needs_review" }));
-          writer.write({ type: "data-canvasAgentProgress", id: run.id, data: progress });
-          await saveMessages({ messages: [{ id: assistantMessageId, chatId: body.id, role: "assistant",
-            parts: [{ type: "text", text }, { type: "data-canvasAgentProgress", data: progress }],
-            attachments: [], createdAt: new Date(), videoStorageStatus: null, temporaryVideoUrl: null,
-            permanentVideoUrl: null, archivedAt: null, videoMetadata: null }] }).catch(() => undefined);
-          emitAssistantText(text.startsWith(streamedText) ? text.slice(streamedText.length) : `\n\n${statusText}`);
-        } finally {
-          clearInterval(heartbeat);
-          writer.write({ type: "text-end", id: textId });
-          writer.write({ type: "finish" });
-        }
-      },
-    });
-    // Browser disconnection does not cancel paid image work. Keep consuming on the server.
-    const [client, background] = stream.tee();
-    after(async () => {
-      const reader = background.getReader();
-      try {
-        while (!(await reader.read()).done) {
-          /* Drain the server branch. */
-        }
-      } finally {
-        reader.releaseLock();
-        await archiveVideoResults?.();
-      }
-    });
-    return createUIMessageStreamResponse({
-      stream: client,
-      headers: { "Cache-Control": "no-store", "X-Accel-Buffering": "no" },
-    });
-  } catch (error) {
-    return NextResponse.json(
-      { error: publicAgentError(error), message: publicAgentError(error) },
-      {
-        status:
-          error instanceof AgentRunError ? error.status : error instanceof z.ZodError ? 400 : 503,
-      },
-    );
-  }
-}

app/api/canvas/agent-runs/route.ts

@@ -1,65 +0,0 @@
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { auth } from "@/app/(auth)/auth";
-import {
-  AgentRunError,
-  agentRunView,
-  assertAgentRunOwnership,
-  controlAgentRun,
-  getAgentRun,
-} from "@/lib/ai/canvas-agent-runtime/store";
-import { publicAgentError } from "@/lib/ai/canvas-agent-runtime/protocol";
-
-export const dynamic = "force-dynamic";
-const scope = z.object({
-  chatId: z.string().uuid(),
-  projectId: z.string().uuid(),
-  runId: z.string().uuid().optional(),
-});
-const control = scope
-  .extend({
-    runId: z.string().uuid(),
-    action: z.enum(["steer", "cancel"]),
-    inputId: z.string().uuid().optional(),
-    text: z.string().trim().min(1).max(2000).optional(),
-  })
-  .refine(
-    (input) => input.action !== "steer" || Boolean(input.inputId && input.text),
-    "补充要求缺少内容或请求号",
-  );
-
-export async function GET(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const input = scope.parse(Object.fromEntries(new URL(request.url).searchParams));
-    await assertAgentRunOwnership(session.user.id, input.projectId, input.chatId);
-    const run = await getAgentRun(session.user.id, input.chatId, input.projectId, input.runId);
-    return NextResponse.json(
-      { run: run ? agentRunView(run) : null },
-      { headers: { "Cache-Control": "private, no-store" } },
-    );
-  } catch (error) {
-    return failure(error);
-  }
-}
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const input = control.parse(await request.json());
-    await assertAgentRunOwnership(session.user.id, input.projectId, input.chatId);
-    return NextResponse.json({ run: await controlAgentRun({ ...input, userId: session.user.id }) });
-  } catch (error) {
-    return failure(error);
-  }
-}
-function failure(error: unknown) {
-  return NextResponse.json(
-    { error: publicAgentError(error) },
-    {
-      status:
-        error instanceof AgentRunError ? error.status : error instanceof z.ZodError ? 400 : 503,
-    },
-  );
-}

app/api/canvas/audio-separate/route.ts

@@ -1,112 +0,0 @@
-import { createHash, randomUUID } from "node:crypto";
-import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { uploadFile } from "@/lib/storage/service";
-import { ffmpeg, mediaSafety, probeMedia } from "@/lib/video-canvas/smart-edit/local";
-import {
-  remoteAudio,
-  remoteAudioConfig,
-} from "@/lib/video-canvas/smart-edit/remote-audio";
-
-export const runtime = "nodejs";
-export const maxDuration = 600;
-
-const running = new Set<string>();
-const allowedStems = ["vocals", "background"] as const;
-
-export async function POST(request: Request) {
-  const session = await auth();
-  const userId = session?.user?.id;
-  if (!userId)
-    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-  const body = (await request.json().catch(() => null)) as {
-    url?: unknown;
-    stem?: unknown;
-  } | null;
-  const url = typeof body?.url === "string" ? body.url.trim() : "";
-  const stem = typeof body?.stem === "string" ? body.stem : "";
-  if (!/^https?:\/\//i.test(url) || !allowedStems.includes(stem as (typeof allowedStems)[number]))
-    return NextResponse.json({ success: false, error: "参数不完整" }, { status: 400 });
-  if (!remoteAudioConfig())
-    return NextResponse.json(
-      { success: false, error: "音频分离服务未配置，请联系管理员" },
-      { status: 503 }
-    );
-  const lockKey = `${userId}:${url}:${stem}`;
-  if (running.has(lockKey) || running.size >= 3)
-    return NextResponse.json(
-      { success: false, error: "已有分离任务在进行，请稍候" },
-      { status: 429 }
-    );
-  running.add(lockKey);
-  let dir = "";
-  try {
-    dir = await mkdtemp(path.join(tmpdir(), "canvas-separate-"));
-    const input = path.join(dir, "input");
-    const response = await fetch(url, {
-      signal: AbortSignal.timeout(180000),
-      cache: "no-store",
-    });
-    if (!response.ok) throw new Error("素材下载失败，请确认素材仍可访问");
-    const bytes = Buffer.from(await response.arrayBuffer());
-    if (!bytes.length || bytes.length > 150 * 1024 * 1024)
-      throw new Error("素材必须非空且不超过 125 MiB");
-    await writeFile(input, bytes);
-    const info = await probeMedia(input, 600);
-    if (!info.hasAudio) throw new Error("当前视频没有音轨");
-    const inputAudio = path.join(dir, "separation-input.wav");
-    const durationSeconds = Math.round(info.duration / 1e6);
-    await ffmpeg(
-      [
-        ...mediaSafety,
-        "-i",
-        input,
-        "-vn",
-        "-t",
-        String(durationSeconds),
-        "-ac",
-        "2",
-        "-ar",
-        "44100",
-        "-c:a",
-        "pcm_f32le",
-        inputAudio,
-      ],
-      undefined,
-      240000
-    );
-    const requestKey = createHash("sha256")
-      .update(`${url}:${stem}:${(await stat(inputAudio)).size}`)
-      .digest("hex");
-    await remoteAudio("separate", inputAudio, userId, requestKey, dir);
-    const stemFile = path.join(dir, `${stem}.wav`);
-    const wav = await readFile(stemFile);
-    if (wav.length < 1024) throw new Error("分离结果异常，请稍后重试");
-    const uploaded = await uploadFile(
-      `canvas-separate-${randomUUID()}.wav`,
-      await new Blob([wav]).arrayBuffer()
-    );
-    return NextResponse.json({
-      success: true,
-      data: {
-        url: uploaded.url,
-        duration: Math.round(info.duration / 1e6),
-      },
-    });
-  } catch (error) {
-    return NextResponse.json(
-      {
-        success: false,
-        error:
-          error instanceof Error ? error.message : "人声分离失败，原音轨已保留",
-      },
-      { status: 500 }
-    );
-  } finally {
-    running.delete(lockKey);
-    if (dir) await rm(dir, { recursive: true, force: true });
-  }
-}

app/api/canvas/audio-source/route.ts

@@ -0,0 +1,16 @@
+import { auth } from "@/app/(auth)/auth";
+import { proxyCanvasAudioSource } from "@/lib/video-canvas/audio-source-proxy";
+
+export async function GET(request: Request) {
+  const requestHostname = new URL(request.url).hostname.toLowerCase();
+  const isLoopbackRequest =
+    requestHostname === "localhost" ||
+    requestHostname === "127.0.0.1" ||
+    requestHostname === "::1";
+  const session = isLoopbackRequest ? null : await auth();
+  if (!isLoopbackRequest && !session?.user?.id) {
+    return Response.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  return proxyCanvasAudioSource(request);
+}

app/api/canvas/audio/models/route.ts

@@ -1,24 +0,0 @@
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { listCanvasAudioModels } from "@/lib/video-canvas/audio-generation";
-import { audioContract } from "@/lib/video-canvas/audio-contract";
-export async function GET() {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const models = await listCanvasAudioModels();
-    return NextResponse.json(
-      {
-        models: models.map(({ model }) => ({
-          id: model.id,
-          modelId: model.modelId,
-          name: model.displayName,
-          ...audioContract(model.modelId),
-        })),
-      },
-      { headers: { "Cache-Control": "no-store" } },
-    );
-  } catch {
-    return NextResponse.json({ error: "音频模型读取失败，请稍后重试" }, { status: 503 });
-  }
-}

app/api/canvas/box-cutout/route.ts

@@ -1,15 +1,100 @@
-import { NextResponse } from "next/server";
+import { NextRequest, NextResponse } from "next/server";
 
 import { auth } from "@/app/(auth)/auth";
-import { executeBoxCutoutPOST } from "@/lib/canvas/operations/box-cutout";
+import {
+  BoxCutoutServiceError,
+  executeBoxCutoutJob,
+} from "@/lib/ai/box-cutout/service";
+import { RmbgServiceError } from "@/lib/ai/rmbg/service";
+import { getPointsSystemConfig } from "@/lib/db/queries";
+import { prepareFeaturePointsCharge } from "@/lib/points/feature-charge";
+import { getImageToolCreditCost } from "@/lib/points/config";
 
 export const runtime = "nodejs";
 export const maxDuration = 60;
 
-export async function POST(request: Request) {
+type BoxCutoutRequest = {
-  const session = await auth();
+  imageUrl?: string;
-  if (!session?.user?.id) {
+  cropRect?: {
-    return NextResponse.json({ success: false, error: "未授权，请先登录" }, { status: 401 });
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+  };
+  paddingRatio?: number;
+  prompt?: string;
+  chatId?: string | null;
+  messageId?: string | null;
+  skipGallerySave?: boolean;
+  sourceNodeId?: string;
+};
+
+export async function POST(request: NextRequest) {
+  try {
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json({ success: false, error: "未授权，请先登录" }, { status: 401 });
+    }
+
+    const body = (await request.json()) as BoxCutoutRequest;
+    const rawImageUrl = String(body.imageUrl || "").trim();
+    if (!rawImageUrl) {
+      return NextResponse.json({ success: false, error: "缺少 imageUrl 参数" }, { status: 400 });
+    }
+
+    const resolvedImageUrl = new URL(rawImageUrl, request.url).toString();
+    const pointsConfig = await getPointsSystemConfig();
+    const pointsCharge = await prepareFeaturePointsCharge({
+      userId: session.user.id,
+      unitCost: getImageToolCreditCost(pointsConfig, "box-cutout"),
+      reason: "image_box_cutout",
+      modelId: "box-cutout",
+      note: "框选抠图消耗积分",
+      pointsConfig,
+    });
+    if (!pointsCharge.ok) {
+      return NextResponse.json(pointsCharge.payload, { status: pointsCharge.status });
+    }
+
+    const result = await executeBoxCutoutJob({
+      userId: session.user.id,
+      imageUrl: resolvedImageUrl,
+      cropRect: body.cropRect || {},
+      paddingRatio: body.paddingRatio,
+      prompt: body.prompt || "框选抠图",
+      chatId: body.chatId || null,
+      messageId: body.messageId || null,
+      skipGallerySave: body.skipGallerySave === true,
+      sourceNodeId: body.sourceNodeId,
+    });
+
+    if (pointsCharge.chargeable) {
+      try {
+        await pointsCharge.consume();
+      } catch (pointsError) {
+        console.error("[Points] Failed to consume box cutout points:", pointsError);
+      }
+    }
+
+    return NextResponse.json(result);
+  } catch (error) {
+    if (error instanceof BoxCutoutServiceError || error instanceof RmbgServiceError) {
+      return NextResponse.json(
+        {
+          success: false,
+          error: error.detail || error.message,
+        },
+        { status: error.status },
+      );
+    }
+
+    console.error("[BoxCutout] 处理失败:", error);
+    return NextResponse.json(
+      {
+        success: false,
+        error: error instanceof Error ? error.message : "框选抠图失败",
+      },
+      { status: 500 },
+    );
   }
-  return executeBoxCutoutPOST(request, session.user.id);
 }

app/api/canvas/clawd-chat/artifact/route.ts

@@ -1,266 +0,0 @@
-import { lookup } from "node:dns/promises";
-import { isIP } from "node:net";
-import { NextResponse } from "next/server";
-import { z } from "zod";
-import { auth } from "@/app/(auth)/auth";
-import { getChatById, getMessageById, getSystemSetting } from "@/lib/db/queries";
-import {
-  normalizeOpenClawChatConfig,
-  OPENCLAW_CHAT_CONFIG_KEY,
-} from "@/lib/openclaw-chat/config";
-import { normalizeClawdTaskMetadata } from "@/lib/openclaw-chat/task-state";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-export const maxDuration = 120;
-
-const querySchema = z.object({
-  chatId: z.string().uuid(),
-  messageId: z.string().uuid(),
-  index: z.coerce.number().int().min(0).max(127),
-  download: z.enum(["0", "1"]).optional().default("0"),
-});
-
-const MAX_REDIRECTS = 4;
-const RESPONSE_HEADERS = [
-  "accept-ranges",
-  "content-length",
-  "content-range",
-  "etag",
-  "last-modified",
-] as const;
-
-function isPrivateIpv4(address: string) {
-  const octets = address.split(".").map(Number);
-  if (octets.length !== 4 || octets.some((value) => !Number.isInteger(value))) {
-    return true;
-  }
-  const [a, b] = octets;
-  return (
-    a === 0 ||
-    a === 10 ||
-    a === 127 ||
-    (a === 100 && b >= 64 && b <= 127) ||
-    (a === 169 && b === 254) ||
-    (a === 172 && b >= 16 && b <= 31) ||
-    (a === 192 && b === 168) ||
-    a >= 224
-  );
-}
-
-function isPrivateIpAddress(address: string) {
-  if (isIP(address) === 4) return isPrivateIpv4(address);
-  if (isIP(address) !== 6) return true;
-  const normalized = address.toLowerCase();
-  if (normalized.startsWith("::ffff:")) {
-    return isPrivateIpv4(normalized.slice("::ffff:".length));
-  }
-  return (
-    normalized === "::" ||
-    normalized === "::1" ||
-    normalized.startsWith("fc") ||
-    normalized.startsWith("fd") ||
-    normalized.startsWith("fe8") ||
-    normalized.startsWith("fe9") ||
-    normalized.startsWith("fea") ||
-    normalized.startsWith("feb") ||
-    normalized.startsWith("ff")
-  );
-}
-
-async function validateTargetUrl(target: URL, trustedOrigin: string) {
-  if (target.username || target.password) return false;
-  if (target.origin === trustedOrigin) {
-    return target.protocol === "http:" || target.protocol === "https:";
-  }
-  if (target.protocol !== "https:") return false;
-  const hostname = target.hostname.toLowerCase().replace(/^\[|\]$/g, "");
-  if (
-    hostname === "localhost" ||
-    hostname.endsWith(".localhost") ||
-    hostname.endsWith(".local")
-  ) {
-    return false;
-  }
-  if (isIP(hostname)) return !isPrivateIpAddress(hostname);
-
-  const addresses = await lookup(hostname, { all: true, verbatim: true }).catch(
-    () => []
-  );
-  return (
-    addresses.length > 0 &&
-    addresses.every((entry) => !isPrivateIpAddress(entry.address))
-  );
-}
-
-function normalizeRangeHeader(value: string | null) {
-  const range = String(value || "").trim();
-  if (!range) return null;
-  const match = range.match(/^bytes=(\d*)-(\d*)$/);
-  if (!match || (!match[1] && !match[2])) return "";
-  if (match[1] && match[2] && Number(match[1]) > Number(match[2])) return "";
-  return range;
-}
-
-function inferContentType(filename: string, declaredType: string) {
-  if (declaredType) return declaredType;
-  const lower = filename.toLowerCase();
-  if (lower.endsWith(".glb")) return "model/gltf-binary";
-  if (lower.endsWith(".gltf")) return "model/gltf+json";
-  if (lower.endsWith(".png")) return "image/png";
-  if (lower.endsWith(".webp")) return "image/webp";
-  if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
-  return "application/octet-stream";
-}
-
-function safeDownloadName(value: string) {
-  const normalized = value.replace(/[\r\n"\\/]/g, "_").trim() || "artifact";
-  return normalized.slice(0, 180);
-}
-
-async function fetchArtifact(params: {
-  request: Request;
-  initialUrl: URL;
-  method: "GET" | "HEAD";
-  range: string | null;
-  token: string;
-  trustedOrigin: string;
-}) {
-  let target = params.initialUrl;
-  for (let redirects = 0; redirects <= MAX_REDIRECTS; redirects += 1) {
-    if (!(await validateTargetUrl(target, params.trustedOrigin))) {
-      throw new Error("不允许访问该文件地址");
-    }
-    const headers = new Headers({ Accept: "*/*" });
-    if (params.range) headers.set("Range", params.range);
-    if (target.origin === params.trustedOrigin && params.token) {
-      headers.set("Authorization", `Bearer ${params.token}`);
-    }
-    const response = await fetch(target, {
-      method: params.method,
-      headers,
-      cache: "no-store",
-      redirect: "manual",
-      signal: params.request.signal,
-    });
-    if (![301, 302, 303, 307, 308].includes(response.status)) {
-      return { response, target };
-    }
-    if (redirects === MAX_REDIRECTS) throw new Error("文件重定向次数过多");
-    const location = response.headers.get("location");
-    if (!location) throw new Error("文件重定向地址无效");
-    target = new URL(location, target);
-  }
-  throw new Error("文件地址无效");
-}
-
-async function handleRequest(request: Request, method: "GET" | "HEAD") {
-  const session = await auth().catch(() => null);
-  if (!session?.user?.id) {
-    return NextResponse.json({ error: "未登录" }, { status: 401 });
-  }
-
-  const url = new URL(request.url);
-  const parsed = querySchema.safeParse({
-    chatId: url.searchParams.get("chatId"),
-    messageId: url.searchParams.get("messageId"),
-    index: url.searchParams.get("index"),
-    download: url.searchParams.get("download") || undefined,
-  });
-  if (!parsed.success) {
-    return NextResponse.json({ error: "请求参数不正确" }, { status: 400 });
-  }
-
-  const chat = await getChatById({ id: parsed.data.chatId }).catch(() => null);
-  if (!chat || chat.userId !== session.user.id) {
-    return NextResponse.json({ error: "Forbidden" }, { status: 403 });
-  }
-  const rows = await getMessageById({ id: parsed.data.messageId }).catch(
-    () => []
-  );
-  const message = rows.find((row) => row.chatId === parsed.data.chatId);
-  const metadata = normalizeClawdTaskMetadata(message?.videoMetadata);
-  const artifact = metadata?.artifacts?.[parsed.data.index];
-  if (!message || !artifact) {
-    return NextResponse.json({ error: "文件不存在" }, { status: 404 });
-  }
-
-  const setting = await getSystemSetting({ key: OPENCLAW_CHAT_CONFIG_KEY }).catch(
-    () => null
-  );
-  const config = normalizeOpenClawChatConfig(setting?.value);
-  let target: URL;
-  let trustedOrigin: string;
-  try {
-    target = new URL(artifact.downloadUrl);
-    trustedOrigin = new URL(config.baseUrl).origin;
-  } catch {
-    return NextResponse.json({ error: "文件地址无效" }, { status: 400 });
-  }
-
-  const range = normalizeRangeHeader(request.headers.get("range"));
-  if (range === "") {
-    return NextResponse.json({ error: "Range 请求格式无效" }, { status: 400 });
-  }
-
-  try {
-    const { response, target: finalTarget } = await fetchArtifact({
-      request,
-      initialUrl: target,
-      method,
-      range,
-      token: config.token,
-      trustedOrigin,
-    });
-    if (!response.ok && response.status !== 206) {
-      return NextResponse.json(
-        { error: `文件读取失败（HTTP ${response.status}）` },
-        { status: response.status >= 400 && response.status < 600 ? response.status : 502 }
-      );
-    }
-
-    const headers = new Headers();
-    for (const name of RESPONSE_HEADERS) {
-      const value = response.headers.get(name);
-      if (value) headers.set(name, value);
-    }
-    headers.set(
-      "content-type",
-      response.headers.get("content-type") ||
-        inferContentType(artifact.filename || finalTarget.pathname, artifact.mimeType)
-    );
-    headers.set("cache-control", "private, max-age=3600, must-revalidate");
-    headers.set("x-content-type-options", "nosniff");
-    if (parsed.data.download === "1") {
-      const filename = safeDownloadName(artifact.filename || artifact.displayName);
-      headers.set(
-        "content-disposition",
-        `attachment; filename*=UTF-8''${encodeURIComponent(filename)}`
-      );
-    }
-
-    return new Response(method === "HEAD" ? null : response.body, {
-      status: response.status,
-      headers,
-    });
-  } catch (error) {
-    console.warn("[Clawd Artifact] Proxy failed:", {
-      chatId: parsed.data.chatId,
-      messageId: parsed.data.messageId,
-      artifactIndex: parsed.data.index,
-      error: error instanceof Error ? error.message : String(error),
-    });
-    return NextResponse.json(
-      { error: error instanceof Error ? error.message : "文件读取失败" },
-      { status: 502 }
-    );
-  }
-}
-
-export async function GET(request: Request) {
-  return handleRequest(request, "GET");
-}
-
-export async function HEAD(request: Request) {
-  return handleRequest(request, "HEAD");
-}

app/api/canvas/clawd-chat/history/route.ts

@@ -25,7 +25,7 @@ export async function GET(request: Request) {
   const url = new URL(request.url);
   const limit = Math.max(
     1,
-    Math.min(500, Math.round(Number(url.searchParams.get("limit") || 100)))
+    Math.min(100, Math.round(Number(url.searchParams.get("limit") || 50)))
   );
 
   const chats = await getClawdChatsByUserId({

app/api/canvas/clawd-chat/route.ts

@@ -29,7 +29,6 @@ import {
   OPENCLAW_CHAT_MEDIA_MAX_ATTACHMENTS,
   type OpenClawChatMediaAttachment,
 } from "@/lib/openclaw-chat/media-attachments";
-import { extractOpenClawArtifacts } from "@/lib/openclaw-chat/artifacts";
 import {
   buildOpenClawDisplayMessage,
   buildOpenClawMessageWithSpreadsheetMarkdown,
@@ -299,7 +298,7 @@ async function executeClawdTask(params: ExecuteClawdTaskParams) {
           params.spreadsheetMarkdownTruncated || undefined,
         ...params.metadata,
       },
-      stream_progress: !params.sensitiveInput,
+      stream_progress: false,
       sensitive_input: params.sensitiveInput,
     };
 
@@ -338,9 +337,6 @@ async function executeClawdTask(params: ExecuteClawdTaskParams) {
           assistantMessageId: params.assistantMessageId,
           answer,
           requestId: getRequestId(payload),
-          artifacts: extractOpenClawArtifacts(payload, {
-            baseUrl: params.config.baseUrl,
-          }),
         });
         clearClawdRequestCancellation(params.cancelKey);
         return;
@@ -374,7 +370,6 @@ async function executeClawdTask(params: ExecuteClawdTaskParams) {
         ...target,
         answer: outcome.answer,
         requestId: outcome.requestId,
-        artifacts: outcome.artifacts,
       });
     } else if (outcome.status === "canceled") {
       await markClawdTaskCanceled({

app/api/canvas/clawd-chat/status/route.ts

@@ -75,7 +75,6 @@ async function reconcileDetachedOpenClawTask(params: {
         ...target,
         answer: outcome.answer,
         requestId: outcome.requestId,
-        artifacts: outcome.artifacts,
       });
     } else if (outcome.status === "failed") {
       await markClawdTaskFailed({ ...target, error: outcome.error });

app/api/canvas/director/upload-model/route.ts

@@ -1,45 +0,0 @@
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { uploadFile } from "@/lib/storage/service";
-import {
-  DIRECTOR_MAX_GLB_BYTES,
-  validateDirectorGlb,
-} from "@/lib/video-canvas/director-glb";
-export const runtime = "nodejs";
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id)
-    return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const form = await request.formData();
-    const file = form.get("file");
-    if (
-      !(file instanceof File) ||
-      !/\.glb$/i.test(file.name) ||
-      file.size > DIRECTOR_MAX_GLB_BYTES
-    )
-      return NextResponse.json(
-        { error: "请上传 25 MiB 以内的 GLB 模型" },
-        { status: 400 },
-      );
-    const buffer = await file.arrayBuffer();
-    try {
-      validateDirectorGlb(buffer);
-    } catch (error) {
-      return NextResponse.json(
-        { error: error instanceof Error ? error.message : "无效 GLB" },
-        { status: 400 },
-      );
-    }
-    const result = await uploadFile(
-      `director-${crypto.randomUUID()}.glb`,
-      buffer,
-    );
-    return NextResponse.json({ success: true, data: result });
-  } catch {
-    return NextResponse.json(
-      { error: "模型上传失败，请重试" },
-      { status: 500 },
-    );
-  }
-}

app/api/canvas/download-image/route.ts

@@ -1,13 +1,5 @@
-import { resolveCanvasCdnDownload } from "@/lib/storage/canvas-cdn-download";
+import { NextRequest, NextResponse } from "next/server";
-import { isRetiredStorageUrl, RETIRED_STORAGE_MESSAGE } from "@/lib/storage/retired-storage";
-import { scheduleImageDownloadPreparation } from "@/lib/storage/image-download-preparation";
-import { randomUUID } from "node:crypto";
-import { formatDownloadFailure, getDownloadFailure, type DownloadFailure } from "@/lib/canvas/download-error";
-import { createLogger } from "@/lib/observability/logger";
-import { after, NextRequest, NextResponse } from "next/server";
 import { auth } from "@/app/(auth)/auth";
-import { getDownloadPreparationQueue, type DownloadPreparationInput } from "@/lib/canvas/download-preparation";
-import { extractImageProxySourceUrl, inferOriginalImageUrl } from "@/lib/image-url";
 import {
   buildAttachmentContentDisposition,
   fetchCanvasDownloadAsset,
@@ -16,50 +8,6 @@ import {
 
 export const runtime = "nodejs";
 export const maxDuration = 120;
-const logger = createLogger("canvas.download");
-
-function failed(failure: DownloadFailure, requestId: string) {
-  logger.warn("request_failed", { requestId, code: failure.code, status: failure.status });
-  return NextResponse.json({ success: false, error: formatDownloadFailure(failure, requestId), failure, requestId }, {
-    status: failure.status,
-    headers: { "Cache-Control": "no-store", ...(failure.status === 429 ? { "Retry-After": "3" } : {}) },
-  });
-}
-
-function preparing(requestId: string) {
-  return NextResponse.json({ delivery: "preparing", retryAfter: 2, requestId,
-    message: "正在准备原图，完成后将自动开始下载" }, {
-    status: 202, headers: { "Retry-After": "2", "Cache-Control": "no-store" },
-  });
-}
-
-async function prepareDownload(input: DownloadPreparationInput, signal: AbortSignal) {
-  // A proxy candidate for the same original must not repeat the same slow
-  // upstream request through our own server (and create another HTTP timeout).
-  const sources = [...new Set(input.urls.map(url => {
-    const source = extractImageProxySourceUrl(url) || url;
-    return inferOriginalImageUrl(source) || source;
-  }))];
-  let lastError: unknown;
-  for (let attempt = 0; attempt < 2; attempt++) {
-    signal.throwIfAborted();
-    for (const url of sources) {
-      signal.throwIfAborted();
-      const result = await fetchCanvasDownloadAsset({
-        file: { url, name: "original" }, index: 0,
-        requestOrigin: input.requestOrigin, cookie: input.cookie,
-        includeSequencePrefix: false, timeoutMs: 60_000, retryCount: 1, signal,
-      });
-      if (result.ok) return { buffer: result.bytes, contentType: result.contentType };
-      lastError = result.error;
-    }
-    // Each pass resolves the latest archive URL inside fetchCanvasDownloadAsset.
-    // No AI/model request is involved and a completed source fetch is shared.
-    if (attempt < 1 && getDownloadFailure(lastError).retryable) await new Promise(resolve => setTimeout(resolve, 1_000));
-    else break;
-  }
-  throw new Error(String(lastError || "Original image sources unavailable"));
-}
 
 function getRequestOrigin(request: NextRequest): string {
   const forwardedHost = (request.headers.get("x-forwarded-host") || "").split(",")[0]?.trim();
@@ -98,63 +46,21 @@ function resolveDownloadUrls(body: Record<string, unknown>, origin: string): str
 }
 
 export async function POST(request: NextRequest) {
-  const requestId = randomUUID();
   try {
     const session = await auth();
     if (!session?.user?.id) {
-      return failed(getDownloadFailure("未登录"), requestId);
+      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
     }
 
     const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
     const requestOrigin = getRequestOrigin(request);
-    const candidates = resolveDownloadUrls(body, requestOrigin);
+    const urls = resolveDownloadUrls(body, requestOrigin);
-    if (candidates.length && candidates.every(isRetiredStorageUrl)) {
-      return failed(getDownloadFailure(RETIRED_STORAGE_MESSAGE), requestId);
-    }
-    const urls = candidates.filter(url => !isRetiredStorageUrl(url));
-    const requestedUrls = [...urls];
     if (urls.length === 0) {
-      return failed(getDownloadFailure("图片地址无效"), requestId);
+      return NextResponse.json({ success: false, error: "图片地址无效" }, { status: 400 });
     }
 
     const name = sanitizeCanvasDownloadFileName(String(body.name || ""), "canvas-image");
-    if (body.preferDirect === true) {
-      const { task, direct, canPrepareDirect } = await resolveCanvasCdnDownload(urls, `${name}.png`).catch((error) => {
-        logger.warn("cdn_lookup_failed", error, { requestId });
-        return { task: null, direct: null, canPrepareDirect: false };
-      });
-      if (direct) return NextResponse.json(direct, { headers: { "Cache-Control": "no-store" } });
-      if (task && canPrepareDirect && body.preparation === "async") {
-        const asset = (task.metadata as { downloadAsset?: { status?: string; failure?: DownloadFailure; retryAt?: string } } | null)?.downloadAsset;
-        if (asset?.status === "abandoned" || (asset?.status === "failed" && Date.parse(asset.retryAt || "") > Date.now())) {
-          return failed(asset.failure || getDownloadFailure(null), task.id);
-        }
-        scheduleImageDownloadPreparation(task.id);
-        return preparing(task.id);
-      }
-      if (task?.targetUrl) {
-        if (!urls.includes(task.targetUrl)) urls.unshift(task.targetUrl);
-        scheduleImageDownloadPreparation(task.id);
-      }
-    }
     const cookie = request.headers.get("cookie") || "";
-    if (body.preparation === "async") {
-      const result = await getDownloadPreparationQueue(prepareDownload, after).request({
-        userId: session.user.id, urls: requestedUrls, requestOrigin, cookie,
-      });
-      if (result.status === "preparing") {
-        return preparing(result.requestId);
-      }
-      if (result.status === "failed") {
-        return failed(result.failure, result.requestId);
-      }
-      return new NextResponse(new Uint8Array(result.asset.buffer), { headers: {
-        "Content-Type": result.asset.contentType,
-        "Content-Length": String(result.asset.buffer.length),
-        "Content-Disposition": buildAttachmentContentDisposition(`${name}.png`),
-        "Cache-Control": "no-store",
-      } });
-    }
     let result: Awaited<ReturnType<typeof fetchCanvasDownloadAsset>> | null = null;
     const failures: string[] = [];
 
@@ -167,14 +73,17 @@ export async function POST(request: NextRequest) {
         includeSequencePrefix: false,
       });
       if (result.ok) break;
-      failures.push(result.error);
+      failures.push(`${url}: ${result.error}`);
     }
 
     if (!result?.ok) {
       if (failures.length > 0) {
-        logger.warn("all_sources_failed", { requestId, failures });
+        console.warn("[CanvasDownloadImage] All candidates failed:", failures);
       }
-      return failed(getDownloadFailure(result?.error), requestId);
+      return NextResponse.json(
+        { success: false, error: result?.error || "图片源文件暂时不可访问" },
+        { status: 502 }
+      );
     }
 
     return new NextResponse(result.bytes, {
@@ -187,7 +96,7 @@ export async function POST(request: NextRequest) {
       },
     });
   } catch (error) {
-    logger.error("download_failed", error, { requestId });
+    console.error("[CanvasDownloadImage] Failed:", error);
-    return failed(getDownloadFailure(error), requestId);
+    return NextResponse.json({ success: false, error: "图片下载失败" }, { status: 500 });
   }
 }

app/api/canvas/download-zip-task/route.ts

@@ -1,24 +1,54 @@
-import { writeDownloadZip, readDownloadZip } from "@/lib/canvas/download-zip-stream";
-import { claimZipTask, loadZipTask, saveZipTask, zipTaskPath, assertZipDiskSpace, cleanupZipTasks, assertZipTaskCapacity, type ZipTask } from "@/lib/canvas/download-zip-task-store";
-import { parseDownloadByteRange } from "@/lib/canvas/download-byte-range";
-import { createReadStream } from "node:fs";
-import { mkdir, stat, writeFile, rm } from "node:fs/promises";
-import { join } from "node:path";
 import { randomUUID } from "node:crypto";
-import { after, NextRequest, NextResponse } from "next/server";
+import { NextRequest, NextResponse } from "next/server";
 import JSZip from "jszip";
 import { auth } from "@/app/(auth)/auth";
 import { fetchCanvasDownloadAsset } from "@/lib/canvas/photoshop-safe-download";
-import { publishCanvasZip } from "@/lib/storage/canvas-zip-delivery";
+
-import { trackRuntimeWork } from "@/lib/observability/active-work";
 export const runtime = "nodejs";
 export const maxDuration = 300;
-type DownloadFileItem = { url: string; name?: string };
+
+type DownloadFileItem = {
+  url: string;
+  name?: string;
+};
+
+type ZipTaskStatus = "pending" | "running" | "completed" | "failed";
+
+type ZipTask = {
+  id: string;
+  userId: string;
+  folderName: string;
+  files: DownloadFileItem[];
+  totalCount: number;
+  processedCount: number;
+  successCount: number;
+  failedCount: number;
+  compressPercent: number;
+  status: ZipTaskStatus;
+  stage: string;
+  error?: string;
+  zipBuffer?: Buffer;
+  contentDisposition?: string;
+  createdAt: number;
+  updatedAt: number;
+  expiresAt: number;
+};
+
+const MAX_CONCURRENCY = 8;
 const MAX_DOWNLOAD_FILES = 200;
-const TASK_TTL_MS = 24 * 60 * 60_000;
+const TASK_TTL_MS = 30 * 60 * 1000;
-const PREPARATION_TTL_MS = 6 * 60 * 60_000;
+
-const running = (globalThis as typeof globalThis & { __canvasZipRunning?: Set<string> });
+const globalTaskStore = globalThis as typeof globalThis & {
-const active = running.__canvasZipRunning ??= new Set<string>();
+  __canvasDownloadZipTasks?: Map<string, ZipTask>;
+};
+
+function getTaskStore() {
+  if (!globalTaskStore.__canvasDownloadZipTasks) {
+    globalTaskStore.__canvasDownloadZipTasks = new Map<string, ZipTask>();
+  }
+  return globalTaskStore.__canvasDownloadZipTasks;
+}
+
 function sanitizeFolderName(value: string): string {
   const cleaned = String(value || "")
     .replace(/[\\/:*?"<>|]+/g, "-")
@@ -26,7 +56,7 @@ function sanitizeFolderName(value: string): string {
     .replace(/-+/g, "-")
     .replace(/^-+|-+$/g, "")
     .trim();
-  return cleaned && !/^\.+$/.test(cleaned) ? cleaned.slice(0, 100) : `canvas-images-${Date.now()}`;
+  return cleaned || `canvas-images-${Date.now()}`;
 }
 
 function buildContentDisposition(folderName: string): string {
@@ -80,172 +110,258 @@ function toDownloadItems(input: unknown, origin: string): DownloadFileItem[] {
     .slice(0, MAX_DOWNLOAD_FILES);
 }
 
+function cleanupExpiredTasks() {
+  const now = Date.now();
+  const store = getTaskStore();
+  for (const [taskId, task] of store.entries()) {
+    if (task.expiresAt <= now) {
+      store.delete(taskId);
+    }
+  }
+}
+
+function getTaskProgress(task: ZipTask) {
+  if (task.status === "completed") {
+    return 100;
+  }
+  if (task.status === "failed") {
+    return Math.max(
+      0,
+      Math.min(100, Math.round((task.processedCount / Math.max(1, task.totalCount)) * 85))
+    );
+  }
+  if (task.processedCount >= task.totalCount && task.totalCount > 0) {
+    return Math.min(99, 85 + Math.round((task.compressPercent / 100) * 14));
+  }
+  return Math.max(
+    4,
+    Math.min(85, Math.round((task.processedCount / Math.max(1, task.totalCount)) * 85))
+  );
+}
 
 function serializeTask(task: ZipTask) {
-  return { id: task.id, folderName: task.folderName, status: task.status, stage: task.stage,
+  const downloadUrl =
-    totalCount: task.totalCount, processedCount: task.processedCount, successCount: task.successCount,
+    task.status === "completed"
-    failedCount: task.failedCount, progress: task.status === "completed" ? 100 : Math.min(99,
+      ? `/api/canvas/download-zip-task?taskId=${encodeURIComponent(task.id)}&download=1`
-      Math.round(task.processedCount / Math.max(1, task.totalCount) * 85 + task.compressPercent * .14)),
+      : "";
-    error: task.error || "", expiresAt: task.expiresAt,
+  return {
-    downloadUrl: task.status === "completed" ? `/api/canvas/download-zip-task?taskId=${task.id}&download=1` : "" };
+    id: task.id,
+    folderName: task.folderName,
+    status: task.status,
+    stage: task.stage,
+    totalCount: task.totalCount,
+    processedCount: task.processedCount,
+    successCount: task.successCount,
+    failedCount: task.failedCount,
+    progress: getTaskProgress(task),
+    error: task.error || "",
+    downloadUrl,
+    createdAt: task.createdAt,
+    updatedAt: task.updatedAt,
+    expiresAt: task.expiresAt,
+  };
 }
-async function processTask(id: string, userId: string, requestOrigin: string, cookie: string) {
+
-  if (active.has(id) || active.size >= 2) return;
+async function processZipTask(params: {
-  active.add(id);
+  task: ZipTask;
-  let release: (() => Promise<void>) | null = null;
+  requestOrigin: string;
-  let task: ZipTask | null = null;
+  cookie: string;
+}) {
+  const { task, requestOrigin, cookie } = params;
+  const store = getTaskStore();
   try {
-    release = await claimZipTask(id);
+    task.status = "running";
-    if (!release) return;
+    task.stage = "正在读取源图";
-    task = await loadZipTask(id, userId);
+    task.updatedAt = Date.now();
-    if (!task || task.status === "completed" || task.status === "failed") return;
+
-    await assertZipDiskSpace();
+    const zip = new JSZip();
-    const existingZip = task.zipFile && task.contentDisposition && await stat(task.zipFile.path).catch(() => null);
+    const folder = zip.folder(task.folderName) || zip;
-    const reuseZip = existingZip && existingZip.size === task.zipFile!.bytes;
+    const results: Array<
-    task.status = "running"; task.stage = reuseZip ? "正在准备加速下载" : "正在准备原图"; task.updatedAt = Date.now();
+      | Awaited<ReturnType<typeof fetchCanvasDownloadAsset>>
-    await saveZipTask(task);
+      | null
-    if (!reuseZip) {
+    > = new Array(task.files.length).fill(null);
-      delete task.zipFile; delete task.contentDisposition; delete task.cdnUrl;
+    let cursor = 0;
-      // Stage each image on disk, not all PNG buffers in the web process heap.
+    const workerCount = Math.min(MAX_CONCURRENCY, task.files.length);
-      // A restart resumes from these files using the current owner's session.
+
-      let cursor = 0;
+    await Promise.all(
-      let writes = Promise.resolve();
+      Array.from({ length: workerCount }, async () => {
-      const persist = () => { const current = task!; writes = writes.then(() => saveZipTask(current)); return writes; };
+        while (true) {
-      const results = await Promise.allSettled(Array.from({ length: Math.min(2, task.files.length) }, async () => {
+          const index = cursor;
-        while (cursor < task!.files.length) {
+          cursor += 1;
-          const index = cursor++; const file = task!.files[index];
+          if (index >= task.files.length) break;
-          const path = join(zipTaskPath(id), `${index}.image`);
+
-          if (file.prepared && file.filename && (await stat(path).catch(() => null))?.size) continue;
+          const file = task.files[index]!;
-          delete file.prepared; delete file.filename;
+          results[index] = await fetchCanvasDownloadAsset({
-          const result = await fetchCanvasDownloadAsset({ file, index, requestOrigin, cookie,
+            file,
-            signal: AbortSignal.timeout(120_000) }).catch(() => ({ ok: false as const, error: "原图读取超时或源地址暂时不可用" }));
+            index,
-          if (result.ok) {
+            requestOrigin,
-            await assertZipDiskSpace(result.bytes.length);
+            cookie,
-            await writeFile(path, result.bytes, { mode: 0o600 });
+          });
-            file.prepared = `${index}.image`; file.filename = result.filename; delete file.error;
+
-          } else file.error = result.error;
+          const result = results[index];
-          task!.processedCount = task!.files.filter(f => f.prepared || f.error).length;
+          task.processedCount += 1;
-          task!.successCount = task!.files.filter(f => f.prepared).length;
+          if (result?.ok) {
-          task!.failedCount = task!.files.filter(f => f.error).length;
+            task.successCount += 1;
-          task!.stage = `正在准备原图 ${task!.processedCount}/${task!.totalCount}`;
+          } else {
-          task!.updatedAt = Date.now(); await persist();
+            task.failedCount += 1;
+          }
+          task.stage = `正在处理 ${task.processedCount}/${task.totalCount} 张`;
+          task.updatedAt = Date.now();
         }
-      }));
+      })
-      const rejected = results.find(result => result.status === "rejected");
+    );
-      if (rejected?.status === "rejected") throw rejected.reason;
+
-      if (!task.successCount) throw new Error("所选原图暂时都无法读取，请稍后重试；画布图片不会被删除");
+    const failures: Array<{ index: number; url: string; name?: string; error: string }> = [];
-      const zip = new JSZip(); const folder = zip.folder(task.folderName) || zip;
+    for (const [index, item] of results.entries()) {
-      for (const file of task.files) if (file.prepared && file.filename)
+      if (!item || !item.ok) {
-        folder.file(file.filename, createReadStream(join(zipTaskPath(id), file.prepared))
+        failures.push({
-          .once("close", () => { void rm(join(zipTaskPath(id), file.prepared!), { force: true }).catch(() => undefined); }));
+          index: index + 1,
-      if (task.failedCount) folder.file("_download-failures.txt", task.files.filter(f => f.error)
+          url: item?.ok === false ? item.url : task.files[index]?.url || "",
-        .map(f => `${f.name || "图片"}：${f.error}`).join("\n"));
+          name: item?.ok === false ? item.name : task.files[index]?.name,
-      task.stage = "正在生成完整 ZIP 文件"; await saveZipTask(task);
+          error: item?.ok === false ? item.error : "未知错误",
-      task.zipFile = await writeDownloadZip(zip, task.id, percent => { task!.compressPercent = percent; });
+        });
-      task.contentDisposition = buildContentDisposition(task.folderName);
+        continue;
-    }
-    task.stage = "正在准备下载链接"; await saveZipTask(task);
-    const cdn = await publishCanvasZip({ id: task.id, ...task.zipFile!, disposition: task.contentDisposition!,
-      onProgress: async bytes => {
-        task!.stage = `正在传送至七牛 ${Math.round(bytes / task!.zipFile!.bytes * 100)}%`;
-        task!.updatedAt = Date.now(); await saveZipTask(task!);
-      } });
-    if (cdn) {
-      task.cdnObject = { storageConfigId: cdn.storageConfigId, key: cdn.key };
-      if (!cdn.url) throw new Error(cdn.error || `ZIP 已打包，但加速下载未就绪，请再次点击下载继续传送原 ZIP。下载编号：${task.id}`);
-      task.cdnUrl = cdn.url;
-    }
-    task.status = "completed"; task.stage = task.failedCount ? `已打包 ${task.successCount} 张，${task.failedCount} 张未能读取` : "打包完成";
-    task.compressPercent = 100; task.updatedAt = Date.now(); task.expiresAt = Date.now() + TASK_TTL_MS;
-    await saveZipTask(task);
-    // The complete ZIP is enough for retries; release staged duplicate bytes.
-    await Promise.all(task.files.filter(f => f.prepared).map(f => rm(join(zipTaskPath(id), f.prepared!), { force: true }).catch(() => undefined)));
-    console.info("[CanvasDownloadZipTask] Complete", { taskId: id, count: task.successCount, failed: task.failedCount,
-      bytes: task.zipFile!.bytes, delivery: task.cdnUrl ? "cdn" : "local" });
-  } catch (error) {
-    if (task) {
-      task.status = "failed"; task.stage = task.zipFile ? "ZIP 已打包，加速下载未就绪" : "打包未完成";
-      task.error = error instanceof Error ? error.message : "打包失败，请稍后重试";
-      task.updatedAt = Date.now(); task.expiresAt = Date.now() + TASK_TTL_MS; await saveZipTask(task).catch(() => undefined);
-    }
-    console.error("[CanvasDownloadZipTask] Preparation failed", { taskId: id, message: task?.error });
-  } finally { await release?.().catch(() => undefined); active.delete(id); }
-}
-function schedule(task: ZipTask, request: NextRequest) {
-  const run = () => trackRuntimeWork(() => processTask(task.id, task.userId, getRequestOrigin(request), request.headers.get("cookie") || ""));
-  after(run);
-}
-export async function POST(request: NextRequest) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    const body = await request.json();
-    let id = typeof body.taskId === "string" ? body.taskId : randomUUID();
-    let task = await loadZipTask(id, session.user.id);
-    if (!task) {
-      await assertZipTaskCapacity(session.user.id);
-      if (await stat(zipTaskPath(id)).catch(() => null)) id = randomUUID();
-      const files = toDownloadItems(body.files, getRequestOrigin(request));
-      if (!files.length || !Array.isArray(body.files) || body.files.length > MAX_DOWNLOAD_FILES || files.length !== body.files.length)
-        return NextResponse.json({ error: "请选择 1 到 200 张可下载图片" }, { status: 400 });
-      // Exclusive creation prevents an arbitrary taskId from overwriting another owner's manifest.
-      await mkdir(zipTaskPath(id), { recursive: false, mode: 0o700 }).catch(async error => {
-        if (error.code !== "ENOENT") throw error;
-        await mkdir((await import("@/lib/canvas/download-zip-stream")).downloadZipDirectory, { recursive: true, mode: 0o700 });
-        await mkdir(zipTaskPath(id), { mode: 0o700 });
-      });
-      const now = Date.now();
-      task = { id, userId: session.user.id, folderName: sanitizeFolderName(String(body.folderName || "")), files,
-        totalCount: files.length, processedCount: 0, successCount: 0, failedCount: 0, compressPercent: 0,
-        status: "pending", stage: "等待后台准备", createdAt: now, updatedAt: now, expiresAt: now + PREPARATION_TTL_MS };
-      await saveZipTask(task);
-    } else if ((task.status === "failed" || task.status === "completed" && task.cdnObject && !task.cdnUrl) && body.retry === true) {
-      task.status = "pending"; task.error = undefined;
-      await assertZipTaskCapacity(session.user.id);
-      if (!task.zipFile) {
-        for (const file of task.files) delete file.error;
-        task.processedCount = task.successCount = task.files.filter(file => file.prepared).length;
-        task.failedCount = 0;
       }
-      task.updatedAt = Date.now(); task.expiresAt = Date.now() + PREPARATION_TTL_MS;
+      folder.file(item.filename, item.bytes);
-      await saveZipTask(task);
     }
-    if (task.status === "pending" || task.status === "running") schedule(task, request);
+
-    after(() => cleanupZipTasks().catch(() => { console.warn("[CanvasDownloadZipTask] Expired file cleanup deferred"); }));
+    if (failures.length > 0) {
-    return NextResponse.json({ success: true, task: serializeTask(task) }, { status: 202, headers: { "Cache-Control": "no-store" } });
+      folder.file(
+        "_download-failures.txt",
+        [
+          "以下图片暂时无法下载。可稍后重试，或复制链接检查源图是否仍可访问。",
+          "",
+          ...failures.map((item) => {
+            const label = item.name ? `${item.index}. ${item.name}` : `${item.index}. image`;
+            return `${label}\nURL: ${item.url}\n原因: ${item.error}`;
+          }),
+        ].join("\n\n")
+      );
+      console.warn("[CanvasDownloadZipTask] Partial download failures:", failures);
+    }
+
+    task.stage = "正在生成 ZIP 文件";
+    task.updatedAt = Date.now();
+    task.zipBuffer = await zip.generateAsync(
+      {
+        type: "nodebuffer",
+        compression: "DEFLATE",
+        compressionOptions: { level: 6 },
+      },
+      (metadata) => {
+        task.compressPercent = Math.max(0, Math.min(100, metadata.percent || 0));
+        task.updatedAt = Date.now();
+      }
+    );
+    task.contentDisposition = buildContentDisposition(task.folderName);
+    task.status = "completed";
+    task.stage = "打包完成";
+    task.compressPercent = 100;
+    task.updatedAt = Date.now();
+    task.expiresAt = Date.now() + TASK_TTL_MS;
   } catch (error) {
-    console.warn("[CanvasDownloadZipTask] Create rejected", { message: (error as Error).message });
+    console.error("[CanvasDownloadZipTask] Failed:", error);
-    return NextResponse.json({ error: "无法创建打包任务，请稍后重试" }, { status: 400 });
+    task.status = "failed";
+    task.stage = "打包失败";
+    task.error = error instanceof Error ? error.message : "打包下载失败";
+    task.updatedAt = Date.now();
+    task.expiresAt = Date.now() + TASK_TTL_MS;
+  } finally {
+    store.set(task.id, task);
   }
 }
-export async function GET(request: NextRequest) {
+
-  const session = await auth();
+export async function POST(request: NextRequest) {
-  if (!session?.user?.id) return NextResponse.json({ error: "未登录" }, { status: 401 });
   try {
-    const id = request.nextUrl.searchParams.get("taskId") || "";
+    cleanupExpiredTasks();
-    const task = await loadZipTask(id, session.user.id);
+    const session = await auth();
-    if (!task) return NextResponse.json({ error: "打包任务不存在或已过期，请重新打包" }, { status: 404 });
+    if (!session?.user?.id) {
-    if (request.nextUrl.searchParams.get("download") === "1") {
+      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-      if (task.status !== "completed" || !task.zipFile) return NextResponse.json({ error: "ZIP 尚未准备好" }, { status: 409 });
-      if (task.cdnUrl && request.nextUrl.searchParams.get("local") !== "1")
-        return NextResponse.redirect(task.cdnUrl, 307);
-      const info = await stat(task.zipFile.path).catch(() => null);
-      if (!info || info.size !== task.zipFile.bytes) return NextResponse.json({ error: "下载文件已过期，请重新打包" }, { status: 410 });
-      const etag = `"${task.id}-${info.size}"`;
-      const headers: Record<string, string> = { "Content-Type": "application/zip", "Content-Disposition": task.contentDisposition!,
-        "Accept-Ranges": "bytes", "ETag": etag, "Cache-Control": "private, no-store",
-        "X-Download-Success-Count": String(task.successCount), "X-Download-Failed-Count": String(task.failedCount) };
-      const ifRange = request.headers.get("if-range");
-      let range;
-      try { range = parseDownloadByteRange(!ifRange || ifRange === etag ? request.headers.get("range") : null, info.size); }
-      catch { return new NextResponse(null, { status: 416, headers: { ...headers, "Content-Range": `bytes */${info.size}` } }); }
-      headers["Content-Length"] = String(range ? range.end - range.start + 1 : info.size);
-      if (range) headers["Content-Range"] = `bytes ${range.start}-${range.end}/${info.size}`;
-      return new NextResponse(readDownloadZip(task.zipFile.path, range || undefined), { status: range ? 206 : 200, headers });
     }
-    if (task.status === "pending" || task.status === "running") schedule(task, request);
+
-    return NextResponse.json({ success: true, task: serializeTask(task) }, { headers: { "Cache-Control": "no-store" } });
+    const body = (await request.json().catch(() => ({}))) as Record<string, unknown>;
-  } catch {
+    const requestOrigin = getRequestOrigin(request);
-    return NextResponse.json({ error: "查询打包任务失败，请稍后重试" }, { status: 500 });
+    const files = toDownloadItems(body.files, requestOrigin);
+    const folderName = sanitizeFolderName(String(body.folderName || ""));
+    if (files.length === 0) {
+      return NextResponse.json({ success: false, error: "没有可下载的图片" }, { status: 400 });
+    }
+
+    const task: ZipTask = {
+      id: randomUUID(),
+      userId: session.user.id,
+      folderName,
+      files,
+      totalCount: files.length,
+      processedCount: 0,
+      successCount: 0,
+      failedCount: 0,
+      compressPercent: 0,
+      status: "pending",
+      stage: "等待服务端开始打包",
+      createdAt: Date.now(),
+      updatedAt: Date.now(),
+      expiresAt: Date.now() + TASK_TTL_MS,
+    };
+    getTaskStore().set(task.id, task);
+
+    void processZipTask({
+      task,
+      requestOrigin,
+      cookie: request.headers.get("cookie") || "",
+    });
+
+    return NextResponse.json({
+      success: true,
+      task: serializeTask(task),
+    });
+  } catch (error) {
+    console.error("[CanvasDownloadZipTask] Create failed:", error);
+    return NextResponse.json({ success: false, error: "创建打包任务失败" }, { status: 500 });
+  }
+}
+
+export async function GET(request: NextRequest) {
+  try {
+    cleanupExpiredTasks();
+    const session = await auth();
+    if (!session?.user?.id) {
+      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+    }
+
+    const taskId = String(request.nextUrl.searchParams.get("taskId") || "").trim();
+    if (!taskId) {
+      return NextResponse.json({ success: false, error: "缺少任务 ID" }, { status: 400 });
+    }
+
+    const task = getTaskStore().get(taskId);
+    if (!task || task.userId !== session.user.id) {
+      return NextResponse.json({ success: false, error: "打包任务不存在或已过期" }, { status: 404 });
+    }
+
+    if (request.nextUrl.searchParams.get("download") === "1") {
+      if (task.status !== "completed" || !task.zipBuffer) {
+        return NextResponse.json({ success: false, error: "ZIP 文件尚未准备好" }, { status: 409 });
+      }
+      return new NextResponse(task.zipBuffer, {
+        status: 200,
+        headers: {
+          "Content-Type": "application/zip",
+          "Content-Disposition": task.contentDisposition || buildContentDisposition(task.folderName),
+          "Content-Length": String(task.zipBuffer.length),
+          "Cache-Control": "no-store",
+          "X-Download-Success-Count": String(task.successCount),
+          "X-Download-Failed-Count": String(task.failedCount),
+        },
+      });
+    }
+
+    return NextResponse.json({
+      success: true,
+      task: serializeTask(task),
+    });
+  } catch (error) {
+    console.error("[CanvasDownloadZipTask] Query failed:", error);
+    return NextResponse.json({ success: false, error: "查询打包任务失败" }, { status: 500 });
   }
 }

app/api/canvas/download-zip/route.ts

@@ -1,4 +1,3 @@
-import { streamDownloadZip } from "@/lib/canvas/download-zip-stream";
 import { NextRequest, NextResponse } from "next/server";
 import JSZip from "jszip";
 import { auth } from "@/app/(auth)/auth";
@@ -160,7 +159,13 @@ export async function POST(request: NextRequest) {
       console.warn("[CanvasDownloadZip] Partial download failures:", failures);
     }
 
-    return new NextResponse(streamDownloadZip(zip), {
+    const zipBuffer = await zip.generateAsync({
+      type: "nodebuffer",
+      compression: "DEFLATE",
+      compressionOptions: { level: 6 },
+    });
+
+    return new NextResponse(zipBuffer, {
       status: 200,
       headers: {
         "Content-Type": "application/zip",

app/api/canvas/generate/image/route.ts

@@ -1,11 +1,84 @@
-import { executeCanvasImageResponse } from "@/lib/canvas/generate-image-response";
 import { NextResponse } from "next/server";
 import { auth } from "@/app/(auth)/auth";
-import { getCanvasImageTaskForUser } from "@/lib/canvas/image-task-queue";
+import {
-import { formatRequestFailure, getRequestFailureDetails } from "@/lib/request-error";
+  createCanvasImageTask,
+  enqueueCanvasImageTask,
+  getCanvasImageTaskForUser,
+  getCanvasDetailReplacementTasksForUserContext,
+} from "@/lib/canvas/image-task-queue";
+import {
+  generateCanvasImage,
+  type CanvasGenerateImageRequest,
+} from "@/lib/canvas/generate-image";
+import { getPointsSystemConfig } from "@/lib/db/queries";
+import { prepareFeaturePointsCharge } from "@/lib/points/feature-charge";
+import {
+  getImageToolCreditCost,
+  type ImageToolCreditFeature,
+} from "@/lib/points/config";
 
 export const maxDuration = 1200;
 
+interface GenerateImageRequest extends CanvasGenerateImageRequest {
+  async?: boolean;
+}
+
+function normalizeBillingFeature(
+  value: unknown
+): Extract<ImageToolCreditFeature, "multi-view" | "repaint"> | null {
+  if (value === "multi-view" || value === "repaint") return value;
+  return null;
+}
+
+function toGenerateImagePayload(body: GenerateImageRequest): CanvasGenerateImageRequest {
+  const requestedQuality =
+    body.providerImageParams &&
+    typeof body.providerImageParams === "object" &&
+    !Array.isArray(body.providerImageParams)
+      ? String(body.providerImageParams.quality || "").trim().toLowerCase()
+      : "";
+  return {
+    prompt: String(body.prompt || "").trim(),
+    displayPrompt:
+      typeof body.displayPrompt === "string" ? body.displayPrompt : undefined,
+    negativePrompt:
+      typeof body.negativePrompt === "string" ? body.negativePrompt : undefined,
+    model: typeof body.model === "string" ? body.model : undefined,
+    aspectRatio:
+      typeof body.aspectRatio === "string" && body.aspectRatio.trim()
+        ? body.aspectRatio.trim()
+        : "auto",
+    imageSize:
+      typeof body.imageSize === "string" && body.imageSize.trim()
+        ? body.imageSize.trim()
+        : undefined,
+    imageCount:
+      typeof body.imageCount === "number" && Number.isFinite(body.imageCount)
+        ? body.imageCount
+        : 1,
+    promptExtend:
+      typeof body.promptExtend === "boolean" ? body.promptExtend : undefined,
+    providerImageParams: new Set(["low", "medium", "high"]).has(
+      requestedQuality,
+    )
+      ? { quality: requestedQuality }
+      : undefined,
+    referenceImage:
+      typeof body.referenceImage === "string" ? body.referenceImage : undefined,
+    referenceImages: Array.isArray(body.referenceImages)
+      ? body.referenceImages.map((item) => String(item || "").trim()).filter(Boolean)
+      : [],
+    debugLabel:
+      typeof body.debugLabel === "string" ? body.debugLabel : undefined,
+    debugMeta:
+      body.debugMeta &&
+      typeof body.debugMeta === "object" &&
+      !Array.isArray(body.debugMeta)
+        ? body.debugMeta
+        : undefined,
+  };
+}
+
 export async function GET(request: Request) {
   try {
     const session = await auth();
@@ -15,8 +88,24 @@ export async function GET(request: Request) {
 
     const { searchParams } = new URL(request.url);
     const taskId = String(searchParams.get("taskId") || "").trim();
+    const chatId = String(searchParams.get("chatId") || "").trim();
+    const projectId = String(searchParams.get("projectId") || "").trim();
+    if (!taskId && chatId) {
+      const tasks = await getCanvasDetailReplacementTasksForUserContext({
+        userId: session.user.id,
+        chatId,
+        projectId: projectId || null,
+      });
+      return NextResponse.json({
+        success: true,
+        tasks,
+      });
+    }
     if (!taskId) {
-      return NextResponse.json({ success: false, error: "缺少 taskId 参数" }, { status: 400 });
+      return NextResponse.json(
+        { success: false, error: "缺少 taskId 参数" },
+        { status: 400 }
+      );
     }
 
     const task = await getCanvasImageTaskForUser({ taskId, userId: session.user.id });
@@ -24,15 +113,13 @@ export async function GET(request: Request) {
       return NextResponse.json({ success: false, error: "任务不存在" }, { status: 404 });
     }
 
-    const failure = task.status === "failed" ? getRequestFailureDetails(task.error) : undefined;
     return NextResponse.json({
       success: true,
       task: {
         id: task.id,
         status: task.status,
         attempts: task.attempts,
-        error: failure ? formatRequestFailure(failure, task.id) : null,
+        error: task.error || null,
-        failure,
         result: task.result || null,
         createdAt: task.createdAt,
         startedAt: task.startedAt,
@@ -47,15 +134,105 @@ export async function GET(request: Request) {
         success: false,
         error: error instanceof Error ? error.message : "查询任务失败",
       },
-      { status: 500 },
+      { status: 500 }
     );
   }
 }
 
 export async function POST(request: Request) {
-  const session = await auth();
+  try {
-  if (!session?.user?.id)
+    const session = await auth();
-    return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
+    if (!session?.user?.id) {
-  const body = await request.json().catch(() => ({}));
+      return NextResponse.json(
-  return executeCanvasImageResponse(body, session.user.id);
+        { success: false, error: "未登录" },
+        { status: 401 }
+      );
+    }
+
+    const body: GenerateImageRequest = await request.json();
+    const payload: CanvasGenerateImageRequest = {
+      ...toGenerateImagePayload(body),
+      ownerKey: session.user.id,
+    };
+    if (!payload.prompt) {
+      return NextResponse.json(
+        { success: false, error: "请输入提示词" },
+        { status: 400 }
+      );
+    }
+
+    const billingFeature = normalizeBillingFeature(body.billingFeature);
+    const pointsCharge = billingFeature
+      ? await (async () => {
+          const pointsConfig = await getPointsSystemConfig();
+          return prepareFeaturePointsCharge({
+            userId: session.user.id,
+            unitCost: getImageToolCreditCost(pointsConfig, billingFeature),
+            reason:
+              billingFeature === "multi-view"
+                ? "image_multi_view"
+                : "image_repaint",
+            modelId: "canvas-generate-image",
+            note:
+              billingFeature === "multi-view"
+                ? "图片多视角生成消耗积分"
+                : "图片重绘消耗积分",
+            pointsConfig,
+          });
+        })()
+      : null;
+    if (pointsCharge && !pointsCharge.ok) {
+      return NextResponse.json(pointsCharge.payload, { status: pointsCharge.status });
+    }
+
+    const asyncMode = body.async === true;
+    if (asyncMode) {
+      const task = await createCanvasImageTask({
+        userId: session.user.id,
+        request: payload as unknown as Record<string, unknown>,
+      });
+      await enqueueCanvasImageTask(task.id);
+      const currentTask = await getCanvasImageTaskForUser({
+        taskId: task.id,
+        userId: session.user.id,
+      });
+      if (pointsCharge?.chargeable) {
+        try {
+          await pointsCharge.consume({
+            note:
+              billingFeature === "multi-view"
+                ? `图片多视角生成消耗积分（${task.id}）`
+                : `图片重绘消耗积分（${task.id}）`,
+          });
+        } catch (pointsError) {
+          console.error("[Points] Failed to consume canvas image task points:", pointsError);
+        }
+      }
+      return NextResponse.json({
+        success: true,
+        taskId: task.id,
+        status: currentTask?.status || task.status,
+        queueStatus: currentTask?.queueStatus,
+      });
+    }
+
+    const result = await generateCanvasImage(payload);
+    if (pointsCharge?.chargeable) {
+      try {
+        await pointsCharge.consume();
+      } catch (pointsError) {
+        console.error("[Points] Failed to consume canvas image points:", pointsError);
+      }
+    }
+    return NextResponse.json({
+      success: true,
+      data: result,
+    });
+  } catch (error) {
+    console.error("[Canvas Generate Image] Error:", error);
+    return NextResponse.json(
+      { success: false, error: error instanceof Error ? error.message : "生成失败" },
+      { status: 500 }
+    );
+  }
 }

app/api/canvas/generate/video/route.ts

@@ -1,26 +1,61 @@
+import { and, eq, inArray } from "drizzle-orm";
 import { NextResponse } from "next/server";
 import { auth } from "@/app/(auth)/auth";
 import { executeDirectVideoGeneration } from "@/lib/ai/tools/generate-video";
-import { probeRemoteUrl } from "@/lib/net/url-access";
+import {
-import { validateVideoReferences } from "@/lib/video-canvas/reference-input";
+  resolveVideoReferenceSelectionRule,
+  selectVideoReferenceImages,
+} from "@/lib/canvas/video-reference-selection";
+import { getSystemSetting } from "@/lib/db/queries";
+import { db } from "@/lib/db";
+import { mediaAsset } from "@/lib/db/schema";
+import { filterReachableRemoteUrls } from "@/lib/net/url-access";
+import {
+  VIDEO_CANVAS_FUNCTION_CONFIG_KEY,
+  defaultVideoCanvasFunctionConfig,
+  normalizeVideoCanvasFunctionConfig,
+} from "@/lib/video-canvas/config";
+import { normalizeVideoCanvasGenerationRequestCount } from "@/lib/video-canvas/video-generation-parameters";
+import {
+  buildVideoCanvasSubjectProviderReferences,
+  composeVideoCanvasSubjectPrompt,
+  normalizeVideoCanvasAttachedSubjects,
+  supportsVideoCanvasSubjectUsage,
+  toVideoCanvasAttachedSubject,
+  VIDEO_CANVAS_SUBJECT_SOURCE_TYPE,
+  type VideoCanvasAttachedSubject,
+} from "@/lib/video-canvas/subjects";
+import {
+  composeVideoCanvasSmartStoryboardPrompt,
+  normalizeVideoCanvasSmartStoryboard,
+  supportsVideoCanvasSmartStoryboard,
+  validateVideoCanvasSmartStoryboard,
+  type VideoCanvasSmartStoryboard,
+} from "@/lib/video-canvas/smart-storyboard";
 import type { VideoGenerationMode, VideoRatio, VideoResolution } from "@/types/ai";
 
 export const maxDuration = 300;
 
 interface GenerateVideoRequest {
+  autoValidateMaterial?: boolean;
   prompt?: string;
   mode?: VideoGenerationMode;
   images?: string[];
   audioUrls?: string[];
-  generateAudio?: boolean;
   resolution?: VideoResolution;
   ratio?: VideoRatio;
   duration?: number;
+  generateAudio?: boolean;
+  count?: number;
   watermark?: boolean;
   cameraFixed?: boolean;
   seed?: number;
   returnLastFrame?: boolean;
+  modelLabel?: string;
   preferredModelRef?: string;
+  searchEnabled?: boolean;
+  smartStoryboard?: VideoCanvasSmartStoryboard;
+  subjects?: VideoCanvasAttachedSubject[];
 }
 
 function inferMode(images: string[]): VideoGenerationMode {
@@ -42,32 +77,179 @@ export async function POST(request: Request) {
 
     const body = (await request.json().catch(() => ({}))) as GenerateVideoRequest;
     const prompt = String(body.prompt || "").trim();
-    if (!prompt) {
+    const count = normalizeVideoCanvasGenerationRequestCount(body.count, 1);
+    if (count === null) {
+      return NextResponse.json(
+        { success: false, error: "生成数量仅支持 1、2 或 4 个" },
+        { status: 400 },
+      );
+    }
+    const generateAudio = body.generateAudio !== false;
+    const setting = await getSystemSetting({
+      key: VIDEO_CANVAS_FUNCTION_CONFIG_KEY,
+    }).catch(() => null);
+    const config = setting?.value
+      ? normalizeVideoCanvasFunctionConfig(setting.value)
+      : defaultVideoCanvasFunctionConfig;
+    const autoValidateMaterial =
+      typeof body.autoValidateMaterial === "boolean"
+        ? body.autoValidateMaterial
+        : config.videoAdvancedSettings.defaultAutoValidateMaterial;
+    const searchEnabled =
+      typeof body.searchEnabled === "boolean"
+        ? body.searchEnabled
+        : config.videoAdvancedSettings.defaultSearchEnabled;
+    const subjectUsageEnabled = supportsVideoCanvasSubjectUsage(
+      config.subjectLibrary,
+      `${body.modelLabel || ""} ${body.preferredModelRef || ""}`,
+    );
+    const requestedSubjects = subjectUsageEnabled
+      ? normalizeVideoCanvasAttachedSubjects(
+          body.subjects,
+          config.subjectLibrary.videoUsage.maxSubjects,
+        )
+      : [];
+    const requestedSubjectIds = requestedSubjects
+      .map((subject) => subject.id)
+      .filter((id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(id));
+    const ownedSubjectRows = requestedSubjectIds.length > 0
+      ? await db
+          .select({
+            description: mediaAsset.summary,
+            displayName: mediaAsset.displayName,
+            id: mediaAsset.id,
+            metadata: mediaAsset.metadata,
+            originalUrl: mediaAsset.originalUrl,
+            previewUrl: mediaAsset.previewUrl,
+            thumbnailUrl: mediaAsset.thumbnailUrl,
+          })
+          .from(mediaAsset)
+          .where(
+            and(
+              inArray(mediaAsset.id, requestedSubjectIds),
+              eq(mediaAsset.userId, session.user.id),
+              eq(mediaAsset.mediaType, "subject"),
+              eq(mediaAsset.sourceType, VIDEO_CANVAS_SUBJECT_SOURCE_TYPE),
+              eq(mediaAsset.status, "ready"),
+            ),
+          )
+      : [];
+    const ownedSubjectsById = new Map(
+      ownedSubjectRows.map((subject) => [subject.id, subject]),
+    );
+    const subjects = requestedSubjects.flatMap((requestedSubject) => {
+      const ownedSubject = ownedSubjectsById.get(requestedSubject.id);
+      const normalized = ownedSubject
+        ? toVideoCanvasAttachedSubject(ownedSubject)
+        : null;
+      return normalized ? [normalized] : [];
+    });
+    const subjectReferences = buildVideoCanvasSubjectProviderReferences(subjects);
+    const smartStoryboardSupported = supportsVideoCanvasSmartStoryboard(
+      config.smartStoryboard,
+      `${body.modelLabel || ""} ${body.preferredModelRef || ""}`,
+    );
+    const smartStoryboard = normalizeVideoCanvasSmartStoryboard(
+      body.smartStoryboard,
+      {
+        config: config.smartStoryboard,
+        fallbackPrompt: prompt,
+        fallbackTotalDurationSeconds: body.duration,
+      },
+    );
+    const storyboardValidation = validateVideoCanvasSmartStoryboard(
+      smartStoryboard,
+    );
+    if (
+      smartStoryboardSupported &&
+      smartStoryboard.enabled &&
+      !storyboardValidation.valid
+    ) {
+      const message =
+        storyboardValidation.emptyShotIndexes.length > 0
+          ? "智能分镜存在未填写的镜头描述"
+          : storyboardValidation.status === "over"
+            ? "智能分镜总时长超出"
+            : "智能分镜总时长不足";
+      return NextResponse.json(
+        { success: false, error: message },
+        { status: 400 },
+      );
+    }
+    const promptWithStoryboard = smartStoryboardSupported
+      ? composeVideoCanvasSmartStoryboardPrompt(
+          prompt,
+          smartStoryboard,
+          config.smartStoryboard,
+        )
+      : prompt;
+    const generationPrompt = composeVideoCanvasSubjectPrompt(
+      promptWithStoryboard,
+      subjects,
+      config.subjectLibrary.videoUsage.promptTemplate,
+    );
+    if (!generationPrompt) {
       return NextResponse.json(
         { success: false, error: "请输入视频提示词" },
         { status: 400 }
       );
     }
+    const referenceRule = resolveVideoReferenceSelectionRule(
+      config.videoReferenceSelection,
+      `${body.modelLabel || ""} ${body.preferredModelRef || ""}`,
+    );
+    const rawImages = Array.isArray(body.images)
+      ? body.images.map((item) => String(item || "").trim()).filter(Boolean).slice(0, 20)
+      : [];
+    const inputImages = body.mode
+      ? body.mode === "text-to-video" || body.mode === "audio-to-video"
+        ? rawImages.slice(0, 4)
+        : selectVideoReferenceImages(rawImages, body.mode, referenceRule.maxImages)
+      : rawImages.slice(0, referenceRule.maxImages);
+    const { kept: reachableImages, dropped: unreachableImages } =
+      await filterReachableRemoteUrls(inputImages, { timeoutMs: 3000 });
+    const inputAudioUrls = Array.isArray(body.audioUrls)
+      ? body.audioUrls.map((item) => String(item || "").trim()).filter(Boolean).slice(0, 3)
+      : [];
+    const { kept: reachableAudioUrls, dropped: unreachableAudioUrls } =
+      await filterReachableRemoteUrls(inputAudioUrls, { timeoutMs: 3000 });
 
-    const referenceCheck = await validateVideoReferences(body.images, url => probeRemoteUrl(url, { timeoutMs: 8000 }));
+    if (inputImages.length > 0 && reachableImages.length === 0) {
-    if (referenceCheck.error) {
+      return NextResponse.json(
-      return NextResponse.json({ success: false, error: referenceCheck.error }, { status: referenceCheck.status });
+        { success: false, error: "参考图片链接不可访问，请重新上传后再试" },
+        { status: 400 }
+      );
     }
-    const reachableImages = referenceCheck.images;
 
-    const mode = body.mode || inferMode(reachableImages);
+    const mode = body.mode || (reachableAudioUrls.length > 0 ? "audio-to-video" : inferMode(reachableImages));
+    const selectedImages =
+      mode === "text-to-video" || mode === "audio-to-video"
+        ? reachableImages
+        : selectVideoReferenceImages(
+            reachableImages,
+            mode,
+            referenceRule.maxImages,
+          );
+    if (mode === "audio-to-video" && reachableAudioUrls.length === 0) {
+      return NextResponse.json(
+        { success: false, error: "音频生视频至少需要 1 个可访问的音频素材" },
+        { status: 400 }
+      );
+    }
     const result = await executeDirectVideoGeneration({
-      prompt,
+      prompt: generationPrompt,
       mode,
-      audioUrls: Array.isArray(body.audioUrls) ? body.audioUrls.filter(url => typeof url === "string" && /^https?:\/\//i.test(url)).slice(0, 3) : undefined,
+      images: selectedImages,
-      generateAudio: body.generateAudio,
+      audioUrls: reachableAudioUrls,
-      images: reachableImages,
       resolution: body.resolution,
       ratio: body.ratio,
       duration:
-        typeof body.duration === "number" && Number.isFinite(body.duration)
+        smartStoryboardSupported && smartStoryboard.enabled
-          ? body.duration
+          ? smartStoryboard.totalDurationSeconds
-          : undefined,
+          : typeof body.duration === "number" && Number.isFinite(body.duration)
+            ? body.duration
+            : undefined,
+      generateAudio,
       watermark: body.watermark,
       cameraFixed: body.cameraFixed,
       seed:
@@ -88,13 +270,25 @@ export async function POST(request: Request) {
       success: true,
       data: {
         url: result.videoUrl,
-        metadata: { ...result.metadata, temporaryVideoUrl: result.videoUrl, storageStatus: result.metadata?.permanentVideoUrl === result.videoUrl ? "archived" : "temporary" },
+        metadata: result.metadata || null,
         modelDisplayName: result.modelDisplayName,
         modelId: result.modelId,
         modelRef: result.modelRef,
         mode,
-        images: reachableImages,
+        images: selectedImages,
-        droppedImages: [],
+        audioUrls: reachableAudioUrls,
+        autoValidateMaterial,
+        count,
+        generateAudio,
+        droppedImages: unreachableImages,
+        droppedAudioUrls: unreachableAudioUrls,
+        searchEnabled,
+        subjects,
+        subjectReferences,
+        smartStoryboard:
+          smartStoryboardSupported && smartStoryboard.enabled
+            ? smartStoryboard
+            : undefined,
       },
     });
   } catch (error) {

app/api/canvas/generation-tasks/route.ts

@@ -1,130 +0,0 @@
-import { videoUpscaleSchema } from "@/lib/video-canvas/video-upscale-contract";
-import { smartEditRequestSchema } from "@/lib/video-canvas/smart-edit/contract";
-import { audioRequestSchema } from "@/lib/video-canvas/audio-contract";
-import { canResumeCanvasTask } from "@/lib/video-canvas/task-recovery";
-import { imageOperationSchema } from "@/lib/video-canvas/image-operation";
-import { after, NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { z } from "zod";
-import { canvasTaskRequestSchema } from "@/lib/video-canvas/task-contract";
-import {
-  cancelCanvasGenerationTask,
-  createCanvasGenerationTask,
-  listCanvasGenerationTasks,
-  ownsTaskProject,
-} from "@/lib/video-canvas/task-store";
-import { runCanvasGenerationQueue } from "@/lib/video-canvas/task-worker";
-import { preflightCanvasProductionRequests } from "@/lib/video-canvas/production-services";
-export const runtime = "nodejs";
-export const maxDuration = 900;
-
-async function owner(projectId: unknown) {
-  const session = await auth();
-  if (!session?.user?.id) throw Object.assign(Error("未登录"), { status: 401 });
-  if (!z.string().uuid().safeParse(projectId).success)
-    throw Object.assign(Error("画布 ID 无效"), { status: 400 });
-  if (!(await ownsTaskProject(session.user.id, projectId as string)))
-    throw Object.assign(Error("画布不存在"), { status: 404 });
-  return session.user.id;
-}
-const fail = (error: unknown) =>
-  NextResponse.json(
-    { success: false, error: error instanceof Error ? error.message : "任务操作失败", code: (error as any)?.code },
-    { status: Number((error as any)?.status) || (error instanceof SyntaxError ? 400 : 500) },
-  );
-const kick = (userId: string, projectId: string) =>
-  after(() =>
-    runCanvasGenerationQueue(userId, projectId).catch((error) =>
-      console.error("[Canvas tasks]", error),
-    ),
-  );
-export async function POST(request: Request) {
-  try {
-    const text = await request.text();
-    if (new TextEncoder().encode(text).byteLength > 262144)
-      throw Object.assign(Error("任务数据过大，请使用已上传的素材链接"), { status: 413 });
-    const parsed = canvasTaskRequestSchema.safeParse(JSON.parse(text));
-    if (!parsed.success) throw Object.assign(Error("任务参数不合法"), { status: 400 });
-    if(parsed.data.workflow)throw Object.assign(Error("编组任务必须使用整组提交接口"),{status:400});
-    if (
-      parsed.data.kind === "image-operation" &&
-      !imageOperationSchema.safeParse(parsed.data.params).success
-    )
-      throw Object.assign(Error("图片处理参数不合法"), { status: 400 });
-    if (
-      parsed.data.attachment &&
-      ((parsed.data.attachment.type === "story-asset" && parsed.data.kind !== "image") ||
-        (parsed.data.attachment.type === "story-prompts" && parsed.data.kind !== "analysis"))
-    )
-      throw Object.assign(Error("脚本结果类型不匹配"), { status: 400 });
-    if (parsed.data.kind === "audio" && !audioRequestSchema.safeParse(parsed.data.params).success)
-      throw Object.assign(Error("音频参数不合法"), { status: 400 });
-    if (
-      parsed.data.kind === "smart-edit" &&
-      !smartEditRequestSchema.safeParse(parsed.data.params).success
-    )
-      throw Object.assign(Error("剪辑参数无效"), { status: 400 });
-    if (parsed.data.kind === "video-upscale" && !videoUpscaleSchema.safeParse(parsed.data.params).success) throw Object.assign(Error("视频高清参数无效"), {status:400});
-    const userId = await owner(parsed.data.projectId);
-    const task = await createCanvasGenerationTask(userId, parsed.data,
-      () => preflightCanvasProductionRequests([parsed.data]));
-    kick(userId, parsed.data.projectId);
-    return NextResponse.json({ success: true, task }, { status: 202 });
-  } catch (error) {
-    return fail(error);
-  }
-}
-export async function GET(request: Request) {
-  try {
-    const projectId = new URL(request.url).searchParams.get("projectId") || "";
-    const userId = await owner(projectId);
-    const tasks = await listCanvasGenerationTasks(userId, projectId);
-    if (tasks.some((task) => task.status === "pending" || canResumeCanvasTask(task)))
-      kick(userId, projectId);
-    return NextResponse.json(
-      { success: true, tasks },
-      { headers: { "Cache-Control": "no-store" } },
-    );
-  } catch (error) {
-    return fail(error);
-  }
-}
-export async function DELETE(request: Request) {
-  try {
-    const { projectId, taskId } = await request.json();
-    const userId = await owner(projectId);
-    if (!z.string().uuid().safeParse(taskId).success)
-      throw Object.assign(Error("任务 ID 无效"), { status: 400 });
-    const result = await cancelCanvasGenerationTask(userId, projectId, taskId);
-    if (!result.task)
-      return NextResponse.json({ success: false, error: "任务不存在" }, { status: 404 });
-    if (!result.ok)
-      return NextResponse.json(
-        {
-          success: false,
-          error:
-            result.task.status === "running"
-              ? "任务已提交供应商，当前线路不支持中止。结果会继续保存，请勿重复生成。"
-              : "任务已结束或状态待核实，请先刷新任务状态。",
-          task: result.task,
-        },
-        { status: 409 },
-      );
-    return NextResponse.json({ success: true, task: result.task });
-  } catch (error) {
-    return fail(error);
-  }
-}
-export async function PATCH(request: Request) {
-  try {
-    const { projectId, taskId, nodeId } = await request.json();
-    const userId = await owner(projectId);
-    if (!z.string().uuid().safeParse(taskId).success || typeof nodeId !== "string")
-      return NextResponse.json({ success: false }, { status: 400 });
-    const { hideCanvasGenerationNode } = await import("@/lib/video-canvas/task-store");
-    const success = await hideCanvasGenerationNode(userId, projectId, taskId, nodeId);
-    return NextResponse.json({ success }, { status: success ? 200 : 404 });
-  } catch (error) {
-    return fail(error);
-  }
-}

app/api/canvas/group-runs/route.ts

@@ -1,41 +0,0 @@
-import { auth } from "@/app/(auth)/auth";
-import { after, NextResponse } from "next/server";
-import { canvasTaskRequestSchema } from "@/lib/video-canvas/task-contract";
-import {
-  createCanvasGroupTasks,
-  ownsTaskProject,
-} from "@/lib/video-canvas/task-store";
-import { runCanvasGenerationQueue } from "@/lib/video-canvas/task-worker";
-import { preflightCanvasProductionRequests } from "@/lib/video-canvas/production-services";
-export const runtime = "nodejs",
-  maxDuration = 900;
-export async function POST(request: Request) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id)
-      return NextResponse.json({ error: "未登录" }, { status: 401 });
-    const text = await request.text();
-    if (Buffer.byteLength(text) > 1048576)
-      return NextResponse.json({ error: "编组数据过大" }, { status: 413 });
-    const parsed = canvasTaskRequestSchema
-      .array()
-      .min(1)
-      .max(40)
-      .safeParse(JSON.parse(text));
-    if (!parsed.success)
-      return NextResponse.json({ error: "编组参数无效" }, { status: 400 });
-    const projectId = parsed.data[0].projectId,
-      userId = session.user.id;
-    if (!(await ownsTaskProject(userId, projectId)))
-      return NextResponse.json({ error: "画布不存在" }, { status: 404 });
-    const tasks = await createCanvasGroupTasks(userId, parsed.data,
-      () => preflightCanvasProductionRequests(parsed.data));
-    after(() => runCanvasGenerationQueue(userId, projectId));
-    return NextResponse.json({ success: true, tasks }, { status: 202 });
-  } catch (e) {
-    return NextResponse.json(
-      { error: e instanceof Error ? e.message : "编组执行失败", code: (e as any)?.code },
-      { status: Number((e as any)?.status) || 400 }
-    );
-  }
-}

app/api/canvas/group-templates/route.ts

@@ -1,40 +0,0 @@
-import { auth } from "@/app/(auth)/auth";
-import { db } from "@/lib/db";
-import { canvasProject } from "@/lib/db/schema";
-import { eq, and, sql, desc } from "drizzle-orm";
-import { NextResponse } from "next/server";
-export async function GET() {
-  const session = await auth();
-  if (!session?.user?.id)
-    return NextResponse.json({ error: "未登录" }, { status: 401 });
-  const rows = await db
-    .select({
-      projectId: canvasProject.id,
-      title: canvasProject.title,
-      templates: sql<any[]>`${canvasProject.canvasData}->'groupTemplates'`,
-    })
-    .from(canvasProject)
-    .where(
-      and(
-        eq(canvasProject.userId, session.user.id),
-        eq(canvasProject.workspaceType, "video"),
-        sql`${canvasProject.canvasData} ? 'groupTemplates'`
-      )
-    )
-    .orderBy(desc(canvasProject.updatedAt))
-    .limit(100);
-  return NextResponse.json(
-    {
-      templates: rows.flatMap((row) =>
-        Array.isArray(row.templates)
-          ? row.templates.map((template) => ({
-              ...template,
-              projectId: row.projectId,
-              projectTitle: row.title,
-            }))
-          : []
-      ),
-    },
-    { headers: { "Cache-Control": "no-store" } }
-  );
-}

app/api/canvas/layout-replace/batches/[batchId]/route.ts

@@ -1,143 +0,0 @@
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import {
-  getCanvasLayoutReplaceBatchActiveTaskId,
-  getCanvasLayoutReplaceBatchForUser,
-  markCanvasLayoutReplaceBatchItemsAdded,
-  retryCanvasLayoutReplaceBatchItem,
-} from "@/lib/canvas/layout-replace-batch";
-import {
-  enqueueCanvasImageTask,
-  ensureCanvasImageTaskActive,
-} from "@/lib/canvas/image-task-queue";
-
-function normalizeUuid(value: unknown) {
-  const id = String(value || "").trim();
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)
-    ? id
-    : "";
-}
-
-export async function GET(
-  _request: Request,
-  { params }: { params: Promise<{ batchId: string }> }
-) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id) {
-      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-    }
-    const batchId = normalizeUuid((await params).batchId);
-    if (!batchId) {
-      return NextResponse.json({ success: false, error: "批次ID无效" }, { status: 400 });
-    }
-
-    let batch = await getCanvasLayoutReplaceBatchForUser({
-      batchId,
-      userId: session.user.id,
-    });
-    if (!batch) {
-      return NextResponse.json({ success: false, error: "批次不存在" }, { status: 404 });
-    }
-    const activeTaskId = getCanvasLayoutReplaceBatchActiveTaskId(batch);
-    if (activeTaskId) {
-      await ensureCanvasImageTaskActive({
-        taskId: activeTaskId,
-        userId: session.user.id,
-      });
-      batch = await getCanvasLayoutReplaceBatchForUser({
-        batchId,
-        userId: session.user.id,
-      });
-    }
-
-    return NextResponse.json({ success: true, batch });
-  } catch (error) {
-    console.error("[Canvas Layout Replace Batch][Detail] Error:", error);
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "查询批次失败",
-      },
-      { status: 500 }
-    );
-  }
-}
-
-export async function PATCH(
-  request: Request,
-  { params }: { params: Promise<{ batchId: string }> }
-) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id) {
-      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-    }
-    const batchId = normalizeUuid((await params).batchId);
-    const body = await request.json().catch(() => ({}));
-    if (body?.action === "retry") {
-      const itemId = normalizeUuid(body?.itemId);
-      if (!batchId || !itemId) {
-        return NextResponse.json(
-          { success: false, error: "缺少需要重试的结果" },
-          { status: 400 }
-        );
-      }
-      const taskId = await retryCanvasLayoutReplaceBatchItem({
-        batchId,
-        itemId,
-        userId: session.user.id,
-      });
-      if (!taskId) {
-        return NextResponse.json(
-          { success: false, error: "该结果当前无法重试" },
-          { status: 409 }
-        );
-      }
-      await enqueueCanvasImageTask(taskId);
-      return NextResponse.json({ success: true, taskId });
-    }
-
-    const items = Array.isArray(body?.items)
-      ? body.items
-          .map((item: unknown) => {
-            const record =
-              item && typeof item === "object" && !Array.isArray(item)
-                ? (item as Record<string, unknown>)
-                : {};
-            return {
-              itemId: normalizeUuid(record.itemId),
-              canvasNodeId: String(record.canvasNodeId || "").trim(),
-            };
-          })
-          .filter(
-            (item: { itemId: string; canvasNodeId: string }) =>
-              Boolean(item.itemId && item.canvasNodeId)
-          )
-      : [];
-    if (!batchId || items.length === 0) {
-      return NextResponse.json(
-        { success: false, error: "缺少已添加的结果信息" },
-        { status: 400 }
-      );
-    }
-    const updated = await markCanvasLayoutReplaceBatchItemsAdded({
-      batchId,
-      userId: session.user.id,
-      items,
-    });
-    if (!updated) {
-      return NextResponse.json({ success: false, error: "批次不存在" }, { status: 404 });
-    }
-    return NextResponse.json({ success: true });
-  } catch (error) {
-    console.error("[Canvas Layout Replace Batch][PATCH] Error:", error);
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "更新批次失败",
-      },
-      { status: 500 }
-    );
-  }
-}

app/api/canvas/layout-replace/batches/route.ts

@@ -1,201 +0,0 @@
-import { and, eq } from "drizzle-orm";
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import {
-  CANVAS_LAYOUT_REPLACE_BATCH_LIMIT,
-  createCanvasLayoutReplaceBatch,
-  getCanvasLayoutReplaceBatchActiveTaskId,
-  getLatestCanvasLayoutReplaceBatchForUser,
-  type CanvasLayoutReplaceBatchSource,
-} from "@/lib/canvas/layout-replace-batch";
-import {
-  enqueueCanvasImageTask,
-  ensureCanvasImageTaskActive,
-} from "@/lib/canvas/image-task-queue";
-import { db } from "@/lib/db";
-import { canvasProject } from "@/lib/db/schema";
-import { getPointsSystemConfig } from "@/lib/db/queries";
-import { prepareFeaturePointsCharge } from "@/lib/points/feature-charge";
-import { getImageToolCreditCost } from "@/lib/points/config";
-
-export const maxDuration = 1200;
-
-function normalizeHttpUrl(value: unknown) {
-  const url = String(value || "").trim();
-  return /^https?:\/\//i.test(url) ? url : "";
-}
-
-function normalizeUuid(value: unknown) {
-  const id = String(value || "").trim();
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)
-    ? id
-    : "";
-}
-
-function normalizeSources(value: unknown): CanvasLayoutReplaceBatchSource[] {
-  if (!Array.isArray(value)) return [];
-  const seen = new Set<string>();
-  const sources: CanvasLayoutReplaceBatchSource[] = [];
-  for (const item of value) {
-    if (!item || typeof item !== "object" || Array.isArray(item)) continue;
-    const record = item as Record<string, unknown>;
-    const sourceImageUrl = normalizeHttpUrl(record.sourceImageUrl);
-    if (!sourceImageUrl || seen.has(sourceImageUrl)) continue;
-    seen.add(sourceImageUrl);
-    sources.push({
-      sourceImageUrl,
-      sourceKind: record.sourceKind === "upload" ? "upload" : "canvas",
-      sourceNodeId: String(record.sourceNodeId || "").trim() || undefined,
-      sourceTitle: String(record.sourceTitle || "").trim().slice(0, 256) || undefined,
-    });
-    if (sources.length >= CANVAS_LAYOUT_REPLACE_BATCH_LIMIT) break;
-  }
-  return sources;
-}
-
-async function getOwnedProject(projectId: string, userId: string) {
-  const [project] = await db
-    .select({ id: canvasProject.id })
-    .from(canvasProject)
-    .where(and(eq(canvasProject.id, projectId), eq(canvasProject.userId, userId)))
-    .limit(1);
-  return project || null;
-}
-
-export async function GET(request: Request) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id) {
-      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-    }
-
-    const { searchParams } = new URL(request.url);
-    const projectId = normalizeUuid(searchParams.get("projectId"));
-    const sourceNodeId = String(searchParams.get("sourceNodeId") || "").trim();
-    if (!projectId) {
-      return NextResponse.json(
-        { success: false, error: "缺少有效的画布项目" },
-        { status: 400 }
-      );
-    }
-    if (!(await getOwnedProject(projectId, session.user.id))) {
-      return NextResponse.json({ success: false, error: "画布不存在" }, { status: 404 });
-    }
-
-    let batch = await getLatestCanvasLayoutReplaceBatchForUser({
-      projectId,
-      userId: session.user.id,
-      sourceNodeId: sourceNodeId || undefined,
-    });
-    const activeTaskId = batch
-      ? getCanvasLayoutReplaceBatchActiveTaskId(batch)
-      : null;
-    if (activeTaskId) {
-      await ensureCanvasImageTaskActive({
-        taskId: activeTaskId,
-        userId: session.user.id,
-      });
-      batch = await getLatestCanvasLayoutReplaceBatchForUser({
-        projectId,
-        userId: session.user.id,
-        sourceNodeId: sourceNodeId || undefined,
-      });
-    }
-
-    return NextResponse.json({ success: true, batch: batch || null });
-  } catch (error) {
-    console.error("[Canvas Layout Replace Batch][GET] Error:", error);
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "查询批次失败",
-      },
-      { status: 500 }
-    );
-  }
-}
-
-export async function POST(request: Request) {
-  try {
-    const session = await auth();
-    if (!session?.user?.id) {
-      return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-    }
-
-    const body = await request.json().catch(() => ({}));
-    const projectId = normalizeUuid(body?.projectId);
-    const referenceImageUrl = normalizeHttpUrl(body?.referenceImageUrl);
-    const sources = normalizeSources(body?.sources);
-    if (!projectId || !(await getOwnedProject(projectId, session.user.id))) {
-      return NextResponse.json({ success: false, error: "画布不存在" }, { status: 404 });
-    }
-    if (sources.length === 0) {
-      return NextResponse.json(
-        { success: false, error: "请至少添加一张待处理图片" },
-        { status: 400 }
-      );
-    }
-    if (!referenceImageUrl) {
-      return NextResponse.json(
-        { success: false, error: "请上传目标模版图" },
-        { status: 400 }
-      );
-    }
-
-    const pointsConfig = await getPointsSystemConfig();
-    const perImageCost = getImageToolCreditCost(pointsConfig, "repaint");
-    const totalCost = perImageCost * sources.length;
-    const pointsCharge = await prepareFeaturePointsCharge({
-      userId: session.user.id,
-      unitCost: totalCost,
-      reason: "image_repaint",
-      modelId: "canvas-layout-replace-batch",
-      note: `批量排版替换 ${sources.length} 张`,
-      pointsConfig,
-    });
-    if (!pointsCharge.ok) {
-      return NextResponse.json(pointsCharge.payload, { status: pointsCharge.status });
-    }
-
-    const created = await createCanvasLayoutReplaceBatch({
-      userId: session.user.id,
-      projectId,
-      sources,
-      referenceImageUrl,
-      supplementalPrompt:
-        typeof body?.supplementalPrompt === "string"
-          ? body.supplementalPrompt
-          : undefined,
-      imageSize: typeof body?.imageSize === "string" ? body.imageSize : "2K",
-      model: typeof body?.model === "string" ? body.model : undefined,
-    });
-    await enqueueCanvasImageTask(created.firstTaskId);
-
-    if (pointsCharge.chargeable) {
-      try {
-        await pointsCharge.consume({
-          note: `批量排版替换 ${sources.length} 张（${created.batchId}）`,
-        });
-      } catch (error) {
-        console.error("[Points] Failed to consume layout batch points:", error);
-      }
-    }
-
-    return NextResponse.json({
-      success: true,
-      batchId: created.batchId,
-      firstTaskId: created.firstTaskId,
-      sourceCount: sources.length,
-      pointsCost: totalCost,
-    });
-  } catch (error) {
-    console.error("[Canvas Layout Replace Batch][POST] Error:", error);
-    return NextResponse.json(
-      {
-        success: false,
-        error: error instanceof Error ? error.message : "创建批次失败",
-      },
-      { status: 500 }
-    );
-  }
-}

app/api/canvas/layout-replace/route.ts

@@ -16,13 +16,6 @@ function normalizeHttpUrl(value: unknown) {
   return /^https?:\/\//i.test(url) ? url : "";
 }
 
-function normalizeUuid(value: unknown) {
-  const uuid = String(value || "").trim();
-  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(uuid)
-    ? uuid
-    : undefined;
-}
-
 export async function POST(request: Request) {
   try {
     const session = await auth();
@@ -79,7 +72,6 @@ export async function POST(request: Request) {
           : "2K",
       sourceNodeId:
         typeof body?.sourceNodeId === "string" ? body.sourceNodeId : undefined,
-      agentProjectId: normalizeUuid(body?.agentProjectId),
       referenceLabel:
         typeof body?.referenceLabel === "string" ? body.referenceLabel : undefined,
       debugMeta:

app/api/canvas/media/upload/route.ts

@@ -1,65 +0,0 @@
-import { execFile } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { promisify } from "node:util";
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { uploadFile } from "@/lib/storage/service";
-
-export const runtime = "nodejs";
-export const maxDuration = 180;
-const probe = promisify(execFile);
-const running = new Set<string>();
-const formats: Record<string, string> = {
-  "video/mp4": "mp4", "video/quicktime": "mov", "video/webm": "webm",
-  "audio/mpeg": "mp3", "audio/mp3": "mp3", "audio/mp4": "m4a", "audio/x-m4a": "m4a",
-  "audio/wav": "wav", "audio/x-wav": "wav", "audio/ogg": "ogg", "audio/flac": "flac", "audio/webm": "webm",
-};
-
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-  if (running.has(session.user.id) || running.size >= 4) return NextResponse.json({ success: false, error: "正在上传，请稍后重试" }, { status: 429 });
-  running.add(session.user.id);
-  let dir = "";
-  try {
-    const form = await request.formData();
-    const file = form.get("file");
-    if (!(file instanceof File) || !formats[file.type]) return NextResponse.json({ success: false, error: "请上传 MP4、MOV、WebM 视频，或 MP3、M4A、WAV、OGG、FLAC 音频" }, { status: 400 });
-    if (!file.size || file.size > 125 * 1024 * 1024) return NextResponse.json({ success: false, error: "素材必须非空且不超过 125 MiB" }, { status: 413 });
-    dir = await mkdtemp(join(tmpdir(), "canvas-upload-"));
-    const input = join(dir, "input");
-    const buffer = await file.arrayBuffer();
-    await writeFile(input, Buffer.from(buffer));
-    let stdout: string;
-    try {
-      ({ stdout } = await probe("ffprobe", ["-v", "error", "-protocol_whitelist", "file", "-format_whitelist", "mov,matroska,webm,mp3,wav,ogg,flac", "-show_streams", "-show_format", "-of", "json", input], { timeout: 15000, maxBuffer: 1024 * 1024 }));
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException).code === "ENOENT") {
-        return NextResponse.json({ success: false, error: "服务器缺少 ffprobe 视频解析组件，请联系管理员安装 FFmpeg" }, { status: 503 });
-      }
-      return NextResponse.json({ success: false, error: "视频文件无法解析，请确认素材完整且格式受支持" }, { status: 400 });
-    }
-    const info = JSON.parse(stdout);
-    const kind = file.type.startsWith("video/") ? "video" : "audio";
-    const stream = info.streams?.find((item: { codec_type: string }) => item.codec_type === kind);
-    const duration = Number(info.format?.duration);
-    if (!stream || !Number.isFinite(duration) || duration <= 0 || duration > 600) return NextResponse.json({ success: false, error: "请上传内容完整、10 分钟以内的音视频" }, { status: 400 });
-    let uploaded;
-    try {
-      uploaded = await uploadFile(`canvas-${randomUUID()}.${formats[file.type]}`, buffer);
-    } catch (error) {
-      console.error("[Canvas media upload] Storage unavailable:", error);
-      return NextResponse.json({ success: false, error: "媒体存储暂不可用，请稍后重试" }, { status: 503 });
-    }
-    return NextResponse.json({ success: true, data: { url: uploaded.url, duration, width: stream.width, height: stream.height } });
-  } catch (error) {
-    console.error("[Canvas media upload] Failed:", error);
-    return NextResponse.json({ success: false, error: "素材上传失败，请确认文件完整或稍后重试" }, { status: 400 });
-  } finally {
-    running.delete(session.user.id);
-    if (dir) await rm(dir, { recursive: true, force: true });
-  }
-}

app/api/canvas/prompt-tools/route.ts

@@ -1,61 +0,0 @@
-import { generateText } from "ai";
-import { createLogger } from "@/lib/observability/logger";
-const logger = createLogger("canvas-prompt-tools");
-import { NextResponse } from "next/server";
-import { auth } from "@/app/(auth)/auth";
-import { getLanguageModelById } from "@/lib/ai/dynamic-provider";
-import { getEnabledAiModelsWithProvider, getSystemSetting } from "@/lib/db/queries";
-import { VIDEO_CANVAS_FUNCTION_CONFIG_KEY, normalizeVideoCanvasFunctionConfig } from "@/lib/video-canvas/config";
-import { promptToolErrorMessage, promptToolFunctionKey, promptToolSchema, selectPromptToolModel } from "@/lib/video-canvas/prompt-tools";
-
-export const runtime = "nodejs";
-export const maxDuration = 120;
-const running = new Set<string>();
-
-export async function POST(request: Request) {
-  const session = await auth();
-  if (!session?.user?.id) return NextResponse.json({ success: false, error: "未登录" }, { status: 401 });
-  const parsed = promptToolSchema.safeParse(await request.json().catch(() => null));
-  if (!parsed.success) return NextResponse.json({ success: false, error: parsed.error.issues[0]?.message || "参数无效" }, { status: 400 });
-  if (running.has(session.user.id)) return NextResponse.json({ success: false, error: "提示词处理中，请稍候" }, { status: 429 });
-  running.add(session.user.id);
-  try {
-    const [setting, available] = await Promise.all([
-      getSystemSetting({ key: VIDEO_CANVAS_FUNCTION_CONFIG_KEY }),
-      getEnabledAiModelsWithProvider(false),
-    ]);
-    const config = normalizeVideoCanvasFunctionConfig(setting?.value);
-    const definition = config.functions[promptToolFunctionKey(parsed.data.mode)];
-    if (!config.enabled || !definition?.enabled) return NextResponse.json({ success: false, error: "此提示词功能已停用" }, { status: 403 });
-    const requested = parsed.data.model && parsed.data.model !== "auto"
-      ? parsed.data.model : definition.model && definition.model !== "auto"
-        ? definition.model : config.defaultMultimodalModel;
-    let selected;
-    try {
-      selected = selectPromptToolModel(available
-        .filter(item => item.provider.isEnabled && item.model.isEnabled && !item.model.isSubModel)
-        .map(item => ({ ...item.model, providerType: item.provider.type })), requested);
-    } catch (error) {
-      return NextResponse.json({ success: false, error: (error as Error).message }, { status: 400 });
-    }
-    const model = await getLanguageModelById(selected.id);
-    if (!model) return NextResponse.json({ success: false, error: "提示词模型初始化失败" }, { status: 502 });
-    const { text } = await generateText({
-      model,
-      system: definition.prompt,
-      prompt: parsed.data.prompt,
-      temperature: parsed.data.mode === "translate" ? 0.1 : 0.4,
-      maxOutputTokens: 4000,
-      maxRetries: 0,
-      abortSignal: AbortSignal.any([request.signal, AbortSignal.timeout(90_000)]),
-    });
-    if (!text.trim()) throw new Error("empty model output");
-    return NextResponse.json({ success: true, data: { text: text.trim(), model: selected.id, modelName: selected.displayName || selected.modelId } });
-  } catch (error) {
-    const detail = error as { name?: string; statusCode?: number; cause?: { code?: string }; data?: { error?: { code?: string } } };
-    logger.warn("Prompt tool request failed", { name: detail?.name, statusCode: detail?.statusCode, code: detail?.data?.error?.code || detail?.cause?.code });
-    return NextResponse.json({ success: false, error: promptToolErrorMessage(error) }, { status: 502 });
-  } finally {
-    running.delete(session.user.id);
-  }
-}

app/api/canvas/route.ts

@@ -100,8 +100,6 @@ export async function POST(request: NextRequest) {
       .insert(canvasProject)
       .values({
         userId: session.user.id,
-        createdAt: new Date(),
-        updatedAt: new Date(),
         title: title || getDefaultWorkspaceTitle(workspaceType),
         description,
         workspaceType,

app/api/canvas/smart-edit/capabilities/route.ts

@@ -1,68 +0,0 @@
-import { remoteAudioCapabilities } from "@/lib/video-canvas/smart-edit/remote-audio";
-import { auth } from "@/app/(auth)/auth";
-import { NextResponse } from "next/server";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import path from "node:path";
-import { getEnabledAiModelsWithProvider } from "@/lib/db/queries";
-import { isCanvasVisionModel } from "@/lib/video-canvas/model-matching";
-import { remoteRenderConfig } from "@/lib/video-canvas/smart-edit/remote-render";
-export async function GET() {
-  const session = await auth();
-  if (!session?.user?.id)
-    return NextResponse.json({ error: "未登录" }, { status: 401 });
-  try {
-    let capabilities = {
-      separation: false,
-      scenes: false,
-      beats: false,
-      asr: false,
-      ffmpeg: false,
-      ffprobe: false,
-    };
-    try {
-      const { stdout } = await promisify(execFile)(
-        process.env.SMART_EDIT_PYTHON || "python3",
-        [path.resolve("services/smart-edit/analyze.py"), "--check"],
-        { timeout: 10000, maxBuffer: 65536 }
-      );
-      capabilities = JSON.parse(stdout);
-    } catch {}
-    const audio = await remoteAudioCapabilities();
-    if (audio) capabilities = { ...capabilities, ...audio };
-    let renderAvailable = capabilities.ffmpeg;
-    const remote = remoteRenderConfig();
-    if (remote) {
-      try {
-        const response = await fetch(remote.base + "/health", {
-          headers: { authorization: "Bearer " + remote.token },
-          signal: AbortSignal.timeout(3000),
-          redirect: "error",
-          cache: "no-store",
-        });
-        renderAvailable =
-          response.ok && (await response.json()).status === "ok";
-      } catch {
-        renderAvailable = false;
-      }
-    }
-    const models = (await getEnabledAiModelsWithProvider(false))
-      .filter((item) =>
-        isCanvasVisionModel({ ...item.model, providerType: item.provider.type })
-      )
-      .map(({ model }) => ({
-        id: model.id,
-        name: model.displayName,
-        modelId: model.modelId,
-      }));
-    return NextResponse.json(
-      { capabilities: { ...capabilities, render: renderAvailable }, models },
-      { headers: { "Cache-Control": "no-store" } }
-    );
-  } catch {
-    return NextResponse.json(
-      { error: "剪辑服务配置读取失败" },
-      { status: 503 }
-    );
-  }
-}

app/api/canvas/smart-edit/fonts/[id]/route.ts

@@ -1,22 +0,0 @@
-import { auth } from "@/app/(auth)/auth";
-import { captionFont } from "@/lib/video-canvas/smart-edit/fonts";
-import { captionFontFile } from "@/lib/video-canvas/smart-edit/font-files";
-import { readFile } from "node:fs/promises";
-export const runtime = "nodejs";
-export const maxDuration = 180;
-export async function GET(_request: Request, { params }: { params: Promise<{ id: string }> }) {
-  if (!(await auth())?.user?.id) return Response.json({ error: "未登录" }, { status: 401 });
-  const { id } = await params;
-  if (!captionFont(id)) return Response.json({ error: "字体不存在" }, { status: 404 });
-  try {
-    const data = await readFile(await captionFontFile(id));
-    return new Response(new Uint8Array(data), {
-      headers: {
-        "Content-Type": "font/ttf",
-        "Cache-Control": "private, max-age=31536000, immutable",
-      },
-    });
-  } catch {
-    return Response.json({ error: "字体加载失败，请检查字体服务配置后重试" }, { status: 503 });
-  }
-}