余额悬浮卡 ADDD1118/dsh-balance

dsh-balance

一个 DeepSeek Harness (dsh) 的用户级插件，在 Web UI 右上角显示一个可拖动的悬浮 DeepSeek 余额卡片，并在 设置 → 插件 配置页面中提供一张 “调整大小” 卡片。

- 透明鲸鱼娘吉祥物 + 悬浮玻璃卡片
- 预计可用天数、实时余额，以及所选对话的 token 用量 + 费用（随活动会话自动切换）
- 基于近 7 天与近 30 天用量的加权/趋势日均消耗估算
- 视口边界钳制 + 吸附到左/右/下边缘
- 一张用于调整卡片宽度的设置卡（设置 → 插件配置 → dsh-balance）

环境要求

- DeepSeek Harness (dsh) Web 界面（dsh web），v0.1.0+
- Node 22+（使用内置 fetch）

安装

将插件添加到你的 web profile，然后注册插件行。

dsh plugin --profile web add /dsh-balance

在 ~/.dsh/profiles/web/cordis.patch.yml 中追加：

- insert:
- id: dsh-balance
name: dsh-balance

重启 dsh web 并强刷浏览器（Ctrl+F5）。

插件已预构建（lib/index.js + lib/client.js），并自带默认吉祥物图片，因此开箱即用——无需构建步骤，也无需手动设置素材。

DeepSeek 余额卡片

吉祥物图片

插件自带一张默认吉祥物（女孩 / 鲸鱼娘）并自动提供。若要使用其他图片，请将一张透明 PNG 放到 ~/.dsh/.dsh-balance-mascot.png（以 no-store 实时刷新，因此替换后只需刷新浏览器），或通过 DSH_BALANCE_MASCOT 环境变量覆盖路径。若均未设置，则使用自带的默认图片。

定价

预计可用天数的费用使用按模型单价计算。参见 ~/.dsh/.dsh-balance-pricing.json（首次运行时创建），以设置 2026-08-17 前后两档的每百万 token 价格（人民币）。

工作原理

- /dsh-balance-card 返回余额、加权/趋势估算值以及 config.width；浏览器据此缩放卡片。
- /dsh-session-usage?sessionId=… 返回所选对话的 token 用量 + 费用。
- 设置命名空间 dsh-balance（schema 为 { width }）由宿主注册，并可在 设置 → 插件 中编辑。

功能

为 DeepSeek Harness (dsh) 的 Web 界面新增一个可拖动的悬浮余额卡片（默认在右上角），并在 设置 → 插件 → 插件配置 里提供一张调整大小的配置卡。

- 透明鲸鱼娘素材 + 悬浮玻璃卡片
- 显示预计可用天数、实时余额，以及当前选中对话窗口的任务用量与消耗费用（随会话切换自动更新）
- 基于近 7 天与近 30 天用量的加权/趋势日均消耗来估算剩余可用天数
- 视口边界钳制（不会拖出屏幕）+ 靠近左/右/下边自动吸附
- 一张调整大小的设置卡（设置 → 插件配置 → dsh-balance）

环境要求

- DeepSeek Harness (dsh) Web 界面（dsh web），v0.1.0+
- Node 22+（使用内置 fetch）

安装

将插件加入 web profile，并注册插件行。

dsh plugin --profile web add /dsh-balance

在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
- id: dsh-balance
name: dsh-balance

重启 dsh web 并强刷浏览器（Ctrl+F5）。

插件已预构建（lib/index.js + lib/client.js），并自带默认鲸鱼娘素材，开箱即用——无需构建、无需手动放置素材。
DeepSeek 余额卡片

素材图（可选）

默认已打包鲸鱼娘素材，自动提供。如需换成其他图：把透明 PNG 放到 ~/.dsh/.dsh-balance-mascot.png（改动实时生效，no-store，强刷即可），或用 DSH_BALANCE_MASCOT 环境变量指定路径。若未设置，则使用打包的默认图。

单价配置

"预计可用天数"按各模型单价估算。首次运行后编辑 ~/.dsh/.dsh-balance-pricing.json 可设置 2026-08-17 前/后两档的每百万 tokens 单价（CNY）。

工作原理

- /dsh-balance-card 返回余额、加权/趋势预估与 config.width，浏览器据此缩放卡片。
- /dsh-session-usage?sessionId=… 返回所选会话的用量与费用。
- 宿主注册 dsh-balance 设置命名空间（schema 为 { width }），可在 设置 → 插件 中编辑。

License / 许可证

MIT