dsh-token-usage
Persistent token usage records, cost estimation, and observability dashboard for DeepSeek Harness.
Install
$ dsh plugin --profile web add github:LeemanCheung/dsh-token-usagePlugin Overview & Capabilities
AI-assisted organization based on the public repository snapshot. The content must be grounded in source evidence and does not replace compatibility or security verification.
Key Capabilities
- Tracks four token buckets including uncached input, output, cache read, and cache write with retry and context compaction accounting
- Provides a 30-week UTC heatmap, period trends (7/30/90 days), and near real-time confirmed output token rate sampling
- Calculates USD cost estimates and cache savings based on static public rate tables and custom versioned rate cards
- Enables rolling 30-day token and amount budgets with 80% warning, 100% overrun, and 7-day run-rate projections
- Generates deterministic session trajectory breakdowns and opt-in AI usage optimization reports with privacy allowlists
- Supports aggregation exports to JSON v3 and CSV formats with formula-injection guards
Useful For
- Auditing and visualizing LLM token consumption across multiple providers and models in DeepSeek Harness
- Tracking agent execution efficiency, retry overhead, and context compaction rates
- Setting rolling token and cost budget alerts to prevent unexpected API expenditure
- Analyzing individual session trajectories to inspect turn-by-turn token distribution and tool calls
Who It Fits
- DeepSeek Harness web users monitoring API token usage and operational expenses
- Developers building and profiling complex multi-turn or multi-tool agents
- Administrators requiring privacy-preserving token audit trails and usage exports
Documented Limitations
- Cost calculations rely on static public price tables or user-defined rate cards and do not represent live provider billing or invoice sync
- Session trajectory history is stored in local browser storage (up to 24 reports) and does not synchronize across browsers
- UI dashboards and interactive trajectory views are only available on the web profile
- Provider breakdowns do not isolate fine-grained sub-agent, system prompt, or retrieval token buckets if the provider does not expose them
DSH Compatibility
Version-specific runtime evidence collected by DSH Plugin. A missing result means we have not tested that combination yet.
Security Signals
Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.
package.json declares 0 runtime, 0 development, 25 peer, and 0 optional dependencies.
package.json declares DSH bundle metadata.
GitHub reports the repository license as MIT.
A root package.json was captured and can be inspected by the registry.
Public GitHub source metadata is available for this registry snapshot.
Source & Registry Notes
Public provenance, Registry classification, and the latest source check for this entry, kept separate from runtime verification.
- Source repository
- LeemanCheung/dsh-token-usage
- Registry source
- GitHub · dsh-plugin topic
- Registry classification
- Plugin
- Source checked
- 94db895 · 2026-09-30
This project is independently indexed from public source information. DSH Plugin is not affiliated with DeepSeek or the plugin author. Always check the author repository before installation.
Repository Activity
- GitHub stars
- 12GitHub stars
- Forks
- 0
- Open issues
- 0
- Last commit
- 2026-09-27
- Last release
- 2026-09-02
Related DSH Plugins
Ranked by overlapping capabilities, use cases, plugin type, categories, and DSH profile.
Cost, token usage, budget, and coding-plan quota tracking plugin for DeepSeek Harness with bilingual UI.
View plugin →DeepSeek Harness balance and token monitor with whale-girl companion animations and visual billing rules.
View plugin →Generative UI plugin for DeepSeek Harness rendering interactive cards, charts, forms, quizzes, and 3D scenes inline.
View plugin →In-app skill audit and management panel for DeepSeek Harness with turn-by-turn invocation tracking and background customizations.
View plugin →