RecallDesk

混合检索 RAG 服务：上传文档 → 分块 → embedding → Qdrant 混合检索（dense 语义 + 服务端 BM25 关键词，RRF 融合），可选查询改写与本地 Ollama 重排；附带离线检索评测（recall@k / MRR）与 Web 控制台。

技术栈：FastAPI / PostgreSQL（元数据 + Outbox）/ Redis Stream（任务队列）/ Qdrant / React + Vite。

支持格式：.txt / .md / .csv / .json / .pdf（PDF 走 pypdf 提取文本层，纯扫描件会被拒绝）。

部署（Docker）

前置：Docker，以及本机 Ollama 拉好两个模型：

ollama pull mxbai-embed-large
ollama pull dengcao/Qwen3-Reranker-4B:Q4_K_M

准备配置（查询改写需要 OpenAI 兼容 LLM，按注释填；重排走本机 Ollama）：

cp .env.example .env

启动：

docker compose up -d

• 控制台：http://127.0.0.1:5173
• API：http://127.0.0.1:8001（Swagger 文档在 /docs）

本地开发

docker compose up -d postgres redis qdrant   # 只起基础设施
pip install -e .

uvicorn app.main:app --reload                 # API
python -m app.publisher.document            # 以下四个 worker 各开一个终端
python -m app.consumer.document
python -m app.publisher.eval
python -m app.consumer.eval

快速试用

curl -X POST http://127.0.0.1:8001/documents -F 'file=@./a.txt'   # 上传（后台异步索引）
curl 'http://127.0.0.1:8001/search?q=苹果有什么营养&top_k=3'       # 混合检索