dsh-opencode-go-usage

简体中文 · English

A DeepSeek Harness web-GUI plugin that shows your OpenCode Go subscription usage in real time — a floating widget that tracks rolling / weekly / monthly quota for every API key in your pool, with color-coded progress bars and reset countdowns.

Features

• Floating widget — a compact button pinned to the right edge of the page. Its badge shows the worst window across all keys at a glance; the color (green / orange / pulsing red) tells you whether any key is close to its quota limit.
• Expandable panel — click the button to open a panel with one card per key (the currently active key is marked with a ★), each showing rolling / weekly / monthly usage as progress bars, percentages, and time-until-reset. Rate-limited windows are flagged with ⚠.
• Real-time — the Host polls the official usage endpoint every 60 seconds (configurable); the panel refreshes automatically and has a manual refresh button.
• Auto key-pool discovery — reads your key pool from $DSH_HOME/.credentials.yaml (any OPENCODE_GO_KEY_ entries), so there is no hardcoded key count or name. Falls back to the single current key (OPENCODE_GO_API_KEY) when no pool exists.
• i18n — Chinese / English, auto-selected from your browser language.
• Theme-aware — uses DSH theme tokens; works in both light and dark themes.

Screenshot

How it works

Host half (plain Node ESM):

1. Discovers key-pool names — from config.keyNames if provided, otherwise by scanning .credentials.yaml for OPENCODE_GO_KEY_* entries.
2. Resolves each key value through the credentials service (environment → credentials file → .env layering).
3. Calls the official usage endpoint with Authorization: Bearer :

GET https://opencode.ai/zen/go/v1/usage
Authorization: Bearer 

Response example:

{
  "usage": {
    "rolling": { "status": "ok", "percent": 9,  "resetsAt": "2026-08-14T07:20:04.810Z" },
    "weekly":  { "status": "ok", "percent": 12, "resetsAt": "2026-08-17T00:00:00.810Z" },
    "monthly": { "status": "ok", "percent": 6,  "resetsAt": "2026-09-09T00:41:03.810Z" }
  }
}

The usage endpoint is not yet part of OpenCode's public documentation; it was discovered and verified via farion1231/cc-switch#6433. Parsing is defensive.

Client half (browser bundle) registers in the shell.overlay slot and polls the Host's web-server route /plugins/dsh-opencode-go-usage/snapshot. Keys never leave the Host.

Requirements

• Node.js + a DeepSeek Harness web profile (the default dsh web profile mounts webServer, credentials, and timer, which this plugin needs).

Install

Option A — local package via file: dependency (recommended)

1. Copy the package directory anywhere on disk, e.g. D:\tools\dsh-opencode-go-usage.
2. In your profile's package.json (e.g. $DSH_HOME/profiles/web/package.json), add to dependencies:

"@xiaweiliang060035/dsh-opencode-go-usage": "file:D:/tools/dsh-opencode-go-usage"

3. Add the package to the profile's bundle list (dsh.profile.bundles):

"dsh": {
  "profile": {
    "bundles": [ "...existing...", "dsh-opencode-go-usage" ]
  }
}

4. Install and restart:

cd $DSH_HOME/profiles/web
pnpm install

## Configuration

Tunables go in the plugin row's `config` (override it in your profile's `cordis.patch.yml`):

```yaml
- id: opencode-go-usage
  config:
    keyNames: [go1, go2]      # optional: explicit key-pool names
    baseUrl: https://opencode.ai/zen/go/v1/usage   # optional
    refreshMs: 60000          # optional: poll interval (ms)
    timeoutMs: 15000          # optional: fetch timeout (ms)
    dshHome: ~                # optional: override the DSH home directory
    hideCordisPanel: true     # optional: hide the built-in "Cordis plugins" sidebar entry

Key	Default	Description
keyNames	auto-discovered	Explicit key-pool names (OPENCODE_GO_KEY_ in .credentials.yaml)
baseUrl	https://opencode.ai/zen/go/v1/usage	The usage endpoint
refreshMs	60000	Host poll interval in milliseconds
timeoutMs	15000	Fetch timeout in milliseconds
dshHome	resolveDshHome()	DSH home directory containing .credentials.yaml
hideCordisPanel	false	Hide the built-in "Cordis plugins" sidebar entry (dynamic-plugin admin panel)