dsh-ui-cost

Readme

# dsh-ui-cost

English | [中文](README.zh.md)

Self-contained stats strip with an estimated cost, contributed as a pure DSH browser plugin — **no modification to the ui-conversation core**, so a DSH/DSH Desktop upgrade that restores the stock core cannot break it.

This is a community plugin and is not affiliated with DeepSeek AI.

The plugin registers on the same `conversation.composer.dock` cell as the core stats entry (`id: 'stats'`) with a lower shadowing priority, taking over the whole line: turn/step counts, LLM and tool wall times, TTFT/decode throughput, cache-hit share, billed tokens, and the cost. If the plugin ever crashes, the cell's shadowing retires it and the stock core strip renders instead. Composing this plugin out of cordis.yml removes the whole replacement and the stock strip returns.

The cost prices the durable `tokenUsage` projection (uncached input + cache writes at the cache-miss input rate, cache reads at the hit rate, output at the output rate) at the session's CURRENT model selection, read live from the ui-model-selection model directory — so a model switch re-prices immediately. Rates come from the official [Models & Pricing](https://api-docs.deepseek.com/quick_start/pricing) page (CNY per 1M tokens, `deepseek-v4-flash` / `deepseek-v4-pro`) and follow its announced peak/off-peak schedule automatically — peak is 09:00–12:00 and 14:00–18:00 Beijing time, off-peak is half (effective 2026-08-17 00:00 Beijing; the flat table is billed before that).

## Preview

![dsh-ui-cost preview](assets/ui-cost-preview.png)

## Install

The package declares `dsh.bundle` (its `cordis.patch.yml` inserts the `ui-cost` row) and `dsh.client` (the browser bundle). The repository includes the built `lib/` artifacts, so a GitHub install does not need to run an install-time build script:

```sh
dsh plugin --profile web add github:uaapple/dsh-ui-cost
```

For a reproducible install, pin the command to a full commit SHA. If the package is later published to npm, the equivalent command is `dsh plugin --profile web add dsh-ui-cost`.

To mount the row manually instead of using the bundle manifest:

```yaml
- insert:
    - id: ui-cost
      name: dsh-ui-cost
```

The GitHub repository should carry the `dsh-plugin` topic so it appears in DSH community indexes and search pages.

## Development

```sh
npm install
npm run check
npm test
```

The supported runtime is Node.js 22 or newer. DSH itself is still in developer preview, so compatibility follows the DSH client package versions declared in `package.json`.