Nexus Agent
821cf12ade
Append CR when executing quick commands (fixes trim stripping saved \r) and allow optional dedicated Telegram bot for server offline alerts only. Co-authored-by: Cursor <cursoragent@cursor.com>
1.7 KiB
1.7 KiB
子机离线告警独立 Telegram 通道 — 设计
日期: 2026-06-13
状态: 已实现
背景与目标
运维希望将「子机离线」告警与 CPU/内存等资源告警分流：离线通知可发到专用群/专用 Bot，避免主告警群被大量离线消息淹没。
方案对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| A. 新建独立 settings 键 + 发送时路由 | 改动小；与现有 Telegram 配置一致 | 需多配一组 Token/Chat |
| B. 按服务器标签/项目路由 | 更细粒度 | 复杂度高，当前无项目维度 |
| C. 多 Bot 列表 + 规则引擎 | 可扩展 | 过度设计 |
选定 A：telegram_offline_bot_token + telegram_offline_chat_id；二者均配置时离线告警走专用通道，否则回退默认 Bot。
数据与接口
| settings 键 | Settings 属性 | 说明 |
|---|---|---|
telegram_offline_bot_token |
TELEGRAM_OFFLINE_BOT_TOKEN |
敏感，GET 掩码 |
telegram_offline_chat_id |
TELEGRAM_OFFLINE_CHAT_ID |
明文 |
send_telegram_offline_alert→resolve_offline_telegram_credentials()→send_telegram(..., bot_token, chat_id)- API：
PUT /settings/{key}、POST /settings/telegram/offline/test、GET /settings/telegram/offline/chats、POST /settings/telegram/offline/reveal-token - Layer 3 巡检仍仅用默认
telegram_bot_token（不同步离线 Bot）
安全
- Token 入
SENSITIVE_KEYS；reveal 写审计 - 不改变
notify_alert_offline开关语义
验收
- 配置离线专用 Bot+Chat 后，子机离线 Telegram 发到专用群
- 未配置离线专用时，离线告警仍走默认 Bot
- CPU/内存等资源告警始终走默认 Bot
- 设置页可保存、检测 Chat ID、发送测试消息