xueayi/dsh-opencode-go-usage

dsh-opencode-go-usage

OpenCode Go plan usage monitor for DeepSeek Harness: a floating dock in the web GUI showing the 5h-rolling / weekly / monthly quota windows with live reset countdowns.

Data comes from the official quota API (GET https://opencode.ai/zen/go/v1/usage, Bearer API key; no workspace id, no cookie).

Install

# From npm (the Web GUI runs on the `web` profile):
dsh plugin --profile web add @xueayi/dsh-opencode-go-usage
# Or from a local checkout:
dsh plugin --profile web add /path/to/dsh-opencode-go-usage
# Upgrade to the latest version:
dsh plugin --profile web update @xueayi/dsh-opencode-go-usage

Restart the profile afterwards (dsh web for the browser UI).

Configure

Recommended: pick the official-channel OpenCode Go provider in Web Settings → Models and enter the API key there; nothing else is needed.

The API key is resolved per refresh through ctx.credentials under the apiKeyEnv reference (default OPENCODE_GO_API_KEY) — it can also be stored manually in ~/.dsh/.credentials.yaml or an environment variable:

- insert:
    - id: opencode-go-usage
      name: '@xueayi/dsh-opencode-go-usage'
      config:
        apiKeyEnv: OPENCODE_GO_API_KEY
        refreshMs: 60000

Usage dock

A glassy floating dock at the bottom-right corner (the web shell owns no bottom-right slot; mounted through a body portal):

• Badge (collapsed): three mini double rings show all three quota windows at a glance — the outer ring is the remaining quota share (a full ring when nothing is used yet, shrinking as quota is spent; the arc is threshold-colored by spent share: green <60% / orange ≥60% / red ≥85%, so a nearly-empty ring reads red), the inner ring is the window's remaining time until its next reset (brand blue, shrinking live with the window period); beside them an exact 5h-rolling countdown (↻3h25m) and a live health dot.
• Panel (click to expand): one row per window (5h Rolling / Weekly / Monthly) with a double usage ring (remaining quota outer + remaining time inner), the used/remaining percent (preceded by a tone-colored dot: green/amber/red for the spent share, a blue dot before the reset countdown restating the inner ring color), and a live reset countdown; the footer holds the update timestamp, a "Console ↗" link to the OpenCode Go console, and a manual refresh button.
• Dragging: grab the badge and drop it anywhere on screen (the press only becomes a drag after ~4px of pointer travel, so a plain click still toggles the panel); the position persists in localStorage across reloads and is clamped back inside the viewport on window resize. The open panel follows the badge and auto-flips — below it when the top would clip, left-aligned when the badge sits near the left edge — so it always stays fully visible.
• Minimal mode: the panel header carries a "极简" (minimal) switch. When enabled, the whole dock collapses to a single 5h-rolling ring — the badge keeps just one 5h double ring at the regular mini size (remaining quota outer, remaining time inner) with the remaining percent centered inside; no countdown, labels, or health dot. The panel keeps only the 5h-rolling row; the preference persists as well.
• Unconfigured/error states render inline with configuration guidance; a failed fetch never blanks the dock.