DeepSeek Harness (DSH) 採用了“一切皆插件”的架構。在使用 ClinePass 等第三方服務時,開發者常面臨動態模型發現失敗、特定模型前綴配置繁瑣以及配額管理不直觀的問題。dsh-clinebot 是一個原生 DSH 插件,旨在解決 ClinePass 在 DSH 中的集成痛點,提供動態配額追蹤、安全憑證存儲和可視化管理能力。
插件定位¶
這是一個爲 ClineBot / ClinePass 提供原生支持的 DSH 插件,由 GooDAnDReaDY 維護,屬於“模型推理”分類。它通過插件補全了上游 API 缺失的 /v1/models 發現機制,並提供了基於 SWR 的配額緩存與多賬戶自動切換功能。
核心功能¶
-
動態模型同步與特定前綴支持
插件自動從 ClinePass 計劃接口 (GET /api/v1/users/me/plan) 拉取模型列表,並強制要求使用cline-pass/前綴(如cline-pass/deepseek-v4-flash)。由於上游 API 不提供原生的/v1/models端點,插件通過動態解析解決了模型列表爲空的問題。 -
可視化管理與安全存儲
插件提供配置頁面(位於插件行內,非側邊欄),支持直接在 UI 中粘貼並保存 API Key。Key 會被安全地寫入~/.dsh/.credentials.yaml。同時提供模型選擇器,允許開發者精細化勾選哪些模型出現在聊天拾取器中。 -
配額監控與告警
集成 5 小時滾動配額與周限額的實時儀表盤,並在配額達到 80%(警告)和 95%(耗盡)時顯示警告橫幅與重置倒計時。 -
智能故障轉移
支持多賬戶配置,在遇到 429 錯誤或配額耗盡時,自動切換至下一個可用賬戶。機制包含 30 秒的風暴保護(當前請求不重試,後續請求切換)。 -
會話遙測與命令
提供/cline斜槓命令,可在聊天控制台查看實時延遲、Token 消耗、錯誤數等會話指標;支持會話指標的實時遙測記錄。
安裝與啓用¶
使用官方安裝命令添加插件:
dsh plugin --profile web add @goodandready/dsh-clinebot
安裝完成後,請重啓 DeepSeek Harness 實例並刷新瀏覽器。
典型用法¶
- 查看狀態: 在 DSH 聊天窗口輸入
/cline,即可查看配額、限制、會話遙測和當前活躍模型。 - 配置: 點擊已安裝的 ClineBot 插件行,選擇“配置”進入設置頁,在此處粘貼 API Key、同步模型計劃並查看使用限制。
適用場景與注意¶
該插件適合需要穩定、可視化管理第三方 API 配額的開發者。由於插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。API Key 存儲在本地文件 ~/.dsh/.credentials.yaml 中,請確保該目錄權限安全。
生態鏈接¶
- 插件目錄: https://www.skillhub.cn/plugins/GooDAnDReaDY/dsh-clinebot
- 源碼倉庫: https://github.com/GooDAnDReaDY/dsh-clinebot