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 用量一条横排显示,可开关)
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"
}
}
{{NEWAPI_API_KEY}} 从 DSH 凭据库或环境变量解析(仅请求头支持占位符,URL 需写死完整地址);- 无限额度 token(
unlimited_quota: true)没有 total_available,无法提取 remaining,查询会报「remaining is missing or not numeric」——请改用有限额度 token,或在中间层端点换算;
- 配置入口:设置 → 费用(额度标签)→「自定义 Provider 余额」展开配置;或直接改
storages/cost-meter/ledger.json 的 config.customBalance。
凭据与安全
- 变量名命名规则:
{{VAR_NAME}} 的参考格式为 <ROUTE>_API_KEY——<ROUTE> 对应 DSH 模型配置页(设置 → 模型)里的 Provider ID,把 ID 大写、非字母数字字符替换为下划线,例如 openai→{{OPENAI_API_KEY}}、anthropic→{{ANTHROPIC_API_KEY}}、abc23-d→{{ABC23_D_API_KEY}}。与模型页共用同一变量名,自定义余额查询与模型调用即共用同一把密钥(都从 DSH 凭据库解析)。该说明也展示在设置页「请求头 (JSON)」输入框上方。
- 凭据输入框:展开条目配置后,「凭据输入」区会为请求头里出现的每个
{{VAR}} 占位符显示一行 write-only 输入框,密钥直接存入 DSH 凭据库(不落盘、不回显、不经 ledger.json),无需再手改环境变量或凭据文件。
- 明文密钥自动迁移:旧版本把
Bearer sk-… 明文写在请求头里时会明文落盘;插件在启动时自动把这类明文导入 DSH 凭据库,并把头值替换为 {{CUSTOM_BALANCE_KEY_…}} 占位符(名称由条目 host + 头名派生,跨重启稳定),功能不受影响。此后 ledger.json 与下发给浏览器的配置永不包含明文密钥——疑似密钥头(Authorization / X-Api-Key / Bearer / sk- 前缀 / 长不透明串)一律置空,占位符与普通头照常保留。
- 凭据白名单
allowedHosts:请求头携带密钥(占位符或明文)时,出站主机必须命中该白名单,否则直接拒绝——用于防止「导入他人配置」导致密钥外带。未配置白名单时放行并在日志警告一次。设置页条目面板内有「凭据白名单主机」输入框(逗号分隔)。
- 混合凭据模板：同一头值同时含静态密钥与动态占位符时，不能自动整体迁移为嵌套凭据。插件提示待处理并阻止该值落盘、下发；请将静态部分另存为凭据，改用纯引用组合。正常的
Bearer {{VAR}} 或 {{USER}}:{{PASS}} 保留。
CLIProxyAPI 网关额度与 WorkBuddy 积分 (Issue #87)
支持对接本地或局域网部署的 CLIProxyAPI 代理网关,集中观测代理的多个 Provider 账号额度与 WorkBuddy 插件积分:
- 多 Provider 账号原生适配:自动通过 CPA Management API 发现账号,接入 Antigravity、Claude、Codex、Kimi、xAI (Grok) 官方原生配额/用量接口。统一归一化为 5h / 7d / weekly / monthly 等用量百分比窗口与 ISO 重置时刻。
- WorkBuddy 插件积分:只读接入 WorkBuddy 插件
/v0/management/plugins/workbuddy/credits 路由,展示账户总积分、已用/剩余与套餐周期,保留独立账号卡片。
- 零计费副作用保证:严禁并杜绝任何产生计费消耗的操作——不调用 Codex 的 reset-credit consume 端点,不向 xAI 发送消耗 token 的 chat probe,不调用 WorkBuddy 的任何变更性 POST 路由。
- 严格凭据隔离与安全门禁:
- Management Key 通过只写 (write-only) 形式托管于 DSH 凭据库 (
CLIPROXYAPI_MANAGEMENT_KEY_<SOURCE_ID>_<HASH>),永不存入配置文件、账本或浏览器 state。
- 请求路径严格限制为三条固定管理路径 (
/v0/management/auth-files、/v0/management/api-call、/v0/management/plugins/workbuddy/credits),禁止任意 URL 拼接。
- 严格出站白名单 (
allowedHosts):非 loopback 来源必须精确命中白名单,非 loopback HTTP 必须显式开启 allowInsecureHttp。
- 强制禁止 HTTP 重定向 (
redirect: 'manual', 3xx 状态码坚决拒绝),防止网关重定向劫持或凭据外带。
- 账号隐私与元数据过滤:auth-files 响应仅提取必需字段,剔除 raw tokens / cookies / ID claims,展示层邮箱自动脱敏掩码 (
s***@domain)。
双语界面
插件界面(会话徽章、侧边栏余额与预算图框、设置页全部文案)支持简体中文与English:
- 语言可选 简体中文 / English / 跟随浏览器(自动);
- 默认「跟随浏览器」:自动探测浏览器语言(
zh* → 中文,其余 → 英文),并把探测结果写回配置,服务端消息(余额查询、价格同步等)与界面语言保持一致;
- 在 设置 → 费用 → 显示设置 → 界面语言 中切换,切换后整个插件界面即时生效并自动保存;设置页左侧的分节标签也随之切换(费用 / Cost);
- 服务端返回的提示(余额刷新、官方价格同步、配置校验错误等)同样按当前语言输出。
图文演示
截图均取自真实 DeepSeek Harness 实例,默认以中文界面展示;插件界面本身中英双语,可在设置中切换为 English。
主页面
侧边栏底部(自上而下:官方余额 → 额度 / 预算图框 → 设置按钮):
- 余额行显示官方开放平台总余额,悬停可见赠送/充值拆分;开启「余额进度条」后以三段图框展示(蓝=余额,橙=当日,灰=已用);
- 自定义 Provider 余额(如 LiteLLM)可配置 HTTP 查询,侧边栏与设置页同图框样式;
- 未启用预算时,该位置显示「今日 ¥x」徽章。
余额进度条与自定义 Provider 配置:
| 侧边栏进度条 + 显示设置 |
自定义 Provider 余额面板 |
 |
 |
- 显示设置 →「余额进度条」全局开关;可选「额度上限」覆盖 API 的
max_budget;
- 设置 → 费用 →「自定义 Provider 余额」:展开后编辑 URL / Headers(JSON) / extract(JSON)、中/英名称与币种。
额度 / 预算图框三态(OpenCode Go 额度与预算各自独立开关,同款圆角图框;两者同时开启时自动合并为一张卡片,Go 在上、预算在下,细分隔线、各自保留预警色;「图框详细信息」开关可收起次要行,只保留 标签 + 已用% + 进度条):
| 仅 OpenCode Go 额度 |
仅预算 |
两者合并 |
 |
 |
 |
- 预算图框显示「预算 · 已用% · 进度条 · 今日费用与占预算% · 已用/额度」,≥80% 预警、≥100% 超支;窄栏(rail)模式收窄为百分比方块;
- 峰谷计价时段显示 UTC 峰时段 01:00–04:00、06:00–10:00 与当前档位;预算框与今日费用区域显示单行紧凑时段条——细轨道左橙右蓝、标记线指向当前时段,右侧文字为当前时段与距下次切换的倒计时(30 秒刷新),不显示价格;可在设置中单独关闭,并在「峰谷时段条样式」中切换简洁/经典两种样式;rail 窄栏显示同构的竖向时段条,下方横排短词「峰时 / 平价」,倒计时与完整文案悬停可见;
峰时/平价时段条与收起态竖向进度条:
| 设置页峰谷面板(提示开关/样式切换/预览) |
设置页右下角(dock)显示与图框详细信息 |
 |
 |
时段条与收起态竖向条真实 DSH 侧边栏实拍(现行样式),按 UI 类型分组(图示为峰时):
不收起(展开态)——预算框 / 今日费用区域显示单行时段条:
| 简洁 |
经典 |
 |
 |
- 简洁:细轨道左橙右蓝、标记线指向当前时段,右侧短文案「峰时 · N小时后进入平价」;
- �
这是一个 DeepSeek Harness（DSH）插件，用于跟踪会话和每日成本、token 用量、预算、提供商账户余额以及 coding-plan 订阅额度，界面为中英双语。