Introduction

The extension of DeepSeek Harness (DSH) primarily relies on plugins, with the community directory operating as an independent site, having no official affiliation with DeepSeek or High-Flyer.

When using DSH, intelligent agent developers typically encounter several practical issues: the scale of this month’s consumption, estimated costs, differences before and after the price adjustment on August 17th, savings from caching, and which model or session consumes more.

dsh-whale-meter is a community plugin designed to consolidate this information into a unified usage and cost panel.

What is This

dsh-whale-meter is positioned as a DSH usage and cost panel, maintained by Shiye-10Pages under the MIT license.

It supports local computation with zero reporting—all data remains on the local machine. Apart from querying the balance after configuring an API key, it does not make any network requests.

Core Features

Usage and Cost Estimation

  • Monthly consumption tier (five levels) and estimated percentile
  • Estimated costs for today, yesterday, this month, and cumulative totals
  • Daily budget line reminders

Pricing and Price Adjustment Comparison

  • Comparison before and after the August 17th DeepSeek price increase
  • Peak and off-peak two-tier pricing
  • Separate pricing across adjustment dates based on effective price periods
  • Cache hit rate and savings display

Multi-Model and Billing

  • Pricing for 46 models across DeepSeek, Anthropic, OpenAI, Google, Zhipu GLM, and Moonshot Kimi
  • Tiered pricing for domestic providers
  • Bills by model and session
  • Backfill for historical sessions before installation
  • 14-day trend analysis
  • Account balance inquiry after configuring an API key
  • One-click generation of bill-sharing cards

Installation and Activation

  1. Run the installation command. The <your_profile> placeholder in the command should be replaced with your actual profile name.
dsh plugin --profile <your_profile> add dsh-whale-meter
  1. After installation, restart dsh web. A cost badge will appear at the top of the session page.

If installing from source:

dsh plugin --profile <your_profile> add github:Shiye-10Pages/dsh-whale-meter

When installing from source for the first time, you need to authorize the build in the profile’s pnpm-workspace.yaml. It is recommended to pin the commit.

Configuration

Zero configuration is required for use.

When adjustments are needed, you can override relevant configuration items for whale-meter in the profile’s cordis.patch.yml:

  • currency
  • budgetDaily
  • apiKey
  • usdToCny
  • backfill
  • pricingUpdate
  • prices

The apiKey is used for balance inquiries and defaults to reading the DEEPSEEK_API_KEY environment variable.

Pricing uses an internal table by default; a remote table is optional. If fetching fails, it falls back to the internal table. Unknown models are not priced but marked as “Unpriced.”

Typical Usage

View Summary

In the TUI scenario, you can directly request the following endpoint:

curl http://127.0.0.1:3080/whale-meter/api/summary

Update Pricing Data

When updating pricing, first modify src/pricing.data.ts, then run:

npm run gen:pricing

After completion, submit a PR.

Use Cases and Notes

dsh-whale-meter is suitable for developers who need to view DSH usage, estimate costs, compare the impact of price adjustments, and break down bills by model or session.

Before use, please note:

  • The plugin runs with the permissions of the current dsh process; check the source code and license before installation.
  • The license is MIT.
  • DSH is in developer preview; the plugin will adapt as the interface evolves.
  • Balance inquiries require configuring an API key; no other network requests are made.

Links

  • Directory Page: https://www.skillhub.cn/plugins/Shiye-10Pages/dsh-whale-meter
  • GitHub: https://github.com/Shiye-10Pages/dsh-whale-meter