PlantAI-rag/docs/plans/PROJECT_STATUS.md

Gene Family MAS V2 - 项目状态记录

最后更新: 2026-03-19 17:45

---

已完成的功能

Phase 1: 对话记忆系统 ✅

功能	状态	说明
MemoryManager	✅	SQLite fallback 实现
存储/检索	✅	测试通过
查询增强	✅	自动添加上下文
前端集成	✅	bbav20311 支持 RAG 模式

关键文件:

• src/rag/memory/memory_manager.py
• src/rag/memory/conversation_store.py

Phase 2: Qdrant 向量存储 ✅

功能	状态	说明
Docker 部署	✅	端口 6333
向量搜索	✅	query_points API
HybridRetriever	✅	集成测试通过

关键文件:

• src/rag/vector_store_qdrant.py
• scripts/migrate_to_qdrant.py

Docker 命令:

sudo docker start qdrant
sudo docker stop qdrant

Phase 3: 检索增强 ✅

功能	状态	说明
引用数加权	✅	CitationRanker 实现
时效性加权	✅	年份归一化

关键文件:

• src/rag/citation_ranker.py

---

架构决策

LangGraph vs Fallback

模式	状态	决策
LangGraph	⚠️ 可用但未启用	暂不启用，保持简单
Fallback	✅ 当前使用	稳定，满足需求

理由:

• Fallback 已实现 90% 功能
• LangGraph 增加复杂度，需要更多测试
• 当前网络环境不稳定

---

已知问题

1. Mem0 API Key 警告

Mem0 init failed: api_key client option must be set

解决: 使用 SQLite fallback，无影响

2. QueryAnalysis 参数缺失

QueryAnalysis.__init__() missing required_info

解决: 已在 orchestrator.py 添加 required_info=[]

3. FastAPI Deprecation 警告

on_event is deprecated

解决: 无影响，功能正常

---

启动命令

1. 启动 Qdrant

sudo docker start qdrant

2. 启动 RAG API

cd /home/xia-lab/gene-family-mas-v2
source ~/miniconda3/etc/profile.d/conda.sh
conda activate gfpy312
python scripts/rag_api.py

3. 测试

curl -X POST http://localhost:8001/chat \
  -H "Content-Type: application/json" \
  -d '{"query": "SPL基因家族", "user_id": "u1", "session_id": "s1"}'

---

后续计划

短期（本周）

• 完整测试记忆功能（连续对话）
• 验证 Qdrant 向量搜索
• 前端集成测试

中期（下周）

• 数据迁移到 Qdrant（完整版）
• 评估 LangGraph 启用
• 性能优化

长期（可选）

• 启用 LangGraph 多跳检索
• 配置 OpenAI API（如果需要）
• 生产部署

---

新增文件清单

gene-family-mas-v2/
├── src/rag/memory/
│   ├── __init__.py
│   ├── memory_manager.py
│   └── conversation_store.py
├── src/rag/citation_ranker.py
├── src/rag/vector_store_qdrant.py (更新)
├── scripts/
│   ├── migrate_to_qdrant.py
│   ├── test_qdrant_docker.py
│   ├── test_memory_api.py
│   └── rag_api.py (更新)
├── start_v2.sh
├── start_qdrant_docker.sh
└── memory/
    ├── 2026-03-19-v2-*.md

---

依赖状态

依赖	版本	状态
Python	3.12	✅
LangGraph	0.2.76	✅ 已安装
Mem0	1.0.6	✅ SQLite fallback
Qdrant Client	1.17.0	✅
Qdrant Docker	1.17.0	✅ 运行中

---

记录位置: /home/xia-lab/gene-family-mas-v2/PROJECT_STATUS.md