前言¶
DeepSeek Harness (DSH) 是一個基於插件架構的平臺。在 Web 界面開發或使用過程中,開發者通常需要實時掌握多模型提供商的額度情況、高峯時段以及當前工作區的狀態。原生狀態欄在支持多模型和精細化管理方面往往有所欠缺。dsh-statusline-plus 旨在爲 DSH Web 提供一個響應式的增強狀態欄,解決這些信息透明度的問題。
插件定位¶
這是一個由 overact 維護的 MIT 許可證插件,專注於爲 DeepSeek Harness Web (dsh web) 提供狀態欄增強。它不僅提供多模型餘額和配額的實時展示,還集成了 DeepSeek 高峯時段監控、Git 狀態、上下文管理、成本估算以及代理活動監控。
核心功能¶
- 多模型額度監控:支持 DeepSeek、Kimi Code、Z.ai (智譜)、Antigravity、Codex、OpenCode Go 和 OpenRouter 的餘額與配額顯示,點擊卡片可查看詳情並刷新。
- DeepSeek 高峯時段:提供狀態指示、倒計時、每日時間軸以及側邊欄標記,幫助用戶識別並避開高峯期。
- 工作區與會話指標:在底部狀態欄展示 Git 分支與變更、上下文使用量、流式輸出 TPS (Tokens Per Second)、API 參考成本以及子代理和工具的活動狀態。
- 佈局定製:支持開關組件、調整排列順序、使用佈局預設,並提供交互式預覽。
安裝與啓用¶
該插件要求 DSH 版本爲 >=0.2.0-rc.2 且 <0.3.0。安裝發佈版本:
dsh plugin --profile web add https://github.com/overact/dsh-statusline-plus/releases/download/v0.1.1/dsh-statusline-plus-0.1.1.tgz
若用於本地開發調試,可安裝本地路徑:
dsh plugin --profile web add file:/path/to/dsh-statusline-plus
配置與用法¶
安裝完成後,進入 DSH Web → Settings → Statusline。設置會保存在原生配置的 statusline-plus 下。
- 組件開關與順序:通過
enabled、showGit、showContext、showCost等開關控制組件顯示,使用componentOrder調整底部狀態欄的組件順序。 - 憑證管理:配置時應使用憑證引用而非明文密鑰。例如 DeepSeek 使用
DEEPSEEK_API_KEY,Kimi 使用KIMI_API_KEY,Z.ai 使用ZAI_API_KEY等。密鑰僅保存在 Host 端,不會由插件直接持有。 - 緩存與超時:通過
cacheTtlMs設置額度結果的緩存時間(默認 60 秒),通過fetchTimeoutMs設置請求超時時間(默認 10 秒)。
注意事項¶
- 成本估算:顯示的成本是基於實際使用量和廠商公開 API 價格的估算值,不包括子會話、繼承的分支歷史和額外費用,不代表實際賬單。
- 請求機制:額度請求使用插件專用的連接池,地址嘗試窗口爲 5 秒。網絡失敗會進行重試,但成功查詢會立即更新顯示,無需等待連接窗口結束。
- 版本兼容性:插件依賴於 DSH
>=0.2.0-rc.2。注意 v0.1.1 版本中,部分功能(如窄屏適配開關)尚未在發佈版本中包含(參見 release notes)。
結尾¶
dsh-statusline-plus 通過在頭部和底部提供結構化的狀態信息,顯著提升了在 DeepSeek Harness 中管理多模型工作流的效率。如果你想深入瞭解或貢獻代碼,可以訪問其 GitHub 倉庫。
- GitHub: https://github.com/overact/dsh-statusline-plus
- Catalog: https://www.skillhub.cn/plugins/overact/dsh-statusline-plus