DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

boldandigital /

boldandigital/dsh-minimax-quota

Verified

MiniMax Token Plan quota chip for DeepSeek Harness

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@b2e35657

Listed on DSH Plugin Hub

dsh-minimax-quota

MiniMax Token Plan quota chip for the DeepSeek Harness web surface.

It registers one entry in the conversation.composer.dock slot — the row below the composer card — so the remaining quota appears beside the "8.9M tok · Cache hit 91%" strip without touching the shipped UI.

● MiniMax 5h 32%

Clicking the chip opens a panel with the full detail: for every model bucket MiniMax reports, both the 5-hour and the weekly window, each with its remaining percentage, the "x of y left" request counts where MiniMax reports them, and the reset time.

Hovering does nothing. A readout that only appears on hover is invisible on a touch screen, awkward on a trackpad and impossible to screenshot — so the extra numbers live in a panel you open on purpose, and the chip stays a one-glance answer.

Choosing what the chip shows

The panel carries a small segmented control — 5-hour or Weekly — that decides which window the chip itself reports. The choice is remembered in the browser, so it survives a reload, and the chip updates the moment you pick one.

The chip shows the lowest percentage across the reported model buckets for the chosen window, because that is the number that decides when you actually run out. If MiniMax reports only one of the two windows, the chip falls back to the other one rather than showing nothing.

The panel always shows both windows, whatever the chip is set to, so nothing is hidden by the choice.

How it works

Two halves, following the DSH client-plugin contract:

Half File Role
Host lib/index.js Resolves the API key through the harness credential seam, queries MiniMax, normalizes the result
Client lib/client.js Renders the chip and registers it into the composer dock slot

The browser never sees the API key. The client calls the host over the loopback Connection RPC channel (/api, method namespace minimax-quota), and the host returns already-normalized rows.

Upstream endpoints

Tried in order; the first that answers wins:

Region Endpoint
international https://api.minimax.io/v1/api/openplatform/coding_plan/remains
international https://www.minimax.io/v1/token_plan/remains
china https://api.minimaxi.com/v1/token_plan/remains

All three accept a plain API key as Authorization: Bearer <key> — no admin key required.

The region reporting quirk

The international endpoints report current_interval_usage_count / current_weekly_usage_count as how much is left; the China endpoint reports how much was used. Naive subtraction therefore inverts the numbers on one side. This plugin reads the region-independent *_remaining_percent fields as the source of truth and only derives "x of y left" from the counts, interpreting them per region.

Configuration

In the profile's cordis.patch.yml:

- id: minimax-quota
  name: 'dsh-minimax-quota'
  config:
    refreshMs: 60000
    credentialRef: MINIMAX_API_KEY
Key Default Meaning
refreshMs 60000 How often the chip re-reads the quota (minimum 5000)
credentialRef MINIMAX_API_KEY Credential reference resolved through ctx.credentials

The credential must exist in the DSH credential store (~/.dsh/.credentials.yaml). It already does on this machine, so the chip works with no further setup.

Install

dsh plugin --profile web add dsh-minimax-quota

Or through the plugin manager: Plugins → Add plugin, then choose the npm package dsh-minimax-quota.

After installing, reload the GUI page so the browser picks up the new client module from the host's client graph.

Also useful

The same quota can be read from the terminal with the host's own tooling, which prints it as JSON:

dsh plugin --profile desktop status

Reference

The slot contract, the RPC envelope and the client-plugin shape were modelled on the community plugin dsh-quota-panel, which uses shell.overlay instead of the composer dock.

npm

This package is published on npm as dsh-minimax-quota, so you can install it with:

dsh plugin --profile web add dsh-minimax-quota
npm install dsh-minimax-quota

The package name is permanent on npm. Publishing new versions follows the standard npm version patch workflow with git tags.

Marketplace

Add the plugin market index source under Plugins → Discover → Manage index sources:

https://boldandigital.github.io/dsh-plugin-index/index.json

The index is rebuilt from the npm registry every morning, so it never points at a version the registry does not have.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit b2e35657b75e

Community comments

No comments yet. Be the first to write one.