ben7am1n/dsh-deepseek-usage
DeepSeek balance and token usage tools for DeepSeek Harness
A DeepSeek usage monitor that exposes account balance and live token usage as model-callable tools. deepseek_balance queries the DeepSeek balance endpoint and returns availability plus per-currency balances (total / granted / topped-up), appending a warning when the primary currency drops below the configured lowBalanceThreshold. usage_summary aggregates per-session token usage from the harness token meter across live sessions, sorted by total tokens descending, so you can estimate context usage and spot runaway sessions. The README's config table documents the three keys; the plugin is deliberately small — two tools and one optional config row.
Install
dsh plugin --profile <name> add dsh-deepseek-usagenpm package dsh-deepseek-usage 0.1.0 (registry-verified 2026-09-13; repository field → github.com/ben7am1n/dsh-deepseek-usage). README install line quoted verbatim — substitute your profile name for <name>. Requires a DeepSeek API key available as DEEPSEEK_API_KEY (env or credential). Optional config row (- id: deepseek-usage) accepts apiKeyEnv (default DEEPSEEK_API_KEY), baseURL (default https://api.deepseek.com) and lowBalanceThreshold.
Compatibility
DeepSeek Harness with the standard plugin manager and a DeepSeek API key. The balance tool calls the DeepSeek public API (GET https://api.deepseek.com/user/balance), so it needs network access and a valid key; the usage tool reads the harness token meter locally.
Details
- Repo: ben7am1n/dsh-deepseek-usage
- Category: Other
- Stars: 1
- Version: npm dsh-deepseek-usage 0.1.0 (registry-verified 2026-09-13)
- Last push: 2026-08-13
- First seen: 2026-08-13
Recent updates
The README documents the two tools and the config table rather than a versioned changelog; there is no release history or migration section. Version 0.1.0 on the public registry (verified 2026-09-13; last modified 2026-08-13).
FAQ
- How do I install dsh-deepseek-usage?
- Run dsh plugin --profile <name> add dsh-deepseek-usage with your profile name substituted, and make sure DEEPSEEK_API_KEY is available in the environment or credentials store.
- What does deepseek_balance return?
- Availability and per-currency balances (total / granted / topped-up) from the DeepSeek user-balance API; when lowBalanceThreshold is set it appends a warning if the primary currency falls below it.
- What does usage_summary cover?
- It aggregates per-session token usage from the harness token meter across live sessions, sorted by total tokens descending — useful for estimating context usage and spotting runaway sessions.
Alternatives
crazywoola/dsh-balance · Ghost011118/dsh-balance-meter · Ychris12138/dsh-usage-stats