Preface¶

The DSH plugin mechanism allows attaching auxiliary capabilities to existing profiles, with a philosophy leaning toward “everything is a plugin.” For developers using OpenCode Go, quota windows and reset times are typically only visible in the console, and frequently switching back and forth in DSH’s Web interface is not convenient.

@xueayi/dsh-opencode-go-usage is a DSH plugin written for DeepSeek Harness (DSH), designed to display a floating dock in the Web GUI showing 5h-rolling / weekly / monthly quota windows and live reset countdowns.

What This Is¶

Here’s a brief overview of this plugin’s positioning:

• Plugin name: @xueayi/dsh-opencode-go-usage
• Maintainer: xueayi
• License: MIT
• Version declared in package.json: 0.1.6
• Node engine: ^22.19.0 || >=24
• Purpose: OpenCode Go plan usage monitor for DeepSeek Harness

It fetches data through the official quota API and provides a floating dock in DSH’s Web GUI for viewing 5h-rolling / weekly / monthly quota windows, remaining quota, reset countdowns, and refresh status.

Core Features¶

This plugin primarily solves the problem of “quickly viewing OpenCode Go quota in the Web GUI.” The verified capabilities are as follows:

1. Displays a floating dock in the Web GUI.
2. Shows 5h-rolling / weekly / monthly quota windows.
3. Displays live reset countdowns.
4. Supports collapsed badge and expandable panel.
5. Supports draggable badge, with position saved in localStorage.
6. Provides minimal mode.
7. Retains the last successful data with a notification on refresh failure.
8. Does not expose a model-facing surface, and does not add prompt text or tool schema.

The data source is the official quota API:

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

This request uses a Bearer API key and does not require a workspace ID or cookie.

Installation and Activation¶

The installation target is DSH’s Web profile. First, run the installation command:

dsh plugin --profile web add @xueayi/dsh-opencode-go-usage

Restart the profile after installation. The browser interface is usually restarted with:

dsh web

To upgrade to the latest published version later, use:

dsh plugin --profile web update @xueayi/dsh-opencode-go-usage

Typical Usage¶

It is recommended to complete provider selection in DSH’s Web configuration:

1. Open Web Settings → Models.
2. Select the official-channel OpenCode Go provider.
3. Fill in the API key.

The API key can also be provided via the following locations:

• ~/.dsh/.credentials.yaml
• Environment variable OPENCODE_GO_API_KEY

A verified configuration example is as follows:

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

Here:

• apiKeyEnv: Credential reference, defaulting to OPENCODE_GO_API_KEY
• refreshMs: Automatic refresh interval

Use Cases and Considerations¶

This plugin is suitable for developers who need to continuously monitor OpenCode Go quota in the DSH Web GUI. It does not enter the model request path, does not add prompt text or tool schema, and has no impact on model requests, token injection, or KV Cache.

Things to note before use:

1. An OpenCode Go API key is required.
2. Single-account usage, limited to one API key per profile.
3. Poll latency: collapsed badge polls every 60s, open panel every 10s.
4. Retains the last successful data after refresh failure; data may become stale.
5. Dragged positions do not have safe-area compensation.
6. The plugin runs with the current dsh process permissions; review the source code and MIT license before installation.

Conclusion¶

The value of @xueayi/dsh-opencode-go-usage is quite focused: it brings OpenCode Go’s 5h-rolling / weekly / monthly quota windows and reset countdowns into the DSH Web GUI, reducing the cost of leaving the current interface just to check quota.

Related links:

• GitHub: https://github.com/xueayi/dsh-opencode-go-usage
• Community directory page: Verified materials do not provide a verifiable URL; the DSH community directory is an independent site with no official affiliation to DeepSeek / High-Flyer, and the plugin can be searched by name on the directory site.