GLM 额度悬浮条 Everglow28/dsh-glm-quota-dock

dsh-glm-quota-dock

DeepSeek Harness (DSH) 插件：在会话输入框下方的统计行内，常驻一个 GLM Coding Plan 额度 pill，实时显示各窗口用量百分比。

A lightweight DeepSeek Harness plugin that shows your GLM Coding Plan quota as an always-visible pill in the composer stats row.

◔ GLM 5h 9% · 周 45% · 工具 7%

截图

详情面板（底部统计行内可见 pill），三种额度状态独立着色：

| 正常（<80%，绿） | 告警（≥80%，黄） | 临界（≥95%，红） |
| 详情面板 正常(45%) | 详情面板 告警(88%) | 详情面板 临界(99%) |

三张图分别为 5 小时窗口 45% / 88% / 99% 的状态：pill 与对应进度条随窗口阈值同步变色；面板含逐条限额、重置时间、近 24 小时按模型用量与套餐档位。

特性

- 实时额度：输入框统计行内常驻 pill，30 秒轮询；每个窗口（5 小时 Token / 周额度 / 工具月度额度）独立着色 —— <80% 绿、≥80% 黄、≥95% 红
- 仅在 GLM 会话显示：通过会话的模型选择投影判断，只有当前会话走 Coding Plan 路由 且使用 glm-* 模型时才渲染；纯 API 计费路由（消耗余额而非套餐）不会误亮，非 GLM 会话完全零请求
- 点击详情：逐条限额进度条（独立着色）、重置时间（悬停看倒计时）、近 24 小时按模型 Token 用量、套餐档位与版本说明、手动强制刷新
- 空闲降频：页面可见但 5 分钟无操作时自动降为 5 分钟一轮，恢复操作立即刷新；最小化/切走完全停止
- 套餐版本自适应：V1（5h + 月度）、V2（含周窗口）、新版积分制均按响应字段自动识别展示，未知形状优雅回退
- 密钥不出本机：API Key 只在 Host 进程内解析与使用，浏览器仅拿到聚合后的百分比；路由挂在 DSH /api 信任栅栏与浏览器鉴权之后

要求

- DeepSeek Harness（Desktop 或 dsh web，建议较新版本）
- 已在 DSH 模型页配置 GLM Coding Plan 供应商（如 zai-coding-cn），其 API Key 会通过凭据引用自动解析（默认 ZAI_CODING_CN_API_KEY）

[!NOTE]
作者仅在 Lite 档（历史版本 V1：5 小时窗口 + 月度工具额度） 上实际验证过。V2（含周窗口）与新版积分制是按官方响应字段做的适配，逻辑上兼容但未经真机验证；如显示异常，欢迎提 issue 附上返回结构。

安装

插件零构建、零依赖，已发布到 npm，最简单的安装只需一条命令。

方式 A：npm（推荐）

dsh plugin --profile <你的profile> add dsh-glm-quota-dock

方式 B：让 DSH 会话里的 Agent 安装（任何 profile 通用）

把仓库地址交给 DSH 会话里的 Agent：

请用 plugin_manager 的 install_bundle 安装 https://github.com/Everglow28/dsh-glm-quota-dock

Agent 会克隆仓库并把 bundle 装进当前 profile，安装成功后按提示重启 DSH + 刷新网页即可。

方式 C：dsh CLI + git clone

git clone https://github.com/Everglow28/dsh-glm-quota-dock.git
dsh plugin --profile <你的profile> add <克隆目录的绝对路径>

方式 D：手动

把仓库克隆/复制到 ~/.dsh/profiles/<profile>/node_modules/dsh-glm-quota-dock/，并在该 profile 的 cordis.patch.yml 追加：

- insert:
- id: glm-quota-dock
name: 'dsh-glm-quota-dock'
config:
endpoint: https://open.bigmodel.cnyaml
minIntervalSec: 60

安装后重启 DSH（Host 半部需要随进程加载），再刷新网页（Client 半部）。

配置

在安装时生成的 Cordis entry 的 config 下调整（改完重启）：

| 字段 | 默认 | 说明 |
| endpoint | https://open.bigmodel.cn | 全球站用户改为 https://api.z.ai |
| minIntervalSec | 60 | 上游最小请求间隔（秒），下限 30 |
| apiKeyRef | ZAI_CODING_CN_API_KEY | 凭据引用名（与模型页写入的引用一致） |
| apiKey | 无 | 直接内联 key（不推荐，优先用凭据引用） |
| cwd | \ | 上游请求（curl）的工作目录，一般不用改 |

工作原理

凭据服务解析 API Key（与 zai-coding-cn 模型路由同一把 key） │ ▼ Host 半部调用官方监控端点（裸 key 鉴权，与官方 glm-plan-usage 一致）：
GET {endpoint}/api/monitor/usage/quota/limit ← 各窗口百分比/重置时间
GET {endpoint}/api/monitor/usage/model-usage ← 近 24h 按模型用量
│ 60s 内存缓存 + 并发去重 ▼ 注册认证路由 GET /api/glm-quota（DSH /api 信任栅栏 + 浏览器签名 cookie） │ ▼ Client 半部：同源 fetch，30s 轮询（空闲降频），渲染 pill 与详情面板

数据来自智谱官方监控接口（与官方 glm-plan-usage 插件同源），轮询频率保守，不触碰任何非公开接口。

卸载 bash
dsh plugin --profile <你的profile> remove "dsh-glm-quota-dock"

或让 Agent 调 plugin_manager remove_bundle。移除后重启 + 刷新页面。

常见问题

- pill 不显示？ 确认当前会话使用的是 Coding Plan 路由下的 glm 模型；确认凭据引用已配置（面板报错时悬停 "GLM !" 可看原因）；Host 半部改动需要重启而非刷新

License

MIT