diff --git a/README.md b/README.md
index d3cd0ea..0eef03c 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 一个**单二进制**的全栈应用 starter——`bun run compile` 出来的 `./server` 文件就是你要部署的全部产物，自带 HTTP 服务、SSR、API、嵌入式 SQL 迁移，运行时不依赖 Node、不依赖源码、不依赖外部 migration 目录。
 
-技术栈：Bun · TanStack Start (React 19 SSR) · ORPC（契约优先 API）· Drizzle ORM · PostgreSQL · Tailwind v4 · Biome。
+技术栈：Bun · TanStack Start (React 19 SSR) · ORPC（契约优先 API）· Drizzle ORM · PostgreSQL 18+ · Tailwind v4 · Biome。
 
 ## 为什么用这个
 
@@ -13,6 +13,8 @@
 
 ## 快速开始
 
+> **需要 PostgreSQL 18+**——schema 用 PG 原生的 `uuidv7()` 生成主键（`compose.yaml` 已锁 `postgres:18-alpine`）。要兼容更老的 PG，把 `src/server/db/fields.ts` 里的 `default(sql\`uuidv7()\`)` 换成 `$defaultFn(() => Bun.randomUUIDv7())`，再跑 `bun run db:generate`。
+
 ```bash
 cp .env.example .env        # 把里面的 DATABASE_URL 改成你的 Postgres
 bun install