2006spy/dsh-token-billing ↗★ 4

dsh-token-billing

实时Token计费与预算监控,含图表、导出与模型分摊统计 适合成本敏感用户监测费用曲线,需填写模型价格与提供商规则后才能准确计费

包名
dsh-token-billing
兼容性
待验证
Harness 依赖范围
>=0.1.0-rc.8 <0.2.0
Cordis 依赖范围
^4.0.1
版本
0.8.1
许可证
MIT
最近更新
2026年9月11日

同名包的其他仓库

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:2006spy/dsh-token-billing

⚙️ 配置

「设置 → 插件 → Web UI 插件 → Token 计费」卡片,保存即时生效(重建投影)。

基础

字段默认含义
启用实时计费开总开关
默认货币符号¥目标计费货币;官网人民币价直接使用,其他外币价按汇率折算
未知模型 · 输入/输出/缓存读/缓存写价2 / 8 / 0.5 / 2未覆盖模型的默认价(每 1M token)
模型价格覆盖{}可视化编辑器:逐格填「模型 ID + 输入/输出/缓存读/缓存写/币种」,可增删行;也可直接写 JSON { "deepseek-chat": {"input":2,"output":8} };优先级最高,不参与高峰/错峰
本地模型提供方(glob)—本地/自托管 provider 名单(如 local*),按官方价计名义价值;逗号分隔
本地模型实际单价0本地模型每 1M token 实际成本(默认 0 = 免费,可填电费/算力成本);名义价值 − 实际成本 = 已节省
月度预算(默认货币)00 = 不设预算;设置后统计页显示预算进度环与进度条预警(绿 → 琥珀 → 红,超支红色高亮)
Provider 收费形式(JSON){}如 {"opencode-go":"subscription","local*":"local","*free*":"free"};订阅/免费/本地按 0 实付、名义价计节省(见上)

按路由(per provider + model 价目)

字段默认含义
按路由价目(providerPrices,provider + 模型){}设置卡「🧭 按路由」编辑器的持久化形态:{"mxy":{"deepseek-v4-flash-0731":{"input":1,"output":4,"cacheRead":0.02,"cacheWrite":1,"currency":"¥"}}};可只填部分字段(缺省字段按全局生效价回填,避免 NaN)。固定价、不参与高峰/错峰,优先级仅次于「模型价格覆盖」
  • 取价优先级:模型价格覆盖(钉死)> 按路由价目 > 内置价格政策时间线 > 全局表(官网抓取 / 内置)> fallback
  • 编辑器可增删 provider + 模型 行、逐项填四项价与币种、就地设置各 provider 收费形式;并可列出本机实际配置的路由(读 llm-pi-ai.providers)与账本里真实出现过的 provider,点选模型即加行
  • 想跟随官方峰谷政策的 provider 不要在此钉价(固定价不参与峰谷),留空让它回落到政策时间线

价格来源

字段默认含义
价格来源DeepSeek 官网deepseek(中文页·人民币,自动抓取,英文页兜底)/ custom-json(自定义端点)/ builtin(仅内置表)
自定义价格 URL—返回 { "模型id": {"input":..,"output":..,"cacheRead":..,"cacheWrite":..} } 或 { "currency":"CNY", "models":{...} }
各提供商价格 URL(providerPriceUrls,JSON){}provider → URL 映射,如 {"mxy":"https://…"};抓取结果写入该 provider 的价目(来源标 custom-json),与三层 catalog 价并存、优先级高于 catalog 价
自动刷新间隔1h后台周期检查,价格表跟随官网实时更新

汇率折算

字段默认含义
外币自动折算人民币开抓取到外币价(如 $)时按汇率折算为目标货币
汇率(1 外币 = N 元)7.2仅对外币价生效(官网人民币价直接使用)

高峰/错峰(DeepSeek 官方计费)

字段默认含义
启用高峰/错峰开总开关(需抓取到官方高峰价表才生效)
高峰窗口旧版 UTC 默认(视为「跟随官网」)schema 默认值为 [["01:00","04:00"],["06:00","10:00"]](旧版 Config 的 UTC 窗口),与内置默认(北京时间 09:00-12:00 与 14:00-18:00、仅周一至周五)语义等价、都算「未自定义」,因此官网抓到的窗口会自动替换它;窗口第 3 位可带星期几(如 [["09:00","12:00",[1,2,3,4,5]]],0=周日…6=周六,缺省每天);真正自定义的窗口不被官网覆盖
错峰折扣率0.5官方空闲 = 高峰 × 0.5
适用模型deepseek-*glob,逗号分隔
窗口时区UTC(视为「跟随官网」)schema 默认 UTC(旧版默认),与内置 Asia/Shanghai 同属「默认等价」写法,官网抓到时区会自动跟随;自定义时区不被覆盖
忽略生效日期关官方周末空闲价自北京时间 2026-08-23 00:00 生效(高峰仅周一至周五);勾选后立即启用

状态(实时查看)

  • 价格抓取状态:来源、最近更新时间、覆盖模型数、高峰/错峰窗口与生效时刻;「立即刷新价格」按钮手动抓取并重建投影。
  • 当前生效单价表:列出所有模型当前生效价(含高峰/错峰,按此刻计价),切换模型/时段变化后实时刷新。

统计(仪表盘 · 历史账本 · 余额 · 导出 · 节省 · 收费形式 · 缓存命中)

  • 仪表盘概览:KPI 卡(今日 / 昨日环比 / 本月·预算环 / 累计 / 调用次数)+ 近 14 天费用趋势折线图 + Token 用量趋势折线图 + 按模型 / 按 Provider 占比环形图(hover 查看明细,详见上方 v0.7 一节)
  • 月度预算:monthlyBudget 配置后显示进度条预警(超支红色高亮)
  • 费用汇总:今日 / 本月 / 累计(多币种,本地时区)
  • 账户余额:官方余额实时显示(需 DEEPSEEK_API_KEY)
  • 按模型 / 按天:历史明细(按天最近 14 天,含每日 token 总量)
  • 按 provider:每个 provider 的实际花费 / 名义价值 / 节省与收费形式徽标(按量灰 / 订阅紫 / 免费天蓝 / 本地绿)
  • Token 用量与缓存命中:未缓存输入 / 缓存读 / 缓存写 / 输出 / 总 Token / 缓存命中率
  • 本地模型节省:已节省 / 名义价值 / 实际成本
  • 导出:CSV / JSON 一键下载账本