https://github.com/sansan0/TrendRadarTrendRadar 是一个开源的多平台热点聚合与 AI 分析工具，支持监控 35 个平台（如抖音、知乎、B站、华尔街见闻等），通过关键词筛选、自动推送和 AI 对话分析，帮助用户高效处理新闻资讯。项目支持 GitHub 一键部署、Docker 容器化运行，无需编程。项目开源地址：https://github.com/sansan0/TrendRadar，目前该项目已在Github上已收获近3.5w的star，首先感谢开源作者做出的贡献！
本文将基于项目介绍提供的方案，提供一个详细的关于本项目的GitHub Fork 部署（适合无本地环境）方法，协助新用户快速使用。
关键要点
- 部署方式：优先推荐 Docker（一行命令启动），或 GitHub Fork（无需本地环境）。
- 核心配置：修改 config.yaml（平台、推送、AI 设置）和 frequency_words.txt（关键词），并设置 API Keys（如 Webhook）。
- 时间估算：30 秒网页部署，1-5 分钟完成通知推送和 AI 分析配置。
- 依赖：Python 3+（本地运行时），Docker（推荐），GitHub Secrets（Fork 部署）。
- 注意事项：配置 API Keys 时，确保名称严格匹配；测试时使用项目自带样本数据。
第一步: 准备环境
前置条件：
拥有一个 GitHub 账号。
拥有一个用于接收通知的渠道（推荐：企业微信、飞书、钉钉、Telegram 或 Bark）。
GitHub Fork 部署（适合无本地环境）：Fork 项目仓库 https://github.com/sansan0/TrendRadar，无需安装软件。
访问项目主页：https://github.com/sansan0/TrendRadar
点击右上角的 Fork 按钮。
在弹出的页面中，点击 Create fork。注意：这会将项目完整的复制一份到你的 GitHub 账号下。
第二步：配置推送渠道 (GitHub Secrets)
为了保护你的隐私（如 Webhook 地址），不要直接修改代码文件，而是使用 GitHub Secrets。
进入你刚刚 Fork 的仓库页面。
| 推送渠道 | Secret Name (名称) | Secret Value (值) 的获取方式 |
| 企业微信 (推荐) | WEWORK_WEBHOOK_URL | 企业微信群 -> 右上角… -> 添加群机器人 -> 复制 Webhook 地址 |
| 飞书 | FEISHU_WEBHOOK_URL | 飞书群 -> 设置 -> 群机器人 -> 添加机器人 -> 复制 Webhook 地址 |
| 钉钉 | DINGTALK_WEBHOOK_URL | 钉钉群 -> 智能群助手 -> 添加机器人 -> 复制 Webhook |
| Telegram | TELEGRAM_BOT_TOKEN | 找 @BotFather 创建机器人获取 Token |
| Telegram | TELEGRAM_CHAT_ID | 获取你与机器人的 Chat ID |
| Bark (iOS) | BARK_URL | 下载 Bark App -> 复制服务器地址 (如 https://api.day.app/你的Key/) |
| Slack | SLACK_WEBHOOK_URL | Slack App -> Incoming Webhooks -> 复制 Webhook URL |
重要说明（请务必仔细阅读）：
- ✅ 一个 Name 对应一个 Secret：每添加一个配置项，点击一次"New repository secret"按钮，填写一对"Name"和"Secret"
- ✅ 保存后看不到值是正常的：出于安全考虑，保存后重新编辑时，只能看到 Name（名称），看不到 Secret（值）的内容
- ⚠️ 严禁自创名称：Secret 的 Name（名称）必须严格使用下方列出的名称（如 WEWORK_WEBHOOK_URL、FEISHU_WEBHOOK_URL 等），不能自己随意修改或创造新名称，否则系统无法识别
- 💡 可以同时配置多个平台：系统会向所有配置的平台发送通知
这里以飞书为例。
-
电脑浏览器打开 https://botbuilder.feishu.cn/home/my-command，登录飞书账号。
-
点击"新建机器人指令"
-
点击"选择触发器"，往下滑动，点击"Webhook 触发"
-
此时你会看到"Webhook 地址"，把这个链接先复制到本地记事本暂存，继续接下来的操作
-
"参数"里面放上下面的内容，然后点击"完成"
{
"message_type": "text",
"content": {
"total_titles": "{{内容}}",
"timestamp": "{{内容}}",
"report_type": "{{内容}}",
"text": "{{内容}}"
}
}
-
点击"选择操作" > "通过官方机器人发消息"
-
消息标题填写"TrendRadar 热点监控"
-
最关键的部分来了，点击 + 按钮，选择"Webhook 触发"，然后按照下面的图片摆放
- 点击完成并启用，如此处报错系统错误，请在手机端飞书搜索机器人并获取机器人助手应用，再启用即可解决。
- 回到github的New repository secret中，添加值，保存。
第三步：启用 GitHub Actions (自动运行)
因为 Fork 的项目默认会禁用 Actions，你需要手动开启。回到自己Fork仓库的界面，注意是自己Fork的分支，不是官方主界面。
点击仓库顶部的 Actions 标签页。
你会看到一个绿色按钮 I understand my workflows, go ahead and enable them，点击它。
第四步：测试运行 (验证是否可用)
不需要等待定时任务，我们手动触发一次来测试。
点击仓库顶部的 Actions 标签页。
-
页面会出现一个黄色的圆圈在转，表示正在运行（通常需要 1-3 分钟）。
-
如果变成 ✅ 绿色对号，说明运行成功。
-
检查手机： 此时你的飞书/微信/Bark 应该已经收到了热点推送消息。
至此，一个飞书的github网页推送流程就部署好了。
常见问题排查
Action 运行失败 (红色叉号)：
-
点击失败的任务进去看 Run crawler 步骤的日志。
-
错误：Permission denied -> 检查 Settings -> Actions -> General -> Workflow permissions，确保勾选了 Read and write permissions。
-
错误：Secrets not found -> 检查第二步 Secret 的名称是否拼写正确（全大写，下划线）。
没有收到推送：
-
检查 Webhook 地址是否包含了 https://。
-
企业微信/钉钉机器人通常有安全设置，需要在机器人后台勾选“自定义关键词”，并确保推送的内容里包含这个关键词（TrendRadar 默认通常包含“热点”、“榜单”等词，建议关键词设为“热点”）。
总结
-
状态： 🟢 可用 (截至 2025年12月)
-
维护情况： 项目更新非常活跃（GitHub 显示最近几天有代码提交），文档较新。本文将持续更新，后续将详细介绍该项目如何进行高级配置调整、AI分析等，敬请期待！
-
最后，如果你喜欢本文内容，不要忘了点点关注点点赞！再次感谢开源项目的各位贡献者。https://github.com/sansan0/TrendRadar
