dsh-cost-meter README

The project's README from github.com/Han-1413141/dsh-cost-meter. As one markdown file: README.md.

dsh-cost-meter

DeepSeek Harness 会话费用统计插件(界面中英双语)

本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段;2026-08-23 起周末全天按谷价,显示「周末时段——全谷价」) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet / 火山方舟 九家,含 Volcano Ark AK/SK 签名) · Plan/API 双轨计费(订阅额度与按量金额分离统计,每 1% 额度与满窗的 token/等值金额估算及日/周/月曲线) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)

version npm license dsh awesome · DSH plugin WhaleHarness audit

English | 中文


宣传图

功能总览

功能 位置 说明
本会话费用 输入区下方 / 会话标题栏 实时累计费用 + 输入/缓存/输出 token,位置可配
官方余额 侧边栏顶部 / 设置页(可配) 总余额 / 赠送 / 充值,自动刷新 + 手动刷新;可选三段进度条(蓝/橙/灰),当日段只统计官方渠道费用(不含 Coding Plan / 自定义 Provider)
自定义 Provider 余额 侧边栏 / 设置页(可配) 可配置 HTTP 查询任意 Provider 余额(LiteLLM 等);中/英名称、币种、extract 规则(点路径 / 数字常量 / add / subtract / divide,divide 适配 NewApi 等 quota 端点,见下方示例);与 Coding Plan 同区可折叠配置
OpenCode Go 额度 侧边栏 / 设置页 / 右下角(dock,可配) 滚动 5 小时 / 本周 / 本月用量百分比与重置时间,三档可分别开关,可同时显示预算已用%;Key 自动发现(DSH 凭据库 OPENCODE_GO_API_KEY / 环境变量 / opencode 登录态)或手动填写
Coding Plan 额度 侧边栏 / 设置页(每家可配) 多厂商 coding plan 订阅额度查询(Anthropic Claude Pro/Max、Z.ai/智谱 GLM、MiniMax Token Plan、Kimi Code 本周/5 小时配额(无订阅 Key 时回落 PAYG 余额)、OpenRouter credits、SiliconFlow 余额、CommandCode 5h/周窗口与月度 Credits 余额、火山方舟 Volcano Ark 5h/周/月三档(需 AK/SK 管控面 HMAC 签名,需 ArkReadOnlyAccess + BillingCenterReadOnlyAccess)),各家独立启用开关、凭据、显示位置与刷新间隔(侧边栏卡片与 Go 额度同款,收起窄栏显示百分比),凭据只发往官方端点;无凭据/无订阅为中性提示;SCNet 超算互联网 Token Plan 支持外部控制台额度快照,无有效快照时按官方 Credits 抵扣表由本地账本估算月度用量(无需凭据)
额度横条 输入框上方(显示设置可开关) 一条横排 chips 实时显示预算已用% / Go 主窗口 / 各已启用 Coding Plan 用量窗口(短标签+迷你进度条,≥80% 预警、≥100% 超支,悬停见重置时刻);点击任意 chip 即刷新对应数据源(budget→状态、Go→Go 额度、厂商→该家全部窗口),同一厂商多窗口融合为一条 chip 分段显示;首次更新弹引导卡由用户自主决定开关;无可用数据自动隐藏
点击立即刷新 侧边栏余额/额度图框 官方余额 / 自定义余额 / Coding Plan 图框(含窄栏收起态)点击即触发一次查询,刷新中呼吸闪烁,失败保持原值并在悬停提示说明;键盘 Enter/Space 可触发;更新后首次进入有引导提示
简化侧栏显示 设置 → 费用 → 显示 可选开启;更新首次提示选择,压缩卡片和明细,面板高度限制为视口的 38% 且不超过 320 像素;保留金额、额度、点击刷新与悬停详情,关闭后恢复原布局。使用说明
当日费用 侧边栏底部(设置按钮上方) 「今日 ¥x」,悬停见调用次数与 token 明细
预算图框 侧边栏底部(余额行与设置按钮之间) 圆角方形图框:预算、已用%、进度条、今日费用与占预算%、已用/额度,≥80% 预警、≥100% 超支
汇总卡片 设置页 今日 / 本月 / 累计费用与调用次数
Token 用量统计 设置页(费用设置) 历史累计 token 总量(输入/缓存/输出/调用)+ 类 Codex 的 26 周每日用量方格热图,横向铺满设置页宽度,悬停见当日明细
Token Plan 用量统计 设置页(用量) 各已启用 Coding Plan(含 Go)当前窗口的「每 1% 额度」与「满窗 100%」对应的 token 数与等值金额估算(采样差分/当前用量折算),附每日/每周/每月用量曲线;Plan 类调用金额只记等值,不动真金白银(issue #64)
今日会话明细 设置页 每个会话的调用次数、输入/缓存/输出 token 与费用
历史记录 设置页 按天汇总,保留天数可配(默认 180 天)
历史按模型统计回填 设置页(按模型统计) 按模型统计上线前的旧账本自动回放宿主会话日志重建逐模型 token/费用拆分(旧调用按当时基础价),日志已清理的部分归入「早期未分模型」残差行
导入安装前历史 首次启动自动 安装/升级后首次启动自动回放宿主全部会话日志,把未装插件时期的对话导入账本(缺失日期整日重建,已有日期只补未知会话,幂等不与实时计费重复;金额按事件时刻历史价回推);设置页保留手动重跑入口
预算设置 设置页顶部 额度、周期(今日/本月/累计/自定义日期区间)、已用%
价格表 设置页 每模型 谷时/峰时 两档价格(支持 input/output 简写,缓存价自动补齐),增删改自由
峰谷计价时段显示 设置页 / 预算 / 今日费用 显示 UTC 峰时段 01:00–04:00、06:00–10:00 与当前档位;2026-08-23 起周末(周六及周日,北京时间)全天按谷价计费并显示「周末时段——全谷价」;展开态显示峰时/平价时段条(当前时段 + 倒计时),收起(rail)态显示竖向峰谷进度条,可单独开关
峰/谷切换弹窗提醒 全局浮层 距进入峰/谷时段不足设定提前量(默认 2 分钟,1-30 可配)时全屏色条徽标弹窗(提醒色区分进入峰/谷);弹窗位置可选右下角 / 屏幕中心,提醒类型可选(进入峰 / 进入谷 / 峰和谷),同一切换点只提醒一次;可选同步发送浏览器(系统)通知(页面最小化也能收到,需授权通知权限);设置页峰谷计价面板内配置,并可一键预览弹窗效果(真实组件渲染,文案/位置/通知与实际触发完全一致)
官方价格同步 设置页 抓取解析官方定价页,一键应用;可选官方价格币种(美元·英文官方页 / 人民币·中文官方页),人民币价按展示汇率折算入账、展示人民币时与官方账单一致
界面语言 设置页 → 显示设置 简体中文 / English / 跟随浏览器(自动);切换即时生效并自动保存
隐藏官方余额 / 隐藏今日消耗 设置页 → 显示设置 两个独立开关:开启后对应 UI 区块(侧边栏余额行与面板 / 今日费用行、预算明细、概览今日卡片等)整体不再渲染,token 与调用次数统计不受影响,共享屏幕/截图防泄露
AI 价格同步 提示词 DeepSeek 官方同步;其他 provider 使用已核对的官方价格目录与手动配置
模型与 Plan 适配说明 适配文档 各厂商模型计费与 8 家 Coding Plan 的适配矩阵、自动匹配机制与价格来源(English)
峰/谷切换提醒图解 提醒文档 峰谷切换前弹窗与系统通知的完整图解:效果截图(中/英)、设置项说明与使用建议(English)
Token Plan 用量统计图解 面板文档 每 1% 与满窗估算的四列含义、首尾差分估算方法与精度标注、口径边界(只统计 dsh 内调用)与用量曲线说明(English)
多 provider 计费 设置页 / 账本 支持 OpenAI、Anthropic、Google Gemini、Mistral 等 provider 的 input/output、缓存与 reasoning token 价格,按 provider+model 隔离计费
模型名自动匹配 设置页 / 账本 未知模型 id 自动匹配价格表:忽略大小写/空格/横杠/点号与括号附注,归一化等价或请求名包含表内模型名即命中(如 gpt5.6 luna(go));路由 provider(opencode/zen 等)下跨厂商全库查找;可关闭为仅精确;未命中模型可手动指定计费条目
拓展价格表 设置页 → 拓展价格表 内置各厂商、按模型家族分类的参考价格目录(点开展开,厂商默认折叠);一键挂载参与计费,挂载的第三方模型默认收入表内可编辑;逐模型「在费用设置直接显示」开关自选哪些模型(含 DeepSeek)在「价格表」区直接显示

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

千问 / 阿里云资金账户余额可直接点击「添加千问 / 阿里云余额」,使用 RAM AccessKey 签名查询,显示接口返回的可用金与币种;配置步骤、所需权限及口径见千问余额说明。

千问 Token Plan 的本地 Credits 仅统计 qwen、qwen-tokenplan、qianwen-tokenplan、qwen-token-plan、qianwen-token-plan 订阅 provider(大小写不敏感,可带 llm- 前缀);显式归类为 API 的调用不计。qianwen 按量 provider 即使使用相同模型名也不会计入订阅额度。自定义渠道名需使用上述订阅名称之一,模型不在抵扣表中时需补充三项费率。

自定义 Provider 余额的 extract 规则支持四种形式:数字常量、点路径字符串、add/subtract 多路径加减、divide 按 by 除数缩放。divide 适用于 NewApi 等以 quota 整数计量的端点(1 USD = 500000 quota,与 cc-switch 同款换算)。

以 NewApi 的 GET /api/usage/token 为例(响应 { "code": 200, "data": { "total_granted": ..., "total_used": ..., "total_available": ..., "unlimited_quota": false } }):

{
  "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"
  }
}

凭据与安全

CLIProxyAPI 网关额度与 WorkBuddy 积分 (Issue #87)

支持对接本地或局域网部署的 CLIProxyAPI 代理网关,集中观测代理的多个 Provider 账号额度与 WorkBuddy 插件积分:

双语界面

插件界面(会话徽章、侧边栏余额与预算图框、设置页全部文案)支持简体中文与English:

图文演示

截图均取自真实 DeepSeek Harness 实例,默认以中文界面展示;插件界面本身中英双语,可在设置中切换为 English。

主页面

侧边栏底部(自上而下:官方余额 → 额度 / 预算图框 → 设置按钮):

侧边栏底部

余额进度条与自定义 Provider 配置:

侧边栏进度条 + 显示设置 自定义 Provider 余额面板
余额进度条 自定义 Provider 配置

额度 / 预算图框三态(OpenCode Go 额度与预算各自独立开关,同款圆角图框;两者同时开启时自动合并为一张卡片,Go 在上、预算在下,细分隔线、各自保留预警色;「图框详细信息」开关可收起次要行,只保留 标签 + 已用% + 进度条):

仅 OpenCode Go 额度 仅预算 两者合并
仅 Go 额度 仅预算 合并卡片

峰时/平价时段条与收起态竖向进度条:

设置页峰谷面板(提示开关/样式切换/预览) 设置页右下角(dock)显示与图框详细信息
峰谷计价与提示面板 右下角与图框详细设置

时段条与收起态竖向条真实 DSH 侧边栏实拍(现行样式),按 UI 类型分组(图示为峰时):

不收起(展开态)——预算框 / 今日费用区域显示单行时段条:

简洁 经典
展开态·简洁 展开态·经典

dsh-cost-meter (Han-1413141/dsh-cost-meter)

token-usage
Searching Database…

What is this?A plugin for DeepSeek Harness (DSH) that tracks session and daily costs, token usage, budgets, provider account balances, and coding-plan subscription quotas, with a bilingual English/Chinese interface.
Is this a standalone app, or does it run inside DeepSeek Harness?It is a plugin that runs inside DeepSeek Harness itself, adding cost panels to its sidebar, session header, and settings pages rather than being a separate application.
How do I configure provider balance and budget tracking after installing it?Go to Settings → Cost (quota tab) → 'Custom Provider Balance' to point it at any HTTP balance endpoint, or edit the config directly in storages/cost-meter/ledger.json.
Do I need API keys for the coding-plan providers?Yes — each coding-plan provider (Anthropic, Z.ai, MiniMax, Kimi, OpenRouter, SiliconFlow, CommandCode, SCNet, Volcano Ark) needs its own credential entered through DSH's credential store; Volcano Ark additionally requires AK/SK with specific IAM read permissions.
Are there any known accuracy caveats?Querying a provider token with unlimited quota fails because there is no 'remaining' value to extract, and coding-plan usage is tracked only as an equivalent-cost estimate rather than real billed amounts.
How are my provider API keys stored?Keys are entered through write-only fields and stored directly in DSH's credential store — never written to disk, never echoed back, and never saved into ledger.json; outbound requests are also restricted to an allowed-hosts whitelist to prevent key exfiltration.
What is the peak/off-peak pricing feature?It shows DeepSeek's UTC peak-pricing windows (01:00–04:00 and 06:00–10:00) versus off-peak rates, with a rule that weekends have been fully off-peak since 2026-08-23, plus optional pop-up and system-notification reminders before a switch.
Which coding-plan subscriptions can it show quota for?Nine providers: Anthropic Claude Pro/Max, Z.ai GLM, MiniMax Token Plan, Kimi Code, OpenRouter, SiliconFlow, CommandCode, SCNet, and Volcano Ark, each independently toggleable with its own credentials and refresh interval.
Can it recover cost history from before I installed it?Yes, on first launch it automatically replays the host's full session logs to backfill missing days in the ledger, using historical prices at the time of each call.
What does the CLIProxyAPI integration add?It can connect read-only to a local/LAN CLIProxyAPI gateway to show quota for multiple provider accounts (Antigravity, Claude, Codex, Kimi, xAI) and WorkBuddy plugin credits, with a strict guarantee that none of its calls consume billable quota.
Size
21.9 MB
Stars
445
Age
2mo
Commits · 90 Days