dsh-balance-usage-widget

A tiny composer-dock widget for DeepSeek Harness (DSH). It shows your DeepSeek account balance and the current session's token usage in one line:

¥12.34 · 12.3K tok

Hover for the breakdown: topped-up balance, granted balance, uncached input, cache reads, cache writes, output tokens and cache-hit rate.

Community plugin. Not affiliated with or endorsed by DeepSeek.

中文说明

在 DSH 输入框下方的状态行显示“账户余额 + 本会话 token 用量”。

• 左边：DeepSeek 账号的充值余额（多币种用 / 分隔；低于 0.01 显示 <0.01）。
• 右边：本会话累计 token（未命中输入 + 缓存命中 + 缓存写入 + 输出）。
• 悬停：充值余额、赠金余额、本会话 token 分项和缓存命中率。
• 未登录或余额查询失败时显示 余额 --，token 仍正常显示。

安装

从 npm 安装（desktop profile 由桌面端独占管理时，请在界面里安装）：

dsh plugin --profile desktop add dsh-balance-usage-widget

或在 侧栏 → 插件 → 添加插件 中填写包名 dsh-balance-usage-widget，安装后重启 DSH。

本地开发时可在安装对话框里粘贴本目录的绝对路径。

隐私与边界

• 余额通过 DSH 客户端已有的 ctx.remote.account.getBalance 读取，与 设置 → 账号 同源；只读，不写文件。
• Token 来自 DSH 的 tokenUsage 会话投影，与“性能与用量 → 详细”同源。
• 不发起额外网络请求、不读取会话正文、不写任何文件。
• 余额每 60 秒刷新一次，页面重新可见时也会刷新。

How it works

• Host half: an empty bundle patch that inserts one row.
• Client half: a browser module that registers a conversation.composer.dock entry.
  • balance: ctx.remote.account.getBalance({ version, locale, timezoneOffsetSeconds })
  • tokens: useProjection('tokenUsage')
• No build step; client.js is the published browser artifact.

Compatibility

• DSH Web / Desktop 0.2.x (dsh.client bundle).
• Balance requires a DeepSeek account login. API-key-only setups show 余额 --, because the built-in account service does not expose balance for API keys.

Development

# local install into a throwaway profile
dsh plugin --profile <profile> add /absolute/path/to/dsh-balance-usage-widget

The package is plain ESM plus one browser module; there is nothing to compile.

License

MIT. See LICENSE.