2006spy/dsh-token-billing

dsh-token-billing

Name: dsh-token-billing
Author: 2006spy

UIVision3 GitHub stars· updated 2026-08-21

dsh-token-billing is a community DeepSeek Harness plugin. Read the repository README before installing.

Install

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

Restart `dsh web` after install. Bundle APIs can change during the developer preview.

README badge

[![DSH Hub](https://dshhub.dev/badge/dsh-token-billing.svg)](https://dshhub.dev/plugins/dsh-token-billing)

Paste this into your README. The star count updates with every catalog sync.

GitHub Install guide

From the README

Excerpt from 2006spy/dsh-token-billing, cleaned of badges and images.

💸 dsh-token-billing

DeepSeek Harness (dsh) 实时 token 计费插件 · Real-time token billing for DSH

官网人民币价直接计费 · 高峰/错峰自动切换 · 价格实时跟随官网 · 可视化自定义模型价格 · 订阅/免费/本地收费形式分类 · 统计仪表盘（趋势折线图 + 占比环形图 + 预算预警）

✨ 这是什么

为 DeepSeek Harness（dsh）Web 提供实时费用统计：按本次会话实际的 token 用量（输入 / 输出 / 缓存读 / 缓存写四个桶）乘以模型单价，换算成费用，在输入框上方实时显示。

估算 → 精确自动修正：流式生成期间用字符/4 启发式估算（标注「估」），收到模型的精确 usage 后自动修正；被中断（abort）的估算步骤不会落地计费。
零构建依赖：手写 ESM 宿主 + __ModuleLoader__ 客户端 bundle，与 modlens 同款立场。

输入框上方一行实时显示（与 TPS 同款样式）：
💸 ¥0.0302 · 12.3k in / 1.2k out · 本轮(估) ¥0.0011 · deepseek-v4-flash ¥4.5/M · 空闲

📸 界面一览

统计页仪表盘（v0.7 · 纯手写 SVG 图表 · 模拟数据渲染）：

图中可见：KPI 概览卡（今日 / 昨日环比 / 本月·预算环 / 累计 / 调用次数）· 费用趋势折线图 · 按模型费用占比环形图 · Token 用量趋势折线图 · 按 Provider 实际花费占比环形图 · 月度预算进度条 · 账户余额 · 按模型 / 按天明细。

截图由 scripts/render-preview.mjs 用模拟账本数据生成；真实界面随实际账本数据展示。

🚀 安装

方式一：DSH 插件市场（推荐，待上架）

打开 DSH → 设置 → 插件 → 市场
搜索 dsh-token-billing，点安装
重启 DSH Web

方式二：GitHub 直接安装

# 在 web profile 目录下执行
cd ~/.dsh/profiles/web
pnpm add github:2006spy/dsh-token-billing#main

然后在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: token-billing
      name: dsh-token-billing

重启 dsh web 即可。

方式三：本地源码链接（开发）

git clone https://github.com/2006spy/dsh-token-billing.git
# ~/.dsh/profiles/web/package.json → dependencies:
#   "dsh-token-billing": "link:<绝对路径>"
# ~/.dsh/profiles/web/cordis.patch.yml → 挂载行同上

🎯 核心特性

官网人民币价格直接计费

默认抓取 DeepSeek 官网中文页（¥ 标价，如 flash 平峰 0.02/1/2 元、高峰 0.10/3.0/9.0 元），无需汇率换算；英文页（USD）兜底，可用「外币自动折算人民币」按汇率折算。

价格实时跟随官网

默认 1 小时自动检查并重抓官网价格表（后台周期定时器 + 缓存过期重抓 + 卡片手动刷新）；高峰/错峰生效时刻到达后 1 分钟内自动切换，无需重启。

DeepSeek 高峰/错峰计费（官方口径）

高峰：北京时间 09:00-12:00 与 14:00-18:00，其余为空闲时段（半价）
新价自北京时间 2026-08-17 00:00 生效
插件自动解析官网的窗口（北京时间）与时区，按请求发生时刻自动切换计价
费用行实时显示当前「高峰 / 空闲」徽标

可视化自定义模型价格

设置卡「基础」里用表格可视化添加/删除自定义模型与价格（模型 ID + 输入/输出/缓存读/缓存写/币种），替代手写 JSON，实时生效。

多币种兜底

非人民币的外币价按汇率折算为目标货币；不同币种分别累计显示。

持久化历史账本 + 多维统计（v0.5）

每条结算 step 幂等落盘 ~/.dsh/storages/token-billing-ledger.json，跨会话累计、重启不丢。「统计」卡展示 今日 / 本月 / 累计 / 按模型 / 按天（本地时区）。

账户余额查询（v0.5）

调官方 GET /user/balance（复用 DEEPSEEK_API_KEY），统计卡实时显示余额（60s 缓存，失败静默降级，key 不下发浏览器）。

CSV / JSON 导出（v0.5）

统计卡一键导出账本：CSV（带 BOM，Excel 友好）或 JSON。

本地模型节省统计（v0.5）

配置 localProviders（如 local*）与 localCostPerM（实际成本，默认 0 = 免费）后，本地（自托管）模型调用按官方价计名义价值 - 实际成本 = 已节省，统计卡实时显示。

Provider 收费形式（v0.6，参考 dsh-web-billing）

配置 providerModes（JSON，如 {"opencode-go":"subscription","local*":"local","*free*":"free"}）后，订阅制 / 免费 / 本地 provider 的调用实际花费按 0 计，官方名义价折算为「节省/回本」：

模式	说明
`usage`	按量：按官方/配置价实算花费（默认）
`subscription`	订阅（如 opencode-go $10/月）：实际花费 0，名义价值计「回本」
`free`	活动免费：实际花费 0（真正白嫖）
`local`	本地部署：实际花费 0（或按 `localCostPerM`），省的是 API 钱