feat(errors): 错误消息面向最终用户友好化

- memory::MemoryError 英文 → 中文 + 操作建议（namespace 拼写 / 后端存储 / 数据兼容性）
- llm::LlmError 各变体补充修复建议（API key / 超时 / 上下文压缩）
- tools::ToolError 各变体补充修复指引（注册工具 / 检查 Schema / 调权限 / MCP 握手）
- prompt::PromptError 各变体补充修复指引（注册子模板 / 检查语法 / 调深度限制）
- agent::AgentError::Config 中文化 + 提示需调用的 builder 方法名

src/memory/error.rs

@@ -3,21 +3,28 @@
 use thiserror::Error;
 
 /// 记忆系统错误枚举。
+///
+/// 错误消息面向最终用户（中文），并尽量附带可操作的修复建议（如检查环境变量、重试）。
 #[derive(Debug, Error)]
 pub enum MemoryError {
-    #[error("Item not found: {0}")]
+    /// 按 ID 未找到指定记忆条目。可重试——通常是 namespace 拼写错误或条目已被淘汰。
+    #[error("未找到记忆条目 '{0}'，请检查 ID 或 namespace 是否正确")]
     NotFound(String),
 
-    #[error("Storage error: {0}")]
+    /// 底层存储失败（磁盘满、连接断开等）。一般不可恢复，建议上层记录并告警。
+    #[error("存储失败: {0}，请检查后端存储是否可用（磁盘 / 网络 / 权限）")]
     Storage(String),
 
-    #[error("Serialization error: {0}")]
+    /// 序列化 / 反序列化失败（数据结构变更、JSON 字段缺失等）。一般不可恢复。
+    #[error("序列化失败: {0}，请检查数据结构兼容性或升级记忆格式")]
     Serialization(String),
 
-    #[error("Invalid input: {0}")]
+    /// 调用方传入的参数不合法（空 ID、负数容量等）。可重试——修正参数即可。
+    #[error("参数无效: {0}")]
     InvalidInput(String),
 
-    #[error("Retrieval error: {0}")]
+    /// 检索过程出错（索引重建失败、评分异常等）。可重试。
+    #[error("检索失败: {0}，可重试或调整 query")]
     RetrievalError(String),
 }
 
@@ -26,4 +33,4 @@ impl MemoryError {
     pub fn is_recoverable(&self) -> bool {
         matches!(self, Self::NotFound(_) | Self::RetrievalError(_))
     }
-}
+}