在 DeepSeek Harness（DSH）生態中，資源監控是日常操作的基礎。DSH 的核心理念是“一切皆插件”，dsh-usage-indicator 正是爲此類需求設計的工具。該插件在側邊欄頂部實時顯示上下文餘量、賬戶餘額以及預計下次壓縮輪次。數據在本地閉環，API Key 不會離開本機。
核心功能¶
該插件通過側邊欄提供三種主要的信息反饋：
- 上下文佔用 / 模型窗口：顯示當前上下文佔用的進度條。當接近壓縮閾值時進度條變黃，達到閾值時變紅。
- 賬戶餘額：顯示賬戶餘額的進度條。當餘額低於設定的警示線時，整條進度條變紅。
- 壓縮倒計時：使用 EMA（指數移動平均）算法估算「N 輪後壓縮」。若歷史數據不足，狀態顯示爲「評估中」。
- 視圖切換：側邊欄展開時顯示詳細卡片，收起時自動切換爲緊湊的圓環視圖 + 餘額狀態點。
- 熱生效配置：通過 Web 設置面板調整滿條額度與警示線，配置寫入
settings.yaml後無需重啓即可生效。
安裝與啓用¶
安裝前需確保已安裝 DSH 與 pnpm（缺 pnpm 先執行 npm install -g pnpm）。
- 下載對應版本的 Release 包。
- 執行安裝命令：
dsh plugin --profile web add C:\path\to\dsh-usage-indicator-<version>.tgz
安裝完成後，重啓 dsh web 即可生效。
配置與用法¶
- 餘額查詢：插件默認讀取環境變量
DEEPSEEK_API_KEY來獲取餘額信息。 - Web 設置面板：在 Web 界面的「API 用量指示」選項中，可以修改滿條額度（默認 100）、警示線（默認 20）以及刷新間隔等參數。
- 一致性要求：上下文壓縮閾值（
thresholdRatio）默認爲 0.8，需與dsh-compaction-basic保持一致。
注意事項¶
- 隱私安全：數據本地閉環，API Key 不離開本機。
- 前置條件：需要安裝 DSH 與 pnpm。
- 兼容性：必須與
dsh-compaction-basic保持一致。
總結¶
dsh-usage-indicator 將分散的上下文與餘額信息集中展示，幫助用戶在智能體開發或日常交互中及時掌握資源狀態。更多詳情可參考 GitHub 倉庫 或 插件目錄。
