前言¶
在 DeepSeek Harness（DSH）里用智谱 GLM CodingPlan 写代码或对话时，套餐往往同时受「5 小时窗口」和「每周窗口」约束。额度还剩多少、何时重置，通常要到智谱控制台或自行抓接口才能看清，和当前会话脱节。
下面介绍社区客户端插件 dsh-bigmodel-consume（维护者 JHyugou）：在对话输入区实时显示 5 小时与每周用量剩余，并支持月度 MCP 额度、重置倒计时与套餐档位。用户只需配置智谱 API Key；当前会话选用智谱模型（zai / glm）时，模型选择器左侧会出现用量药丸，点击可展开详情。
这是什么¶
dsh-bigmodel-consume 是 DSH 的客户端插件，分类为「客户端」。它在对话输入区挂载用量指示，数据来自智谱 monitor 用量接口，经宿主端转发以绕开浏览器 CORS。插件零 npm 依赖、零构建，采用「宿主端 + 浏览器端」双半结构。
- 目录页：https://www.skillhub.cn/plugins/JHyugou/dsh-bigmodel-consume
- 源码与说明：https://github.com/JHyugou/dsh-bigmodel-consume
- 当前包版本（package.json）：0.2.0，许可证 MIT
核心功能¶
用量药丸¶
插槽为 conversation.input.right，位于模型选择器左侧（设计参照 opencode-go 的 UsagePill）。仅当当前会话选中智谱模型时显示；展示状态点与类似 GLM 5h 73% · 周 95% 的剩余百分比，并按余量变色：绿（≥30%）→ 橙（<30%）→ 红（<10%）。非智谱模型时自动隐藏。
用量弹窗¶
点击药丸可展开：5 小时、每周、月度 MCP 三个窗口的进度条、已用/总量积分、重置时间与倒计时、套餐档位、Key 来源，以及手动刷新。未配置 Key 时，弹窗内提供就地录入表单。
设置页¶
通过 settings.section 插槽提供「GLM 用量」区块，包括：
- API Key（保存前真实校验，认证失败不落盘）
- 组织/项目 ID（新版积分套餐）
- 套餐类型（团队=2 / 个人=1）
- 区域（bigmodel.cn / z.ai）
- 自动刷新间隔（1–60 分钟）
自动轮询与 Key 来源¶
默认每 5 分钟后台刷新；页面不可见时暂停。弹窗打开且数据超过 60 秒时会自动刷新；连接重置后自动重取。
不填 Key 时依次回退：DSH 凭据库的 ZAI_API_KEY（与官方控制台同一把 Key），再回退环境变量。
安装与启用¶
本机若已通过 desktop profile 安装，在新机器上可按 README 两种方式之一操作。
# 方式一：CLI（dsh 在 PATH 时）
dsh plugin --profile desktop add <本目录路径>
方式二：Web 界面 — 侧栏 → Plugins → Install from path → 填写本插件目录路径。
安装后若未热加载，重启 DSH 桌面端。卸载在 Plugins 页移除本包即可。
API Key 与新版积分套餐¶
旧版套餐：只需 API Key。宿主端以 Bearer 方式请求
https://open.bigmodel.cn/api/monitor/usage/quota/limit。
新版积分套餐（README 注明 2026-07 改版后，含团队套餐）：需要组织/项目上下文。做法概要：
- 登录 bigmodel.cn/coding-plan。
- 打开浏览器 DevTools → Network，找到
api/monitor/usage/quota/limit请求。 - 请求头
bigmodel-organization/bigmodel-project即为组织/项目 ID；URL querytype为套餐类型（团队=2，个人=1）。 - 将上述字段填入设置页对应项。
响应中 limits 按 unit 区分窗口（3=小时窗、6=周窗）；percentage 为已用百分比；currentValue / usage / remaining 为已用/总量/剩余积分；nextResetTime 为窗口重置时间（unix 毫秒）。
典型用法¶
- 安装插件并重启 DSH（如需要）。
- 在设置页「GLM 用量」填入 API Key；若为新版积分套餐，补全组织/项目 ID 与套餐类型、区域。
- 新建或切换会话，在模型选择器中选择智谱相关模型（provider 为 zai 或 glm）。
- 在输入区左侧查看用量药丸；点击打开弹窗核对各窗口额度与重置时间。
- 需要即时数据时，在弹窗内使用手动刷新。
维护者在仓库中提供本地验证命令（需在本机插件目录执行）：
node smoke.mjs # 宿主端端点 + 真实 API 调用 + 客户端结构与降级路径冒烟
node verify.mjs # 对运行中的 DSH 宿主（127.0.0.1:19387）做端到端验证
DSH 升级后可用 node doctor.mjs 做约 30 秒的逐层体检（宿主在线 → 启动图 → bundle → /api 双协议 → 智谱上游），按 PASS/WARN/FAIL 定位问题。
架构要点（便于排查）¶
| 文件 | 角色 |
|---|---|
src/index.js |
宿主端 Cordis 插件：注册同源 /api/bigmodel-usage.{config,setConfig,usage} POST 路由，转发智谱 monitor；配置写入 <dsh home>/plugins/dsh-bigmodel-consume/config.json，原子写入且不向客户端回传完整 Key |
src/client.js |
浏览器端 bundle：React 组件经 connection.rpc.call 调宿主；通过 modelDirectories 感知当前会话模型 |
cordis.patch.yml |
安装时挂载宿主端入口 |
package.json |
dsh.bundle.patch 与 dsh.client 声明 |
usage 结果在宿主端缓存 60 秒。插件对 DSH 版本演进做了失败软着陆、插槽降级链、双协议数据通道与 CSS 令牌兜底等兼容设计，详见 README「兼容性设计」一节。
适用场景与注意¶
适合谁：在 DSH 中长期使用智谱 GLM CodingPlan、希望在写 prompt 时一眼看到 5 小时/周额度，而不反复打开控制台的用户。
权限与安全：DSH 插件在当前 dsh 进程权限下运行；安装前请自行阅读源码与 MIT 许可证，确认 Key 存储与转发行为符合你的安全要求。API Key 经宿主校验后落盘，插件声明永不向浏览器回传完整 Key。
生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的客户端插件，非官方应用商店条目。
结尾¶
dsh-bigmodel-consume 把智谱 CodingPlan 的 5 小时窗口、每周窗口及月度 MCP 用量收敛到 DSH 对话输入区一侧，配置 Key（及新版套餐的组织上下文）后即可在选用智谱模型时看到药丸与弹窗详情。
