dsh-glm-quota-dock: Real-Time Monitoring of GLM Coding Plan Quotas with DeepSeek Harness

前言¶

DeepSeek Harness (DSH) 采用插件化架构，在开发与调试 GLM Coding Plan 路由时，需要实时掌握各窗口（5小时窗口、周窗口、工具窗口）的额度消耗情况。现有的方式通常需要切换页面或手动查询，缺乏常驻的反馈机制。

dsh-glm-quota-dock 插件解决了这个问题。它会在会话输入框下方的统计行内，常驻一个 GLM Coding Plan 额度 pill，实时显示各窗口的用量百分比与重置倒计时，无需切换页面即可掌握配额状态。

功能概览¶

该插件在 DSH 客户端中实现以下功能：

1. 统计行常驻显示：在会话输入框下方的统计行内，常驻 GLM Coding Plan 额度 pill。插件会实时显示 5h 窗口、周窗口、工具窗口的用量百分比。
2. 5 小时窗口重置倒计时：pill 末尾常驻 5 小时窗口的重置倒计时，颜色跟随 5h 窗口状态变化。点击详情面板可查看具体时刻。
3. 会话级过滤：仅在 GLM 会话中显示。只有当前会话走 Coding Plan 路由且使用 glm-* 模型时才会渲染。纯 API 计费路由不会触发显示。
4. 详情面板：点击 pill 可打开双列卡片式详情面板。每个窗口一张卡片，显示标题、百分比、重置时刻与进度条。正常状态颜色为绿/蓝，告警（≥80%）为琥珀色，临界（≥95%）为红色。
5. 空闲降频：页面可见但 5 分钟无操作时，自动降为 5 分钟轮询一次。恢复操作后立即刷新。
6. 插件更新：面板页脚显示插件版本号。每小时静默检查 npm 新版本，支持 Host 端 pnpm 自更新。
7. 套餐版本自适应：支持 V1（Lite 档）、V2（含周窗口）与新版积分制，未知形状可优雅回退。
8. 密钥安全：API Key 仅在 Host 进程内解析与使用，浏览器端仅拿到聚合后的百分比数据。

安装与启用¶

安装过程无需构建，直接使用 npm 包进行安装。

命令行安装¶

使用 DSH 的插件管理命令添加插件：

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

Agent 安装¶

在 DSH 会话中，可以让 Agent 执行以下指令进行安装：

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

安装完成后，需要重启 DSH（Host 半部）并刷新网页（Client 半部）。

配置¶

安装后，插件会在生成的 Cordis entry 的 config 下生成配置项。修改配置后需要重启 DSH。

使用示例¶

在会话统计行中，插件会显示如下格式的额度信息：

◔ GLM 5h 9% · 周 45% · 工具 7% · 🕐 2h 15m

注意事项¶

1. 环境要求：需要安装较新版本的 DeepSeek Harness（Desktop 或 dsh web）。
2. 供应商配置：需在 DSH 模型页配置 GLM Coding Plan 供应商（例如 zai-coding-cn），并确保凭据引用正确。
3. 验证状态：作者仅在 Lite 档（历史版本 V1：5 小时窗口 + 月度工具额度）上进行了实际验证。V2（含周窗口）与新版积分制在逻辑上兼容，但未经真机验证；如显示异常，建议提 Issue 并附上返回结构。
4. Host 改动生效：Host 半部的配置或改动需要重启进程，而非刷新网页。

总结¶

dsh-glm-quota-dock 为 DSH 用户提供了在开发 GLM Coding Plan 时监控配额的直观工具。它通过常驻统计行和详情面板，结合自动降频与版本适配，在保证性能的同时提供了清晰的使用反馈。