Introduction¶
Under DSH’s “everything is a plugin” mechanism, the Web GUI can mount different extension capabilities. dsh-provider-quota addresses the issue of scattered quotas from model providers: it centralizes the balance queries of configured providers into the DSH Web GUI’s sidebar and settings page, providing a real-time panel and a manual refresh entry.
Overview¶
dsh-provider-quota is a model provider quota query plugin, maintained by 781316853, with an MIT license.
It provides real-time quota display for the DSH Web GUI: an entry point at the bottom of the sidebar + a popup panel (auto-polling every 60 seconds), and a full query block on the “Settings → Model Quota” page.
Core Features¶
Sidebar Real-time Panel¶
The “Model Quota” entry is provided at the bottom of the sidebar.
Upon clicking, a real-time panel pops up, automatically polling the balance of all configured providers every 60 seconds.
Settings Page Query Block¶
“Settings → Model Quota” displays the account balance of each configured provider.
Displayed fields include Available / Used / Total / Plan / Rolling Window, etc., and supports manual refresh.
Supported Providers¶
Supports the following providers that offer balance query interfaces:
- DeepSeek
- OpenAI
- Moonshot
- Zhipu
- OpenRouter
- SiliconFlow
- Z.AI
Quota Formats¶
The plugin can display quotas in multiple formats:
- Amount: CNY/USD, etc.
- Percentage Window: e.g., 5-hour rolling.
- Token Usage: Z.AI
Key Handling and Interface Language¶
API keys are only parsed on the host side; the browser side only renders the normalized results returned by the routing, ensuring keys are not sent to the browser.
Interface text follows the GUI language and supports Chinese and English bilingual display.
Mounting Method¶
The plugin is mounted via profile bundle patch + node_modules link, requiring no modification to the dsh source code.
Installation and Enablement¶
First, execute the installation command to add the plugin to the web profile:
dsh plugin --profile web add github:781316853/dsh-provider-quota
This is a bundle-type plugin. In addition to installing dependencies, the plugin’s package name must be added to the dsh.profile.bundles layer stack of the profile; both steps are essential.
Configuration items are as follows:
dsh.profile.bundles
After completing the installation and bundle layer stack configuration, restart the web service:
dsh web
You can also restart the desktop application to load the plugin.
Typical Usage¶
- Configure at least one provider that supports balance queries and its API key on the “Models” page.
- Click the “Model Quota” icon at the bottom of the sidebar; the panel will automatically refresh the balance. “Refresh All” allows for an immediate manual refresh.
- View the detailed quota and update time for each provider in “Settings → Model Quota”.
Use Cases and Notes¶
- Suitable for DSH users who need to view balances from multiple model providers centrally, especially in scenarios where provider keys are configured on the “Models” page.
- The plugin runs with the permissions of the current dsh process. It is recommended to check the source code and license before installation; the license for this plugin is MIT.
- The plugin declares peerDependencies, including
reactand multiple@deepseek-ai/dsh-client-*packages; the host environment must satisfy these dependencies. - API keys are not sent to the browser, but you should still manage the host-side accessible key configurations with care.
Related Links¶
- Independent Community Directory Page: https://www.skillhub.cn/plugins/781316853/dsh-provider-quota
- GitHub: https://github.com/781316853/dsh-provider-quota