| # 单鼠姿态检测WebRTC项目部署检查清单 | |
| ## 📋 部署前检查 | |
| ### 1. 环境要求检查 | |
| - [ ] Python 3.11+ 已安装 | |
| - [ ] pip 工具可用 | |
| - [ ] 虚拟环境已创建 (推荐) | |
| - [ ] 网络连接正常 (用于下载依赖) | |
| ### 2. 文件完整性检查 | |
| - [ ] `models/kunin-mice-pose.v0.1.5n.pt` - 模型文件 (~11MB) | |
| - [ ] `requirements_gradio_webrtc.txt` - 依赖文件 | |
| - [ ] `start_gradio_webrtc.py` - 服务启动器 | |
| - [ ] `gradio_webrtc_server.py` - Gradio服务器 | |
| - [ ] `gradio_webrtc_api.py` - FastAPI服务器 | |
| - [ ] `test_gradio_webrtc_client.py` - 测试客户端 | |
| - [ ] `check_model.py` - 模型检查脚本 | |
| - [ ] `API对接文档.md` - API文档 | |
| - [ ] `README.md` - 项目主文档 | |
| ### 3. 快速部署 | |
| ```bash | |
| # 进入项目目录 | |
| cd single_mouse_webrtc_project | |
| # 运行自动部署脚本 | |
| ./deploy.sh | |
| # 或手动步骤: | |
| # 1. 安装依赖 | |
| pip install -r requirements_gradio_webrtc.txt | |
| # 2. 检查模型 | |
| python check_model.py | |
| # 3. 启动服务 | |
| python start_gradio_webrtc.py | |
| ``` | |
| ## 🧪 功能测试清单 | |
| ### 1. 基础服务测试 | |
| - [ ] Gradio界面可访问: http://localhost:7860 | |
| - [ ] API服务可访问: http://localhost:8765 | |
| - [ ] API文档可访问: http://localhost:8765/docs | |
| - [ ] 状态接口正常: `GET /api/status` | |
| ### 2. 模型功能测试 | |
| ```bash | |
| # 运行完整测试套件 | |
| python test_gradio_webrtc_client.py | |
| ``` | |
| 测试项目： | |
| - [ ] API状态检查通过 | |
| - [ ] 单帧处理功能正常 | |
| - [ ] WebSocket连接正常 | |
| - [ ] 批量处理功能正常 | |
| - [ ] 摄像头流测试通过 | |
| ### 3. 性能指标验证 | |
| - [ ] CPU模式: 6-15 FPS | |
| - [ ] GPU模式: 30+ FPS (如果可用) | |
| - [ ] 内存使用: < 2GB | |
| - [ ] 响应延迟: < 100ms | |
| ## 🔧 故障排除检查 | |
| ### 1. 常见问题检查 | |
| - [ ] 端口7860和8765未被占用 | |
| - [ ] Python版本兼容 (3.11+) | |
| - [ ] 所有依赖正确安装 | |
| - [ ] 模型文件完整且可读取 | |
| ### 2. 错误处理验证 | |
| - [ ] 无效图像输入处理正常 | |
| - [ ] 网络中断恢复正常 | |
| - [ ] 高并发连接稳定 | |
| - [ ] 内存泄漏检查 | |
| ## 📊 集成准备检查 | |
| ### 1. API兼容性 | |
| - [ ] WebSocket协议标准兼容 | |
| - [ ] REST API规范符合要求 | |
| - [ ] JSON数据格式正确 | |
| - [ ] Base64图像编码正常 | |
| ### 2. 前端集成准备 | |
| - [ ] CORS配置正确 | |
| - [ ] 错误码定义明确 | |
| - [ ] 响应格式统一 | |
| - [ ] 文档示例可用 | |
| ### 3. 性能优化配置 | |
| - [ ] 图像压缩参数合理 | |
| - [ ] 置信度阈值调优 | |
| - [ ] 批处理大小优化 | |
| - [ ] 连接池配置 | |
| ## 🚀 生产部署检查 | |
| ### 1. 安全性检查 | |
| - [ ] 服务端口访问控制 | |
| - [ ] 输入数据验证 | |
| - [ ] 错误信息过滤 | |
| - [ ] 日志记录配置 | |
| ### 2. 监控配置 | |
| - [ ] 服务健康检查 | |
| - [ ] 性能指标监控 | |
| - [ ] 错误日志收集 | |
| - [ ] 资源使用监控 | |
| ### 3. 备份与恢复 | |
| - [ ] 模型文件备份 | |
| - [ ] 配置文件备份 | |
| - [ ] 服务重启脚本 | |
| - [ ] 故障恢复流程 | |
| ## ✅ 部署完成确认 | |
| ### 最终验证步骤 | |
| 1. [ ] 运行自动化测试全部通过 | |
| 2. [ ] 与前端团队对接测试成功 | |
| 3. [ ] 性能指标达到预期 | |
| 4. [ ] 文档交付完整 | |
| 5. [ ] 监控系统配置完成 | |
| ### 交付清单 | |
| - [ ] 完整项目代码包 | |
| - [ ] 详细API对接文档 | |
| - [ ] 部署和运维指南 | |
| - [ ] 测试报告 | |
| - [ ] 性能基准数据 | |
| --- | |
| **检查完成日期**: _____________ | |
| **检查人员**: _____________ | |
| **签名确认**: _____________ |