前言¶
DeepSeek Harness (DSH) 采用插件化架构，在开发与调试 GLM Coding Plan 路由时，需要实时掌握各窗口（5小时窗口、周窗口、工具窗口）的额度消耗情况。现有的方式通常需要切换页面或手动查询，缺乏常驻的反馈机制。
dsh-glm-quota-dock 插件解决了这个问题。它会在会话输入框下方的统计行内，常驻一个 GLM Coding Plan 额度 pill，实时显示各窗口的用量百分比与重置倒计时，无需切换页面即可掌握配额状态。
功能概览¶
该插件在 DSH 客户端中实现以下功能：
- 统计行常驻显示：在会话输入框下方的统计行内，常驻 GLM Coding Plan 额度 pill。插件会实时显示 5h 窗口、周窗口、工具窗口的用量百分比。
- 5 小时窗口重置倒计时：pill 末尾常驻 5 小时窗口的重置倒计时，颜色跟随 5h 窗口状态变化。点击详情面板可查看具体时刻。
- 会话级过滤：仅在 GLM 会话中显示。只有当前会话走 Coding Plan 路由且使用
glm-*模型时才会渲染。纯 API 计费路由不会触发显示。 - 详情面板：点击 pill 可打开双列卡片式详情面板。每个窗口一张卡片，显示标题、百分比、重置时刻与进度条。正常状态颜色为绿/蓝，告警（≥80%）为琥珀色，临界（≥95%）为红色。
- 空闲降频：页面可见但 5 分钟无操作时，自动降为 5 分钟轮询一次。恢复操作后立即刷新。
- 插件更新：面板页脚显示插件版本号。每小时静默检查 npm 新版本，支持 Host 端 pnpm 自更新。
- 套餐版本自适应：支持 V1（Lite 档）、V2（含周窗口）与新版积分制，未知形状可优雅回退。
- 密钥安全：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。
| 字段 | 默认值 | 说明 |
|---|---|---|
endpoint |
https://open.bigmodel.cn |
GLM API 端点。全球站用户需改为 https://api.z.ai |
minIntervalSec |
60 |
上游请求最小间隔（秒），下限为 30 |
apiKeyRef |
ZAI_CODING_CN_API_KEY |
凭据引用名，需与模型页配置的引用一致 |
apiKey |
无 | 直接内联 API Key（不推荐，优先使用凭据引用） |
cwd |
\ |
上游请求的工作目录，一般无需修改 |
使用示例¶
在会话统计行中，插件会显示如下格式的额度信息：
◔ GLM 5h 9% · 周 45% · 工具 7% · 🕐 2h 15m
注意事项¶
- 环境要求：需要安装较新版本的 DeepSeek Harness（Desktop 或
dsh web）。 - 供应商配置：需在 DSH 模型页配置 GLM Coding Plan 供应商（例如
zai-coding-cn），并确保凭据引用正确。 - 验证状态：作者仅在 Lite 档（历史版本 V1：5 小时窗口 + 月度工具额度）上进行了实际验证。V2（含周窗口）与新版积分制在逻辑上兼容，但未经真机验证；如显示异常，建议提 Issue 并附上返回结构。
- Host 改动生效：Host 半部的配置或改动需要重启进程，而非刷新网页。
总结¶
dsh-glm-quota-dock 为 DSH 用户提供了在开发 GLM Coding Plan 时监控配额的直观工具。它通过常驻统计行和详情面板，结合自动降频与版本适配，在保证性能的同时提供了清晰的使用反馈。
