Plugin directory / Knowledge / dsh-plugin-usage-dashboard
dsh-plugin-usage-dashboard
Verified · install-tested on dsh hnmrxz
What it does
DeepSeek usage & cost dashboard for the DSH bottom status bar: per-session token/cost aggregation with low-balance budget alert.
Works — verified, early-stage project
DeepSeek usage & cost dashboard for the DSH bottom status bar: per-session token/cost aggregation with low-balance budget alert. It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-plugin-usage-dashboard
在 DeepSeek Harness (dsh) 底部状态栏显示 DeepSeek 用量与估算花费：按会话聚合 token 成本、余额预算告警。
Estimated token cost & usage dashboard for DSH: per-session token/cost aggregation with a low-balance budget alert, right in the bottom status bar.
Features
- 状态栏 chip：
DS ¥12.34 · 估算花费，余额低于阈值时变橙色⚠ 余额偏低 - 悬停查看明细：总花费 / 会话数 / token 数 + 按会话 Top 8 的成本排行
- 每 30 秒自动刷新，点击立即刷新
- 数据完全来自 dsh 自己的投影缓存（
tokenUsage/sessionStats），零核心改动、零运行时依赖 - 余额告警复用
DEEPSEEK_API_KEY凭据（与余额插件同一条链路），无需再配置 - 中英文自动跟随 DSH 界面语言
Install
需要 DSH 0.1.0-rc.x（Web profile）。
1. 安装到 profile
cd ~/.dsh/profiles/web
npm install dsh-plugin-usage-dashboard
# 本地开发：npm install /path/to/dsh-plugin-usage-dashboard
2. 加入 composition
编辑 ~/.dsh/profiles/web/cordis.patch.yml：
- insert:
- id: usage-dashboard
name: dsh-plugin-usage-dashboard
3. 重启 dsh
dsh --profile web
Configuration
无配置项。Key 复用 DEEPSEEK_API_KEY（Models 设置页或环境变量）。
成本为估算值：按 DeepSeek 公开定价（CNY/1M tokens）折算——缓存命中输入 ¥0.5、未命中输入 ¥2、输出 ¥8。如需调整，编辑 lib/index.js 顶部的 PRICE 常量；余额告警阈值 BALANCE_ALERT_THRESHOLD（默认 10 CNY）同理。
How it works
Browser client.js dsh Host process
┌──────────────┐ GET ┌───────────────────────────┐
│ composer.dock│ ───────► │ /dsh-usage │
│ chip │ ◄─────── │ ├─ sessionQuery │
└──────────────┘ JSON │ │ .listSessions() │
│ ├─ sessionProjections │
│ │ .snapshot() │
│ │ (tokenUsage, │
│ │ sessionStats, │
│ │ title) │
│ ├─ credentials.resolve() │
│ └─ fetch /user/balance │
└───────────────────────────┘
Development
lib/index.js # Host half：聚合用量 + 余额告警，注册 /dsh-usage 路由
lib/client.js # Client half：状态栏 chip（__ModuleLoader__ bundle）
License
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-plugin-usage-dashboard for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:hnmrxz/dsh-plugin-usage-dashboardHeadless (CLI) profile:
dsh plugin --profile headless add github:hnmrxz/dsh-plugin-usage-dashboardTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Give the agent a memory, a knowledge base, or a retrieval layer so it stops forgetting context between sessions.
Who it's for
Users running long projects who want the agent to remember decisions, docs, and preferences without re-explaining.
For developers — extending it
The memory/retrieval backend is the seam — plug a new store, tune what gets distilled, or add citation and audit trails.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-plugin-usage-dashboard/)<a href="https://dshbase.com/plugins/dsh-plugin-usage-dashboard/"><img src="https://dshbase.com/badges/dsh-plugin-usage-dashboard.svg" alt="dshbase install-tested"></a>