error-handling.md

# 通用错误处理

所有命令在遇到以下错误时，遵循统一处理策略。

## 错误码与 Agent 应对

| 错误码 | 含义 | Agent 应对 |
|--------|------|-----------|
| — | AK 未配置（命令入口预检查） | 输出 AK 引导话术（见 SKILL.md） |
| 400 | 参数不合法 | 检查用户输入是否正确，引导用户修正 |
| 429 | 请求被限流 | 建议用户稍后重试（通常等待 1-2 分钟） |
| 500 | 服务端异常 | 建议用户稍后重试 |

## 网络异常

CLI 已内置 3 次重试（指数退避），重试耗尽后返回 `success: false`。

Agent 应对：告知用户"网络异常，请检查网络连接后重试"。

## 业务错误

当 API 返回 `hasError: true` 或 `data.success: false` 时：

1. 输出 `markdown` 字段（用户可读的错误描述）
2. 检查 `markdown` 中的关键词，按 SKILL.md 异常处理表追加对应引导