Introduction

Under DSH’s “everything is a plugin” extension philosophy, the context window, token details, and account balance during a session are often scattered across different locations. dsh-sonar targets developers using the DeepSeek Harness web profile, providing a drag-and-drop session dashboard that consolidates context usage, accounted-token composition, and DeepSeek balance. It is maintained by Howe829 and is licensed under the MIT license.

What is it

dsh-sonar is a read-only UI plugin used for the DeepSeek Harness web client scenario. It does not add tools, prompts, commands, persistent session events, or model visible context, nor does it alter request envelope or KV cache behavior.

Core Features

The following outlines the verified UI and data capabilities of dsh-sonar:

  • Provides a floating Fish icon launcher that does not compress the conversation area; clicking opens the session dashboard, which can be dragged to any position in the viewport.
  • The dashboard automatically selects a suitable direction; press Escape or click the Fish icon again to collapse.
  • Displays context window gauges in green, amber, and red.
  • Displays accounted-token donut charts for uncached input, cached read, cached write, output, and reasoning; reasoning items are only displayed when Harness exposes this information.
  • Heuristically displays system prompt, tool schema, and session composition.
  • Displays turns, steps, model time, tool time, cache hit rate, and cumulative tokens.
  • Fetches and displays the DeepSeek total_balance precise balance upon the completion of each turn or manual refresh.

Installation and Usage

It is recommended to pin the release tag v0.1.0 for repeatable installation:

dsh plugin --profile web add github:Howe829/dsh-sonar#v0.1.0
dsh --profile web

To uninstall:

dsh plugin --profile web remove dsh-sonar

The plugin defaults to hosting DEEPSEEK_API_KEY credentials and using the public DeepSeek API. The configuration line is as follows:

- id: dsh-sonar
  name: dsh-sonar
  config:
    apiKeyEnv: DEEPSEEK_API_KEY
    baseURL: https://api.deepseek.com

Subsequent profile or home patch configurations can replace this line. Note that Harness patch configurations are replaced line-by-line; if you modify the configuration, you need to rewrite all fields you wish to retain.

Typical Usage

The typical flow is to install the fixed version first, then start the web profile.

  1. Install the fixed version:
dsh plugin --profile web add github:Howe829/dsh-sonar#v0.1.0
  1. Run the web profile:
dsh --profile web
  1. Use the Fish icon in the Harness web session to open the dashboard and view the context gauge, token donut chart, session composition, and total_balance.
  2. Remove when no longer needed:
dsh plugin --profile web remove dsh-sonar

For development-side verification, you can execute:

pnpm install; pnpm run verify; pnpm pack --pack-destination .artifacts

Applicable Scenarios and Notes

Suitable for developers currently using the public DeepSeek Harness 0.1.0-rc.6 package family and wishing to view session tokens and balance in the web profile. The current stable version is v0.1.0; DeepSeek Harness is still in developer preview, so subsequent Harness versions may require compatibility updates.

Regarding Security and Model Impact:

  • API keys remain on the Host.
  • The browser only calls same-origin dsh-sonar routes and returns only { totalBalance }.
  • Cross-site and non-IP/localhost Host requests will be rejected.
  • Responses are never cached.
  • The plugin is a read-only UI and does not add tools, prompts, commands, persistent session events, or model visible context.
  • The plugin does not modify request envelope or KV cache behavior.

It runs with the current dsh process permissions; it is recommended to check the source code, dependencies, and MIT license before installation to ensure they meet internal usage requirements.

Conclusion

The value of dsh-sonar lies in placing the context, token details, and balance from a DeepSeek Harness session into a drag-and-drop read-only panel. The verified project repository is: