dsh-workload-report
DeepSeek Harness (DSH) 插件 — 按日期和工作区查看您的工作量与令牌使用情况：日历热力图、时段分析、工作区占比，以及可分享的自包含 HTML 报告。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:tableau-China/dsh-workload-report#bb71aebc8dec8086e01e87ed6c375466ad4accc2Workload Report 以 dsh-workload-report 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Put your effort and your token spend on the same picture: see where your time went and where the tokens went, by date and by workspace — calendar heatmap, time-of-day analysis, workspace share, and a one-click self-contained HTML report you can send straight to a client. A DeepSeek Harness (DSH) plugin for effort & token insights.
TimeMirror is a macOS time-distribution app I published on the Mac App Store; this plugin brings the same idea to AI-assisted work — the time you and your AI spend, and what it costs, made visible. The package/repo uses the descriptive name
dsh-workload-reportso it can be found in the DSH ecosystem; the brand stays TimeMirror.
中文 · English
You use AI every day, but you cannot say where the work went or what it was worth:
DSH itself only shows a stats line for the current session; the cross-session, cross-project, cross-time view is what this plugin adds.
Not just cost — the work behind it. Cost meters tell you what you spent; this plugin also tells you what you did: how many days you showed up, which hours you were sharpest, and which project your effort actually went into. That is the part you can put in front of a client.
anonymize=1 to hide workspace names and session titles.--dsw-*), so it follows the harness's light/dark theme and Chinese/English locale.Home: six KPIs + calendar heatmap (switchable to a bar chart) + side-by-side time-of-day analysis and workspace share + a collapsed daily table
By workspace: effort on the left, token spend on the right, two bars on one scale
The exported report (single file, safe to send to a client)
dsh plugin --profile web add github:tableau-China/dsh-workload-report#main
The built client bundle (lib/client.js) is committed, so no local build is needed. Restart the Web profile afterwards — a "Workload report" entry appears at the bottom of the sidebar.
cd /path/to/dsh-workload-report
dsh plugin --profile web add link:$PWD # points the profile at your source tree
dsh plugin --profile web add dsh-workload-report
Published on npm: https://www.npmjs.com/package/dsh-workload-report If your npm client points at a mirror (e.g. npmmirror), a brand-new package can take a few minutes to appear — use option 1 if you are in a hurry.
Uninstall: dsh plugin --profile web remove dsh-workload-report.
Override any of these in your profile's cordis.patch.yml (all optional):
- id: workload-report
name: dsh-workload-report
config:
apiPath: /workload-report/v1 # read-only API prefix
defaultDays: 7 # default range
defaultScope: all # all | main | subagent
defaultTitle: Workload Report # report title
workspaceAliases: # display names (very handy for client-facing reports)
my-shop-app: Retail Order System
data-platform: Data Platform
| Route | Description |
|---|---|
GET {apiPath}/snapshot?days=30&tz=Asia/Shanghai&scope=all | Aggregated snapshot JSON (totals / byDay / byWorkspace / byHour / bySession / calendar / diagnostics) |
GET {apiPath}/export.json?... | Same payload, sent with content-disposition for download |
GET {apiPath}/report.html?days=90&theme=dark&anonymize=1&title=... | Self-contained HTML report |
GET {apiPath}/health | Index diagnostics (session count, checkpoint hits, cold reads, read failures, duration) |
Parameters: from/to (YYYY-MM-DD, take precedence over days), days, all=1 (earliest active day → today), tz (IANA time zone), scope.
The full definitions live in docs/metrics.md. Durations are always shown in H / M / S (language-neutral, like K/M/B for tokens, so one format serves every locale). The three most misunderstood:
All statistics stay on your machine. The plugin registers read-only HTTP routes only: no outbound requests, no telemetry, no user content collected.
The single file it writes is its own index cache at <DSH_HOME>/workload-report/index-v*.json — delete it and the plugin rebuilds by cold-reading; nothing else in your harness data is touched.
Whether the exported HTML report contains session titles is your call (anonymize=1 hides them).
| Command | Purpose |
|---|---|
pnpm add -D esbuild puppeteer-core | Install build and E2E dependencies (or point ESBUILD_PATH / WL_PUPPETEER_DIR at existing installs) |
node build.mjs | Bundle src/client/ into lib/client.js (ModuleLoader factory format) with esbuild |
node test/verify.mjs | 124 offline assertions: aggregation semantics, time zones, hour-spread conservation, "all-time" start, calendar data source, HTML escaping, both token shapes, cold-read fallback, inject declaration check, host routes |
./test/e2e-boot.sh 3299 | Boot an isolated instance (own DSH_HOME and port, copied projection data) without touching your running GUI |
node test/e2e-ui.mjs | 61 real-browser assertions: calendar/bar switching, side-by-side geometry, weekday bars, donut switching, collapsed detail, report export |
CI runs build.mjs + verify.mjs, and fails if the committed lib/client.js differs from a fresh build.
0.2.x, including alpha prereleases (developed and verified against @deepseek-ai/dsh@0.2.1-alpha.2): the plugin only depends on official interfaces (sessionProjections / sessionProjectionCache / sessionQuery) and Node built-ins, never on internal file formats — so it can follow new releases. Staying compatible with the latest alpha is one of this project's goals; breakages will be tracked in issues and the CHANGELOG.indexing: true; once the index is persisted, restarts reuse it.| XILEJUN |
XILEJUN — author of TimeMirror · Blog post (中文) |