Auran-Lu/dsh-client-ui-monitor
30Last commit Aug 14, 2026
dsh-client-ui-monitor DSH plugin
This plugin adds a real-time dashboard to the left sidebar of DeepSeek Harness Web, showing token usage, estimated cost, and API balance for the current session. It supports Chinese/English toggle, currency selection (CNY/USD), manual refresh, and auto-refresh every 30 seconds.
How to install the dsh-client-ui-monitor DSH plugin
dsh plugin --profile web add github:Auran-Lu/dsh-client-ui-monitorCopying does not run this command. Review the repository and version before installing the dsh-client-ui-monitor DSH plugin.
dsh-client-ui-monitor DSH plugin data source
dsh-client-ui-monitor DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-client-ui-monitor DSH plugin can do
- Displays live token usage (input, cache read/write, output) for the current session.
- Estimates cost based on published DeepSeek pricing and displays in CNY or USD.
- Queries and displays DeepSeek API balance via GET /api/deepseek-balance.
- Supports language toggle between Chinese and English.
- Supports currency toggle between CNY and USD.
- Auto-refreshes every 30 seconds; manual refresh button available.
Where the dsh-client-ui-monitor DSH plugin fits
- Monitor token consumption in real-time during a conversation session.
- Track estimated costs to control spending on DeepSeek API usage.
- Check API account balance without leaving the DeepSeek Harness interface.
- Switch between Chinese and English interface for multilingual teams.
- Compare costs in two currencies (CNY and USD) for budget planning.
Who the dsh-client-ui-monitor DSH plugin is for
- Developers using DeepSeek Harness Web profile.
- Users who need to track API usage and costs in real-time.
- Project managers monitoring token budgets across team members.
dsh-client-ui-monitor DSH plugin limitations
- Only works with the 'web' profile of DeepSeek Harness.
- Requires a DeepSeek API key configured in Settings → Models.
- Pricing constants must be manually edited in lib/client.js before installation.
- Exchange rate (USD to CNY) is a fixed constant set to 7.2 by default, not live.
- Requires restarting the dsh web server after installation and configuration.
dsh-client-ui-monitor DSH plugin: from the repository README
Quoted from the Auran-Lu/dsh-client-ui-monitor README, the upstream source of the dsh-client-ui-monitor DSH plugin. Copyright remains with the original authors.
A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web plugin that pins a usage dashboard to the bottom-left of the sidebar. [简体中文](README.zh.md) 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 `web` profile. - A DeepSeek API key configured in **Settings → Models** (stored as the `DEEPSEEK_API_KEY` credential). ## Install ### Method 1 — GitHub ```bash 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: ```yaml - 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
Read the full READMEThe repository declares no license. Check with the authors before using it.
dsh-client-ui-monitor DSH plugin questions
How do I install the DSH Client UI Monitor plugin?
Run `dsh plugin --profile web add github:Auran-Lu/dsh-client-ui-monitor` in your terminal. Then edit `~/.dsh/profiles/web/cordis.patch.yml` and add the plugin entry to the top-level array. Finally restart the `dsh web` server and expand the left sidebar to see the dashboard.
Why doesn't the dashboard show after installation?
Make sure you have completed the configuration step: add the plugin entry to `cordis.patch.yml` as described in the README. Then restart the `dsh web` server. Also ensure that your DeepSeek API key is set in Settings → Models. If the sidebar is collapsed, expand it to see the dashboard at the bottom.
How do I change the currency from USD to CNY?
After installation, you can toggle the currency by clicking the currency selector on the dashboard. The plugin supports both USD and CNY. The default exchange rate is 7.2, which you can modify by editing the `USD_TO_CNY` constant in `lib/client.js` before installing.
Can I change the auto-refresh interval?
The auto-refresh interval is fixed at 30 seconds in the current version. If you need a different interval, you can modify the source code in `lib/client.js` before installation. The plugin also provides a manual refresh button for immediate updates.
Does this plugin work with DeepSeek Harness's desktop or CLI mode?
No, this plugin is designed exclusively for the 'web' profile of DeepSeek Harness. It uses the sidebar component slot which is only available in the web interface. If you are using a different profile, the plugin will not be active.