前言¶
DeepSeek Harness（DSH）里跑智能体时，经常需要查看智谱 GLM Coding Plan 的额度情况。当前做法通常是打开控制台网页，手动刷新 5 小时窗口或每周窗口，操作不连续。DSH GLM Usage 插件在 DSH 侧栏常驻卡片，展示已用 / 总量、百分比和进度条，并支持打开明细面板查看重置时间与 MCP 工具调用次数。
插件定位¶
DSH GLM Usage 是一个 DSH 客户端插件，在 DeepSeek Harness 侧栏展示智谱 GLM Coding Plan 的用量信息。插件维护者为 zhangaiyu1996，分类为客户端，当前在 GitHub 上有 1 星标。
核心功能¶
- 侧栏常驻小卡：底部一行显示各窗口的「已用 / 总量 + 百分比 + 进度条」，并带最后更新时间。侧栏收起到 56px 轨道时自动变成只显示最紧张那个窗口百分比的图标。
- 点击打开明细面板：在中间栏打开完整面板，逐行展示 5 小时窗口、每周窗口与 MCP 工具额度，含重置时间。再点一次收起。
- MCP 工具明细：面板里额外列出
search-prime/web-reader/zread各自的调用次数，MCP 数字异常时能立刻定位到是哪个工具。 - 零配置起步：默认直接复用 DSH 凭据库里已有的
ZAI_API_KEY（以及同名环境变量），不必再粘贴一次。 - Key 只在宿主侧：浏览器永远拿不到 Key —— 所有上游读取都由宿主进程完成，卡片只拿到归一化后的数字。
- 保存前先校验：粘贴新 Key 时先真的打一次上游，通过才落盘，打错不会把可用的凭据弄丢。
- 中英双语：跟随 DSH 的界面语言。
- 低调的轮询：默认 5 分钟一次，页面不可见时跳过；所有界面共享同一份快照与同一个定时器，面板与侧栏永远显示同一组数字。
支持的区域¶
插件同时支持两个区域，凭据一份、按卡片切换：
| 区域 | 额度接口 | 控制台 |
|---|---|---|
| 智谱开放平台（默认） | https://open.bigmodel.cn/api/monitor/usage/quota/limit |
bigmodel.cn |
| Z.AI 国际站 | https://api.z.ai/api/monitor/usage/quota/limit |
z.ai |
两站的 API Key 不互通：国内 Key 调国际站会失败，反之亦然。
安装与启用¶
将插件目录放入 DSH profile，使用以下命令安装：
dsh plugin --profile desktop add /path/to/dsh-glm-usage
或者直接放进 profile 的 package.json 依赖，并在 dsh.profile.bundles 里追加 dsh-glm-usage。装好后重启 DSH。
配置¶
在「设置 → 插件设置 → GLM 用量」或侧栏「插件」面板里本插件的详情页进行配置：
| 项 | 说明 |
|---|---|
| 区域 | 智谱开放平台 / Z.AI 国际站 |
| Coding Plan API Key | 留空则用 DSH 的 ZAI_API_KEY |
| 侧栏显示 | 关掉后侧栏不再出现小卡，其余功能不变 |
Key 的解析优先级：卡片保存的 Key > DSH 凭据库的 ZAI_API_KEY > 环境变量 ZAI_API_KEY。面板上的徽标会显示当前生效来源。
数据文件位于 <profile>/.dsh-glm-usage/settings.json，只有区域、Key（若保存过）与显示开关。可用 DSH_GLM_USAGE_DATA_DIR 覆盖目录。
用 CLI 排查¶
不想起 DSH 就能确认 Key 和区域是否可用（走的是插件同一条代码路径）：
ZAI_API_KEY=... node test/live-check.mjs # 两个区域都试
ZAI_API_KEY=... node test/live-check.mjs cn # 只试国内站
失败时打印的是卡片上会显示的同一套分类（auth / no-plan / upstream / network / shape），所以「区域选错了」和「Key 过期了」能一眼分清。
关于上游接口¶
额度接口没有公开文档，实现按实测响应字段归一化。两个关键点：
- 业务失败也是 HTTP 200。Key 失效或账号没有套餐时，服务返回
200 OK加success:false，所以判断依据是响应体而不是状态码。本体区分三种失败：auth（Key 无效）、no-plan（按量计费账号，读不到套餐）、upstream（其它）。 - 窗口靠
unit识别，不靠数组位置。5 小时窗口是unit:3，每周窗口是unit:6。上游随时可能调整limits的顺序，按位置切分会把两个窗口张冠李戴。
百分比优先用绝对值算（currentValue / usage），因为上游的 percentage 是取整后的整数，会把 0.71% 报成 1%、算成整数倍误差；只有在没有绝对数值时（旧版 TOKENS_LIMIT）才回退到 percentage。
CREDIT_LIMIT 的字段名与直觉相反：usage 是总额度，currentValue 才是已用。三种桶（TOKENS_LIMIT / CREDIT_LIMIT / TIME_LIMIT）都会被读取，未知类型跳过而不是报错。
适用场景与注意¶
- 适合在 DSH 中开发使用智谱 GLM Coding Plan 的智能体，需要频繁查看额度情况。
- 插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。
- 插件与智谱、Z.AI、DeepSeek 官方均无关联，是社区插件，上游接口随时可能变化。
总结¶
DSH GLM Usage 在 DSH 侧栏常驻展示智谱 GLM Coding Plan 的用量信息，支持两个区域、MCP 工具明细与中英双语，零配置即可复用 DSH 凭据库的 Key。通过侧栏卡片与明细面板，开发者可以在不切换控制台的情况下掌握 5 小时窗口、每周窗口与 MCP 工具额度。
- 插件目录：https://www.skillhub.cn/plugins/zhangaiyu1996/dsh-glm-usage
- GitHub：https://github.com/zhangaiyu1996/dsh-glm-usage
