Install
$ dsh plugin --profile web add "github:zh667/TokenLedger"Plugin 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
- Adds a TokenLedger entry to the DSH web sidebar and `/tokenledger` commands.
- Tracks usage across total, daily, monthly, relay-site, and model views.
- Attributes usage to relay-site origins derived from provider base URLs.
- Provides cache-hit metrics, an activity heatmap, CSV/JSON export, diagnostics, and index rebuilding.
- Supports configurable rate tables for dated, bucketed, and peak/off-peak cost estimation.
- Queries balances or quotas for the provider types listed in the README, including DeepSeek, New API variants, Sub2API, Moonshot/Kimi, Zhipu GLM/Z.ai, and OpenRouter.
- Exposes loopback-only GET endpoints for the web panel's usage and balance data.
Useful For
- Review token consumption by relay site and model.
- Investigate unattributed records and usage-index health.
- Export recent usage data for reporting or analysis.
- Estimate costs when applicable pricing rates are configured.
- Check supported provider account balances or quotas from the panel.
Who It Fits
- DeepSeek Harness web-profile users.
- Users routing requests through relay sites or multiple providers.
- Users who need local token-usage reporting and attribution.
Documented Limitations
- Requires the DeepSeek Harness `web` profile and README-stated `@deepseek-ai/dsh >= 0.1.0-rc.6`.
- Cost estimates require user-supplied rate tables; unpriced models are shown without an estimated cost.
- Balance support is limited to the account types and upstream APIs listed by the project.
- OpenRouter balance lookup requires a Management Key rather than an inference key.
- Automatic relay discovery may need manual `tokenledger.relays` configuration when provider settings are unavailable.
- Relay fingerprint probing is disabled by default.
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, 1 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
- zh667/TokenLedger
- Registry source
- GitHub · dsh-plugin topic
- Registry classification
- Plugin
- Source checked
- f3e3b77 · 2026-08-16
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
- 15GitHub stars
- Forks
- 3
- Open issues
- 0
- Last commit
- 2026-08-15
- Last release
- No release detected
Related DSH Plugins
Ranked by overlapping capabilities, use cases, plugin type, categories, and DSH profile.
DeepSeek Harness plugin that tracks per-call token usage, cache activity, and estimated costs in the web UI.
View plugin →Bilingual DeepSeek Harness cost-tracking plugin with session costs, budgets, balance checks, history, and pricing sync.
View plugin →A local-first DeepSeek Harness Web plugin for persistent token-usage tracking, budgets, exports, and optional AI-assisted usage and session-trajectory reports.
View plugin →A DeepSeek Harness web UI plugin that adds a Context tab for inspecting context-window composition and changes across a conversation.
View plugin →