前言¶
用 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.com、api-docs.deepseek.com等网络域)符合你的安全策略。
典型用法示例¶
查看会话与当日费用¶
安装并重启 dsh web 后,打开任意会话即可在输入区下方或标题栏看到本会话累计费用与 Token 拆分;侧边栏底部显示今日总费用,悬停可见调用次数明细。无需额外配置即可开始记账,价格默认按内置表与官方峰谷规则估算。
设置预算与同步官方价格¶
- 进入 设置 → 费用,在顶部「预算」面板填写额度与周期。
- 在「数据与同步」区域点击从官方文档同步价格,按需选择美元或人民币官方页。
- 在「显示设置」中开启余额进度条、输入框上方额度横条,或切换界面语言。
预算超支时界面变色提示,但不会拦截模型请求。
配置自定义 Provider 余额(NewApi 示例)¶
在 设置 → 费用 → 自定义 Provider 余额 中展开配置,或编辑 storages/cost-meter/ledger.json 的 config.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,并跟官方峰谷规则与价格表对齐,值得装上去试一轮。