Foreword

When using DSH to call DeepSeek models, there is often a lack of a direct view for costs among balance, cumulative consumption, and specific usage. dsh-usage-dashboard is a DSH Web plugin maintained by Cassius0924, licensed under MIT, designed to display account balance, daily/monthly/cumulative consumption with trends, model and session costs, cache savings, and bill estimates after the peak-valley pricing introduced on 2026-08-17.

DSH’s extension method can be understood as “everything is a plugin”; the community directory is an independent site, with no official affiliation to DeepSeek or High-Flyer. Below, we introduce this plugin’s capabilities, installation methods, and considerations.

What Is This

dsh-usage-dashboard adds a floating quota window and a top “Quota” tab to the DSH Web GUI, integrating quota and usage views into the existing Web session interface.

What You Can See

  • Account balance, as well as daily, monthly, cumulative consumption and trends.
  • Estimated days remaining based on average consumption over the last 7 natural days; turns red when less than 3 days.
  • Peak/valley usage distribution and bill estimates under the peak-valley pricing introduced on 2026-08-17.
  • Savings from prefix cache hits.
  • Model cost ranking by descending cost, with breakdowns for input, output, and cache.
  • Session cost ranking to identify the most expensive sessions.
  • Daily and hourly (0–23 hours) usage distribution over the last 30 days, as well as a heatmap for the last 12 weeks.

Interface and Alerts

The interface supports Chinese and English, following the DSH Settings → Language configuration. The floating quota window resides in the bottom-right corner, can be dragged, snapped to corners, collapsed, and its state is remembered. Styling uses DSH’s --dsw-alias-* CSS variables, adapting to the host theme.

The plugin supports setting a balance alert threshold. When the balance falls below the threshold, both the dashboard and the floating quota window will display a warning.

Cost Estimation

The costs shown by the plugin are estimates, not official bills. The estimation rules and pricing table are publicly disclosed; unrecognized models are priced according to deepseek-v4-pro. The estimates do not account for factors such as DeepSeek-side discounts or consumption order of credits. The final costs should be based on the official bill.

Installation and Enabling

First, confirm two prerequisites:

  • DEEPSEEK_API_KEY is configured, which the balance API will use for authentication.
  • pnpm is installed on the local machine, as dsh plugin is a wrapper for pnpm.

Install via npm:

dsh plugin --profile web add @cassius0924/dsh-usage-dashboard

Or install via GitHub:

dsh plugin --profile web add github:Cassius0924/dsh-usage-dashboard

After installation, restart dsh:

dsh --profile web

Typical Usage

  1. Open the GUI and enter any session. The 「Quota」 tab is attached to conversation.view; the New Session homepage does not have a tab bar, so you need to enter a session first.

  2. View Chat / Trajectory / Quota at the top.

  3. Configure the balance alert threshold in settings. The default is ¥10; set to 0 to disable.

  4. In the “Quota” tab, view pricing explanations, peak-valley pricing estimates, cache savings, model/session rankings, and usage distribution charts.

  5. The floating quota window in the bottom-right corner supports dragging, collapsing, and manual refresh with ↻, for constant visibility of quota information.

Data Scope and Performance

Usage data comes from local DSH session logs and does not include usage from other machines or accounts. Initial loading of usage requires replaying all session logs, taking about 5 seconds on the local machine, with 5-minute server-side memoization enabled.

Applicable Scenarios and Considerations

This is suitable for users who need to view DeepSeek quotas, usage, and cost distribution within the local DSH environment, especially those comparing models, sessions, peak-valley periods, and cache savings.

Please note: the plugin reads local DSH session logs and runs with the current dsh process permissions. Before installation, review the source code and license; the license is MIT.

Links