本地开发与初始化

环境要求复制标题链接

Node.js 版本以 .nvmrc 为准，pnpm 版本以 package.json 的 packageManager 为准。项目当前使用 Node.js 22.23.1 与 pnpm 11.20.0。

nvm use
corepack enable
pnpm install
cp .env.example .env.local
cp .dev.vars.example .dev.vars

.env.local 用于 Next.js 本地环境；.dev.vars 用于 Wrangler 本地运行。按各自运行方式配置，不要假定两个文件会自动保持一致。

初始化与启动复制标题链接

先按环境变量说明 设置站点地址与认证密钥，再执行：

pnpm db:migrate:dev
pnpm dev

访问 http://localhost:3000。默认语言是中文，常规中文页面不需要 /zh 前缀。注册账户后进入 /app/resumes 创建简历。

db:migrate:dev 从 wrangler.jsonc 读取 D1 名称，将 drizzle/ 下的迁移应用到本地数据库。若修改绑定名称，同步检查 src/integrations/database/client.ts。

分步确认复制标题链接

1. 首页能打开，导航中的开发者文档可访问。
2. 注册或登录后，创建简历并刷新，确认数据仍存在。
3. 需要 AI 时再配置平台服务开关，或在模型设置中添加自有模型。
4. 涉及 Worker 能力时使用 pnpm preview 验证 OpenNext 运行方式。

实现入口复制标题链接

• package.json：开发、迁移、构建与部署命令。
• next.config.ts：Next.js、MDX 与运行时配置。
• wrangler.jsonc：Worker 资源绑定。
• scripts/get-db-name.mjs：迁移命令读取数据库名。