DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

wwu328763-netizen /

wwu328763-netizen/dsh-billing-compass

Verified

DeepSeek Harness 计费罗盘:余额 / 官网用量与消费 / 按模型花费 / 实时费用估算

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@f4a80e0b

计费罗盘 · Billing Compass

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

license node platform deps dsh

计费罗盘界面预览

预览图按插件真实 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 可选 逐项显示"未配置",其它数据照常

安装

方式一:bundle 安装(推荐)

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

在 Harness 里让 Agent 用 plugin_manager 安装该目录(或你自己在设置里装),然后重启 Harness:

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: {}
  1. 把 dsh-billing-compass 写进同目录 package.json 的 dependencies
  2. 重启 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/client.js      客户端:统计条 + 点击弹出面板(React.createElement,无构建)
cordis.patch.yml   bundle 注册行(含可选项说明)
locale/{en,zh}.json  插件管理里显示的标题与描述
icon.svg           应用图标
docs/              README 用图

调试图中数据:GET http://127.0.0.1:<port>/api/dsh-billing?sessionId=<id> 直接返回完整快照。

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit f4a80e0b65fe

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout