From d65ef7800f9e17ef7eeb833a4950528884d76c6a Mon Sep 17 00:00:00 2001 From: sansan <77180927+sansan0@users.noreply.github.com> Date: Tue, 29 Jul 2025 19:10:18 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=B0=83=E6=95=B4=20readme=20=E6=8E=92?= =?UTF-8?q?=E7=89=88=EF=BC=8C=E6=84=9F=E8=B0=A2=E7=AC=AC=E4=B8=80=E4=B8=AA?= =?UTF-8?q?=E7=82=B9=E8=B5=9E=E4=BA=BA=E7=9A=84=E6=94=AF=E6=8C=81=20?= =?UTF-8?q?=E2=80=94=E2=80=94=20**=E9=BE=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- readme.md | 134 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 69 insertions(+), 65 deletions(-) diff --git a/readme.md b/readme.md index aae076c..7a4c9ab 100644 --- a/readme.md +++ b/readme.md @@ -20,22 +20,14 @@ -> 如果本项目帮到了你，**点个 Star ⭐** +> 本项目以轻量，易部署为目标，主要处理 issues > > 遇到问题提 issues，或【硅基茶水间】公众号留言 -> -> 详细步骤和使用说明都有，耐心往下翻，很多地方可以点击展开 -> -> 本项目以轻量，易部署为目标，主要处理 issues - - ## ✨ 核心功能 ### **全网热点聚合** -默认监控 11 个主流平台 - - 今日头条 - 百度热搜 - 华尔街见闻 @@ -48,17 +40,11 @@ - 抖音 - 知乎 -> _理论上支持 35 个左右，如果想额外增加，可看最下方的**自定义监控平台**_ +默认监控 11 个主流平台，如想额外增加，可看最下方的**自定义监控平台** ### **智能推送策略** -提供三种工作模式满足不同需求： - -| 模式 | 推送时机 | 显示内容 | 适用场景 | -|------|----------|----------|----------| -| **当日汇总模式**
`daily` | 按时推送 | 当日所有匹配新闻
+ 新增新闻区域 | 日报总结
全面了解当日热点趋势 | -| **当前榜单模式**
`current` | 按时推送 | 当前榜单匹配新闻
+ 新增新闻区域 | 实时热点追踪
了解当前最火的内容 | -| **增量监控模式**
`incremental` | 有新增才推送 | 新出现的匹配频率词新闻 | 避免重复信息干扰
高频监控场景 | +三种推送模式： - **📈 投资者/交易员** → 选择 `incremental`，及时获取新增资讯 - **📰 自媒体人/内容创作者** → 选择 `current`，掌握实时热点趋势 @@ -68,8 +54,6 @@ 设置个人关键词（如：AI、比亚迪、教育政策），只推送相关热点，过滤无关信息 -> _比如关注"新能源"，自动筛选出特斯拉降价、政策补贴等相关新闻_ - ### **多渠道实时推送** 支持**企业微信**、**飞书**、**钉钉**、**Telegram**，消息直达手机 @@ -78,24 +62,56 @@ GitHub 一键 Fork 即可使用，无需编程基础。 -> _如果要手机接收通知， 要达到 1 分钟部署完毕的效果，请选择**企业微信**_ +> 如果要手机接收通知， 要达到 1 分钟部署完毕的效果，请选择**企业微信** ### **减少 APP 依赖** -不再需要频繁打开各种资讯 APP，有效控制手机使用时间 - -> _从"被算法推荐绑架"变成"主动获取自己想要的信息"_ +从"被算法推荐绑架"变成"主动获取自己想要的信息" **适合人群：** 投资者、自媒体人、企业公关、关心时事的普通用户 **典型场景：** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取 -**💡 提示：** 想要网页版？进入你的仓库 Settings → Pages，启用 GitHub Pages 即可获得自动更新的新闻页面链接。比如我这里[TrendRadar](https://sansan0.github.io/TrendRadar/)。 +**💡 提示：** 想要网页版？进入你的仓库 Settings → Pages，启用 GitHub Pages。比如我这里[TrendRadar](https://sansan0.github.io/TrendRadar/)。

最新推送效果

+
+👉 点击查看推送格式说明 + +## 📊 输出示例 + +### 通知示例： + +``` +📊 热点词汇统计 + +🔥 人工智能 AI : 12 条 + + 1. [百度热搜] 科技巨头发布新AI模型 [1] - 12时30分 (4次) + + 2. [今日头条] AI技术最新突破 [2] - [13时15分 ~ 14时30分] (2次) + +``` + +### 消息格式说明 + +| 格式元素 | 示例 | 含义 | 说明 | +| ------------- | --------------------------- | ------------ | --------------------------------------- | +| **关键词** | **人工智能 AI** | 频率词组 | 表示本组匹配的关键词 | +| : N 条 | : 12 条 | 匹配数量 | 该关键词组匹配的标题总数 | +| [平台名] | [百度热搜] | 来源平台 | 标题所属的平台名称 | +| [**数字**] | [**1**] | 高排名标记 | 排名 ≤ 阈值(默认 5)的热搜，红色加粗显示 | +| [数字] | [7] | 普通排名标记 | 排名>阈值的热搜，普通显示 | +| - 时间 | - 12 时 30 分 | 首次发现时间 | 标题首次被发现的时间 | +| [时间 ~ 时间] | [12 时 30 分 ~ 14 时 00 分] | 时间范围 | 标题出现的时间范围(首次~最后) | +| (N 次) | (4 次) | 出现次数 | 标题在监控期间出现的总次数 | + + +
+ ## 📝 更新日志 **升级说明：** @@ -107,6 +123,10 @@ GitHub 一键 Fork 即可使用，无需编程基础。 - 重构代码 - 解决版本号容易被遗漏修改的问题 +
+👉 点击查看历史更新 + + ### 2025/07/27 - v2.0.1 **修复问题**: @@ -118,9 +138,6 @@ GitHub 一键 Fork 即可使用，无需编程基础。 - 方案二：减少推送平台，优先选择**企业微信**或**Telegram**，这两个推送我做了分批推送功能(因为分批推送影响推送体验，且只有这两个平台只给一点点推送容量，所以才不得已做了分批推送功能，但至少能保证获得的信息完整) - 方案三：可与方案二结合，模式选择 current 或 incremental 可有效减少一次性推送的内容 -
-📝 点击查看历史更新 - ### 2025/07/17 - v2.0.0 **重大重构**： @@ -225,10 +242,10 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号 在你 Fork 后的仓库中，进入 `Settings` > `Secrets and variables` > `Actions` > `New repository secret`，然后根据需要配置以下任一或多个通知平台： - **💡 提示：** 可以同时配置多个平台，系统会向所有配置的平台发送通知。点击下方对应平台展开详细配置步骤。 + 可以同时配置多个平台，系统会向所有配置的平台发送通知。
- 🟡 企业微信机器人（配置最简单最迅速） + 👉 企业微信机器人（配置最简单最迅速） **GitHub Secret 配置：** - 名称：`WEWORK_WEBHOOK_URL` @@ -246,7 +263,7 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号
- 🟢 飞书机器人（消息显示最友好） + 👉 飞书机器人（消息显示最友好） **GitHub Secret 配置：** - 名称：`FEISHU_WEBHOOK_URL` @@ -290,7 +307,7 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号
- 🔵 钉钉机器人 + 👉 钉钉机器人 **GitHub Secret 配置：** - 名称：`DINGTALK_WEBHOOK_URL` @@ -317,7 +334,7 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号
- 🟣 Telegram Bot + 👉 Telegram Bot **GitHub Secret 配置：** - 名称：`TELEGRAM_BOT_TOKEN` - 你的 Telegram Bot Token @@ -351,12 +368,14 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号 - **关键词配置**: 修改 `config/frequency_words.txt` 文件，添加你关心的关键词 - **运行模式配置**: 在 `config/config.yaml` 中修改 `report.mode` 设置： - - `"daily"` - 当日汇总模式（默认） - - `"current"` - 当前榜单模式 - - `"incremental"` - 增量监控模式 + | 模式 | 推送时机 | 显示内容 | 适用场景 | + |------|----------|----------|----------| + | **当日汇总模式**
`daily` | 按时推送 | 当日所有匹配新闻
+ 新增新闻区域 | 日报总结
全面了解当日热点趋势 | + | **当前榜单模式**
`current` | 按时推送 | 当前榜单匹配新闻
+ 新增新闻区域 | 实时热点追踪
了解当前最火的内容 | + | **增量监控模式**
`incremental` | 有新增才推送 | 新出现的匹配频率词新闻 | 避免重复信息干扰
高频监控场景 |
- ⚙️ 点击查看 frequency_words.txt 配置教程 + 👉 点击查看 frequency_words.txt 配置教程 在 `frequency_words.txt` 文件中配置监控的关键词，支持三种语法和词组功能。 @@ -515,34 +534,6 @@ frequency_words.txt 文件增加了一个【必须词】功能，使用 + 号 - 同时通过配置的机器人发送通知到你的群组 -## 📊 输出示例 - -### 通知示例： - -``` -📊 热点词汇统计 - -🔥 人工智能 AI : 12 条 - - 1. [百度热搜] 科技巨头发布新AI模型 [1] - 12时30分 (4次) - - 2. [今日头条] AI技术最新突破 [2] - [13时15分 ~ 14时30分] (2次) - -``` - -### 消息格式说明 - -| 格式元素 | 示例 | 含义 | 说明 | -| ------------- | --------------------------- | ------------ | --------------------------------------- | -| **关键词** | **人工智能 AI** | 频率词组 | 表示本组匹配的关键词 | -| : N 条 | : 12 条 | 匹配数量 | 该关键词组匹配的标题总数 | -| [平台名] | [百度热搜] | 来源平台 | 标题所属的平台名称 | -| [**数字**] | [**1**] | 高排名标记 | 排名 ≤ 阈值(默认 5)的热搜，红色加粗显示 | -| [数字] | [7] | 普通排名标记 | 排名>阈值的热搜，普通显示 | -| - 时间 | - 12 时 30 分 | 首次发现时间 | 标题首次被发现的时间 | -| [时间 ~ 时间] | [12 时 30 分 ~ 14 时 00 分] | 时间范围 | 标题出现的时间范围(首次~最后) | -| (N 次) | (4 次) | 出现次数 | 标题在监控期间出现的总次数 | - ### 🔧 自定义监控平台 @@ -561,6 +552,9 @@ platforms: # 添加更多平台... ``` +
+👉 点击查看 docker 部署 + ### 🐳 Docker 部署 1. **克隆项目并进入目录**: @@ -602,10 +596,12 @@ platforms: # 显示帮助信息 docker exec -it trend-radar python manage.py help ``` - +
## ☕ 学习交流与1元点赞 +> 心意到就行，收到的点赞用于提高开发者开源的积极性 +
|公众号关注 |微信点赞 | 支付宝点赞 | @@ -614,7 +610,14 @@ platforms:
+感谢以下热心观众的点赞 +| 点赞人 | 金额 | 日期 | 备注 | +| :-------------------------: | :----: | :----: | :-----------------------: | +| **龙 | 10.00 | 2025.7.29 | 支持一下 | + +
+👉 点击查看使用流程图 ```mermaid flowchart TD @@ -655,6 +658,7 @@ flowchart TD style O fill:#e8f5e8 ``` +
[![Star History Chart](https://api.star-history.com/svg?repos=sansan0/TrendRadar&type=Date)](https://www.star-history.com/#sansan0/TrendRadar&Date)