docs: 增加答疑方式的区别和调整排版等

This commit is contained in:
sansan 2025-09-21 15:33:05 +08:00
parent 30c40314c0
commit b73f16d7cd
2 changed files with 87 additions and 77 deletions

View File

@ -36,7 +36,7 @@ notification:
silent_push: silent_push:
enabled: false # 是否启用静默推送模式,如果 true则启用 enabled: false # 是否启用静默推送模式,如果 true则启用
# 因为我们白嫖的 github 服务器执行时间不稳定,所以时间范围要根据实际尽可能大一点,留足 2 小时 # 因为我们白嫖的 github 服务器执行时间不稳定,所以时间范围要尽可能大一点,至少留足 2 小时
# 如果你想寻求稳定的按时的推送,建议通过 docker 部署在个人的服务器上 # 如果你想寻求稳定的按时的推送,建议通过 docker 部署在个人的服务器上
time_range: time_range:
start: "20:00" # 推送时间范围开始(北京时间) start: "20:00" # 推送时间范围开始(北京时间)
@ -46,7 +46,7 @@ notification:
# 请务必妥善保管好 webhooks不要公开 # 请务必妥善保管好 webhooks不要公开
# 如果你以 fork 的方式将本项目部署在 GitHub 上,请勿在此填写任何 webhooks而是将 webhooks 填入 GitHub Secret # 如果你以 fork 的方式将本项目部署在 GitHub 上,请勿在此填写任何 webhooks而是将 webhooks 填入 GitHub Secret
# 不然轻则手机上收到奇怪的广告推送,重则存在一定的安全隐患 # 不然轻则手机上收到奇怪的广告推送,重则存在更严重的安全隐患
webhooks: webhooks:
feishu_url: "" # 飞书机器人的 webhook URL feishu_url: "" # 飞书机器人的 webhook URL
dingtalk_url: "" # 钉钉机器人的 webhook URL dingtalk_url: "" # 钉钉机器人的 webhook URL

160
readme.md
View File

@ -23,8 +23,10 @@
> 本项目以轻量,易部署为目标 > 本项目以轻量,易部署为目标
>
> 遇到问题提 issues或【硅基茶水间】公众号相关文章下留言 - **详细问题** → 选择 [GitHub Issues](https://github.com/sansan0/TrendRadar/issues),准备好截图和日志等。
- **快速咨询** → 选择【硅基茶水间】公众号文章留言或私信,尽量说清核心问题。
- 遇到问题可选择以上 2 种方式获得帮助,[点此跳转到两者的区别](#问题答疑与1元点赞)
<details> <details>
<summary>👉 点击查看<strong>致谢名单</strong> (当前 <strong>🔥22🔥</strong> 位)</summary> <summary>👉 点击查看<strong>致谢名单</strong> (当前 <strong>🔥22🔥</strong> 位)</summary>
@ -75,19 +77,40 @@
### **全网热点聚合** ### **全网热点聚合**
- 今日头条
- 百度热搜
- 华尔街见闻
- 澎湃新闻
- bilibili 热搜
- 财联社热门
- 凤凰网
- 贴吧
- 微博
- 抖音
- 知乎 - 知乎
- 抖音
- bilibili 热搜
- 华尔街见闻
- 贴吧
- 百度热搜
- 财联社热门
- 澎湃新闻
- 凤凰网
- 今日头条
- 微博
默认监控 11 个主流平台,如想额外增加,可看最下方的**自定义监控平台** 默认监控 11 个主流平台,如想额外增加其它平台,可自行增加
<details>
<summary><strong>👉 自定义监控平台</strong></summary>
### 🔧 自定义监控平台
本项目的资讯数据来源于 [newsnow](https://github.com/ourongxing/newsnow) ,你可以点击[网站](https://newsnow.busiyi.world/),点击[更多],查看是否有你想要的平台。
具体添加可访问 [项目源代码](https://github.com/ourongxing/newsnow/tree/main/server/sources),根据里面的文件名,在 `config/config.yaml` 文件中修改 `platforms` 配置:
```yaml
platforms:
- id: "toutiao"
name: "今日头条"
- id: "baidu"
name: "百度热搜"
- id: "wallstreetcn-hot"
name: "华尔街见闻"
# 添加更多平台...
```
</details>
### **智能推送策略** ### **智能推送策略**
@ -124,7 +147,42 @@
**实际效果**:把分散在各个平台的热搜合并起来,按照你关心的热度重新排序 **实际效果**:把分散在各个平台的热搜合并起来,按照你关心的热度重新排序
> 这三个比例可以选择适合自己的场景进行调整,具体见【热点权重调整】 > 这三个比例可以选择适合自己的场景进行调整
<details>
<summary><strong>👉 热点权重调整</strong></summary>
<br>
当前默认的配置是平衡性配置
### 两个核心场景
**追实时热点型**
```yaml
weight:
rank_weight: 0.8 # 主要看排名
frequency_weight: 0.1 # 不太在乎持续性
hotness_weight: 0.1
```
**适用人群**:自媒体博主、营销人员、想快速了解当下最火话题的用户
**追深度话题型**
```yaml
weight:
rank_weight: 0.4 # 适度看排名
frequency_weight: 0.5 # 重视当天内的持续热度
hotness_weight: 0.1
```
**适用人群**:投资者、研究人员、新闻工作者、需要深度分析趋势的用户
### 调整的方法
1. **三个数字加起来必须等于 1.0**
2. **哪个重要就调大哪个**:在乎排名就调大 rank_weight在乎持续性就调大 frequency_weight
3. **建议每次只调 0.1-0.2**,观察效果
核心思路:追求速度和时效性的用户提高排名权重,追求深度和稳定性的用户提高频次权重。
</details>
### **多渠道实时推送** ### **多渠道实时推送**
@ -154,7 +212,7 @@ GitHub 一键 Fork 即可使用,无需编程基础。
**典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取 **典型场景:** 股市投资监控、品牌舆情追踪、行业动态关注、生活资讯获取
| Github Pages 网页效果(手机端适配) | 飞书推送效果 | | Github Pages 网页效果(手机端适配) | 飞书推送效果 |
|:---:|:---:| |:---:|:---:|
| ![Github Pages效果](_image/github-pages.png) | ![飞书推送效果](_image/feishu.jpg) | | ![Github Pages效果](_image/github-pages.png) | ![飞书推送效果](_image/feishu.jpg) |
@ -689,28 +747,6 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
</details> </details>
<details>
<summary><strong>👉 自定义监控平台</strong></summary>
### 🔧 自定义监控平台
本项目的资讯数据来源于 [newsnow](https://github.com/ourongxing/newsnow) ,你可以点击[网站](https://newsnow.busiyi.world/),点击[更多],查看是否有你想要的平台。
具体添加可访问 [项目源代码](https://github.com/ourongxing/newsnow/tree/main/server/sources),根据里面的文件名,在 `config/config.yaml` 文件中修改 `platforms` 配置:
```yaml
platforms:
- id: "toutiao"
name: "今日头条"
- id: "baidu"
name: "百度热搜"
- id: "wallstreetcn-hot"
name: "华尔街见闻"
# 添加更多平台...
```
</details>
<details> <details>
<summary><strong>👉 Docker 部署</strong></summary> <summary><strong>👉 Docker 部署</strong></summary>
@ -905,45 +941,10 @@ docker exec -it trend-radar ls -la /app/config/
</details> </details>
<details>
<summary><strong>👉 热点权重调整</strong></summary>
<br>
当前默认的配置是平衡性配置 ## ☕问题答疑与1元点赞
### 两个核心场景 > 心意到就行,收到的**点赞**用于提高开发者开源的积极性。你们的**点赞**已记录于最顶部的【致谢名单】
**追实时热点型**
```yaml
weight:
rank_weight: 0.8 # 主要看排名
frequency_weight: 0.1 # 不太在乎持续性
hotness_weight: 0.1
```
**适用人群**:自媒体博主、营销人员、想快速了解当下最火话题的用户
**追深度话题型**
```yaml
weight:
rank_weight: 0.4 # 适度看排名
frequency_weight: 0.5 # 重视当天内的持续热度
hotness_weight: 0.1
```
**适用人群**:投资者、研究人员、新闻工作者、需要深度分析趋势的用户
### 调整的方法
1. **三个数字加起来必须等于 1.0**
2. **哪个重要就调大哪个**:在乎排名就调大 rank_weight在乎持续性就调大 frequency_weight
3. **建议每次只调 0.1-0.2**,观察效果
核心思路:追求速度和时效性的用户提高排名权重,追求深度和稳定性的用户提高频次权重。
</details>
## ☕ 学习交流与1元点赞
> 心意到就行,收到的点赞用于提高开发者开源的积极性
<div align="center"> <div align="center">
@ -953,10 +954,19 @@ weight:
</div> </div>
| 答疑方式 | 适用场景 | 响应时间 | 详细程度 | 如何提问 |
|---------|---------|---------|---------|---------|
| **GitHub Issues** | 部署配置问题<br/>功能异常 | 1-2天内 | 针对性强 | 📋 **提供完整信息**<br/>• 尽量截图<br/>• 错误日志<br/>• 系统环境等等 |
| **公众号留言** | 快速咨询<br/>使用疑问<br/>功能了解 | 几小时 | 简要指导 | 💡 **抓住问题核心**<br/>• 一句话描述问题<br/>• 说明想要的效果 |
### 项目相关 ### 项目相关
> **两篇文章** > **3 篇文章**
- [可在该文章下方留言,方便项目作者用手机答疑](https://mp.weixin.qq.com/s/KYEPfTPVzZNWFclZh4am_g)
- [2个月破 1000 star我的GitHub项目推广实战经验](https://mp.weixin.qq.com/s/jzn0vLiQFX408opcfpPPxQ) - [2个月破 1000 star我的GitHub项目推广实战经验](https://mp.weixin.qq.com/s/jzn0vLiQFX408opcfpPPxQ)
- [基于本项目,如何开展公众号或者新闻资讯类文章写作](https://mp.weixin.qq.com/s/8ghyfDAtQZjLrnWTQabYOQ) - [基于本项目,如何开展公众号或者新闻资讯类文章写作](https://mp.weixin.qq.com/s/8ghyfDAtQZjLrnWTQabYOQ)