dsh-deepseek-cost

A DeepSeek Harness (DSH) plugin that shows what the conversation has cost so far:
a cost pill beside the built-in step/time and token statistics, with the session
total and the current turn priced at DeepSeek's official peak/off-peak API rates,
plus one 花费 row in the built-in 本轮用量 panel of every completed turn.
Both of DeepSeek's own routes — the API key and the signed-in account — are
priced; every other route is counted as 0.

What it adds

One cost pill in the composer dock, inline beside the built-in step/time and
token pills. The leading ¥ is the currency mark for the whole pill, so the
amounts beside it stay bare — one symbol per pill — and every figure is shown at
two decimals:

[¥] 0.43 · 本轮 0.51                     every call billed
[¥] 0.00（0.98）· 本轮 0.00（0.49）     routes billed at 0

A route billed at 0 still spent tokens, so the collapsed pill shows what those
calls would have cost at official rates beside the billed figure, in
parentheses and one step dimmer (--dsw-alias-label-caption) — otherwise the
pill reads a flat 0.00 for a session that in fact ran elsewhere. Each scope
carries its own estimate, and the parentheses come from the dictionary, so the
English pill uses ASCII parentheses with a leading space while the Chinese one
uses full-width ones. The accessible name spells the estimate out
(会话花费 ¥ 0.00（预估 ~¥ 0.98）…) rather than leaving it to the punctuation.

Two decimals means an amount below half a cent shows as 0.00. The wire keeps
six decimals and the host prices exactly, so nothing is lost upstream; it takes a
very short turn with a warm cache to land below the display threshold at all.

Clicking it opens its own details dialog, shaped like the built-in step and token
dialogs: the same panel material, title, and rule, and the same shipped
useAnchoredPosition / useDismissOnOutsidePointer primitives to position and
dismiss it.

The material is the built-in one token for token, which matters more than it
looks: the menu surface (--dsw-specific-menu) is a translucent colour —
#303136f0 in the desktop dark theme — and it only reads as solid because the
built-in panels also apply backdrop-filter: var(--dsw-menu-backdrop-filter)
(blur(40px) saturate(150%), defined on body and so inherited by a panel
portaled to body). A panel that sets the surface without that filter shows the
transcript through it. The radius is the theme's --dsw-radius-lg rather than a
hardcoded value, for the same reason. client.test.mjs case 16 pins this.

The panel itself is the grid: the cost category, then one column per scope.
The two scope totals sit in the title bar, and because the grid starts at the
panel edge they land exactly over the columns they summarize.

¥  花费                     ¥ 0.43       ¥ 0.51
──────────────────────────────────────────────
会话         本轮
输入未缓存                  ¥ 0.01       ¥ 0.11
输入缓存                    ¥ 0.10       ¥ 0.02
输出                        ¥ 0.32       ¥ 0.38
──────────────────────────────────────────────
预估（按官方价）            ~¥ 0.17      ~¥ 0.02
──────────────────────────────────────────────
计费时段                                空闲时段
未计费调用            1 次 · 非 DeepSeek 官方，按 0 计

• The three cost categories are the prompt-side split (输入未缓存 / 输入缓存) plus
  输出, each priced per scope. The 会话 / 本轮 captions name the two value columns.
• The title bar carries one total per scope, so no totals row is repeated
  below and neither total is printed twice.
• 预估（按官方价） answers "what would the routes billed at 0 have cost at
  official rates?" — see Estimating the routes billed at 0.
  It reuses the two scope columns, is dimmed, and is tilde-marked so it is never
  read as part of the billed total. It appears only when some call was actually
  billed at 0.
• Items that belong to neither scope own a whole line in the full-width footer
  below the grid — that is how "spans both columns" is expressed here, and it
  also keeps the divider above them continuous (a spanning grid row would break
  its hairline on the column gaps).

Nothing built in is replaced. The pill is a normal occupant of the composer's dock
slot, and the dock lays its occupants out inline, so the pill simply sits beside
the built-in pills. If the projection is absent the occupant renders null and
nothing regresses.

The row in the built-in 本轮用量 panel

Opening a completed turn's built-in usage info shows the turn's tokens; this
plugin appends the turn's cost as the last row of that same list, so the money is
read where the tokens are:

本轮用量                     22,582.085 tok
──────────────────────────────────────────
提供方 / 模型   deepseek-official/deepseek-flash
缓存命中                            97.8%
未缓存输入                     487,432 tok
缓存读取                    22,070,784 tok
缓存写入                           0 tok
输出                            23,869 tok
花费                              ¥ 1.02

That panel is shipped UI with no slot of its own, so this is the one place the
plugin reads another package's DOM — deliberately, and through exactly two hooks:

• dl[data-turn-usage-details] — the attribute DSH puts on the turn-usage
  panel's own row list (the neighbouring session-stats and performance panels use
  data-session-stats-details, so this one is unambiguous). The row is appended
  only while that panel is open, and only after checking it is not already there.
• data-turn-tail — the turn number DSH stamps on a completed turn's footer,
  read from the clicked trigger's ancestors. A trigger click is the only way the
  panel opens, so a panel opened for an older turn shows that turn's cost, never
  the current turn's.

The append is idempotent, the observer watches only document.body's children
(where the panel is portaled), and the whole watcher is one effect on the occupant
that disconnects when the occupant unmounts. client.test.mjs asserts the
selector inventory of the whole bundle, so a third hook cannot be added quietly.

A turn whose calls were billed at 0 still gets the row, carrying the same
what-if as the dialog — 花费 ¥ 0.00（预估 ~¥ 0.98） — and a turn older than the
plugin's own ledger was never priced at all, so its panel is left untouched.

Estimating the routes billed at 0

Only DeepSeek's own routes are billed — deepseek-official (API key) and
deepseek-account (the signed-in account, the desktop's "DeepSeek 账号" mode).
Every other provider shows a real cost of 0, and the estimate says what those
same requests would have cost at official rates.

The estimate reaches the UI in three places, all of them gated on there being a
call that was billed at 0: the collapsed pill's parenthesized figure per scope,
the 预估（按官方价） row and its column totals in the details dialog, and the
（预估 …） suffix on the 花费 row of a turn's built-in usage panel.

Which rate. The model id picks the reference tier: an id naming a Pro model
references deepseek-v4-pro, everything else references deepseek-flash — a
Flash alias, a DeepSeek id of unknown version, or a model from another family
entirely (Qwen, GLM, MiniCPM5-2B). Flash is the cheapest official rate and
so the conservative choice for a what-if.

Which cache-hit rate. This is the one premise the estimate rests on, so it is
stated rather than buried:

Third-party routes frequently report no cache accounting at all, and an agent
session re-sends almost its whole prompt every step. Reading a reported zero
literally would price the entire prompt at the cache-miss rate — an order of
magnitude too high. So the whole prompt is re-split by the hit rate rather than
read bucket by bucket, and 95% is the shape a real session settles into.

The estimate follows the same rules as the real cost: the same peak/off-peak
multiplier, the same in-step sample replacement, and the same retry accounting.

Pricing

Rates are CNY per 1,000,000 tokens, off-peak, with peak windows charged at
exactly twice every rate. Source:
.

• Peak windows are Beijing 09:00–12:00 and 14:00–18:00, Monday through
  Friday; everything else is off-peak, weekends and Chinese statutory
  holidays included. The holiday ranges come from the State Council's 2026
  notice (国办发明电〔2025〕7号) and are listed as HOLIDAY_RANGES at the top of
  lib/index.js; a year with no ranges there is charged as if every weekday were
  ordinary. The 调休 makeup workdays are deliberately not peak — the published
  rule keys off weekdays and calls weekends off-peak all day, so a Saturday stays
  off-peak however it is worked. The 计费时段 row names the window of the
  latest attempt that had a route, which is the window that attempt's own
  figures were priced in — both the real price and the what-if call the same rule
  on the same timestamp, so the label and the amounts cannot disagree. A session
  that spans a boundary therefore labels the newest window, not a session-wide
  one; the totals themselves already mix the windows they were incurred in.
• The two retired Flash aliases are still callable and are served — and billed —
  as deepseek-flash, so they share its tiers.
• Cache writes are charged at the cache-miss rate.
• Reasoning tokens are already part of the provider's outputTokens, so
  they need no separate row.
• A model id with no published rate, and every provider that is not DeepSeek's
  own, is billed 0 while its tokens stay visible (freeCalls in the
  projection), so an unpriced call is never silently folded into a DeepSeek
  figure.

Which routes count as DeepSeek's own

Both official routes are registered by DeepSeek's own LLM plugins
(@deepseek-ai/dsh-llm-deepseek-api-key and @deepseek-ai/dsh-llm-deepseek-account)
against one shared Messages transport and one upstream, so only the credential
differs — the published rates apply identically. Neither route is ever estimated:
an official cost is already the exact answer.

How it works

Host half (lib/index.js) registers the deepseekCost session projection on
ctx.sessionProjections. A projection is a pure, synchronous fold over the
whole durable session log, so the figures are complete regardless of transcript
paging and compaction — the same seam tokenUsage and sessionStats use.

The fold mirrors token-meter's replacement rule: the last usage sample inside one
(turn, step) replaces its predecessor, and llm/retry-started closes that slot
so a retried attempt adds a second billed attempt. Route attribution prefers the
settled assistant message's own source, then the last request/header /
request/context snapshot.

Besides the session and current-turn totals, the fold keeps a per-turn ledger
(turns, keyed by the turn number) of every turn's cost and estimate. A finished
turn is never the current turn again — turn/start resets the current-turn
figures at every boundary — yet its usage panel stays openable from the
transcript, so the ledger is what makes that panel answerable. Replacement and
retry rewrite only their own turn's entry.

Browser half (lib/client.js) registers one occupant on the
conversation.composer.dock list slot, reads the projection with
useProjection('deepseekCost'), and returns the pill as that occupant's element.
The dock is a flex row (InputBar.module.css .dock), so the pill is laid out
inline beside the built-in pills; the occupant owns no portal and no anchoring.
The pill owns its dialog seat, replicating the built-in useStatDialog placement
and dismissal from the shipped primitives. The occupant's one effect is the
turn-usage row watcher described above.

The dock slot is the public contract, which is what makes the pill survive DSH
upgrades: 0.1.6 dropped the statistics row's data-composer-stats hook that an
inline portal would have needed. The pill never referenced a class name belonging
to another package. The 本轮用量 row is the deliberate exception — that panel
offers no slot — and it is confined to the two data- attributes above rather
than any hashed class name.

The package declares both dsh.bundle.patch and dsh.client, so one install
command wires the host row and the browser bundle.

Where things live

Two directories carry this plugin's name, and they hold different things:

boot.log is a one-line activation record the host half overwrites on every
mount (2026-09-11T11:43:49.732Z host half mounted: projection "deepseekCost" registered). It is the quickest way to answer "did my restart actually load the
plugin?" when the browser shows nothing. Its parent honours $DSH_HOME the way
the rest of the harness does, so setting that variable moves it.

The name collision is the harness's own convention — a plugin owns
~/.dsh// for state, next to ~/.dsh/dsh-usage/ from the
community usage plugin — while plugins/ is where this one's source happens to
sit. Nothing writes to the source tree at runtime, and the test suite redirects
$DSH_HOME to a temp dir so running it never touches the real state dir.

Install

The package lives at ~/.dsh/plugins/dsh-deepseek-cost and is linked into the web
profile's node_modules, with one row in the profile's own patch layer.

# 1. link the package into the profile (a junction keeps one source of truth)
cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-deepseek-cost" "$env:USERPROFILE\.dsh\plugins\dsh-deepseek-cost"

Then ~/.dsh/profiles/web/cordis.patch.yml declares the row:

- insert:
- id: deepseek-cost
name: 'dsh-deepseek-cost'

The web profile is patchReload: live, so a running dsh web re-applies this
file when it changes; refresh the page and the pill appears. A dsh web restart
also picks it up. The host half writes a one-line activation record to
~/.dsh/dsh-deepseek-cost/boot.log on every mount, which is how you confirm it.

Declare the row once. insert appends, so listing dsh-deepseek-cost in both
dsh.profile.bundles and the profile patch layer mounts it twice.

The idiomatic alternative

dsh plugin --profile web add is the normal install path — it links the
package, appends the name to dsh.profile.bundles, and lets the package's own
dsh.bundle.patch own the row. It is blocked on this machine by a pnpm store
mismatch:

ERR_PNPM_UNEXPECTED_STORE  node_modules is linked from
C:\Users\wuw\AppData\Local\pnpm\store\v11, pnpm now wants
C:\Users\wuw\.dsh\.pnpm-store\v11

To switch to it, reconcile the store first (pnpm config set store-dir C:\Users\wuw\AppData\Local\pnpm store --global), run pnpm install in
~/.dsh/profiles/web, then remove the row above before running
dsh plugin --profile web add.

Tests

cd C:\Users\wuw\.dsh\plugins\dsh-deepseek-cost
node test/fold.test.mjs      # 26 pricing/fold cases
node test/client.test.mjs    # 21 browser-half render/wiring cases
node test/wiring.test.mjs    #  8 host-half + package-resolution cases

fold.test.mjs cases 1 and 2 reproduce two aggregates from a real DeepSeek
console ledger (2026-09-10 off-peak, 2026-09-11 peak) to six decimals under the
tier in force on those days, which pins the tier table, the peak windows, and the
bucket mapping together. Case 2b shows the same token mix one week later priced
under the current tier, and case 20 prices the account route against the API-key
route to pin them together. client.test.mjs drives the bundle through the real
window.__ModuleLoader__.load contract and renders the pill and its dialog
against a minimal React stand-in, because React is a browser-side static module
in DSH and is not installed as a Node package. It asserts the single visible
currency mark and its parenthesized estimate, the clamped/measure placement, both
dismissal paths, the dialog's rows, the absent-projection no-op, the appended
本轮用量 row (including which turn it answers for, its idempotence, and its
teardown), the panel material parity with the built-in dialogs — and, as a
regression guard for the 0.1.6 breakage, the complete inventory of selectors the
bundle evaluates, so the DOM surface cannot grow unnoticed. wiring.test.mjs
resolves the package, and its locale resources, from every profile that loads the
plugin.

What the plugin list shows

Settings lists this plugin as DeepSeek 花费统计 with a one-line summary,
instead of the bare module-derived deepseek-cost. DSH reads that text from
/locale/.json — the same mechanism the shipped packages use —
through the package's own exports, so the resource must be exported:

// package.json
"exports": { "./locale/*.json": "./locale/*.json" }

// locale/zh.json
{ "meta": { "title": "DeepSeek 花费统计", "description": "按 DeepSeek 官方价……" } }

• The filename is the language id (en.json, zh.json, …), the key inside is
  meta, and en.json is required: DSH enumerates that directory only when
  the English resource resolves, and ctx.locale.resolveText needs the en
  fallback before it walks the active language's fallback chain (zh-CN → zh →
  en).
• package.json name / description remain the fallbacks for a package with no
  locale directory, and the plugin list shortens a bare name by stripping the
  dsh- / dsh-host- / dsh-client- prefix — which is why the plugin used to
  read deepseek-cost.
• package.json icon (a manifest-relative SVG/PNG/JPEG/WebP under 256 KiB) is
  read the same way. This package ships no icon.
• wiring.test.mjs case 6 resolves both files from every profile that loads the
  plugin and checks the shape, because a missing export fails silently: the list
  just falls back to the package name.

Configuration

The price book lives at the top of lib/index.js (FLASH_TIERS, PRO_TIERS,
PRICE_BOOK, OFFICIAL_PROVIDERS). Add a tier for a new model id, or a new
{ from, ... } entry when DeepSeek changes rates.

stateVersion must be bumped whenever the fold's meaning changes, so persisted
projection checkpoints are discarded instead of forward-applied — it is at 4:

A bump is what retro-applies a correction to already-logged sessions: the old
rows are discarded and every session refolds from its log. Version 3 is how
account-route calls logged while the route was still billed 0 got their real
price; version 4 is how a session whose window label had frozen at its last
official attempt gets the right one, and how a holiday request priced at peak
gets re-priced off-peak.