From 0ee3d989a45b845f75ba9bd3e71d4d8ffa893906 Mon Sep 17 00:00:00 2001 From: YonghaoZhao722 <118432288+YonghaoZhao722@users.noreply.github.com> Date: Thu, 30 Apr 2026 19:23:26 +0800 Subject: [PATCH] feat: improve error handling user experience Enhanced 4 critical error messages with better context and actionable solutions: 1. Model call failure: - Add detailed error context - Provide 4 solution steps (check model, switch model, verify API, check network) - Include specific commands for each solution 2. Execution exception: - Add debugging suggestions - Show log file path (~/.kwcode/kwcode.log) - Include full stack trace for troubleshooting - Suggest /plan mode and GitHub issue reporting 3. Directory not found: - Show attempted path - Provide path checking tips - Display current directory for reference - Include usage example 4. API configuration error: - Show complete usage with examples - List common API endpoints (Ollama, DeepSeek, SiliconFlow) - Clarify temp vs default commands All error messages now include: - Clear context (what happened) - Actionable solutions (what to do) - Specific examples (how to do it) - Visual improvements (icons and colors) Co-Authored-By: Claude Opus 4.7 (1M context) --- kaiwu/cli/main.py | 45 +++++++++++++++++++++++++++++++++++++++------ 1 file changed, 39 insertions(+), 6 deletions(-) diff --git a/kaiwu/cli/main.py b/kaiwu/cli/main.py index 962f83a..bbf2786 100644 --- a/kaiwu/cli/main.py +++ b/kaiwu/cli/main.py @@ -205,8 +205,13 @@ def _run_task(task, gate, orchestrator, memory, project_root, verbose, plan=Fals gate_result = gate.classify(task, memory_context=memory.load(project_root)) except Exception as e: progress.stop() - console.print(f"\n [red]模型调用失败：{e}[/red]") - console.print(" [dim]请检查模型是否正常运行（ollama list），或用 /model 切换模型[/dim]") + console.print(f"\n [red]❌ 模型调用失败[/red]") + console.print(f" [yellow]错误详情：[/yellow]{e}") + console.print("\n [cyan]💡 可能的解决方案：[/cyan]") + console.print(" 1. 检查模型是否正常运行：[dim]ollama list[/dim]") + console.print(" 2. 切换到其他模型：[dim]/model qwen3:8b[/dim]") + console.print(" 3. 检查 API 配置：[dim]/api show[/dim]") + console.print(" 4. 如果使用云端 API，检查网络连接和 API key") return False et = gate_result.get("expert_type", "chat") @@ -309,7 +314,15 @@ def _run_task(task, gate, orchestrator, memory, project_root, verbose, plan=Fals orchestrator._last_result = result except Exception as e: progress.stop() - console.print(f"\n [red]执行异常：{e}[/red]") + console.print(f"\n [red]❌ 执行异常[/red]") + console.print(f" [yellow]错误详情：[/yellow]{e}") + console.print("\n [cyan]💡 调试建议：[/cyan]") + console.print(" 1. 查看详细日志：[dim]~/.kwcode/kwcode.log[/dim]") + console.print(" 2. 尝试更简单的任务描述") + console.print(" 3. 使用 /plan 模式查看执行步骤：[dim]/plan <任务描述>[/dim]") + console.print(" 4. 如果问题持续，请在 GitHub 提交 issue") + import traceback + console.print(f"\n [dim]堆栈跟踪：\n{traceback.format_exc()}[/dim]") return False # ── Output: user-friendly result summary ── @@ -606,7 +619,13 @@ def _repl(model_path, ollama_url, ollama_model, project_root, verbose): verbose=verbose, ) else: - console.print(f" [red]目录不存在: {new_root}[/red]") + console.print(f" [red]❌ 目录不存在[/red]") + console.print(f" [yellow]路径：[/yellow]{new_root}") + console.print("\n [cyan]💡 提示：[/cyan]") + console.print(" • 检查路径拼写是否正确") + console.print(" • 使用绝对路径或相对路径") + console.print(f" • 当前目录：[dim]{os.getcwd()}[/dim]") + console.print(" • 示例：[dim]/cd ~/projects/myapp[/dim]") elif cmd == "/experts": experts = registry.list_experts() @@ -973,11 +992,25 @@ def _handle_api_command(parts: list[str], current_url: str, current_model: str): sub = parts[1] if sub not in ("temp", "default"): - console.print(" [red]未知子命令[/red]，用法: /api show | /api temp | /api default ") + console.print(" [red]❌ 未知子命令[/red]") + console.print("\n [cyan]用法：[/cyan]") + console.print(" /api show - 查看当前 API 配置") + console.print(" /api temp [key] - 临时切换 API（本次会话）") + console.print(" /api default [key] - 永久保存 API 配置") + console.print("\n [cyan]示例：[/cyan]") + console.print(" /api temp http://localhost:11434") + console.print(" /api default https://api.deepseek.com sk-xxx") return None if len(parts) < 3: - console.print(" [red]缺少URL参数[/red]，例: /api temp http://localhost:11434") + console.print(" [red]❌ 缺少 URL 参数[/red]") + console.print("\n [cyan]示例：[/cyan]") + console.print(" /api temp http://localhost:11434") + console.print(" /api default https://api.deepseek.com your-api-key") + console.print("\n [cyan]常用 API 地址：[/cyan]") + console.print(" • Ollama 本地：http://localhost:11434") + console.print(" • DeepSeek：https://api.deepseek.com") + console.print(" • 硅基流动：https://api.siliconflow.cn/v1") return None new_url = parts[2].rstrip("/")