会话成本与余额计费X-avier-W/dsh-elegent-balance-tracker

dsh-elegent-balance-tracker

npm version
license
dsh
awesome · DSH plugin

DeepSeek Harness（dsh）计费插件：当前会话成本 + 官方账户余额，两个数字都按 DeepSeek 官方计价/接口展示。

功能

| 位置 | 内容 | 说明 |
|---|---|---|
| 输入框统计行下方 | 费用: x.xx元 | 当前会话累计成本。host 端逐条读取会话日志的 usage（未命中输入 / 缓存命中 / 输出 token），按每条消息的发生时刻（北京时间）选择官方高峰/空闲价计算，与官方账单口径一致；模型回复完毕即刷新，15s 轮询兜底 |
| 侧边栏底部（设置按钮同行、右对齐） | 余额: x.xx元 | 启动时获取官方准确余额，之后每分钟自动对齐官方 GET /user/balance；两次对齐之间按本机所有会话新增成本实时扣减生成预估余额。点击立即同步；悬停显示余额与上次对齐时间 |

- 计费：token 取自会话日志中 provider 上报的 usage（缓存命中拆分、失败重试计入），单价内置官方价格，2026-08-17 起自动按北京时间峰谷价（周一至周五高峰 9-12 / 14-18 点，周末全天闲时、空闲半价）。
- 自动同步官方计价（v0.2.0+，默认开启）：启动时及每 12 小时抓取官方定价页，自动识别新模型与峰谷规则变化——deepseek-v4-flash-vision-exp 等新模型无需升级插件即可按官方价计费。优先级：用户显式配置 > 官方自动同步 > 内置默认价。
- 纯本机：余额只请求官方接口（API Key 不出服务器），会话日志只在本地解析，不上报任何外部服务。
- 子代理是独立会话，各自单独统计。
- 累计充值 / 累计消费：官方 API 不提供（/user/balance 只有当前余额构成），因此不展示。

安装

npm 渠道（推荐，适用于所有设备）
dsh plugin --profile web add dsh-elegent-balance-tracker

离线安装包

方式一：直接指定 tgz 离线包
dsh plugin --profile web add /path/to/dsh-elegent-balance-tracker-0.1.0.tgz

方式二：本地目录
dsh plugin --profile web add /absolute/path/to/dsh-elegent-balance-tracker

安装后重启 dsh web（插件行与客户端 bundle 在启动时扫描），再刷新浏览器页面（F5）。

宿主侧 API Key 使用 DEEPSEEK_API_KEY 凭据引用（在 Web 模型设置页保存即可），也可回退到同名环境变量。

配置（全部可选）

在 web profile 的 cordis.patch.yml 覆盖（$DSH_HOME/profiles/web/cordis.patch.yml）：

- patch:
- id: dsh-elegent-balance-tracker
config:
apiKeyRef: DEEPSEEK_API_KEY   # 余额查询用的凭据引用
baseURL: ""                   # 余额接口地址；留空用 $DEEPSEEK_BASE_URL，再回退 https://api.deepseek.com
balanceCacheMs: 60000         # 余额缓存毫秒数
costCacheMs: 2000             # 会话费用缓存毫秒数
官方计价自动同步（默认开启；关闭后仅用内置价 + 下方手动覆盖）
priceSync:
enabled: true
url: "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/"
intervalMs: 43200000        # 12 小时
timeoutMs: 10000
单价覆盖（元 / 百万 tokens）——优先级高于官方同步价
prices:
deepseek-v4-flash: { input: 1, cacheRead: 0.02, output: 2 }
日期生效的峰谷价表——优先级高于官方同步价
priceSchedule:
- from: "2026-08-17"
peak:
deepseek-v4-flash: { input: 3, cacheRead: 0.1, output: 9 }
idle:
deepseek-v4-flash: { input: 1.5, cacheRead: 0.05, output: 4.5 }

内置默认价（官方现行价，2026-08-17 起）：

| 模型 | 时段 | 未命中输入 | 缓存命中 | 输出 |
|---|---|---|---|---|
| deepseek-v4-flash | 高峰 | ¥3.0/M | ¥0.10/M | ¥9.0/M |
| deepseek-v4-flash | 空闲 | ¥1.5/M | ¥0.05/M | ¥4.5/M |
| deepseek-v4-flash-vision-exp | 高峰 | ¥3.0/M | ¥0.10/M | ¥9.0/M |
| deepseek-v4-flash-vision-exp | 空闲 | ¥1.5/M | ¥0.05/M | ¥4.5/M |
| deepseek-v4-pro | 高峰 | ¥9.0/M | ¥0.30/M | ¥27.0/M |
| deepseek-v4-pro | 空闲 | ¥4.5/M | ¥0.15/M | ¥13.5/M |

表格仅为内置兜底价；priceSync 开启时（默认）以官方页面实时同步价为准，新模型与调价自动生效。

卸载

dsh plugin --profile web remove dsh-elegent-balance-tracker

License

MIT