前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。對於使用 MiniMax Coding Plan 的開發者而言，監控 API 配額消耗是日常開發中的常見需求。此插件將 MiniMax 的配額使用情況直接渲染到 DSH 的側邊欄，提供實時進度條和重置倒計時，避免開發者手動切換頁面或打開網頁進行查詢。

插件介紹¶

名稱：owen-si-zhou/dsh-plugin-minimax-usage
定位：DSH 客戶端插件
維護者：owen-si-zhou
核心價值：在 DSH 側邊欄直接顯示 5 小時窗口和每週配額的剩餘進度。

核心功能¶

1. 5 小時配額條：實時顯示當前間隔（5小時窗口）的剩餘額度進度。
2. 每週配額條：概覽本週額度的使用情況，直觀展示剩餘百分比。
3. 重置倒計時：顯示窗口重置的精確時間（例如：重置於 2h 17m）。
4. 可摺疊面板：點擊面板箭頭可摺疊/展開。摺疊狀態下顯示緊湊摘要。
5. 自動刷新：每 60 秒通過服務端緩存自動更新數據。
6. 側邊欄集成：渲染在 sidebar.footer.action 區域，位於“設置”按鈕上方。
7. 輕量級：使用純 React.createElement 構建，無 CSS 框架依賴，無外部圖片資源。

安裝與啓用¶

插件安裝目錄爲 ~/.dsh/profiles/web。

1. 安裝插件
   進入插件目錄並使用包管理器安裝。以 pnpm 爲例：

   cd ~/.dsh/profiles/web
   pnpm add /path/to/this/plugin

或使用 npm link：

   cd ~/.dsh/profiles/web
   npm link /path/to/this/plugin

2. 註冊插件
   將以下內容追加到 ~/.dsh/profiles/web/cordis.patch.yml：

   - insert:
       - id: minimax-usage
         name: '@dsh-external/minimax-usage'

3. 配置 API 密鑰
   插件在請求時從 ~/.zshrc.secret 讀取 MINIMAX_API_KEY。請確保該文件中已導出密鑰：

   export MINIMAX_API_KEY='your-minimax-api-key-here'

4. 重啓與刷新
   重啓 DSH web 服務：

   dsh web

在瀏覽器中強制刷新頁面以加載插件。

技術細節與注意事項¶

• 時間戳精度：API 返回的 end_time、start_time、weekly_end_time 和 weekly_start_time 字段均爲 Unix 毫秒時間戳。
• 倒計時計算：API 的 remains_time 字段不可靠（可能錯誤地返回 96 天）。插件通過 end_time - Date.now() 計算重置時間，確保準確性。
• 百分比格式：API 返回的配額百分比爲 0-100 的整數。
• 容錯機制：若未配置 MINIMAX_API_KEY，插件會在側邊欄顯示錯誤信息，不會導致程序崩潰。

適用場景¶

適合需要頻繁查看 MiniMax 配額狀態的開發者，特別是將 DSH 作爲主要開發環境，希望將配額監控集成到側邊欄以減少操作中斷的用戶。

結語¶

該插件通過純 React 組件實現了輕量級的配額監控功能，並直接集成於 DSH 側邊欄。更多詳情與源碼可參考：GitHub。