When developing agents or making day-to-day calls with DeepSeek Harness (DSH), having real-time visibility into account balance and token usage is fundamental to debugging and billing. Manually querying APIs or inspecting logs often lacks intuitiveness. Below, we introduce dsh-plugin-quota, a plugin that mounts DeepSeek account quotas and session usage directly into the DSH Web settings interface.

What Is This?

The plugin, dsh-plugin-quota, is maintained by ArvenWang. It is a standalone installable plugin whose core value is bringing data that previously required extra queries or log inspection into the DSH Web settings interface with one click, enabling visual monitoring of balance and usage.

Core Features

The plugin provides two monitoring views:

  1. Account Quota
    Real-time query of DeepSeek account balance. Supports displaying total quota, bonus quota, and topped-up quota by currency. Includes an availability status badge (Available/Unavailable), as well as full loading, failure, and retry status handling. If a request fails, it clearly indicates the reason (for example, no configured Key, HTTP error, etc.).

  2. Token Usage
    Aggregates cumulative consumption for the current session. The data is split into four independent buckets: uncached input, output, cache reads, and cache writes, with a total value displayed. Inline values use compact k/M formatting, and hovering reveals exact numbers. The data source is the harness tokenUsage projection and updates in real time as the session progresses.

Installation and Enablement

Use the official command to install it into the Web Profile:

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

After installation, restart dsh web (or restart the desktop app), then find the Quota section in the settings interface.

Typical Usage

Before use, ensure the DeepSeek API Key has been configured. You can set it via the environment variable DEEPSEEK_API_KEY or configure it on the Settings → Models page. After navigating to Settings → Quota, you can see the account balance status and token consumption details for the current session.

Use Cases and Notes

  • Environment requirement: DeepSeek Harness version >= 0.1.0-rc.5 (Web profile).
  • Compatibility: A valid DeepSeek API Key is required. If using a custom OpenAI-compatible endpoint, the endpoint must support the /user/balance route; otherwise, an HTTP error will be displayed.
  • Security: The plugin follows DSH security principles. Routes are read-only, API keys do not pass through the browser, they remain in the host process, and they are not written to disk or logs.
  • Development details: The plugin has zero build and zero runtime dependencies (only peer dependencies). The code can run directly and mainly relies on official Harness packages.

Conclusion

By integrating dsh-plugin-quota, developers can monitor resource status and consumption without leaving the settings page while using the DSH Web interface daily. Its MIT license permits free use and modification. For more details or source code, refer to the project repository: https://github.com/ArvenWang/dsh-plugin-quota