npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@sixzjd/dsh-usage-dashboard

v0.6.8

Published

Usage statistics for DeepSeek Harness: daily token usage, request count, cache hit rate and estimated cost as a native settings section, with durable history that survives deleted sessions.

Downloads

1,753

Readme

dsh-usage-dashboard

Awesome DSH Plugin npm version npm downloads license: MIT DeepSeek Harness 的本地用量统计插件:在设置 → 用量统计里查看 token 消耗、请求数、缓存命中率与按天趋势。

数据全部来自本机会话日志,不联网、不上传、不需要任何 API Key。

背景

DSH 自带每轮对话的 token 明细,但没有跨会话的汇总视图。社区里 cc-switch 这类外部工具能做,代价是要额外装一个桌面应用、并且靠解析日志文件来猜格式。

这个插件解决同一件事,但完全跑在 DSH 内部:宿主已经提供了公开的 sessionQuery 服务,会话日志的解压、排序与中断轮次平衡都由它负责,插件只消费结构化的事件。因此没有文件解析、没有格式猜测,也不会因为 DSH 升级改了日志布局而失效。

原理

durable session log
      │  ctx.sessionQuery.listSessions() / readSession()
      ▼
  事件流(已解压、已排序)
      │  assistant/message.usage  ▸ 覆盖同轮的 assistant/chunk
      │  request/header / request/context  ▸ 模型与供应商标识
      ▼
  按 (session, turn, step) 折叠成"一次调用"
      │  本地日历日分桶
      ▼
  日聚合 / 模型聚合 / 区间汇总 + 价格表计价
      │  GET /api/dsh-usage-dashboard/summary
      ▼
  设置页原生分区(settings.section slot)

一次调用只计一份用量:assistant/message 上的最终 usage 会替换同一 turn:step 的流式 assistant/chunk,而不是相加;全零的重放事件也不会覆盖已记录的真实数字。

删除的会话仍计入历史

数据源 sessionQuery 只能列出磁盘上还存在的会话日志。如果直接用它做统计,删掉一个对话,它花过的 token 就会从合计里凭空消失 —— 数字不会报错,只是安静地变小。

所以插件把每次扫描到的调用用量另存一份(storages/dsh_usage_dashboard_history.json)。历史行的优先级低于活日志:先载入历史、再折叠磁盘日志,所以还存在的会话永远以日志为准,删掉的会话继续按存档计入。

对在本功能上线之前就已删除的会话,插件会从宿主的会话投影缓存(session_projcache)里一次性回填 tokenUsage 总量。

口径限制:tokenUsage 每个会话只有一个总量,没有按天、按模型拆分。回填行只能锚定在会话创建时间,所以历史部分的总量准确,但它在按天图上的位置是近似的。

指标口径

token 桶遵循宿主 @deepseek-ai/dsh-llm 声明的 DISJOINT 语义:inputTokens 只含未命中缓存的输入,缓存部分单列在 cacheReadTokens / cacheWriteTokens。

| 指标 | 计算方式 | |---|---| | 消耗 token | 输入 + 输出 + 缓存写 + 缓存读 | | 总请求数 | 携带 usage 的调用次数(按 session:turn:step 去重) | | 缓存命中率 | 缓存读 ÷ (输入 + 缓存写 + 缓存读) |

注意:OpenAI 式协议不上报 cacheWriteTokens,此时该项恒为 0,命中率仍然正确(分母同样不含它)。这不是统计缺失,是上游没有这个字段。

功能

| 位置 | 内容 | |---|---| | 顶部三张卡 | 消耗 token / 总请求数 / 缓存命中率,点击展开该指标的构成明细 | | 使用趋势 | 柱状图,可切 Tokens / 请求;数值悬浮或键盘聚焦时显示,不常驻。默认按天,选今天(或起止同一天的自定义区间)自动切成按小时 | | 筛选 | 供应商、模型、时间范围(今天 / 近 7 / 30 / 90 天 / 全部时间 / 自定义起止),打开时默认近 30 天 | | 请求明细 | 逐次调用的时间、供应商、模型、token、费用 | | 供应商 / 模型 | 分组聚合与占比 | | 定价 | 可编辑价格表,按 USD / 百万 token 计四桶价格 |

趋势图的 X 轴按日历日补齐,没有数据的日期显示为 0 而不是跳过 —— 否则"闲置两周后爆发一天"会被画成"长期低用量带个尖峰"。按小时视图同理:24 个时段一个不少,安静的凌晨 3 点也占一格。

「全部时间」的起点是实际最早一条记录,不是某个固定天数;没有任何记录时退化为「今天」,但视图仍按天,不会把空历史画成 24 个小时柱。

标题下会标出这组数字的抓取时刻(· 数据更新于 15:27:45)。一次响应里所有表恒定自洽(供应商的请求数 === 它各模型请求数之和),所以两张表数字不同只可能是两次抓取之间用量又涨了 —— 时间戳就是用来分辨这一点的。面板不自动刷新,数字只在你改筛选或点「刷新」时更新。

安装

dsh plugin --profile web add @sixzjd/dsh-usage-dashboard

装好后可在 设置 → 插件 页直接检查并更新版本,无需再手敲命令。若想装 GitHub 上的开发版:

dsh plugin --profile web add github:sixzjd/dsh-usage-dashboard

安装后刷新浏览器页面即可。插件挂载在设置页的 settings.section 插槽,入口为「用量统计」(英文界面下为 Usage Statistics)。

卸载

dsh plugin --profile web remove @sixzjd/dsh-usage-dashboard

内置价格

预置 DeepSeek 官方峰谷价(含中国法定节假日全天按谷价),数据以插件内常量形式随版本发布,来源为官方公告:

| 模型 | 谷时 in / out / 缓存读 | 峰时 in / out / 缓存读 | |---|---|---| | deepseek-v4-flash | 0.15 / 0.6 / 0.003 | 0.44 / 1.32 / 0.014 | | deepseek-v4-pro | 0.66 / 1.98 / 0.022 | 1.32 / 3.96 / 0.044 |

单位均为 USD / 百万 token。峰时段为 UTC 01:00–04:00 与 06:00–10:00(北京时间 09:00–12:00、14:00–18:00)的周一至周五,法定节假日除外。

没有公开单价的模型一律标为「未计价」,不会套用任何猜测价格。 你可以在「定价」里手工补价。

开发

client.js            浏览器半区(设置页面板)
lib/index.js         宿主半区入口
lib/plugin.js        扫描、聚合调度、持久化与 HTTP 路由
lib/aggregate.js     事件折叠与日/模型分桶
lib/catalog.js       读取路由别名缓存,解析真实模型名(失败即关闭)
lib/pricing.js       价格表与峰谷判定
locale/{en,zh}.json  插件页显示名(en.json 必须存在,否则 zh.json 不被读取)
test/                node:test 套件,无第三方依赖
npm test     # 全部离线,无需依赖
npm run check

模型显示名

部分供应商用路由别名暴露模型,而不是真实模型名。日志里记的是路由键 ({provider:"…", model:"qfmodel"}),而路由背后的实际模型可能是 Qwen3.8-Flash。 这个键会原样回传给上游,不能在源头替换掉,真实名字只存在于对应供应商插件自己的模型发现缓存里。

面板会读取这些缓存,把路由别名显示为真实模型名。

不针对任何特定插件。 没有公开的接缝能表达「这个路由键背后是谁」,所以唯一的来源就是供应商插件 自己发现到的模型表。这些插件在存储位置上各不相同,但都有一个共同点:目录里是含 {id, name} 行的 JSON。因此这里按目录形态扫描,而不是按插件名硬编码:

  • <profile>/.<任意插件>/state/<文件>
  • <profile>/.<任意插件>/<文件>

只搜以点开头的插件私有目录(普通列举会跳过它们,也不会走进 node_modules),文件还必须通过结构校验 才会被采用,所以放宽扫描范围不会引入错误的名字。当前环境实测覆盖三类供应商插件、共 97 条别名。

只有日志里的 modelId 本身就是别名的模型需要这一步。绝大多数供应商返回的就是真实模型名 (openai/gpt-oss-120b、minimaxai/minimax-m3……),别名表里查不到,面板原样显示。没装某个供应商 插件的人不会看到它那些路由键,因为他本来就不会产生那些调用 —— 少解析几条别名,界面上没有任何变化。

匹配是整串精确匹配(忽略大小写),不匹配命名空间后的尾段。因为别名表里没有 provider 字段, vendor/foo 若按尾段命中某家的 foo,就会把别家的模型标成这家的名字 —— 界面上标错比不标更糟。 两个账号的缓存对同一路由键给出不同名字、且新鲜度相同,该别名被丢弃。

这仅影响显示。 分组、计数、筛选与计价一律仍按路由 id 进行,所以:

  • 贴标签不会把某次调用挪到另一行,也不会改变任何统计数字
  • 两个账号的缓存对同一别名给出不同名字时,该别名被丢弃(宁可显示路由 id,也不显示错的模型名)
  • 缓存缺失、格式变更或不可读时静默退回路由 id:界面上不提示,看到的就只是 qfmodel 这类路由键。要确认是否生效,查 GET /api/dsh-usage-dashboard/summary 响应里的 catalog.aliasCount,为 0 即表示没解析到任何别名

依赖的接缝

| 接缝 | 用途 | |---|---| | ctx.sessionQuery | 列出会话、读取已解压的事件流 | | ctx.storage (json backend, kv) | 持久化价格表到 $DSH_HOME/storages | | ctx.webServer | 注册 /api/dsh-usage-dashboard/* | | ctx.timer | 定时对账与实时去抖 | | settings.section slot | 挂载设置页分区 | | @deepseek-ai/dsh-client-ui-primitives 的 Modal | 指标详情浮层(缺失时降级为自绘浮层) |

一处公开接缝之外的读取

本插件不读 $DSH_HOME/sessions(会话日志全部经 ctx.sessionQuery), 但为了上面的模型显示名,它会读取供应商插件自己的模型发现缓存:

$DSH_HOME/profiles/<profile>/.<任意供应商插件>/state/*-catalog.json
$DSH_HOME/profiles/<profile>/.<任意供应商插件>/*-catalog.json

这是另一个插件的私有文件,不是公开契约 —— 路径、JSON 结构与分账号的格式都可能随对方版本改变。 取舍是:不读它就只能在界面上永远显示 qfmodel 这类无语义的路由键。

因此该读取被写成失败即关闭,并按目录形态而非插件名发现:

  • 只搜以点开头的插件私有目录,且只看文件名以 -catalog.json 结尾者;同目录下的探针、心跳等 JSON(含 pid 之类字段)不会被当成目录
  • 结构校验接受两种已知布局:顶层 {models:[…]},或按账号嵌套的 {entries:{…models:[…]}};不匹配的文件一律不采用
  • 只提取 {id, name} 两个字段,分账号的键(如 pat:<hash>)不进入任何响应(有测试钉住这一点)
  • 任何一步失败都退回原路由键,不抛错、不猜测、不影响其余统计
  • 若上游改了格式,最坏结果是名字回到路由键,统计数字不受牵连

安全边界

  • 两个 HTTP 路由都要求回环地址:socket 对端与 Host 头必须都是 loopback,Sec-Fetch-Site: cross-site 直接拒绝,防止 DNS rebinding。
  • 写接口(保存价格)额外要求进程令牌,由 GET /pricing 下发,跨源页面读不到。
  • 响应只含用量数字、模型标识与会话 ID(UUID)。不包含提示词、回复正文、会话标题、工作区路径,也不包含上文的账号标识符。
  • 唯一的文件读取是上面那处 catalog 缓存;不写入该文件,也不读取同目录其它文件。

已知限制

  • 成本是估算值,按内置/手工价格表计算,不等于供应商账单。缓存读写与推理的口径取决于上游是否上报。
  • 按配额计费的路由,token 单价不等于你实际支付的钱。 有些供应商按 credits/次数计费而不是按 token(其模型表里会带一个倍率,例如 x0.5)。对这类路由套用公开的 USD 单价得到的是"等价 API 价";本插件因此只做名称解析,不会自动为这类路由填价,需要时请自行在「定价」页填写你的实际费率。
  • 上游请求被中断时可能只有 assistant/chunk 的 usage 而没有最终 assistant/message;此时保留 chunk 用量。若上游完全没有任何 usage 事件,则无法从回复内容精确还原 token 数。
  • 缺少 request/header / request/context 的会话,模型标识显示为 unknown,不会从供应商标名猜测模型。
  • 模型显示名依赖供应商插件的私有缓存格式(见上文)。这是另一个插件的内部实现,不是公开契约,对方变更需跟进适配;读取被写成失败即关闭,最坏结果是名字回到路由键,统计数字不受影响。
  • 面板正文目前为中文,仅设置页侧栏标签跟随浏览器语言。
  • 统计覆盖宿主列出的全部会话,不限于已注册工作区。

许可

MIT