dsh-token-gauge

dsh-token-gauge · 费用仪表盘

一个给 DeepSeek Harness（DSH） 用的侧边栏 Token 费用仪表盘。用老式车机 / 马卡龙 / 极简 / 星空四种皮肤，把 Token 输出速度、当前会话与今日消耗、缓存命中率做成一眼能读懂的仪表。

界面预览使用示例数据；实际数据来自 DSH 本地会话与计费插件聚合，不伪造样本。

特性

• 两种结构
  • 单表：左侧 Token 速度仪表盘，右侧当前会话 / 今日 Token 与金额，底部缓存命中率进度条。
  • 双表：上方左侧 Token 速度、右侧缓存命中率两个仪表盘；下方并列展示当前会话与今日的 Token 量、金额。
• 四种皮肤：古典（老式车机琥珀色）、马卡龙、极简、星空。结构 × 皮肤可自由组合，共 8 种呈现。
• 实时 Token 速度：读取当前会话的流式输出增量，指针在 0–500 token/秒之间平滑摆动。
• 缓存命中率表盘：量程 70–100%，刻度 70 / 85 / 100；低于 70% 时指针停在 70%，中央数字仍显示真实值。
• Token 口径：统一以 k（千 token） 显示，保留两位小数并带千分位，例如 15,098.77k。
• 设置入口：卡片右上角滑杆图标；选择结构与皮肤后立即生效，并写入 localStorage，刷新后保留。
• 主题自适应：颜色来自 DSH 主题令牌，深浅色模式均可读；不引入图表库、不请求外部 CDN。

安装

本插件自带 Host 半边，直接从 DSH 的 sessionPersistence 读取本地会话日志并聚合用量，不依赖任何计费插件。

dsh plugin --profile web add dsh-token-gauge

从源码安装（本仓库当前版本）：

git clone https://github.com/liumiaozhi/dsh-token-gauge.git
dsh plugin --profile web add "link:<本仓库绝对路径>"

npm 上的 dsh-token-gauge 若仍为旧版，请先用源码安装；发布 1.1.0 后可直接按名称安装。

安装后重启或硬刷新 DSH Web，侧边栏底部会出现「费用仪表盘」。插件以 slot 优先级覆盖原计费卡片，但不需要计费插件本身。

使用

1. 点击卡片右上角的滑杆图标打开设置。
2. 在「结构」中选择 单表 / 双表。
3. 在下方四种皮肤中选择 古典 / 马卡龙 / 极简 / 星空。
4. 开始对话，Token 速度表会随流式输出更新；会话与今日数据每 1.5 秒刷新。

数据与口径

指标	来源 / 口径
Token 速度	当前会话 assistant/live-chunk 文本 / reasoning / tool-call 增量估算，0–500 token/秒
当前会话 Token	当前会话所有轮次的 input + output
今日 Token	本插件 byDay 中今天的 input + output
当前会话金额	当前会话所有成功模型调用按单价估算
今日金额	本插件按 DeepSeek Flash / Pro 列表价与峰谷时段估算的今日费用
缓存命中率	今日 cacheHit / (cacheHit + cacheMiss)，仪表盘量程 70–100%

Host 半边读取 DSH 的 sessionPersistence 会话日志，按 assistant/message.usage 聚合；搜索调用按 0.02 元/次估算。DeepSeek Flash（2 / 0.04 / 8 元每百万 token）与 Pro（9 / 0.3 / 27）使用官方列表价，工作日高峰外与周末按半价；其他模型回退到 Flash 价格估算。金额是参考值，不是官方账单。

目录结构

dsh-token-gauge/
├── package.json          # DSH bundle + Client 声明
├── cordis.patch.yml      # 插入 token-gauge 行
├── index.js              # Host 半边：注册 /api/token-gauge/usage-stats
├── usage-server.js       # 会话日志聚合 + DeepSeek 峰谷计价
├── client.js             # Client 半边：仪表盘 / 设置 / 样式
├── locale/
│   ├── zh.json           # 插件市场中文标题与描述
│   └── en.json
├── icon.svg              # 插件图标
├── screenshots/          # README 预览图
└── README.md / README.en.md / LICENSE

开发

git clone https://github.com/liumiaozhi/dsh-token-gauge.git
cd dsh-token-gauge
# 本插件是手写 Client bundle，无构建步骤
dsh plugin --profile web add "link:$PWD"

修改 client.js 后，DSH 的 Client HMR 会在文件变化后重新加载模块；没有热更新时刷新页面即可。

发布流程（版本号规则、自检清单、NPM_TOKEN 配置、回滚与常见故障）见 RELEASING.md。推送 v* 标签会触发 .github/workflows/release.yml 自动发布到 npm 并创建 GitHub Release。

兼容与限制

• 面向 DSH Web（platform: web），需要 @deepseek-ai/dsh-client-ui-sidebar 与 @deepseek-ai/dsh-client-ui-session。
• Host 半边依赖 DSH 自带的 sessionPersistence 与 webServer 服务；不需要计费插件。
• 缓存命中率低于 70% 时指针停在 70% 刻度，中央数字保留真实值，避免表盘外推。
• README 图片为按实际组件样式生成的示例预览，数据为演示值。

更新日志

1.1.1

• 修复在 DSH 0.2.x 上无法启动：Client bundle 的注册 id 由 dsh-cost-dashboard 改为包名 dsh-token-gauge。加载器按包名匹配模块工厂，旧 id 不被识别，该行会被判定缺失并重新拉取 bundle，导致同一个 bundle 执行两次并抛出 duplicate factory registration，最终表现为 web boot: 1 entry did not activate / dsh-token-gauge: import failed。
• 新增 engines.dsh 与 dsh.compatibility 声明，限定 DSH >=0.2.0-rc.1 <0.3.0-0。不兼容的运行时会在安装阶段被 DSH 拦下并给出明确提示，而不是等到启动失败才暴露。

许可

MIT © 2026 liumiaozhi