Forráskód Böngészése

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

sansan 7 hónapja
szülő
commit
b73f16d7cd
2 módosított fájl, 84 hozzáadás és 74 törlés
  1. 2 2
      config/config.yaml
  2. 82 72
      readme.md

+ 2 - 2
config/config.yaml

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

+ 82 - 72
readme.md

@@ -23,8 +23,10 @@
 
 
 > 本项目以轻量,易部署为目标
->
-> 遇到问题提 issues,或【硅基茶水间】公众号相关文章下留言
+
+- **详细问题** → 选择 [GitHub Issues](https://github.com/sansan0/TrendRadar/issues),准备好截图和日志等。 
+- **快速咨询** → 选择【硅基茶水间】公众号文章留言或私信,尽量说清核心问题。
+- 遇到问题可选择以上 2 种方式获得帮助,[点此跳转到两者的区别](#问题答疑与1元点赞)
 
 <details>
 <summary>👉 点击查看<strong>致谢名单</strong> (当前 <strong>🔥22🔥</strong> 位)</summary>
@@ -75,19 +77,40 @@
 
 ### **全网热点聚合**
 
-- 今日头条
-- 百度热搜
-- 华尔街见闻
-- 澎湃新闻
+- 知乎
+- 抖音
 - 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) |
 
@@ -689,28 +747,6 @@ frequency_words.txt 文件增加了一个【必须词】功能,使用 + 号
     </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>
 <summary><strong>👉 Docker 部署</strong></summary>
@@ -905,45 +941,10 @@ docker exec -it trend-radar ls -la /app/config/
 
 </details>
 
-<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>
-
 
-## ☕ 学习交流与1元点赞
+## ☕问题答疑与1元点赞
 
-> 心意到就行,收到的点赞用于提高开发者开源的积极性
+> 心意到就行,收到的**点赞**用于提高开发者开源的积极性。你们的**点赞**已记录于最顶部的【致谢名单】
 
 <div align="center">
 
@@ -953,10 +954,19 @@ weight:
 
 </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)
 - [基于本项目,如何开展公众号或者新闻资讯类文章写作](https://mp.weixin.qq.com/s/8ghyfDAtQZjLrnWTQabYOQ)