在使用 DeepSeek Harness (DSH) 进行开发或调用服务时,经常需要打开网页或第三方平台查看 API Key 的余额或订阅额度,这会打断操作流。下面介绍一个 Web GUI 插件,它能在 DSH 界面右下角常驻显示用量卡片,解决频繁查看余额的问题。
插件简介¶
插件名称为 loommii/dsh-provider-usage,由 loommii 维护,开源协议为 MIT。这是一个 Web GUI 插件,核心功能是在 DSH 的 Web 界面右下角悬浮显示 AI 服务的用量或余额,支持多实例配置和本地 Token 统计。
核心功能¶
- 常驻右下角悬浮用量卡片:在主界面右下角显示用量或余额,位置可拖动。
- 自动刷新:每 30 秒自动更新数据;点击卡片上的 ↻ 可手动刷新。
- 多实例配置:支持同时配置多个提供方(如多个账号),点击卡片上的 Logo 或名称可切换查看。
- 本地 Token 统计:读取本地会话文件进行离线统计,不联网。
- API Key 加密存储:密钥仅在 DSH 进程内使用,界面显示时打码,支持 AES-256 加密。
安装与启用¶
安装前请确保已安装 DSH。安装命令如下:
# 安装
dsh plugin --profile web add github:loommii/dsh-provider-usage
安装后重启 dsh web 即可生效。
典型用法¶
- 打开 DSH 设置,进入「用量中心」。
- 点击「提供方」添加实例:
- OpenCode Go:支持订阅查询。
- DeepSeek:支持余额查询。
- Command Code:支持订阅/余额查询。 - 添加账号后,返回主界面,右下角会出现用量卡片。
注意事项¶
- 密钥安全:密钥仅在 DSH 进程内使用,界面显示时打码,不会上传或泄露。
- 本地统计:本地 Token 统计功能不联网,仅读取本地会话文件。
可选配置项¶
插件支持部分配置项,默认值通常可用。如需调整,可写入 profile 的 bundle 配置(cordis.patch.yml 或设置页):
| 配置项 | 默认值 | 说明 |
|---|---|---|
timeoutMs |
15000 |
出站请求超时。 |
subscriptionTimeoutMs |
5000 |
Command Code 订阅端点超时。 |
maxSessions |
30 |
本地 Token 统计扫描的会话文件数上限。 |
sessionsDir |
$DSH_HOME/sessions |
本地 Token 统计的会话目录。 |
更多细节可查阅 GitHub 仓库。