部署构建Skill deployment-build

---

名称：部署构建 描述：关于Vercel部署流水线、混合构建脚本和环境配置的知识。

部署与构建流水线

混合构建流程

本项目结合了Next.js根应用与Docusaurus文档应用。

• 构建命令：npm run build
• 逻辑：
  1. cd textbook && npm install && npm run build （构建文档）
  2. npx shx mkdir -p public/docs （创建输出目录）
  3. npx shx cp -r textbook/build/* public/docs/ （将静态文档复制到Next.js的public文件夹）
  4. next build （构建主Next.js应用）

Vercel配置

• 文件：backend/vercel.json
• Python运行时：用于FastAPI后端（backend/main.py）。
• 路由：将所有/api/*请求重写到Python函数。

环境变量

确保在Vercel控制台中设置以下变量：

• GEMINI_API_KEY
• QDRANT_URL
• QDRANT_API_KEY
• BETTER_AUTH_SECRET
• NEXT_PUBLIC_APP_URL