需先识别代码类型及依赖文件，再按python后端（fastapi/flask）或前端（react/vue）路径部署：安装依赖→构建（前端需npm run build）→启动服务（绑定0.0.0.0）→端口冲突时清理残留进程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
将MiniMax Agent生成的项目代码部署到可运行环境，需根据代码类型、目标平台和运行时依赖选择对应路径，避免直接复制粘贴导致服务启动失败或端口冲突。
确认生成代码的项目结构与启动方式
打开Agent输出的代码根目录，检查是否存在requirements.txt、pyproject.toml、package.json、Dockerfile或Procfile等关键文件。若无任何包管理文件，说明该代码为纯脚本或前端静态资源，无需构建步骤；若有，则必须先完成依赖安装再启动。
执行ls -la（Linux/macOS）或dir（Windows）查看顶层文件，重点识别main.py、app.py、index.js、src/或dist/目录。这一步跳过会导致后续启动命令报错“ModuleNotFoundError”或“No such file or directory”。
Python后端服务部署（FastAPI/Flask）
方法一：本地快速验证
在项目根目录下运行pip install -r requirements.txt安装依赖。确保Python版本与Agent生成时声明的一致（如Python 3.10+），否则可能因asyncio语法或typing模块不兼容而报错。
启动服务：uvicorn main:app --reload --host 0.0.0.0 --port 8000（FastAPI）或flask run --host=0.0.0.0 --port=5000（Flask）。【必须绑定0.0.0.0而非localhost，否则外部设备无法访问】
方法二：生产环境容器化
创建Dockerfile，基础镜像选用python:3.12-slim而非python:3.12，减少镜像体积；WORKDIR设为/app，COPY仅包含requirements.txt和源码，避免缓存失效；CMD使用gunicorn -w 4 -b 0.0.0.0:8000 main:app替代uvicorn，提升并发承载能力。
构建并运行：docker build -t my-agent-app . && docker run -p 8000:8000 --rm my-agent-app。若提示端口被占用，先执行lsof -i :8000（macOS/Linux）或netstat -ano | findstr :8000（Windows）杀掉残留进程。
前端项目部署（React/Vue）
第一步：安装依赖并构建生产包
运行npm install或yarn install，等待完成后执行npm run build（React）或yarn build（Vue）。生成的静态文件默认位于build/或dist/目录，此目录不可直接用file://协议打开，必须通过HTTP服务托管。
第二步：启用轻量HTTP服务
无需安装Nginx或Apache，直接用npx serve -s build（React）或npx serve -s dist（Vue）启动。该命令自动启用gzip压缩、CORS头和history fallback，适配前端路由。若提示npx未找到，先运行npm install -g serve全局安装。
第三步：配置反向代理（可选）
当后端API地址为/api/xxx但实际服务在http://localhost:8000时，在serve启动前需创建serve.json，写入{"rewrites": [{"source": "/api/**", "destination": "http://localhost:8000/api/**"}]}，再执行npx serve -s build -c serve.json。
一键部署至Vercel或Render（免服务器）
1. 将代码推送到GitHub仓库，确保package.json中"scripts"包含"build"和"start"字段（前端）或"web"字段（后端）。
2. 登录Vercel，点击New Project→选择对应仓库→在Build and Output Settings中，Framework Preset选Next.js（即使非Next项目）、Other或留空；Output Directory填build（前端）或保持默认；Build Command留空（Vercel自动检测）或填npm run build。
3. 点击Deploy，等待构建完成。Vercel自动生成https://xxx.vercel.app域名，且自动处理HTTPS、CDN、缓存策略。若部署失败，检查vercel.json中routes是否覆盖了/api/*路径并指向正确函数。
Render对Python后端更友好：创建Web Service → 选择仓库 → Runtime选Python 3.12 → Build Command填pip install -r requirements.txt → Start Command填gunicorn main:app → Environment Variables添加PORT=8000（Render强制注入PORT变量，代码中必须读取该值绑定端口）。
