dsh-quota-dashboard

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 打造的可拖拽额度/费用面板。一张悬浮卡片整合 OpenRouter 与 DeepSeek 的余额与花费——数据来自官方 API 加本地会话日志计价引擎。

功能

数据	OpenRouter	DeepSeek
余额（真实剩余）	✅ 官方 /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：

方式二：从源码安装（开发/贡献）

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

配置（可选）

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

凭据	用途
OPENROUTER_API_KEY	OpenRouter 余额/用量（Settings → Models 页面设置）
DEEPSEEK_API_KEY	DeepSeek 余额
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。

---

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

Data	OpenRouter	DeepSeek
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:

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:

Credential	Purpose
OPENROUTER_API_KEY	OpenRouter balance/usage (Settings → Models page)
DEEPSEEK_API_KEY	DeepSeek 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.credentials — never 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.