Preface

When using DeepSeek Harness (DSH) for Web GUI agents, usage, context, and cost are often scattered across session logs and platform bills. dsh-board is a DSH plugin that brings DeepSeek backend-style usage statistics to the bottom-left corner of the Web GUI, allowing you to view token trends, context occupancy, and estimated costs.

What is This

dsh-board is maintained by dfkai under the MIT license. It adds a sidebar usage and cost panel to DSH: providing billing estimates, 1M context information, visual charts, and “Word Rank” levels and achievement displays in the bottom-left corner of the Web GUI.

Please note that the panel displays estimated values, not billing documents. Actual charges are based on the DeepSeek platform bills.

Core Features

Billing Estimates

  • Uses official pricing.
  • Automatically switches prices based on Beijing time peak/off-peak hours starting from 2026-08-17: Peak hours are 09:00–12:00 and 14:00–18:00; off-peak hours are charged at half the peak price.
  • Inference tokens are counted at the output price.

1M Context

  • Shows context occupancy percentage.
  • Displays remaining budget.
  • Uses stacked bars to show the composition of system, tools, and messages.
  • Shows sub-agent time consumption.

Visualization

  • Input/output trends per round.
  • Cumulative output curve.
  • 12-week daily heatmap.
  • Per-model statistics.
  • Global session leaderboard.

“Word Rank” Levels

A ten-tier progression, from “Unawakened Word Sprout” to “Ten Thousand Word King” to “Trillion Word God.” Displayed like a membership card, including a progress bar, unlock ETA, and benefits for each level.

Achievements

  • Consecutive check-in days.
  • 9 data-driven badges.

Visuals and Badges

  • Geist restrained style.
  • Light/dark theme adaptation.
  • Bilingual Chinese and English.
  • Zero decorative animations.
  • Horizontal badges default to menu-width tiles, showing rank label, ¥ spent, total tokens, today, and week; clicking expands the badge to the top of the panel, clicking again collapses it.

Installation and Enabling

The installation command is as follows:

dsh plugin --profile <profile> add dsh-board@0.2.0

After installation, restart the profile or start a new DSH process:

dsh --profile <profile>

You can check if the plugin layer is present using dump-config:

dsh --profile <profile> --dump-config

The output should include:

# == dsh-board layer

Disabling and Conditional Toggles

If you only want to temporarily disable the panel, you can add the following to your profile’s cordis.patch.yml:

- id: board
  disabled: true

disabled supports !!js expressions and can also be toggled conditionally.

Development Sync

If you modify the plugin code locally, you can build and sync using the following steps:

pnpm install
pnpm build
pnpm sync -- <profile directory>

First, install dependencies, then build the artifacts, and finally sync them to the specified profile directory.

Use Cases and Notes

It is suitable for developers using the DSH Web GUI to view local session usage, context occupancy, and estimated costs. It is not a billing system or a billing document.

Before use, note:

  • The plugin runs with the permissions of the current dsh process; check the source code and license before installation.
  • Inference tokens are counted at the output price, which requires a fix from the harness’s token-meter; on older harnesses, cumulative totals and costs will undercount the inference portion.
  • All data comes from public interfaces of the local DSH; the plugin does not make any third-party network requests.
  • The only persistence is the panel’s collapsed state in the browser’s localStorage.
  • The host only registers read-only session projections (dominantModel, sessionCost) and does not write any data.
  • The license is MIT.

Conclusion

The value of dsh-board is clear: it places token, context, and cost estimates from DSH sessions into a sidebar panel for quick viewing in the Web GUI. The repository is located at:

https://github.com/dfkai/dsh-board