dsh-balance-monitor：DSH Web 侧边栏余额与用量监控插件

DSH 理念是“一切皆插件”。在多渠道 API 开发中，实时监控余额与用量是刚需。下面介绍 dsh-balance-monitor，一款在 DSH Web 侧边栏展示余额与用量的插件。

是什么¶

该插件由 ShawnKung 维护，解决多渠道 API 账户管理繁琐的问题。它可以在 DSH Web 侧边栏直接查看所选渠道的余额与 Token 用量详情，支持 DeepSeek 官方 API 和 TeamoRouter，并具备自动刷新与主题适配能力。

安装与启用¶

安装前请确保已安装 DSH（版本 >= 0.1.7-rc.1）并运行 dsh web，环境需满足 Node.js >= 20。

使用官方 npm 包安装最新版本：

dsh plugin --profile web add @shawnkung/dsh-balance-monitor@latest
dsh plugin --profile web list

安装完成后，重启 DSH Web 进程，并在浏览器中执行硬刷新（macOS：Cmd+Shift+R；Windows/Linux：Ctrl+Shift+R）以加载插件。

核心功能¶

1. 侧边栏展示
   在“新会话”或工作区之间，侧边栏显示所选渠道的余额概览。

2. 详情弹窗
   点击侧边栏入口，弹窗展示各渠道的详细数据，包括消费金额、请求数和 Token 用量。

3. 自动刷新
   支持会话结束后自动刷新对应渠道，也支持手动点击刷新按钮。插件会检查 npm 最新版本并在启动时提示更新。

4. 主题适配
   支持浅色、深色和跟随系统主题。

5. 渠道支持
   支持的渠道包括：DeepSeek 官方 API、Kimi 官方 API、智谱 GLM 和 TeamoRouter。

配置¶

进入 DSH 侧边栏的“插件”，打开 @shawnkung/dsh-balance-monitor 配置项：

1. 侧边栏展示渠道
   默认仅展示 DeepSeek，可多选，最多展示 3 个渠道。

2. 余额保留位数
   通过滑块控制显示精度，默认保留 2 位，可选无小数位、1 至 6 位或精确。

3. API Key 凭据引用
   配置各渠道的 Key 来源，默认引用环境变量。例如：

   • DeepSeek：DEEPSEEK_API_KEY
   • Kimi：KIMI_API_KEY
   • 智谱 GLM：ZAI_API_KEY
   • TeamoRouter：TEAMO_API_KEY

4. TeamoRouter 统计天数
   配置区间统计范围，支持 2 至 90 天。

依赖与兼容性¶

• DSH 版本：>= 0.1.7-rc.1 < 0.2.0
• Node.js 版本：>= 20
• Profile：仅支持 Web
• 许可证：MIT

安全说明¶

API Key 仅通过 DSH 的 credentials 服务解析和写入，明文 Key 不会发送到浏览器。插件运行在 DSH 进程权限下，仅读取必要的配置文件。

相关链接¶

• GitHub 仓库
• 社区目录