Introduction

For developers using DeepSeek Harness (DSH), local sessions have already generated Token, request, Agent activity, tool call, and performance data. However, this information is scattered within session events, making it difficult to verify directly.

dsh-usage-insights solves this specific problem: it does not introduce new model calls, does not display costs, and only reads the existing local session corpus from DSH, providing a filterable, verifiable, and exportable usage panel in DSH Web under “Settings > Work Activity”.

What is it

dsh-usage-insights is a local read-only usage panel for DeepSeek Harness maintained by fazhu4, current version is 0.2.0, license is MIT.

It aggregates Token, request, Agent activity, tool call, and performance data from DSH session events and provides cards, trends, and paginated details in “Settings > Work Activity”. Current version is alpha.

Core Features

The following explains the capabilities by panel.

Time Range & Filters

  • View today, 7d, 30d, or all data by verified IANA timezone natural days.
  • Filter by workspace, provider, and model simultaneously.
  • The tool dimension does not accept provider or model filtering; this combination returns HTTP 400.

Tokens & Requests

  • Display uncached input, cache read, cache write, output, and reasoning tokens in output separately.
  • Display metered requests, active workspaces, active sessions, Agent Usage, model duration, tool duration, TTFT coverage, and cache reuse rate.
  • Daily trends can be switched between Token and Request counts.
  • Provider and model details distinguish Agent and Compaction request sources.
  • Provide five types of paginated details: workspace, provider, model, session, and tool, which are searchable and sortable.

Performance & Export

  • Statistics for average Time to First Token (TTFT), output speed, model duration, tool duration, tool failure daily trends, and turn results.
  • Export UTF-8 CSV consistent with current filtering and analysis dimensions.
  • Session rows open via the DSH client session service, without constructing private URLs.

UI & API

  • Chinese and English interface, keyboard-navigable tabs, focusable chart daily buckets, and narrow-screen layout.
  • Provide HTTP APIs such as summary, breakdown, filters, export.csv, retry, etc.

Installation & Enabling

v0.2.0 renamed from dsh-activity-report. If the old profile has dsh-activity-report installed, remove the old package first:

dsh plugin --profile web remove dsh-activity-report

Then install the current version:

dsh plugin --profile web add dsh-usage-insights@0.2.0

After the above steps, restart dsh web and open “Settings > Work Activity”.

Typical Usage

The following explains the reproducible steps given in the documentation.

  1. Install dsh-usage-insights@0.2.0.
  2. Restart dsh web.
  3. Open “Settings > Work Activity”.
  4. Use range=today|7d|30d|all to select the time range.
  5. If filtering is needed, use the repeatable workspace, provider, and model parameters.
  6. View details for workspace, provider, model, session, and tool, or export UTF-8 CSV.
  7. If querying the tool dimension, do not pass provider or model parameters simultaneously; this combination returns HTTP 400.

Configuration

cordis.patch.yml exposes the following deployment parameters:

Field Default Description
persistDebounceMs 1000 Milliseconds to wait for real-time event merging writes
backfillConcurrency 4 Historical session backfill concurrency
defaultPageSize 25 Default page size for details
timezone System IANA timezone Timezone for natural day bucketing

Local Storage & Privacy

  • The plugin only reads the existing local session corpus from DSH.
  • The plugin persists per-session aggregated records in the usage_insights domain of DSH’s storageDomain.
  • The plugin does not display costs, does not call model or provider interfaces, and does not modify, archive, or delete sessions.
  • The interface and export do not include prompts, response bodies, tool parameters, or tool outputs.
  • When a source session is removed from the DSH logical corpus, the plugin only cleans up the corresponding derived aggregated records and does not modify or delete DSH session data.

Development & Verification

Development verification requires Node.js ^22.19.0 or >=24.0.0 and pnpm.

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run verify:package

Use Cases & Notes

Suitable for developers or operations personnel who need to verify DSH session usage, requests, Agent activity, tool calls, and performance information locally.

Notes:

  • Current version is alpha.
  • The plugin runs with the current dsh process permissions; check source code, dependencies, and license before installing.
  • The plugin does not display costs, does not call model or provider interfaces, and does not modify sessions.
  • The tool dimension does not accept provider or model filtering; this combination returns HTTP 400.

Conclusion

The value of dsh-usage-insights is to organize the existing usage, requests, Agent activity, and tool call information from DSH local sessions into a verifiable, filterable, and exportable read-only panel.

  • Page: https://www.skillhub.cn/plugins/fazhu4/dsh-usage-insights
  • GitHub: https://github.com/fazhu4/dsh-usage-insights