故障排查

常见问题、调试技巧。

常见问题

1. Agent 无响应

可能原因：

• 模型 API 不可用
• 网络连接问题
• 配置错误

解决方法：

# 检查配置
/config show

# 测试 API 连接
/ping

# 查看日志
/logs

2. 工具调用失败

可能原因：

• 权限不足
• 参数错误
• 文件不存在

解决方法：

• 检查工具权限设置
• 查看详细错误信息
• 确认文件路径正确

3. 记忆丢失

可能原因：

• Workspace 切换
• 文件未保存
• 缓存问题

解决方法：

• 检查 memory/ 目录
• 查看 MEMORY.md 内容
• 重新加载 Agent

调试技巧

# 启用详细日志
/debug on

# 显示推理过程
/reasoning on

# 查看系统提示
/system-prompt

调试检查清单

• [ ] 检查网络连接
• [ ] 确认配置正确
• [ ] 查看错误日志
• [ ] 测试 API 连接
• [ ] 检查文件权限

---

← 上一节：性能优化 | 返回进阶指南 →