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

@cassius0924/dsh-usage-dashboard

v0.9.2

Published

DeepSeek 额度与用量仪表盘 —— DSH (DeepSeek Harness) Web 插件:余额还能撑几天、今日/本月花了多少、哪个模型和哪个会话最贵、图片/多模态用量、缓存省了多少、高峰挪到闲时能省多少

Readme

dsh-usage-dashboard

npm license

在 DSH(DeepSeek Harness)的 Web GUI 里,随时看得见 DeepSeek 的钱花在哪: 余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少、钱里有多少来自图片,以及峰谷定价生效后把任务挪到闲时能省多少。

dsh-usage-dashboard

装上之后 GUI 里多两样东西:右下角一个可拖动的悬浮额度窗,顶部栏多一个**「额度」tab**。 还能在「额度 → 设置」里加一个侧边栏额度入口(顶部或底部,点开账号级额度页)、拖动调整「额度」tab 的位置。 额度页会收起聊天输入框,把整屏留给数据;「图片 / 多模态用量」并入用量趋势卡,切换 7 天 / 30 天 / 90 天 / 1 年 时随图片有无平滑展开或收起。界面支持简体中文与 English,直接跟随 DSH 全局的「Settings → Language」设置; 切换无需刷新,选择由 DSH 持久化。


为什么需要它

用 DSH 跑 agent,钱是一点一点漏掉的,而 DSH 自己不会告诉你:

| 你真正想知道的 | 装之前 | |---|---| | 余额还能用几天? | 只有一个余额数字 | | 今天花了多少?这个月呢? | 只有「累计」,没有时间感 | | 钱花在哪个模型上? | 不知道 | | 缓存到底帮我省了多少? | 完全看不到 | | 钱里有多少来自图片? | 多模态模型上线后更是看不见 | | 高峰时段多付了多少? | 只能自己算 |

这个插件把这些问题逐个翻译成一眼能看懂的数字。费用全部为估算,算法与单价公开可查(见费用是怎么算的)。


悬浮额度窗

常驻右下角,不打断你干活:

  • 余额 + 今日消耗,一眼就够。
  • 可拖动,松手自动吸附四角;边界避开侧边栏、右侧详情面板、会话顶栏和输入框——不会挡住发送按钮。
  • 可收起成一行;显示/隐藏、所在角落、收起状态都会记住,刷新页面后原样回来。
  • 余额跌破预警线时,状态点和余额数字一起转成警示色。
  • 60 秒自动刷新余额。今日消耗读共享缓存,点 ↻ 同时刷新两者。
  • 插件加载时就把余额和用量预取到缓存里,所以打开「额度」tab 通常是秒开, 不用等那几秒的会话日志重放;预取失败不报错,交给各自挂载时再取。

「额度」仪表盘

余额:还能撑几天

「还剩多少钱」不解决余额焦虑,「还能用几天」才行。按近 7 个自然日(含没用的日子)的日均消耗折算,hover 能看到估算口径;不足 3 天转红。

今日 / 本月花了多少 —— 以及这个数怎么来的

今日、本月、累计三个窗口,今日带「较昨日」、本月带「较上月同期」环比(上月同期而不是上月整月,免得月初总是显得便宜)。

展开计价说明能看到费用估算实际套用的单价表——估算不该是个黑箱。

高峰时段多付了多少

DeepSeek 从 2026-08-17 00:00 起改峰谷定价,高峰(北京时间 09:00–12:00、14:00–18:00)价格是闲时的两倍。

这张卡告诉你用量落在峰谷两侧的比例,以及如果高峰用量都挪到闲时能省多少——批量、可延后的任务放到闲时跑,同样的 token 只要一半的钱。

缓存替你省了多少

前缀缓存的命中价只有未命中价的百分之一量级,是 DSH 这类高重复 prompt 负载上最大的省钱杠杆——上图这份用量实付 ¥50.61,缓存省下了 ¥1,220.87。

命中率掉到 60% 以下时,文案会换成怎么把它救回来的建议。

钱里有多少来自图片

deepseek-v4-flash-vision-exp 上线后,图片按尺寸折算成 token 与文本一并计费,但「看了一堆截图」和「纯文本」在账单里长得一模一样。

这张卡重放会话日志时顺手数出图片:用户消息里的附件和 tool result 里的截图都会统计(不用读附件本体,日志里就有宽高)。每组数字给出图片张数、按官方换算规则估算的 token 与费用,以及占窗口输入 / 费用的比例,旁边是每天图片数的趋势和「图片最多的会话」排行——一个不停刷截图的循环会话,在这里一眼就能认出来。

图片归属到随后一次模型调用,按该调用的时段与模型单价估算;实际 token 数以接口返回的用量为准。

钱花在哪个模型上

按费用降序,带占比条和输入/输出/缓存拆分。模型配色在排行、下拉选择器和图表图例三处一致。

哪个会话最烧钱

按模型、按天的视图告诉你「花在什么上」和「什么时候花的」;这张告诉你是哪一次跑掉的——对 agent 用户来说,这是唯一能直接动手改的东西:一个特别贵的会话,通常意味着一段值得看看的 prompt 或一个没收住的循环。上图里最贵的会话占了近 30 天总花费的 24.4%,前 6 个会话合起来约 65%。

会话标题直接从会话日志里读(session/title 事件),跟用量重放搭同一趟车,不额外读盘。

用量的时间分布

近 30 天逐天、0–23 点逐小时(可按模型多选过滤,叠成分组柱状图);逐天/逐小时切换、周期与指标都在这张卡上。hover 立刻出 tooltip,不用等系统那一秒。

热力图单独成卡,覆盖近一年每一天:一眼看出长期的使用节奏,而不是只看最近几周。

余额预警

在「设置」里定一条预警线(默认 ¥10,填 0 关闭)。跌破时仪表盘顶部出现警示条——带上还能撑几天和充值入口——同时悬浮窗一起转警示色,两边不会各说各话:

余额低于 ¥10、或跌破设置的预警线时,「预计可用」右侧还会出现一个实心的「去充值 ↗」按钮,点开在浏览器新标签页直达 DeepSeek 开放平台的充值页。预警线填 0 只关掉上面的警示条,不会关掉这个入口——余额快到零时,总该有个一键跳出去的地方:


安装

标准 DSH 插件包(bundle + client 双面包),用 dsh plugin 装:

# 从 npm 安装
dsh plugin --profile web add @cassius0924/dsh-usage-dashboard

# 或从 GitHub(git 依赖会跑 prepare 脚本现场构建)
dsh plugin --profile web add github:Cassius0924/dsh-usage-dashboard

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

然后重启 dsh(dsh --profile web)生效。

前提:

  • 余额优先走 DSH 的账号登录(浏览器授权,不需要 API Key);未登录账号时才回退到 DEEPSEEK_API_KEY(「设置 → 模型」里填,或放在 $DSH_HOME/.credentials.yaml)。
  • 本机有 pnpm(dsh plugin 是 pnpm 的转发器)。

装好后打开 GUI,进入任意一个会话(「额度」tab 挂在 conversation.view 上,New Session 首页没有 tab 栏),顶部就能看到 Chat / Trajectory / 额度。

兼容性:同时支持两代宿主接口——旧版 readFrom(id, 0) 与新版 handle 化 open(id, 'read') / read / close。 宿主升级到移除 readFrom 的版本后,插件无需更换版本,会话日志照常重放。

界面语言

跟随 DSH 全局的 Settings → Language,切换即时生效、无需刷新,选择由 DSH 持久化:

  • 简体中文 —— DSH 内置 zh;
  • English —— DSH 内置 en。

插件只提供这两种语言,与宿主内置语言保持一致,不额外注册语言包:语言目录属于宿主的设置面, 插件私自加一门宿主没翻译的语言,会让宿主界面和仪表盘说两种语言(宿主只能回落到简中)。 日期与数字格式化按当前语言取对应的 Intl 标签(zh-CN / en-US),不随浏览器区域设置漂移。

费用是怎么算的

费用是估算,不是账单。规则都在 src/pricing.ts 一个文件里:

  • 逐条用量记录按「模型 + 是否落在高峰时段 + 当时的价目表」计价,而不是全局一套价。
  • 2026-08-17 00:00(北京时间)之前按旧的固定价;之后按峰谷价,闲时为高峰的一半。
  • 2026-09-10 12:00 起 Flash 系列降价(V4.1-Flash),高峰时段同时收紧为周一至周五。
  • 2026-09-14 12:00 起 deepseek-v4-pro 的请求由 V4.1-Flash 承接,按 Flash 价计费。
  • 高峰时段按北京时间判定,不随机器时区漂移。
  • 未识别的模型按 deepseek-v4-pro(较贵的一侧)计价。

单价(CNY / 百万 tokens,与官方价目表的两档一致):

| 模型 | 时段 | 输入·缓存命中 | 输入·未命中 | 输出 | |---|---|---|---|---| | deepseek-flash | 高峰 / 闲时 | 0.04 / 0.02 | 2 / 1 | 8 / 4 | | deepseek-v4-pro | 高峰 / 闲时 | 0.3 / 0.15 | 9 / 4.5 | 27 / 13.5 |

deepseek-v4-flash、deepseek-v4-flash-vision-exp 是旧模型名,现由 deepseek-flash 承接、按 Flash 价计费;2026-09-14 12:00 起 deepseek-v4-pro 的请求也路由到 V4.1-Flash,按 Flash 价计费。历史各时期单价:08-17 前 pro 0.025/3/6、flash 0.02/1/2;08-17 – 09-10 12:00 的 flash 高峰 0.1/3/9、闲时 0.05/1.5/4.5。

图片不另外收费,而是按尺寸折算成 token 与文本一并计费:官方规则是先把图片按比例缩放到 ~800×800(小于 ~384×384 的放大),token 与缩放后面积成正比、每张上限 384 tokens。多模态卡的估算就套这条规则。

DeepSeek 再调价时,只改这张表。

开发 / 构建

pnpm install
pnpm test           # Node 内置测试运行器:计价、缓存、信任围栏与用量聚合
pnpm run build      # esbuild 出 lib/index.js(host)+ lib/client.js(client),再 tsc 出类型
pnpm run typecheck

产物:

  • lib/index.js —— Host 半(ESM,Node),注册 /api/dsh-usage-dashboard/* 路由。
  • lib/client.js —— Client 半(CJS 闭包),通过 window.__ModuleLoader__ 注册进 web 启动图。

改动生效方式不同:只改 src/client/** 时,浏览器硬刷新(Ctrl/Cmd+Shift+R)即可;改了 src/index.ts 等 host 端要重启 dsh。

src/
├── index.ts        # Host 半入口(webServer 路由 + TTL 记忆化)
├── usage.ts        # 余额 + 用量聚合(按天/小时/模型/峰谷分桶)
├── pricing.ts      # 价目表与费用估算(唯一改价的地方)
├── contract.ts     # host ↔ client 的 wire 类型
├── trust-fence.ts  # 浏览器信任校验
└── client/
    ├── index.tsx   # Client 半入口(slots 注册)
    ├── widget.tsx  # 悬浮额度窗
    ├── dashboard.tsx # 「额度」tab
    ├── charts.tsx  # 柱状图 / 热力图 / tooltip
    ├── locales.ts  # 中英文完整词典
    ├── i18n.tsx    # DSH locale 桥接与 Intl 标签映射
    ├── styles.ts   # 全部样式
    ├── api.ts      # fetch + 客户端缓存
    ├── cache.ts    # TTL 缓存(含 localStorage 持久化)
    ├── prefs.ts    # 用户设置持久化
    └── store.ts    # 两个界面共享的设置

样式全部走 DSH 自己的 --dsw-alias-* CSS 变量,跟随宿主主题,不引入独立配色。

已知限制

  • 用量数据来自本机 DSH 会话日志,不含其它机器/账户的用量。
  • 费用是估算:不含 DeepSeek 侧的折扣、赠金消耗顺序等因素,以官方账单为准。
  • 图片 token 按官方换算规则估算,且把图片归属到随后一次模型调用;若缺少图片宽高或图片后没有成功的调用,则不纳入估算(无调用即无计费)。
  • 首次加载用量需要重放全部会话日志(本机实测约 5 秒),因此有 5 分钟的服务端记忆化;界面在此期间显示骨架屏。

License

MIT