feat：缓存异常时触发警告，增加飞书hook

[yhzhang067]

rt

[github-actions]

感谢您的功能建议！

基于对代码库的分析，我发现：

当前已实现的功能

1. 飞书 (Feishu) Webhook 支持 ✅

飞书 webhook 集成已经完整实现：

• Feishu 渲染器：src/lib/webhook/renderers/feishu.ts - 支持飞书卡片消息格式
• Webhook 通知器：src/lib/webhook/notifier.ts (第 65、85、207-211 行) - 自动检测飞书 URL (open.feishu.cn) 并处理响应
• 测试覆盖：tests/unit/webhook/renderers/feishu.test.ts - 完整的单元测试

2. 熔断器告警通知 ✅

供应商熔断时的告警机制已经实现：

• 熔断器逻辑：src/lib/circuit-breaker.ts (第 267-275 行) - 当供应商失败次数达到阈值时触发告警
• 告警触发函数：src/lib/circuit-breaker.ts (第 285-299 行) - triggerCircuitBreakerAlert 函数
• 通知发送：src/lib/notification/notifier.ts (第 55、70 行) - sendCircuitBreakerAlert 函数
• 消息模板：src/lib/webhook/templates/circuit-breaker.ts - 熔断告警消息格式

3. 支持的通知类型

数据库 schema (src/drizzle/schema.ts 第 31-33 行) 定义了三种通知类型：

• circuit_breaker - 熔断器告警 ✅
• daily_leaderboard - 每日排行榜
• cost_alert - 成本告警

关于「缓存异常」告警

目前系统中的 Redis 缓存错误处理策略：

Redis 连接错误处理 (src/lib/redis/client.ts 第 135-146 行)：

• 连接错误会记录到日志
• 采用快速失败 + 重试策略（最多 5 次）
• 失败后会降级处理（返回 null）

当前行为：

• Redis 错误会记录到应用日志中
• 系统采用 fail-open 降级策略，不会阻塞主流程
• 但没有主动的 webhook 告警机制

实现建议

如果您希望在 Redis 缓存异常时也触发飞书告警，可以考虑：

1. 扩展通知类型：在 src/drizzle/schema.ts 中添加新的通知类型（如 cache_error）
2. 添加告警逻辑：在 src/lib/redis/client.ts 的错误处理中调用通知服务
3. 创建消息模板：参考 src/lib/webhook/templates/circuit-breaker.ts 创建缓存异常消息模板
4. 配置告警规则：在系统设置中添加缓存异常告警的开关和 webhook 配置

配置方式

您可以通过以下方式配置熔断器告警：

1. 系统设置：在数据库 system_config 表中配置

   • circuit_breaker_enabled: 启用熔断器告警
   • circuit_breaker_webhook: 飞书 webhook URL

2. Webhook 目标：在 webhook_targets 表中配置飞书 webhook

   • provider_type: 设置为 feishu
   • webhook_url: 飞书机器人 webhook URL (格式: https://open.feishu.cn/open-apis/bot/v2/hook/...)

---

Automated response from Claude AI

[github-actions]

This issue has been automatically marked as stale because it has not had any activity in the last 30 days.

If this issue is still relevant:

• Please comment to keep it open
• Add any new information that might help resolve it

This issue will be automatically closed in 14 days if there is no further activity.

[github-actions]

This issue has been automatically marked as stale because it has not had any activity in the last 30 days.

If this issue is still relevant:

• Please comment to keep it open
• Add any new information that might help resolve it

This issue will be automatically closed in 14 days if there is no further activity.

[github-actions]

This issue has been automatically closed due to inactivity.

If you believe this issue is still relevant, please feel free to reopen it with additional information.