dsh-token-metrics

dsh-token-metrics

中文 | [English](README.en.md)

一个 DSH 插件：把经过 DeepSeek Harness 的每一次模型调用都记下来，在侧边栏给你一个

Token 用量统计页，顺带管好成本与供应商余额。

统计

• 今天、近 7 天与全部的 token 总量，以及趋势涨跌
• 各模型、各供应商的用量排行
• 缓存命中率——钱有没有花在重复输入上
• 各项目、各子代理的 token 消耗
• 首字延迟与输出速度——调用快不快，而不只是花了多少
• 活动热力图：一年里哪天用得多，一眼看出使用节奏
• 悬浮用量窗：跨页面常驻，显示所选供应商的今日 Token / 花费与余额或订阅主窗口；展开时自动避让正文，不挡内容

成本

• 按模型估算实际花费，价格取自 LiteLLM 公开价目表（约 2800 个模型）
• 峰谷计价：DeepSeek 谷时价是峰时的一半，按调用时刻区分，不虚高
• 美元 / 人民币一键切换，汇率实时拉取
• 匹配不到价格的模型明确列出「未定价」并提供补价入口，不静默算成 0
• 预算：设日 / 月预算，全局或按模型分组（一组可含多个模型），实时看已用百分比

订阅额度（OpenCode Go）

• 独立「订阅额度」页签：5h / 周 / 月窗口按模型拆 token、额度消耗与份额，

并给出「每 1% ≈ 多少 token」；档位可切 Go / Plus / Teams

• 单模型额度换算：只看一个模型时，各窗口能跑多少 token（三种极端 +

按最近 30 天实际构成）

• 账本是独立的 10 分钟桶文件，不影响 usage.json 落盘；额度是美元配额

而非 token 配额，缓存读与输出能差两个数量级，页面按模型/构成折算

模型接入

• 35 个服务预设，国内优先排序，选中即填好地址与协议
• 供应商余额与配额：覆盖 Sub2API / new-api / one-api 三类网关与 11 家官方平台
• 从 pi-ai 模型目录（1241 个模型）自动识别上下文、输出上限、思考档位与附件能力
• 一键把供应商与模型写入 DSH 模型配置

提醒

• 余额不足、配额将尽、配额即将重置、查询失败、插件更新，以及峰谷切换前提醒、预算将尽，八类告警推送到右下角

数据来自 DSH 自己的会话日志；只有订阅额度查询会向你配置的订阅站点发请求（可用 quotaSampleMs: 0 关闭自动采样），不上传任何数据。

安装

按包名安装（推荐，走 npm）

在 DSH 的「添加插件」搜索框输入 dsh-token-metrics，或在插件管理里执行：

plugin_manager install_bundle dsh-token-metrics

> 走已发布到 npm 的版本，国际（npm 官方源）与国内（npmmirror 镜像源）都能装。

> DSH 会并行探测两个源、自动选响应更快的一个，无需手动挑：海外用户走官方源，

> 国内用户走镜像源，都覆盖到。

>

> 发布只需推到 npm 官方源，npmmirror 会自动镜像同步（通常几分钟内）。刚发新版

> 若镜像还没跟上，在「添加插件」里把安装源临时切到官方源，或到 npmmirror 搜

> 本包点「同步」。

从 GitHub 安装

不依赖任何 npm 源、或想用尚未发布的最新版时，直接从仓库装：

plugin_manager install_bundle github:hugoyee75-cmyk/dsh-token-metrics

锁定某个版本加 #v0.3.2：

plugin_manager install_bundle github:hugoyee75-cmyk/dsh-token-metrics#v0.3.2

本地开发（link）

改代码即时生效时用本地目录，把 dsh-token-metrics 指到你的仓库：

{
  "dsh": { "profile": { "bundles": ["dsh-token-metrics"] } },
  "dependencies": { "dsh-token-metrics": "link:/path/to/dsh-token-metrics" }
}

装完重启 DSH（或热重载），侧边栏就会出现「Token 用量统计」图标。第一次打开页面，插件会自动回扫历史会话日志，把以前的用量补上。

界面

统计页（深色主题）

顶部是时间范围与模型筛选，中间是九项总计指标，下方是趋势图与模型占比环形图，

再往下是按模型 / 来源 / 项目 / 供应商 / 账号 / 日期切换的明细表。

切换「今日 / 近 7 天 / 全部」时，指标卡、图表、明细表与金额一起联动。

模型接入

「模型接入」页签管理第三方中转站与官方平台：余额、可用模型、订阅额度窗口

与重置倒计时。余额可点击在美元 / 人民币之间切换。

订阅制平台（如智谱 GLM Coding Plan、Kimi Coding Plan）没有「余额」概念，