推送渠道

TrendRadar 支持 10 种推送渠道，你可以根据使用习惯选择一种或多种渠道同时接收推送。每个渠道的配置方式是在 GitHub 仓库的 Settings > Secrets and variables > Actions 中添加对应的 Secret。

配置须知

至少配置一个渠道即可使用推送功能
可以同时配置多个渠道，系统会并行推送到所有已配置的渠道
Secret 的 Name 必须与文档中标注的名称完全一致，区分大小写
Secret 保存后无法查看原始值（GitHub 安全机制），如果输入有误可以直接更新覆盖

渠道配置详情

企业微信

个人微信

飞书

钉钉

邮件

ntfy

Bark

Slack

自定义 Webhook

企业微信群机器人

企业微信群机器人是最简单、最快速的推送渠道配置方式，适合已经使用企业微信的团队。

GitHub Secret 配置

Secret 名称	值
WEWORK_WEBHOOK_URL	企业微信群机器人的 Webhook 地址

手机端配置步骤

打开企业微信 App，进入需要接收推送的内部群聊

点击右上角「...」按钮

找到并点击「群机器人」（或「消息推送」）

点击「添加」按钮

设置机器人名称（例如「TrendRadar」），点击「添加」

复制显示的 Webhook 地址

将复制的地址添加到 GitHub Secrets 中，名称为 WEWORK_WEBHOOK_URL

电脑端配置步骤

打开企业微信电脑客户端，进入需要接收推送的内部群聊

点击群聊右上角的「...」图标

找到「群机器人」选项并点击

点击「添加」，设置机器人名称（例如「TrendRadar」）

创建完成后，复制 Webhook 地址

将复制的地址添加到 GitHub Secrets 中，名称为 WEWORK_WEBHOOK_URL

提示

企业微信群机器人是所有推送渠道中配置最简单的方式，通常 2 分钟内即可完成。推送消息支持 Markdown 格式。

多账号推送

TrendRadar 支持同一渠道配置多个账号，同时向多个接收方推送消息。

配置方式

在 Secret 的值中使用英文分号 ; 分隔多个地址或令牌：

# 企业微信多群推送
WEWORK_WEBHOOK_URL = https://qyapi.weixin.qq.com/xxx1;https://qyapi.weixin.qq.com/xxx2;https://qyapi.weixin.qq.com/xxx3

# 飞书多群推送
FEISHU_WEBHOOK_URL = https://open.feishu.cn/open-apis/bot/v2/hook/aaa;https://open.feishu.cn/open-apis/bot/v2/hook/bbb

Telegram 多账号注意事项

Telegram 需要同时配置 Token 和 Chat ID 两个 Secret，多账号时两边的数量和顺序必须一一对应。例如：
TELEGRAM_BOT_TOKEN = token1;token2;token3
TELEGRAM_CHAT_ID = chatid1;chatid2;chatid3
其中 token1 对应 chatid1，token2 对应 chatid2，以此类推。

ntfy 多账号 Token 空位处理

如果某个 ntfy 账号不需要 Token（使用官方免费服务），在对应位置留空即可。例如三个主题中第二个不需要 Token：
NTFY_TOKEN = token1;;token3
中间两个分号之间为空，表示第二个主题不使用认证。
多个主题共用同一个 ntfy 服务器地址（NTFY_SERVER_URL 只支持单一值，不支持分号分隔）。

通用 Webhook 多账号

通用 Webhook 同样支持多账号：用分号分隔多个 URL（GENERIC_WEBHOOK_URL），每个 URL 可对应独立的 payload 模板（GENERIC_WEBHOOK_TEMPLATE，用分号分隔；如果只有一个模板则所有 URL 共用）。
例如：
GENERIC_WEBHOOK_URL = https://hook1.example.com;https://hook2.example.com
GENERIC_WEBHOOK_TEMPLATE = {"text":"{content}"};{"message":"{content}"}

默认每个渠道最多支持 3 个账号。

通过 config.yaml 配置

上面介绍的 GitHub Secrets 方式适合 GitHub Actions 部署。如果你使用 Docker 或本地部署，可以直接在 config/config.yaml 的 notification.channels 部分填写渠道配置：

notification:
  enabled: true
  channels:
    feishu:
      webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/your-token"

    telegram:
      bot_token: "123456:ABC-DEF..."
      chat_id: "987654321"

    wework:
      webhook_url: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"
      msg_type: "markdown"    # markdown=群机器人, text=个人微信

环境变量优先

如果同时设置了环境变量（如 FEISHU_WEBHOOK_URL）和 config.yaml 中的字段，环境变量的值会覆盖 config.yaml。这使得你可以在 config.yaml 中写默认值，通过环境变量在不同环境中灵活覆盖。

测试推送

配置完成后，可以使用以下命令发送一条测试消息，验证所有渠道是否配通：

uv run python -m trendradar --test-notification

该命令会向所有已配置的推送渠道发送一条测试消息。如果某个渠道未配置（字段为空），则会跳过该渠道。

排查推送失败

如果测试消息未收到，检查终端输出的日志。常见问题包括：Webhook URL 拼写错误、Telegram Bot Token 无效、邮件授权码过期等。日志中会显示具体的错误信息。