dsh-usage-dashboard

一个给 DeepSeek Harness（DSH）Web GUI 用的额度与用量仪表盘插件，以 DSH 插件包（bundle） 的形式安装。

它把 DeepSeek 账户余额和 DSH 里的 token 用量汇总到一起，做成两个界面：

• 右下角一个可拖动的悬浮额度窗（实时余额）。
• 顶部栏「对话 / 轨迹」旁的一个 「额度」view tab（完整仪表盘）。

功能

悬浮额度窗（右下角）

• 显示当前账户余额（总余额 / 赠送额度 / 充值额度）。
• 可拖动，松手自动吸附到主区域（不含侧边栏、不遮顶栏）四个角落。
• 可收起/展开，60 秒自动刷新。

「额度」仪表盘 tab

• 账户余额：总余额、赠送额度、充值额度、可用状态。
• 官方平台跳转：查看额度/用量、生成 API Key、服务状态。
• 用量统计：累计 tokens、消耗费用（估算）、输入/输出/缓存命中、模型调用次数。
• 逐天用量柱状图：近 30 天。
• 逐小时用量柱状图：按 0–23 点分布。
• 每日用量热力图：近 12 周。
• 悬浮窗开关：控制右下角悬浮窗是否展示。

工作原理

数据	来源
账户余额	DeepSeek API GET /user/balance（通过 credentials 服务读取 DEEPSEEK_API_KEY）
token 用量	遍历 DSH 会话日志（sessionPersistence），聚合每个 assistant/message 事件的 usage
消耗费用	按 deepseek-v4-pro 单价估算（见 src/usage.ts 里的 PRICE_*_PER_M 常量）

Host 半注册了自己的带信任校验的 JSON API（/api/dsh-usage-dashboard/balance、/api/dsh-usage-dashboard/usage），Client 半用同源 fetch 调用它并渲染 UI。

安装 / 使用

这是标准 DSH 插件包（bundle + client 双面包），通过 dsh plugin 安装：

# 本地 checkout 安装
dsh plugin --profile web add ./path/to/dsh-usage-dashboard

# 或从 GitHub 安装（git 依赖会执行 prepare 脚本构建）
dsh plugin --profile web add github:Cassius0924/dsh-usage-dashboard

然后重启 dsh（dsh --profile web）生效。

• 前提：已配置 DEEPSEEK_API_KEY（在「设置 → 模型」里填写，或放在 $DSH_HOME/.credentials.yaml）。
• 前提：本机需要 pnpm（dsh plugin 是 pnpm 的转发器）。

开发 / 构建

pnpm install    # 安装 devDependencies
pnpm run build  # esbuild 构建 lib/index.js（host）+ lib/client.js（client bundle），再 tsc 出类型
pnpm run typecheck