常见问题 (FAQ)

常见问题和故障排除提示。

---

🚀 入门

Q: 最低硬件要求是什么？

A: 基础使用：

• CPU: 任何现代处理器
• 内存: 4GB 最低，推荐 8GB+
• 存储: 2GB 可用空间

GPU 加速：

• NVIDIA: GTX 1060 6GB 或更好
• Apple Silicon: M1 或更新

---

🐛 安装问题

Q: CUDA 可用但检测不到

A: 验证 PyTorch CUDA：

python -c "import torch; print(torch.cuda.is_available())"

如果为 False，重新安装正确 CUDA 版本：

pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118

---

⚡ 性能

Q: 如何提高推理速度？

A: 尝试这些优化：

1. 使用更小的模型：

   MODEL_NAME=yolov8n.pt

2. 降低分辨率：

   canvas.toBlob(sendFrame, 'image/jpeg', 0.7)

3. 启用 GPU：

   DEVICE=cuda:0

Q: 内存不足错误

A: 减少内存使用：

MODEL_NAME=yolov8n.pt
MAX_CONCURRENCY=1

---

🎯 模型使用

Q: 如何检测自定义对象？

A: 使用开放词汇检测：

curl -X POST "http://localhost:8000/infer" \
  -F "model=google/owlvit-base-patch32" \
  -F "file=@image.jpg" \
  -F "text_queries=your custom object"

---

🔗 还需要帮助？

• 文档
• GitHub Issues