zoumutou/dsh-cost-balance

dsh-cost-balance

DeepSeek Harness（DSH）Web UI 插件：在输入框下方显示一条 iOS 风格的小黑条，点击展开轻盈的半透明多行面板，查看会话花费、账户余额、缓存命中、Token 用量等统计。

默认折叠为一条居中的小黑条（类似 iOS 底部横条），点击展开毛玻璃面板：

安装（npm 发布版）

dsh plugin --profile web add dsh-cost-balance

该命令从 npm registry 拉取已发布的 dsh-cost-balance（dsh.bundle），自动加入 profile 的 bundle 层。

然后重启（或刷新）DSH Web UI。卸载：dsh plugin --profile web remove dsh-cost-balance。

工作原理

• Client 半（lib/client.js）：注册在 conversation.composer.dock 槽位（接管 shipped 的 stats 单元格，与产品自带统计行同源同数据），展示折叠/展开 UI；通过同源 GET /api/cost-balance 读取数据，每 60 秒自动刷新，token 用量变化时即时重算。
• Host 半（lib/index.js）：经 webServer 注册 /api/cost-balance 路由——花费按会话累计 token（未命中输入 / 缓存命中 / 缓存写入 / 输出）× 模型单价计算；余额经 credentials 服务解析 DEEPSEEK_API_KEY 后调用 DeepSeek 官方 GET /user/balance（60s 缓存、失败 30s 抑制）。

余额取自用户自己的 API Key 账户，无需任何配置；未配置或抓取失败时面板显示 余额 --。

定价与覆盖

内置 DeepSeek 官方定价（USD / 1M tokens）：

DeepSeek 将于 2026-08-16 16:00 UTC 起切换峰谷计费（off-peak 为 peak 的一半）。价格变更时无需等插件更新——在 profile 的 cordis.patch.yml 里覆盖即可：

# ~/.dsh/profiles/<你的profile>/cordis.patch.yml
- id: cost-balance
  config:
    prices:
      deepseek-v4-flash:
        cacheHit: 0.014
        cacheMiss: 0.44
        output: 1.32

（覆盖是整行替换，务必保留 id: cost-balance。）

从源码安装（开发）

git clone https://github.com/zoumutou/dsh-cost-balance.git
cd dsh-cost-balance
dsh plugin --profile web add .

发布新版本：修改 package.json 的 version 后 npm publish（账号需 2FA 绕过 token，见 npm 文档）。

许可

MIT