In use cases for DeepSeek Harness (DSH), agent developers often need to manage multiple AI service subscription quotas and account balances at the same time. Manually checking account status on each platform can interrupt the workflow. The dsh-ai-quota plugin provides a one-stop quota monitoring solution by consolidating the status of different services into a single interface.

This is a DeepSeek Harness plugin maintained by Carrick-K7. It supports Codex, Kimi, GLM Coding Plan, DeepSeek, 302.AI, and OpenCode Go. It presents subscription windows or balance information in a unified format and provides automatic refresh and visualized management features.

Core Features

This plugin provides the following capabilities:

  1. Model tool query_ai_quota: Call this tool in any agent session to retrieve a quota summary.
  2. Settings page: The “AI Quota” settings page displays usage bar charts and balances by window, and supports manual refresh.
  3. Per-provider visibility: The title bar on the settings page includes a gear button that opens secondary settings, where a toggle can control the display state of each provider.
  4. Composer chips: On the new conversation page and within sessions, a row of quota indicators is displayed based on the currently selected provider routing (rather than the model ID).
  5. Automatic refresh: A configurable automatic refresh interval is supported. The default is 2 minutes, and it can be set to 0 to disable auto-refresh.
  6. Unified formatting: Data from different providers is normalized into subscription windows or balance entries. A failure from one provider does not affect the display of other providers.
  7. Skin-aware palette: All readout colors are defined with CSS variables. When a specific theme is loaded (such as dsh-miku-skin), the chips and usage bar charts reflect the corresponding theme colors.
  8. No key leakage: The plugin is designed to ensure that API keys and tokens never appear in tool output or logs.

Installation and Enablement

Run the following command in a terminal to install the plugin. This command automatically appends the plugin entry to dsh.profile.bundles. After installation, restart dsh web.

dsh plugin --profile web add github:Carrick-K7/dsh-ai-quota

Typical Usage

After installation, you can use it in the following ways:

  1. Session query: In any agent session, call the query_ai_quota tool to retrieve the current quota summary for all providers.
  2. Settings page view: Find the “AI Quota” section on the DSH settings page, then manually refresh and view the balances and usage bar charts for each service.
  3. Composer chips view: On the new chat page, based on the currently selected model routing, the chips automatically display the quota status of the corresponding provider.
  4. Provider management: In the “AI Quota” title bar on the settings page, click the gear button to toggle the display of a specific provider on or off.

Applicable Scenarios and Notes

  • Multi-service management: Suitable for DSH users who use multiple services such as Codex, Kimi, GLM, DeepSeek, 302.AI, or OpenCode Go simultaneously.
  • Local credentials: Codex and Kimi use local CLI login status, so no API key needs to be entered in the plugin.
  • Dependency requirements: Running this plugin requires the host environment to have React, Cordis, and other peer dependencies installed.
  • Data security: The plugin obtains keys through DSH credential mechanisms (such as DEEPSEEK_API_KEY) and never writes keys to output or logs.

Summary

dsh-ai-quota provides DSH users with intuitive and automated multi-platform quota management capabilities through three dimensions: the model tool, the settings page, and Composer chips. All displayed balance data is sourced from the official APIs of each service and follows a unified format and theme specification.