dsh-balance

English | 中文

一个 DeepSeek Harness Web GUI 插件，在会话输入框上方的统计栏里直接显示你的 DeepSeek 账户余额和本次 会话的 token 花费：

会话 ¥31.19 · 本步 ¥2.60 · 余额 ¥49.81 · TPS 12.3 tok/s

• 会话 — 本次会话所有已完成步骤的累计花费。
• 本步 — 最近一个上报了 token 用量的步骤的花费。
• 余额 — 实时账户余额，来自 DeepSeek 官方余额接口，缓存 60 秒。
• TPS — 生成吞吐，复用 dsh-live-stats 的 liveTokenUsage 投影合并显示。

该行是单行，替换掉原来独立的 TPS 行，其余界面不变。

工作原理

插件分两半：

1. host 半区（src/index.ts）注册 HTTP 路由 GET /api/dsh-balance/balance，从 ~/.dsh/.credentials.yaml 读取你的 DeepSeek API key，调用 https://api.deepseek.com/user/balance 并返回 JSON。它还注册会话投影（dshBalanceUsage），把 assistant/message 事件折叠成精确的逐步 token 计数（可重放，刷新后仍保留）。
2. browser 半区（src/client/）根据投影渲染统计行，并轮询余额路由。

花费按 DeepSeek 官方定价（元 / 百万 tokens）估算，北京高峰时段 （09:00-12:00、14:00-18:00）按 3 倍计。无法识别的模型 id 回退到更高的 v4-pro 单价，因此估算不会偏低。

安装

需要 Node.js ^22.19 || >=24，以及带 web profile 的 dsh CLI。

从仓库安装

git clone https://github.com/milesc1616-hue/dsh-balance.git
cd dsh-balance
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)

安装后重启 dsh web（或刷新 Web GUI）。

安全模型

• 你的 DeepSeek API key 只会在 host 进程内 读取和使用，绝不会发送到 浏览器；浏览器只通过上面那条仅限回环的接口拿到余额数字。
• 余额路由仅允许回环请求，并拒绝跨站请求。
• 插件只调用官方 api.deepseek.com 接口。

已知限制

• 花费是估算值：使用当前官方定价与固定高峰时段。优惠额度、账户折扣、 价格调整不会体现在结果中。
• 余额缓存 60 秒，可能短暂滞后。
• 若 ~/.dsh/.credentials.yaml 中没有 API key，余额显示 …，不发起上游 请求。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build

许可证

BSD-3-Clause。见 LICENSE。

本插件派生自 dsh-web-ui 插件家族。