Preface

The native bottom status bar of DSH places all information on a single line. When the window is narrow, some content gets truncated. For users who want to continuously view model information, context pressure, tokens, generation speed, and costs alongside the session, a fixed single line is insufficient.

Introducing dsh-status-bar. It is a DSH client plugin that replaces the built-in stats line, providing a configurable status bar.

What It Is

dsh-status-bar is maintained by Starlight-bananice, licensed under MIT, and categorized as a client plugin.

Within DSH’s plugin ecosystem, it addresses the issue of bottom bar information display: 17 information segments can be toggled on/off and reordered, with support for line wrapping, real-time TPS, and cost estimation.

Core Features

  • 17 information segments can be toggled and rearranged, covering status, model, context pressure, tokens, TPS, cost, tasks/queues, and more.
  • Real-time TPS: Updates chunk by chunk based on assistant/chunk events.
  • Cost Estimation: Supports user-maintained model price books, peak/off-peak pricing, and CNY/USD currency selection.
  • Multi-line wrapping prevents the status bar from being truncated.
  • Zero-configuration defaults: 13 information segments are enabled by default.
  • Replaces the built-in stats line; automatically restores the built-in status bar upon uninstallation.
  • UI strings in English/Chinese.
  • Usage & Cost dialog: Cost trend charts, paginated step-by-step usage history, and total cost display.
  • Uses a different projection key from @linxin666/dsh-live-stats, allowing for coexistence.

Regarding coexistence, it has been verified that both use different projection keys. dsh-status-bar uses statusBarLiveTokenUsage, while @linxin666/dsh-live-stats uses liveTokenUsage.

Installation & Activation

First, confirm the environment. It has been verified that DSH compatible version is 0.1.1-rc.2 (mainline master); earlier RCs may work but are unverified. Runtime requires Node ≥ 22 (host) and a modern browser (client), with no external services.

First, install via npm:

dsh plugin --profile web add @bananiceee/dsh-status-bar

Then start or restart DSH Web. The default status bar will appear without any configuration.

If pnpm 11 rejects installation on the same day due to a newly published package’s 24h minimumReleaseAge, you can use the installation command with an appended parameter:

dsh plugin --profile web add @bananiceee/dsh-status-bar --config.minimumReleaseAge=0

After completing the above steps, the status bar should replace the built-in stats line. If you want to temporarily hide it, you can navigate to:

Settings → Plugins → Status Bar

Or use the gear menu to hide it immediately.

Typical Usage

  1. After installation, restart DSH Web:
dsh plugin --profile web add @bananiceee/dsh-status-bar

  1. Maintain per-model prices and peak/off-peak time periods in the settings page.

  2. View cost trends, step-by-step usage history, and total cost via the Usage & Cost dialog.

  3. Upgrade npm installation:

dsh plugin --profile web update @bananiceee/dsh-status-bar
  1. Uninstall:
dsh plugin --profile web remove @bananiceee/dsh-status-bar

After uninstallation, the built-in status bar will be automatically restored. The dsh.statusBar.v1 in the browser localStorage and host usage files will not be automatically deleted; manual deletion is required if cleanup is needed.

Use Cases & Notes

It is suitable for scenarios where you need to directly view session operation information within the DSH interface: status, model, context pressure, tokens, real-time TPS, cost estimation, tasks, and queues. It does not depend on external services.

Check the source code and license before use. The plugin runs with the current dsh process permissions; ensure you trust the maintainer, repository, and dependencies before installation.

Notes related to the installation environment:

  • pnpm may not read git proxy configurations when installing from GitHub; if network failure occurs, you can set HTTPS_PROXY / HTTP_PROXY.
  • Since v0.1.5, the repository includes build artifacts, so git installation does not require building; versions ≤v0.1.4 require manual building.
  • When enabled simultaneously with @linxin666/dsh-live-stats, both use different projection keys and can coexist independently.

Links

  • GitHub: https://github.com/Starlight-bananice/dsh-status-bar
  • Community directory page (independent site, not the official app store; clue provided, not independently verified in the captured materials): https://www.skillhub.cn/plugins/Starlight-bananice/dsh-status-bar