dsh-deepseek-quota

A plugin for the DeepSeek Harness (DSH) web GUI that shows your remaining DeepSeek API quota (balance) in a floating card pinned to the bottom-right corner of the page.

中文说明见下文。

Features

• Bottom-right overlay card (registered into the frame-wide shell.overlay slot — additive, never blocks the app).
• Shows total balance, availability, current conversation cost, today's consumption, and the granted / topped-up balance.
• Current conversation cost (当前对话费用): the host prices every assistant/message with the official DeepSeek price table (incl. peak/off-peak since 2026-08-17; pricing engine ported from dsh-web-billing, MIT) and reports the current session's accumulated cost via GET /api/deepseek-session-cost?sessionId=.
• Auto-refreshes every 60 s (balance) / 5 s (conversation cost), plus a manual refresh button.
• Follows the app's light/dark theme (--dsw-* tokens).
• Explicit error states: missing API key, network failure, provider errors.
• The API key never leaves your machine — the browser only talks to local routes that the host half registers.

Install

Requires the DSH CLI and pnpm.

dsh plugin --profile web add dsh-deepseek-quota

The package declares dsh.bundle, so dsh plugin automatically adds it to the profile's bundle layers (no manual patch editing). Then:

1. Restart the web app: dsh web (bundle layers are read at boot).
2. Open http://127.0.0.1:3080 and refresh the page.
3. The balance card appears at the bottom-right.

Manual alternative: install the package into the profile's node_modules and add a loader entry to ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: deepseek-quota
      name: dsh-deepseek-quota

Configuration

The plugin reads the same API key the harness already uses: , resolved through the credentials service (set it on the page; it is stored in , or export it in the launching environment).