前言¶

在 DeepSeek Harness（DSH）里把 GLM Coding Plan 配成 coding 路由后，套餐额度是滚动窗口：5 小时 token 窗口、Pro/Max 还有本周窗口，另有内置工具 30 天次数。智谱侧往往在额度用尽时以 1310 一类错误才暴露问题，会话中途才发现「已经打满」会打断开发节奏。下面介绍社区插件 glm-quota-monitor（维护者 XJPeng12，目录分类 admin-security）：在 Web GUI 设置页、输入框 dock 和 Agent 工具三条路径上展示剩余比例与重置时间，查询走账务 monitor 接口，不跑模型、不消耗套餐额度。

这是什么¶

GLM Quota Monitor 是为 DSH 编写的 GLM Coding Plan 额度监控插件。它从 DSH 凭据库解析 ZAI_CODING_CN_API_KEY（与 GLM coding 模型路由同一密钥），调用智谱 open.bigmodel.cn/api/monitor/usage/quota/limit，把返回的百分比归一化为界面与工具可用的结构。插件包名 @local/glm-quota-monitor，当前仓库 package.json 版本为 1.0.6，许可证 MIT。社区目录页：https://www.skillhub.cn/plugins/XJPeng12/glm-quota-monitor；源码：https://github.com/XJPeng12/glm-quota-monitor。

核心功能¶

设置页「GLM 额度查询」¶

路径：设置 → 左侧栏。展示套餐档位（LITE / PRO / MAX）、数据更新时间；每个 token 窗口的剩余 % / 已用 %、彩色进度条、重置时间（绝对时刻 + 倒计时）。内置工具 30 天次数显示剩余 / 已用，并按工具拆分明细。支持手动刷新，以及自动刷新频率（1 分钟～3 小时或关闭，选择会记忆）。

输入框下方 dock¶

在会话输入框下方常驻极简一行，例如 5h 剩 xx% · x小时x分后重置。升级到 Pro/Max 后，dock 会自动多出「本周窗口」一栏；Lite 仅 5 小时窗口。

Agent 工具 glm_quota_check¶

在任意会话中可直接提问「我还剩多少额度」等，Agent 会调用该工具返回当前额度概况，无需单独打开设置页。

密钥与刷新成本¶

默认零配置密钥：每次请求从 DSH 凭据库读取 credentialRef（默认 ZAI_CODING_CN_API_KEY），不落插件配置、不回显 Key。刷新调用的是 monitor 接口，不消耗 Coding Plan 的模型调用额度。

数据窗口说明¶

智谱接口只返回百分比（percentage 表示已用比例），不提供具体 token 数。

安装与启用¶

环境要求：DSH 桌面版或 Web 版；profile 中已挂载 dsh-credentials、dsh-host-webserver、dsh-tools（常见默认组合已包含）。

官方 README 给出的步骤如下（安装方式为目录 bundle，不是 dsh plugin add github:... 一类命令）。

1、克隆仓库到本地（示例为 PowerShell）：

git clone https://github.com/XJPeng12/glm-quota-monitor.git

2、在 DSH 会话中让 Agent 安装，或自行调用 Plugin Manager，目标为克隆目录的绝对路径：

请安装插件 bundle：<克隆目录的绝对路径>

等价命令：

plugin_manager install_bundle target=<绝对路径>

安装后刷新 Web GUI（F5）生效。插件以 link: 协议目录链接方式安装；改源码后需 remove_bundle 再 install_bundle 更新；若替换已安装版本，需重启 DSH 才能加载新模块。

卸载：

plugin_manager remove_bundle target=@local/glm-quota-monitor

刷新页面即可。

典型用法¶

• 完整详情与刷新策略：打开 设置 → GLM 额度查询，查看各窗口与内置工具次数，按需点手动刷新或设置自动刷新间隔。
• 会话中扫一眼：看输入框下方 dock 的 5h（及 Pro/Max 的周窗口）剩余比例与重置倒计时。
• 对话查询：在会话里问「GLM 额度还剩多少」，由 Agent 通过 glm_quota_check 回答。

可选配置¶

插件行（cordis.patch.yml 中 config）支持：

不要把 Key 写进 apiKey：该字段以明文落在 profile 配置里，能读 profile 目录的人可见。首选默认行为——通过 credentialRef 从凭据库解析。

工作原理（概要）¶

Host 半（index.js）注册同源路由 GET /glm-quota-usage（响应体 v 字段标记版本代次），实时请求智谱 monitor 接口并归一化，带 Origin 校验；同时注册 glm_quota_check。Client 半（client.js）注册 settings.section 与 conversation.composer.dock，共享页面级取数 store；自动刷新频率存 localStorage，倒计时约每 30 秒重绘。样式使用 --dsw-alias-* 主题 token，跟随宿主明暗主题。

适用场景与注意¶

适合已在 DSH 中配置智谱 GLM Coding Plan、且希望提前掌握滚动窗口与内置工具次数的开发者或团队管理员。目录站点 SkillHub 为社区生态索引，与 DeepSeek / 幻方无官方从属关系；安装前建议通读仓库源码与 MIT 许可证。插件在当前 DSH 进程权限下运行，Host 路由会代表 profile 访问凭据与上游 HTTPS 接口——仅安装你信任来源的 bundle。

结尾¶

经过上面的步骤，glm-quota-monitor 把额度从「报错后才知道」变成设置页、dock 和 Agent 工具上的可观测信号，且查询不占用模型额度。需要安装说明与配置细节时，以 GitHub README 为准：

• 目录页：https://www.skillhub.cn/plugins/XJPeng12/glm-quota-monitor
• 仓库：https://github.com/XJPeng12/glm-quota-monitor