# bbav5 项目总规划

## 项目目标
将 bbav20311 迁移到 LangGraph 框架，实现 9 个 Agent 的图结构编排

## 当前状态
- 项目路径: `/home/xia-lab/wutx/00test/bbav5`
- 端口: 7867 ✅ 服务运行中
- RAG端口: 8001 ✅ 服务运行中

---

## 任务清单

### Phase 1: 项目初始化 ✅
- [x] 复制项目（排除 input/workspace）
- [x] 修改端口 7865 → 7867
- [x] 修改 RAG 端口 8000 → 8001
- [x] 更新项目路径 bbav20311 → bbav5
- [x] 添加 DiscoveryAgent（9个Agent）

### Phase 2: 代码清理 ✅
- [x] 删除测试文件（test_*.py）
- [x] 删除 demo 文件
- [x] 保留微信集成文件（wechat_*.py）
- [x] 删除旧 RAG 实现（kb/）
- [x] 删除备份文件（backup/, *.bak, *.backup.*）
- [x] 删除实验性代码（langchain_agent.py）
- [x] 删除日志文件（logs/, *.log）
- [x] 删除修订记录（REVISION_*.md）
- [x] 保留文档（项目记录/, codeMiaoshu/）

### Phase 3: LangGraph 迁移 ✅
- [x] 安装 langgraph 依赖 (0.2.0)
- [x] 设计 StateGraph 结构
- [x] 创建 LangGraphOrchestrator 类
- [x] 实现 9 个 Agent 节点
- [x] 构建条件边和路由
- [x] 更新 apps/web/vue3/main.py 使用新的 LangGraphOrchestrator
- [x] 保留原 orchestrator.py 作为参考
- [x] 调整 RAG 集成（gene-family-mas-v2 端口 8001）

### Phase 4: 测试验证 ✅
- [x] RAG 服务启动（gene-family-mas-v2 端口 8001）
- [x] KnowledgeAgent 单测通过
- [x] LangGraph Orchestrator FAQ 流程测试通过
- [x] bbav5 服务启动（端口 7867）
- [x] API 测试通过（/api/agent/chat）
- [ ] 前端页面测试
- [ ] 完整分析流程测试（ANALYSIS 模式）

---

## 9 个 Agent 清单
1. RouterAgent - 意图路由 ✅
2. PlanningAgent - 任务规划 ✅
3. ExecutionAgent - 任务执行 ✅
4. KnowledgeAgent - 知识检索（RAG）✅
5. DiagnosisAgent - 错误诊断 ✅
6. ValidatorAgent - 结果验证 ✅
7. ResultParserAgent - 结果解析 ✅
8. LearningAgent - 学习优化 ✅
9. DiscoveryAgent - 科学发现（新增）✅

---

## LangGraph 工作流图

```
Router -> [条件分支]
    ├── FAQ/CONSULTATION/INTERPRETATION -> Knowledge -> END ✅ 已测试
    └── ANALYSIS -> Planning -> Execution -> Validator
        ├── 失败 -> Diagnosis -> [重试/结束]
        └── 成功 -> ResultParser -> Discovery -> Learning -> END
```

---

## 测试结果

### ✅ API 测试 (FAQ 模式)
```bash
curl http://localhost:7867/api/agent/chat \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"message": "什么是SPL基因家族", "model": "kimi"}'
```

**响应:**
```json
{
    "success": true,
    "intent": {
        "stage": "identify",
        "taskType": "faq",
        "params": {},
        "confidence": 0.9,
        "message": "处理完成"
    },
    "model_used": "kimi",
    "session_id": "test_api_007",
    "mode": "langgraph",
    "current_agent": "knowledge"
}
```

### ✅ RAG 集成测试
```
查询: "什么是SPL基因家族的功能？"
回答: 找到 5 条相关文献。涉及物种: Arabidopsis。涉及基因家族: NAC, SPL。
来源: Arabidopsis_SPL_2010, Arabidopsis_SPL_2025_Hortic_Res 等
```

---

## 服务状态

| 服务 | 端口 | 状态 |
|------|------|------|
| bbav5 | 7867 | ✅ 运行中 |
| gene-family-mas-v2 | 8001 | ✅ 运行中 |

---

## 下一步任务
**Phase 4 完成: 最终验证**

可选执行：
1. 前端页面测试（浏览器访问 http://localhost:7867）
2. 完整分析流程测试（ANALYSIS 模式，需要配置 LLM API Key）
3. 微信集成测试

---

## 修订记录
| 时间 | 任务 | 状态 |
|------|------|------|
| 2026-04-12 11:37 | Phase 1 完成 | ✅ |
| 2026-04-12 11:47 | 添加 DiscoveryAgent | ✅ |
| 2026-04-12 12:07 | Phase 2 代码清理完成 | ✅ |
| 2026-04-12 12:15 | LangGraph 编排器创建完成 | ✅ |
| 2026-04-12 12:25 | 更新 main.py 使用 LangGraphOrchestrator | ✅ |
| 2026-04-12 12:35 | RAG 服务启动，KnowledgeAgent 测试通过 | ✅ |
| 2026-04-12 12:40 | LangGraph Orchestrator FAQ 流程测试通过 | ✅ |
| 2026-04-12 12:50 | bbav5 服务启动，API 测试通过 | ✅ |