dsh-billing-compass

dsh plugin --profile web add dsh-billing-compass

<div align="center">

计费罗盘 · Billing Compass

DeepSeek Harness 的账单面板 —— 余额、官网用量与消费、按模型花费、实时费用估算,一屏看清。

</div>

预览图按插件真实 CSS + 宿主真实主题令牌渲染,数据为示例值。

---

它显示什么

统计条常驻在输入框下方,点一下弹出面板:

区域 · 内容 · 数据来源

账户余额 · 充值 / 赠送 / 是否可用 · api.deepseek.com/user/balance

官网消费 · 最近两个月消费合计,按模型拆分 · platform.deepseek.com/api/v0/usage/export(zip 内 cost-*.csv)

综合每亿 token · 官网消费 ÷ tokens · 由上面两项推导

按模型 · tokens、缓存命中率、消费、每亿 token 单价、消费占比条 · platform.deepseek.com/api/v0/usage/amount

本对话消费(整段) · 整个会话从开始到现在的估算费用 · 只读解析本地会话日志

本次运行 · 本次进程启动以来的调用次数 / tokens / 估算费用 · 本地拦截 llm/stream 的 usage

• 触发行:● 余额 ¥9.56 · 官网消费 ¥252.48 · 本对话 $8.47 · 263.8M tokens ▼
• 面板宽度与位置与输入框卡片完全一致,不是浮在中间的窄条
• 当前正在使用的模型会在列表里高亮(D 品牌蓝)

数据流

关键点:

• 零依赖:HTTP 用 node:https,ZIP 解压与 zstd 解码用 node:zlib;不需要 curl、pwsh、unzip 或任何 npm 包
• 不落盘:实时调用记录只存在内存(最近 3000 条),进程重启即清零;会话日志只读
• 凭据三级回退:环境变量 → Harness credentials 服务 → <DSH_HOME>/.credentials.yaml
• 失败自愈:官网接口偶发失败或凭据后补时,30 秒一次自动重试,不用等 5 分钟

---

环境要求

项目 · 要求 · 不满足时会怎样

DeepSeek Harness · 0.2.x(需要 conversation.composer.dock 槽位与 useProjection) · 面板不出现

Node · ≥ 20 · —

Node · ≥ 22.15(内置 zlib.zstdDecompressSync) · "本对话消费(整段)" 退化为"本次运行"

平台 · Windows / macOS / Linux 均可 · —

凭据 · DEEPSEEK_API_KEY 必需;DEEPSEEK_USER_TOKEN 可选 · 逐项显示"未配置",其它数据照常

安装

方式一:预构建包(最快,无需构建)

从 Releases 下载 dsh-billing-compass.tgz,然后:

plugin_manager  action=install_bundle  target=<下载后的 tgz 绝对路径>

或直接给它 URL:

plugin_manager  action=install_bundle  target=https://github.com/wwu328763-netizen/dsh-billing-compass/releases/latest/download/dsh-billing-compass.tgz

装完重启 Harness。

方式二:从源码目录装

git clone https://github.com/wwu328763-netizen/dsh-billing-compass.git

plugin_manager  action=install_bundle  target=<克隆下来的绝对路径>

方式三:手工放置

1. 复制整个目录到 <DSH_HOME>/profiles/node_modules/dsh-billing-compass/

2. 在当前生效 profile 的 cordis.patch.yml 追加:

- insert:
    - id: dsh-billing-compass
      name: dsh-billing-compass
      config: {}

3. 把 dsh-billing-compass 写进同目录 package.json 的 dependencies

4. 重启 Harness,再刷新页面(Ctrl+F5)

宿主的 JS 模块在进程内被缓存,改代码或首次安装都必须重启;客户端改动刷新页面即可。

方式四:通过「插件市场 / Discover」添加

本仓库自带一份 format 1 市场索引,加进任何人的插件市场即可看到并安装本插件:

https://raw.githubusercontent.com/wwu328763-netizen/dsh-billing-compass/main/market/index.json

1. 启用实验性市场 bundle @deepseek-ai/dsh-experimental-plugin-market-bundle(默认关闭)

2. 设置 → 插件 → Discover → 添加索引,粘贴上面的地址

3. 在本插件条目上点安装(底层是

git+https://github.com/wwu328763-netizen/dsh-billing-compass.git#<commit>)

4. 重启 Harness

DSH 目前没有集中托管的官方市场:market 只是一个"读索引"的客户端,索引谁托管都行。

本仓库的 market/index.json 就是一份现成索引,你可以 fork 后维护自己的索引。

配置凭据

两个键写在 <DSH_HOME>/.credentials.yaml,或用同名环境变量。

DEEPSEEK_API_KEY —— 余额

到 platform.deepseek.com/api_keys 创建,sk- 开头。

DEEPSEEK_USER_TOKEN —— 官网用量与消费(可选)

这是登录态 token,不是 API key,需要自己从浏览器取:

1. 浏览器登录 <https://platform.deepseek.com>

2. F12 → Application / 应用 → Local Storage → https://platform.deepseek.com

3. 找 userToken,复制其值(通常 64 位)

version: 1
refs:
  DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
  DEEPSEEK_USER_TOKEN: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

这是官网内部接口,可能随官网改版失效。失效时只会影响"官网用量/消费"两块,余额与本地统计不受影响。

可选配置

- insert:
    - id: dsh-billing-compass
      name: dsh-billing-compass
      config:
        balanceKeyRef: DEEPSEEK_API_KEY       # 换成自己的凭据名
        platformTokenRef: DEEPSEEK_USER_TOKEN
        balanceIntervalMs: 30000              # 余额刷新
        officialIntervalMs: 120000            # 官网用量/消费刷新(并行拉取)
        retryIntervalMs: 30000                # 失败/未配置时的重试
        sessionLog: true                      # 关掉则不解析本地会话日志
        pricing:                              # 单价覆盖,USD / 1M tokens
          deepseek-v4-flash: { input: 0.28, cacheHit: 0.028, output: 0.42 }
          deepseek-v4-pro:   { input: 0.55, cacheHit: 0.14,  output: 2.19 }

性能设计

面板打开到出数是毫秒级,靠三条约束:

措施 · 效果(本机实测)

官方接口并行,不再串行 · 4 个请求(用量×2 + 消费×2):1282ms → 904ms(冷 TLS;热连接更低)

HTTPS keep-alive 连接池 · 余额每 30s 一次,跳过重复 TLS 握手

会话日志移出请求路径 · 路由响应 0–1ms;日志由后台间隔增量刷新

会话日志是只追加的多帧 zstd 流,因此:

• 首次全量解析(约 4MB → 20MB 文本,~175ms),之后只解码新增的帧,长会话不会越跑越慢
• 路由只读缓存值,缓存过期时丢到后台刷新,永不阻塞响应
• 文件被轮转/缩短时自动重新全量解析

计算口径

单次/整段费用 ≈ (未缓存输入 + 缓存写) × input
              + 缓存读 × cacheHit
              + 输出 × output            （单位:USD / 1M tokens）

每亿 token 消费 = 消费金额 ÷ (tokens ÷ 100,000,000)
综合每亿 token = 官网消费合计 ÷ (官网 tokens ÷ 100,000,000)

• 官网数据以官网为准,但可能有数小时延迟,且只覆盖最近约两个月
• 本次运行 / 整段对话是按内置单价表的估算,与官网账单会有偏差(缓存计费口径、重试请求、单价变动等)
• 模型名匹配不到单价表时:含 flash 按 flash 价、含 pro/reasoner 按 pro 价,其余用默认价

隐私

• 不写任何文件;不采集、不上传任何内容
• 实时统计只在内存,重启清零
• 会话日志只读(汇总 token 用量),不修改
• 唯一外部请求是 DeepSeek 官方三个接口

常见问题

现象 · 处理

统计条里没有"余额 …" · 未装成功或未重启;检查 profile 的 cordis.patch.yml 与 profiles/node_modules

显示"余额 未配置" · 缺 DEEPSEEK_API_KEY

"官网消费/用量 未配置" · 缺 DEEPSEEK_USER_TOKEN(可选功能)

官网数据"获取失败 HTTP 401" · token 过期,重新取一次

"本对话消费(整段)" 与"本次运行"相同 · Node < 22.15 不支持 zstd,或 sessionLog: false

面板位置/宽度不对 · 该 Harness 版本的输入框 DOM 变了,欢迎提 issue 并附版本号

改了代码不生效 · 宿主模块被缓存,重启 Harness;客户端改动刷新页面

目录结构

lib/index.js       宿主:HTTPS 抓取、ZIP/CSV、zstd 会话日志、/api/dsh-billing 路由
lib

…(truncated)