Lzh3070/dsh-session-cost

English | 中文

dsh-session-cost

A DeepSeek Harness (dsh) web plugin that shows the current session's DeepSeek API cost as a small chip beside the composer input.

Features

• Live session cost — a chip in the conversation.input.right slot (left of the model selector) shows the current session's DeepSeek API spend (¥), refreshed every 5 seconds.
• Strict model gate — the chip only appears when the session's current model is DeepSeek; other models (MiniMax, Kimi, …) are never priced and never enter the statistics.
• Hover popover — a project-styled card with:
  • a session cost breakdown table: input (cache miss) / cache hit / output × tokens × effective rate = amount;
  • today's DSH usage: DeepSeek spend across local DSH sessions for today (Beijing time);
  • account balance: read from the DSH credential DEEPSEEK_API_KEY via the official user/balance endpoint.
• Official pricing engine — every assistant/message event is priced by its own timestamp against the official DeepSeek pricing timeline, including the 2026-08-17 peak/off-peak policy (Beijing 09:00–12:00 / 14:00–18:00 peak, half price otherwise), and covering history from before this plugin was installed.
• Performance friendly — session log replays are cached by log revision (a 5-second poll costs one stat, not a re-decompress); today/balance refresh on their own 60-second cadence.

Install

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

⚠️ Note: this plugin's npm package name is scoped: @phynez_1103/dsh-session-cost. The unscoped dsh-session-cost package on npm (ChengChe106/dsh-session-cost) is a different, same-named plugin, unrelated to this repo — dsh plugin add dsh-session-cost installs that one, not this one.

Or install straight from the GitHub repo:

dsh plugin --profile web add github:Lzh3070/dsh-session-cost

Or from the Gitee mirror (faster in mainland China):

dsh plugin --profile web add https://gitee.com/lzh10602042_gitee/dsh-session-cost/repository/archive/master.zip

Restart the dsh web service and hard-refresh the browser (Ctrl+Shift+R).

First use: configure DEEPSEEK_API_KEY in Settings → Models (used for the balance and today's total; without it the balance shows --, session cost still works).

Screenshot

The chip (¥0.12) beside the composer input, with the hover popover:

Popover contents example:

当前会话花费 ¥6.55
  项目        数量      单价        金额
  输入(未命中) 3.5M     ¥1.000/M   ¥3.49
  缓存命中    111.8M    ¥0.020/M   ¥2.24
  输出      410.5K     ¥2.00/M    ¥0.821
──────────────────────────────
  今日(DSH)          ¥0.356
  账户余额          ¥197.66

Pricing

Built-in official DeepSeek policy timeline (CNY per 1M tokens):

The table lives in OFFICIAL_PRICING_POLICIES in lib/index.js; append entries to the since timeline when the official pricing changes.

Structure

cordis.patch.yml   inserts the plugin row into the host composition
dsh.plugin.json    plugin metadata (entry id + client platform)
lib/index.js       host entry: SessionCostRuntime (TypertRemoteService) +
                   official pricing engine + strict Typert manifest
lib/client.js      single-file client bundle (ModuleLoader handshake):
                   composer cost chip + hover popover (class component)
lib/invariant.js   invariants companion entry

Data flow

• Host sessionCost(sessionId): replays the persisted session log via sessionPersistence.readRaw, prices every message, cached by log revision.
• Host accountSummary(): replays all sessions for today's (Beijing) DeepSeek usage; reads DEEPSEEK_API_KEY from DSH credentials for the official user/balance call.
• Client: registered in the conversation.input.right slot, 5s session poll + 60s account cadence + hover popover.

License

MIT. The pricing engine is ported from dsh-deepseek-quota (MIT, itself ported from bpc-oss/dsh-web-billing, MIT).