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

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

src/tools/error.rs

@@ -5,44 +5,44 @@ use std::sync::Arc;
 /// 工具调用过程中可能发生的所有错误。
 #[derive(thiserror::Error, Debug, Clone)]
 pub enum ToolError {
-    /// 工具未注册。
-    #[error("工具 '{0}' 未注册")]
+    /// 工具未注册。不可恢复——需调用方先 `registry.register(...)`。
+    #[error("工具 '{0}' 未注册。请先用 ToolRegistry::register(...) 注册该工具，或检查 LLM 输出的工具名拼写")]
     NotFound(String),
 
-    /// 工具执行失败（可恢复——文本回传 LLM）。
-    #[error("工具 '{0}' 执行失败: {1}")]
+    /// 工具执行失败（可恢复——文本回传 LLM 由其决定重试或放弃）。
+    #[error("工具 '{0}' 执行失败: {1}。可让 LLM 调整参数后重试，或切换到备选工具")]
     ExecutionFailed(String, String),
 
     /// 工具参数无效（可恢复——文本回传 LLM）。
-    #[error("工具 '{0}' 参数无效: {1}")]
+    #[error("工具 '{0}' 参数无效: {1}。请检查 LLM 输出的参数是否符合 BaseTool::parameters() 声明的 JSON Schema")]
     InvalidArguments(String, String),
 
     /// 权限被拒绝（不可恢复——终止循环）。
-    #[error("权限被拒绝: 工具 '{0}' 需要 {1} 权限")]
+    #[error("权限被拒绝: 工具 '{0}' 需要 {1} 权限。请在 PermissionConfig 中显式允许，或人工确认后绕过")]
     PermissionDenied(String, String),
 
     /// MCP 协议错误（不可恢复）。
-    #[error("MCP 协议错误: {0}")]
+    #[error("MCP 协议错误: {0}。请检查 MCP server 版本与本库兼容，或查看 server 日志")]
     McpError(String),
 
     /// MCP 未初始化（不可恢复）。
-    #[error("MCP 未初始化: {0}")]
+    #[error("MCP 未初始化: {0}。请先调用 McpClient::initialize() 完成握手")]
     McpNotInitialized(String),
 
     /// MCP 超时（不可恢复）。
-    #[error("MCP 超时: {0}")]
+    #[error("MCP 超时: {0}。请检查 MCP server 是否存活，或调大超时配置")]
     McpTimeout(String),
 
     /// IO 错误（不可恢复）。
-    #[error("IO 错误: {0}")]
+    #[error("IO 错误: {0}。请检查文件路径、权限或磁盘空间")]
     Io(Arc<std::io::Error>),
 
-    /// 取消。
+    /// 工具执行被取消。
     #[error("工具执行已取消: {0}")]
     Cancelled(String),
 
     /// 其他未分类错误。
-    #[error("其他错误: {0}")]
+    #[error("工具调用错误: {0}")]
     Other(String),
 }