在 DeepSeek Harness (DSH) Web 界面中開發或調試時，需要了解當前會話、整個項目以及賬戶餘額的 API 成本。omdsh-usage 插件在 Chat 和 Work 模式的會話頭部、以及 Code 模式的角落提供這些信息，以便快速監控消耗。
核心功能¶
插件在界面上添加了三位數字的消耗徽章，顯示當前的 API 花費。
- 位置顯示：在 Chat 和 Work 模式下，徽章顯示在會話頭部，緊鄰模式芯片。在 Code 模式下，由於沒有頭部，徽章顯示在框架的角落。
- 數據範圍：顯示當前會話的消耗、當前項目的總消耗以及賬戶餘額。
- 詳細信息：將鼠標懸停在徽章上，可以看到詳細的令牌分解（包括緩存命中/未命中、輸出、峯值/夜間費率）和成本計算。
- 技術實現：插件提供了
omdshUsage投影單元，用於按模型統計令牌。同時提供了GET /omdsh-usage/summary端點。價格計算在主機端進行，瀏覽器端只接收格式化後的數字。
配置¶
插件提供了一套可配置的參數，用於控制顯示的貨幣、費率、夜間折扣以及低餘額閾值。
- 配置入口：可以通過 DSH 界面的“Settings -> Plugins -> Plugin hub -> Usage”進行配置，也可以直接在
cordis.yml中寫入。 - 配置項：
currency：貨幣單位，如 CNY 或 USD。rates：定義不同模型的費率表，格式爲<cache hit>/<cache miss>/<output>，單位爲每百萬 tokens 的峯值價格。支持default默認行。offPeakDiscount：夜間折扣比例，例如0.5表示夜間價格爲峯值的一半。lowBalance：餘額低於此閾值時，所有圖標變紅。apiKeyEnv：用於獲取餘額的 API Key 環境變量名，默認爲DEEPSEEK_API_KEY。baseURL：餘額查詢的 API 地址。
技術細節與注意事項¶
- 依賴項：插件依賴
omdsh-sidepanel插件來提供 Files 和 Terminal UI 上下文。 - 高峯時段：夜間折扣的時間窗口是硬編碼的，爲北京時間 09:00-12:00 和 14:00-18:00。
- 緩存機制：賬戶餘額每分鐘緩存一次。
- 運行環境：插件要求 Node.js 版本爲
^22.19.0或>=24.0.0。 - 費率校驗：在寫入
cordis.yml時，費率行必須由三個非負數字組成，否則會被拒絕。
總結¶
omdsh-usage 插件通過投影單元和 API 端點，將 DeepSeek Harness 的 API 消耗集中在界面顯眼位置，便於開發者實時監控成本。它支持自定義費率和夜間折扣，並在主機端進行價格計算。
