云端部署引导

按顺序完成这些必须步骤，就可以把 PCI 从本地迁移到云服务器，并直接连接 Supabase 启动。

还缺必须配置

必须手工配置

DATABASE_URL
Supabase Postgres 连接串，服务器端专用。
已配置
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
Clerk 浏览器端公开 key。
已配置
CLERK_SECRET_KEY
Clerk 服务端 secret。
已配置
NEXT_PUBLIC_CLERK_SIGN_IN_URL
固定为 /sign-in。
已配置
NEXT_PUBLIC_CLERK_SIGN_UP_URL
固定为 /sign-up。
已配置
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL
固定为 /today。
已配置
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL
固定为 /today。
已配置

环境变量示例

DATABASE_URL=postgresql://...
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_...
CLERK_SECRET_KEY=sk_...
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/today
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/today
1

准备云服务器

安装 Node.js 20+ 和 Git。拉取 GitHub 仓库后进入项目根目录。

2

配置 Supabase

把 Supabase Postgres 或 pooler 连接串写入 DATABASE_URL。当前应用通过 Prisma 在服务器端连接 Supabase。

3

配置 Clerk

写入 Clerk publishable key、secret key，以及登录/注册后的跳转路径。

4

安装和构建

运行 npm install、Prisma generate 和生产构建命令。

5

启动服务

运行 Next.js production start，绑定到你的云服务器端口或反向代理后面的端口。

6

首次登录

通过域名打开系统，注册或登录后进入 Today。系统会自动初始化用户、通知、Focus Tasks 和连接器配置。

服务器初始化命令

npm install
npx prisma generate --schema packages/db/prisma/schema.prisma
npm run build:pci
npm run start --workspace @agents-for-life/pci-web -- --hostname 0.0.0.0 --port 3000

Supabase 连接方式

可以直接连接 Supabase，不需要在云服务器上再安装 PostgreSQL。建议生产环境使用 Supabase pooler 连接串作为 DATABASE_URL，并且只放在服务器环境变量中。

启动后验证

打开域名后，应进入登录或注册。成功后跳转到 /today，并自动生成通知、Focus Tasks 和 Connector Settings。

后续连接器配置

这些不是首次启动必须项。配置后才会开启真实 Calendar、Email、Notes、To-do 或模型能力。