TrendRadarDocsA PROJECT BYsansansansan's personal projects and softwaresandev.cc
HomeDocumentationCommunityPartnershipsIndividual SupportCredits
  • Start here
    • Choose a deployment
    • No server: GitHub Actions
    • Server / NAS: Docker
    • Try locally: Run with uv
    • Configure content & delivery
  • Data Sources
    • Platform Configuration
    • Self-hosted sources (AI)
    • RSS Feed Configuration
  • Content Filtering
    • Keyword Configuration
    • AI Smart Filtering
  • Push Notifications
    • Push Channels
    • Push Modes
    • Scheduling
  • AI Enhancement
    • AI Analysis & Push
    • AI Translation
    • MCP Chat Analysis
    • MCP Query Guide
  • Data & Operations
    • Storage Configuration
    • Config Editor
    • Publish web reports
    • Architecture
  • More
    • FAQ
  1. Docs
  2. /
  3. Push Notifications
  4. /
  5. Push Modes
PreviousPush ChannelsNextScheduling
© TrendRadar·GPL-3.0 License·Website·GitHub·by sansan

Push Modes

TrendRadar supports three push modes for different scenarios. Choose the one that best fits your needs.

How to configure

Change the report.mode field in config/config.yaml:
report:
  mode: "current"  # Options: "daily" | "incremental" | "current" (default: current)

Comparison of the three modes

ModeBest forWhen it pushesWhat it pushesUse case
Mode
Best for
When it pushes
What it pushes
Use case
daily (Daily Digest)
daily
Managers / general usersScheduled push (hourly by default)All matching news for the day + a "newly added" sectionReview the full-day trend without missing anything
current (Current Board)
current
Content creators / independent mediaScheduled push (hourly by default)Matching news currently on the board + a "newly added" sectionTrack what is trending right now
incremental (Incremental Monitoring)
incremental
Investors / tradersPushes only when there is new contentOnly newly appearing matching newsZero duplicates — only pushes content the first time it appears
Mode behavior reminder
  • daily mode: each push contains all matching news for the day, so previously pushed items appear again
  • current mode: each push contains the matching items currently on the board, so a topic that stays on the board shows up every time
  • incremental mode: only pushes news the first time it appears — never repeats

Quick selection guide

incremental You don't want to see duplicates -- choose Incremental Monitoring, which only pushes newly appearing items
current You want to know the current board's trend -- choose Current Board to keep track of what is trending at any moment
daily You need a full daily digest -- choose Daily Digest to review all trending topics at the end of the day

A real-world example

Suppose you have configured the keyword "Apple" and the system runs once an hour. Here is how the three modes push over the same period:
Timedaily push contentcurrent push contentincremental push content
Time
daily push content
current push content
incremental push content
10:00News ANews BNews ANews BNews ANews B
11:00News ANews BNews CNews BNews CNews DNews C
12:00News ANews BNews CNews CNews DNews ENews DNews E
Line-by-line: what is each mode doing?

Frequently asked questions

It runs every hour, but I keep seeing news that was already pushed
After switching to incremental mode, I haven't received a push for a long time
Can the three modes be used at the same time?

Push content grouping

Use report.display_mode to control how matched content is grouped in push messages:
report:
  display_mode: "keyword"   # Options: "keyword" | "platform"
  • keyword Group by keyword (default) -- matched results are grouped by word group, each showing its matched items
  • platform Group by platform -- matched results are grouped by source platform (e.g. Weibo, Zhihu)

Push content region control

A push message is composed of multiple regions. You can toggle each region with display.regions and control their order with display.region_order.
RegionDescription
hotlistTrending board: results from keyword matching or AI filtering
rssRSS feeds: content from RSS sources
new_itemsNewly added: items that appeared for the first time in this run (trending + RSS)
standaloneStandalone: specified platforms/RSS shown in full, not filtered by keywords
ai_analysisAI analysis: the AI-generated trending analysis report
display:
  # Region display order (top to bottom = order in the push)
  region_order:
    - new_items
    - hotlist
    - rss
    - standalone
    - ai_analysis

  # Toggle each region
  regions:
    hotlist: true          # Trending board
    new_items: false        # Newly added
    rss: true              # RSS feeds
    standalone: false       # Standalone
    ai_analysis: true       # AI analysis
Region visibility rules
For a region to appear in the push, two conditions must both be met: 1. it exists in the region_order list; 2. its corresponding toggle in regions is true. Removing a line from region_order or setting the toggle to false will both hide that region.

Standalone display

The standalone region shows the complete content from specified platforms or RSS sources, bypassing keyword filtering. It's useful when you want to see all trending items from a particular platform without missing anything.
display:
  regions:
    standalone: true                     # Enable standalone region

  standalone:
    platforms: ["zhihu", "wallstreetcn-hot"]   # Trending platform IDs
    rss_feeds: []                              # RSS source IDs
    max_items: 20                              # Max items per source