Community研究與資料分析github.com

vahnxu/signalradar

監控 Polymarket 預測市場的機率變化。涵蓋 AI、加密貨幣、地緣政治。零依賴。

signalradar 是什麼?

SignalRadar 是一個輕量級的工具,專為監控 Polymarket 預測市場的機率變化而設計。它專注於 AI、加密貨幣和地緣政治等領域,且零依賴,易於部署。使用者可以透過 CLI 指令新增、列出、檢查和移除監控的市場,並設定觸發警報的閾值。SignalRadar 支援多種通知傳遞方式,包括 webhook(推薦)、本地檔案記錄以及 OpenClaw 平台訊息。其核心工作流程為:透過 crontab 排程定期執行檢查,偵測到機率變化超過閾值時,透過設定的傳遞渠道發送警報,整個過程無需 LLM 參與,因此零 LLM 成本且無平台依賴。此技能特別適合需要在不耗費 LLM token 的情況下,持續追蹤特定預測市場動態的開發者或 AI 代理使用者。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add vahnxu/signalradar

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

signalradar 是做什麼的?

傳遞渠道

SignalRadar 支援三種傳遞適配器來發送警報:

  • webhook(建議,可攜式)— HTTP POST 到任何端點(Slack webhook、Telegram Bot API、Discord 等)。可在任何平台上使用。搭配 crontab 排程時,可在零 LLM 成本、零平台依賴的情況下傳送通知。
  • file— 將警報附加到本機 JSONL 檔案。適合本地記錄或自訂消費。
  • openclaw(僅限 OpenClaw)— OpenClaw 平台訊息傳送。僅在透過 ClawHub 安裝時可用。不可移植到其他平台。

預設傳遞渠道是 webhook。 使用以下指令設定您的 webhook URL:

python3 scripts/signalradar.py config delivery webhook https://your-webhook-url

傳遞路徑(技術細節): crontab → signalradar.py run --yes --output json → 偵測到 HIT → deliver_hit() → HTTP POST 到 webhook URL → 訊息送達。零平台依賴,零 LLM 成本。

意圖對應

在收到使用者訊息後,從此表格中選擇一個指令。當沒有符合的意圖時,請勿執行任何指令 — 只需正常聊天。

用户意图(中文常见表达)English intentCommand
"看看我监控了啥" / "我的列表" / "在追踪哪些""list my monitors" / "what am I tracking"list
"有啥变化吗" / "检查一下" / "跑一下""any changes?" / "run a check"run
"帮我加一下 [URL]" / "监控这个链接""add this market" / "monitor this"add <url>
"帮我加几个市场" / "想监控但没链接""add markets" (no URL)add (no arg) → empty watchlist returns ONBOARD_NEEDED, Agent starts onboard flow
"删掉第 N 个" / "不监控这个了""remove #N" / "stop monitoring"remove <N>
"阈值改成 X" / "灵敏度调高""change threshold" / "more sensitive"config threshold.abs_pp <X>
"多久检查一次" / "改成 30 分钟""check frequency" / "every 30 min"schedule / schedule 30
"自动监控还在跑吗" / "cron 状态""is auto-monitoring running?"schedule (view status)
"现在设置是什么" / "阈值多少""what are current settings?"config (must check actual value)
"健康检查" / "能用吗""health check" / "is it working?"doctor --output json
"周报" / "本周总结" / "生成 digest""weekly digest" / "summary report"digest
"设置推送" / "配置通知渠道""set up notifications" / "configure delivery"Guide user to provide webhook URL, then config delivery webhook <url>
"通知改中文" / "语言改中文""switch to Chinese notifications"config profile.language zh
"好的" / "没事" / "OK" / "知道了"casual chatDo NOT run any command
"那个 GPT 概率多少了""what's the probability of X?"show <number|keyword>

關鍵規則

CR-01 多市場事件必須先報告數量 如果事件包含多個市場(>3 個),CLI 會強制輸出數量、類型摘要和市場列表,然後才等待確認;即使使用 --yes 也無法跳過。代理在執行 add 之前,必須先解釋數量與類型。

CR-02 絕不自動新增市場 使用者必須明確提供 Polymarket URL 或從預設項目中選擇。請勿自動新增。

CR-03 代理不得直接編輯資料檔案 代理不得使用 Write/Edit 工具編輯 ~/.signalradar/cache/、~/.signalradar/config/watchlist.json 或基準檔案。請僅使用 CLI 指令。一般執行時會自動寫入這些檔案 — 這是預期行為。(注意:人類使用者可能手動編輯 watchlist.json — 系統可以容忍。此規則僅限制代理。)

CR-04 與人類對話時不使用 --yes 在與人類使用者互動時,代理不得使用 --yes 旗標。--yes 旗標僅供自動化/CI 管道使用(冒煙測試、cron 任務、發布前閘道)。讓內建確認機制來處理使用者互動。

CR-05 務必檢查實際設定值 當使用者詢問當前設定時,一律先執行 signalradar.py config。請勿猜測或憑記憶回答。如果缺少某個值,請報告預設值並說明「此為預設值」。

CR-06 首次新增後自動啟用監控(crontab 優先,帶路由閘道) 在首次執行 add 或 onboard finalize 後,背景監控會嘗試自動啟用(間隔 10 分鐘)。優先使用系統 crontab;僅在 crontab 不可用時才回退到 openclaw cron。路由閘道:當 delivery.primary.channel == openclaw + crontab 驅動 + 沒有捕獲的回覆路由時,CLI 會啟用監控,但會返回 route_missing 警告,因為檢查可以執行,但背景聊天傳遞尚未就緒。代理不得詢問「我應該設定 cron 嗎?」,也不得手動建立任務。檢查 schedule --output json 中的 delivery_status,並如實報告監控和傳遞是否處於活躍狀態。建議組合:crontab 排程 + webhook 傳遞 = 零 LLM 成本 + 零平台依賴。

CR-07 使用 CLI 管理設定和排程 使用 signalradar.py config [key] [value] 來管理設定(閾值、傳遞渠道等)。使用 signalradar.py schedule [N|disable] [--driver auto|openclaw|crontab] 來管理監控頻率。請勿手動編輯 JSON 設定檔。

CR-08 空的監視列表會觸發引導流程 當監視列表為空且代理執行 add/run --output json 時,回應將是 ONBOARD_NEEDED。代理接著必須啟動 3 步驟的 onboard 流程,而不是建議提供 URL。

CR-09 引導流程是一個 3 步驟的流程 + webhook 指引(狹橋原則) 在 Bot/Agent 模式下,新使用者的引導流程透過 onboard 子指令分三步驟進行:

  1. onboard --step preview --output json → 顯示預設事件列表 + 術語教育(事件/市場)→ 詢問使用者「要移除哪些?」
  2. onboard --step confirm --keep <user-selection> --output json → 顯示子市場細節 + 術語(類別/基準線)→ 詢問「確認新增?」
  3. onboard --step finalize --output json → 寫入監視列表 + 啟用自動監控 → 顯示完成訊息與後續步驟 每個步驟都必須等待使用者回覆後才能繼續。請勿將 3 個步驟壓縮成 1 個。

Webhook 指引(finalize 後):ONBOARD_COMPLETE JSON 包含 webhook_setup 欄位。當 webhook_setup.needed == true 時,代理應主動引導使用者設定 webhook URL 以用於背景推送。提供 Telegram Bot API / Slack / Discord URL 範例。使用者提供 URL 後,執行 config delivery webhook <URL>。

CR-10 背景推送需要捕獲的回覆路由 在 crontab 路徑上的背景 --push 需要一個儲存的路由(~/.signalradar/cache/openclaw_reply_route.json)。如果缺失,請勿聲稱背景傳遞正在運作。對於 openclaw 傳遞,檢查 schedule --output json 中的 delivery_status 和 route_ready。

CR-11 在聲明推送就緒前驗證實際狀態(渠道感知) 在告訴使用者背景推送正在運作之前,檢查 schedule --output json → delivery_status 欄位:

  • "ready" → 推送對當前傳遞渠道有效
  • "webhook_url_missing" → 引導使用者執行 config delivery webhook <URL>
  • "route_missing" → 僅與 openclaw 渠道相關;如果使用者使用 webhook,此欄位不會出現
  • "file_target_missing" → 引導使用者設定檔案目標

請勿跨渠道混合診斷。如果傳遞渠道是 webhook,請勿檢查或報告 route_ready — 這與之無關。delivery_status 欄位已考慮到活躍渠道。

已知的 AI 錯誤(請勿重複)

這些錯誤實際發生在生產環境中。代理必須避免它們。

錯誤 1:未事先報告數量就新增 28 個市場

  • 錯誤:使用者發送比特幣 URL → 代理執行 add 並默默新增 28 個市場
  • 正確:報告「此事件有 28 個子市場(14 個上漲 + 14 個下跌)。全部新增還是挑選?」→ 等待回覆

錯誤 2:使用者說「好的」→ 代理觸發 run 並輸出 NO_REPLY

  • 錯誤:使用者說「好的」→ 代理執行 signalradar.py run → 回覆「NO_REPLY」
  • 正確:「好的」是隨口應答。正常回覆,不要執行任何指令。

錯誤 3:在人機對話中使用 --yes

  • 錯誤:signalradar.py add <url> --yes(跳過人類聊天中的確認)
  • 正確:signalradar.py add <url>(讓內建確認機制處理;CLI 會對大量批次強制預覽)

錯誤 4:使用 Write/Edit 工具編輯 watchlist.json

  • 錯誤:使用 Write/Edit 工具編輯 ~/.signalradar/config/watchlist.json
  • 正確:使用 signalradar.py add、remove、config CLI 指令

錯誤 5:憑記憶猜測設定值

  • 錯誤:「預設閾值是 5pp」(未經檢查)
  • 正確:先執行 signalradar.py config threshold.abs_pp,然後用實際值回答

錯誤 6:在技能之外編寫補償腳本

  • 錯誤:在技能之外編寫輔助腳本,例如 send_alerts_to_telegram.py,來補償缺失的行為
  • 正確:將監控、排程和傳遞保留在技能/運行時契約內。如果存在真正的間隙,請修復技能本身,而不是發明側腳本

錯誤 7:將 clawhub 更新視為全新安裝而不檢查資料

  • 錯誤:clawhub update 後,假設使用者丟失了所有資料,並在未檢查運行時資料目錄的情況下將其視為全新安裝
  • 正確:先讀取實際的使用者資料目錄(~/.signalradar/ 或 SIGNALRADAR_DATA_DIR),然後再決定是否需要遷移或恢復

錯誤 8:未檢查 webhook URL 就聲明推送就緒

  • 錯誤:「背景監控已啟用,警報將會送達!」(當 webhook URL 為空時)
  • 正確:檢查 doctor --output json → 如果 webhook_url_configured: false,引導使用者設定 webhook URL

錯誤 9:將 3 步驟引導流程壓縮成一次執行

  • 錯誤:依序執行所有 3 個 onboard 步驟,而不向使用者顯示任何結果
  • 正確:向使用者顯示每個步驟的輸出,並在繼續之前等待他們回覆

錯誤 10:未檢查路由就聲明推送就緒

  • 錯誤:「背景推送已全部設定完成!」(未檢查 route_ready)
  • 正確:檢查 schedule --output json → 如果 route_ready: false,告訴使用者傳遞尚未就緒

錯誤 11:未檢查 webhook URL 就聲明推送就緒

  • 錯誤:「背景監控已啟用,警報將會送達!」(當 webhook URL 為空時)
  • 正確:檢查 doctor --output json → 如果 webhook_url_configured: false,引導使用者設定 webhook URL

快速入門

# 安裝(OpenClaw 使用者)
clawhub install signalradar

# 或直接 Clone
出錯或無法再繼續進行翻譯

相關技能