用途
Topic Monitor 用于持续监控用户关心的主题，并在出现重要进展时主动发出提醒。它把助手从被动响应转变为主动监控：用户定义好主题后，系统按设定频率自动搜索，并只把真正重要的内容推送给用户。
主要能力
- 主题配置：为每个主题定义名称、搜索查询、关键词、频率、重要性阈值、告警渠道和上下文。
- 定时监控：按可配置的间隔（hourly / daily / weekly）自动执行搜索。
- AI 重要性评分：对每条结果打分，高重要性立即告警，中重要性保存进摘要，低重要性忽略。
- 上下文摘要：不只给链接，而是给出带上下文的摘要。
- 每周摘要：把非紧急的发现汇编成可读报告。
- 记忆整合：可引用用户过去的对话与兴趣，生成个性化摘要。
- 学习模式：跟踪用户与告警的互动，调整评分权重并建议主题优化。
- 去重与限流：通过状态文件避免重复告警，并限制每日告警数量。
使用方式
首次使用运行交互式设置向导：
python3 scripts/setup.py
向导会依次询问：要监控的主题、每个主题的搜索查询、关键词、检查频率（hourly/daily/weekly）、重要性阈值（low/medium/high）、是否生成每周摘要。完成后生成 config.json，之后可手动编辑或用 manage_topics.py 增删主题。
手动快速开始：
# 从模板初始化配置
cp config.example.json config.json
# 添加主题
python3 scripts/manage_topics.py add "Product Updates" \
--keywords "release,update,patch" \
--frequency daily \
--importance medium
# 测试监控（dry run）
python3 scripts/monitor.py --dry-run
# 设置 cron 自动监控
python3 scripts/setup_cron.py
主要脚本：
- manage_topics.py：添加、列出、编辑、删除、测试主题。
- monitor.py：主监控脚本，通常由 cron 调用；支持 --dry-run、--topic、--verbose。
- digest.py：生成每周摘要，支持 --send、--preview。
- setup_cron.py：配置自动监控的 cron 任务，支持 --auto、--remove。
监控流程：读取到期需检查的主题 → 使用 web-search-plus 或内置 web_search 搜索 → 用 AI 重要性评分器打分 → 高重要性立即告警、中重要性存入摘要、低重要性忽略 → 更新状态防止重复告警。
配置要点
每个主题包含：name、query、keywords、frequency、importance_threshold、channels、context、alert_on。全局 settings 包含 digest_day、digest_time、max_alerts_per_day、deduplication_window_hours、learning_enabled 等。
告警渠道支持 Telegram（需 OpenClaw message 工具）、Discord（webhook）、Email（SMTP 或 API）。
高级配置包括告警条件（alert_on、ignore_sources、boost_sources）、正则模式（patterns）、限流（max_alerts_per_day、max_alerts_per_topic_per_day、quiet_hours）。
状态管理：.research_state.json 记录每个主题的最后检查时间、已告警 URL、评分历史和学习数据；.findings/ 目录存放适合摘要的发现。
适用场景
- 跟踪产品发布（如 iPhone 17 发布）。
- 监控竞争对手动态（产品发布、融资）。
- 跟踪研究主题（如量子计算论文）。
- 安全漏洞监控（CVE、补丁）。
- 行业新闻与融资收购动态。
限制与注意事项
- 除搜索 API 外不依赖外部服务，所有数据保存在本地；状态文件已加入 gitignore。
- 记忆提示文件 references/memory_hints.md 为可选，由用户自行创建。
- 学习数据保存在 .learning_data.json，仅本地存储。
- 若未收到告警，可检查 cron 是否运行、渠道配置是否正确，并用 --dry-run --verbose 查看评分。
- 告警过多时可提高重要性阈值、增加限流、优化关键词或启用学习模式。
- 遗漏重要新闻时可降低阈值、提高检查频率或放宽关键词。
- 摘要未生成时，检查 .findings/ 目录是否存在且有内容，并确认摘要 cron 计划。
- 该技能为 ClawHub 构建，使用 web-search-plus 技能进行智能搜索路由。