用途：在用户本机安装一个用户自有的 cron 任务，定期扫描已认证的 X/Twitter For You 时间线，发现互动相对浏览量异常高的帖子并推送提醒。所有运行只执行本地 Python，不调用 LLM 或智能体。
主要能力：每次抓取最多 VIRAL_RADAR_LIMIT 条帖子，保留新于 VIRAL_RADAR_CUTOFF_HOURS 的内容；按 engagement = likes + 3retweets + 9replies + 7quotes + 5bookmarks，normalized_score = engagement / views ^ VIRAL_RADAR_VIEW_EXPONENT 计算得分，超过 VIRAL_RADAR_THRESHOLD 即告警。新于 VIRAL_RADAR_FRESH_HOURS 的帖子全部参与竞争，否则最多发送一条较旧的合格帖，避免积压刷屏。内置 boost 过滤，剔除疑似人为放大的帖子；通过 state.sqlite3 按推文 ID 去重，超过 VIRAL_RADAR_RETENTION_DAYS 后清理。
使用方式：需 Node 20+ 与 Webcmd，并已登录 X。安装时创建 ~/.viral-radar/ 目录及 viral-timeline.py、config.env（权限 0600）、state.sqlite3、output/、logs/。webhook URL 属凭据，不应打印或写入聊天；macOS 可用 osascript 隐藏输入对话框收集。测试须模拟 cron 的最小环境（绝对 Python 与 Webcmd 路径、显式 --config/--state/--output-dir、精简 PATH），先加 --test-alert 验证，再跑一次完整扫描。cron 条目放在 # viral-radar begin 与 # viral-radar end 标记之间，默认每小时运行。
适用场景：需要低成本监控 X 时间线爆款信号并推送到团队频道的用户。
限制：机器需保持唤醒 cron 才会触发；依赖 Webcmd 浏览器会话与登录状态；配置项含义与默认值见资料，其他平台或无法弹出对话框时需用户自行编辑 config.env。删除前应询问，因目录含投递历史与 webhook 凭据。