In the plugin ecosystem of DeepSeek Harness (DSH), monitoring the cost of API calls is an important part of fine-grained management. In particular, when facing different model pricing, differences between cache hits and misses, and rate changes between peak/off-peak periods, manual accounting often struggles to be real-time and accurate. az790871109/dsh-cost-tracker aims to address this need. As a Profile plugin for DSH, it provides real-time cost statistics and backend balance management.

Features

This plugin achieves real-time billing by listening to the llm/stream event and has the following capabilities:

  1. Real-time billing and accurate accumulation: It listens to model call streams and immediately accumulates token counts.
  2. Precise pricing model: It supports per-model unit pricing, distinguishes cached from non-cached tokens, and supports switching between peak and off-peak tiers.
  3. RMB-only display: Default exchange rate is 7.2; the panel allows manual adjustment of the exchange rate.
  4. Backend balance management: Provides a recharge entry point and displays balance, current-period consumption, and remaining quota in real time.
  5. Project and conversation summaries: The top of the panel shows the total cost for the project containing the current conversation, with per-conversation details listed below.
  6. Interactive floating panel: The panel is draggable and collapsible, and its colors follow the DSH theme.
  7. Model-queryable: Registers the deepseek_cost tool so the model can be asked directly to view costs.
  8. Cross-process persistence: Statistics state is written to a local file and continues to accumulate after restarts.
  9. Zero-intrusion automatic startup: As a profile plugin, it is loaded when DSH starts and requires no extra activation.

Installation and Activation

The installation process includes copying files and modifying the configuration. The steps are as follows:

  1. Create the directory and copy the plugin files:
    mkdir -p "$DSH_HOME/profiles/web/node_modules"
    cp -R . "$DSH_HOME/profiles/web/node_modules/dsh-cost-tracker"
  1. Modify the configuration file to load the plugin. Append the following content to the end of $DSH_HOME/profiles/web/cordis.patch.yml:
    - insert:
        - id: cost-tracker
          name: dsh-cost-tracker
  1. Restart the DSH Web service:
    pkill -f "dsh/lib/bin.js web"
    dsh web

After restarting, open the page; the cost floating panel will appear in the bottom-right corner.

Usage

After installation, you can operate directly via the panel or conversation:

  1. View costs: Ask the model directly in the conversation “How much money have I spent?”, or check the main reading on the panel.
  2. Recharge management: Enter an amount in the panel input box and click “Recharge”.
  3. Switch tier: Click the panel button to switch the billing tier (auto/off-peak/peak).
  4. Modify exchange rate: Adjust the value in the “Exchange rate” input box at the bottom of the panel.
  5. Reset statistics: Click the “Reset” button on the panel to reset all data.
  6. Panel interaction: Hold the title bar to drag the panel; click the title bar to collapse or expand it.

Notes

Before using it, note the following limitations and dependencies:

  1. Data nature: This is a local estimate, not an official bill, and may differ from the official billing records.
  2. Statistical scope: It only counts calls after the plugin is loaded; historical messages are not included.
  3. Price synchronization: The price table is hard-coded in BASE_PRICES in lib/index.js; after official price adjustments, the source code must be updated manually.
  4. State file: Delete $DSH_HOME/storages/cost-tracker-state. to reset.
  5. Effective method: After modifying cordis.patch.yml or the source code, you must restart dsh web for changes to take effect.
  6. React dependency: The client side must use factory: function (require) + require("react") to obtain React; a global React cannot be used, otherwise rendering will error.
  7. Dependency environment: The host side depends on tools and webServer; the client side depends on slots (from @deepseek-ai/dsh-client-runtime).

Ecosystem Information

  • Maintainer: az790871109
  • License: MIT
  • Repository: https://github.com/az790871109/dsh-cost-tracker