前言¶
用 DeepSeek Harness（DSH）Web GUI 跑智譜 GLM（bigmodel.cn）Coding Plan 時，上下文用量圓環能反映當前會話，但小時額度、周額度是否快用完，通常要另開瀏覽器查 bigmodel.cn 用量頁。頻繁切換窗口既打斷節奏，也容易在額度觸頂後才注意到。
下面介紹社區插件 dsh-plugin-glm-balance（維護者 HoodyHuo，分類：聯網工具）：在 composer 輸入框旁的上下文用量指示器附近掛載 GLM 套餐額度條，並在設置裏集中配置 authorization 與自動刷新。本文事實均來自 GitHub 倉庫 README 與 package.json（當前版本 0.2.0，MIT 許可證）。
這是什麼¶
dsh-plugin-glm-balance 是 DSH Web 平臺插件，面向 bigmodel.cn 的套餐額度查詢與展示。插件通過宿主代理同源路由訪問 GET https://bigmodel.cn/api/monitor/usage/quota/limit，避免瀏覽器 CORS；額度 widget 僅當會話當前模型供應商 ID 與配置一致時顯示（默認 zai-coding-cn）。
- 目錄頁：https://www.skillhub.cn/plugins/HoodyHuo/dsh-plugin-glm-balance
- 源碼：https://github.com/HoodyHuo/dsh-plugin-glm-balance
核心功能¶
額度展示¶
- 兩條迷你進度條：分別對應 API 實測映射下的小時額度（
unit爲3）與每週額度（unit爲6），顯示百分比與下次重置時間。 - 樣式使用 harness 的
--dsw-*主題 token，可隨明暗模式及第三方主題（README 舉例 Dracula）變化。
刷新與交互¶
- 按可配置間隔自動輪詢（默認 30 分鐘）；點擊 widget 立即刷新，請求進行中顯示加載動畫。
- 右鍵菜單：打開 bigmodel.cn 用量頁面，或執行刷新；點擊其他區域關閉菜單。
認證與狀態¶
- 未配置 token、認證失效、上游請求失敗等狀態會在界面上區分提示；認證失效時點擊可查看修復指引。
- 設置頁獨立分區 GLM 餘額（Settings → GLM Balance）：填寫
authorization、供應商 ID（providerId）、自動刷新間隔（refreshMinutes）。
安裝與啓用¶
插件通過 dsh plugin --profile web add 安裝。安裝後需重啓 dsh web，以便宿主半註冊代理路由（GET/POST /glm-balance/api/config、GET /glm-balance/api/usage）。
從插件名安裝（README 給出的方式之一）：
dsh plugin --profile web add dsh-plugin-glm-balance
或直接從 GitHub 安裝（無需 npm 發佈）：
dsh plugin --profile web add https://github.com/HoodyHuo/dsh-plugin-glm-balance.git
本地源碼路徑安裝（示例爲 Windows 路徑，按實際目錄替換）：
dsh plugin --profile web add E:\path\to\dsh-plugin-glm-balance
更新時，若以克隆目錄維護，可在該目錄 git pull 後重新執行 GitHub 安裝命令；然後同樣重啓 dsh web。更新不會修改已保存的 token 文件 ~/.dsh/glm-balance.json。各版本變更見倉庫內 CHANGELOG.md。
典型用法：配置 authorization¶
authorization 取值爲 bigmodel.cn 請求頭中同名字段的內容，README 建議從瀏覽器開發者工具的網絡請求頭裏複製。
方式一：設置頁¶
打開 DSH Web 設置 → GLM 餘額，粘貼 authorization、確認供應商 ID（默認 zai-coding-cn）、設置自動刷新分鐘數。修改後無需重啓服務，下次輪詢或點擊刷新即生效。
方式二：編輯配置文件¶
憑證與選項默認寫在 harness 主目錄下的 glm-balance.json（路徑默認爲 ~/.dsh/glm-balance.json）：
{
"authorization": "bigmodel.cn 請求頭裏的 authorization 值",
"providerId": "zai-coding-cn",
"refreshMinutes": 30
}
完成配置後，在 Web GUI 中將當前會話模型供應商設爲與 providerId 一致（默認即 zai-coding-cn），輸入框旁應出現額度條；若顯示未配置或認證失效，按界面提示覈對 authorization 是否仍有效。
適用場景與注意¶
適合誰： 長期在 DSH Web 中使用智譜 GLM Coding Plan、需要對照小時/周額度安排會話的用戶；希望額度信息與 composer 上下文用量同屏查看、減少反覆打開 bigmodel.cn 的場景。
運行與信任邊界： 插件在 DSH 進程內運行，token 以明文保存在 harness 主目錄，與 harness 其他配置處於同一信任域。安裝前建議自行查看 GitHub 源碼 與 MIT 許可證，確認代理路由與存儲方式可接受。
顯示條件： 額度 widget 不會對任意供應商都顯示；僅噹噹前會話 provider 與配置的 providerId 匹配時才掛載，避免無關模型會話下的多餘請求。
結尾¶
dsh-plugin-glm-balance 把 bigmodel.cn 的小時/周套餐額度收進 DSH Web 輸入框旁：可配置輪詢、點擊與右鍵刷新，並在 GLM 餘額 設置分區或 ~/.dsh/glm-balance.json 中維護憑證。若你已在 harness 裏固定使用智譜 GLM Coding Plan，可按上文命令安裝並重啓 dsh web 後配置 authorization 試用。
