DeepSeek Harness plugin

dsh-quota-dashboard

Draggable quota/cost dashboard for the dsh web GUI: combines OpenRouter and DeepSeek balances and spend (official APIs + local ledger) in one movable card.

Jump to install

Source facts

Repository
wangyong1972/dsh-quota-dashboard
Latest update
Aug 16, 2026
Category
Models & Providers
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and 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 review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/wangyong1972/dsh-quota-dashboard
Plugin: dsh-quota-dashboard
Author: wangyong1972

Check the source files

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

File explorer3 files
README.mdSource · read only

dsh-quota-dashboard

[English](#english) | [中文](#中文)

A draggable quota & cost dashboard for the DeepSeek Harness (dsh) Web GUI. One floating card combines OpenRouter and DeepSeek balances and spend — from official APIs plus a local session-log pricing engine.

---

中文

一个为 DeepSeek Harness(dsh)Web GUI 打造的可拖拽额度/费用面板。一张悬浮卡片整合 OpenRouterDeepSeek 的余额与花费——数据来自官方 API 加本地会话日志计价引擎。

功能

数据OpenRouterDeepSeek
余额(真实剩余)✅ 官方 /credits✅ 官方 /user/balance
赠送额度✅ granted / topped-up
当前对话费用✅ 会话日志回放✅ 会话日志回放
今日 / 本周 / 本月✅ 官方 /auth/key✅ 今日:官方(平台 token)或回放
过去 1 小时✅ 本地记账✅ 回放

其他特性:

  • 可拖拽:按住卡片拖到任意位置,位置自动记住(localStorage)
  • 点击展开/收起 详情面板
  • 中英双语:跟随浏览器语言,面板内一键切换(持久化)
  • 色盲友好配色:区分信息不单靠颜色
  • 自动刷新(60s)+ 手动刷新按钮
  • API key 永不出机器:浏览器只访问本地路由 GET /api/quota-dashboard,密钥由宿主 credentials 服务解析

安装

方式一:npm(推荐,一行安装)

dsh plugin --profile web add @wangyong1972/dsh-quota-dashboard
# 重启 dsh web(bundle 层启动时加载),然后硬刷新浏览器(Cmd+Shift+R)

已发布到 npm:![npm](https://www.npmjs.com/package/@wangyong1972/dsh-quota-dashboard)

方式二:从源码安装(开发/贡献)

git clone https://github.com/wangyong1972/dsh-quota-dashboard
dsh plugin --profile web add /path/to/dsh-quota-dashboard

配置(可选)

插件的 key 复用 DSH 已有的 credentials:

凭据用途
OPENROUTER_API_KEYOpenRouter 余额/用量(Settings → Models 页面设置)
DEEPSEEK_API_KEYDeepSeek 余额
DEEPSEEK_PLATFORM_TOKEN(可选)解锁 DeepSeek 官方「今日」用量(与控制台一致)。获取:登录 https://platform.deepseek.com → DevTools → Console → JSON.parse(localStorage.getItem('userToken')).value → 加入 ~/.dsh/.credentials.yaml

未配置 DEEPSEEK_PLATFORM_TOKEN 时,「今日」自动回放本地会话日志(准确,包含安装前历史)。

数据来源

  • 余额 / 赠送 / 日周月:官方 API(实时)
  • 当前对话 / 今日 / 1h:回放会话日志 × 官方价格引擎(OpenRouter 用 /models 价格表,DeepSeek 用官方定价)
  • 本地 ledger$DSH_HOME/storages/quota-dashboard-ledger.jsonl(记账最近 7 天)

隐私

  • API key 只存在于宿主进程,通过 ctx.credentials 解析,不发送到浏览器
  • 无遥测、无外部上报
  • 价格表与官方 API 端点均为公开数据

许可

MIT。lib/pricing.js 移植自 dsh-web-billing(MIT),见 [LICENSE](LICENSE)。

---

English

A draggable quota & cost dashboard for the DeepSeek Harness (dsh) Web GUI. One floating card combines OpenRouter and DeepSeek balances and spend — from official APIs plus a local session-log pricing engine.

Features

DataOpenRouterDeepSeek
Balance (real remaining)✅ official /credits✅ official /user/balance
Granted credit✅ granted / topped-up
This-chat cost✅ session-log replay✅ session-log replay
Today / Week / Month✅ official /auth/key✅ Today: official (platform token) or replay
Last hour✅ local ledger✅ replay

Also:

  • Draggable — grab and move anywhere; position persists (localStorage)
  • Click to expand/collapse the detail panel
  • i18n (zh/en) — follows browser locale, one-click toggle in the panel (persisted)
  • Colorblind-safe palette — never relies on color alone
  • Auto-refresh (60s) + manual refresh button
  • API keys never leave the machine — the browser only talks to the local route GET /api/quota-dashboard; secrets resolve via the host credentials service

Install

Option 1: npm (recommended, one line)

dsh plugin --profile web add @wangyong1972/dsh-quota-dashboard
# restart `dsh web` (bundle layers load at boot), then hard-refresh (Cmd+Shift+R)

Published on npm: ![npm](https://www.npmjs.com/package/@wangyong1972/dsh-quota-dashboard)

Option 2: from source (development / contributions)

git clone https://github.com/wangyong1972/dsh-quota-dashboard
dsh plugin --profile web add /path/to/dsh-quota-dashboard

Configuration (optional)

Keys reuse the harness credentials:

CredentialPurpose
OPENROUTER_API_KEYOpenRouter balance/usage (Settings → Models page)
DEEPSEEK_API_KEYDeepSeek balance
DEEPSEEK_PLATFORM_TOKEN (optional)Unlocks the official DeepSeek "today" usage (same data as the platform console). Get it: log in to https://platform.deepseek.com → DevTools → Console → JSON.parse(localStorage.getItem('userToken')).value → add to ~/.dsh/.credentials.yaml

Without DEEPSEEK_PLATFORM_TOKEN, "today" falls back to replaying local session logs (accurate, includes pre-install history).

Data sources

  • Balances / granted / daily-weekly-monthly: official APIs (live)
  • This chat / today / last hour: session-log replay × official price engines (OpenRouter /models table, DeepSeek official pricing)
  • Local ledger: $DSH_HOME/storages/quota-dashboard-ledger.jsonl (7-day retention)

Privacy

  • API keys live only in the host process, resolved via ctx.credentialsnever sent to the browser
  • No telemetry, no external reporting
  • Price tables and official API endpoints are public data

License

MIT. lib/pricing.js is ported from dsh-web-billing (MIT); see [LICENSE](LICENSE).