核心用法
telegram-notify 是一个面向量化交易场景的消息通知技能，专注于将关键交易事件（entry/exit/self-heal）以一致格式推送至用户的 Telegram 私信。用户需在环境中配置 Telegram Bot Token 与用户 Chat ID，技能会自动处理消息格式化、速率限制及错误重试逻辑。
显著优点
1. 隐私优先设计：默认仅发送 DM（Direct Message），避免信息泄露至公共群组
2. 反垃圾机制：内置可选冷却期（cooldown），防止交易高频场景下的消息轰炸
3. 模板一致性：预置干净的消息模板，确保 entry/exit/self-heal 三类事件格式统一，便于快速扫描与归档
4. 自愈告警：特别针对自动化交易系统的 self-heal/restart 事件提供独立通知通道，降低系统 silent failure 风险
潜在局限
- 依赖外部服务：完全依赖 Telegram Bot API 可用性与网络连通性，存在单点故障风险
- 配置门槛：需用户自行申请 Bot Token 并获取 Chat ID，对非技术用户不够友好
- 无加密传输：消息内容在 Telegram 服务器中转，敏感策略信息存在理论泄露面
- 功能单一：仅覆盖通知场景，无内置告警分级、聚合或降噪策略
适合人群
- 运行自动化交易策略（bot/trading system）的量化交易者
- 需要远程监控交易执行状态，但不愿暴露策略细节至公共频道的用户
- 具备基础 Telegram Bot 配置能力的技术用户
常规风险
- Token 泄露：Bot Token 若硬编码或误提交至版本控制，可能导致消息被篡改或机器人被滥用
- Chat ID 变更：用户更换 Telegram 账号或清理对话后需重新配置，否则通知失效
- API 限流：Telegram 对 Bot 有频率限制（约 30 msg/sec），极端高频交易场景可能触发丢消息