@allbluecn/admin-app 0.2.6 → 0.3.0

package/src/server/serverFns/ai-prompts/activate.ts

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/activate.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma } from "@allbluecn/database"
+import { requireAdmin } from "../../auth-helpers"
+
+const activateSchema = z.object({
+  key: z.string(),
+  isActive: z.boolean(),
+})
+
+/** 切换启用状态；受保护模板不可停用 */
+export const activatePromptTemplateFn = createServerFn({ method: "POST" })
+  .validator(activateSchema)
+  .handler(async ({ data }) => {
+    const session = await requireAdmin()
+    const updatedBy = session.user?.id ?? null
+    const existing = await prisma.systemPromptTemplate.findUnique({
+      where: { key: data.key },
+    })
+    if (!existing) throw new Error("模板不存在")
+    if (!data.isActive && existing.isProtected) {
+      throw new Error("受保护的模板不可停用（停用会回退到内置默认，可能降低安全策略）")
+    }
+    const updated = await prisma.systemPromptTemplate.update({
+      where: { id: existing.id },
+      data: { isActive: data.isActive, updatedBy },
+    })
+    return {
+      id: updated.id,
+      key: updated.key,
+      isActive: updated.isActive,
+      isProtected: updated.isProtected,
+      updatedAt: updated.updatedAt.toISOString(),
+    }
+  })

package/src/server/serverFns/ai-prompts/get.ts

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/get.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma } from "@allbluecn/database"
+import type {
+  SystemPromptSectionDTO,
+  SystemPromptTemplateDTO,
+} from "@allbluecn/kernel"
+import { requireAdmin } from "../../auth-helpers"
+import { backfillMissingPromptTemplates } from "./prompt-defaults"
+
+const getInput = z.object({ key: z.string() })
+
+export interface PromptVersionSummary {
+  id: string
+  version: number
+  note: string | null
+  createdBy: string | null
+  createdAt: string
+}
+
+/** 按 key 取单个模板 + 版本历史（历史只带元数据，不含 sections 快照正文） */
+export const getPromptTemplateFn = createServerFn({ method: "GET" })
+  .validator(getInput)
+  .handler(async ({ data }) => {
+    await requireAdmin()
+    await backfillMissingPromptTemplates()
+    const template = await prisma.systemPromptTemplate.findUnique({
+      where: { key: data.key },
+    })
+    if (!template) throw new Error("模板不存在")
+    const versions = await prisma.systemPromptVersion.findMany({
+      where: { templateId: template.id },
+      orderBy: { version: "desc" },
+      take: 30,
+    })
+    const dto: SystemPromptTemplateDTO = {
+      id: template.id,
+      key: template.key,
+      name: template.name,
+      description: template.description,
+      sections: template.sections as unknown as SystemPromptSectionDTO[],
+      variables: template.variables as unknown as SystemPromptTemplateDTO["variables"],
+      version: template.version,
+      isActive: template.isActive,
+      isProtected: template.isProtected,
+      updatedAt: template.updatedAt.toISOString(),
+    }
+    const versionSummaries: PromptVersionSummary[] = versions.map((v) => ({
+      id: v.id,
+      version: v.version,
+      note: v.note,
+      createdBy: v.createdBy,
+      createdAt: v.createdAt.toISOString(),
+    }))
+    return { template: dto, versions: versionSummaries }
+  })

package/src/server/serverFns/ai-prompts/list.ts

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/list.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma } from "@allbluecn/database"
+import { requireAdmin } from "../../auth-helpers"
+import { backfillMissingPromptTemplates } from "./prompt-defaults"
+
+/** 列出提示词模板（列表页只取轻量字段，详情经 get 加载） */
+export const listPromptTemplatesFn = createServerFn({ method: "GET" })
+  .validator(z.object({}))
+  .handler(
+  async () => {
+    await requireAdmin()
+    await backfillMissingPromptTemplates()
+    const templates = await prisma.systemPromptTemplate.findMany({
+      orderBy: [{ key: "asc" }],
+      take: 50,
+      select: {
+        id: true,
+        key: true,
+        name: true,
+        version: true,
+        isActive: true,
+        isProtected: true,
+        updatedAt: true,
+      },
+    })
+    return templates.map((t) => ({
+      id: t.id,
+      key: t.key,
+      name: t.name,
+      version: t.version,
+      isActive: t.isActive,
+      isProtected: t.isProtected,
+      updatedAt: t.updatedAt.toISOString(),
+    }))
+  },
+)

package/src/server/serverFns/ai-prompts/preview.ts

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/preview.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { interpolateTemplate, UnknownPromptVariableError } from "@allbluecn/kernel"
+import { requireAdmin } from "../../auth-helpers"
+import { previewSectionSchema } from "./prompt-schemas"
+
+const previewSchema = z.object({
+  key: z.string(),
+  // 用宽容 schema：编辑中临时空分区不应让整个预览失败（见 prompt-schemas.ts）
+  sections: z.array(previewSectionSchema),
+  vars: z.record(z.string(), z.string()),
+})
+
+// admin-only 宽容行为，与运行时严格性故意不同：
+// 运行时（apps/web ai-gateway）对未知变量直接抛 UnknownPromptVariableError 使请求失败；
+// 预览场景下内置变量由服务端填充占位串（下方 PREVIEW_VAR_PLACEHOLDERS），
+// 用户新增的未知变量仍返回 { ok:false, error } 而非静默留空。
+const PREVIEW_VAR_PLACEHOLDERS: Record<string, string> = {
+  now: "[当前时间]",
+  locale: "[语言]",
+  userName: "[用户名]",
+  workspaceName: "[工作区名]",
+}
+
+/** 编辑器实时预览：按 order 拼合分区，未知变量返回 error 而非中断整个调用 */
+export const previewPromptFn = createServerFn({ method: "POST" })
+  .validator(previewSchema)
+  .handler(async ({ data }) => {
+    await requireAdmin()
+    const vars = { ...PREVIEW_VAR_PLACEHOLDERS, ...data.vars }
+    try {
+      const sections = data.sections
+        .filter((s) => s.template.trim().length > 0)
+        .slice()
+        .sort((a, b) => a.order - b.order)
+        .map((s) => ({
+          id: s.id,
+          order: s.order,
+          text: interpolateTemplate(s.template, vars),
+        }))
+      return { ok: true as const, sections }
+    } catch (e) {
+      if (e instanceof UnknownPromptVariableError) {
+        return { ok: false as const, error: `未知变量: ${e.variable}` }
+      }
+      throw e
+    }
+  })

package/src/server/serverFns/ai-prompts/prompt-defaults.ts

@@ -0,0 +1,63 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/prompt-defaults.ts
+import { prisma, type Prisma } from "@allbluecn/database"
+import { listPromptDefinitions } from "@allbluecn/web-app/ai-gateway/prompts/definitions"
+
+// 提示词的唯一来源是代码内置定义（apps/web ai-gateway/prompts/builtin.ts）；
+// admin 后台只是查看与二次编辑的入口，DB 永远不该是「唯一事实」——
+// 只要 admin 单独部署或 web 进程尚未执行过 ensurePromptSeeded，DB 里就
+// 可能一行都没有。这里把缺失的 key 按内置默认值补进 DB，保证后台任何
+// 时刻都能看到默认提示词，且默认值绝不可能是空串。
+
+export const BACKFILL_SNAPSHOT_NOTE =
+  "初始化自代码内置默认提示词（可在后台编辑）"
+
+/** 只补缺失的 key：已存在的行（含被停用或留空的）一律不动 */
+function toJson(value: unknown): Prisma.InputJsonValue {
+  return value as unknown as Prisma.InputJsonValue
+}
+
+export async function backfillMissingPromptTemplates() {
+  const defaults = listPromptDefinitions()
+  const existing = await prisma.systemPromptTemplate.findMany({
+    select: { key: true },
+  })
+  const known = new Set(existing.map((row) => row.key))
+  const missing = defaults.filter((definition) => !known.has(definition.key))
+  if (missing.length === 0) return 0
+  try {
+    await prisma.systemPromptTemplate.createMany({
+      data: missing.map((definition) => ({
+        key: definition.key,
+        name: definition.name,
+        description: definition.description ?? null,
+        sections: toJson(definition.sections),
+        variables: toJson(definition.variables),
+        version: 1,
+        isProtected: definition.isProtected,
+      })),
+    })
+    return missing.length
+  } catch {
+    // createMany 是原子的：并发补种时先到的那次已经写完整批，
+    // 后到的整批失败——此时行已存在，返回 0 由调用方按现状读取。
+    return 0
+  }
+}
+

package/src/server/serverFns/ai-prompts/prompt-schemas.ts

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/prompt-schemas.ts
+import { z } from "zod"
+
+const PROMPT_VAR_NAME_RE = /^[A-Za-z_][A-Za-z0-9_]*$/
+
+const promptSectionShape = {
+  id: z.string().min(1),
+  order: z.number().int(),
+}
+
+export const promptSectionSchema = z.object({
+  ...promptSectionShape,
+  // trim().min(1) 同时拦截空串与纯空白：否则落库后 web 侧
+  // parseSections 会丢弃该行并静默回落内置默认，后台编辑等于无效。
+  template: z.string().trim().min(1, "分区正文不能为空"),
+})
+
+// 预览故意比保存宽容：清空某个分区的瞬间不能让整个预览面板变空白。
+// 空分区在 preview.ts 的 handler 内过滤，非空约束只在写入路径强制。
+export const previewSectionSchema = z.object({
+  ...promptSectionShape,
+  template: z.string(),
+})
+
+export const promptVariableSchema = z.object({
+  name: z
+    .string()
+    .regex(PROMPT_VAR_NAME_RE, "变量名须以字母或下划线开头，仅含字母数字下划线"),
+  description: z.string(),
+})

package/src/server/serverFns/ai-prompts/rollback.ts

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/rollback.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma, Prisma } from "@allbluecn/database"
+import type {
+  PromptVariableDefDTO,
+  SystemPromptSectionDTO,
+} from "@allbluecn/kernel"
+import { requireAdmin } from "../../auth-helpers"
+
+const rollbackSchema = z.object({
+  key: z.string(),
+  version: z.number().int(),
+  expectedVersion: z.number().int(),
+})
+
+function toJson(value: unknown): Prisma.InputJsonValue {
+  return value as unknown as Prisma.InputJsonValue
+}
+
+/** 回滚到指定历史版本：先快照当前内容，再把快照 sections 写回模板并 bump version */
+export const rollbackPromptTemplateFn = createServerFn({ method: "POST" })
+  .validator(rollbackSchema)
+  .handler(async ({ data }) => {
+    const session = await requireAdmin()
+    const updatedBy = session.user?.id ?? null
+    return prisma.$transaction(async (tx) => {
+      const existing = await tx.systemPromptTemplate.findUnique({
+        where: { key: data.key },
+      })
+      if (!existing) throw new Error("模板不存在")
+      if (existing.version !== data.expectedVersion) {
+        throw new Error("版本冲突，请刷新后重试")
+      }
+      const snapshot = await tx.systemPromptVersion.findUnique({
+        where: { templateId_version: { templateId: existing.id, version: data.version } },
+      })
+      if (!snapshot) throw new Error("未找到该版本快照")
+      await tx.systemPromptVersion.create({
+        data: {
+          templateId: existing.id,
+          version: existing.version,
+          sections: toJson(existing.sections),
+          note: `回滚自 v${existing.version}`,
+          createdBy: updatedBy,
+        },
+      })
+      const updated = await tx.systemPromptTemplate.update({
+        where: { id: existing.id },
+        data: {
+          sections: toJson(snapshot.sections),
+          version: existing.version + 1,
+          updatedBy,
+        },
+      })
+      return {
+        id: updated.id,
+        key: updated.key,
+        name: updated.name,
+        description: updated.description,
+        sections: updated.sections as unknown as SystemPromptSectionDTO[],
+        variables: updated.variables as unknown as PromptVariableDefDTO[],
+        version: updated.version,
+        isActive: updated.isActive,
+        isProtected: updated.isProtected,
+        updatedAt: updated.updatedAt.toISOString(),
+      }
+    })
+  })

package/src/server/serverFns/ai-prompts/save.ts

@@ -0,0 +1,129 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-prompts/save.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma, Prisma } from "@allbluecn/database"
+import { requireAdmin } from "../../auth-helpers"
+import { promptSectionSchema, promptVariableSchema } from "./prompt-schemas"
+import { getPromptDefinition } from "@allbluecn/web-app/ai-gateway/prompts/definitions"
+import { BACKFILL_SNAPSHOT_NOTE } from "./prompt-defaults"
+
+const saveSchema = z.object({
+  key: z.string(),
+  expectedVersion: z.number().int(),
+  name: z.string().min(1).optional(),
+  description: z.string().nullish(),
+  sections: z.array(promptSectionSchema).min(1),
+  note: z.string().max(200).optional(),
+  variables: z.array(promptVariableSchema).default([]),
+})
+
+function toJson(value: unknown): Prisma.InputJsonValue {
+  return value as unknown as Prisma.InputJsonValue
+}
+
+/** 保存分区 + 变量，带乐观锁；成功后先落历史快照再 bump version */
+export const savePromptTemplateFn = createServerFn({ method: "POST" })
+  .validator(saveSchema)
+  .handler(async ({ data }) => {
+    const session = await requireAdmin()
+    const updatedBy = session.user?.id ?? null
+    return prisma.$transaction(async (tx) => {
+      const existing = await tx.systemPromptTemplate.findUnique({
+        where: { key: data.key },
+      })
+      if (!existing) {
+        // 后台首屏看到的是补种进来的「代码内置默认值」，此时还没有历史快照。
+        // 首次保存以默认正文补一份 v1 快照再升到 v2，与下方更新路径保持一致
+        // 的不变量：当前版本无快照，快照只保存历史。
+        const definition = getPromptDefinition(data.key)
+        if (!definition) throw new Error("提示词不在代码内置定义中")
+        const created = await tx.systemPromptTemplate.create({
+          data: {
+            key: data.key,
+            name: data.name ?? definition.name,
+            description: data.description ?? definition.description ?? null,
+            sections: toJson(data.sections),
+            variables: toJson(data.variables),
+            version: 2,
+            isProtected: definition.isProtected,
+            updatedBy,
+          },
+        })
+        await tx.systemPromptVersion.create({
+          data: {
+            templateId: created.id,
+            version: 1,
+            sections: toJson(definition.sections),
+            note: BACKFILL_SNAPSHOT_NOTE,
+            createdBy: updatedBy,
+          },
+        })
+        return {
+          id: created.id,
+          key: created.key,
+          name: created.name,
+          description: created.description,
+          sections: created.sections as unknown as typeof data.sections,
+          variables: created.variables as unknown as typeof data.variables,
+          version: created.version,
+          isActive: created.isActive,
+          isProtected: created.isProtected,
+          updatedAt: created.updatedAt.toISOString(),
+        }
+      }
+      if (existing.version !== data.expectedVersion) {
+        throw new Error("版本冲突，请刷新后重试")
+      }
+      await tx.systemPromptVersion.create({
+        data: {
+          templateId: existing.id,
+          version: existing.version,
+          sections: toJson(existing.sections),
+          note: data.note ?? `保存前 v${existing.version}`,
+          createdBy: updatedBy,
+        },
+      })
+      const updated = await tx.systemPromptTemplate.update({
+        where: { id: existing.id },
+        data: {
+          ...(data.name !== undefined ? { name: data.name } : {}),
+          ...(data.description !== undefined
+            ? { description: data.description }
+            : {}),
+          sections: toJson(data.sections),
+          variables: toJson(data.variables),
+          version: existing.version + 1,
+          updatedBy,
+        },
+      })
+      return {
+        id: updated.id,
+        key: updated.key,
+        name: updated.name,
+        description: updated.description,
+        sections: updated.sections as unknown as typeof data.sections,
+        variables: updated.variables as unknown as typeof data.variables,
+        version: updated.version,
+        isActive: updated.isActive,
+        isProtected: updated.isProtected,
+        updatedAt: updated.updatedAt.toISOString(),
+      }
+    })
+  })

package/src/server/serverFns/ai-provider/seed-from-seed.ts

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// apps/admin/src/server/serverFns/ai-provider/seed-from-seed.ts
+import { createServerFn } from "@tanstack/react-start"
+import { z } from "zod"
+import { prisma } from "@allbluecn/database"
+import { SEED_AI_PROVIDERS } from "@allbluecn/kernel"
+import { requireAdmin } from "../../auth-helpers"
+
+export const seedFromSeedFn = createServerFn({ method: "POST" })
+  .validator(z.object({}))
+  .handler(async () => {
+    await requireAdmin()
+    const created: string[] = []
+    const skipped: string[] = []
+    for (let i = 0; i < SEED_AI_PROVIDERS.length; i++) {
+      const p = SEED_AI_PROVIDERS[i]!
+      const existing = await prisma.aiProvider.findUnique({
+        where: { providerId: p.providerId },
+      })
+      if (existing) {
+        skipped.push(p.providerId)
+        continue
+      }
+      await prisma.aiProvider.create({
+        data: {
+          providerId: p.providerId,
+          displayName: p.displayName,
+          brandName: p.brandName,
+          description: p.description,
+          category: p.category,
+          adapterKind: p.adapterKind,
+          defaultBaseUrl: p.defaultBaseUrl ?? null,
+          keyUrl: p.keyUrl ?? null,
+          docsUrl: p.docsUrl ?? null,
+          keyPlaceholder: p.keyPlaceholder ?? null,
+          iconSlug: p.iconSlug ?? null,
+          brandColor: p.brandColor,
+          badge: p.badge ?? null,
+          isLocal: p.isLocal ?? false,
+          models: p.models as any,
+          sortOrder: i,
+          enabled: true,
+        },
+      })
+      created.push(p.providerId)
+    }
+    return { created, skipped }
+  })