dsh-status-bar · Know what your agent is doing — at a glance > A 17-segment, fully configurable status bar for the DeepSeek Harness composer dock. Replaces the built-in stats line with live session intelligence: status, model, context pressure, token burn, real-time generation speed, cost estimates, jobs and queue — toggled and reordered in two clicks, and it removes itself cleanly when you unload it. English · 中文 --- ## Overview The problem: the DSH composer shows one thin, fixed stats line. You cannot see the current model, how full the context window is, how fast tokens are streaming, or what a session has cost — and there is no way to arrange that information the way you work. Who it is for: power users and teams running DSH daily — anyone who wants live session telemetry without leaving the composer, and without running a separate monitor. What it does: - 17 toggleable, reorderable segments — status dot, model, title, workspace, agent preset, turns & steps, model/tool time, TTFT & decode speed, cache-hit rate, tokens, context pressure, live TPS, session time, cost estimate, jobs, queue, errors - Live throughput (TPS) — a host-side projection folds every assistant/chunk event, so the speed updates chunk by chunk while streaming; no polling, no external live-stats plugin - Cost estimation with a user-maintained model price book — per-model rates, per-model peak/off-peak schedules, each message/step priced with the model that actually produced it (input, cache-hit, cache-write and output priced separately at that step's own time), and a «Usage & cost» dialog with a stacked cost-trend chart (day / week / month), a paged per-step usage history (with a dedicated cache-hit column), and a total-cost hero - Zero-config default — 13 segments ship enabled; everything else is a checkbox away - Clean takeover — the plugin's bar shadows the built-in stats cell at lower priority: while loaded it renders, when unloaded the built-in line returns untouched - Bilingual UI — client locale strings ship for English and Chinese, following the DSH locale system ## Screenshots The status bar replaces the built-in stats line with live session telemetry (status · model · turns · context · cache · TPS · session time · jobs · queue · errors), managed from a dedicated settings page — including a per-model price book with peak/off-peak pricing: | Toggle & reorder on the go (segment list) | Usage & cost dialog (trend chart · stat cards · history) | |---|---| | | | ## Compatibility | Item | Value | |---|---| | DSH versions | 0.1.0-rc.5 (mainline master) — earlier RCs may work but are not verified | | Last verified | 2026-08-16 | | Runtime | Node ≥ 22 (host) + modern browser (client); no external services | | Peer relation | Coexists with @linxin666/dsh-live-stats — both serve the liveTokenUsage key; the session-projection registry keeps the first registrant (one unit, no duplicate rows) | ## Install / Uninstall ### Install sh # From a local checkout (profile assembly; `web` is a hardcoded alias for `--profile web`) dsh plugin --profile web add ../dsh-status-bar # Or from the GitHub repository dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar # Or a pinned release tarball — immutable and versioned (attached to every # GitHub release; handy when git access to the repo is awkward) dsh plugin --profile web add https://github.com/Starlight-bananice/dsh-status-bar/releases/download/v0.1.6/starlight-bananice-dsh-status-bar-0.1.6.tgz > Note: pnpm fetches GitHub-hosted packages from codeload.github.com and does not read your git proxy config. If the install hangs or fails with a network error (e.g. error (23)), export an HTTP(S) proxy: export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 and re-run. > Since v0.1.5: the built lib/ artifacts are committed to the repository — a git install is ready to run immediately, no build step required. Add the plugin, restart DSH Web, done. (Installs of ≤ v0.1.4 shipped no lib/, so they needed the manual build described under Development.) sh # Or runtime injection without a restart (developer workflow) # dev_inject_plugin / dsh-super-injector → point at this repository Then start/restart DSH Web. No configuration is required — the bar appears with its defaults. ### Upgrade sh # pnpm pins a ref-less `github:` dependency to the commit resolved at install # time, so `dsh plugin update github:...` reports "Already up to date" and # keeps the old build. Upgrade with a re-add: dsh plugin --profile web remove @Starlight-bananice/dsh-status-bar dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar # or pin an explicit ref (tag / branch / commit) dsh plugin --profile web add github:Starlight-bananice/dsh-status-bar#v0.1.5 ### Disable - Hide the bar only — the client master switch (Settings → Plugins → Status Bar, or the gear menu) turns the bar off instantly; the host projections and usage ledger keep running. - Stop the plugin entirely — remove it from the profile's bundles list (equivalent to uninstall below); re-adding restores it. ### Uninstall sh dsh plugin --profile web remove @Starlight-bananice/dsh-status-bar Removal restores the built-in stats line automatically (shadow cell released). Data left behind: browser localStorage (dsh.statusBar.v1) and the host usage file (see Permissions & data) are not deleted — remove them manually if you want a clean slate. ## Quick start 1. Install (above), restart DSH Web. 2. Start a session — the bar shows status · model · turns · durations · speeds · cache hit · tokens · context · TPS · session time · jobs · queue · errors by default. 3. Open Settings → Plugins → Status Bar to toggle/reorder segments, enable wrapping, or reset. 4. Want cost estimates? Add the models you use to the model price book: sh # In Settings → Plugins → Status Bar → Model price book: # model "deepseek-chat" → input 2 / cache read 0.5 / cache write 2 / output 8 (CNY per 1M tokens) # optional: enable peak/off-peak with DeepSeek's official windows 09:00–12:00, 14:00–18:00 The bar then shows e.g. ≈¥0.0123 for the current session; the figure is the sum of each model's usage × that model's own price (so switching models mid-session prices each part with its own rate). Click the chart button next to the gear to open the usage & cost dialog (stat cards, rate card, a paged usage history — 20 rows per page, up to 10 pages — with input / cache-hit / output / cost columns, and a per-model cost-trend chart with ‹ › period navigation). ## Configuration All configuration is client-side, stored in browser localStorage under dsh.statusBar.v1, edited via the settings page or the in-composer gear menu. | Option | Default | Meaning | |---|---|---| | enabled | true | Master switch; false hides the bar entirely | | wrap | true | Allow the bar to wrap onto multiple lines within the input card's width instead of eliding (the bar never runs past the input box's edges in either mode) | | segments | 13 on / 4 off (see below) | Ordered list of enabled segments | | cost.currency | CNY | Currency for cost display (CNY / USD) | | cost.models | {} | User-maintained model price book (model id → prices + schedule) | Default segment state: on — status, model, counts, durations, speeds, cache hit, tokens, context, TPS, session time, jobs, queue, errors; off — title, workspace, agent, cost. Model price book entry (values added when a model is configured): input 2, cache read 0.5, cache write 2, output 8 (per 1M tokens, in the configured currency); peak/off-peak disabled by default; when enabled, defaults to DeepSeek's official windows 09:00–12:00, 14:00–18:00, timezone local. Environment variables: DSH_HOME (host-side) — base directory for the plugin's local data (default ~/.dsh). No other env vars, no secrets, no tokens. Segment reference (all 17, toggleable & reorderable): | Segment | Shows | Source | |---|---|---| | Status | ● running / idle / error dot | snapshot running / partial / lastAgentError | | Model | model of the latest response | sessionModel projection (host fold of assistant/message events) | | Title | session title (truncated) | SessionSummary | | Workspace | workspace dir name | SessionSummary | | Agent preset | preset name | SessionSummary | | Turns & steps | N turns · M steps | sessionStats projection (window-fold fallback) | | Model & tool time | LLM · tool-call wall time | sessionStats | | TTFT & decode | avg first token · tok/s | sessionStats | | Cache hit | prompt cache-hit share (2 decimals, capped at 99.99%) | tokenUsage | | Tokens | billed input/output totals | tokenUsage | | Context | context-window occupancy % | contextPressure | | Throughput TPS | live generation rate (default on) | liveTokenUsage projection — folded from assistant/chunk in real time; block-aware estimation (~4 chars/token + block/role framing, re-priced at block-end, EWMA against burst flushes), exact once the provider reports usage; 0 while the session is not generating | | Session time | wall clock, ticks while running | turnTimings | | Cost estimate | ≈¥0.0123 (off by default) | sessionUsage projection — each model's usage × its own effective price (flat or peak/off-peak at now), summed across models | | Jobs | running background jobs | jobsBySession | | Queue | queued messages | snapshot queue | | Errors | failed/retried/over-limit count (>0 only) | node fold | ## Permissions & data | Category | What the plugin touches | |---|---| | Files | Host writes the usage ledger to <DSH_HOME>/dsh-status-bar/usage.jsonl (~/.dsh/dsh-status-bar/usage.jsonl by default; one record per assistant message: timestamp, model, input/cacheRead/cacheWrite/output tokens). In-memory history is a rolling 120-day window. | | Network | No outbound requests, ever. The only endpoint is the plugin's own local webserver route /status-bar/api/usage (same origin as DSH Web, 127.0.0.1), serving the chart buckets. | | Credentials | None. The plugin never reads, stores, or transmits API keys, tokens, or cookies. | | User data | Client: localStorage["dsh.statusBar.v1"] (bar config + price book — no conversation content). Host: the usage ledger described above (token counts only, no prompts, no messages, no file contents). | ## Troubleshooting | Symptom | Cause & fix | |---|---| | Bar does not appear | Master switch off → enable it in Settings → Plugins → Status Bar, or via the gear menu. localStorage cleared? Config resets to defaults. | | TPS segment is 0 / blank | No stream has started yet, or the stream is between retries. The measurement window restarts on each llm/retry; the carried rate never goes blank after the first stream. | | TPS conflicts with another plugin | If @linxin666/dsh-live-stats is loaded, the registry keeps whichever registered first for the shared liveTokenUsage key — one unit, no duplicate rows. | | Cost estimate missing | None of the session's models is in the price book (or they are all zero-priced) → add them in Settings → Plugins → Status Bar → Model price book. Costs are estimated at the book's rates (per model, flat or peak/off-peak), not provider billing. | | Usage chart is empty | No assistant messages with provider-reported usage in the period yet, or DSH_HOME points elsewhere than expected (check usage.jsonl location above). | | UI looks broken after an upgrade | Hard-refresh the browser (stale client bundle) and verify the plugin version in Settings. | | Can't tell which version is installed | From the profile directory (macOS/Linux): node -p "require(process.env.HOME + '/.dsh/profiles/web/node_modules/@Starlight-bananice/dsh-status-bar/package.json').version". Behind v0.1.5? Re-apply the Upgrade steps — a ref-less github: install keeps the commit resolved at install time. | Logs: the plugin writes no log files of its own — host-side diagnostics appear in the DSH web process output (profile logs); client-side issues surface in the browser devtools console. Rollback: the settings page has a one-click Reset (restores all defaults). For the plugin itself, uninstall → re-add the previous version with dsh plugin --profile web add <pkg>@<version>; the built-in stats line is always restored automatically on removal. ## Development sh pnpm install # devDependencies only (typescript / tsdown / @types); npm peers are provided by the DSH runtime closure and intentionally not declared npm run build:client # tsdown → lib/client.js (ModuleLoader bundle) npm run build # junction links + host tsc + client typecheck (needs DSH_CHECKOUT pointing at a dsh source checkout) Build artifacts under lib/ are committed (since v0.1.5), so plain git installs work without any build step; the commands above exist to refresh the artifacts before a release. npm run build / typecheck:client need DSH_CHECKOUT (or the common-path probe) — client typechecking resolves against the checkout's lib/types through junction links. Host-side sources are plain TypeScript (Cordis plugin), client sources are React + the DSH client UI slots. Keeping lib/ in sync: run pnpm install --frozen-lockfile (reproducible rebuilds use the exact toolchain pinned in pnpm-lock.yaml), then npm run verify before pushing (scripts/verify.sh rebuilds host + client and fails when the committed lib/ drifted from src/). The repository also ships a pre-push hook that runs it automatically whenever a push touches src/ or the build config — enable it once with: sh git config core.hooksPath .githooks The lib-sync GitHub Actions workflow enforces the same invariant in CI: a fast artifact-integrity check on every push/PR, plus a full rebuild-vs-lib/ drift check on PRs that touch src/ and on manual dispatch. Contributing: fork the repository, branch off main, and open a PR — small, focused changes with a clear description are preferred. Report bugs via Issues with the DSH version, browser, and a minimal repro. ## License & security - License: MIT (© 2026 Starlight-bananice). - Security: this plugin holds no credentials and makes no network calls; the attack surface is the DSH host process itself. To report a security issue privately, use GitHub's Security Advisories on this repository (https://github.com/Starlight-bananice/dsh-status-bar/security/advisories/new) — do not open a public issue for vulnerabilities.