返回目录
部署运维 基础设施

dsh-plugin-window-stats

wellorbetter/dsh-plugin-window-stats

DSH web plugin: see every session's conversation progress and token usage at a glance — all-windows overview, session analysis, cost estimation, and a token heatmap. 窗口统计插件:一屏看全所有会话的对话进度与 Token 消耗——全窗口总览、会话分析、成本估算、Token 热力图。

Stars
2
Forks
0
Issues
0
更新
3 天前

PROJECT TOPICS

项目标签

PROJECT README

README

Window Stats

English | 中文

License MIT For DeepSeek Harness dsh-plugin

A DeepSeek Harness web plugin that shows every session's conversation progress and token usage at a glance.
All-windows overview · session analysis · cost estimation · token heatmap.
100% read-only and local — no outbound requests, no session writes.

Window Stats

Session Analysis

Overview panel and sidebar summary

What this plugin provides

Installing this bundle adds a cross-session observability surface to every session of the target dsh profile. It reads the official tokenUsage / sessionStats / contextPressure / contextBreakdown projections (plus a tokenHistory projection it registers itself), so no host service or new RPC is required beyond that one projection unit.

Surface What it shows
窗口统计 view tab One row per session: status, turns/steps, input/output tokens, cache-hit ratio, context occupancy, duration, cost, last activity — with sort / filter / group-by-workspace / model & currency selectors, and a right detail panel (token buckets, context composition, timing, heatmap).
会话分析 view tab Time-range analysis (presets + custom) of the current session: token trend chart, tool-type duration distribution (donut + bars), and per-turn task summaries.
Sidebar footer summary Always-visible running count, total tokens, and cost.
Right overview drawer Collapsed by default; expands to a running-sessions + top-token-consumers + recent-activity panel with click-to-open.

Data source

Displayed Source
turns / steps / wall times sessionStats projection
input / output / cache tokens tokenUsage projection
context occupancy / composition contextPressure + contextBreakdown projections
per-day token history (heatmap) tokenHistory projection (registered by this plugin)
status SessionSummary.running / pendingInteraction / completed

Cost is estimated from DeepSeek's official pricing (V4-Flash / V4-Pro, cache-hit / cache-miss / output priced separately) with USD / CNY / EUR / GBP / JPY switching.

Install

Requires the dsh CLI (install DeepSeek Harness).

# from GitHub (recommended)
dsh plugin --profile web add github:wellorbetter/dsh-plugin-window-stats

# or from a local checkout
dsh plugin --profile web add ./dsh-plugin-window-stats

Restart the profile (dsh web) after installing. The plugin is a bundle: it declares dsh.bundle.patch, so dsh plugin reconciles it into the profile's dsh.profile.bundles automatically. It ships pre-built JavaScript (lib/), so a GitHub install needs no build step or allowBuilds permission.

Use

After restarting dsh web:

  • Sidebar — the footer shows running count + total tokens + cost at all times.
  • 窗口统计 tab — open any session and click the tab to see every session's progress, tokens, and cost; click a row for a rich breakdown; use the toolbar to sort / filter / group / switch model & currency.
  • 会话分析 tab — analyze the current session over a time range, by tool type, with a token trend chart and task summaries.
  • Right drawer — click the edge handle to expand the running / top-tokens / recent overview, click any row to open it.

Development

pnpm install
pnpm verify   # typecheck + build + test

License

MIT

CLASSIFICATION EVIDENCE

分类依据

项目类型基础设施
功能分类部署运维
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: observability。