核心用法
SignalRadar 是一款专为 Polymarket 预测市场设计的概率监控工具，通过持续追踪市场赔率变化，在概率波动超过设定阈值时向用户推送实时告警。
典型工作流程：
1. 添加监控：通过 add <polymarket-url> 添加单个事件，或执行 add 进入引导式市场选择
2. 查看状态：list 展示当前监控列表，show <keyword> 查看特定市场当前概率
3. 手动检查：run 执行即时全量检查，--dry-run 只读预览不更新基线
4. 自动监控：首次添加成功后自动启用 10 分钟间隔的 cron 后台监控
5. 阈值管理：默认 5 个百分点阈值，支持全局/分类/单市场三级配置
6. 通知渠道：推荐 webhook（零成本、跨平台），openclaw 为 OpenClaw 平台专用（Agent 回复即通知），file 用于本地日志
7. 周期报告：支持日/周/双周 digest，汇总期间概率变动 Top N 市场
关键概念：
- Baseline（基线）：上次记录的概率值，用于计算变化幅度
- HIT：变化超阈值 → 发送告警并更新基线
- SILENT/NO_REPLY：未超阈值或市场无变化
- 多市场事件：如 Bitcoin 价格预测含多个档位，工具自动分组展示
显著优点
1. 精准监控，噪音过滤：5pp 默认阈值有效过滤小幅波动，避免信息过载；支持 0.1pp 精度的细粒度配置
2. 架构简洁，零依赖：纯 Python 标准库实现，无需 pip 安装，单脚本即可运行
3. 跨平台可移植：webhook 通道完全解耦，可部署于任何支持 Python 3.9+ 的环境
4. 智能分组：同一事件下的多个关联市场自动聚合，告警清晰不重复
5. 状态持久化：基线、历史事件、归档市场分层存储，支持 --dry-run 安全测试
6. 自动化就绪：内置 crontab 自动调度，无需手动配置系统任务
潜在局限
1. 单数据源依赖：仅支持 Polymarket API（gamma-api.polymarket.com），不覆盖 Kalshi、PredictIt 等其他预测市场
2. 网络波动敏感：API 超时或不可用时直接报错，无内置指数退避重试
3. 阈值全局性陷阱：默认阈值对所有市场生效，高波动事件（如大选前夜）与稳定事件共用同一敏感度可能顾此失彼
4. 手动 URL 输入：无自动发现或推荐市场功能，依赖用户主动提供 Polymarket 链接
5. 结算后静默：已到期市场自动跳过检查，历史归档需手动清理
6. 语言本地化有限：系统消息支持中英，但市场问题保持英文原文
适合人群
- 信息套利者：追踪重大事件（AI 发布、大选、经济数据）的隐含概率变化，捕捉市场信息更新节奏
- 预测市场研究者：需要结构化概率时间序列数据进行分析
- 新闻敏感型投资者：将预测市场作为领先指标，辅助传统投资决策
- 自动化爱好者：希望搭建零成本、低维护的私有监控基础设施
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **API 可用性风险** | Polymarket 服务中断或限流导致监控失效 | 配置 `doctor` 健康检查，结合外部心跳监控 |
| **阈值设置风险** | 阈值过低导致告警疲劳，过高漏掉关键变化 | 从默认 5pp 开始，按事件类型逐步调优 |
| **基线漂移风险** | 长期未触发导致基线 stale，实际已大幅变动 | 定期 `run` 手动刷新，或缩短检查间隔 |
| **通知丢失风险** | webhook 端点失效、openclaw 路由未捕获 | 定期检查 `schedule --output json` 的 `delivery_status` |
| **数据隐私风险** | 监控列表暴露用户关注领域 | 本地文件权限控制，敏感事件使用私有 webhook 端点 |
| **平台锁定风险** | openclaw 通道非通用，迁移需重新配置 | 优先采用 webhook + crontab 组合确保可迁移性 |
技术可靠性：代码结构清晰（~1500 行主脚本），无外部依赖攻击面，配置与缓存分离设计降低数据损坏风险。MIT 协议开源，社区可审计。