deepseekplugins

DeepSeek Harness plugin

dsh-usage-guard

Usage statistics panel: silent per-model token collection, activity heatmap, trend charts, cost estimation and daily-limit guard.

Usage & Billing
Jump to install

Source facts

Repository
hb-degithub/dsh-usage-guard
Latest update
Aug 21, 2026
Category
Usage & Billing
GitHub stars
0

Install

Start with a prompt that asks an agent to read the source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to read the page and repository first.

Do not install anything yet. Read this DeepSeek Harness plugin and explain what it does, which files, networks, or credentials it can access, and how to install and remove it.

Plugin page: https://deepseekplugins.org/plugins/hb-degithub/dsh-usage-guard
GitHub: https://github.com/hb-degithub/dsh-usage-guard
Plugin: dsh-usage-guard
Author: hb-degithub
Install command: dsh plugin --profile web add github:hb-degithub/dsh-usage-guard

Do not run the install command until I confirm.

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-usage-guard

English | [中文](#中文)

Usage statistics panel for DeepSeek Harness (DSH) Web GUI — silent background collection, per-model analytics, cost estimation and a daily-limit guard.

Features

  • Silent collection — hooks session events, folds every assistant message's token usage into daily buckets per provider × model; survives restarts, backfills from session logs on first run
  • Dashboard in Settings → Usage: six stat cards (tokens, sessions, messages, active days, current streak, top model), a GitHub-style activity heatmap (continuous year view, weekday/month labels, hover detail card per day), a multi-series line/area trend chart (input / output / cache hit / cache write / cost, dual axes, 7d/30d switch) and a model-usage donut
  • Cost estimation — configurable per-model prices (input / output / cache read / cache write per 1M tokens); built-in DeepSeek list prices; models without a price are excluded from cost instead of guessed
  • Daily-limit guard — optional daily token / cost caps; warn mode shows a global banner, block mode aborts over-limit LLM requests before they hit the network
  • Bilingual (zh/en), follows the DSH theme tokens, zero external runtime dependencies

Install

From the DSH plugin market (Settings → 插件市场), or:

dsh plugin --profile web add dsh-usage-guard   # npm
dsh plugin --profile web add <github-url>      # or from GitHub

Restart dsh web, then open Settings → 使用统计.

Develop

pnpm install
pnpm build   # tsdown + wrap-client → dist/client.js (host loads host/, browser loads dist/)
pnpm test    # vitest, incl. an SSR smoke test that renders all charts from real data

License

MIT

---

中文

DeepSeek Harness（DSH）Web GUI 的用量统计面板——后台静默采集、按模型分析、费用估算、每日超限守卫。

功能

  • 静默采集——挂钩会话事件，把每条助手消息的 token 用量折叠进 天 × 提供商 × 模型 桶；重启不丢，首次运行自动从会话日志回填
  • 仪表盘（设置 → 使用统计）：六张统计卡（tokens、会话数、消息数、活跃天数、连续天数、最常用模型）、GitHub 风格活跃热力图（连续年度视图、星期/月份标注、逐日悬浮详情卡）、多序列折线/面积趋势图（输入/输出/缓存命中/缓存创建/成本，双轴，7/30 天切换）、模型用量环形图
  • 费用估算——按模型配置价格（每 1M tokens 的 输入/输出/缓存读/缓存写）；内置 DeepSeek 刊例价；未配置价格的模型不计费而不是瞎猜
  • 每日超限守卫——可选每日 token / 费用上限；warn 模式全局横幅提醒，block 模式在请求发出前直接拦截
  • 中英双语，跟随 DSH 主题令牌，零外部运行时依赖

安装

插件市场（设置 → 插件市场）一键安装，或：

dsh plugin --profile web add dsh-usage-guard   # npm
dsh plugin --profile web add <github 地址>      # 或从 GitHub

重启 dsh web，打开 设置 → 使用统计。

许可

MIT

Back to searchOpen GitHub repository

More related plugins

View category