🔄 卡若AI 同步 2026-02-25 12:07 | 更新：Cursor规则、水桥平台对接、运营中枢、运营中枢参考资料、运营中枢工作台 | 排除 >20MB: 13 个

.cursor/rules/api-failover-stability.mdc

@@ -0,0 +1,29 @@
+---
+description: 卡若AI API 接口排队与故障切换稳定性规则
+alwaysApply: true
+---
+
+# 卡若AI API 稳定性规则
+
+## 目标
+- 所有 AI 请求优先走可用接口，单接口超时/报错时自动切换下一接口。
+- 全部接口都失败时，必须触发邮件告警并返回可读降级回复。
+
+## 接口排队规则（按顺序）
+- 使用 `OPENAI_API_BASES` 配置接口队列（逗号分隔）。
+- 对应密钥用 `OPENAI_API_KEYS`（可选）；若缺省则回退 `OPENAI_API_KEY`。
+- 对应模型用 `OPENAI_MODELS`（可选）；若缺省则回退 `OPENAI_MODEL`。
+
+## 故障切换规则
+- 单接口失败条件：超时、网络错误、HTTP 非 200、响应体不可解析。
+- 每次请求必须按队列顺序逐个尝试，直到成功或队列耗尽。
+- 队列耗尽后：发送告警邮件到 `ALERT_EMAIL_TO`（默认 `zhiqun@qq.com`），并返回降级回复，不得直接空响应。
+
+## 告警规则
+- SMTP 默认：`SMTP_HOST=smtp.qq.com`、`SMTP_PORT=465`。
+- 必填：`SMTP_USER`、`SMTP_PASS`、`ALERT_EMAIL_TO`（可不填则默认收件箱）。
+- 为防刷屏，告警需带冷却时间（默认 300 秒）。
+
+## 安全规则
+- 不在代码与规则里写死明文密钥。
+- 仅记录必要错误摘要，不在日志输出完整 token。