PlantAI-dev/docs/revisions/2026-04-11-wechat-mcp.md

2026-04-11 微信 MCP 服务集成修订记录

修订概览

• 日期: 2026-04-11
• 执行者: agent:main:github (子会话)
• 项目: bbav20311
• 目标: 将微信 MCP 服务链接到 bbav20311 项目，实现微信端基因家族分析任务触发

---

已完成工作

1. 微信服务基础架构 ✅

文件创建:

• /home/xia-lab/wutx/00test/bbav20311/wechat_service.py (6361 bytes)
• /home/xia-lab/wutx/00test/bbav20311/start_wechat_service.sh (274 bytes)

功能实现:

• MCP 工具调用封装 (call_mcp_tool)
• 消息接收 (get_messages)
• 消息发送 (send_message)
• 命令解析与处理 (handle_message)

支持的命令:

命令	功能
你是谁	查看助手介绍
帮助/help	显示可用命令
状态	查询系统状态
分析 Ft.SPL	创建基因家族分析任务

2. bbav20311 API 集成 ✅

API 端点确认:

• POST /api/new_job - 创建新任务
• POST /api/execute - 执行分析任务
• GET /api/info - 系统信息

任务创建流程:

1. 调用 /api/new_job 获取 job_id
2. 调用 /api/execute 传入参数:
   - job_id: 任务ID
   - stage: 分析阶段 (identify/phylogeny/motif/domain)
   - prefix: 基因家族名称 (如 Ft.SPL)
   - wechat_user_id: 微信用户ID

3. 服务部署 ✅

运行状态:

• 服务 PID: 2946338, 3028565
• 启动脚本: start_wechat_service.sh
• 日志文件: wechat_service.log
• 后台运行: nohup python wechat_service.py > wechat_service.log 2>&1 &

---

未完成/待办事项

1. 真实分析任务启用 ⏳

当前状态: 演示模式 问题: create_task() 函数被注释掉

# 当前代码 (第144-145行)
# 创建实际任务
# result = create_task(gene_family, stage)
# print(f"任务创建结果: {result}")

待完成:

• 确认输入数据位置 (FASTA文件)
• 确认参考数据库配置 (Pfam, PlantCARE)
• 启用真实任务创建
• 测试完整分析流程

2. 前端 Agent 状态组件集成 ⏳

当前状态: 部分完成，存在 bug

已完成:

• AgentStatusComponent 定义
• 组件模板嵌入 index.html
• 组件注册
• API 调用实现

待修复:

• jobInfo 未定义问题 (组件内部使用 this.jobInfo.job_id)
• 组件未在页面中实际使用 (缺少 <agent-status-component> 标签)

文件位置: /home/xia-lab/wutx/00test/bbav20311/apps/web/vue3/index.html

---

今日任务完成统计

任务	状态	完成度
微信 MCP 服务基础架构	✅	100%
bbav20311 API 集成	✅	100%
服务部署与启动	✅	100%
真实分析任务启用	⏳	0% (演示模式)
前端 Agent 组件集成	⚠️	70% (有bug)

总体完成度: 3.5/5 = 70%

---

明日计划 (2026-04-12)

优先级 P0 (必须完成)

1. 修复前端 Agent 状态组件 bug

   • 修复 jobInfo 传递问题
   • 在页面中添加 <agent-status-component> 标签
   • 测试组件正常渲染

2. 启用真实分析任务

   • 确认输入数据路径
   • 取消 create_task() 注释
   • 测试完整微信 → bbav20311 分析流程

优先级 P1 (建议完成)

3. 前端集成测试 (任务3)

   • 测试 Agent 状态实时更新
   • 测试多阶段任务串联显示

4. 微信服务优化

   • 添加任务状态查询命令
   • 添加分析结果推送功能

---

总体计划

阶段1: 微信集成 (当前)

• ✅ 基础服务搭建
• ✅ API 对接
• ⏳ 真实任务启用
• ⏳ 结果通知推送

阶段2: 前端完善

• ⏳ Agent 状态组件修复
• ⏳ 前端集成测试
• ⏳ 用户体验优化

阶段3: 生产化

• ⏳ 错误处理增强
• ⏳ 日志与监控
• ⏳ 性能优化

---

相关文件位置

/home/xia-lab/wutx/00test/bbav20311/
├── wechat_service.py              # 微信服务主程序
├── start_wechat_service.sh        # 启动脚本
├── wechat_service.log             # 运行日志
├── apps/web/vue3/
│   ├── index.html                 # 前端主页面 (含Agent组件)
│   └── agent_status_component.html # Agent状态组件模板
└── docs/revisions/
    └── 2026-04-11-wechat-mcp.md   # 本修订记录

---

备注

• 微信服务当前在演示模式下运行，可接收命令但不会执行真实分析
• 前端组件 bug 需要修复后才能正常显示 Agent 状态
• 建议明日优先完成 P0 任务，使系统达到可用状态