deepseekplugins

DeepSeek Harness plugin

dsh-token-usage-nigel211

DeepSeek Harness (DSH) token usage & cost statistics plugin: per-model/per-session token accounting with official CNY pricing (peak/off-peak), range filters, multi-provider balance queries, and a

Memory
Jump to install

Source facts

Repository
Nigel211/dsh-token-usage
Latest update
Aug 22, 2026
Category
Memory
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Nigel211/dsh-token-usage
Plugin: dsh-token-usage-nigel211
Author: Nigel211

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-token-usage

DeepSeek Harness (DSH) 的 Token 用量与费用统计插件:零第三方依赖,数据全部派生自 DSH 持久化会话日志,重启自动回填、不丢历史。

  • 用量统计:输入/ 输出 / 缓存命中 tokens,按模型、按会话、按时间范围(今天 / 近7天 / 近14天 / 近30天)聚合。
  • 费用估算:内置 DeepSeek 官方人民币价目表(元/百万 tokens),按生效日期分段计价 —— 8-17 前旧价、8-17 起峰谷价(北京时间 9:00–12:00、14:00–18:00 高峰,谷段半价);价目表可增删改并持久化,未知模型手动加价后立即出费用。
  • 账户余额:按已配置的模型路由自动枚举(DeepSeek 官方 / pi-ai 等),模板化查询 DeepSeek、OpenRouter、SiliconFlow、New-API 等平台的余额,keep-last-good 缓存与瞬时/确定性错误分类;DeepSeek 官方行带「充值」按钮,一键跳转开放平台充值页。
  • 图表:使用趋势(单图四曲线 + 双轴费用)、当月日历活跃热力图、模型占比环图(悬停联动)。
  • 界面:设置 →「Token 用量」现代简洁仪表盘 + 输入框下方常驻读数(本会话 tokens / 费用、今日费用)。

界面速览

仪表盘自上而下:

区块说明
费用 Hero + 指标卡范围内费用估算、调用次数、tokens、输入未命中/输出/缓存命中/推理
账户余额每路由一张卡片,余额/赠送/充值/已用,手动刷新;DeepSeek 官方带充值按钮
使用趋势今天(按小时)/ 近7天 / 近14天 / 近30天;输入(总)/输出/缓存命中/费用 四条曲线,图例可切换显隐,悬停看明细
活跃热力图当月日历网格(周一~周日),蓝色深浅 = 当日 tokens,今天描边、未来虚线淡化,悬停看用量
模型占比环形图按 tokens 汇总各模型占比,悬停分段/图例联动高亮,中心显示总 tokens 或所选模型占比
按模型 / 按会话 / 最近调用三张明细表
价目表内置官方分段价 + 自定义条目增删改、费用显示币种与汇率配置
导出最近 5000 条用量记录 JSON

安装

> ⚠️ 不要使用裸包名安装:npm registry 上已存在另一个同名包(他人发布),dsh plugin --profile web add dsh-token-usage 会从 npm 拉取错误的包。本插件仅发布在 GitHub,请使用下面的 GitHub 源或 tarball 方式。

方式一:命令行(推荐)

从 GitHub 安装(pnpm 的 github: 依赖语法):

dsh plugin --profile web add github:Nigel211/dsh-token-usage

(指定版本:github:Nigel211/dsh-token-usage#v0.1.15)

或本地 tarball:dsh plugin --profile web add ./dsh-token-usage-0.1.15.tgz

装完重启 dsh web 服务后生效。

方式二:手动注册(本地包)

1. 在 $DSH_HOME/profiles/web/package.json 的 dependencies 中添加指向本目录的 link 依赖:

``json "dependencies": { "dsh-token-usage": "link:<本目录绝对路径>" } ``

2. 确认 dsh.profile.bundles 列表包含 dsh-token-usage(安装器会自动 reconcile;也可手动加入,与 @deepseek-ai/dsh-base 等同层)。

3. 重启 dsh web 服务,打开 设置 → Token 用量。

> 说明:bundle 挂载完全由 dsh.profile.bundles 声明驱动,无需在 cordis.patch.yml 手动 insert(重复注册会导致重复挂载)。

前置条件

  • DSH(dsh web),模型路由与 API Key 与对话使用同一份凭证,无需额外配置。
  • 余额查询需要:curl(Windows 10+ 自带;或 powershell 备用)与网络可达对应平台接口。

API

Host 半通过 webServer 提供同源路由(浏览器端 fetch 调用,无需鉴权头):

路由说明
GET /api/token-stats/summary?rangeDays=N范围内汇总(1/7/14/30/0=全部)
GET /api/token-stats/trends?days=D趋势:today(按小时)/ 7 / 14 / 30 / 31 天
GET /api/token-stats/session?sessionId=单会话统计
GET /api/token-stats/export最近 5000 条记录 JSON
GET /api/token-stats/pricing价目表与显示配置
POST /api/token-stats/pricing增/删/改/重置价目条目或显示配置
GET /api/token-stats/balance?force=1各路由余额

数据与隐私

  • 用量数据派生自 DSH 会话日志(assistant/message.usage),插件不做独立落盘;价目表与显示配置写入工作区根目录的 .dsh-token-stats-pricing.json。
  • 余额查询仅在打开设置页时进行(60s 缓存),API Key 通过 DSH 凭证服务解析,只传给对应的平台接口,绝不写入日志。

已知限制

  • 历史回填只认 assistant/message 中携带 usage 的调用;未上报 usage 的调用不计入。
  • 更早的价格调整(8-17 之前的历史调价)未分段,统一按 8-17 前旧价估算。

开发

  • lib/index.js — Host 半(标准 cordis 插件,webServer 路由)。
  • lib/client.js — 浏览器半(window.__ModuleLoader__ bundle,exports.apply 注册 settings.section 与 conversation.composer.dock 两个增量槽位;图表全部手写 SVG)。
  • 修改后刷新页面即可生效(client bundle 随页面加载);host 半改动需重启 DSH。

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category