Introduction

If you manage sessions using the DeepSeek Harness (DSH) Web UI, you often want to check local DSH session records for tokens usage, number of sessions, number of messages, activity levels, most frequently used models, and daily token consumption trends. Below is an introduction to a DSH Web UI plugin: dsh-usage-lens. After installation, it adds a “Usage Statistics” page to the settings panel to visually display this local usage data.

What is it

dsh-usage-lens is a usage statistics panel for the DeepSeek Harness (DSH) Web UI maintained by yokesky.

Its corresponding npm package name is @yokesky/dsh-usage-lens, and the repository address is:

https://github.com/yokesky/dsh-usage-lens

The license provided in the documentation is:

MIT © 2026 yokesky

This documentation does not provide the number of stars, directory page URL, or complete dsh client configuration, so this article will not expand on these points.

Core Features

After installation, the DSH settings panel will add a “Usage Statistics” page. Verified features include:

  • Overview cards: tokens usage, number of sessions, number of messages, active days, current streak, most frequently used model.
  • Activity heatmap: A GitHub-style 280-day activity heatmap.
  • Daily Token Trends: View token consumption by day, with the ability to switch between “Model / Provider” perspectives.
  • Model Usage Dual-Doughnut Chart: Supports three viewing modes: “Aggregate / Provider / Model”.
  • Panel automatically follows DSH’s light / dark theme.

Installation and Enablement

Method 1: Installation via npm package

First, install or confirm you have dsh CLI, then execute the plugin installation command.

  1. Install dsh CLI. If already installed, you can skip this step:
npm install -g @deepseek-ai/dsh   # Install dsh CLI first, then you can execute dsh commands
  1. Add dsh-usage-lens to the Web plugin profile:
dsh plugin --profile web add @yokesky/dsh-usage-lens
  1. Restart the web service, open the settings panel, and you will see “Usage Statistics”.

Method 2: Installation via Source Code

The source code method is suitable for scenarios requiring local code modification and rebuilding before enabling. The engines declaration provided in the documentation is:

node >=24

Please confirm that your local Node.js version meets the requirements first.

  1. Clone the repository and enter the directory:
git clone https://github.com/yokesky/dsh-usage-lens.git
cd dsh-usage-lens
  1. Install dependencies and build:
pnpm install
pnpm build
  1. Use the link: method to point to the local source code installation:
dsh plugin --profile web add link:<absolute path of this repository>

The link: method here points to the local source code. After modifying the code, simply re-run pnpm build and restart the web service for changes to take effect; no reinstall is required.

Typical Usage

After installation, first restart the web service, then open the DSH settings panel and go to “Usage Statistics”.

Below are some common viewing paths:

  1. View the overview cards to confirm tokens usage, number of sessions, number of messages, active days, current streak, and most frequently used model.
  2. Open the Daily Token Trends to view token consumption by day and switch between “Model / Provider” perspectives.
  3. Open the Model Usage Dual-Doughnut Chart and switch between the three viewing modes: “Aggregate / Provider / Model”.
  4. If installed via source code, modify the code, execute pnpm build, and then restart the web service.

Applicable Scenarios and Notes

Suitable for the following developers:

  • Already using DSH Web UI.
  • Want to check local DSH session records for tokens, number of sessions, number of messages, and activity levels.
  • Want to view token consumption trends by day.
  • Want to view usage distribution at the model or provider level.
  • Want to modify the plugin’s display logic via local source code.

Notes when using:

  • All data comes from your local DSH session records and is processed locally; it is not uploaded anywhere.
  • The panel automatically follows DSH’s light / dark theme.
  • The plugin runs with the permissions of the current dsh process; ensure you check the source code and license before installing.
  • The DSH Community Directory is an independent site with no official affiliation with DeepSeek or High-Flyer; do not interpret it as an official app store.

Links

  • GitHub repository:
https://github.com/yokesky/dsh-usage-lens
  • Community Directory: This documentation does not provide a verifiable directory page URL, so the directory page link is not attached here.