|
|
@@ -10,13 +10,89 @@ body:
|
|
|
- type: markdown
|
|
|
attributes:
|
|
|
value: |
|
|
|
- ### 💝 温馨提醒
|
|
|
+ 遇到设置问题时,**请尽可能详细描述你的问题**,并上传配置文件和错误信息的截图,这样能帮助更快定位和解决问题。
|
|
|
|
|
|
- 如果这个项目对你有帮助,欢迎给项目点个 ⭐ **Star**!
|
|
|
+ 建议先查看项目说明文档,大部分常见问题都有详细说明。
|
|
|
|
|
|
- 遇到设置问题不要担心,**强烈建议上传配置文件和错误信息的截图**。
|
|
|
+ ---
|
|
|
|
|
|
- 📖 **建议先查看项目说明文档**,很多常见问题都有详细说明。
|
|
|
+ ### 📋 配置问题自查清单(提问前建议阅读)
|
|
|
+
|
|
|
+ #### 1️⃣ **优先查看文档** 📚
|
|
|
+ 绝大部分配置问题在文档中都有详细说明,建议先查看相关章节:
|
|
|
+ - [🚀 快速开始](https://github.com/sansan0/TrendRadar#-快速开始)
|
|
|
+ - [📝 frequency_words.txt 配置](https://github.com/sansan0/TrendRadar#frequencywordstxt-配置教程)
|
|
|
+ - [🐳 Docker 部署指南](https://github.com/sansan0/TrendRadar#-docker-部署)
|
|
|
+ - [🤖 AI 分析配置](https://github.com/sansan0/TrendRadar#-ai-智能分析部署)
|
|
|
+
|
|
|
+ #### 2️⃣ **测试推送的常见误区** ⚠️
|
|
|
+ 测试消息推送时,请检查以下配置:
|
|
|
+
|
|
|
+ **必须检查的配置项:**
|
|
|
+ - ❌ **错误**:`report.mode` 设置为 `incremental`(增量模式仅在有新内容时推送)
|
|
|
+ - ✅ **正确**:`report.mode` 设置为 `daily` 或 `current`
|
|
|
+ - ❌ **错误**:`notification.push_window.enabled` 设置为 `true`(推送时间窗口会限制推送时间)
|
|
|
+ - ✅ **正确**:`notification.push_window.enabled` 设置为 `false`(测试时建议关闭)
|
|
|
+
|
|
|
+ **说明:**
|
|
|
+ - 推送时间窗口控制是可选功能,开启后只在指定时间范围内推送
|
|
|
+ - 如果当前时间不在设定的窗口范围内,将不会收到推送消息
|
|
|
+ - 测试时建议先关闭此功能
|
|
|
+
|
|
|
+ #### 3️⃣ **YAML 格式很严格** 📏
|
|
|
+ 配置文件最常见的 3 个错误:
|
|
|
+ ```yaml
|
|
|
+ # ❌ 错误示例 1:缩进不对(必须用空格,不能用Tab)
|
|
|
+ notification:
|
|
|
+ enable_notification: true # ← 错误:缺少缩进
|
|
|
+
|
|
|
+ # ❌ 错误示例 2:冒号后面没有空格
|
|
|
+ enable_notification:true # ← 错误:冒号后需要空格
|
|
|
+
|
|
|
+ # ✅ 正确示例:
|
|
|
+ notification:
|
|
|
+ enable_notification: true # ← 正确:2空格缩进 + 冒号后有空格
|
|
|
+ ```
|
|
|
+
|
|
|
+ #### 4️⃣ **根据部署方式准备信息** 📦
|
|
|
+
|
|
|
+ **如果你是 GitHub Actions 部署:**
|
|
|
+ 1. **必须提供** Actions 工作流链接(格式:`https://github.com/你的用户名/TrendRadar/actions/workflows/crawler.yml`)
|
|
|
+ 2. **如何查看并截图执行日志:**
|
|
|
+ ```
|
|
|
+ 步骤 1:打开你的仓库,点击顶部 "Actions" 标签
|
|
|
+ 步骤 2:点击左侧 "Crawler" 工作流
|
|
|
+ 步骤 3:点击最近一次运行记录(最上面的那个)
|
|
|
+ 步骤 4:点击展开 "Run crawler" 步骤
|
|
|
+ 步骤 5:截图完整的日志内容(特别是红色错误部分)
|
|
|
+ ```
|
|
|
+ 3. 提供 `config.yaml` 配置内容(记得隐藏 webhook 地址)
|
|
|
+
|
|
|
+ **如果你是 Docker 部署:**
|
|
|
+ 1. 提供项目目录结构截图(运行 `ls -la` 或打开文件管理器)
|
|
|
+ 2. 提供 Docker 日志(运行 `docker logs 容器名`)
|
|
|
+ 3. 提供容器状态(运行 `docker ps -a`)
|
|
|
+ 4. 提供 `.env` 文件内容(隐藏敏感信息)
|
|
|
+
|
|
|
+ **如果你是本地运行:**
|
|
|
+ 1. 提供完整的错误信息截图
|
|
|
+ 2. 提供 `config.yaml` 配置内容
|
|
|
+ 3. 提供 Python 版本(运行 `python --version`)
|
|
|
+
|
|
|
+ #### 5️⃣ **遇到困难时的建议** 🤔
|
|
|
+ - 如果尝试 30 分钟以上仍无进展,建议考虑换个思路
|
|
|
+ - 可以尝试:
|
|
|
+ 1. 重新从头阅读相关文档章节
|
|
|
+ 2. 尝试其他部署方式(如从 Docker 切换到 GitHub Actions)
|
|
|
+ 3. 对比文档示例,检查差异之处
|
|
|
+
|
|
|
+ #### 6️⃣ **提问时请尽量提供以下信息** 📋
|
|
|
+ 为了更快地帮你定位问题,建议提供:
|
|
|
+ - ✅ 配置文件内容(请隐藏 webhook 等敏感信息)
|
|
|
+ - ✅ 完整的错误日志截图
|
|
|
+ - ✅ 部署方式(本地运行/Docker/GitHub Actions)
|
|
|
+ - ✅ 已经尝试过的解决方法
|
|
|
+ - ✅ 具体的问题现象(请避免只说"不生效"或"没反应",尽量描述具体表现)
|
|
|
|
|
|
- type: dropdown
|
|
|
id: config-type
|