Plugin directory / UI & Skins / dsh-plugin-api-quota
dsh-plugin-api-quota
Verified · install-tested on dsh ganfne123
What it does
DSH Web UI plugin: check your DeepSeek API key balance from the sidebar
Works — verified, early-stage project
DSH Web UI plugin: check your DeepSeek API key balance from the sidebar It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-plugin-api-quota
DSH Web UI plugin — check your DeepSeek API key balance from the sidebar.
What It Does
Adds an API Quota entry to the Web sidebar footer (next to Settings). Clicking it opens a panel that queries the DeepSeek official balance endpoint (GET /user/balance) and shows:
- Total balance, granted balance, topped-up balance
- Currency and availability
- Query time, with a refresh button
The API key never crosses into the browser: the browser half fetches a same-origin route (/api-quota/balance) served by the plugin's host half, which resolves the key through the credential seam (ctx.credentials) and talks to DeepSeek server-side.
How It Works
| Half | Responsibility |
|---|---|
Host (src/index.ts) |
Registers GET /api-quota/balance on the web server; resolves DEEPSEEK_API_KEY via ctx.credentials, calls https://api.deepseek.com/user/balance |
Browser (src/client/) |
Registers the sidebar.footer.action slot entry; fetches the route and renders the balance panel (Modal) |
The credential reference and endpoint are configurable via the plugin config (apiKeyEnv, baseURL, balancePath), defaulting to DEEPSEEK_API_KEY / https://api.deepseek.com / /user/balance.
Quick Start
DSH plugins install into a profile (dsh web → web profile). Install, restart dsh web, done.
# from the plugin repo root
npm install && npm run build
# register in the profile patch layer (~/.dsh/profiles/web/cordis.patch.yml):
# - insert:
# - id: plugin-api-quota
# name: dsh-plugin-api-quota
# symlink into the profile's node_modules:
# ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-plugin-api-quota
Configuration
| Field | Default | Meaning |
|---|---|---|
apiKeyEnv |
DEEPSEEK_API_KEY |
Credential reference (environment-variable-shaped) holding the API key |
baseURL |
https://api.deepseek.com |
DeepSeek API base URL |
balancePath |
/user/balance |
Balance endpoint path appended to baseURL |
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-plugin-api-quota for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:ganfne123/dsh-plugin-api-quotaHeadless (CLI) profile:
dsh plugin --profile headless add github:ganfne123/dsh-plugin-api-quotaTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-plugin-api-quota/)<a href="https://dshbase.com/plugins/dsh-plugin-api-quota/"><img src="https://dshbase.com/badges/dsh-plugin-api-quota.svg" alt="dshbase install-tested"></a>