📌 TrendRadar 热点监控 —— GitHub 部署流程 & 飞书推送注意事项（强化版教程）

type

status

date

Nov 16, 2025 06:48 AM

slug

summary

🚀 一、Fork 项目到你的 GitHub 账户

打开项目：https://github.com/sansan0/TrendRadar

点击右上角 “Fork”，创建你自己的副本。

🔐 二、配置 GitHub Secrets（选择推送平台）

进入你 Fork 后的仓库：

Settings → Secrets and variables → Actions → New repository secret

填入你要使用的推送平台的 Secret。

可多个平台同时使用。

例如：

保存后看不到内容属于正常（GitHub 自动隐藏）。

💬 三、我的使用体验（真实反馈）

🟦 ntfy（免费开源）

优点：下载客户端即用，无需注册

缺点：排版不太美观，偶尔乱码

✔ 适合测试用，不适合作为主力通知。

🤖 Telegram Bot

国内环境直接无法访问（被墙）

GitHub Actions 出口 IP 不稳定，可能无法推送

❌ 不推荐国内用户使用。

📧 邮箱推送

GitHub Actions IP 流动性大

网易、QQ 邮箱会判定风险自动拒绝

❌ 也不推荐。

🟩 飞书（最稳定、最推荐）

✔ 国内可用

✔ 网络稳定

✔ 群消息推送方便

✔ 支持两个方案，推荐方案二

👉 飞书 = 最佳通知方式（我个人强烈推荐）

🤝 四、飞书 Webhook 配置（方案一 & 方案二）

🅰️ 方案一：简单配置（适合个人）

📱 必须注意的重要步骤！

⚠ 群必须先在手机飞书 APP 中创建，否则无法绑定机器人到群。

⚠ 机器人必须点击“发布”才会生效，否则根本无法使用。

（这两个是很多人忽略的关键点）

方案一配置流程

1️⃣ 访问机器人指令页面

https://botbuilder.feishu.cn/home/my-command

2️⃣ 创建指令 → 选择 Webhook 触发

复制 Webhook 地址备用。

3️⃣ 参数填写：

4️⃣ 操作 → “通过官方机器人发送消息”

标题：TrendRadar 热点监控

5️⃣ 添加 “Webhook 触发” 节点（关键）

配置完成后，设为 Secret：

🅱️ 方案二（推荐）：机器人应用（更稳定、更专业）

📱 同样重要的两个提醒！

⚠ 群必须在飞书手机端提前建好

⚠ 创建机器人后必须点击“发布”才能正常使用

方案二配置流程

1️⃣ 打开机器人应用后台

https://botbuilder.feishu.cn/home/my-app

2️⃣ 创建新机器人 → 进入应用 → “流程设计”

3️⃣ 选择触发器 → Webhook 触发

复制 Webhook 地址备用。

4️⃣ “参数”填写：

5️⃣ 操作 → 发送飞书消息

勾选“群消息”，选择你创建的群。

标题填写：TrendRadar 热点监控

6️⃣ 添加“Webhook 触发”节点

完成后，将 Webhook 设置到 GitHub：

👉 方案二非常稳定，适合长期运行。

⏰ 五、CRON 定时任务（非常重要）

要删掉注释，这里给出示例与原因：

❗ 要删除的注释：

GitHub Actions 对 Cron 有严格格式要求，

注释写在 cron 行后面可能导致整个 workflow 无法解析。

📊 REPORT_MODE 报告模式说明（daily / incremental / current）

TrendRadar 的配置中，REPORT_MODE（或 report.mode）用于控制 每次推送的内容方式。

它支持三种模式：

🟦 1. daily（每日模式）

含义：

只推送今天（当天）抓取到的最新内容。

特点：

每日重置

只关注今天的热点

适合 每天固定推送一次 的场景

历史积累不会混入今日内容

推荐给：

想每天得到“今日热点总结”的用户

想保持干净、无重复的每日报告的人

🟩 2. incremental（增量模式）

含义：

每次只推送自上次推送以来新增的内容。

特点：

自动记录上一次推送的位置

不会重复推送，实际情况是每次推送会把先前的一起推送，不过在末尾会标记处此次新增内容

适合 一天多次推送 的场景

新内容出现就会推送，不会重复旧内容

实际体验：

👉 如果你设置每小时执行，这种模式最合理。

👉 多次抓取不会造成内容重复。

推荐给：

希望及时收到新内容（多次推送）的用户

内容希望“持续滚动更新”而不是每天重置的人

🟥 3. current（当前模式）

含义：

每次推送的都是本次抓取到的 所有当前发现的内容。

特点：

不去重，不管历史

每次执行都是一份全量报告

内容重复度可能很高

报性价比最低，但最简单粗暴

适合：

Debug、测试

你想“看到这次抓取的全部内容”时

不关心重复、不关心历史记录的用户

🧠 三者对比表

模式	是否重复推送	是否记录历史	适合频率	场景
daily	不重复（当天）	当天重置	1次/天	每日热点总结
incremental	不重复	持续记录	多次/天	最新消息、即时更新
current	可能重复	不记录	任意	测试 / 全量输出

⭐ 最推荐使用哪个？

如果你每天只想推送一次 → daily

如果你每小时或每半小时执行 → incremental（最佳）

如果你正在调试抓取效果 → current

🐳 六、Docker 版本

TrendRadar 也支持 Docker 部署：

适合 VPS、服务器、自托管环境

更适合不想依赖 GitHub Actions 的用户

你提到需要的话可自行研究，仓库中有 Dockerfile

（如你需要，我可以帮你做 Docker-compose 示例）

🧩 七、企业微信 / 钉钉说明

你提到：

企业微信和钉钉我没有测试

所以教程中已移除，不做推荐。

如你以后要接入，我可以帮你写专门的 Webhook 配置章节。

🎯 八、总结

推送方式	推荐指数	使用体验总结
ntfy	⭐⭐⭐	简单可用，但排版差
Telegram	⭐⭐	国内基本不能用
邮箱	⭐	GitHub IP 波动导致频繁失败
飞书方案一	⭐⭐⭐⭐	简单稳定，需要发布机器人
飞书方案二	⭐⭐⭐⭐⭐	最稳定、最专业，强烈推荐
Docker	⭐⭐⭐⭐	理解能力强的用户可选，自托管最佳