DeepSeek Harness (DSH) 採用插件化架構。在使用 OpenCode Go 服務時,管理多個 API Key 的用量往往需要頻繁切換頁面或查看後臺,效率較低。dsh-opencode-go-usage 旨在解決這個問題,它將 OpenCode Go 的訂閱用量監控直接集成到 DSH 的 Web 界面中。
插件定位¶
這是一個 DSH Web 插件,由 mouseteamlucky 維護。它提供懸浮窗口,實時展示 OpenCode Go 訂閱用量,支持按 Key 展示滾動/周/月窗口的用量條、百分比和重置倒計時。
核心功能¶
- 懸浮窗口:緊湊按鈕固定在右側邊緣,顯示所有 Key 中最差窗口的百分比,並根據緊迫程度(綠/橙/紅)閃爍。
- 展開面板:每張卡片顯示一張 Key 的用量詳情,包含用量條、百分比、重置倒計時和手動刷新按鈕。
- 實時刷新:Host 端輪詢官方端點獲取數據,面板自動更新。
- Key pool 自動發現:自動讀取
$DSH_HOME/.credentials.yaml中的OPENCODE_GO_KEY_<name>配置。 - 雙語 UI & DSH 主題令牌:界面支持中英文切換,並適配 DSH 的亮色/暗色主題。
安裝與啓用¶
使用官方安裝命令添加插件:
dsh plugin --profile web add github:mouseteamlucky/dsh-opencode-go-usage
安裝完成後,重啓 DSH Web 應用(通過 launcher 或受保護路徑),並刷新瀏覽器頁面即可生效。
典型用法¶
啓用後,在 DSH Web 界面右側邊緣會出現懸浮按鈕。點擊按鈕展開面板,即可查看所有 Key 的實時用量。面板會自動輪詢數據,支持手動刷新。
適用場景與注意¶
此插件適合需要同時管理多個 OpenCode Go Key 並希望實時監控用量的開發者。
技術實現上,Host(Node ESM)負責聚合數據,Client(瀏覽器)負責展示,Key 數據不會直接暴露給瀏覽器。依賴項包括 React、@deepseek-ai/cordis、@deepseek-ai/dsh-credentials 和 @deepseek-ai/dsh-home-paths。
注意:上游 fork 歸屬 @xiaweiliang060035/dsh-opencode-go-usage。
總結¶
該插件通過懸浮組件解決了多 Key 用量監控的痛點。更多詳情可參考目錄頁或 GitHub 倉庫。