dsh-plugin-glm-balance:在 DSH Web 输入框旁显示智谱 GLM 套餐额度

前言

用 DeepSeek Harness(DSH)Web GUI 跑智谱 GLM(bigmodel.cn)Coding Plan 时,上下文用量圆环能反映当前会话,但小时额度、周额度是否快用完,通常要另开浏览器查 bigmodel.cn 用量页。频繁切换窗口既打断节奏,也容易在额度触顶后才注意到。

下面介绍社区插件 dsh-plugin-glm-balance(维护者 HoodyHuo,分类:联网工具):在 composer 输入框旁的上下文用量指示器附近挂载 GLM 套餐额度条,并在设置里集中配置 authorization 与自动刷新。本文事实均来自 GitHub 仓库 README 与 package.json(当前版本 0.2.0,MIT 许可证)。

这是什么

dsh-plugin-glm-balance 是 DSH Web 平台插件,面向 bigmodel.cn 的套餐额度查询与展示。插件通过宿主代理同源路由访问 GET https://bigmodel.cn/api/monitor/usage/quota/limit,避免浏览器 CORS;额度 widget 仅当会话当前模型供应商 ID 与配置一致时显示(默认 zai-coding-cn)。

核心功能

额度展示

  • 两条迷你进度条:分别对应 API 实测映射下的小时额度(unit 为 3)与每周额度(unit 为 6),显示百分比与下次重置时间。
  • 样式使用 harness 的 --dsw-* 主题 token,可随明暗模式及第三方主题(README 举例 Dracula)变化。

刷新与交互

  • 按可配置间隔自动轮询(默认 30 分钟);点击 widget 立即刷新,请求进行中显示加载动画。
  • 右键菜单:打开 bigmodel.cn 用量页面,或执行刷新;点击其他区域关闭菜单。

认证与状态

  • 未配置 token、认证失效、上游请求失败等状态会在界面上区分提示;认证失效时点击可查看修复指引。
  • 设置页独立分区 GLM 余额(Settings → GLM Balance):填写 authorization、供应商 ID(providerId)、自动刷新间隔(refreshMinutes)。

安装与启用

插件通过 dsh plugin --profile web add 安装。安装后需重启 dsh web,以便宿主半注册代理路由(GET/POST /glm-balance/api/config、GET /glm-balance/api/usage)。

从插件名安装(README 给出的方式之一):

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

本地源码路径安装(示例为 Windows 路径,按实际目录替换):

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

更新时,若以克隆目录维护,可在该目录 git pull 后重新执行 GitHub 安装命令;然后同样重启 dsh web。更新不会修改已保存的 token 文件 ~/.dsh/glm-balance.json。各版本变更见仓库内 CHANGELOG.md。

典型用法:配置 authorization

authorization 取值为 bigmodel.cn 请求头中同名字段的内容,README 建议从浏览器开发者工具的网络请求头里复制。

方式一:设置页

打开 DSH Web 设置 → GLM 余额,粘贴 authorization、确认供应商 ID(默认 zai-coding-cn)、设置自动刷新分钟数。修改后无需重启服务,下次轮询或点击刷新即生效。

方式二:编辑配置文件

凭证与选项默认写在 harness 主目录下的 glm-balance.json(路径默认为 ~/.dsh/glm-balance.json):

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

完成配置后,在 Web GUI 中将当前会话模型供应商设为与 providerId 一致(默认即 zai-coding-cn),输入框旁应出现额度条;若显示未配置或认证失效,按界面提示核对 authorization 是否仍有效。

适用场景与注意

适合谁: 长期在 DSH Web 中使用智谱 GLM Coding Plan、需要对照小时/周额度安排会话的用户;希望额度信息与 composer 上下文用量同屏查看、减少反复打开 bigmodel.cn 的场景。

运行与信任边界: 插件在 DSH 进程内运行,token 以明文保存在 harness 主目录,与 harness 其他配置处于同一信任域。安装前建议自行查看 GitHub 源码 与 MIT 许可证,确认代理路由与存储方式可接受。

显示条件: 额度 widget 不会对任意供应商都显示;仅当当前会话 provider 与配置的 providerId 匹配时才挂载,避免无关模型会话下的多余请求。

结尾

dsh-plugin-glm-balance 把 bigmodel.cn 的小时/周套餐额度收进 DSH Web 输入框旁:可配置轮询、点击与右键刷新,并在 GLM 余额 设置分区或 ~/.dsh/glm-balance.json 中维护凭证。若你已在 harness 里固定使用智谱 GLM Coding Plan,可按上文命令安装并重启 dsh web 后配置 authorization 试用。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜