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.