TrendRadar:轻量易部署的多平台热点监控助手,聚焦精准资讯与多端推送

原创 发布日期:
24

一、TrendRadar是什么?

TrendRadar是一款以“轻量、易部署”为核心目标的开源热点监控助手,支持多平台热点资讯爬取、关键词精准筛选,提供企业微信、Telegram、钉钉等多渠道通知推送,适配GitHub Actions、Docker容器化、本地运行等多种部署方式,可生成HTML/TXT格式历史报告,集成MCP协议实现AI智能分析,帮助用户告别无效刷屏,高效获取精准资讯,适用于投资者、自媒体人、企业公关等各类人群,30秒即可完成基础部署。

TrendRadar并非复杂的大型系统,而是聚焦“精准筛选+高效推送”的工具型项目:它通过整合多平台热点数据源,结合用户自定义关键词,自动过滤无关信息,只保留核心资讯;同时支持多渠道实时推送,让用户在手机、电脑等终端随时接收;更提供零门槛部署方案,即使是非技术背景的用户,也能在30秒内搭建专属热点监控系统。

其核心价值在于“去芜存菁”——不追求覆盖所有资讯,而是帮助用户聚焦“真正关心的内容”,无论是股市动态、行业政策、品牌舆情还是生活热点,都能通过个性化配置实现精准追踪,让资讯获取从“被动接收”变为“主动筛选”,大幅提升信息获取效率。

作为开源项目,TrendRadar完全免费,代码公开可查,支持用户根据自身需求二次开发,既满足普通用户的基础使用场景,也适配技术用户的自定义扩展需求,实现“按需搭建、灵活调整”。

二、功能特色:实用与易用兼具的热点追踪工具

TrendRadar的功能设计围绕“精准、高效、灵活”三大核心,既覆盖热点监控的全流程需求,又兼顾不同用户的使用门槛,核心特色如下:

1. 热点监控与筛选:精准锁定核心资讯

TrendRadar的核心能力是“精准筛选”,避免无关信息干扰:

  • 多平台数据源整合:基于newsnow API接口,自动爬取主流资讯平台、行业榜单、社交热点等多渠道数据,覆盖时事、财经、科技、娱乐、生活等多个领域,无需手动切换多个平台查找信息;

  • 关键词自定义配置:用户通过config/frequency_words.txt文件设置关键词(每行一个关键词,支持中文、英文等任意字符),例如“人工智能”“A股政策”“品牌名称”等,系统会自动匹配资讯标题、摘要中的关键词,只保留相关度高的内容;

  • 无冗余去重:内置资讯去重机制,避免同一热点通过不同渠道重复推送,减少信息干扰;

  • 多模式筛选逻辑:支持按“关键词精准匹配”“关键词模糊关联”两种模式配置(通过config.yaml设置),精准匹配适合聚焦特定术语(如专业名词),模糊关联适合追踪泛领域热点(如行业趋势)。

2. 多端通知推送:全场景覆盖,不遗漏关键信息

TrendRadar支持多种通知渠道,可同时配置多个平台,确保用户在任意终端都能及时接收热点:

  • 主流办公/社交渠道全覆盖:支持企业微信、Telegram、钉钉、飞书、邮件、ntfy等6种核心渠道,满足个人、团队、企业等不同使用场景:

    • 个人用户:优先选择Telegram、邮件,操作简单、即时触达;

    • 团队/企业用户:优先选择企业微信、钉钉、飞书,方便团队共享热点、协同响应;

  • 推送内容结构化:推送信息包含资讯标题、来源、发布时间、核心摘要、原文链接,无需跳转多个平台,即可快速掌握关键信息;

  • 多渠道同时推送:支持在config.yaml中同时配置多个通知渠道(如同时推企业微信和Telegram),避免单一渠道故障导致信息遗漏;

  • 移动端适配:推送内容优化移动端阅读体验,网页版报告支持响应式设计,可直接保存为图片分享。

3. 灵活部署方案:30秒上手,适配不同用户需求

TrendRadar最大的亮点之一是“零门槛部署”,提供三种核心部署方式,覆盖从新手到技术用户的全场景:

部署方式 核心优势 适用人群 操作难度 部署耗时
GitHub Actions部署 零服务器依赖、自动化运行、支持网页版报告 新手用户、无服务器资源用户、追求快速上手的用户 低(无需代码基础) 30秒-5分钟
Docker容器化部署 环境隔离、稳定可靠、支持多架构、可本地/服务器部署 有服务器资源用户、追求长期稳定运行的用户 中(了解基础Docker操作) 5-10分钟
本地运行 自定义扩展方便、调试灵活、无需依赖第三方平台 开发者、技术用户、需要二次开发的用户 中-高(具备基础Python环境) 10-15分钟

三种部署方式的核心共性是“配置简单”——无需复杂的环境搭建,仅需修改少量配置文件,即可启动服务,真正实现“开箱即用”。

4. 数据持久化:历史资讯可追溯,支持趋势分析

TrendRadar会自动将每次爬取的热点数据保存至项目output目录,实现数据持久化:

  • 双格式输出:同时生成HTML和TXT两种格式文件,HTML文件支持响应式设计(适配电脑、手机查看),TXT文件适合快速检索;

  • 按时间命名:文件名称包含“日期+时间”(如20251116_1430_hotspot.html),方便用户按时间回溯历史热点;

  • 支持分享与存档:HTML报告可直接通过浏览器打开,支持保存为图片分享至社交平台,或存档至本地/云盘,便于后续查阅、统计分析。

5. AI分析支持:深度挖掘热点价值

针对有深度分析需求的用户,TrendRadar集成了MCP(Model Context Protocol)协议,可结合Cherry Studio客户端实现热点智能分析:

  • 核心分析能力:支持热点趋势判断、关联资讯聚合、关键信息提取、舆情倾向分析等(具体能力依赖Cherry Studio服务);

  • 配置灵活:AI分析为可选功能,用户可根据需求开启/关闭,无需额外配置即可使用基础监控功能;

  • 无缝集成:分析结果会通过已配置的通知渠道同步推送,与基础热点资讯形成互补,满足从“获取信息”到“解读信息”的深层需求。

6. 自动化与灵活性:适配不同使用场景

TrendRadar在“自动化运行”和“配置灵活性”上做了充分优化:

  • 定时自动化运行:默认配置为每小时爬取一次热点,支持自定义执行频率(如每30分钟、每天一次),无需手动触发;

  • 多推送模式可选:支持三种核心推送模式,通过config.yaml切换:

    • daily(当日汇总):每天固定时间推送当日所有匹配热点,适合需要批量回顾的场景;

    • current(当前榜单):推送实时热点榜单,适合关注最新动态的场景;

    • incremental(增量监控):仅推送新增热点,避免重复信息,适合实时追踪的场景;

  • 环境变量覆盖配置:支持通过环境变量覆盖config.yaml中的部分配置(如通知渠道的Token、爬取频率),适配不同部署环境(如开发环境、生产环境),无需修改核心配置文件;

  • 跨平台兼容:支持Windows、MacOS、Linux等主流操作系统,Docker镜像支持linux/amd64(普通服务器)、linux/arm64(树莓派等设备)多架构,满足本地电脑、云服务器、边缘设备等不同部署载体。

TrendRadar:轻量易部署的多平台热点监控助手,聚焦精准资讯与多端推送

三、技术细节:轻量架构与可靠实现

TrendRadar的技术设计遵循“轻量、低依赖、高兼容”原则,核心技术架构简洁清晰,既保证运行效率,又降低部署与维护成本,具体技术细节如下:

1. 核心技术架构

TrendRadar采用“模块化”设计,整体架构分为5大核心模块,各模块职责清晰、耦合度低,便于维护与扩展:

用户配置 → 触发模块 → 爬取模块 → 筛选模块 → 推送模块 → 持久化模块 →(可选)AI分析模块
  • 配置模块:负责解析用户配置,包括config.yaml(主配置)、frequency_words.txt(关键词)、环境变量,优先级为“环境变量 > config.yaml > 默认配置”,确保配置灵活覆盖;

  • 触发模块:提供定时触发能力,基于GitHub Actions的Cron表达式(云端部署)或系统定时任务(本地/Docker部署),控制爬取频率;

  • 爬取模块:基于requests库调用newsnow API接口,获取多平台热点数据,包含资讯标题、来源、发布时间、原文链接、摘要等字段,内置网络异常重试、超时处理机制,保证爬取稳定性;

  • 筛选模块:基于字符串匹配算法,对比爬取数据与关键词列表,过滤无关资讯,保留匹配结果,支持精准匹配、模糊匹配两种模式切换;

  • 推送模块:封装各通知渠道的API调用逻辑(如企业微信Webhook、Telegram Bot API),支持多渠道同时推送,内置推送失败重试机制;

  • 持久化模块:基于jinja2模板引擎生成HTML报告,通过文件操作写入TXT文件,自动创建output目录,处理文件权限问题;

  • AI分析模块:基于MCP协议与Cherry Studio客户端通信,传递热点数据并接收分析结果,支持异步调用,不影响核心监控流程。

2. 核心依赖与技术栈

TrendRadar采用Python作为开发语言(生态丰富、轻量易部署),核心依赖库少且均为成熟开源工具,降低环境配置难度,具体核心依赖如下:

依赖名称 核心用途 版本要求(推荐) 备注
Python 核心运行环境 ≥3.8 兼容Python 3.8-3.11版本
requests 网络请求(调用newsnow API) ≥2.25.0 处理HTTP请求、异常重试
PyYAML 解析YAML格式配置文件(config.yaml) ≥5.4.0 支持配置文件结构化解析
python-dotenv 加载环境变量(.env文件) ≥0.19.0 适配本地部署的环境配置
jinja2 生成HTML报告模板 ≥2.11.3 实现响应式HTML页面渲染
docker 容器化部署支持 ≥20.10.0 可选,仅Docker部署需安装
python-telegram-bot Telegram推送支持 ≥13.7 可选,仅Telegram渠道需安装
wechatwork-sdk 企业微信推送支持 ≥1.0.0 可选,仅企业微信渠道需安装

注:除Python基础环境外,其余依赖可通过项目提供的requirements.txt一键安装,无需手动逐个配置。

3. 自动化实现原理

  • GitHub Actions自动化:项目内置.github/workflows/trendradar.yml工作流文件,用户Fork仓库后,开启Actions功能即可触发自动化——通过Cron表达式设置定时任务(默认0 * * * *,每小时运行),自动拉取最新代码、安装依赖、执行爬取-筛选-推送流程,运行结果可在GitHub Actions日志中查看,失败时支持邮件提醒;

  • 本地/ Docker自动化:本地运行可通过Windows任务计划程序(Windows)、crontab(Mac/Linux)设置定时执行脚本;Docker部署可通过docker-compose.yml配置cron服务,或使用supervisor管理进程,实现后台持续运行与定时触发。

4. 跨平台与多架构适配

  • 操作系统兼容:通过Python的跨平台特性,确保代码在Windows、MacOS、Linux上一致运行,同时提供Windows专属setup.bat脚本、Mac/Linux专属setup.sh脚本,一键完成环境配置;

  • Docker多架构支持:项目Dockerfile采用multi-arch构建策略,支持linux/amd64(x86架构服务器/电脑)、linux/arm64(ARM架构设备,如树莓派4B、AWS Graviton服务器),用户可直接拉取对应架构镜像,无需手动修改Dockerfile;

  • 响应式网页报告:HTML报告采用原生CSS实现响应式设计,自动适配手机、平板、电脑屏幕,支持长按保存为图片,兼顾查看与分享需求。

5. 数据安全与稳定性

  • 配置安全:支持将敏感信息(如通知渠道的Token、API密钥)通过环境变量或.env文件配置,避免硬编码在代码中,降低泄露风险;

  • 网络稳定性:爬取模块内置3次重试机制,超时时间设置为10秒,应对网络波动、API临时不可用等情况;

  • 推送可靠性:推送模块支持失败重试,若某一渠道推送失败(如网络问题),会尝试重新推送2次,确保信息不丢失;

  • 文件权限处理:持久化模块自动处理output目录的创建权限,避免因权限不足导致报告生成失败,兼容不同操作系统的文件权限机制。

四、应用场景:覆盖多人群的热点追踪需求

TrendRadar的功能设计贴合实际使用场景,无论是个人用户的热点获取,还是企业用户的舆情监控,都能找到适配方案,以下是核心应用场景与使用示例:

1. 投资者:实时追踪市场动态

  • 核心需求:快速获取股市政策、行业动态、企业公告等关键信息,避免错过投资机会或风险预警;

  • 配置方案

    • 关键词:“A股”“创业板”“新能源政策”“锂电池价格”“美联储加息”等;

    • 推送模式:incremental(增量监控),每30分钟爬取一次;

    • 通知渠道:Telegram(实时推送)+ 邮件(每日汇总);

  • 使用价值:第一时间接收政策利好/利空、行业数据变化、企业重大公告等信息,无需频繁刷新股票APP、财经网站,同时通过历史报告回溯市场热点趋势,辅助投资决策。

2. 自媒体人:高效获取创作素材

  • 核心需求:追踪领域热点、收集选题素材、了解行业趋势,提升内容创作效率;

  • 配置方案

    • 关键词:“科技新品”“人工智能应用”“短视频趋势”“自媒体运营技巧”等;

    • 推送模式:daily(当日汇总)+ current(实时榜单),每日早8点推送汇总,每2小时推送实时榜单;

    • 通知渠道:飞书(团队共享)+ 网页版报告(素材存档);

  • 使用价值:快速筛选领域内高热度话题,通过HTML报告的素材存档功能整理选题库,避免创作灵感枯竭,同时及时跟进热点提升内容曝光度。

3. 企业公关:品牌舆情实时监控

  • 核心需求:监控品牌名称、产品名称、行业竞品动态,及时发现正面/负面舆情,快速响应;

  • 配置方案

    • 关键词:企业名称、产品名称、品牌Slogan、竞品名称、行业负面术语(如“投诉”“故障”“质量问题”);

    • 推送模式:incremental(增量监控),每15分钟爬取一次,触发负面关键词立即推送;

    • 通知渠道:企业微信(公关团队群)+ 钉钉(管理层);

  • 使用价值:实时掌握品牌舆情动态,第一时间处理负面信息,跟踪竞品动态调整公关策略,通过历史报告统计舆情趋势,优化品牌传播方案。

4. 职场人:行业资讯精准汇总

  • 核心需求:获取行业政策、技术动态、职业技能相关资讯,提升专业能力,把握职场机会;

  • 配置方案

    • 关键词:“行业政策”“技术革新”“职业认证”“行业会议”“技能培训”等;

    • 推送模式:daily(当日汇总),每晚8点推送;

    • 通知渠道:邮件(归档)+ 企业微信(即时查看);

  • 使用价值:告别碎片化资讯干扰,每天仅需5分钟即可掌握当日核心行业动态,节省信息筛选时间,专注专业能力提升。

5. 普通用户:生活热点个性化获取

  • 核心需求:关注生活相关热点(如旅游、美食、健康、教育),过滤无关资讯,获取实用信息;

  • 配置方案

    • 关键词:“旅游攻略”“美食探店”“健康养生”“中小学教育”“本地活动”等;

    • 推送模式:current(实时榜单),每天中午12点推送;

    • 通知渠道:Telegram + 网页版报告(保存攻略);

  • 使用价值:只接收感兴趣的生活资讯,避免社交平台的无效刷屏,快速获取实用信息(如节假日旅游攻略、本地美食推荐),提升生活质量。

TrendRadar:轻量易部署的多平台热点监控助手,聚焦精准资讯与多端推送

五、使用方法:3种部署方式详细指南

TrendRadar提供3种部署方式,覆盖不同用户需求,以下是 step-by-step 详细操作指南,新手推荐优先选择「GitHub Actions部署」(零门槛、无服务器依赖):

前置准备

无论选择哪种部署方式,需提前完成以下基础配置:

  1. 访问项目GitHub仓库:https://github.com/sansan0/TrendRadar,下载最新版本代码(可直接Fork仓库,或下载ZIP包解压);

  2. 配置关键词文件:打开config/frequency_words.txt,按“每行一个关键词”的格式,填写需要监控的关键词(如“人工智能”“A股”),无需特殊格式,支持中文、英文、数字;

  3. 配置主配置文件:打开config/config.yaml,核心配置项说明如下(无需修改所有字段,仅配置必要项即可):

    • push_mode:推送模式,可选daily/current/incremental,默认current

    • crawl_interval:爬取间隔(仅本地/Docker部署生效),单位分钟,默认60;

    • notification:通知渠道配置,按需开启对应渠道(如企业微信、Telegram),填写相关参数(如webhook、token);

    • ai_analysis:AI分析配置,默认enable: false,需使用时设置为true,并填写service_urlapi_key(从Cherry Studio获取);

    • persistence:数据持久化配置,默认enable: true,自动生成HTML/TXT报告。

方式1:GitHub Actions部署(零门槛,推荐新手)

这是最简单的部署方式,无需服务器、无需本地环境,仅需GitHub账号即可,30秒完成部署:

  1. Fork仓库:登录GitHub账号,访问TrendRadar仓库(https://github.com/sansan0/TrendRadar),点击右上角「Fork」按钮,将仓库复制到自己的GitHub账号下;

  2. 配置敏感信息(可选):若不想公开通知渠道的Token(如企业微信webhook),可通过GitHub Secrets配置环境变量:

    • 进入Fork后的仓库,点击「Settings」→「Secrets and variables」→「Actions」→「New repository secret」;

    • 按需求添加 secrets(如WECHAT_WORK_WEBHOOK=企业微信webhook地址、TELEGRAM_BOT_TOKEN=Telegram机器人Token);

    • config/config.yaml中,将对应渠道的参数改为${SECRET_NAME}(如webhook: ${WECHAT_WORK_WEBHOOK}),实现敏感信息加密;

  3. 开启GitHub Actions

    • 进入Fork后的仓库,点击顶部「Actions」标签;

    • 找到默认工作流(如「TrendRadar Auto Run」),点击「Enable workflow」开启自动化;

  4. 自定义爬取频率(可选)

    • 每30分钟运行:30 * * * *

    • 每天早8点运行:0 8 * * *

    • 每15分钟运行:*/15 * * * *

    • 打开仓库中的.github/workflows/trendradar.yml文件,找到on.schedule.cron字段;

    • 默认值0 * * * *表示每小时运行一次,修改为目标频率(Cron表达式),例如:

    • 点击「Commit changes」保存修改;

  5. 查看运行结果与报告

    • 自动化运行后,点击「Actions」→ 对应运行记录,可查看日志(是否爬取成功、推送成功);

    • 开启GitHub Pages查看网页版报告:

    1. 点击仓库「Settings」→「Pages」;

    2. 「Source」选择「Deploy from a branch」,「Branch」选择「main」,目录选择「/output」,点击「Save」;

    3. 等待1-2分钟,访问「https://你的GitHub用户名.github.io/TrendRadar」,即可查看历史热点报告。

方式2:Docker部署(稳定可靠,适合有服务器用户)

Docker部署可实现环境隔离,避免依赖冲突,支持本地电脑或云服务器(如阿里云、腾讯云)部署:

  1. 前置环境:安装Docker和Docker Compose(参考Docker官方文档:https://docs.docker.com/get-docker/);

  2. 获取项目代码

    # 克隆仓库
    git clone https://github.com/sansan0/TrendRadar.git
    cd TrendRadar
  3. 配置文件:按「前置准备」步骤修改config/frequency_words.txtconfig/config.yaml

  4. 启动容器

    • 方式1:使用现成Docker镜像(推荐):

      # 拉取镜像(支持amd64/arm64架构)
      docker pull sansan0/trendradar:latest
      # 启动容器,挂载配置文件和输出目录
      docker run -d \
       -v $(pwd)/config:/app/config \
       -v $(pwd)/output:/app/output \
       --name trendradar \
       sansan0/trendradar:latest
    • 方式2:本地构建镜像:

      # 构建镜像
      docker build -t trendradar:local .
      # 启动容器
      docker run -d \
       -v $(pwd)/config:/app/config \
       -v $(pwd)/output:/app/output \
       --name trendradar \
       trendradar:local
  5. 设置定时任务(可选)

    • 若需自定义爬取频率,修改docker-compose.yml文件(项目已提供示例):

      version: '3'
      services:
       trendradar:
        image: sansan0/trendradar:latest
        volumes:
         - ./config:/app/config
         - ./output:/app/output
        command: >
         sh -c "while true; do
          python main.py;
          sleep 3600; # 每3600秒(1小时)运行一次,可修改为其他时间
         done"
    • 启动容器:docker-compose up -d

  6. 验证部署

    • 查看容器日志:docker logs -f trendradar,确认无报错;

    • 检查output目录是否生成HTML/TXT文件;

    • 查看通知渠道是否收到推送。

方式3:本地运行(适合技术用户,支持自定义扩展)

本地运行适合需要二次开发或调试的用户,需配置Python环境:

  1. 前置环境:安装Python 3.8+(参考:https://www.python.org/downloads/);

  2. 获取项目代码

    git clone https://github.com/sansan0/TrendRadar.git
    cd TrendRadar
  3. 安装依赖

    • Windows用户:双击运行setup.bat,自动安装依赖;

    • Mac/Linux用户:终端执行sh setup.sh,自动安装依赖;

    • 手动安装(备用):pip install -r requirements.txt

  4. 配置文件:按「前置准备」步骤修改config/frequency_words.txtconfig/config.yaml

  5. 运行程序

    • 单次运行:python main.py(手动触发一次爬取-筛选-推送);

    • 定时运行(Windows):

    • 定时运行(Mac/Linux):

    1. 终端执行crontab -e

    2. 添加定时任务(如每小时运行):0 * * * * cd /path/to/TrendRadar && python3 main.py

    3. 打开「任务计划程序」→「创建基本任务」;

    4. 设置触发频率(如每小时),操作选择「启动程序」,选择Python.exe和main.py路径;

  6. 查看结果

    • 运行日志会输出到终端,同时output目录生成报告文件;

    • 若需调试,可在main.py中添加打印语句,或使用Python调试工具。

配置文件关键参数说明(必看)

config/config.yaml是核心配置文件,以下是高频使用的参数说明,避免配置错误导致功能失效:

参数路径 说明 可选值/示例
push_mode 推送模式 daily(当日汇总)/current(当前榜单)/incremental(增量)
crawl_interval 爬取间隔(本地/Docker部署) 30(分钟)、60(默认)、1440(每天)
notification.wechat_work.enable 是否开启企业微信推送 true/false(默认false)
notification.wechat_work.webhook 企业微信机器人webhook地址 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx
notification.telegram.enable 是否开启Telegram推送 true/false(默认false)
notification.telegram.bot_token Telegram机器人Token 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
notification.telegram.chat_id 接收消息的Chat ID 12345678(通过@userinfobot获取)
persistence.enable 是否开启数据持久化 true(默认)/false
persistence.output_dir 报告输出目录 ./output(默认,无需修改)
ai_analysis.enable 是否开启AI分析 true/false(默认false)

注:各通知渠道的参数获取方式(如企业微信webhook、Telegram Bot Token)可参考项目README中的「通知渠道配置指南」,或在GitHub Issues中搜索相关教程。

六、常见问题解答(FAQ)

1. 部署后没有收到推送,怎么办?

排查步骤

  • 检查配置文件:确认config/config.yaml中对应通知渠道的enable设为true,且参数填写正确(如webhook、token无多余空格);

  • 查看运行日志:GitHub Actions部署可在「Actions」→ 对应运行记录中查看日志,Docker部署执行docker logs trendradar,本地运行查看终端输出,是否有“推送失败”“参数错误”等提示;

  • 验证关键词匹配:若关键词过窄(如“某小众品牌+某具体型号”),可能暂无匹配热点,可临时添加“热点”“新闻”等通用关键词测试;

  • 网络问题:Telegram、ntfy等渠道可能需要科学上网,若服务器无相关网络环境,可切换为企业微信、钉钉、邮件等国内可访问渠道;

  • 权限问题:确保通知渠道的权限正常(如企业微信机器人未被限制、Telegram Bot已加入目标聊天群)。

2. 如何修改爬取频率?

  • GitHub Actions部署:修改.github/workflows/trendradar.yml中的cron表达式(参考Cron语法:分 时 日 月 周);

  • Docker部署:修改docker-compose.yml中的sleep时间(单位秒,如sleep 1800表示每30分钟);

  • 本地部署:Windows修改任务计划程序的触发频率,Mac/Linux修改crontab中的定时表达式。

3. 关键词配置后,筛选结果不符合预期?

  • 检查关键词格式:确保frequency_words.txt中每行仅一个关键词,无空行、特殊符号(如逗号、引号);

  • 切换匹配模式:若需精准匹配(仅包含完整关键词才推送),可在config/config.yaml中添加match_mode: exact;若需模糊匹配(包含关键词片段即推送),设置match_mode: fuzzy(默认);

  • 调整关键词:避免过于宽泛(如“科技”可能推送大量无关信息)或过于狭窄(如“2025年XX行业政策”可能无匹配结果),可适当增加相关关键词扩大覆盖范围。

4. Docker部署提示“架构不兼容”(如arm64设备)?

项目Docker镜像已支持linux/amd64linux/arm64多架构,解决方法:

  • 拉取镜像时指定架构:docker pull sansan0/trendradar:latest --platform linux/arm64

  • 本地构建镜像:进入项目目录执行docker build -t trendradar:local .,Docker会自动适配当前设备架构;

  • 确认Docker版本:需Docker 19.03+版本支持多架构,若版本过低,升级Docker后重试。

5. 如何更新TrendRadar到最新版本?

  • GitHub Actions部署:进入Fork后的仓库,点击「Fetch upstream」→「Fetch and merge」,拉取原仓库最新代码,自动覆盖旧版本;

  • Docker部署:

    # 停止旧容器
    docker stop trendradar && docker rm trendradar
    # 拉取最新镜像
    docker pull sansan0/trendradar:latest
    # 重启容器
    docker run -d -v $(pwd)/config:/app/config -v $(pwd)/output:/app/output --name trendradar sansan0/trendradar:latest
  • 本地部署:

    # 拉取最新代码
    git pull origin main
    # 更新依赖
    pip install -r requirements.txt --upgrade

注:大版本升级(如v1.x → v2.x)建议重新Fork仓库或下载最新代码,避免旧配置文件与新版本不兼容。

6. 网页版报告如何访问?

  • GitHub Actions部署:按「方式1」步骤开启GitHub Pages后,访问「https://你的GitHub用户名.github.io/TrendRadar」,即可查看所有历史报告;

  • Docker/本地部署:直接打开output目录下的HTML文件(如20251116_1430_hotspot.html),用浏览器打开即可,支持保存为图片分享。

7. AI分析功能如何启用?

  • 下载并安装Cherry Studio客户端(官方链接:参考项目README);

  • 打开Cherry Studio,进入「MCP服务配置」,启用MCP服务,获取service_url(服务地址)和api_key(密钥);

  • 打开config/config.yaml,修改AI分析配置:

    ai_analysis:
     enable: true
     service_url: "获取的service_url"
     api_key: "获取的api_key"
  • 重启TrendRadar,爬取的热点数据会自动发送至AI服务,分析结果通过通知渠道推送。

8. 能否同时监控多个关键词分组(如工作+生活)?

支持!可在frequency_words.txt中按“# 分组名称”的格式划分关键词组,例如:

# 工作关键词
人工智能
行业政策
技术革新
# 生活关键词
旅游攻略
美食探店
健康养生

系统会自动识别分组,推送时会标注资讯对应的关键词组,便于区分不同场景的热点。

七、相关链接

八、总结

TrendRadar作为一款聚焦“轻量、易部署”的开源热点监控助手,以用户需求为核心,通过多平台资讯爬取、关键词精准筛选、多端通知推送等实用功能,有效解决了信息爆炸时代用户“资讯获取效率低、无关信息干扰多”的痛点。它既支持零门槛的GitHub Actions一键部署,让新手30秒上手,也提供Docker容器化和本地自定义运行方案,满足技术用户的扩展需求;数据持久化功能实现历史资讯回溯,AI分析集成提升热点解读深度,适配投资者、自媒体人、企业公关等各类人群的使用场景。其开源特性不仅保证了功能的透明性与安全性,更允许用户根据自身需求二次开发,无需额外成本即可搭建专属的精准资讯获取工具。无论是追求高效信息筛选的普通用户,还是需要专业热点追踪的职场人群,TrendRadar都以“实用、易用、灵活”的核心优势,成为一款值得推荐的开源热点监控工具。

打赏
THE END
作者头像
AI工具箱
一个喜欢收集AI工具的小萌新