dsh-tps

A live tokens-per-second card for the current DeepSeek Harness session. It docks into the left sidebar, or floats as a draggable card — switch with the toggle at the card's top-right corner.

What it shows

• Live t/s — throughput of the streaming assistant output, computed from real agent/assistant-stream deltas (a sliding window, with a denominator floor so bursty chunks cannot spike the number).
• Average t/s — session-wide average since the first token; toggle 实时 / 平均 (live / average) with the segmented control in the card header.
• Sparkline — the last 40 samples, drawn with the card's own accent colour.
• Session list — every session with a reading, titled and followed by the workspace it lives in, e.g. dsh-tps (dsh-tps). Click a row to switch the card to that session; the click does not touch your current page.

Dock left or float

The two buttons at the card's top-right choose the placement:

• 左侧 (left) — dock into the sidebar footer slot. The card follows the sidebar: if the slot disappears (narrow window, collapsed sidebar), it falls back to the floating position instead of vanishing.
• 悬浮 (float) — stay pinned as a floating card at the bottom-right corner.

The choice is remembered in localStorage, as are the floating position, the collapsed state and the mode (live/average).

Dragging

In floating mode the whole card is a drag handle — header, number, sparkline, empty space. Only the buttons, the segmented controls and the session rows opt out, because those are click targets. Drags are tracked on document, so the card keeps following the pointer even when it leaves the card, and a drag never fires the click that would toggle the card.

Install

dsh plugin add TINGOD2006/dsh-tps

Then restart the harness service (the card appears in the sidebar once the plugin is loaded). No build step, no dependencies.

How it works

• lib/tracker.js keeps a per-session sliding window fed by agent/assistant-stream deltas and session/event (turn boundaries, cache-hit usage totals).
• lib/index.js subscribes to those events, exposes GET /dsh-tps/state.json and GET /dsh-tps/widget.js, and injects the card through both supported paths: the structured webserver/index-inject table (used by the Electron desktop shell) and ctx.webServer.tapIndex() (used when the Host renders index.html itself, e.g. dsh web).
• lib/widget.js is served from disk on every request, so editing it and reloading the page is enough — no restart. A ⟳ hint appears when the page is still running an older copy of the widget than the one on disk.

Tests

node lib/tracker.test.js

Covers the window denominator floor, idle decay, in-flight step readings, block-end fallback and cache-hit accounting — all with injected timestamps, no real clock, no network, no fixtures.

License

MIT