部署说明文档系统要求最低配置CPU: 2核及以上内存: 4GB 及以上硬盘: 10GB 可用空间操作系统: Windows 10/Linux Ubuntu 20.04/macOS 12Python 版本: 3.9 ~ 3.12推荐配置CPU: 4核内存: 8GB硬盘: 50GB SSD网络: 可正常访问API服务环境部署详细步骤1. Python环境准备Windows系统# 下载安装 Python 3.12 # 官网: # 安装时勾选 Add Python to PATH python --versionLinux (Ubuntu/Debian) 系统sudo apt update sudo apt install python3 python3-pip python3-venv -y python3 --version2. 创建虚拟环境推荐做法3. 安装项目依赖pip install -r requirements.txt4. 配置环境变量# 创建 .env 文件内容参考 .env.example关键配置项说明 | 配置项 | 说明 | 示例值 | |--------|------|--------| | VOLCENGINE_API_KEY | API密钥 | 21xxxxxxxxxxxxx | | VOLCENGINE_EP | 接入点EP | https:// | | DOUBAO_API_KEY | Doubao-Seed-2.0-lite密钥 | xxxxxxxxxxxxx | | DOUBAO_EP | Doubao接入点EP | | | DEBUG | 调试模式开关 | True/False |5. 验证系统完整性# 运行所有系统测试 python tests/test_system.py所有测试项通过则环境配置成功。6. 启动生产级服务# 开发环境启动 python main.py # 生产环境建议 uvicorn backend.main:app --host 0.0.0.0 --port 8000 --workers 47. 访问验证打开浏览器访问:API健康检查: http://localhost:8000/前端界面: 直接打开 frontend/index.html常见问题排查Q: OpenCV 安装失败?A: 改用镜像源安装:Q: LLM API 调用超时?A: 检查网络连接确认可访问服务在 config.py 中调整超时时间。Q: 端口 8000 被占用?A: 修改启动命令更换端口如:--port 8080安全建议生产环境不要开启 DEBUG 模式妥善保管 API Key不要提交到公开代码仓库配置 HTTPS 证书