docs: 调整 readme 排版,感谢第一个点赞人的支持 —— **龙

This commit is contained in:
sansan 2025-07-29 19:10:18 +08:00
parent 789a7890cc
commit d65ef7800f

134
readme.md
View File

@ -20,22 +20,14 @@
</div> </div>
> 如果本项目帮到了你,**点个 Star ⭐** > 本项目以轻量,易部署为目标,主要处理 issues
> >
> 遇到问题提 issues或【硅基茶水间】公众号留言 > 遇到问题提 issues或【硅基茶水间】公众号留言
>
> 详细步骤和使用说明都有,耐心往下翻,很多地方可以点击展开
>
> 本项目以轻量,易部署为目标,主要处理 issues
## ✨ 核心功能 ## ✨ 核心功能
### **全网热点聚合** ### **全网热点聚合**
默认监控 11 个主流平台
- 今日头条 - 今日头条
- 百度热搜 - 百度热搜
- 华尔街见闻 - 华尔街见闻
@ -48,17 +40,11 @@
- 抖音 - 抖音
- 知乎 - 知乎
> _理论上支持 35 个左右,如果想额外增加,可看最下方的**自定义监控平台**_ 默认监控 11 个主流平台,如想额外增加,可看最下方的**自定义监控平台**
### **智能推送策略** ### **智能推送策略**
提供三种工作模式满足不同需求: 三种推送模式:
| 模式 | 推送时机 | 显示内容 | 适用场景 |
|------|----------|----------|----------|
| **当日汇总模式**<br/>`daily` | 按时推送 | 当日所有匹配新闻<br/>+ 新增新闻区域 | 日报总结<br/>全面了解当日热点趋势 |
| **当前榜单模式**<br/>`current` | 按时推送 | 当前榜单匹配新闻<br/>+ 新增新闻区域 | 实时热点追踪<br/>了解当前最火的内容 |
| **增量监控模式**<br/>`incremental` | 有新增才推送 | 新出现的匹配频率词新闻 | 避免重复信息干扰<br/>高频监控场景 |
- **📈 投资者/交易员** → 选择 `incremental`,及时获取新增资讯 - **📈 投资者/交易员** → 选择 `incremental`,及时获取新增资讯
- **📰 自媒体人/内容创作者** → 选择 `current`,掌握实时热点趋势 - **📰 自媒体人/内容创作者** → 选择 `current`,掌握实时热点趋势
@ -68,8 +54,6 @@
设置个人关键词AI、比亚迪、教育政策只推送相关热点过滤无关信息 设置个人关键词AI、比亚迪、教育政策只推送相关热点过滤无关信息
> _比如关注"新能源"自动筛选出特斯拉降价、政策补贴等相关新闻_
### **多渠道实时推送** ### **多渠道实时推送**
支持**企业微信**、**飞书**、**钉钉**、**Telegram**,消息直达手机 支持**企业微信**、**飞书**、**钉钉**、**Telegram**,消息直达手机
@ -78,24 +62,56 @@
GitHub 一键 Fork 即可使用,无需编程基础。 GitHub 一键 Fork 即可使用,无需编程基础。
> _如果要手机接收通知, 要达到 1 分钟部署完毕的效果,请选择**企业微信**_ > 如果要手机接收通知, 要达到 1 分钟部署完毕的效果,请选择**企业微信**
### **减少 APP 依赖** ### **减少 APP 依赖**
不再需要频繁打开各种资讯 APP有效控制手机使用时间 从"被算法推荐绑架"变成"主动获取自己想要的信息"
> _从"被算法推荐绑架"变成"主动获取自己想要的信息"_
**适合人群:** 投资者、自媒体人、企业公关、关心时事的普通用户 **适合人群:** 投资者、自媒体人、企业公关、关心时事的普通用户
**典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取 **典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取
**💡 提示:** 想要网页版?进入你的仓库 Settings → Pages启用 GitHub Pages 即可获得自动更新的新闻页面链接。比如我这里[TrendRadar](https://sansan0.github.io/TrendRadar/)。 **💡 提示:** 想要网页版?进入你的仓库 Settings → Pages启用 GitHub Pages。比如我这里[TrendRadar](https://sansan0.github.io/TrendRadar/)。
<p align="center"> <p align="center">
<img src="_image/2025-06-14.jpg" alt="最新推送效果" width="400"/> <img src="_image/2025-06-14.jpg" alt="最新推送效果" width="400"/>
</p> </p>
<details>
<summary><strong>👉 点击查看推送格式说明</strong></summary>
## 📊 输出示例
### 通知示例:
```
📊 热点词汇统计
🔥 人工智能 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 次) | 出现次数 | 标题在监控期间出现的总次数 |
</details>
## 📝 更新日志 ## 📝 更新日志
**升级说明:** **升级说明:**
@ -107,6 +123,10 @@ GitHub 一键 Fork 即可使用,无需编程基础。
- 重构代码 - 重构代码
- 解决版本号容易被遗漏修改的问题 - 解决版本号容易被遗漏修改的问题
<details>
<summary><strong>👉 点击查看历史更新</strong></summary>
### 2025/07/27 - v2.0.1 ### 2025/07/27 - v2.0.1
**修复问题**: **修复问题**:
@ -118,9 +138,6 @@ GitHub 一键 Fork 即可使用,无需编程基础。
- 方案二:减少推送平台,优先选择**企业微信**或**Telegram**,这两个推送我做了分批推送功能(因为分批推送影响推送体验,且只有这两个平台只给一点点推送容量,所以才不得已做了分批推送功能,但至少能保证获得的信息完整) - 方案二:减少推送平台,优先选择**企业微信**或**Telegram**,这两个推送我做了分批推送功能(因为分批推送影响推送体验,且只有这两个平台只给一点点推送容量,所以才不得已做了分批推送功能,但至少能保证获得的信息完整)
- 方案三:可与方案二结合,模式选择 current 或 incremental 可有效减少一次性推送的内容 - 方案三:可与方案二结合,模式选择 current 或 incremental 可有效减少一次性推送的内容
<details>
<summary><strong>📝 点击查看历史更新</strong></summary>
### 2025/07/17 - v2.0.0 ### 2025/07/17 - v2.0.0
**重大重构** **重大重构**
@ -225,10 +242,10 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
在你 Fork 后的仓库中,进入 `Settings` > `Secrets and variables` > `Actions` > `New repository secret`,然后根据需要配置以下任一或多个通知平台: 在你 Fork 后的仓库中,进入 `Settings` > `Secrets and variables` > `Actions` > `New repository secret`,然后根据需要配置以下任一或多个通知平台:
**💡 提示:** 可以同时配置多个平台,系统会向所有配置的平台发送通知。点击下方对应平台展开详细配置步骤。 可以同时配置多个平台,系统会向所有配置的平台发送通知。
<details> <details>
<summary>🟡 <strong>企业微信机器人</strong>(配置最简单最迅速)</summary> <summary> <strong>👉 企业微信机器人</strong>(配置最简单最迅速)</summary>
**GitHub Secret 配置:** **GitHub Secret 配置:**
- 名称:`WEWORK_WEBHOOK_URL` - 名称:`WEWORK_WEBHOOK_URL`
@ -246,7 +263,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
</details> </details>
<details> <details>
<summary>🟢 <strong>飞书机器人</strong>(消息显示最友好)</summary> <summary> <strong>👉 飞书机器人</strong>(消息显示最友好)</summary>
**GitHub Secret 配置:** **GitHub Secret 配置:**
- 名称:`FEISHU_WEBHOOK_URL` - 名称:`FEISHU_WEBHOOK_URL`
@ -290,7 +307,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
</details> </details>
<details> <details>
<summary>🔵 <strong>钉钉机器人</strong></summary> <summary> <strong>👉 钉钉机器人</strong></summary>
**GitHub Secret 配置:** **GitHub Secret 配置:**
- 名称:`DINGTALK_WEBHOOK_URL` - 名称:`DINGTALK_WEBHOOK_URL`
@ -317,7 +334,7 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
</details> </details>
<details> <details>
<summary>🟣 <strong>Telegram Bot</strong></summary> <summary> <strong>👉 Telegram Bot</strong></summary>
**GitHub Secret 配置:** **GitHub Secret 配置:**
- 名称:`TELEGRAM_BOT_TOKEN` - 你的 Telegram Bot Token - 名称:`TELEGRAM_BOT_TOKEN` - 你的 Telegram Bot Token
@ -351,12 +368,14 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
- **关键词配置**: 修改 `config/frequency_words.txt` 文件,添加你关心的关键词 - **关键词配置**: 修改 `config/frequency_words.txt` 文件,添加你关心的关键词
- **运行模式配置**: 在 `config/config.yaml` 中修改 `report.mode` 设置: - **运行模式配置**: 在 `config/config.yaml` 中修改 `report.mode` 设置:
- `"daily"` - 当日汇总模式(默认) | 模式 | 推送时机 | 显示内容 | 适用场景 |
- `"current"` - 当前榜单模式 |------|----------|----------|----------|
- `"incremental"` - 增量监控模式 | **当日汇总模式**<br/>`daily` | 按时推送 | 当日所有匹配新闻<br/>+ 新增新闻区域 | 日报总结<br/>全面了解当日热点趋势 |
| **当前榜单模式**<br/>`current` | 按时推送 | 当前榜单匹配新闻<br/>+ 新增新闻区域 | 实时热点追踪<br/>了解当前最火的内容 |
| **增量监控模式**<br/>`incremental` | 有新增才推送 | 新出现的匹配频率词新闻 | 避免重复信息干扰<br/>高频监控场景 |
<details> <details>
<summary><strong>⚙️ 点击查看 frequency_words.txt 配置教程</strong></summary> <summary><strong>👉 点击查看 frequency_words.txt 配置教程</strong></summary>
`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:
# 添加更多平台... # 添加更多平台...
``` ```
<details>
<summary><strong>👉 点击查看 docker 部署</strong></summary>
### 🐳 Docker 部署 ### 🐳 Docker 部署
1. **克隆项目并进入目录**: 1. **克隆项目并进入目录**:
@ -602,10 +596,12 @@ platforms:
# 显示帮助信息 # 显示帮助信息
docker exec -it trend-radar python manage.py help docker exec -it trend-radar python manage.py help
``` ```
</details>
## ☕ 学习交流与1元点赞 ## ☕ 学习交流与1元点赞
> 心意到就行,收到的点赞用于提高开发者开源的积极性
<div align="center"> <div align="center">
|公众号关注 |微信点赞 | 支付宝点赞 | |公众号关注 |微信点赞 | 支付宝点赞 |
@ -614,7 +610,14 @@ platforms:
</div> </div>
感谢以下热心观众的点赞
| 点赞人 | 金额 | 日期 | 备注 |
| :-------------------------: | :----: | :----: | :-----------------------: |
| **龙 | 10.00 | 2025.7.29 | 支持一下 |
<details>
<summary><strong>👉 点击查看使用流程图</strong></summary>
```mermaid ```mermaid
flowchart TD flowchart TD
@ -655,6 +658,7 @@ flowchart TD
style O fill:#e8f5e8 style O fill:#e8f5e8
``` ```
</details>
[![Star History Chart](https://api.star-history.com/svg?repos=sansan0/TrendRadar&type=Date)](https://www.star-history.com/#sansan0/TrendRadar&Date) [![Star History Chart](https://api.star-history.com/svg?repos=sansan0/TrendRadar&type=Date)](https://www.star-history.com/#sansan0/TrendRadar&Date)