dsh-sonar
English | 中文
A compact, draggable deep-sea usage dashboard for the DeepSeek Harness Web UI.
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
