PlantAI-dev/.worktrees/router-error-detail/PROJECT_PLAN.md

bbav5 项目总规划

项目目标

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

当前状态

• 项目路径: /home/xia-lab/wutx/00test/bbav5
• 端口: 7867 ✅ 服务运行中
• RAG端口: 8001 ✅ 服务运行中

---

任务清单

Phase 1: 项目初始化 ✅

• 复制项目（排除 input/workspace）
• 修改端口 7865 → 7867
• 修改 RAG 端口 8000 → 8001
• 更新项目路径 bbav20311 → bbav5
• 添加 DiscoveryAgent（9个Agent）

Phase 2: 代码清理 ✅

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

Phase 3: LangGraph 迁移 ✅

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

Phase 4: 测试验证 ✅

• RAG 服务启动（gene-family-mas-v2 端口 8001）
• KnowledgeAgent 单测通过
• LangGraph Orchestrator FAQ 流程测试通过
• bbav5 服务启动（端口 7867）
• 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 模式)

curl http://localhost:7867/api/agent/chat \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"message": "什么是SPL基因家族", "model": "kimi"}'

响应:

{
    "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 测试通过	✅