SuperAPI AI 工具集

prisma-next-quickstart

编程与开发

查看项目

更新于 10-16 07:20

技能介绍

用途:把用户从零或接近零带到 Prisma Next 的第一条可用查询。三条路径——首次接触、绿地、棕地数据库——最终都汇聚到同一条主线:连接 → 写入 → 读取;schema 编辑放在主线之后,而不是之前。不覆盖从其他 ORM 迁移,那些是单独的技能。

主要能力与概念:Prisma Next 是 contract-first,contract 是数据模型的唯一来源,框架据此派生查询类型、迁移与运行时类型。contract 用 contract.prisma(PSL,默认)或 contract.ts 编写,emits contract.json 与 contract.d.ts。target 目前支持 postgres 或 mongodb,通过 @prisma-next/postgres 或 @prisma-next/mongo 门面包导入。db.ts 位于 src/prisma/ 下,是运行时入口;其余代码从它导入。marker 是数据库中的 pn_meta_marker 行,记录 contract 哈希以检测漂移,由 db init 或 db sign 创建。

使用方式:绿地用 pnpm dlx prisma-next init(可加 --yes --target postgres --authoring psl)在空目录初始化;棕地数据库先用 contract infer 推断 contract,再用 db sign 签署 marker,然后对已有表写查询;首次接触路径先读 prisma-next.config.ts、contract 源与 .env,确认 DATABASE_URL 后执行 pnpm prisma-next db init,再在 src/ 新文件里用 db.orm.<Model> 完成写入与读取。注意 init 目前脚手架生成到仓库根而非 src/prisma/(TML-2532),可传 --schema-path src/prisma/contract.prisma 或事后移动并更新配置。

适用场景:已有脚手架问下一步、新项目想采用、已有 Postgres/Mongo 想引入 Prisma Next。限制:不处理从 Drizzle、Prisma 6/7、Sequelize、TypeORM、Kysely、Knex 或裸驱动的迁移;加模型、改字段等后续任务路由到 prisma-next-contract、prisma-next-runtime、prisma-next-build 或 prisma-next-queries。