dsh-cost-meter:给 DeepSeek Harness 装上会话费用仪表盘

前言

用 DeepSeek Harness(DSH)跑长会话、多模型切换时,Token 消耗往往事后才在账单里对上号:本会话花了多少、今天累计多少、峰谷时段有没有踩到高价档、Coding Plan 还剩几成额度——这些数字分散在官方控制台、各家订阅后台和脑子里,很难在写代码的同一屏里看见。

社区插件 dsh-cost-meter(维护者 Han-1413141)把费用统计嵌进 DSH Web 界面:会话徽章、侧边栏余额与预算图框、设置页历史与热图,并支持官方价格同步、峰谷计价提醒与中英双语。项目在 GitHub 上约 184 stars、12 forks,MIT 许可,当前发布版本 v1.5.45,在 SkillHub 插件库 分类为「联网工具」。SkillHub 是面向 DSH 插件的社区目录,与 DeepSeek / 幻方无官方从属关系;DSH 本身遵循「一切皆插件」的扩展理念,这类工具由社区维护、自行审阅后安装。

这是什么

dsh-cost-meter 是 DeepSeek Harness 的 Web 端会话费用统计插件。它在宿主进程内包裹每次 LLM 调用,按 usage 与价格表实时入账,并在浏览器侧展示本会话费用、当日/月度汇总、预算进度、官方与自定义 Provider 余额,以及 OpenCode Go、多家 Coding Plan 的额度窗口。

账本持久化在 $DSH_HOME/storages/cost-meter/ledger.json;界面语言可选简体中文、English 或跟随浏览器。

核心功能与亮点

会话与账本

  • 本会话费用:显示在输入区下方或会话标题栏,含输入/缓存/输出 Token 与累计金额,位置可在设置中切换。
  • 当日费用与历史:侧边栏底部「今日 ¥x」徽章,设置页提供今日/本月/累计汇总、按天历史(默认保留 180 天)及今日各会话明细。
  • 预算图框:可设额度与周期(今日/本月/累计/自定义区间),≥80% 预警、≥100% 超支提示;仅提醒,不阻止调用
  • Token 热图:设置页提供类 Codex 的 26 周每日用量方格热图,悬停可看当日明细。
  • 安装前历史导入:首次启动可回放宿主会话日志,把未装插件时期的对话补入账本(幂等,不与实时计费重复)。

余额与多源额度

  • 官方余额:查询 api.deepseek.com 总余额/赠送/充值,支持三段进度条与手动刷新;API Key 复用 DSH 凭据,仅发往官方域名
  • 自定义 Provider 余额:可配置任意 HTTP 端点(如 LiteLLM、NewApi),通过 JSON extract 规则解析剩余额度。
  • OpenCode Go 额度:展示滚动 5 小时/本周/本月用量与重置时间,Key 可自动发现或手动填写。
  • Coding Plan 额度:支持 Anthropic、Z.ai、MiniMax、Kimi、OpenRouter、SiliconFlow、CommandCode 等厂商订阅窗口查询;SCNet Token Plan 无公开 API 时由本地 Credits 表估算。
  • 输入框上方额度横条:预算、Go、各 Coding Plan 用量以 chips 横排显示,点击即刷新对应数据源。

计价与价格表

  • 多模型计费:内置 90+ 模型参考价格目录,支持 OpenAI、Anthropic、Google Gemini、Mistral 等 provider 的 input/output、缓存与 reasoning Token;未知模型 id 可模糊匹配或手动指定条目。
  • 峰谷两档计价:UTC 01:00–04:00、06:00–10:00 为峰时段,其余按谷时价(约为峰时一半);2026-08-23 起周末(北京时间周六、周日)全天按谷价,界面显示「周末时段——全谷价」。
  • 峰/谷切换提醒:进入峰/谷前可弹全屏色条或发送浏览器系统通知,提前量、位置、提醒类型可配,设置页支持预览。
  • 官方价格同步:抓取官方定价页 HTML 解析,一键写入价格表;可选美元或人民币官方页,人民币按展示汇率折算显示。

体验细节

  • 侧边栏余额/额度图框支持点击立即刷新;可单独隐藏官方余额或今日消耗,便于共享屏幕。
  • 界面与服务器提示消息均支持中英双语

安装与启用

环境要求:Node.js ≥ 20,以及带 dsh plugin 子命令的 DeepSeek Harness(例如 npm install -g @deepseek-ai/dsh)。

一键安装(推荐)

npm 包名安装,始终跟随 registry 最新版:

dsh plugin --profile web add dsh-cost-meter

若需固定到当前发布 tag(README 示例为 v1.5.45),且本机已有 pnpm 与 git:

dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.45

没有 git 时可用 tag 打包直链:

dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.45.tar.gz

安装后重启 Web 进程,插件行与客户端 bundle 在启动时扫描:

dsh web

卸载:

dsh plugin --profile web remove dsh-cost-meter

插件以当前 dsh 进程权限运行,会访问网络查询余额与官方定价页。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证,确认权限声明(manifest 中列有 api.deepseek.comapi-docs.deepseek.com 等网络域)符合你的安全策略。

典型用法示例

查看会话与当日费用

安装并重启 dsh web 后,打开任意会话即可在输入区下方或标题栏看到本会话累计费用与 Token 拆分;侧边栏底部显示今日总费用,悬停可见调用次数明细。无需额外配置即可开始记账,价格默认按内置表与官方峰谷规则估算。

设置预算与同步官方价格

  1. 进入 设置 → 费用,在顶部「预算」面板填写额度与周期。
  2. 在「数据与同步」区域点击从官方文档同步价格,按需选择美元或人民币官方页。
  3. 在「显示设置」中开启余额进度条、输入框上方额度横条,或切换界面语言。

预算超支时界面变色提示,但不会拦截模型请求。

配置自定义 Provider 余额(NewApi 示例)

设置 → 费用 → 自定义 Provider 余额 中展开配置,或编辑 storages/cost-meter/ledger.jsonconfig.customBalance。以下片段来自官方 README,适用于以 quota 整数计量的 NewApi 端点(1 USD = 500000 quota):

{
  "enabled": true,
  "display": "both",
  "refreshMinutes": 15,
  "label": "NewApi",
  "labelEn": "NewApi",
  "unit": "USD",
  "request": {
    "url": "https://你的NewApi域名/api/usage/token",
    "method": "GET",
    "headers": { "Authorization": "Bearer {{NEWAPI_API_KEY}}" }
  },
  "extract": {
    "remaining": { "op": "divide", "path": "data.total_available", "by": 500000 },
    "maxBudget": { "op": "divide", "path": "data.total_granted", "by": 500000 },
    "spend": { "op": "divide", "path": "data.total_used", "by": 500000 },
    "unit": "USD"
  }
}

{{NEWAPI_API_KEY}} 从 DSH 凭据库或环境变量解析;配置保存后约 600ms 防抖自动持久化。

开发者本地调试

git clone https://github.com/Han-1413141/dsh-cost-meter.git
cd <克隆目录的父目录>
dsh plugin --profile web add link:./dsh-cost-meter

符号链接模式下修改 lib/client.js 后刷新页面即可看到 UI 变化。

适用场景与注意事项

适合谁用

  • 长期在 DSH Web 里跑 Agent、子代理或多模型路由,需要同屏掌握 Token 与费用的开发者。
  • 同时使用 DeepSeek 官方 API、OpenCode Go 或多家 Coding Plan,希望统一查看额度窗口的用户。
  • 关注 DeepSeek 峰谷计价规则,想在切换前收到弹窗或系统通知提醒的场景。

使用注意

  • 会话徽章按当前价格档位估算,精确金额以账本为准;官方定价页结构变化时同步可能失败,可手动改价格表兜底。
  • 历史按模型回填依赖宿主会话日志仍在磁盘;日志已清理的早期调用无法逐模型拆分。
  • OpenCode Go 等第三方额度接口若变更,设置页会显示错误,可在显示设置中关闭对应模块。
  • 删除 $DSH_HOME/storages/cost-meter/ledger.json 或使用设置页「清除全部历史」可清零本地账本。

结尾

如果你已经在用 DeepSeek Harness,却总觉得「花了多少」要靠事后对账,dsh-cost-meter 把会话成本、预算、余额和多源额度收进同一套 Web UI,并跟官方峰谷规则与价格表对齐,值得装上去试一轮。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜