Skip to content

Latest commit

 

History

History
81 lines (51 loc) · 2.11 KB

File metadata and controls

81 lines (51 loc) · 2.11 KB

路线图与计划

方向总览

目标:从“前端本地化聊天”升级为“前后端分离的可扩展 AI 系统”。

核心里程碑:

  • 后端分离(Go Gin)
  • 服务端持久化
  • Agent 执行框架
  • MCP 工具生态接入

Phase 1:后端分离(Go Gin)

目标:将业务 API 从 Next.js Node 路由中拆分出来。

交付物:

  • 独立 Gin 服务骨架(健康检查、配置加载、日志中间件)。
  • 会话与聊天基础 API(先兼容现有前端调用)。
  • /api/chat 到 Gin 的过渡层(或网关转发)。

验收标准:

  • 前端主要聊天流程不改交互即可接入 Gin。
  • 错误码、超时、日志可观测。

Phase 2:服务端持久化

目标:将本地会话/消息迁移到服务端数据库。

交付物:

  • 会话表、消息表与基础索引。
  • CRUD + 分页查询接口。
  • 数据迁移策略(本地数据到服务端的导入流程)。

验收标准:

  • 关闭本地存储后,核心会话流程仍可稳定运行。
  • 单用户高会话量下查询性能可接受。

Phase 3:Agent 能力

目标:提供可扩展的 Agent 任务执行能力。

交付物:

  • Agent 任务模型(计划、步骤、状态、重试)。
  • 工具调用框架与执行上下文。
  • 失败恢复与最小可观测(事件日志/步骤状态)。

验收标准:

  • 至少支持一个端到端 Agent 场景(计划 -> 执行 -> 汇总输出)。
  • 失败可定位、可重试。

Phase 4:MCP 接入

目标:将外部工具能力统一接入为标准协议。

交付物:

  • MCP 网关与连接管理。
  • 工具注册、发现、鉴权与调用链路。
  • Agent 与 MCP 的组合调用策略。

验收标准:

  • 至少接入 2 个 MCP 工具并完成端到端调用。
  • 工具错误与超时可回退。

风险与缓解

  • 风险:分离期接口频繁变更影响前端节奏。
    缓解:统一 API 合约,先做兼容层。
  • 风险:Agent/MCP 增加系统复杂度。
    缓解:分阶段交付,先跑通最小闭环。
  • 风险:数据迁移带来一致性问题。
    缓解:灰度迁移与回滚脚本并行准备。