deepseekplugins

DeepSeek Harness plugin

dsh-session-cost-ljcscp

DeepSeek account balance and session-cost readout for the DeepSeek Harness Web GUI: official balance endpoint, auto-fetched official pricing with peak/off-peak hours, per-model costing (flash/pro).

Memory
Jump to install

Source facts

Repository
ljcscp/dsh-session-cost
Latest update
Aug 14, 2026
Category
Memory
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/ljcscp/dsh-session-cost
Plugin: dsh-session-cost-ljcscp
Author: ljcscp

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-session-cost

DeepSeek account balance and session-cost readout for the DeepSeek Harness (DSH) Web GUI.

  • Account balance — queries the official GET /user/balance endpoint (the API key stays on the host, resolved per refresh through the DSH credentials seam)
  • Session spend — token usage × official DeepSeek prices, auto-fetched from the official pricing page every 6h, so price changes never require a plugin update
  • Peak/off-peak pricing — the 2026-08-17 rollout is applied automatically: peak hours 09:00-12:00 / 14:00-18:00 (Beijing), off-peak at half price
  • Per-model costing — the session's actual model (deepseek-v4-flash / deepseek-v4-pro) is read from the newest assistant message's provenance and priced at its own bucket

The composer dock shows one readout under the shipped stats line:

本会话 ¥0.90 · 余额 ¥30.82

Hover for the breakdown (input / cache read / output, model, pricing source) and the balance split (granted + topped up).

Requirements

  • DeepSeek Harness 0.1.0-rc.5 or newer (web profile)
  • A DeepSeek API key stored through the DSH credentials seam (DEEPSEEK_API_KEY — the web Models page writes it)

Installation

From a git URL (no npm account needed):

dsh plugin --profile web add https://github.com/ljcscp/dsh-session-cost

From npm:

dsh plugin --profile web add @ljcscp/dsh-session-cost

From a local checkout (development):

git clone https://github.com/ljcscp/dsh-session-cost.git
dsh plugin --profile web add link:$(pwd)/dsh-session-cost

Restart dsh web, then refresh the page. The readout appears in the composer dock below the conversation stats line.

Configuration

Zero-config by default. Optional composition settings:

- insert:
    - id: session-cost
      name: '@ljcscp/dsh-session-cost'
      config:
        refreshMs: 60000          # balance cache lifetime (ms)
        pricingRefreshHours: 6    # official-pricing page refresh cadence
        apiKeyEnv: DEEPSEEK_API_KEY
        baseURL: https://api.deepseek.com
KeyTypeDefaultMeaning
refreshMsnumber60000Balance cache lifetime in ms (failures retry after 10s)
pricingRefreshHoursnumber6Hours between official-pricing page refreshes
apiKeyEnvstringDEEPSEEK_API_KEYCredential ref storing the DeepSeek API key
baseURLstringhttps://api.deepseek.comEndpoint base; /user/balance is appended
trustedHostsstring[][]Non-loopback authorities served beyond the trust fence

How it works

  • Host half (src/index.ts): registers one trusted webserver route /session-cost that serves the balance snapshot (cached refreshMs) and the effective pricing snapshot (official page parsed per pricingRefreshHours, peak/off-peak band applied by the current Beijing hour once the rollout is live). The API key never leaves the host.
  • Browser half (src/client/): a conversation.composer.dock entry that reads the tokenUsage projection, detects the session's model from the newest assistant provenance, applies the effective bucket, and renders the readout — refreshed every minute.

Cost formula (matches the official billing rule 扣减费用 = token 消耗量 × 模型单价):

spend = uncachedInput × inputPerMillion + cacheRead × cacheReadPerMillion + output × outputPerMillion   (per 1M tokens)

Cache writes bill at the uncached input rate (DeepSeek reports only hit/miss buckets). The readout is an estimate at official rates; the official bill on platform.deepseek.com/usage lags by a few minutes of settlement.

License

MIT. The browser-bundle build preset (shared/) is adapted from dsh-balance-meter (BSD-3-Clause), which adapted it from deepseek-harness (MIT).

Back to searchOpen GitHub repository

More related plugins

View category