前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。在開發或調用 DeepSeek API 的過程中，實時監控餘額、Token 消耗以及請求頻率至關重要。dsh-deepseek-balance 是爲此需求設計的 Web 界面插件，它將 API 用量信息直接嵌入到側邊欄中，無需離開當前頁面即可掌握核心數據。
這是什麼¶
這是一個 DeepSeek Harness (DSH) Web 界面插件。由開發者 qianTouchFish 維護，採用 MIT 許可證。它的核心作用是在側邊欄常顯 DeepSeek API 的用量條，並提供展開卡片以查看更詳細的消費數據。
核心功能¶
-
側邊欄常顯用量條
在側邊欄「設置」按鈕正上方，常顯餘額、消費金額、API 請求次數和 Tokens。數據每分鐘自動刷新，當餘額較低時會變爲黃色警示。 -
展開查看詳細數據
點擊用量條可展開完整卡片。支持按模型和時間維度（今天、昨天、近7天、近30天、本月、上月）查看消費，並附帶迷你柱狀圖。 -
官方累計消費
顯示官方累計消費數據。此數據來源於平臺控制台，需配置平臺令牌；若未配置，系統會自動回退爲餘額差值估算。 -
高峯/空閒時段標識
在模型選擇器旁實時顯示當前計費時段。北京時間 09:00-12:00 和 14:00-18:00 標識爲高峯時段，其餘爲空閒時段。 -
令牌一鍵獲取
支持從本機 Chrome、Edge 或 Chromium 瀏覽器一鍵提取平臺令牌（DEEPSEEK_PLATFORM_TOKEN）。 -
主題與持久化
插件自動適配淺色/深色主題。時間維度、API Key 和模型選擇會自動持久化保存。
安裝¶
在終端執行以下命令：
dsh plugin --profile web add github:qianTouchFish/dsh-deepseek-balance
安裝完成後，重啓 Web 應用（桌面圖標或 dsh web）並刷新頁面，側邊欄底部即可看到用量條。
配置與使用¶
-
填寫 API Key
首次使用需到 DSH 的「設置 → 模型」頁面填寫DEEPSEEK_API_KEY。 -
獲取官方數據
若需查看官方累計消費和更精確的數據，打開用量卡片，點擊底部【自動獲取】按鈕。插件會嘗試從本機已登錄 https://platform.deepseek.com 的瀏覽器中提取令牌。 -
手動配置令牌（可選）
如果自動獲取失敗，可手動獲取。在瀏覽器登錄平臺後，按F12打開控制台，執行以下代碼提取令牌：
JSON.parse(localStorage.getItem('userToken')).value
將獲取到的令牌追加到 ~/.dsh/.credentials.yaml 文件中：
DEEPSEEK_PLATFORM_TOKEN: <那串令牌>
注意事項¶
- 本插件依賴已安裝的 DSH CLI 與 pnpm。
- 使用【自動獲取】功能時，瀏覽器必須已登錄 https://platform.deepseek.com，且不支持隱身模式。若瀏覽器使用非默認配置（如 Profile N），需在插件設置中調整。
總結¶
dsh-deepseek-balance 通過在側邊欄提供常顯的用量條和展開的詳情卡片，解決了開發者頻繁切換頁面查看 API 餘額和消費的痛點。配合高峯時段標識和自動刷新機制，能更好地輔助智能體開發和成本控制。
插件目錄：[catalog_url]
GitHub 倉庫：[github_url]
