Foreword

When developing local agents using DeepSeek Harness (DSH), checking API balance and available models often requires switching to the DeepSeek console or writing separate scripts. During conversations, it’s also difficult to determine the remaining quota of the current Key or whether peak-hour pricing is in effect.

The dsh-balance plugin introduced below is a community-maintained client-side plugin that integrates balance checking and model list into DSH’s settings page and displays a summary continuously below the chat box. The API Key is only used locally and is not sent to the browser.

What Is This

dsh-balance is maintained by crazywoola and is categorized as a client-side plugin. It can be found in the SkillHub directory. The npm package name is @pinkbanana/dsh-balance, currently at version 0.4.1, and is licensed under the MIT License.

The plugin is aimed at developers who are already using DSH Web profiles: it allows you to view DeepSeek account balance, top-up balance, bonus balance, and the list of available models for the current API Key directly within Harness, without leaving the chat interface.

Core Features

According to the project’s README, the plugin provides the following capabilities:

  • View total balance, top-up balance, and bonus balance
  • Continuously display a balance summary below the chat box
  • View the list of models available for the current API Key
  • Cache query results and support manual refresh
  • Change the balance indicator light below the chat box to orange during peak pricing hours in Beijing time (9:00–12:00 and 14:00–18:00) based on DeepSeek’s peak/off-peak pricing
  • Natively support Simplified Chinese and English, switching with the Harness system language
  • Support Harness’s saved DEEPSEEK_API_KEY, or configure the API Key in “Settings → Models”

Installation and Enabling

First, install the plugin in DSH, then start Harness with the Web profile:

dsh plugin --profile web add @pinkbanana/dsh-balance@latest
dsh --profile web

After installation, open http://127.0.0.1:3080/ and go to “Settings → DeepSeek Balance”. This entry is located below “Agent Presets”. If the API Key has been saved in “Settings → Models” or provided via the environment variable DEEPSEEK_API_KEY, the plugin can initiate balance and model queries.

Typical Usage

After installation and API Key configuration, follow these steps to use:

  1. Open the Harness web interface, go to “Settings → DeepSeek Balance”, and view total balance, top-up balance, bonus balance, and the list of available models.
  2. Return to an existing session; the balance summary will be displayed below the chat box, eliminating the need to enter the settings page each time.
  3. When up-to-date data is needed, manually refresh in the settings panel; the plugin caches query results to reduce redundant requests.
  4. If currently in DeepSeek’s peak pricing hours (Beijing time 9:00–12:00 and 14:00–18:00), the balance indicator light below the chat box will turn orange to help you stay aware of billing changes.

Two ways to configure the API Key:

  • Save it in Harness’s “Settings → Models”
  • Provide it via the environment variable DEEPSEEK_API_KEY

Use Cases and Considerations

Who Is This For

  • Developers who frequently debug agents in DSH and need to monitor API balance at any time
  • Users who want to confirm available models for the current Key within the same chat interface to avoid discovering quota exhaustion only after it happens
  • Scenarios where monitoring DeepSeek’s peak/off-peak pricing and balance status during peak hours is important

Considerations Before Use

  • The plugin runs with the permissions of the current dsh process. Before installation, read the GitHub source code and review the MIT license terms.
  • This plugin is for the Web profile (--profile web). The package name in the installation command is @pinkbanana/dsh-balance, corresponding to the GitHub repository crazywoola/dsh-balance.
  • SkillHub is a community plugin directory and has no official affiliation with DeepSeek or High-Flyer; the plugin’s capabilities are based on the README and source code.
  • Development and building require Node.js >= 20; contributors can run pnpm install and pnpm check for validation.

Conclusion

dsh-balance integrates DeepSeek API balance and model queries into DSH’s settings page and chat interface, reducing the need to switch between the console and Harness. If you are using DSH for local agent development, you can obtain the plugin from the directory page or GitHub and install it using the commands above.