dsh-plugin-glm-balance

English | 中文

GLM (bigmodel.cn) quota balance indicator for the DeepSeek Harness web GUI.

A quota widget beside the composer's context meter — shown only when the session's current model provider matches the configured provider id (default zai-coding-cn).

Features

• Two mini progress bars (hourly / weekly credit limits) with percentage and next-reset time, styled with the harness --dsw-* theme tokens (works with light/dark and third-party themes such as Dracula).
• Polls on a configurable interval (default 30 minutes); click to refresh immediately, with a spinner while the request is in flight.
• Right-click menu: open the usage page on bigmodel.cn, or refresh.
• Auth-token states: no token / auth invalid (click shows how to fix) / upstream failure.
• Its own "GLM Balance" settings section (Settings → GLM Balance) to paste the authorization header, configure the provider id, and set the auto-refresh interval.

Install

dsh plugin --profile web add dsh-plugin-glm-balance

Or straight from GitHub (no npm publish needed):

dsh plugin --profile web add https://github.com/HoodyHuo/dsh-plugin-glm-balance.git

Or install from source:

dsh plugin --profile web add E:\path\to\dsh-plugin-glm-balance

Restart dsh web afterwards (the host half registers proxy routes).

Update

git -C <repo-or-clone> pull                 # when installed from a clone
dsh plugin --profile web add https://github.com/HoodyHuo/dsh-plugin-glm-balance.git   # re-install = update

Then restart dsh web. The token file ~/.dsh/glm-balance.json is never touched by an update. See CHANGELOG.md for what changed in each version.

Configuration

The plugin proxies GET https://bigmodel.cn/api/monitor/usage/quota/limit through two same-origin host routes (avoiding browser CORS):

• GET/POST /glm-balance/api/config — stored credentials
• GET /glm-balance/api/usage — proxied quota query

The token persists in glm-balance.json under the harness home (~/.dsh/glm-balance.json by default):

{
  "authorization": "your bigmodel.cn authorization header value",
  "providerId": "zai-coding-cn",
  "refreshMinutes": 30
}

Edit the file, or use Settings → GLM Balance. No restart needed for token changes; the indicator picks them up on the next poll (or click).

Notes

• The authorization value is whatever bigmodel.cn expects in the header — copy it from your browser's devtools request headers.
• Quota unit mapping follows the observed API: 3 → hourly, 6 → weekly.
• The token is stored in plain text inside the harness home, the same trust domain as the rest of the harness configuration.

License

MIT

---

DeepSeek Harness Web GUI 的 GLM（智谱 bigmodel.cn）套餐余额指示器插件。

在输入框上下文用量圆环旁显示额度条，仅当会话当前模型供应商匹配配置值 （默认 zai-coding-cn）时显示。

功能

• 两条迷你进度条（5 小时 / 每周额度），含百分比与下次重置时间；颜色走 --dsw-* 主题 token，自动适配明暗与第三方主题（如 Dracula）；
• 可配置的自动刷新间隔（默认 30 分钟），点击立即刷新并显示加载动画；
• 右键菜单：打开 bigmodel.cn 用量页面、刷新（点击其他位置关闭）；
• 认证状态提示：未配置 / 认证失效（点击提示修复方法）/ 获取失败；
• 设置页独立分区「GLM 余额」：填写 authorization、供应商 ID 与自动刷新间隔。

安装

dsh plugin --profile web add dsh-plugin-glm-balance

或直接从 GitHub 安装（无需发布到 npm）：

dsh plugin --profile web add https://github.com/HoodyHuo/dsh-plugin-glm-balance.git

或从源码安装（安装后需重启 dsh web，宿主半要注册代理路由）。

更新

git -C <克隆目录> pull          # 以克隆方式使用时
dsh plugin --profile web add https://github.com/HoodyHuo/dsh-plugin-glm-balance.git   # 重新安装即更新

然后重启 dsh web。更新不会触碰 token 文件 ~/.dsh/glm-balance.json。 各版本变更见 CHANGELOG.md。

配置

Token 存放在 harness 主目录下的 glm-balance.json（默认 ~/.dsh/glm-balance.json）：

{
  "authorization": "bigmodel.cn 请求头里的 authorization 值",
  "providerId": "zai-coding-cn",
  "refreshMinutes": 30
}

可直接编辑该文件，或在 设置 → GLM 余额 分区填写；改完无需重启，下次轮询（或点击刷新）即生效。

说明

• authorization 的值从浏览器 devtools 的请求头里复制；
• 额度 unit 映射按实测 API：3 → 小时，6 → 每周；
• token 以明文存于 harness 主目录，与 harness 其他配置同一信任域。

License

MIT