前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在 Web 端使用智譜 Coding Plan 時,頻繁查看 Token 窗口、MCP 工具配額以及模型調用用量通常需要依賴外部監控面板或手動切換頁面。dsh-zhipu-coding-plan 旨在解決這一割裂感,將智譜 Coding Plan 的關鍵指標直接嵌入 DSH Web 的對話視圖面板中,讓額度管理更加直觀。
核心功能¶
該插件在 DSH Web 中提供以下維度的數據展示:
- Token 窗口:展示 5 小時 / 每週 Token 額度進度條與重置倒計時。當佔用率達到一定閾值時,進度條會自動變色以示警示。
- MCP 工具額度:顯示本月工具額度的已用總量、總量及剩餘次數,並提供聯網搜索、網頁讀取、Zread 等分項明細。
- 模型用量:查看近 24 小時 / 7 天內的模型調用次數和 Token 總量,以及按模型佔比的統計排行。
- Key 頁內配置:支持在面板內直接保存智譜 API Key,保存前會自動進行校驗。
- 錯誤可讀:對 Key 無效、限流、斷網等錯誤進行分類提示。即使明細接口異常,主面板的額度展示也不會受到影響。
安裝與啓用¶
在終端中執行官方安裝命令:
dsh plugin --profile web add dsh-zhipu-coding-plan
安裝完成後,請重啓 DSH Web。
重啓後,界面選項卡中會出現「額度 / Quota」選項卡。它位於對話、軌跡和統計選項卡旁邊,無需離開當前對話即可查看額度信息。
使用說明¶
- 保存 Key:首次打開額度面板時,可以在頁面內直接保存智譜 API Key。
- Key 解析邏輯:插件會按照優先級解析 Key:啓動環境變量
ZHIPU_API_KEY→ DSH 憑據存儲 → 啓動目錄.env。 - 動態更新:插件每次查詢都會重新解析 Key,因此更換 Key 無需重啓 DSH Web。
注意事項¶
- 套餐限制:本插件僅支持智譜個人版套餐。若使用其他平臺的 Key(如 DeepSeek),面板會明確提示爲無效,不會誤報數據。
- 隱私安全:Key 只保存在本機 DSH 憑據存儲(
~/.dsh/.credentials.yaml)或環境變量中,面板界面中永不顯示 Key 值。 - 數據來源:額度查詢直連智譜官方監控接口(
open.bigmodel.cn),無第三方中轉。 - 運行環境:需要 Node.js
^22.19.0或>=24.0.0。 - 數據精度:Token 窗口接口不返回絕對值,面板如實呈現接口返回的百分比。
生態背景¶
DSH 是 DeepSeek 官方維護的插件化框架,社區目錄與 DeepSeek / 幻方無官方從屬關係。本插件由社區維護,許可證爲 MIT。
鏈接¶
- 插件目錄:https://www.skillhub.cn/plugins/tsja2001/dsh-zhipu-coding-plan
- 源代碼:https://github.com/tsja2001/dsh-zhipu-coding-plan