rag-debuglisted
Install: claude install-skill hyhmrright/Confer
按顺序执行以下诊断步骤,汇总哪一步有问题并给出修复建议:
**1. Qdrant 集合状态**
```bash
curl -s http://localhost:6333/collections/knowledge_chunks | jq '{points: .result.points_count, status: .result.status}'
```
预期:`status: "green"`,`points > 0`(若已上传文档)
**2. 最近嵌入日志**
```bash
docker logs confer-gateway-1 2>&1 | grep -E 'embed|chunk|qdrant|vector' | tail -20
```
检查是否有错误(400 Bad Request 通常是 ULID 未转 UUID)
**3. Embedding provider 生效情况**
检查 `packages/gateway/src/lib/embedding.ts` 中 `EMBEDDING_PROVIDER_PRIORITY` 顺序,
再查环境变量哪个 key 已配置:
```bash
docker exec confer-gateway-1 env | grep -E 'OPENAI_API_KEY|GLM_API_KEY|QWEN_API_KEY' | sed 's/=.*/=***/'
```
**4. MinIO 存储状态**
```bash
docker exec confer-minio-1 mc ls local/knowledge-docs/ 2>/dev/null | tail -10
```
若 mc 未配置,改用:
```bash
docker logs confer-minio-1 2>&1 | grep -E 'PUT|GET|ERROR' | tail -10
```
**5. Gateway 服务健康**
```bash
docker ps --filter name=confer-gateway --format "{{.Names}}: {{.Status}}"
```
**常见问题速查**:
- Qdrant 400 → ULID 未转 UUID,检查 `toUUID()` 是否调用
- 嵌入维度不匹配 → 切换了 provider 但 collection 维度未重建(需删除 collection 重建)
- MinIO 连接拒绝 → Docker 网络用 `minio:9000`,不能用 `localhost:9000`
- 无日志输出 → 检查 stream.ts 中 RAG tool 是否注册到当前 conversation 类型