dsh-web-billing
支持多币种、峰谷计价的Token账单插件 适合需要精细化统计官方及本地模型调用成本的Web端用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:bpc-oss/dsh-web-billing说明文档
阅读完整 README ↗配置参考
| 键 | 默认 | 说明 |
|---|---|---|
currency | CNY | 币种标识 |
symbol | ¥ | 人民币展示符号 |
symbolUsd | $ | 美元展示符号 |
displayCurrency | auto | auto=跟随界面语言（英文界面显示 USD）；CNY/USD=强制指定 |
timezone | Asia/Shanghai | 峰谷时段判定时区（IANA） |
peakWindows | [[9,12],[14,18]] | 高峰时段（本地小时，[start,end)） |
officialPricing | auto | auto=官方政策自动计价；off=只用 prices |
prices | {} | 用户价格表（覆盖/兜底，单位 ¥/1M，同时作用于美元价） |
usdPrices | {} | 美元价覆盖（可选，单位 $/1M） |
localProviders | [] | 本地（自托管）provider 名单：调用按官方价计「名义价值」，实际成本按 localCostPerM，差值计入「已节省」 |
localCostPerM | 0 | 本地模型实际单价（¥/1M，所有 token 统一；默认 0 = 免费，可填电费/算力成本） |
codingUsdCnyRate | 7.2 | coding plan 美元价的参考人民币汇率（$→¥，仅展示换算；DeepSeek 官方价不受影响） |
policyOverrides | [] | 追加的官方政策条目（since 必填，prices 或 peak+offPeak） |
persistPath | ~/.dsh/storages/web-billing.json | 账本文件路径（核心聚合，高频写） |
maxRecent | 100000 | 最近流水保留条数（范围明细窗口） |
maxMessagesPerSession | 2000 | 每会话消息明细保留条数 |
detailWriteIntervalMs | 30000 | 明细文件（sessions 消息 + recent，独立 -detail.json）防抖写间隔；调大降写频率（掉电最多丢该间隔内明细，统计聚合不丢） |
loopbackOnly | true | /billing 端点仅允许回环地址访问 |
balance.enabled | true | 是否查询并展示账号余额 |
balance.endpoint | https://api.deepseek.com/user/balance | 余额接口地址（DEEPSEEK_BASE_URL 环境变量存在时以其为前缀） |
balance.apiKeyEnv | DEEPSEEK_API_KEY | 解析 API key 的凭证引用（经 ctx.credentials 或环境变量） |
balance.refreshMs | 60000 | 余额刷新间隔 |
balance.timeoutMs | 5000 | 余额请求超时 |
metering | {} | 静态收费形式表：{ provider: { mode, monthly?, freeModels? } }（运行时可在设置页改，存 web-billing-metering.json） |
单价字段语义：input=缓存未命中输入，cacheRead=缓存命中输入，output=输出
（¥ / 百万 tokens）。