Introduction

When developing agents using DSH, the model selector may display models from multiple vendors simultaneously, such as DeepSeek, StepFun, Kimi Coding, OpenRouter, MiniMax, xAI / Grok, etc. Being able to call a model does not mean the current account has sufficient balance or quota; checking the corresponding console every time interrupts the development workflow.

dsh-model-balance is a DSH Web GUI plugin maintained by nabin-qq273274877 and licensed under the MIT License. It displays a balance capsule before the composer’s model selector, directly showing the current vendor’s real account balance or quota at the position of model switching.

Plugin Positioning

The problem solved by dsh-model-balance is specific: to display the real account balance and quota of multiple vendors before the model selector in the DeepSeek Harness Web GUI.

It does not act as a model proxy nor does it change the model invocation chain. It only adds an entry point for displaying balance within the model selection area of the DSH Web GUI. For vendors with an API balance or quota interface, the plugin queries and displays the results directly; for vendors without an API balance interface, the plugin provides a console entry point.

Supported Scope

The following is classified by query method.

Suppliers Queryable via API

These vendors support querying through official balance or quota interfaces:

  • DeepSeek
  • StepFun
  • Kimi Coding
  • OpenRouter
  • MiniMax
  • xAI / Grok

Among them, Kimi Coding displays quota information rather than just monetary balance.

Suppliers Requiring Login

The following vendors do not have an API balance interface and require login to view:

  • Tongyi Token Plan
  • Xiaomi MiMo

After clicking the corresponding capsule in the plugin interface, the corresponding console will open in a new page.

Not Supported Yet

The following vendors are not supported yet:

  • Mistral
  • Groq
  • Cohere, etc.

Balance Refresh

The plugin refreshes the balance at the following times:

  • Immediately display the balance for that vendor after switching models.
  • Force a refresh bypassing the cache after the conversation ends.
  • Perform a scheduled polling every 2 minutes.
  • Force a refresh bypassing the cache when clicking the capsule.

The host router caches query results:

  • Successful results are cached for 60 seconds.
  • Failed results are cached for 15 seconds.

The actions of ending a conversation and clicking the capsule bypass the cache to confirm the latest status.

Installation and Enabling

Install the plugin via GitHub:

npx @deepseek-ai/dsh plugin --profile web add github:nabin-qq273274877/dsh-model-balance

You can also install using the npm package name:

npx @deepseek-ai/dsh plugin --profile web add dsh-model-balance

For local development, you can also use the link method:

npx @deepseek-ai/dsh plugin --profile web add link:/path/to/dsh-model-balance

After installation, restart dsh web and refresh the page.

If you need to uninstall:

npx @deepseek-ai/dsh plugin --profile web remove dsh-model-balance

Custom Providers

If your vendor is not in the built-in list, you can add it via a configuration file.

Two locations are supported:

  1. Edit providers.json in the plugin directory.
  2. Create ~/.dsh/model-balance-providers.json.

Steps:

  1. Edit providers.json in the plugin directory, or create ~/.dsh/model-balance-providers.json.
  2. Add the vendor in the configuration.
  3. After modifying the vendor configuration, restart dsh web and refresh the page.

Notes

  • The plugin registers with the dsh web host and runs with the current dsh process permissions; it is recommended to check the source code and license before installation.
  • The host router is responsible for parsing credentials and querying the billing API; the API Key will not reach the browser.
  • Tongyi Token Plan and Xiaomi MiMo require login to view and do not have an API balance interface.
  • Mistral, Groq, Cohere, etc., are not supported yet.

Conclusion

dsh-model-balance is suitable for developers who use multiple model vendors simultaneously in the DSH Web GUI and wish to check balance or quota without leaving the workspace.

Plugin entry point:

  • Directory page: https://www.skillhub.cn/plugins/nabin-qq273274877/dsh-model-balance
  • GitHub: https://github.com/nabin-qq273274877/dsh-model-balance