snail-ai-feature-agent 模块职责

这是 Server 端智能体对话的核心功能模块，实现了聊天请求的责任链处理、gRPC 分发、回调处理和结果持久化。

四大功能区域
1. chain/ — 聊天责任链（15 个 Handler）
按 @Order 顺序执行的对话处理链：

辅助组件： | 类 | 作用 | |----|------| |

AgentChatContext | 责任链上下文：承载所有 Handler 的输入/输出数据 | |

AgentChatHandler | Handler 接口：handle(ctx) 方法，可短路终止链 | |

ChatStreamObserver | gRPC 响应观察者：将 Client 返回的流式分片（text/thinking/completion）转发给前端 SSE | |

SubscriptionCheckHandler | 订阅校验：检查用户是否已订阅该智能体 | |

SystemPromptHandler | 系统提示词处理 | |

WebSearchHandler | 联网搜索处理 |

 

2. callback/ — Client 回调处理器
接收 Agent Client 通过 gRPC 回调的请求：

3. persist/ — 聊天结果持久化

4. 其他

在整体架构中的位置

一句话总结
snail-ai-feature-agent = Server 端智能体对话引擎，核心是 15 个 Handler 组成的责任链（初始化→会话→模型→MCP→附件→RAG→Skill→路由→gRPC 分发），配合 Client 回调处理和聊天结果持久化，完成从 HTTP 请求到 LLM 流式响应的完整链路。