169 lines
3.5 KiB
Markdown
Executable File
169 lines
3.5 KiB
Markdown
Executable File
# 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 命令**:
|
|
```bash
|
|
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
|
|
```bash
|
|
sudo docker start qdrant
|
|
```
|
|
|
|
### 2. 启动 RAG API
|
|
```bash
|
|
cd /home/xia-lab/gene-family-mas-v2
|
|
source ~/miniconda3/etc/profile.d/conda.sh
|
|
conda activate gfpy312
|
|
python scripts/rag_api.py
|
|
```
|
|
|
|
### 3. 测试
|
|
```bash
|
|
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*
|