deepseekplugins

DeepSeek Harness plugin

dsh-sonar

A draggable deep-sea token and context dashboard for DeepSeek Harness

Development & Runtime
Jump to install

Source facts

Repository
Howe829/dsh-sonar
Latest update
Aug 14, 2026
Category
Development & Runtime
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Howe829/dsh-sonar
Plugin: dsh-sonar
Author: Howe829

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-sonar

English | 中文

A compact, draggable deep-sea usage dashboard for the DeepSeek Harness Web UI.

![dsh-sonar dashboard in DeepSeek Harness](docs/assets/dsh-sonar-dashboard.png)

dsh-sonar adds a Fish-logo floating launcher without narrowing the conversation. Click the Fish to open a complete session dashboard; drag it anywhere in the viewport. The panel automatically chooses a direction where it fits, and Escape or another Fish click collapses it. While the model is answering, lightweight bubbles rise around the launcher.

The dashboard includes:

  • a green / amber / red context-window gauge;
  • an accounted-token donut for uncached input, cache read/write, output, and reasoning when the installed Harness exposes it;
  • heuristic system prompt, tool schema, and conversation composition;
  • turn, step, model time, tool time, cache hit rate, and cumulative tokens;
  • exact DeepSeek total_balance, refreshed after each completed turn or manually.

The API key stays on the Host. The browser calls a same-origin dsh-sonar route that returns only { totalBalance }; cross-site and non-IP/localhost Host requests are rejected, and responses are never cached.

Install from GitHub

The repository commits its built lib/ artifacts, so a Git install does not need to execute a build script:

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

Pin a release tag for repeatable installations. Remove it with:

dsh plugin --profile web remove dsh-sonar

Configuration

The bundle inserts one dsh-sonar row. Defaults use the managed DEEPSEEK_API_KEY credential and the public DeepSeek API:

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

A later profile or home patch can replace this row. Harness patch configuration is row-replacing, so restate every field you want to keep.

Development

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

The current stable dsh-sonar release is v0.1.0. It is tested against the public DeepSeek Harness 0.1.0-rc.6 package family. DeepSeek Harness itself remains a developer preview, so future Harness releases may require compatibility updates.

Privacy and model impact

This is a read-only UI plugin. It adds no tools, prompts, commands, durable session events, or model-visible context. It does not alter the request envelope or KV cache behavior.

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category