Files
smartmate/backend/agent/README.md
Losita c689af56c8 Version: 0.5.6.dev.260314
 feat(agent): 重构 Agent 分层并修复普通聊天助手消息未写入 Redis 的问题

🔧 按职责重构 backend/agent 目录为 route/chat/quicknote 三层结构

🔄 将随口记链路拆分为 graph/nodes/tool/state/prompt,其中 graph 仅负责连线

🏃 新增 quicknote runner(方法引用)来收口节点依赖,提升代码可读性

🔀 将控制码分流逻辑抽离到 agent/route,服务层改为薄封装调用

📚 更新相关 README 与测试引用路径,保持原业务逻辑不变

🐛 修复普通聊天链路遗漏 assistant 写入 Redis 的问题(确保 MySQL 和 Redis 的口径一致)
2026-03-14 19:42:26 +08:00

1.2 KiB
Raw Blame History

backend/agent 目录说明

该目录已按“路由 / 聊天 / 随口记”三层拆分,便于阅读、调试与扩展:

  1. route/
  • route.go:只负责模型控制码分流(quick_note / chat)。
  • 提供控制码解析、nonce 校验、路由兜底,不参与写库与回复拼装。
  1. chat/
  • stream.go普通聊天流式输出封装SSE/OpenAI 兼容 chunk 转换)。
  • prompt.go:聊天主系统提示词。
  1. quicknote/
  • graph.go:只负责图编排连线与分支,不承载节点内部实现。
  • nodes.go:节点实现(意图识别、优先级评估、持久化、分支选择)。
  • tool.go工具定义、参数校验、deadline 解析、写库工具打包。
  • state.go:随口记状态容器与重试状态记录。
  • prompt.go:随口记提示词(控制码路由、聚合规划、优先级评估、回复润色)。
  1. README.md(当前文件)
  • 记录目录职责边界,帮助后续继续按同样范式扩展 query/update 等技能链路。

说明:服务层仍通过 RunQuickNoteGraph 调用随口记图;若判定为非随口记意图,会自动回落到普通流式聊天链路。