✨ feat(agent): 重构 Agent 分层并修复普通聊天助手消息未写入 Redis 的问题 🔧 按职责重构 backend/agent 目录为 route/chat/quicknote 三层结构 🔄 将随口记链路拆分为 graph/nodes/tool/state/prompt,其中 graph 仅负责连线 🏃 新增 quicknote runner(方法引用)来收口节点依赖,提升代码可读性 🔀 将控制码分流逻辑抽离到 agent/route,服务层改为薄封装调用 📚 更新相关 README 与测试引用路径,保持原业务逻辑不变 🐛 修复普通聊天链路遗漏 assistant 写入 Redis 的问题(确保 MySQL 和 Redis 的口径一致)
1.2 KiB
1.2 KiB
backend/agent 目录说明
该目录已按“路由 / 聊天 / 随口记”三层拆分,便于阅读、调试与扩展:
route/
route.go:只负责模型控制码分流(quick_note/chat)。- 提供控制码解析、nonce 校验、路由兜底,不参与写库与回复拼装。
chat/
stream.go:普通聊天流式输出封装(SSE/OpenAI 兼容 chunk 转换)。prompt.go:聊天主系统提示词。
quicknote/
graph.go:只负责图编排连线与分支,不承载节点内部实现。nodes.go:节点实现(意图识别、优先级评估、持久化、分支选择)。tool.go:工具定义、参数校验、deadline 解析、写库工具打包。state.go:随口记状态容器与重试状态记录。prompt.go:随口记提示词(控制码路由、聚合规划、优先级评估、回复润色)。
README.md(当前文件)
- 记录目录职责边界,帮助后续继续按同样范式扩展
query/update等技能链路。
说明:服务层仍通过
RunQuickNoteGraph调用随口记图;若判定为非随口记意图,会自动回落到普通流式聊天链路。