dsh-openrouter-monitor

English | 繁體中文

A DeepSeek Harness Web plugin that puts one line under the composer:

● 餘額 $12.40 · 今日 $0.85 · 本週 $3.20 · 4m
              ⚠ 餘額不足

• Live OpenRouter account balance and today/week spend, summed across every key.
• Alert thresholds — low balance, daily spend, per-key remaining — tint the row orange and can fire browser notifications (edge-triggered, once per UTC day).
• Hover card: account totals, balance & daily-spend trend charts, top keys with remaining-limit bars, and a local setup box.
• Configured in DSH settings under 「OpenRouter 監控」— interval, thresholds, display currency with manual FX rate — all live-applied without a restart.

Install

dsh plugin --profile web add dsh-openrouter-monitor

Restart dsh web; confirm both halves:

dsh --profile web --dump-config | grep openrouter-monitor

Setup

1. Hover the row → paste an OpenRouter Provisioning/Management key (sk-or-v1-…, created on openrouter.ai/keys with provisioning enabled). It is stored in this browser only (localStorage) and sent only to openrouter.ai — never to the DSH host. This is deliberate: DSH's settings wire redacts secret-role fields before they reach any browser, so the key could not be usable from settings even if it were stored there.
2. Tune interval / thresholds / currency in DSH settings → OpenRouter 監控.

A plain inference key authenticates but gets HTTP 403 on /keys — the setup box labels it insufficient. Without any key the row stays dim with a hint; poll failures keep the last good numbers alongside a red dot.

Notes

• Display conversion is by manual rate only (fxRate); USD passthrough needs none. The host schema rejects non-USD currencies with fxRate ≤ 0 at write time, and unknown codes degrade to plain $.
• Trend history keeps the latest 240 samples in localStorage; reloads continue the chart rather than restarting it.
• AI analysis of your bill needs no extra code here — paste the hover card's text into any DSH session.

MIT