在 DeepSeek Harness (DSH) 的 Web 界面中開發智能體時，若使用 OpenCodex 作爲底層提供方，開發者通常需要頻繁確認 API 配額、速率限制以及費用統計。在聊天窗口中反覆切換標籤或打開終端查看，既影響開發效率也容易打斷心流。dsh-opencodex-usage 插件旨在解決這一痛點，提供一個常駐屏幕的懸浮監控組件，將複雜的接口數據轉化爲直觀的卡片視圖。
插件定位¶
這是一個由 Walvez 維護的 DSH 客戶端插件，用於在 DeepSeek Harness 的 Web 界面中展示 OpenCodex 的用量數據。它通過讀取本地 OpenCodex 的接口和配置文件，將多提供方的速率限制、配額剩餘以及費用統計集成到一個可自由拖拽的懸浮卡片中，無需手動刷新頁面即可獲取最新狀態。
核心功能¶
1. 自由拖拽與位置記憶¶
插件在聊天主界面生成一個懸浮膠囊。用戶可以按住膠囊在屏幕任意位置拖拽，鬆開後位置會自動保存在瀏覽器的 localStorage 中。即便刷新頁面或重啓服務，膠囊仍會出現在上次的位置。插件加入了防誤觸邏輯，能夠區分微小的移動（點擊打開面板）和大幅度的拖拽操作。
2. 全量接入 5 大提供方速率與配額監控¶
插件直接對接 OpenCodex 的官方接口獲取數據。支持的提供方包括 OpenCode Go、Google Antigravity、OpenAI (Codex login)、xAI Grok 和 DeepSeek。針對每個提供方，插件展示不同的關鍵指標，例如 OpenCode Go 的 5 小時滾動限額、Google Antigravity 的 Gem/Cla 用量百分比、OpenAI 的賬戶池容量恢復提示以及 DeepSeek 的實時 API 餘額。
3. 用量與費用統計¶
插件提供 7 天和 30 天兩種統計週期。面板展示總請求數、總 Tokens、Cache 緩存命中率以及基於 API 估算的費用。同時，它還列出了當前活躍度最高的模型排行榜，幫助開發者快速瞭解資源消耗情況。
4. 零配置自動探測¶
插件不需要手動配置 OpenCodex 的運行端口和鑑權 Token。它會自動讀取 ~/.opencodex/runtime-port. 獲取動態端口，並讀取 ~/.opencodex/admin-api-token 完成鑑權。同時，它適配了 DSH 的設計令牌，能夠自動適應深色、淺色以及自定義皮膚主題。
安裝與啓用¶
- 克隆倉庫
cd ~/.dsh/profiles/web/plugins
git clone https://github.com/Walvez/dsh-opencodex-usage.git
- 修改配置文件
打開~/.dsh/profiles/web/package.json，在dependencies中添加插件依賴，並在dsh.profile.bundles中加入插件名稱。
{
"dependencies": {
"dsh-opencodex-usage": "link:plugins/dsh-opencodex-usage"
},
"dsh": {
"profile": {
"bundles": [
"dsh-opencodex-usage"
]
}
}
}
- 重啓服務
安裝完成後，必須重啓dsh web服務才能使插件生效。
典型用法¶
安裝並重啓服務後，在 DSH 的聊天主界面會出現一個懸浮膠囊。點擊膠囊可展開監控面板，拖拽膠囊可改變其在屏幕上的位置。面板頂部提供 7 天和 30 天的切換按鈕，用於查看不同時間維度的用量與費用統計。
適用場景與注意¶
本插件以 DSH 進程的權限運行，因此它依賴於本機安裝並正在運行的 OpenCodex 服務。確保 OpenCodex 的運行端口（默認 10100）和鑑權 Token 配置正確。此外，插件遵循 MIT 許可證，使用時請自行檢查源碼與許可證。
對於需要在 DSH 中頻繁管理 OpenCodex 資源的開發者，dsh-opencodex-usage 提供了一種直觀且低干擾的監控方案。它將複雜的接口數據轉化爲可視化的懸浮卡片，減少了視線在窗口與終端之間的切換。
插件目錄：https://www.skillhub.cn/plugins/Walvez/dsh-opencodex-usage
源碼地址：https://github.com/Walvez/dsh-opencodex-usage
