核心用法
Notify 是面向 AI 代理的通知调度中枢，核心解决「何时、通过什么渠道、以什么形式」触达用户。
路由矩阵是核心决策框架：系统宕机/安全警报 → 即时推送+聊天；2小时内截止任务 → 即时主渠道；任务完成 → 5-15分钟批处理；日报周报 → 定时邮件/聊天；调试日志 → 仅记录不打扰。
四步执行流程：1) 判断事件紧急等级（1-5级）；2) 匹配渠道（Telegram/Discord/邮件/SMS/推送）；3) 检查静默时段（默认23:00-08:00，仅5级可破例）；4) 格式化输出（按渠道限制裁剪内容）。
显著优点
- 防疲劳设计完善：静默时段、批处理（5分钟内3条合并）、禁止「仍在运行」类无意义通知，从源头减少噪音
- 渠道适配精细：Telegram禁用表格、SMS限160字符、邮件要求可执行主题行，避免格式灾难
- 内容质量规则明确：强制「结果导向」开头（"✅ 部署完成"而非"Task completed ✅"），必须包含影响+建议动作
- 降级策略合理：关键警报最多3次尝试，2小时间隔+跨渠道切换，防止骚扰循环
局限性与风险
- 依赖前置配置：首次使用需确认用户时区、主渠道、关键警报渠道，缺失任一将导致路由失误或静默失效
- 「关键」定义模糊：文档未提供判定标准，实际依赖实现者的主观分级，可能引发过度警报或漏报
- 批处理时序陷阱：5分钟窗口+定时摘要可能导致紧急但不关键的消息（如3.5级）延迟到次日早晨，存在时效风险
- 跨渠道一致性：同一事件在不同渠道呈现形式差异大，用户可能因信息碎片化产生困惑
适合人群
- 构建 AI Agent 的开发者，需替代「打印日志」式粗糙通知
- 多项目协作场景，需按项目分组降噪
- 跨时区团队，需自动适配用户本地时间的调度系统
常规风险
| 风险场景 | 说明 |
|---------|------|
| 时区误判 | 未配置时区时静默时段计算错误，可能在用户深夜推送 |
| 分级滥用 | 将所有通知标为5级「破窗」，导致真正紧急信息被淹没 |
| 渠道冗余 | 忽略「同一消息不发3个渠道」规则，造成轰炸体验 |
| 隐私合规 | 未提及用户同意机制，关键警报的SMS/推送可能涉及GDPR/电信法规风险 |