Plugin directory / Knowledge / dsh-client-ui-monitor
dsh-client-ui-monitor
Verified · install-tested on dsh Auran-Lu
What it does
Used to monitor the current session's quota consumption, estimated costs, and current API balance.
Works — verified, early-stage project
Used to monitor the current session's quota consumption, estimated costs, and current API balance. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
@auranlu/dsh-client-ui-monitor
A DeepSeek Harness Web plugin that pins a usage dashboard to the bottom-left of the sidebar.
It shows, live for the current session:
- Token usage — input (with cache read/write), output.
- Estimated cost — computed from DeepSeek's published pricing, displayed in CNY or USD.
- API balance — your DeepSeek account balance, queried via
GET https://api.deepseek.com/user/balance.
Features: Chinese/English toggle, currency selector (CNY/USD), manual balance refresh, auto-refresh every 30s.
Prerequisites
- DeepSeek Harness
webprofile. - A DeepSeek API key configured in Settings → Models (stored as the
DEEPSEEK_API_KEYcredential).
Install
Method 1 — GitHub
dsh plugin --profile web add github:Auran-Lu/dsh-client-ui-monitor
After installing, register the plugin and restart:
Edit ~/.dsh/profiles/web/cordis.patch.yml and add this entry to its top-level array:
- insert:
- id: ui-monitor
name: '@auranlu/dsh-client-ui-monitor'
Then restart the server (dsh web) and expand the left sidebar.
Method 2 — one-sentence install (paste to an LLM agent)
Copy the whole block below to a coding agent that has shell access to the machine:
Install the DeepSeek Harness client plugin from github.com/Auran-Lu/dsh-client-ui-monitor: run
dsh plugin --profile web add github:Auran-Lu/dsh-client-ui-monitor, then append this entry to the top-level array of~/.dsh/profiles/web/cordis.patch.yml:- insert: - id: ui-monitor name: '@auranlu/dsh-client-ui-monitor'Finally restart the
dsh webserver and confirm the dashboard appears at the bottom of the left sidebar.
Configuration
Edit lib/client.js before installing / publishing:
| Constant | Default | Meaning |
|---|---|---|
PRICING.inputPerM |
0.27 |
USD per 1M prompt tokens (cache miss) |
PRICING.cacheReadPerM |
0.07 |
USD per 1M prompt tokens (cache hit) |
PRICING.cacheWritePerM |
0.07 |
USD per 1M prompt tokens (cache write) |
PRICING.outputPerM |
1.10 |
USD per 1M completion tokens |
USD_TO_CNY |
7.2 |
USD → CNY exchange rate |
How it works
- Client half (
lib/client.js) registers a component into thesidebar.footer.actionslot and reads the current session'stokenUsageprojection. - Host half (
lib/index.js) registersGET /api/deepseek-balance, proxying DeepSeek's balance API with the stored key.
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalog Then say "install dsh-client-ui-monitor for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:Auran-Lu/dsh-client-ui-monitor Headless (CLI) profile:
dsh plugin --profile headless add github:Auran-Lu/dsh-client-ui-monitor Test report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Give the agent a memory, a knowledge base, or a retrieval layer so it stops forgetting context between sessions.
Who it's for
Users running long projects who want the agent to remember decisions, docs, and preferences without re-explaining.
For developers — extending it
The memory/retrieval backend is the seam — plug a new store, tune what gets distilled, or add citation and audit trails.