前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構。在本地運行智能體或進行開發調試時，頻繁切換到 DeepSeek 平臺控制台查看餘額和今日消費會打斷工作流。需要在 DSH 網頁界面中直接、實時地獲取這些信息。
是什麼¶
dsh-deepseek-quota 是一個爲 DSH Web GUI 設計的插件，由用戶 ricardolicong 維護。它通過右下角的懸浮卡片，展示 DeepSeek API 的額度狀態和消費詳情，無需離開當前頁面。
核心功能¶
- 懸浮卡片顯示：卡片固定在頁面右下角，不遮擋主界面。
- 關鍵信息展示：顯示總餘額、可用狀態、當前對話費用以及今日消費。
- 自動刷新：餘額每 60 秒自動刷新，對話費用每 5 秒自動刷新。
- 交互與持久化：卡片可拖拽移動，支持最小化；位置和狀態保存在本地存儲中，刷新頁面後保持。
- 錯誤處理：對 API Key 缺失、網絡失敗或接口報錯有明確的錯誤狀態提示。
- 定價計算：使用官方 DeepSeek 價格表計算當前對話費用。
- 本地安全：API Key 僅在本地處理，不會離開用戶的機器。
安裝與啓用¶
前置條件：已安裝 DSH CLI 和 pnpm。
dsh plugin --profile web add dsh-deepseek-quota
安裝完成後，按以下步驟啓用：
- 重啓 Web 應用：
dsh web。 - 打開 http://127.0.0.1:3080 並刷新頁面。
- 在設置頁面配置
DEEPSEEK_API_KEY，或在環境變量中導出。
典型用法¶
配置好 DEEPSEEK_API_KEY 後，右下角即會出現額度卡片。若需獲取官方今日消費數據，可設置可選的環境變量 DEEPSEEK_PLATFORM_TOKEN；未設置時，插件會使用估算值。
注意事項¶
- 插件依賴 DSH CLI 和 pnpm。
- API Key 僅在本地處理，瀏覽器僅訪問本地註冊的路由。
- 若未配置
DEEPSEEK_PLATFORM_TOKEN，今日消費將顯示爲估算值。
總結¶
dsh-deepseek-quota 將額度監控集成到 DSH 界面中，提供了基於官方價格的實時對話成本計算和餘額狀態展示，適合需要在本地持續監控 API 資源的智能體開發者。
