Prisma Next 重磅发布：TypeScript 重写、AI Agent 原生集成与数据合约系统

Prisma 团队近日正式发布了 Prisma Next——这是对经典 Prisma ORM 的彻底重构，从 Rust 代码库完全迁移到 TypeScript，并围绕 AI Agent 兼容性、可扩展架构和数据合约系统进行了重新设计。目前该项目处于 Early Access 阶段，以 Apache 2.0 许可在 GitHub 上开源。

如果你在 2026 年仍然使用 ORM 管理数据库，这篇文章会告诉你为什么 Prisma Next 值得关注——尤其是当你同时在用 AI 编码助手（Claude Code、Cursor、Copilot Agent）时。

一、为什么要完全重写？

Prisma 原来的引擎用 Rust 编写，虽然性能出色，但给社区贡献和扩展带来了天然的门槛。Kotlin、Go 等语言的开发者想贡献 Prisma 客户端变得困难，第三方扩展更是无从谈起。

Prisma Next 的核心设计目标：

二、安装与初始化

全新项目

npm create prisma@next

交互式脚手架会询问你使用的框架（Next.js、Vite、Hono 等）和数据库（PostgreSQL 或 MongoDB），自动生成一个可运行的应用、一份入门数据合约，以及注册好的 Agent Skills 文件。

现有项目

npx prisma-next@latest init

这个命令会：

1. 创建 prisma-next.config.ts 配置文件
2. 在 src/prisma/ 下生成初始合约和 db.ts
3. 安装运行时依赖
4. 编译数据合约
5. 注册 AI Agent Skills（见下一节）

三、最亮眼的功能：AI Agent 原生兼容

这是 Prisma Next 最与众不同的设计。初始化后，项目根目录会生成一个 prisma-next.md 文件——任何 AI 编码助手都可以首先读取它来了解数据库结构。

更厉害的是，npx prisma-next@latest init 还会在两个位置生成 SKILL.md 文件：

• .claude/skills/<skill-name>/SKILL.md — 被 Claude Code 自动识别
• .agents/skills/<skill-name>/SKILL.md — 被 Cursor、Copilot Agent 等标准运行时识别

项目根目录的 skills-lock.json 追踪已安装的 Skill 版本。当你在编辑器中输入类似以下需求时：

“添加一个 posts 模型，与 users 建立关联，然后写一个查询加载每个用户最近的三篇文章。”

AI 编码助手会自动加载 prisma-next-contract Skill 来处理 schema 编辑，加载 prisma-next-queries Skill 来写查询语句——整个过程端到端自动化。

目前内置的 Agent Skills 包括：

四、数据合约系统

Prisma Next 引入了 Data Contracts（数据合约） 的概念——取代了传统 Prisma schema 文件。合约是类型安全的 TypeScript/JSON 定义，不仅描述表结构，还包含数据流约束、验证规则和迁移依赖信息。

// contract.ts — Prisma Next 数据合约示例
import { contract } from "prisma-next";

export const userContract = contract.define({
  model: "User",
  fields: {
    id: contract.uuid().primary(),
    email: contract.string().unique().email(),
    name: contract.string().min(1).max(100),
    posts: contract.hasMany("Post", { onDelete: "Cascade" }),
  },
  indexes: [{ fields: ["email"], unique: true }],
});

这套系统的优势在于：

• 类型安全：编译时发现 schema 错误
• 迁移图形化：迁移不再是黑盒，而是可视化的依赖图
• Agent 可读：合约是纯 JSON/TS，AI Agent 可以直接理解和操作

五、迁移图形化（Migration Graphs）

Prisma 的老用户应该都踩过迁移冲突的坑。Prisma Next 把迁移改成了有向无环图（DAG），每个迁移都是一个节点，依赖关系清晰可见：

npx prisma-next migrate visualize

这个命令输出一个 ASCII 或 HTML 格式的迁移依赖图，让你一眼看出：

• 哪些迁移还在等待
• 是否有循环依赖
• 基线迁移和回滚路径

对于多人协作的项目，这种可视化能力可以大幅减少”我改了 schema 但是迁移失败了”的痛苦。

六、扩展生态：一切皆插件

Prisma Next 的核心极简——甚至连 PostgreSQL 支持本身都是通过公开 SPI 实现的。这意味着任何第三方都可以编写扩展，而且与官方扩展享受同样的集成深度。

已经可用的扩展：

npm install @prisma-next/extension-pgvector
npm install @prisma-next/extension-paradedb
npm install @prisma-next/extension-postgis
npm install @cipherstash/prisma-next

如果你有自己的工具或数据库想与 Prisma 集成，现在可以通过 SPI 实现。Prisma 团队在博客 Authoring Prisma Next Extensions 中详细介绍了扩展编写流程。

七、支持的数据库与路线图

八、实际使用感受

我在一个 Vite + Prisma Next 项目中试用了这套工具链，整体体验相当流畅：

1. 初始化体验好：npm create prisma@next 一步到位，比原来 Prisma 的初始化流程简洁不少
2. Agent 集成是亮点：Claude Code 确实自动识别了生成的 SKILL.md，用自然语言写查询的体验很自然
3. TypeScript 代码库更友好：之前看 Prisma 源码需要 Rust 知识，现在纯 TypeScript 直接可以跟着类型提示理解
4. 不足：Early Access 版本还有一些 API 不稳定（这是 EA 阶段正常的），生产环境建议等 GA

九、总结与建议

• 如果你在用 Claude Code / Cursor / Copilot Agent：Prisma Next 的 Agent 原生兼容是目前 ORM 中独一无二的，值得立即尝试
• 如果你维护 Prisma 扩展或想贡献：TypeScript 重写大大降低了门槛
• 如果是生产环境：建议等 GA 版本，或者先在非关键项目上试用
• 如果你只用 SQLite/MySQL：目前还不是最佳时机，可以关注路线图

Prisma Next 对开发者社区的意义不仅是一个 ORM 升级——它展示了”AI 时代的开发工具应该长什么样”：工具主动适配 AI Agent，而不是让开发者去适配工具。

Prisma Next GitHub 仓库 | 官方公告 | Prisma Next 文档