前言¶
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
