dsh-balance

English | 中文

一个 DeepSeek Harness 插件：为 Web GUI 添加 /balance 斜杠命令和对话框底部常驻的余额显示，实时查询 DeepSeek 账户余额。

它调用 DeepSeek 官方 查询余额 接口，返回每种货币的总额、充值与赠送余额。API key 通过凭证服务（ctx.credentials）或环境变量按次解析——绝不写入配置、返回文本或进入浏览器。

功能

• /balance — 人用斜杠命令，在会话里输出完整的余额明细。
• Web GUI 底部余额条 — 对话页统计条区域（缓存命中率下方）显示简洁的 余额: ¥…，hover 显示充值/赠送详情，附带 充值 链接（跳转 DeepSeek 平台充值页）、手动刷新按钮，以及估算的 本会话 ≈ ¥… 花费（hover 显示 token 分桶 × 单价）。浏览器只请求宿主端的 /dsh-balance 路由；API key 始终留在宿主端。文案双语，跟随 dsh 当前语言（中文 / English）。
• 每日消耗图 — 近{days}天 ≈ ¥… 开关就地展开一张内联 SVG 柱状图，展示最近 usageDays 天的估算花费（hover 柱子显示日期与金额）。数据来自宿主端 /dsh-usage 路由：遍历已持久化的会话，折叠 assistant/message 的用量，并按每次请求发生时所在的时段单独计价。

会话花费估算

本会话 ≈ ¥… 按 DeepSeek 公布的每百万 token 单价（高峰/空闲分档，按当前北京时间自动选择），对会话累计 token 用量计价——数据源与统计条「缓存命中率」用的是同一个 tokenUsage 投影。这是估算值，不是账单记录：模型取配置的 estimateModel（而非每个请求实际使用的模型），缓存写入 token 不计价。价格可通过 offpeakPrices / peakMultiplier / peakWindows 配置项调整。

兼容性

已在 DeepSeek Harness 0.1.0-rc.6（web profile，Windows 11）上实测通过——/balance 命令与对话框底部余额条均于 2026-08-14 在线验证。npm 上的 @deepseek-ai/dsh-* 包处于 pre-release（无兼容性承诺）；若新版 dsh 改变了 conversation.composer.dock 槽位或 webServer 服务，请重新验证并提交 issue。

安装

方式 A：dsh plugin（推荐）

推送后执行：

dsh plugin --profile web add github:deepforce/dsh-balance

把 github:deepforce/dsh-balance 换成你的实际 git 地址。该 bundle 同时安装两部分：宿主端插件（斜杠命令 + /dsh-balance 路由）和浏览器端底部余额条插件（因为包声明了 dsh.client）。安装后重启 dsh web，让客户端插件表扫描到新条目。

方式 B：--patch overlay

# balance.cordis.yml
- insert:
    - id: balance
      name: '@deepforce/dsh-balance'

dsh web --patch "$PWD/balance.cordis.yml"