推送到你每天真正会看的地方

同一份结论，发到企业微信、Telegram 和邮件里，长相必须不同。企业微信对字节数敏感，Telegram 会被切成多条，邮件需要完整的 HTML，Discord 对频率限制很严格。通知层的价值，就是把这些「渠道脾气」吸收掉，让上层只管产出内容。

14 类渠道：能力不同，策略不同

项目里常说「14 类渠道」，指的就是这些发送器。你不需要全配，配一个能稳定收到消息的就够了。配得越多，失败面越大，噪音也越大。

路由：什么消息，发给谁

通知不是「一股脑全发」。系统按消息类型路由：

变量为空表示「全量渠道」，未知渠道名也按全量处理，避免因为拼写错误而静默丢消息。这种 fail-open 的选择有代价：可能多发，但比「以为配好了其实没发」好。

降噪：别让系统变成骚扰

通知层有一道「降噪门」，在真正发送前检查：

• 严重级：info < warning < error < critical，低于 NOTIFICATION_MIN_SEVERITY 的直接丢弃。
• 静默时段：HH:MM-HH:MM 内不发（时区由 NOTIFICATION_TIMEZONE 指定）。
• 去重 TTL：相同内容在窗口内只发一次。
• 冷却：同一规则触发后，短时间内不重复提醒。

这些状态保存在进程内存里，并且是 fail-open 的：降噪逻辑本身出错时，倾向于放行而不是拦截。代价是多实例部署时状态不共享——每个实例都可能各发一次。要严格去重，就只保留一个发送入口。

格式适配：一份内容，多种排版

报告可以在两个层面渲染：默认在通知层用字符串拼装；开启 REPORT_RENDERER_ENABLED 后，使用 Jinja2 模板按平台渲染。常见输出形态有：

格式化层还处理一些很琐碎但很致命的问题：Markdown 表格在 Telegram 不生效、飞书有字节上限、企业微信的 Markdown 语法子集有限、Slack 的表格语法不同。这些不是「文案问题」，而是渠道协议差异。

排版示意，非真实推送内容

Markdown 转图片：当文字排版不可靠时

有些渠道对 Markdown 支持很差，或者长表格在手机上根本看不清。这时可以把报告渲染成图片：

• 由 MARKDOWN_TO_IMAGE_CHANNELS 指定哪些渠道需要转图；只转一次，再分发给多个渠道。
• 引擎可选 wkhtmltoimage（默认）、Markdown 文件渲染或 Playwright；缺依赖时自动回退文本。
• 超过 MARKDOWN_TO_IMAGE_MAX_CHARS（默认 15000 字符）会跳过转图，避免生成一张看不清的超长图。
• 分享海报走另一条路径：1080×720 的固定版式，历史报告可单独生成 PNG。

图片是「保底的可读性」，不是「更高级的格式」。它不可搜索、不可复制、对屏幕阅读器不友好，所以只在必要时使用。

Bot：把分析装进 IM

Bot 不是独立进程，而是跟着 --serve* 启动的后台能力。当前实际接入以Stream 长连接为主：飞书用 lark-oapi WebSocket，钉钉用 Stream 模式，自动重连、线程池处理。好处是不需要公网 IP，家里 NAS 也能用。

10 个命令

默认命令前缀是 /，中文别名可以不带前缀。命令分发器有滑动窗口限流（默认 10 次/60 秒）与管理员校验；/ask、/chat、/research 在 AGENT_MODE=false 时会明确拒绝。非命令消息可以走 LLM 意图路由，但只在私聊/@、且开启 AGENT_NL_ROUTING 与 Agent 模式时生效。

配置清单

# 至少一个通知渠道
WECHAT_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=...
# FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/...
# TELEGRAM_BOT_TOKEN=...
# TELEGRAM_CHAT_ID=...

# 路由（可选）
NOTIFICATION_REPORT_CHANNELS=wechat,feishu
NOTIFICATION_MIN_SEVERITY=warning
NOTIFICATION_TIMEZONE=Asia/Shanghai

# 图片（可选）
MARKDOWN_TO_IMAGE_CHANNELS=wechat
MD2IMG_ENGINE=wkhtmltoimage

# Bot（可选）
BOT_ENABLED=true
FEISHU_STREAM_ENABLED=true
DINGTALK_STREAM_ENABLED=false

配好后，用 Web 设置页的「测试渠道」或 python main.py --check-notify 验证，不要等第二天 18:00 才发现 Webhook 少了一个字符。

五个常见坑

源码与文档锚点