Skip to content

dsh-scope

Verified

@ammelsayed/dsh-scope Β· v0.4.1 Β· MIT Β· Web UI

Usage statistics for DeepSeek Harness as a sidebar page: lifetime token dashboard (52-week activity heatmap with daily/weekly/cumulative modes, per-model trend and donut, streaks), a balance page, and a context lens for the current session. Fork of dsh-sc

Install

dsh plugin add @ammelsayed/dsh-scope

Confirm the layer applied with dsh --profile default --dump-config β€” see the install guide.

Source

Tags

Creators

Readme

@ammelsayed/dsh-scope

Usage statistics for DeepSeek Harness, as a sidebar page.

A fork of dsh-scope that moves the usage dashboard out of a floating footer popup and into a first-class sidebar panel β€” a nav row that opens a full page in the center column, the way the shipped Plugins page works.

Everything the original measures is unchanged: a lifetime token dashboard (52-week activity heatmap with daily / weekly / cumulative modes, per-model trend and donut, streaks), a balance page, and a context lens in the session header.

Install

dsh plugin --profile web add @ammelsayed/dsh-scope

Or from the Web UI: Settings β†’ Plugins β†’ install bundle, with:

@ammelsayed/dsh-scope

No version in the spec β€” installs the latest published release. Reload the Web page afterwards; the host half needs a dsh restart the first time.

Straight from git (no npm involved):

dsh plugin --profile web add "github:ammelsayed/dsh-scope"

The built lib/ is tracked on main, so this installs the latest commit's build and no build step runs. Pin a tag (#v0.4.0) if you want a frozen version instead.

The profile patch mounts it as dsh-scope-page, a distinct id from upstream's dsh-scope, so you can install both side by side and toggle them independently.

What's different from upstream

upstream dsh-scope this fork
Where it lives footer badge + floating popup sidebar nav row + full page
Entry point sidebar.footer.action sidebar.panellist + main
Sizing tuned for a 400–860px popup page measure, app-matched type ramp
Scrolling popup body scrolls the page is the scroll container

The page reuses upstream's AppUsagePanel and BalancePanel unchanged, so the numbers, endpoints, and host-side aggregation are identical.

Two bug fixes carried in the fork:

  • Reload kept a stale stylesheet. injectStyle() skipped injection when a tag with the plugin's id already existed, so a reloaded page ran CSS from before the component tree. It now overwrites the existing tag.
  • The page could not scroll. The container is now bounded (flex:1, height:100%, min-height:0) and sets the DSH scrollbar tokens, which are what make the thumb visible in the first place.

Requirements

  • DeepSeek Harness >=0.2.1-rc.3
  • The Web profile (this is a Web-only UI plugin; the host half is an empty shell)

Plugin market

This repo publishes its own format-1 index to GitHub Pages on every release. Add that URL under Settings β†’ Discover β†’ index URLs to see the package in the Discover page, or install it directly with the command above.

Develop

npm install
npm run build     # lib/index.js (host) + lib/client.js (browser)
npm test          # smoke-test the built bundle (scripts/verify.mjs)

lib/client.js is built in the harness ModuleLoader closure-factory format; platform modules (react, cordis, ui-slots) stay external and resolve through the loader's injected require.

npm test loads the built bundle under a shimmed loader and asserts the slot contract, the page stylesheet, and the reload-refresh behaviour β€” no browser and no network. CI runs it on every push.

Releasing

npm version patch|minor|major
git push --follow-tags

The Publish workflow builds, tests, checks the tag against package.json, and publishes with provenance via npm Trusted Publishing (OIDC β€” no long-lived token). The Market index workflow then regenerates and deploys the index once npm serves the new version.

The very first publish of a new package name must be done by hand, because Trusted Publishing is configured on a package that already exists:

npm publish --access public

Credit

Original work: dsh-scope by Kun Xiao (helloxkk), MIT. The usage panel's design derives from ZCode's "Application Usage" surface β€” see NOTICE.md for the full attribution chain.

License

MIT. See LICENSE.