Introduction

When running multiple sets of providers, models, and workspaces in DSH’s Web profile, usage metrics tend to be scattered across session logs. dsh-usage-monitor is a client plugin that aggregates token and request usage from session logs into Settings → Usage, making it convenient to view trends, proportions, and cache-hit rates.

What is it

The owner of dsh-usage-monitor is NOirBRight, and it is positioned as a Session-log usage dashboard for DeepSeek Harness. It reads live and persisted sessions from ctx.sessionQuery and displays tokens, requests, output tokens, and cache-hit rate in Settings → Usage on the Web UI. The license is MIT.

Core Features

  • Display tokens, requests, output tokens, and cache-hit rate in Settings → Usage.
  • Provides a stacked chart viewable by token / request metrics, grouped by provider / model / workspace, and aggregated by day / week.
  • Supports week, month, and custom ranges.
  • Provides a responsive overview: full-width token summary, compact secondary metrics, stacked chart, and token-share cards.
  • On narrow screens, cards collapse into a single column, and the chart legend scrolls horizontally.

Installation and Usage

First, confirm two prerequisites: DeepSeek Harness requires version 0.1.0-rc.6 or higher; package.json engines requires node ^22.19.0 || >=24.0.0. Below is the installation command using the fixed version v0.2.9 release:

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-usage-monitor/releases/download/v0.2.9/dsh-usage-monitor.tgz

After installation, open Settings → Usage. If configured via the Settings Web UI plugin section or the dsh.profile.bundles entry, explicit credentials/backend addresses must be provided.

After installation, you can verify with the following commands:

dsh plugin --profile web list
dsh plugin --profile web doctor

Typical Usage

Check plugin loading status:

dsh plugin --profile web list
dsh plugin --profile web doctor

Update to the latest release:

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-usage-monitor/releases/latest/download/dsh-usage-monitor.tgz

Uninstall:

dsh plugin --profile web remove dsh-usage-monitor

When rolling back to v0.2.9, re-run the fixed v0.2.9 installation command, verify the profile list, and restart the Web service once:

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-usage-monitor/releases/download/v0.2.9/dsh-usage-monitor.tgz
dsh plugin --profile web list

Use Cases and Notes

Suitable for developers who need to view DSH session usage in the Web UI and analyze token and request distribution by provider/model/workspace. Notes:

  • The plugin does not retrieve Subscription quotas.
  • The plugin does not directly scan session.jsonl.zstd, nor does it read leftover community cache files.
  • The plugin reads live and persisted sessions from ctx.sessionQuery.
  • The v0.2.9 Release artifacts target DeepSeek Harness 0.1.2-alpha.1 and only contain built Host/Client files.
  • The Release provides links for v0.2.9 and SHA256SUMS verification; it is recommended to verify the source, verification information, and license before installation.
  • The plugin runs with the permissions of the current dsh process; the source code and configuration origin should be checked before installation.

The DSH Community Directory is an independent site with no official affiliation with DeepSeek / Huanfuan.

Links

GitHub Repository: https://github.com/NOirBRight/dsh-usage-monitor