Preface

When running agents in DSH’s web usage scenarios, the statistics bar at the bottom of the chat interface often only displays default fields: token, duration, throughput, etc., are shown, but to arrange their order yourself or to see estimated costs additionally, plugin intervention is required. dsh-bottom-bar is designed for this purpose: it takes over the statistics line at the very bottom of the chat interface, makes it configurable and customizable, and appends an estimated cost at the end.

DSH emphasizes “everything is a plugin.” The community directory is an independent site, with no official affiliation with DeepSeek or High-Flyer. Below, we introduce @kc0ed/dsh-bottom-bar by covering installation, functionality, usage, and considerations.

What Is This

@kc0ed/dsh-bottom-bar is a DSH plugin maintained by kc0ed, licensed under MIT. Its goal is to transform the statistics bar at the bottom of the DSH chat interface into a configurable, sortable, and composable state, while providing estimated costs and detailed views.

Core Features

Assembleable Bottom Statistics Bar

The plugin provides 8 statistics segments: turn/step, LLM duration, tool call duration, time to first token, throughput (tok/s), cache hit, input/output tokens, and estimated cost.

These segments support:

  • Toggle for each segment;
  • Drag-and-drop sorting;
  • Holding Ctrl to click-select and batch-select multiple segments;
  • Hovering over truncated rows to view the full line, with an option to always display it.

Clicking any segment will open a detail panel. The cost segment displays per-model unit prices, token buckets, amounts, subtotals, and totals; other segments show corresponding values.

Settings Page Preview and Price Table

The bottom bar area in the settings page includes a preview area and a price table.

The preview area allows you to view effects while modifying configurations. The price table includes built-in templates for vendors like DeepSeek V4/V3, Claude, OpenAI, Gemini, Kimi, and Tongyi, and also supports manual price entry. Configuration is hydrated via localStorage, so refreshing the webpage won’t revert to default values.

Cost Estimation and Ledger

The cost is not a bill but an estimate: calculated as session tokens × unit price, excluding official discounts or promotional pricing.

The ledger granularity is “channel@model.” For example, the same model using different channels is calculated separately. The ledger file is located at:

~/.dsh/cost-estimate.ledger.json

This ledger is append-only and never recalculated. During streaming output, the cost updates in real-time.

DeepSeek Peak/Valley Pricing

The plugin supports toggles for DeepSeek peak/valley pricing, peak/valley reminders, and timezone selection. Peak/valley reminders are for displaying peak/off-peak labels and do not affect cost calculation; the peak/valley pricing toggle controls whether to calculate based on peak/valley prices.

Current documentation states that peak/valley pricing currently applies to DeepSeek official channels and OpenCode. The README mentions “temporarily not applied” for other third-party gateways, which appears to be a typo. The specific scope should be confirmed via source code or actual behavior.

Installation and Enabling

Prerequisites

First, ensure that Node.js, pnpm, and the dsh command-line tool are available in your environment. pnpm is mandatory because dsh plugin is a pnpm forwarder; without pnpm, it will fail.

npm i -g pnpm
npm i -g @deepseek-ai/dsh

After installation, open a new terminal and verify:

pnpm -v
dsh --version

Installing the Plugin

Use the npm stable version command:

dsh plugin --profile web add @kc0ed/dsh-bottom-bar

If you prefer to track the GitHub repository directly, you can also use:

dsh plugin --profile web add github:kc0ed/dsh-bottom-bar

Direct GitHub installation may trigger pnpm’s git build approval. If you encounter pnpm failed with an allowBuilds prompt, edit the exact key from the error:

~/.dsh/profiles/web/pnpm-workspace.yaml

Add the corresponding entry and re-run the add command.

Updating and Uninstalling

Update:

dsh plugin --profile web update @kc0ed/dsh-bottom-bar

Uninstall:

dsh plugin --profile web remove @kc0ed/dsh-bottom-bar

Post-Installation Startup

After installation:

  1. Completely exit DSH and restart it.
  2. In the browser, press Ctrl+Shift+R to hard refresh.

Note: If you have already installed a static package, do not run the “dynamic plugin” version simultaneously. Two instances writing to the same ledger will cause conflicts.

Typical Usage

Below are reproducible operation paths from the documentation:

  1. Install and restart DSH, confirming that the bottom statistics bar has changed.
  2. Toggle individual statistics segments and drag to adjust their order in the bottom bar area of the settings page.
  3. Hold Ctrl to select multiple segments, then drag them in bulk.
  4. Click the cost segment to view per-model unit prices, token buckets, amounts, subtotals, and totals.
  5. If prices show as “—”, add a price in the settings page price table.
  6. If peak/valley information is needed, enable peak/valley reminders or peak/valley pricing, and confirm peak/off-peak labels based on timezone settings.

Use Cases and Considerations

This plugin is suitable for DSH web usage scenarios where you want to customize the order of the bottom statistics bar and view token throughput, cache hit rates, and estimated costs during chats.

Important considerations:

  • Requires Node.js and pnpm; dsh plugin depends on pnpm.
  • The plugin runs with the current DSH process permissions; review the source code, dependencies, and license before installation.
  • Costs are estimates, not official bills, and exclude discounts or promotional pricing.
  • The ledger is append-only and never recalculated, located at ~/.dsh/cost-estimate.ledger.json.
  • The scope of peak/valley pricing has documentation uncertainties; confirm whether it applies to your target channel before use.

Links

GitHub: https://github.com/kc0ed/dsh-bottom-bar

Directory page (documented source, not confirmed in this main text): https://www.skillhub.cn/plugins/kc0ed/dsh-bottom-bar