前言¶
在 DeepSeek Harness（DSH）里跑长对话或流式输出时，开发者往往要同时关心几件事：当前输出有多快、这一轮和今天各用了多少 Token、缓存有没有帮上忙、大致要花多少钱。若只靠分散的日志或另装计费插件，要么信息不全，要么依赖链变长。下面介绍的 dsh-token-gauge（社区目录名 liumiaozhi/dsh-token-gauge）是面向 DSH Web 的客户端插件，用老式车机风格的仪表把 Token 速度、会话与今日用量、参考金额和缓存命中率收进侧边栏，且自带 Host 半边从本地会话日志聚合数据，不依赖任何计费插件。
这是什么¶
dsh-token-gauge（显示名：费用仪表盘 / Token Gauge）由维护者 liumiaozhi 发布，分类为客户端，在 SkillHub 插件目录 与 GitHub 仓库 均可找到。当前 npm 包版本为 1.1.1，许可证 MIT。
插件解决的核心问题是：在 DSH Web 侧边栏用可读性高的仪表 UI 展示 Token 用量与参考计费，数据来自 DSH 的 sessionPersistence 与会话中的 usage 字段，而不是伪造演示样本。
核心功能¶
两种布局¶
- 单表：左侧 Token 速度表，右侧当前会话 / 今日 Token 与金额，底部缓存命中率进度条。
- 双表：上方左侧 Token 速度、右侧缓存命中率；下方并列当前会话与今日的 Token 量、金额。
四种皮肤¶
古典（老式车机琥珀色）、马卡龙、极简、星空。结构与皮肤可自由组合，共 8 种呈现。
指标与刷新¶
- Token 速度：读取当前会话流式输出增量，指针在 0–500 token/秒 间平滑摆动。
- Token 显示口径：统一以 k（千 token） 显示，保留两位小数并带千分位，例如
15,098.77k。 - 缓存命中率表盘：量程 70–100%，刻度 70 / 85 / 100；低于 70% 时指针停在 70%，中央数字仍显示真实值。
- 会话与今日数据：约每 1.5 秒刷新；金额按 DeepSeek Flash / Pro 列表价与峰谷时段估算，为参考值，不是官方账单。
设置与主题¶
卡片右上角滑杆图标打开设置；结构、皮肤选择后立即生效并写入 localStorage，刷新后保留。颜色来自 DSH 主题令牌，深浅色均可读；不引入图表库、不请求外部 CDN。
Host 与 API¶
插件自带 Host 半边，注册 /api/token-gauge/usage-stats，从 sessionPersistence 读取本地会话日志并聚合用量。以 slot 优先级覆盖原计费卡片位置，但不需要安装计费插件本身。
安装与启用¶
面向 DSH Web（platform: web），engines.dsh 声明为 >=0.2.0-rc.1 <0.3.0-0；不兼容的运行时会在安装阶段被 DSH 拦截并提示。
官方按包名安装：
dsh plugin --profile web add dsh-token-gauge
若 npm 上的包仍为旧版，可先从源码用 link 方式安装（README 说明发布 1.1.0 后可直接按名称安装）：
git clone https://github.com/liumiaozhi/dsh-token-gauge.git
dsh plugin --profile web add "link:<本仓库绝对路径>"
安装后重启或硬刷新 DSH Web，侧边栏底部会出现「费用仪表盘」。
典型用法¶
- 点击卡片右上角滑杆图标打开设置。
- 在「结构」中选择 单表 或 双表。
- 在四种皮肤中选择 古典 / 马卡龙 / 极简 / 星空。
- 开始对话后，Token 速度表随流式输出更新；会话与今日数据按上述间隔刷新。
开发时可在克隆仓库后执行：
dsh plugin --profile web add "link:$PWD"
修改 client.js 后，DSH Client HMR 会在文件变化后重新加载；无热更新时刷新页面即可。本插件为手写 Client bundle，无额外构建步骤。
数据口径（摘要）¶
| 指标 | 来源 / 口径 |
|---|---|
| Token 速度 | 当前会话 assistant/live-chunk 文本 / reasoning / tool-call 增量估算 |
| 当前会话 Token | 当前会话所有轮次 input + output |
| 今日 Token | 插件 byDay 中今天的 input + output |
| 当前会话 / 今日金额 | 成功模型调用按单价估算；Flash / Pro 用官方列表价，峰谷与周末规则见 README |
| 缓存命中率 | 今日 cacheHit / (cacheHit + cacheMiss) |
搜索调用按 0.02 元/次估算；其他模型在 README 中有回退规则。
适用场景与注意¶
适合谁：在 DSH Web 上日常对话、需要一眼看到 Token 速度与当日消耗、又不想单独堆计费插件链的开发者。
兼容与限制（来自 README）：
- 需要
@deepseek-ai/dsh-client-ui-sidebar与@deepseek-ai/dsh-client-ui-session。 - Host 依赖 DSH 自带的
sessionPersistence与webServer。 - Node 引擎要求
>=22.19.0。
安全与信任：DSH 生态是「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。插件在当前 dsh 进程权限下运行，安装前请自行查看 源码与 MIT 许可证。
结尾¶
经过上面的步骤，你可以在侧边栏用 8 种布局与皮肤组合，实时看 Token 速度与缓存命中，并对会话、今日用量有统一 k 口径的参考。进一步细节见仓库 README 与 RELEASING.md。
- 目录页：https://www.skillhub.cn/plugins/liumiaozhi/dsh-token-gauge
- GitHub：https://github.com/liumiaozhi/dsh-token-gauge
