前言¶
在 DSH Web 中使用 DeepSeek API 时，查看剩余额度、配置低余额提醒、打开充值入口通常需要额外操作。dsh-balance-display 是一个 DSH 客户端插件，把余额展示放在 Web GUI 左侧栏底部，并支持余额趋势、低余额预警和一键充值。
这是什么¶
dsh-balance-display 由 zhangjianyu1006156 维护，许可证为 MIT，分类为客户端。它面向 DSH Web 场景，在左侧栏底部显示 DeepSeek API 的剩余额度，并在设置页提供「余额显示」配置入口。
核心功能¶
余额胶囊¶
- 在左侧栏底部显示余额。
- 点击可刷新。
- 悬浮时显示充值/赠送拆分。
低余额预警¶
- 余额低于阈值时，圆点变红，并显示悬浮警告。
- 可配置浏览器通知；使用浏览器通知需要授权通知权限。
- 默认低余额预警阈值为
¥5。
精度与趋势¶
- 余额小于
¥1时，显示 4 位小数。 - 设置页展示 sparkline 趋势图，并给出今日/近 7 天消耗统计。
- 余额历史与偏好存于浏览器
localStorage，键名前缀为dsh.balanceDisplay.*；主机端不感知、不存储。
充值与重试¶
- 胶囊和设置页均可一键打开
platform.deepseek.com/usage。 - 连续失败时，刷新间隔自动递增。
- 切换标签页时暂停刷新，返回后立即刷新。
主题与协作¶
- 支持浅色、深色和跟随系统。
- 中英文界面跟随 dsh 语言设置实时切换。
- 可在系统提示中声明插件，供智能体在余额过低时提醒用户充值。
安装与启用¶
安装命令如下：
dsh plugin --profile web add dsh-balance-display
本地开发模式可使用：
dsh plugin --profile web add link:/path/to/dsh-balance-display
安装后重启 dsh web。侧边栏底部会出现余额胶囊，设置页会出现「余额显示」tab。
典型配置¶
在设置页「余额显示」tab 中，可配置：
- 侧边栏显示余额角标。
- 自动刷新间隔；默认为 10 分钟。
- 低余额预警阈值；默认为
¥5。 - 余额不足时浏览器通知。
- Agent 协作，即在系统提示中声明插件。
安全与运行边界¶
- 密钥全程只在主机端，浏览器端只从本机回环路由拉取脱敏后的余额 JSON。
dsh web默认仅绑定127.0.0.1，路由仅 GET（余额）与 GET/POST（announce 配置），不加 CORS 头。- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 浏览器通知需要浏览器授权通知权限。
兼容性与环境¶
- 兼容桌面打包版（内嵌 dsh
rc.5）与官网 npm 版dsh web（rc.6）。 package.json要求node >=22.19。
测试¶
主机端测试可运行：
node /tmp/test-balance-host.mjs
客户端测试可运行：
node /tmp/test-balance-client3.mjs
适用场景¶
适合经常通过 DSH Web 使用 DeepSeek API，希望在不离开 Web 界面时查看余额、配置低余额预警、查看近期消耗并快速跳转充值的开发者。
