前言¶
DeepSeek Harness (DSH) 採用插件化架構，在開發與調試 GLM Coding Plan 路由時，需要實時掌握各窗口（5小時窗口、周窗口、工具窗口）的額度消耗情況。現有的方式通常需要切換頁面或手動查詢，缺乏常駐的反饋機制。
dsh-glm-quota-dock 插件解決了這個問題。它會在會話輸入框下方的統計行內，常駐一個 GLM Coding Plan 額度 pill，實時顯示各窗口的用量百分比與重置倒計時，無需切換頁面即可掌握配額狀態。
功能概覽¶
該插件在 DSH 客戶端中實現以下功能：
- 統計行常駐顯示：在會話輸入框下方的統計行內，常駐 GLM Coding Plan 額度 pill。插件會實時顯示 5h 窗口、周窗口、工具窗口的用量百分比。
- 5 小時窗口重置倒計時：pill 末尾常駐 5 小時窗口的重置倒計時，顏色跟隨 5h 窗口狀態變化。點擊詳情面板可查看具體時刻。
- 會話級過濾：僅在 GLM 會話中顯示。只有當前會話走 Coding Plan 路由且使用
glm-*模型時纔會渲染。純 API 計費路由不會觸發顯示。 - 詳情面板：點擊 pill 可打開雙列卡片式詳情面板。每個窗口一張卡片，顯示標題、百分比、重置時刻與進度條。正常狀態顏色爲綠/藍，告警（≥80%）爲琥珀色，臨界（≥95%）爲紅色。
- 空閒降頻：頁面可見但 5 分鐘無操作時，自動降爲 5 分鐘輪詢一次。恢復操作後立即刷新。
- 插件更新：面板頁腳顯示插件版本號。每小時靜默檢查 npm 新版本，支持 Host 端 pnpm 自更新。
- 套餐版本自適應：支持 V1（Lite 檔）、V2（含周窗口）與新版積分制，未知形狀可優雅回退。
- 密鑰安全：API Key 僅在 Host 進程內解析與使用，瀏覽器端僅拿到聚合後的百分比數據。
安裝與啓用¶
安裝過程無需構建，直接使用 npm 包進行安裝。
命令行安裝¶
使用 DSH 的插件管理命令添加插件：
dsh plugin --profile <你的profile> add dsh-glm-quota-dock
Agent 安裝¶
在 DSH 會話中，可以讓 Agent 執行以下指令進行安裝：
請用 plugin_manager 的 install_bundle 安裝 https://github.com/Everglow28/dsh-glm-quota-dock
安裝完成後，需要重啓 DSH（Host 半部）並刷新網頁（Client 半部）。
配置¶
安裝後，插件會在生成的 Cordis entry 的 config 下生成配置項。修改配置後需要重啓 DSH。
| 字段 | 默認值 | 說明 |
|---|---|---|
endpoint |
https://open.bigmodel.cn |
GLM API 端點。全球站用戶需改爲 https://api.z.ai |
minIntervalSec |
60 |
上游請求最小間隔（秒），下限爲 30 |
apiKeyRef |
ZAI_CODING_CN_API_KEY |
憑據引用名，需與模型頁配置的引用一致 |
apiKey |
無 | 直接內聯 API Key（不推薦，優先使用憑據引用） |
cwd |
\ |
上游請求的工作目錄，一般無需修改 |
使用示例¶
在會話統計行中，插件會顯示如下格式的額度信息：
◔ GLM 5h 9% · 周 45% · 工具 7% · 🕐 2h 15m
注意事項¶
- 環境要求：需要安裝較新版本的 DeepSeek Harness（Desktop 或
dsh web）。 - 供應商配置：需在 DSH 模型頁配置 GLM Coding Plan 供應商（例如
zai-coding-cn），並確保憑據引用正確。 - 驗證狀態：作者僅在 Lite 檔（歷史版本 V1：5 小時窗口 + 月度工具額度）上進行了實際驗證。V2（含周窗口）與新版積分制在邏輯上兼容，但未經真機驗證；如顯示異常，建議提 Issue 並附上返回結構。
- Host 改動生效：Host 半部的配置或改動需要重啓進程，而非刷新網頁。
總結¶
dsh-glm-quota-dock 爲 DSH 用戶提供了在開發 GLM Coding Plan 時監控配額的直觀工具。它通過常駐統計行和詳情面板，結合自動降頻與版本適配，在保證性能的同時提供了清晰的使用反饋。
