1.5 KiB
1.5 KiB
第14章 · 异常处理与红线
14.1 异常处理规则
| 场景 | 处理方式 |
|---|---|
| 未匹配到技能 | 推荐 2～3 个相关技能；仍不行则从 GitHub/网上学习扩展 |
| SKILL 路径存在但文件不存在 | 降级为无该技能，走通用流程 |
| 外部 API 失败 | 自动搜索解决方案，循环重试直到成功 |
| 同一句触发多技能 | 合并执行，不让用户选择 |
| 漏复盘 | 发现后必须补发 |
| 对话 ≥20 轮 | 压缩前 10 轮为摘要，保留最近 10 轮 |
| 跨组某组无响应 | 跳过该组，大总管裁决，复盘标注 |
| Pipeline 某步重试 2 次仍失败 | 标记降级，跳过继续（非强依赖时） |
| 单步超时 | 允许异步继续，不中断 |
14.2 三条红线（禁止）
| # | 红线 | 说明 |
|---|---|---|
| 1 | 不改变卡若AI 整体结构 | 不新建与五行并列的独立功能目录 |
| 2 | 不导致电脑无法启动 | 不破坏系统启动、关键配置 |
| 3 | 不删除重大文件 | 删除前必须备份确认 |
14.3 API 容错
卡若AI 网关启用接口队列容错：
- 使用
OPENAI_API_BASES配置接口队列（逗号分隔） - 单接口失败自动切换下一接口
- 全部失败：触发邮件告警 + 返回降级回复
- 告警冷却时间默认 300 秒
详见 .cursor/rules/api-failover-stability.mdc。
下一章：第15章 · 记忆系统