3.4.0

.dockerignore

@@ -0,0 +1,35 @@
+.git/
+.gitignore
+*.md
+README.md
+
+output/
+
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+.pytest_cache/
+
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+.DS_Store
+Thumbs.db
+
+docker/.env
+
+_image/
+
+.github/
+
+*.log
+.env.local
+.env.*.local
+version
+index.html

.github/ISSUE_TEMPLATE/01-bug-report.yml

@@ -0,0 +1,208 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-issue-forms.json
+
+name: 🐛 遇到问题了
+description: 程序运行不正常或出现错误
+title: "[问题] "
+labels: ["bug"]
+assignees:
+  - sansan0
+body:
+  - type: markdown
+    attributes:
+      value: |
+        **详细清楚的问题描述能帮助项目作者更快理解和解决你遇到的困扰**。强烈建议上传截图，图文并茂会让问题更容易被理解和定位。
+
+        ---
+
+        ### 📋 提交问题前，请先检查以下事项
+
+        #### 1️⃣ **建议先查看文档** 📖
+        大部分常见问题在文档中都有详细说明，建议先查看相关章节：
+        - [📝 配置教程](https://github.com/sansan0/TrendRadar#-快速开始)
+        - [❓ 常见问题](https://github.com/sansan0/TrendRadar#问题答疑与1元点赞)
+        - [🐳 Docker部署](https://github.com/sansan0/TrendRadar#-docker-部署)
+
+        #### 2️⃣ **测试推送功能的注意事项** ⚠️
+        测试消息推送时，请确保以下配置正确：
+
+        **必须检查的配置项：**
+        - ✅ `report.mode` 设置为 `daily` 或 `current`（请勿使用 `incremental`，该模式仅在有新内容时才推送）
+        - ✅ `notification.push_window.enabled` 设置为 `false`（关闭推送时间窗口控制）
+        - ✅ `notification.enable_notification` 设置为 `true`（确保通知功能已启用）
+
+        **说明：**
+        - 推送时间窗口控制（`push_window`）是可选功能，如果开启会限制推送时间范围
+        - 测试时建议关闭此功能，避免因不在推送时间窗口而收不到消息
+
+        #### 3️⃣ **检查配置细节** 🔍
+        部分问题可能是配置细节导致，建议检查：
+        - 配置文件的缩进格式是否正确（YAML 格式要求严格，必须使用空格而非 Tab）
+        - Webhook 地址是否完整复制（注意不要有多余或缺失的字符）
+        - 环境变量是否正确设置
+        - 文件路径是否正确
+
+        #### 4️⃣ **遇到困难时的建议** 💡
+        - 如果尝试 30 分钟以上仍无进展，可以考虑换个思路
+        - 建议重新从头阅读相关文档章节
+        - 或尝试其他部署方式（如从 Docker 切换到 GitHub Actions）
+
+        #### 5️⃣ **根据部署方式提供完整信息** 📦
+
+        **如果是 GitHub Actions 部署：**
+        1. **必须提供** Actions 工作流链接（如：`https://github.com/你的用户名/TrendRadar/actions/workflows/crawler.yml`）
+        2. **查看执行日志的步骤：**
+           - 打开你的仓库页面
+           - 点击顶部的 **Actions** 标签
+           - 点击左侧的 **Crawler** 工作流
+           - 点击最近一次运行记录
+           - 点击 **Run crawler** 查看详细日志
+           - **截图完整的日志内容**（特别是错误部分）
+        3. 提供 `config.yaml` 配置内容（隐藏敏感信息）
+
+        **如果是 Docker 部署：**
+        1. 提供项目目录结构截图（运行 `ls -la` 或打开文件管理器）
+        2. 提供 Docker 容器日志（运行 `docker logs 容器名`）
+        3. 提供容器状态（运行 `docker ps -a`）
+        4. 提供 `.env` 文件内容（隐藏敏感信息）
+
+        **如果是本地运行：**
+        1. 提供完整的错误日志截图
+        2. 提供 `config.yaml` 配置内容
+        3. 提供 Python 版本（运行 `python --version`）
+
+  - type: dropdown
+    id: bug-category
+    attributes:
+      label: 🏷️ 遇到了什么问题
+      options:
+        - 数据获取问题（获取不到新闻、请求失败等）
+        - 关键词筛选问题（关键词不生效、匹配异常等）
+        - 通知推送问题（收不到消息、推送失败等）
+        - 配置设置问题（配置文件错误、参数不生效等）
+        - 部署运行问题（Docker、GitHub Actions等）
+        - 性能问题（运行慢、卡顿等）
+        - 其他问题
+    validations:
+      required: true
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: 🖥️ 使用环境
+      options:
+        - 本地运行（直接在电脑上运行）
+        - Docker 容器运行
+        - GitHub Actions 自动运行
+        - 其他方式
+    validations:
+      required: true
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: 📝 详细描述问题
+      description: 请详细说明遇到的问题（建议配合截图说明）
+      placeholder: |
+        请清楚地描述：
+        - 具体发生了什么问题
+        - 问题出现时的情况
+        - 这个问题影响了什么功能
+
+        💡 提示：上传问题截图能提供更多信息。
+    validations:
+      required: true
+
+  - type: dropdown
+    id: system-info
+    attributes:
+      label: 💻 系统信息
+      description: 你的电脑系统
+      options:
+        - Windows 10
+        - Windows 11
+        - macOS
+        - Ubuntu/Linux
+        - 其他系统
+        - 不确定
+    validations:
+      required: false
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: 🔄 怎么重现这个问题
+      description: 如何让这个问题重新出现？（可选，但建议填写）
+      placeholder: |
+        请按步骤描述（建议每个步骤都配截图）：
+        1. 我点击了...
+        2. 然后设置了...
+        3. 接着出现了...
+
+        💡 操作过程的截图特别有用！
+    validations:
+      required: false
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: ✅ 期望的正常情况
+      description: 正常情况下应该是什么样的？（可选）
+      placeholder: |
+        描述你期望看到的正常结果...
+        如果有参考图片就更好了！
+    validations:
+      required: false
+
+  - type: textarea
+    id: error-logs
+    attributes:
+      label: 📋 错误信息
+      description: 程序显示的错误信息或日志（如果有的话）
+      placeholder: |
+        如果程序显示了错误信息，请完整复制到这里：
+
+        ```
+        错误信息内容...
+        ```
+
+    validations:
+      required: false
+
+  - type: textarea
+    id: config-info
+    attributes:
+      label: ⚙️ 相关配置
+      description: 与问题相关的配置内容（请隐藏敏感信息如 webhook 地址）
+      placeholder: |
+        相关的配置内容（记得隐藏敏感信息）：
+
+        ```yaml
+        notification:
+          enable_notification: true
+          webhooks:
+            feishu_url: "***隐藏***"
+        ```
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: 📷 截图补充
+      description: 上传相关截图（强烈推荐！）
+      placeholder: |
+        请拖拽截图到这里，建议包含：
+        - 错误界面截图
+        - 配置设置截图
+        - 操作步骤截图
+
+        💡 截图是最直观的问题说明方式！
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 📎 其他补充信息
+      description: 其他可能有用的信息
+      placeholder: |
+        - 网络环境特殊情况
+        - 之前是否正常工作过
+        - 最近有没有改动什么设置
+        - 其他你觉得可能相关的信息

.github/ISSUE_TEMPLATE/02-feature-request.yml

@@ -0,0 +1,98 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-issue-forms.json
+
+name: 💡 我有个想法
+description: 建议新功能或改进现有功能
+title: "[建议] "
+labels: ["enhancement"]
+assignees:
+  - sansan0
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### 💝 温馨提醒
+
+        感谢你的创意想法！如果这个项目对你有帮助，欢迎给项目点个 ⭐ **Star**！
+
+        好的建议让项目变得更加实用。**欢迎用截图或示例**来展示你的想法！
+
+  - type: dropdown
+    id: feature-category
+    attributes:
+      label: 🏷️ 建议类别
+      options:
+        - 数据源相关（新增平台、改进抓取等）
+        - 分析功能相关（算法改进、筛选优化等）
+        - 通知方式相关（新增通知渠道、消息格式等）
+        - 配置管理相关（设置优化、界面改进等）
+        - 部署运维相关（安装简化、监控告警等）
+        - 数据展示相关（报告格式、图表可视化等）
+        - 性能优化相关
+        - 用户体验改进
+        - 其他想法
+    validations:
+      required: true
+
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: 💭 详细描述你的想法
+      description: 请详细描述你希望添加的功能
+      placeholder: |
+        请详细描述：
+        - 你希望增加什么功能
+        - 这个功能应该怎么使用
+        - 使用后能达到什么效果
+
+        💡 提示：如果有类似功能的截图作为参考就更好了！
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: 🎯 什么时候会用到这个功能
+      description: 这个功能在什么场景下使用？
+      placeholder: |
+        例如：
+        - 当我需要...的时候
+        - 在...情况下会很方便
+        - 可以解决...问题
+        - 能够帮助...用户
+    validations:
+      required: true
+
+  - type: textarea
+    id: implementation-ideas
+    attributes:
+      label: 🛠️ 实现想法（可选）
+      description: 如果你有实现思路，欢迎分享
+      placeholder: |
+        - 功能界面应该怎么设计
+        - 配置应该怎么设置
+        - 参考哪些类似的工具或网站
+        - 其他实现建议
+
+  - type: textarea
+    id: mockups-examples
+    attributes:
+      label: 📷 功能示意图（推荐）
+      description: 上传功能示意图、参考截图或手绘草图
+      placeholder: |
+        请上传：
+        - 功能界面的设计图（手绘也可以）
+        - 类似功能的参考截图
+        - 使用流程的示意图
+
+        💡 可视化的说明最容易理解！
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 📎 其他补充说明
+      description: 其他想要补充的内容
+      placeholder: |
+        - 相关的参考资料链接
+        - 类似功能的其他工具
+        - 更多使用场景说明
+        - 其他相关想法