前言¶
在 DeepSeek Harness（DSH）裏把 GLM Coding Plan 配成 coding 路由後，套餐額度是滾動窗口：5 小時 token 窗口、Pro/Max 還有本週窗口，另有內置工具 30 天次數。智譜側往往在額度用盡時以 1310 一類錯誤才暴露問題，會話中途才發現「已經打滿」會打斷開發節奏。下面介紹社區插件 glm-quota-monitor（維護者 XJPeng12，目錄分類 admin-security）：在 Web GUI 設置頁、輸入框 dock 和 Agent 工具三條路徑上展示剩餘比例與重置時間，查詢走賬務 monitor 接口，不跑模型、不消耗套餐額度。
這是什麼¶
GLM Quota Monitor 是爲 DSH 編寫的 GLM Coding Plan 額度監控插件。它從 DSH 憑據庫解析 ZAI_CODING_CN_API_KEY（與 GLM coding 模型路由同一密鑰），調用智譜 open.bigmodel.cn/api/monitor/usage/quota/limit，把返回的百分比歸一化爲界面與工具可用的結構。插件包名 @local/glm-quota-monitor，當前倉庫 package.json 版本爲 1.0.6，許可證 MIT。社區目錄頁：https://www.skillhub.cn/plugins/XJPeng12/glm-quota-monitor；源碼：https://github.com/XJPeng12/glm-quota-monitor。
核心功能¶
設置頁「GLM 額度查詢」¶
路徑：設置 → 左側欄。展示套餐檔位（LITE / PRO / MAX）、數據更新時間；每個 token 窗口的剩餘 % / 已用 %、彩色進度條、重置時間（絕對時刻 + 倒計時）。內置工具 30 天次數顯示剩餘 / 已用，並按工具拆分明細。支持手動刷新，以及自動刷新頻率（1 分鐘～3 小時或關閉，選擇會記憶）。
輸入框下方 dock¶
在會話輸入框下方常駐極簡一行，例如 5h 剩 xx% · x小時x分後重置。升級到 Pro/Max 後，dock 會自動多出「本週窗口」一欄；Lite 僅 5 小時窗口。
Agent 工具 glm_quota_check¶
在任意會話中可直接提問「我還剩多少額度」等，Agent 會調用該工具返回當前額度概況，無需單獨打開設置頁。
密鑰與刷新成本¶
默認零配置密鑰：每次請求從 DSH 憑據庫讀取 credentialRef（默認 ZAI_CODING_CN_API_KEY），不落插件配置、不回顯 Key。刷新調用的是 monitor 接口，不消耗 Coding Plan 的模型調用額度。
數據窗口說明¶
智譜接口只返回百分比（percentage 表示已用比例），不提供具體 token 數。
| 窗口 | 來源 | 說明 |
|---|---|---|
| 5 小時窗口 | TOKENS_LIMIT (unit=3) |
滾動窗口；Lite 套餐唯一的 token 窗口 |
| 本週窗口 | TOKENS_LIMIT (unit=6) |
Pro/Max 纔有；Lite 下界面自動隱藏 |
| 內置工具 30 天 | TIME_LIMIT |
search-prime、web-reader 等次數 |
安裝與啓用¶
環境要求：DSH 桌面版或 Web 版；profile 中已掛載 dsh-credentials、dsh-host-webserver、dsh-tools（常見默認組合已包含）。
官方 README 給出的步驟如下（安裝方式爲目錄 bundle，不是 dsh plugin add github:... 一類命令）。
1、克隆倉庫到本地（示例爲 PowerShell）：
git clone https://github.com/XJPeng12/glm-quota-monitor.git
2、在 DSH 會話中讓 Agent 安裝，或自行調用 Plugin Manager，目標爲克隆目錄的絕對路徑：
請安裝插件 bundle：<克隆目錄的絕對路徑>
等價命令：
plugin_manager install_bundle target=<絕對路徑>
安裝後刷新 Web GUI（F5）生效。插件以 link: 協議目錄鏈接方式安裝；改源碼後需 remove_bundle 再 install_bundle 更新；若替換已安裝版本，需重啓 DSH 才能加載新模塊。
卸載：
plugin_manager remove_bundle target=@local/glm-quota-monitor
刷新頁面即可。
典型用法¶
- 完整詳情與刷新策略：打開 設置 → GLM 額度查詢，查看各窗口與內置工具次數，按需點手動刷新或設置自動刷新間隔。
- 會話中掃一眼：看輸入框下方 dock 的 5h（及 Pro/Max 的周窗口）剩餘比例與重置倒計時。
- 對話查詢：在會話裏問「GLM 額度還剩多少」，由 Agent 通過
glm_quota_check回答。
可選配置¶
插件行（cordis.patch.yml 中 config）支持：
| 字段 | 默認 | 說明 |
|---|---|---|
apiKey |
— | 直接提供 API Key（跳過憑據庫） |
credentialRef |
ZAI_CODING_CN_API_KEY |
憑據庫中的 Key 名 |
endpoint |
https://open.bigmodel.cn/api/monitor/usage/quota/limit |
上游接口（僅接受 https） |
不要把 Key 寫進 apiKey：該字段以明文落在 profile 配置裏，能讀 profile 目錄的人可見。首選默認行爲——通過 credentialRef 從憑據庫解析。
工作原理（概要）¶
Host 半（index.js）註冊同源路由 GET /glm-quota-usage（響應體 v 字段標記版本代次），實時請求智譜 monitor 接口並歸一化，帶 Origin 校驗；同時註冊 glm_quota_check。Client 半（client.js）註冊 settings.section 與 conversation.composer.dock，共享頁面級取數 store；自動刷新頻率存 localStorage，倒計時約每 30 秒重繪。樣式使用 --dsw-alias-* 主題 token，跟隨宿主明暗主題。
適用場景與注意¶
適合已在 DSH 中配置智譜 GLM Coding Plan、且希望提前掌握滾動窗口與內置工具次數的開發者或團隊管理員。目錄站點 SkillHub 爲社區生態索引，與 DeepSeek / 幻方無官方從屬關係；安裝前建議通讀倉庫源碼與 MIT 許可證。插件在當前 DSH 進程權限下運行，Host 路由會代表 profile 訪問憑據與上游 HTTPS 接口——僅安裝你信任來源的 bundle。
結尾¶
經過上面的步驟，glm-quota-monitor 把額度從「報錯後才知道」變成設置頁、dock 和 Agent 工具上的可觀測信號，且查詢不佔用模型額度。需要安裝說明與配置細節時，以 GitHub README 爲準：
- 目錄頁：https://www.skillhub.cn/plugins/XJPeng12/glm-quota-monitor
- 倉庫：https://github.com/XJPeng12/glm-quota-monitor
